@gesslar/toolkit 4.0.0 → 4.2.0

package/types/node/lib/Watcher.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @import FileObject from "./FileObject.js"
+ * @import DirectoryObject from "./DirectoryObject.js"
+ */
+export const OverFlowBehaviour: Readonly<{
+    IGNORE: "ignore";
+    THROW: "throw";
+}>;
+export default class Watcher {
+    /**
+     * Watch one or more file/directory targets for changes, invoking a callback
+     * with debounce protection.
+     *
+     * @param {FileObject|DirectoryObject|Array.<(FileObject|DirectoryObject)>} targets - The target(s) to watch
+     * @param {object} options - Watch options
+     * @param {(target: FileObject|DirectoryObject) => void} options.onChange - Callback invoked on change
+     * @param {number} [options.debounceMs=50] - Debounce interval in milliseconds
+     * @param {boolean} [options.persistent=true] - Keep the process alive while watching
+     * @param {boolean} [options.recursive=false] - Watch subdirectories (directories only)
+     * @param {string} [options.overflow="ignore"] - Overflow behaviour ("ignore" or "throw")
+     * @returns {Promise<undefined>}
+     */
+    watch(targets: FileObject | DirectoryObject | Array<(FileObject | DirectoryObject)>, { onChange, debounceMs, persistent, recursive, overflow }?: {
+        onChange: (target: FileObject | DirectoryObject) => void;
+        debounceMs?: number;
+        persistent?: boolean;
+        recursive?: boolean;
+        overflow?: string;
+    }): Promise<undefined>;
+    /**
+     * Stop watching all targets.
+     */
+    stopWatching(): void;
+    #private;
+}
+import type FileObject from "./FileObject.js";
+import type DirectoryObject from "./DirectoryObject.js";
+//# sourceMappingURL=Watcher.d.ts.map

package/types/node/lib/Watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Watcher.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Watcher.js"],"names":[],"mappings":"AAKA;;;GAGG;AAEH;;;GAGE;AAEF;IAIE;;;;;;;;;;;;OAYG;IACH,eATW,UAAU,GAAC,eAAe,GAAC,KAAK,CAAE,CAAC,UAAU,GAAC,eAAe,CAAC,CAAC,8DAEvE;QAA8D,QAAQ,EAA9D,CAAC,MAAM,EAAE,UAAU,GAAC,eAAe,KAAK,IAAI;QAC3B,UAAU,GAA3B,MAAM;QACY,UAAU,GAA5B,OAAO;QACW,SAAS,GAA3B,OAAO;QACU,QAAQ,GAAzB,MAAM;KACd,GAAU,OAAO,CAAC,SAAS,CAAC,CA6E9B;IAED;;OAEG;IACH,qBAIC;;CACF;4BA/G0B,iBAAiB;iCACZ,sBAAsB"}