@zthun/crumbtrail-cli 2.4.6

package/LICENSE

@@ -0,0 +1,20 @@
+# MIT License
+
+Copyright © 2025 Anthony Bonta
+
+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.

package/README.md

@@ -0,0 +1,17 @@
+# Description
+
+Crumbtrail Watch is a command line debug utility. This utility will watch a
+specific directory and will output the events, add, remove, update, on said
+directory.
+
+## Installation
+
+```sh
+npm i -g @zthun/crumbtrail-cli
+```
+
+## Usage
+
+```sh
+crumbtrail-cli /path/to/directory
+```

package/dist/cli.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+const crumbtrailFs = require('@zthun/crumbtrail-fs');
+const lumberjackyLog = require('@zthun/lumberjacky-log');
+const commander = require('commander');
+const watch = require('./watch-C-6Gf4uc.cjs');
+
+const logger = new lumberjackyLog.ZLoggerConsole(console);
+const application = new commander.Command();
+application.name("crumbtrail-cli").description("Crumbtrail utilities for debugging");
+application.command("watch", {
+    isDefault: true
+}).description("Watch a directory and log changes").option("-d, --directory <dir>", "The directory to watch", process.cwd()).option("-g, --glob <pattern>", "Glob pattern (repeatable)", (val, prev)=>prev.concat(val), []).action(async (options)=>{
+    const command = new watch.ZCrumbtrailWatch(logger);
+    const result = await command.run(options);
+    process.exitCode = result;
+});
+application.command("nudge").description("Touch directory timestamps to prompt a refresh").option("-d, --directory <path>", "Directory to refresh", process.cwd()).option("--recursive", "Nudge all subdirectories as well", false).option("--silent", "Do not log any output.  Nudge silently", false).option("-e, --every <ms>", "Time between nudges in milliseconds", (v)=>Number.parseInt(v, 10), crumbtrailFs.ZWatchDelay).action(async (options)=>{
+    const log = options.silent ? new lumberjackyLog.ZLoggerSilent() : logger;
+    const command = new watch.ZCrumbtrailNudge(log);
+    process.exitCode = await command.run(options);
+});
+application.parse();
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","sources":["../src/cli.mts"],"sourcesContent":["import { ZWatchDelay } from \"@zthun/crumbtrail-fs\";\nimport { ZLoggerConsole, ZLoggerSilent } from \"@zthun/lumberjacky-log\";\nimport { Command } from \"commander\";\nimport type { IZCrumbtrailNudgeOptions } from \"./nudge/nudge.mjs\";\nimport { ZCrumbtrailNudge } from \"./nudge/nudge.mjs\";\nimport type { IZCrumbtrailWatchOptions } from \"./watch/watch.mjs\";\nimport { ZCrumbtrailWatch } from \"./watch/watch.mjs\";\n\nconst logger = new ZLoggerConsole(console);\nconst application = new Command();\n\napplication\n  .name(\"crumbtrail-cli\")\n  .description(\"Crumbtrail utilities for debugging\");\n\napplication\n  .command(\"watch\", { isDefault: true })\n  .description(\"Watch a directory and log changes\")\n  .option(\"-d, --directory <dir>\", \"The directory to watch\", process.cwd())\n  .option(\n    \"-g, --glob <pattern>\",\n    \"Glob pattern (repeatable)\",\n    (val, prev: string[]) => prev.concat(val),\n    [],\n  )\n  .action(async (options: IZCrumbtrailWatchOptions) => {\n    const command = new ZCrumbtrailWatch(logger);\n    const result = await command.run(options);\n    process.exitCode = result;\n  });\n\napplication\n  .command(\"nudge\")\n  .description(\"Touch directory timestamps to prompt a refresh\")\n  .option(\"-d, --directory <path>\", \"Directory to refresh\", process.cwd())\n  .option(\"--recursive\", \"Nudge all subdirectories as well\", false)\n  .option(\"--silent\", \"Do not log any output.  Nudge silently\", false)\n  .option(\n    \"-e, --every <ms>\",\n    \"Time between nudges in milliseconds\",\n    (v) => Number.parseInt(v, 10),\n    ZWatchDelay,\n  )\n  .action(async (options: IZCrumbtrailNudgeOptions & { silent: boolean }) => {\n    const log = options.silent ? new ZLoggerSilent() : logger;\n    const command = new ZCrumbtrailNudge(log);\n    process.exitCode = await command.run(options);\n  });\n\napplication.parse();\n"],"names":["logger","ZLoggerConsole","console","application","Command","name","description","command","isDefault","option","process","cwd","val","prev","concat","action","options","ZCrumbtrailWatch","result","run","exitCode","v","Number","parseInt","ZWatchDelay","log","silent","ZLoggerSilent","ZCrumbtrailNudge","parse"],"mappings":";;;;;;;AAQA,MAAMA,MAAAA,GAAS,IAAIC,6BAAAA,CAAeC,OAAAA,CAAAA;AAClC,MAAMC,cAAc,IAAIC,iBAAAA,EAAAA;AAExBD,WAAAA,CACGE,IAAI,CAAC,gBAAA,CAAA,CACLC,WAAW,CAAC,oCAAA,CAAA;AAEfH,WAAAA,CACGI,OAAO,CAAC,OAAA,EAAS;IAAEC,SAAAA,EAAW;AAAK,CAAA,CAAA,CACnCF,WAAW,CAAC,mCAAA,CAAA,CACZG,MAAM,CAAC,yBAAyB,wBAAA,EAA0BC,OAAAA,CAAQC,GAAG,EAAA,CAAA,CACrEF,MAAM,CACL,wBACA,2BAAA,EACA,CAACG,GAAAA,EAAKC,IAAAA,GAAmBA,IAAAA,CAAKC,MAAM,CAACF,GAAAA,CAAAA,EACrC,EAAE,CAAA,CAEHG,MAAM,CAAC,OAAOC,OAAAA,GAAAA;IACb,MAAMT,OAAAA,GAAU,IAAIU,sBAAAA,CAAiBjB,MAAAA,CAAAA;AACrC,IAAA,MAAMkB,MAAAA,GAAS,MAAMX,OAAAA,CAAQY,GAAG,CAACH,OAAAA,CAAAA;AACjCN,IAAAA,OAAAA,CAAQU,QAAQ,GAAGF,MAAAA;AACrB,CAAA,CAAA;AAEFf,WAAAA,CACGI,OAAO,CAAC,OAAA,CAAA,CACRD,WAAW,CAAC,kDACZG,MAAM,CAAC,wBAAA,EAA0B,sBAAA,EAAwBC,QAAQC,GAAG,EAAA,CAAA,CACpEF,MAAM,CAAC,eAAe,kCAAA,EAAoC,KAAA,CAAA,CAC1DA,MAAM,CAAC,YAAY,wCAAA,EAA0C,KAAA,CAAA,CAC7DA,MAAM,CACL,oBACA,qCAAA,EACA,CAACY,CAAAA,GAAMC,MAAAA,CAAOC,QAAQ,CAACF,CAAAA,EAAG,KAC1BG,wBAAAA,CAAAA,CAEDT,MAAM,CAAC,OAAOC,OAAAA,GAAAA;AACb,IAAA,MAAMS,GAAAA,GAAMT,OAAAA,CAAQU,MAAM,GAAG,IAAIC,4BAAAA,EAAAA,GAAkB3B,MAAAA;IACnD,MAAMO,OAAAA,GAAU,IAAIqB,sBAAAA,CAAiBH,GAAAA,CAAAA;AACrCf,IAAAA,OAAAA,CAAQU,QAAQ,GAAG,MAAMb,OAAAA,CAAQY,GAAG,CAACH,OAAAA,CAAAA;AACvC,CAAA,CAAA;AAEFb,WAAAA,CAAY0B,KAAK,EAAA;;"}

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/cli.js

