@symmio/trading-core 3.0.0 → 3.1.0

package/dist/websocket/gasless/gasless-stream-hub.js

@@ -0,0 +1,311 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+import { computeBackoffDelay as t } from "../socket/backoff.js";
+import { createReconnectingSocket as n } from "../socket/create-reconnecting-socket.js";
+import { classifyGaslessCloseCode as r } from "./close-code-policy.js";
+import { buildGaslessSubscribeCommand as i, buildGaslessUnsubscribeCommand as a, gaslessStreamSelectorKey as o, parseGaslessStreamMessage as s } from "./parse-gasless-stream-message.js";
+//#region src/websocket/gasless/gasless-stream-hub.ts
+var c = {
+	baseDelayMs: 1e3,
+	maxDelayMs: 3e4,
+	jitter: !0
+}, l = 250, u = 1e4, d = 1e3, f = 6e4, p = 2e3, m = 2e3, h = 1e4, g = 3, _ = 1500, v = /* @__PURE__ */ new WeakMap();
+function y(e, t) {
+	let n = e.timers[t];
+	n !== void 0 && (clearTimeout(n), e.timers[t] = void 0);
+}
+function b(e) {
+	for (let t of Object.keys(e.timers)) y(e, t);
+}
+function x(e, t, n) {
+	e.status = t, e.detail = n;
+	for (let r of e.selectors.values()) {
+		let e = t === "live" && r.state !== "live" ? "degraded" : t;
+		for (let t of r.listeners) t.onStatusChange?.(e, n);
+	}
+}
+function S(e, t, n) {
+	let r = t === null ? [...e.selectors.values()] : [e.selectors.get(t)].filter(Boolean);
+	for (let e of r) for (let t of e.listeners) t.onError?.(n);
+}
+function C(e) {
+	return [...e.selectors.values()].filter((e) => !e.done && e.state !== "not-found" && e.listeners.size > 0);
+}
+function w(e) {
+	for (let t of e.selectors.values()) if (t.listeners.size > 0) return !0;
+	return !1;
+}
+function T(e) {
+	e.idle !== void 0 && (clearTimeout(e.idle), e.idle = void 0);
+}
+function E(e) {
+	for (let t of e.selectors.values()) if (t.state === "overflow" && t.listeners.size > 0) return !0;
+	return !1;
+}
+function D(e, t, n) {
+	T(n), !(n.listeners.size > 0) && (e.selectors.delete(t), e.phase === "ready" && !n.done && n.state === "live" && A(e, {
+		key: t,
+		kind: "unsubscribe",
+		frame: a(n.selector)
+	}), e.phase === "ready" && N(e));
+}
+function O(e, t) {
+	return e.inFlight?.key === t || e.queue.some((e) => e.key === t);
+}
+function k(e, t, n) {
+	if (!(e.phase !== "ready" || n.done) && !(n.state === "live" || n.state === "not-found") && !O(e, t)) {
+		if (C(e).filter((e) => e.state !== "overflow").length > e.maxSubscriptions) {
+			n.state = "overflow";
+			return;
+		}
+		n.state = "pending", A(e, {
+			key: t,
+			kind: "subscribe",
+			frame: i(n.selector)
+		});
+	}
+}
+function A(e, t) {
+	e.queue.push(t), j(e);
+}
+function j(e) {
+	if (e.phase !== "ready" || e.inFlight !== null || e.queue.length === 0 || e.timers.command !== void 0) return;
+	let t = Math.max(0, l - (Date.now() - e.lastCommandAt));
+	e.timers.command = setTimeout(() => {
+		if (e.timers.command = void 0, e.phase !== "ready" || e.inFlight !== null) return;
+		let t = e.queue.shift();
+		t && (e.inFlight = t, e.lastCommandAt = Date.now(), e.socket?.send(t.frame), e.timers.ack = setTimeout(() => {
+			e.timers.ack = void 0;
+			let t = e.inFlight;
+			e.inFlight = null, t && e.queue.unshift(t), j(e);
+		}, u));
+	}, t);
+}
+function M(e, t) {
+	e.inFlight?.key === t && (e.inFlight = null, y(e, "ack"), j(e));
+}
+function N(e) {
+	C(e).forEach((t, n) => {
+		let r = o(t.selector);
+		if (n >= e.maxSubscriptions) {
+			t.state = "overflow";
+			for (let n of t.listeners) n.onStatusChange?.("degraded", {
+				reason: "subscription-limit",
+				detail: `The gateway allows ${e.maxSubscriptions} subscriptions per socket; this workflow keeps polling over HTTP until a slot frees.`
+			});
+			return;
+		}
+		O(e, r) || (t.state = "pending", A(e, {
+			key: r,
+			kind: "subscribe",
+			frame: i(t.selector)
+		}));
+	});
+}
+function P(e) {
+	y(e, "liveness"), e.timers.liveness = setTimeout(() => {
+		e.timers.liveness = void 0, F(e), I(e, {
+			reason: "unreachable",
+			detail: "The gateway stopped sending heartbeats; reconnecting while status reads continue over HTTP."
+		});
+	}, f);
+}
+function F(e) {
+	y(e, "ready"), y(e, "command"), y(e, "ack"), y(e, "liveness"), e.inFlight = null, e.queue = [];
+	let t = e.socket;
+	e.socket = null, t?.close(1e3);
+}
+function I(e, n) {
+	if (e.phase === "disabled") return;
+	e.phase = "backoff", x(e, "degraded", n);
+	let r = t(e.attempt, c, e.random);
+	e.attempt += 1, y(e, "redial"), e.timers.redial = setTimeout(() => {
+		if (e.timers.redial = void 0, e.selectors.size === 0) {
+			e.phase = "idle";
+			return;
+		}
+		B(e);
+	}, r);
+}
+function L(e, t, n) {
+	e.phase = "disabled", F(e), y(e, "redial");
+	for (let t of e.selectors.values()) t.state = "overflow";
+	x(e, "disabled", t), n && S(e, null, n);
+}
+function R(t, n) {
+	P(t);
+	let r = s(n);
+	if (r.type === "throttle") {
+		let e = t.inFlight;
+		t.inFlight = null, y(t, "ack"), e && t.queue.unshift(e), y(t, "command"), t.timers.command = setTimeout(() => {
+			t.timers.command = void 0, j(t);
+		}, d + Math.round(t.random() * d));
+		return;
+	}
+	if (r.type === "unparseable" || r.type === "transport") return;
+	if (r.type === "error") {
+		let n = r.selector ? o(r.selector) : null;
+		n && M(t, n);
+		let a = n ? t.selectors.get(n) : void 0;
+		if (r.code === "NOT_FOUND" && a) {
+			if (a.notFoundRetries < g) {
+				a.notFoundRetries += 1;
+				let e = a;
+				setTimeout(() => {
+					t.phase !== "ready" || e.done || A(t, {
+						key: o(e.selector),
+						kind: "subscribe",
+						frame: i(e.selector)
+					});
+				}, _);
+				return;
+			}
+			a.state = "not-found";
+			for (let e of a.listeners) e.onStatusChange?.("degraded", {
+				reason: "not-found",
+				detail: "The gateway does not store this workflow on the configured instance; status reads continue over HTTP."
+			});
+			S(t, n, new e("api", "GASLESS_STREAM_NOT_FOUND", "Gasless: the status stream does not know this request id on the configured protocol instance. Check that the workflow was accepted by this instance; status reads continue over HTTP."));
+			return;
+		}
+		if (r.code === "SUBSCRIPTION_LIMIT" && a) {
+			a.state = "overflow";
+			for (let e of a.listeners) e.onStatusChange?.("degraded", {
+				reason: "subscription-limit",
+				detail: "The socket is at its subscription limit; this workflow keeps polling over HTTP."
+			});
+			return;
+		}
+		S(t, n, new e("api", r.code === "INVALID_MESSAGE" ? "GASLESS_STREAM_COMMAND_INVALID" : "GASLESS_STREAM_PROTOCOL_ERROR", `Gasless: the status stream rejected a command with ${r.code}.`));
+		return;
+	}
+	if (r.protocolInstance !== t.endpoint.protocolInstance) {
+		L(t, {
+			reason: "instance-mismatch",
+			detail: `The status stream answered for protocol instance "${r.protocolInstance}" but the config pins "${t.endpoint.protocolInstance}". Status reads continue over HTTP.`
+		}, new e("api", "GASLESS_STREAM_INSTANCE_MISMATCH", `Gasless: the status stream answered for protocol instance "${r.protocolInstance}" but the config pins "${t.endpoint.protocolInstance}".`));
+		return;
+	}
+	if (r.type === "ready") {
+		y(t, "ready"), t.phase = "ready", t.maxSubscriptions = r.maxSubscriptions, x(t, "connecting", null), N(t);
+		return;
+	}
+	if (r.type === "unsubscribed") {
+		M(t, o(r.selector));
+		return;
+	}
+	let a = o(r.selector), c = t.selectors.get(a);
+	if (!c) return;
+	r.type === "snapshot" && (M(t, a), t.attempt = 0), c.state = "live", c.notFoundRetries = 0, x(t, "live", null);
+	let l = {
+		kind: r.type,
+		request: r.request,
+		transactions: r.transactions
+	};
+	c.lastUpdate = l;
+	for (let e of c.listeners) e.onUpdate(l);
+}
+function z(t, n) {
+	if (t.phase === "disabled") return;
+	let i = t.phase === "ready";
+	t.socket = null, y(t, "ready"), y(t, "command"), y(t, "ack"), y(t, "liveness"), t.inFlight = null, t.queue = [];
+	for (let e of t.selectors.values()) e.state === "live" && (e.state = "pending");
+	let a = r(n), o = {
+		reason: a.reason,
+		closeCode: n,
+		detail: a.detail
+	};
+	if (a.action === "disable") {
+		L(t, o, new e("api", "GASLESS_STREAM_DISABLED", `Gasless: ${a.detail}`));
+		return;
+	}
+	if (a.action === "retry-bounded" && !i && t.attempt >= 3) {
+		L(t, o, new e("api", "GASLESS_STREAM_DISABLED", `Gasless: the status stream closed 3 times without connecting. ${a.detail}`));
+		return;
+	}
+	I(t, o);
+}
+function B(e) {
+	if (e.phase === "disabled" || e.socket !== null) return;
+	e.phase = "connecting", x(e, "connecting", null);
+	let t;
+	try {
+		t = n({
+			url: e.endpoint.url,
+			webSocketConstructor: e.webSocketConstructor,
+			reconnect: { enabled: !1 },
+			onMessage: (t) => R(e, t),
+			onClose: ({ code: t }) => z(e, t),
+			onError: () => {}
+		});
+	} catch (t) {
+		I(e, {
+			reason: "unreachable",
+			detail: `The status stream could not be opened (${t instanceof Error ? t.message : String(t)}); status reads continue over HTTP.`
+		});
+		return;
+	}
+	e.socket = t, P(e), e.timers.ready = setTimeout(() => {
+		e.timers.ready = void 0, F(e), z(e, 1006);
+	}, h);
+}
+function V(e, t) {
+	let { endpoint: n, selector: r, listener: i, random: a = Math.random } = t, s = v.get(e);
+	s || (s = /* @__PURE__ */ new Map(), v.set(e, s));
+	let c = s.get(n.url);
+	c || (c = {
+		endpoint: n,
+		socket: null,
+		phase: "idle",
+		status: "idle",
+		detail: null,
+		maxSubscriptions: 1,
+		selectors: /* @__PURE__ */ new Map(),
+		queue: [],
+		inFlight: null,
+		attempt: 0,
+		lastCommandAt: 0,
+		timers: {},
+		random: a,
+		webSocketConstructor: e.getWebSocketConstructor()
+	}, s.set(n.url, c));
+	let l = c, u = s;
+	y(l, "idle");
+	let d = o(r), f = l.selectors.get(d);
+	f || (f = {
+		selector: r,
+		listeners: /* @__PURE__ */ new Set(),
+		state: "pending",
+		notFoundRetries: 0,
+		done: !1
+	}, l.selectors.set(d, f));
+	let h = f;
+	T(h), h.listeners.add(i), k(l, d, h), i.onStatusChange?.(l.status === "live" && h.state !== "live" ? "degraded" : l.status, l.detail), h.lastUpdate && queueMicrotask(() => {
+		let e = h.lastUpdate;
+		e && h.listeners.has(i) && i.onUpdate(e);
+	}), l.phase === "idle" && B(l);
+	let g = !1;
+	return () => {
+		g || (g = !0, h.listeners.delete(i), !(h.listeners.size > 0) && (T(h), E(l) ? D(l, d, h) : h.idle = setTimeout(() => {
+			h.idle = void 0, D(l, d, h);
+		}, m), w(l) || (y(l, "idle"), l.timers.idle = setTimeout(() => {
+			if (l.timers.idle = void 0, !w(l)) {
+				for (let e of l.selectors.values()) T(e);
+				l.selectors.clear(), b(l), F(l), l.phase = l.phase === "disabled" ? "disabled" : "idle", u.delete(n.url);
+			}
+		}, p))));
+	};
+}
+function H(e, t, n) {
+	let r = v.get(e)?.get(t);
+	if (!r) return;
+	let i = o(n), s = r.selectors.get(i);
+	!s || s.done || (s.done = !0, r.phase === "ready" && s.state === "live" && A(r, {
+		key: i,
+		kind: "unsubscribe",
+		frame: a(n)
+	}));
+}
+//#endregion
+export { V as acquireGaslessStreamSelector, H as releaseGaslessStreamSelector };
+
+//# sourceMappingURL=gasless-stream-hub.js.map

