@kuralle-syrinx/server-websocket 4.4.0 → 4.5.0

package/dist/test-helpers.d.ts

@@ -0,0 +1,20 @@
+import type { Server as HttpServer } from "node:http";
+import WebSocket from "ws";
+export declare const DEFAULT_CONDITION_TIMEOUT_MS = 5000;
+interface ClosableServer {
+    close(): Promise<void>;
+}
+export declare function registerServer<T extends ClosableServer>(server: T): T;
+export declare function registerHttpServer(server: HttpServer): HttpServer;
+export declare function registerSocket(socket: WebSocket): WebSocket;
+export declare function setupTransportTestCleanup(): void;
+export declare function openSocket(url: string, options?: WebSocket.ClientOptions): Promise<WebSocket>;
+export declare function openSmartPbxSocket(url: string): Promise<WebSocket>;
+export declare function openBrowserSocketReady(url: string, options?: WebSocket.ClientOptions): Promise<WebSocket>;
+export declare function openBrowserClientAndReadReady(url: string, options?: WebSocket.ClientOptions): Promise<[WebSocket, any]>;
+export declare function readJson(socket: WebSocket): Promise<any>;
+export declare function readJsonMatching(socket: WebSocket, predicate: (message: any) => boolean): Promise<any>;
+export declare function waitForCondition(predicate: () => boolean, timeoutMs?: number): Promise<void>;
+export declare function waitForClose(socket: WebSocket): Promise<number>;
+export {};
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,eAAO,MAAM,4BAA4B,OAAO,CAAC;AA0BjD,UAAU,cAAc;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAMD,wBAAgB,cAAc,CAAC,CAAC,SAAS,cAAc,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAGrE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAGjE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAG3D;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CA0BhD;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAOnG;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAsCxE;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAmB/G;AAED,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,SAAS,CAAC,aAAa,GAChC,OAAO,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAqB3B;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAwB9D;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,GACnC,OAAO,CAAC,GAAG,CAAC,CA0Bd;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,OAAO,EACxB,SAAS,SAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAe/D"}

package/dist/test-helpers.js

