@nimbus-sh/platform 0.8.0 → 0.8.1

package/dist/limits.d.ts

@@ -74,14 +74,14 @@ export declare const BLOCK_CONCURRENCY_CANCEL_MS = 30000;
  */
 export declare const RESIDENT_KEEPALIVE_MS = 5000;
 /**
- * How long the keep-alive holds a session after its last client is gone.
+ * How long the keep-alive holds a resident after its last client traffic.
  *
  * The keep-alive exists so a quiet process survives while its user is
  * present. Unbounded, it made every abandoned session with a dev server
  * run forever: the probe suite's cancelled runs left staging with resident
  * watchers polling `stat` at ~7.5/s in the isolate every session shares,
  * and launches that pass on a fresh Worker reset there (2026-09-22). Past
- * this grace with no attached socket and no request, the session idles
+ * this grace without runtime client traffic, even with idle sockets, the session idles
  * out as it did before the keep-alive, and the launch journal re-drives
  * the process when a client returns. Long enough for a tab reload.
  */

package/dist/limits.js

@@ -87,14 +87,14 @@ export const BLOCK_CONCURRENCY_CANCEL_MS = 30_000;
  */
 export const RESIDENT_KEEPALIVE_MS = 5_000;
 /**
- * How long the keep-alive holds a session after its last client is gone.
+ * How long the keep-alive holds a resident after its last client traffic.
  *
  * The keep-alive exists so a quiet process survives while its user is
  * present. Unbounded, it made every abandoned session with a dev server
  * run forever: the probe suite's cancelled runs left staging with resident
  * watchers polling `stat` at ~7.5/s in the isolate every session shares,
  * and launches that pass on a fresh Worker reset there (2026-09-22). Past
- * this grace with no attached socket and no request, the session idles
+ * this grace without runtime client traffic, even with idle sockets, the session idles
  * out as it did before the keep-alive, and the launch journal re-drives
  * the process when a client returns. Long enough for a tab reload.
  */

package/dist/module-source.d.ts

@@ -0,0 +1,31 @@
+/** A deployed source asset: its digest, not its pathname, is its identity. */
+export interface ModuleSourceAsset {
+    path: string;
+    sha256: string;
+}
+export interface ModuleSourceEnv {
+    ASSETS?: {
+        fetch(request: Request): Promise<Response>;
+    };
+}
+/** Source already verified against its deployment pin. Shared across generated programs. */
+export declare class ImmutableModuleSource {
+    readonly asset: ModuleSourceAsset;
+    readonly byteLength: number;
+    readonly text: string;
+    constructor(bytes: ArrayBuffer | Uint8Array, asset: ModuleSourceAsset);
+}
+export type ModuleSourcePart = string | ImmutableModuleSource;
+export type ModuleSourceRecipe = (string | ModuleSourceAsset)[];
+/** A generated module retains its immutable pieces until the Loader needs its complete text. */
+export declare class ModuleSource {
+    readonly parts: readonly ModuleSourcePart[];
+    private joined;
+    readonly byteLength: number;
+    constructor(parts: readonly ModuleSourcePart[]);
+    get text(): string;
+    recipe(): ModuleSourceRecipe;
+}
+/** Template interpolation without flattening immutable runtime libraries into process-owned text. */
+export declare function moduleSource(strings: TemplateStringsArray, ...values: (string | number | boolean | null | undefined | ImmutableModuleSource | ModuleSource)[]): ModuleSource;
+//# sourceMappingURL=module-source.d.ts.map

package/dist/module-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-source.d.ts","sourceRoot":"","sources":["../src/module-source.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAC;CACzD;AAED,4FAA4F;AAC5F,qBAAa,qBAAqB;IAGa,QAAQ,CAAC,KAAK,EAAE,iBAAiB;IAF9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,KAAK,EAAE,WAAW,GAAG,UAAU,EAAW,KAAK,EAAE,iBAAiB;CAI/E;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,qBAAqB,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAC;AAEhE,gGAAgG;AAChG,qBAAa,YAAY;IAGX,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE;IAFvD,OAAO,CAAC,MAAM,CAAqB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBACP,KAAK,EAAE,SAAS,gBAAgB,EAAE;IAGvD,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,MAAM,IAAI,kBAAkB;CAG7B;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,qBAAqB,GAAG,YAAY,CAAC,EAAE,GAAG,YAAY,CAiB5K"}

