@catbee/utils 1.0.5 → 2.0.0-next.0

package/dir/dir.utils.d.ts

@@ -0,0 +1,216 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import fs from 'fs';
+/**
+ * Ensures that a directory exists, creating parent directories if needed (like `mkdir -p`).
+ *
+ * @param {string} dirPath - The directory path to ensure.
+ * @returns {Promise<void>} Resolves when the directory exists.
+ * @throws {Error} If directory cannot be created.
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Recursively lists all files in a directory.
+ *
+ * @param {string} dirPath - The base directory.
+ * @param {boolean} [recursive=false] - Whether to recurse into subdirectories.
+ * @returns {Promise<string[]>} Array of absolute file paths.
+ * @throws {Error} If the directory cannot be read.
+ */
+export declare function listFiles(dirPath: string, recursive?: boolean): Promise<string[]>;
+/**
+ * Deletes a directory and all its contents recursively (like `rm -rf`).
+ *
+ * @param {string} dirPath - Directory to delete.
+ * @returns {Promise<void>} Resolves when deletion is complete.
+ * @throws {Error} If deletion fails.
+ */
+export declare function deleteDirRecursive(dirPath: string): Promise<void>;
+/**
+ * Checks whether a given path is a directory.
+ *
+ * @param {string} pathStr - Path to check.
+ * @returns {Promise<boolean>} True if the path is a directory, else false.
+ */
+export declare function isDirectory(pathStr: string): Promise<boolean>;
+/**
+ * Recursively copies a directory and all its contents to a destination.
+ *
+ * @param {string} src - Source directory path.
+ * @param {string} dest - Destination directory path.
+ * @returns {Promise<void>} Resolves when copy is complete.
+ * @throws {Error} If source does not exist or copy fails.
+ */
+export declare function copyDir(src: string, dest: string): Promise<void>;
+/**
+ * Moves a directory to a new location by copying and deleting the original.
+ *
+ * @param {string} src - Source directory path.
+ * @param {string} dest - Destination directory path.
+ * @returns {Promise<void>} Resolves when move is complete.
+ * @throws {Error} If copy or deletion fails.
+ */
+export declare function moveDir(src: string, dest: string): Promise<void>;
+/**
+ * Empties a directory by deleting all files and subdirectories inside it.
+ *
+ * @param {string} dirPath - Path to the directory to empty.
+ * @returns {Promise<void>} Resolves when the directory has been emptied.
+ * @throws {Error} If files or subdirectories cannot be removed.
+ */
+export declare function emptyDir(dirPath: string): Promise<void>;
+/**
+ * Calculates the total size (in bytes) of all files in a directory (recursive).
+ *
+ * @param {string} dirPath - Path to the directory.
+ * @returns {Promise<number>} Total size in bytes.
+ * @throws {Error} If any file stats cannot be read.
+ */
+export declare function getDirSize(dirPath: string): Promise<number>;
+/**
+ * Watches a directory for file changes and calls a callback on each event.
+ *
+ * @param {string} dirPath - Directory path to watch.
+ * @param {(eventType: "rename" | "change", filename: string | null) => void} callback - Callback for each change event.
+ * @returns {() => void} A function to stop watching the directory.
+ */
+export declare function watchDir(dirPath: string, callback: (eventType: 'rename' | 'change', filename: string | null) => void): () => void;
+/**
+ * Recursively finds files matching a simple pattern (supports '*' and '?').
+ *
+ * @param {string} pattern - Simple pattern to match files (e.g., '*.ts', 'src/*.js').
+ * @param {object} [options] - Options for matching files.
+ * @param {string} [options.cwd=process.cwd()] - Base directory to start searching from.
+ * @param {boolean} [options.dot=false] - Include dotfiles in matches.
+ * @returns {Promise<string[]>} Array of matched file paths.
+ */
+export declare function findFilesByPattern(pattern: string, options?: {
+    cwd?: string;
+    dot?: 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>;

package/dir/index.cjs

@@ -0,0 +1,416 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+'use strict';
+
+var os = require('os');
+var fs = require('fs');
+var fsp = require('fs/promises');
+var path = require('path');
+var crypto = require('crypto');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var os__default = /*#__PURE__*/_interopDefault(os);
+var fs__default = /*#__PURE__*/_interopDefault(fs);
+var fsp__default = /*#__PURE__*/_interopDefault(fsp);
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+async function ensureDir(dirPath) {
+  await fsp__default.default.mkdir(dirPath, {
+    recursive: true
+  });
+}
+__name(ensureDir, "ensureDir");
+async function listFiles(dirPath, recursive = false) {
+  const entries = await fsp__default.default.readdir(dirPath, {
+    withFileTypes: true
+  });
+  const files = [];
+  for (const entry of entries) {
+    const fullPath = path__default.default.join(dirPath, entry.name);
+    if (entry.isFile()) {
+      files.push(fullPath);
+    } else if (recursive && entry.isDirectory()) {
+      const nestedFiles = await listFiles(fullPath, true);
+      files.push(...nestedFiles);
+    }
+  }
+  return files;
+}
+__name(listFiles, "listFiles");
+async function deleteDirRecursive(dirPath) {
+  await fsp__default.default.rm(dirPath, {
+    recursive: true,
+    force: true
+  });
+}
+__name(deleteDirRecursive, "deleteDirRecursive");
+async function isDirectory(pathStr) {
+  try {
+    const stat = await fsp__default.default.stat(pathStr);
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+__name(isDirectory, "isDirectory");
+async function copyDir(src, dest) {
+  await ensureDir(dest);
+  const entries = await fsp__default.default.readdir(src, {
+    withFileTypes: true
+  });
+  for (const entry of entries) {
+    const srcPath = path__default.default.join(src, entry.name);
+    const destPath = path__default.default.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, destPath);
+    } else {
+      await fsp__default.default.copyFile(srcPath, destPath);
+    }
+  }
+}
+__name(copyDir, "copyDir");
+async function moveDir(src, dest) {
+  await copyDir(src, dest);
+  await deleteDirRecursive(src);
+}
+__name(moveDir, "moveDir");
+async function emptyDir(dirPath) {
+  const entries = await fsp__default.default.readdir(dirPath, {
+    withFileTypes: true
+  });
+  for (const entry of entries) {
+    const entryPath = path__default.default.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      await fsp__default.default.rm(entryPath, {
+        recursive: true,
+        force: true
+      });
+    } else {
+      await fsp__default.default.unlink(entryPath);
+    }
+  }
+}
+__name(emptyDir, "emptyDir");
+async function getDirSize(dirPath) {
+  let total = 0;
+  const entries = await fsp__default.default.readdir(dirPath, {
+    withFileTypes: true
+  });
+  for (const entry of entries) {
+    const entryPath = path__default.default.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      total += await getDirSize(entryPath);
+    } else {
+      const stat = await fsp__default.default.stat(entryPath);
+      total += stat.size;
+    }
+  }
+  return total;
+}
+__name(getDirSize, "getDirSize");
+function watchDir(dirPath, callback) {
+  const watcher = fs__default.default.watch(dirPath, (eventType, filename) => {
+    callback(eventType, filename);
+  });
+  return () => watcher.close();
+}
+__name(watchDir, "watchDir");
+async function findFilesByPattern(pattern, options = {}) {
+  const matchPattern = /* @__PURE__ */ __name((name, pattern2) => {
+    let escaped = pattern2.replaceAll(/[.+^${}()|[\]\\]/g, "\\$&");
+    escaped = escaped.replaceAll("*", ".*").replaceAll("?", ".");
+    const regex = new RegExp(`^${escaped}$`);
+    return regex.test(name);
+  }, "matchPattern");
+  const { cwd = process.cwd(), dot = false } = options;
+  const segments = pattern.split("/");
+  async function walk(dir, segIndex) {
+    if (segIndex >= segments.length) return [];
+    const segment = segments[segIndex];
+    const entries = await fs__default.default.promises.readdir(dir, {
+      withFileTypes: true
+    });
+    let matchedFiles = [];
+    for (const entry of entries) {
+      const entryName = entry.name;
+      if (!dot && entryName.startsWith(".")) continue;
+      const fullPath = path__default.default.join(dir, entryName);
+      const isLastSegment = segIndex === segments.length - 1;
+      if (isLastSegment) {
+        if (matchPattern(entryName, segment) && entry.isFile()) {
+          matchedFiles.push(fullPath);
+        }
+      } else if (entry.isDirectory()) {
+        if (matchPattern(entryName, segment)) {
+          matchedFiles.push(...await walk(fullPath, segIndex + 1));
+        }
+      }
+    }
+    return matchedFiles;
+  }
+  __name(walk, "walk");
+  return walk(cwd, 0);
+}
+__name(findFilesByPattern, "findFilesByPattern");
+async function getSubdirectories(dirPath, recursive = false) {
+  const entries = await fsp__default.default.readdir(dirPath, {
+    withFileTypes: true
+  });
+  const dirs = entries.filter((entry) => entry.isDirectory()).map((entry) => path__default.default.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;
+}
+__name(getSubdirectories, "getSubdirectories");
+async function ensureEmptyDir(dirPath) {
+  if (await isDirectory(dirPath)) {
+    await emptyDir(dirPath);
+  } else {
+    try {
+      await fsp__default.default.unlink(dirPath);
+    } catch (error) {
+      if (error.code !== "ENOENT") {
+        throw error;
+      }
+    }
+    await ensureDir(dirPath);
+  }
+}
+__name(ensureEmptyDir, "ensureEmptyDir");
+async function createTempDir(options = {}) {
+  const prefix = options.prefix || "tmp-";
+  const parentDir = options.parentDir || os__default.default.tmpdir();
+  const dirName = `${prefix}${crypto.randomBytes(6).toString("hex")}`;
+  const tempDirPath = path__default.default.join(parentDir, dirName);
+  await ensureDir(tempDirPath);
+  const cleanup = /* @__PURE__ */ __name(async () => {
+    try {
+      await deleteDirRecursive(tempDirPath);
+    } catch {
+    }
+  }, "cleanup");
+  if (options.cleanup) {
+    process.once("exit", () => {
+      try {
+        fs__default.default.rmSync(tempDirPath, {
+          recursive: true,
+          force: true
+        });
+      } catch {
+      }
+    });
+    const signals = [
+      "SIGINT",
+      "SIGTERM",
+      "SIGUSR1",
+      "SIGUSR2"
+    ];
+    for (const signal of signals) {
+      process.once(signal, () => {
+        cleanup().then(() => process.exit());
+      });
+    }
+  }
+  return {
+    path: tempDirPath,
+    cleanup
+  };
+}
+__name(createTempDir, "createTempDir");
+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__default.default.stat(file)).mtime
+  })));
+  return stats.sort((a, b) => b.mtime.getTime() - a.mtime.getTime())[0].path;
+}
+__name(findNewestFile, "findNewestFile");
+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__default.default.stat(file)).mtime
+  })));
+  return stats.sort((a, b) => a.mtime.getTime() - b.mtime.getTime())[0].path;
+}
+__name(findOldestFile, "findOldestFile");
+async function findInDir(dirPath, predicate, recursive = false) {
+  const entries = await fsp__default.default.readdir(dirPath, {
+    withFileTypes: true
+  });
+  const results = [];
+  for (const entry of entries) {
+    const entryPath = path__default.default.join(dirPath, entry.name);
+    const stat = await fsp__default.default.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;
+}
+__name(findInDir, "findInDir");
+async function watchDirRecursive(dirPath, callback, includeSubdirs = true) {
+  const normalizedBasePath = path__default.default.normalize(dirPath);
+  const watchers = [];
+  const addWatcher = /* @__PURE__ */ __name((dir) => {
+    try {
+      const watcher = fs__default.default.watch(dir, (eventType, filename) => {
+        if (!filename) return;
+        const fullPath = path__default.default.join(dir, filename);
+        const relativePath = path__default.default.relative(normalizedBasePath, fullPath);
+        callback(eventType, relativePath);
+        if (eventType === "rename" && includeSubdirs) {
+          setTimeout(async () => {
+            try {
+              if (await isDirectory(fullPath)) {
+                addWatcher(fullPath);
+              }
+            } catch {
+            }
+          }, 100);
+        }
+      });
+      watchers.push(watcher);
+    } catch {
+    }
+  }, "addWatcher");
+  addWatcher(normalizedBasePath);
+  if (includeSubdirs) {
+    const subdirs = await getSubdirectories(normalizedBasePath, true);
+    for (const subdir of subdirs) {
+      addWatcher(subdir);
+    }
+  }
+  return () => {
+    for (const watcher of watchers) {
+      watcher.close();
+    }
+  };
+}
+__name(watchDirRecursive, "watchDirRecursive");
+async function getDirStats(dirPath) {
+  let fileCount = 0;
+  let dirCount = 0;
+  let totalSize = 0;
+  async function processDir(currentPath) {
+    const entries = await fsp__default.default.readdir(currentPath, {
+      withFileTypes: true
+    });
+    for (const entry of entries) {
+      const entryPath = path__default.default.join(currentPath, entry.name);
+      if (entry.isDirectory()) {
+        dirCount++;
+        await processDir(entryPath);
+      } else if (entry.isFile()) {
+        fileCount++;
+        const stat = await fsp__default.default.stat(entryPath);
+        totalSize += stat.size;
+      }
+    }
+  }
+  __name(processDir, "processDir");
+  await processDir(dirPath);
+  return {
+    fileCount,
+    dirCount,
+    totalSize
+  };
+}
+__name(getDirStats, "getDirStats");
+async function walkDir(dirPath, options) {
+  const traversalOrder = options.traversalOrder || "pre";
+  const entries = await fsp__default.default.readdir(dirPath, {
+    withFileTypes: true
+  });
+  for (const entry of entries) {
+    const entryPath = path__default.default.join(dirPath, entry.name);
+    const stats = await fsp__default.default.stat(entryPath);
+    const entryInfo = {
+      path: entryPath,
+      name: entry.name,
+      isDirectory: entry.isDirectory(),
+      stats
+    };
+    if (entry.isDirectory()) {
+      if (traversalOrder === "pre") {
+        const shouldContinue = await options.visitorFn(entryInfo);
+        if (shouldContinue !== false) {
+          await walkDir(entryPath, options);
+        }
+      } else {
+        await walkDir(entryPath, options);
+        await options.visitorFn(entryInfo);
+      }
+    } else {
+      await options.visitorFn(entryInfo);
+    }
+  }
+  if (traversalOrder === "post") {
+    const stats = await fsp__default.default.stat(dirPath);
+    const entryInfo = {
+      path: dirPath,
+      name: path__default.default.basename(dirPath),
+      isDirectory: true,
+      stats
+    };
+    await options.visitorFn(entryInfo);
+  }
+}
+__name(walkDir, "walkDir");
+
+exports.copyDir = copyDir;
+exports.createTempDir = createTempDir;
+exports.deleteDirRecursive = deleteDirRecursive;
+exports.emptyDir = emptyDir;
+exports.ensureDir = ensureDir;
+exports.ensureEmptyDir = ensureEmptyDir;
+exports.findFilesByPattern = findFilesByPattern;
+exports.findInDir = findInDir;
+exports.findNewestFile = findNewestFile;
+exports.findOldestFile = findOldestFile;
+exports.getDirSize = getDirSize;
+exports.getDirStats = getDirStats;
+exports.getSubdirectories = getSubdirectories;
+exports.isDirectory = isDirectory;
+exports.listFiles = listFiles;
+exports.moveDir = moveDir;
+exports.walkDir = walkDir;
+exports.watchDir = watchDir;
+exports.watchDirRecursive = watchDirRecursive;

package/dir/index.d.ts

@@ -0,0 +1,25 @@
+/*
+ * The MIT License
+ * 
+ * Copyright (c) 2025 Catbee Technologies. https://catbee.in/license
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export * from './dir.utils';