@moltzap/client 2026.414.0 → 2026.425.0

package/dist/runtime/frame.test.js

@@ -0,0 +1,32 @@
+import { Effect } from "effect";
+import { describe, expect, it } from "vitest";
+import { decodeFrames } from "./frame.js";
+describe("decodeFrames", () => {
+    it("decodes padded chunks that contain both an event and a response", async () => {
+        const raw = JSON.stringify({
+            jsonrpc: "2.0",
+            type: "event",
+            event: "messages/received",
+            data: { message: { id: "m-1", conversationId: "c-1" } },
+        }) +
+            "\u0000\n" +
+            JSON.stringify({
+                jsonrpc: "2.0",
+                type: "response",
+                id: "rpc-7",
+                result: { ok: true },
+            });
+        const decoded = await Effect.runPromise(decodeFrames(raw));
+        expect(decoded).toHaveLength(2);
+        expect(decoded[0]).toMatchObject({
+            _tag: "Event",
+            frame: { event: "messages/received" },
+        });
+        expect(decoded[1]).toMatchObject({
+            _tag: "Response",
+            id: "rpc-7",
+            result: { ok: true },
+        });
+    });
+});
+//# sourceMappingURL=frame.test.js.map

package/dist/runtime/frame.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.test.js","sourceRoot":"","sources":["../../src/runtime/frame.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,GAAG,GACP,IAAI,CAAC,SAAS,CAAC;YACb,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,mBAAmB;YAC1B,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE;SACxD,CAAC;YACF,UAAU;YACV,IAAI,CAAC,SAAS,CAAC;gBACb,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,UAAU;gBAChB,EAAE,EAAE,OAAO;gBACX,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;aACrB,CAAC,CAAC;QAEL,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QAE3D,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC/B,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE;SACtC,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC/B,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,OAAO;YACX,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,3 @@
+export { AgentNotFoundError, NotConnectedError, RpcTimeoutError, RpcServerError, MalformedFrameError, } from "./errors.js";
+export { snapshot, getOr } from "./refs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,3 @@
+export { AgentNotFoundError, NotConnectedError, RpcTimeoutError, RpcServerError, MalformedFrameError, } from "./errors.js";
+export { snapshot, getOr } from "./refs.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC"}

package/dist/runtime/refs.d.ts

@@ -0,0 +1,10 @@
+import { HashMap, Ref } from "effect";
+/**
+ * Read a `Ref` synchronously outside an Effect scope. Only safe for `Ref`s
+ * that never fiber-park (the stock `Ref.Ref<A>` never does). Use from
+ * object methods or sync code paths that hold a `Ref` set up at construction.
+ */
+export declare const snapshot: <A>(ref: Ref.Ref<A>) => A;
+/** Lookup `key` in `m`, falling back to `dflt()` if absent. Lazy default. */
+export declare const getOr: <K, V>(m: HashMap.HashMap<K, V>, key: K, dflt: () => V) => V;
+//# sourceMappingURL=refs.d.ts.map

package/dist/runtime/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/runtime/refs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,OAAO,EAAU,GAAG,EAAE,MAAM,QAAQ,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAG,CAAiC,CAAC;AAEhF,6EAA6E;AAC7E,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EACxB,KAAK,CAAC,EACN,MAAM,MAAM,CAAC,KACZ,CAAgD,CAAC"}

package/dist/runtime/refs.js

@@ -0,0 +1,10 @@
+import { Effect, HashMap, Option, Ref } from "effect";
+/**
+ * Read a `Ref` synchronously outside an Effect scope. Only safe for `Ref`s
+ * that never fiber-park (the stock `Ref.Ref<A>` never does). Use from
+ * object methods or sync code paths that hold a `Ref` set up at construction.
+ */
+export const snapshot = (ref) => Effect.runSync(Ref.get(ref));
+/** Lookup `key` in `m`, falling back to `dflt()` if absent. Lazy default. */
+export const getOr = (m, key, dflt) => Option.getOrElse(HashMap.get(m, key), dflt);
+//# sourceMappingURL=refs.js.map

