@zthun/crumbtrail-cli 2.4.11 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zthun/crumbtrail-cli",
-  "version": "2.4.11",
+  "version": "3.0.0",
   "description": "An application for crumbtrail that helps with debugging io issues",
   "author": "Anthony Bonta",
   "license": "MIT",
@@ -10,47 +10,36 @@
     "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",
+  "bin": "dist/main.js",
   "engines": {
     "node": ">=24.13.0"
   },
   "scripts": {
     "build": "vite build",
-    "start": "node ./dist/cli.js",
-    "debug": "tsx src/cli.mts"
+    "start": "node ./dist/main.js",
+    "debug": "tsx src/main.mts"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@zthun/crumbtrail-fs": "^2.4.11",
-    "@zthun/helpful-fn": "^9.11.13",
-    "@zthun/lumberjacky-log": "^4.0.7",
-    "commander": "^14.0.3",
-    "fast-glob": "^3.3.3",
-    "lodash-es": "^4.18.1",
-    "minimatch": "^10.2.5"
+    "@zthun/crumbtrail-fs": "^3.0.0",
+    "@zthun/lumberjacky-log": "^4.0.9",
+    "commander": "^15.0.0"
   },
   "devDependencies": {
-    "@zthun/janitor-build-config": "^20.0.6",
-    "@zthun/janitor-ts-config": "^20.0.4",
-    "tsx": "^4.22.3",
-    "typescript": "~6.0.3",
-    "vite": "^8.0.14",
-    "vitest": "^4.1.7",
-    "vitest-mock-extended": "^4.0.0"
+    "@zthun/janitor-build-config": "^21.1.3",
+    "@zthun/janitor-ts-config": "^21.1.3",
+    "@zthun/janitor-vite": "^21.1.4",
+    "tsx": "^4.23.12",
+    "typescript": "^6.0.3",
+    "vite": "^8.2.2",
+    "vitest": "^4.1.11",
+    "vitest-mock-extended": "^5.1.1"
   },
   "files": [
     "dist"
   ],
   "sideEffects": false,
-  "gitHead": "b70b686b5976f3837f8fe6fbafe49b344251f20d"
+  "gitHead": "3aac05ac1a20f55ac9617dd55f69063e2cde261f"
 }

package/dist/cli.cjs

@@ -1,21 +0,0 @@
-#!/usr/bin/env node
-const require_watch = require("./watch-DXvYTgIr.cjs");
-let _zthun_crumbtrail_fs = require("@zthun/crumbtrail-fs");
-let _zthun_lumberjacky_log = require("@zthun/lumberjacky-log");
-let commander = require("commander");
-//#region src/cli.mts
-var logger = new _zthun_lumberjacky_log.ZLoggerConsole(console);
-var 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 result = await new require_watch.ZCrumbtrailWatch(logger).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), _zthun_crumbtrail_fs.ZWatchDelay).action(async (options) => {
-	const command = new require_watch.ZCrumbtrailNudge(options.silent ? new _zthun_lumberjacky_log.ZLoggerSilent() : logger);
-	process.exitCode = await command.run(options);
-});
-application.parse();
-//#endregion
-
-//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.cjs","names":["ZWatchDelay","ZLoggerConsole","ZLoggerSilent","Command","ZCrumbtrailNudge","ZCrumbtrailWatch","logger","console","application","name","description","command","isDefault","option","process","cwd","val","prev","concat","action","options","result","run","exitCode","v","Number","parseInt","log","silent","parse"],"sources":["../src/cli.mts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { ZWatchDelay } from \"@zthun/crumbtrail-fs\";\nimport { ZLoggerConsole, ZLoggerSilent } from \"@zthun/lumberjacky-log\";\nimport { Command } from \"commander\";\n\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"],"mappings":";;;;;;AAWA,IAAMM,SAAS,IAAIL,uBAAAA,eAAeM,OAAAA;AAClC,IAAMC,cAAc,IAAIL,UAAAA,QAAAA;AAExBK,YACGC,KAAK,gBAAA,EACLC,YAAY,oCAAA;AAEfF,YACGG,QAAQ,SAAS,EAAEC,WAAW,KAAK,CAAA,EACnCF,YAAY,mCAAA,EACZG,OAAO,yBAAyB,0BAA0BC,QAAQC,IAAG,CAAA,EACrEF,OACC,wBACA,8BACCG,KAAKC,SAAmBA,KAAKC,OAAOF,GAAAA,GACrC,CAAA,CAAE,EAEHG,OAAO,OAAOC,YAAAA;CAEb,MAAMC,SAAS,MAAMV,IADDN,cAAAA,iBAAiBC,MAChBK,EAAQW,IAAIF,OAAAA;CACjCN,QAAQS,WAAWF;AACrB,CAAA;AAEFb,YACGG,QAAQ,OAAA,EACRD,YAAY,gDAAA,EACZG,OAAO,0BAA0B,wBAAwBC,QAAQC,IAAG,CAAA,EACpEF,OAAO,eAAe,oCAAoC,KAAA,EAC1DA,OAAO,YAAY,0CAA0C,KAAA,EAC7DA,OACC,oBACA,wCACCW,MAAMC,OAAOC,SAASF,GAAG,EAAA,GAC1BxB,qBAAAA,WAAAA,EAEDmB,OAAO,OAAOC,YAAAA;CAEb,MAAMT,UAAU,IAAIP,cAAAA,iBADRgB,QAAQQ,SAAS,IAAI1B,uBAAAA,cAAAA,IAAkBI,MACdqB;CACrCb,QAAQS,WAAW,MAAMZ,QAAQW,IAAIF,OAAAA;AACvC,CAAA;AAEFZ,YAAYqB,MAAK"}