@@ -0,0 +1,242 @@
+// SPDX-License-Identifier: MIT
+import { afterEach, beforeEach } from "vitest";
+import WebSocket from "ws";
+export const DEFAULT_CONDITION_TIMEOUT_MS = 5000;
+const HTTP_SERVER_CLOSE_FALLBACK_MS = 500;
+function closeHttpServerBounded(httpServer) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(fallbackTimer);
+            resolve();
+        };
+        const fallbackTimer = setTimeout(finish, HTTP_SERVER_CLOSE_FALLBACK_MS);
+        if (typeof httpServer.closeAllConnections === "function") {
+            httpServer.closeAllConnections();
+        }
+        else if (typeof httpServer.closeIdleConnections === "function") {
+            httpServer.closeIdleConnections();
+        }
+        httpServer.close(() => finish());
+    });
+}
+let activeServers = [];
+let activeHttpServers = [];
+let activeSockets = [];
+export function registerServer(server) {
+    activeServers.push(server);
+    return server;
+}
+export function registerHttpServer(server) {
+    activeHttpServers.push(server);
+    return server;
+}
+export function registerSocket(socket) {
+    activeSockets.push(socket);
+    return socket;
+}
+export function setupTransportTestCleanup() {
+    beforeEach(() => {
+        activeServers = [];
+        activeHttpServers = [];
+        activeSockets = [];
+    });
+    afterEach(async () => {
+        await Promise.allSettled(activeSockets.map((socket) => {
+            if (socket.readyState === WebSocket.OPEN || socket.readyState === WebSocket.CONNECTING) {
+                socket.terminate();
+            }
+            return new Promise((resolve) => {
+                if (socket.readyState === WebSocket.CLOSED) {
+                    resolve();
+                    return;
+                }
+                socket.once("close", () => resolve());
+            });
+        }));
+        await Promise.allSettled(activeServers.map((server) => server.close()));
+        await Promise.allSettled(activeHttpServers.map((httpServer) => closeHttpServerBounded(httpServer)));
+        activeServers = [];
+        activeHttpServers = [];
+        activeSockets = [];
+    });
+}
+export async function openSocket(url, options) {
+    const socket = registerSocket(new WebSocket(url, options));
+    await new Promise((resolveOpen, reject) => {
+        socket.once("open", resolveOpen);
+        socket.once("error", reject);
+    });
+    return socket;
+}
+export async function openSmartPbxSocket(url) {
+    const startedAt = Date.now();
+    let lastError;
+    while (Date.now() - startedAt < DEFAULT_CONDITION_TIMEOUT_MS) {
+        const socket = registerSocket(new WebSocket(url));
+        try {
+            await new Promise((resolveOpen, reject) => {
+                const cleanup = () => {
+                    socket.off("open", onOpen);
+                    socket.off("error", onError);
+                    socket.off("unexpected-response", onUnexpectedResponse);
+                };
+                const onOpen = () => {
+                    cleanup();
+                    resolveOpen();
+                };
+                const onError = (err) => {
+                    cleanup();
+                    reject(err);
+                };
+                const onUnexpectedResponse = (_request, response) => {
+                    cleanup();
+                    response.resume();
+                    reject(new Error(`Unexpected server response: ${String(response.statusCode)}`));
+                };
+                socket.once("open", onOpen);
+                socket.once("error", onError);
+                socket.once("unexpected-response", onUnexpectedResponse);
+            });
+            return socket;
+        }
+        catch (err) {
+            socket.terminate();
+            lastError = err;
+            if (!(err instanceof Error) || !err.message.includes("Unexpected server response: 404"))
+                throw err;
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+export async function openBrowserSocketReady(url, options) {
+    const socket = registerSocket(new WebSocket(url, options));
+    await new Promise((resolve, reject) => {
+        const onMessage = (data, isBinary) => {
+            if (isBinary)
+                return;
+            try {
+                const parsed = JSON.parse(data.toString());
+                if (parsed.type === "ready") {
+                    socket.off("message", onMessage);
+                    resolve();
+                }
+            }
+            catch {
+                // Ignore non-JSON frames while waiting for ready.
+            }
+        };
+        socket.on("message", onMessage);
+        socket.once("error", reject);
+    });
+    return socket;
+}
+export async function openBrowserClientAndReadReady(url, options) {
+    const socket = registerSocket(new WebSocket(url, options));
+    let readyMessage;
+    await new Promise((resolve, reject) => {
+        const onMessage = (data, isBinary) => {
+            if (isBinary)
+                return;
+            try {
+                const parsed = JSON.parse(data.toString());
+                if (parsed.type === "ready") {
+                    readyMessage = parsed;
+                    socket.off("message", onMessage);
+                    resolve();
+                }
+            }
+            catch {
+                // Ignore non-JSON frames while waiting for ready.
+            }
+        };
+        socket.on("message", onMessage);
+        socket.once("error", reject);
+    });
+    return [socket, readyMessage];
+}
+export async function readJson(socket) {
+    return new Promise((resolve, reject) => {
+        const cleanup = () => {
+            socket.off("message", onMessage);
+            socket.off("close", onClose);
+            socket.off("error", onError);
+        };
+        const onMessage = (data, isBinary) => {
+            if (isBinary)
+                return;
+            cleanup();
+            resolve(JSON.parse(data.toString()));
+        };
+        const onClose = () => {
+            cleanup();
+            reject(new Error("Socket closed before JSON message"));
+        };
+        const onError = (err) => {
+            cleanup();
+            reject(err);
+        };
+        socket.on("message", onMessage);
+        socket.once("close", onClose);
+        socket.once("error", onError);
+    });
+}
+export async function readJsonMatching(socket, predicate) {
+    return new Promise((resolve, reject) => {
+        const cleanup = () => {
+            socket.off("message", onMessage);
+            socket.off("close", onClose);
+            socket.off("error", onError);
+        };
+        const onMessage = (data, isBinary) => {
+            if (isBinary)
+                return;
+            const message = JSON.parse(data.toString());
+            if (!predicate(message))
+                return;
+            cleanup();
+            resolve(message);
+        };
+        const onClose = () => {
+            cleanup();
+            reject(new Error("Socket closed before matching JSON message"));
+        };
+        const onError = (err) => {
+            cleanup();
+            reject(err);
+        };
+        socket.on("message", onMessage);
+        socket.once("close", onClose);
+        socket.once("error", onError);
+    });
+}
+export async function waitForCondition(predicate, timeoutMs = DEFAULT_CONDITION_TIMEOUT_MS) {
+    const startedAt = Date.now();
+    while (Date.now() - startedAt < timeoutMs) {
+        if (predicate())
+            return;
+        await new Promise((resolve) => setTimeout(resolve, 10));
+    }
+    throw new Error("Timed out waiting for condition");
+}
+export function waitForClose(socket) {
+    if (socket.readyState === WebSocket.CLOSED) {
+        return Promise.resolve(1006);
+    }
+    return new Promise((resolve) => {
+        let done = false;
+        const finish = (code) => {
+            if (!done) {
+                done = true;
+                resolve(code);
+            }
+        };
+        socket.on("close", (code) => finish(code));
+        socket.on("error", () => finish(1006));
+    });
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/test-helpers.js.map

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

package/dist/transport-helpers.d.ts

@@ -0,0 +1,12 @@
+import type { RawData } from "ws";
+export declare function positiveInteger(value: unknown): number | null;
+export declare function nonNegativeInteger(value: unknown): number | null;
+export declare function numberFromString(value: number | string | undefined): number | null;
+export declare function optionalPositiveIntegerString(value: string | undefined, name: string): number | undefined;
+export declare function optionalNonNegativeIntegerString(value: string | undefined, name: string): number | undefined;
+export declare function rawDataToText(data: RawData): string;
+export declare function rawDataByteLength(data: RawData): number;
+export declare function cloneRawData(data: RawData): RawData;
+export declare function decodeStrictBase64(value: string, fieldName: string): Uint8Array;
+export declare function requireTtsAudioSampleRate(value: unknown): number;
+//# sourceMappingURL=transport-helpers.d.ts.map

package/dist/transport-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-helpers.d.ts","sourceRoot":"","sources":["../src/transport-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAElC,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG7D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAOlF;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzG;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM5G;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAMnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAMvD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAMnD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAQ/E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIhE"}

package/dist/transport-helpers.js

@@ -0,0 +1,90 @@
+// SPDX-License-Identifier: MIT
+export function positiveInteger(value) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value <= 0)
+        return null;
+    return value;
+}
+export function nonNegativeInteger(value) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 0)
+        return null;
+    return value;
+}
+export function numberFromString(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return null;
+}
+export function optionalPositiveIntegerString(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (!/^[0-9]+$/.test(value))
+        throw new Error(`${name} must be a positive integer string`);
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed <= 0)
+        throw new Error(`${name} must be a positive integer string`);
+    return parsed;
+}
+export function optionalNonNegativeIntegerString(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (!/^[0-9]+$/.test(value))
+        throw new Error(`${name} must be a non-negative integer string`);
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed))
+        throw new Error(`${name} must be a non-negative integer string`);
+    return parsed;
+}
+export function rawDataToText(data) {
+    if (typeof data === "string")
+        return data;
+    if (Buffer.isBuffer(data))
+        return data.toString("utf8");
+    if (data instanceof ArrayBuffer)
+        return Buffer.from(data).toString("utf8");
+    if (Array.isArray(data))
+        return Buffer.concat(data).toString("utf8");
+    throw new Error("Unsupported text message payload");
+}
+export function rawDataByteLength(data) {
+    if (typeof data === "string")
+        return Buffer.byteLength(data, "utf8");
+    if (Buffer.isBuffer(data))
+        return data.byteLength;
+    if (data instanceof ArrayBuffer)
+        return data.byteLength;
+    if (Array.isArray(data))
+        return data.reduce((sum, chunk) => sum + chunk.byteLength, 0);
+    return 0;
+}
+export function cloneRawData(data) {
+    if (typeof data === "string")
+        return data;
+    if (Buffer.isBuffer(data))
+        return Buffer.from(data);
+    if (data instanceof ArrayBuffer)
+        return data.slice(0);
+    if (Array.isArray(data))
+        return data.map((chunk) => Buffer.from(chunk));
+    throw new Error("Unsupported websocket message payload");
+}
+export function decodeStrictBase64(value, fieldName) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`${fieldName} must be a non-empty base64 string`);
+    }
+    if (value.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(value)) {
+        throw new Error(`${fieldName} must be valid base64`);
+    }
+    return Uint8Array.from(Buffer.from(value, "base64"));
+}
+export function requireTtsAudioSampleRate(value) {
+    const sampleRateHz = positiveInteger(value);
+    if (sampleRateHz === null)
+        throw new Error("tts.audio sampleRateHz must be a positive integer");
+    return sampleRateHz;
+}
+//# sourceMappingURL=transport-helpers.js.map

