npmdata 0.10.3 → 0.12.0

package/dist/types.d.ts

@@ -1,68 +1,187 @@
 /**
- * Default filename patterns applied when no filenamePatterns are specified.
- * Excludes common package metadata files that are not meant to be extracted by consumers.
+ * Internal parsed representation of an npm package specifier.
  */
-export declare const DEFAULT_FILENAME_PATTERNS: string[];
+export type PackageConfig = {
+    /** npm package name (e.g. "my-pkg" or "@scope/my-pkg") */
+    name: string;
+    /** Semver range constraint. Absent means "latest". */
+    version?: string;
+};
 /**
- * Configuration for a post-extract symlink operation.
- * After files are extracted, matching files/dirs in the output directory are made
- * available as symlinks inside the target directory.
+ * Controls which files are selected from a package and install behaviour.
  */
-export type SymlinkConfig = {
+export type SelectorConfig = {
     /**
-     * Glob pattern relative to the extraction outputDir. Every file or directory
-     * whose relative path matches this pattern will be represented by a symlink in
-     * the target directory.
-     * Example: "**\/skills\/**" will find every entry under any "skills" directory.
+     * Glob patterns; files must match at least one.
+     * Default: DEFAULT_FILENAME_PATTERNS (excludes package.json, bin/**, README.md, node_modules/**)
      */
-    source: string;
+    files?: string[];
     /**
-     * Directory where the symlinks will be created, relative to the working
-     * directory in which the runner is invoked (i.e. the consumer's project root).
-     * Example: ".github/skills"
+     * Regex strings; files must match at least one. Binary files always skip regex check.
      */
-    target: string;
+    contentRegexes?: string[];
+    /**
+     * Tags this entry for --presets CLI filtering. Not forwarded to dependency packages.
+     */
+    presets?: string[];
+    /**
+     * Force fresh package install even if a satisfying version is installed.
+     */
+    upgrade?: boolean;
 };
 /**
- * Configuration for a post-extract content-replacement operation.
- * After files are extracted, the specified files in the workspace are searched
- * for regex matches and the matched portions are replaced with the target string.
+ * Controls where and how extracted files are written.
  */
-export type ContentReplacementConfig = {
+export type OutputConfig = {
     /**
-     * Glob pattern (relative to the working directory) selecting workspace files
-     * whose content should be modified.
-     * Example: "docs/**\/*.md"
+     * Output directory relative to cwd. Concatenated across recursion levels.
      */
-    files: string;
+    path: string;
     /**
-     * Regular-expression string used to locate the text to replace inside each
-     * matched file.  All non-overlapping occurrences are replaced (global flag is
-     * applied automatically).
-     * Example: "<!-- version: .* -->"
+     * Overwrite existing unmanaged files. Overridden by --force and --keep-existing.
      */
-    match: string;
+    force?: boolean;
+    /**
+     * Skip files that already exist; create missing ones. Cannot combine with force.
+     */
+    keepExisting?: boolean;
+    /**
+     * Create/update .gitignore alongside each .npmdata marker.
+     */
+    gitignore?: boolean;
     /**
-     * Replacement string (may contain regex back-references such as "$1").
-     * Example: "<!-- version: 1.2.3 -->"
+     * Write without .npmdata marker, no gitignore update, no read-only. Existing files skipped.
+     * Takes precedence over force.
      */
+    unmanaged?: boolean;
+    /**
+     * Report what would change; no disk writes.
+     */
+    dryRun?: boolean;
+    /**
+     * Post-extract symlink operations. Appended across recursion levels.
+     */
+    symlinks?: SymlinkConfig[];
+    /**
+     * Post-extract content replacements. Appended across recursion levels.
+     */
+    contentReplacements?: ContentReplacementConfig[];
+};
+/**
+ * Controls runtime output verbosity.
+ */
+export type ExecutionConfig = {
+    /** Suppress per-file output; print only final summary line. */
+    silent?: boolean;
+    /** Print detailed step information. */
+    verbose?: boolean;
+};
+/**
+ * Defines one post-extract symlink operation.
+ */
+export type SymlinkConfig = {
+    /** Glob relative to outputDir. Matching files/dirs get symlinked into `target`. */
+    source: string;
+    /** Directory where symlinks are created, relative to outputDir. Supports ../ paths. */
+    target: string;
+};
+/**
+ * Defines one post-extract content replacement operation.
+ */
+export type ContentReplacementConfig = {
+    /** Glob relative to cwd selecting workspace files to modify. */
+    files: string;
+    /** Regex string; all non-overlapping occurrences replaced (global flag applied). */
+    match: string;
+    /** Replacement string; may contain back-references ($1, $2). */
     replace: string;
 };
 /**
- * Configuration for filtering which files to include/exclude
+ * One entry in the npmdata.sets array. Represents a single extraction target.
  */
-export type FileFilterConfig = {
+export type NpmdataExtractEntry = {
+    /** Flat package spec string ("my-pkg@^1.2.3"). Parsed to PackageConfig internally. */
+    package: string;
+    /** Where/how to write files. */
+    output: OutputConfig;
+    /** Which files to select and install options. */
+    selector?: SelectorConfig;
     /**
-     * Glob patterns to match filenames (e.g., "*.md", "src/**\/*.ts")
+     * Preset tags for --presets CLI filtering. An entry is included when at least
+     * one of its presets appears in the requested preset list.
+     * Not forwarded to dependency packages.
      */
-    filenamePatterns?: string[];
+    presets?: string[];
+    /** Suppress per-file output. Root-level (not nested). */
+    silent?: boolean;
+    /** Print detailed step information. Root-level (not nested). */
+    verbose?: boolean;
+};
+/**
+ * Top-level structure stored under npmdata key in package.json or in any cosmiconfig source.
+ */
+export type NpmdataConfig = {
+    /** All extraction entries. */
+    sets: NpmdataExtractEntry[];
     /**
-     * Regex patterns to match file contents (files must contain at least one match)
+     * Shell command run after successful extract (not during --dry-run).
+     * Executed in process.cwd(). Full argv appended as arguments.
      */
-    contentRegexes?: RegExp[];
+    postExtractScript?: string;
+};
+/**
+ * A single file operation in the diff/execute pipeline.
+ */
+export type FileOperation = {
+    relPath: string;
+    sourcePath: string;
+    destPath: string;
+    hash: string;
+};
+/**
+ * A file skipped during extraction with the reason.
+ */
+export type SkippedFile = {
+    relPath: string;
+    reason: 'conflict' | 'keep-existing' | 'unmanaged';
+};
+/**
+ * An unmanaged file in outputDir that blocks extraction.
+ */
+export type ConflictFile = {
+    relPath: string;
+    /** Set when file is managed by a different package. */
+    existingOwner?: string;
+};
+/**
+ * Internal read-only structure produced by fileset/diff.ts. Not persisted.
+ */
+export type ExtractionMap = {
+    /** Files present in package source but absent from outputDir. */
+    toAdd: FileOperation[];
+    /** Files whose hash differs between package source and outputDir. */
+    toModify: FileOperation[];
+    /** Relative paths of managed files no longer present in filtered package source. */
+    toDelete: string[];
+    /** Files skipped with reason. */
+    toSkip: SkippedFile[];
+    /** Unmanaged files in outputDir that block extraction. */
+    conflicts: ConflictFile[];
 };
 /**
- * Event emitted by extract() as files are processed.
+ * One row in a .npmdata CSV marker file.
+ * CSV format (preserved from v1): path,packageName,packageVersion — one row per file, no header.
+ */
+export type ManagedFileMetadata = {
+    /** Relative path from marker file directory. */
+    path: string;
+    /** Source npm package name. */
+    packageName: string;
+    /** Installed version at extraction time. */
+    packageVersion: string;
+};
+/**
+ * Event emitted by extract/check/purge for UI progress reporting.
  */
 export type ProgressEvent = {
     type: 'package-start';
@@ -90,245 +209,40 @@ export type ProgressEvent = {
     file: string;
 };
 /**
- * Configuration for the consumer
+ * Result of a check operation for a single fileset.
  */
-export type ConsumerConfig = FileFilterConfig & {
-    /**
-     * Package specs to install from registry. Each entry is either a bare package name
-     * ("my-pkg") or a name with a semver constraint ("my-pkg@^1.2.3"). Multiple packages
-     * can be provided and they will all be extracted into outputDir.
-     */
-    packages: string[];
-    /**
-     * Output directory where files will be extracted
-     */
-    outputDir: string;
-    /**
-     * Package manager type (auto-detect if not specified)
-     */
-    packageManager?: 'pnpm' | 'yarn' | 'npm';
-    /**
-     * Allow creating conflicting files (default: false, will error)
-     */
-    force?: boolean;
-    /**
-     * When true, skip files that already exist in the output directory but create
-     * them when they are absent.  Cannot be combined with force.
-     */
-    keepExisting?: boolean;
-    /**
-     * Working directory from which to run package manager install commands (e.g. pnpm add).
-     * Defaults to process.cwd() if not specified.
-     */
-    cwd?: string;
-    /**
-     * Automatically create/update a .gitignore file alongside each .npmdata marker file,
-     * adding the managed files and the .npmdata file itself to be ignored by git.
-     * Defaults to true. Set to false to disable.
-     */
-    gitignore?: boolean;
-    /**
-     * When true, write files to disk without creating a .npmdata marker, without
-     * updating .gitignore, and without making files read-only. Files written with
-     * this flag are not tracked by npmdata and can be freely edited by the user.
-     * When a destination file already exists it is left untouched and reported as
-     * skipped. Takes precedence over force.
-     */
-    unmanaged?: boolean;
-    /**
-     * When true, simulate extraction without writing anything to disk.
-     * The returned ConsumerResult reflects what would have changed.
-     */
-    dryRun?: boolean;
-    /**
-     * When true, force a fresh install of each package even if a satisfying version
-     * is already installed. Useful to pick up the latest patch or minor release.
-     */
-    upgrade?: boolean;
-    /**
-     * Optional callback called for each file event during extraction.
-     * Useful for progress reporting in scripts and build tools.
-     */
-    onProgress?: (event: ProgressEvent) => void;
-    /**
-     * Content-replacement operations that were applied to files after extraction.
-     * When provided, check() will apply the same transformations to the package
-     * source content before comparing hashes, so files modified by replacements
-     * are not incorrectly reported as out of sync.
-     */
-    contentReplacements?: ContentReplacementConfig[];
-};
-/**
- * Metadata about managed files
- */
-export type ManagedFileMetadata = {
-    /**
-     * Path to the managed file (relative to marker file directory)
-     */
-    path: string;
-    /**
-     * Package name that created this file
-     */
-    packageName: string;
-    /**
-     * Package version that created this file
-     */
-    packageVersion: string;
-    /**
-     * Whether the file was written replacing an existing unmanaged file (via force flag)
-     */
-    force?: boolean;
-};
-/**
- * Result of a consumer operation
- */
-export type ConsumerResult = {
-    added: string[];
+export type CheckResult = {
+    /** Files in .npmdata marker but absent from output dir. */
+    missing: string[];
+    /** Files whose content hash differs from package source. */
     modified: string[];
-    deleted: string[];
-    skipped: string[];
-    sourcePackages: Array<{
-        name: string;
-        version: string;
-        changes: {
-            added: string[];
-            modified: string[];
-            deleted: string[];
-            skipped: string[];
-        };
-    }>;
+    /** Files in filtered package source but never extracted. */
+    extra: string[];
 };
 /**
- * Result of a check operation
+ * Result of purging one fileset.
  */
-export type CheckResult = {
-    /**
-     * Whether all files are in sync
-     */
-    ok: boolean;
-    /**
-     * Aggregated files that differ from source (across all packages)
-     */
-    differences: {
-        /**
-         * Files that are in the .npmdata marker but missing from the output directory
-         */
-        missing: string[];
-        /**
-         * Files whose contents differ from the package source
-         */
-        modified: string[];
-        /**
-         * Files that exist in the package but have not been extracted yet
-         */
-        extra: string[];
-    };
-    /**
-     * Per-package breakdown of differences
-     */
-    sourcePackages: Array<{
-        name: string;
-        version: string;
-        ok: boolean;
-        differences: {
-            missing: string[];
-            modified: string[];
-            extra: string[];
-        };
-    }>;
+export type PurgeResult = {
+    /** Number of files deleted. */
+    deleted: number;
+    /** Number of symlinks removed. */
+    symlinksRemoved: number;
+    /** Number of empty dirs removed. */
+    dirsRemoved: number;
 };
 /**
- * A single extraction entry defined in the publishable package.json "npmdata" array.
- * The runner iterates over these entries and calls extract() for each one.
+ * Result of executing an ExtractionMap.
  */
-export type NpmdataExtractEntry = {
-    /**
-     * Package spec to install and extract from. Either a bare name ("my-pkg") or a
-     * name with a semver constraint ("my-pkg@^1.2.3").
-     */
-    package: string;
-    /**
-     * Output directory where files will be extracted, relative to where the consumer
-     * runs the command (e.g. "./data" or "src/generated").
-     */
-    outputDir: string;
-    /**
-     * Glob patterns to filter which files are extracted (e.g. ["data/**", "*.json"]).
-     * Defaults to all files when not set.
-     */
-    files?: string[];
-    /**
-     * Allow overwriting existing unmanaged files (default: false).
-     */
-    force?: boolean;
-    /**
-     * When true, skip files that already exist in the output directory but create
-     * them when they are absent.  Cannot be combined with force (default: false).
-     */
-    keepExisting?: boolean;
-    /**
-     * Create/update a .gitignore file alongside each .npmdata marker file (default: true).
-     */
-    gitignore?: boolean;
-    /**
-     * Write files without creating a .npmdata marker, updating .gitignore, or making
-     * files read-only. Existing files are skipped rather than overwritten (default: false).
-     */
-    unmanaged?: boolean;
-    /**
-     * Simulate extraction without writing anything to disk (default: false).
-     */
-    dryRun?: boolean;
-    /**
-     * Force a fresh install of the package even when a satisfying version is already
-     * installed (default: false).
-     */
-    upgrade?: boolean;
-    /**
-     * Suppress per-file output, printing only the final result line (default: false).
-     */
-    silent?: boolean;
-    /**
-     * Print detailed progress information for each file and step processed (default: false).
-     */
-    verbose?: boolean;
-    /**
-     * Regex patterns (as strings) to filter files by content. Only files whose content
-     * matches at least one pattern are extracted.
-     */
-    contentRegexes?: string[];
-    /**
-     * Tags used to group and selectively run entries. When the data package is invoked with
-     * --tags, only entries whose tags list includes at least one of the requested tags are
-     * processed. Entries with no tags are always skipped when a tag filter is active.
-     */
-    tags?: string[];
-    /**
-     * Post-extract symlink operations. After extraction, for each config the runner
-     * resolves all files/directories inside outputDir that match the source glob and
-     * creates a corresponding symlink inside the target directory. Stale symlinks
-     * (pointing into outputDir but no longer matched) are removed automatically.
-     */
-    symlinks?: SymlinkConfig[];
-    /**
-     * Post-extract content-replacement operations. After extraction, for each config
-     * the runner finds workspace files matching the files glob and applies the regex
-     * replacement to their contents.
-     */
-    contentReplacements?: ContentReplacementConfig[];
-};
-/**
- * Package.json for a publishable project
- */
-export type PublishablePackageJson = {
-    name: string;
-    version: string;
-    description?: string;
-    main?: string;
-    bin?: string;
-    files?: string[];
-    dependencies?: Record<string, string>;
-    npmdata?: NpmdataExtractEntry[];
-    [key: string]: unknown;
+export type ExecuteResult = {
+    /** Paths of newly created files (for rollback purposes). */
+    newlyCreated: string[];
+    /** Number of files added. */
+    added: number;
+    /** Number of files modified. */
+    modified: number;
+    /** Number of files deleted. */
+    deleted: number;
+    /** Number of files skipped. */
+    skipped: number;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,15 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_FILENAME_PATTERNS = void 0;
-/**
- * Default filename patterns applied when no filenamePatterns are specified.
- * 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/**',
-];
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,yBAAyB,GAAG;IACvC,IAAI;IACJ,eAAe;IACf,SAAS;IACT,YAAY;IACZ,kBAAkB;CACnB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -1,78 +1,48 @@
-import { ManagedFileMetadata } from './types';
+import { NpmdataExtractEntry, PackageConfig } from './types';
 /**
  * Parse a package spec like "my-pkg@^1.2.3" or "@scope/pkg@2.x" into name and version.
- * The version separator is the LAST "@" so that scoped packages ("@scope/name") are handled correctly.
+ * The version separator is the LAST "@" so that scoped packages ("@scope/name") are handled.
  */
-export declare function parsePackageSpec(spec: string): {
-    name: string;
-    version: string | undefined;
-};
+export declare function parsePackageSpec(spec: string): PackageConfig;
 /**
- * Return true if at least one path in managedPaths is equal to relDir or starts with
- * "relDir/", i.e. lives somewhere inside that directory.
+ * Compute the SHA-256 hash of a file.
  */
-export declare function hasManagedFilesUnder(relDir: string, managedPaths: Set<string>): boolean;
-/**
- * Detect whether a file is binary by scanning it for null bytes.
- * Reads up to the first 8 KB only to keep memory usage low.
- */
-export declare function isBinaryFile(filePath: string): boolean;
-/**
- * Get hash of file contents
- */
-export declare function calculateFileHash(filePath: string): string;
+export declare function hashFile(filePath: string): Promise<string>;
 /**
  * Compute the SHA-256 hash of an in-memory buffer or string.
- * Used to hash content that has been transformed in memory before writing to disk.
- */
-export declare function calculateBufferHash(content: Buffer | string): string;
-/**
- * Check if file contents match regex patterns.
- * Binary files (detected via null-byte scan) are always excluded when patterns are set.
- */
-export declare function matchesContentRegex(filePath: string, patterns?: RegExp[]): boolean;
-/**
- * Recursively find all files in directory matching filters
+ * Used to hash content that has been transformed in memory before comparison.
  */
-export declare function findMatchingFiles(dir: string, filenamePatterns?: string[], contentRegexes?: RegExp[]): string[];
-export declare const matchesFilenamePattern: (filename: string, patterns?: string[]) => boolean;
+export declare function hashBuffer(content: Buffer | string): string;
 /**
- * Create directory recursively
+ * Synchronous file hash (SHA-256).
  */
-export declare function ensureDir(dir: string): void;
+export declare function hashFileSync(filePath: string): string;
 /**
- * Remove file with error handling
- */
-export declare function removeFile(filePath: string): void;
-/**
- * Copy file preserving directory structure
- */
-export declare function copyFile(src: string, dest: string): void;
-/**
- * Detect package manager type.
- * Inspects the lock files in the given directory (defaults to process.cwd()).
+ * Detect whether a file is binary by scanning it for null bytes.
+ * Reads up to the first 8 KB only.
  */
-export declare function detectPackageManager(cwd?: string): 'npm' | 'yarn' | 'pnpm';
+export declare function isBinaryFile(filePath: string): boolean;
 /**
- * Get package info from installed package
+ * Detect package manager by inspecting lock files in the given directory.
+ * Falls back to npm if no lock file is found.
  */
-export declare function getInstalledPackageVersion(packageName: string, cwd?: string): string | null;
+export declare function detectPackageManager(cwd?: string): 'pnpm' | 'npm';
 /**
- * Read JSON file safely
+ * Install a package using the detected package manager.
+ * Returns the installed package path under node_modules.
  */
-export declare function readJsonFile<T>(filePath: string): T;
+export declare function installPackage(name: string, version: string | undefined, upgrade: boolean, cwd?: string): string;
 /**
- * Write JSON file
+ * Return the installed package path under cwd/node_modules, or null if not installed.
  */
-export declare function writeJsonFile(filePath: string, data: unknown): void;
+export declare function getInstalledPackagePath(name: string, cwd?: string): string | null;
 /**
- * Read the .npmdata marker file.
- * Supports both the current pipe-delimited format and the legacy comma-delimited format
- * (detected automatically for backward compatibility).
+ * Ensure a directory exists, creating it recursively if needed.
  */
-export declare function readCsvMarker(filePath: string): ManagedFileMetadata[];
+export declare function ensureDir(dir: string): void;
 /**
- * Write the .npmdata marker file using the pipe-delimited format.
+ * Filter entries by requested presets.
+ * When no presets are requested, all entries pass through.
  */
-export declare function writeCsvMarker(filePath: string, data: ManagedFileMetadata[]): void;
+export declare function filterEntriesByPresets(entries: NpmdataExtractEntry[], presets: string[]): NpmdataExtractEntry[];
 //# sourceMappingURL=utils.d.ts.map