@catbee/utils 0.0.1 → 0.0.2

package/build/esnext/utils/dir.utils.d.ts

@@ -1,3 +1,4 @@
+import fs from "fs";
 /**
  * Ensures that a directory exists, creating parent directories if needed (like `mkdir -p`).
  *
@@ -72,4 +73,124 @@ export declare function getDirSize(dirPath: string): Promise<number>;
  * @returns {() => void} A function to stop watching the directory.
  */
 export declare function watchDir(dirPath: string, callback: (eventType: "rename" | "change", filename: string | null) => void): () => void;
+/**
+ * Finds files matching a glob pattern.
+ *
+ * @param {string} pattern - Glob pattern to match files.
+ * @param {object} [options] - Options for glob pattern matching.
+ * @param {string} [options.cwd] - Current working directory for relative patterns.
+ * @param {boolean} [options.dot=false] - Include dotfiles in matches.
+ * @param {boolean} [options.nodir=true] - Only match files, not directories.
+ * @returns {Promise<string[]>} Array of matched file paths.
+ * @throws {Error} If pattern matching fails.
+ */
+export declare function findFilesByPattern(pattern: string, options?: {
+    cwd?: string;
+    dot?: boolean;
+    nodir?: boolean;
+}): Promise<string[]>;
+/**
+ * Gets all subdirectories in a directory.
+ *
+ * @param {string} dirPath - The directory to search in.
+ * @param {boolean} [recursive=false] - Whether to include subdirectories recursively.
+ * @returns {Promise<string[]>} Array of absolute subdirectory paths.
+ * @throws {Error} If directory cannot be read.
+ */
+export declare function getSubdirectories(dirPath: string, recursive?: boolean): Promise<string[]>;
+/**
+ * Ensures a directory exists and is empty.
+ *
+ * @param {string} dirPath - Path to the directory.
+ * @returns {Promise<void>} Resolves when the directory exists and is empty.
+ * @throws {Error} If directory cannot be created or emptied.
+ */
+export declare function ensureEmptyDir(dirPath: string): Promise<void>;
+/**
+ * Creates a temporary directory with optional auto-cleanup.
+ *
+ * @param {object} [options] - Options for the temporary directory.
+ * @param {string} [options.prefix='tmp-'] - Prefix for the directory name.
+ * @param {string} [options.parentDir=os.tmpdir()] - Parent directory.
+ * @param {boolean} [options.cleanup=false] - Whether to register cleanup on process exit.
+ * @returns {Promise<{ path: string, cleanup: () => Promise<void> }>} Object with directory path and cleanup function.
+ * @throws {Error} If directory cannot be created.
+ */
+export declare function createTempDir(options?: {
+    prefix?: string;
+    parentDir?: string;
+    cleanup?: boolean;
+}): Promise<{
+    path: string;
+    cleanup: () => Promise<void>;
+}>;
+/**
+ * Finds the newest file in a directory.
+ *
+ * @param {string} dirPath - Directory to search.
+ * @param {boolean} [recursive=false] - Whether to search subdirectories.
+ * @returns {Promise<string | null>} Path to the newest file or null if no files.
+ * @throws {Error} If directory cannot be read.
+ */
+export declare function findNewestFile(dirPath: string, recursive?: boolean): Promise<string | null>;
+/**
+ * Finds the oldest file in a directory.
+ *
+ * @param {string} dirPath - Directory to search.
+ * @param {boolean} [recursive=false] - Whether to search subdirectories.
+ * @returns {Promise<string | null>} Path to the oldest file or null if no files.
+ * @throws {Error} If directory cannot be read.
+ */
+export declare function findOldestFile(dirPath: string, recursive?: boolean): Promise<string | null>;
+/**
+ * Finds files or directories in a directory matching a predicate function.
+ *
+ * @param {string} dirPath - Directory to search.
+ * @param {(path: string, stat: fs.Stats) => boolean | Promise<boolean>} predicate - Function to test each path.
+ * @param {boolean} [recursive=false] - Whether to search subdirectories.
+ * @returns {Promise<string[]>} Array of matching paths.
+ * @throws {Error} If directory cannot be read.
+ */
+export declare function findInDir(dirPath: string, predicate: (path: string, stat: fs.Stats) => boolean | Promise<boolean>, recursive?: boolean): Promise<string[]>;
+/**
+ * Watches a directory recursively for file changes.
+ *
+ * @param {string} dirPath - Base directory path to watch.
+ * @param {(eventType: "rename" | "change", filename: string) => void} callback - Callback for each change event.
+ * @param {boolean} [includeSubdirs=true] - Whether to watch subdirectories.
+ * @returns {Promise<() => void>} A function to stop watching the directory.
+ * @throws {Error} If directory cannot be watched.
+ */
+export declare function watchDirRecursive(dirPath: string, callback: (eventType: "rename" | "change", filename: string) => void, includeSubdirs?: boolean): Promise<() => void>;
+/**
+ * Gets detailed directory statistics including file count, directory count, and size.
+ *
+ * @param {string} dirPath - Path to the directory.
+ * @returns {Promise<{ fileCount: number, dirCount: number, totalSize: number }>} Directory statistics.
+ * @throws {Error} If directory cannot be read.
+ */
+export declare function getDirStats(dirPath: string): Promise<{
+    fileCount: number;
+    dirCount: number;
+    totalSize: number;
+}>;
+/**
+ * Walks through a directory hierarchy, calling a visitor function for each entry.
+ *
+ * @param {string} dirPath - Starting directory path.
+ * @param {object} options - Options for walking the directory.
+ * @param {(entry: { path: string, name: string, isDirectory: boolean, stats: fs.Stats }) => boolean | void | Promise<boolean | void>} options.visitorFn -
+ *   Function called for each file/directory. Return false to skip a directory.
+ * @param {'pre' | 'post'} [options.traversalOrder='pre'] - Whether to visit directories before or after their contents.
+ * @throws {Error} If directory cannot be read.
+ */
+export declare function walkDir(dirPath: string, options: {
+    visitorFn: (entry: {
+        path: string;
+        name: string;
+        isDirectory: boolean;
+        stats: fs.Stats;
+    }) => boolean | void | Promise<boolean | void>;
+    traversalOrder?: "pre" | "post";
+}): Promise<void>;
 //# sourceMappingURL=dir.utils.d.ts.map