package/dist/websocket/gasless/gasless-stream-hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasless-stream-hub.js","names":[],"sources":["../../../src/websocket/gasless/gasless-stream-hub.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\nimport type { WebSocketConstructor } from \"../../shared/types/websocket\";\nimport { computeBackoffDelay } from \"../socket/backoff\";\nimport { createReconnectingSocket, type ReconnectingSocket } from \"../socket/create-reconnecting-socket\";\nimport { classifyGaslessCloseCode, GASLESS_STREAM_BOUNDED_ATTEMPTS } from \"./close-code-policy\";\nimport {\n  buildGaslessSubscribeCommand,\n  buildGaslessUnsubscribeCommand,\n  gaslessStreamSelectorKey,\n  parseGaslessStreamMessage,\n  type GaslessStreamSelector,\n} from \"./parse-gasless-stream-message\";\nimport type { GaslessStreamEndpoint } from \"./resolve-gasless-stream-url\";\nimport type { GaslessRequestStreamUpdate, GaslessStreamStatus, GaslessStreamStatusDetail } from \"./types\";\n\n/** Dial backoff: 1 s doubling to 30 s, jittered, reset only after a snapshot. */\nconst BACKOFF = { baseDelayMs: 1_000, maxDelayMs: 30_000, jitter: true } as const;\n/** Minimum spacing between client commands; they share the caller's request quota. */\nconst COMMAND_INTERVAL_MS = 250;\n/** How long a command waits for its snapshot / ack before it is retried. */\nconst COMMAND_ACK_TIMEOUT_MS = 10_000;\n/** A throttled command waits at least this long, since `Retry-After` is not on the socket. */\nconst THROTTLE_BACKOFF_MS = 1_000;\n/** No inbound frame for this long (heartbeats arrive about every 20 s) means the socket is dead. */\nconst LIVENESS_TIMEOUT_MS = 60_000;\n/** Grace period before the last watcher's departure closes the socket (absorbs StrictMode remounts). */\nconst IDLE_CLOSE_MS = 2_000;\n/**\n * Grace period before an unwatched selector is unsubscribed.\n *\n * One relayed write is followed by two waits in sequence — broadcast, then\n * terminal — and without this the handoff between them costs a full\n * unsubscribe/subscribe round trip plus the HTTP read the second wait takes\n * while its new subscription is still pending. Runs alongside\n * {@link IDLE_CLOSE_MS}, not after it, so an idle socket still closes as\n * promptly as before.\n */\nconst SELECTOR_IDLE_MS = 2_000;\n/** The `ready` handshake must arrive within this long after the socket opens. */\nconst READY_TIMEOUT_MS = 10_000;\n/** Resubscribes tolerated for the accept-vs-record race after a 202. */\nconst NOT_FOUND_RETRIES = 3;\n/** Delay between those resubscribes. */\nconst NOT_FOUND_RETRY_MS = 1_500;\n\n/**\n * One watcher of one selector.\n *\n * @internal\n */\nexport interface GaslessStreamListener {\n  onUpdate: (update: GaslessRequestStreamUpdate) => void;\n  onStatusChange?: (status: GaslessStreamStatus, detail: GaslessStreamStatusDetail | null) => void;\n  onError?: (error: SymmError) => void;\n}\n\ninterface SelectorEntry {\n  selector: GaslessStreamSelector;\n  listeners: Set<GaslessStreamListener>;\n  /** `pending` until its snapshot arrives; `overflow` while the socket is at its cap. */\n  state: \"pending\" | \"live\" | \"overflow\" | \"not-found\";\n  notFoundRetries: number;\n  /** Set once a terminal record arrived, so a reconnect does not resubscribe it. */\n  done: boolean;\n  /** The last frame delivered for this selector, replayed to a late joiner. */\n  lastUpdate?: GaslessRequestStreamUpdate;\n  /** Pending removal while nobody watches this selector. */\n  idle?: ReturnType<typeof setTimeout>;\n}\n\ninterface QueuedCommand {\n  key: string;\n  kind: \"subscribe\" | \"unsubscribe\";\n  frame: string;\n}\n\ninterface Hub {\n  endpoint: GaslessStreamEndpoint;\n  /** Resolved once per hub: the config's WebSocket implementation. */\n  webSocketConstructor: WebSocketConstructor;\n  socket: ReconnectingSocket | null;\n  phase: \"idle\" | \"connecting\" | \"ready\" | \"backoff\" | \"disabled\";\n  status: GaslessStreamStatus;\n  detail: GaslessStreamStatusDetail | null;\n  maxSubscriptions: number;\n  selectors: Map<string, SelectorEntry>;\n  queue: QueuedCommand[];\n  inFlight: QueuedCommand | null;\n  attempt: number;\n  /** When the last command was sent, so pacing spans a burst and not an idle socket. */\n  lastCommandAt: number;\n  timers: {\n    redial?: ReturnType<typeof setTimeout>;\n    command?: ReturnType<typeof setTimeout>;\n    ack?: ReturnType<typeof setTimeout>;\n    liveness?: ReturnType<typeof setTimeout>;\n    idle?: ReturnType<typeof setTimeout>;\n    ready?: ReturnType<typeof setTimeout>;\n  };\n  random: () => number;\n}\n\nconst hubRegistries = new WeakMap<Config, Map<string, Hub>>();\n\nfunction clearTimer(hub: Hub, name: keyof Hub[\"timers\"]): void {\n  const timer = hub.timers[name];\n  if (timer !== undefined) {\n    clearTimeout(timer);\n    hub.timers[name] = undefined;\n  }\n}\n\nfunction clearAllTimers(hub: Hub): void {\n  for (const name of Object.keys(hub.timers) as (keyof Hub[\"timers\"])[]) clearTimer(hub, name);\n}\n\nfunction setStatus(hub: Hub, status: GaslessStreamStatus, detail: GaslessStreamStatusDetail | null): void {\n  hub.status = status;\n  hub.detail = detail;\n  for (const entry of hub.selectors.values()) {\n    /** An overflowed selector is never `live`, whatever the socket is doing. */\n    const effective = status === \"live\" && entry.state !== \"live\" ? \"degraded\" : status;\n    for (const listener of entry.listeners) listener.onStatusChange?.(effective, detail);\n  }\n}\n\nfunction notifyError(hub: Hub, key: string | null, error: SymmError): void {\n  const entries = key === null ? [...hub.selectors.values()] : [hub.selectors.get(key)].filter(Boolean);\n  for (const entry of entries as SelectorEntry[]) {\n    for (const listener of entry.listeners) listener.onError?.(error);\n  }\n}\n\n/** Selectors that still want a subscription, capped by what the gateway allows. */\nfunction wantedSelectors(hub: Hub): SelectorEntry[] {\n  return [...hub.selectors.values()].filter(\n    (entry) => !entry.done && entry.state !== \"not-found\" && entry.listeners.size > 0,\n  );\n}\n\n/** Whether anything still watches this hub. Entries inside their idle grace do not count. */\nfunction hasWatchers(hub: Hub): boolean {\n  for (const entry of hub.selectors.values()) if (entry.listeners.size > 0) return true;\n  return false;\n}\n\n/** Cancel a selector's pending removal — a new watcher arrived in time. */\nfunction clearSelectorIdle(entry: SelectorEntry): void {\n  if (entry.idle !== undefined) {\n    clearTimeout(entry.idle);\n    entry.idle = undefined;\n  }\n}\n\n/** Whether a watched selector is sitting over the cap, waiting for a slot. */\nfunction hasOverflowedSelector(hub: Hub): boolean {\n  for (const entry of hub.selectors.values()) {\n    if (entry.state === \"overflow\" && entry.listeners.size > 0) return true;\n  }\n  return false;\n}\n\n/** Give up a selector nobody watches: unsubscribe it and hand its slot on. */\nfunction removeSelector(hub: Hub, key: string, entry: SelectorEntry): void {\n  clearSelectorIdle(entry);\n  if (entry.listeners.size > 0) return;\n\n  hub.selectors.delete(key);\n  if (hub.phase === \"ready\" && !entry.done && entry.state === \"live\") {\n    enqueue(hub, { key, kind: \"unsubscribe\", frame: buildGaslessUnsubscribeCommand(entry.selector) });\n  }\n  /** A freed slot may let an overflowed selector subscribe. */\n  if (hub.phase === \"ready\") subscribeAll(hub);\n}\n\n/** Whether a command for this selector is already queued or in flight. */\nfunction isCommandPending(hub: Hub, key: string): boolean {\n  return hub.inFlight?.key === key || hub.queue.some((command) => command.key === key);\n}\n\n/**\n * Subscribe a selector that wants one and has no command out for it yet.\n *\n * Shared by a first watcher and by one that rejoined an entry whose grace had\n * not expired: rejoining a `live` entry needs no command at all, which is the\n * whole point of the grace.\n */\nfunction ensureSubscribed(hub: Hub, key: string, entry: SelectorEntry): void {\n  if (hub.phase !== \"ready\" || entry.done) return;\n  if (entry.state === \"live\" || entry.state === \"not-found\") return;\n  if (isCommandPending(hub, key)) return;\n\n  const live = wantedSelectors(hub).filter((candidate) => candidate.state !== \"overflow\").length;\n  if (live > hub.maxSubscriptions) {\n    entry.state = \"overflow\";\n    return;\n  }\n  entry.state = \"pending\";\n  enqueue(hub, { key, kind: \"subscribe\", frame: buildGaslessSubscribeCommand(entry.selector) });\n}\n\nfunction enqueue(hub: Hub, command: QueuedCommand): void {\n  hub.queue.push(command);\n  pumpQueue(hub);\n}\n\n/** Send one command at a time, paced, and only while the socket is ready. */\nfunction pumpQueue(hub: Hub): void {\n  if (hub.phase !== \"ready\" || hub.inFlight !== null || hub.queue.length === 0) return;\n  if (hub.timers.command !== undefined) return;\n\n  /**\n   * Paced from the last command sent, not from now: the interval exists to keep\n   * a burst of commands off the caller's request quota, and a socket that has\n   * been quiet has already served it. The first subscribe after `ready` is what\n   * a status wait is blocked on, so it goes out at once.\n   */\n  const delay = Math.max(0, COMMAND_INTERVAL_MS - (Date.now() - hub.lastCommandAt));\n\n  hub.timers.command = setTimeout(() => {\n    hub.timers.command = undefined;\n    if (hub.phase !== \"ready\" || hub.inFlight !== null) return;\n    const command = hub.queue.shift();\n    if (!command) return;\n    hub.inFlight = command;\n    hub.lastCommandAt = Date.now();\n    hub.socket?.send(command.frame);\n    hub.timers.ack = setTimeout(() => {\n      hub.timers.ack = undefined;\n      /** No ack in time: put it back at the head and try again. */\n      const pending = hub.inFlight;\n      hub.inFlight = null;\n      if (pending) hub.queue.unshift(pending);\n      pumpQueue(hub);\n    }, COMMAND_ACK_TIMEOUT_MS);\n  }, delay);\n}\n\nfunction completeInFlight(hub: Hub, key: string): void {\n  if (hub.inFlight?.key !== key) return;\n  hub.inFlight = null;\n  clearTimer(hub, \"ack\");\n  pumpQueue(hub);\n}\n\nfunction subscribeAll(hub: Hub): void {\n  const wanted = wantedSelectors(hub);\n  wanted.forEach((entry, index) => {\n    const key = gaslessStreamSelectorKey(entry.selector);\n    if (index >= hub.maxSubscriptions) {\n      /** Over the cap: this selector stays on HTTP until a slot frees. */\n      entry.state = \"overflow\";\n      for (const listener of entry.listeners) {\n        listener.onStatusChange?.(\"degraded\", {\n          reason: \"subscription-limit\",\n          detail: `The gateway allows ${hub.maxSubscriptions} subscriptions per socket; this workflow keeps polling over HTTP until a slot frees.`,\n        });\n      }\n      return;\n    }\n    if (isCommandPending(hub, key)) return;\n    entry.state = \"pending\";\n    enqueue(hub, { key, kind: \"subscribe\", frame: buildGaslessSubscribeCommand(entry.selector) });\n  });\n}\n\nfunction armLiveness(hub: Hub): void {\n  clearTimer(hub, \"liveness\");\n  hub.timers.liveness = setTimeout(() => {\n    hub.timers.liveness = undefined;\n    /** Heartbeats stopped: treat it as a dead connection and redial. */\n    dropSocket(hub);\n    scheduleRedial(hub, {\n      reason: \"unreachable\",\n      detail: \"The gateway stopped sending heartbeats; reconnecting while status reads continue over HTTP.\",\n    });\n  }, LIVENESS_TIMEOUT_MS);\n}\n\nfunction dropSocket(hub: Hub): void {\n  clearTimer(hub, \"ready\");\n  clearTimer(hub, \"command\");\n  clearTimer(hub, \"ack\");\n  clearTimer(hub, \"liveness\");\n  hub.inFlight = null;\n  hub.queue = [];\n  const socket = hub.socket;\n  hub.socket = null;\n  socket?.close(1000);\n}\n\nfunction scheduleRedial(hub: Hub, detail: GaslessStreamStatusDetail): void {\n  if (hub.phase === \"disabled\") return;\n  hub.phase = \"backoff\";\n  setStatus(hub, \"degraded\", detail);\n  const delay = computeBackoffDelay(hub.attempt, BACKOFF, hub.random);\n  hub.attempt += 1;\n  clearTimer(hub, \"redial\");\n  hub.timers.redial = setTimeout(() => {\n    hub.timers.redial = undefined;\n    if (hub.selectors.size === 0) {\n      hub.phase = \"idle\";\n      return;\n    }\n    connect(hub);\n  }, delay);\n}\n\nfunction disable(hub: Hub, detail: GaslessStreamStatusDetail, error?: SymmError): void {\n  hub.phase = \"disabled\";\n  dropSocket(hub);\n  clearTimer(hub, \"redial\");\n  for (const entry of hub.selectors.values()) entry.state = \"overflow\";\n  setStatus(hub, \"disabled\", detail);\n  if (error) notifyError(hub, null, error);\n}\n\nfunction handleMessage(hub: Hub, data: unknown): void {\n  armLiveness(hub);\n  const message = parseGaslessStreamMessage(data);\n\n  /** The throttle notice has no type or instance, so it is handled first. */\n  if (message.type === \"throttle\") {\n    const pending = hub.inFlight;\n    hub.inFlight = null;\n    clearTimer(hub, \"ack\");\n    if (pending) hub.queue.unshift(pending);\n    clearTimer(hub, \"command\");\n    hub.timers.command = setTimeout(\n      () => {\n        hub.timers.command = undefined;\n        pumpQueue(hub);\n      },\n      THROTTLE_BACKOFF_MS + Math.round(hub.random() * THROTTLE_BACKOFF_MS),\n    );\n    return;\n  }\n\n  if (message.type === \"unparseable\" || message.type === \"transport\") return;\n\n  if (message.type === \"error\") {\n    const key = message.selector ? gaslessStreamSelectorKey(message.selector) : null;\n    if (key) completeInFlight(hub, key);\n    const entry = key ? hub.selectors.get(key) : undefined;\n\n    if (message.code === \"NOT_FOUND\" && entry) {\n      /**\n       * The accepted record may not be readable the instant a 202 returns, and\n       * the gateway does not retain a NOT_FOUND subscription, so resubscribe a\n       * few times before giving up on the stream for this workflow.\n       */\n      if (entry.notFoundRetries < NOT_FOUND_RETRIES) {\n        entry.notFoundRetries += 1;\n        const retried = entry;\n        setTimeout(() => {\n          if (hub.phase !== \"ready\" || retried.done) return;\n          enqueue(hub, {\n            key: gaslessStreamSelectorKey(retried.selector),\n            kind: \"subscribe\",\n            frame: buildGaslessSubscribeCommand(retried.selector),\n          });\n        }, NOT_FOUND_RETRY_MS);\n        return;\n      }\n      entry.state = \"not-found\";\n      for (const listener of entry.listeners) {\n        listener.onStatusChange?.(\"degraded\", {\n          reason: \"not-found\",\n          detail:\n            \"The gateway does not store this workflow on the configured instance; status reads continue over HTTP.\",\n        });\n      }\n      notifyError(\n        hub,\n        key,\n        new SymmError(\n          \"api\",\n          \"GASLESS_STREAM_NOT_FOUND\",\n          \"Gasless: the status stream does not know this request id on the configured protocol instance. Check that the workflow was accepted by this instance; status reads continue over HTTP.\",\n        ),\n      );\n      return;\n    }\n\n    if (message.code === \"SUBSCRIPTION_LIMIT\" && entry) {\n      entry.state = \"overflow\";\n      for (const listener of entry.listeners) {\n        listener.onStatusChange?.(\"degraded\", {\n          reason: \"subscription-limit\",\n          detail: \"The socket is at its subscription limit; this workflow keeps polling over HTTP.\",\n        });\n      }\n      return;\n    }\n\n    notifyError(\n      hub,\n      key,\n      new SymmError(\n        \"api\",\n        message.code === \"INVALID_MESSAGE\" ? \"GASLESS_STREAM_COMMAND_INVALID\" : \"GASLESS_STREAM_PROTOCOL_ERROR\",\n        `Gasless: the status stream rejected a command with ${message.code}.`,\n      ),\n    );\n    return;\n  }\n\n  /** Every remaining frame names an instance; a mismatch means a different deployment answered. */\n  if (message.protocolInstance !== hub.endpoint.protocolInstance) {\n    disable(\n      hub,\n      {\n        reason: \"instance-mismatch\",\n        detail: `The status stream answered for protocol instance \"${message.protocolInstance}\" but the config pins \"${hub.endpoint.protocolInstance}\". Status reads continue over HTTP.`,\n      },\n      new SymmError(\n        \"api\",\n        \"GASLESS_STREAM_INSTANCE_MISMATCH\",\n        `Gasless: the status stream answered for protocol instance \"${message.protocolInstance}\" but the config pins \"${hub.endpoint.protocolInstance}\".`,\n      ),\n    );\n    return;\n  }\n\n  if (message.type === \"ready\") {\n    clearTimer(hub, \"ready\");\n    hub.phase = \"ready\";\n    hub.maxSubscriptions = message.maxSubscriptions;\n    setStatus(hub, \"connecting\", null);\n    subscribeAll(hub);\n    return;\n  }\n\n  if (message.type === \"unsubscribed\") {\n    completeInFlight(hub, gaslessStreamSelectorKey(message.selector));\n    return;\n  }\n\n  const key = gaslessStreamSelectorKey(message.selector);\n  const entry = hub.selectors.get(key);\n  if (!entry) return;\n  if (message.type === \"snapshot\") {\n    completeInFlight(hub, key);\n    /** A delivering socket is healthy, so the dial backoff starts over. */\n    hub.attempt = 0;\n  }\n  entry.state = \"live\";\n  entry.notFoundRetries = 0;\n  setStatus(hub, \"live\", null);\n  const update: GaslessRequestStreamUpdate = {\n    kind: message.type,\n    request: message.request,\n    transactions: message.transactions,\n  };\n  /** Kept so a watcher that joins this subscription later starts from it. */\n  entry.lastUpdate = update;\n  for (const listener of entry.listeners) listener.onUpdate(update);\n}\n\nfunction handleClose(hub: Hub, code?: number): void {\n  if (hub.phase === \"disabled\") return;\n  const reachedReady = hub.phase === \"ready\";\n  hub.socket = null;\n  clearTimer(hub, \"ready\");\n  clearTimer(hub, \"command\");\n  clearTimer(hub, \"ack\");\n  clearTimer(hub, \"liveness\");\n  hub.inFlight = null;\n  hub.queue = [];\n  for (const entry of hub.selectors.values()) if (entry.state === \"live\") entry.state = \"pending\";\n\n  const policy = classifyGaslessCloseCode(code);\n  const detail: GaslessStreamStatusDetail = { reason: policy.reason, closeCode: code, detail: policy.detail };\n\n  if (policy.action === \"disable\") {\n    disable(hub, detail, new SymmError(\"api\", \"GASLESS_STREAM_DISABLED\", `Gasless: ${policy.detail}`));\n    return;\n  }\n  if (policy.action === \"retry-bounded\" && !reachedReady && hub.attempt >= GASLESS_STREAM_BOUNDED_ATTEMPTS) {\n    disable(\n      hub,\n      detail,\n      new SymmError(\n        \"api\",\n        \"GASLESS_STREAM_DISABLED\",\n        `Gasless: the status stream closed ${GASLESS_STREAM_BOUNDED_ATTEMPTS} times without connecting. ${policy.detail}`,\n      ),\n    );\n    return;\n  }\n  scheduleRedial(hub, detail);\n}\n\nfunction connect(hub: Hub): void {\n  if (hub.phase === \"disabled\" || hub.socket !== null) return;\n  hub.phase = \"connecting\";\n  setStatus(hub, \"connecting\", null);\n\n  let socket: ReconnectingSocket;\n  try {\n    socket = createReconnectingSocket({\n      url: hub.endpoint.url,\n      webSocketConstructor: hub.webSocketConstructor,\n      /** The hub owns reconnects: the close code decides whether to redial at all. */\n      reconnect: { enabled: false },\n      onMessage: (data) => handleMessage(hub, data),\n      onClose: ({ code }) => handleClose(hub, code),\n      onError: () => {\n        /** A transport error is always followed by a close, which carries the policy. */\n      },\n    });\n  } catch (err) {\n    scheduleRedial(hub, {\n      reason: \"unreachable\",\n      detail: `The status stream could not be opened (${err instanceof Error ? err.message : String(err)}); status reads continue over HTTP.`,\n    });\n    return;\n  }\n  hub.socket = socket;\n  armLiveness(hub);\n  hub.timers.ready = setTimeout(() => {\n    hub.timers.ready = undefined;\n    /** Opened but never greeted: close and redial rather than sending into the void. */\n    dropSocket(hub);\n    handleClose(hub, 1006);\n  }, READY_TIMEOUT_MS);\n}\n\n/**\n * Parameters for {@link acquireGaslessStreamSelector}.\n *\n * @internal\n */\nexport interface AcquireGaslessStreamSelectorParameters {\n  /** The resolved stream endpoint; one hub per URL per config. */\n  endpoint: GaslessStreamEndpoint;\n  /** What this watcher wants to follow. */\n  selector: GaslessStreamSelector;\n  /** This watcher's callbacks. */\n  listener: GaslessStreamListener;\n  /** Randomness for backoff and throttle jitter; injectable for tests. */\n  random?: () => number;\n}\n\n/**\n * Join (or open) the shared status stream for an endpoint and subscribe one\n * selector.\n *\n * One socket serves every watcher of a `(config, endpoint)` pair: the hub keeps\n * the desired selector set independent of the connection, replays it after each\n * `ready`, paces commands so they do not eat the caller's request quota, and\n * routes every frame to the watchers of its selector. Watchers are told when the\n * stream is not delivering so they can poll instead — the hub itself never\n * issues HTTP.\n *\n * A subscription outlives its last watcher by a short grace, and a watcher that\n * joins one which has already delivered is handed that record. Together they\n * make the handoff between two waits on the same workflow free: no\n * unsubscribe/subscribe round trip, and nothing to read over HTTP.\n *\n * @returns A release function; the socket closes shortly after the last watcher releases.\n *\n * @internal\n */\nexport function acquireGaslessStreamSelector(\n  config: Config,\n  parameters: AcquireGaslessStreamSelectorParameters,\n): () => void {\n  const { endpoint, selector, listener, random = Math.random } = parameters;\n\n  let registry = hubRegistries.get(config);\n  if (!registry) {\n    registry = new Map();\n    hubRegistries.set(config, registry);\n  }\n\n  let hub = registry.get(endpoint.url);\n  if (!hub) {\n    hub = {\n      endpoint,\n      socket: null,\n      phase: \"idle\",\n      status: \"idle\",\n      detail: null,\n      maxSubscriptions: 1,\n      selectors: new Map(),\n      queue: [],\n      inFlight: null,\n      attempt: 0,\n      lastCommandAt: 0,\n      timers: {},\n      random,\n      webSocketConstructor: config.getWebSocketConstructor(),\n    };\n    registry.set(endpoint.url, hub);\n  }\n  const currentHub = hub;\n  const currentRegistry = registry;\n  clearTimer(currentHub, \"idle\");\n\n  const key = gaslessStreamSelectorKey(selector);\n  let entry = currentHub.selectors.get(key);\n  if (!entry) {\n    entry = { selector, listeners: new Set(), state: \"pending\", notFoundRetries: 0, done: false };\n    currentHub.selectors.set(key, entry);\n  }\n  const currentEntry = entry;\n  /** Rejoined inside its grace: the subscription is still good, so keep it. */\n  clearSelectorIdle(currentEntry);\n  currentEntry.listeners.add(listener);\n  ensureSubscribed(currentHub, key, currentEntry);\n\n  /** Sync the late joiner to the stream's current health. */\n  listener.onStatusChange?.(\n    currentHub.status === \"live\" && currentEntry.state !== \"live\" ? \"degraded\" : currentHub.status,\n    currentHub.detail,\n  );\n\n  /**\n   * A watcher joining a subscription that already delivered starts from what it\n   * delivered: the gateway sends its snapshot once per *subscribe*, not once\n   * per listener, so without this a joiner would wait for a change that may\n   * never come.\n   *\n   * Deferred by a microtask because `watchGaslessRequest` releases its selector\n   * from inside `onUpdate` when the record is terminal — delivering inline\n   * would re-enter the hub in the middle of this acquire.\n   */\n  if (currentEntry.lastUpdate) {\n    queueMicrotask(() => {\n      /** Re-read rather than capture: a frame that landed meanwhile is the one to deliver. */\n      const update = currentEntry.lastUpdate;\n      if (update && currentEntry.listeners.has(listener)) listener.onUpdate(update);\n    });\n  }\n\n  if (currentHub.phase === \"idle\") connect(currentHub);\n\n  let released = false;\n  return () => {\n    if (released) return;\n    released = true;\n    currentEntry.listeners.delete(listener);\n    if (currentEntry.listeners.size > 0) return;\n\n    /**\n     * Nobody is watching, but the next wait on this workflow is often moments\n     * away, so the subscription is held briefly before it is given up — unless\n     * another selector is over the cap and waiting for exactly this slot. The\n     * grace saves a round trip; it is never a claim on a scarce resource.\n     */\n    clearSelectorIdle(currentEntry);\n    if (hasOverflowedSelector(currentHub)) {\n      removeSelector(currentHub, key, currentEntry);\n    } else {\n      currentEntry.idle = setTimeout(() => {\n        currentEntry.idle = undefined;\n        removeSelector(currentHub, key, currentEntry);\n      }, SELECTOR_IDLE_MS);\n    }\n\n    if (!hasWatchers(currentHub)) {\n      clearTimer(currentHub, \"idle\");\n      currentHub.timers.idle = setTimeout(() => {\n        currentHub.timers.idle = undefined;\n        if (hasWatchers(currentHub)) return;\n        for (const entry of currentHub.selectors.values()) clearSelectorIdle(entry);\n        currentHub.selectors.clear();\n        clearAllTimers(currentHub);\n        dropSocket(currentHub);\n        currentHub.phase = currentHub.phase === \"disabled\" ? \"disabled\" : \"idle\";\n        currentRegistry.delete(endpoint.url);\n      }, IDLE_CLOSE_MS);\n    }\n  };\n}\n\n/**\n * Mark a selector finished, so a reconnect does not resubscribe it.\n *\n * The caller decides what \"finished\" means — a terminal workflow status, or a\n * dismissed row — and the hub unsubscribes it from the live socket.\n *\n * @internal\n */\nexport function releaseGaslessStreamSelector(\n  config: Config,\n  endpointUrl: string,\n  selector: GaslessStreamSelector,\n): void {\n  const hub = hubRegistries.get(config)?.get(endpointUrl);\n  if (!hub) return;\n  const key = gaslessStreamSelectorKey(selector);\n  const entry = hub.selectors.get(key);\n  if (!entry || entry.done) return;\n  entry.done = true;\n  if (hub.phase === \"ready\" && entry.state === \"live\") {\n    enqueue(hub, { key, kind: \"unsubscribe\", frame: buildGaslessUnsubscribeCommand(selector) });\n  }\n}\n"],"mappings":"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"}