package/dist/runtime/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/runtime/refs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAI,GAAe,EAAK,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,CAAwB,EACxB,GAAM,EACN,IAAa,EACV,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC"}

package/dist/runtime/runtime.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.test.d.ts.map

package/dist/runtime/runtime.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.test.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.test.ts"],"names":[],"mappings":""}

package/dist/runtime/runtime.test.js

@@ -0,0 +1,29 @@
+import { it } from "@effect/vitest";
+import { Effect, Exit } from "effect";
+import { expect } from "vitest";
+import { NotConnectedError, RpcServerError, RpcTimeoutError, } from "./errors.js";
+it.effect("tagged errors discriminate by _tag", () => Effect.gen(function* () {
+    const exit = yield* Effect.exit(Effect.fail(new RpcTimeoutError({ method: "messages/send", timeoutMs: 30_000 })));
+    if (Exit.isFailure(exit) && exit.cause._tag === "Fail") {
+        const err = exit.cause.error;
+        expect(err._tag).toBe("RpcTimeoutError");
+        expect(err.method).toBe("messages/send");
+    }
+    else {
+        throw new Error("expected failure");
+    }
+}));
+it.effect("RpcServerError preserves wire fields", () => Effect.gen(function* () {
+    const err = new RpcServerError({
+        code: -32002,
+        message: "Not found",
+    });
+    expect(err.code).toBe(-32002);
+    expect(err.message).toBe("Not found");
+    expect(err.data).toBeUndefined();
+}));
+it.effect("NotConnectedError compiles and carries message", () => Effect.gen(function* () {
+    const err = new NotConnectedError({ message: "socket closed" });
+    expect(err.message).toBe("socket closed");
+}));
+//# sourceMappingURL=runtime.test.js.map

package/dist/runtime/runtime.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.test.js","sourceRoot":"","sources":["../../src/runtime/runtime.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,EAAE,CAAC,MAAM,CAAC,oCAAoC,EAAE,GAAG,EAAE,CACnD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAC7B,MAAM,CAAC,IAAI,CACT,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CACpE,CACF,CAAC;IACF,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;AACH,CAAC,CAAC,CACH,CAAC;AAEF,EAAE,CAAC,MAAM,CAAC,sCAAsC,EAAE,GAAG,EAAE,CACrD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC;QAC7B,IAAI,EAAE,CAAC,KAAK;QACZ,OAAO,EAAE,WAAW;KACrB,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;AACnC,CAAC,CAAC,CACH,CAAC;AAEF,EAAE,CAAC,MAAM,CAAC,gDAAgD,EAAE,GAAG,EAAE,CAC/D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;IAChE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAC5C,CAAC,CAAC,CACH,CAAC"}