package/build/esnext/utils/dir.utils.js

@@ -1,6 +1,9 @@
+import os from "os";
 import fs from "fs";
 import fsp from "fs/promises";
 import path from "path";
+import { glob } from "glob";
+import { randomBytes } from "crypto";
 /**
  * Ensures that a directory exists, creating parent directories if needed (like `mkdir -p`).
  *
@@ -147,4 +150,307 @@ export function watchDir(dirPath, callback) {
     });
     return () => watcher.close();
 }
+/**
+ * Finds files matching a glob pattern.
+ *
+ * @param {string} pattern - Glob pattern to match files.
+ * @param {object} [options] - Options for glob pattern matching.
+ * @param {string} [options.cwd] - Current working directory for relative patterns.
+ * @param {boolean} [options.dot=false] - Include dotfiles in matches.
+ * @param {boolean} [options.nodir=true] - Only match files, not directories.
+ * @returns {Promise<string[]>} Array of matched file paths.
+ * @throws {Error} If pattern matching fails.
+ */
+export async function findFilesByPattern(pattern, options = {}) {
+    const defaultOptions = Object.assign({ nodir: true }, options);
+    return glob(pattern, defaultOptions);
+}
+/**
+ * Gets all subdirectories in a directory.
+ *
+ * @param {string} dirPath - The directory to search in.
+ * @param {boolean} [recursive=false] - Whether to include subdirectories recursively.
+ * @returns {Promise<string[]>} Array of absolute subdirectory paths.
+ * @throws {Error} If directory cannot be read.
+ */
+export async function getSubdirectories(dirPath, recursive = false) {
+    const entries = await fsp.readdir(dirPath, { withFileTypes: true });
+    const dirs = entries
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => path.join(dirPath, entry.name));
+    if (recursive && dirs.length > 0) {
+        const nestedDirs = await Promise.all(dirs.map((dir) => getSubdirectories(dir, true)));
+        return [...dirs, ...nestedDirs.flat()];
+    }
+    return dirs;
+}
+/**
+ * Ensures a directory exists and is empty.
+ *
+ * @param {string} dirPath - Path to the directory.
+ * @returns {Promise<void>} Resolves when the directory exists and is empty.
+ * @throws {Error} If directory cannot be created or emptied.
+ */
+export async function ensureEmptyDir(dirPath) {
+    if (await isDirectory(dirPath)) {
+        await emptyDir(dirPath);
+    }
+    else {
+        try {
+            await fsp.unlink(dirPath);
+        }
+        catch (error) {
+            // Ignore if file doesn't exist
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+        await ensureDir(dirPath);
+    }
+}
+/**
+ * Creates a temporary directory with optional auto-cleanup.
+ *
+ * @param {object} [options] - Options for the temporary directory.
+ * @param {string} [options.prefix='tmp-'] - Prefix for the directory name.
+ * @param {string} [options.parentDir=os.tmpdir()] - Parent directory.
+ * @param {boolean} [options.cleanup=false] - Whether to register cleanup on process exit.
+ * @returns {Promise<{ path: string, cleanup: () => Promise<void> }>} Object with directory path and cleanup function.
+ * @throws {Error} If directory cannot be created.
+ */
+export async function createTempDir(options = {}) {
+    const prefix = options.prefix || "tmp-";
+    const parentDir = options.parentDir || os.tmpdir();
+    const dirName = `${prefix}${randomBytes(6).toString("hex")}`;
+    const tempDirPath = path.join(parentDir, dirName);
+    await ensureDir(tempDirPath);
+    const cleanup = async () => {
+        try {
+            await deleteDirRecursive(tempDirPath);
+        }
+        catch (_a) {
+            // Ignore cleanup errors
+        }
+    };
+    if (options.cleanup) {
+        process.once("exit", () => {
+            try {
+                fs.rmSync(tempDirPath, { recursive: true, force: true });
+            }
+            catch (_a) {
+                // Ignore cleanup errors on exit
+            }
+        });
+        // Handle signals for better cleanup
+        ["SIGINT", "SIGTERM", "SIGUSR1", "SIGUSR2"].forEach((signal) => {
+            process.once(signal, () => {
+                cleanup().then(() => process.exit());
+            });
+        });
+    }
+    return { path: tempDirPath, cleanup };
+}
+/**
+ * Finds the newest file in a directory.
+ *
+ * @param {string} dirPath - Directory to search.
+ * @param {boolean} [recursive=false] - Whether to search subdirectories.
+ * @returns {Promise<string | null>} Path to the newest file or null if no files.
+ * @throws {Error} If directory cannot be read.
+ */
+export async function findNewestFile(dirPath, recursive = false) {
+    const files = await listFiles(dirPath, recursive);
+    if (files.length === 0)
+        return null;
+    const stats = await Promise.all(files.map(async (file) => ({
+        path: file,
+        mtime: (await fsp.stat(file)).mtime,
+    })));
+    return stats.sort((a, b) => b.mtime.getTime() - a.mtime.getTime())[0].path;
+}
+/**
+ * Finds the oldest file in a directory.
+ *
+ * @param {string} dirPath - Directory to search.
+ * @param {boolean} [recursive=false] - Whether to search subdirectories.
+ * @returns {Promise<string | null>} Path to the oldest file or null if no files.
+ * @throws {Error} If directory cannot be read.
+ */
+export async function findOldestFile(dirPath, recursive = false) {
+    const files = await listFiles(dirPath, recursive);
+    if (files.length === 0)
+        return null;
+    const stats = await Promise.all(files.map(async (file) => ({
+        path: file,
+        mtime: (await fsp.stat(file)).mtime,
+    })));
+    return stats.sort((a, b) => a.mtime.getTime() - b.mtime.getTime())[0].path;
+}
+/**
+ * Finds files or directories in a directory matching a predicate function.
+ *
+ * @param {string} dirPath - Directory to search.
+ * @param {(path: string, stat: fs.Stats) => boolean | Promise<boolean>} predicate - Function to test each path.
+ * @param {boolean} [recursive=false] - Whether to search subdirectories.
+ * @returns {Promise<string[]>} Array of matching paths.
+ * @throws {Error} If directory cannot be read.
+ */
+export async function findInDir(dirPath, predicate, recursive = false) {
+    const entries = await fsp.readdir(dirPath, { withFileTypes: true });
+    const results = [];
+    for (const entry of entries) {
+        const entryPath = path.join(dirPath, entry.name);
+        const stat = await fsp.stat(entryPath);
+        if (await predicate(entryPath, stat)) {
+            results.push(entryPath);
+        }
+        if (recursive && entry.isDirectory()) {
+            const nestedResults = await findInDir(entryPath, predicate, true);
+            results.push(...nestedResults);
+        }
+    }
+    return results;
+}
+/**
+ * Watches a directory recursively for file changes.
+ *
+ * @param {string} dirPath - Base directory path to watch.
+ * @param {(eventType: "rename" | "change", filename: string) => void} callback - Callback for each change event.
+ * @param {boolean} [includeSubdirs=true] - Whether to watch subdirectories.
+ * @returns {Promise<() => void>} A function to stop watching the directory.
+ * @throws {Error} If directory cannot be watched.
+ */
+export async function watchDirRecursive(dirPath, callback, includeSubdirs = true) {
+    // Normalize the path to ensure consistent path separators
+    const normalizedBasePath = path.normalize(dirPath);
+    // Create watchers for the base dir and all subdirectories
+    const watchers = [];
+    // Helper function to add a watcher for a directory
+    const addWatcher = (dir) => {
+        try {
+            const watcher = fs.watch(dir, (eventType, filename) => {
+                if (!filename)
+                    return;
+                const fullPath = path.join(dir, filename);
+                // Make the path relative to the base directory
+                const relativePath = path.relative(normalizedBasePath, fullPath);
+                callback(eventType, relativePath);
+                // If a new directory is created, we should watch it
+                if (eventType === "rename" && includeSubdirs) {
+                    setTimeout(async () => {
+                        try {
+                            if (await isDirectory(fullPath)) {
+                                addWatcher(fullPath);
+                            }
+                        }
+                        catch (_a) {
+                            // Ignore errors checking newly created items
+                        }
+                    }, 100);
+                }
+            });
+            watchers.push(watcher);
+        }
+        catch (_a) {
+            // Silently ignore directories we can't watch
+        }
+    };
+    // Add watcher for the base directory
+    addWatcher(normalizedBasePath);
+    // If watching subdirectories, add watchers for all existing subdirectories
+    if (includeSubdirs) {
+        const subdirs = await getSubdirectories(normalizedBasePath, true);
+        for (const subdir of subdirs) {
+            addWatcher(subdir);
+        }
+    }
+    // Return a function to close all watchers
+    return () => {
+        watchers.forEach((watcher) => watcher.close());
+    };
+}
+/**
+ * Gets detailed directory statistics including file count, directory count, and size.
+ *
+ * @param {string} dirPath - Path to the directory.
+ * @returns {Promise<{ fileCount: number, dirCount: number, totalSize: number }>} Directory statistics.
+ * @throws {Error} If directory cannot be read.
+ */
+export async function getDirStats(dirPath) {
+    let fileCount = 0;
+    let dirCount = 0;
+    let totalSize = 0;
+    async function processDir(currentPath) {
+        const entries = await fsp.readdir(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const entryPath = path.join(currentPath, entry.name);
+            if (entry.isDirectory()) {
+                dirCount++;
+                await processDir(entryPath);
+            }
+            else if (entry.isFile()) {
+                fileCount++;
+                const stat = await fsp.stat(entryPath);
+                totalSize += stat.size;
+            }
+        }
+    }
+    await processDir(dirPath);
+    return { fileCount, dirCount, totalSize };
+}
+/**
+ * Walks through a directory hierarchy, calling a visitor function for each entry.
+ *
+ * @param {string} dirPath - Starting directory path.
+ * @param {object} options - Options for walking the directory.
+ * @param {(entry: { path: string, name: string, isDirectory: boolean, stats: fs.Stats }) => boolean | void | Promise<boolean | void>} options.visitorFn -
+ *   Function called for each file/directory. Return false to skip a directory.
+ * @param {'pre' | 'post'} [options.traversalOrder='pre'] - Whether to visit directories before or after their contents.
+ * @throws {Error} If directory cannot be read.
+ */
+export async function walkDir(dirPath, options) {
+    const traversalOrder = options.traversalOrder || "pre";
+    const entries = await fsp.readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const entryPath = path.join(dirPath, entry.name);
+        const stats = await fsp.stat(entryPath);
+        const entryInfo = {
+            path: entryPath,
+            name: entry.name,
+            isDirectory: entry.isDirectory(),
+            stats,
+        };
+        if (entry.isDirectory()) {
+            // Pre-order: visit directory before its contents
+            if (traversalOrder === "pre") {
+                const shouldContinue = await options.visitorFn(entryInfo);
+                // If the visitor returns false, don't recurse into this directory
+                if (shouldContinue !== false) {
+                    await walkDir(entryPath, options);
+                }
+            }
+            else {
+                // Post-order: visit directory after its contents
+                await walkDir(entryPath, options);
+                await options.visitorFn(entryInfo);
+            }
+        }
+        else {
+            // Files are always visited when encountered
+            await options.visitorFn(entryInfo);
+        }
+    }
+    if (traversalOrder === "post") {
+        // Only visit the root if this is the top-level call (not for subdirectories)
+        // But since this function is always called recursively, always visit after children
+        const stats = await fsp.stat(dirPath);
+        const entryInfo = {
+            path: dirPath,
+            name: path.basename(dirPath),
+            isDirectory: true,
+            stats,
+        };
+        await options.visitorFn(entryInfo);
+    }
+}
 //# sourceMappingURL=dir.utils.js.map