package/dist/websocket/gasless/index.d.ts

@@ -0,0 +1,7 @@
+export * from './close-code-policy.js';
+export * from './gasless-stream-hub.js';
+export * from './parse-gasless-stream-message.js';
+export * from './resolve-gasless-stream-url.js';
+export * from './types.js';
+export * from './watch-gasless-request.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/websocket/gasless/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/websocket/gasless/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC"}

package/dist/websocket/gasless/parse-gasless-stream-message.d.ts

@@ -0,0 +1,82 @@
+import { GaslessRequest, GaslessRequestTransaction } from '../../gasless/types.js';
+/**
+ * Which workflow a stream frame is about: a request id, or one stored
+ * transaction attempt by hash. Hash selectors are compared lowercase, the form
+ * the gateway echoes.
+ *
+ * @internal
+ */
+export type GaslessStreamSelector = {
+    kind: "request";
+    requestId: string;
+} | {
+    kind: "transaction";
+    txHash: string;
+};
+/**
+ * A parsed inbound stream frame.
+ *
+ * `throttle` is the gateway's own rate-limit notice, which arrives as a bare
+ * `{"error":"Rate limit exceeded"}` — no `type`, no `protocol_instance`, no
+ * selector. It must be recognised before the instance check, or a healthy
+ * socket would be torn down every time a command is throttled.
+ *
+ * @internal
+ */
+export type GaslessStreamMessage = {
+    type: "ready";
+    protocolInstance: string;
+    maxSubscriptions: number;
+} | {
+    type: "snapshot" | "update";
+    protocolInstance: string;
+    selector: GaslessStreamSelector;
+    request: GaslessRequest | null;
+    transactions: readonly GaslessRequestTransaction[];
+} | {
+    type: "unsubscribed";
+    protocolInstance: string;
+    selector: GaslessStreamSelector;
+} | {
+    type: "error";
+    protocolInstance: string | null;
+    code: string;
+    selector: GaslessStreamSelector | null;
+} | {
+    type: "throttle";
+    message: string;
+} | {
+    type: "transport";
+    kind: "heartbeat" | "pong";
+    protocolInstance: string | null;
+} | {
+    type: "unparseable";
+    detail: string;
+};
+/**
+ * Parse one inbound stream frame into a discriminated message.
+ *
+ * Parsing never throws: a malformed frame becomes `unparseable`, so one bad
+ * message cannot take down a socket that is otherwise delivering. The caller
+ * checks `protocolInstance` itself — every frame that carries one exposes it —
+ * after handling `throttle` and `error`.
+ *
+ * A `snapshot`/`update` carries the same models the HTTP reads return, so both
+ * transports normalize through `toGaslessRequest` / `toGaslessRequestTransaction`
+ * and a consumer cannot tell which one produced a record. A record the
+ * normalizer rejects (an unknown status, say) yields `request: null` rather
+ * than throwing, leaving the poll fallback to fetch it.
+ *
+ * @param data - The raw `event.data` from the socket.
+ * @returns The parsed message.
+ *
+ * @internal
+ */
+export declare function parseGaslessStreamMessage(data: unknown): GaslessStreamMessage;
+/** Stable map key for a selector, so listeners and pending commands agree. @internal */
+export declare function gaslessStreamSelectorKey(selector: GaslessStreamSelector): string;
+/** The JSON command that subscribes to a selector. @internal */
+export declare function buildGaslessSubscribeCommand(selector: GaslessStreamSelector): string;
+/** The JSON command that releases a selector. @internal */
+export declare function buildGaslessUnsubscribeCommand(selector: GaslessStreamSelector): string;
+//# sourceMappingURL=parse-gasless-stream-message.d.ts.map

