npmdata 0.10.3 → 0.12.0

package/README.md

@@ -27,20 +27,22 @@ Create a dedicated npm package whose `package.json` declares an `npmdata` config
 
 ```json
 {
-  "name": "my-org-data",
+  "name": "my-org-configs",
   "version": "1.0.0",
-  "npmdata": [
-    {
-      "package": "base-datasets@^3.0.0",
-      "outputDir": "./data/base",
-      "files": ["datasets/**"]
-    },
-    {
-      "package": "org-configs@^1.2.0",
-      "outputDir": "./configs",
-      "contentRegexes": ["env: production"]
-    }
-  ]
+  "npmdata": {
+    "sets": [
+      {
+        "package": "base-datasets@^3.0.0",
+        "selector": { "files": ["datasets/**"] },
+        "output": { "path": "./data/base" }
+      },
+      {
+        "package": "org-configs@^1.2.0",
+        "selector": { "contentRegexes": ["env: production"] },
+        "output": { "path": "./configs" }
+      }
+    ]
+  }
 }
 ```
 
@@ -49,13 +51,71 @@ Run `pnpm dlx npmdata init` in that package and then `npm publish` to release it
 **Consumer** — just install and run:
 
 ```sh
-npx my-org-data extract --output ./local-data
+npx my-org-configs extract --output ./local-data
 ```
 
 No knowledge of the upstream packages or transformation rules is required.
 
 **When to use:** When an intermediary team (a platform, infrastructure, or data team) wants to bundle, curate, and version a collection of data from multiple sources and hand it to consumers as a single, opinionated package. Consumers get a stable, self-describing interface; producers control all the complexity.
 