package/build/esnext/utils/dir.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"dir.utils.js","sourceRoot":"","sources":["../../../src/utils/dir.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"fs\";\nimport fsp from \"fs/promises\";\nimport path from \"path\";\n\n/**\n * Ensures that a directory exists, creating parent directories if needed (like `mkdir -p`).\n *\n * @param {string} dirPath - The directory path to ensure.\n * @returns {Promise<void>} Resolves when the directory exists.\n * @throws {Error} If directory cannot be created.\n */\nexport async function ensureDir(dirPath: string): Promise<void> {\n  await fsp.mkdir(dirPath, { recursive: true });\n}\n\n/**\n * Recursively lists all files in a directory.\n *\n * @param {string} dirPath - The base directory.\n * @param {boolean} [recursive=false] - Whether to recurse into subdirectories.\n * @returns {Promise<string[]>} Array of absolute file paths.\n * @throws {Error} If the directory cannot be read.\n */\nexport async function listFiles(\n  dirPath: string,\n  recursive = false,\n): Promise<string[]> {\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n  const files: string[] = [];\n\n  for (const entry of entries) {\n    const fullPath = path.join(dirPath, entry.name);\n\n    if (entry.isFile()) {\n      files.push(fullPath);\n    } else if (recursive && entry.isDirectory()) {\n      const nestedFiles = await listFiles(fullPath, true);\n      files.push(...nestedFiles);\n    }\n  }\n\n  return files;\n}\n\n/**\n * Deletes a directory and all its contents recursively (like `rm -rf`).\n *\n * @param {string} dirPath - Directory to delete.\n * @returns {Promise<void>} Resolves when deletion is complete.\n * @throws {Error} If deletion fails.\n */\nexport async function deleteDirRecursive(dirPath: string): Promise<void> {\n  await fsp.rm(dirPath, { recursive: true, force: true });\n}\n\n/**\n * Checks whether a given path is a directory.\n *\n * @param {string} pathStr - Path to check.\n * @returns {Promise<boolean>} True if the path is a directory, else false.\n */\nexport async function isDirectory(pathStr: string): Promise<boolean> {\n  try {\n    const stat = await fsp.stat(pathStr);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Recursively copies a directory and all its contents to a destination.\n *\n * @param {string} src - Source directory path.\n * @param {string} dest - Destination directory path.\n * @returns {Promise<void>} Resolves when copy is complete.\n * @throws {Error} If source does not exist or copy fails.\n */\nexport async function copyDir(src: string, dest: string): Promise<void> {\n  await ensureDir(dest);\n  const entries = await fsp.readdir(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const srcPath = path.join(src, entry.name);\n    const destPath = path.join(dest, entry.name);\n\n    if (entry.isDirectory()) {\n      await copyDir(srcPath, destPath);\n    } else {\n      await fsp.copyFile(srcPath, destPath);\n    }\n  }\n}\n\n/**\n * Moves a directory to a new location by copying and deleting the original.\n *\n * @param {string} src - Source directory path.\n * @param {string} dest - Destination directory path.\n * @returns {Promise<void>} Resolves when move is complete.\n * @throws {Error} If copy or deletion fails.\n */\nexport async function moveDir(src: string, dest: string): Promise<void> {\n  await copyDir(src, dest);\n  await deleteDirRecursive(src);\n}\n\n/**\n * Empties a directory by deleting all files and subdirectories inside it.\n *\n * @param {string} dirPath - Path to the directory to empty.\n * @returns {Promise<void>} Resolves when the directory has been emptied.\n * @throws {Error} If files or subdirectories cannot be removed.\n */\nexport async function emptyDir(dirPath: string): Promise<void> {\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name);\n\n    if (entry.isDirectory()) {\n      await fsp.rm(entryPath, { recursive: true, force: true });\n    } else {\n      await fsp.unlink(entryPath);\n    }\n  }\n}\n\n/**\n * Calculates the total size (in bytes) of all files in a directory (recursive).\n *\n * @param {string} dirPath - Path to the directory.\n * @returns {Promise<number>} Total size in bytes.\n * @throws {Error} If any file stats cannot be read.\n */\nexport async function getDirSize(dirPath: string): Promise<number> {\n  let total = 0;\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name);\n    if (entry.isDirectory()) {\n      total += await getDirSize(entryPath);\n    } else {\n      const stat = await fsp.stat(entryPath);\n      total += stat.size;\n    }\n  }\n\n  return total;\n}\n\n/**\n * Watches a directory for file changes and calls a callback on each event.\n *\n * @param {string} dirPath - Directory path to watch.\n * @param {(eventType: \"rename\" | \"change\", filename: string | null) => void} callback - Callback for each change event.\n * @returns {() => void} A function to stop watching the directory.\n */\nexport function watchDir(\n  dirPath: string,\n  callback: (eventType: \"rename\" | \"change\", filename: string | null) => void,\n): () => void {\n  const watcher = fs.watch(dirPath, (eventType, filename) => {\n    callback(eventType, filename);\n  });\n\n  return () => watcher.close();\n}\n"]}
+{"version":3,"file":"dir.utils.js","sourceRoot":"","sources":["../../../src/utils/dir.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import os from \"os\";\nimport fs from \"fs\";\nimport fsp from \"fs/promises\";\nimport path from \"path\";\nimport { glob } from \"glob\";\nimport { randomBytes } from \"crypto\";\n\n/**\n * Ensures that a directory exists, creating parent directories if needed (like `mkdir -p`).\n *\n * @param {string} dirPath - The directory path to ensure.\n * @returns {Promise<void>} Resolves when the directory exists.\n * @throws {Error} If directory cannot be created.\n */\nexport async function ensureDir(dirPath: string): Promise<void> {\n  await fsp.mkdir(dirPath, { recursive: true });\n}\n\n/**\n * Recursively lists all files in a directory.\n *\n * @param {string} dirPath - The base directory.\n * @param {boolean} [recursive=false] - Whether to recurse into subdirectories.\n * @returns {Promise<string[]>} Array of absolute file paths.\n * @throws {Error} If the directory cannot be read.\n */\nexport async function listFiles(\n  dirPath: string,\n  recursive = false,\n): Promise<string[]> {\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n  const files: string[] = [];\n\n  for (const entry of entries) {\n    const fullPath = path.join(dirPath, entry.name);\n\n    if (entry.isFile()) {\n      files.push(fullPath);\n    } else if (recursive && entry.isDirectory()) {\n      const nestedFiles = await listFiles(fullPath, true);\n      files.push(...nestedFiles);\n    }\n  }\n\n  return files;\n}\n\n/**\n * Deletes a directory and all its contents recursively (like `rm -rf`).\n *\n * @param {string} dirPath - Directory to delete.\n * @returns {Promise<void>} Resolves when deletion is complete.\n * @throws {Error} If deletion fails.\n */\nexport async function deleteDirRecursive(dirPath: string): Promise<void> {\n  await fsp.rm(dirPath, { recursive: true, force: true });\n}\n\n/**\n * Checks whether a given path is a directory.\n *\n * @param {string} pathStr - Path to check.\n * @returns {Promise<boolean>} True if the path is a directory, else false.\n */\nexport async function isDirectory(pathStr: string): Promise<boolean> {\n  try {\n    const stat = await fsp.stat(pathStr);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Recursively copies a directory and all its contents to a destination.\n *\n * @param {string} src - Source directory path.\n * @param {string} dest - Destination directory path.\n * @returns {Promise<void>} Resolves when copy is complete.\n * @throws {Error} If source does not exist or copy fails.\n */\nexport async function copyDir(src: string, dest: string): Promise<void> {\n  await ensureDir(dest);\n  const entries = await fsp.readdir(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const srcPath = path.join(src, entry.name);\n    const destPath = path.join(dest, entry.name);\n\n    if (entry.isDirectory()) {\n      await copyDir(srcPath, destPath);\n    } else {\n      await fsp.copyFile(srcPath, destPath);\n    }\n  }\n}\n\n/**\n * Moves a directory to a new location by copying and deleting the original.\n *\n * @param {string} src - Source directory path.\n * @param {string} dest - Destination directory path.\n * @returns {Promise<void>} Resolves when move is complete.\n * @throws {Error} If copy or deletion fails.\n */\nexport async function moveDir(src: string, dest: string): Promise<void> {\n  await copyDir(src, dest);\n  await deleteDirRecursive(src);\n}\n\n/**\n * Empties a directory by deleting all files and subdirectories inside it.\n *\n * @param {string} dirPath - Path to the directory to empty.\n * @returns {Promise<void>} Resolves when the directory has been emptied.\n * @throws {Error} If files or subdirectories cannot be removed.\n */\nexport async function emptyDir(dirPath: string): Promise<void> {\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name);\n\n    if (entry.isDirectory()) {\n      await fsp.rm(entryPath, { recursive: true, force: true });\n    } else {\n      await fsp.unlink(entryPath);\n    }\n  }\n}\n\n/**\n * Calculates the total size (in bytes) of all files in a directory (recursive).\n *\n * @param {string} dirPath - Path to the directory.\n * @returns {Promise<number>} Total size in bytes.\n * @throws {Error} If any file stats cannot be read.\n */\nexport async function getDirSize(dirPath: string): Promise<number> {\n  let total = 0;\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name);\n    if (entry.isDirectory()) {\n      total += await getDirSize(entryPath);\n    } else {\n      const stat = await fsp.stat(entryPath);\n      total += stat.size;\n    }\n  }\n\n  return total;\n}\n\n/**\n * Watches a directory for file changes and calls a callback on each event.\n *\n * @param {string} dirPath - Directory path to watch.\n * @param {(eventType: \"rename\" | \"change\", filename: string | null) => void} callback - Callback for each change event.\n * @returns {() => void} A function to stop watching the directory.\n */\nexport function watchDir(\n  dirPath: string,\n  callback: (eventType: \"rename\" | \"change\", filename: string | null) => void,\n): () => void {\n  const watcher = fs.watch(dirPath, (eventType, filename) => {\n    callback(eventType, filename);\n  });\n\n  return () => watcher.close();\n}\n\n/**\n * Finds files matching a glob pattern.\n *\n * @param {string} pattern - Glob pattern to match files.\n * @param {object} [options] - Options for glob pattern matching.\n * @param {string} [options.cwd] - Current working directory for relative patterns.\n * @param {boolean} [options.dot=false] - Include dotfiles in matches.\n * @param {boolean} [options.nodir=true] - Only match files, not directories.\n * @returns {Promise<string[]>} Array of matched file paths.\n * @throws {Error} If pattern matching fails.\n */\nexport async function findFilesByPattern(\n  pattern: string,\n  options: { cwd?: string; dot?: boolean; nodir?: boolean } = {},\n): Promise<string[]> {\n  const defaultOptions = { nodir: true, ...options };\n  return glob(pattern, defaultOptions);\n}\n\n/**\n * Gets all subdirectories in a directory.\n *\n * @param {string} dirPath - The directory to search in.\n * @param {boolean} [recursive=false] - Whether to include subdirectories recursively.\n * @returns {Promise<string[]>} Array of absolute subdirectory paths.\n * @throws {Error} If directory cannot be read.\n */\nexport async function getSubdirectories(\n  dirPath: string,\n  recursive = false,\n): Promise<string[]> {\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n  const dirs = entries\n    .filter((entry) => entry.isDirectory())\n    .map((entry) => path.join(dirPath, entry.name));\n\n  if (recursive && dirs.length > 0) {\n    const nestedDirs = await Promise.all(\n      dirs.map((dir) => getSubdirectories(dir, true)),\n    );\n    return [...dirs, ...nestedDirs.flat()];\n  }\n\n  return dirs;\n}\n\n/**\n * Ensures a directory exists and is empty.\n *\n * @param {string} dirPath - Path to the directory.\n * @returns {Promise<void>} Resolves when the directory exists and is empty.\n * @throws {Error} If directory cannot be created or emptied.\n */\nexport async function ensureEmptyDir(dirPath: string): Promise<void> {\n  if (await isDirectory(dirPath)) {\n    await emptyDir(dirPath);\n  } else {\n    try {\n      await fsp.unlink(dirPath);\n    } catch (error) {\n      // Ignore if file doesn't exist\n      if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") {\n        throw error;\n      }\n    }\n    await ensureDir(dirPath);\n  }\n}\n\n/**\n * Creates a temporary directory with optional auto-cleanup.\n *\n * @param {object} [options] - Options for the temporary directory.\n * @param {string} [options.prefix='tmp-'] - Prefix for the directory name.\n * @param {string} [options.parentDir=os.tmpdir()] - Parent directory.\n * @param {boolean} [options.cleanup=false] - Whether to register cleanup on process exit.\n * @returns {Promise<{ path: string, cleanup: () => Promise<void> }>} Object with directory path and cleanup function.\n * @throws {Error} If directory cannot be created.\n */\nexport async function createTempDir(\n  options: { prefix?: string; parentDir?: string; cleanup?: boolean } = {},\n): Promise<{ path: string; cleanup: () => Promise<void> }> {\n  const prefix = options.prefix || \"tmp-\";\n  const parentDir = options.parentDir || os.tmpdir();\n  const dirName = `${prefix}${randomBytes(6).toString(\"hex\")}`;\n  const tempDirPath = path.join(parentDir, dirName);\n\n  await ensureDir(tempDirPath);\n\n  const cleanup = async () => {\n    try {\n      await deleteDirRecursive(tempDirPath);\n    } catch {\n      // Ignore cleanup errors\n    }\n  };\n\n  if (options.cleanup) {\n    process.once(\"exit\", () => {\n      try {\n        fs.rmSync(tempDirPath, { recursive: true, force: true });\n      } catch {\n        // Ignore cleanup errors on exit\n      }\n    });\n\n    // Handle signals for better cleanup\n    [\"SIGINT\", \"SIGTERM\", \"SIGUSR1\", \"SIGUSR2\"].forEach((signal) => {\n      process.once(signal as NodeJS.Signals, () => {\n        cleanup().then(() => process.exit());\n      });\n    });\n  }\n\n  return { path: tempDirPath, cleanup };\n}\n\n/**\n * Finds the newest file in a directory.\n *\n * @param {string} dirPath - Directory to search.\n * @param {boolean} [recursive=false] - Whether to search subdirectories.\n * @returns {Promise<string | null>} Path to the newest file or null if no files.\n * @throws {Error} If directory cannot be read.\n */\nexport async function findNewestFile(\n  dirPath: string,\n  recursive = false,\n): Promise<string | null> {\n  const files = await listFiles(dirPath, recursive);\n  if (files.length === 0) return null;\n\n  const stats = await Promise.all(\n    files.map(async (file) => ({\n      path: file,\n      mtime: (await fsp.stat(file)).mtime,\n    })),\n  );\n\n  return stats.sort((a, b) => b.mtime.getTime() - a.mtime.getTime())[0].path;\n}\n\n/**\n * Finds the oldest file in a directory.\n *\n * @param {string} dirPath - Directory to search.\n * @param {boolean} [recursive=false] - Whether to search subdirectories.\n * @returns {Promise<string | null>} Path to the oldest file or null if no files.\n * @throws {Error} If directory cannot be read.\n */\nexport async function findOldestFile(\n  dirPath: string,\n  recursive = false,\n): Promise<string | null> {\n  const files = await listFiles(dirPath, recursive);\n  if (files.length === 0) return null;\n\n  const stats = await Promise.all(\n    files.map(async (file) => ({\n      path: file,\n      mtime: (await fsp.stat(file)).mtime,\n    })),\n  );\n\n  return stats.sort((a, b) => a.mtime.getTime() - b.mtime.getTime())[0].path;\n}\n\n/**\n * Finds files or directories in a directory matching a predicate function.\n *\n * @param {string} dirPath - Directory to search.\n * @param {(path: string, stat: fs.Stats) => boolean | Promise<boolean>} predicate - Function to test each path.\n * @param {boolean} [recursive=false] - Whether to search subdirectories.\n * @returns {Promise<string[]>} Array of matching paths.\n * @throws {Error} If directory cannot be read.\n */\nexport async function findInDir(\n  dirPath: string,\n  predicate: (path: string, stat: fs.Stats) => boolean | Promise<boolean>,\n  recursive = false,\n): Promise<string[]> {\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n  const results: string[] = [];\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name);\n    const stat = await fsp.stat(entryPath);\n\n    if (await predicate(entryPath, stat)) {\n      results.push(entryPath);\n    }\n\n    if (recursive && entry.isDirectory()) {\n      const nestedResults = await findInDir(entryPath, predicate, true);\n      results.push(...nestedResults);\n    }\n  }\n\n  return results;\n}\n\n/**\n * Watches a directory recursively for file changes.\n *\n * @param {string} dirPath - Base directory path to watch.\n * @param {(eventType: \"rename\" | \"change\", filename: string) => void} callback - Callback for each change event.\n * @param {boolean} [includeSubdirs=true] - Whether to watch subdirectories.\n * @returns {Promise<() => void>} A function to stop watching the directory.\n * @throws {Error} If directory cannot be watched.\n */\nexport async function watchDirRecursive(\n  dirPath: string,\n  callback: (eventType: \"rename\" | \"change\", filename: string) => void,\n  includeSubdirs = true,\n): Promise<() => void> {\n  // Normalize the path to ensure consistent path separators\n  const normalizedBasePath = path.normalize(dirPath);\n\n  // Create watchers for the base dir and all subdirectories\n  const watchers: fs.FSWatcher[] = [];\n\n  // Helper function to add a watcher for a directory\n  const addWatcher = (dir: string) => {\n    try {\n      const watcher = fs.watch(dir, (eventType, filename) => {\n        if (!filename) return;\n\n        const fullPath = path.join(dir, filename);\n        // Make the path relative to the base directory\n        const relativePath = path.relative(normalizedBasePath, fullPath);\n        callback(eventType, relativePath);\n\n        // If a new directory is created, we should watch it\n        if (eventType === \"rename\" && includeSubdirs) {\n          setTimeout(async () => {\n            try {\n              if (await isDirectory(fullPath)) {\n                addWatcher(fullPath);\n              }\n            } catch {\n              // Ignore errors checking newly created items\n            }\n          }, 100);\n        }\n      });\n      watchers.push(watcher);\n    } catch {\n      // Silently ignore directories we can't watch\n    }\n  };\n\n  // Add watcher for the base directory\n  addWatcher(normalizedBasePath);\n\n  // If watching subdirectories, add watchers for all existing subdirectories\n  if (includeSubdirs) {\n    const subdirs = await getSubdirectories(normalizedBasePath, true);\n    for (const subdir of subdirs) {\n      addWatcher(subdir);\n    }\n  }\n\n  // Return a function to close all watchers\n  return () => {\n    watchers.forEach((watcher) => watcher.close());\n  };\n}\n\n/**\n * Gets detailed directory statistics including file count, directory count, and size.\n *\n * @param {string} dirPath - Path to the directory.\n * @returns {Promise<{ fileCount: number, dirCount: number, totalSize: number }>} Directory statistics.\n * @throws {Error} If directory cannot be read.\n */\nexport async function getDirStats(\n  dirPath: string,\n): Promise<{ fileCount: number; dirCount: number; totalSize: number }> {\n  let fileCount = 0;\n  let dirCount = 0;\n  let totalSize = 0;\n\n  async function processDir(currentPath: string): Promise<void> {\n    const entries = await fsp.readdir(currentPath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const entryPath = path.join(currentPath, entry.name);\n\n      if (entry.isDirectory()) {\n        dirCount++;\n        await processDir(entryPath);\n      } else if (entry.isFile()) {\n        fileCount++;\n        const stat = await fsp.stat(entryPath);\n        totalSize += stat.size;\n      }\n    }\n  }\n\n  await processDir(dirPath);\n\n  return { fileCount, dirCount, totalSize };\n}\n\n/**\n * Walks through a directory hierarchy, calling a visitor function for each entry.\n *\n * @param {string} dirPath - Starting directory path.\n * @param {object} options - Options for walking the directory.\n * @param {(entry: { path: string, name: string, isDirectory: boolean, stats: fs.Stats }) => boolean | void | Promise<boolean | void>} options.visitorFn -\n *   Function called for each file/directory. Return false to skip a directory.\n * @param {'pre' | 'post'} [options.traversalOrder='pre'] - Whether to visit directories before or after their contents.\n * @throws {Error} If directory cannot be read.\n */\nexport async function walkDir(\n  dirPath: string,\n  options: {\n    visitorFn: (entry: {\n      path: string;\n      name: string;\n      isDirectory: boolean;\n      stats: fs.Stats;\n    }) => boolean | void | Promise<boolean | void>;\n    traversalOrder?: \"pre\" | \"post\";\n  },\n): Promise<void> {\n  const traversalOrder = options.traversalOrder || \"pre\";\n  const entries = await fsp.readdir(dirPath, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name);\n    const stats = await fsp.stat(entryPath);\n    const entryInfo = {\n      path: entryPath,\n      name: entry.name,\n      isDirectory: entry.isDirectory(),\n      stats,\n    };\n\n    if (entry.isDirectory()) {\n      // Pre-order: visit directory before its contents\n      if (traversalOrder === \"pre\") {\n        const shouldContinue = await options.visitorFn(entryInfo);\n        // If the visitor returns false, don't recurse into this directory\n        if (shouldContinue !== false) {\n          await walkDir(entryPath, options);\n        }\n      } else {\n        // Post-order: visit directory after its contents\n        await walkDir(entryPath, options);\n        await options.visitorFn(entryInfo);\n      }\n    } else {\n      // Files are always visited when encountered\n      await options.visitorFn(entryInfo);\n    }\n  }\n\n  if (traversalOrder === \"post\") {\n    // Only visit the root if this is the top-level call (not for subdirectories)\n    // But since this function is always called recursively, always visit after children\n    const stats = await fsp.stat(dirPath);\n    const entryInfo = {\n      path: dirPath,\n      name: path.basename(dirPath),\n      isDirectory: true,\n      stats,\n    };\n    await options.visitorFn(entryInfo);\n  }\n}\n"]}

