@proj-airi/server-sdk 0.10.2 → 0.11.0

package/dist/index.d.mts

@@ -1,31 +1,7 @@
-import { ContextUpdateStrategy, MessageHeartbeat, MetadataEventSource, ModuleConfigSchema, ModuleDependency, WebSocketBaseEvent, WebSocketEvent, WebSocketEventOptionalSource, WebSocketEventSource, WebSocketEvents } from "@proj-airi/server-shared/types";
+import { ClientConnector, ClientConnector as ClientConnector$1, ClientEvents } from "@proj-airi/better-ws";
+import { ContextUpdateStrategy, ExtensionIdentity, ExtensionModuleIdentity, MessageHeartbeat, ModuleConfigSchema, ModuleDependency, ModulePermissionDeclaration, ProtocolEvents, WebSocketBaseEvent, WebSocketEvent, WebSocketEventOptionalSource, WebSocketEventSource, WebSocketEvents } from "@proj-airi/server-shared/types";
 export * from "@proj-airi/server-shared/types";
 
-//#region src/websocket-like.d.ts
-interface WebSocketMessageEventLike<T = string> {
-  data: T;
-}
-interface WebSocketErrorEventLike {
-  error?: Error | unknown;
-}
-interface WebSocketLike {
-  readonly readyState: number;
-  onopen?: (event?: unknown) => void;
-  onmessage?: (event: WebSocketMessageEventLike) => void;
-  onerror?: (event: WebSocketErrorEventLike | unknown) => void;
-  onclose?: (event?: unknown) => void;
-  send: (data: string | ArrayBufferLike | ArrayBufferView) => void;
-  close: (code?: number, reason?: string) => void;
-  ping?: () => void;
-  pong?: () => void;
-}
-interface WebSocketLikeConstructor {
-  readonly OPEN: number;
-  readonly CLOSING: number;
-  readonly CLOSED: number;
-  new (url: string): WebSocketLike;
-}
-//#endregion
 //#region src/client.d.ts
 type ClientStatus = 'idle' | 'connecting' | 'authenticating' | 'announcing' | 'ready' | 'reconnecting' | 'closing' | 'closed' | 'failed';
 interface ClientHeartbeatOptions {
@@ -45,13 +21,20 @@ interface ClientOptions<C = undefined> {
   url?: string;
   name: string;
   token?: string;
-  websocketConstructor?: WebSocketLikeConstructor;
+  connector?: ClientConnector$1<WebSocketEvent<C>>;
+  /**
+   * Selects the connection handshake owned by this client.
+   *
+   * @default 'module'
+   */
+  handshake?: 'module' | 'manual';
   connectTimeoutMs?: number;
   possibleEvents?: Array<keyof WebSocketEvents<C>>;
-  identity?: MetadataEventSource;
+  extension?: ExtensionIdentity;
+  identity?: ExtensionModuleIdentity;
   dependencies?: ModuleDependency[];
   configSchema?: ModuleConfigSchema;
-  heartbeat?: ClientHeartbeatOptions;
+  heartbeat?: false | ClientHeartbeatOptions;
   autoConnect?: boolean;
   autoReconnect?: boolean;
   maxReconnectAttempts?: number;
@@ -62,24 +45,16 @@ interface ClientOptions<C = undefined> {
   onAnyMessage?: (data: WebSocketEvent<C>) => void;
   onAnySend?: (data: WebSocketEvent<C>) => void;
 }
+/** Wraps a text websocket connector with AIRI protocol serialization. */
+declare function createTextProtocolConnector<C = undefined>(textConnector: ClientConnector$1<string>): ClientConnector$1<WebSocketEvent<C>>;
 declare class Client<C = undefined> {
-  private websocket?;
-  private shouldClose;
-  private connectTask?;
-  private heartbeatTimer?;
-  private lastPingAt;
-  private lastReadAt;
-  private reconnectAttempts;
-  private pendingReconnect;
-  private connectionAttempt?;
-  private failureReason?;
-  private status;
-  private readonly identity;
-  private readonly heartbeat;
-  private readonly websocketConstructor;
   private readonly opts;
+  private readonly transport;
   private readonly eventListeners;
   private readonly stateListeners;
+  private status;
+  private connectTask?;
+  private failureReason?;
   constructor(options: ClientOptions<C>);
   get connectionStatus(): ClientStatus;
   get isReady(): boolean;
@@ -93,33 +68,111 @@ declare class Client<C = undefined> {
   offEvent<E extends keyof WebSocketEvents<C>>(event: E, callback?: (data: WebSocketBaseEvent<E, WebSocketEvents<C>[E]>) => void | Promise<void>): void;
   send(data: WebSocketEventOptionalSource<C>): boolean;
   sendOrThrow(data: WebSocketEventOptionalSource<C>): void;
-  sendRaw(data: string | ArrayBufferLike | ArrayBufferView): boolean;
-  close(): void;
-  private runConnectLoop;
-  private connectOnce;
-  private handleSocketFailure;
-  private cleanupSocket;
-  private rejectAttempt;
-  private resolveAttempt;
-  private canRetry;
-  private getReconnectDelay;
+  close(code?: number, reason?: string): void;
+  private createReconnectOptions;
+  private createHeartbeatOptions;
+  private prepareProtocolConnection;
+  private waitForManualReconnectHandshake;
+  private consumePrepareMessage;
+  private handleMessage;
+  private handleTransportStateChange;
+  private mapTransportStatus;
   private transitionTo;
   private waitForConnection;
-  private tryAnnounce;
-  private tryAuthenticate;
-  private handleMessage;
-  private parseMessage;
-  private handleControlMessage;
-  private isSelfAnnouncement;
-  private dispatchMessage;
+  private waitForReady;
+  private errorFromServerEvent;
+  private normalizeError;
+  private isSelfModuleAnnouncement;
+  private hasSelfModuleInRegistrySync;
   private createPayload;
-  private startHeartbeat;
-  private stopHeartbeat;
-  private sendNativeHeartbeat;
-  private sendHeartbeatPing;
-  private sendHeartbeatPong;
-  private reconnectAfterProtocolError;
 }
+declare function createClient<C = undefined>(options: ClientOptions<C>): Client<C>;
+//#endregion
+//#region src/codec.d.ts
+/** Options for websocket message validation failures. */
+interface InvalidMessageErrorOptions {
+  /** Original parser or validator failure that made the websocket message unusable. */
+  cause?: unknown;
+  /** Parsed candidate event when available; otherwise the original websocket text. */
+  source?: unknown;
+}
+/** Error thrown when websocket text cannot be parsed as an AIRI event envelope. */
+declare class InvalidMessageError extends Error {
+  readonly source?: unknown;
+  constructor(options?: InvalidMessageErrorOptions);
+}
+/** Parses one AIRI websocket protocol event from SuperJSON or plain JSON text. */
+declare function parseEvent<C = undefined>(text: string): WebSocketEvent<C>;
+/** Serializes one AIRI websocket protocol event with SuperJSON. */
+declare function stringifyEvent<C = undefined>(event: WebSocketBaseEvent<string, unknown> | WebSocketEvent<C>): string;
+//#endregion
+//#region src/extension-peer.d.ts
+/**
+ * Describes the client operations required by {@link WebSocketExtensionPeer}.
+ *
+ * @param C - Optional custom protocol event map carried by the websocket client.
+ */
+interface ExtensionPeerClient<C = undefined> {
+  connect: (options?: ConnectOptions) => Promise<void>;
+  send: (data: WebSocketEventOptionalSource<C>) => boolean;
+  sendOrThrow: (data: WebSocketEventOptionalSource<C>) => void;
+  close: () => void;
+  onEvent?: <E extends keyof WebSocketEvents<C>>(event: E, callback: (data: WebSocketBaseEvent<E, WebSocketEvents<C>[E]>) => void | Promise<void>) => () => void;
+}
+/**
+ * Describes one module announcement emitted through a websocket extension peer.
+ *
+ * @param C - Optional custom protocol event map used for possible event declarations.
+ */
+interface AnnounceExtensionModuleInput<C = undefined> {
+  /** Stable module id within the owning extension session. */
+  id: string;
+  /** Human-readable module name used by registry and diagnostics. */
+  name: string;
+  /** Protocol events this module may emit or handle. */
+  possibleEvents?: Array<keyof ProtocolEvents<C>>;
+  /** Runtime permissions requested by this module. */
+  permissions?: ModulePermissionDeclaration;
+  /** Optional configuration schema understood by the module. */
+  configSchema?: ModuleConfigSchema;
+  /** Other modules or capabilities this module expects to exist. */
+  dependencies?: ModuleDependency[];
+  /** Optional labels for routing, diagnostics, or inspector views. */
+  labels?: Record<string, string>;
+}
+/**
+ * Options for creating a websocket-backed extension peer. Supplying `client` lets
+ * tests and embedding runtimes provide their own protocol client implementation.
+ *
+ * @param C - Optional custom protocol event map carried by the websocket client.
+ */
+interface WebSocketExtensionPeerOptions<C = undefined> {
+  extension: ExtensionIdentity;
+  client?: ExtensionPeerClient<C>;
+  clientOptions?: Omit<ClientOptions<C>, 'name' | 'identity'>;
+}
+/**
+ * Provides extension-level protocol helpers over a server-sdk protocol client.
+ */
+declare class WebSocketExtensionPeer<C = undefined> {
+  private readonly client;
+  private readonly extension;
+  constructor(options: WebSocketExtensionPeerOptions<C>);
+  connect(options?: ConnectOptions): Promise<void>;
+  authenticatePeer(input?: {
+    token?: string;
+    peerId?: string;
+  }): void;
+  announceExtension(input?: {
+    permissions?: ModulePermissionDeclaration;
+  }): void;
+  announceModule(input: AnnounceExtensionModuleInput<C>): void;
+  send(data: WebSocketEventOptionalSource<C>): boolean;
+  onEvent<E extends keyof WebSocketEvents<C>>(event: E, callback: (data: WebSocketBaseEvent<E, WebSocketEvents<C>[E]>) => void | Promise<void>): () => void;
+  close(): void;
+}
+/** Creates a websocket extension peer over a server-sdk protocol client. */
+declare function createWebSocketExtensionPeer<C = undefined>(options: WebSocketExtensionPeerOptions<C>): WebSocketExtensionPeer<C>;
 //#endregion
-export { Client, ClientHeartbeatOptions, ClientOptions, ClientStateChangeContext, ClientStatus, ConnectOptions, ContextUpdateStrategy, WebSocketErrorEventLike, WebSocketEventSource, WebSocketLike, WebSocketLikeConstructor, WebSocketMessageEventLike };
+export { AnnounceExtensionModuleInput, Client, type ClientConnector, type ClientEvents, ClientHeartbeatOptions, ClientOptions, ClientStateChangeContext, ClientStatus, ConnectOptions, ContextUpdateStrategy, ExtensionPeerClient, InvalidMessageError, InvalidMessageErrorOptions, WebSocketEventSource, WebSocketExtensionPeer, WebSocketExtensionPeerOptions, createClient, createTextProtocolConnector, createWebSocketExtensionPeer, parseEvent, stringifyEvent };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,8 +1,58 @@
-import NativeWebSocket from "crossws/websocket";
-import superjson from "superjson";
-import { errorMessageFrom, sleep } from "@moeru/std";
+import { errorMessageFrom } from "@moeru/std";
+import { createClient as createClient$1 } from "@proj-airi/better-ws";
+import { createCrossWsConnector } from "@proj-airi/better-ws/client/crossws";
 import { isTerminalAuthenticationServerErrorMessage, parseServerErrorMessage } from "@proj-airi/server-shared";
 import { ContextUpdateStrategy, MessageHeartbeat, MessageHeartbeatKind, WebSocketEventSource } from "@proj-airi/server-shared/types";
+import { parse, stringify } from "superjson";
+import { check, objectWithRest, pipe, safeParse, string, unknown } from "valibot";
+//#region src/codec.ts
+const invalidMessage = "Invalid AIRI websocket message.";
+const eventDataSchema = pipe(unknown(), check((value) => Boolean(value) && typeof value === "object" && !Array.isArray(value), "Expected event data to be a non-array object."));
+const eventEnvelopeSchema = objectWithRest({
+	type: string(),
+	data: eventDataSchema
+}, unknown());
+/** Error thrown when websocket text cannot be parsed as an AIRI event envelope. */
+var InvalidMessageError = class extends Error {
+	source;
+	constructor(options = {}) {
+		super(invalidMessage, { cause: options.cause });
+		this.name = "InvalidMessageError";
+		this.source = options.source;
+	}
+};
+/** Parses one AIRI websocket protocol event from SuperJSON or plain JSON text. */
+function parseEvent(text) {
+	let superJsonParsed;
+	let superJsonError;
+	try {
+		superJsonParsed = parse(text);
+	} catch (error) {
+		superJsonError = error;
+	}
+	const potentialEvent = superJsonParsed && typeof superJsonParsed === "object" && "type" in superJsonParsed ? superJsonParsed : parsePlainJson(text, superJsonError);
+	const result = safeParse(eventEnvelopeSchema, potentialEvent);
+	if (!result.success) throw new InvalidMessageError({
+		cause: result.issues,
+		source: potentialEvent
+	});
+	return potentialEvent;
+}
+/** Serializes one AIRI websocket protocol event with SuperJSON. */
+function stringifyEvent(event) {
+	return stringify(event);
+}
+function parsePlainJson(text, superJsonError) {
+	try {
+		return JSON.parse(text);
+	} catch (jsonError) {
+		throw new InvalidMessageError({
+			cause: superJsonError ?? jsonError,
+			source: text
+		});
+	}
+}
+//#endregion
 //#region src/client.ts
 function createInstanceId() {
 	return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
@@ -10,19 +60,8 @@ function createInstanceId() {
 function createEventId() {
 	return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
 }
-function createDeferredPromise() {
-	let resolve;
-	let reject;
-	return {
-		promise: new Promise((innerResolve, innerReject) => {
-			resolve = innerResolve;
-			reject = innerReject;
-		}),
-		reject,
-		resolve
-	};
-}
 function normalizeHeartbeatOptions(heartbeat) {
+	if (heartbeat === false) return false;
 	const readTimeout = heartbeat?.readTimeout ?? 3e4;
 	const pingInterval = heartbeat?.pingInterval ?? Math.max(1e3, Math.floor(readTimeout / 2));
 	return {
@@ -31,55 +70,95 @@ function normalizeHeartbeatOptions(heartbeat) {
 		message: heartbeat?.message ?? MessageHeartbeat.Ping
 	};
 }
+/** Wraps a text websocket connector with AIRI protocol serialization. */
+function createTextProtocolConnector(textConnector) {
+	return { async connect(events) {
+		const connection = await textConnector.connect({
+			message(text) {
+				try {
+					events.message(parseEvent(text));
+				} catch (error) {
+					events.error(error);
+				}
+			},
+			close: (details) => events.close(details),
+			error: (error) => events.error(error)
+		});
+		return {
+			send: (message) => connection.send(stringifyEvent(message)),
+			close: (code, reason) => connection.close?.(code, reason),
+			ping: connection.ping,
+			pong: connection.pong
+		};
+	} };
+}
+function createDefaultProtocolConnector(url) {
+	return createTextProtocolConnector(createCrossWsConnector({ url }));
+}
+function normalizeOptions(options) {
+	const url = options.url ?? "ws://localhost:6121/ws";
+	const extension = options.extension ?? { id: options.name };
+	const identity = options.identity ?? {
+		id: createInstanceId(),
+		extension
+	};
+	return {
+		url,
+		name: options.name,
+		token: options.token,
+		connector: options.connector ?? createDefaultProtocolConnector(url),
+		handshake: options.handshake ?? "module",
+		connectTimeoutMs: options.connectTimeoutMs ?? 15e3,
+		possibleEvents: options.possibleEvents ?? [],
+		extension,
+		identity,
+		dependencies: options.dependencies ?? [],
+		configSchema: options.configSchema,
+		heartbeat: normalizeHeartbeatOptions(options.heartbeat),
+		autoConnect: options.autoConnect ?? true,
+		autoReconnect: options.autoReconnect ?? true,
+		maxReconnectAttempts: options.maxReconnectAttempts ?? -1,
+		onError: options.onError ?? (() => {}),
+		onClose: options.onClose ?? (() => {}),
+		onReady: options.onReady ?? (() => {}),
+		onStateChange: options.onStateChange ?? (() => {}),
+		onAnyMessage: options.onAnyMessage ?? (() => {}),
+		onAnySend: options.onAnySend ?? (() => {})
+	};
+}
+function createConnectionTimeoutError(timeout) {
+	return /* @__PURE__ */ new Error(`Connection timed out after ${timeout}ms`);
+}
+function createAbortError() {
+	return /* @__PURE__ */ new Error("Connection aborted");
+}
 var Client = class {
-	websocket;
-	shouldClose = false;
-	connectTask;
-	heartbeatTimer;
-	lastPingAt = 0;
-	lastReadAt = 0;
-	reconnectAttempts = 0;
-	pendingReconnect = false;
-	connectionAttempt;
-	failureReason;
-	status = "idle";
-	identity;
-	heartbeat;
-	websocketConstructor;
 	opts;
+	transport;
 	eventListeners = /* @__PURE__ */ new Map();
 	stateListeners = /* @__PURE__ */ new Set();
+	status = "idle";
+	connectTask;
+	failureReason;
 	constructor(options) {
-		const { websocketConstructor, ...clientOptions } = options;
-		const identity = options.identity ?? {
-			kind: "plugin",
-			plugin: { id: options.name },
-			id: createInstanceId()
-		};
-		const heartbeat = normalizeHeartbeatOptions(options.heartbeat);
-		this.opts = {
-			url: "ws://localhost:6121/ws",
-			connectTimeoutMs: 15e3,
-			onAnyMessage: () => {},
-			onAnySend: () => {},
-			possibleEvents: [],
-			dependencies: [],
-			configSchema: void 0,
-			onError: () => {},
-			onClose: () => {},
-			onReady: () => {},
-			onStateChange: () => {},
-			autoConnect: true,
-			autoReconnect: true,
-			maxReconnectAttempts: -1,
-			...clientOptions,
-			heartbeat,
-			identity
-		};
-		this.identity = identity;
-		this.heartbeat = heartbeat;
-		this.websocketConstructor = websocketConstructor ?? NativeWebSocket;
-		if (this.opts.autoConnect) this.connect();
+		this.opts = normalizeOptions(options);
+		this.transport = createClient$1({
+			connector: this.opts.connector,
+			reconnect: this.createReconnectOptions(),
+			heartbeat: this.createHeartbeatOptions(),
+			prepare: (context) => this.prepareProtocolConnection(context)
+		});
+		this.transport.onMessage(({ message }) => {
+			this.handleMessage(message);
+		});
+		this.transport.onStateChange(({ previousState, state }) => {
+			this.handleTransportStateChange(previousState, state);
+		});
+		if (this.opts.autoConnect) this.connect().catch((error) => {
+			const normalized = this.normalizeError(error, "Failed to connect websocket client");
+			this.failureReason = normalized;
+			this.opts.onError(normalized);
+		});
 	}
 	get connectionStatus() {
 		return this.status;
@@ -88,16 +167,16 @@ var Client = class {
 		return this.status === "ready";
 	}
 	get isSocketOpen() {
-		return this.websocket?.readyState === this.websocketConstructor.OPEN;
+		return this.transport.state === "open" || this.transport.state === "preparing" || this.transport.state === "ready";
 	}
 	get lastError() {
 		return this.failureReason;
 	}
 	async connect(options) {
-		if (this.shouldClose) throw new Error("Client is closed");
 		if (this.status === "ready") return;
-		if (this.connectTask) return this.waitForConnection(this.connectTask, options);
-		this.connectTask = this.runConnectLoop().finally(() => {
+		if (!this.connectTask && this.transport.state === "reconnecting") return this.waitForConnection(this.waitForReady(), options);
+		if (!this.connectTask && (this.transport.state === "open" || this.transport.state === "preparing")) return this.waitForConnection(this.waitForReady(), options);
+		if (!this.connectTask) this.connectTask = this.transport.connect().finally(() => {
 			this.connectTask = void 0;
 		});
 		return this.waitForConnection(this.connectTask, options);
@@ -131,167 +210,162 @@ var Client = class {
 		if (callback) {
 			listeners.delete(callback);
 			if (!listeners.size) this.eventListeners.delete(event);
-		} else this.eventListeners.delete(event);
+			return;
+		}
+		this.eventListeners.delete(event);
 	}
 	send(data) {
-		if (!this.isSocketOpen || !this.websocket) return false;
 		const payload = this.createPayload(data);
-		this.opts.onAnySend?.(payload);
-		this.websocket.send(superjson.stringify(payload));
+		if (!this.transport.send(payload).ok) return false;
+		this.opts.onAnySend(payload);
 		return true;
 	}
 	sendOrThrow(data) {
 		if (!this.send(data)) throw new Error(`Client is not connected, current status: ${this.status}`);
 	}
-	sendRaw(data) {
-		if (!this.isSocketOpen || !this.websocket) return false;
-		this.websocket.send(data);
-		return true;
+	close(code, reason) {
+		this.transport.close(code, reason);
 	}
-	close() {
-		this.shouldClose = true;
-		this.pendingReconnect = false;
-		this.transitionTo("closing");
-		this.stopHeartbeat();
-		this.rejectAttempt(/* @__PURE__ */ new Error("Client closed"));
-		const websocket = this.websocket;
-		this.websocket = void 0;
-		if (websocket && websocket.readyState !== this.websocketConstructor.CLOSED && websocket.readyState !== this.websocketConstructor.CLOSING) websocket.close();
-		this.transitionTo("closed");
-	}
-	async runConnectLoop() {
-		this.pendingReconnect = false;
-		while (!this.shouldClose) {
-			const reconnecting = this.reconnectAttempts > 0;
-			this.transitionTo(reconnecting ? "reconnecting" : "connecting");
-			try {
-				await this.connectOnce();
-				this.reconnectAttempts = 0;
-				return;
-			} catch (error) {
-				const normalizedError = error instanceof Error ? error : new Error(errorMessageFrom(error) ?? "Failed to connect websocket client");
-				this.failureReason = normalizedError;
-				this.opts.onError?.(normalizedError);
-				if (this.shouldClose) throw normalizedError;
-				if (isTerminalAuthenticationServerErrorMessage(normalizedError.message)) {
-					this.transitionTo("failed");
-					throw normalizedError;
-				}
-				if (!this.opts.autoReconnect && reconnecting) {
-					this.transitionTo("failed");
-					throw normalizedError;
-				}
-				if (!this.canRetry()) {
-					this.transitionTo("failed");
-					throw normalizedError;
-				}
-				const delay = this.getReconnectDelay(this.reconnectAttempts);
-				this.reconnectAttempts += 1;
-				await sleep(delay);
+	createReconnectOptions() {
+		if (!this.opts.autoReconnect) return false;
+		return {
+			retries: (attempt, error) => {
+				if (isTerminalAuthenticationServerErrorMessage(this.normalizeError(error, "Failed to connect websocket client").message)) return false;
+				return this.opts.maxReconnectAttempts === -1 || attempt <= this.opts.maxReconnectAttempts;
+			},
+			onFailed: (error) => {
+				const normalized = this.normalizeError(error, "Failed to connect websocket client");
+				if (this.failureReason === normalized) return;
+				this.failureReason = normalized;
+				this.opts.onError(normalized);
 			}
-		}
-		throw new Error("Client is closed");
-	}
-	connectOnce() {
-		const WebSocketConstructor = this.websocketConstructor;
-		const ws = new WebSocketConstructor(this.opts.url);
-		this.websocket = ws;
-		this.lastReadAt = Date.now();
-		this.lastPingAt = 0;
-		const deferred = createDeferredPromise();
-		const attempt = {
-			announced: false,
-			authenticated: !this.opts.token,
-			promise: deferred.promise,
-			reject: deferred.reject,
-			resolve: deferred.resolve,
-			socket: ws
-		};
-		this.connectionAttempt = attempt;
-		const isCurrentSocket = () => this.websocket === ws;
-		const connectTimeoutMs = this.opts.connectTimeoutMs;
-		const connectTimer = setTimeout(() => {
-			if (ws.readyState === WebSocket.OPEN) return;
-			ws.close();
-			deferred.reject(/* @__PURE__ */ new Error(`Connection timeout after ${connectTimeoutMs}ms`));
-		}, connectTimeoutMs);
-		const clearConnectTimer = () => {
-			clearTimeout(connectTimer);
 		};
-		ws.onmessage = (event) => {
-			if (!isCurrentSocket()) return;
-			this.handleMessage(event);
-		};
-		ws.onerror = (event) => {
-			clearConnectTimer();
-			if (!isCurrentSocket()) return;
-			const error = event?.error instanceof Error ? event.error : /* @__PURE__ */ new Error("WebSocket error");
-			if (this.connectionAttempt) this.handleSocketFailure(error, ws);
-			else {
-				this.opts.onError?.(error);
-				this.reconnectAfterProtocolError(error);
-			}
+	}
+	createHeartbeatOptions() {
+		if (!this.opts.heartbeat) return false;
+		return {
+			mode: "message",
+			interval: this.opts.heartbeat.pingInterval,
+			timeout: this.opts.heartbeat.readTimeout,
+			message: () => this.createPayload({
+				type: "transport:connection:heartbeat",
+				data: {
+					kind: MessageHeartbeatKind.Ping,
+					message: this.opts.heartbeat ? this.opts.heartbeat.message : MessageHeartbeat.Ping,
+					at: Date.now()
+				}
+			})
 		};
-		ws.onclose = () => {
-			clearConnectTimer();
-			if (!isCurrentSocket()) return;
-			const wasReady = this.status === "ready";
-			this.cleanupSocket(ws);
-			this.opts.onClose?.();
-			if (this.shouldClose) return;
-			if (wasReady && this.opts.autoReconnect) {
-				this.pendingReconnect = true;
-				this.transitionTo("idle");
-				this.connect();
-				return;
+	}
+	async prepareProtocolConnection(context) {
+		if (this.opts.handshake === "manual") {
+			if (!context.reconnecting) return;
+			this.transitionTo("authenticating");
+			await this.waitForManualReconnectHandshake(context);
+			return;
+		}
+		if (this.opts.token) {
+			this.transitionTo("authenticating");
+			context.send(this.createPayload({
+				type: "module:authenticate",
+				data: { token: this.opts.token }
+			}));
+			await context.waitFor((message) => {
+				const result = this.consumePrepareMessage(message);
+				if (result.error) throw result.error;
+				return message.type === "module:authenticated" && message.data.authenticated === true;
+			}, { timeout: this.opts.connectTimeoutMs });
+		}
+		this.transitionTo("announcing");
+		context.send(this.createPayload({
+			type: "extension:module:announce",
+			data: {
+				name: this.opts.name,
+				identity: this.opts.identity,
+				possibleEvents: this.opts.possibleEvents,
+				configSchema: this.opts.configSchema,
+				dependencies: this.opts.dependencies
 			}
-			this.rejectAttempt(/* @__PURE__ */ new Error("WebSocket closed"));
-		};
-		ws.onopen = () => {
-			clearConnectTimer();
-			if (!isCurrentSocket()) return;
-			this.startHeartbeat();
-			if (this.opts.token) {
-				attempt.authenticated = false;
-				this.transitionTo("authenticating");
-				this.tryAuthenticate();
-			} else {
-				attempt.authenticated = true;
-				this.transitionTo("announcing");
-				this.tryAnnounce();
+		}));
+		await context.waitFor((message) => {
+			const result = this.consumePrepareMessage(message);
+			if (result.error) throw result.error;
+			return result.ready;
+		}, { timeout: this.opts.connectTimeoutMs });
+	}
+	async waitForManualReconnectHandshake(context) {
+		await context.waitFor((message) => {
+			const result = this.consumePrepareMessage(message);
+			if (result.error) throw result.error;
+			return message.type === "peer:authenticated" && message.data.authenticated === true;
+		}, { timeout: this.opts.connectTimeoutMs });
+		this.transitionTo("announcing");
+		await context.waitFor((message) => {
+			const result = this.consumePrepareMessage(message);
+			if (result.error) throw result.error;
+			return message.type === "extension:announced" && message.data.identity.id === this.opts.extension.id;
+		}, { timeout: this.opts.connectTimeoutMs });
+	}
+	consumePrepareMessage(message) {
+		const error = this.errorFromServerEvent(message);
+		if (error) {
+			this.failureReason = error;
+			return {
+				ready: false,
+				error
+			};
+		}
+		if (message.type === "extension:module:announced") return { ready: this.isSelfModuleAnnouncement(message) };
+		if (message.type === "registry:modules:sync") return { ready: this.hasSelfModuleInRegistrySync(message) };
+		return { ready: false };
+	}
+	async handleMessage(message) {
+		this.opts.onAnyMessage(message);
+		const error = this.errorFromServerEvent(message);
+		if (error) {
+			this.failureReason = error;
+			this.opts.onError(error);
+		}
+		if (message.type === "transport:connection:heartbeat" && message.data.kind === MessageHeartbeatKind.Ping) this.send({
+			type: "transport:connection:heartbeat",
+			data: {
+				kind: MessageHeartbeatKind.Pong,
+				message: MessageHeartbeat.Pong,
+				at: Date.now()
 			}
-		};
-		return attempt.promise;
-	}
-	handleSocketFailure(error, socket) {
-		if (socket && this.websocket !== socket) return;
-		const currentSocket = socket ?? this.websocket;
-		this.cleanupSocket(socket);
-		if (currentSocket && currentSocket.readyState !== this.websocketConstructor.CLOSED && currentSocket.readyState !== this.websocketConstructor.CLOSING) currentSocket.close();
-		this.rejectAttempt(error);
-	}
-	cleanupSocket(socket) {
-		if (socket && this.websocket !== socket) return;
-		this.stopHeartbeat();
-		if (!socket || this.websocket === socket) this.websocket = void 0;
-	}
-	rejectAttempt(error) {
-		if (!this.connectionAttempt) return;
-		const attempt = this.connectionAttempt;
-		this.connectionAttempt = void 0;
-		attempt.reject(error);
-	}
-	resolveAttempt() {
-		if (!this.connectionAttempt) return;
-		const attempt = this.connectionAttempt;
-		this.connectionAttempt = void 0;
-		attempt.resolve();
-	}
-	canRetry() {
-		return this.opts.maxReconnectAttempts === -1 || this.reconnectAttempts < this.opts.maxReconnectAttempts;
-	}
-	getReconnectDelay(attempts) {
-		return Math.min(2 ** attempts * 1e3, 3e4);
+		});
+		const listeners = this.eventListeners.get(message.type);
+		if (!listeners?.size) return;
+		const results = await Promise.allSettled(Array.from(listeners).map((listener) => Promise.resolve(listener(message))));
+		for (const result of results) if (result.status === "rejected") {
+			this.failureReason = this.normalizeError(result.reason, "Client event listener failed");
+			this.opts.onError(result.reason);
+		}
+	}
+	handleTransportStateChange(previousState, state) {
+		if (state === "ready") {
+			this.transitionTo("ready");
+			this.opts.onReady();
+			return;
+		}
+		const nextStatus = this.mapTransportStatus(state);
+		if (!nextStatus) return;
+		this.transitionTo(nextStatus);
+		if (previousState === "ready" && state === "reconnecting") this.opts.onClose();
+		else if (state === "closed") this.opts.onClose();
+	}
+	mapTransportStatus(state) {
+		switch (state) {
+			case "idle":
+			case "connecting":
+			case "reconnecting":
+			case "closing":
+			case "closed":
+			case "failed": return state;
+			case "open":
+			case "preparing":
+			case "ready": return;
+		}
 	}
 	transitionTo(status) {
 		if (this.status === status) return;
@@ -301,26 +375,24 @@ var Client = class {
 			previousStatus,
 			status
 		};
-		this.opts.onStateChange?.(context);
+		this.opts.onStateChange(context);
 		for (const listener of this.stateListeners) listener(context);
 	}
 	async waitForConnection(connectPromise, options) {
 		if (!options?.timeout && !options?.abortSignal) return connectPromise;
 		const timeout = options?.timeout;
-		if (typeof timeout !== "undefined" && timeout <= 0) throw new Error(`Connection timed out after ${timeout}ms`);
+		if (typeof timeout !== "undefined" && timeout <= 0) throw createConnectionTimeoutError(timeout);
 		const abortSignal = options?.abortSignal;
-		if (abortSignal?.aborted) throw new Error("Connection aborted");
+		if (abortSignal?.aborted) throw createAbortError();
 		let timeoutHandle;
 		let removeAbortListener;
 		try {
 			await Promise.race([connectPromise, new Promise((_, reject) => {
 				if (typeof timeout !== "undefined") timeoutHandle = setTimeout(() => {
-					reject(/* @__PURE__ */ new Error(`Connection timed out after ${timeout}ms`));
+					reject(createConnectionTimeoutError(timeout));
 				}, timeout);
 				if (abortSignal) {
-					const onAbort = () => {
-						reject(/* @__PURE__ */ new Error("Connection aborted"));
-					};
+					const onAbort = () => reject(createAbortError());
 					abortSignal.addEventListener("abort", onAbort, { once: true });
 					removeAbortListener = () => abortSignal.removeEventListener("abort", onAbort);
 				}
@@ -330,187 +402,128 @@ var Client = class {
 			removeAbortListener?.();
 		}
 	}
-	tryAnnounce() {
-		this.sendOrThrow({
-			type: "module:announce",
-			data: {
-				name: this.opts.name,
-				identity: this.identity,
-				possibleEvents: this.opts.possibleEvents,
-				dependencies: this.opts.dependencies,
-				configSchema: this.opts.configSchema
-			}
-		});
-	}
-	tryAuthenticate() {
-		if (!this.opts.token) return;
-		this.sendOrThrow({
-			type: "module:authenticate",
-			data: { token: this.opts.token }
-		});
-	}
-	async handleMessage(event) {
-		this.lastReadAt = Date.now();
-		try {
-			const data = this.parseMessage(event.data);
-			this.opts.onAnyMessage?.(data);
-			await this.handleControlMessage(data);
-			await this.dispatchMessage(data);
-		} catch (error) {
-			const normalizedError = error instanceof Error ? error : new Error(errorMessageFrom(error) ?? "Failed to handle websocket message");
-			this.opts.onError?.(normalizedError);
-			if (this.connectionAttempt && this.status !== "ready") this.handleSocketFailure(normalizedError);
-		}
-	}
-	parseMessage(raw) {
-		try {
-			const parsed = superjson.parse(raw);
-			if (parsed && typeof parsed === "object" && "type" in parsed) return parsed;
-		} catch {}
-		const parsed = JSON.parse(raw);
-		if (!parsed || typeof parsed !== "object" || !("type" in parsed)) throw new Error("Received invalid websocket message");
-		return parsed;
-	}
-	async handleControlMessage(data) {
-		switch (data.type) {
-			case "error": {
-				const message = data.data?.message;
-				if (!message || typeof message !== "string") return;
-				const parsedServerError = parseServerErrorMessage(message);
-				if (parsedServerError.authentication) {
-					const error = new Error(message);
-					if (parsedServerError.terminal) {
-						this.shouldClose = true;
-						this.handleSocketFailure(error);
-						this.transitionTo("failed");
-						return;
-					}
-					await this.reconnectAfterProtocolError(error);
+	waitForReady() {
+		if (this.status === "ready") return Promise.resolve();
+		return new Promise((resolve, reject) => {
+			const dispose = this.onConnectionStateChange(({ status }) => {
+				if (status === "ready") {
+					dispose();
+					resolve();
 					return;
 				}
-				if (parsedServerError.code !== "unknown") throw new Error(parsedServerError.message);
-				throw new Error(message);
-			}
-			case "module:authenticated":
-				if (data.data.authenticated) {
-					if (!this.connectionAttempt || this.connectionAttempt.authenticated) return;
-					this.connectionAttempt.authenticated = true;
-					this.transitionTo("announcing");
-					this.tryAnnounce();
-					return;
+				if (status === "failed" || status === "closed") {
+					dispose();
+					reject(this.failureReason ?? /* @__PURE__ */ new Error(`Client connection ended with status: ${status}`));
 				}
-				throw new Error("Authentication failed");
-			case "module:announced":
-				if (!this.isSelfAnnouncement(data)) return;
-				if (this.status === "ready") return;
-				if (this.connectionAttempt) this.connectionAttempt.announced = true;
-				this.reconnectAttempts = 0;
-				this.transitionTo("ready");
-				this.resolveAttempt();
-				this.opts.onReady?.();
-				return;
-			case "registry:modules:sync":
-				if (this.status !== "announcing" || !this.connectionAttempt) return;
-				if (!(data.data?.modules ?? []).some((m) => m.name === this.opts.name && m.identity?.id === this.identity.id)) return;
-				if (this.connectionAttempt) this.connectionAttempt.announced = true;
-				this.reconnectAttempts = 0;
-				this.transitionTo("ready");
-				this.resolveAttempt();
-				this.opts.onReady?.();
-				return;
-			case "transport:connection:heartbeat": if (data.data.kind === MessageHeartbeatKind.Ping) this.sendHeartbeatPong();
-		}
+			});
+		});
 	}
-	isSelfAnnouncement(event) {
-		return event.data.name === this.opts.name && event.data.identity?.id === this.identity.id;
+	errorFromServerEvent(message) {
+		if (message.type !== "error") return;
+		const errorMessage = typeof message.data.message === "string" ? message.data.message : "Unknown server error";
+		const parsed = parseServerErrorMessage(errorMessage);
+		if (parsed.code === "unknown") return new Error(errorMessage);
+		return new Error(parsed.message);
 	}
-	async dispatchMessage(data) {
-		const listeners = this.eventListeners.get(data.type);
-		if (!listeners?.size) return;
-		const results = await Promise.allSettled(Array.from(listeners).map((listener) => Promise.resolve(listener(data))));
-		for (const result of results) if (result.status === "rejected") this.opts.onError?.(result.reason);
+	normalizeError(error, fallback) {
+		return error instanceof Error ? error : new Error(errorMessageFrom(error) ?? fallback);
+	}
+	isSelfModuleAnnouncement(event) {
+		return event.data.name === this.opts.name && event.data.identity?.id === this.opts.identity.id;
+	}
+	hasSelfModuleInRegistrySync(event) {
+		return event.data.modules.some((module) => module.name === this.opts.name && module.identity?.id === this.opts.identity.id);
 	}
 	createPayload(data) {
 		return {
 			...data,
 			metadata: {
-				...data?.metadata,
-				source: data?.metadata?.source ?? this.identity,
+				...data.metadata,
+				source: data.metadata?.source ?? {
+					kind: "plugin",
+					...this.opts.identity,
+					plugin: { id: this.opts.extension.id }
+				},
 				event: {
-					id: data?.metadata?.event?.id ?? createEventId(),
-					...data?.metadata?.event
+					...data.metadata?.event,
+					id: data.metadata?.event?.id ?? createEventId()
 				}
 			}
 		};
 	}
-	startHeartbeat() {
-		if (!this.heartbeat.readTimeout || !this.heartbeat.pingInterval) return;
-		this.stopHeartbeat();
-		this.lastReadAt = Date.now();
-		this.lastPingAt = 0;
-		const interval = Math.max(1e3, Math.min(this.heartbeat.pingInterval, Math.floor(this.heartbeat.readTimeout / 2)));
-		this.heartbeatTimer = setInterval(() => {
-			if (!this.isSocketOpen) return;
-			const now = Date.now();
-			if (now - this.lastReadAt > this.heartbeat.readTimeout) {
-				this.reconnectAfterProtocolError(/* @__PURE__ */ new Error(`Read timeout after ${this.heartbeat.readTimeout}ms`));
-				return;
-			}
-			if (now - this.lastPingAt >= this.heartbeat.pingInterval) this.sendHeartbeatPing();
-		}, interval);
-	}
-	stopHeartbeat() {
-		if (!this.heartbeatTimer) return;
-		clearInterval(this.heartbeatTimer);
-		this.heartbeatTimer = void 0;
-	}
-	sendNativeHeartbeat(kind) {
-		const websocket = this.websocket;
-		if (kind === "ping") websocket.ping?.();
-		else websocket.pong?.();
-	}
-	sendHeartbeatPing() {
-		this.lastPingAt = Date.now();
-		this.send({
-			type: "transport:connection:heartbeat",
+};
+function createClient(options) {
+	return new Client(options);
+}
+//#endregion
+//#region src/extension-peer.ts
+/**
+* Provides extension-level protocol helpers over a server-sdk protocol client.
+*/
+var WebSocketExtensionPeer = class {
+	client;
+	extension;
+	constructor(options) {
+		this.extension = options.extension;
+		this.client = options.client ?? createClient({
+			...options.clientOptions,
+			name: options.extension.id,
+			handshake: "manual",
+			autoConnect: options.clientOptions?.autoConnect ?? false,
+			autoReconnect: options.clientOptions?.autoReconnect ?? false
+		});
+	}
+	connect(options) {
+		return this.client.connect(options);
+	}
+	authenticatePeer(input = {}) {
+		this.client.sendOrThrow({
+			type: "peer:authenticate",
+			data: input
+		});
+	}
+	announceExtension(input = {}) {
+		this.client.sendOrThrow({
+			type: "extension:announce",
 			data: {
-				kind: MessageHeartbeatKind.Ping,
-				message: this.heartbeat.message,
-				at: Date.now()
+				identity: this.extension,
+				permissions: input.permissions
 			}
 		});
-		this.sendNativeHeartbeat("ping");
 	}
-	sendHeartbeatPong() {
-		this.send({
-			type: "transport:connection:heartbeat",
+	announceModule(input) {
+		this.client.sendOrThrow({
+			type: "extension:module:announce",
 			data: {
-				kind: MessageHeartbeatKind.Pong,
-				message: MessageHeartbeat.Pong,
-				at: Date.now()
+				name: input.name,
+				identity: {
+					id: input.id,
+					extension: this.extension,
+					labels: input.labels
+				},
+				possibleEvents: input.possibleEvents ?? [],
+				permissions: input.permissions,
+				configSchema: input.configSchema,
+				dependencies: input.dependencies
 			}
 		});
-		this.sendNativeHeartbeat("pong");
-	}
-	async reconnectAfterProtocolError(error) {
-		if (this.shouldClose || this.pendingReconnect) return;
-		this.pendingReconnect = true;
-		const hadSocket = !!this.websocket;
-		if (!this.connectionAttempt || this.status === "ready") this.opts.onError?.(error);
-		const websocket = this.websocket;
-		this.cleanupSocket(websocket);
-		this.rejectAttempt(error);
-		if (websocket && websocket.readyState !== this.websocketConstructor.CLOSED && websocket.readyState !== this.websocketConstructor.CLOSING) websocket.close();
-		if (hadSocket) this.opts.onClose?.();
-		if (!this.opts.autoReconnect) {
-			this.transitionTo("failed");
-			return;
-		}
-		this.transitionTo("idle");
-		this.connect();
+	}
+	send(data) {
+		return this.client.send(data);
+	}
+	onEvent(event, callback) {
+		if (!this.client.onEvent) throw new Error("Wrapped extension peer client does not support event listeners.");
+		return this.client.onEvent(event, callback);
+	}
+	close() {
+		this.client.close();
 	}
 };
+/** Creates a websocket extension peer over a server-sdk protocol client. */
+function createWebSocketExtensionPeer(options) {
+	return new WebSocketExtensionPeer(options);
+}
 //#endregion
-export { Client, ContextUpdateStrategy, WebSocketEventSource };
+export { Client, ContextUpdateStrategy, InvalidMessageError, WebSocketEventSource, WebSocketExtensionPeer, createClient, createTextProtocolConnector, createWebSocketExtensionPeer, parseEvent, stringifyEvent };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type {\n  MetadataEventSource,\n  ModuleConfigSchema,\n  ModuleDependency,\n  WebSocketBaseEvent,\n  WebSocketEvent,\n  WebSocketEventOptionalSource,\n  WebSocketEvents,\n} from '@proj-airi/server-shared/types'\n\nimport type { WebSocketLike, WebSocketLikeConstructor, WebSocketMessageEventLike } from './websocket-like'\n\nimport NativeWebSocket from 'crossws/websocket'\nimport superjson from 'superjson'\n\nimport { errorMessageFrom, sleep } from '@moeru/std'\nimport { isTerminalAuthenticationServerErrorMessage, parseServerErrorMessage } from '@proj-airi/server-shared'\nimport { MessageHeartbeat, MessageHeartbeatKind } from '@proj-airi/server-shared/types'\n\nexport type ClientStatus\n  = | 'idle'\n    | 'connecting'\n    | 'authenticating'\n    | 'announcing'\n    | 'ready'\n    | 'reconnecting'\n    | 'closing'\n    | 'closed'\n    | 'failed'\n\nexport interface ClientHeartbeatOptions {\n  pingInterval?: number\n  readTimeout?: number\n  message?: MessageHeartbeat | string\n}\n\nexport interface ClientStateChangeContext {\n  previousStatus: ClientStatus\n  status: ClientStatus\n}\n\nexport interface ConnectOptions {\n  abortSignal?: AbortSignal\n  timeout?: number\n}\n\nexport interface ClientOptions<C = undefined> {\n  url?: string\n  name: string\n  token?: string\n  websocketConstructor?: WebSocketLikeConstructor\n\n  connectTimeoutMs?: number\n  possibleEvents?: Array<keyof WebSocketEvents<C>>\n  identity?: MetadataEventSource\n  dependencies?: ModuleDependency[]\n  configSchema?: ModuleConfigSchema\n  heartbeat?: ClientHeartbeatOptions\n\n  autoConnect?: boolean\n  autoReconnect?: boolean\n  maxReconnectAttempts?: number\n\n  onError?: (error: unknown) => void\n  onClose?: () => void\n  onReady?: () => void\n  onStateChange?: (context: ClientStateChangeContext) => void\n\n  onAnyMessage?: (data: WebSocketEvent<C>) => void\n  onAnySend?: (data: WebSocketEvent<C>) => void\n}\n\ninterface ConnectionAttempt {\n  announced: boolean\n  authenticated: boolean\n  promise: Promise<void>\n  reject: (error: Error) => void\n  resolve: () => void\n  socket: WebSocketLike\n}\n\nfunction createInstanceId() {\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`\n}\n\nfunction createEventId() {\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`\n}\n\nfunction createDeferredPromise() {\n  let resolve!: () => void\n  let reject!: (error: Error) => void\n\n  const promise = new Promise<void>((innerResolve, innerReject) => {\n    resolve = innerResolve\n    reject = innerReject\n  })\n\n  return { promise, reject, resolve }\n}\n\nfunction normalizeHeartbeatOptions(heartbeat?: ClientHeartbeatOptions): Required<ClientHeartbeatOptions> {\n  const readTimeout = heartbeat?.readTimeout ?? 30_000\n  const pingInterval = heartbeat?.pingInterval ?? Math.max(1_000, Math.floor(readTimeout / 2))\n\n  return {\n    readTimeout,\n    pingInterval: Math.min(pingInterval, readTimeout),\n    message: heartbeat?.message ?? MessageHeartbeat.Ping,\n  }\n}\n\nexport class Client<C = undefined> {\n  private websocket?: WebSocketLike\n  private shouldClose = false\n  private connectTask?: Promise<void>\n  private heartbeatTimer?: ReturnType<typeof setInterval>\n  private lastPingAt = 0\n  private lastReadAt = 0\n  private reconnectAttempts = 0\n  private pendingReconnect = false\n  private connectionAttempt?: ConnectionAttempt\n  private failureReason?: Error\n  private status: ClientStatus = 'idle'\n  private readonly identity: MetadataEventSource\n  private readonly heartbeat: Required<ClientHeartbeatOptions>\n  private readonly websocketConstructor: WebSocketLikeConstructor\n\n  private readonly opts:\n    & Required<Omit<ClientOptions<C>, 'token' | 'heartbeat' | 'websocketConstructor' | 'configSchema'>>\n    & Pick<ClientOptions<C>, 'token' | 'heartbeat' | 'configSchema'>\n\n  private readonly eventListeners = new Map<\n    keyof WebSocketEvents<C>,\n    Set<(data: WebSocketBaseEvent<any, any>) => void | Promise<void>>\n  >()\n\n  private readonly stateListeners = new Set<(context: ClientStateChangeContext) => void>()\n\n  constructor(options: ClientOptions<C>) {\n    const { websocketConstructor, ...clientOptions } = options\n    const identity = options.identity ?? {\n      kind: 'plugin',\n      plugin: { id: options.name },\n      id: createInstanceId(),\n    }\n\n    const heartbeat = normalizeHeartbeatOptions(options.heartbeat)\n\n    this.opts = {\n      url: 'ws://localhost:6121/ws',\n      connectTimeoutMs: 15_000,\n      onAnyMessage: () => {},\n      onAnySend: () => {},\n      possibleEvents: [],\n      dependencies: [],\n      configSchema: undefined,\n      onError: () => {},\n      onClose: () => {},\n      onReady: () => {},\n      onStateChange: () => {},\n      autoConnect: true,\n      autoReconnect: true,\n      maxReconnectAttempts: -1,\n      ...clientOptions,\n      heartbeat,\n      identity,\n    }\n\n    this.identity = identity\n    this.heartbeat = heartbeat\n    this.websocketConstructor = websocketConstructor ?? (NativeWebSocket as unknown as WebSocketLikeConstructor)\n\n    if (this.opts.autoConnect) {\n      void this.connect()\n    }\n  }\n\n  get connectionStatus() {\n    return this.status\n  }\n\n  get isReady() {\n    return this.status === 'ready'\n  }\n\n  get isSocketOpen() {\n    return this.websocket?.readyState === this.websocketConstructor.OPEN\n  }\n\n  get lastError() {\n    return this.failureReason\n  }\n\n  async connect(options?: ConnectOptions) {\n    if (this.shouldClose) {\n      throw new Error('Client is closed')\n    }\n\n    if (this.status === 'ready') {\n      return\n    }\n\n    if (this.connectTask) {\n      return this.waitForConnection(this.connectTask, options)\n    }\n\n    this.connectTask = this.runConnectLoop().finally(() => {\n      this.connectTask = undefined\n    })\n\n    return this.waitForConnection(this.connectTask, options)\n  }\n\n  ready(options?: ConnectOptions) {\n    return this.connect(options)\n  }\n\n  ensureConnected(options?: ConnectOptions) {\n    return this.connect(options)\n  }\n\n  onConnectionStateChange(callback: (context: ClientStateChangeContext) => void): () => void {\n    this.stateListeners.add(callback)\n\n    return () => {\n      this.stateListeners.delete(callback)\n    }\n  }\n\n  onEvent<E extends keyof WebSocketEvents<C>>(\n    event: E,\n    callback: (data: WebSocketBaseEvent<E, WebSocketEvents<C>[E]>) => void | Promise<void>,\n  ): () => void {\n    let listeners = this.eventListeners.get(event)\n    if (!listeners) {\n      listeners = new Set()\n      this.eventListeners.set(event, listeners)\n    }\n\n    listeners.add(callback as any)\n\n    return () => {\n      this.offEvent(event, callback)\n    }\n  }\n\n  offEvent<E extends keyof WebSocketEvents<C>>(\n    event: E,\n    callback?: (data: WebSocketBaseEvent<E, WebSocketEvents<C>[E]>) => void | Promise<void>,\n  ): void {\n    const listeners = this.eventListeners.get(event)\n    if (!listeners) {\n      return\n    }\n\n    if (callback) {\n      listeners.delete(callback as any)\n      if (!listeners.size) {\n        this.eventListeners.delete(event)\n      }\n    }\n    else {\n      this.eventListeners.delete(event)\n    }\n  }\n\n  send(data: WebSocketEventOptionalSource<C>): boolean {\n    if (!this.isSocketOpen || !this.websocket) {\n      return false\n    }\n\n    const payload = this.createPayload(data)\n    this.opts.onAnySend?.(payload)\n    this.websocket.send(superjson.stringify(payload))\n\n    return true\n  }\n\n  sendOrThrow(data: WebSocketEventOptionalSource<C>): void {\n    if (!this.send(data)) {\n      throw new Error(`Client is not connected, current status: ${this.status}`)\n    }\n  }\n\n  sendRaw(data: string | ArrayBufferLike | ArrayBufferView): boolean {\n    if (!this.isSocketOpen || !this.websocket) {\n      return false\n    }\n\n    this.websocket.send(data)\n    return true\n  }\n\n  close(): void {\n    this.shouldClose = true\n    this.pendingReconnect = false\n    this.transitionTo('closing')\n    this.stopHeartbeat()\n    this.rejectAttempt(new Error('Client closed'))\n\n    const websocket = this.websocket\n    this.websocket = undefined\n\n    if (websocket && websocket.readyState !== this.websocketConstructor.CLOSED && websocket.readyState !== this.websocketConstructor.CLOSING) {\n      websocket.close()\n    }\n\n    this.transitionTo('closed')\n  }\n\n  private async runConnectLoop() {\n    this.pendingReconnect = false\n\n    while (!this.shouldClose) {\n      const reconnecting = this.reconnectAttempts > 0\n      this.transitionTo(reconnecting ? 'reconnecting' : 'connecting')\n\n      try {\n        await this.connectOnce()\n        this.reconnectAttempts = 0\n        return\n      }\n      catch (error) {\n        const normalizedError = error instanceof Error ? error : new Error(errorMessageFrom(error) ?? 'Failed to connect websocket client')\n        this.failureReason = normalizedError\n        this.opts.onError?.(normalizedError)\n\n        if (this.shouldClose) {\n          throw normalizedError\n        }\n\n        if (isTerminalAuthenticationServerErrorMessage(normalizedError.message)) {\n          this.transitionTo('failed')\n          throw normalizedError\n        }\n\n        if (!this.opts.autoReconnect && reconnecting) {\n          this.transitionTo('failed')\n          throw normalizedError\n        }\n\n        if (!this.canRetry()) {\n          this.transitionTo('failed')\n          throw normalizedError\n        }\n\n        const delay = this.getReconnectDelay(this.reconnectAttempts)\n        this.reconnectAttempts += 1\n        await sleep(delay)\n      }\n    }\n\n    throw new Error('Client is closed')\n  }\n\n  private connectOnce(): Promise<void> {\n    const WebSocketConstructor = this.websocketConstructor\n    const ws = new WebSocketConstructor(this.opts.url)\n    this.websocket = ws\n    this.lastReadAt = Date.now()\n    this.lastPingAt = 0\n\n    const deferred = createDeferredPromise()\n    const attempt: ConnectionAttempt = {\n      announced: false,\n      authenticated: !this.opts.token,\n      promise: deferred.promise,\n      reject: deferred.reject,\n      resolve: deferred.resolve,\n      socket: ws,\n    }\n\n    this.connectionAttempt = attempt\n\n    const isCurrentSocket = () => this.websocket === ws\n    const connectTimeoutMs = this.opts.connectTimeoutMs\n    const connectTimer = setTimeout(() => {\n      if (ws.readyState === WebSocket.OPEN) {\n        return\n      }\n\n      ws.close()\n      deferred.reject(new Error(`Connection timeout after ${connectTimeoutMs}ms`))\n    }, connectTimeoutMs)\n\n    const clearConnectTimer = () => {\n      clearTimeout(connectTimer)\n    }\n\n    ws.onmessage = (event: WebSocketMessageEventLike) => {\n      if (!isCurrentSocket()) {\n        return\n      }\n\n      void this.handleMessage(event)\n    }\n\n    ws.onerror = (event: any) => {\n      clearConnectTimer()\n\n      if (!isCurrentSocket()) {\n        return\n      }\n\n      const error = event?.error instanceof Error ? event.error : new Error('WebSocket error')\n      if (this.connectionAttempt) {\n        this.handleSocketFailure(error, ws)\n      }\n      else {\n        this.opts.onError?.(error)\n        void this.reconnectAfterProtocolError(error)\n      }\n    }\n\n    ws.onclose = () => {\n      clearConnectTimer()\n\n      if (!isCurrentSocket()) {\n        return\n      }\n\n      const wasReady = this.status === 'ready'\n      this.cleanupSocket(ws)\n      this.opts.onClose?.()\n\n      if (this.shouldClose) {\n        return\n      }\n\n      if (wasReady && this.opts.autoReconnect) {\n        this.pendingReconnect = true\n        this.transitionTo('idle')\n        void this.connect()\n        return\n      }\n\n      this.rejectAttempt(new Error('WebSocket closed'))\n    }\n\n    ws.onopen = () => {\n      clearConnectTimer()\n\n      if (!isCurrentSocket()) {\n        return\n      }\n\n      this.startHeartbeat()\n\n      if (this.opts.token) {\n        attempt.authenticated = false\n        this.transitionTo('authenticating')\n        this.tryAuthenticate()\n      }\n      else {\n        attempt.authenticated = true\n        this.transitionTo('announcing')\n        this.tryAnnounce()\n      }\n    }\n\n    return attempt.promise\n  }\n\n  private handleSocketFailure(error: Error, socket?: WebSocketLike) {\n    if (socket && this.websocket !== socket) {\n      return\n    }\n\n    const currentSocket = socket ?? this.websocket\n    this.cleanupSocket(socket)\n\n    if (currentSocket && currentSocket.readyState !== this.websocketConstructor.CLOSED && currentSocket.readyState !== this.websocketConstructor.CLOSING) {\n      currentSocket.close()\n    }\n\n    this.rejectAttempt(error)\n  }\n\n  private cleanupSocket(socket?: WebSocketLike) {\n    if (socket && this.websocket !== socket) {\n      return\n    }\n\n    this.stopHeartbeat()\n\n    if (!socket || this.websocket === socket) {\n      this.websocket = undefined\n    }\n  }\n\n  private rejectAttempt(error: Error) {\n    if (!this.connectionAttempt) {\n      return\n    }\n\n    const attempt = this.connectionAttempt\n    this.connectionAttempt = undefined\n    attempt.reject(error)\n  }\n\n  private resolveAttempt() {\n    if (!this.connectionAttempt) {\n      return\n    }\n\n    const attempt = this.connectionAttempt\n    this.connectionAttempt = undefined\n    attempt.resolve()\n  }\n\n  private canRetry() {\n    return this.opts.maxReconnectAttempts === -1 || this.reconnectAttempts < this.opts.maxReconnectAttempts\n  }\n\n  private getReconnectDelay(attempts: number) {\n    return Math.min(2 ** attempts * 1_000, 30_000)\n  }\n\n  private transitionTo(status: ClientStatus) {\n    if (this.status === status) {\n      return\n    }\n\n    const previousStatus = this.status\n    this.status = status\n    const context = { previousStatus, status }\n\n    this.opts.onStateChange?.(context)\n\n    for (const listener of this.stateListeners) {\n      listener(context)\n    }\n  }\n\n  private async waitForConnection(connectPromise: Promise<void>, options?: ConnectOptions) {\n    if (!options?.timeout && !options?.abortSignal) {\n      return connectPromise\n    }\n\n    const timeout = options?.timeout\n    if (typeof timeout !== 'undefined' && timeout <= 0) {\n      throw new Error(`Connection timed out after ${timeout}ms`)\n    }\n\n    const abortSignal = options?.abortSignal\n    if (abortSignal?.aborted) {\n      throw new Error('Connection aborted')\n    }\n\n    let timeoutHandle: ReturnType<typeof setTimeout> | undefined\n    let removeAbortListener: (() => void) | undefined\n\n    try {\n      await Promise.race([\n        connectPromise,\n        new Promise<void>((_, reject) => {\n          if (typeof timeout !== 'undefined') {\n            timeoutHandle = setTimeout(() => {\n              reject(new Error(`Connection timed out after ${timeout}ms`))\n            }, timeout)\n          }\n\n          if (abortSignal) {\n            const onAbort = () => {\n              reject(new Error('Connection aborted'))\n            }\n\n            abortSignal.addEventListener('abort', onAbort, { once: true })\n            removeAbortListener = () => abortSignal.removeEventListener('abort', onAbort)\n          }\n        }),\n      ])\n    }\n    finally {\n      if (timeoutHandle) {\n        clearTimeout(timeoutHandle)\n      }\n\n      removeAbortListener?.()\n    }\n  }\n\n  private tryAnnounce() {\n    this.sendOrThrow({\n      type: 'module:announce',\n      data: {\n        name: this.opts.name,\n        identity: this.identity,\n        possibleEvents: this.opts.possibleEvents,\n        dependencies: this.opts.dependencies,\n        configSchema: this.opts.configSchema,\n      },\n    })\n  }\n\n  private tryAuthenticate() {\n    if (!this.opts.token) {\n      return\n    }\n\n    this.sendOrThrow({\n      type: 'module:authenticate',\n      data: { token: this.opts.token },\n    })\n  }\n\n  private async handleMessage(event: WebSocketMessageEventLike) {\n    this.lastReadAt = Date.now()\n\n    try {\n      const data = this.parseMessage(event.data as string)\n      this.opts.onAnyMessage?.(data)\n\n      await this.handleControlMessage(data)\n      await this.dispatchMessage(data)\n    }\n    catch (error) {\n      const normalizedError = error instanceof Error ? error : new Error(errorMessageFrom(error) ?? 'Failed to handle websocket message')\n      this.opts.onError?.(normalizedError)\n\n      if (this.connectionAttempt && this.status !== 'ready') {\n        this.handleSocketFailure(normalizedError)\n      }\n    }\n  }\n\n  private parseMessage(raw: string): WebSocketEvent<C> {\n    try {\n      const parsed = superjson.parse<WebSocketEvent<C> | undefined>(raw)\n      if (parsed && typeof parsed === 'object' && 'type' in parsed) {\n        return parsed\n      }\n    }\n    catch {\n      // Try standard JSON next.\n    }\n\n    const parsed = JSON.parse(raw) as WebSocketEvent<C>\n    if (!parsed || typeof parsed !== 'object' || !('type' in parsed)) {\n      throw new Error('Received invalid websocket message')\n    }\n\n    return parsed\n  }\n\n  private async handleControlMessage(data: WebSocketEvent<C>) {\n    switch (data.type) {\n      case 'error': {\n        const message = data.data?.message\n        if (!message || typeof message !== 'string') {\n          return\n        }\n\n        const parsedServerError = parseServerErrorMessage(message)\n        if (parsedServerError.authentication) {\n          const error = new Error(message)\n          if (parsedServerError.terminal) {\n            this.shouldClose = true\n            this.handleSocketFailure(error)\n            this.transitionTo('failed')\n            return\n          }\n\n          await this.reconnectAfterProtocolError(error)\n          return\n        }\n\n        if (parsedServerError.code !== 'unknown') {\n          throw new Error(parsedServerError.message)\n        }\n\n        throw new Error(message)\n      }\n\n      case 'module:authenticated': {\n        if (data.data.authenticated) {\n          if (!this.connectionAttempt || this.connectionAttempt.authenticated) {\n            return\n          }\n\n          this.connectionAttempt.authenticated = true\n          this.transitionTo('announcing')\n          this.tryAnnounce()\n          return\n        }\n\n        throw new Error('Authentication failed')\n      }\n\n      case 'module:announced': {\n        if (!this.isSelfAnnouncement(data)) {\n          return\n        }\n\n        if (this.status === 'ready') {\n          return\n        }\n\n        if (this.connectionAttempt) {\n          this.connectionAttempt.announced = true\n        }\n\n        this.reconnectAttempts = 0\n        this.transitionTo('ready')\n        this.resolveAttempt()\n        this.opts.onReady?.()\n        return\n      }\n\n      case 'registry:modules:sync': {\n        // Fallback: If the status is stuck at 'announcing' but the sync already contains this module,\n        // it means the announce succeeded; the server simply didn't send back 'module:announced'\n        if (this.status !== 'announcing' || !this.connectionAttempt) {\n          return\n        }\n\n        const modules = (data.data as any)?.modules as Array<{\n          name: string\n          identity?: { id?: string }\n        }> ?? []\n\n        const selfRegistered = modules.some(\n          m => m.name === this.opts.name\n            && m.identity?.id === this.identity.id,\n        )\n\n        if (!selfRegistered) {\n          return\n        }\n\n        if (this.connectionAttempt) {\n          this.connectionAttempt.announced = true\n        }\n\n        this.reconnectAttempts = 0\n        this.transitionTo('ready')\n        this.resolveAttempt()\n        this.opts.onReady?.()\n        return\n      }\n\n      case 'transport:connection:heartbeat': {\n        if (data.data.kind === MessageHeartbeatKind.Ping) {\n          this.sendHeartbeatPong()\n        }\n      }\n    }\n  }\n\n  private isSelfAnnouncement(event: WebSocketBaseEvent<'module:announced', WebSocketEvents<C>['module:announced']>) {\n    return event.data.name === this.opts.name && event.data.identity?.id === this.identity.id\n  }\n\n  private async dispatchMessage(data: WebSocketEvent<C>) {\n    const listeners = this.eventListeners.get(data.type)\n    if (!listeners?.size) {\n      return\n    }\n\n    const results = await Promise.allSettled(\n      Array.from(listeners).map(listener => Promise.resolve(listener(data as any))),\n    )\n\n    for (const result of results) {\n      if (result.status === 'rejected') {\n        this.opts.onError?.(result.reason)\n      }\n    }\n  }\n\n  private createPayload(data: WebSocketEventOptionalSource<C>) {\n    return {\n      ...data,\n      metadata: {\n        ...data?.metadata,\n        source: data?.metadata?.source ?? this.identity,\n        event: {\n          id: data?.metadata?.event?.id ?? createEventId(),\n          ...data?.metadata?.event,\n        },\n      },\n    } as WebSocketEvent<C>\n  }\n\n  private startHeartbeat() {\n    if (!this.heartbeat.readTimeout || !this.heartbeat.pingInterval) {\n      return\n    }\n\n    this.stopHeartbeat()\n    this.lastReadAt = Date.now()\n    this.lastPingAt = 0\n\n    const interval = Math.max(1_000, Math.min(this.heartbeat.pingInterval, Math.floor(this.heartbeat.readTimeout / 2)))\n    this.heartbeatTimer = setInterval(() => {\n      if (!this.isSocketOpen) {\n        return\n      }\n\n      const now = Date.now()\n      if (now - this.lastReadAt > this.heartbeat.readTimeout) {\n        void this.reconnectAfterProtocolError(new Error(`Read timeout after ${this.heartbeat.readTimeout}ms`))\n        return\n      }\n\n      if (now - this.lastPingAt >= this.heartbeat.pingInterval) {\n        this.sendHeartbeatPing()\n      }\n    }, interval)\n  }\n\n  private stopHeartbeat() {\n    if (!this.heartbeatTimer) {\n      return\n    }\n\n    clearInterval(this.heartbeatTimer)\n    this.heartbeatTimer = undefined\n  }\n\n  private sendNativeHeartbeat(kind: 'ping' | 'pong') {\n    const websocket = this.websocket as WebSocketLike & {\n      ping?: () => void\n      pong?: () => void\n    }\n\n    if (kind === 'ping') {\n      websocket.ping?.()\n    }\n    else {\n      websocket.pong?.()\n    }\n  }\n\n  private sendHeartbeatPing() {\n    this.lastPingAt = Date.now()\n    this.send({\n      type: 'transport:connection:heartbeat',\n      data: {\n        kind: MessageHeartbeatKind.Ping,\n        message: this.heartbeat.message,\n        at: Date.now(),\n      },\n    })\n    this.sendNativeHeartbeat('ping')\n  }\n\n  private sendHeartbeatPong() {\n    this.send({\n      type: 'transport:connection:heartbeat',\n      data: {\n        kind: MessageHeartbeatKind.Pong,\n        message: MessageHeartbeat.Pong,\n        at: Date.now(),\n      },\n    })\n    this.sendNativeHeartbeat('pong')\n  }\n\n  private async reconnectAfterProtocolError(error: Error) {\n    if (this.shouldClose || this.pendingReconnect) {\n      return\n    }\n\n    this.pendingReconnect = true\n    const hadSocket = !!this.websocket\n\n    if (!this.connectionAttempt || this.status === 'ready') {\n      this.opts.onError?.(error)\n    }\n\n    const websocket = this.websocket\n    this.cleanupSocket(websocket)\n    this.rejectAttempt(error)\n\n    if (websocket && websocket.readyState !== this.websocketConstructor.CLOSED && websocket.readyState !== this.websocketConstructor.CLOSING) {\n      websocket.close()\n    }\n\n    if (hadSocket) {\n      this.opts.onClose?.()\n    }\n\n    if (!this.opts.autoReconnect) {\n      this.transitionTo('failed')\n      return\n    }\n\n    this.transitionTo('idle')\n    void this.connect()\n  }\n}\n"],"mappings":";;;;;;AAiFA,SAAS,mBAAmB;AAC1B,QAAO,GAAG,KAAK,KAAK,CAAC,SAAS,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE;;AAG7E,SAAS,gBAAgB;AACvB,QAAO,GAAG,KAAK,KAAK,CAAC,SAAS,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG;;AAG9E,SAAS,wBAAwB;CAC/B,IAAI;CACJ,IAAI;AAOJ,QAAO;EAAE,SALO,IAAI,SAAe,cAAc,gBAAgB;AAC/D,aAAU;AACV,YAAS;IACT;EAEgB;EAAQ;EAAS;;AAGrC,SAAS,0BAA0B,WAAsE;CACvG,MAAM,cAAc,WAAW,eAAe;CAC9C,MAAM,eAAe,WAAW,gBAAgB,KAAK,IAAI,KAAO,KAAK,MAAM,cAAc,EAAE,CAAC;AAE5F,QAAO;EACL;EACA,cAAc,KAAK,IAAI,cAAc,YAAY;EACjD,SAAS,WAAW,WAAW,iBAAiB;EACjD;;AAGH,IAAa,SAAb,MAAmC;CACjC;CACA,cAAsB;CACtB;CACA;CACA,aAAqB;CACrB,aAAqB;CACrB,oBAA4B;CAC5B,mBAA2B;CAC3B;CACA;CACA,SAA+B;CAC/B;CACA;CACA;CAEA;CAIA,iCAAkC,IAAI,KAGnC;CAEH,iCAAkC,IAAI,KAAkD;CAExF,YAAY,SAA2B;EACrC,MAAM,EAAE,sBAAsB,GAAG,kBAAkB;EACnD,MAAM,WAAW,QAAQ,YAAY;GACnC,MAAM;GACN,QAAQ,EAAE,IAAI,QAAQ,MAAM;GAC5B,IAAI,kBAAkB;GACvB;EAED,MAAM,YAAY,0BAA0B,QAAQ,UAAU;AAE9D,OAAK,OAAO;GACV,KAAK;GACL,kBAAkB;GAClB,oBAAoB;GACpB,iBAAiB;GACjB,gBAAgB,EAAE;GAClB,cAAc,EAAE;GAChB,cAAc,KAAA;GACd,eAAe;GACf,eAAe;GACf,eAAe;GACf,qBAAqB;GACrB,aAAa;GACb,eAAe;GACf,sBAAsB;GACtB,GAAG;GACH;GACA;GACD;AAED,OAAK,WAAW;AAChB,OAAK,YAAY;AACjB,OAAK,uBAAuB,wBAAyB;AAErD,MAAI,KAAK,KAAK,YACP,MAAK,SAAS;;CAIvB,IAAI,mBAAmB;AACrB,SAAO,KAAK;;CAGd,IAAI,UAAU;AACZ,SAAO,KAAK,WAAW;;CAGzB,IAAI,eAAe;AACjB,SAAO,KAAK,WAAW,eAAe,KAAK,qBAAqB;;CAGlE,IAAI,YAAY;AACd,SAAO,KAAK;;CAGd,MAAM,QAAQ,SAA0B;AACtC,MAAI,KAAK,YACP,OAAM,IAAI,MAAM,mBAAmB;AAGrC,MAAI,KAAK,WAAW,QAClB;AAGF,MAAI,KAAK,YACP,QAAO,KAAK,kBAAkB,KAAK,aAAa,QAAQ;AAG1D,OAAK,cAAc,KAAK,gBAAgB,CAAC,cAAc;AACrD,QAAK,cAAc,KAAA;IACnB;AAEF,SAAO,KAAK,kBAAkB,KAAK,aAAa,QAAQ;;CAG1D,MAAM,SAA0B;AAC9B,SAAO,KAAK,QAAQ,QAAQ;;CAG9B,gBAAgB,SAA0B;AACxC,SAAO,KAAK,QAAQ,QAAQ;;CAG9B,wBAAwB,UAAmE;AACzF,OAAK,eAAe,IAAI,SAAS;AAEjC,eAAa;AACX,QAAK,eAAe,OAAO,SAAS;;;CAIxC,QACE,OACA,UACY;EACZ,IAAI,YAAY,KAAK,eAAe,IAAI,MAAM;AAC9C,MAAI,CAAC,WAAW;AACd,+BAAY,IAAI,KAAK;AACrB,QAAK,eAAe,IAAI,OAAO,UAAU;;AAG3C,YAAU,IAAI,SAAgB;AAE9B,eAAa;AACX,QAAK,SAAS,OAAO,SAAS;;;CAIlC,SACE,OACA,UACM;EACN,MAAM,YAAY,KAAK,eAAe,IAAI,MAAM;AAChD,MAAI,CAAC,UACH;AAGF,MAAI,UAAU;AACZ,aAAU,OAAO,SAAgB;AACjC,OAAI,CAAC,UAAU,KACb,MAAK,eAAe,OAAO,MAAM;QAInC,MAAK,eAAe,OAAO,MAAM;;CAIrC,KAAK,MAAgD;AACnD,MAAI,CAAC,KAAK,gBAAgB,CAAC,KAAK,UAC9B,QAAO;EAGT,MAAM,UAAU,KAAK,cAAc,KAAK;AACxC,OAAK,KAAK,YAAY,QAAQ;AAC9B,OAAK,UAAU,KAAK,UAAU,UAAU,QAAQ,CAAC;AAEjD,SAAO;;CAGT,YAAY,MAA6C;AACvD,MAAI,CAAC,KAAK,KAAK,KAAK,CAClB,OAAM,IAAI,MAAM,4CAA4C,KAAK,SAAS;;CAI9E,QAAQ,MAA2D;AACjE,MAAI,CAAC,KAAK,gBAAgB,CAAC,KAAK,UAC9B,QAAO;AAGT,OAAK,UAAU,KAAK,KAAK;AACzB,SAAO;;CAGT,QAAc;AACZ,OAAK,cAAc;AACnB,OAAK,mBAAmB;AACxB,OAAK,aAAa,UAAU;AAC5B,OAAK,eAAe;AACpB,OAAK,8BAAc,IAAI,MAAM,gBAAgB,CAAC;EAE9C,MAAM,YAAY,KAAK;AACvB,OAAK,YAAY,KAAA;AAEjB,MAAI,aAAa,UAAU,eAAe,KAAK,qBAAqB,UAAU,UAAU,eAAe,KAAK,qBAAqB,QAC/H,WAAU,OAAO;AAGnB,OAAK,aAAa,SAAS;;CAG7B,MAAc,iBAAiB;AAC7B,OAAK,mBAAmB;AAExB,SAAO,CAAC,KAAK,aAAa;GACxB,MAAM,eAAe,KAAK,oBAAoB;AAC9C,QAAK,aAAa,eAAe,iBAAiB,aAAa;AAE/D,OAAI;AACF,UAAM,KAAK,aAAa;AACxB,SAAK,oBAAoB;AACzB;YAEK,OAAO;IACZ,MAAM,kBAAkB,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,iBAAiB,MAAM,IAAI,qCAAqC;AACnI,SAAK,gBAAgB;AACrB,SAAK,KAAK,UAAU,gBAAgB;AAEpC,QAAI,KAAK,YACP,OAAM;AAGR,QAAI,2CAA2C,gBAAgB,QAAQ,EAAE;AACvE,UAAK,aAAa,SAAS;AAC3B,WAAM;;AAGR,QAAI,CAAC,KAAK,KAAK,iBAAiB,cAAc;AAC5C,UAAK,aAAa,SAAS;AAC3B,WAAM;;AAGR,QAAI,CAAC,KAAK,UAAU,EAAE;AACpB,UAAK,aAAa,SAAS;AAC3B,WAAM;;IAGR,MAAM,QAAQ,KAAK,kBAAkB,KAAK,kBAAkB;AAC5D,SAAK,qBAAqB;AAC1B,UAAM,MAAM,MAAM;;;AAItB,QAAM,IAAI,MAAM,mBAAmB;;CAGrC,cAAqC;EACnC,MAAM,uBAAuB,KAAK;EAClC,MAAM,KAAK,IAAI,qBAAqB,KAAK,KAAK,IAAI;AAClD,OAAK,YAAY;AACjB,OAAK,aAAa,KAAK,KAAK;AAC5B,OAAK,aAAa;EAElB,MAAM,WAAW,uBAAuB;EACxC,MAAM,UAA6B;GACjC,WAAW;GACX,eAAe,CAAC,KAAK,KAAK;GAC1B,SAAS,SAAS;GAClB,QAAQ,SAAS;GACjB,SAAS,SAAS;GAClB,QAAQ;GACT;AAED,OAAK,oBAAoB;EAEzB,MAAM,wBAAwB,KAAK,cAAc;EACjD,MAAM,mBAAmB,KAAK,KAAK;EACnC,MAAM,eAAe,iBAAiB;AACpC,OAAI,GAAG,eAAe,UAAU,KAC9B;AAGF,MAAG,OAAO;AACV,YAAS,uBAAO,IAAI,MAAM,4BAA4B,iBAAiB,IAAI,CAAC;KAC3E,iBAAiB;EAEpB,MAAM,0BAA0B;AAC9B,gBAAa,aAAa;;AAG5B,KAAG,aAAa,UAAqC;AACnD,OAAI,CAAC,iBAAiB,CACpB;AAGG,QAAK,cAAc,MAAM;;AAGhC,KAAG,WAAW,UAAe;AAC3B,sBAAmB;AAEnB,OAAI,CAAC,iBAAiB,CACpB;GAGF,MAAM,QAAQ,OAAO,iBAAiB,QAAQ,MAAM,wBAAQ,IAAI,MAAM,kBAAkB;AACxF,OAAI,KAAK,kBACP,MAAK,oBAAoB,OAAO,GAAG;QAEhC;AACH,SAAK,KAAK,UAAU,MAAM;AACrB,SAAK,4BAA4B,MAAM;;;AAIhD,KAAG,gBAAgB;AACjB,sBAAmB;AAEnB,OAAI,CAAC,iBAAiB,CACpB;GAGF,MAAM,WAAW,KAAK,WAAW;AACjC,QAAK,cAAc,GAAG;AACtB,QAAK,KAAK,WAAW;AAErB,OAAI,KAAK,YACP;AAGF,OAAI,YAAY,KAAK,KAAK,eAAe;AACvC,SAAK,mBAAmB;AACxB,SAAK,aAAa,OAAO;AACpB,SAAK,SAAS;AACnB;;AAGF,QAAK,8BAAc,IAAI,MAAM,mBAAmB,CAAC;;AAGnD,KAAG,eAAe;AAChB,sBAAmB;AAEnB,OAAI,CAAC,iBAAiB,CACpB;AAGF,QAAK,gBAAgB;AAErB,OAAI,KAAK,KAAK,OAAO;AACnB,YAAQ,gBAAgB;AACxB,SAAK,aAAa,iBAAiB;AACnC,SAAK,iBAAiB;UAEnB;AACH,YAAQ,gBAAgB;AACxB,SAAK,aAAa,aAAa;AAC/B,SAAK,aAAa;;;AAItB,SAAO,QAAQ;;CAGjB,oBAA4B,OAAc,QAAwB;AAChE,MAAI,UAAU,KAAK,cAAc,OAC/B;EAGF,MAAM,gBAAgB,UAAU,KAAK;AACrC,OAAK,cAAc,OAAO;AAE1B,MAAI,iBAAiB,cAAc,eAAe,KAAK,qBAAqB,UAAU,cAAc,eAAe,KAAK,qBAAqB,QAC3I,eAAc,OAAO;AAGvB,OAAK,cAAc,MAAM;;CAG3B,cAAsB,QAAwB;AAC5C,MAAI,UAAU,KAAK,cAAc,OAC/B;AAGF,OAAK,eAAe;AAEpB,MAAI,CAAC,UAAU,KAAK,cAAc,OAChC,MAAK,YAAY,KAAA;;CAIrB,cAAsB,OAAc;AAClC,MAAI,CAAC,KAAK,kBACR;EAGF,MAAM,UAAU,KAAK;AACrB,OAAK,oBAAoB,KAAA;AACzB,UAAQ,OAAO,MAAM;;CAGvB,iBAAyB;AACvB,MAAI,CAAC,KAAK,kBACR;EAGF,MAAM,UAAU,KAAK;AACrB,OAAK,oBAAoB,KAAA;AACzB,UAAQ,SAAS;;CAGnB,WAAmB;AACjB,SAAO,KAAK,KAAK,yBAAyB,MAAM,KAAK,oBAAoB,KAAK,KAAK;;CAGrF,kBAA0B,UAAkB;AAC1C,SAAO,KAAK,IAAI,KAAK,WAAW,KAAO,IAAO;;CAGhD,aAAqB,QAAsB;AACzC,MAAI,KAAK,WAAW,OAClB;EAGF,MAAM,iBAAiB,KAAK;AAC5B,OAAK,SAAS;EACd,MAAM,UAAU;GAAE;GAAgB;GAAQ;AAE1C,OAAK,KAAK,gBAAgB,QAAQ;AAElC,OAAK,MAAM,YAAY,KAAK,eAC1B,UAAS,QAAQ;;CAIrB,MAAc,kBAAkB,gBAA+B,SAA0B;AACvF,MAAI,CAAC,SAAS,WAAW,CAAC,SAAS,YACjC,QAAO;EAGT,MAAM,UAAU,SAAS;AACzB,MAAI,OAAO,YAAY,eAAe,WAAW,EAC/C,OAAM,IAAI,MAAM,8BAA8B,QAAQ,IAAI;EAG5D,MAAM,cAAc,SAAS;AAC7B,MAAI,aAAa,QACf,OAAM,IAAI,MAAM,qBAAqB;EAGvC,IAAI;EACJ,IAAI;AAEJ,MAAI;AACF,SAAM,QAAQ,KAAK,CACjB,gBACA,IAAI,SAAe,GAAG,WAAW;AAC/B,QAAI,OAAO,YAAY,YACrB,iBAAgB,iBAAiB;AAC/B,4BAAO,IAAI,MAAM,8BAA8B,QAAQ,IAAI,CAAC;OAC3D,QAAQ;AAGb,QAAI,aAAa;KACf,MAAM,gBAAgB;AACpB,6BAAO,IAAI,MAAM,qBAAqB,CAAC;;AAGzC,iBAAY,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM,CAAC;AAC9D,iCAA4B,YAAY,oBAAoB,SAAS,QAAQ;;KAE/E,CACH,CAAC;YAEI;AACN,OAAI,cACF,cAAa,cAAc;AAG7B,0BAAuB;;;CAI3B,cAAsB;AACpB,OAAK,YAAY;GACf,MAAM;GACN,MAAM;IACJ,MAAM,KAAK,KAAK;IAChB,UAAU,KAAK;IACf,gBAAgB,KAAK,KAAK;IAC1B,cAAc,KAAK,KAAK;IACxB,cAAc,KAAK,KAAK;IACzB;GACF,CAAC;;CAGJ,kBAA0B;AACxB,MAAI,CAAC,KAAK,KAAK,MACb;AAGF,OAAK,YAAY;GACf,MAAM;GACN,MAAM,EAAE,OAAO,KAAK,KAAK,OAAO;GACjC,CAAC;;CAGJ,MAAc,cAAc,OAAkC;AAC5D,OAAK,aAAa,KAAK,KAAK;AAE5B,MAAI;GACF,MAAM,OAAO,KAAK,aAAa,MAAM,KAAe;AACpD,QAAK,KAAK,eAAe,KAAK;AAE9B,SAAM,KAAK,qBAAqB,KAAK;AACrC,SAAM,KAAK,gBAAgB,KAAK;WAE3B,OAAO;GACZ,MAAM,kBAAkB,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,iBAAiB,MAAM,IAAI,qCAAqC;AACnI,QAAK,KAAK,UAAU,gBAAgB;AAEpC,OAAI,KAAK,qBAAqB,KAAK,WAAW,QAC5C,MAAK,oBAAoB,gBAAgB;;;CAK/C,aAAqB,KAAgC;AACnD,MAAI;GACF,MAAM,SAAS,UAAU,MAAqC,IAAI;AAClE,OAAI,UAAU,OAAO,WAAW,YAAY,UAAU,OACpD,QAAO;UAGL;EAIN,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,CAAC,UAAU,OAAO,WAAW,YAAY,EAAE,UAAU,QACvD,OAAM,IAAI,MAAM,qCAAqC;AAGvD,SAAO;;CAGT,MAAc,qBAAqB,MAAyB;AAC1D,UAAQ,KAAK,MAAb;GACE,KAAK,SAAS;IACZ,MAAM,UAAU,KAAK,MAAM;AAC3B,QAAI,CAAC,WAAW,OAAO,YAAY,SACjC;IAGF,MAAM,oBAAoB,wBAAwB,QAAQ;AAC1D,QAAI,kBAAkB,gBAAgB;KACpC,MAAM,QAAQ,IAAI,MAAM,QAAQ;AAChC,SAAI,kBAAkB,UAAU;AAC9B,WAAK,cAAc;AACnB,WAAK,oBAAoB,MAAM;AAC/B,WAAK,aAAa,SAAS;AAC3B;;AAGF,WAAM,KAAK,4BAA4B,MAAM;AAC7C;;AAGF,QAAI,kBAAkB,SAAS,UAC7B,OAAM,IAAI,MAAM,kBAAkB,QAAQ;AAG5C,UAAM,IAAI,MAAM,QAAQ;;GAG1B,KAAK;AACH,QAAI,KAAK,KAAK,eAAe;AAC3B,SAAI,CAAC,KAAK,qBAAqB,KAAK,kBAAkB,cACpD;AAGF,UAAK,kBAAkB,gBAAgB;AACvC,UAAK,aAAa,aAAa;AAC/B,UAAK,aAAa;AAClB;;AAGF,UAAM,IAAI,MAAM,wBAAwB;GAG1C,KAAK;AACH,QAAI,CAAC,KAAK,mBAAmB,KAAK,CAChC;AAGF,QAAI,KAAK,WAAW,QAClB;AAGF,QAAI,KAAK,kBACP,MAAK,kBAAkB,YAAY;AAGrC,SAAK,oBAAoB;AACzB,SAAK,aAAa,QAAQ;AAC1B,SAAK,gBAAgB;AACrB,SAAK,KAAK,WAAW;AACrB;GAGF,KAAK;AAGH,QAAI,KAAK,WAAW,gBAAgB,CAAC,KAAK,kBACxC;AAaF,QAAI,EAVa,KAAK,MAAc,WAG9B,EAAE,EAEuB,MAC7B,MAAK,EAAE,SAAS,KAAK,KAAK,QACrB,EAAE,UAAU,OAAO,KAAK,SAAS,GACvC,CAGC;AAGF,QAAI,KAAK,kBACP,MAAK,kBAAkB,YAAY;AAGrC,SAAK,oBAAoB;AACzB,SAAK,aAAa,QAAQ;AAC1B,SAAK,gBAAgB;AACrB,SAAK,KAAK,WAAW;AACrB;GAGF,KAAK,iCACH,KAAI,KAAK,KAAK,SAAS,qBAAqB,KAC1C,MAAK,mBAAmB;;;CAMhC,mBAA2B,OAAuF;AAChH,SAAO,MAAM,KAAK,SAAS,KAAK,KAAK,QAAQ,MAAM,KAAK,UAAU,OAAO,KAAK,SAAS;;CAGzF,MAAc,gBAAgB,MAAyB;EACrD,MAAM,YAAY,KAAK,eAAe,IAAI,KAAK,KAAK;AACpD,MAAI,CAAC,WAAW,KACd;EAGF,MAAM,UAAU,MAAM,QAAQ,WAC5B,MAAM,KAAK,UAAU,CAAC,KAAI,aAAY,QAAQ,QAAQ,SAAS,KAAY,CAAC,CAAC,CAC9E;AAED,OAAK,MAAM,UAAU,QACnB,KAAI,OAAO,WAAW,WACpB,MAAK,KAAK,UAAU,OAAO,OAAO;;CAKxC,cAAsB,MAAuC;AAC3D,SAAO;GACL,GAAG;GACH,UAAU;IACR,GAAG,MAAM;IACT,QAAQ,MAAM,UAAU,UAAU,KAAK;IACvC,OAAO;KACL,IAAI,MAAM,UAAU,OAAO,MAAM,eAAe;KAChD,GAAG,MAAM,UAAU;KACpB;IACF;GACF;;CAGH,iBAAyB;AACvB,MAAI,CAAC,KAAK,UAAU,eAAe,CAAC,KAAK,UAAU,aACjD;AAGF,OAAK,eAAe;AACpB,OAAK,aAAa,KAAK,KAAK;AAC5B,OAAK,aAAa;EAElB,MAAM,WAAW,KAAK,IAAI,KAAO,KAAK,IAAI,KAAK,UAAU,cAAc,KAAK,MAAM,KAAK,UAAU,cAAc,EAAE,CAAC,CAAC;AACnH,OAAK,iBAAiB,kBAAkB;AACtC,OAAI,CAAC,KAAK,aACR;GAGF,MAAM,MAAM,KAAK,KAAK;AACtB,OAAI,MAAM,KAAK,aAAa,KAAK,UAAU,aAAa;AACjD,SAAK,4CAA4B,IAAI,MAAM,sBAAsB,KAAK,UAAU,YAAY,IAAI,CAAC;AACtG;;AAGF,OAAI,MAAM,KAAK,cAAc,KAAK,UAAU,aAC1C,MAAK,mBAAmB;KAEzB,SAAS;;CAGd,gBAAwB;AACtB,MAAI,CAAC,KAAK,eACR;AAGF,gBAAc,KAAK,eAAe;AAClC,OAAK,iBAAiB,KAAA;;CAGxB,oBAA4B,MAAuB;EACjD,MAAM,YAAY,KAAK;AAKvB,MAAI,SAAS,OACX,WAAU,QAAQ;MAGlB,WAAU,QAAQ;;CAItB,oBAA4B;AAC1B,OAAK,aAAa,KAAK,KAAK;AAC5B,OAAK,KAAK;GACR,MAAM;GACN,MAAM;IACJ,MAAM,qBAAqB;IAC3B,SAAS,KAAK,UAAU;IACxB,IAAI,KAAK,KAAK;IACf;GACF,CAAC;AACF,OAAK,oBAAoB,OAAO;;CAGlC,oBAA4B;AAC1B,OAAK,KAAK;GACR,MAAM;GACN,MAAM;IACJ,MAAM,qBAAqB;IAC3B,SAAS,iBAAiB;IAC1B,IAAI,KAAK,KAAK;IACf;GACF,CAAC;AACF,OAAK,oBAAoB,OAAO;;CAGlC,MAAc,4BAA4B,OAAc;AACtD,MAAI,KAAK,eAAe,KAAK,iBAC3B;AAGF,OAAK,mBAAmB;EACxB,MAAM,YAAY,CAAC,CAAC,KAAK;AAEzB,MAAI,CAAC,KAAK,qBAAqB,KAAK,WAAW,QAC7C,MAAK,KAAK,UAAU,MAAM;EAG5B,MAAM,YAAY,KAAK;AACvB,OAAK,cAAc,UAAU;AAC7B,OAAK,cAAc,MAAM;AAEzB,MAAI,aAAa,UAAU,eAAe,KAAK,qBAAqB,UAAU,UAAU,eAAe,KAAK,qBAAqB,QAC/H,WAAU,OAAO;AAGnB,MAAI,UACF,MAAK,KAAK,WAAW;AAGvB,MAAI,CAAC,KAAK,KAAK,eAAe;AAC5B,QAAK,aAAa,SAAS;AAC3B;;AAGF,OAAK,aAAa,OAAO;AACpB,OAAK,SAAS"}
+{"version":3,"file":"index.mjs","names":["createBetterWsClient"],"sources":["../src/codec.ts","../src/client.ts","../src/extension-peer.ts"],"sourcesContent":["import type { WebSocketBaseEvent, WebSocketEvent } from '@proj-airi/server-shared/types'\n\nimport { parse, stringify } from 'superjson'\nimport { check, objectWithRest, pipe, safeParse, string, unknown } from 'valibot'\n\nconst invalidMessage = 'Invalid AIRI websocket message.'\n\nconst eventDataSchema = pipe(\n  unknown(),\n  check(\n    value => Boolean(value) && typeof value === 'object' && !Array.isArray(value),\n    'Expected event data to be a non-array object.',\n  ),\n)\n\nconst eventEnvelopeSchema = objectWithRest({\n  type: string(),\n  data: eventDataSchema,\n}, unknown())\n\n/** Options for websocket message validation failures. */\nexport interface InvalidMessageErrorOptions {\n  /** Original parser or validator failure that made the websocket message unusable. */\n  cause?: unknown\n  /** Parsed candidate event when available; otherwise the original websocket text. */\n  source?: unknown\n}\n\n/** Error thrown when websocket text cannot be parsed as an AIRI event envelope. */\nexport class InvalidMessageError extends Error {\n  readonly source?: unknown\n\n  constructor(options: InvalidMessageErrorOptions = {}) {\n    super(invalidMessage, { cause: options.cause })\n    this.name = 'InvalidMessageError'\n    this.source = options.source\n  }\n}\n\n/** Parses one AIRI websocket protocol event from SuperJSON or plain JSON text. */\nexport function parseEvent<C = undefined>(text: string): WebSocketEvent<C> {\n  let superJsonParsed: WebSocketEvent<C> | undefined\n  let superJsonError: unknown\n\n  try {\n    superJsonParsed = parse<WebSocketEvent<C>>(text)\n  }\n  catch (error) {\n    superJsonError = error\n  }\n\n  const potentialEvent = superJsonParsed && typeof superJsonParsed === 'object' && 'type' in superJsonParsed\n    ? superJsonParsed\n    : parsePlainJson(text, superJsonError)\n\n  const result = safeParse(eventEnvelopeSchema, potentialEvent)\n  if (!result.success) {\n    throw new InvalidMessageError({ cause: result.issues, source: potentialEvent })\n  }\n\n  return potentialEvent as WebSocketEvent<C>\n}\n\n/** Serializes one AIRI websocket protocol event with SuperJSON. */\nexport function stringifyEvent<C = undefined>(\n  event: WebSocketBaseEvent<string, unknown> | WebSocketEvent<C>,\n) {\n  return stringify(event)\n}\n\nfunction parsePlainJson(text: string, superJsonError: unknown): unknown {\n  try {\n    return JSON.parse(text)\n  }\n  catch (jsonError) {\n    throw new InvalidMessageError({\n      cause: superJsonError ?? jsonError,\n      source: text,\n    })\n  }\n}\n","import type {\n  Client as BetterWsClient,\n  ClientConnector,\n  PrepareContext,\n  ReconnectOptions,\n} from '@proj-airi/better-ws'\nimport type {\n  ExtensionIdentity,\n  ExtensionModuleIdentity,\n  ModuleConfigSchema,\n  ModuleDependency,\n  WebSocketBaseEvent,\n  WebSocketEvent,\n  WebSocketEventOptionalSource,\n  WebSocketEvents,\n} from '@proj-airi/server-shared/types'\n\nimport { errorMessageFrom } from '@moeru/std'\nimport { createClient as createBetterWsClient } from '@proj-airi/better-ws'\nimport { createCrossWsConnector } from '@proj-airi/better-ws/client/crossws'\nimport { isTerminalAuthenticationServerErrorMessage, parseServerErrorMessage } from '@proj-airi/server-shared'\nimport { MessageHeartbeat, MessageHeartbeatKind } from '@proj-airi/server-shared/types'\n\nimport { parseEvent, stringifyEvent } from './codec'\n\nexport type { ClientConnector, ClientEvents } from '@proj-airi/better-ws'\n\nexport type ClientStatus\n  = | 'idle'\n    | 'connecting'\n    | 'authenticating'\n    | 'announcing'\n    | 'ready'\n    | 'reconnecting'\n    | 'closing'\n    | 'closed'\n    | 'failed'\n\nexport interface ClientHeartbeatOptions {\n  pingInterval?: number\n  readTimeout?: number\n  message?: MessageHeartbeat | string\n}\n\nexport interface ClientStateChangeContext {\n  previousStatus: ClientStatus\n  status: ClientStatus\n}\n\nexport interface ConnectOptions {\n  abortSignal?: AbortSignal\n  timeout?: number\n}\n\nexport interface ClientOptions<C = undefined> {\n  url?: string\n  name: string\n  token?: string\n  connector?: ClientConnector<WebSocketEvent<C>>\n  /**\n   * Selects the connection handshake owned by this client.\n   *\n   * @default 'module'\n   */\n  handshake?: 'module' | 'manual'\n\n  connectTimeoutMs?: number\n  possibleEvents?: Array<keyof WebSocketEvents<C>>\n  extension?: ExtensionIdentity\n  identity?: ExtensionModuleIdentity\n  dependencies?: ModuleDependency[]\n  configSchema?: ModuleConfigSchema\n  heartbeat?: false | ClientHeartbeatOptions\n\n  autoConnect?: boolean\n  autoReconnect?: boolean\n  maxReconnectAttempts?: number\n\n  onError?: (error: unknown) => void\n  onClose?: () => void\n  onReady?: () => void\n  onStateChange?: (context: ClientStateChangeContext) => void\n\n  onAnyMessage?: (data: WebSocketEvent<C>) => void\n  onAnySend?: (data: WebSocketEvent<C>) => void\n}\n\ninterface NormalizedClientOptions<C> {\n  url: string\n  name: string\n  token?: string\n  connector: ClientConnector<WebSocketEvent<C>>\n  handshake: 'module' | 'manual'\n  connectTimeoutMs: number\n  possibleEvents: Array<keyof WebSocketEvents<C>>\n  extension: ExtensionIdentity\n  identity: ExtensionModuleIdentity\n  dependencies: ModuleDependency[]\n  configSchema?: ModuleConfigSchema\n  heartbeat: false | Required<ClientHeartbeatOptions>\n  autoConnect: boolean\n  autoReconnect: boolean\n  maxReconnectAttempts: number\n  onError: (error: unknown) => void\n  onClose: () => void\n  onReady: () => void\n  onStateChange: (context: ClientStateChangeContext) => void\n  onAnyMessage: (data: WebSocketEvent<C>) => void\n  onAnySend: (data: WebSocketEvent<C>) => void\n}\n\ninterface ProtocolWaitResult {\n  ready: boolean\n  error?: Error\n}\n\nfunction createInstanceId() {\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`\n}\n\nfunction createEventId() {\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`\n}\n\nfunction normalizeHeartbeatOptions(heartbeat?: false | ClientHeartbeatOptions): false | Required<ClientHeartbeatOptions> {\n  if (heartbeat === false) {\n    return false\n  }\n\n  const readTimeout = heartbeat?.readTimeout ?? 30_000\n  const pingInterval = heartbeat?.pingInterval ?? Math.max(1_000, Math.floor(readTimeout / 2))\n\n  return {\n    readTimeout,\n    pingInterval: Math.min(pingInterval, readTimeout),\n    message: heartbeat?.message ?? MessageHeartbeat.Ping,\n  }\n}\n\n/** Wraps a text websocket connector with AIRI protocol serialization. */\nexport function createTextProtocolConnector<C = undefined>(\n  textConnector: ClientConnector<string>,\n): ClientConnector<WebSocketEvent<C>> {\n  return {\n    async connect(events) {\n      const connection = await textConnector.connect({\n        message(text) {\n          try {\n            events.message(parseEvent<C>(text))\n          }\n          catch (error) {\n            events.error(error)\n          }\n        },\n        close: details => events.close(details),\n        error: error => events.error(error),\n      })\n\n      return {\n        send: message => connection.send(stringifyEvent(message)),\n        close: (code, reason) => connection.close?.(code, reason),\n        ping: connection.ping,\n        pong: connection.pong,\n      }\n    },\n  }\n}\n\nfunction createDefaultProtocolConnector<C>(url: string): ClientConnector<WebSocketEvent<C>> {\n  return createTextProtocolConnector(createCrossWsConnector({ url }))\n}\n\nfunction normalizeOptions<C>(options: ClientOptions<C>): NormalizedClientOptions<C> {\n  const url = options.url ?? 'ws://localhost:6121/ws'\n  const extension = options.extension ?? { id: options.name }\n  const identity = options.identity ?? {\n    id: createInstanceId(),\n    extension,\n  }\n\n  return {\n    url,\n    name: options.name,\n    token: options.token,\n    connector: options.connector ?? createDefaultProtocolConnector<C>(url),\n    handshake: options.handshake ?? 'module',\n    connectTimeoutMs: options.connectTimeoutMs ?? 15_000,\n    possibleEvents: options.possibleEvents ?? [],\n    extension,\n    identity,\n    dependencies: options.dependencies ?? [],\n    configSchema: options.configSchema,\n    heartbeat: normalizeHeartbeatOptions(options.heartbeat),\n    autoConnect: options.autoConnect ?? true,\n    autoReconnect: options.autoReconnect ?? true,\n    maxReconnectAttempts: options.maxReconnectAttempts ?? -1,\n    onError: options.onError ?? (() => {}),\n    onClose: options.onClose ?? (() => {}),\n    onReady: options.onReady ?? (() => {}),\n    onStateChange: options.onStateChange ?? (() => {}),\n    onAnyMessage: options.onAnyMessage ?? (() => {}),\n    onAnySend: options.onAnySend ?? (() => {}),\n  }\n}\n\nfunction createConnectionTimeoutError(timeout: number) {\n  return new Error(`Connection timed out after ${timeout}ms`)\n}\n\nfunction createAbortError() {\n  return new Error('Connection aborted')\n}\n\nexport class Client<C = undefined> {\n  private readonly opts: NormalizedClientOptions<C>\n  private readonly transport: BetterWsClient<WebSocketEvent<C>>\n  private readonly eventListeners = new Map<\n    keyof WebSocketEvents<C>,\n    Set<(data: WebSocketBaseEvent<string, unknown>) => void | Promise<void>>\n  >()\n\n  private readonly stateListeners = new Set<(context: ClientStateChangeContext) => void>()\n  private status: ClientStatus = 'idle'\n  private connectTask?: Promise<void>\n  private failureReason?: Error\n\n  constructor(options: ClientOptions<C>) {\n    this.opts = normalizeOptions(options)\n    this.transport = createBetterWsClient<WebSocketEvent<C>>({\n      connector: this.opts.connector,\n      reconnect: this.createReconnectOptions(),\n      heartbeat: this.createHeartbeatOptions(),\n      prepare: context => this.prepareProtocolConnection(context),\n    })\n\n    this.transport.onMessage(({ message }) => {\n      void this.handleMessage(message)\n    })\n    this.transport.onStateChange(({ previousState, state }) => {\n      this.handleTransportStateChange(previousState, state)\n    })\n\n    if (this.opts.autoConnect) {\n      void this.connect().catch((error) => {\n        const normalized = this.normalizeError(error, 'Failed to connect websocket client')\n        this.failureReason = normalized\n        this.opts.onError(normalized)\n      })\n    }\n  }\n\n  get connectionStatus() {\n    return this.status\n  }\n\n  get isReady() {\n    return this.status === 'ready'\n  }\n\n  get isSocketOpen() {\n    return this.transport.state === 'open' || this.transport.state === 'preparing' || this.transport.state === 'ready'\n  }\n\n  get lastError() {\n    return this.failureReason\n  }\n\n  async connect(options?: ConnectOptions) {\n    if (this.status === 'ready') {\n      return\n    }\n\n    if (!this.connectTask && this.transport.state === 'reconnecting') {\n      return this.waitForConnection(this.waitForReady(), options)\n    }\n\n    if (!this.connectTask && (this.transport.state === 'open' || this.transport.state === 'preparing')) {\n      return this.waitForConnection(this.waitForReady(), options)\n    }\n\n    if (!this.connectTask) {\n      this.connectTask = this.transport.connect().finally(() => {\n        this.connectTask = undefined\n      })\n    }\n\n    return this.waitForConnection(this.connectTask, options)\n  }\n\n  ready(options?: ConnectOptions) {\n    return this.connect(options)\n  }\n\n  ensureConnected(options?: ConnectOptions) {\n    return this.connect(options)\n  }\n\n  onConnectionStateChange(callback: (context: ClientStateChangeContext) => void): () => void {\n    this.stateListeners.add(callback)\n\n    return () => {\n      this.stateListeners.delete(callback)\n    }\n  }\n\n  onEvent<E extends keyof WebSocketEvents<C>>(\n    event: E,\n    callback: (data: WebSocketBaseEvent<E, WebSocketEvents<C>[E]>) => void | Promise<void>,\n  ): () => void {\n    let listeners = this.eventListeners.get(event)\n    if (!listeners) {\n      listeners = new Set()\n      this.eventListeners.set(event, listeners)\n    }\n\n    listeners.add(callback as (data: WebSocketBaseEvent<string, unknown>) => void | Promise<void>)\n\n    return () => {\n      this.offEvent(event, callback)\n    }\n  }\n\n  offEvent<E extends keyof WebSocketEvents<C>>(\n    event: E,\n    callback?: (data: WebSocketBaseEvent<E, WebSocketEvents<C>[E]>) => void | Promise<void>,\n  ): void {\n    const listeners = this.eventListeners.get(event)\n    if (!listeners) {\n      return\n    }\n\n    if (callback) {\n      listeners.delete(callback as (data: WebSocketBaseEvent<string, unknown>) => void | Promise<void>)\n      if (!listeners.size) {\n        this.eventListeners.delete(event)\n      }\n      return\n    }\n\n    this.eventListeners.delete(event)\n  }\n\n  send(data: WebSocketEventOptionalSource<C>): boolean {\n    const payload = this.createPayload(data)\n    const result = this.transport.send(payload)\n    if (!result.ok) {\n      return false\n    }\n\n    this.opts.onAnySend(payload)\n    return true\n  }\n\n  sendOrThrow(data: WebSocketEventOptionalSource<C>): void {\n    if (!this.send(data)) {\n      throw new Error(`Client is not connected, current status: ${this.status}`)\n    }\n  }\n\n  close(code?: number, reason?: string): void {\n    this.transport.close(code, reason)\n  }\n\n  private createReconnectOptions(): false | ReconnectOptions {\n    if (!this.opts.autoReconnect) {\n      return false\n    }\n\n    return {\n      retries: (attempt, error) => {\n        const normalized = this.normalizeError(error, 'Failed to connect websocket client')\n        if (isTerminalAuthenticationServerErrorMessage(normalized.message)) {\n          return false\n        }\n\n        return this.opts.maxReconnectAttempts === -1 || attempt <= this.opts.maxReconnectAttempts\n      },\n      onFailed: (error) => {\n        const normalized = this.normalizeError(error, 'Failed to connect websocket client')\n        if (this.failureReason === normalized) {\n          return\n        }\n\n        this.failureReason = normalized\n        this.opts.onError(normalized)\n      },\n    }\n  }\n\n  private createHeartbeatOptions() {\n    if (!this.opts.heartbeat) {\n      return false\n    }\n\n    return {\n      mode: 'message' as const,\n      interval: this.opts.heartbeat.pingInterval,\n      timeout: this.opts.heartbeat.readTimeout,\n      message: () => this.createPayload({\n        type: 'transport:connection:heartbeat',\n        data: {\n          kind: MessageHeartbeatKind.Ping,\n          message: this.opts.heartbeat ? this.opts.heartbeat.message : MessageHeartbeat.Ping,\n          at: Date.now(),\n        },\n      } as WebSocketEventOptionalSource<C>),\n    }\n  }\n\n  private async prepareProtocolConnection(context: PrepareContext<WebSocketEvent<C>>): Promise<void> {\n    if (this.opts.handshake === 'manual') {\n      if (!context.reconnecting) {\n        return\n      }\n\n      this.transitionTo('authenticating')\n      await this.waitForManualReconnectHandshake(context)\n      return\n    }\n\n    if (this.opts.token) {\n      this.transitionTo('authenticating')\n      context.send(this.createPayload({\n        type: 'module:authenticate',\n        data: { token: this.opts.token },\n      } as WebSocketEventOptionalSource<C>))\n\n      await context.waitFor((message) => {\n        const result = this.consumePrepareMessage(message)\n        if (result.error) {\n          throw result.error\n        }\n\n        return message.type === 'module:authenticated' && message.data.authenticated === true\n      }, { timeout: this.opts.connectTimeoutMs })\n    }\n\n    this.transitionTo('announcing')\n    context.send(this.createPayload({\n      type: 'extension:module:announce',\n      data: {\n        name: this.opts.name,\n        identity: this.opts.identity,\n        possibleEvents: this.opts.possibleEvents,\n        configSchema: this.opts.configSchema,\n        dependencies: this.opts.dependencies,\n      },\n    } as WebSocketEventOptionalSource<C>))\n\n    await context.waitFor((message) => {\n      const result = this.consumePrepareMessage(message)\n      if (result.error) {\n        throw result.error\n      }\n\n      return result.ready\n    }, { timeout: this.opts.connectTimeoutMs })\n  }\n\n  private async waitForManualReconnectHandshake(context: PrepareContext<WebSocketEvent<C>>): Promise<void> {\n    await context.waitFor((message) => {\n      const result = this.consumePrepareMessage(message)\n      if (result.error) {\n        throw result.error\n      }\n\n      return message.type === 'peer:authenticated' && message.data.authenticated === true\n    }, { timeout: this.opts.connectTimeoutMs })\n\n    this.transitionTo('announcing')\n\n    await context.waitFor((message) => {\n      const result = this.consumePrepareMessage(message)\n      if (result.error) {\n        throw result.error\n      }\n\n      return message.type === 'extension:announced'\n        && message.data.identity.id === this.opts.extension.id\n    }, { timeout: this.opts.connectTimeoutMs })\n  }\n\n  private consumePrepareMessage(message: WebSocketEvent<C>): ProtocolWaitResult {\n    const error = this.errorFromServerEvent(message)\n    if (error) {\n      this.failureReason = error\n      return { ready: false, error }\n    }\n\n    if (message.type === 'extension:module:announced') {\n      return { ready: this.isSelfModuleAnnouncement(message) }\n    }\n\n    if (message.type === 'registry:modules:sync') {\n      return { ready: this.hasSelfModuleInRegistrySync(message) }\n    }\n\n    return { ready: false }\n  }\n\n  private async handleMessage(message: WebSocketEvent<C>): Promise<void> {\n    this.opts.onAnyMessage(message)\n\n    const error = this.errorFromServerEvent(message)\n    if (error) {\n      this.failureReason = error\n      this.opts.onError(error)\n    }\n\n    if (message.type === 'transport:connection:heartbeat' && message.data.kind === MessageHeartbeatKind.Ping) {\n      this.send({\n        type: 'transport:connection:heartbeat',\n        data: {\n          kind: MessageHeartbeatKind.Pong,\n          message: MessageHeartbeat.Pong,\n          at: Date.now(),\n        },\n      } as WebSocketEventOptionalSource<C>)\n    }\n\n    const listeners = this.eventListeners.get(message.type)\n    if (!listeners?.size) {\n      return\n    }\n\n    const results = await Promise.allSettled(\n      Array.from(listeners).map(listener => Promise.resolve(listener(message as WebSocketBaseEvent<string, unknown>))),\n    )\n\n    for (const result of results) {\n      if (result.status === 'rejected') {\n        this.failureReason = this.normalizeError(result.reason, 'Client event listener failed')\n        this.opts.onError(result.reason)\n      }\n    }\n  }\n\n  private handleTransportStateChange(previousState: BetterWsClient<WebSocketEvent<C>>['state'], state: BetterWsClient<WebSocketEvent<C>>['state']) {\n    if (state === 'ready') {\n      this.transitionTo('ready')\n      this.opts.onReady()\n      return\n    }\n\n    const nextStatus = this.mapTransportStatus(state)\n    if (!nextStatus) {\n      return\n    }\n\n    this.transitionTo(nextStatus)\n\n    if (previousState === 'ready' && state === 'reconnecting') {\n      this.opts.onClose()\n    }\n    else if (state === 'closed') {\n      this.opts.onClose()\n    }\n  }\n\n  private mapTransportStatus(state: BetterWsClient<WebSocketEvent<C>>['state']): ClientStatus | undefined {\n    switch (state) {\n      case 'idle':\n      case 'connecting':\n      case 'reconnecting':\n      case 'closing':\n      case 'closed':\n      case 'failed':\n        return state\n      case 'open':\n      case 'preparing':\n      case 'ready':\n        return undefined\n    }\n  }\n\n  private transitionTo(status: ClientStatus) {\n    if (this.status === status) {\n      return\n    }\n\n    const previousStatus = this.status\n    this.status = status\n    const context = { previousStatus, status }\n\n    this.opts.onStateChange(context)\n\n    for (const listener of this.stateListeners) {\n      listener(context)\n    }\n  }\n\n  private async waitForConnection(connectPromise: Promise<void>, options?: ConnectOptions) {\n    if (!options?.timeout && !options?.abortSignal) {\n      return connectPromise\n    }\n\n    const timeout = options?.timeout\n    if (typeof timeout !== 'undefined' && timeout <= 0) {\n      throw createConnectionTimeoutError(timeout)\n    }\n\n    const abortSignal = options?.abortSignal\n    if (abortSignal?.aborted) {\n      throw createAbortError()\n    }\n\n    let timeoutHandle: ReturnType<typeof setTimeout> | undefined\n    let removeAbortListener: (() => void) | undefined\n\n    try {\n      await Promise.race([\n        connectPromise,\n        new Promise<void>((_, reject) => {\n          if (typeof timeout !== 'undefined') {\n            timeoutHandle = setTimeout(() => {\n              reject(createConnectionTimeoutError(timeout))\n            }, timeout)\n          }\n\n          if (abortSignal) {\n            const onAbort = () => reject(createAbortError())\n            abortSignal.addEventListener('abort', onAbort, { once: true })\n            removeAbortListener = () => abortSignal.removeEventListener('abort', onAbort)\n          }\n        }),\n      ])\n    }\n    finally {\n      if (timeoutHandle) {\n        clearTimeout(timeoutHandle)\n      }\n\n      removeAbortListener?.()\n    }\n  }\n\n  private waitForReady(): Promise<void> {\n    if (this.status === 'ready') {\n      return Promise.resolve()\n    }\n\n    return new Promise<void>((resolve, reject) => {\n      const dispose = this.onConnectionStateChange(({ status }) => {\n        if (status === 'ready') {\n          dispose()\n          resolve()\n          return\n        }\n\n        if (status === 'failed' || status === 'closed') {\n          dispose()\n          reject(this.failureReason ?? new Error(`Client connection ended with status: ${status}`))\n        }\n      })\n    })\n  }\n\n  private errorFromServerEvent(message: WebSocketEvent<C>): Error | undefined {\n    if (message.type !== 'error') {\n      return undefined\n    }\n\n    const errorMessage = typeof message.data.message === 'string'\n      ? message.data.message\n      : 'Unknown server error'\n    const parsed = parseServerErrorMessage(errorMessage)\n\n    if (parsed.code === 'unknown') {\n      return new Error(errorMessage)\n    }\n\n    return new Error(parsed.message)\n  }\n\n  private normalizeError(error: unknown, fallback: string): Error {\n    return error instanceof Error\n      ? error\n      : new Error(errorMessageFrom(error) ?? fallback)\n  }\n\n  private isSelfModuleAnnouncement(event: WebSocketBaseEvent<'extension:module:announced', WebSocketEvents<C>['extension:module:announced']>) {\n    return event.data.name === this.opts.name && event.data.identity?.id === this.opts.identity.id\n  }\n\n  private hasSelfModuleInRegistrySync(event: WebSocketBaseEvent<'registry:modules:sync', WebSocketEvents<C>['registry:modules:sync']>) {\n    return event.data.modules.some(module =>\n      module.name === this.opts.name\n      && module.identity?.id === this.opts.identity.id,\n    )\n  }\n\n  private createPayload(data: WebSocketEventOptionalSource<C>) {\n    return {\n      ...data,\n      metadata: {\n        ...data.metadata,\n        source: data.metadata?.source ?? {\n          kind: 'plugin',\n          ...this.opts.identity,\n          plugin: { id: this.opts.extension.id },\n        },\n        event: {\n          ...data.metadata?.event,\n          id: data.metadata?.event?.id ?? createEventId(),\n        },\n      },\n    } as WebSocketEvent<C>\n  }\n}\n\nexport function createClient<C = undefined>(options: ClientOptions<C>): Client<C> {\n  return new Client(options)\n}\n","import type {\n  ExtensionIdentity,\n  ModuleConfigSchema,\n  ModuleDependency,\n  ModulePermissionDeclaration,\n  ProtocolEvents,\n  WebSocketBaseEvent,\n  WebSocketEventOptionalSource,\n  WebSocketEvents,\n} from '@proj-airi/server-shared/types'\n\nimport type { ClientOptions, ConnectOptions } from './client'\n\nimport { createClient } from './client'\n\n/**\n * Describes the client operations required by {@link WebSocketExtensionPeer}.\n *\n * @param C - Optional custom protocol event map carried by the websocket client.\n */\nexport interface ExtensionPeerClient<C = undefined> {\n  connect: (options?: ConnectOptions) => Promise<void>\n  send: (data: WebSocketEventOptionalSource<C>) => boolean\n  sendOrThrow: (data: WebSocketEventOptionalSource<C>) => void\n  close: () => void\n  onEvent?: <E extends keyof WebSocketEvents<C>>(\n    event: E,\n    callback: (data: WebSocketBaseEvent<E, WebSocketEvents<C>[E]>) => void | Promise<void>,\n  ) => () => void\n}\n\n/**\n * Describes one module announcement emitted through a websocket extension peer.\n *\n * @param C - Optional custom protocol event map used for possible event declarations.\n */\nexport interface AnnounceExtensionModuleInput<C = undefined> {\n  /** Stable module id within the owning extension session. */\n  id: string\n  /** Human-readable module name used by registry and diagnostics. */\n  name: string\n  /** Protocol events this module may emit or handle. */\n  possibleEvents?: Array<keyof ProtocolEvents<C>>\n  /** Runtime permissions requested by this module. */\n  permissions?: ModulePermissionDeclaration\n  /** Optional configuration schema understood by the module. */\n  configSchema?: ModuleConfigSchema\n  /** Other modules or capabilities this module expects to exist. */\n  dependencies?: ModuleDependency[]\n  /** Optional labels for routing, diagnostics, or inspector views. */\n  labels?: Record<string, string>\n}\n\n/**\n * Options for creating a websocket-backed extension peer. Supplying `client` lets\n * tests and embedding runtimes provide their own protocol client implementation.\n *\n * @param C - Optional custom protocol event map carried by the websocket client.\n */\nexport interface WebSocketExtensionPeerOptions<C = undefined> {\n  extension: ExtensionIdentity\n  client?: ExtensionPeerClient<C>\n  clientOptions?: Omit<ClientOptions<C>, 'name' | 'identity'>\n}\n\n/**\n * Provides extension-level protocol helpers over a server-sdk protocol client.\n */\nexport class WebSocketExtensionPeer<C = undefined> {\n  private readonly client: ExtensionPeerClient<C>\n  private readonly extension: ExtensionIdentity\n\n  constructor(options: WebSocketExtensionPeerOptions<C>) {\n    this.extension = options.extension\n    this.client = options.client ?? createClient<C>({\n      ...options.clientOptions,\n      name: options.extension.id,\n      handshake: 'manual',\n      autoConnect: options.clientOptions?.autoConnect ?? false,\n      autoReconnect: options.clientOptions?.autoReconnect ?? false,\n    })\n  }\n\n  connect(options?: ConnectOptions): Promise<void> {\n    return this.client.connect(options)\n  }\n\n  authenticatePeer(input: { token?: string, peerId?: string } = {}): void {\n    this.client.sendOrThrow({\n      type: 'peer:authenticate',\n      data: input,\n    })\n  }\n\n  announceExtension(input: { permissions?: ModulePermissionDeclaration } = {}): void {\n    this.client.sendOrThrow({\n      type: 'extension:announce',\n      data: {\n        identity: this.extension,\n        permissions: input.permissions,\n      },\n    })\n  }\n\n  announceModule(input: AnnounceExtensionModuleInput<C>): void {\n    this.client.sendOrThrow({\n      type: 'extension:module:announce',\n      data: {\n        name: input.name,\n        identity: {\n          id: input.id,\n          extension: this.extension,\n          labels: input.labels,\n        },\n        possibleEvents: input.possibleEvents ?? [],\n        permissions: input.permissions,\n        configSchema: input.configSchema,\n        dependencies: input.dependencies,\n      },\n    })\n  }\n\n  send(data: WebSocketEventOptionalSource<C>): boolean {\n    return this.client.send(data)\n  }\n\n  onEvent<E extends keyof WebSocketEvents<C>>(\n    event: E,\n    callback: (data: WebSocketBaseEvent<E, WebSocketEvents<C>[E]>) => void | Promise<void>,\n  ): () => void {\n    if (!this.client.onEvent) {\n      throw new Error('Wrapped extension peer client does not support event listeners.')\n    }\n\n    return this.client.onEvent(event, callback)\n  }\n\n  close(): void {\n    this.client.close()\n  }\n}\n\n/** Creates a websocket extension peer over a server-sdk protocol client. */\nexport function createWebSocketExtensionPeer<C = undefined>(\n  options: WebSocketExtensionPeerOptions<C>,\n): WebSocketExtensionPeer<C> {\n  return new WebSocketExtensionPeer(options)\n}\n"],"mappings":";;;;;;;;AAKA,MAAM,iBAAiB;AAEvB,MAAM,kBAAkB,KACtB,SAAS,EACT,OACE,UAAS,QAAQ,MAAM,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM,EAC7E,gDACD,CACF;AAED,MAAM,sBAAsB,eAAe;CACzC,MAAM,QAAQ;CACd,MAAM;CACP,EAAE,SAAS,CAAC;;AAWb,IAAa,sBAAb,cAAyC,MAAM;CAC7C;CAEA,YAAY,UAAsC,EAAE,EAAE;AACpD,QAAM,gBAAgB,EAAE,OAAO,QAAQ,OAAO,CAAC;AAC/C,OAAK,OAAO;AACZ,OAAK,SAAS,QAAQ;;;;AAK1B,SAAgB,WAA0B,MAAiC;CACzE,IAAI;CACJ,IAAI;AAEJ,KAAI;AACF,oBAAkB,MAAyB,KAAK;UAE3C,OAAO;AACZ,mBAAiB;;CAGnB,MAAM,iBAAiB,mBAAmB,OAAO,oBAAoB,YAAY,UAAU,kBACvF,kBACA,eAAe,MAAM,eAAe;CAExC,MAAM,SAAS,UAAU,qBAAqB,eAAe;AAC7D,KAAI,CAAC,OAAO,QACV,OAAM,IAAI,oBAAoB;EAAE,OAAO,OAAO;EAAQ,QAAQ;EAAgB,CAAC;AAGjF,QAAO;;;AAIT,SAAgB,eACd,OACA;AACA,QAAO,UAAU,MAAM;;AAGzB,SAAS,eAAe,MAAc,gBAAkC;AACtE,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;UAElB,WAAW;AAChB,QAAM,IAAI,oBAAoB;GAC5B,OAAO,kBAAkB;GACzB,QAAQ;GACT,CAAC;;;;;ACsCN,SAAS,mBAAmB;AAC1B,QAAO,GAAG,KAAK,KAAK,CAAC,SAAS,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE;;AAG7E,SAAS,gBAAgB;AACvB,QAAO,GAAG,KAAK,KAAK,CAAC,SAAS,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG;;AAG9E,SAAS,0BAA0B,WAAsF;AACvH,KAAI,cAAc,MAChB,QAAO;CAGT,MAAM,cAAc,WAAW,eAAe;CAC9C,MAAM,eAAe,WAAW,gBAAgB,KAAK,IAAI,KAAO,KAAK,MAAM,cAAc,EAAE,CAAC;AAE5F,QAAO;EACL;EACA,cAAc,KAAK,IAAI,cAAc,YAAY;EACjD,SAAS,WAAW,WAAW,iBAAiB;EACjD;;;AAIH,SAAgB,4BACd,eACoC;AACpC,QAAO,EACL,MAAM,QAAQ,QAAQ;EACpB,MAAM,aAAa,MAAM,cAAc,QAAQ;GAC7C,QAAQ,MAAM;AACZ,QAAI;AACF,YAAO,QAAQ,WAAc,KAAK,CAAC;aAE9B,OAAO;AACZ,YAAO,MAAM,MAAM;;;GAGvB,QAAO,YAAW,OAAO,MAAM,QAAQ;GACvC,QAAO,UAAS,OAAO,MAAM,MAAM;GACpC,CAAC;AAEF,SAAO;GACL,OAAM,YAAW,WAAW,KAAK,eAAe,QAAQ,CAAC;GACzD,QAAQ,MAAM,WAAW,WAAW,QAAQ,MAAM,OAAO;GACzD,MAAM,WAAW;GACjB,MAAM,WAAW;GAClB;IAEJ;;AAGH,SAAS,+BAAkC,KAAiD;AAC1F,QAAO,4BAA4B,uBAAuB,EAAE,KAAK,CAAC,CAAC;;AAGrE,SAAS,iBAAoB,SAAuD;CAClF,MAAM,MAAM,QAAQ,OAAO;CAC3B,MAAM,YAAY,QAAQ,aAAa,EAAE,IAAI,QAAQ,MAAM;CAC3D,MAAM,WAAW,QAAQ,YAAY;EACnC,IAAI,kBAAkB;EACtB;EACD;AAED,QAAO;EACL;EACA,MAAM,QAAQ;EACd,OAAO,QAAQ;EACf,WAAW,QAAQ,aAAa,+BAAkC,IAAI;EACtE,WAAW,QAAQ,aAAa;EAChC,kBAAkB,QAAQ,oBAAoB;EAC9C,gBAAgB,QAAQ,kBAAkB,EAAE;EAC5C;EACA;EACA,cAAc,QAAQ,gBAAgB,EAAE;EACxC,cAAc,QAAQ;EACtB,WAAW,0BAA0B,QAAQ,UAAU;EACvD,aAAa,QAAQ,eAAe;EACpC,eAAe,QAAQ,iBAAiB;EACxC,sBAAsB,QAAQ,wBAAwB;EACtD,SAAS,QAAQ,kBAAkB;EACnC,SAAS,QAAQ,kBAAkB;EACnC,SAAS,QAAQ,kBAAkB;EACnC,eAAe,QAAQ,wBAAwB;EAC/C,cAAc,QAAQ,uBAAuB;EAC7C,WAAW,QAAQ,oBAAoB;EACxC;;AAGH,SAAS,6BAA6B,SAAiB;AACrD,wBAAO,IAAI,MAAM,8BAA8B,QAAQ,IAAI;;AAG7D,SAAS,mBAAmB;AAC1B,wBAAO,IAAI,MAAM,qBAAqB;;AAGxC,IAAa,SAAb,MAAmC;CACjC;CACA;CACA,iCAAkC,IAAI,KAGnC;CAEH,iCAAkC,IAAI,KAAkD;CACxF,SAA+B;CAC/B;CACA;CAEA,YAAY,SAA2B;AACrC,OAAK,OAAO,iBAAiB,QAAQ;AACrC,OAAK,YAAYA,eAAwC;GACvD,WAAW,KAAK,KAAK;GACrB,WAAW,KAAK,wBAAwB;GACxC,WAAW,KAAK,wBAAwB;GACxC,UAAS,YAAW,KAAK,0BAA0B,QAAQ;GAC5D,CAAC;AAEF,OAAK,UAAU,WAAW,EAAE,cAAc;AACnC,QAAK,cAAc,QAAQ;IAChC;AACF,OAAK,UAAU,eAAe,EAAE,eAAe,YAAY;AACzD,QAAK,2BAA2B,eAAe,MAAM;IACrD;AAEF,MAAI,KAAK,KAAK,YACP,MAAK,SAAS,CAAC,OAAO,UAAU;GACnC,MAAM,aAAa,KAAK,eAAe,OAAO,qCAAqC;AACnF,QAAK,gBAAgB;AACrB,QAAK,KAAK,QAAQ,WAAW;IAC7B;;CAIN,IAAI,mBAAmB;AACrB,SAAO,KAAK;;CAGd,IAAI,UAAU;AACZ,SAAO,KAAK,WAAW;;CAGzB,IAAI,eAAe;AACjB,SAAO,KAAK,UAAU,UAAU,UAAU,KAAK,UAAU,UAAU,eAAe,KAAK,UAAU,UAAU;;CAG7G,IAAI,YAAY;AACd,SAAO,KAAK;;CAGd,MAAM,QAAQ,SAA0B;AACtC,MAAI,KAAK,WAAW,QAClB;AAGF,MAAI,CAAC,KAAK,eAAe,KAAK,UAAU,UAAU,eAChD,QAAO,KAAK,kBAAkB,KAAK,cAAc,EAAE,QAAQ;AAG7D,MAAI,CAAC,KAAK,gBAAgB,KAAK,UAAU,UAAU,UAAU,KAAK,UAAU,UAAU,aACpF,QAAO,KAAK,kBAAkB,KAAK,cAAc,EAAE,QAAQ;AAG7D,MAAI,CAAC,KAAK,YACR,MAAK,cAAc,KAAK,UAAU,SAAS,CAAC,cAAc;AACxD,QAAK,cAAc,KAAA;IACnB;AAGJ,SAAO,KAAK,kBAAkB,KAAK,aAAa,QAAQ;;CAG1D,MAAM,SAA0B;AAC9B,SAAO,KAAK,QAAQ,QAAQ;;CAG9B,gBAAgB,SAA0B;AACxC,SAAO,KAAK,QAAQ,QAAQ;;CAG9B,wBAAwB,UAAmE;AACzF,OAAK,eAAe,IAAI,SAAS;AAEjC,eAAa;AACX,QAAK,eAAe,OAAO,SAAS;;;CAIxC,QACE,OACA,UACY;EACZ,IAAI,YAAY,KAAK,eAAe,IAAI,MAAM;AAC9C,MAAI,CAAC,WAAW;AACd,+BAAY,IAAI,KAAK;AACrB,QAAK,eAAe,IAAI,OAAO,UAAU;;AAG3C,YAAU,IAAI,SAAgF;AAE9F,eAAa;AACX,QAAK,SAAS,OAAO,SAAS;;;CAIlC,SACE,OACA,UACM;EACN,MAAM,YAAY,KAAK,eAAe,IAAI,MAAM;AAChD,MAAI,CAAC,UACH;AAGF,MAAI,UAAU;AACZ,aAAU,OAAO,SAAgF;AACjG,OAAI,CAAC,UAAU,KACb,MAAK,eAAe,OAAO,MAAM;AAEnC;;AAGF,OAAK,eAAe,OAAO,MAAM;;CAGnC,KAAK,MAAgD;EACnD,MAAM,UAAU,KAAK,cAAc,KAAK;AAExC,MAAI,CADW,KAAK,UAAU,KAAK,QAAQ,CAC/B,GACV,QAAO;AAGT,OAAK,KAAK,UAAU,QAAQ;AAC5B,SAAO;;CAGT,YAAY,MAA6C;AACvD,MAAI,CAAC,KAAK,KAAK,KAAK,CAClB,OAAM,IAAI,MAAM,4CAA4C,KAAK,SAAS;;CAI9E,MAAM,MAAe,QAAuB;AAC1C,OAAK,UAAU,MAAM,MAAM,OAAO;;CAGpC,yBAA2D;AACzD,MAAI,CAAC,KAAK,KAAK,cACb,QAAO;AAGT,SAAO;GACL,UAAU,SAAS,UAAU;AAE3B,QAAI,2CADe,KAAK,eAAe,OAAO,qCAAqC,CACzB,QAAQ,CAChE,QAAO;AAGT,WAAO,KAAK,KAAK,yBAAyB,MAAM,WAAW,KAAK,KAAK;;GAEvE,WAAW,UAAU;IACnB,MAAM,aAAa,KAAK,eAAe,OAAO,qCAAqC;AACnF,QAAI,KAAK,kBAAkB,WACzB;AAGF,SAAK,gBAAgB;AACrB,SAAK,KAAK,QAAQ,WAAW;;GAEhC;;CAGH,yBAAiC;AAC/B,MAAI,CAAC,KAAK,KAAK,UACb,QAAO;AAGT,SAAO;GACL,MAAM;GACN,UAAU,KAAK,KAAK,UAAU;GAC9B,SAAS,KAAK,KAAK,UAAU;GAC7B,eAAe,KAAK,cAAc;IAChC,MAAM;IACN,MAAM;KACJ,MAAM,qBAAqB;KAC3B,SAAS,KAAK,KAAK,YAAY,KAAK,KAAK,UAAU,UAAU,iBAAiB;KAC9E,IAAI,KAAK,KAAK;KACf;IACF,CAAoC;GACtC;;CAGH,MAAc,0BAA0B,SAA2D;AACjG,MAAI,KAAK,KAAK,cAAc,UAAU;AACpC,OAAI,CAAC,QAAQ,aACX;AAGF,QAAK,aAAa,iBAAiB;AACnC,SAAM,KAAK,gCAAgC,QAAQ;AACnD;;AAGF,MAAI,KAAK,KAAK,OAAO;AACnB,QAAK,aAAa,iBAAiB;AACnC,WAAQ,KAAK,KAAK,cAAc;IAC9B,MAAM;IACN,MAAM,EAAE,OAAO,KAAK,KAAK,OAAO;IACjC,CAAoC,CAAC;AAEtC,SAAM,QAAQ,SAAS,YAAY;IACjC,MAAM,SAAS,KAAK,sBAAsB,QAAQ;AAClD,QAAI,OAAO,MACT,OAAM,OAAO;AAGf,WAAO,QAAQ,SAAS,0BAA0B,QAAQ,KAAK,kBAAkB;MAChF,EAAE,SAAS,KAAK,KAAK,kBAAkB,CAAC;;AAG7C,OAAK,aAAa,aAAa;AAC/B,UAAQ,KAAK,KAAK,cAAc;GAC9B,MAAM;GACN,MAAM;IACJ,MAAM,KAAK,KAAK;IAChB,UAAU,KAAK,KAAK;IACpB,gBAAgB,KAAK,KAAK;IAC1B,cAAc,KAAK,KAAK;IACxB,cAAc,KAAK,KAAK;IACzB;GACF,CAAoC,CAAC;AAEtC,QAAM,QAAQ,SAAS,YAAY;GACjC,MAAM,SAAS,KAAK,sBAAsB,QAAQ;AAClD,OAAI,OAAO,MACT,OAAM,OAAO;AAGf,UAAO,OAAO;KACb,EAAE,SAAS,KAAK,KAAK,kBAAkB,CAAC;;CAG7C,MAAc,gCAAgC,SAA2D;AACvG,QAAM,QAAQ,SAAS,YAAY;GACjC,MAAM,SAAS,KAAK,sBAAsB,QAAQ;AAClD,OAAI,OAAO,MACT,OAAM,OAAO;AAGf,UAAO,QAAQ,SAAS,wBAAwB,QAAQ,KAAK,kBAAkB;KAC9E,EAAE,SAAS,KAAK,KAAK,kBAAkB,CAAC;AAE3C,OAAK,aAAa,aAAa;AAE/B,QAAM,QAAQ,SAAS,YAAY;GACjC,MAAM,SAAS,KAAK,sBAAsB,QAAQ;AAClD,OAAI,OAAO,MACT,OAAM,OAAO;AAGf,UAAO,QAAQ,SAAS,yBACnB,QAAQ,KAAK,SAAS,OAAO,KAAK,KAAK,UAAU;KACrD,EAAE,SAAS,KAAK,KAAK,kBAAkB,CAAC;;CAG7C,sBAA8B,SAAgD;EAC5E,MAAM,QAAQ,KAAK,qBAAqB,QAAQ;AAChD,MAAI,OAAO;AACT,QAAK,gBAAgB;AACrB,UAAO;IAAE,OAAO;IAAO;IAAO;;AAGhC,MAAI,QAAQ,SAAS,6BACnB,QAAO,EAAE,OAAO,KAAK,yBAAyB,QAAQ,EAAE;AAG1D,MAAI,QAAQ,SAAS,wBACnB,QAAO,EAAE,OAAO,KAAK,4BAA4B,QAAQ,EAAE;AAG7D,SAAO,EAAE,OAAO,OAAO;;CAGzB,MAAc,cAAc,SAA2C;AACrE,OAAK,KAAK,aAAa,QAAQ;EAE/B,MAAM,QAAQ,KAAK,qBAAqB,QAAQ;AAChD,MAAI,OAAO;AACT,QAAK,gBAAgB;AACrB,QAAK,KAAK,QAAQ,MAAM;;AAG1B,MAAI,QAAQ,SAAS,oCAAoC,QAAQ,KAAK,SAAS,qBAAqB,KAClG,MAAK,KAAK;GACR,MAAM;GACN,MAAM;IACJ,MAAM,qBAAqB;IAC3B,SAAS,iBAAiB;IAC1B,IAAI,KAAK,KAAK;IACf;GACF,CAAoC;EAGvC,MAAM,YAAY,KAAK,eAAe,IAAI,QAAQ,KAAK;AACvD,MAAI,CAAC,WAAW,KACd;EAGF,MAAM,UAAU,MAAM,QAAQ,WAC5B,MAAM,KAAK,UAAU,CAAC,KAAI,aAAY,QAAQ,QAAQ,SAAS,QAA+C,CAAC,CAAC,CACjH;AAED,OAAK,MAAM,UAAU,QACnB,KAAI,OAAO,WAAW,YAAY;AAChC,QAAK,gBAAgB,KAAK,eAAe,OAAO,QAAQ,+BAA+B;AACvF,QAAK,KAAK,QAAQ,OAAO,OAAO;;;CAKtC,2BAAmC,eAA2D,OAAmD;AAC/I,MAAI,UAAU,SAAS;AACrB,QAAK,aAAa,QAAQ;AAC1B,QAAK,KAAK,SAAS;AACnB;;EAGF,MAAM,aAAa,KAAK,mBAAmB,MAAM;AACjD,MAAI,CAAC,WACH;AAGF,OAAK,aAAa,WAAW;AAE7B,MAAI,kBAAkB,WAAW,UAAU,eACzC,MAAK,KAAK,SAAS;WAEZ,UAAU,SACjB,MAAK,KAAK,SAAS;;CAIvB,mBAA2B,OAA6E;AACtG,UAAQ,OAAR;GACE,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK,SACH,QAAO;GACT,KAAK;GACL,KAAK;GACL,KAAK,QACH;;;CAIN,aAAqB,QAAsB;AACzC,MAAI,KAAK,WAAW,OAClB;EAGF,MAAM,iBAAiB,KAAK;AAC5B,OAAK,SAAS;EACd,MAAM,UAAU;GAAE;GAAgB;GAAQ;AAE1C,OAAK,KAAK,cAAc,QAAQ;AAEhC,OAAK,MAAM,YAAY,KAAK,eAC1B,UAAS,QAAQ;;CAIrB,MAAc,kBAAkB,gBAA+B,SAA0B;AACvF,MAAI,CAAC,SAAS,WAAW,CAAC,SAAS,YACjC,QAAO;EAGT,MAAM,UAAU,SAAS;AACzB,MAAI,OAAO,YAAY,eAAe,WAAW,EAC/C,OAAM,6BAA6B,QAAQ;EAG7C,MAAM,cAAc,SAAS;AAC7B,MAAI,aAAa,QACf,OAAM,kBAAkB;EAG1B,IAAI;EACJ,IAAI;AAEJ,MAAI;AACF,SAAM,QAAQ,KAAK,CACjB,gBACA,IAAI,SAAe,GAAG,WAAW;AAC/B,QAAI,OAAO,YAAY,YACrB,iBAAgB,iBAAiB;AAC/B,YAAO,6BAA6B,QAAQ,CAAC;OAC5C,QAAQ;AAGb,QAAI,aAAa;KACf,MAAM,gBAAgB,OAAO,kBAAkB,CAAC;AAChD,iBAAY,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM,CAAC;AAC9D,iCAA4B,YAAY,oBAAoB,SAAS,QAAQ;;KAE/E,CACH,CAAC;YAEI;AACN,OAAI,cACF,cAAa,cAAc;AAG7B,0BAAuB;;;CAI3B,eAAsC;AACpC,MAAI,KAAK,WAAW,QAClB,QAAO,QAAQ,SAAS;AAG1B,SAAO,IAAI,SAAe,SAAS,WAAW;GAC5C,MAAM,UAAU,KAAK,yBAAyB,EAAE,aAAa;AAC3D,QAAI,WAAW,SAAS;AACtB,cAAS;AACT,cAAS;AACT;;AAGF,QAAI,WAAW,YAAY,WAAW,UAAU;AAC9C,cAAS;AACT,YAAO,KAAK,iCAAiB,IAAI,MAAM,wCAAwC,SAAS,CAAC;;KAE3F;IACF;;CAGJ,qBAA6B,SAA+C;AAC1E,MAAI,QAAQ,SAAS,QACnB;EAGF,MAAM,eAAe,OAAO,QAAQ,KAAK,YAAY,WACjD,QAAQ,KAAK,UACb;EACJ,MAAM,SAAS,wBAAwB,aAAa;AAEpD,MAAI,OAAO,SAAS,UAClB,QAAO,IAAI,MAAM,aAAa;AAGhC,SAAO,IAAI,MAAM,OAAO,QAAQ;;CAGlC,eAAuB,OAAgB,UAAyB;AAC9D,SAAO,iBAAiB,QACpB,QACA,IAAI,MAAM,iBAAiB,MAAM,IAAI,SAAS;;CAGpD,yBAAiC,OAA2G;AAC1I,SAAO,MAAM,KAAK,SAAS,KAAK,KAAK,QAAQ,MAAM,KAAK,UAAU,OAAO,KAAK,KAAK,SAAS;;CAG9F,4BAAoC,OAAiG;AACnI,SAAO,MAAM,KAAK,QAAQ,MAAK,WAC7B,OAAO,SAAS,KAAK,KAAK,QACvB,OAAO,UAAU,OAAO,KAAK,KAAK,SAAS,GAC/C;;CAGH,cAAsB,MAAuC;AAC3D,SAAO;GACL,GAAG;GACH,UAAU;IACR,GAAG,KAAK;IACR,QAAQ,KAAK,UAAU,UAAU;KAC/B,MAAM;KACN,GAAG,KAAK,KAAK;KACb,QAAQ,EAAE,IAAI,KAAK,KAAK,UAAU,IAAI;KACvC;IACD,OAAO;KACL,GAAG,KAAK,UAAU;KAClB,IAAI,KAAK,UAAU,OAAO,MAAM,eAAe;KAChD;IACF;GACF;;;AAIL,SAAgB,aAA4B,SAAsC;AAChF,QAAO,IAAI,OAAO,QAAQ;;;;;;;ACnoB5B,IAAa,yBAAb,MAAmD;CACjD;CACA;CAEA,YAAY,SAA2C;AACrD,OAAK,YAAY,QAAQ;AACzB,OAAK,SAAS,QAAQ,UAAU,aAAgB;GAC9C,GAAG,QAAQ;GACX,MAAM,QAAQ,UAAU;GACxB,WAAW;GACX,aAAa,QAAQ,eAAe,eAAe;GACnD,eAAe,QAAQ,eAAe,iBAAiB;GACxD,CAAC;;CAGJ,QAAQ,SAAyC;AAC/C,SAAO,KAAK,OAAO,QAAQ,QAAQ;;CAGrC,iBAAiB,QAA6C,EAAE,EAAQ;AACtE,OAAK,OAAO,YAAY;GACtB,MAAM;GACN,MAAM;GACP,CAAC;;CAGJ,kBAAkB,QAAuD,EAAE,EAAQ;AACjF,OAAK,OAAO,YAAY;GACtB,MAAM;GACN,MAAM;IACJ,UAAU,KAAK;IACf,aAAa,MAAM;IACpB;GACF,CAAC;;CAGJ,eAAe,OAA8C;AAC3D,OAAK,OAAO,YAAY;GACtB,MAAM;GACN,MAAM;IACJ,MAAM,MAAM;IACZ,UAAU;KACR,IAAI,MAAM;KACV,WAAW,KAAK;KAChB,QAAQ,MAAM;KACf;IACD,gBAAgB,MAAM,kBAAkB,EAAE;IAC1C,aAAa,MAAM;IACnB,cAAc,MAAM;IACpB,cAAc,MAAM;IACrB;GACF,CAAC;;CAGJ,KAAK,MAAgD;AACnD,SAAO,KAAK,OAAO,KAAK,KAAK;;CAG/B,QACE,OACA,UACY;AACZ,MAAI,CAAC,KAAK,OAAO,QACf,OAAM,IAAI,MAAM,kEAAkE;AAGpF,SAAO,KAAK,OAAO,QAAQ,OAAO,SAAS;;CAG7C,QAAc;AACZ,OAAK,OAAO,OAAO;;;;AAKvB,SAAgB,6BACd,SAC2B;AAC3B,QAAO,IAAI,uBAAuB,QAAQ"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@proj-airi/server-sdk",
   "type": "module",
-  "version": "0.10.2",
+  "version": "0.11.0",
   "description": "Client-side SDK implementation for connecting to AIRI server components and runtimes",
   "author": {
     "name": "Moeru AI Project AIRI Team",
@@ -33,9 +33,10 @@
   ],
   "dependencies": {
     "@moeru/std": "0.1.0-beta.17",
-    "crossws": "^0.4.5",
     "superjson": "^2.2.6",
-    "@proj-airi/server-shared": "^0.10.2"
+    "valibot": "^1.3.1",
+    "@proj-airi/better-ws": "^0.11.0",
+    "@proj-airi/server-shared": "^0.11.0"
   },
   "scripts": {
     "dev": "pnpm run build",