@kuralle-syrinx/server-websocket 4.4.1 → 4.5.0

package/dist/smartpbx.js

@@ -0,0 +1,437 @@
+// SPDX-License-Identifier: MIT
+import { createServer } from "node:http";
+import { WebSocket } from "ws";
+import { Decoder as OpusDecoder, Encoder as OpusEncoder } from "@evan/opus";
+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, positiveInteger, rawDataToText, } from "./transport-helpers.js";
+const DEFAULT_ENGINE_SAMPLE_RATE_HZ = 16000;
+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 createSmartPbxMediaStreamServer(options) {
+    const ownsHttpServer = !options.server;
+    const httpServer = options.server ?? createServer();
+    const routedWebSocket = createRoutedWebSocketServer(httpServer, options.path ?? "/media-stream", {
+        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 outboundFrameDurationMs = positiveInteger(options.outboundFrameDurationMs) ?? DEFAULT_OUTBOUND_FRAME_DURATION_MS;
+    const maxQueuedOutputAudioMs = positiveInteger(options.maxQueuedOutputAudioMs) ?? DEFAULT_MAX_QUEUED_OUTPUT_AUDIO_MS;
+    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 ?? defaultSmartPbxContextId;
+    const gracefulCloseRegistry = new Map();
+    const adapter = {
+        createState: () => ({
+            callId: "",
+            accountId: "",
+            contextId: "",
+            contextBase: "",
+            turnCounter: 0,
+            codec: "g711_ulaw",
+            wireSampleRateHz: 8000,
+            opusDecoder: null,
+            opusEncoder: null,
+            opusEncodeRemainder: new Int16Array(0),
+            started: false,
+            stopped: false,
+            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("SmartPBX websocket session startup aborted");
+            }
+            sessions.add(sess);
+            await sess.start();
+            if (shouldAbort()) {
+                sessions.delete(sess);
+                await sess.close().catch(() => undefined);
+                throw new Error("SmartPBX websocket session startup aborted");
+            }
+            return { session: sess, resumed: false };
+        },
+        wireSession(session, socket, state, disposers) {
+            const outbound = wireTelephonyOutboundPipeline({
+                session,
+                socket,
+                disposers,
+                outboundFrameDurationMs,
+                maxQueuedOutputAudioMs,
+                ...(options.backgroundAudio ? { backgroundAudio: new BackgroundAudioMixer(options.backgroundAudio) } : {}),
+                callbacks: {
+                    carrierLabel: "smartpbx",
+                    getContextId: () => state.contextId,
+                    isActive: () => !state.stopped && state.started,
+                    encodeFrames: (audio, sourceSampleRateHz, contextId) => {
+                        return encodeOutboundFrames(audio, sourceSampleRateHz, state, outboundFrameDurationMs)
+                            .map((frame) => ({
+                            contextId,
+                            send: () => {
+                                if (state.stopped)
+                                    return false;
+                                return sendSmartPbxJson(socket, {
+                                    event: "media",
+                                    callId: state.callId,
+                                    accountId: state.accountId,
+                                    media: { payload: Buffer.from(frame).toString("base64") },
+                                }, hostConfig.maxBufferedAmountBytes);
+                            },
+                        }));
+                    },
+                    onInterrupt: (contextId) => {
+                        state.opusEncodeRemainder = new Int16Array(0);
+                        session.bus.push(Route.Background, {
+                            kind: "metric.conversation",
+                            contextId,
+                            timestampMs: Date.now(),
+                            name: "smartpbx.interrupt_no_playback_clear",
+                            value: "1",
+                        });
+                    },
+                    onDrain: (contextId, playout, progress) => {
+                        const pendingFrames = encodePendingOpusFrame(state, outboundFrameDurationMs)
+                            .map((frame) => ({
+                            contextId,
+                            send: () => {
+                                if (state.stopped)
+                                    return false;
+                                return sendSmartPbxJson(socket, {
+                                    event: "media",
+                                    callId: state.callId,
+                                    accountId: state.accountId,
+                                    media: { payload: Buffer.from(frame).toString("base64") },
+                                }, hostConfig.maxBufferedAmountBytes);
+                            },
+                        }));
+                        playout.enqueue(pendingFrames);
+                        playout.enqueueControl(() => {
+                            if (state.stopped)
+                                return;
+                            progress.complete(contextId);
+                            session.bus.push(Route.Background, {
+                                kind: "metric.conversation",
+                                contextId,
+                                timestampMs: Date.now(),
+                                name: "smartpbx.playout_drained",
+                                value: "1",
+                            });
+                        });
+                    },
+                    onStop: () => {
+                        state.stopped = true;
+                        state.opusEncodeRemainder = new Int16Array(0);
+                    },
+                    onClear: () => { state.opusEncodeRemainder = new Int16Array(0); },
+                },
+            });
+            state.clearPlayout = outbound.clearPlayout;
+            installTelephonyTurnRotation(session, disposers, state);
+            gracefulCloseRegistry.set(socket, (deadlineMs) => outbound.drainAndClose(socket, deadlineMs));
+            disposers.push(() => gracefulCloseRegistry.delete(socket));
+            return (reason) => {
+                state.opusEncodeRemainder = new Int16Array(0);
+                state.clearPlayout(reason);
+            };
+        },
+        processMessage(data, isBinary, session, state) {
+            if (isBinary)
+                throw new Error("SmartPBX AI Provider messages must be JSON text frames");
+            const message = parseSmartPbxMessage(parseJsonRecord(rawDataToText(data), "SmartPBX AI Provider message"));
+            if (message.event === "connected")
+                return;
+            if (message.event === "start") {
+                if (state.stopped)
+                    throw new Error("SmartPBX start event received after stream stop");
+                const start = message.start ?? {};
+                const format = validateSmartPbxStart(start);
+                state.callId = start.callId ?? "";
+                state.accountId = start.accountId ?? "";
+                if (!state.callId)
+                    throw new Error("SmartPBX start event is missing callId");
+                if (!state.accountId)
+                    throw new Error("SmartPBX start event is missing accountId");
+                state.contextId = contextIdFn(start);
+                state.contextBase = state.contextId;
+                state.codec = format.codec;
+                state.wireSampleRateHz = format.sampleRateHz;
+                state.opusDecoder = format.codec === "opus" ? new OpusDecoder({ channels: 1, sample_rate: 48000 }) : null;
+                state.opusEncoder = format.codec === "opus" ? new OpusEncoder({ channels: 1, sample_rate: 48000, application: "voip" }) : null;
+                state.opusEncodeRemainder = new Int16Array(0);
+                state.started = true;
+                return;
+            }
+            if (message.event === "media") {
+                if (state.stopped)
+                    return;
+                if (!state.started || !state.contextId)
+                    throw new Error("SmartPBX media event received before a valid start event");
+                const payload = message.media?.payload;
+                if (!payload)
+                    throw new Error("SmartPBX media event is missing media.payload");
+                const wire = decodeStrictBase64(payload, "media.payload");
+                const decoded = decodeSmartPbxWireAudio(wire, state);
+                const resampled = resamplePcm16Streaming(state.streamingResamplers, decoded, state.wireSampleRateHz, inputSampleRateHz);
+                session.bus.push(Route.Main, {
+                    kind: "user.audio_received",
+                    contextId: state.contextId,
+                    timestampMs: Date.now(),
+                    audio: pcm16SamplesToBytes(resampled),
+                    sampleRateHz: inputSampleRateHz,
+                });
+                return;
+            }
+            if (message.event === "hangup" || message.event === "stop") {
+                state.stopped = true;
+                state.started = false;
+                state.opusEncodeRemainder = new Int16Array(0);
+                state.clearPlayout("stop");
+                session.close().catch(() => undefined);
+                return;
+            }
+            if (message.event === "dtmf") {
+                if (state.stopped)
+                    return;
+                if (!state.started || !state.contextId) {
+                    session.bus.push(Route.Background, {
+                        kind: "metric.conversation",
+                        contextId: "",
+                        timestampMs: Date.now(),
+                        name: "smartpbx.dtmf.before_start",
+                        value: message.dtmf?.digit ?? message.digit ?? "",
+                    });
+                    return;
+                }
+                const rawDigit = message.dtmf?.digit ?? message.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: "smartpbx",
+                    rawDigit,
+                });
+                return;
+            }
+            throw new Error(`Unsupported SmartPBX AI Provider event: ${String(message.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) {
+            sendSmartPbxError(socket, state, message, hostConfig.maxBufferedAmountBytes);
+        },
+        sendStartupError(socket, state, err) {
+            sendSmartPbxError(socket, state, 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 parseSmartPbxMessage(value) {
+    const start = optionalRecord(value.start, "SmartPBX start");
+    const media = optionalRecord(value.media, "SmartPBX media");
+    const dtmf = optionalRecord(value.dtmf, "SmartPBX dtmf");
+    const mediaFormat = optionalRecord(start?.mediaFormat, "SmartPBX start.mediaFormat");
+    return {
+        event: requiredString(value.event, "SmartPBX event"),
+        digit: optionalString(value.digit, "SmartPBX digit"),
+        start: start
+            ? {
+                callId: optionalString(start.callId, "SmartPBX start.callId"),
+                otherLegCallId: optionalString(start.otherLegCallId, "SmartPBX start.otherLegCallId"),
+                callerIdNumber: optionalString(start.callerIdNumber, "SmartPBX start.callerIdNumber"),
+                calleeIdNumber: optionalString(start.calleeIdNumber, "SmartPBX start.calleeIdNumber"),
+                accountId: optionalString(start.accountId, "SmartPBX start.accountId"),
+                mediaFormat: mediaFormat
+                    ? {
+                        encoding: optionalString(mediaFormat.encoding, "SmartPBX start.mediaFormat.encoding"),
+                        sampleRate: optionalStringOrNumber(mediaFormat.sampleRate, "SmartPBX start.mediaFormat.sampleRate"),
+                    }
+                    : undefined,
+            }
+            : undefined,
+        media: media ? { payload: optionalString(media.payload, "SmartPBX media.payload") } : undefined,
+        dtmf: dtmf ? { digit: optionalString(dtmf.digit, "SmartPBX dtmf.digit") } : undefined,
+    };
+}
+function validateSmartPbxStart(start) {
+    const format = start.mediaFormat;
+    if (!format)
+        throw new Error("SmartPBX start event is missing mediaFormat");
+    const encoding = format.encoding?.trim().toLowerCase();
+    const sampleRateHz = numberFromString(format.sampleRate);
+    if (encoding !== "g711_ulaw" && encoding !== "pcm16" && encoding !== "opus") {
+        throw new Error(`Unsupported SmartPBX media encoding: ${format.encoding ?? "unknown"}`);
+    }
+    if (encoding === "g711_ulaw" && sampleRateHz !== 8000)
+        throw new Error(`Unsupported SmartPBX g711_ulaw sample rate: ${String(format.sampleRate)}`);
+    if (encoding === "pcm16" && sampleRateHz !== 24000)
+        throw new Error(`Unsupported SmartPBX pcm16 sample rate: ${String(format.sampleRate)}`);
+    if (encoding === "opus" && sampleRateHz !== 48000)
+        throw new Error(`Unsupported SmartPBX opus sample rate: ${String(format.sampleRate)}`);
+    return { codec: encoding, sampleRateHz: sampleRateHz };
+}
+function decodeSmartPbxWireAudio(wire, state) {
+    if (state.codec === "g711_ulaw")
+        return decodeMuLawToPcm16(wire);
+    if (state.codec === "pcm16")
+        return pcm16BytesToSamples(wire);
+    if (!state.opusDecoder)
+        throw new Error("SmartPBX opus decoder is not initialized");
+    return pcm16BytesToSamples(state.opusDecoder.decode(wire));
+}
+function encodeOutboundFrames(audio, sourceSampleRateHz, state, frameDurationMs) {
+    const samples = pcm16BytesToSamples(audio);
+    const resampled = resamplePcm16Streaming(state.streamingResamplers, samples, sourceSampleRateHz, state.wireSampleRateHz);
+    if (state.codec === "opus")
+        return encodeOpusFrames(resampled, state, frameDurationMs, false);
+    const encoded = state.codec === "g711_ulaw" ? encodePcm16ToMuLaw(resampled) : pcm16SamplesToBytes(resampled);
+    const bytesPerSample = state.codec === "g711_ulaw" ? 1 : 2;
+    const frameBytes = Math.max(1, Math.round((state.wireSampleRateHz * frameDurationMs) / 1000) * bytesPerSample);
+    const frames = [];
+    for (let offset = 0; offset < encoded.byteLength; offset += frameBytes) {
+        frames.push(encoded.subarray(offset, Math.min(encoded.byteLength, offset + frameBytes)));
+    }
+    return frames;
+}
+function encodePendingOpusFrame(state, frameDurationMs) {
+    if (state.codec !== "opus" || state.opusEncodeRemainder.length === 0)
+        return [];
+    return encodeOpusFrames(new Int16Array(0), state, frameDurationMs, true);
+}
+function encodeOpusFrames(samples, state, frameDurationMs, flush) {
+    if (!state.opusEncoder)
+        throw new Error("SmartPBX opus encoder is not initialized");
+    const frameSamples = Math.round((state.wireSampleRateHz * frameDurationMs) / 1000);
+    const pending = new Int16Array(state.opusEncodeRemainder.length + samples.length);
+    pending.set(state.opusEncodeRemainder);
+    pending.set(samples, state.opusEncodeRemainder.length);
+    const completeFrames = Math.floor(pending.length / frameSamples);
+    const frames = [];
+    for (let index = 0; index < completeFrames; index += 1) {
+        const frame = pending.subarray(index * frameSamples, (index + 1) * frameSamples);
+        frames.push(state.opusEncoder.encode(pcm16SamplesToBytes(frame)));
+    }
+    const consumed = completeFrames * frameSamples;
+    const remainder = pending.subarray(consumed);
+    if (flush && remainder.length > 0) {
+        const padded = new Int16Array(frameSamples);
+        padded.set(remainder);
+        frames.push(state.opusEncoder.encode(pcm16SamplesToBytes(padded)));
+        state.opusEncodeRemainder = new Int16Array(0);
+    }
+    else {
+        state.opusEncodeRemainder = new Int16Array(remainder);
+    }
+    return frames;
+}
+function defaultSmartPbxContextId(start) {
+    const callId = start.callId?.trim();
+    if (callId)
+        return `smartpbx-${callId}`;
+    return `smartpbx-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function sendSmartPbxError(socket, state, message, maxBufferedAmountBytes) {
+    sendSmartPbxJson(socket, {
+        event: "syrinx_error",
+        callId: state.callId || undefined,
+        accountId: state.accountId || undefined,
+        error: { component: "transport", category: "invalid_input", message },
+    }, maxBufferedAmountBytes);
+}
+function sendSmartPbxJson(socket, value, maxBufferedAmountBytes) {
+    return sendJsonCapped(socket, value, maxBufferedAmountBytes);
+}
+//# sourceMappingURL=smartpbx.js.map

package/dist/smartpbx.js.map

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

package/dist/telnyx-codec.d.ts

@@ -0,0 +1,41 @@
+import { type G722DecoderState, type G722EncoderState } from "@kuralle-syrinx/core/audio";
+/** Telnyx stream codecs. PCMA/G722 unit-tested; live trunk negotiation unverified. */
+export type TelnyxCodec = "PCMU" | "L16" | "PCMA" | "G722";
+export interface TelnyxStartMediaFormat {
+    readonly encoding?: string;
+    readonly sample_rate?: number | string;
+    readonly channels?: number | string;
+}
+export interface TelnyxStartPayload {
+    readonly stream_id?: string;
+    readonly call_control_id?: string;
+    readonly call_session_id?: string;
+    readonly media_format?: TelnyxStartMediaFormat;
+}
+/** Stateful G.722 pair for a stream. Other codecs leave both null. */
+export interface TelnyxG722State {
+    decoder: G722DecoderState | null;
+    encoder: G722EncoderState | null;
+}
+export declare function wireSampleRateForCodec(codec: TelnyxCodec): number;
+/** Alias kept for callers that used the Node-side name. */
+export declare const outboundSampleRateForCodec: typeof wireSampleRateForCodec;
+export declare function createTelnyxG722State(codec: TelnyxCodec): TelnyxG722State;
+export declare function validateTelnyxStart(start: TelnyxStartPayload): {
+    readonly codec: TelnyxCodec;
+    readonly sampleRateHz: number;
+};
+/**
+ * Decode a Telnyx media payload (RTP bytes, already base64-decoded) to PCM16 at
+ * the wire sample rate. G.722 keeps 16 kHz — do not downsample before STT.
+ */
+export declare function decodeTelnyxInboundPayload(input: Uint8Array, codec: TelnyxCodec, g722: TelnyxG722State): Int16Array;
+/** Encode PCM16 samples already at the wire sample rate into a Telnyx media payload. */
+export declare function encodeTelnyxOutboundPayload(samples: Int16Array, codec: TelnyxCodec, g722: TelnyxG722State): Uint8Array;
+/**
+ * Split an encoded payload into fixed-duration wire frames (Node paced playout).
+ * G.722: 1 byte per 2 samples @ 16 kHz; L16: 2 bytes/sample; PCMU/PCMA: 1 byte/sample.
+ */
+export declare function splitTelnyxEncodedFrames(encoded: Uint8Array, codec: TelnyxCodec, wireSampleRateHz: number, frameDurationMs: number): Uint8Array[];
+export declare function defaultTelnyxContextId(start: TelnyxStartPayload): string;
+//# sourceMappingURL=telnyx-codec.d.ts.map

package/dist/telnyx-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telnyx-codec.d.ts","sourceRoot":"","sources":["../src/telnyx-codec.ts"],"names":[],"mappings":"AAMA,OAAO,EAWL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAEpC,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;CAChD;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAClC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAEjE;AAED,2DAA2D;AAC3D,eAAO,MAAM,0BAA0B,+BAAyB,CAAC;AAEjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,CAMzE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,GACxB;IAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAkBhE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,eAAe,GACpB,UAAU,CAaZ;AAED,wFAAwF;AACxF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,eAAe,GACpB,UAAU,CAaZ;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,WAAW,EAClB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,GACtB,UAAU,EAAE,CAWd;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAQxE"}

package/dist/telnyx-codec.js

@@ -0,0 +1,114 @@
+// SPDX-License-Identifier: MIT
+//
+// Workers-safe Telnyx codec helpers (TypedArray only — no Node Buffer / process /
+// node: imports). Shared by the Node host (`telnyx.ts`) and the Workers edge
+// runner (`edge-telnyx.ts`). Live trunk negotiation remains carrier-gated.
+import { bigEndianPcm16BytesToSamples, createG722DecoderState, createG722EncoderState, decodeALawToPcm16, decodeG722, decodeMuLawToPcm16, encodeG722, encodePcm16ToALaw, encodePcm16ToMuLaw, pcm16SamplesToBigEndianBytes, } from "@kuralle-syrinx/core/audio";
+export function wireSampleRateForCodec(codec) {
+    return codec === "L16" || codec === "G722" ? 16_000 : 8_000;
+}
+/** Alias kept for callers that used the Node-side name. */
+export const outboundSampleRateForCodec = wireSampleRateForCodec;
+export function createTelnyxG722State(codec) {
+    if (codec !== "G722")
+        return { decoder: null, encoder: null };
+    return {
+        decoder: createG722DecoderState(),
+        encoder: createG722EncoderState(),
+    };
+}
+export function validateTelnyxStart(start) {
+    const format = start.media_format;
+    if (!format)
+        throw new Error("Telnyx start event is missing media_format");
+    const encoding = format.encoding?.trim().toUpperCase();
+    if (encoding !== "PCMU" && encoding !== "L16" && encoding !== "PCMA" && encoding !== "G722") {
+        throw new Error(`Unsupported Telnyx media encoding: ${format.encoding ?? "unknown"}`);
+    }
+    const sampleRateHz = numberFromString(format.sample_rate);
+    if (sampleRateHz === null)
+        throw new Error(`Unsupported Telnyx sample rate: ${String(format.sample_rate)}`);
+    if ((encoding === "PCMU" || encoding === "PCMA") && sampleRateHz !== 8000) {
+        throw new Error(`Unsupported Telnyx ${encoding} sample rate: ${String(format.sample_rate)}`);
+    }
+    if ((encoding === "L16" || encoding === "G722") && sampleRateHz !== 16000) {
+        throw new Error(`Unsupported Telnyx ${encoding} sample rate: ${String(format.sample_rate)}`);
+    }
+    const channels = numberFromString(format.channels);
+    if (channels !== 1)
+        throw new Error(`Unsupported Telnyx channel count: ${String(format.channels)}`);
+    return { codec: encoding, sampleRateHz };
+}
+/**
+ * Decode a Telnyx media payload (RTP bytes, already base64-decoded) to PCM16 at
+ * the wire sample rate. G.722 keeps 16 kHz — do not downsample before STT.
+ */
+export function decodeTelnyxInboundPayload(input, codec, g722) {
+    switch (codec) {
+        case "PCMU":
+            return decodeMuLawToPcm16(input);
+        case "PCMA":
+            return decodeALawToPcm16(input);
+        case "G722": {
+            if (!g722.decoder)
+                g722.decoder = createG722DecoderState();
+            return decodeG722(g722.decoder, input);
+        }
+        case "L16":
+            return bigEndianPcm16BytesToSamples(input);
+    }
+}
+/** Encode PCM16 samples already at the wire sample rate into a Telnyx media payload. */
+export function encodeTelnyxOutboundPayload(samples, codec, g722) {
+    switch (codec) {
+        case "PCMU":
+            return encodePcm16ToMuLaw(samples);
+        case "PCMA":
+            return encodePcm16ToALaw(samples);
+        case "G722": {
+            if (!g722.encoder)
+                g722.encoder = createG722EncoderState();
+            return encodeG722(g722.encoder, samples);
+        }
+        case "L16":
+            return pcm16SamplesToBigEndianBytes(samples);
+    }
+}
+/**
+ * Split an encoded payload into fixed-duration wire frames (Node paced playout).
+ * G.722: 1 byte per 2 samples @ 16 kHz; L16: 2 bytes/sample; PCMU/PCMA: 1 byte/sample.
+ */
+export function splitTelnyxEncodedFrames(encoded, codec, wireSampleRateHz, frameDurationMs) {
+    const samplesPerFrame = Math.max(1, Math.round((wireSampleRateHz * frameDurationMs) / 1000));
+    const frameBytes = codec === "G722"
+        ? Math.max(1, samplesPerFrame >> 1)
+        : samplesPerFrame * (codec === "L16" ? 2 : 1);
+    const frames = [];
+    for (let offset = 0; offset < encoded.byteLength; offset += frameBytes) {
+        frames.push(encoded.subarray(offset, Math.min(encoded.byteLength, offset + frameBytes)));
+    }
+    return frames;
+}
+export function defaultTelnyxContextId(start) {
+    const callControlId = start.call_control_id?.trim();
+    if (callControlId)
+        return `telnyx-${callControlId}`;
+    const callSessionId = start.call_session_id?.trim();
+    if (callSessionId)
+        return `telnyx-${callSessionId}`;
+    const streamId = start.stream_id?.trim();
+    if (streamId)
+        return `telnyx-${streamId}`;
+    return `telnyx-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+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;
+}
+//# sourceMappingURL=telnyx-codec.js.map

package/dist/telnyx-codec.js.map

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