@nimbus-sh/worker 0.12.0 → 0.13.0

package/dist/npm/pre-bundle-facet.d.ts

@@ -1,109 +1,27 @@
 /**
- * pre-bundle-facet.ts — IsolatePool entry for esbuild pre-bundling.
+ * pre-bundle-facet.ts — the supervisor's half of pre-bundling npm packages
+ * (the `Pre-bundling N modules…` step in npm/installer.ts, and the Vite dev
+ * server's on-demand /@modules/ bundles).
  *
- * Why this exists
- * ───────────────
- * Pre-bundling npm packages (the `Pre-bundling N modules…` step in
- * src/npm/installer.ts) used to call `EsbuildService.build(...)`
- * inside the supervisor DO isolate. Each `esbuild.build` allocates
- * 30–80 MiB of WASM linear memory plus the input/output graph; against
- * the 128 MB DO heap cap this OOM-killed the supervisor on installs
- * touching large React libraries (motion, framer-motion, etc.). The
- * symptom was a banner re-print after `npm install` succeeded —
- * NimbusSession's constructor running again because workerd had killed
- * the previous isolate.
- *
- * The fix is to dispatch each per-specifier `esbuild.build` to a
- * IsolatePool isolate. Each facet has its own 128 MB budget and
- * stable-slot reuse keeps the warm-up cost amortized across the 8
- * concurrent specs of a typical install. The install-batch facet uses
- * the same isolate boundary for tarball extraction.
+ * Bundling runs in the Durable Object's build facet (facets/build-facet.ts:
+ * `prebundle`, rolldown, core runtime/prebundle-slice.ts), never in the
+ * supervisor: a bundle's working set (the engine's wasm memory plus the
+ * input and output graph) would not fit beside the supervisor's own heap.
  *
  * File-slice strategy (zero per-read RPC)
  * ──────────────────────────────────────
- * esbuild's VFS plugin would naturally call back to the supervisor for
- * every onLoad / onResolve hit. With workerd's ~5–20 ms RPC latency and
- * 50–200 reads per bundle × 8 specs that's 4–32 seconds of pure RPC
- * overhead per install — measurably worse than the current OOM-y path.
- *
- * Instead the supervisor walks the spec's transitive non-external
- * dependency tree once (fast — direct VFS access) and ships the
- * entire `{path → bytes}` slice as part of the spec. The facet's VFS
- * plugin reads from this in-memory map. Zero RPC during bundling.
- *
- * Stability invariants
- * ───────────────────
- * cloudflare-parallel serializes the function via `fn.toString()`.
- *   - No `this` references (arrow / anonymous async).
- *   - No free variables other than preamble names + explicit args.
- *   - Module-level constants the function references must come from
- *     the preamble (src/loaders/pre-bundle-preamble.ts) — see
- *     `ESBUILD_PRELOAD_PREAMBLE`.
- *
- * The supervisor RPC surface (env.SUPERVISOR) is available for emergency
- * fallbacks but the bundle path MUST NOT use it — slice-up-front is the
- * contract.
+ * A VFS plugin would naturally call back to the supervisor for every
+ * resolve and load. With workerd's ~5–20 ms RPC latency and 50–200 reads
+ * per bundle that is seconds of pure RPC overhead per install. Instead the
+ * supervisor walks the spec's transitive non-external dependency tree once
+ * (fast — direct VFS access) and ships the entire `{path → bytes}` slice as
+ * part of the spec; the bundler reads from that in-memory map.
  */
 import type { CredentialedVfs } from '@nimbus-sh/core/vfs/sqlite-vfs.js';
 import type { ResolvedPackage } from './resolver.js';
 import { BUNDLER_VERSION } from '@nimbus-sh/core/runtime/esbuild-service.js';