package/dist/runtime/subscribers.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Per-subscription event registry for `MoltZapWsClient`.
+ *
+ * Responsibility: own the list of live `subscribe()` handles and fan each
+ * inbound `EventFrame` out to every subscription whose filter matches.
+ * Implements spec #222 §5.3 (C4 + the `RealClientEventSubscriber.subscribe`
+ * filter stub). Lives as an internal collaborator of `MoltZapWsClient`;
+ * the public types (`SubscriptionFilter`, `EventSubscription`,
+ * `SubscriptionId`) re-export from the package barrel.
+ *
+ * Dispatch ordering (Invariant 6 — events delivered in arrival order):
+ *   1. Inbound frames are handed to the registry in arrival order.
+ *   2. Within a single frame, subscriptions are notified in registration
+ *      order.
+ *   3. There is no separate legacy `onEvent` fanout — spec #222 OQ-4 is
+ *      resolved by DELETING `MoltZapWsClientOptions.onEvent`. Callers
+ *      that want "every event" register `subscribe({}, handler)` after
+ *      construction and before `connect()`.
+ *
+ * Unsubscribe semantics (OQ-3 A): `unsubscribe` takes effect on the next
+ * frame. The registry snapshots its live-subscription list at the start
+ * of each `dispatch` call; in-flight dispatch of frame N is not
+ * interrupted by an unsubscribe during frame N. Frame N+1 observes the
+ * unsubscribed state.
+ *
+ * Error channel: handlers are invoked inside a defect-catcher; a throw is
+ * logged via the client's injected `WsClientLogger` and swallowed
+ * (matching the prior `onEvent` contract at `ws-client.ts:650-655`
+ * pre-deletion). The registry itself has no typed error surface —
+ * `register`, `dispatch`, and `closeAll` are `Effect<T, never>`.
+ */
+import { Effect } from "effect";
+import type { EventFrame } from "@moltzap/protocol";
+/** Branded identifier for a subscription handle. Minted by `register`. */
+export type SubscriptionId = string & {
+    readonly __brand: "SubscriptionId";
+};
+/**
+ * Filter grammar for `subscribe`. An event is delivered to a subscription
+ * iff it matches **every** field that is set on the filter. Unset fields
+ * are wildcards; the empty filter `{}` matches every event.
+ *
+ * OQ-2 resolution (A): exactly these three fields, no free-form
+ * predicate, no schema-derived matcher. Matches the existing
+ * `RealClientEventFilter` contract at
+ * `packages/protocol/src/testing/conformance/client/runner.ts:104-116`
+ * one-for-one.
+ *
+ *   - `emissionTag` — exact match against the canonical payload key
+ *     `frame.data.__emissionTag`. (The adapter reads the same key at
+ *     `packages/client/src/test-utils/conformance-adapter.ts:77-79`;
+ *     `emitTaggedEventDefault` writes it at `runner.ts:343-357`. The
+ *     `__emissionId` string in the `runner.ts:108` doc comment is a
+ *     known doc-bug — architect files a follow-up issue against
+ *     protocol to correct the comment; it is not the canonical name.)
+ *   - `conversationId` — exact match against `frame.data.conversationId`
+ *     when set on the event payload.
+ *   - `eventNamePrefix` — `frame.event.startsWith(prefix)`.
+ */
+export interface SubscriptionFilter {
+    readonly emissionTag?: string;
+    readonly conversationId?: string;
+    readonly eventNamePrefix?: string;
+}
+/**
+ * Handle returned by `register` / `MoltZapWsClient.subscribe`. Caller
+ * holds the handle for its subscription's lifetime and runs
+ * `unsubscribe` to stop delivery.
+ *
+ * `unsubscribe` is `Effect<void, never>`: it is idempotent and total.
+ * Calling `unsubscribe` a second time, or after `closeAll`, is a no-op.
+ */
+export interface EventSubscription {
+    readonly id: SubscriptionId;
+    readonly unsubscribe: Effect.Effect<void, never>;
+}
+/**
+ * Per-subscription handler signature. Runs inside the registry's
+ * dispatch fiber. Must not throw — throws are caught by the registry,
+ * logged via the injected logger, and swallowed.
+ *
+ * Returning an `Effect` (not a plain `void`) lets handlers compose with
+ * Effect-native downstream code without an extra runSync shim. The
+ * registry awaits each handler's effect before moving to the next
+ * subscription for this frame — fairness over throughput, so a slow
+ * handler on subscription A does not reorder frames seen by
+ * subscription B across frames.
+ */
+export type SubscriberHandler = (frame: EventFrame) => Effect.Effect<void, never>;
+/**
+ * Subscriber registry. One instance per `MoltZapWsClient`, created at
+ * construction time and owned by the client. Not exported from the
+ * package barrel — consumers reach the registry only through
+ * `MoltZapWsClient.subscribe`.
+ */
+export interface SubscriberRegistry {
+    /**
+     * Add a subscription. Returns the handle immediately; delivery starts
+     * with the next frame passed to `dispatch`. Does not await any
+     * connection state — subscribe is legal pre-connect (spec §5.3 +
+     * Assumption 1 deletion: post-delete of `onEvent`, subscribe is the
+     * only pre-connect event hook).
+     */
+    readonly register: (filter: SubscriptionFilter, handler: SubscriberHandler) => Effect.Effect<EventSubscription, never>;
+    /**
+     * Fan an inbound event out to every matching subscription. Called by
+     * `MoltZapWsClient.handleIncoming` at the existing event-dispatch
+     * point (`ws-client.ts:649-685`). Implementation snapshots the
+     * live-subscription list at the start of dispatch so
+     * unsubscribe-during-dispatch observes next-frame semantics (OQ-3 A).
+     *
+     * Dispatch order: registration order, iterated sequentially; slow
+     * handlers block later subscriptions for this frame but never
+     * reorder frame N relative to frame N+1.
+     */
+    readonly dispatch: (frame: EventFrame) => Effect.Effect<void, never>;
+    /**
+     * Drop every live subscription. Called from `MoltZapWsClient.close`
+     * so handlers stop firing once the client is torn down. Idempotent.
+     */
+    readonly closeAll: Effect.Effect<void, never>;
+}
+/**
+ * Construct an empty registry. Called once from the `MoltZapWsClient`
+ * constructor. Takes a logger so registry-internal error logs reach the
+ * same sink as the rest of the client.
+ *
+ * Implementation notes:
+ *   - Live subscriptions are stored in a `Ref<ReadonlyArray<…>>` keyed
+ *     by registration order. Append-on-register, filter-on-unsubscribe
+ *     keeps the dispatch path O(N) with N = live subscription count.
+ *     Bigger structures aren't justified at the expected sub count
+ *     (≤ ~10 per fixture).
+ *   - `dispatch` snapshots the array at start (OQ-3 A). An
+ *     `unsubscribe` mid-dispatch mutates the Ref but the in-flight
+ *     iteration walks the snapshot.
+ *   - Handler exceptions are caught with `Effect.catchAllDefect` after
+ *     the handler Effect. Sync `throw` from a `(frame) => …` body
+ *     surfaces as a defect; we log + swallow to match the pre-deletion
+ *     `onEvent` contract.
+ */
+export declare function makeSubscriberRegistry(logger: {
+    readonly warn: (...args: ReadonlyArray<unknown>) => void;
+}): Effect.Effect<SubscriberRegistry, never>;
+/**
+ * Pure filter-match predicate. Exposed for unit testing so executable
+ * client-side divergence proofs can force known-bad subscription
+ * behavior without bypassing the production dispatch path.
+ *
+ * Returns `true` iff `frame` matches every set field on `filter`:
+ *   - `filter.emissionTag === frame.data.__emissionTag` (strict ===)
+ *   - `filter.conversationId === frame.data.conversationId` (strict ===)
+ *   - `frame.event.startsWith(filter.eventNamePrefix)`
+ * Unset filter fields are wildcards.
+ */
+export declare function matchesFilter(filter: SubscriptionFilter, frame: EventFrame): boolean;
+//# sourceMappingURL=subscribers.d.ts.map