@@ -0,0 +1,22 @@
+import { ZWatchDelay } from '@zthun/crumbtrail-fs';
+import { ZLoggerConsole, ZLoggerSilent } from '@zthun/lumberjacky-log';
+import { Command } from 'commander';
+import { a as ZCrumbtrailWatch, Z as ZCrumbtrailNudge } from './watch-DdpcqnOY.js';
+
+const logger = new ZLoggerConsole(console);
+const application = new Command();
+application.name("crumbtrail-cli").description("Crumbtrail utilities for debugging");
+application.command("watch", {
+    isDefault: true
+}).description("Watch a directory and log changes").option("-d, --directory <dir>", "The directory to watch", process.cwd()).option("-g, --glob <pattern>", "Glob pattern (repeatable)", (val, prev)=>prev.concat(val), []).action(async (options)=>{
+    const command = new ZCrumbtrailWatch(logger);
+    const result = await command.run(options);
+    process.exitCode = result;
+});
+application.command("nudge").description("Touch directory timestamps to prompt a refresh").option("-d, --directory <path>", "Directory to refresh", process.cwd()).option("--recursive", "Nudge all subdirectories as well", false).option("--silent", "Do not log any output.  Nudge silently", false).option("-e, --every <ms>", "Time between nudges in milliseconds", (v)=>Number.parseInt(v, 10), ZWatchDelay).action(async (options)=>{
+    const log = options.silent ? new ZLoggerSilent() : logger;
+    const command = new ZCrumbtrailNudge(log);
+    process.exitCode = await command.run(options);
+});
+application.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sources":["../src/cli.mts"],"sourcesContent":["import { ZWatchDelay } from \"@zthun/crumbtrail-fs\";\nimport { ZLoggerConsole, ZLoggerSilent } from \"@zthun/lumberjacky-log\";\nimport { Command } from \"commander\";\nimport type { IZCrumbtrailNudgeOptions } from \"./nudge/nudge.mjs\";\nimport { ZCrumbtrailNudge } from \"./nudge/nudge.mjs\";\nimport type { IZCrumbtrailWatchOptions } from \"./watch/watch.mjs\";\nimport { ZCrumbtrailWatch } from \"./watch/watch.mjs\";\n\nconst logger = new ZLoggerConsole(console);\nconst application = new Command();\n\napplication\n  .name(\"crumbtrail-cli\")\n  .description(\"Crumbtrail utilities for debugging\");\n\napplication\n  .command(\"watch\", { isDefault: true })\n  .description(\"Watch a directory and log changes\")\n  .option(\"-d, --directory <dir>\", \"The directory to watch\", process.cwd())\n  .option(\n    \"-g, --glob <pattern>\",\n    \"Glob pattern (repeatable)\",\n    (val, prev: string[]) => prev.concat(val),\n    [],\n  )\n  .action(async (options: IZCrumbtrailWatchOptions) => {\n    const command = new ZCrumbtrailWatch(logger);\n    const result = await command.run(options);\n    process.exitCode = result;\n  });\n\napplication\n  .command(\"nudge\")\n  .description(\"Touch directory timestamps to prompt a refresh\")\n  .option(\"-d, --directory <path>\", \"Directory to refresh\", process.cwd())\n  .option(\"--recursive\", \"Nudge all subdirectories as well\", false)\n  .option(\"--silent\", \"Do not log any output.  Nudge silently\", false)\n  .option(\n    \"-e, --every <ms>\",\n    \"Time between nudges in milliseconds\",\n    (v) => Number.parseInt(v, 10),\n    ZWatchDelay,\n  )\n  .action(async (options: IZCrumbtrailNudgeOptions & { silent: boolean }) => {\n    const log = options.silent ? new ZLoggerSilent() : logger;\n    const command = new ZCrumbtrailNudge(log);\n    process.exitCode = await command.run(options);\n  });\n\napplication.parse();\n"],"names":["logger","ZLoggerConsole","console","application","Command","name","description","command","isDefault","option","process","cwd","val","prev","concat","action","options","ZCrumbtrailWatch","result","run","exitCode","v","Number","parseInt","ZWatchDelay","log","silent","ZLoggerSilent","ZCrumbtrailNudge","parse"],"mappings":";;;;;AAQA,MAAMA,MAAAA,GAAS,IAAIC,cAAAA,CAAeC,OAAAA,CAAAA;AAClC,MAAMC,cAAc,IAAIC,OAAAA,EAAAA;AAExBD,WAAAA,CACGE,IAAI,CAAC,gBAAA,CAAA,CACLC,WAAW,CAAC,oCAAA,CAAA;AAEfH,WAAAA,CACGI,OAAO,CAAC,OAAA,EAAS;IAAEC,SAAAA,EAAW;AAAK,CAAA,CAAA,CACnCF,WAAW,CAAC,mCAAA,CAAA,CACZG,MAAM,CAAC,yBAAyB,wBAAA,EAA0BC,OAAAA,CAAQC,GAAG,EAAA,CAAA,CACrEF,MAAM,CACL,wBACA,2BAAA,EACA,CAACG,GAAAA,EAAKC,IAAAA,GAAmBA,IAAAA,CAAKC,MAAM,CAACF,GAAAA,CAAAA,EACrC,EAAE,CAAA,CAEHG,MAAM,CAAC,OAAOC,OAAAA,GAAAA;IACb,MAAMT,OAAAA,GAAU,IAAIU,gBAAAA,CAAiBjB,MAAAA,CAAAA;AACrC,IAAA,MAAMkB,MAAAA,GAAS,MAAMX,OAAAA,CAAQY,GAAG,CAACH,OAAAA,CAAAA;AACjCN,IAAAA,OAAAA,CAAQU,QAAQ,GAAGF,MAAAA;AACrB,CAAA,CAAA;AAEFf,WAAAA,CACGI,OAAO,CAAC,OAAA,CAAA,CACRD,WAAW,CAAC,kDACZG,MAAM,CAAC,wBAAA,EAA0B,sBAAA,EAAwBC,QAAQC,GAAG,EAAA,CAAA,CACpEF,MAAM,CAAC,eAAe,kCAAA,EAAoC,KAAA,CAAA,CAC1DA,MAAM,CAAC,YAAY,wCAAA,EAA0C,KAAA,CAAA,CAC7DA,MAAM,CACL,oBACA,qCAAA,EACA,CAACY,CAAAA,GAAMC,MAAAA,CAAOC,QAAQ,CAACF,CAAAA,EAAG,KAC1BG,WAAAA,CAAAA,CAEDT,MAAM,CAAC,OAAOC,OAAAA,GAAAA;AACb,IAAA,MAAMS,GAAAA,GAAMT,OAAAA,CAAQU,MAAM,GAAG,IAAIC,aAAAA,EAAAA,GAAkB3B,MAAAA;IACnD,MAAMO,OAAAA,GAAU,IAAIqB,gBAAAA,CAAiBH,GAAAA,CAAAA;AACrCf,IAAAA,OAAAA,CAAQU,QAAQ,GAAG,MAAMb,OAAAA,CAAQY,GAAG,CAACH,OAAAA,CAAAA;AACvC,CAAA,CAAA;AAEFb,WAAAA,CAAY0B,KAAK,EAAA"}

