@hypernym/utils 3.3.0 → 3.4.0

package/README.md

@@ -119,7 +119,7 @@ isString('@hypernym/utils') // => true
 
 ### exists
 
-Checks if the file or directory exists.
+Checks if the `file` or `directory` exists.
 
 ```ts
 import { exists } from '@hypernym/utils/fs'
@@ -129,7 +129,7 @@ await exists('dir/file.ts') // => true
 
 ### read
 
-Reads the entire contents of a file.
+Reads the entire contents of a `file`.
 
 ```ts
 import { read } from '@hypernym/utils/fs'
@@ -137,9 +137,19 @@ import { read } from '@hypernym/utils/fs'
 await read('dir/subdir/file.ts')
 ```
 
+### readdir
+
+Reads the contents of a `directory` recursively.
+
+```ts
+import { readdir } from '@hypernym/utils/fs'
+
+await readdir('dir/subdir')
+```
+
 ### write
 
-Writes data to a file recursively.
+Writes data to a `file` recursively.
 
 ```ts
 import { write } from '@hypernym/utils/fs'

package/dist/fs/index.mjs

@@ -1,4 +1,4 @@
-import { access, constants, readFile, mkdir as mkdir$1, writeFile as writeFile$1, cp, rm } from 'node:fs/promises';
+import { access, constants, readFile, readdir as readdir$1, mkdir as mkdir$1, writeFile as writeFile$1, cp, rm } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { isURL, isString } from '../index.mjs';
@@ -12,6 +12,15 @@ async function read(path, options = {}) {
   return await readFile(path, { encoding, ...options });
 }
 
+async function readdir(path, options = {}) {
+  const { encoding = "utf-8", recursive = true } = options;
+  return await readdir$1(path, {
+    encoding,
+    recursive,
+    ...options
+  });
+}
+
 async function write(path, data, options) {
   await mkdir$1(dirname(isURL(path) ? fileURLToPath(path) : path), {
     recursive: true
@@ -47,4 +56,4 @@ async function remove(path, options = {}) {
   }
 }
 
-export { copy, exists, mkdir, read, remove, write, writeFile };
+export { copy, exists, mkdir, read, readdir, remove, write, writeFile };

package/dist/types/fs/index.d.ts

@@ -1,7 +1,8 @@
+import { Dirent } from 'node:fs';
 import { writeFile as writeFile$1 } from 'node:fs/promises';
 
 /**
- * Checks if the file or directory exists.
+ * Checks if the `file` or `directory` exists.
  *
  * @example
  *
@@ -37,7 +38,7 @@ interface ReadOptions<T extends ReadEncodingType> {
     flag?: number | string;
 }
 /**
- * Reads the entire contents of a file.
+ * Reads the entire contents of a `file`.
  *
  * @example
  *
@@ -49,9 +50,46 @@ interface ReadOptions<T extends ReadEncodingType> {
  */
 declare function read<T extends ReadEncodingType = BufferEncoding>(path: ReadPath, options?: ReadOptions<T>): Promise<ReadType<T>>;
 
+type ReaddirPath = string | URL;
+type ReaddirEncodingType = BufferEncoding | null | 'buffer' | undefined;
+type ReaddirWithFileType = true | undefined;
+type ReaddirType<E, F> = F extends true ? Dirent : E extends BufferEncoding | undefined ? string : E extends null | 'buffer' ? Buffer : never;
+interface ReaddirOptions<E extends ReaddirEncodingType, F extends ReaddirWithFileType> {
+    /**
+     * If the encoding is set to `'buffer'` or `null`, the filenames returned will be passed as `Buffer` objects.
+     *
+     * @default 'utf-8'
+     */
+    encoding?: E;
+    /**
+     * If `withFileTypes` is set to `true`, the returned array will contain `fs.Dirent` objects.
+     *
+     * @default undefined
+     */
+    withFileTypes?: F;
+    /**
+     * Reads the directory recursively.
+     *
+     * @default true
+     */
+    recursive?: boolean;
+}
+/**
+ * Reads the contents of a `directory` recursively.
+ *
+ * @example
+ *
+ * ```ts
+ * import { readdir } from '@hypernym/utils/fs'
+ *
+ * await readdir('dir/subdir')
+ * ```
+ */
+declare function readdir<E extends ReaddirEncodingType = BufferEncoding, F extends ReaddirWithFileType = undefined>(path: ReaddirPath, options?: ReaddirOptions<E, F>): Promise<ReaddirType<E, F>[]>;
+
 type WritePath = string | URL;
 /**
- * Writes data to a file recursively.
+ * Writes data to a `file` recursively.
  *
  * @example
  *
@@ -182,4 +220,4 @@ interface RemoveOptions {
  */
 declare function remove(path: RemovePath | RemovePath[], options?: RemoveOptions): Promise<void>;
 
-export { type CopyDestination, type CopyOptions, type CopySource, type MakeDirOptions, type MakeDirPath, type ReadEncodingType, type ReadOptions, type ReadPath, type ReadType, type RemoveOptions, type RemovePath, type WritePath, copy, exists, mkdir, read, remove, write, writeFile };
+export { type CopyDestination, type CopyOptions, type CopySource, type MakeDirOptions, type MakeDirPath, type ReadEncodingType, type ReadOptions, type ReadPath, type ReadType, type ReaddirEncodingType, type ReaddirOptions, type ReaddirPath, type ReaddirType, type ReaddirWithFileType, type RemoveOptions, type RemovePath, type WritePath, copy, exists, mkdir, read, readdir, remove, write, writeFile };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypernym/utils",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "author": "Hypernym Studio",
   "description": "A collection of reusable utilities.",
   "license": "MIT",
@@ -45,7 +45,7 @@
     "prepublishOnly": "npm run build"
   },
   "sideEffects": false,
-  "packageManager": "pnpm@9.10.0",
+  "packageManager": "pnpm@9.11.0",
   "engines": {
     "node": ">=20.0.0",
     "pnpm": ">=9.0.0"