package/dist/runtime/subscribers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.d.ts","sourceRoot":"","sources":["../../src/runtime/subscribers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAE,MAAM,EAAO,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;CAClD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,UAAU,KACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,CACjB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,iBAAiB,KACvB,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAE7C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAErE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;CAC/C;AAQD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CAC1D,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,CA8C3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,UAAU,GAChB,OAAO,CA8BT"}

package/dist/runtime/subscribers.js

@@ -0,0 +1,131 @@
+/**
+ * Per-subscription event registry for `MoltZapWsClient`.
+ *
+ * Responsibility: own the list of live `subscribe()` handles and fan each
+ * inbound `EventFrame` out to every subscription whose filter matches.
+ * Implements spec #222 §5.3 (C4 + the `RealClientEventSubscriber.subscribe`
+ * filter stub). Lives as an internal collaborator of `MoltZapWsClient`;
+ * the public types (`SubscriptionFilter`, `EventSubscription`,
+ * `SubscriptionId`) re-export from the package barrel.
+ *
+ * Dispatch ordering (Invariant 6 — events delivered in arrival order):
+ *   1. Inbound frames are handed to the registry in arrival order.
+ *   2. Within a single frame, subscriptions are notified in registration
+ *      order.
+ *   3. There is no separate legacy `onEvent` fanout — spec #222 OQ-4 is
+ *      resolved by DELETING `MoltZapWsClientOptions.onEvent`. Callers
+ *      that want "every event" register `subscribe({}, handler)` after
+ *      construction and before `connect()`.
+ *
+ * Unsubscribe semantics (OQ-3 A): `unsubscribe` takes effect on the next
+ * frame. The registry snapshots its live-subscription list at the start
+ * of each `dispatch` call; in-flight dispatch of frame N is not
+ * interrupted by an unsubscribe during frame N. Frame N+1 observes the
+ * unsubscribed state.
+ *
+ * Error channel: handlers are invoked inside a defect-catcher; a throw is
+ * logged via the client's injected `WsClientLogger` and swallowed
+ * (matching the prior `onEvent` contract at `ws-client.ts:650-655`
+ * pre-deletion). The registry itself has no typed error surface —
+ * `register`, `dispatch`, and `closeAll` are `Effect<T, never>`.
+ */
+import { Effect, Ref } from "effect";
+/**
+ * Construct an empty registry. Called once from the `MoltZapWsClient`
+ * constructor. Takes a logger so registry-internal error logs reach the
+ * same sink as the rest of the client.
+ *
+ * Implementation notes:
+ *   - Live subscriptions are stored in a `Ref<ReadonlyArray<…>>` keyed
+ *     by registration order. Append-on-register, filter-on-unsubscribe
+ *     keeps the dispatch path O(N) with N = live subscription count.
+ *     Bigger structures aren't justified at the expected sub count
+ *     (≤ ~10 per fixture).
+ *   - `dispatch` snapshots the array at start (OQ-3 A). An
+ *     `unsubscribe` mid-dispatch mutates the Ref but the in-flight
+ *     iteration walks the snapshot.
+ *   - Handler exceptions are caught with `Effect.catchAllDefect` after
+ *     the handler Effect. Sync `throw` from a `(frame) => …` body
+ *     surfaces as a defect; we log + swallow to match the pre-deletion
+ *     `onEvent` contract.
+ */
+export function makeSubscriberRegistry(logger) {
+    return Effect.gen(function* () {
+        const subsRef = yield* Ref.make([]);
+        const counterRef = yield* Ref.make(0);
+        const register = (filter, handler) => Effect.gen(function* () {
+            const n = yield* Ref.updateAndGet(counterRef, (c) => c + 1);
+            const id = `sub-${n}`;
+            const live = { id, filter, handler };
+            yield* Ref.update(subsRef, (xs) => [...xs, live]);
+            const unsubscribe = Ref.update(subsRef, (xs) => xs.filter((s) => s.id !== id));
+            return { id, unsubscribe };
+        });
+        const dispatch = (frame) => Effect.gen(function* () {
+            // Snapshot at dispatch-start: OQ-3 A. Unsubscribes during this
+            // frame mutate `subsRef` but our iteration walks `snapshot`.
+            const snapshot = yield* Ref.get(subsRef);
+            // Short-circuit the common pre-subscribe path (every inbound
+            // frame before any `subscribe()` call) so hot-path dispatch
+            // avoids even the `for…of` allocation.
+            if (snapshot.length === 0)
+                return;
+            for (const sub of snapshot) {
+                if (!matchesFilter(sub.filter, frame))
+                    continue;
+                // Handlers must not throw; we catch defects defensively so
+                // one buggy subscriber can't kill the dispatch loop or break
+                // the reader fiber.
+                yield* Effect.suspend(() => sub.handler(frame)).pipe(Effect.catchAllDefect((err) => Effect.sync(() => {
+                    logger.warn("subscriber handler threw", err);
+                })));
+            }
+        });
+        const closeAll = Ref.set(subsRef, []);
+        return { register, dispatch, closeAll };
+    });
+}
+/**
+ * Pure filter-match predicate. Exposed for unit testing so executable
+ * client-side divergence proofs can force known-bad subscription
+ * behavior without bypassing the production dispatch path.
+ *
+ * Returns `true` iff `frame` matches every set field on `filter`:
+ *   - `filter.emissionTag === frame.data.__emissionTag` (strict ===)
+ *   - `filter.conversationId === frame.data.conversationId` (strict ===)
+ *   - `frame.event.startsWith(filter.eventNamePrefix)`
+ * Unset filter fields are wildcards.
+ */
+export function matchesFilter(filter, frame) {
+    if (filter.eventNamePrefix !== undefined) {
+        if (!frame.event.startsWith(filter.eventNamePrefix))
+            return false;
+    }
+    // `frame.data` is `unknown` per the EventFrame schema; narrow it to
+    // a record before reading the two payload-keyed fields. Anything
+    // else (string, number, array) cannot satisfy a payload-key filter.
+    // The cast is annotated below: the EventFrame schema declares `data:
+    // unknown`, and the OQ-2 A filter grammar intentionally treats
+    // payloads as untyped maps so arbitrary publisher payloads can be
+    // filtered without a per-event schema tax. The `typeof === "object"`
+    // guard is the runtime boundary; the read sites
+    // (`data?.["__emissionTag"]`, `data?.["conversationId"]`) defend
+    // against missing or wrong-typed values via `=== filter.<field>`.
+    const data = typeof frame.data === "object" &&
+        frame.data !== null &&
+        !Array.isArray(frame.data)
+        ? frame.data // #ignore-sloppy-code[record-cast]: EventFrame schema declares `data: unknown`; OQ-2 A filter treats payloads as untyped maps; the typeof guard above is the runtime boundary
+        : null;
+    if (filter.emissionTag !== undefined) {
+        const tag = data?.["__emissionTag"];
+        if (tag !== filter.emissionTag)
+            return false;
+    }
+    if (filter.conversationId !== undefined) {
+        const cid = data?.["conversationId"];
+        if (cid !== filter.conversationId)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=subscribers.js.map

package/dist/runtime/subscribers.js.map

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

package/dist/runtime/subscribers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subscribers.test.d.ts.map

package/dist/runtime/subscribers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.test.d.ts","sourceRoot":"","sources":["../../src/runtime/subscribers.test.ts"],"names":[],"mappings":""}

package/dist/runtime/subscribers.test.js

@@ -0,0 +1,155 @@
+/**
+ * Unit tests for the per-subscription event registry.
+ *
+ * Spec #222 §5.3 (C4 + the `RealClientEventSubscriber.subscribe` filter
+ * stub) requires:
+ *   - Every set filter field narrows delivery (AND semantics).
+ *   - Subscriptions fire in registration order.
+ *   - Unsubscribe-during-dispatch is next-frame effective (OQ-3 A
+ *     snapshot semantics).
+ *   - Handler exceptions are caught + logged, not propagated.
+ *
+ * Each scenario gets a dedicated test so a mutation that bypasses the
+ * filter (e.g. force `matchesFilter` to always return `true`) trips the
+ * filter-narrows tests but leaves order tests passing — the tests
+ * discriminate.
+ */
+import { describe, expect, it, vi } from "vitest";
+import { Effect, Ref } from "effect";
+import { makeSubscriberRegistry, matchesFilter } from "./subscribers.js";
+const eventFrame = (event, data) => ({
+    jsonrpc: "2.0",
+    type: "event",
+    event,
+    data,
+});
+const noopLogger = { warn: vi.fn() };
+describe("matchesFilter", () => {
+    it("empty filter matches every frame", () => {
+        expect(matchesFilter({}, eventFrame("any", { x: 1 }))).toBe(true);
+    });
+    it("emissionTag matches on `__emissionTag` key", () => {
+        const frame = eventFrame("e", { __emissionTag: "tag-1" });
+        expect(matchesFilter({ emissionTag: "tag-1" }, frame)).toBe(true);
+        expect(matchesFilter({ emissionTag: "tag-other" }, frame)).toBe(false);
+    });
+    it("conversationId matches on `conversationId` key", () => {
+        const frame = eventFrame("e", { conversationId: "c-1" });
+        expect(matchesFilter({ conversationId: "c-1" }, frame)).toBe(true);
+        expect(matchesFilter({ conversationId: "c-2" }, frame)).toBe(false);
+    });
+    it("eventNamePrefix uses startsWith", () => {
+        const frame = eventFrame("messages/received", {});
+        expect(matchesFilter({ eventNamePrefix: "messages/" }, frame)).toBe(true);
+        expect(matchesFilter({ eventNamePrefix: "presence/" }, frame)).toBe(false);
+    });
+    it("AND semantics: all set fields must match", () => {
+        const frame = eventFrame("messages/received", {
+            __emissionTag: "tag-1",
+            conversationId: "c-1",
+        });
+        expect(matchesFilter({ emissionTag: "tag-1", conversationId: "c-1", eventNamePrefix: "m" }, frame)).toBe(true);
+        // conversationId mismatch → reject even when other fields match.
+        expect(matchesFilter({ emissionTag: "tag-1", conversationId: "c-other" }, frame)).toBe(false);
+    });
+    it("non-record `data` cannot satisfy payload-key filters", () => {
+        const stringData = eventFrame("e", "string-payload");
+        expect(matchesFilter({ emissionTag: "x" }, stringData)).toBe(false);
+        expect(matchesFilter({ conversationId: "x" }, stringData)).toBe(false);
+        // …but an event-name-prefix filter still applies.
+        expect(matchesFilter({ eventNamePrefix: "e" }, stringData)).toBe(true);
+    });
+});
+describe("SubscriberRegistry", () => {
+    it("dispatches in registration order", async () => {
+        const registry = await Effect.runPromise(makeSubscriberRegistry(noopLogger));
+        const order = [];
+        await Effect.runPromise(registry.register({}, () => Effect.sync(() => void order.push("a"))));
+        await Effect.runPromise(registry.register({}, () => Effect.sync(() => void order.push("b"))));
+        await Effect.runPromise(registry.dispatch(eventFrame("e", {})));
+        expect(order).toEqual(["a", "b"]);
+    });
+    it("unsubscribe stops delivery for the next frame (OQ-3 A snapshot)", async () => {
+        const registry = await Effect.runPromise(makeSubscriberRegistry(noopLogger));
+        const aCalls = [];
+        const bCalls = [];
+        let frameIdx = 0;
+        let unsubA = null;
+        const handleA = await Effect.runPromise(registry.register({}, () => Effect.gen(function* () {
+            aCalls.push(frameIdx);
+            // During the FIRST frame's dispatch, a unsubscribes itself.
+            // OQ-3 A: b should still see frame 0 (snapshot taken at
+            // dispatch start), but a should NOT see frame 1.
+            if (frameIdx === 0 && unsubA !== null) {
+                yield* unsubA;
+            }
+        })));
+        unsubA = handleA.unsubscribe;
+        await Effect.runPromise(registry.register({}, () => Effect.sync(() => void bCalls.push(frameIdx))));
+        frameIdx = 0;
+        await Effect.runPromise(registry.dispatch(eventFrame("e", {})));
+        frameIdx = 1;
+        await Effect.runPromise(registry.dispatch(eventFrame("e", {})));
+        expect(aCalls).toEqual([0]); // a saw frame 0, not frame 1.
+        expect(bCalls).toEqual([0, 1]); // b saw both — snapshot at start of frame 0 still included a; b is unaffected by a's unsub.
+    });
+    it("filters narrow delivery", async () => {
+        const registry = await Effect.runPromise(makeSubscriberRegistry(noopLogger));
+        const seenByConv1 = [];
+        const seenByConv2 = [];
+        await Effect.runPromise(registry.register({ conversationId: "c-1" }, (frame) => Effect.sync(() => void seenByConv1.push(frame))));
+        await Effect.runPromise(registry.register({ conversationId: "c-2" }, (frame) => Effect.sync(() => void seenByConv2.push(frame))));
+        await Effect.runPromise(registry.dispatch(eventFrame("e", { conversationId: "c-1" })));
+        await Effect.runPromise(registry.dispatch(eventFrame("e", { conversationId: "c-2" })));
+        expect(seenByConv1).toHaveLength(1);
+        expect(seenByConv2).toHaveLength(1);
+        expect(seenByConv1[0].data.conversationId).toBe("c-1");
+        expect(seenByConv2[0].data.conversationId).toBe("c-2");
+    });
+    it("handler exceptions are caught + logged via the injected logger", async () => {
+        const warn = vi.fn();
+        const registry = await Effect.runPromise(makeSubscriberRegistry({ warn }));
+        const otherCalls = [];
+        await Effect.runPromise(registry.register({}, () => Effect.sync(() => {
+            throw new Error("subscriber blew up");
+        })));
+        await Effect.runPromise(registry.register({}, () => Effect.sync(() => void otherCalls.push(1))));
+        await Effect.runPromise(registry.dispatch(eventFrame("e", {})));
+        expect(warn).toHaveBeenCalledTimes(1);
+        expect(otherCalls).toEqual([1]); // other subscribers still fire.
+    });
+    it("construction-time throw from handler is caught + logged (not escaped)", async () => {
+        const warn = vi.fn();
+        const registry = await Effect.runPromise(makeSubscriberRegistry({ warn }));
+        const otherCalls = [];
+        await Effect.runPromise(registry.register({}, (_frame) => {
+            throw new Error("construction-time throw");
+        }));
+        await Effect.runPromise(registry.register({}, () => Effect.sync(() => void otherCalls.push(1))));
+        await Effect.runPromise(registry.dispatch(eventFrame("e", {})));
+        expect(warn).toHaveBeenCalledTimes(1);
+        expect(otherCalls).toEqual([1]); // subsequent subscribers still fire.
+    });
+    it("closeAll drops every subscription", async () => {
+        const registry = await Effect.runPromise(makeSubscriberRegistry(noopLogger));
+        const calls = [];
+        await Effect.runPromise(registry.register({}, () => Effect.sync(() => void calls.push(1))));
+        await Effect.runPromise(registry.closeAll);
+        await Effect.runPromise(registry.dispatch(eventFrame("e", {})));
+        expect(calls).toEqual([]);
+    });
+    it("Ref-make composition works: register inside an Effect.gen", async () => {
+        // Smoke test that the Effect surface composes; the registry never
+        // resolves with `never` failure tag, so this can't catch
+        // typechecker drift, but it does pin behaviour.
+        const result = await Effect.runPromise(Effect.gen(function* () {
+            const registry = yield* makeSubscriberRegistry(noopLogger);
+            const counter = yield* Ref.make(0);
+            yield* registry.register({}, () => Ref.update(counter, (n) => n + 1));
+            yield* registry.dispatch(eventFrame("e", {}));
+            return yield* Ref.get(counter);
+        }));
+        expect(result).toBe(1);
+    });
+});
+//# sourceMappingURL=subscribers.test.js.map

package/dist/runtime/subscribers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.test.js","sourceRoot":"","sources":["../../src/runtime/subscribers.test.ts"],"names":[],"mappings":"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"}