@kuralle-syrinx/server-websocket 4.4.0 → 4.5.0

package/dist/twilio.js

@@ -0,0 +1,511 @@
+// SPDX-License-Identifier: MIT
+import { createServer } from "node:http";
+import { WebSocket } from "ws";
+import { Route } from "@kuralle-syrinx/core";
+import { decodeMuLawToPcm16, encodePcm16ToMuLaw, pcm16BytesToSamples, pcm16SamplesToBytes, resamplePcm16Streaming, } from "@kuralle-syrinx/core/audio";
+import { sendJsonCapped } from "./websocket-close.js";
+import { optionalRecord, optionalString, optionalStringOrNumber, parseJsonRecord, requiredString, } from "./json-message.js";
+import { createRoutedWebSocketServer } from "./websocket-upgrade.js";
+import { runWebSocketConnection, TRANSPORT_ADMISSION_REJECTED_METRIC } from "./transport-host.js";
+import { BackgroundAudioMixer } from "./background-audio.js";
+import { wireTelephonyOutboundPipeline, installTelephonyTurnRotation } from "./outbound-playout-pipeline.js";
+import { decodeStrictBase64, nonNegativeInteger, numberFromString, optionalNonNegativeIntegerString, optionalPositiveIntegerString, positiveInteger, rawDataToText, } from "./transport-helpers.js";
+import { wireCarrierControl } from "./wire-carrier-control.js";
+const DEFAULT_ENGINE_SAMPLE_RATE_HZ = 16000;
+const DEFAULT_TWILIO_SAMPLE_RATE_HZ = 8000;
+const DEFAULT_OUTBOUND_FRAME_DURATION_MS = 20;
+// Bounds queue memory + sanity only. TTS providers legitimately burst entire
+// replies ahead of realtime (Deepgram); the pacer drains at wire rate and
+// barge-in clear is O(1), so a generous cap is safe. A tiny cap turns every
+// long reply into dropped audio.
+const DEFAULT_MAX_QUEUED_OUTPUT_AUDIO_MS = 60_000;
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 30_000;
+const DEFAULT_STARTUP_TIMEOUT_MS = 15_000;
+const DEFAULT_MAX_SESSION_DURATION_MS = 30 * 60_000;
+const DEFAULT_MAX_BUFFERED_AMOUNT_BYTES = 8 * 1024 * 1024;
+const DEFAULT_MAX_INBOUND_MESSAGE_BYTES = 256 * 1024;
+export async function createTwilioMediaStreamServer(options) {
+    const ownsHttpServer = !options.server;
+    const httpServer = options.server ?? createServer();
+    const routedWebSocket = createRoutedWebSocketServer(httpServer, options.path ?? "/twilio", {
+        maxConcurrentSessions: positiveInteger(options.maxConcurrentSessions) ?? undefined,
+        maxConcurrentSessionsScope: options.maxConcurrentSessionsScope,
+        onAdmissionRejected: () => options.onTransportMetric?.(TRANSPORT_ADMISSION_REJECTED_METRIC),
+    });
+    const wsServer = routedWebSocket.wsServer;
+    const sessions = new Set();
+    const inputSampleRateHz = positiveInteger(options.inputSampleRateHz) ?? DEFAULT_ENGINE_SAMPLE_RATE_HZ;
+    const twilioSampleRateHz = positiveInteger(options.twilioSampleRateHz) ?? DEFAULT_TWILIO_SAMPLE_RATE_HZ;
+    const outboundFrameDurationMs = positiveInteger(options.outboundFrameDurationMs) ?? DEFAULT_OUTBOUND_FRAME_DURATION_MS;
+    const maxQueuedOutputAudioMs = positiveInteger(options.maxQueuedOutputAudioMs) ?? DEFAULT_MAX_QUEUED_OUTPUT_AUDIO_MS;
+    const frameBytes = Math.max(1, Math.round((twilioSampleRateHz * outboundFrameDurationMs) / 1000));
+    const hostConfig = {
+        heartbeatIntervalMs: nonNegativeInteger(options.heartbeatIntervalMs) ?? DEFAULT_HEARTBEAT_INTERVAL_MS,
+        startupTimeoutMs: nonNegativeInteger(options.startupTimeoutMs) ?? DEFAULT_STARTUP_TIMEOUT_MS,
+        maxSessionDurationMs: nonNegativeInteger(options.maxSessionDurationMs) ?? DEFAULT_MAX_SESSION_DURATION_MS,
+        maxBufferedAmountBytes: positiveInteger(options.maxBufferedAmountBytes) ?? DEFAULT_MAX_BUFFERED_AMOUNT_BYTES,
+        maxInboundMessageBytes: positiveInteger(options.maxInboundMessageBytes) ?? DEFAULT_MAX_INBOUND_MESSAGE_BYTES,
+    };
+    const contextIdFn = options.contextId ?? defaultTwilioContextId;
+    const gracefulCloseRegistry = new Map();
+    const adapter = {
+        createState: () => ({
+            streamSid: "",
+            callSid: "",
+            contextId: "",
+            contextBase: "",
+            turnCounter: 0,
+            started: false,
+            stopped: false,
+            lastInboundSequenceNumber: null,
+            lastInboundMediaChunk: null,
+            lastInboundMediaTimestampMs: null,
+            outboundSequence: 0,
+            pendingMarks: new Set(),
+            pendingEndMarkName: "",
+            clearPlayout: () => undefined,
+            streamingResamplers: new Map(),
+        }),
+        async acquireSession({ request, shouldAbort, onSessionCreated }) {
+            const sess = await options.createSession(request);
+            onSessionCreated(sess);
+            if (shouldAbort()) {
+                await sess.close().catch(() => undefined);
+                throw new Error("Twilio websocket session startup aborted");
+            }
+            sessions.add(sess);
+            await sess.start();
+            if (shouldAbort()) {
+                sessions.delete(sess);
+                await sess.close().catch(() => undefined);
+                throw new Error("Twilio websocket session startup aborted");
+            }
+            return { session: sess, resumed: false };
+        },
+        wireSession(session, socket, state, disposers) {
+            const sendPendingEndMark = () => {
+                if (state.stopped || !state.streamSid || !state.pendingEndMarkName || state.pendingMarks.size > 0)
+                    return;
+                const markName = state.pendingEndMarkName;
+                const sent = sendTwilioJson(socket, {
+                    event: "mark",
+                    streamSid: state.streamSid,
+                    mark: { name: markName },
+                }, hostConfig.maxBufferedAmountBytes);
+                if (sent)
+                    state.pendingEndMarkName = "";
+            };
+            state.onPlaybackMarkReceived = sendPendingEndMark;
+            wireCarrierControl(session, disposers, {
+                carrier: "twilio",
+                getCallSid: () => state.callSid || undefined,
+                credentials: options.restCredentials,
+                fetchImpl: options.restFetch,
+                redirectUrl: options.transferRedirectUrl,
+                warmSummarizer: options.warmTransferSummarizer,
+            });
+            const outbound = wireTelephonyOutboundPipeline({
+                session,
+                socket,
+                disposers,
+                outboundFrameDurationMs,
+                maxQueuedOutputAudioMs,
+                ...(options.backgroundAudio ? { backgroundAudio: new BackgroundAudioMixer(options.backgroundAudio) } : {}),
+                callbacks: {
+                    carrierLabel: "twilio",
+                    getContextId: () => state.contextId,
+                    isActive: () => !state.stopped && !!state.streamSid,
+                    encodeFrames: (audio, sourceSampleRateHz, contextId) => {
+                        const samples = pcm16BytesToSamples(audio);
+                        const resampled = resamplePcm16Streaming(state.streamingResamplers, samples, sourceSampleRateHz, twilioSampleRateHz);
+                        const encoded = encodePcm16ToMuLaw(resampled);
+                        const frames = [];
+                        for (let offset = 0; offset < encoded.byteLength; offset += frameBytes) {
+                            const frame = encoded.subarray(offset, Math.min(encoded.byteLength, offset + frameBytes));
+                            frames.push({
+                                contextId,
+                                send: () => {
+                                    if (state.stopped)
+                                        return false;
+                                    return sendTwilioJson(socket, {
+                                        event: "media",
+                                        streamSid: state.streamSid,
+                                        media: { payload: Buffer.from(frame).toString("base64") },
+                                    }, hostConfig.maxBufferedAmountBytes);
+                                },
+                            });
+                        }
+                        state.outboundSequence += 1;
+                        const markName = `${contextId}:${String(state.outboundSequence)}`;
+                        const finalFrame = frames.at(-1);
+                        if (finalFrame) {
+                            frames[frames.length - 1] = {
+                                contextId,
+                                send: finalFrame.send,
+                                afterSend: () => {
+                                    if (state.stopped)
+                                        return;
+                                    const sent = sendTwilioJson(socket, {
+                                        event: "mark",
+                                        streamSid: state.streamSid,
+                                        mark: { name: markName },
+                                    }, hostConfig.maxBufferedAmountBytes);
+                                    if (sent) {
+                                        state.pendingMarks.add(markName);
+                                        session.bus.push(Route.Background, {
+                                            kind: "metric.conversation",
+                                            contextId,
+                                            timestampMs: Date.now(),
+                                            name: "twilio.mark_sent",
+                                            value: markName,
+                                        });
+                                    }
+                                },
+                            };
+                        }
+                        return frames;
+                    },
+                    onInterrupt: (contextId) => {
+                        state.pendingMarks.clear();
+                        state.pendingEndMarkName = "";
+                        const sent = !state.stopped && !!state.streamSid && sendTwilioJson(socket, {
+                            event: "clear",
+                            streamSid: state.streamSid,
+                        }, hostConfig.maxBufferedAmountBytes);
+                        if (sent) {
+                            session.bus.push(Route.Background, {
+                                kind: "metric.conversation",
+                                contextId,
+                                timestampMs: Date.now(),
+                                name: "twilio.clear_sent",
+                                value: "1",
+                            });
+                        }
+                    },
+                    onDrain: (contextId, playout, progress) => {
+                        playout.enqueueControl(() => {
+                            if (state.stopped || !state.streamSid)
+                                return;
+                            progress.complete(contextId);
+                            state.pendingEndMarkName = `${contextId}:end`;
+                            sendPendingEndMark();
+                        });
+                    },
+                    onStop: () => { state.stopped = true; },
+                },
+            });
+            state.clearPlayout = outbound.clearPlayout;
+            installTelephonyTurnRotation(session, disposers, state);
+            gracefulCloseRegistry.set(socket, (deadlineMs) => outbound.drainAndClose(socket, deadlineMs));
+            disposers.push(() => gracefulCloseRegistry.delete(socket));
+            return (reason) => state.clearPlayout(reason);
+        },
+        processMessage(data, isBinary, session, state) {
+            if (isBinary)
+                throw new Error("Twilio Media Streams messages must be JSON text frames");
+            const message = parseTwilioMessage(parseJsonRecord(rawDataToText(data), "Twilio Media Streams message"));
+            const event = message.event;
+            rememberTwilioSequenceNumber(session, state, message.sequenceNumber);
+            if (event === "connected")
+                return;
+            if (event === "start") {
+                if (state.stopped)
+                    throw new Error("Twilio start event received after stream stop");
+                const start = message.start ?? {};
+                validateTwilioStart(start, twilioSampleRateHz);
+                state.streamSid = start.streamSid ?? message.streamSid ?? "";
+                if (!state.streamSid)
+                    throw new Error("Twilio start event is missing streamSid");
+                state.callSid = start.callSid?.trim() ?? "";
+                state.contextId = contextIdFn(start);
+                state.contextBase = state.contextId;
+                state.started = true;
+                return;
+            }
+            if (event === "media") {
+                if (state.stopped)
+                    return;
+                if (!state.started || !state.contextId)
+                    throw new Error("Twilio media event received before a valid start event");
+                const payload = message.media?.payload;
+                if (!payload)
+                    throw new Error("Twilio media event is missing media.payload");
+                rememberTwilioMediaChunk(session, state, message.media?.chunk);
+                const ulaw = decodeStrictBase64(payload, "media.payload");
+                const pcm8k = decodeMuLawToPcm16(ulaw);
+                rememberTwilioMediaTimestamp(session, state, message.media?.timestamp, pcm8k.length, twilioSampleRateHz);
+                const pcm16k = resamplePcm16Streaming(state.streamingResamplers, pcm8k, twilioSampleRateHz, inputSampleRateHz);
+                session.bus.push(Route.Main, {
+                    kind: "user.audio_received",
+                    contextId: state.contextId,
+                    timestampMs: Date.now(),
+                    audio: pcm16SamplesToBytes(pcm16k),
+                    sampleRateHz: inputSampleRateHz,
+                });
+                return;
+            }
+            if (event === "stop") {
+                state.stopped = true;
+                state.started = false;
+                state.pendingMarks.clear();
+                state.clearPlayout("stop");
+                session.close().catch(() => undefined);
+                return;
+            }
+            if (event === "mark") {
+                if (state.stopped)
+                    return;
+                const markName = message.mark?.name ?? "";
+                if (markName)
+                    state.pendingMarks.delete(markName);
+                state.onPlaybackMarkReceived?.();
+                session.bus.push(Route.Background, {
+                    kind: "metric.conversation",
+                    contextId: state.contextId,
+                    timestampMs: Date.now(),
+                    name: "twilio.mark_received",
+                    value: markName,
+                });
+                return;
+            }
+            if (event === "dtmf") {
+                if (state.stopped)
+                    return;
+                if (!state.started || !state.contextId) {
+                    session.bus.push(Route.Background, {
+                        kind: "metric.conversation",
+                        contextId: "",
+                        timestampMs: Date.now(),
+                        name: "twilio.dtmf.before_start",
+                        value: message.dtmf?.digit ?? "",
+                    });
+                    return;
+                }
+                const rawDigit = message.dtmf?.digit ?? "";
+                const digit = parseDtmfDigit(rawDigit);
+                if (!digit) {
+                    session.bus.push(Route.Background, {
+                        kind: "metric.conversation",
+                        contextId: state.contextId,
+                        timestampMs: Date.now(),
+                        name: "dtmf.unparsed",
+                        value: rawDigit,
+                    });
+                    return;
+                }
+                session.bus.push(Route.Critical, {
+                    kind: "dtmf.received",
+                    contextId: state.contextId,
+                    timestampMs: Date.now(),
+                    digit,
+                    provider: "twilio",
+                    rawDigit,
+                });
+                return;
+            }
+            throw new Error(`Unsupported Twilio Media Streams event: ${String(event)}`);
+        },
+        onDisconnect(session) {
+            sessions.delete(session);
+            void session.close().catch(() => undefined);
+        },
+        onStartupTimeout(_state, session) {
+            sessions.delete(session);
+            void session.close().catch(() => undefined);
+        },
+        sendError(socket, state, message) {
+            sendTwilioError(socket, state.streamSid, message, hostConfig.maxBufferedAmountBytes);
+        },
+        sendStartupError(socket, state, err) {
+            sendTwilioError(socket, state.streamSid, err instanceof Error ? err.message : String(err), hostConfig.maxBufferedAmountBytes);
+        },
+    };
+    wsServer.on("connection", (socket, request) => {
+        void runWebSocketConnection(socket, request, hostConfig, adapter);
+    });
+    if (ownsHttpServer || typeof options.port === "number") {
+        await new Promise((resolveListen, reject) => {
+            httpServer.once("error", reject);
+            httpServer.listen(options.port ?? 0, options.host, () => {
+                httpServer.off("error", reject);
+                resolveListen();
+            });
+        });
+    }
+    let closing = false;
+    return {
+        httpServer,
+        wsServer,
+        address: () => httpServer.address(),
+        close: async (opts) => {
+            if (closing)
+                return;
+            closing = true;
+            if (opts?.graceful === true && gracefulCloseRegistry.size > 0) {
+                const deadline = Date.now() + (opts.drainDeadlineMs ?? 10_000);
+                await Promise.allSettled([...gracefulCloseRegistry.values()].map((fn) => fn(deadline)));
+                for (const client of wsServer.clients) {
+                    if (client.readyState === WebSocket.OPEN)
+                        client.terminate();
+                }
+            }
+            else {
+                for (const client of wsServer.clients)
+                    client.terminate();
+            }
+            gracefulCloseRegistry.clear();
+            for (const session of sessions)
+                await session.close().catch(() => undefined);
+            await new Promise((resolveClose) => { wsServer.close(() => resolveClose()); });
+            routedWebSocket.detach();
+            if (ownsHttpServer || typeof options.port === "number") {
+                await new Promise((resolveClose) => { httpServer.close(() => resolveClose()); });
+            }
+        },
+    };
+}
+const DTMF_DIGITS = new Set(["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "*", "#"]);
+function parseDtmfDigit(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length !== 1 || !DTMF_DIGITS.has(trimmed))
+        return null;
+    return trimmed;
+}
+function parseTwilioMessage(value) {
+    const start = optionalRecord(value.start, "Twilio start");
+    const media = optionalRecord(value.media, "Twilio media");
+    const mark = optionalRecord(value.mark, "Twilio mark");
+    const dtmf = optionalRecord(value.dtmf, "Twilio dtmf");
+    const mediaFormat = optionalRecord(start?.mediaFormat, "Twilio start.mediaFormat");
+    return {
+        event: requiredString(value.event, "Twilio event"),
+        streamSid: optionalString(value.streamSid, "Twilio streamSid"),
+        sequenceNumber: optionalString(value.sequenceNumber, "Twilio sequenceNumber"),
+        start: start
+            ? {
+                streamSid: optionalString(start.streamSid, "Twilio start.streamSid"),
+                callSid: optionalString(start.callSid, "Twilio start.callSid"),
+                mediaFormat: mediaFormat
+                    ? {
+                        encoding: optionalString(mediaFormat.encoding, "Twilio start.mediaFormat.encoding"),
+                        sampleRate: optionalStringOrNumber(mediaFormat.sampleRate, "Twilio start.mediaFormat.sampleRate"),
+                        channels: optionalStringOrNumber(mediaFormat.channels, "Twilio start.mediaFormat.channels"),
+                    }
+                    : undefined,
+            }
+            : undefined,
+        media: media
+            ? {
+                payload: optionalString(media.payload, "Twilio media.payload"),
+                track: optionalString(media.track, "Twilio media.track"),
+                chunk: optionalString(media.chunk, "Twilio media.chunk"),
+                timestamp: optionalString(media.timestamp, "Twilio media.timestamp"),
+            }
+            : undefined,
+        mark: mark ? { name: optionalString(mark.name, "Twilio mark.name") } : undefined,
+        dtmf: dtmf ? { digit: optionalString(dtmf.digit, "Twilio dtmf.digit") } : undefined,
+    };
+}
+function rememberTwilioSequenceNumber(session, state, sequenceValue) {
+    const sequence = optionalPositiveIntegerString(sequenceValue, "Twilio sequenceNumber");
+    if (sequence === undefined)
+        return;
+    const previous = state.lastInboundSequenceNumber;
+    if (previous !== null && sequence <= previous) {
+        throw new Error(`Twilio sequenceNumber must increase monotonically: ${String(previous)} -> ${String(sequence)}`);
+    }
+    if (previous !== null && sequence > previous + 1) {
+        session.bus.push(Route.Background, {
+            kind: "metric.conversation",
+            contextId: state.contextId,
+            timestampMs: Date.now(),
+            name: "twilio.sequence_gap",
+            value: JSON.stringify({ expected: previous + 1, actual: sequence, missed: sequence - previous - 1 }),
+        });
+    }
+    state.lastInboundSequenceNumber = sequence;
+}
+function rememberTwilioMediaChunk(session, state, chunkValue) {
+    const chunk = optionalPositiveIntegerString(chunkValue, "Twilio media.chunk");
+    if (chunk === undefined)
+        return;
+    const previous = state.lastInboundMediaChunk;
+    if (previous !== null && chunk <= previous) {
+        throw new Error(`Twilio media.chunk must increase monotonically: ${String(previous)} -> ${String(chunk)}`);
+    }
+    if (previous !== null && chunk > previous + 1) {
+        session.bus.push(Route.Background, {
+            kind: "metric.conversation",
+            contextId: state.contextId,
+            timestampMs: Date.now(),
+            name: "twilio.media_chunk_gap",
+            value: JSON.stringify({ expected: previous + 1, actual: chunk, missed: chunk - previous - 1 }),
+        });
+    }
+    state.lastInboundMediaChunk = chunk;
+}
+function rememberTwilioMediaTimestamp(session, state, timestampValue, sampleCount, sampleRateHz) {
+    const timestampMs = optionalNonNegativeIntegerString(timestampValue, "Twilio media.timestamp");
+    if (timestampMs === undefined)
+        return;
+    const previous = state.lastInboundMediaTimestampMs;
+    if (previous !== null && timestampMs < previous) {
+        session.bus.push(Route.Background, {
+            kind: "metric.conversation",
+            contextId: state.contextId,
+            timestampMs: Date.now(),
+            name: "twilio.media_timestamp_regression",
+            value: JSON.stringify({ previous, actual: timestampMs }),
+        });
+    }
+    else if (previous !== null) {
+        const expected = previous + Math.round((sampleCount / sampleRateHz) * 1000);
+        if (timestampMs > expected) {
+            session.bus.push(Route.Background, {
+                kind: "metric.conversation",
+                contextId: state.contextId,
+                timestampMs: Date.now(),
+                name: "twilio.media_timestamp_gap",
+                value: JSON.stringify({ expected, actual: timestampMs, missedMs: timestampMs - expected }),
+            });
+        }
+    }
+    state.lastInboundMediaTimestampMs = timestampMs;
+}
+function validateTwilioStart(start, expectedSampleRateHz) {
+    const format = start.mediaFormat;
+    if (!format)
+        throw new Error("Twilio start event is missing mediaFormat");
+    const encoding = format.encoding?.trim().toLowerCase();
+    const validEncoding = encoding === "audio/x-mulaw" || encoding === "audio/mulaw"
+        || encoding === "mulaw" || encoding === "mu-law" || encoding === "ulaw"
+        || encoding === "pcmu" || encoding === "g711_ulaw";
+    if (!validEncoding)
+        throw new Error(`Unsupported Twilio media encoding: ${format.encoding ?? "unknown"}`);
+    const sampleRate = numberFromString(format.sampleRate);
+    if (sampleRate !== expectedSampleRateHz)
+        throw new Error(`Unsupported Twilio sample rate: ${String(format.sampleRate)}`);
+    const channels = numberFromString(format.channels);
+    if (channels !== 1)
+        throw new Error(`Unsupported Twilio channel count: ${String(format.channels)}`);
+}
+function defaultTwilioContextId(start) {
+    const callSid = start.callSid?.trim();
+    if (callSid)
+        return `twilio-${callSid}`;
+    const streamSid = start.streamSid?.trim();
+    if (streamSid)
+        return `twilio-${streamSid}`;
+    return `twilio-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function sendTwilioError(socket, streamSid, message, maxBufferedAmountBytes) {
+    sendTwilioJson(socket, {
+        event: "syrinx_error",
+        streamSid: streamSid || undefined,
+        error: { component: "transport", category: "invalid_input", message },
+    }, maxBufferedAmountBytes);
+}
+function sendTwilioJson(socket, value, maxBufferedAmountBytes) {
+    return sendJsonCapped(socket, value, maxBufferedAmountBytes);
+}
+//# sourceMappingURL=twilio.js.map

package/dist/twilio.js.map

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

package/dist/websocket-close.d.ts

@@ -0,0 +1,12 @@
+import { WebSocket } from "ws";
+export declare function closeWebSocketWithFallback(socket: WebSocket, code: number, reason: string, terminateAfterMs?: number): void;
+export declare function waitForWebSocketClose(socket: WebSocket, fallbackMs: number): Promise<void>;
+/**
+ * Serialize `value` to JSON and send it, enforcing the per-socket send-buffer
+ * cap. Returns false (and sends nothing) if the socket is not OPEN. If the send
+ * would push `bufferedAmount` past `maxBufferedAmountBytes`, the socket is closed
+ * 1013 (slow consumer / try-again-later) and false is returned. Canonical safe
+ * downlink-JSON write shared by every carrier adapter.
+ */
+export declare function sendJsonCapped(socket: WebSocket, value: unknown, maxBufferedAmountBytes: number): boolean;
+//# sourceMappingURL=websocket-close.d.ts.map

package/dist/websocket-close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-close.d.ts","sourceRoot":"","sources":["../src/websocket-close.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAI/B,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,gBAAgB,SAA6B,GAC5C,IAAI,CAaN;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB1F;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,OAAO,EACd,sBAAsB,EAAE,MAAM,GAC7B,OAAO,CAST"}

package/dist/websocket-close.js

@@ -0,0 +1,58 @@
+// SPDX-License-Identifier: MIT
+import { WebSocket } from "ws";
+const DEFAULT_TERMINATE_AFTER_MS = 250;
+export function closeWebSocketWithFallback(socket, code, reason, terminateAfterMs = DEFAULT_TERMINATE_AFTER_MS) {
+    if (socket.readyState === WebSocket.CLOSED || socket.readyState === WebSocket.CLOSING)
+        return;
+    socket.close(code, reason);
+    const timer = setTimeout(() => {
+        if (socket.readyState !== WebSocket.CLOSED) {
+            socket.terminate();
+        }
+    }, terminateAfterMs);
+    timer.unref?.();
+    socket.once("close", () => {
+        clearTimeout(timer);
+    });
+}
+export function waitForWebSocketClose(socket, fallbackMs) {
+    if (socket.readyState === WebSocket.CLOSED)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        let settled = false;
+        const settle = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            if (socket.readyState !== WebSocket.CLOSED && socket.readyState !== WebSocket.CLOSING) {
+                socket.terminate();
+            }
+            settle();
+        }, fallbackMs);
+        timer.unref?.();
+        socket.once("close", settle);
+    });
+}
+/**
+ * Serialize `value` to JSON and send it, enforcing the per-socket send-buffer
+ * cap. Returns false (and sends nothing) if the socket is not OPEN. If the send
+ * would push `bufferedAmount` past `maxBufferedAmountBytes`, the socket is closed
+ * 1013 (slow consumer / try-again-later) and false is returned. Canonical safe
+ * downlink-JSON write shared by every carrier adapter.
+ */
+export function sendJsonCapped(socket, value, maxBufferedAmountBytes) {
+    if (socket.readyState !== WebSocket.OPEN)
+        return false;
+    const data = JSON.stringify(value);
+    if (socket.bufferedAmount + Buffer.byteLength(data, "utf8") > maxBufferedAmountBytes) {
+        closeWebSocketWithFallback(socket, 1013, "websocket send buffer exceeded");
+        return false;
+    }
+    socket.send(data);
+    return true;
+}
+//# sourceMappingURL=websocket-close.js.map

package/dist/websocket-close.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-close.js","sourceRoot":"","sources":["../src/websocket-close.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAEvC,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,IAAY,EACZ,MAAc,EACd,gBAAgB,GAAG,0BAA0B;IAE7C,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,OAAO;QAAE,OAAO;IAE9F,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACrB,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAChB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QACxB,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,UAAkB;IACzE,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACrE,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;gBACtF,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,CAAC;YACD,MAAM,EAAE,CAAC;QACX,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAiB,EACjB,KAAc,EACd,sBAA8B;IAE9B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,sBAAsB,EAAE,CAAC;QACrF,0BAA0B,CAAC,MAAM,EAAE,IAAI,EAAE,gCAAgC,CAAC,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,OAAO,IAAI,CAAC;AACd,CAAC"}