package/dist/transport-helpers.js.map

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

package/dist/transport-host.d.ts

@@ -0,0 +1,56 @@
+import type { IncomingMessage } from "node:http";
+import type { Socket } from "node:net";
+import { WebSocket, WebSocketServer, type RawData } from "ws";
+import type { VoiceAgentSession } from "@kuralle-syrinx/core";
+export interface TransportHostConfig {
+    readonly heartbeatIntervalMs: number;
+    readonly startupTimeoutMs: number;
+    readonly maxSessionDurationMs: number;
+    readonly maxBufferedAmountBytes: number;
+    readonly maxInboundMessageBytes: number;
+}
+export interface TransportAdmissionOptions {
+    readonly maxConcurrentSessions?: number;
+    readonly maxConcurrentSessionsScope?: "path" | "server";
+    readonly onAdmissionRejected?: () => void;
+    /**
+     * Authorize an inbound connection before the WebSocket upgrade completes. Return
+     * false (or throw) to reject with 4401. Voice endpoints are unauthenticated by
+     * default and each connection incurs provider cost and can attach to a live
+     * session — set this (shared secret / bearer / Twilio signature) before exposing
+     * the endpoint. Receives the raw upgrade request (headers + URL) so it can read
+     * an `Authorization` header or a `?token=` query param.
+     */
+    readonly authorize?: (request: IncomingMessage) => boolean | Promise<boolean>;
+}
+export declare const TRANSPORT_ADMISSION_REJECTED_METRIC = "transport.admission_rejected";
+export declare function rejectWebSocketAdmission(wsServer: WebSocketServer, request: IncomingMessage, socket: Socket, head: Buffer, code?: number, reason?: string): void;
+export interface GracefulCloseOptions {
+    readonly graceful?: boolean;
+    readonly drainDeadlineMs?: number;
+}
+export interface TransportAdapter<TState> {
+    createState(): TState;
+    acquireSession(args: {
+        readonly request: IncomingMessage;
+        readonly state: TState;
+        readonly shouldAbort: () => boolean;
+        readonly onSessionCreated: (session: VoiceAgentSession) => void;
+    }): Promise<{
+        readonly session: VoiceAgentSession;
+        readonly resumed: boolean;
+    }>;
+    wireSession(session: VoiceAgentSession, socket: WebSocket, state: TState, disposers: Array<() => void>): (reason: string) => void;
+    processMessage(data: RawData, isBinary: boolean, session: VoiceAgentSession, state: TState): void;
+    onSocketClose?(state: TState, session: VoiceAgentSession | null): void;
+    onDisconnect(session: VoiceAgentSession, state: TState, opts: {
+        readonly maxSessionTimedOut: boolean;
+    }): void;
+    onStartupTimeout(state: TState, session: VoiceAgentSession): void;
+    sendReady?(session: VoiceAgentSession, socket: WebSocket, state: TState, resumed: boolean, config: TransportHostConfig): void;
+    sendError(socket: WebSocket, state: TState, message: string): void;
+    sendStartupError(socket: WebSocket, state: TState, err: unknown, isTimeout: boolean): void;
+    onMaxSessionTimeout?(socket: WebSocket, state: TState): void;
+}
+export declare function runWebSocketConnection<TState>(socket: WebSocket, request: IncomingMessage, config: TransportHostConfig, adapter: TransportAdapter<TState>): Promise<void>;
+//# sourceMappingURL=transport-host.d.ts.map

