npmdata 0.11.0 → 0.12.0

package/dist/cli/argv.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgv = parseArgv;
+exports.buildEntriesFromArgv = buildEntriesFromArgv;
+exports.applyArgvOverrides = applyArgvOverrides;
+const utils_1 = require("../utils");
+/**
+ * Parse all supported CLI flags from an argv array.
+ * Validates mutually exclusive combinations and throws on invalid input.
+ */
+function parseArgv(argv) {
+    const getFlag = (flag) => argv.includes(flag);
+    const getValue = (flag, shortFlag) => {
+        // eslint-disable-next-line no-undefined
+        const idx = argv.findIndex((a) => a === flag || (shortFlag !== undefined && a === shortFlag));
+        if (idx === -1 || idx + 1 >= argv.length) {
+            // eslint-disable-next-line no-undefined
+            return undefined;
+        }
+        return argv[idx + 1];
+    };
+    const getCommaSplit = (flag, shortFlag) => {
+        const val = getValue(flag, shortFlag);
+        // eslint-disable-next-line no-undefined
+        if (val === undefined) {
+            // eslint-disable-next-line no-undefined
+            return undefined;
+        }
+        return val
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+    };
+    const force = getFlag('--force');
+    const keepExisting = getFlag('--keep-existing');
+    if (force && keepExisting) {
+        throw new Error('--force and --keep-existing are mutually exclusive');
+    }
+    const packagesRaw = getCommaSplit('--packages');
+    const packages = packagesRaw?.map((s) => (0, utils_1.parsePackageSpec)(s));
+    return {
+        packages,
+        output: getValue('--output', '-o'),
+        files: getCommaSplit('--files'),
+        contentRegexes: getCommaSplit('--content-regex'),
+        presets: getCommaSplit('--presets'),
+        force,
+        keepExisting,
+        noGitignore: getFlag('--no-gitignore'),
+        unmanaged: getFlag('--unmanaged'),
+        dryRun: getFlag('--dry-run'),
+        upgrade: getFlag('--upgrade'),
+        silent: getFlag('--silent'),
+        verbose: getFlag('--verbose') || getFlag('-v'),
+    };
+}
+/**
+ * Build NpmdataExtractEntry objects from --packages + --output CLI flags.
+ * Returns null if --packages is not set.
+ */
+function buildEntriesFromArgv(parsed) {
+    if (!parsed.packages || parsed.packages.length === 0) {
+        // eslint-disable-next-line unicorn/no-null
+        return null;
+    }
+    const selector = {};
+    if (parsed.files)
+        selector.files = parsed.files;
+    if (parsed.contentRegexes)
+        selector.contentRegexes = parsed.contentRegexes;
+    if (parsed.presets)
+        selector.presets = parsed.presets;
+    if (parsed.upgrade)
+        selector.upgrade = true;
+    const output = {
+        path: parsed.output ?? '.',
+        force: parsed.force,
+        keepExisting: parsed.keepExisting,
+        gitignore: !parsed.noGitignore,
+        unmanaged: parsed.unmanaged,
+        dryRun: parsed.dryRun,
+    };
+    return parsed.packages.map((pkg) => ({
+        package: pkg.version ? `${pkg.name}@${pkg.version}` : pkg.name,
+        output,
+        selector,
+        silent: parsed.silent,
+        verbose: parsed.verbose,
+    }));
+}
+/**
+ * Apply CLI overrides from ParsedArgv to each NpmdataExtractEntry.
+ * CLI flags always take precedence over config file values.
+ */
+function applyArgvOverrides(entries, parsed) {
+    return entries.map((entry) => {
+        const updatedOutput = {
+            ...entry.output,
+            // eslint-disable-next-line no-undefined
+            ...(parsed.output !== undefined
+                ? // eslint-disable-next-line no-undefined
+                    { path: parsed.output }
+                : {}),
+            ...(parsed.force ? { force: true } : {}),
+            ...(parsed.keepExisting ? { keepExisting: true } : {}),
+            ...(parsed.noGitignore ? { gitignore: false } : {}),
+            ...(parsed.unmanaged ? { unmanaged: true } : {}),
+            ...(parsed.dryRun ? { dryRun: true } : {}),
+        };
+        const updatedSelector = {
+            ...entry.selector,
+            ...(parsed.files ? { files: parsed.files } : {}),
+            ...(parsed.contentRegexes ? { contentRegexes: parsed.contentRegexes } : {}),
+            ...(parsed.upgrade ? { upgrade: true } : {}),
+        };
+        return {
+            ...entry,
+            output: updatedOutput,
+            selector: updatedSelector,
+            ...(parsed.silent ? { silent: true } : {}),
+            ...(parsed.verbose ? { verbose: true } : {}),
+        };
+    });
+}
+//# sourceMappingURL=argv.js.map