package/dist/index.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const watch = require('./watch-C-6Gf4uc.cjs');
+
+
+
+exports.ZCrumbtrailNudge = watch.ZCrumbtrailNudge;
+exports.ZCrumbtrailWatch = watch.ZCrumbtrailWatch;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+export * from './nudge/nudge.mjs';
+export * from './watch/watch.mjs';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { Z as ZCrumbtrailNudge, a as ZCrumbtrailWatch } from './watch-DdpcqnOY.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/nudge/nudge.d.mts

@@ -0,0 +1,52 @@
+import { IZLogger } from '@zthun/lumberjacky-log';
+/**
+ * Options for the nudge command.
+ */
+export interface IZCrumbtrailNudgeOptions {
+    /**
+     * The directory to nudge.
+     *
+     * The default if not specified is the current working directory.
+     */
+    directory?: string;
+    /**
+     * Whether to nudge recursively.
+     *
+     * Warning:  This can have severe CPU
+     * usage for deep directories.
+     *
+     * Default is false.
+     */
+    recursive?: boolean;
+    /**
+     * The total number of milliseconds to wait
+     * between nudges.
+     *
+     * Default is {@link ZWatchDelay}
+     */
+    every?: number;
+}
+/**
+ * An operation to continuously nudge a directory.
+ *
+ * This is a special operation that lists the contents of a targeted parent directory.
+ * The main reason for this is to work around an issue when you are running inside of
+ * a container and your host is not linux.
+ *
+ * A lot of times, you will not receive events in this situation for add and update
+ * until the virtual file bridge is refreshed by listing the outer directory contents.
+ * This command helps to force the bridge to send file change events.  You should
+ * only need this if you are running on a non linux host inside a docker container.
+ *
+ * Run a separate container in the background and just nudge the directory
+ * for however long you need.
+ */
+export declare class ZCrumbtrailNudge {
+    private _controller?;
+    private _resolve?;
+    private _promise?;
+    private readonly _logger;
+    constructor(logger: IZLogger);
+    kill(): Promise<void>;
+    run(options?: IZCrumbtrailNudgeOptions): Promise<number>;
+}

package/dist/watch/watch.d.mts

@@ -0,0 +1,101 @@
+import { IZLogEntry, IZLogger } from '@zthun/lumberjacky-log';
+/**
+ * Arguments for the crumbtrail app.
+ */
+export interface IZCrumbtrailWatchOptions {
+    /**
+     * The directory to watch.
+     *
+     * If this is falsy, then the cwd is used.
+     */
+    directory?: string;
+    /**
+     * The list of file globs to watch.
+     *
+     * If this is falsy or empty, then '**' is used.
+     */
+    globs?: string[];
+}
+/**
+ * The root application for the crumbtrail cli.
+ */
+export declare class ZCrumbtrailWatch {
+    private _logger;
+    private _globs;
+    private _watch;
+    private _ready;
+    private _promise;
+    private _resolve;
+    /**
+     * Gets the entry for a basic information message.
+     *
+     * @returns
+     *        The log entry for a basic information message.
+     */
+    static msg(msg: string): IZLogEntry;
+    /**
+     * Gets the message for when a file is added.
+     *
+     * @returns
+     *        The message for when a file is added.
+     */
+    static add(path: string): IZLogEntry;
+    /**
+     * Gets the message for when a file/folder is removed.
+     *
+     * @returns
+     *        The message for when a file/folder is added.
+     */
+    static remove(path: string): IZLogEntry;
+    /**
+     * Gets the message for when a file is updated.
+     *
+     * @returns
+     *        The message for when a file is updated.
+     */
+    static update(path: string): IZLogEntry;
+    /**
+     * Gets the current directory being watched.
+     *
+     * @returns
+     *        The directory that is watching for events.
+     */
+    watching(): Promise<string | undefined>;
+    /**
+     * Gets the list of globs that filter the directory contents.
+     *
+     * @returns
+     *      The list of globs that filter the directory contents.
+     */
+    globs(): Promise<string[] | undefined>;
+    /**
+     * Returns a promise that can be awaited on to
+     * make sure the watch is initialized.
+     */
+    ready(): Promise<void>;
+    /**
+     * Initializes a new instance of this object.
+     *
+     * @param logger -
+     *        The logger to use to output events.
+     */
+    constructor(logger: IZLogger);
+    /**
+     * Kills the application.
+     */
+    kill(): Promise<void>;
+    private _handleFsEvent;
+    private _handleAdd;
+    private _handleRemove;
+    private _handleUpdate;
+    /**
+     * Runs the application.
+     *
+     * @param args -
+     *        The application arguments.
+     *
+     * @returns
+     *        The process exit code.
+     */
+    run(args?: IZCrumbtrailWatchOptions): Promise<number>;
+}

package/dist/watch-C-6Gf4uc.cjs

