@lunora/do 1.0.0-alpha.14 → 1.0.0-alpha.15

package/dist/index.d.mts

@@ -5536,6 +5536,26 @@ declare abstract class ShardDO {
   */
   private errorToResponse;
   /**
+  * Batch dispatch (plan 088). Applies each `calls[]` entry through the SAME
+  * single-call `/rpc` path (via a nested `this.fetch`), **sequentially**, so
+  * the per-`(identity, mutationId)` idempotency dedup and the per-client
+  * `__client_watermark` ordering are enforced entry-by-entry exactly as for an
+  * individual call — no duplication of the dispatch core, no reordering.
+  *
+  * Failures are **per-slot, not fail-fast**: an entry that throws (or a
+  * custom-mutator `OUT_OF_ORDER` gap) is captured in its own result slot and
+  * later entries still run. Ordering is still safe — a later same-client
+  * mutator after a gap re-classifies as a gap too (the watermark never
+  * advanced), so it cannot apply out of order; unrelated entries/queries are
+  * independent. The response is `{ results: [{ id, status, body }] }` in
+  * request order; each `body` is the untouched single-call envelope (its
+  * `result` already wire-encoded), so the client demuxes + decodes each
+  * exactly as one call.
+  */
+  private handleBatchRpc;
+  /** Dispatch one batch entry through the single-call `/rpc` path and capture its envelope (plan 088). */
+  private dispatchBatchEntry;
+  /**
   * Serve a reserved admin-introspection RPC (`__lunora_admin__:*`) for the
   * data browser. Gated by `env.LUNORA_ADMIN_TOKEN`: introspection is
   * **disabled unless the token is configured**, and when it is, the request

package/dist/index.d.ts

@@ -5536,6 +5536,26 @@ declare abstract class ShardDO {
   */
   private errorToResponse;
   /**
+  * Batch dispatch (plan 088). Applies each `calls[]` entry through the SAME
+  * single-call `/rpc` path (via a nested `this.fetch`), **sequentially**, so
+  * the per-`(identity, mutationId)` idempotency dedup and the per-client
+  * `__client_watermark` ordering are enforced entry-by-entry exactly as for an
+  * individual call — no duplication of the dispatch core, no reordering.
+  *
+  * Failures are **per-slot, not fail-fast**: an entry that throws (or a
+  * custom-mutator `OUT_OF_ORDER` gap) is captured in its own result slot and
+  * later entries still run. Ordering is still safe — a later same-client
+  * mutator after a gap re-classifies as a gap too (the watermark never
+  * advanced), so it cannot apply out of order; unrelated entries/queries are
+  * independent. The response is `{ results: [{ id, status, body }] }` in
+  * request order; each `body` is the untouched single-call envelope (its
+  * `result` already wire-encoded), so the client demuxes + decodes each
+  * exactly as one call.
+  */
+  private handleBatchRpc;
+  /** Dispatch one batch entry through the single-call `/rpc` path and capture its envelope (plan 088). */
+  private dispatchBatchEntry;
+  /**
   * Serve a reserved admin-introspection RPC (`__lunora_admin__:*`) for the
   * data browser. Gated by `env.LUNORA_ADMIN_TOKEN`: introspection is
   * **disabled unless the token is configured**, and when it is, the request

package/dist/index.mjs

@@ -7,9 +7,9 @@ export { NotUniqueError, assertValidClientId, createShardCtxDb, normalizeIdStruc
 export { DATA_MIGRATION_STATE_TABLE, readMigrationStatus, runDataMigration } from './packem_shared/DATA_MIGRATION_STATE_TABLE-PTtTiQ7U.mjs';
 export { SCAN_DEP, createDependencyTracker, depKey } from './packem_shared/SCAN_DEP-DLJF8dsj.mjs';
 export { renderSql } from './packem_shared/renderSql-D6eUcn2N.mjs';
-export { diffExternalSource } from './packem_shared/diffExternalSource-Br2GYVZB.mjs';
-export { materializeExternalRows, readExternalSourceBaseline, runExternalSourceTick } from './packem_shared/materializeExternalRows-CcsfmiDe.mjs';
-export { isSourceDue, liftSourceId, pullExternalSourceTick } from './packem_shared/isSourceDue-D_wTv871.mjs';
+export { diffExternalSource } from './packem_shared/diffExternalSource-Cx9HUPJj.mjs';
+export { materializeExternalRows, readExternalSourceBaseline, runExternalSourceTick } from './packem_shared/materializeExternalRows-uKBx9H0s.mjs';
+export { isSourceDue, liftSourceId, pullExternalSourceTick } from './packem_shared/isSourceDue-BMTJv65e.mjs';
 export { FUNCTION_METRICS_BUCKETS_TABLE, FUNCTION_METRICS_BUCKET_MS, FUNCTION_METRICS_BUCKET_RETENTION, FUNCTION_METRICS_INDEX_TABLE, FUNCTION_METRICS_TABLE, ensureFunctionMetricsTables, readFunctionMetricBuckets, readFunctionMetricIndexHits, readFunctionMetrics, readFunctionMetricsTotals, recordFunctionMetric } from './packem_shared/FUNCTION_METRICS_BUCKETS_TABLE-UDNVD7FS.mjs';
 export { ADMIN_FUNCTIONS, ADMIN_FUNCTION_PREFIX, FLAGS_FUNCTION_PREFIX, RELATION_FUNCTION_PREFIX, facetColumn, listTables, readTablePage, selectMatchingIds } from './packem_shared/ADMIN_FUNCTIONS-fMl1vyt1.mjs';
 export { LogBuffer } from './packem_shared/LogBuffer-B_Ezju_N.mjs';
@@ -18,7 +18,7 @@ export { default as NotFoundError } from './packem_shared/NotFoundError-CMuMZt81
 export { armRestore, readBookmark } from './packem_shared/armRestore-BJk53Ro8.mjs';
 export { applySelect, buildSeekWhere, decodeCursor, encodeCursor, normalizeOrderKeys, softDeleteScope } from './packem_shared/applySelect-BvZdFUBT.mjs';
 export { RANK_TIEBREAK, encodePartitionKey, matchesRankStaticWhere, rankTableName, resolveRankPartition, sortColumnName } from './packem_shared/RANK_TIEBREAK-CXhdcA1o.mjs';
-export { ReactiveCache, reactiveCacheKey } from './packem_shared/ReactiveCache-1hDydFyv.mjs';
+export { ReactiveCache, reactiveCacheKey } from './packem_shared/ReactiveCache-BYlSGY0N.mjs';
 export { serveRelationFanout } from './packem_shared/serveRelationFanout-EZLD9-O3.mjs';
 export { DEFAULT_MAX_RELATION_KEYS, assertFlatPredicate, assertShapeShardable, containsRelationPredicate, isRelationPredicate, resolveRelationPredicates } from './packem_shared/DEFAULT_MAX_RELATION_KEYS-DU-Y4-LJ.mjs';
 export { applyOnDelete, fanOutScalarCounts, resolveWith, runRowValidators } from './packem_shared/applyOnDelete-BQ-8ZlZ1.mjs';
@@ -26,7 +26,7 @@ export { RLS_UNWRAP_SYMBOL, RlsRequiredError, guardWriter } from './packem_share
 export { buildFtsMatch, ftsTableName, scoreDocument, stringifySearchText, tokenizeSearch } from './packem_shared/buildFtsMatch-BLEMawrp.mjs';
 export { M as MIN_ADMIN_TOKEN_LENGTH, a as MIN_AUTH_SECRET_LENGTH, b as buildSecurityAudit } from './packem_shared/security-audit-CucgBice.mjs';
 export { SESSION_DO_TTL_DEFAULT, SessionDO } from './packem_shared/SESSION_DO_TTL_DEFAULT-ilPZsVwu.mjs';
-export { ROOT_DO_SIZE_WARN_BYTES, ROOT_SHARD_NAME, ShardDO } from './packem_shared/ROOT_DO_SIZE_WARN_BYTES-DXVOGLBS.mjs';
+export { ROOT_DO_SIZE_WARN_BYTES, ROOT_SHARD_NAME, ShardDO } from './packem_shared/ROOT_DO_SIZE_WARN_BYTES-CEVhBec2.mjs';
 export { SHARD_REGISTRY_DO_NAME, ShardRegistryDO } from './packem_shared/SHARD_REGISTRY_DO_NAME-BsAbi5Mn.mjs';
 export { MAX_SQL_ROWS, assertReadonly, runReadonlySql } from './packem_shared/MAX_SQL_ROWS-dDcFE1YZ.mjs';
 export { createSystemReader } from './packem_shared/createSystemReader-8CzSZP9V.mjs';
@@ -36,5 +36,5 @@ export { compileWhereSql } from './packem_shared/compileWhereSql-CXrhFA3G.mjs';
 export { CDC_LOG_TABLE, applyCdcChanges, readCdcChanges, trimCdcChanges } from './packem_shared/CDC_LOG_TABLE-DSycmnDf.mjs';
 export { backfillAggregateIndexes, backfillRankIndexes } from './packem_shared/backfillAggregateIndexes-BZsOqDXP.mjs';
 export { runShardMigrations } from './packem_shared/runShardMigrations-nIwoQeOK.mjs';
-export { stableStringify } from './packem_shared/stableStringify-CyHKJXre.mjs';
-export { subscriptionListDeltas } from './packem_shared/subscriptionListDeltas-DoB136JT.mjs';
+export { stableStringify } from './packem_shared/stableStringify-MydiuScU.mjs';
+export { s as subscriptionListDeltas } from './packem_shared/subscription-delivery-Z6nXHvQN.mjs';

package/dist/packem_shared/{ROOT_DO_SIZE_WARN_BYTES-DXVOGLBS.mjs → ROOT_DO_SIZE_WARN_BYTES-CEVhBec2.mjs}

@@ -1,4 +1,5 @@
 import { drizzle } from 'drizzle-orm/durable-sqlite';
+import { e as encodeWire, a as awaitWsDrain, t as trySendFrame, d as decodeWire, s as subscriptionListDeltas, b as sendDeltaFrames } from './subscription-delivery-Z6nXHvQN.mjs';
 import { parseExportShardArgs, parseImportShardArgs } from './exportShardRows-DZEhUeyI.mjs';
 import { recordAuthEvent, readAuthMetrics } from './AUTH_METRICS_BUCKETS_TABLE-CiHHYeJi.mjs';
 import { DATA_MIGRATION_STATE_TABLE, readMigrationStatus } from './DATA_MIGRATION_STATE_TABLE-PTtTiQ7U.mjs';
@@ -8,9 +9,8 @@ import { createFanoutCounters, ADMIN_FUNCTION_PREFIX, RELATION_FUNCTION_PREFIX,
 import { LogBuffer } from './LogBuffer-B_Ezju_N.mjs';
 import { recordCapturedMail, clearCapturedMail, readCapturedMail, MAIL_TABLE } from './MAIL_RETENTION-CPpgl-dX.mjs';
 import { readBookmark, armRestore } from './armRestore-BJk53Ro8.mjs';
-import { ReactiveCache, reactiveCacheKey } from './ReactiveCache-1hDydFyv.mjs';
-import { stableStringify } from './stableStringify-CyHKJXre.mjs';
-import { awaitWsDrain, trySendFrame, subscriptionListDeltas, sendDeltaFrames } from './subscriptionListDeltas-DoB136JT.mjs';
+import { ReactiveCache, reactiveCacheKey } from './ReactiveCache-BYlSGY0N.mjs';
+import { stableStringify } from './stableStringify-MydiuScU.mjs';
 import { redact, standardRules } from '@visulima/redact';
 import { i as isDevEnvironment, c as buildSettings, b as buildSecurityAudit } from './security-audit-CucgBice.mjs';
 import { runReadonlySql } from './MAX_SQL_ROWS-dDcFE1YZ.mjs';
@@ -19,6 +19,8 @@ import { e as deleteGlobalShapeSnapshotsForConnection, g as readIdempotent, h as
 import { CDC_LOG_TABLE, readCdcChanges, readCdcCursor, readCdcEpoch, minCdcSeq, bumpCdcEpoch } from './CDC_LOG_TABLE-DSycmnDf.mjs';
 import { a as selectShapeMemberIds, s as selectShapeRows } from './ctx-db-shapes-BQapRFjB.mjs';
 
+const MAX_BATCH_ENTRIES = 500;
+
 const AUDIT_LOG_TABLE = "__lunora_audit__";
 const AUDIT_LOG_RETENTION = 1e3;
 const runSql$2 = (sql, query, ...params) => {
@@ -79,6 +81,38 @@ const readAuditLog = (sql, options = {}) => {
   });
 };
 
+const SHARED_BATCH_HEADERS = [
+  "x-lunora-userid",
+  "x-lunora-identity",
+  "x-d1-bookmark",
+  "x-lunora-client-ip",
+  "x-lunora-system",
+  "x-lunora-shard-binding"
+];
+const buildBatchEntryRequest = (batchRequest, entry) => {
+  const headers = new Headers({ "content-type": "application/json" });
+  for (const name of SHARED_BATCH_HEADERS) {
+    const value = batchRequest.headers.get(name);
+    if (value !== null) {
+      headers.set(name, value);
+    }
+  }
+  if (entry.mutationId !== void 0) {
+    headers.set("x-lunora-mutation-id", entry.mutationId);
+  }
+  if (entry.clientId !== void 0) {
+    headers.set("x-lunora-client-id", entry.clientId);
+  }
+  if (entry.clientSeq !== void 0) {
+    headers.set("x-lunora-client-seq", String(entry.clientSeq));
+  }
+  return new Request("https://shard.internal/rpc", {
+    body: JSON.stringify({ args: entry.args ?? {}, functionPath: entry.functionPath }),
+    headers,
+    method: "POST"
+  });
+};
+
 const QUERY_METRICS_TABLE = "__lunora_metrics_queries";
 const QUERY_METRICS_MAX_SQL_LEN = 512;
 const QUERY_METRICS_MAX_STATEMENTS = 500;
@@ -182,7 +216,7 @@ const diffGlobalMembership = (rows, previous, options) => {
   const rowsPatch = [];
   for (const { doc, id } of rows) {
     const value = projectColumns(doc, columns);
-    const json = JSON.stringify(value);
+    const json = JSON.stringify(encodeWire(value));
     next.set(id, json);
     const before = previous.get(id);
     if (before === void 0) {
@@ -202,10 +236,11 @@ const buildPokeFrames = (parts, meta) => {
   const { baseCheckpoint, checkpoint, epoch, lastMutationId, pokeId } = meta;
   const frames = [JSON.stringify({ baseCheckpoint, epoch, pokeId, type: "pokeStart" })];
   for (const part of parts) {
+    const rowsPatch = part.rowsPatch.map((op) => op.value === void 0 ? op : { ...op, value: encodeWire(op.value) });
     frames.push(
       JSON.stringify({
         pokeId,
-        rowsPatch: part.rowsPatch,
+        rowsPatch,
         shapeId: part.shapeId,
         type: "pokePart",
         ...lastMutationId === void 0 ? {} : { lastMutationId }
@@ -2086,7 +2121,7 @@ class ShardDO {
       if (cached !== void 0) {
         return this.respondFromIdempotencyCache(payload.functionPath, dispatchStartedAt, mutatorClass, cached.value);
       }
-      const result = await this.handleRpc(payload.functionPath, payload.args ?? {});
+      const result = await this.handleRpc(payload.functionPath, decodeWire(payload.args ?? {}));
       this.recordPostDispatchBookkeeping(result, mutatorClass);
       if (mutatorClass?.kind === "next") {
         this.advanceClientMutationWatermark();
@@ -2097,7 +2132,7 @@ class ShardDO {
       const tablesWritten = [...this.pendingChangedTables ?? []];
       this.recordRequestLog(payload.functionPath, payload.args ?? {}, durationMs, "ok", tablesWritten);
       this.maybeWarnRootSize();
-      const response = this.buildDispatchResponse(mutatorClass, result);
+      const response = this.buildDispatchResponse(mutatorClass, encodeWire(result));
       await this.flushChangedTables();
       return response;
     } catch (error) {
@@ -2217,7 +2252,7 @@ class ShardDO {
         ws.send(JSON.stringify({ id: envelope.id, message: "streams must be public", type: "error" }));
         return;
       }
-      this.handleStream(ws, envelope.id, envelope.query.functionPath, envelope.query.args ?? {}).catch(() => {
+      this.handleStream(ws, envelope.id, envelope.query.functionPath, decodeWire(envelope.query.args ?? {})).catch(() => {
       });
       return;
     }
@@ -3031,7 +3066,7 @@ class ShardDO {
     }
     const now = Date.now();
     try {
-      writeIdempotent(this.sql, this.currentRequestUserId ?? "", this.currentRequestMutationId, JSON.stringify(result) ?? "null", now);
+      writeIdempotent(this.sql, this.currentRequestUserId ?? "", this.currentRequestMutationId, JSON.stringify(encodeWire(result)), now);
       if (now - this.lastIdempotencyTrimAt > IDEMPOTENCY_GC_INTERVAL_MS) {
         trimIdempotent(this.sql, now - IDEMPOTENCY_RETENTION_MS);
         this.lastIdempotencyTrimAt = now;
@@ -3887,11 +3922,74 @@ class ShardDO {
     if (error && typeof error === "object" && error.name === "LunoraError") {
       const lunoraError = error;
       const status = typeof lunoraError.status === "number" ? lunoraError.status : 500;
-      return jsonResponse({ error: { code: lunoraError.code ?? "INTERNAL", message: lunoraError.message ?? "internal error" } }, status);
+      const body = {
+        code: lunoraError.code ?? "INTERNAL",
+        message: lunoraError.message ?? "internal error"
+      };
+      if (lunoraError.data !== void 0) {
+        body.data = encodeWire(lunoraError.data);
+      }
+      return jsonResponse({ error: body }, status);
     }
     console.error("[@lunora/do] unhandled RPC error:", error);
     return jsonResponse({ error: { code: "RPC_FAILED", message: "internal error" } }, 500);
   }
+  /**
+   * Batch dispatch (plan 088). Applies each `calls[]` entry through the SAME
+   * single-call `/rpc` path (via a nested `this.fetch`), **sequentially**, so
+   * the per-`(identity, mutationId)` idempotency dedup and the per-client
+   * `__client_watermark` ordering are enforced entry-by-entry exactly as for an
+   * individual call — no duplication of the dispatch core, no reordering.
+   *
+   * Failures are **per-slot, not fail-fast**: an entry that throws (or a
+   * custom-mutator `OUT_OF_ORDER` gap) is captured in its own result slot and
+   * later entries still run. Ordering is still safe — a later same-client
+   * mutator after a gap re-classifies as a gap too (the watermark never
+   * advanced), so it cannot apply out of order; unrelated entries/queries are
+   * independent. The response is `{ results: [{ id, status, body }] }` in
+   * request order; each `body` is the untouched single-call envelope (its
+   * `result` already wire-encoded), so the client demuxes + decodes each
+   * exactly as one call.
+   */
+  async handleBatchRpc(request) {
+    let payload;
+    try {
+      payload = await request.json();
+    } catch {
+      return jsonResponse({ error: { code: "BAD_REQUEST", message: "invalid JSON body" } }, 400);
+    }
+    if (!Array.isArray(payload.calls)) {
+      return jsonResponse({ error: { code: "BAD_REQUEST", message: "batch `calls` must be an array" } }, 400);
+    }
+    if (payload.calls.length > MAX_BATCH_ENTRIES) {
+      return jsonResponse({ error: { code: "BAD_REQUEST", message: `batch exceeds the ${String(MAX_BATCH_ENTRIES)}-call limit` } }, 400);
+    }
+    const results = [];
+    let latestBookmark;
+    for (const raw of payload.calls) {
+      const outcome = await this.dispatchBatchEntry(request, raw);
+      if (outcome.bookmark !== void 0) {
+        latestBookmark = outcome.bookmark;
+      }
+      results.push({ body: outcome.body, id: outcome.id, status: outcome.status });
+    }
+    return jsonResponse({ results }, 200, latestBookmark);
+  }
+  /** Dispatch one batch entry through the single-call `/rpc` path and capture its envelope (plan 088). */
+  async dispatchBatchEntry(batchRequest, entry) {
+    try {
+      const response = await this.fetch(buildBatchEntryRequest(batchRequest, entry));
+      return { body: await response.json(), bookmark: response.headers.get("x-d1-bookmark") ?? void 0, id: entry.id, status: response.status };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        body: { error: { code: "BATCH_ENTRY_FAILED", message } },
+        bookmark: void 0,
+        id: entry?.id,
+        status: 500
+      };
+    }
+  }
   /**
    * Serve a reserved admin-introspection RPC (`__lunora_admin__:*`) for the
    * data browser. Gated by `env.LUNORA_ADMIN_TOKEN`: introspection is
@@ -4841,7 +4939,7 @@ class ShardDO {
           break;
         }
         await awaitWsDrain(ws);
-        ws.send(JSON.stringify({ data: chunk, id, type: "chunk" }));
+        ws.send(JSON.stringify({ data: encodeWire(chunk), id, type: "chunk" }));
       }
       if (!controller.signal.aborted) {
         ws.send(JSON.stringify({ id, type: "complete" }));
@@ -5634,7 +5732,7 @@ class ShardDO {
       memos = /* @__PURE__ */ new Map();
       this.subMemos.set(ws, memos);
     }