package/dist/websocket/gasless/parse-gasless-stream-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-gasless-stream-message.d.ts","sourceRoot":"","sources":["../../../src/websocket/gasless/parse-gasless-stream-message.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAGrF;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErH;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GACrE;IACE,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACpD,GACD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,qBAAqB,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAA;CAAE,GACxG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAgB5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAkF7E;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAEhF;AAED,gEAAgE;AAChE,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAIpF;AAED,2DAA2D;AAC3D,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAItF"}

package/dist/websocket/gasless/parse-gasless-stream-message.js

@@ -0,0 +1,136 @@
+import { toGaslessRequest as e } from "../../gasless/get-gasless-request/to-gasless-request.js";
+import { toGaslessRequestTransaction as t } from "../../gasless/get-gasless-request-transactions/to-gasless-request-transaction.js";
+//#region src/websocket/gasless/parse-gasless-stream-message.ts
+function n(e) {
+	return typeof e == "object" && e ? e : null;
+}
+function r(e) {
+	let t = n(e);
+	if (!t) return null;
+	let r = t.request_id;
+	if (typeof r == "string" && r !== "") return {
+		kind: "request",
+		requestId: r
+	};
+	let i = t.tx_hash;
+	return typeof i == "string" && i !== "" ? {
+		kind: "transaction",
+		txHash: i.toLowerCase()
+	} : null;
+}
+function i(i) {
+	if (typeof i != "string") return {
+		type: "unparseable",
+		detail: "the frame was not text"
+	};
+	let a;
+	try {
+		a = JSON.parse(i);
+	} catch {
+		return {
+			type: "unparseable",
+			detail: "the frame was not valid JSON"
+		};
+	}
+	let o = n(a);
+	if (!o) return {
+		type: "unparseable",
+		detail: "the frame was not a JSON object"
+	};
+	let s = o.error;
+	if (typeof s == "string" && o.type === void 0) return {
+		type: "throttle",
+		message: s
+	};
+	let c = typeof o.protocol_instance == "string" ? o.protocol_instance : null, l = o.type;
+	if (l === "ready") {
+		if (c === null) return {
+			type: "unparseable",
+			detail: "the ready frame named no protocol instance"
+		};
+		let e = o.max_subscriptions;
+		return {
+			type: "ready",
+			protocolInstance: c,
+			maxSubscriptions: typeof e == "number" && Number.isSafeInteger(e) && e > 0 ? e : 1
+		};
+	}
+	if (l === "error") return {
+		type: "error",
+		protocolInstance: c,
+		code: typeof o.code == "string" ? o.code : "GASLESS_STREAM_PROTOCOL_ERROR",
+		selector: r(o.subscription)
+	};
+	if (l === "heartbeat" || l === "pong") return {
+		type: "transport",
+		kind: l,
+		protocolInstance: c
+	};
+	if (l === "unsubscribed") {
+		let e = r(o.subscription);
+		return !e || c === null ? {
+			type: "unparseable",
+			detail: "the unsubscribed frame named no subscription"
+		} : {
+			type: "unsubscribed",
+			protocolInstance: c,
+			selector: e
+		};
+	}
+	if (l === "snapshot" || l === "update") {
+		let i = r(o.subscription);
+		if (!i || c === null) return {
+			type: "unparseable",
+			detail: `the ${l} frame named no subscription`
+		};
+		let a = n(o.data) ?? {}, s = n(a.request), u = null;
+		if (s && Object.keys(s).length > 0) try {
+			u = e(s);
+		} catch {
+			u = null;
+		}
+		let d = Array.isArray(a.transactions) ? a.transactions : [], f = [];
+		for (let e of d) {
+			let r = n(e);
+			if (r) try {
+				f.push(t(r));
+			} catch {}
+		}
+		return {
+			type: l,
+			protocolInstance: c,
+			selector: i,
+			request: u,
+			transactions: f
+		};
+	}
+	return {
+		type: "unparseable",
+		detail: `unknown frame type ${typeof l == "string" ? `"${l}"` : "(absent)"}`
+	};
+}
+function a(e) {
+	return e.kind === "request" ? `request:${e.requestId}` : `transaction:${e.txHash}`;
+}
+function o(e) {
+	return e.kind === "request" ? JSON.stringify({
+		type: "subscribe",
+		request_id: e.requestId
+	}) : JSON.stringify({
+		type: "subscribe",
+		tx_hash: e.txHash
+	});
+}
+function s(e) {
+	return e.kind === "request" ? JSON.stringify({
+		type: "unsubscribe",
+		request_id: e.requestId
+	}) : JSON.stringify({
+		type: "unsubscribe",
+		tx_hash: e.txHash
+	});
+}
+//#endregion
+export { o as buildGaslessSubscribeCommand, s as buildGaslessUnsubscribeCommand, a as gaslessStreamSelectorKey, i as parseGaslessStreamMessage };
+
+//# sourceMappingURL=parse-gasless-stream-message.js.map