package/build/esnext/utils/env.utils.d.ts

@@ -18,6 +18,24 @@ export declare class Env {
      * @returns {boolean} `true` if NODE_ENV is 'development', else `false`.
      */
     static isDev(): boolean;
+    /**
+     * Checks if the current NODE_ENV is 'production'.
+     *
+     * @returns {boolean} `true` if NODE_ENV is 'production', else `false`.
+     */
+    static isProd(): boolean;
+    /**
+     * Checks if the current NODE_ENV is 'testing'.
+     *
+     * @returns {boolean} `true` if NODE_ENV is 'testing', else `false`.
+     */
+    static isTest(): boolean;
+    /**
+     * Checks if the current NODE_ENV is 'staging'.
+     *
+     * @returns {boolean} `true` if NODE_ENV is 'staging', else `false`.
+     */
+    static isStaging(): boolean;
     /**
      * Sets an environment variable (only affects runtime memory).
      *
@@ -113,6 +131,71 @@ export declare class Env {
      * @throws {Error} If missing or invalid.
      */
     static getEnum<T extends string>(key: string, allowedValues: T[], defaultValue?: T): T;
+    /**
+     * Retrieves a URL environment variable and validates it.
+     *
+     * @param {string} key - The environment variable key.
+     * @param {string} [defaultValue] - Optional fallback value.
+     * @param {object} [options] - Validation options.
+     * @param {string[]} [options.protocols] - Allowed protocols.
+     * @param {boolean} [options.requireTld=true] - Whether TLD is required.
+     * @returns {string} The validated URL.
+     * @throws {Error} If URL is invalid.
+     */
+    static getUrl(key: string, defaultValue?: string, options?: {
+        protocols?: string[];
+        requireTld?: boolean;
+    }): string;
+    /**
+     * Retrieves an email environment variable and validates it.
+     *
+     * @param {string} key - The environment variable key.
+     * @param {string} [defaultValue] - Optional fallback value.
+     * @returns {string} The validated email address.
+     * @throws {Error} If email is invalid.
+     */
+    static getEmail(key: string, defaultValue?: string): string;
+    /**
+     * Retrieves a path environment variable and validates it exists.
+     *
+     * @param {string} key - The environment variable key.
+     * @param {string} [defaultValue] - Optional fallback value.
+     * @param {object} [options] - Validation options.
+     * @param {boolean} [options.mustExist=false] - Whether path must exist.
+     * @param {boolean} [options.makeAbsolute=true] - Convert relative paths to absolute.
+     * @returns {string} The validated path.
+     * @throws {Error} If path is invalid.
+     */
+    static getPath(key: string, defaultValue?: string, options?: {
+        mustExist?: boolean;
+        makeAbsolute?: boolean;
+    }): string;
+    /**
+     * Retrieves a port environment variable and validates it.
+     *
+     * @param {string} key - The environment variable key.
+     * @param {number} [defaultValue=3000] - Optional fallback value.
+     * @returns {number} The validated port number.
+     * @throws {Error} If port is invalid.
+     */
+    static getPort(key: string, defaultValue?: number): number;
+    /**
+     * Retrieves a duration string and converts to milliseconds.
+     * Supports formats like "1d", "2h", "30m", "45s", "100ms" or combinations like "1h30m".
+     *
+     * @param {string} key - The environment variable key.
+     * @param {string|number} [defaultValue='0'] - Optional fallback value.
+     * @returns {number} The duration in milliseconds.
+     * @throws {Error} If duration format is invalid.
+     */
+    static getDuration(key: string, defaultValue?: string | number): number;
+    /**
+     * Gets all environment variables with sensitive values masked for safe logging.
+     *
+     * @param {string[]} [sensitiveKeys=['password', 'secret', 'key', 'token', 'auth']] - Keys to mask.
+     * @returns {Record<string, string>} Environment variables with sensitive values masked.
+     */
+    static getSafeEnv(sensitiveKeys?: string[]): Record<string, string>;
     /**
      * Checks whether the specified environment variable exists.
      *