-    memos.set(subId, { lastJson: JSON.stringify(outcome.result ?? null), tables: outcome.tables });
+    memos.set(subId, { lastJson: JSON.stringify(encodeWire(outcome.result ?? null)), tables: outcome.tables });
   }
   /**
    * Memoise `outcome` for `(ws, subId)` and push it to the socket, unless an
@@ -5661,7 +5759,7 @@ class ShardDO {
       this.subMemos.set(ws, memos);
     }
     const cursorSuffix = cdcSuffix(cursor, epoch);
-    const json = JSON.stringify(outcome.result ?? null);
+    const json = JSON.stringify(encodeWire(outcome.result ?? null));
     const existing = memos.get(subId);
     if (existing?.lastJson === json) {
       existing.tables = outcome.tables;
@@ -5778,6 +5876,9 @@ class ShardDO {
     if (url.pathname === "/_lunora/route" && request.method === "GET") {
       return jsonResponse({ relayCount: this.relay?.relayCount() ?? 0 });
     }
+    if (url.pathname === "/rpc-batch" && request.method === "POST") {
+      return this.handleBatchRpc(request);
+    }
     if (request.headers.get("Upgrade") === "websocket") {
       return this.handleWebSocketUpgrade(request);
     }

package/dist/packem_shared/{ReactiveCache-1hDydFyv.mjs → ReactiveCache-BYlSGY0N.mjs}

@@ -1,4 +1,4 @@
-import { stableStringify } from './stableStringify-CyHKJXre.mjs';
+import { stableStringify } from './stableStringify-MydiuScU.mjs';
 import { depKey, SCAN_DEP } from './SCAN_DEP-DLJF8dsj.mjs';
 
 const DEFAULT_MAX_ENTRIES = 1e3;

package/dist/packem_shared/{diffExternalSource-Br2GYVZB.mjs → diffExternalSource-Cx9HUPJj.mjs}

@@ -1,4 +1,4 @@
-import { stableStringify } from './stableStringify-CyHKJXre.mjs';
+import { stableStringify } from './stableStringify-MydiuScU.mjs';
 
 const projectExternalSourceRow = (row, columns) => {
   const projected = { _id: row._id };

package/dist/packem_shared/{isSourceDue-D_wTv871.mjs → isSourceDue-BMTJv65e.mjs}

@@ -1,4 +1,4 @@
-import { runExternalSourceTick } from './materializeExternalRows-CcsfmiDe.mjs';
+import { runExternalSourceTick } from './materializeExternalRows-uKBx9H0s.mjs';
 
 const liftSourceId = (row, options = {}) => {
   const { idColumn = "id", map } = options;

package/dist/packem_shared/{materializeExternalRows-CcsfmiDe.mjs → materializeExternalRows-uKBx9H0s.mjs}

@@ -1,7 +1,7 @@
 import { applyCdcChanges } from './CDC_LOG_TABLE-DSycmnDf.mjs';
 import { s as selectShapeRows } from './ctx-db-shapes-BQapRFjB.mjs';
-import { diffExternalSource, projectExternalSourceRow } from './diffExternalSource-Br2GYVZB.mjs';
-import { stableStringify } from './stableStringify-CyHKJXre.mjs';
+import { diffExternalSource, projectExternalSourceRow } from './diffExternalSource-Cx9HUPJj.mjs';
+import { stableStringify } from './stableStringify-MydiuScU.mjs';
 
 const materializeExternalRows = async (writer, pulled, baseline, options) => {
   const { changes, nextBaseline } = diffExternalSource(pulled, baseline, options);

package/dist/packem_shared/{stableStringify-CyHKJXre.mjs → stableStringify-MydiuScU.mjs}

@@ -8,12 +8,22 @@ const stableStringify = (value) => {
   if (value === void 0) {
     return "null";
   }
+  if (typeof value === "bigint") {
+    throw new TypeError("stableStringify: cannot use a bigint in a cache key (query/subscription/shape args) — pass it as a string");
+  }
   if (value === null || typeof value !== "object") {
     return JSON.stringify(value);
   }
   if (Array.isArray(value)) {
     return `[${value.map((item) => stableStringify(item)).join(",")}]`;
   }
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== null && proto !== Object.prototype) {
+    const name = value.constructor?.name ?? "value";
+    throw new TypeError(
+      `stableStringify: cannot use a ${name} in a cache key (query/subscription/shape args) — only plain objects, arrays, and JSON primitives are supported`
+    );
+  }
   const record = value;
   const keys = Object.keys(record).toSorted(compareKeys);
   const parts = [];

package/dist/packem_shared/subscription-delivery-Z6nXHvQN.mjs

@@ -0,0 +1,340 @@
+const TAG = "$lunora.wire$";
+const MAX_DEPTH = 64;
+const MAX_BIGINT_DIGITS = 1024;
+const UNSAFE_KEY = "__proto__";
+const TYPED_ARRAY_CTORS = {
+  BigInt64Array,
+  BigUint64Array,
+  Float32Array,
+  Float64Array,
+  Int8Array,
+  Int16Array,
+  Int32Array,
+  Uint8Array,
+  Uint8ClampedArray,
+  Uint16Array,
+  Uint32Array
+};
+const ERROR_CTORS = {
+  Error,
+  EvalError,
+  RangeError,
+  ReferenceError,
+  SyntaxError,
+  TypeError,
+  URIError
+};
+const toBase64 = (bytes) => {
+  let binary = "";
+  const chunk = 32768;
+  for (let index = 0; index < bytes.length; index += chunk) {
+    binary += String.fromCharCode(...bytes.subarray(index, index + chunk));
+  }
+  return btoa(binary);
+};
+const fromBase64 = (base64) => {
+  const binary = atob(base64);
+  const bytes = new Uint8Array(binary.length);
+  for (let index = 0; index < binary.length; index += 1) {
+    bytes[index] = binary.codePointAt(index) ?? 0;
+  }
+  return bytes;
+};
+const encodeWire = (value, depth = 0) => {
+  if (depth > MAX_DEPTH) {
+    throw new RangeError(`wire-codec: value nesting exceeds the ${MAX_DEPTH}-level limit`);
+  }
+  if (value === void 0) {
+    return [TAG, "undefined"];
+  }
+  if (value === null) {
+    return null;
+  }
+  const kind = typeof value;
+  if (kind === "bigint") {
+    return [TAG, "bigint", value.toString()];
+  }
+  if (kind === "number") {
+    const numeric = value;
+    if (Number.isNaN(numeric)) {
+      return [TAG, "nan"];
+    }
+    if (numeric === Infinity) {
+      return [TAG, "inf"];
+    }
+    if (numeric === -Infinity) {
+      return [TAG, "-inf"];
+    }
+    return numeric;
+  }
+  if (kind !== "object") {
+    return value;
+  }
+  if (value instanceof Date) {
+    return [TAG, "date", encodeWire(value.getTime(), depth + 1)];
+  }
+  if (value instanceof Error) {
+    const error = value;
+    const properties = {};
+    for (const key of Object.keys(error)) {
+      if (error[key] !== void 0) {
+        properties[key] = encodeWire(error[key], depth + 1);
+      }
+    }
+    const encodedError = [TAG, "error", error.name, error.message, properties];
+    if (error.cause !== void 0) {
+      encodedError.push(encodeWire(error.cause, depth + 1));
+    }
+    return encodedError;
+  }
+  if (value instanceof URL) {
+    return [TAG, "url", value.href];
+  }
+  if (value instanceof Map) {
+    return [TAG, "map", [...value.entries()].map(([k, v]) => [encodeWire(k, depth + 1), encodeWire(v, depth + 1)])];
+  }
+  if (value instanceof Set) {
+    return [TAG, "set", [...value].map((item) => encodeWire(item, depth + 1))];
+  }
+  if (value instanceof ArrayBuffer) {
+    return [TAG, "bytes", toBase64(new Uint8Array(value)), "ArrayBuffer"];
+  }
+  if (ArrayBuffer.isView(value)) {
+    const view = value;
+    const ctorName = view.constructor.name;
+    const bytes = new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
+    return ctorName === "Uint8Array" ? [TAG, "bytes", toBase64(bytes)] : [TAG, "bytes", toBase64(bytes), ctorName];
+  }
+  if (Array.isArray(value)) {
+    const encoded = value.map((item) => encodeWire(item, depth + 1));
+    return encoded.length > 0 && encoded[0] === TAG ? [TAG, "arr", encoded] : encoded;
+  }
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== null && proto !== Object.prototype) {
+    const name = value.constructor?.name ?? "value";
+    throw new TypeError(
+      `wire-codec: cannot encode a ${name} over the Lunora wire — only plain objects, arrays, and the supported built-ins (Date, Error, URL, Map, Set, ArrayBuffer/typed arrays, bigint) round-trip`
+    );
+  }
+  const source = value;
+  const result = {};
+  for (const key of Object.keys(source)) {
+    const field = source[key];
+    if (field !== void 0) {
+      result[key] = encodeWire(field, depth + 1);
+    }
+  }
+  return result;
+};
+const decodeWire = (value, depth = 0) => {
+  if (depth > MAX_DEPTH) {
+    throw new RangeError(`wire-codec: value nesting exceeds the ${MAX_DEPTH}-level limit`);
+  }
+  if (value === null || typeof value !== "object") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    if (value[0] === TAG) {
+      const tag = value[1];
+      switch (tag) {
+        case "-inf": {
+          return -Infinity;
+        }
+        case "arr": {
+          return value[2].map((item) => decodeWire(item, depth + 1));
+        }
+        case "bigint": {
+          const raw = value[2];
+          if (typeof raw !== "string" || raw.length > MAX_BIGINT_DIGITS || !/^-?\d+$/.test(raw)) {
+            throw new RangeError(`wire-codec: invalid or over-long bigint (max ${MAX_BIGINT_DIGITS} digits)`);
+          }
+          return BigInt(raw);
+        }
+        case "date": {
+          return new Date(decodeWire(value[2], depth + 1));
+        }
+        case "map": {
+          return new Map(value[2].map(([k, v]) => [decodeWire(k, depth + 1), decodeWire(v, depth + 1)]));
+        }
+        case "set": {
+          return new Set(value[2].map((item) => decodeWire(item, depth + 1)));
+        }
+        case "url": {
+          return new URL(value[2]);
+        }
+        case "error": {
+          const name = value[2];
+          const message = value[3];
+          const Ctor = (Object.hasOwn(ERROR_CTORS, name) ? ERROR_CTORS[name] : void 0) ?? Error;
+          const error = new Ctor(message);
+          if (error.name !== name) {
+            Object.defineProperty(error, "name", { configurable: true, value: name, writable: true });
+          }
+          Object.assign(error, decodeWire(value[4], depth + 1));
+          if (value.length > 5) {
+            Object.defineProperty(error, "cause", { configurable: true, value: decodeWire(value[5], depth + 1), writable: true });
+          }
+          return error;
+        }
+        case "bytes": {
+          const bytes = fromBase64(value[2]);
+          const ctorName = value[3] ?? "Uint8Array";
+          if (ctorName === "ArrayBuffer") {
+            return bytes.buffer.byteLength === bytes.byteLength ? bytes.buffer : bytes.slice().buffer;
+          }
+          const Ctor = Object.hasOwn(TYPED_ARRAY_CTORS, ctorName) ? TYPED_ARRAY_CTORS[ctorName] : void 0;
+          return Ctor ? new Ctor(bytes.slice().buffer) : bytes;
+        }
+        case "inf": {
+          return Infinity;
+        }
+        case "nan": {
+          return Number.NaN;
+        }
+        case "undefined": {
+          return void 0;
+        }
+        default: {
+          return value.map((item) => decodeWire(item, depth + 1));
+        }
+      }
+    }
+    return value.map((item) => decodeWire(item, depth + 1));
+  }
+  const source = value;
+  const result = {};
+  for (const key of Object.keys(source)) {
+    const decoded = decodeWire(source[key], depth + 1);
+    if (key === UNSAFE_KEY) {
+      Object.defineProperty(result, key, { configurable: true, enumerable: true, value: decoded, writable: true });
+    } else {
+      result[key] = decoded;
+    }
+  }
+  return result;
+};
+
+const ROW_ID_FIELD = "_id";
+const DELTA_FALLBACK_TABLE = "__lunora__";
+const readRowId = (row) => {
+  if (typeof row !== "object" || row === null || Array.isArray(row)) {
+    return void 0;
+  }
+  const id = row[ROW_ID_FIELD];
+  return typeof id === "string" ? id : void 0;
+};
+const indexRowsById = (rows) => {
+  const byId = /* @__PURE__ */ new Map();
+  const order = [];
+  for (const row of rows) {
+    const id = readRowId(row);
+    if (id === void 0 || byId.has(id)) {
+      return void 0;
+    }
+    byId.set(id, row);
+    order.push(id);
+  }
+  return { byId, order };
+};
+const survivorsKeepOrder = (previous, next) => {
+  const survivingPrevious = previous.order.filter((id) => next.byId.has(id));
+  const survivingNext = next.order.filter((id) => previous.byId.has(id));
+  if (survivingPrevious.length !== survivingNext.length) {
+    return false;
+  }
+  return survivingPrevious.every((id, index) => survivingNext[index] === id);
+};
+const collectDeleteDeltas = (previous, next, deltaTable, tableJson) => {
+  const out = [];
+  for (const id of previous.order) {
+    if (!next.byId.has(id)) {
+      out.push({
+        delta: { key: id, op: "delete", table: deltaTable },
+        frame: `{"key":${JSON.stringify(id)},"op":"delete","table":${tableJson}}`
+      });
+    }
+  }
+  return out;
+};
+const collectUpsertDeltas = (previous, next, deltaTable, tableJson) => {
+  const out = [];
+  for (const id of next.order) {
+    const nextRow = next.byId.get(id);
+    const previousRow = previous.byId.get(id);
+    const nextFingerprint = JSON.stringify(encodeWire(nextRow));
+    const previousFingerprint = previousRow === void 0 ? void 0 : JSON.stringify(previousRow);
+    if (previousFingerprint === nextFingerprint) {
+      continue;
+    }
+    const op = previousFingerprint === void 0 ? "insert" : "update";
+    out.push({
+      delta: { key: id, op, row: nextRow, table: deltaTable },
+      frame: `{"key":${JSON.stringify(id)},"op":"${op}","row":${nextFingerprint},"table":${tableJson}}`
+    });
+  }
+  return out;
+};
+const subscriptionListDeltas = (previousJson, nextResult, table, frames) => {
+  let parsed;
+  try {
+    parsed = JSON.parse(previousJson);
+  } catch {
+    return void 0;
+  }
+  if (!Array.isArray(parsed) || !Array.isArray(nextResult)) {
+    return void 0;
+  }
+  const previous = indexRowsById(parsed);
+  const next = indexRowsById(nextResult);
+  if (previous === void 0 || next === void 0) {
+    return void 0;
+  }
+  if (!survivorsKeepOrder(previous, next)) {
+    return void 0;
+  }
+  const deltaTable = table === "" ? DELTA_FALLBACK_TABLE : table;
+  const tableJson = JSON.stringify(deltaTable);
+  const framed = [...collectDeleteDeltas(previous, next, deltaTable, tableJson), ...collectUpsertDeltas(previous, next, deltaTable, tableJson)];
+  if (framed.length > next.order.length) {
+    return void 0;
+  }
+  if (frames !== void 0) {
+    for (const { frame } of framed) {
+      frames.push(frame);
+    }
+  }
+  return framed.map(({ delta }) => delta);
+};
+const trySendFrame = (ws, frame) => {
+  try {
+    ws.send(frame);
+    return true;
+  } catch {
+    return false;
+  }
+};
+const sendDeltaFrames = (ws, subId, deltaFrames, cursorSuffix) => {
+  const idJson = JSON.stringify(subId);
+  let delivered = true;
+  for (const deltaBody of deltaFrames) {
+    if (!trySendFrame(ws, `{"type":"delta","id":${idJson},"delta":${deltaBody}${cursorSuffix}}`)) {
+      delivered = false;
+    }
+  }
+  return delivered;
+};
+const awaitWsDrain = async (ws) => {
+  let attempts = 0;
+  while (attempts < 100) {
+    attempts += 1;
+    const buffered = ws.bufferedAmount;
+    if (typeof buffered !== "number" || buffered < 1048576) {
+      return;
+    }
+    await new Promise((resolve) => {
+      setTimeout(resolve, 20);
+    });
+  }
+};
+
+export { awaitWsDrain as a, sendDeltaFrames as b, decodeWire as d, encodeWire as e, subscriptionListDeltas as s, trySendFrame as t };