package/dist/module-source.js

@@ -0,0 +1,52 @@
+/** Source already verified against its deployment pin. Shared across generated programs. */
+export class ImmutableModuleSource {
+    asset;
+    byteLength;
+    text;
+    constructor(bytes, asset) {
+        this.asset = asset;
+        this.text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+        this.byteLength = bytes.byteLength;
+    }
+}
+/** A generated module retains its immutable pieces until the Loader needs its complete text. */
+export class ModuleSource {
+    parts;
+    joined;
+    byteLength;
+    constructor(parts) {
+        this.parts = parts;
+        this.byteLength = parts.reduce((bytes, part) => bytes + (typeof part === 'string' ? new TextEncoder().encode(part).byteLength : part.byteLength), 0);
+    }
+    get text() {
+        return this.joined ??= this.parts.map((part) => typeof part === 'string' ? part : part.text).join('');
+    }
+    recipe() {
+        return this.parts.map((part) => typeof part === 'string' ? part : part.asset);
+    }
+}
+/** Template interpolation without flattening immutable runtime libraries into process-owned text. */
+export function moduleSource(strings, ...values) {
+    const parts = [];
+    const append = (part) => {
+        if (part === '')
+            return;
+        const last = parts.length - 1;
+        const previous = parts[last];
+        if (typeof part === 'string' && typeof previous === 'string')
+            parts[last] = previous + part;
+        else
+            parts.push(part);
+    };
+    for (const [i, literal] of strings.entries()) {
+        append(literal);
+        if (i === values.length)
+            continue;
+        const value = values[i];
+        if (value instanceof ModuleSource)
+            value.parts.forEach(append);
+        else
+            append(value instanceof ImmutableModuleSource ? value : String(value));
+    }
+    return new ModuleSource(parts);
+}

package/dist/retry.d.ts

@@ -12,8 +12,8 @@
  * Every wait is its schedule's entry ±25%, uniformly, so concurrent callers
  * that failed together do not try again together.
  *
