async-file-tried 1.2.0 → 1.2.2

package/README.md

@@ -9,10 +9,6 @@ Write more linear, better readable code by getting a concise response. Dependenc
 [![Coverage Status](https://coveralls.io/repos/github/fwalzel/async-file-tried/badge.svg?branch=main)](https://coveralls.io/github/fwalzel/async-file-tried?branch=main)
 [![Known Vulnerabilities](https://snyk.io/test/github/fwalzel/async-file-tried/badge.svg)](https://snyk.io/test/github/fwalzel/async-file-tried/badge.svg)
 
-## License
-
-Copyright (c) 2023–24 Florian Walzel,
-MIT License
 
 ## Install
 
@@ -52,184 +48,623 @@ catch (err) {
 
 ## Extra: joined paths
 
-*async-file-tried* also has an in-built path.join() so that you can alternatively pass all path arguments as array of sub-elements.
+*async-file-tried* also has an in-built `path.join()` so that you can alternatively pass the path argument as array of sub-elements.
 
 You can write i.e.:
 
 ```javascript
-let [res, err] = await fs.appendFile(['fs.__dirname', '..' , 'myfolder', `img_${i}.txt`], 'my text');
+let [res, err] = await fs.appendFile(
+  ['fs.__dirname', '..' , 'myfolder', `img_${i}.txt`], 
+  'my text');
+```
+
+... and the path string will be composed automatically.
+
+## Public Functions (FS Function List)
+
+### [fs.access](https://nodejs.org/api/fs.html#fspromisesaccesspath-mode)
+
+Tests a user's permissions for the file or directory specified by `path`.
+
+Typescript implementation: 
+```typescript
+async (path: string|Array<string>, mode?: number|string)
+```
+
+Usage example: 
+```javascript
+let [res, err] = await fs.access('file.txt', fs.constants.R_OK);
+```
+
+---
+
+### [fs.appendFile](https://nodejs.org/api/fs.html#fspromisesappendfilepath-data-options)
+
+Asynchronously appends data to a file, creating the file if it does not exist.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, data: any, options?: { encoding?: Encoding; mode?: number|string; flag?: Flags; })
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.appendFile('file.txt', 'foo');
+```
+
+---
+
+### [fs.chmod](https://nodejs.org/api/fs.html#filehandlechmodmode)
+
+Changes the permissions of a file or directory.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, mode?: number|string)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.chmod('file.txt', '755');
+```
+
+---
+
+### [fs.chown](https://nodejs.org/api/fs.html#filehandlechownuid-gid)
+
+Changes the ownership of a file by setting the user ID and group ID.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, uid: number, gid: number)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.chown('file.txt', 1541, 999);
+```
+
+---
+
+### [fs.copyFile](https://nodejs.org/api/fs.html#fspromisescopyfilesrc-dest-mode)
+
+Copies a file from one location to another.
+
+Typescript implementation:
+```typescript
+async (srcPath: string|Array<string>, destPath: string|Array<string>, flags?: number)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.copyFile('file.txt', 'file-copy.txt');
+```
+
+---
+
+### [fs.cp](https://nodejs.org/api/fs.html#fspromisescpsrc-dest-options)
+
+Recursively copies files and directories from one location to another.
+
+Typescript implementation:
+```typescript
+async (srcPath: string|Array<string>, destPath: string|Array<string>)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.cp('myfolder', 'myfolder-copy', { recursive: true });
+```
+
+---
+
+### [fs.lchmod](https://nodejs.org/api/fs.html#fspromiseslchmodpath-mode)
+
+Changes the permissions of a symbolic link.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, mode?: number|string)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.lchmod('symlink.txt', '755');
+```
+
+---
+
+### [fs.lchown](https://nodejs.org/api/fs.html#fspromiseslchownpath-uid-gid)
+
+Changes the ownership of a symbolic link.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, uid: number, gid: number)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.lchown('./test/static-testfiles/symlinkToFile-append.txt', 1200, 1201);
+```
+
+---
+
+### [fs.link](https://nodejs.org/api/fs.html#fspromiseslinkexistingpath-newpath)
+
+Creates a new hard link to an existing file.
+
+Typescript implementation:
+```typescript
+async (existingPath: string|Array<string>, newPath: string|Array<string>)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.link('file.txt', 'file-hard-link.txt');
+```
+
+---
+
+### [fs.lstat](https://nodejs.org/api/fs.html#fspromiseslstatpath-options)
+
+Retrieves information about a symbolic link or file without following the link.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, options?: object)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.lstat('symlinkToFile.txt');
+```
+
+---
+
+### [fs.lutimes](https://nodejs.org/api/fs.html#fspromiseslutimespath-atime-mtime)
+
+Changes the access and modification times of a symbolic link.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, atime: Date|number, mtime: Date|number)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.lutimes('file.txt', new Date(), new Date());
+```
+
+---
+
+### [fs.mkdir](https://nodejs.org/api/fs.html#fspromisesmkdirpath-options)
+
+Creates a new directory at the specified path.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, options?: number|string)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.mkdir('./my-new-folder');
+```
+
+---
+
+### [fs.mkdtemp](https://nodejs.org/api/fs.html#fspromisesmkdtempprefix-options)
+
+Creates a uniquely named temporary directory.
+
+Typescript implementation:
+```typescript
+async (prefix: string, encoding?: Encoding)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.mkdtemp('temp-');
+```
+
+---
+
+### [fs.open](https://nodejs.org/api/fs.html#fspromisesopenpath-flags-mode)
+
+Opens a file and returns a file handle for reading or writing.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, flags?: Flags, mode?: number|string)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.open('file.txt', 'r');
+```
+
+---
+
+### [fs.opendir](https://nodejs.org/api/fs.html#fspromisesopendirpath-options)
+
+Opens a directory for reading and returns a directory handle.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, flags?: Flags, mode?: number|string)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.opendir('./test', { encoding: "utf8", bufferSize: 64 });
+```
+
+---
+
+### [fs.readFile](https://nodejs.org/api/fs.html#filehandlereadfileoptions)
+
+Reads the contents of a file into memory.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, options?: Encoding)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.readFile('file.txt', 'utf8');
 ```
 
-... and the file string will be composed automatically.
+---
 
-## API
+### [fs.readdir](https://nodejs.org/api/fs.html#filehandlereadfileoptions)
 
-### FS Function List
+Reads the contents of a directory.
 
-- [fs.access](https://nodejs.org/api/fs.html#fspromisesaccesspath-mode)
-  + Typescript implementation: `async (path: string|Array<string>, mode?: number|string)`
-  + Usage example: `let [res, err] = await fs.access('file.txt', fs.constants.R_OK);`
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, options?: object)
+```
 