@@ -0,0 +1,239 @@
+'use strict';
+
+const crumbtrailFs = require('@zthun/crumbtrail-fs');
+const helpfulFn = require('@zthun/helpful-fn');
+const lumberjackyLog = require('@zthun/lumberjacky-log');
+const glob = require('fast-glob');
+const lodashEs = require('lodash-es');
+const promises = require('node:fs/promises');
+const node_path = require('node:path');
+const minimatch = require('minimatch');
+const node_process = require('node:process');
+
+function _define_property$1(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * An operation to continuously nudge a directory.
+ *
+ * This is a special operation that lists the contents of a targeted parent directory.
+ * The main reason for this is to work around an issue when you are running inside of
+ * a container and your host is not linux.
+ *
+ * A lot of times, you will not receive events in this situation for add and update
+ * until the virtual file bridge is refreshed by listing the outer directory contents.
+ * This command helps to force the bridge to send file change events.  You should
+ * only need this if you are running on a non linux host inside a docker container.
+ *
+ * Run a separate container in the background and just nudge the directory
+ * for however long you need.
+ */ class ZCrumbtrailNudge {
+    async kill() {
+        this._controller?.abort();
+        delete this._controller;
+        await this._promise;
+        delete this._promise;
+    }
+    async run(options = {}) {
+        await this.kill();
+        const controller = new AbortController();
+        this._controller = controller;
+        const { promise, resolve } = Promise.withResolvers();
+        this._promise = promise;
+        this._resolve = resolve;
+        const { directory = process.cwd(), recursive, every = crumbtrailFs.ZWatchDelay } = options;
+        const ms = helpfulFn.firstTruthy(crumbtrailFs.ZWatchDelay, every);
+        this._logger.log(new lumberjackyLog.ZLogEntryBuilder().info().message(`Starting a nudge loop every ${ms} milliseconds`).build());
+        if (recursive) {
+            this._logger.log(new lumberjackyLog.ZLogEntryBuilder().warning().message("Nudging is recursive.  Child folders will be nudged too.").build());
+        }
+        do {
+            this._logger.log(new lumberjackyLog.ZLogEntryBuilder().info().message(`Nudging ${directory} to refresh`).build());
+            await promises.readdir(node_path.dirname(directory)).catch(lodashEs.noop);
+            if (recursive) {
+                await glob(`${directory}/**`, {
+                    onlyDirectories: true
+                }).catch(lodashEs.noop);
+            }
+            await helpfulFn.sleep(ms);
+        }while (!controller.signal.aborted)
+        resolve(0);
+        delete this._resolve;
+        return this._promise;
+    }
+    constructor(logger){
+        _define_property$1(this, "_controller", void 0);
+        _define_property$1(this, "_resolve", void 0);
+        _define_property$1(this, "_promise", void 0);
+        _define_property$1(this, "_logger", void 0);
+        this._logger = new lumberjackyLog.ZLoggerContext("ZCrumbtrailNudge", logger);
+    }
+}
+
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * The root application for the crumbtrail cli.
+ */ class ZCrumbtrailWatch {
+    /**
+   * Gets the entry for a basic information message.
+   *
+   * @returns
+   *        The log entry for a basic information message.
+   */ static msg(msg) {
+        return new lumberjackyLog.ZLogEntryBuilder().info().message(msg).build();
+    }
+    /**
+   * Gets the message for when a file is added.
+   *
+   * @returns
+   *        The message for when a file is added.
+   */ static add(path) {
+        return new lumberjackyLog.ZLogEntryBuilder().info().message(`Node added: ${path}`).build();
+    }
+    /**
+   * Gets the message for when a file/folder is removed.
+   *
+   * @returns
+   *        The message for when a file/folder is added.
+   */ static remove(path) {
+        return new lumberjackyLog.ZLogEntryBuilder().warning().message(`Node removed: ${path}`).build();
+    }
+    /**
+   * Gets the message for when a file is updated.
+   *
+   * @returns
+   *        The message for when a file is updated.
+   */ static update(path) {
+        return new lumberjackyLog.ZLogEntryBuilder().info().message(`Node updated: ${path}`).build();
+    }
+    /**
+   * Gets the current directory being watched.
+   *
+   * @returns
+   *        The directory that is watching for events.
+   */ watching() {
+        return Promise.resolve(this._watch?.path);
+    }
+    /**
+   * Gets the list of globs that filter the directory contents.
+   *
+   * @returns
+   *      The list of globs that filter the directory contents.
+   */ globs() {
+        return Promise.resolve(this._globs?.slice());
+    }
+    /**
+   * Returns a promise that can be awaited on to
+   * make sure the watch is initialized.
+   */ async ready() {
+        return this._ready;
+    }
+    /**
+   * Kills the application.
+   */ async kill() {
+        await this._watch?.stop();
+        delete this._watch;
+        delete this._globs;
+        this._ready = Promise.resolve();
+        this._resolve?.(0);
+        await this._promise;
+        delete this._promise;
+    }
+    _handleFsEvent(path, entry) {
+        const globs = helpfulFn.firstDefined([
+            "**"
+        ], this._globs);
+        const directory = helpfulFn.firstDefined(node_process.cwd(), this._watch?.path);
+        if (globs?.some((g)=>minimatch.minimatch(path, node_path.resolve(directory, g)))) {
+            this._logger.log(entry);
+        }
+    }
+    _handleAdd(node) {
+        const { add } = ZCrumbtrailWatch;
+        this._handleFsEvent(node.path, add(node.path));
+    }
+    _handleRemove(node) {
+        const { remove } = ZCrumbtrailWatch;
+        this._handleFsEvent(node.path, remove(node.path));
+    }
+    _handleUpdate(node) {
+        const { update } = ZCrumbtrailWatch;
+        this._handleFsEvent(node.path, update(node.path));
+    }
+    /**
+   * Runs the application.
+   *
+   * @param args -
+   *        The application arguments.
+   *
+   * @returns
+   *        The process exit code.
+   */ async run(args = {}) {
+        if (this._promise) {
+            return this._promise;
+        }
+        const { promise, resolve } = Promise.withResolvers();
+        this._resolve = resolve;
+        this._promise = promise;
+        const { msg } = ZCrumbtrailWatch;
+        const { directory = node_process.cwd(), globs = [
+            "**"
+        ] } = args;
+        this._globs = lodashEs.uniq(globs.slice());
+        this._globs = this._globs.length ? this._globs : [
+            "**"
+        ];
+        this._watch = new crumbtrailFs.ZFileWatch(directory);
+        const filter = globs.join(",");
+        this._logger.log(msg("Welcome to Crumbtrail CLI"));
+        this._logger.log(msg(`You are now watching ${directory}`));
+        this._logger.log(msg(`Files that match ${filter} will be logged here.`));
+        this._logger.log(msg("Press Ctrl+C to stop watching"));
+        this._watch.add().subscribe(this._handleAdd.bind(this));
+        this._watch.remove().subscribe(this._handleRemove.bind(this));
+        this._watch.update().subscribe(this._handleUpdate.bind(this));
+        this._ready = this._watch.start();
+        await this._ready;
+        return this._promise;
+    }
+    /**
+   * Initializes a new instance of this object.
+   *
+   * @param logger -
+   *        The logger to use to output events.
+   */ constructor(logger){
+        _define_property(this, "_logger", void 0);
+        _define_property(this, "_globs", void 0);
+        _define_property(this, "_watch", void 0);
+        _define_property(this, "_ready", Promise.resolve());
+        _define_property(this, "_promise", void 0);
+        _define_property(this, "_resolve", void 0);
+        this._logger = new lumberjackyLog.ZLoggerContext("ZCrumbtrailApp", logger);
+    }
+}
+
+exports.ZCrumbtrailNudge = ZCrumbtrailNudge;
+exports.ZCrumbtrailWatch = ZCrumbtrailWatch;
+//# sourceMappingURL=watch-C-6Gf4uc.cjs.map

package/dist/watch-C-6Gf4uc.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-C-6Gf4uc.cjs","sources":["../src/nudge/nudge.mts","../src/watch/watch.mts"],"sourcesContent":["import { ZWatchDelay } from \"@zthun/crumbtrail-fs\";\nimport { firstTruthy, sleep } from \"@zthun/helpful-fn\";\nimport type { IZLogger } from \"@zthun/lumberjacky-log\";\nimport { ZLogEntryBuilder, ZLoggerContext } from \"@zthun/lumberjacky-log\";\nimport glob from \"fast-glob\";\nimport { noop } from \"lodash-es\";\nimport { readdir } from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\n\n/**\n * Options for the nudge command.\n */\nexport interface IZCrumbtrailNudgeOptions {\n  /**\n   * The directory to nudge.\n   *\n   * The default if not specified is the current working directory.\n   */\n  directory?: string;\n\n  /**\n   * Whether to nudge recursively.\n   *\n   * Warning:  This can have severe CPU\n   * usage for deep directories.\n   *\n   * Default is false.\n   */\n  recursive?: boolean;\n\n  /**\n   * The total number of milliseconds to wait\n   * between nudges.\n   *\n   * Default is {@link ZWatchDelay}\n   */\n  every?: number;\n}\n\n/**\n * An operation to continuously nudge a directory.\n *\n * This is a special operation that lists the contents of a targeted parent directory.\n * The main reason for this is to work around an issue when you are running inside of\n * a container and your host is not linux.\n *\n * A lot of times, you will not receive events in this situation for add and update\n * until the virtual file bridge is refreshed by listing the outer directory contents.\n * This command helps to force the bridge to send file change events.  You should\n * only need this if you are running on a non linux host inside a docker container.\n *\n * Run a separate container in the background and just nudge the directory\n * for however long you need.\n */\nexport class ZCrumbtrailNudge {\n  private _controller?: AbortController;\n  private _resolve?: (val: number) => void;\n  private _promise?: Promise<number>;\n  private readonly _logger: IZLogger;\n\n  public constructor(logger: IZLogger) {\n    this._logger = new ZLoggerContext(\"ZCrumbtrailNudge\", logger);\n  }\n\n  public async kill(): Promise<void> {\n    this._controller?.abort();\n    delete this._controller;\n\n    await this._promise;\n    delete this._promise;\n  }\n\n  public async run(options: IZCrumbtrailNudgeOptions = {}): Promise<number> {\n    await this.kill();\n\n    const controller = new AbortController();\n    this._controller = controller;\n\n    const { promise, resolve } = Promise.withResolvers<number>();\n    this._promise = promise;\n    this._resolve = resolve;\n\n    const {\n      directory = process.cwd(),\n      recursive,\n      every = ZWatchDelay,\n    } = options;\n\n    const ms = firstTruthy(ZWatchDelay, every);\n\n    this._logger.log(\n      new ZLogEntryBuilder()\n        .info()\n        .message(`Starting a nudge loop every ${ms} milliseconds`)\n        .build(),\n    );\n\n    if (recursive) {\n      this._logger.log(\n        new ZLogEntryBuilder()\n          .warning()\n          .message(\"Nudging is recursive.  Child folders will be nudged too.\")\n          .build(),\n      );\n    }\n\n    do {\n      this._logger.log(\n        new ZLogEntryBuilder()\n          .info()\n          .message(`Nudging ${directory} to refresh`)\n          .build(),\n      );\n      await readdir(dirname(directory)).catch(noop);\n\n      if (recursive) {\n        await glob(`${directory}/**`, { onlyDirectories: true }).catch(noop);\n      }\n\n      await sleep(ms);\n    } while (!controller.signal.aborted);\n\n    resolve(0);\n    delete this._resolve;\n\n    return this._promise;\n  }\n}\n","import type { IZFileSystemNode } from \"@zthun/crumbtrail-fs\";\nimport { ZFileWatch } from \"@zthun/crumbtrail-fs\";\nimport { firstDefined } from \"@zthun/helpful-fn\";\nimport type { IZLogEntry, IZLogger } from \"@zthun/lumberjacky-log\";\nimport { ZLogEntryBuilder, ZLoggerContext } from \"@zthun/lumberjacky-log\";\nimport { uniq } from \"lodash-es\";\nimport { minimatch } from \"minimatch\";\nimport { resolve } from \"node:path\";\nimport { cwd } from \"node:process\";\n\n/**\n * Arguments for the crumbtrail app.\n */\nexport interface IZCrumbtrailWatchOptions {\n  /**\n   * The directory to watch.\n   *\n   * If this is falsy, then the cwd is used.\n   */\n  directory?: string;\n\n  /**\n   * The list of file globs to watch.\n   *\n   * If this is falsy or empty, then '**' is used.\n   */\n  globs?: string[];\n}\n\n/**\n * The root application for the crumbtrail cli.\n */\nexport class ZCrumbtrailWatch {\n  private _logger: IZLogger;\n  private _globs: string[] | undefined;\n  private _watch: ZFileWatch | undefined;\n  private _ready: Promise<void> = Promise.resolve();\n  private _promise: Promise<number> | undefined;\n  private _resolve: ((value: number) => void) | undefined;\n\n  /**\n   * Gets the entry for a basic information message.\n   *\n   * @returns\n   *        The log entry for a basic information message.\n   */\n  public static msg(msg: string): IZLogEntry {\n    return new ZLogEntryBuilder().info().message(msg).build();\n  }\n\n  /**\n   * Gets the message for when a file is added.\n   *\n   * @returns\n   *        The message for when a file is added.\n   */\n  public static add(path: string): IZLogEntry {\n    return new ZLogEntryBuilder().info().message(`Node added: ${path}`).build();\n  }\n\n  /**\n   * Gets the message for when a file/folder is removed.\n   *\n   * @returns\n   *        The message for when a file/folder is added.\n   */\n  public static remove(path: string): IZLogEntry {\n    return new ZLogEntryBuilder()\n      .warning()\n      .message(`Node removed: ${path}`)\n      .build();\n  }\n\n  /**\n   * Gets the message for when a file is updated.\n   *\n   * @returns\n   *        The message for when a file is updated.\n   */\n  public static update(path: string): IZLogEntry {\n    return new ZLogEntryBuilder()\n      .info()\n      .message(`Node updated: ${path}`)\n      .build();\n  }\n\n  /**\n   * Gets the current directory being watched.\n   *\n   * @returns\n   *        The directory that is watching for events.\n   */\n  public watching() {\n    return Promise.resolve(this._watch?.path);\n  }\n\n  /**\n   * Gets the list of globs that filter the directory contents.\n   *\n   * @returns\n   *      The list of globs that filter the directory contents.\n   */\n  public globs() {\n    return Promise.resolve(this._globs?.slice());\n  }\n\n  /**\n   * Returns a promise that can be awaited on to\n   * make sure the watch is initialized.\n   */\n  public async ready() {\n    return this._ready;\n  }\n\n  /**\n   * Initializes a new instance of this object.\n   *\n   * @param logger -\n   *        The logger to use to output events.\n   */\n  public constructor(logger: IZLogger) {\n    this._logger = new ZLoggerContext(\"ZCrumbtrailApp\", logger);\n  }\n\n  /**\n   * Kills the application.\n   */\n  public async kill(): Promise<void> {\n    await this._watch?.stop();\n\n    delete this._watch;\n    delete this._globs;\n    this._ready = Promise.resolve();\n\n    this._resolve?.(0);\n    await this._promise;\n    delete this._promise;\n  }\n\n  private _handleFsEvent(path: string, entry: IZLogEntry) {\n    const globs = firstDefined([\"**\"], this._globs);\n    const directory = firstDefined(cwd(), this._watch?.path);\n\n    if (globs?.some((g) => minimatch(path, resolve(directory, g)))) {\n      this._logger.log(entry);\n    }\n  }\n\n  private _handleAdd(node: IZFileSystemNode) {\n    const { add } = ZCrumbtrailWatch;\n    this._handleFsEvent(node.path, add(node.path));\n  }\n\n  private _handleRemove(node: IZFileSystemNode) {\n    const { remove } = ZCrumbtrailWatch;\n    this._handleFsEvent(node.path, remove(node.path));\n  }\n\n  private _handleUpdate(node: IZFileSystemNode) {\n    const { update } = ZCrumbtrailWatch;\n    this._handleFsEvent(node.path, update(node.path));\n  }\n\n  /**\n   * Runs the application.\n   *\n   * @param args -\n   *        The application arguments.\n   *\n   * @returns\n   *        The process exit code.\n   */\n  public async run(args: IZCrumbtrailWatchOptions = {}): Promise<number> {\n    if (this._promise) {\n      return this._promise;\n    }\n\n    const { promise, resolve } = Promise.withResolvers<number>();\n    this._resolve = resolve;\n    this._promise = promise;\n\n    const { msg } = ZCrumbtrailWatch;\n    const { directory = cwd(), globs = [\"**\"] } = args;\n\n    this._globs = uniq(globs.slice());\n    this._globs = this._globs.length ? this._globs : [\"**\"];\n    this._watch = new ZFileWatch(directory);\n\n    const filter = globs.join(\",\");\n    this._logger.log(msg(\"Welcome to Crumbtrail CLI\"));\n    this._logger.log(msg(`You are now watching ${directory}`));\n    this._logger.log(msg(`Files that match ${filter} will be logged here.`));\n    this._logger.log(msg(\"Press Ctrl+C to stop watching\"));\n\n    this._watch.add().subscribe(this._handleAdd.bind(this));\n    this._watch.remove().subscribe(this._handleRemove.bind(this));\n    this._watch.update().subscribe(this._handleUpdate.bind(this));\n\n    this._ready = this._watch.start();\n    await this._ready;\n\n    return this._promise;\n  }\n}\n"],"names":["ZCrumbtrailNudge","kill","_controller","abort","_promise","run","options","controller","AbortController","promise","resolve","Promise","withResolvers","_resolve","directory","process","cwd","recursive","every","ZWatchDelay","ms","firstTruthy","_logger","log","ZLogEntryBuilder","info","message","build","warning","readdir","dirname","catch","noop","glob","onlyDirectories","sleep","signal","aborted","logger","_define_property","ZLoggerContext","ZCrumbtrailWatch","msg","add","path","remove","update","watching","_watch","globs","_globs","slice","ready","_ready","stop","_handleFsEvent","entry","firstDefined","some","g","minimatch","_handleAdd","node","_handleRemove","_handleUpdate","args","uniq","length","ZFileWatch","filter","join","subscribe","bind","start"],"mappings":"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"}