package/dist/websocket/gasless/parse-gasless-stream-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-gasless-stream-message.js","names":[],"sources":["../../../src/websocket/gasless/parse-gasless-stream-message.ts"],"sourcesContent":["import { toGaslessRequestTransaction } from \"../../gasless/get-gasless-request-transactions/to-gasless-request-transaction\";\nimport { toGaslessRequest } from \"../../gasless/get-gasless-request/to-gasless-request\";\nimport type { GaslessRequest, GaslessRequestTransaction } from \"../../gasless/types\";\nimport type { GaslessWireRequestRecord, GaslessWireTransactionAttempt } from \"../../gasless/wire-types\";\n\n/**\n * Which workflow a stream frame is about: a request id, or one stored\n * transaction attempt by hash. Hash selectors are compared lowercase, the form\n * the gateway echoes.\n *\n * @internal\n */\nexport type GaslessStreamSelector = { kind: \"request\"; requestId: string } | { kind: \"transaction\"; txHash: string };\n\n/**\n * A parsed inbound stream frame.\n *\n * `throttle` is the gateway's own rate-limit notice, which arrives as a bare\n * `{\"error\":\"Rate limit exceeded\"}` — no `type`, no `protocol_instance`, no\n * selector. It must be recognised before the instance check, or a healthy\n * socket would be torn down every time a command is throttled.\n *\n * @internal\n */\nexport type GaslessStreamMessage =\n  | { type: \"ready\"; protocolInstance: string; maxSubscriptions: number }\n  | {\n      type: \"snapshot\" | \"update\";\n      protocolInstance: string;\n      selector: GaslessStreamSelector;\n      request: GaslessRequest | null;\n      transactions: readonly GaslessRequestTransaction[];\n    }\n  | { type: \"unsubscribed\"; protocolInstance: string; selector: GaslessStreamSelector }\n  | { type: \"error\"; protocolInstance: string | null; code: string; selector: GaslessStreamSelector | null }\n  | { type: \"throttle\"; message: string }\n  | { type: \"transport\"; kind: \"heartbeat\" | \"pong\"; protocolInstance: string | null }\n  | { type: \"unparseable\"; detail: string };\n\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return typeof value === \"object\" && value !== null ? (value as Record<string, unknown>) : null;\n}\n\nfunction readSelector(value: unknown): GaslessStreamSelector | null {\n  const subscription = asRecord(value);\n  if (!subscription) return null;\n  const requestId = subscription.request_id;\n  if (typeof requestId === \"string\" && requestId !== \"\") return { kind: \"request\", requestId };\n  const txHash = subscription.tx_hash;\n  if (typeof txHash === \"string\" && txHash !== \"\") return { kind: \"transaction\", txHash: txHash.toLowerCase() };\n  return null;\n}\n\n/**\n * Parse one inbound stream frame into a discriminated message.\n *\n * Parsing never throws: a malformed frame becomes `unparseable`, so one bad\n * message cannot take down a socket that is otherwise delivering. The caller\n * checks `protocolInstance` itself — every frame that carries one exposes it —\n * after handling `throttle` and `error`.\n *\n * A `snapshot`/`update` carries the same models the HTTP reads return, so both\n * transports normalize through `toGaslessRequest` / `toGaslessRequestTransaction`\n * and a consumer cannot tell which one produced a record. A record the\n * normalizer rejects (an unknown status, say) yields `request: null` rather\n * than throwing, leaving the poll fallback to fetch it.\n *\n * @param data - The raw `event.data` from the socket.\n * @returns The parsed message.\n *\n * @internal\n */\nexport function parseGaslessStreamMessage(data: unknown): GaslessStreamMessage {\n  if (typeof data !== \"string\") return { type: \"unparseable\", detail: \"the frame was not text\" };\n\n  let payload: unknown;\n  try {\n    payload = JSON.parse(data);\n  } catch {\n    return { type: \"unparseable\", detail: \"the frame was not valid JSON\" };\n  }\n\n  const frame = asRecord(payload);\n  if (!frame) return { type: \"unparseable\", detail: \"the frame was not a JSON object\" };\n\n  /**\n   * The gateway's throttle notice has no `type` at all, so it is recognised\n   * before anything else reads one.\n   */\n  const gatewayError = frame.error;\n  if (typeof gatewayError === \"string\" && frame.type === undefined) {\n    return { type: \"throttle\", message: gatewayError };\n  }\n\n  const protocolInstance = typeof frame.protocol_instance === \"string\" ? frame.protocol_instance : null;\n  const type = frame.type;\n\n  if (type === \"ready\") {\n    if (protocolInstance === null) return { type: \"unparseable\", detail: \"the ready frame named no protocol instance\" };\n    const max = frame.max_subscriptions;\n    return {\n      type: \"ready\",\n      protocolInstance,\n      maxSubscriptions: typeof max === \"number\" && Number.isSafeInteger(max) && max > 0 ? max : 1,\n    };\n  }\n\n  if (type === \"error\") {\n    const code = typeof frame.code === \"string\" ? frame.code : \"GASLESS_STREAM_PROTOCOL_ERROR\";\n    return { type: \"error\", protocolInstance, code, selector: readSelector(frame.subscription) };\n  }\n\n  if (type === \"heartbeat\" || type === \"pong\") {\n    return { type: \"transport\", kind: type, protocolInstance };\n  }\n\n  if (type === \"unsubscribed\") {\n    const selector = readSelector(frame.subscription);\n    if (!selector || protocolInstance === null) {\n      return { type: \"unparseable\", detail: \"the unsubscribed frame named no subscription\" };\n    }\n    return { type: \"unsubscribed\", protocolInstance, selector };\n  }\n\n  if (type === \"snapshot\" || type === \"update\") {\n    const selector = readSelector(frame.subscription);\n    if (!selector || protocolInstance === null) {\n      return { type: \"unparseable\", detail: `the ${type} frame named no subscription` };\n    }\n    const data = asRecord(frame.data) ?? {};\n    const rawRequest = asRecord(data.request);\n    let request: GaslessRequest | null = null;\n    if (rawRequest && Object.keys(rawRequest).length > 0) {\n      try {\n        request = toGaslessRequest(rawRequest as unknown as GaslessWireRequestRecord);\n      } catch {\n        request = null;\n      }\n    }\n    const rawTransactions = Array.isArray(data.transactions) ? data.transactions : [];\n    const transactions: GaslessRequestTransaction[] = [];\n    for (const attempt of rawTransactions) {\n      const record = asRecord(attempt);\n      if (!record) continue;\n      try {\n        transactions.push(toGaslessRequestTransaction(record as unknown as GaslessWireTransactionAttempt));\n      } catch {\n        /** A single unparseable attempt never discards the rest of the frame. */\n      }\n    }\n    return { type: type as \"snapshot\" | \"update\", protocolInstance, selector, request, transactions };\n  }\n\n  return { type: \"unparseable\", detail: `unknown frame type ${typeof type === \"string\" ? `\"${type}\"` : \"(absent)\"}` };\n}\n\n/** Stable map key for a selector, so listeners and pending commands agree. @internal */\nexport function gaslessStreamSelectorKey(selector: GaslessStreamSelector): string {\n  return selector.kind === \"request\" ? `request:${selector.requestId}` : `transaction:${selector.txHash}`;\n}\n\n/** The JSON command that subscribes to a selector. @internal */\nexport function buildGaslessSubscribeCommand(selector: GaslessStreamSelector): string {\n  return selector.kind === \"request\"\n    ? JSON.stringify({ type: \"subscribe\", request_id: selector.requestId })\n    : JSON.stringify({ type: \"subscribe\", tx_hash: selector.txHash });\n}\n\n/** The JSON command that releases a selector. @internal */\nexport function buildGaslessUnsubscribeCommand(selector: GaslessStreamSelector): string {\n  return selector.kind === \"request\"\n    ? JSON.stringify({ type: \"unsubscribe\", request_id: selector.requestId })\n    : JSON.stringify({ type: \"unsubscribe\", tx_hash: selector.txHash });\n}\n"],"mappings":"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"}