-- [fs.appendFile](https://nodejs.org/api/fs.html#fspromisesappendfilepath-data-options)
-  + Typescript implementation: `async (path: string|Array<string>, data: any, options?: { encoding?: Encoding; mode?: number|string; flag?: Flags; })`
-  + Usage example: `let [res, err] = await fs.appendFile('file.txt', 'foo');`
+Usage example:
+```javascript
+let [res, err] = await fs.readdir('./my-directory');
+```
 
-- [fs.chmod](https://nodejs.org/api/fs.html#filehandlechmodmode)
-  + Typescript implementation: `async (path: string|Array<string>, mode?: number|string)`
-  + Usage example: `let [res, err] = await fs.chmod('file.txt', '755');`
+---
 
-- [fs.chown](https://nodejs.org/api/fs.html#filehandlechownuid-gid)
-  + Typescript implementation: `async (path: string|Array<string>, uid: number, gid: number)`
-  + Usage example: `let [res, err] = await fs.chown('file.txt', 1541, 999);`
+### [fs.readlink](https://nodejs.org/api/fs.html#fspromisesreadlinkpath-options)
 
-- [fs.copyFile](https://nodejs.org/api/fs.html#fspromisescopyfilesrc-dest-mode)
-  + Typescript implementation: `async (srcPath: string|Array<string>, destPath: string|Array<string>,flags?: number)`
-  + Usage example: `let [res, err] = await fs.copyFile('file.txt', 'file-copy.txt');`
+Reads the value of a symbolic link.
 
-- [fs.cp](https://nodejs.org/api/fs.html#fspromisescpsrc-dest-options)
-  + Typescript implementation: `async (srcPath: string|Array<string>, destPath: string|Array<string>)`
-  + Usage example: `let [res, err] = await fs.cp('myfolder', 'myfolder-copy', {recursive: true});`
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, options?: object|string)
+```
 
-- [fs.lchmod](https://nodejs.org/api/fs.html#fspromiseslchmodpath-mode)
-  + Typescript implementation: `async (path: string|Array<string>, mode?: number|string)`
-  + Usage example: ``
+Usage example:
+```javascript
+let [res, err] = await fs.readlink('symlinkToFile.txt');
+```
 
-- [fs.lchown](https://nodejs.org/api/fs.html#fspromiseslchownpath-uid-gid)
-  + Typescript implementation: `async (path: string|Array<string>, uid: number, gid: number)`
-  + Usage example: `let [res, err] = await fs.lchown('./test/static-testfiles/symlinkToFile-append.txt', 1200, 1201);`
+---
 
-- [fs.link](https://nodejs.org/api/fs.html#fspromiseslinkexistingpath-newpath)
-  + Typescript implementation: `async (existingPath: string|Array<string>, newPath: string|Array<string>)`
-  + Usage example: `let [res, err] = await fs.link('file.txt', 'file-hard-link.txt');`
+### [fs.realpath](https://nodejs.org/api/fs.html#fspromisesrealpathpath-options)
 
-- [fs.lstat](https://nodejs.org/api/fs.html#fspromiseslstatpath-options)
-   + Typescript implementation: `async (path: string|Array<string>, options?: object)`
-   + Usage example: `let [res, err] = await fs.lstat('symlinkToFile.txt');`
+Resolves a path to its absolute real path, resolving symlinks.
 
-- [fs.lutimes](https://nodejs.org/api/fs.html#fspromiseslutimespath-atime-mtime)
-  + Typescript implementation: `async (path: string|Array<string>, atime: Date|number, mtime: Date|number)`
-  + Usage example: `let [res, err] = await fs.lutimes('file.txt', new Date(), new Date());`
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, options?: object)
+```
 
-- [fs.mkdir](https://nodejs.org/api/fs.html#fspromisesmkdirpath-options)
-  + Typescript implementation: `async (path: string|Array<string>, options?: number|string)`
-  + Usage example: `let [res, err] = await fs.mkdir('./my-new-folder');`
+Usage example:
+```javascript
+let [res, err] = await fs.realpath('./my-folder/../');
+```
+
+---
+
+### [fs.rename](https://nodejs.org/api/fs.html#fspromisesrenameoldpath-newpath)
 
-- [fs.mkdtemp](https://nodejs.org/api/fs.html#fspromisesmkdtempprefix-options)
-  + Typescript implementation: `async (prefix: string, encoding?: Encoding)`
-  + Usage example: `let [res, err] = await fs.mkdtemp('temp-');`
+Renames or moves a file or directory.
 
-- [fs.open](https://nodejs.org/api/fs.html#fspromisesopenpath-flags-mode)
-  + Typescript implementation: `async (path: string|Array<string>, flags?: Flags, mode?: number|string)`
-  + Usage example: `let [res, err] = await fs.open('file.txt', 'r');`
+Typescript implementation:
+```typescript
+async (oldPath: string|Array<string>, newPath: string|Array<string>)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.rename('old.txt', 'new.txt');
+```
+
+---
+
+### [fs.rm](https://nodejs.org/api/fs.html#fspromisesrenameoldpath-newpath)
+
+Removes files or directories.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, options?: object)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.rm('file.txt');
+```
+
+---
+
+### [fs.rmdir](https://nodejs.org/api/fs.html#fspromisesrmdirpath-options)
+
+Removes a directory.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, options?: object)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.rmdir('./my-folder');
+```
+
+---
+
+### [fs.stat](https://nodejs.org/api/fs.html#fspromisesstatpath-options)
+
+Retrieves information about a file or directory.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, options?: object)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.stat('file.txt');
+```
+
+---
+
+### [fs.symlink](https://nodejs.org/api/fs.html#fspromisessymlinktarget-path-type)
+
+Creates a symbolic link to a target file or directory.
+
+Typescript implementation:
+```typescript
+async (target: string|Array<string>, path: string|Array<string>, type?: string)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.symlink('file.txt', 'file-symlink.txt', 'file');
+```
+
+---
+
+### [fs.truncate](https://nodejs.org/api/fs.html#fspromisestruncatepath-len)
+
+Truncates a file to a specified length.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, len: number)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.truncate('file.txt', 760);
+```
+
+---
+
+### [fs.unlink](https://nodejs.org/api/fs.html#fspromisesunlinkpath)
+
+Removes (deletes) a file.
+
+Typescript implementation:
+```typescript
+async (path: string|Array<string>)
+```
+
+Usage example:
+```javascript
+let [res, err] = await fs.unlink('file-symlink.txt');
+```
 
-- [fs.opendir](https://nodejs.org/api/fs.html#fspromisesopendirpath-options)
-  + Typescript implementation: `async (path: string|Array<string>, flags?: Flags, mode?: number|string)`
-  + Usage example: `let [res, err] = await fs.opendir('./test', { encoding: "utf8", bufferSize: 64 } );`
+---
 
-- [fs.readFile](https://nodejs.org/api/fs.html#filehandlereadfileoptions)
-  + Typescript implementation: `async (path: string|Array<string>, options?: Encoding)`
-  + Usage example: `let [res, err] = await fs.readFile('file.txt', 'utf8');`
+### [fs.utimes](https://nodejs.org/api/fs.html#fspromisesutimespath-atime-mtime)
 
-- [fs.readdir](https://nodejs.org/api/fs.html#filehandlereadfileoptions)
-  + Typescript implementation: `async (path: string|Array<string>, options?: object)`
-  + Usage example: `let [res, err] = await fs.readdir('./my-directory');`
+Changes the access and modification times of a file.
 
-- [fs.readlink](https://nodejs.org/api/fs.html#fspromisesreadlinkpath-options)
-  + Typescript implementation: `async (path: string|Array<string>, options?: object|string)`
-  + Usage example: `let [res, err] = await fs.readlink('symlinkToFile.txt');`
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, atime: number|string|Date, mtime: number|string|Date)
+```
 
-- [fs.realpath](https://nodejs.org/api/fs.html#fspromisesrealpathpath-options)
-  + Typescript implementation: `async (path: string|Array<string>, options?: object)`
-  + Usage example: `let [res, err] = await fs.realpath('./my-folder/../' );`
+Usage example:
+```javascript
+let [res, err] = await fs.utimes('file.txt', new Date(), new Date());
+```
 
-- [fs.rename](https://nodejs.org/api/fs.html#fspromisesrenameoldpath-newpath)
-  + Typescript implementation: `async (oldPath: string|Array<string>, newPath: string|Array<string>)`
-  + Usage example: `let [res, err] = await fs.rename('old.txt', 'new.txt' );`
+---
 
-- [fs.rm](https://nodejs.org/api/fs.html#fspromisesrenameoldpath-newpath)
-  + Typescript implementation: `async (path: string|Array<string>, options?: object)`
-  + Usage example: `let [res, err] = await fs.rm('file.txt' );`
+### [fs.watch](https://nodejs.org/api/fs.html#fspromiseswatchfilename-options)
 
-- [fs.rmdir](https://nodejs.org/api/fs.html#fspromisesrmdirpath-options)
-  + Typescript implementation: `async (path: string|Array<string>, options?: object)`
-  + Usage example: `let [res, err] = await fs.rmdir('./my-folder');`
+Watches for changes in a file or directory and emits events.
 
-- [fs.stat](https://nodejs.org/api/fs.html#fspromisesstatpath-options)
-  + Typescript implementation: `async (path: string|Array<string>, options?: object)`
-  + Usage example: `let [res, err] = await fs.stat('file.txt');`
+Typescript implementation:
+```typescript
+async (filename: string|Array<string>, options?: BufferEncoding | "buffer")
+```
 
-- [fs.symlink](https://nodejs.org/api/fs.html#fspromisessymlinktarget-path-type)
-  + Typescript implementation: `async (target: string|Array<string>, path: string|Array<string>, type?: string)`
-  + Usage example: `let [res, err] = await fs.symlink('file.txt', 'file-symlink.txt', 'file');`
+Usage example:
+```javascript
+let [res, err] = await fs.watch('file.txt', (ev, file) => {
+  console.log("Watcher: " + file);
+});
+```
 
-- [fs.truncate](https://nodejs.org/api/fs.html#fspromisestruncatepath-len)
-  + Typescript implementation: `async (path: string|Array<string>, len:number)`
-  + Usage example: `let [res, err] = await fs.truncate('file.txt', 760);`
+---
 
-- [fs.unlink](https://nodejs.org/api/fs.html#fspromisesunlinkpath)
-  + Typescript implementation: `async (path: string|Array<string>)`
-  + Usage example: `let [res, err] = await fs.unlink('file-symlink.txt');`
+### [fs.writeFile](https://nodejs.org/api/fs.html#fspromiseswritefilefile-data-options)
 
-- [fs.utimes](https://nodejs.org/api/fs.html#fspromisesutimespath-atime-mtime)
-  + Typescript implementation: `async (path: string|Array<string>, atime: number|string|Date, mtime: number|string|Date)`
-  + Usage example: `let [res, err] = await fs.utimes('file.txt', new Date(), new Date());`
+Writes data to a file, replacing its contents if it already exists.
 
-- [fs.watch](https://nodejs.org/api/fs.html#fspromiseswatchfilename-options)
-  + Typescript implementation: `async (filename: string|Array<string>, options?: object|string)`
-  + Usage example: `let [res, err] = await fs.watch('file.txt', (ev, file) => { console.log("Watcher: " + file); });`
+Typescript implementation:
+```typescript
+async (path: string|Array<string>, data: any, options?: Encoding)
+```
 
-- [fs.writeFile](https://nodejs.org/api/fs.html#fspromiseswritefilefile-data-options)
-  + Typescript implementation: `async (path: string|Array<string>, data: any, options?: Encoding)`
-  + Usage example: `let [res, err] = await fs.writeFile('file.txt', 'my text', 'utf8');`
+Usage example:
+```javascript
+let [res, err] = await fs.writeFile('file.txt', 'my text', 'utf8');
+```
 
+---
 
 ### The Constants
 
-- [fs.constants](https://nodejs.org/api/fs.html#fspromisesconstants)
-  + The FS [constants](https://nodejs.org/api/fs.html#fs-constants) object
+### [fs.constants](https://nodejs.org/api/fs.html#fspromisesconstants)
 
-- [fs.__dirname](https://nodejs.org/docs/latest/api/globals.html#__dirname)
-  + The equivalent to node’s `__dirname` usable within ES6 Module Syntax. Returns the directory name of the current module.
-  + Implementation: `path.dirname(fileURLToPath(import.meta.url));`
+The `fs.constants` object provides commonly used constants for file operations.
 
-- [fs.__filename](https://nodejs.org/docs/latest/api/globals.html#__filename)
-  + The equivalent to node’s `__filename` usable within ES6 Module Syntax. Returns the filename of the code which is executed.
-  + Implementation: `fileURLToPath(import.meta.url);`
+---
+
+### [fs.__dirname](https://nodejs.org/docs/latest/api/globals.html#__dirname)
+
+Equivalent to Node’s `__dirname` but usable within ES modules. Returns the directory name of the current module.
+
+Implementation:
+```javascript
+path.dirname(fileURLToPath(import.meta.url));
+```
+
+---
+
+### [fs.__filename](https://nodejs.org/docs/latest/api/globals.html#__filename)
+
+Equivalent to Node’s `__filename` but usable within ES modules. Returns the absolute filename of the current module.
+
+Implementation:
+```javascript
+fileURLToPath(import.meta.url);
+```
+
+---
 
 
 ### Bonus Functions
 
-- fs.exists
-  + Checks if a file or directory exists, returns boolean
-  + Typescript implementation: `async (path: string|Array<string>)`
-  + Usage example: `let res = await fs.exists('file.txt');`
-
-- fs.ensureDir
-  + Checks if a directory exists, creates it if not
-  + Typescript implementation: `async (dir: string|Array<string>)`
-  + Usage example: `let res = await fs.ensureDir('./my-dir');` 
-
-- fs.readJson
-  + Reads a JSON file and returns it as parsed Javascript object.
-  + Typescript implementation: `async (path: string|Array<string>, options?: Encoding)`
-  + Usage example: `let [res, err] = await fs.readJson('my.json');`
-
-- fs.writeJson
-  + Expects a Javascript object, will stringify it and write it out as JSON.
-  + Typescript implementation: `async (path: string|Array<string>, data: Object, options?: Encoding)`
-  + Usage example: `let [res, err] = await fs.writeJson('my.json', { key : "value" });`
-
-- fs.readTextFile
-  + Reads a text file as UTF8
-  + Typescript implementation: `async (path: string|Array<string>)`
-  + Usage example: `let [res, err] = await fs.readTextFile('file.txt');`
-
-- fs.writeTextFile
-  + Writes out a String as UTF8
-  + Typescript implementation: `async (path: string|Array<string>, data: string)`
-  + Usage example: `let [res, err] = await fs.writeTextFile('file.txt', 'Hello world!');`
-
-- fs.asyncHandler
-  + Takes any asynchronous Function and will internally wrap a try-catch block around it. The Return is given in the tuple pattern `[res, err]`.
-  + Typescript implementation: `asyncHandler = async (func: Function)`
-  + Usage example: `let [res, err] = await fs.asyncHandler(() => await myCustomFunction(someParam));`
+---
+
+### fs.exists
+Checks if a file or directory exists, returns boolean.
+Typescript implementation: 
+```typescript
+async (path: string|Array<string>)
+```
+Usage example: 
+```javascript
+let res = await fs.exists('file.txt');
+```
+
+---
+
+### fs.ensureDir
+Checks if a directory exists, creates it if not.
+Typescript implementation: 
+```typescript
+async (dir: string|Array<string>)
+```
+Usage example: 
+```javascript
+let res = await fs.ensureDir('./my-dir');
+```
+
+---
+
+### fs.readJson
+Reads a JSON file and returns it as parsed Javascript object.
+Typescript implementation: 
+```typescript
+async (path: string|Array<string>, options?: Encoding)
+```
+Usage example: 
+```javascript
+let [res, err] = await fs.readJson('my.json');
+```
+
+---
+
+### fs.writeJson
+Expects a Javascript object, will stringify it and write it out as JSON.
+Typescript implementation: 
+```typescript
+async (path: string|Array<string>, data: Object, options?: Encoding)
+```
+Usage example: 
+```javascript
+let [res, err] = await fs.writeJson('my.json', { key : "value" });
+```
+
+---
+
+### fs.readTextFile
+Reads a text file as UTF8.
+Typescript implementation: 
+```typescript
+async (path: string|Array<string>)
+```
+Usage example: 
+```javascript
+let [res, err] = await fs.readTextFile('file.txt');
+```
+
+---
+
+### fs.writeTextFile
+Writes out a String as UTF8.
+Typescript implementation: 
+```typescript
+async (path: string|Array<string>, data: string)
+```
+Usage example: 
+```javascript
+let [res, err] = await fs.writeTextFile('file.txt', 'Hello world!');
+```
+
+---
+
+### The Async Handler
+
+This Handler is behind all Async-file-tried functions. You can pass any function (wrapped in an anonymous function) to it, 
+and the Result/ Error will be returned as tuple.  
+
+### fs.asyncHandler
+Takes any asynchronous Function and will internally wrap a try-catch block around it. The Return is given in the tuple pattern `[res, err]`.
+Typescript implementation: 
+```typescript
+asyncHandler = async (func: Function)
+```
+Usage example: 
+```javascript
+let [res, err] = await fs.asyncHandler(() => await myCustomFunction(someParam));
+```
+---
+
+## Run tests
+
+```sh
+npm test
+```
+
+## License
+
+Copyright (c) 2023–25 Florian Walzel,
+MIT License

package/dist/index.d.ts

@@ -37,14 +37,14 @@ declare const fs: {
     truncate: (path: string | Array<string>, len: number) => Promise<any[]>;
     unlink: (path: string | Array<string>) => Promise<any[]>;
     utimes: (path: string | Array<string>, atime: number | string | Date, mtime: number | string | Date) => Promise<any[]>;
-    watch: (filename: string | Array<string>, options?: object | string) => Promise<any[]>;
+    watch: (filename: string | Array<string>, options?: BufferEncoding | "buffer") => Promise<any[]>;
     writeFile: (path: string | Array<string>, data: any, options?: Encoding) => Promise<any[]>;
     constants: typeof fsNormal.constants;
     __dirname: string;
     __filename: string;
     asyncHandler: (func: Function) => Promise<any[]>;
     exists: (path: string | Array<string>) => Promise<boolean>;
-    ensureDir: (dir: string | Array<string>) => Promise<any[]>;
+    ensureDir: (dir: string | Array<string>) => Promise<boolean>;
     readJson: (path: string | Array<string>, options?: Encoding) => Promise<any[]>;
     writeJson: (path: string | Array<string>, data: Object, options?: Encoding) => Promise<any[]>;
     readTextFile: (path: string | Array<string>) => Promise<any[]>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -366,8 +366,14 @@ const exists = async (path) => {
 const ensureDir = async (dir) => {
     const pathResolved = __resolvePath(dir);
     let [acc, err] = await access(pathResolved);
-    if (err)
-        return await mkdir(pathResolved, { recursive: true });
+    if (err) {
+        let [r, e] = await mkdir(pathResolved, { recursive: true });
+        if (e) {
+            console.error(e);
+            return false;
+        }
+    }
+    return true;
 };
 /**
  *

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/index.ts

@@ -352,7 +352,7 @@ const utimes = async (path: string|Array<string>, atime: number|string|Date, mti
  * @param options
  * @returns {Promise<*[]>}
  */
-const watch = async (filename: string|Array<string>, options?: object|string) => {
+const watch = async (filename: string|Array<string>, options?: BufferEncoding | "buffer") => {
   const filenameResolved = __resolvePath(filename);
   return await asyncHandler(() => fsp.watch(filenameResolved, options));
 };
@@ -411,8 +411,14 @@ const exists = async (path: string|Array<string>) => {
 const ensureDir = async (dir: string|Array<string>)=> {
   const pathResolved = __resolvePath(dir);
   let [acc, err] = await access(pathResolved);
-  if (err)
-    return await mkdir(pathResolved, { recursive: true })
+  if (err) {
+    let [r,e] = await mkdir(pathResolved, { recursive: true })
+    if (e) {
+      console.error(e);
+      return false;
+    }
+  }
+  return true;
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "async-file-tried",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "A try-catch wrapper around node’s fs/promises.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,11 +21,11 @@
   },
   "homepage": "https://github.com/fwalzel/async-file-tried#readme",
   "devDependencies": {
-    "@types/node": "^20.9.5",
+    "@types/node": "^24.5.2",
     "c8": "^8.0.1",
-    "chai": "^4.3.6",
-    "mocha": "^10.1.0",
-    "typescript": "^5.7.2"
+    "chai": "^6.0.1",
+    "mocha": "^11.7.2",
+    "typescript": "^5.9.2"
   },
   "keywords": [
     "fs promises",

package/test/index.test.js

@@ -369,35 +369,53 @@ describe('Tests for async-file-tried', () => {
     assert.equal(res, false);
   });
 
-  it('[63] ERR: fs.exists shall return TRUE file does not exist', async () => {
+  it('[63] RES: fs.exists shall return TRUE file exists', async () => {
     let res = await fs.exists('./test/static-testfiles/file.txt');
     assert.equal(res, true);
   });
 
-  it('[64] ERR: fs.writeJson shall error when file does not exist', async () => {
+
+  it('[64] RES: fs.exists shall return TRUE if folder exists', async () => {
+    let res = await fs.ensureDir('./test/static-testfiles');
+    assert.equal(res, true);
+  });
+
+  it('[65] RES: fs.exists shall return TRUE if folder was created', async () => {
+    let res = await fs.ensureDir('./test/static-testfiles/ensure-folder');
+    assert.equal(res, true);
+  });
+
+  it('[66] ERR: fs.writeJson shall error when file does not exist', async () => {
     let [res, err] = await fs.writeJson('', '');
     assert.notEqual(err, null);
   });
 
-  it('[65] RES: fs.writeJson shall return valid result when JSON was written', async () => {
+  it('[67] RES: fs.writeJson shall return valid result when JSON was written', async () => {
     let [res, err] = await fs.writeJson('./test/static-testfiles/test.json', { key : "value" });
     assert.equal(err, null);
   });
 
-  it('[66] ERR: fs.readJson shall error when file does not exist', async () => {
+  it('[68] ERR: fs.readJson shall error when file does not exist', async () => {
     let [res, err] = await fs.readJson('');
     assert.notEqual(err, null);
   });
 
-  it('[67] RES: fs.readJson shall return object when JSON was read', async () => {
+  it('[69] RES: fs.readJson shall return object when JSON was read', async () => {
     let [res, err] = await fs.readJson('./test/static-testfiles/test.json', 'utf8');
     assert.isObject(res);
   });
 
+  it('Cleanup', async () => {
+    // cleanup symlink from test run:
+    await fs.unlink('./test/static-testfiles/symlinkToFile-append.txt');
+
+    // cleanup symlink from test run:
+    await fs.rm('./test/static-testfiles/file.txt');
+
+    // cleanup symlink from test run:
+    await fs.rmdir('./test/static-testfiles/ensure-folder');
+  });
+
 });
 
-// cleanup symlink from test run:
-await fs.unlink('./test/static-testfiles/symlinkToFile-append.txt');
 
-// cleanup symlink from test run:
-await fs.rm('./test/static-testfiles/file.txt');

package/want.md

@@ -1,4 +0,0 @@
-- Logo (!)
-– bonus functions: file exists, ensureDir, writeTextFile,  readTextFile
-- importable as common JS
-- README: how to use in typescript, explain asyncHandler