package/dist/watch-DdpcqnOY.js

@@ -0,0 +1,236 @@
+import { ZWatchDelay, ZFileWatch } from '@zthun/crumbtrail-fs';
+import { firstTruthy, sleep, firstDefined } from '@zthun/helpful-fn';
+import { ZLogEntryBuilder, ZLoggerContext } from '@zthun/lumberjacky-log';
+import glob from 'fast-glob';
+import { noop, uniq } from 'lodash-es';
+import { readdir } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { minimatch } from 'minimatch';
+import { cwd } from 'node:process';
+
+function _define_property$1(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * An operation to continuously nudge a directory.
+ *
+ * This is a special operation that lists the contents of a targeted parent directory.
+ * The main reason for this is to work around an issue when you are running inside of
+ * a container and your host is not linux.
+ *
+ * A lot of times, you will not receive events in this situation for add and update
+ * until the virtual file bridge is refreshed by listing the outer directory contents.
+ * This command helps to force the bridge to send file change events.  You should
+ * only need this if you are running on a non linux host inside a docker container.
+ *
+ * Run a separate container in the background and just nudge the directory
+ * for however long you need.
+ */ class ZCrumbtrailNudge {
+    async kill() {
+        this._controller?.abort();
+        delete this._controller;
+        await this._promise;
+        delete this._promise;
+    }
+    async run(options = {}) {
+        await this.kill();
+        const controller = new AbortController();
+        this._controller = controller;
+        const { promise, resolve } = Promise.withResolvers();
+        this._promise = promise;
+        this._resolve = resolve;
+        const { directory = process.cwd(), recursive, every = ZWatchDelay } = options;
+        const ms = firstTruthy(ZWatchDelay, every);
+        this._logger.log(new ZLogEntryBuilder().info().message(`Starting a nudge loop every ${ms} milliseconds`).build());
+        if (recursive) {
+            this._logger.log(new ZLogEntryBuilder().warning().message("Nudging is recursive.  Child folders will be nudged too.").build());
+        }
+        do {
+            this._logger.log(new ZLogEntryBuilder().info().message(`Nudging ${directory} to refresh`).build());
+            await readdir(dirname(directory)).catch(noop);
+            if (recursive) {
+                await glob(`${directory}/**`, {
+                    onlyDirectories: true
+                }).catch(noop);
+            }
+            await sleep(ms);
+        }while (!controller.signal.aborted)
+        resolve(0);
+        delete this._resolve;
+        return this._promise;
+    }
+    constructor(logger){
+        _define_property$1(this, "_controller", void 0);
+        _define_property$1(this, "_resolve", void 0);
+        _define_property$1(this, "_promise", void 0);
+        _define_property$1(this, "_logger", void 0);
+        this._logger = new ZLoggerContext("ZCrumbtrailNudge", logger);
+    }
+}
+
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * The root application for the crumbtrail cli.
+ */ class ZCrumbtrailWatch {
+    /**
+   * Gets the entry for a basic information message.
+   *
+   * @returns
+   *        The log entry for a basic information message.
+   */ static msg(msg) {
+        return new ZLogEntryBuilder().info().message(msg).build();
+    }
+    /**
+   * Gets the message for when a file is added.
+   *
+   * @returns
+   *        The message for when a file is added.
+   */ static add(path) {
+        return new ZLogEntryBuilder().info().message(`Node added: ${path}`).build();
+    }
+    /**
+   * Gets the message for when a file/folder is removed.
+   *
+   * @returns
+   *        The message for when a file/folder is added.
+   */ static remove(path) {
+        return new ZLogEntryBuilder().warning().message(`Node removed: ${path}`).build();
+    }
+    /**
+   * Gets the message for when a file is updated.
+   *
+   * @returns
+   *        The message for when a file is updated.
+   */ static update(path) {
+        return new ZLogEntryBuilder().info().message(`Node updated: ${path}`).build();
+    }
+    /**
+   * Gets the current directory being watched.
+   *
+   * @returns
+   *        The directory that is watching for events.
+   */ watching() {
+        return Promise.resolve(this._watch?.path);
+    }
+    /**
+   * Gets the list of globs that filter the directory contents.
+   *
+   * @returns
+   *      The list of globs that filter the directory contents.
+   */ globs() {
+        return Promise.resolve(this._globs?.slice());
+    }
+    /**
+   * Returns a promise that can be awaited on to
+   * make sure the watch is initialized.
+   */ async ready() {
+        return this._ready;
+    }
+    /**
+   * Kills the application.
+   */ async kill() {
+        await this._watch?.stop();
+        delete this._watch;
+        delete this._globs;
+        this._ready = Promise.resolve();
+        this._resolve?.(0);
+        await this._promise;
+        delete this._promise;
+    }
+    _handleFsEvent(path, entry) {
+        const globs = firstDefined([
+            "**"
+        ], this._globs);
+        const directory = firstDefined(cwd(), this._watch?.path);
+        if (globs?.some((g)=>minimatch(path, resolve(directory, g)))) {
+            this._logger.log(entry);
+        }
+    }
+    _handleAdd(node) {
+        const { add } = ZCrumbtrailWatch;
+        this._handleFsEvent(node.path, add(node.path));
+    }
+    _handleRemove(node) {
+        const { remove } = ZCrumbtrailWatch;
+        this._handleFsEvent(node.path, remove(node.path));
+    }
+    _handleUpdate(node) {
+        const { update } = ZCrumbtrailWatch;
+        this._handleFsEvent(node.path, update(node.path));
+    }
+    /**
+   * Runs the application.
+   *
+   * @param args -
+   *        The application arguments.
+   *
+   * @returns
+   *        The process exit code.
+   */ async run(args = {}) {
+        if (this._promise) {
+            return this._promise;
+        }
+        const { promise, resolve } = Promise.withResolvers();
+        this._resolve = resolve;
+        this._promise = promise;
+        const { msg } = ZCrumbtrailWatch;
+        const { directory = cwd(), globs = [
+            "**"
+        ] } = args;
+        this._globs = uniq(globs.slice());
+        this._globs = this._globs.length ? this._globs : [
+            "**"
+        ];
+        this._watch = new ZFileWatch(directory);
+        const filter = globs.join(",");
+        this._logger.log(msg("Welcome to Crumbtrail CLI"));
+        this._logger.log(msg(`You are now watching ${directory}`));
+        this._logger.log(msg(`Files that match ${filter} will be logged here.`));
+        this._logger.log(msg("Press Ctrl+C to stop watching"));
+        this._watch.add().subscribe(this._handleAdd.bind(this));
+        this._watch.remove().subscribe(this._handleRemove.bind(this));
+        this._watch.update().subscribe(this._handleUpdate.bind(this));
+        this._ready = this._watch.start();
+        await this._ready;
+        return this._promise;
+    }
+    /**
+   * Initializes a new instance of this object.
+   *
+   * @param logger -
+   *        The logger to use to output events.
+   */ constructor(logger){
+        _define_property(this, "_logger", void 0);
+        _define_property(this, "_globs", void 0);
+        _define_property(this, "_watch", void 0);
+        _define_property(this, "_ready", Promise.resolve());
+        _define_property(this, "_promise", void 0);
+        _define_property(this, "_resolve", void 0);
+        this._logger = new ZLoggerContext("ZCrumbtrailApp", logger);
+    }
+}
+
+export { ZCrumbtrailNudge as Z, ZCrumbtrailWatch as a };
+//# sourceMappingURL=watch-DdpcqnOY.js.map

package/dist/watch-DdpcqnOY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-DdpcqnOY.js","sources":["../src/nudge/nudge.mts","../src/watch/watch.mts"],"sourcesContent":["import { ZWatchDelay } from \"@zthun/crumbtrail-fs\";\nimport { firstTruthy, sleep } from \"@zthun/helpful-fn\";\nimport type { IZLogger } from \"@zthun/lumberjacky-log\";\nimport { ZLogEntryBuilder, ZLoggerContext } from \"@zthun/lumberjacky-log\";\nimport glob from \"fast-glob\";\nimport { noop } from \"lodash-es\";\nimport { readdir } from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\n\n/**\n * Options for the nudge command.\n */\nexport interface IZCrumbtrailNudgeOptions {\n  /**\n   * The directory to nudge.\n   *\n   * The default if not specified is the current working directory.\n   */\n  directory?: string;\n\n  /**\n   * Whether to nudge recursively.\n   *\n   * Warning:  This can have severe CPU\n   * usage for deep directories.\n   *\n   * Default is false.\n   */\n  recursive?: boolean;\n\n  /**\n   * The total number of milliseconds to wait\n   * between nudges.\n   *\n   * Default is {@link ZWatchDelay}\n   */\n  every?: number;\n}\n\n/**\n * An operation to continuously nudge a directory.\n *\n * This is a special operation that lists the contents of a targeted parent directory.\n * The main reason for this is to work around an issue when you are running inside of\n * a container and your host is not linux.\n *\n * A lot of times, you will not receive events in this situation for add and update\n * until the virtual file bridge is refreshed by listing the outer directory contents.\n * This command helps to force the bridge to send file change events.  You should\n * only need this if you are running on a non linux host inside a docker container.\n *\n * Run a separate container in the background and just nudge the directory\n * for however long you need.\n */\nexport class ZCrumbtrailNudge {\n  private _controller?: AbortController;\n  private _resolve?: (val: number) => void;\n  private _promise?: Promise<number>;\n  private readonly _logger: IZLogger;\n\n  public constructor(logger: IZLogger) {\n    this._logger = new ZLoggerContext(\"ZCrumbtrailNudge\", logger);\n  }\n\n  public async kill(): Promise<void> {\n    this._controller?.abort();\n    delete this._controller;\n\n    await this._promise;\n    delete this._promise;\n  }\n\n  public async run(options: IZCrumbtrailNudgeOptions = {}): Promise<number> {\n    await this.kill();\n\n    const controller = new AbortController();\n    this._controller = controller;\n\n    const { promise, resolve } = Promise.withResolvers<number>();\n    this._promise = promise;\n    this._resolve = resolve;\n\n    const {\n      directory = process.cwd(),\n      recursive,\n      every = ZWatchDelay,\n    } = options;\n\n    const ms = firstTruthy(ZWatchDelay, every);\n\n    this._logger.log(\n      new ZLogEntryBuilder()\n        .info()\n        .message(`Starting a nudge loop every ${ms} milliseconds`)\n        .build(),\n    );\n\n    if (recursive) {\n      this._logger.log(\n        new ZLogEntryBuilder()\n          .warning()\n          .message(\"Nudging is recursive.  Child folders will be nudged too.\")\n          .build(),\n      );\n    }\n\n    do {\n      this._logger.log(\n        new ZLogEntryBuilder()\n          .info()\n          .message(`Nudging ${directory} to refresh`)\n          .build(),\n      );\n      await readdir(dirname(directory)).catch(noop);\n\n      if (recursive) {\n        await glob(`${directory}/**`, { onlyDirectories: true }).catch(noop);\n      }\n\n      await sleep(ms);\n    } while (!controller.signal.aborted);\n\n    resolve(0);\n    delete this._resolve;\n\n    return this._promise;\n  }\n}\n","import type { IZFileSystemNode } from \"@zthun/crumbtrail-fs\";\nimport { ZFileWatch } from \"@zthun/crumbtrail-fs\";\nimport { firstDefined } from \"@zthun/helpful-fn\";\nimport type { IZLogEntry, IZLogger } from \"@zthun/lumberjacky-log\";\nimport { ZLogEntryBuilder, ZLoggerContext } from \"@zthun/lumberjacky-log\";\nimport { uniq } from \"lodash-es\";\nimport { minimatch } from \"minimatch\";\nimport { resolve } from \"node:path\";\nimport { cwd } from \"node:process\";\n\n/**\n * Arguments for the crumbtrail app.\n */\nexport interface IZCrumbtrailWatchOptions {\n  /**\n   * The directory to watch.\n   *\n   * If this is falsy, then the cwd is used.\n   */\n  directory?: string;\n\n  /**\n   * The list of file globs to watch.\n   *\n   * If this is falsy or empty, then '**' is used.\n   */\n  globs?: string[];\n}\n\n/**\n * The root application for the crumbtrail cli.\n */\nexport class ZCrumbtrailWatch {\n  private _logger: IZLogger;\n  private _globs: string[] | undefined;\n  private _watch: ZFileWatch | undefined;\n  private _ready: Promise<void> = Promise.resolve();\n  private _promise: Promise<number> | undefined;\n  private _resolve: ((value: number) => void) | undefined;\n\n  /**\n   * Gets the entry for a basic information message.\n   *\n   * @returns\n   *        The log entry for a basic information message.\n   */\n  public static msg(msg: string): IZLogEntry {\n    return new ZLogEntryBuilder().info().message(msg).build();\n  }\n\n  /**\n   * Gets the message for when a file is added.\n   *\n   * @returns\n   *        The message for when a file is added.\n   */\n  public static add(path: string): IZLogEntry {\n    return new ZLogEntryBuilder().info().message(`Node added: ${path}`).build();\n  }\n\n  /**\n   * Gets the message for when a file/folder is removed.\n   *\n   * @returns\n   *        The message for when a file/folder is added.\n   */\n  public static remove(path: string): IZLogEntry {\n    return new ZLogEntryBuilder()\n      .warning()\n      .message(`Node removed: ${path}`)\n      .build();\n  }\n\n  /**\n   * Gets the message for when a file is updated.\n   *\n   * @returns\n   *        The message for when a file is updated.\n   */\n  public static update(path: string): IZLogEntry {\n    return new ZLogEntryBuilder()\n      .info()\n      .message(`Node updated: ${path}`)\n      .build();\n  }\n\n  /**\n   * Gets the current directory being watched.\n   *\n   * @returns\n   *        The directory that is watching for events.\n   */\n  public watching() {\n    return Promise.resolve(this._watch?.path);\n  }\n\n  /**\n   * Gets the list of globs that filter the directory contents.\n   *\n   * @returns\n   *      The list of globs that filter the directory contents.\n   */\n  public globs() {\n    return Promise.resolve(this._globs?.slice());\n  }\n\n  /**\n   * Returns a promise that can be awaited on to\n   * make sure the watch is initialized.\n   */\n  public async ready() {\n    return this._ready;\n  }\n\n  /**\n   * Initializes a new instance of this object.\n   *\n   * @param logger -\n   *        The logger to use to output events.\n   */\n  public constructor(logger: IZLogger) {\n    this._logger = new ZLoggerContext(\"ZCrumbtrailApp\", logger);\n  }\n\n  /**\n   * Kills the application.\n   */\n  public async kill(): Promise<void> {\n    await this._watch?.stop();\n\n    delete this._watch;\n    delete this._globs;\n    this._ready = Promise.resolve();\n\n    this._resolve?.(0);\n    await this._promise;\n    delete this._promise;\n  }\n\n  private _handleFsEvent(path: string, entry: IZLogEntry) {\n    const globs = firstDefined([\"**\"], this._globs);\n    const directory = firstDefined(cwd(), this._watch?.path);\n\n    if (globs?.some((g) => minimatch(path, resolve(directory, g)))) {\n      this._logger.log(entry);\n    }\n  }\n\n  private _handleAdd(node: IZFileSystemNode) {\n    const { add } = ZCrumbtrailWatch;\n    this._handleFsEvent(node.path, add(node.path));\n  }\n\n  private _handleRemove(node: IZFileSystemNode) {\n    const { remove } = ZCrumbtrailWatch;\n    this._handleFsEvent(node.path, remove(node.path));\n  }\n\n  private _handleUpdate(node: IZFileSystemNode) {\n    const { update } = ZCrumbtrailWatch;\n    this._handleFsEvent(node.path, update(node.path));\n  }\n\n  /**\n   * Runs the application.\n   *\n   * @param args -\n   *        The application arguments.\n   *\n   * @returns\n   *        The process exit code.\n   */\n  public async run(args: IZCrumbtrailWatchOptions = {}): Promise<number> {\n    if (this._promise) {\n      return this._promise;\n    }\n\n    const { promise, resolve } = Promise.withResolvers<number>();\n    this._resolve = resolve;\n    this._promise = promise;\n\n    const { msg } = ZCrumbtrailWatch;\n    const { directory = cwd(), globs = [\"**\"] } = args;\n\n    this._globs = uniq(globs.slice());\n    this._globs = this._globs.length ? this._globs : [\"**\"];\n    this._watch = new ZFileWatch(directory);\n\n    const filter = globs.join(\",\");\n    this._logger.log(msg(\"Welcome to Crumbtrail CLI\"));\n    this._logger.log(msg(`You are now watching ${directory}`));\n    this._logger.log(msg(`Files that match ${filter} will be logged here.`));\n    this._logger.log(msg(\"Press Ctrl+C to stop watching\"));\n\n    this._watch.add().subscribe(this._handleAdd.bind(this));\n    this._watch.remove().subscribe(this._handleRemove.bind(this));\n    this._watch.update().subscribe(this._handleUpdate.bind(this));\n\n    this._ready = this._watch.start();\n    await this._ready;\n\n    return this._promise;\n  }\n}\n"],"names":["ZCrumbtrailNudge","kill","_controller","abort","_promise","run","options","controller","AbortController","promise","resolve","Promise","withResolvers","_resolve","directory","process","cwd","recursive","every","ZWatchDelay","ms","firstTruthy","_logger","log","ZLogEntryBuilder","info","message","build","warning","readdir","dirname","catch","noop","glob","onlyDirectories","sleep","signal","aborted","logger","_define_property","ZLoggerContext","ZCrumbtrailWatch","msg","add","path","remove","update","watching","_watch","globs","_globs","slice","ready","_ready","stop","_handleFsEvent","entry","firstDefined","some","g","minimatch","_handleAdd","node","_handleRemove","_handleUpdate","args","uniq","length","ZFileWatch","filter","join","subscribe","bind","start"],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@zthun/crumbtrail-cli",
+  "version": "2.4.6",
+  "description": "An application for crumbtrail that helps with debugging io issues",
+  "author": "Anthony Bonta",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zthun/crumbtrail",
+    "directory": "packages/crumbtrail-cli"
+  },
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    "types": "./dist/index.d.mts",
+    "require": "./dist/index.cjs",
+    "import": "./dist/index.js"
+  },
+  "bin": "dist/cli.js",
+  "engines": {
+    "node": ">=24.13.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "start": "node ./dist/cli.js",
+    "debug": "tsx src/cli.mts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@zthun/crumbtrail-fs": "^2.4.6",
+    "@zthun/helpful-fn": "^9.11.5",
+    "@zthun/lumberjacky-log": "^4.0.4",
+    "commander": "^14.0.3",
+    "fast-glob": "^3.3.3",
+    "lodash-es": "^4.17.23",
+    "minimatch": "^10.1.2"
+  },
+  "devDependencies": {
+    "@zthun/janitor-build-config": "^19.5.6",
+    "@zthun/janitor-ts-config": "^19.5.3",
+    "tsx": "^4.21.0",
+    "typescript": "~5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.18",
+    "vitest-mock-extended": "^3.1.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "gitHead": "b092744640cbefa05311c878cf8e79326347fa01"
+}