package/dist/cli.d.mts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/cli.js

@@ -1,21 +0,0 @@
-#!/usr/bin/env node
-import { n as ZCrumbtrailNudge, t as ZCrumbtrailWatch } from "./watch-peSooqy2.js";
-import { ZWatchDelay } from "@zthun/crumbtrail-fs";
-import { ZLoggerConsole, ZLoggerSilent } from "@zthun/lumberjacky-log";
-import { Command } from "commander";
-//#region src/cli.mts
-var logger = new ZLoggerConsole(console);
-var 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 result = await new ZCrumbtrailWatch(logger).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 command = new ZCrumbtrailNudge(options.silent ? new ZLoggerSilent() : logger);
-	process.exitCode = await command.run(options);
-});
-application.parse();
-//#endregion
-
-//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.js","names":["ZWatchDelay","ZLoggerConsole","ZLoggerSilent","Command","ZCrumbtrailNudge","ZCrumbtrailWatch","logger","console","application","name","description","command","isDefault","option","process","cwd","val","prev","concat","action","options","result","run","exitCode","v","Number","parseInt","log","silent","parse"],"sources":["../src/cli.mts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { ZWatchDelay } from \"@zthun/crumbtrail-fs\";\nimport { ZLoggerConsole, ZLoggerSilent } from \"@zthun/lumberjacky-log\";\nimport { Command } from \"commander\";\n\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"],"mappings":";;;;;;AAWA,IAAMM,SAAS,IAAIL,eAAeM,OAAAA;AAClC,IAAMC,cAAc,IAAIL,QAAAA;AAExBK,YACGC,KAAK,gBAAA,EACLC,YAAY,oCAAA;AAEfF,YACGG,QAAQ,SAAS,EAAEC,WAAW,KAAK,CAAA,EACnCF,YAAY,mCAAA,EACZG,OAAO,yBAAyB,0BAA0BC,QAAQC,IAAG,CAAA,EACrEF,OACC,wBACA,8BACCG,KAAKC,SAAmBA,KAAKC,OAAOF,GAAAA,GACrC,CAAA,CAAE,EAEHG,OAAO,OAAOC,YAAAA;CAEb,MAAMC,SAAS,MAAMV,IADDN,iBAAiBC,MAChBK,EAAQW,IAAIF,OAAAA;CACjCN,QAAQS,WAAWF;AACrB,CAAA;AAEFb,YACGG,QAAQ,OAAA,EACRD,YAAY,gDAAA,EACZG,OAAO,0BAA0B,wBAAwBC,QAAQC,IAAG,CAAA,EACpEF,OAAO,eAAe,oCAAoC,KAAA,EAC1DA,OAAO,YAAY,0CAA0C,KAAA,EAC7DA,OACC,oBACA,wCACCW,MAAMC,OAAOC,SAASF,GAAG,EAAA,GAC1BxB,WAAAA,EAEDmB,OAAO,OAAOC,YAAAA;CAEb,MAAMT,UAAU,IAAIP,iBADRgB,QAAQQ,SAAS,IAAI1B,cAAAA,IAAkBI,MACdqB;CACrCb,QAAQS,WAAW,MAAMZ,QAAQW,IAAIF,OAAAA;AACvC,CAAA;AAEFZ,YAAYqB,MAAK"}