- * Self-contained, both functions: a facet that cannot import carries them
- * by source (fn.toString(); the npm install facet's preamble does).
+ * A facet carries these same functions and their dependencies in its
+ * build-time compiled task expression (the npm install facet does).
  */
 /**
  * The wait before re-try `attempt` (0-based, the try that just failed):

package/dist/retry.js

@@ -12,8 +12,8 @@
  * Every wait is its schedule's entry ±25%, uniformly, so concurrent callers
  * that failed together do not try again together.
  *
- * Self-contained, both functions: a facet that cannot import carries them
- * by source (fn.toString(); the npm install facet's preamble does).
+ * A facet carries these same functions and their dependencies in its
+ * build-time compiled task expression (the npm install facet does).
  */
 /**
  * The wait before re-try `attempt` (0-based, the try that just failed):

package/dist/wave-writer.d.ts

@@ -319,7 +319,9 @@ export declare class WaveWriter<Meta = undefined> {
     /**
      * The epoch this writer's waves are fenced under: opened before its first
      * wave, and again once half of WAVE_EPOCH_TTL_MS has passed, so a wave is
-     * never sent under an epoch about to close.
+     * never sent under an epoch about to close. Opened under the lost-call
+     * policy (openWaveEpoch); an open that failed even so is not the writer's
+     * epoch, and the next wave opens again.
      */
     private currentEpoch;
     /** The directories the buffered records publish, shallowest first. */
@@ -366,6 +368,24 @@ export interface WaveTimers {
  * W7 producer sends: the wave writer, and a process's filesystem client.
  */
 export declare function sendWaveAttempts(options: WaveAttempts): Promise<unknown>;
+/**
+ * Open a writer epoch (`open`: the supervisor's openWaveWriter, or a
+ * process's openWriter), again while the call is lost or shed, under a
+ * wave's lost-call policy and budget (isLostFencedCall,
+ * LOST_CALL_RESEND_BACKOFF_MS). Re-opening is safe: an open the session
+ * never ran issued nothing, and one whose answer was lost issued an epoch
+ * nothing is sent under, which closes at WAVE_EPOCH_TTL_MS. Anything else
+ * it answered is its verdict. A shed open would otherwise fail every write
+ * the epoch was for, unsent: measured, create-next-app lost 31 of 42
+ * packages to one.
+ */
+export declare function openWaveEpoch(open: () => Promise<string | null>, options?: {
+    retry?: {
+        backoffMs: readonly number[];
+    };
+    resent?: (lost: Record<string, string | number>) => void;
+    timers?: WaveTimers;
+}): Promise<string | null>;
 /** A wave's encoded bytes as each attempt's stream (in SEND_SLICE_BYTES pieces, each a copy). */
 export declare function waveAttemptsOf(bytes: Uint8Array): () => ReadableStream<Uint8Array>;
 export declare function createWaveWriter<Meta = undefined>(options: WaveWriterOptions<Meta>): WaveWriter<Meta>;

package/dist/wave-writer.d.ts.map

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

package/dist/wave-writer.js

@@ -657,7 +657,9 @@ export class WaveWriter {
     /**
      * The epoch this writer's waves are fenced under: opened before its first
      * wave, and again once half of WAVE_EPOCH_TTL_MS has passed, so a wave is
-     * never sent under an epoch about to close.
+     * never sent under an epoch about to close. Opened under the lost-call
+     * policy (openWaveEpoch); an open that failed even so is not the writer's
+     * epoch, and the next wave opens again.
      */
     async currentEpoch() {
         const supervisor = this.options.supervisor;
@@ -668,7 +670,16 @@ export class WaveWriter {
         if (held === null || (held.writer !== null && now - held.openedAt >= WAVE_EPOCH_TTL_MS / 2)) {
             // Called as a method of the supervisor, never through .call/.apply:
             // on an RPC stub those are remote method names too.
-            this.epoch = supervisor.openWaveWriter().then((writer) => ({ writer, openedAt: now }));
+            const opening = openWaveEpoch(() => supervisor.openWaveWriter(), {
+                ...(this.options.retry === undefined ? {} : { retry: this.options.retry }),
+                resent: (lost) => {
+                    this.counters.retries++;
+                    this.options.onResend?.(lost);
+                },
+            }).then((writer) => ({ writer, openedAt: now }));
+            this.epoch = opening;
+            opening.catch(() => { if (this.epoch === opening)
+                this.epoch = null; });
         }
         return (await this.epoch).writer;
     }
@@ -759,6 +770,37 @@ export async function sendWaveAttempts(options) {
         }
     }
 }
+/**
+ * Open a writer epoch (`open`: the supervisor's openWaveWriter, or a
+ * process's openWriter), again while the call is lost or shed, under a
+ * wave's lost-call policy and budget (isLostFencedCall,
+ * LOST_CALL_RESEND_BACKOFF_MS). Re-opening is safe: an open the session
+ * never ran issued nothing, and one whose answer was lost issued an epoch
+ * nothing is sent under, which closes at WAVE_EPOCH_TTL_MS. Anything else
+ * it answered is its verdict. A shed open would otherwise fail every write
+ * the epoch was for, unsent: measured, create-next-app lost 31 of 42
+ * packages to one.
+ */
+export async function openWaveEpoch(open, options = {}) {
+    const backoffMs = options.retry?.backoffMs ?? LOST_CALL_RESEND_BACKOFF_MS;
+    const timers = options.timers ?? GLOBAL_TIMERS;
+    for (let attempt = 0;; attempt++) {
+        try {
+            return await open();
+        }
+        catch (error) {
+            if (!isLostFencedCall(error) || attempt >= backoffMs.length)
+                throw error;
+            options.resent?.(lostCallAttributes({
+                operation: 'openWaveWriter',
+                attempt: attempt + 1,
+                of: backoffMs.length,
+                reason: error instanceof Error ? error.message : String(error),
+            }));
+            await new Promise((resolve) => { timers.setTimeout(resolve, retryDelayMs(backoffMs, attempt)); });
+        }
+    }
+}
 /** A wave's encoded bytes as each attempt's stream (in SEND_SLICE_BYTES pieces, each a copy). */
 export function waveAttemptsOf(bytes) {
     return piecesOf(bytes, SEND_SLICE_BYTES);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbus-sh/platform",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "The measured Cloudflare platform truths Nimbus is built on \u2014 error taxonomy, limits tables, budget coordination, and wire-format primitives, with zero runtime dependencies.",
   "keywords": [
     "cloudflare",

package/src/limits.ts

@@ -101,14 +101,14 @@ export const BLOCK_CONCURRENCY_CANCEL_MS = 30_000;
 export const RESIDENT_KEEPALIVE_MS = 5_000;
 
 /**
- * How long the keep-alive holds a session after its last client is gone.
+ * How long the keep-alive holds a resident after its last client traffic.
  *
  * The keep-alive exists so a quiet process survives while its user is
  * present. Unbounded, it made every abandoned session with a dev server
  * run forever: the probe suite's cancelled runs left staging with resident
  * watchers polling `stat` at ~7.5/s in the isolate every session shares,
  * and launches that pass on a fresh Worker reset there (2026-09-22). Past
- * this grace with no attached socket and no request, the session idles
+ * this grace without runtime client traffic, even with idle sockets, the session idles
  * out as it did before the keep-alive, and the launch journal re-drives
  * the process when a client returns. Long enough for a tab reload.
  */

package/src/module-source.ts

@@ -0,0 +1,57 @@
+/** A deployed source asset: its digest, not its pathname, is its identity. */
+export interface ModuleSourceAsset {
+  path: string;
+  sha256: string;
+}
+
+export interface ModuleSourceEnv {
+  ASSETS?: { fetch(request: Request): Promise<Response> };
+}
+
+/** Source already verified against its deployment pin. Shared across generated programs. */
+export class ImmutableModuleSource {
+  readonly byteLength: number;
+  readonly text: string;
+  constructor(bytes: ArrayBuffer | Uint8Array, readonly asset: ModuleSourceAsset) {
+    this.text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    this.byteLength = bytes.byteLength;
+  }
+}
+
+export type ModuleSourcePart = string | ImmutableModuleSource;
+export type ModuleSourceRecipe = (string | ModuleSourceAsset)[];
+
+/** A generated module retains its immutable pieces until the Loader needs its complete text. */
+export class ModuleSource {
+  private joined: string | undefined;
+  readonly byteLength: number;
+  constructor(readonly parts: readonly ModuleSourcePart[]) {
+    this.byteLength = parts.reduce((bytes, part) => bytes + (typeof part === 'string' ? new TextEncoder().encode(part).byteLength : part.byteLength), 0);
+  }
+  get text(): string {
+    return this.joined ??= this.parts.map((part) => typeof part === 'string' ? part : part.text).join('');
+  }
+  recipe(): ModuleSourceRecipe {
+    return this.parts.map((part) => typeof part === 'string' ? part : part.asset);
+  }
+}
+
+/** Template interpolation without flattening immutable runtime libraries into process-owned text. */
+export function moduleSource(strings: TemplateStringsArray, ...values: (string | number | boolean | null | undefined | ImmutableModuleSource | ModuleSource)[]): ModuleSource {
+  const parts: ModuleSourcePart[] = [];
+  const append = (part: ModuleSourcePart) => {
+    if (part === '') return;
+    const last = parts.length - 1;
+    const previous = parts[last];
+    if (typeof part === 'string' && typeof previous === 'string') parts[last] = previous + part;
+    else parts.push(part);
+  };
+  for (const [i, literal] of strings.entries()) {
+    append(literal);
+    if (i === values.length) continue;
+    const value = values[i];
+    if (value instanceof ModuleSource) value.parts.forEach(append);
+    else append(value instanceof ImmutableModuleSource ? value : String(value));
+  }
+  return new ModuleSource(parts);
+}

package/src/retry.ts

@@ -12,8 +12,8 @@
  * Every wait is its schedule's entry ±25%, uniformly, so concurrent callers
  * that failed together do not try again together.
  *
- * Self-contained, both functions: a facet that cannot import carries them
- * by source (fn.toString(); the npm install facet's preamble does).
+ * A facet carries these same functions and their dependencies in its
+ * build-time compiled task expression (the npm install facet does).
  */
 
 /**

package/src/wave-writer.ts

@@ -820,7 +820,9 @@ export class WaveWriter<Meta = undefined> {
   /**
    * The epoch this writer's waves are fenced under: opened before its first
    * wave, and again once half of WAVE_EPOCH_TTL_MS has passed, so a wave is
-   * never sent under an epoch about to close.
+   * never sent under an epoch about to close. Opened under the lost-call
+   * policy (openWaveEpoch); an open that failed even so is not the writer's
+   * epoch, and the next wave opens again.
    */
   private async currentEpoch(): Promise<string | null> {
     const supervisor = this.options.supervisor;
@@ -830,7 +832,15 @@ export class WaveWriter<Meta = undefined> {
     if (held === null || (held.writer !== null && now - held.openedAt >= WAVE_EPOCH_TTL_MS / 2)) {
       // Called as a method of the supervisor, never through .call/.apply:
       // on an RPC stub those are remote method names too.
-      this.epoch = supervisor.openWaveWriter().then((writer) => ({ writer, openedAt: now }));
+      const opening = openWaveEpoch(() => supervisor.openWaveWriter!(), {
+        ...(this.options.retry === undefined ? {} : { retry: this.options.retry }),
+        resent: (lost) => {
+          this.counters.retries++;
+          this.options.onResend?.(lost);
+        },
+      }).then((writer) => ({ writer, openedAt: now }));
+      this.epoch = opening;
+      opening.catch(() => { if (this.epoch === opening) this.epoch = null; });
     }
     return (await this.epoch!).writer;
   }
@@ -943,6 +953,39 @@ export async function sendWaveAttempts(options: WaveAttempts): Promise<unknown>
   }
 }
 
+/**
+ * Open a writer epoch (`open`: the supervisor's openWaveWriter, or a
+ * process's openWriter), again while the call is lost or shed, under a
+ * wave's lost-call policy and budget (isLostFencedCall,
+ * LOST_CALL_RESEND_BACKOFF_MS). Re-opening is safe: an open the session
+ * never ran issued nothing, and one whose answer was lost issued an epoch
+ * nothing is sent under, which closes at WAVE_EPOCH_TTL_MS. Anything else
+ * it answered is its verdict. A shed open would otherwise fail every write
+ * the epoch was for, unsent: measured, create-next-app lost 31 of 42
+ * packages to one.
+ */
+export async function openWaveEpoch(
+  open: () => Promise<string | null>,
+  options: { retry?: { backoffMs: readonly number[] }; resent?: (lost: Record<string, string | number>) => void; timers?: WaveTimers } = {},
+): Promise<string | null> {
+  const backoffMs = options.retry?.backoffMs ?? LOST_CALL_RESEND_BACKOFF_MS;
+  const timers = options.timers ?? GLOBAL_TIMERS;
+  for (let attempt = 0; ; attempt++) {
+    try {
+      return await open();
+    } catch (error) {
+      if (!isLostFencedCall(error) || attempt >= backoffMs.length) throw error;
+      options.resent?.(lostCallAttributes({
+        operation: 'openWaveWriter',
+        attempt: attempt + 1,
+        of: backoffMs.length,
+        reason: error instanceof Error ? error.message : String(error),
+      }));
+      await new Promise<void>((resolve) => { timers.setTimeout(resolve, retryDelayMs(backoffMs, attempt)); });
+    }
+  }
+}
+
 /** A wave's encoded bytes as each attempt's stream (in SEND_SLICE_BYTES pieces, each a copy). */
 export function waveAttemptsOf(bytes: Uint8Array): () => ReadableStream<Uint8Array> {
   return piecesOf(bytes, SEND_SLICE_BYTES);