package/dist/packem_shared/subscriptionListDeltas-CXwfoEE_.mjs

@@ -0,0 +1 @@
+export { a as awaitWsDrain, b as sendDeltaFrames, s as subscriptionListDeltas, t as trySendFrame } from './subscription-delivery-Z6nXHvQN.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/do",
-  "version": "1.0.0-alpha.14",
+  "version": "1.0.0-alpha.15",
   "description": "Lunora Durable Objects: ShardDO (SQLite, OCC, hibernated WebSocket subscriptions) and SessionDO",
   "keywords": [
     "cloudflare",

package/dist/packem_shared/subscriptionListDeltas-DoB136JT.mjs

@@ -1,124 +0,0 @@
-const ROW_ID_FIELD = "_id";
-const DELTA_FALLBACK_TABLE = "__lunora__";
-const readRowId = (row) => {
-  if (typeof row !== "object" || row === null || Array.isArray(row)) {
-    return void 0;
-  }
-  const id = row[ROW_ID_FIELD];
-  return typeof id === "string" ? id : void 0;
-};
-const indexRowsById = (rows) => {
-  const byId = /* @__PURE__ */ new Map();
-  const order = [];
-  for (const row of rows) {
-    const id = readRowId(row);
-    if (id === void 0 || byId.has(id)) {
-      return void 0;
-    }
-    byId.set(id, row);
-    order.push(id);
-  }
-  return { byId, order };
-};
-const survivorsKeepOrder = (previous, next) => {
-  const survivingPrevious = previous.order.filter((id) => next.byId.has(id));
-  const survivingNext = next.order.filter((id) => previous.byId.has(id));
-  if (survivingPrevious.length !== survivingNext.length) {
-    return false;
-  }
-  return survivingPrevious.every((id, index) => survivingNext[index] === id);
-};
-const collectDeleteDeltas = (previous, next, deltaTable, tableJson) => {
-  const out = [];
-  for (const id of previous.order) {
-    if (!next.byId.has(id)) {
-      out.push({
-        delta: { key: id, op: "delete", table: deltaTable },
-        frame: `{"key":${JSON.stringify(id)},"op":"delete","table":${tableJson}}`
-      });
-    }
-  }
-  return out;
-};
-const collectUpsertDeltas = (previous, next, deltaTable, tableJson) => {
-  const out = [];
-  for (const id of next.order) {
-    const nextRow = next.byId.get(id);
-    const previousRow = previous.byId.get(id);
-    const nextFingerprint = JSON.stringify(nextRow);
-    const previousFingerprint = previousRow === void 0 ? void 0 : JSON.stringify(previousRow);
-    if (previousFingerprint === nextFingerprint) {
-      continue;
-    }
-    const op = previousFingerprint === void 0 ? "insert" : "update";
-    out.push({
-      delta: { key: id, op, row: nextRow, table: deltaTable },
-      frame: `{"key":${JSON.stringify(id)},"op":"${op}","row":${nextFingerprint},"table":${tableJson}}`
-    });
-  }
-  return out;
-};
-const subscriptionListDeltas = (previousJson, nextResult, table, frames) => {
-  let parsed;
-  try {
-    parsed = JSON.parse(previousJson);
-  } catch {
-    return void 0;
-  }
-  if (!Array.isArray(parsed) || !Array.isArray(nextResult)) {
-    return void 0;
-  }
-  const previous = indexRowsById(parsed);
-  const next = indexRowsById(nextResult);
-  if (previous === void 0 || next === void 0) {
-    return void 0;
-  }
-  if (!survivorsKeepOrder(previous, next)) {
-    return void 0;
-  }
-  const deltaTable = table === "" ? DELTA_FALLBACK_TABLE : table;
-  const tableJson = JSON.stringify(deltaTable);
-  const framed = [...collectDeleteDeltas(previous, next, deltaTable, tableJson), ...collectUpsertDeltas(previous, next, deltaTable, tableJson)];
-  if (framed.length > next.order.length) {
-    return void 0;
-  }
-  if (frames !== void 0) {
-    for (const { frame } of framed) {
-      frames.push(frame);
-    }
-  }
-  return framed.map(({ delta }) => delta);
-};
-const trySendFrame = (ws, frame) => {
-  try {
-    ws.send(frame);
-    return true;
-  } catch {
-    return false;
-  }
-};
-const sendDeltaFrames = (ws, subId, deltaFrames, cursorSuffix) => {
-  const idJson = JSON.stringify(subId);
-  let delivered = true;
-  for (const deltaBody of deltaFrames) {
-    if (!trySendFrame(ws, `{"type":"delta","id":${idJson},"delta":${deltaBody}${cursorSuffix}}`)) {
-      delivered = false;
-    }
-  }
-  return delivered;
-};
-const awaitWsDrain = async (ws) => {
-  let attempts = 0;
-  while (attempts < 100) {
-    attempts += 1;
-    const buffered = ws.bufferedAmount;
-    if (typeof buffered !== "number" || buffered < 1048576) {
-      return;
-    }
-    await new Promise((resolve) => {
-      setTimeout(resolve, 20);
-    });
-  }
-};
-
-export { awaitWsDrain, sendDeltaFrames, subscriptionListDeltas, trySendFrame };