@rotorsoft/act-http 1.10.24 → 1.11.1

package/dist/@types/api/errors.d.ts

@@ -5,7 +5,7 @@
  * error parsers.
  *
  * - `error` — the framework error name (`"ValidationError"`,
- *   `"InvariantError"`, …). Stable identifier, safe to switch on.
+ *   `"PreconditionError"`, …). Stable identifier, safe to switch on.
  * - `detail` — the framework's message text. Human-readable; not
  *   parsed by clients.
  * - `code` — a machine-readable status code from {@link ERROR_MAP}
@@ -38,6 +38,11 @@ export declare const ERROR_MAP: {
         readonly status: 422;
         readonly code: "VALIDATION";
     };
+    readonly PreconditionError: {
+        readonly status: 409;
+        readonly code: "PRECONDITION";
+    };
+    /** @deprecated Thrown only by the deprecated `.given` rules. Removed in 2.0. */
     readonly InvariantError: {
         readonly status: 409;
         readonly code: "INVARIANT";

package/dist/@types/api/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/api/errors.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;;iBACD,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,YAAY;;;iBAChC,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,WAAW;;;iBAC5B,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,aAAa;;;iBAC/B,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,eAAe;;;iBAClC,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,eAAe;;CACP,CAAC;AAanD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAuB3E"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/api/errors.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;;iBACD,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,YAAY;;;iBAC7B,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,cAAc;;IACtD,gFAAgF;;iBAC9D,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,WAAW;;;iBAC5B,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,aAAa;;;iBAC/B,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,eAAe;;;iBAClC,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,eAAe;;CACP,CAAC;AAenD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAuB3E"}

package/dist/@types/sse/broadcast.d.ts

@@ -1,15 +1,46 @@
 import { StateCache } from "./state-cache.js";
 import { type BroadcastState, type PatchMessage, type Subscriber } from "./types.js";
+/**
+ * Server-side broadcast channel for incremental state sync over SSE.
+ *
+ * Manages per-stream subscriber sets and an LRU state cache. When state
+ * changes, forwards domain patches (from event handlers) to all subscribers
+ * as version-keyed messages.
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * const broadcast = new BroadcastChannel<MyState>();
+ *
+ * // After every app.do():
+ * const snaps = await app.do(...);
+ * const patches = snaps.map(s => s.patch).filter(Boolean);
+ * const state = deriveState(snaps.at(-1));
+ * broadcast.publish(streamId, state, patches);
+ *
+ * // In SSE subscription:
+ * const cleanup = broadcast.subscribe(streamId, (msg) => {
+ *   pending = msg;
+ *   resolve?.();
+ * });
+ *
+ * // Initial state for reconnects:
+ * const cached = broadcast.state(streamId);
+ * ```
+ *
+ * ## Version Contract
+ *
+ * The `_v` field on state MUST be set from `snap.event.version` (the event
+ * store's monotonic stream version) BEFORE calling `publish()`. This is the
+ * single source of truth for ordering — no separate version counters.
+ */
 export declare class BroadcastChannel<S extends BroadcastState = BroadcastState> {
     private channels;
     private state_cache;
-    /**
-     * @param options.cacheSize - Max number of stream states kept in the LRU
-     * cache (default 50).
-     */
     private on_subscriber_error;
     private on_overlay_miss;
     constructor(options?: {
+        /** Max number of stream states kept in the LRU cache (default 50). */
         cacheSize?: number;
         /**
          * Called when overlay-contributed state is lost, on either of the two

package/dist/@types/sse/broadcast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../../src/sse/broadcast.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EAEjB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AA4KpB,qBAAa,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc;IACrE,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,WAAW,CAAgB;IAEnC;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,eAAe,CAA6B;IAEpD,YAAY,OAAO,CAAC,EAAE;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB;;;;;;;;;;;;;;WAcG;QACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QAC3C;;;;;WAKG;QACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QAC/D;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,EAQA;IAED;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAKtB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;;;;OAOG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,CAAC,EACR,OAAO,GAAE,OAAO,CAAC,CAAC,CAAC,EAAO,GACzB,YAAY,CAAC,CAAC,CAAC,CAwCjB;IAED;;;;OAIG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CA6C7B;IAED;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CASzD;IAED,kDAAkD;IAClD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExC;IAED,8EAA8E;IAC9E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAErC;IAED,4DAA4D;IAC5D,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAE7B;IAED,oEAAoE;IACpE,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7C;IAED,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAEzC;IAED,+EAA+E;IAC/E,IAAI,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,CAEzB;CACF"}
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../../src/sse/broadcast.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EAEjB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AA0IpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc;IACrE,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,eAAe,CAA6B;IAEpD,YAAY,OAAO,CAAC,EAAE;QACpB,sEAAsE;QACtE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB;;;;;;;;;;;;;;WAcG;QACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QAC3C;;;;;WAKG;QACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QAC/D;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,EAQA;IAED;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAKtB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;;;;OAOG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,CAAC,EACR,OAAO,GAAE,OAAO,CAAC,CAAC,CAAC,EAAO,GACzB,YAAY,CAAC,CAAC,CAAC,CAwCjB;IAED;;;;OAIG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CA6C7B;IAED;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CASzD;IAED,kDAAkD;IAClD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExC;IAED,8EAA8E;IAC9E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAErC;IAED,4DAA4D;IAC5D,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAE7B;IAED,oEAAoE;IACpE,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7C;IAED,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAEzC;IAED,+EAA+E;IAC/E,IAAI,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,CAEzB;CACF"}

package/dist/api/index.cjs

@@ -37,6 +37,8 @@ module.exports = __toCommonJS(api_exports);
 var import_act = require("@rotorsoft/act");
 var ERROR_MAP = {
   ValidationError: { status: 422, code: "VALIDATION" },
+  PreconditionError: { status: 409, code: "PRECONDITION" },
+  /** @deprecated Thrown only by the deprecated `.given` rules. Removed in 2.0. */
   InvariantError: { status: 409, code: "INVARIANT" },
   ConcurrencyError: { status: 412, code: "CONCURRENCY" },
   StreamClosedError: { status: 410, code: "STREAM_CLOSED" },
@@ -44,6 +46,7 @@ var ERROR_MAP = {
 };
 var lookup_known = (err) => {
   if (err instanceof import_act.ValidationError) return { name: "ValidationError" };
+  if (err instanceof import_act.PreconditionError) return { name: "PreconditionError" };
   if (err instanceof import_act.InvariantError) return { name: "InvariantError" };
   if (err instanceof import_act.ConcurrencyError) return { name: "ConcurrencyError" };
   if (err instanceof import_act.StreamClosedError) return { name: "StreamClosedError" };