@microwiseai/snapshot 0.3.46 → 0.3.57

package/node_modules/@microwiseai/snapshot-parallel/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @microwiseai/snapshot-parallel
+ *
+ * Parallel package installer with concurrency control.
+ * Drop-in replacement for serial install loops in @microwiseai/snapshot core.
+ */
+export { parallelInstall, recordToEntries, partitionEntries, } from './parallel-installer.js';
+export type { PackageEntry, PackageInstallResult, ParallelInstallResult, ProgressEvent, InstallFn, ParallelInstallOptions, } from './parallel-installer.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@microwiseai/snapshot-parallel/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,SAAS,EACT,sBAAsB,GACvB,MAAM,yBAAyB,CAAC"}

package/node_modules/@microwiseai/snapshot-parallel/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @microwiseai/snapshot-parallel
+ *
+ * Parallel package installer with concurrency control.
+ * Drop-in replacement for serial install loops in @microwiseai/snapshot core.
+ */
+export { parallelInstall, recordToEntries, partitionEntries, } from './parallel-installer.js';
+//# sourceMappingURL=index.js.map

package/node_modules/@microwiseai/snapshot-parallel/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,yBAAyB,CAAC"}

package/node_modules/@microwiseai/snapshot-parallel/dist/parallel-installer.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Parallel Package Installer
+ *
+ * Concurrency-limited parallel execution for package installation.
+ * Replaces serial for-loops in core/install.ts with Promise-pool pattern.
+ */
+/** A single package to install: name + version */
+export interface PackageEntry {
+    name: string;
+    version: string;
+}
+/** Result of installing a single package */
+export interface PackageInstallResult {
+    name: string;
+    version: string;
+    /** "name@version" convenience string */
+    spec: string;
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Duration in ms */
+    durationMs: number;
+}
+/** Aggregated results from a parallel install batch */
+export interface ParallelInstallResult {
+    installed: string[];
+    failed: string[];
+    results: PackageInstallResult[];
+    totalDurationMs: number;
+}
+/** Progress event emitted for each package completion */
+export interface ProgressEvent {
+    /** 1-based index of completed package */
+    current: number;
+    /** Total number of packages */
+    total: number;
+    /** The result for the just-completed package */
+    result: PackageInstallResult;
+}
+/** Function that actually installs a single package. Provided by the caller. */
+export type InstallFn = (entry: PackageEntry) => Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/** Options for parallel installation */
+export interface ParallelInstallOptions {
+    /** Max concurrent installs (default: 4) */
+    concurrency?: number;
+    /** Called after each package completes */
+    onProgress?: (event: ProgressEvent) => void;
+    /** AbortSignal to cancel remaining installs */
+    signal?: AbortSignal;
+}
+/**
+ * Install packages in parallel with concurrency control.
+ *
+ * @param entries - List of packages to install
+ * @param installFn - Function that installs a single package (caller provides the actual logic)
+ * @param options - Concurrency, progress callback, abort signal
+ *
+ * @example
+ * ```ts
+ * import { parallelInstall } from '@microwiseai/snapshot-parallel';
+ *
+ * const result = await parallelInstall(
+ *   [{ name: '@ist/smon', version: '0.2.15' }],
+ *   async (entry) => {
+ *     // your install logic here
+ *     return { success: true };
+ *   },
+ *   { concurrency: 4, onProgress: (e) => console.log(`${e.current}/${e.total}`) }
+ * );
+ * ```
+ */
+export declare function parallelInstall(entries: PackageEntry[], installFn: InstallFn, options?: ParallelInstallOptions): Promise<ParallelInstallResult>;
+/**
+ * Convert a { name: version } record to PackageEntry[].
+ * Preserves insertion order.
+ */
+export declare function recordToEntries(packages: Record<string, string>): PackageEntry[];
+/**
+ * Partition entries by a classifier function.
+ * Useful for splitting skit vs npm vs generic before parallel install.
+ */
+export declare function partitionEntries<K extends string>(entries: PackageEntry[], classifier: (entry: PackageEntry) => K): Record<K, PackageEntry[]>;
+//# sourceMappingURL=parallel-installer.d.ts.map

package/node_modules/@microwiseai/snapshot-parallel/dist/parallel-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-installer.d.ts","sourceRoot":"","sources":["../src/parallel-installer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,gFAAgF;AAChF,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/F,wCAAwC;AACxC,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA2CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,YAAY,EAAE,EACvB,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CA8FhC;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,EAAE,CAEhF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,OAAO,EAAE,YAAY,EAAE,EACvB,UAAU,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,CAAC,GACrC,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAU3B"}

package/node_modules/@microwiseai/snapshot-parallel/dist/parallel-installer.js

