@statelyai/sdk 0.15.0 → 0.16.1

package/dist/relay.mjs

@@ -1,6 +1,29 @@
 import { INSPECTION_PROTOCOL_VERSION, PREFIX } from "./protocol.mjs";
 
 //#region src/relay.ts
+const REPLAYABLE_MESSAGE_TYPES = new Set([
+	"@statelyai.init",
+	"@statelyai.inspectSnapshot",
+	"@statelyai.system.init",
+	"@statelyai.system.actorRegistered",
+	"@statelyai.system.actorEvent",
+	"@statelyai.system.actorSnapshot",
+	"@statelyai.system.actorStopped"
+]);
+const FORWARD_ONLY_MESSAGE_TYPES = new Set([
+	"@statelyai.system.selectActor",
+	"@statelyai.retrieve",
+	"@statelyai.retrieved",
+	"@statelyai.error",
+	"@statelyai.ready",
+	"@statelyai.loaded",
+	"@statelyai.capabilityDenied",
+	"@statelyai.register",
+	"@statelyai.registered"
+]);
+function isSupportedMessageType(type) {
+	return REPLAYABLE_MESSAGE_TYPES.has(type) || FORWARD_ONLY_MESSAGE_TYPES.has(type);
+}
 function parseMessage(raw) {
 	if (raw instanceof ArrayBuffer) raw = new TextDecoder().decode(raw);
 	if (typeof raw === "string") try {
@@ -12,6 +35,22 @@ function parseMessage(raw) {
 	const message = raw;
 	return typeof message.type === "string" && message.type.startsWith(PREFIX) ? message : null;
 }
+function validationError(message) {
+	if (!isSupportedMessageType(message.type)) return `Unsupported inspection message type ${String(message.type)}`;
+	const hasString = (key) => typeof message[key] === "string" && message[key] !== "";
+	switch (message.type) {
+		case "@statelyai.system.init": return message.protocolVersion === INSPECTION_PROTOCOL_VERSION && Array.isArray(message.actors) ? null : "system.init requires the current protocolVersion and actors array";
+		case "@statelyai.system.selectActor":
+		case "@statelyai.system.actorStopped": return hasString("sessionId") ? null : `${message.type} requires sessionId`;
+		case "@statelyai.system.actorRegistered": return hasString("sessionId") && hasString("actorId") ? null : "actorRegistered requires sessionId and actorId";
+		case "@statelyai.system.actorEvent": return hasString("sessionId") && "event" in message ? null : "actorEvent requires sessionId and event";
+		case "@statelyai.system.actorSnapshot": return hasString("sessionId") && "snapshot" in message ? null : "actorSnapshot requires sessionId and snapshot";
+		case "@statelyai.retrieve":
+		case "@statelyai.retrieved": return hasString("requestId") ? null : `${message.type} requires requestId`;
+		case "@statelyai.error": return hasString("code") && hasString("message") ? null : "error requires code and message";
+		default: return null;
+	}
+}
 function errorMessage(code, message) {
 	return {
 		type: "@statelyai.error",
@@ -30,10 +69,10 @@ function compactReplay(replay, message, max) {
 		const index = replay.findIndex((entry) => entry.type === "@statelyai.init");
 		if (index >= 0) replay.splice(index, 1);
 	} else if (type === "@statelyai.system.actorSnapshot" || type === "@statelyai.inspectSnapshot") {
-		const actorId = record.actorId;
+		const sessionId = record.sessionId;
 		const index = replay.findIndex((entry) => {
 			const candidate = entry;
-			return candidate.type === type && candidate.actorId === actorId;
+			return candidate.type === type && candidate.sessionId === sessionId;
 		});
 		if (index >= 0) replay.splice(index, 1);
 	}
@@ -41,110 +80,92 @@ function compactReplay(replay, message, max) {
 	if (replay.length > max) replay.splice(0, replay.length - max);
 }
 /**
-* Runtime-neutral WebSocket inspection room.
+* Runtime-neutral implementation of one inspection room.
 *
-* It owns protocol registration, routing, multiplexed session membership, and
-* bounded late-join replay. Node and Durable Object adapters only translate
-* `send` effects to their native WebSocket APIs and persist `snapshot()`.
+* The hosting adapter selects the room from the WebSocket URL. This module
+* owns protocol registration, multi-producer/viewer routing, and bounded
+* per-producer replay.
 */
 function createInspectionRelay(options = {}) {
 	const maxReplayMessages = options.maxReplayMessages ?? 200;
-	const maxReplaySessions = Math.max(1, options.maxReplaySessions ?? 100);
+	const maxReplayProducers = Math.max(1, options.maxReplayProducers ?? 100);
 	const peers = /* @__PURE__ */ new Map();
-	const sessions = new Map(Object.entries(options.snapshot?.sessions ?? {}).slice(-maxReplaySessions).map(([id, replay]) => [id, [...replay]]));
+	const producers = new Map(Object.entries(options.snapshot?.producers ?? {}).slice(-maxReplayProducers).map(([id, replay]) => [id, [...replay]]));
 	const send = (peerId, message) => ({
 		type: "send",
 		peerId,
 		message
 	});
-	function replayTo(peerId, sessionId) {
-		return (sessions.get(sessionId) ?? []).map((message) => send(peerId, message));
-	}
-	function oppositePeers(sender, sessionId) {
-		return Array.from(peers.values()).filter((peer) => peer.id !== sender.id && peer.role !== sender.role && peer.sessionIds.includes(sessionId));
-	}
-	function retainReplay(sessionId, replay) {
-		sessions.delete(sessionId);
-		sessions.set(sessionId, replay);
-		while (sessions.size > maxReplaySessions) {
-			const oldestSessionId = sessions.keys().next().value;
-			if (oldestSessionId === void 0) break;
-			sessions.delete(oldestSessionId);
+	function retainReplay(producerId, replay) {
+		producers.delete(producerId);
+		producers.set(producerId, replay);
+		while (producers.size > maxReplayProducers) {
+			const oldestProducerId = producers.keys().next().value;
+			if (oldestProducerId === void 0) break;
+			producers.delete(oldestProducerId);
 		}
 	}
 	return {
 		connect(peer) {
-			peers.set(peer.id, {
-				...peer,
-				sessionIds: Array.from(new Set([peer.primarySessionId, ...peer.sessionIds]))
-			});
+			peers.set(peer.id, { ...peer });
 		},
 		disconnect(peerId) {
 			peers.delete(peerId);
 		},
 		clear() {
 			peers.clear();
-			sessions.clear();
+			producers.clear();
 		},
 		peer(peerId) {
 			const peer = peers.get(peerId);
-			return peer ? {
-				...peer,
-				sessionIds: [...peer.sessionIds]
-			} : void 0;
+			return peer ? { ...peer } : void 0;
 		},
 		receive(peerId, raw) {
 			const message = parseMessage(raw);
-			if (!message) return [];
+			if (!message) return [send(peerId, errorMessage("invalid_message", "Expected a JSON protocol message"))];
+			const invalid = validationError(message);
+			if (invalid) return [send(peerId, errorMessage("invalid_message", invalid))];
 			if (message.type === "@statelyai.register") {
 				const role = message.role;
-				const sessionId = message.sessionId;
 				const protocolVersion = message.protocolVersion;
-				if (role !== "client" && role !== "viz" || typeof sessionId !== "string" || sessionId.length === 0) return [send(peerId, errorMessage("invalid_registration", "Invalid relay registration"))];
-				if (typeof protocolVersion === "number" && protocolVersion > INSPECTION_PROTOCOL_VERSION) return [send(peerId, errorMessage("unsupported_protocol", `Protocol ${protocolVersion} is not supported`))];
+				const producerId = message.producerId;
+				if (role !== "producer" && role !== "viewer" || role === "producer" && (typeof producerId !== "string" || producerId.length === 0)) return [send(peerId, errorMessage("invalid_registration", "Invalid relay registration"))];
+				if (protocolVersion !== INSPECTION_PROTOCOL_VERSION) return [send(peerId, errorMessage("unsupported_protocol", `Protocol ${String(protocolVersion)} is not supported; expected ${INSPECTION_PROTOCOL_VERSION}`))];
 				const peer = {
 					id: peerId,
 					role,
-					primarySessionId: sessionId,
-					sessionIds: [sessionId]
+					...role === "producer" && { producerId }
 				};
 				peers.set(peerId, peer);
 				const effects = [send(peerId, {
 					type: "@statelyai.registered",
 					protocolVersion: INSPECTION_PROTOCOL_VERSION,
-					sessionId
+					...peer.producerId && { producerId: peer.producerId }
 				})];
-				if (role === "viz") effects.push(...replayTo(peerId, sessionId));
+				if (role === "viewer") for (const replay of producers.values()) effects.push(...replay.map((entry) => send(peerId, entry)));
 				return effects;
 			}
 			const sender = peers.get(peerId);
 			if (!sender) return [send(peerId, errorMessage("not_registered", "Register before sending messages"))];
-			if (message.type === "@statelyai.addSession") {
-				const sessionId = message.sessionId;
-				if (typeof sessionId !== "string" || sessionId.length === 0) return [send(peerId, errorMessage("invalid_session", "Invalid session id"))];
-				if (!sender.sessionIds.includes(sessionId)) sender.sessionIds.push(sessionId);
-				const effects = [send(peerId, {
-					type: "@statelyai.sessionAdded",
-					sessionId
-				})];
-				if (sender.role === "viz") effects.push(...replayTo(peerId, sessionId));
-				return effects;
-			}
-			const sessionId = (typeof message.sessionId === "string" ? message.sessionId : void 0) ?? sender.primarySessionId;
-			if (!sender.sessionIds.includes(sessionId)) return [send(peerId, errorMessage("unknown_session", "Peer is not registered for session"))];
-			const stamped = {
-				...message,
-				sessionId
-			};
-			if (sender.role === "client") {
-				const replay = sessions.get(sessionId) ?? [];
-				compactReplay(replay, stamped, maxReplayMessages);
-				retainReplay(sessionId, replay);
+			if (sender.role === "producer") {
+				const producerId = sender.producerId;
+				const stamped = {
+					...message,
+					producerId
+				};
+				if (REPLAYABLE_MESSAGE_TYPES.has(message.type)) {
+					const replay = producers.get(producerId) ?? [];
+					compactReplay(replay, stamped, maxReplayMessages);
+					retainReplay(producerId, replay);
+				}
+				return Array.from(peers.values()).filter((peer) => peer.role === "viewer").map((peer) => send(peer.id, stamped));
 			}
-			return oppositePeers(sender, sessionId).map((peer) => send(peer.id, stamped));
+			const targetProducerId = typeof message.producerId === "string" ? message.producerId : void 0;
+			return Array.from(peers.values()).filter((peer) => peer.role === "producer" && (!targetProducerId || peer.producerId === targetProducerId)).map((peer) => send(peer.id, message));
 		},
-		snapshot() {
-			return { sessions: Object.fromEntries(Array.from(sessions, ([sessionId, replay]) => [sessionId, [...replay]])) };
+		snapshot(producerId) {
+			const entries = producerId ? producers.has(producerId) ? [[producerId, producers.get(producerId)]] : [] : Array.from(producers.entries());
+			return { producers: Object.fromEntries(entries.map(([producerId, replay]) => [producerId, [...replay]])) };
 		}
 	};
 }

package/dist/studio.d.mts

@@ -1,2 +1,2 @@
-import { A as Machine, C as StudioMachineRecord, D as VerifyApiKeyResponse, E as UpdateProjectInput, F as ProjectVisibility, I as VerifyResult, L as XStateVersion, M as Project, N as ProjectMachineSummary, O as createStatelyClient, P as ProjectSummary, R as ResourceErrorCode, S as StudioClientOptions, T as UpdateMachineInput, _ as ProjectMachine, a as CreateMachineTemplate, b as StudioApiErrorOptions, c as EnsureProjectInput, d as ExtractedMachine, f as GetMachineOptions, g as ProjectData, h as LegacyUpdateMachineInput, i as CreateMachineInput, j as MachineVersion, k as ExtractedMachines, l as ExtractMachinesInput, m as LegacyProjectVisibility, n as CreateMachineFromDefinitionInput, o as CreateProjectInput, p as LegacyExtractMachinesOptions, r as CreateMachineFromTemplateInput, s as DEFAULT_STATELY_BASE_URL, t as ConnectedRepo, u as ExtractMachinesResponse, v as RepoType, w as StudioRequestOptions, x as StudioClient, y as StudioApiError } from "./studio-Da5pyxv6.mjs";
+import { A as Machine, C as StudioMachineRecord, D as VerifyApiKeyResponse, E as UpdateProjectInput, F as ProjectVisibility, I as VerifyResult, L as XStateVersion, M as Project, N as ProjectMachineSummary, O as createStatelyClient, P as ProjectSummary, R as ResourceErrorCode, S as StudioClientOptions, T as UpdateMachineInput, _ as ProjectMachine, a as CreateMachineTemplate, b as StudioApiErrorOptions, c as EnsureProjectInput, d as ExtractedMachine, f as GetMachineOptions, g as ProjectData, h as LegacyUpdateMachineInput, i as CreateMachineInput, j as MachineVersion, k as ExtractedMachines, l as ExtractMachinesInput, m as LegacyProjectVisibility, n as CreateMachineFromDefinitionInput, o as CreateProjectInput, p as LegacyExtractMachinesOptions, r as CreateMachineFromTemplateInput, s as DEFAULT_STATELY_BASE_URL, t as ConnectedRepo, u as ExtractMachinesResponse, v as RepoType, w as StudioRequestOptions, x as StudioClient, y as StudioApiError } from "./studio-Bk_u41gu.mjs";
 export { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, DEFAULT_STATELY_BASE_URL, EnsureProjectInput, ExtractMachinesInput, ExtractMachinesResponse, ExtractedMachine, ExtractedMachines, GetMachineOptions, LegacyExtractMachinesOptions, LegacyProjectVisibility, LegacyUpdateMachineInput, Machine, MachineVersion, Project, ProjectData, ProjectMachine, ProjectMachineSummary, ProjectSummary, ProjectVisibility, RepoType, ResourceErrorCode, StudioApiError, StudioApiErrorOptions, StudioClient, StudioClientOptions, StudioMachineRecord, StudioRequestOptions, UpdateMachineInput, UpdateProjectInput, VerifyApiKeyResponse, VerifyResult, XStateVersion, createStatelyClient };

package/dist/sync.d.mts

@@ -1,5 +1,5 @@
 import { b as DigraphConfig, i as StatelyGraph } from "./graph-DuOeLGvh.mjs";
-import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-Da5pyxv6.mjs";
+import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-Bk_u41gu.mjs";
 import { GraphDiff } from "@statelyai/graph";
 
 //#region src/sync.d.ts

package/dist/{transport-D2Ud05yg.mjs → transport-B_ig9Znn.mjs}

@@ -157,9 +157,7 @@ function createPostMessageTransport(options) {
 		},
 		onMessage(handler) {
 			messageHandlers.add(handler);
-			return () => {
-				messageHandlers.delete(handler);
-			};
+			return () => messageHandlers.delete(handler);
 		},
 		destroy() {
 			if (destroyed) return;
@@ -177,31 +175,52 @@ function createPostMessageTransport(options) {
 				return () => {};
 			}
 			readyHandlers.add(handler);
-			return () => {
-				readyHandlers.delete(handler);
-			};
+			return () => readyHandlers.delete(handler);
 		}
 	};
 }
 function createWebSocketTransport(options) {
-	const { url, role, sessionId, metadata, reconnect = true, maxReconnectAttempts = 10 } = options;
+	const { url, role, producerId, metadata, reconnect = true, maxReconnectAttempts = 10 } = options;
+	if (role === "producer" && !producerId) throw new Error("A producerId is required for producer transports.");
 	let ws = null;
 	let destroyed = false;
+	let terminalFailure = false;
 	let isReady = false;
 	let reconnectAttempts = 0;
 	let reconnectTimer = null;
 	const readyHandlers = /* @__PURE__ */ new Set();
 	const messageHandlers = /* @__PURE__ */ new Set();
+	const errorHandlers = /* @__PURE__ */ new Set();
+	function fail(failure) {
+		errorHandlers.forEach((handler) => handler(failure));
+	}
+	function scheduleReconnect() {
+		if (!reconnect || reconnectAttempts >= maxReconnectAttempts) {
+			terminalFailure = true;
+			fail({
+				code: "connection_failed",
+				message: `Unable to connect to inspection relay ${url}`
+			});
+			return;
+		}
+		const delay = Math.min(1e3 * 2 ** reconnectAttempts, 3e4);
+		reconnectAttempts++;
+		reconnectTimer = setTimeout(connect, delay);
+	}
 	function connect() {
-		if (destroyed) return;
-		ws = new WebSocket(url);
+		if (destroyed || terminalFailure) return;
+		try {
+			ws = new WebSocket(url);
+		} catch {
+			scheduleReconnect();
+			return;
+		}
 		ws.onopen = () => {
-			reconnectAttempts = 0;
 			ws.send(JSON.stringify({
 				type: "@statelyai.register",
 				protocolVersion: INSPECTION_PROTOCOL_VERSION,
 				role,
-				sessionId,
+				...producerId && { producerId },
 				...metadata && { metadata }
 			}));
 		};
@@ -217,20 +236,33 @@ function createWebSocketTransport(options) {
 			if (!raw.type.startsWith(PREFIX)) return;
 			const data = raw;
 			if (data.type === "@statelyai.registered") {
+				if (data.protocolVersion !== INSPECTION_PROTOCOL_VERSION) {
+					terminalFailure = true;
+					fail({
+						code: "unsupported_protocol",
+						message: `Relay selected protocol ${data.protocolVersion}; expected ${INSPECTION_PROTOCOL_VERSION}`
+					});
+					ws?.close(1002, "Unsupported inspection protocol");
+					return;
+				}
+				reconnectAttempts = 0;
 				const wasReady = isReady;
 				isReady = true;
 				if (!wasReady) readyHandlers.forEach((fn) => fn());
+			} else if (data.type === "@statelyai.error" && !isReady) {
+				terminalFailure = true;
+				fail({
+					code: data.code,
+					message: data.message
+				});
+				ws?.close(1002, data.message.slice(0, 123));
 			}
 			messageHandlers.forEach((fn) => fn(data));
 		};
 		ws.onclose = () => {
-			if (destroyed) return;
+			if (destroyed || terminalFailure) return;
 			isReady = false;
-			if (reconnect && reconnectAttempts < maxReconnectAttempts) {
-				const delay = Math.min(1e3 * 2 ** reconnectAttempts, 3e4);
-				reconnectAttempts++;
-				reconnectTimer = setTimeout(connect, delay);
-			}
+			scheduleReconnect();
 		};
 		ws.onerror = () => {};
 	}
@@ -242,9 +274,7 @@ function createWebSocketTransport(options) {
 		},
 		onMessage(handler) {
 			messageHandlers.add(handler);
-			return () => {
-				messageHandlers.delete(handler);
-			};
+			return () => messageHandlers.delete(handler);
 		},
 		destroy() {
 			if (destroyed) return;
@@ -254,6 +284,7 @@ function createWebSocketTransport(options) {
 			ws = null;
 			messageHandlers.clear();
 			readyHandlers.clear();
+			errorHandlers.clear();
 		},
 		get ready() {
 			return isReady && !!ws && ws.readyState === WebSocket.OPEN;
@@ -261,187 +292,14 @@ function createWebSocketTransport(options) {
 		onReady(handler) {
 			readyHandlers.add(handler);
 			if (isReady) handler();
-			return () => {
-				readyHandlers.delete(handler);
-			};
-		}
-	};
-}
-function createMultiplexedWebSocketConnection(options) {
-	const { url, role, sessionId: primarySessionId, metadata: primaryMetadata, reconnect = true, maxReconnectAttempts = 10 } = options;
-	let ws = null;
-	let destroyed = false;
-	let connectionReady = false;
-	let reconnectAttempts = 0;
-	let reconnectTimer = null;
-	const pendingOutbound = [];
-	const channels = /* @__PURE__ */ new Map();
-	function ensureChannel(opts) {
-		const existing = channels.get(opts.sessionId);
-		if (existing) return existing;
-		const state = {
-			sessionId: opts.sessionId,
-			metadata: opts.metadata,
-			ready: false,
-			readyHandlers: /* @__PURE__ */ new Set(),
-			messageHandlers: /* @__PURE__ */ new Set(),
-			registered: false,
-			transport: null
-		};
-		state.transport = {
-			send(msg) {
-				if (destroyed) return;
-				const stamped = {
-					...msg,
-					sessionId: state.sessionId
-				};
-				if (ws && ws.readyState === WebSocket.OPEN && state.registered) {
-					ws.send(JSON.stringify(stamped));
-					return;
-				}
-				pendingOutbound.push(stamped);
-			},
-			onMessage(handler) {
-				state.messageHandlers.add(handler);
-				return () => {
-					state.messageHandlers.delete(handler);
-				};
-			},
-			destroy() {
-				state.messageHandlers.clear();
-				state.readyHandlers.clear();
-				channels.delete(state.sessionId);
-			},
-			get ready() {
-				return state.ready;
-			},
-			onReady(handler) {
-				state.readyHandlers.add(handler);
-				if (state.ready) handler();
-				return () => {
-					state.readyHandlers.delete(handler);
-				};
-			}
-		};
-		channels.set(state.sessionId, state);
-		if (connectionReady && ws && ws.readyState === WebSocket.OPEN) registerChannel(state);
-		return state;
-	}
-	function registerChannel(state) {
-		if (!ws || ws.readyState !== WebSocket.OPEN) return;
-		if (state.registered) return;
-		if (state.sessionId === primarySessionId) return;
-		ws.send(JSON.stringify({
-			type: "@statelyai.addSession",
-			sessionId: state.sessionId,
-			...state.metadata && { metadata: state.metadata }
-		}));
-	}
-	function markChannelReady(sessionId) {
-		const state = channels.get(sessionId);
-		if (!state || state.ready) return;
-		state.ready = true;
-		state.registered = true;
-		state.readyHandlers.forEach((fn) => fn());
-		flushPending();
-	}
-	function flushPending() {
-		if (!ws || ws.readyState !== WebSocket.OPEN) return;
-		const remaining = [];
-		for (const msg of pendingOutbound) {
-			const sessionId = msg.sessionId ?? primarySessionId;
-			const state = channels.get(sessionId);
-			if (state && state.registered) ws.send(JSON.stringify(msg));
-			else remaining.push(msg);
-		}
-		pendingOutbound.length = 0;
-		pendingOutbound.push(...remaining);
-	}
-	function connect() {
-		if (destroyed) return;
-		ws = new WebSocket(url);
-		ws.onopen = () => {
-			reconnectAttempts = 0;
-			ws.send(JSON.stringify({
-				type: "@statelyai.register",
-				protocolVersion: INSPECTION_PROTOCOL_VERSION,
-				role,
-				sessionId: primarySessionId,
-				...primaryMetadata && { metadata: primaryMetadata }
-			}));
-		};
-		ws.onmessage = (event) => {
-			if (destroyed) return;
-			let raw;
-			try {
-				raw = JSON.parse(event.data);
-			} catch {
-				return;
-			}
-			if (!raw?.type || typeof raw.type !== "string") return;
-			if (!raw.type.startsWith(PREFIX)) return;
-			const data = raw;
-			if (data.type === "@statelyai.registered") {
-				connectionReady = true;
-				markChannelReady(primarySessionId);
-				for (const state of channels.values()) if (!state.registered && state.sessionId !== primarySessionId) registerChannel(state);
-				flushPending();
-				return;
-			}
-			if (data.type === "@statelyai.sessionAdded") {
-				const added = data.sessionId;
-				if (added) markChannelReady(added);
-				return;
-			}
-			const sessionId = raw.sessionId ?? primarySessionId;
-			const state = channels.get(sessionId);
-			if (state) state.messageHandlers.forEach((fn) => fn(data));
-		};
-		ws.onclose = () => {
-			if (destroyed) return;
-			connectionReady = false;
-			for (const state of channels.values()) {
-				state.ready = false;
-				state.registered = false;
-			}
-			if (reconnect && reconnectAttempts < maxReconnectAttempts) {
-				const delay = Math.min(1e3 * 2 ** reconnectAttempts, 3e4);
-				reconnectAttempts++;
-				reconnectTimer = setTimeout(connect, delay);
-			}
-		};
-		ws.onerror = () => {};
-	}
-	ensureChannel({
-		sessionId: primarySessionId,
-		metadata: primaryMetadata
-	});
-	connect();
-	return {
-		openChannel(opts) {
-			return ensureChannel(opts).transport;
-		},
-		destroy() {
-			if (destroyed) return;
-			destroyed = true;
-			if (reconnectTimer) clearTimeout(reconnectTimer);
-			ws?.close();
-			ws = null;
-			for (const state of channels.values()) {
-				state.messageHandlers.clear();
-				state.readyHandlers.clear();
-			}
-			channels.clear();
-			pendingOutbound.length = 0;
-		},
-		get ready() {
-			return connectionReady;
+			return () => readyHandlers.delete(handler);
 		},
-		get primarySessionId() {
-			return primarySessionId;
+		onError(handler) {
+			errorHandlers.add(handler);
+			return () => errorHandlers.delete(handler);
 		}
 	};
 }
 
 //#endregion
-export { createPendingExportManager as a, createEventRegistry as i, createPostMessageTransport as n, toInitMessage as o, createWebSocketTransport as r, createMultiplexedWebSocketConnection as t };
+export { toInitMessage as a, createPendingExportManager as i, createWebSocketTransport as n, createEventRegistry as r, createPostMessageTransport as t };

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@statelyai/sdk",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "license": "MIT",
+  "bin": {
+    "stately-sdk": "./dist/bin.mjs"
+  },
   "files": [
     "dist",
     "schemas"
@@ -62,6 +65,10 @@
       "types": "./dist/relay.d.mts",
       "import": "./dist/relay.mjs"
     },
+    "./node-relay": {
+      "types": "./dist/node-relay.d.mts",
+      "import": "./dist/node-relay.mjs"
+    },
     "./statelyai.schema.json": "./schemas/statelyai.schema.json",
     "./schemas/statelyai.schema.json": "./schemas/statelyai.schema.json",
     "./xstate.schema.json": "./schemas/xstate.schema.json",
@@ -73,16 +80,20 @@
     "@statelyai/graph": "^1.0.0",
     "esbuild": "^0.27.0",
     "typescript": "^5.9.3",
+    "ws": "^8.19.0",
     "xstate": "^5.0.0"
   },
   "devDependencies": {
     "@types/json-schema": "^7.0.15",
+    "@types/ws": "^8.18.1",
     "jsdom": "^27.4.0",
     "tsdown": "0.21.0-beta.2",
     "vitest": "^3.2.4",
-    "ws": "^8.19.0",
-    "@statelyai/graph-tools": "0.0.7",
-    "@statelyai/api-contract": "0.0.1"
+    "@statelyai/api-contract": "0.0.1",
+    "@statelyai/graph-tools": "0.0.7"
+  },
+  "engines": {
+    "node": ">=22.4"
   },
   "scripts": {
     "build": "tsdown",