@nimbus-sh/platform 0.4.0 → 0.5.0

package/dist/limits.d.ts

@@ -18,6 +18,13 @@ export declare const CHUNK_SIZE = 65536;
 export declare const MAX_TX_BLOB_BYTES: number;
 export declare const MAX_TX_LOGICAL_ROWS = 256;
 export declare const MAX_TX_SQL_EXECS = 64;
+/**
+ * Bound parameters per SQL statement on Durable Objects SQLite. Measured
+ * 2026-09-21 on workerd: 100 bind, 101 fail as `too many SQL variables`
+ * (a 9-row insert of 12 columns fails, 8 rows succeed). Every IN-list and
+ * multi-row VALUES statement is sized from this.
+ */
+export declare const SQL_MAX_BOUND_PARAMETERS = 100;
 /**
  * Storage per SQLite-backed Durable Object: 10 decimal GB documented
  * (Workers Paid), shared by the root object, every facet beneath it, and

package/dist/limits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,QAAS,CAAC;AAEjC,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AACjD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAInC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,cAAiB,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAa,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,UAAY,CAAC;AAI9C;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAIlD;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAOhD,eAAO,MAAM,0BAA0B,QAAmB,CAAC;AA6B3D,eAAO,MAAM,6BAA6B,QAAmB,CAAC;AAO9D,eAAO,MAAM,4CAA4C,QAAmB,CAAC;AAY7E,eAAO,MAAM,6BAA6B,QAAc,CAAC;AAKzD,eAAO,MAAM,oCAAoC,QAAkB,CAAC;AAQpE,eAAO,MAAM,0BAA0B,QAA6B,CAAC;AACrE,eAAO,MAAM,sBAAsB,IAAI,CAAC"}
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,QAAS,CAAC;AAEjC,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AACjD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAI5C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,cAAiB,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAa,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,UAAY,CAAC;AAI9C;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAIlD;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAOhD,eAAO,MAAM,0BAA0B,QAAmB,CAAC;AA6B3D,eAAO,MAAM,6BAA6B,QAAmB,CAAC;AAO9D,eAAO,MAAM,4CAA4C,QAAmB,CAAC;AAY7E,eAAO,MAAM,6BAA6B,QAAc,CAAC;AAKzD,eAAO,MAAM,oCAAoC,QAAkB,CAAC;AAQpE,eAAO,MAAM,0BAA0B,QAA6B,CAAC;AACrE,eAAO,MAAM,sBAAsB,IAAI,CAAC"}

package/dist/limits.js

@@ -24,6 +24,13 @@ export const CHUNK_SIZE = 65_536;
 export const MAX_TX_BLOB_BYTES = 1 * 1024 * 1024;
 export const MAX_TX_LOGICAL_ROWS = 256;
 export const MAX_TX_SQL_EXECS = 64;
+/**
+ * Bound parameters per SQL statement on Durable Objects SQLite. Measured
+ * 2026-09-21 on workerd: 100 bind, 101 fail as `too many SQL variables`
+ * (a 9-row insert of 12 columns fails, 8 rows succeed). Every IN-list and
+ * multi-row VALUES statement is sized from this.
+ */
+export const SQL_MAX_BOUND_PARAMETERS = 100;
 // ── SQLite storage walls ────────────────────────────────────────────────
 /**
  * Storage per SQLite-backed Durable Object: 10 decimal GB documented

package/dist/w7-frame.js

@@ -77,7 +77,7 @@ export async function decodeWriteBatchStream(stream, options = {}) {
     catch {
         throw new Error('w7-frame: stream must be a byte-oriented ReadableStream');
     }
-    const buffer = new ExactByteReader(reader);
+    const buffer = new ExactByteReader(reader, options.signal);
     let handedOff = false;
     try {
         throwIfAborted(options.signal);
@@ -796,9 +796,24 @@ async function cancelReader(reader, reason) {
 }
 class ExactByteReader {
     reader;
+    signal;
     done = false;
-    constructor(reader) {
+    constructor(reader, signal) {
         this.reader = reader;
+        this.signal = signal;
+    }
+    async read(read, cancel) {
+        throwIfAborted(this.signal);
+        const abort = () => { void cancel().catch(() => { }); };
+        this.signal?.addEventListener('abort', abort, { once: true });
+        try {
+            const result = await read();
+            throwIfAborted(this.signal);
+            return result;
+        }
+        finally {
+            this.signal?.removeEventListener('abort', abort);
+        }
     }
     async readExact(length, label) {
         if (length === 0)
@@ -809,7 +824,7 @@ class ExactByteReader {
             if (this.done) {
                 throw new Error(`w7-frame: stream ended ${offset} bytes into expected ${length}-byte ${label}`);
             }
-            const next = await this.reader.read(new Uint8Array(length - offset));
+            const next = await this.read(() => this.reader.read(new Uint8Array(length - offset)), () => this.reader.cancel(this.signal?.reason));
             if (next.done)
                 this.done = true;
             else if (next.value.byteLength > 0) {
@@ -825,7 +840,7 @@ class ExactByteReader {
         this.reader.releaseLock();
         const reader = stream.getReader();
         try {
-            const next = await reader.read();
+            const next = await this.read(() => reader.read(), () => reader.cancel(this.signal?.reason));
             if (!next.done && next.value.byteLength > 0) {
                 await reader.cancel(new Error('w7-frame: trailing bytes after batch-end'));
                 throw new Error('w7-frame: trailing bytes after batch-end');

package/package.json

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

package/src/limits.ts

@@ -28,6 +28,14 @@ export const MAX_TX_BLOB_BYTES = 1 * 1024 * 1024;
 export const MAX_TX_LOGICAL_ROWS = 256;
 export const MAX_TX_SQL_EXECS = 64;
 
+/**
+ * Bound parameters per SQL statement on Durable Objects SQLite. Measured
+ * 2026-09-21 on workerd: 100 bind, 101 fail as `too many SQL variables`
+ * (a 9-row insert of 12 columns fails, 8 rows succeed). Every IN-list and
+ * multi-row VALUES statement is sized from this.
+ */
+export const SQL_MAX_BOUND_PARAMETERS = 100;
+
 // ── SQLite storage walls ────────────────────────────────────────────────
 
 /**

package/src/w7-frame.ts

@@ -220,7 +220,7 @@ export async function decodeWriteBatchStream(
   } catch {
     throw new Error('w7-frame: stream must be a byte-oriented ReadableStream');
   }
-  const buffer = new ExactByteReader(reader);
+  const buffer = new ExactByteReader(reader, options.signal);
   let handedOff = false;
   try {
     throwIfAborted(options.signal);
@@ -1006,7 +1006,20 @@ async function cancelReader(
 class ExactByteReader {
   private done = false;
 
-  constructor(private readonly reader: ReadableStreamBYOBReader) {}
+  constructor(private readonly reader: ReadableStreamBYOBReader, private readonly signal?: AbortSignal) {}
+
+  private async read<T>(read: () => Promise<T>, cancel: () => Promise<void>): Promise<T> {
+    throwIfAborted(this.signal);
+    const abort = () => { void cancel().catch(() => {}); };
+    this.signal?.addEventListener('abort', abort, { once: true });
+    try {
+      const result = await read();
+      throwIfAborted(this.signal);
+      return result;
+    } finally {
+      this.signal?.removeEventListener('abort', abort);
+    }
+  }
 
   async readExact(length: number, label: string): Promise<Uint8Array> {
     if (length === 0) return new Uint8Array(0);
@@ -1018,7 +1031,10 @@ class ExactByteReader {
           `w7-frame: stream ended ${offset} bytes into expected ${length}-byte ${label}`,
         );
       }
-      const next = await this.reader.read(new Uint8Array(length - offset));
+      const next = await this.read(
+        () => this.reader.read(new Uint8Array(length - offset)),
+        () => this.reader.cancel(this.signal?.reason),
+      );
       if (next.done) this.done = true;
       else if (next.value.byteLength > 0) {
         output.set(next.value, offset);
@@ -1033,7 +1049,7 @@ class ExactByteReader {
     this.reader.releaseLock();
     const reader = stream.getReader();
     try {
-      const next = await reader.read();
+      const next = await this.read(() => reader.read(), () => reader.cancel(this.signal?.reason));
       if (!next.done && next.value.byteLength > 0) {
         await reader.cancel(new Error('w7-frame: trailing bytes after batch-end'));
         throw new Error('w7-frame: trailing bytes after batch-end');