@@ -0,0 +1,159 @@
+/**
+ * Parallel Package Installer
+ *
+ * Concurrency-limited parallel execution for package installation.
+ * Replaces serial for-loops in core/install.ts with Promise-pool pattern.
+ */
+// ============================================================
+// Core: Concurrency-limited Promise Pool
+// ============================================================
+/**
+ * Run an array of async tasks with a concurrency limit.
+ * Uses a pool pattern (not chunking) so a new task starts
+ * as soon as a slot frees up.
+ */
+async function runPool(items, concurrency, fn, signal) {
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    async function worker() {
+        while (nextIndex < items.length) {
+            if (signal?.aborted) {
+                break;
+            }
+            const idx = nextIndex++;
+            results[idx] = await fn(items[idx], idx);
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+// ============================================================
+// Public API
+// ============================================================
+/**
+ * Install packages in parallel with concurrency control.
+ *
+ * @param entries - List of packages to install
+ * @param installFn - Function that installs a single package (caller provides the actual logic)
+ * @param options - Concurrency, progress callback, abort signal
+ *
+ * @example
+ * ```ts
+ * import { parallelInstall } from '@microwiseai/snapshot-parallel';
+ *
+ * const result = await parallelInstall(
+ *   [{ name: '@ist/smon', version: '0.2.15' }],
+ *   async (entry) => {
+ *     // your install logic here
+ *     return { success: true };
+ *   },
+ *   { concurrency: 4, onProgress: (e) => console.log(`${e.current}/${e.total}`) }
+ * );
+ * ```
+ */
+export async function parallelInstall(entries, installFn, options = {}) {
+    const { concurrency = 4, onProgress, signal } = options;
+    if (entries.length === 0) {
+        return { installed: [], failed: [], results: [], totalDurationMs: 0 };
+    }
+    const totalStart = Date.now();
+    let completedCount = 0;
+    const results = await runPool(entries, concurrency, async (entry, _index) => {
+        const spec = `${entry.name}@${entry.version}`;
+        const start = Date.now();
+        if (signal?.aborted) {
+            const res = {
+                name: entry.name,
+                version: entry.version,
+                spec,
+                success: false,
+                error: 'Aborted',
+                durationMs: 0,
+            };
+            return res;
+        }
+        try {
+            const outcome = await installFn(entry);
+            const durationMs = Date.now() - start;
+            const res = {
+                name: entry.name,
+                version: entry.version,
+                spec,
+                success: outcome.success,
+                error: outcome.error,
+                durationMs,
+            };
+            completedCount++;
+            onProgress?.({
+                current: completedCount,
+                total: entries.length,
+                result: res,
+            });
+            return res;
+        }
+        catch (err) {
+            const durationMs = Date.now() - start;
+            const error = err instanceof Error ? err.message : String(err);
+            const res = {
+                name: entry.name,
+                version: entry.version,
+                spec,
+                success: false,
+                error,
+                durationMs,
+            };
+            completedCount++;
+            onProgress?.({
+                current: completedCount,
+                total: entries.length,
+                result: res,
+            });
+            return res;
+        }
+    }, signal);
+    const installed = [];
+    const failed = [];
+    for (const r of results) {
+        if (!r)
+            continue; // skipped due to abort
+        if (r.success) {
+            installed.push(r.spec);
+        }
+        else {
+            failed.push(r.spec);
+        }
+    }
+    return {
+        installed,
+        failed,
+        results: results.filter(Boolean),
+        totalDurationMs: Date.now() - totalStart,
+    };
+}
+// ============================================================
+// Helpers: Convert between Record<string,string> and PackageEntry[]
+// ============================================================
+/**
+ * Convert a { name: version } record to PackageEntry[].
+ * Preserves insertion order.
+ */
+export function recordToEntries(packages) {
+    return Object.entries(packages).map(([name, version]) => ({ name, version }));
+}
+/**
+ * Partition entries by a classifier function.
+ * Useful for splitting skit vs npm vs generic before parallel install.
+ */
+export function partitionEntries(entries, classifier) {
+    const result = {};
+    for (const entry of entries) {
+        const key = classifier(entry);
+        if (!result[key]) {
+            result[key] = [];
+        }
+        result[key].push(entry);
+    }
+    return result;
+}
+//# sourceMappingURL=parallel-installer.js.map

package/node_modules/@microwiseai/snapshot-parallel/dist/parallel-installer.js.map

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

package/node_modules/@microwiseai/snapshot-parallel/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@microwiseai/snapshot-parallel",
+  "version": "0.1.0",
+  "description": "Parallel package installer with concurrency control for Snapshot CLI",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "snapshot",
+    "parallel",
+    "installer",
+    "concurrency"
+  ],
+  "author": "IST Team",
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microwiseai/snapshot",
-  "version": "0.3.46",
+  "version": "0.3.57",
   "description": "CLI for installing IST Snapshot packages",
   "type": "module",
   "main": "./dist/lib.js",
@@ -35,7 +35,9 @@
     "@ist/registry-config",
     "@microwiseai/import-telemetry",
     "@microwiseai/license",
-    "@microwiseai/skit"
+    "@microwiseai/skit",
+    "@microwiseai/snapshot-dedup",
+    "@microwiseai/snapshot-parallel"
   ],
   "keywords": [
     "snapshot",
@@ -72,6 +74,8 @@
     "@ist/registry-config",
     "@microwiseai/import-telemetry",
     "@microwiseai/license",
-    "@microwiseai/skit"
+    "@microwiseai/skit",
+    "@microwiseai/snapshot-dedup",
+    "@microwiseai/snapshot-parallel"
   ]
 }