shalithasuranga/node-touch

node-touch brings the familiar Unix touch command into the JavaScript world. If you've ever used a Mac or Linux terminal, touch is that handy utility that creates empty files or updates the timestamps on existing ones. This package lets you do exactly the same thing, but from within a Node.js program or as a standalone command-line tool. At a high level, the package does two things. First, it gives you a command-line tool called nodetouch that behaves almost identically to the standard Unix version. Second, it provides a set of functions you can import directly into your JavaScript code. These functions let you create a file if it doesn't exist, or update its "last accessed" and "last modified" dates if it does. You can run these operations either asynchronously (letting your program continue while it works) or synchronously (pausing everything until the file is ready). This tool is useful for developers building applications that need to manage files programmatically. For example, if you are building a build script that needs to create placeholder files, or an automated backup tool that needs to "touch" a file to mark when it was last checked, this package handles that cleanly. It also supports familiar options like setting a custom date on a file, copying the timestamp from another file, or ensuring a file is only updated and not created if it's missing. The project's main tradeoff is simplicity and familiarity. It doesn't reinvent file management, it just makes a standard, decades-old tool available in a modern JavaScript environment.