+### Pattern 3 — Config file mode
+
+Add an `npmdata` configuration directly to a project's own `package.json` (or a `.npmdatarc` file) and then run `npmdata extract` without `--packages`. The CLI automatically loads the configuration and runs every entry, reusing the same runner logic as data packages.
+
+**Consumer** — declare the config inline in `package.json`:
+
+```json
+{
+  "name": "my-project",
+  "npmdata": {
+    "sets": [
+      {
+        "package": "base-datasets@^3.0.0",
+        "selector": { "files": ["datasets/**"] },
+        "output": { "path": "./data" }
+      }
+    ]
+  }
+}
+```
+
+Or write a standalone `.npmdatarc` (JSON object at the top level):
+
+```json
+{
+  "sets": [
+    {
+      "package": "base-datasets@^3.0.0",
+      "selector": { "files": ["datasets/**"] },
+      "output": { "path": "./data" }
+    }
+  ]
+}
+```
+
+Then run any command without `--packages`:
+
+```sh
+npx npmdata           # same as 'npx npmdata extract'
+npx npmdata extract   # reads config, extracts all entries
+npx npmdata check     # checks all entries
+npx npmdata purge     # purges all entries
+```
+
+Config is resolved using [cosmiconfig](https://github.com/cosmiconfig/cosmiconfig). Sources searched in order from the current directory:
+
+| Source | Key / format |
+|---|---|
+| `package.json` | `"npmdata"` key — object with `"sets"` array |
+| `.npmdatarc` | JSON or YAML object with `"sets"` array |
+| `.npmdatarc.json` | JSON object with `"sets"` array |
+| `.npmdatarc.yaml` / `.npmdatarc.yml` | YAML object with `"sets"` array |
+| `npmdata.config.js` | CommonJS module exporting object with `sets` array |
+
+All runner flags (`--dry-run`, `--silent`, `--verbose`, `--no-gitignore`, `--unmanaged`, `--presets`, `--output`) work as usual.
+
+**When to use:** When a consuming project wants to pin and automate a set of data extractions locally without publishing a separate data package. This is the lightest-weight approach — no extra package, no `init` step, just a config block and a single CLI call.
+
 ---
 
 ## Quick start
@@ -139,24 +199,26 @@ npx my-shared-assets extract --output ./data
 npx my-shared-assets check  --output ./data
 ```
 
-When the data package defines multiple `npmdata` entries in its `package.json`, you can limit which entries are processed using the `--tags` option. Only entries whose `tags` list includes at least one of the requested tags will be extracted; entries with no tags are skipped when a tag filter is active.
+When the data package defines multiple `npmdata` entries in its `package.json`, you can limit which entries are processed using the `--presets` option. Only entries whose `presets` list includes at least one of the requested presets will be extracted; entries with no presets are skipped when a preset filter is active.
 
 ```sh
 # run only entries tagged with "prod"
-npx my-shared-assets --tags prod
+npx my-shared-assets --presets prod
 
 # run entries tagged with either "prod" or "staging"
-npx my-shared-assets --tags prod,staging
+npx my-shared-assets --presets prod,staging
 ```
 
-To use tags, add a `tags` array to each `npmdata` entry in the data package's `package.json`:
+To use presets, add a `presets` array to each `npmdata` entry in the data package's `package.json`:
 
 ```json
 {
-  "npmdata": [
-    { "package": "my-shared-assets", "outputDir": "./data", "tags": ["prod"] },
-    { "package": "my-dev-assets",    "outputDir": "./dev-data", "tags": ["dev", "staging"] }
-  ]
+  "npmdata": {
+    "sets": [
+      { "package": "my-shared-assets", "output": { "path": "./data" }, "presets": ["prod"] },
+      { "package": "my-dev-assets",    "output": { "path": "./dev-data" }, "presets": ["dev", "staging"] }
+    ]
+  }
 }
 ```
 
@@ -168,8 +230,8 @@ When calling the bin script bundled in a data package, the following options are
 
 | Option | Description |
 |---|---|
-| `--output, -o <dir>` | Base directory for resolving all `outputDir` paths (default: cwd). |
-| `--tags <tag1,tag2>` | Limit to entries whose `tags` overlap with the given list (comma-separated). |
+| `--output, -o <dir>` | Base directory for resolving all `output.path` values (default: cwd). |
+| `--presets <preset1,preset2>` | Limit to entries whose `presets` overlap with the given list (comma-separated). |
 | `--no-gitignore` | Disable `.gitignore` management for every entry, overriding each entry's `gitignore` field. |
 | `--unmanaged` | Run every entry in unmanaged mode, overriding each entry's `unmanaged` field. Files are written without a `.npmdata` marker, without `.gitignore` updates, and without being made read-only. |
 | `--dry-run` | Simulate changes without writing or deleting any files. |
@@ -188,32 +250,32 @@ npx my-shared-assets --no-gitignore --unmanaged --dry-run
 
 ### npmdata entry options reference
 
-Each entry in the `npmdata` array in `package.json` supports the following options:
+Each entry in the `npmdata.sets` array in `package.json` supports the following options:
 
 | Option | Type | Default | Description |
 |---|---|---|---|
 | `package` | `string` | required | Package spec to install and extract. Either a bare name (`my-pkg`) or with a semver constraint (`my-pkg@^1.2.3`). |
-| `outputDir` | `string` | required | Directory where files will be extracted, relative to where the consumer runs the command. |
-| `files` | `string[]` | all files | Glob patterns to filter which files are extracted (e.g. `["data/**", "*.json"]`). |
-| `contentRegexes` | `string[]` | none | Regex patterns (as strings) to filter files by content. Only files matching at least one pattern are extracted. |
-| `force` | `boolean` | `false` | Allow overwriting existing unmanaged files or files owned by a different package. |
-| `keepExisting` | `boolean` | `false` | Skip files that already exist but create them when absent. Cannot be combined with `force`. |
-| `gitignore` | `boolean` | `true` | Create/update a `.gitignore` file alongside each `.npmdata` marker file. Set to `false` to disable. |
-| `unmanaged` | `boolean` | `false` | Write files without a `.npmdata` marker, `.gitignore` update, or read-only flag. Existing files are skipped. |
-| `dryRun` | `boolean` | `false` | Simulate extraction without writing anything to disk. |
+| `output.path` | `string` | required | Directory where files will be extracted, relative to where the consumer runs the command. |
+| `selector.files` | `string[]` | all files | Glob patterns to filter which files are extracted (e.g. `["data/**", "*.json"]`). |
+| `selector.contentRegexes` | `string[]` | none | Regex patterns (as strings) to filter files by content. Only files matching at least one pattern are extracted. |
+| `output.force` | `boolean` | `false` | Allow overwriting existing unmanaged files or files owned by a different package. |
+| `output.keepExisting` | `boolean` | `false` | Skip files that already exist but create them when absent. Cannot be combined with `force`. |
+| `output.gitignore` | `boolean` | `true` | Create/update a `.gitignore` file alongside each `.npmdata` marker file. Set to `false` to disable. |
+| `output.unmanaged` | `boolean` | `false` | Write files without a `.npmdata` marker, `.gitignore` update, or read-only flag. Existing files are skipped. |
+| `output.dryRun` | `boolean` | `false` | Simulate extraction without writing anything to disk. |
 | `upgrade` | `boolean` | `false` | Force a fresh install of the package even when a satisfying version is already installed. |
 | `silent` | `boolean` | `false` | Suppress per-file output, printing only the final result line. |
-| `tags` | `string[]` | none | Tags used to group and selectively run entries with `--tags`. |
-| `symlinks` | `SymlinkConfig[]` | none | Post-extract symlink operations (see below). |
-| `contentReplacements` | `ContentReplacementConfig[]` | none | Post-extract content-replacement operations (see below). |
+| `presets` | `string[]` | none | Presets used to group and selectively run entries with `--presets`. |
+| `output.symlinks` | `SymlinkConfig[]` | none | Post-extract symlink operations (see below). |
+| `output.contentReplacements` | `ContentReplacementConfig[]` | none | Post-extract content-replacement operations (see below). |
 
 #### SymlinkConfig
 
-After extraction, for each config the runner resolves all files/directories inside `outputDir` that match `source` and creates a corresponding symlink inside `target`. Stale symlinks pointing into `outputDir` but no longer matched are removed automatically.
+After extraction, for each config the runner resolves all files/directories inside `output.path` that match `source` and creates a corresponding symlink inside `target`. Stale symlinks pointing into `output.path` but no longer matched are removed automatically.
 
 | Field | Type | Description |
 |---|---|---|
-| `source` | `string` | Glob pattern relative to `outputDir`. Every matching file or directory gets a symlink in `target`. Example: `"**\/skills\/**"` |
+| `source` | `string` | Glob pattern relative to `output.path`. Every matching file or directory gets a symlink in `target`. Example: `"**\/skills\/**"` |
 | `target` | `string` | Directory where symlinks are created, relative to the project root. Example: `".github/skills"` |
 
 #### ContentReplacementConfig
@@ -233,17 +295,21 @@ Example with multiple options:
   "npmdata": [
     {
       "package": "my-shared-assets@^2.0.0",
-      "outputDir": "./data",
-      "files": ["docs/**", "configs/*.json"],
-      "gitignore": true,
+      "selector": {
+        "files": ["docs/**", "configs/*.json"]
+      },
+      "output": {
+        "path": "./data",
+        "gitignore": true,
+        "symlinks": [
+          { "source": "**\/skills\/**", "target": ".github/skills" }
+        ],
+        "contentReplacements": [
+          { "files": "docs/**\/*.md", "match": "<!-- version: .* -->", "replace": "<!-- version: 2.0.0 -->" }
+        ]
+      },
       "upgrade": true,
-      "tags": ["prod"],
-      "symlinks": [
-        { "source": "**\/skills\/**", "target": ".github/skills" }
-      ],
-      "contentReplacements": [
-        { "files": "docs/**\/*.md", "match": "<!-- version: .* -->", "replace": "<!-- version: 2.0.0 -->" }
-      ]
+      "presets": ["prod"]
     }
   ]
 }
@@ -262,10 +328,10 @@ npx npmdata check --packages "my-shared-assets,another-pkg" --output ./data
 The check command reports differences per package:
 
 ```
-my-shared-assets@^2.0.0  FAIL
-  missing:   data/new-file.json
-  modified:  data/configs/app.config.json
-  extra:     data/old-file.json
+  my-shared-assets@2.1.0: out of sync
+    - missing:  data/new-file.json
+    ~ modified: data/configs/app.config.json
+    + extra:    data/old-file.json
 ```
 
 ### 4. List managed files
@@ -318,7 +384,7 @@ Commands:
 
 Global options:
   --help, -h       Show help
-  --version, -v    Show version
+  --version        Show version
 
 Init options:
   --files <patterns>       Comma-separated glob patterns of files to publish (required)
@@ -335,11 +401,16 @@ Init options:
                            and without being made read-only. Existing files are skipped.
 
 Extract options:
-  --packages <specs>       Comma-separated package specs (required).
+  --packages <specs>       Comma-separated package specs.
+                           When omitted, npmdata searches for a configuration file
+                           (package.json "npmdata" key, .npmdatarc, etc.) and runs all
+                           entries defined there.
                            Each spec is "name" or "name@version", e.g.
                            "my-pkg@^1.0.0,other-pkg@2.x"
   --output, -o <dir>       Output directory (default: current directory)
   --force                  Overwrite existing unmanaged files or files owned by a different package
+  --keep-existing          Skip files that already exist; create them when absent. Cannot be
+                           combined with --force
   --no-gitignore           Skip creating/updating .gitignore (gitignore is enabled by default)
   --unmanaged              Write files without a .npmdata marker, .gitignore update, or read-only
                            flag. Existing files are skipped. Files can be freely edited afterwards
@@ -348,13 +419,17 @@ Extract options:
   --content-regex <regex>  Regex to filter files by content
   --dry-run                Preview changes without writing any files
   --upgrade                Reinstall the package even if already present
+  --silent                 Print only the final result line, suppressing per-file output
+  --verbose, -v            Print detailed progress information for each step
 
 Check options:
-  --packages <specs>       Same format as extract (required)
+  --packages <specs>       Same format as extract.
+                           When omitted, reads from a configuration file (see Pattern 3).
   --output, -o <dir>       Output directory to check (default: current directory)
 
 Purge options:
-  --packages <specs>       Comma-separated package names whose managed files should be removed
+  --packages <specs>       Comma-separated package names whose managed files should be removed.
+                           When omitted, reads from a configuration file (see Pattern 3).
   --output, -o <dir>       Output directory to purge from (default: current directory)
   --dry-run                Simulate purge without removing any files
   --silent                 Suppress per-file output
@@ -461,8 +536,8 @@ await purge({
 });
 
 // list all files managed by npmdata in an output directory
-const managed = await list('./data');
-// managed is Record<string, string[]> keyed by "package@version"
+const managed = list('./data');
+// managed is Array<{ packageName: string; packageVersion: string; files: string[] }>
 
 // initialize a publisher package
 await initPublisher(['docs', 'data'], { workingDir: './my-package' });

package/dist/cli/actions/check.d.ts

@@ -0,0 +1,6 @@
+import { NpmdataConfig } from '../../types';
+/**
+ * `check` CLI action handler.
+ */
+export declare function runCheck(config: NpmdataConfig | null, argv: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

package/dist/cli/actions/check.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCheck = runCheck;
+const argv_1 = require("../argv");
+const usage_1 = require("../usage");
+const action_check_1 = require("../../package/action-check");
+/**
+ * `check` CLI action handler.
+ */
+async function runCheck(config, argv, cwd) {
+    if (argv.includes('--help')) {
+        (0, usage_1.printUsage)('check');
+        return;
+    }
+    let parsed;
+    try {
+        parsed = (0, argv_1.parseArgv)(argv);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!config || config.sets.length === 0) {
+        console.error('Error: No config found and no --packages specified.');
+        process.exitCode = 1;
+        return;
+    }
+    const overridden = (0, argv_1.applyArgvOverrides)(config.sets, parsed);
+    try {
+        const summary = await (0, action_check_1.actionCheck)({
+            entries: overridden,
+            config,
+            cwd,
+            verbose: parsed.verbose,
+            skipUnmanaged: parsed.unmanaged,
+        });
+        const hasDrift = summary.missing.length > 0 || summary.modified.length > 0 || summary.extra.length > 0;
+        if (hasDrift) {
+            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;
+        }
+        else {
+            console.log('All managed files are in sync.');
+        }
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/actions/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/actions/check.ts"],"names":[],"mappings":";;AASA,4BAmDC;AA1DD,kCAAwD;AACxD,oCAAsC;AACtC,6DAAyD;AAEzD;;GAEG;AACI,KAAK,UAAU,QAAQ,CAC5B,MAA4B,EAC5B,IAAc,EACd,GAAW;IAEX,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAA,kBAAU,EAAC,OAAO,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,yBAAkB,EAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAA,0BAAW,EAAC;YAChC,OAAO,EAAE,UAAU;YACnB,MAAM;YACN,GAAG;YACH,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,SAAS;SAChC,CAAC,CAAC;QAEH,MAAM,QAAQ,GACZ,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAExF,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAC9D,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ;gBAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YAChE,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC1D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/actions/extract.d.ts

@@ -0,0 +1,7 @@
+import { NpmdataConfig } from '../../types';
+/**
+ * `extract` CLI action handler.
+ * Parses argv, merges with config, calls actionExtract, prints summary.
+ */
+export declare function runExtract(config: NpmdataConfig | null, argv: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=extract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/extract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAuEf"}

package/dist/cli/actions/extract.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runExtract = runExtract;
+/* eslint-disable no-console */
+const node_child_process_1 = require("node:child_process");
+const argv_1 = require("../argv");
+const usage_1 = require("../usage");
+const action_extract_1 = require("../../package/action-extract");
+const utils_1 = require("../../utils");
+/**
+ * `extract` CLI action handler.
+ * Parses argv, merges with config, calls actionExtract, prints summary.
+ */
+async function runExtract(config, argv, cwd) {
+    if (argv.includes('--help')) {
+        (0, usage_1.printUsage)('extract');
+        return;
+    }
+    let parsed;
+    try {
+        parsed = (0, argv_1.parseArgv)(argv);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    // Build entries: --packages overrides config sets
+    let entries = (0, argv_1.buildEntriesFromArgv)(parsed);
+    if (!entries) {
+        if (!config || config.sets.length === 0) {
+            console.error('Error: No packages specified. Use --packages or a config file with sets.');
+            process.exitCode = 1;
+            return;
+        }
+        // Config-sourced entries need CLI flag overrides applied
+        entries = (0, argv_1.applyArgvOverrides)(config.sets, parsed);
+    }
+    // Apply preset filter
+    const presets = parsed.presets ?? [];
+    const filtered = (0, utils_1.filterEntriesByPresets)(entries, presets);
+    if (filtered.length === 0) {
+        console.log('No entries matched the specified presets.');
+        return;
+    }
+    try {
+        const result = await (0, action_extract_1.actionExtract)({
+            entries: filtered,
+            config,
+            cwd,
+            verbose: parsed.verbose,
+            onProgress: (event) => {
+                if (filtered[0]?.silent)
+                    return;
+                if (event.type === 'file-added')
+                    console.log(`  + ${event.file}`);
+                else if (event.type === 'file-modified')
+                    console.log(`  ~ ${event.file}`);
+                else if (event.type === 'file-deleted')
+                    console.log(`  - ${event.file}`);
+            },
+        });
+        // Run postExtractScript if configured and not dry-run
+        const isDryRun = filtered.some((e) => e.output.dryRun);
+        if (!isDryRun && config?.postExtractScript) {
+            const scriptCmd = `${config.postExtractScript} ${argv.join(' ')}`.trim();
+            try {
+                (0, node_child_process_1.execSync)(scriptCmd, { cwd, stdio: 'inherit', encoding: 'utf8' });
+            }
+            catch (error) {
+                const e = error;
+                process.exitCode = e.status ?? 1;
+                return;
+            }
+        }
+        console.log(`Extract complete: ${result.added} added, ${result.modified} modified, ` +
+            `${result.deleted} deleted, ${result.skipped} skipped.`);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/cli/actions/extract.js.map

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

package/dist/cli/actions/init.d.ts

@@ -0,0 +1,6 @@
+import { NpmdataConfig } from '../../types';
+/**
+ * `init` CLI action handler.
+ */
+export declare function runInit(config: NpmdataConfig | null, argv: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/init.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C;;GAEG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/cli/actions/init.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+/* eslint-disable no-console */
+const node_path_1 = __importDefault(require("node:path"));
+const argv_1 = require("../argv");
+const usage_1 = require("../usage");
+const action_init_1 = require("../../package/action-init");
+/**
+ * `init` CLI action handler.
+ */
+async function runInit(config, argv, cwd) {
+    if (argv.includes('--help')) {
+        (0, usage_1.printUsage)('init');
+        return;
+    }
+    const parsed = (0, argv_1.parseArgv)(argv);
+    const outputDir = parsed.output ? node_path_1.default.resolve(cwd, parsed.output) : cwd;
+    const { verbose, files, packages } = parsed;
+    const initConfig = {
+        files,
+        packages: packages?.map((p) => (p.version ? `${p.name}@${p.version}` : p.name)),
+    };
+    try {
+        await (0, action_init_1.actionInit)(outputDir, verbose, initConfig);
+        console.log('Init complete. Scaffolded package.json and bin/npmdata.js.');
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/actions/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/actions/init.ts"],"names":[],"mappings":";;;;;AAWA,0BA0BC;AArCD,+BAA+B;AAC/B,0DAA6B;AAG7B,kCAAoC;AACpC,oCAAsC;AACtC,2DAAuD;AAEvD;;GAEG;AACI,KAAK,UAAU,OAAO,CAC3B,MAA4B,EAC5B,IAAc,EACd,GAAW;IAEX,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAA,kBAAU,EAAC,MAAM,CAAC,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACzE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAE5C,MAAM,UAAU,GAAG;QACjB,KAAK;QACL,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;KAChF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,IAAA,wBAAU,EAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/actions/list.d.ts

@@ -0,0 +1,7 @@
+import { NpmdataConfig } from '../../types';
+/**
+ * `list` CLI action handler.
+ * Note: list always ignores --presets.
+ */
+export declare function runList(config: NpmdataConfig | null, argv: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/cli/actions/list.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runList = runList;
+const argv_1 = require("../argv");
+const usage_1 = require("../usage");
+const action_list_1 = require("../../package/action-list");
+/**
+ * `list` CLI action handler.
+ * Note: list always ignores --presets.
+ */
+async function runList(config, argv, cwd) {
+    if (argv.includes('--help')) {
+        (0, usage_1.printUsage)('list');
+        return;
+    }
+    const parsed = (0, argv_1.parseArgv)(argv);
+    const entries = config?.sets ?? [];
+    try {
+        const files = await (0, action_list_1.actionList)({
+            entries,
+            config,
+            cwd,
+            output: parsed.output,
+            verbose: parsed.verbose,
+        });
+        if (files.length === 0) {
+            if (parsed.verbose)
+                console.log('No managed files found.');
+        }
+        else {
+            for (const f of files) {
+                console.log(`${f.path}  ${f.packageName}@${f.packageVersion}`);
+            }
+        }
+        // list always exits 0
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/actions/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/cli/actions/list.ts"],"names":[],"mappings":";;AAUA,0BAmCC;AA3CD,kCAAoC;AACpC,oCAAsC;AACtC,2DAAuD;AAEvD;;;GAGG;AACI,KAAK,UAAU,OAAO,CAC3B,MAA4B,EAC5B,IAAc,EACd,GAAW;IAEX,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAA,kBAAU,EAAC,MAAM,CAAC,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC;IAE/B,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAA,wBAAU,EAAC;YAC7B,OAAO;YACP,MAAM;YACN,GAAG;YACH,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QACD,sBAAsB;IACxB,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/actions/purge.d.ts

@@ -0,0 +1,6 @@
+import { NpmdataConfig } from '../../types';
+/**
+ * `purge` CLI action handler.
+ */
+export declare function runPurge(config: NpmdataConfig | null, argv: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=purge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"purge.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/purge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAoCf"}