package/dist/index.cjs

@@ -1,4 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_watch = require("./watch-DXvYTgIr.cjs");
-exports.ZCrumbtrailNudge = require_watch.ZCrumbtrailNudge;
-exports.ZCrumbtrailWatch = require_watch.ZCrumbtrailWatch;

package/dist/index.d.mts

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

package/dist/index.js

@@ -1,2 +0,0 @@
-import { n as ZCrumbtrailNudge, t as ZCrumbtrailWatch } from "./watch-peSooqy2.js";
-export { ZCrumbtrailNudge, ZCrumbtrailWatch };

package/dist/nudge/nudge.d.mts

@@ -1,52 +0,0 @@
-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

@@ -1,101 +0,0 @@
-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-DXvYTgIr.cjs

@@ -1,226 +0,0 @@
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-let node_fs_promises = require("node:fs/promises");
-let node_path = require("node:path");
-let _zthun_crumbtrail_fs = require("@zthun/crumbtrail-fs");
-let _zthun_helpful_fn = require("@zthun/helpful-fn");
-let _zthun_lumberjacky_log = require("@zthun/lumberjacky-log");
-let fast_glob = require("fast-glob");
-fast_glob = __toESM(fast_glob, 1);
-let lodash_es = require("lodash-es");
-let node_process = require("node:process");
-let minimatch = require("minimatch");
-//#region src/nudge/nudge.mts
-/**
-* 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.
-*/ var ZCrumbtrailNudge = class {
-	_controller;
-	_resolve;
-	_promise;
-	_logger;
-	constructor(logger) {
-		this._logger = new _zthun_lumberjacky_log.ZLoggerContext("ZCrumbtrailNudge", logger);
-	}
-	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 = _zthun_crumbtrail_fs.ZWatchDelay } = options;
-		const ms = (0, _zthun_helpful_fn.firstTruthy)(_zthun_crumbtrail_fs.ZWatchDelay, every);
-		this._logger.log(new _zthun_lumberjacky_log.ZLogEntryBuilder().info().message(`Starting a nudge loop every ${ms} milliseconds`).build());
-		if (recursive) this._logger.log(new _zthun_lumberjacky_log.ZLogEntryBuilder().warning().message("Nudging is recursive.  Child folders will be nudged too.").build());
-		do {
-			this._logger.log(new _zthun_lumberjacky_log.ZLogEntryBuilder().info().message(`Nudging ${directory} to refresh`).build());
-			await (0, node_fs_promises.readdir)((0, node_path.dirname)(directory)).catch(lodash_es.noop);
-			if (recursive) await (0, fast_glob.default)(`${directory}/**`, { onlyDirectories: true }).catch(lodash_es.noop);
-			await (0, _zthun_helpful_fn.sleep)(ms);
-		} while (!controller.signal.aborted);
-		resolve(0);
-		delete this._resolve;
-		return this._promise;
-	}
-};
-//#endregion
-//#region src/watch/watch.mts
-/**
-* The root application for the crumbtrail cli.
-*/ var ZCrumbtrailWatch = class ZCrumbtrailWatch {
-	_logger;
-	_globs;
-	_watch;
-	_ready = Promise.resolve();
-	_promise;
-	_resolve;
-	/**
-	* Gets the entry for a basic information message.
-	*
-	* @returns
-	*        The log entry for a basic information message.
-	*/ static msg(msg) {
-		return new _zthun_lumberjacky_log.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 _zthun_lumberjacky_log.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 _zthun_lumberjacky_log.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 _zthun_lumberjacky_log.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;
-	}
-	/**
-	* Initializes a new instance of this object.
-	*
-	* @param logger -
-	*        The logger to use to output events.
-	*/ constructor(logger) {
-		this._logger = new _zthun_lumberjacky_log.ZLoggerContext("ZCrumbtrailApp", logger);
-	}
-	/**
-	* 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 = (0, _zthun_helpful_fn.firstDefined)(["**"], this._globs);
-		const directory = (0, _zthun_helpful_fn.firstDefined)((0, node_process.cwd)(), this._watch?.path);
-		if (globs?.some((g) => (0, minimatch.minimatch)(path, (0, node_path.resolve)(directory, g)))) this._logger.log(entry);
-	}
-	_handleAdd(node) {
-		this._handleFsEvent(node.path, ZCrumbtrailWatch.add(node.path));
-	}
-	_handleRemove(node) {
-		this._handleFsEvent(node.path, ZCrumbtrailWatch.remove(node.path));
-	}
-	_handleUpdate(node) {
-		this._handleFsEvent(node.path, ZCrumbtrailWatch.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 { directory = (0, node_process.cwd)(), globs = ["**"] } = args;
-		this._globs = (0, lodash_es.uniq)(globs.slice());
-		this._globs = this._globs.length ? this._globs : ["**"];
-		this._watch = new _zthun_crumbtrail_fs.ZFileWatch(directory);
-		const filter = globs.join(",");
-		this._logger.log(ZCrumbtrailWatch.msg("Welcome to Crumbtrail CLI"));
-		this._logger.log(ZCrumbtrailWatch.msg(`You are now watching ${directory}`));
-		this._logger.log(ZCrumbtrailWatch.msg(`Logging files matching ${filter}.`));
-		this._logger.log(ZCrumbtrailWatch.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;
-	}
-};
-//#endregion
-Object.defineProperty(exports, "ZCrumbtrailNudge", {
-	enumerable: true,
-	get: function() {
-		return ZCrumbtrailNudge;
-	}
-});
-Object.defineProperty(exports, "ZCrumbtrailWatch", {
-	enumerable: true,
-	get: function() {
-		return ZCrumbtrailWatch;
-	}
-});
-
-//# sourceMappingURL=watch-DXvYTgIr.cjs.map

package/dist/watch-DXvYTgIr.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"watch-DXvYTgIr.cjs","names":["readdir","dirname","ZWatchDelay","firstTruthy","sleep","ZLogEntryBuilder","ZLoggerContext","glob","noop","ZCrumbtrailNudge","_controller","_resolve","_promise","_logger","logger","kill","abort","run","options","controller","AbortController","promise","resolve","Promise","withResolvers","directory","process","cwd","recursive","every","ms","log","info","message","build","warning","catch","onlyDirectories","signal","aborted","resolve","cwd","ZFileWatch","firstDefined","ZLogEntryBuilder","ZLoggerContext","uniq","minimatch","ZCrumbtrailWatch","_logger","_globs","_watch","_ready","Promise","_promise","_resolve","msg","info","message","build","add","path","remove","warning","update","watching","globs","slice","ready","logger","kill","stop","_handleFsEvent","entry","directory","some","g","log","_handleAdd","node","_handleRemove","_handleUpdate","run","args","promise","withResolvers","length","filter","join","subscribe","bind","start"],"sources":["../src/nudge/nudge.mts","../src/watch/watch.mts"],"sourcesContent":["import { readdir } from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\n\nimport { 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\";\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 { resolve } from \"node:path\";\nimport { cwd } from \"node:process\";\n\nimport 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\";\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    this._handleFsEvent(node.path, ZCrumbtrailWatch.add(node.path));\n  }\n\n  private _handleRemove(node: IZFileSystemNode) {\n    this._handleFsEvent(node.path, ZCrumbtrailWatch.remove(node.path));\n  }\n\n  private _handleUpdate(node: IZFileSystemNode) {\n    this._handleFsEvent(node.path, ZCrumbtrailWatch.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 { 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(ZCrumbtrailWatch.msg(\"Welcome to Crumbtrail CLI\"));\n    this._logger.log(ZCrumbtrailWatch.msg(`You are now watching ${directory}`));\n    this._logger.log(ZCrumbtrailWatch.msg(`Logging files matching ${filter}.`));\n    this._logger.log(ZCrumbtrailWatch.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"],"mappings":"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"}