@nimbus-sh/worker 0.1.0

package/dist/npm/resolver.d.ts

@@ -0,0 +1,109 @@
+/**
+ * npm-resolver.ts — Semver resolution, exports field, and hoisting for Nimbus npm v2.
+ *
+ * Provides:
+ *   1. Proper semver parsing + range matching (^, ~, >=, ||, *, x ranges)
+ *   2. Node.js-spec exports field resolution with conditions
+ *   3. Aggressive hoisting algorithm (one copy of each version at the highest level)
+ *   4. Build-only package skip list
+ */
+import type { NpmCache } from './cache.js';
+/**
+ * Injectable fetch function. Allows the caller to route fetches through a
+ * facet worker (required because DO fetch() hangs in wrangler local dev).
+ * Falls back to global fetch() if not provided.
+ */
+export type FetchFn = (url: string, init?: RequestInit) => Promise<Response>;
+/**
+ * Simple concurrency limiter. Prevents ephemeral port exhaustion when
+ * making many fetch() calls through a single proxy worker.
+ */
+export declare function pLimit(concurrency: number): <T>(fn: () => Promise<T>) => Promise<T>;
+export interface ResolvedPackage {
+    name: string;
+    version: string;
+    tarballUrl: string;
+    integrity: string;
+    dependencies: Record<string, string>;
+    /** X.5-F R2: required peer-deps surfaced for auto-install. Optional
+     *  peers (peerDependenciesMeta.<name>.optional === true) are
+     *  excluded here. */
+    peerDependencies?: Record<string, string>;
+    /** X.5-G G1: optionalDependencies — best-effort installs that are
+     *  silently skipped when the host doesn't match os/cpu/libc OR when
+     *  the packument shape is a known native-shard pattern. Per npm 4828
+     *  semantics: failure to install MUST NOT fail the parent. */
+    optionalDependencies?: Record<string, string>;
+    /** X.5-G G1: platform constraints from the registry. Empty arrays
+     *  mean cross-platform. Non-empty means the package opts out of
+     *  installs on hosts that don't match. */
+    os?: string[];
+    cpu?: string[];
+    libc?: string[];
+    exports: any;
+    main: string;
+    module: string;
+    bin: Record<string, string>;
+}
+export interface HoistPlan {
+    /** Root-level hoisted packages: name → ResolvedPackage */
+    root: Map<string, ResolvedPackage>;
+    /**
+     * Nested packages that couldn't be hoisted due to version conflicts.
+     * Key: "parentName/childName", Value: ResolvedPackage
+     */
+    nested: Map<string, ResolvedPackage>;
+}
+/**
+ * Check if a version satisfies a full range expression.
+ * Supports || (OR), space (AND within a range set), hyphen ranges.
+ */
+export declare function satisfiesRange(version: string, range: string): boolean;
+/** Find the highest version matching a range from a list of versions. */
+export declare function resolveVersion(versions: string[], range: string): string | null;
+/**
+ * Resolve a single package from the registry.
+ * Checks cache first, then fetches from npm.
+ */
+export declare function resolvePackage(name: string, versionRange: string, cache: NpmCache, fetchFn?: FetchFn, log?: (msg: string) => void): Promise<ResolvedPackage | null>;
+/**
+ * Resolve the full dependency tree, breadth-first.
+ * Calls onResolved() for each package as it's resolved (pipelined — caller
+ * can start fetching tarballs immediately).
+ *
+ * W11: pass `opts.frameworkAware = true` when the project is detected as
+ * one of {next, astro, nuxt, remix, sveltekit, vite, wrangler} so that
+ * `vite` (and any future FRAMEWORK_REQUIRED_PACKAGES additions) actually
+ * land in node_modules. See audit/sections/W11-plan.md §3.0.
+ */
+export declare function resolveTree(specs: Record<string, string>, cache: NpmCache, onResolved?: (pkg: ResolvedPackage) => void, onProgress?: (msg: string) => void, fetchFn?: FetchFn, opts?: {
+    frameworkAware?: boolean;
+}): Promise<Map<string, ResolvedPackage>>;
+/**
+ * Compute npm-style hoisting: maximize packages at root node_modules/.
+ *
+ * Algorithm:
+ *   1. Collect all unique name@version pairs from the resolved tree.
+ *   2. For each package name, pick the most commonly depended-upon version
+ *      for root hoisting.
+ *   3. Any dep that requires a different version of an already-hoisted name
+ *      goes into nested: node_modules/<parent>/node_modules/<child>
+ *
+ * In practice, for well-maintained projects (e.g., Radix UI ecosystem),
+ * most packages agree on compatible versions and everything hoists to root.
+ */
+export declare function computeHoistPlan(resolved: Map<string, ResolvedPackage>): HoistPlan;
+/** Check if a package should be skipped (build-only, native, types). */
+export declare function shouldSkipPackage(name: string): boolean;
+/**
+ * W11: framework-aware skip variant. When `frameworkAware` is true, the
+ * resolver lets through packages in FRAMEWORK_REQUIRED_PACKAGES (currently
+ * just `vite`) so framework dev binaries can import them from node_modules.
+ *
+ * Callers detect framework presence via `framework-detect.ts` BEFORE
+ * starting resolution and thread the flag through `resolveTree`.
+ *
+ * See audit/sections/W11-plan.md §3.0.
+ */
+export declare function shouldSkipPackageWithFramework(name: string, frameworkAware: boolean): boolean;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/npm/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/npm/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAsB,MAAM,YAAY,CAAC;AA0B/D;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE7E;;;GAGG;AACH,wBAAgB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAmBnF;AAID,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC;;yBAEqB;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;kEAG8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C;;8CAE0C;IAC1C,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,0DAA0D;IAC1D,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnC;;;OAGG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACtC;AA0ED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAuBtE;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB/E;AAID;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAsMjC;AA+ID;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,KAAK,EAAE,QAAQ,EACf,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,EAC3C,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAClC,OAAO,CAAC,EAAE,OAAO,EACjB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAuQvC;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACrC,SAAS,CA8BX;AA0DD,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,OAAO,GACtB,OAAO,CAGT"}