-/**
- * One file inside a facet spec's slice. `bytes` is a Uint8Array — esbuild's
- * loader inferences (js/ts/css/binary) need raw bytes for binary entries
- * and TextDecoder produces lossless text for source code.
- *
- * RPC serialisation: workerd transmits Uint8Array via structured-clone with
- * zero-copy semantics across same-process isolates. Memory cost on the
- * facet side equals the spec's slice size; cost on the supervisor side is
- * the same (the slice was just built from VFS reads).
- */
-export interface SlicedFile {
-    path: string;
-    bytes: Uint8Array;
-    isDir: false;
-}
-export interface SlicedDir {
-    path: string;
-    isDir: true;
-}
-export type SliceEntry = SlicedFile | SlicedDir;
-/** What the supervisor sends per pre-bundle dispatch. */
-export interface PrebundleSpec {
-    /** Bare specifier being bundled, e.g. "framer-motion" or "react/jsx-runtime". */
-    specifier: string;
-    /** VFS path of the entry point, e.g. "/home/user/example-app/node_modules/framer-motion/dist/es/index.mjs". */
-    entryPath: string;
-    /** External specifiers (from getSharedRuntimeExternals). */
-    externals: string[];
-    /**
-     * Slice: every file/dir the bundler may need for this spec. Computed
-     * supervisor-side via a transitive-dependency walk. Includes:
-     *   - Every file under node_modules/<spec-pkg>/
-     *   - Every file under node_modules/<dep>/ for each transitive dep
-     *     NOT marked external by `externals`.
-     */
-    slice: SliceEntry[];
-    /** Stamp written into pkg_esm_bundles.bundle_hash; matches BUNDLER_VERSION. */
-    bundlerVersion: string;
-    /** Optional esbuild `define` map. Used by the on-demand bundler path
-     *  (vite-dev-server) to inject process.env.NODE_ENV, import.meta.env.*,
-     *  global → globalThis, etc. The pre-bundle path leaves this undefined
-     *  (browser-target build needs no define replacement). */
-    define?: Record<string, string>;
-}
-/** What the facet returns. */
-export interface PrebundleResult {
-    specifier: string;
-    ok: boolean;
-    /** ESM bundle output as a UTF-8 string. Empty when ok=false. */
-    esmCode: string;
-    /** First esbuild error message; populated when ok=false. */
-    errorText?: string;
-    /** Wall-clock ms inside the facet (bundling only, excludes RPC roundtrip). */
-    elapsed: number;
-    /** Non-fatal warnings the supervisor should surface. */
-    warnings: string[];
-}
+import type { SliceEntry } from '@nimbus-sh/core/runtime/prebundle-slice.js';
+export type { PrebundleResult, PrebundleSpec, SlicedDir, SlicedFile, SliceEntry } from '@nimbus-sh/core/runtime/prebundle-slice.js';
 export declare function buildSliceForSpecifierWithCap(vfs: CredentialedVfs, specifier: string, nmDir: string, capBytes: number): {
     slice: SliceEntry[];
     totalBytes: number;
@@ -114,26 +32,6 @@ export declare function buildSliceForSpecifierWithCap(vfs: CredentialedVfs, spec
  * the helper from esbuild-service.ts on the call site.
  */
 export declare function externalsForSpecifier(specifier: string): string[];
-/**
- * Bundle one specifier in a facet isolate. Returns the ESM bundle output
- * to the supervisor; bundle bytes flow through `pool.map`'s return value
- * (no RPC writeBatch — pkg_esm_bundles is supervisor-side SQLite, not VFS).
- *
- * Memory plan (verified by /api/_diag/memory after the rollout):
- *   - Slice retained in facet memory: ~3–10 MiB per typical React lib.
- *   - esbuild WASM linear memory: ~30–80 MiB during build.
- *   - Output bundle: usually <2 MiB.
- *   - Peak in the facet: ~100 MiB worst case (well under 128 MB cap).
- *
- * The supervisor never holds more than the spec arg + result return at
- * once, so its peak stays in the low tens of MiB during the entire
- * pre-bundle phase.
- */
-export declare const prebundleOne: (spec: PrebundleSpec, _env: {
-    SUPERVISOR: {
-        readFile(p: string): Promise<string | null>;
-    };
-}) => Promise<PrebundleResult>;
 export { BUNDLER_VERSION };
 export type _ResolvedPackage = ResolvedPackage;
 //# sourceMappingURL=pre-bundle-facet.d.ts.map

package/dist/npm/pre-bundle-facet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pre-bundle-facet.d.ts","sourceRoot":"","sources":["../../src/npm/pre-bundle-facet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAA6B,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAgBxG;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;CACd;AACD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;CACb;AACD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhD,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,+GAA+G;IAC/G,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;;OAMG;IACH,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB;;;8DAG0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAQD,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4GpD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjE;AAmBD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,aAAa,EACnB,MAAM;IACJ,UAAU,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;KAAE,CAAC;CAC7D,KACA,OAAO,CAAC,eAAe,CAiazB,CAAC;AAGF,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC"}
+{"version":3,"file":"pre-bundle-facet.d.ts","sourceRoot":"","sources":["../../src/npm/pre-bundle-facet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAA6B,eAAe,EAAE,MAAM,4CAA4C,CAAC;AACxG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4CAA4C,CAAC;AAE7E,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,4CAA4C,CAAC;AAQpI,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4GpD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjE;AAGD,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC"}