package/dist/cli/argv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv.js","sourceRoot":"","sources":["../../src/cli/argv.ts"],"names":[],"mappings":"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"}

package/dist/cli/cli.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Top-level CLI router.
+ * Detects command from argv, loads config, and dispatches to appropriate handler.
+ *
+ * @param argv - Process argument vector (argv[0] = node, argv[1] = script).
+ * @param cwd  - Working directory override (defaults to process.cwd()).
+ */
+export declare function cli(argv: string[], cwd?: string): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDrE"}

package/dist/cli/cli.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cli = cli;
+/* eslint-disable no-console */
+const config_1 = require("../package/config");
+const usage_1 = require("./usage");
+const extract_1 = require("./actions/extract");
+const check_1 = require("./actions/check");
+const list_1 = require("./actions/list");
+const purge_1 = require("./actions/purge");
+const init_1 = require("./actions/init");
+const KNOWN_COMMANDS = new Set(['extract', 'check', 'list', 'purge', 'init']);
+/**
+ * Top-level CLI router.
+ * Detects command from argv, loads config, and dispatches to appropriate handler.
+ *
+ * @param argv - Process argument vector (argv[0] = node, argv[1] = script).
+ * @param cwd  - Working directory override (defaults to process.cwd()).
+ */
+async function cli(argv, cwd) {
+    const args = argv.slice(2); // strip node + script
+    // Handle global --help with no command
+    if (args.includes('--help') && args.length === 1) {
+        (0, usage_1.printUsage)();
+        return;
+    }
+    // Handle global --version
+    if (args.includes('--version')) {
+        (0, usage_1.printVersion)();
+        return;
+    }
+    // Detect action
+    let action;
+    let cmdArgs;
+    const firstArg = args[0];
+    if (firstArg && KNOWN_COMMANDS.has(firstArg)) {
+        action = firstArg;
+        cmdArgs = args.slice(1);
+    }
+    else {
+        // Default to extract
+        action = 'extract';
+        cmdArgs = args;
+    }
+    // Load config from cwd
+    const effectiveCwd = cwd ?? process.cwd();
+    const config = await (0, config_1.loadNpmdataConfig)(effectiveCwd);
+    switch (action) {
+        case 'extract':
+            await (0, extract_1.runExtract)(config, cmdArgs, effectiveCwd);
+            break;
+        case 'check':
+            await (0, check_1.runCheck)(config, cmdArgs, effectiveCwd);
+            break;
+        case 'list':
+            await (0, list_1.runList)(config, cmdArgs, effectiveCwd);
+            break;
+        case 'purge':
+            await (0, purge_1.runPurge)(config, cmdArgs, effectiveCwd);
+            break;
+        case 'init':
+            await (0, init_1.runInit)(config, cmdArgs, effectiveCwd);
+            break;
+        default:
+            console.error(`Unknown command: ${action}`);
+            process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":";;AAmBA,kBAqDC;AAxED,+BAA+B;AAC/B,8CAAsD;AAEtD,mCAAmD;AACnD,+CAA+C;AAC/C,2CAA2C;AAC3C,yCAAyC;AACzC,2CAA2C;AAC3C,yCAAyC;AAEzC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9E;;;;;;GAMG;AACI,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,GAAY;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;IAElD,uCAAuC;IACvC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,IAAA,kBAAU,GAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,0BAA0B;IAC1B,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,IAAA,oBAAY,GAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,gBAAgB;IAChB,IAAI,MAAc,CAAC;IACnB,IAAI,OAAiB,CAAC;IAEtB,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,QAAQ,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,MAAM,GAAG,QAAQ,CAAC;QAClB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,qBAAqB;QACrB,MAAM,GAAG,SAAS,CAAC;QACnB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,uBAAuB;IACvB,MAAM,YAAY,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAiB,EAAC,YAAY,CAAC,CAAC;IAErD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,MAAM,IAAA,oBAAU,EAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YAChD,MAAM;QACR,KAAK,OAAO;YACV,MAAM,IAAA,gBAAQ,EAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YAC9C,MAAM;QACR,KAAK,MAAM;YACT,MAAM,IAAA,cAAO,EAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YAC7C,MAAM;QACR,KAAK,OAAO;YACV,MAAM,IAAA,gBAAQ,EAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YAC9C,MAAM;QACR,KAAK,MAAM;YACT,MAAM,IAAA,cAAO,EAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YAC7C,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;YAC5C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/cli/runner.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Entry point for self-installable packages generated by `init`.
+ * Called from bin/npmdata.js: require('npmdata').run(__dirname, process.argv.slice(2))
+ *
+ * @param binDir   Absolute path to the bin/ directory of the hosting package.
+ * @param argv     CLI arguments (process.argv.slice(2) from bin shim).
+ */
+export declare function run(binDir: string, argv?: string[]): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/cli/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AAEH,wBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsF5E"}

package/dist/cli/runner.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+/* eslint-disable functional/no-try-statements */
+/* eslint-disable no-console */
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const action_extract_1 = require("../package/action-extract");
+const action_check_1 = require("../package/action-check");
+const action_list_1 = require("../package/action-list");
+const action_purge_1 = require("../package/action-purge");
+const utils_1 = require("../utils");
+const argv_1 = require("./argv");
+/**
+ * Entry point for self-installable packages generated by `init`.
+ * Called from bin/npmdata.js: require('npmdata').run(__dirname, process.argv.slice(2))
+ *
+ * @param binDir   Absolute path to the bin/ directory of the hosting package.
+ * @param argv     CLI arguments (process.argv.slice(2) from bin shim).
+ */
+// eslint-disable-next-line complexity
+async function run(binDir, argv = []) {
+    const pkgDir = node_path_1.default.dirname(binDir);
+    const pkgJsonPath = node_path_1.default.join(pkgDir, 'package.json');
+    let pkgName = node_path_1.default.basename(pkgDir);
+    let sets;
+    try {
+        const pkgJson = JSON.parse(node_fs_1.default.readFileSync(pkgJsonPath).toString());
+        pkgName = pkgJson.name ?? pkgName;
+        sets = pkgJson.npmdata?.sets;
+    }
+    catch {
+        // No package.json or parse error
+    }
+    // Fallback: synthetic single-entry when no sets defined
+    const entries = sets ?? [{ package: pkgName, output: { path: '.' } }];
+    const config = { sets: entries };
+    const cwd = process.cwd();
+    // Parse command from argv (same as CLI)
+    const firstArg = argv[0];
+    const KNOWN_COMMANDS = new Set(['extract', 'check', 'list', 'purge']);
+    let command = 'extract';
+    let cmdArgs = argv;
+    if (firstArg && KNOWN_COMMANDS.has(firstArg)) {
+        command = firstArg;
+        cmdArgs = argv.slice(1);
+    }
+    let parsed;
+    try {
+        parsed = (0, argv_1.parseArgv)(cmdArgs);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    // --packages overrides sets
+    const cliEntries = (0, argv_1.buildEntriesFromArgv)(parsed);
+    const activeEntries = cliEntries ?? entries;
+    const overridden = (0, argv_1.applyArgvOverrides)(activeEntries, parsed);
+    const presets = parsed.presets ?? [];
+    const filtered = (0, utils_1.filterEntriesByPresets)(overridden, presets);
+    try {
+        switch (command) {
+            case 'extract': {
+                await (0, action_extract_1.actionExtract)({ entries: filtered, config, cwd });
+                break;
+            }
+            case 'check': {
+                const summary = await (0, action_check_1.actionCheck)({ entries: filtered, config, cwd });
+                if (summary.missing.length > 0 || summary.modified.length > 0 || summary.extra.length > 0) {
+                    for (const f of summary.missing)
+                        console.log(`missing: ${f}`);
+                    for (const f of summary.modified)
+                        console.log(`modified: ${f}`);
+                    for (const f of summary.extra)
+                        console.log(`extra: ${f}`);
+                    process.exitCode = 1;
+                }
+                break;
+            }
+            case 'list': {
+                const files = await (0, action_list_1.actionList)({ entries: filtered, config, cwd });
+                for (const f of files) {
+                    console.log(`${f.path}  ${f.packageName}@${f.packageVersion}`);
+                }
+                break;
+            }
+            case 'purge': {
+                await (0, action_purge_1.actionPurge)({ entries: filtered, config, cwd, presets, dryRun: parsed.dryRun });
+                break;
+            }
+            default:
+                console.error(`Unknown command: ${command}`);
+                process.exitCode = 1;
+        }
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/cli/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"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"}

package/dist/cli/usage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Print usage/help text for the given command to stdout.
+ */
+export declare function printUsage(command?: string): void;
+export declare function printVersion(): void;
+//# sourceMappingURL=usage.d.ts.map

package/dist/cli/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAqHjD;AAED,wBAAgB,YAAY,IAAI,IAAI,CAGnC"}

package/dist/cli/usage.js

@@ -0,0 +1,126 @@
+"use strict";
+/* eslint-disable no-console */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printUsage = printUsage;
+exports.printVersion = printVersion;
+const VERSION = '2.0.0';
+/**
+ * Print usage/help text for the given command to stdout.
+ */
+function printUsage(command) {
+    const cmd = command ?? 'extract';
+    switch (cmd) {
+        case 'extract':
+            console.log(`
+Usage: npmdata [extract] [options]
+
+Extract files from one or more npm packages into a local output directory.
+
+Options:
+  --packages <specs>      Comma-separated package specs (e.g. my-pkg@^1.2.3). Overrides config sets.
+  --output, -o <dir>      Output directory path. Required when --packages is used.
+  --files <globs>         Comma-separated glob patterns for file selection.
+  --content-regex <re>    Comma-separated regex strings for content filtering.
+  --force                 Overwrite existing unmanaged files.
+  --keep-existing         Skip files that already exist; create missing ones.
+  --no-gitignore          Disable .gitignore update alongside each marker.
+  --unmanaged             Write without .npmdata marker; no gitignore; no read-only.
+  --dry-run               Report changes without writing to disk.
+  --upgrade               Force fresh package install even if satisfying version installed.
+  --presets <tags>        Comma-separated preset tags; only matching entries are processed.
+  --silent                Suppress per-file output; print only final summary line.
+  --verbose, -v           Print detailed step information.
+  --help                  Print this help text.
+  --version               Print version.
+
+Exit codes: 0 success | 1 error
+`);
+            break;
+        case 'check':
+            console.log(`
+Usage: npmdata check [options]
+
+Verify that locally extracted files match their package sources.
+
+Options:
+  --packages <specs>      Comma-separated package specs. Overrides config sets.
+  --output, -o <dir>      Output directory path.
+  --files <globs>         Glob patterns for file selection.
+  --content-regex <re>    Regex strings for content filtering.
+  --unmanaged             Silently skip unmanaged entries.
+  --presets <tags>        Comma-separated preset tags; only matching entries are checked.
+  --verbose, -v           Print detailed comparison information.
+  --help                  Print this help text.
+
+Exit codes: 0 all in sync | 1 drift detected or error
+`);
+            break;
+        case 'list':
+            console.log(`
+Usage: npmdata list [options]
+
+Print all files currently managed by npmdata in the output directory.
+
+Options:
+  --output, -o <dir>      Output directory to inspect.
+  --verbose, -v           Print additional metadata per file.
+  --help                  Print this help text.
+
+Output format: <relPath>  <packageName>@<packageVersion>
+Exit codes: 0 always
+`);
+            break;
+        case 'purge':
+            console.log(`
+Usage: npmdata purge [options]
+
+Remove all managed files from the output directory.
+
+Options:
+  --packages <specs>      Comma-separated package specs. Limits purge to matching entries.
+  --output, -o <dir>      Output directory to purge.
+  --presets <tags>        Comma-separated preset tags; only matching entries are purged.
+  --dry-run               Print what would be removed without deleting.
+  --silent                Suppress per-file output.
+  --verbose, -v           Print detailed deletion steps.
+  --help                  Print this help text.
+
+Exit codes: 0 purge complete | 1 error during deletion
+`);
+            break;
+        case 'init':
+            console.log(`
+Usage: npmdata init [options]
+
+Scaffold a new publishable npm data package.
+
+Options:
+  --output, -o <dir>      Directory to scaffold into (default: current dir).
+  --verbose, -v           Print scaffolding steps.
+  --help                  Print this help text.
+
+Created files: package.json, bin/npmdata.js
+Exit codes: 0 success | 1 target dir has conflicting files
+`);
+            break;
+        default:
+            console.log(`
+Usage: npmdata [command] [options]
+
+Commands:
+  extract (default)  Extract files from npm packages
+  check              Verify extracted files match package sources
+  list               List all managed files
+  purge              Remove managed files
+  init               Scaffold a publishable data package
+
+Run 'npmdata <command> --help' for command-specific help.
+Version: ${VERSION}
+`);
+    }
+}
+function printVersion() {
+    // Try to read version from package.json
+    console.log(`npmdata v${VERSION}`);
+}
+//# sourceMappingURL=usage.js.map

package/dist/cli/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":";AAAA,+BAA+B;;AAO/B,gCAqHC;AAED,oCAGC;AA/HD,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB;;GAEG;AACH,SAAgB,UAAU,CAAC,OAAgB;IACzC,MAAM,GAAG,GAAG,OAAO,IAAI,SAAS,CAAC;IAEjC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;CAuBjB,CAAC,CAAC;YACG,MAAM;QAER,KAAK,OAAO;YACV,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;CAgBjB,CAAC,CAAC;YACG,MAAM;QAER,KAAK,MAAM;YACT,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;CAYjB,CAAC,CAAC;YACG,MAAM;QAER,KAAK,OAAO;YACV,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;CAejB,CAAC,CAAC;YACG,MAAM;QAER,KAAK,MAAM;YACT,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;CAYjB,CAAC,CAAC;YACG,MAAM;QAER;YACE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;WAWP,OAAO;CACjB,CAAC,CAAC;IACD,CAAC;AACH,CAAC;AAED,SAAgB,YAAY;IAC1B,wCAAwC;IACxC,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/fileset/check.d.ts

@@ -0,0 +1,15 @@
+import { SelectorConfig, OutputConfig, ManagedFileMetadata, CheckResult } from '../types';
+/**
+ * Check whether locally extracted files are in sync with their package source.
+ * Reuses diff logic to classify files as missing, modified, or extra.
+ * Applies contentReplacements before hash comparison.
+ *
+ * @param pkgPath       Absolute path to the installed package directory, or null if not installed.
+ * @param outputDir     Absolute path to the output directory.
+ * @param selector      SelectorConfig controlling which package files are in scope.
+ * @param outputConfig  OutputConfig (used for contentReplacements).
+ * @param marker        Managed file entries from the .npmdata marker.
+ * @returns CheckResult with missing, modified, and extra arrays.
+ */
+export declare function checkFileset(pkgPath: string | null, outputDir: string, selector: SelectorConfig, outputConfig: OutputConfig, marker: ManagedFileMetadata[]): Promise<CheckResult>;
+//# sourceMappingURL=check.d.ts.map

package/dist/fileset/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/fileset/check.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,WAAW,EAEZ,MAAM,UAAU,CAAC;AAMlB;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,OAAO,CAAC,WAAW,CAAC,CAmDtB"}

package/dist/fileset/check.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkFileset = checkFileset;
+/* eslint-disable no-restricted-syntax */
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const utils_1 = require("../utils");
+const content_replacements_1 = require("../package/content-replacements");
+const package_files_1 = require("./package-files");
+/**
+ * Check whether locally extracted files are in sync with their package source.
+ * Reuses diff logic to classify files as missing, modified, or extra.
+ * Applies contentReplacements before hash comparison.
+ *
+ * @param pkgPath       Absolute path to the installed package directory, or null if not installed.
+ * @param outputDir     Absolute path to the output directory.
+ * @param selector      SelectorConfig controlling which package files are in scope.
+ * @param outputConfig  OutputConfig (used for contentReplacements).
+ * @param marker        Managed file entries from the .npmdata marker.
+ * @returns CheckResult with missing, modified, and extra arrays.
+ */
+async function checkFileset(pkgPath, outputDir, selector, outputConfig, marker) {
+    const contentReplacements = outputConfig.contentReplacements ?? [];
+    if (!pkgPath) {
+        // Package not installed
+        return {
+            missing: marker.map((m) => m.path),
+            modified: [],
+            extra: [],
+        };
+    }
+    const managedByPath = new Map(marker.map((m) => [m.path, m]));
+    // Enumerate files from package (in scope)
+    const pkgFiles = await (0, package_files_1.enumeratePackageFiles)(pkgPath, selector);
+    const pkgFileSet = new Set(pkgFiles);
+    const result = { missing: [], modified: [], extra: [] };
+    // Check each managed file
+    for (const m of marker) {
+        const destPath = node_path_1.default.join(outputDir, m.path);
+        if (!node_fs_1.default.existsSync(destPath)) {
+            result.missing.push(m.path);
+            continue;
+        }
+        // Compare hash with content replacements applied
+        if (pkgFileSet.has(m.path)) {
+            const srcPath = node_path_1.default.join(pkgPath, m.path);
+            const srcContent = node_fs_1.default.readFileSync(srcPath, 'utf8');
+            const transformed = (0, content_replacements_1.applyContentReplacementsToBuffer)(srcContent, contentReplacements);
+            const srcHash = (0, utils_1.hashBuffer)(transformed);
+            // eslint-disable-next-line no-await-in-loop
+            const destHash = await (0, utils_1.hashFile)(destPath);
+            if (srcHash !== destHash) {
+                result.modified.push(m.path);
+            }
+        }
+    }
+    // Find extra files: in filtered package source but never extracted (not in marker)
+    for (const relPath of pkgFiles) {
+        if (!managedByPath.has(relPath)) {
+            result.extra.push(relPath);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=check.js.map

package/dist/fileset/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/fileset/check.ts"],"names":[],"mappings":";;;;;AA4BA,oCAyDC;AArFD,yCAAyC;AACzC,0DAA6B;AAC7B,sDAAyB;AASzB,oCAAgD;AAChD,0EAAmF;AAEnF,mDAAwD;AAExD;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,YAAY,CAChC,OAAsB,EACtB,SAAiB,EACjB,QAAwB,EACxB,YAA0B,EAC1B,MAA6B;IAE7B,MAAM,mBAAmB,GAA+B,YAAY,CAAC,mBAAmB,IAAI,EAAE,CAAC;IAE/F,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,wBAAwB;QACxB,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAClC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAA8B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3F,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,MAAM,IAAA,qCAAqB,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAErC,MAAM,MAAM,GAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAErE,0BAA0B;IAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,iDAAiD;QACjD,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,iBAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,WAAW,GAAG,IAAA,uDAAgC,EAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;YACtF,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,WAAW,CAAC,CAAC;YACxC,4CAA4C;YAC5C,MAAM,QAAQ,GAAG,MAAM,IAAA,gBAAQ,EAAC,QAAQ,CAAC,CAAC;YAE1C,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACzB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/fileset/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Name of the npmdata marker file that tracks managed files.
+ */
+export declare const MARKER_FILE = ".npmdata";
+/**
+ * Default filename patterns applied when no `files` glob patterns are specified in SelectorConfig.
+ * Excludes common package metadata files that are not meant to be extracted by consumers.
+ */
+export declare const DEFAULT_FILENAME_PATTERNS: string[];
+export declare const GITIGNORE_FILE = ".gitignore";
+export declare const GITIGNORE_START = "# npmdata:start";
+export declare const GITIGNORE_END = "# npmdata:end";
+//# sourceMappingURL=constants.d.ts.map

package/dist/fileset/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/fileset/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,yBAAyB,UAMrC,CAAC;AAEF,eAAO,MAAM,cAAc,eAAe,CAAC;AAC3C,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,eAAO,MAAM,aAAa,kBAAkB,CAAC"}

package/dist/fileset/constants.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GITIGNORE_END = exports.GITIGNORE_START = exports.GITIGNORE_FILE = exports.DEFAULT_FILENAME_PATTERNS = exports.MARKER_FILE = void 0;
+/**
+ * Name of the npmdata marker file that tracks managed files.
+ */
+exports.MARKER_FILE = '.npmdata';
+/**
+ * Default filename patterns applied when no `files` glob patterns are specified in SelectorConfig.
+ * Excludes common package metadata files that are not meant to be extracted by consumers.
+ */
+exports.DEFAULT_FILENAME_PATTERNS = [
+    '**',
+    '!package.json',
+    '!bin/**',
+    '!README.md',
+    '!node_modules/**',
+];
+exports.GITIGNORE_FILE = '.gitignore';
+exports.GITIGNORE_START = '# npmdata:start';
+exports.GITIGNORE_END = '# npmdata:end';
+//# sourceMappingURL=constants.js.map

package/dist/fileset/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/fileset/constants.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,WAAW,GAAG,UAAU,CAAC;AAEtC;;;GAGG;AACU,QAAA,yBAAyB,GAAG;IACvC,IAAI;IACJ,eAAe;IACf,SAAS;IACT,YAAY;IACZ,kBAAkB;CACnB,CAAC;AAEW,QAAA,cAAc,GAAG,YAAY,CAAC;AAC9B,QAAA,eAAe,GAAG,iBAAiB,CAAC;AACpC,QAAA,aAAa,GAAG,eAAe,CAAC"}

package/dist/fileset/diff.d.ts

@@ -0,0 +1,16 @@
+import { SelectorConfig, OutputConfig, ExtractionMap, ManagedFileMetadata, ContentReplacementConfig } from '../types';
+/**
+ * Pure read-only diff between package source files and an output directory.
+ * Classifies each file as toAdd, toModify, toDelete, toSkip, or conflicts.
+ * Makes NO disk writes.
+ *
+ * @param pkgPath       Absolute path to the installed package directory.
+ * @param outputDir     Absolute path to the output directory.
+ * @param selector      SelectorConfig controlling which package files are included.
+ * @param outputConfig  OutputConfig controlling extraction behaviour.
+ * @param existingMarker Current managed file entries from the .npmdata marker.
+ * @param contentReplacements Content replacement configs to apply before hash comparison.
+ * @returns ExtractionMap classifying all file operations.
+ */
+export declare function diff(pkgPath: string, outputDir: string, selector: SelectorConfig, outputConfig: OutputConfig, existingMarker: ManagedFileMetadata[], contentReplacements: ContentReplacementConfig[]): Promise<ExtractionMap>;
+//# sourceMappingURL=diff.d.ts.map