package/dist/transport-host.d.ts.map

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

package/dist/transport-host.js

@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: MIT
+import { WebSocket } from "ws";
+import { WebSocketStartupTimeoutError, startWebSocketHeartbeat, startWebSocketMaxSessionDuration, withWebSocketStartupTimeout, } from "./websocket-lifecycle.js";
+import { cloneRawData, rawDataByteLength } from "./transport-helpers.js";
+export const TRANSPORT_ADMISSION_REJECTED_METRIC = "transport.admission_rejected";
+export function rejectWebSocketAdmission(wsServer, request, socket, head, code = 1013, reason = "try again later") {
+    wsServer.handleUpgrade(request, socket, head, (websocket) => {
+        websocket.close(code, reason);
+    });
+}
+export async function runWebSocketConnection(socket, request, config, adapter) {
+    const state = adapter.createState();
+    const disposers = [];
+    const pendingMessages = [];
+    let pendingMessageBytes = 0;
+    let ready = false;
+    let socketClosed = socket.readyState === WebSocket.CLOSED || socket.readyState === WebSocket.CLOSING;
+    if (socketClosed) {
+        return;
+    }
+    let maxSessionTimedOut = false;
+    let startupTimedOut = false;
+    let teardown = () => undefined;
+    let session = null;
+    const startupSession = {};
+    const processMessage = (data, isBinary) => {
+        if (!session)
+            return;
+        adapter.processMessage(data, isBinary, session, state);
+    };
+    const handleMessage = (data, isBinary) => {
+        try {
+            const byteLength = rawDataByteLength(data);
+            if (byteLength > config.maxInboundMessageBytes) {
+                adapter.sendError(socket, state, `Websocket message exceeds maxInboundMessageBytes (${String(config.maxInboundMessageBytes)})`);
+                socket.close(1009, "websocket message too large");
+                return;
+            }
+            if (!ready) {
+                pendingMessageBytes += byteLength;
+                if (pendingMessageBytes > config.maxInboundMessageBytes) {
+                    adapter.sendError(socket, state, `Pending websocket input exceeds maxInboundMessageBytes (${String(config.maxInboundMessageBytes)}) before session ready`);
+                    socket.close(1009, "websocket pending input too large");
+                    return;
+                }
+                pendingMessages.push({ data: cloneRawData(data), isBinary, byteLength });
+                return;
+            }
+            processMessage(data, isBinary);
+        }
+        catch (err) {
+            adapter.sendError(socket, state, err instanceof Error ? err.message : String(err));
+        }
+    };
+    socket.on("message", handleMessage);
+    socket.on("close", () => {
+        socketClosed = true;
+        adapter.onSocketClose?.(state, session);
+        teardown("disconnect");
+        for (const dispose of disposers.splice(0))
+            dispose();
+        if (session) {
+            adapter.onDisconnect(session, state, { maxSessionTimedOut });
+        }
+    });
+    try {
+        const startup = adapter.acquireSession({
+            request,
+            state,
+            shouldAbort: () => socketClosed || startupTimedOut,
+            onSessionCreated: (s) => { startupSession.current = s; },
+        });
+        startup.catch(() => undefined);
+        const acquired = await withWebSocketStartupTimeout(startup, config.startupTimeoutMs);
+        session = acquired.session;
+        if (socketClosed) {
+            adapter.onDisconnect(session, state, { maxSessionTimedOut });
+            return;
+        }
+        startWebSocketHeartbeat(socket, config.heartbeatIntervalMs, disposers);
+        startWebSocketMaxSessionDuration(socket, config.maxSessionDurationMs, disposers, () => {
+            maxSessionTimedOut = true;
+            adapter.onMaxSessionTimeout?.(socket, state);
+        });
+        teardown = adapter.wireSession(session, socket, state, disposers);
+        adapter.sendReady?.(session, socket, state, acquired.resumed, config);
+        ready = true;
+        for (const pending of pendingMessages.splice(0)) {
+            pendingMessageBytes -= pending.byteLength;
+            try {
+                processMessage(pending.data, pending.isBinary);
+            }
+            catch (err) {
+                adapter.sendError(socket, state, err instanceof Error ? err.message : String(err));
+            }
+        }
+        pendingMessageBytes = 0;
+    }
+    catch (err) {
+        if (err instanceof WebSocketStartupTimeoutError) {
+            startupTimedOut = true;
+            if (startupSession.current) {
+                adapter.onStartupTimeout(state, startupSession.current);
+            }
+        }
+        adapter.sendStartupError(socket, state, err, err instanceof WebSocketStartupTimeoutError);
+        socket.close(1011, "session initialization failed");
+    }
+}
+//# sourceMappingURL=transport-host.js.map

package/dist/transport-host.js.map

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