@nimbus-sh/fabric 0.6.0 → 0.7.0

package/dist/turn-budget.d.ts

@@ -114,7 +114,7 @@ export interface PacedWorkHost {
      * reason. Without it the pump degrades to a same-context timer — see
      * {@link PacedWork.nextTurn}.
      */
-    requestTurn?: (notBefore?: number) => void;
+    requestTurn?: (notBefore?: number) => void | Promise<void>;
 }
 /**
  * The granting side of {@link TurnScheduler}: parks suspended launches
@@ -134,6 +134,7 @@ export declare class PacedWork implements TurnScheduler {
      * from its inputs is the same idempotent work again.
      */
     private waiters;
+    private closed;
     /**
      * `ctx` keys the cold-start queue the pump drains first on every turn it
      * grants — see {@link pump}.
@@ -159,6 +160,9 @@ export declare class PacedWork implements TurnScheduler {
      * the runtime may tear the context down mid-chunk.
      */
     pump(): Promise<void>;
+    private requestTurn;
+    /** Reject parked work before the owner drains launch cleanup and cancels its alarm. */
+    close(reason?: Error): void;
     /** Whether any launch is suspended waiting for a turn. */
     get hasPending(): boolean;
 }

package/dist/turn-budget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn-budget.d.ts","sourceRoot":"","sources":["../src/turn-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,UAAY,CAAC;AAE9C;;;;;;;;;GASG;AACH,qBAAa,UAAU;IAkBnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAnB/B,qEAAqE;IACrE,MAAM,SAAK;IACX,iDAAiD;IACjD,KAAK,SAAK;IAEV,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,UAAU,CAA8D;IAEhF;;;;;;;OAOG;gBAEgB,SAAS,EAAE,aAAa,EACxB,aAAa,GAAE,MAA6B,EAC5C,WAAW,CAAC,GAAE,MAAM,IAAI,aAAA;IAG3C;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczC;;;;OAIG;IACH,MAAM,IAAI,IAAI;CAIf;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,CAAC,GAAG,IAAI,KAAK;IAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;CAAE,CAI/G;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED;;;GAGG;AACH,qBAAa,SAAU,YAAW,aAAa;IAkB3C,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAlBvB;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAO,CAAmF;IAElG;;;OAGG;gBAEgB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,aAAa;IAGtC;;;;;;;;;OASG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjE;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,0DAA0D;IAC1D,IAAI,UAAU,IAAI,OAAO,CAExB;CACF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMtD"}
+{"version":3,"file":"turn-budget.d.ts","sourceRoot":"","sources":["../src/turn-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,UAAY,CAAC;AAE9C;;;;;;;;;GASG;AACH,qBAAa,UAAU;IAkBnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAnB/B,qEAAqE;IACrE,MAAM,SAAK;IACX,iDAAiD;IACjD,KAAK,SAAK;IAEV,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,UAAU,CAA8D;IAEhF;;;;;;;OAOG;gBAEgB,SAAS,EAAE,aAAa,EACxB,aAAa,GAAE,MAA6B,EAC5C,WAAW,CAAC,GAAE,MAAM,IAAI,aAAA;IAG3C;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczC;;;;OAIG;IACH,MAAM,IAAI,IAAI;CAIf;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,CAAC,GAAG,IAAI,KAAK;IAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;CAAE,CAI/G;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED;;;GAGG;AACH,qBAAa,SAAU,YAAW,aAAa;IAmB3C,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAnBvB;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAO,CAAqH;IACpI,OAAO,CAAC,MAAM,CAAoB;IAElC;;;OAGG;gBAEgB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,aAAa;IAGtC;;;;;;;;;OASG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjE;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAyBb,WAAW;IAKzB,uFAAuF;IACvF,KAAK,CAAC,MAAM,QAA0C,GAAG,IAAI;IAK7D,0DAA0D;IAC1D,IAAI,UAAU,IAAI,OAAO,CAExB;CACF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMtD"}

package/dist/turn-budget.js

@@ -130,6 +130,7 @@ export class PacedWork {
      * from its inputs is the same idempotent work again.
      */
     waiters = [];
+    closed;
     /**
      * `ctx` keys the cold-start queue the pump drains first on every turn it
      * grants — see {@link pump}.
@@ -149,10 +150,19 @@ export class PacedWork {
      * responsiveness but keeps the behaviour.
      */
     nextTurn(chunkEnded, notBefore = 0) {
-        return new Promise((resume) => {
-            this.waiters.push({ resume, chunkEnded, notBefore });
+        if (this.closed)
+            return Promise.reject(this.closed);
+        return new Promise((resume, reject) => {
+            const waiter = { resume, reject, chunkEnded, notBefore };
+            this.waiters.push(waiter);
             if (this.host.requestTurn) {
-                this.host.requestTurn(notBefore);
+                void this.requestTurn(notBefore).catch((error) => {
+                    const index = this.waiters.indexOf(waiter);
+                    if (index < 0)
+                        return;
+                    this.waiters.splice(index, 1);
+                    waiter.reject(error);
+                });
                 return;
             }
             setTimeout(() => { void this.pump(); }, Math.max(0, notBefore - Date.now()));
@@ -167,21 +177,44 @@ export class PacedWork {
      * the runtime may tear the context down mid-chunk.
      */
     async pump() {
-        // Deferred reconciliation runs first, before any waiter resumes. Where
-        // the resident-launch journal's recovery sits (`onColdStart`): the pump
-        // is what an alarm calls, and the first turn after a reset is the
-        // re-delivered alarm of a launch the reset interrupted.
+        if (this.closed)
+            return;
         await runColdStart(this.ctx);
+        if (this.closed)
+            return;
         const now = Date.now();
         const waiting = this.waiters.filter((waiter) => waiter.notBefore <= now);
         this.waiters = this.waiters.filter((waiter) => waiter.notBefore > now);
-        if (this.waiters.length > 0)
-            this.host.requestTurn?.(Math.min(...this.waiters.map((waiter) => waiter.notBefore)));
-        if (waiting.length === 0)
-            return;
+        const future = [...this.waiters];
+        const scheduled = future.length > 0
+            ? this.requestTurn(Math.min(...future.map((waiter) => waiter.notBefore))).catch((error) => {
+                for (const waiter of future) {
+                    const index = this.waiters.indexOf(waiter);
+                    if (index < 0)
+                        continue;
+                    this.waiters.splice(index, 1);
+                    waiter.reject(error);
+                }
+                throw error;
+            })
+            : Promise.resolve();
         for (const waiter of waiting)
             waiter.resume();
-        await Promise.all(waiting.map((waiter) => waiter.chunkEnded));
+        const results = await Promise.allSettled([scheduled, ...waiting.map((waiter) => waiter.chunkEnded)]);
+        const failure = results.find((result) => result.status === 'rejected');
+        if (failure?.status === 'rejected')
+            throw failure.reason;
+    }
+    async requestTurn(notBefore) {
+        if (this.closed)
+            throw this.closed;
+        await this.host.requestTurn?.(notBefore);
+    }
+    /** Reject parked work before the owner drains launch cleanup and cancels its alarm. */
+    close(reason = new Error('Launch scheduler is closed')) {
+        this.closed ??= reason;
+        for (const waiter of this.waiters.splice(0))
+            waiter.reject(this.closed);
     }
     /** Whether any launch is suspended waiting for a turn. */
     get hasPending() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbus-sh/fabric",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "The Cloudflare half of Nimbus — Durable Object facet hosting, dynamic-worker loader pools, the resident-process fabric, and DO alarm/hibernation machinery.",
   "keywords": [
     "cloudflare",
@@ -50,8 +50,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@nimbus-sh/core": "^0.10.0",
-    "@nimbus-sh/platform": "^0.4.0",
+    "@nimbus-sh/core": "^0.11.0",
+    "@nimbus-sh/platform": "^0.5.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {

package/src/turn-budget.ts

@@ -142,7 +142,7 @@ export interface PacedWorkHost {
    * reason. Without it the pump degrades to a same-context timer — see
    * {@link PacedWork.nextTurn}.
    */
-  requestTurn?: (notBefore?: number) => void;
+  requestTurn?: (notBefore?: number) => void | Promise<void>;
 }
 
 /**
@@ -160,7 +160,8 @@ export class PacedWork implements TurnScheduler {
    * half-built work for pids that no longer exist, where re-driving a launch
    * from its inputs is the same idempotent work again.
    */
-  private waiters: Array<{ resume: () => void; chunkEnded: Promise<void>; notBefore: number }> = [];
+  private waiters: Array<{ resume: () => void; reject: (error: unknown) => void; chunkEnded: Promise<void>; notBefore: number }> = [];
+  private closed: Error | undefined;
 
   /**
    * `ctx` keys the cold-start queue the pump drains first on every turn it
@@ -182,10 +183,17 @@ export class PacedWork implements TurnScheduler {
    * responsiveness but keeps the behaviour.
    */
   nextTurn(chunkEnded: Promise<void>, notBefore = 0): Promise<void> {
-    return new Promise<void>((resume) => {
-      this.waiters.push({ resume, chunkEnded, notBefore });
+    if (this.closed) return Promise.reject(this.closed);
+    return new Promise<void>((resume, reject) => {
+      const waiter = { resume, reject, chunkEnded, notBefore };
+      this.waiters.push(waiter);
       if (this.host.requestTurn) {
-        this.host.requestTurn(notBefore);
+        void this.requestTurn(notBefore).catch((error: unknown) => {
+          const index = this.waiters.indexOf(waiter);
+          if (index < 0) return;
+          this.waiters.splice(index, 1);
+          waiter.reject(error);
+        });
         return;
       }
       setTimeout(() => { void this.pump(); }, Math.max(0, notBefore - Date.now()));
@@ -201,18 +209,39 @@ export class PacedWork implements TurnScheduler {
    * the runtime may tear the context down mid-chunk.
    */
   async pump(): Promise<void> {
-    // Deferred reconciliation runs first, before any waiter resumes. Where
-    // the resident-launch journal's recovery sits (`onColdStart`): the pump
-    // is what an alarm calls, and the first turn after a reset is the
-    // re-delivered alarm of a launch the reset interrupted.
+    if (this.closed) return;
     await runColdStart(this.ctx);
+    if (this.closed) return;
     const now = Date.now();
     const waiting = this.waiters.filter((waiter) => waiter.notBefore <= now);
     this.waiters = this.waiters.filter((waiter) => waiter.notBefore > now);
-    if (this.waiters.length > 0) this.host.requestTurn?.(Math.min(...this.waiters.map((waiter) => waiter.notBefore)));
-    if (waiting.length === 0) return;
+    const future = [...this.waiters];
+    const scheduled = future.length > 0
+      ? this.requestTurn(Math.min(...future.map((waiter) => waiter.notBefore))).catch((error: unknown) => {
+        for (const waiter of future) {
+          const index = this.waiters.indexOf(waiter);
+          if (index < 0) continue;
+          this.waiters.splice(index, 1);
+          waiter.reject(error);
+        }
+        throw error;
+      })
+      : Promise.resolve();
     for (const waiter of waiting) waiter.resume();
-    await Promise.all(waiting.map((waiter) => waiter.chunkEnded));
+    const results = await Promise.allSettled([scheduled, ...waiting.map((waiter) => waiter.chunkEnded)]);
+    const failure = results.find((result) => result.status === 'rejected');
+    if (failure?.status === 'rejected') throw failure.reason;
+  }
+
+  private async requestTurn(notBefore: number): Promise<void> {
+    if (this.closed) throw this.closed;
+    await this.host.requestTurn?.(notBefore);
+  }
+
+  /** Reject parked work before the owner drains launch cleanup and cancels its alarm. */
+  close(reason = new Error('Launch scheduler is closed')): void {
+    this.closed ??= reason;
+    for (const waiter of this.waiters.splice(0)) waiter.reject(this.closed);
   }
 
   /** Whether any launch is suspended waiting for a turn. */