@polymorfa/sdk 0.1.0-dev.20260922093854

package/dist/calls/lifecycle.js

@@ -0,0 +1,490 @@
+import { CallsAuthError, CallsError } from "./errors.js";
+import { Emitter } from "./events.js";
+import { AUTH_FAILED_CLOSE_CODE, LIFECYCLE_SOCKET_PATH, parseLifecycleFrame, } from "./protocol.js";
+import { isClientToken } from "./token.js";
+/** Close codes the platform uses on the lifecycle and media sockets. */
+export const SocketCloseCode = {
+    /** The credential does not (or no longer) authorize the socket. */
+    Unauthorized: AUTH_FAILED_CLOSE_CODE,
+    /** Call or session state refused the socket (for example a claimed call). */
+    Conflict: 4409,
+    /** Too many attempts. */
+    RateLimited: 4429,
+    /** The request is invalid (for example an unknown session or participant). */
+    InvalidRequest: 4400,
+    /** A policy violation, including no auth frame within 5 seconds. */
+    PolicyViolation: 1008,
+    /** Authorization or the call is temporarily unavailable. */
+    TryAgainLater: 1013,
+};
+/**
+ * The client's one lifecycle socket. Every attempt authenticates with the
+ * first frame, waits for `ready`, replaces the token before it expires,
+ * reconnects with capped backoff until {@link close}, and heartbeats so a
+ * half-open connection is dropped rather than silently swallowing events.
+ * A 4401 close emits {@link CallsAuthError} and the next attempt asks the
+ * token provider for a fresh token.
+ */
+export class LifecycleSocket extends Emitter {
+    #o;
+    #WS;
+    #socket;
+    #authenticated = false;
+    #closed = true;
+    #attempt = 0;
+    #timer;
+    #beat;
+    #refreshTimer;
+    #awaitingPong = false;
+    #generation = 0;
+    #settle;
+    #abort;
+    #openTimer;
+    /** Set by a 4401 close: the next attempt must not reuse a cached token. */
+    #refreshNext = false;
+    /** Set by a 4400 close: retrying the same request cannot succeed. */
+    #refused = false;
+    #participant;
+    constructor(options) {
+        super();
+        this.#o = options;
+        const WS = options.WebSocket ?? globalThis.WebSocket;
+        if (WS === undefined)
+            throw new Error("No WebSocket implementation: pass `WebSocket` (Node < 22) or run on Node 22+.");
+        this.#WS = WS;
+    }
+    /** True while an authenticated socket is open. */
+    get connected() {
+        return (this.#authenticated &&
+            this.#socket !== undefined &&
+            this.#socket.readyState === this.#WS.OPEN);
+    }
+    /** Participant reference from the last `ready` frame, when the platform sent one. */
+    get participant() {
+        return this.#participant;
+    }
+    /**
+     * Resolves once the first attempt settles: authenticated, failed (a retry
+     * is scheduled), or closed.
+     */
+    async connect() {
+        this.#closed = false;
+        this.#refused = false;
+        if (this.#timer !== undefined) {
+            (this.#o.clearTimeout ?? clearTimeout)(this.#timer);
+            this.#timer = undefined;
+        }
+        await this.#open();
+    }
+    /** Send a local ICE candidate; false while no authenticated socket is open. */
+    sendCandidate(callId, connectionId, candidate) {
+        return this.#send({ type: "candidate", callId, connectionId, candidate });
+    }
+    close() {
+        this.#closed = true;
+        this.#stopHeartbeat();
+        this.#clearRefresh();
+        this.#clearOpenTimer();
+        if (this.#timer !== undefined) {
+            (this.#o.clearTimeout ?? clearTimeout)(this.#timer);
+            this.#timer = undefined;
+        }
+        const socket = this.#socket;
+        const wasAuthenticated = this.#authenticated;
+        this.#socket = undefined;
+        this.#authenticated = false;
+        try {
+            if (socket !== undefined) {
+                detach(socket);
+                try {
+                    socket.close();
+                }
+                catch {
+                    // already closed
+                }
+                if (wasAuthenticated)
+                    this.emit("state", false);
+            }
+        }
+        finally {
+            // A throwing state listener must not leave a pending connect() hanging,
+            // the token request in flight, or the generation stale.
+            this.#generation += 1;
+            this.#abort?.abort();
+            this.#abort = undefined;
+            this.#settle?.();
+        }
+    }
+    #send(frame) {
+        const socket = this.#socket;
+        if (!this.#authenticated && frame.type !== "auth")
+            return false;
+        if (socket === undefined || socket.readyState !== this.#WS.OPEN)
+            return false;
+        socket.send(JSON.stringify(frame));
+        return true;
+    }
+    #open() {
+        if (this.#socket !== undefined || this.#abort !== undefined)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            const generation = this.#generation;
+            const abort = new AbortController();
+            this.#abort = abort;
+            let settled = false;
+            const settle = () => {
+                if (settled)
+                    return;
+                settled = true;
+                if (this.#settle === settle)
+                    this.#settle = undefined;
+                if (this.#abort === abort)
+                    this.#abort = undefined;
+                resolve();
+            };
+            this.#settle = settle;
+            this.#openOnce(generation, abort.signal, settle).catch((cause) => this.#report(cause));
+        });
+    }
+    #report(cause) {
+        const report = this.#o.reportError ??
+            globalThis.reportError;
+        if (report !== undefined) {
+            try {
+                report(cause);
+                return;
+            }
+            catch {
+                // fall through
+            }
+        }
+        queueMicrotask(() => {
+            throw cause;
+        });
+    }
+    async #openOnce(generation, signal, settle) {
+        let token;
+        const refresh = this.#refreshNext;
+        try {
+            token = await this.#o.api.token({ refresh, signal });
+            this.#refreshNext = false;
+        }
+        catch (cause) {
+            try {
+                if (!signal.aborted && !this.#closed)
+                    this.emit("error", new CallsError("token_failed", cause instanceof Error
+                        ? cause.message
+                        : "Could not obtain a token for the lifecycle socket.", { cause }));
+            }
+            finally {
+                settle();
+                if (!signal.aborted && !this.#closed)
+                    this.#scheduleReconnect();
+            }
+            return;
+        }
+        if (this.#closed || signal.aborted || generation !== this.#generation) {
+            settle();
+            return;
+        }
+        let socket;
+        try {
+            socket = new this.#WS(this.#o.api.socketUrl(this.#path(token)));
+        }
+        catch {
+            settle();
+            if (!signal.aborted && !this.#closed && generation === this.#generation)
+                this.#scheduleReconnect();
+            return;
+        }
+        this.#socket = socket;
+        this.#authenticated = false;
+        // A socket stuck CONNECTING, or one that never answers the auth frame,
+        // would otherwise hold the attempt forever.
+        const timeoutMs = this.#o.connectTimeoutMs ?? 10_000;
+        this.#clearOpenTimer();
+        this.#openTimer =
+            timeoutMs > 0
+                ? (this.#o.setTimeout ?? setTimeout)(() => {
+                    this.#openTimer = undefined;
+                    if (this.#socket !== socket)
+                        return;
+                    this.#socket = undefined;
+                    detach(socket);
+                    try {
+                        socket.close();
+                    }
+                    catch {
+                        // never opened
+                    }
+                    try {
+                        this.emit("error", new CallsError("connect_timeout", "The lifecycle socket did not authenticate in time."));
+                    }
+                    finally {
+                        settle();
+                        this.#scheduleReconnect();
+                    }
+                }, timeoutMs)
+                : undefined;
+        let opened = false;
+        socket.onopen = () => {
+            opened = true;
+            const frame = { type: "auth", token: token.value };
+            socket.send(JSON.stringify(frame));
+        };
+        socket.onmessage = (event) => {
+            if (this.#socket !== socket)
+                return;
+            const frame = parseLifecycleFrame(event.data);
+            if (frame === undefined)
+                return;
+            if (!this.#authenticated) {
+                if (frame.type === "ready") {
+                    this.#clearOpenTimer();
+                    this.#authenticated = true;
+                    this.#attempt = 0;
+                    this.#participant = frame.participant ?? this.#participant;
+                    this.#startHeartbeat(socket);
+                    this.#scheduleRefresh(socket, token);
+                    try {
+                        this.emit("ready", {
+                            ...(frame.session === undefined
+                                ? {}
+                                : { session: frame.session }),
+                            ...(frame.participant === undefined
+                                ? {}
+                                : { participant: frame.participant }),
+                        });
+                        this.emit("state", true);
+                    }
+                    finally {
+                        settle();
+                    }
+                }
+                else if (frame.type === "error") {
+                    this.emit("error", new CallsError(frame.code, frame.message));
+                }
+                return;
+            }
+            this.#receive(frame);
+        };
+        // Node 22's WebSocket reports a failed handshake (refused, reset, or a
+        // non-101 reply) with an error event and never fires close, so treat an
+        // error before open as the close that other runtimes deliver.
+        socket.onerror = () => {
+            if (opened || this.#socket !== socket)
+                return;
+            const onclose = socket.onclose;
+            detach(socket);
+            try {
+                socket.close();
+            }
+            catch {
+                // never opened
+            }
+            onclose?.call(socket, { code: 1006 });
+        };
+        socket.onclose = (event) => {
+            this.#clearOpenTimer();
+            this.#stopHeartbeat();
+            this.#clearRefresh();
+            if (this.#socket !== socket)
+                return;
+            const wasAuthenticated = this.#authenticated;
+            this.#socket = undefined;
+            this.#authenticated = false;
+            const code = event?.code;
+            try {
+                const error = closeError(code);
+                if (code === SocketCloseCode.Unauthorized)
+                    this.#refreshNext = true;
+                if (code === SocketCloseCode.InvalidRequest)
+                    this.#refused = true;
+                if (error !== undefined)
+                    this.emit("error", error);
+                if (wasAuthenticated)
+                    this.emit("state", false);
+            }
+            finally {
+                settle();
+                this.#scheduleReconnect();
+            }
+        };
+    }
+    #receive(frame) {
+        switch (frame.type) {
+            case "pong":
+                this.#awaitingPong = false;
+                return;
+            case "error":
+                this.emit("error", new CallsError(frame.code, frame.message));
+                return;
+            case "candidate":
+                this.emit("candidate", {
+                    callId: frame.callId,
+                    ...(frame.connectionId === undefined
+                        ? {}
+                        : { connectionId: frame.connectionId }),
+                    candidate: frame.candidate,
+                });
+                return;
+            case "event": {
+                const payload = frame.payload !== null && typeof frame.payload === "object"
+                    ? frame.payload
+                    : {};
+                this.emit("event", {
+                    event: frame.event,
+                    callId: frame.callId,
+                    payload,
+                    timestamp: frame.timestamp,
+                });
+                return;
+            }
+            default:
+                return;
+        }
+    }
+    /**
+     * Replace the token on the open socket before it expires. The platform
+     * re-validates the latest token on its own schedule and closes with 4401
+     * when it no longer authorizes the session.
+     */
+    #scheduleRefresh(socket, token) {
+        this.#clearRefresh();
+        if (token.expiresAt === undefined)
+            return;
+        const now = (this.#o.now ?? Date.now)();
+        const lead = this.#o.refreshBeforeExpiryMs ?? 60_000;
+        const remaining = token.expiresAt - now;
+        const delay = Math.max(1_000, remaining > lead * 2 ? remaining - lead : remaining / 2);
+        this.#refreshTimer = (this.#o.setTimeout ?? setTimeout)(() => {
+            this.#refreshTimer = undefined;
+            void this.#replaceToken(socket);
+        }, delay);
+    }
+    async #replaceToken(socket) {
+        let token;
+        try {
+            token = await this.#o.api.token({ refresh: true });
+        }
+        catch (cause) {
+            if (this.#socket !== socket || this.#closed)
+                return;
+            try {
+                this.emit("error", new CallsError("token_failed", cause instanceof Error
+                    ? cause.message
+                    : "Could not refresh the lifecycle token.", { cause }));
+            }
+            catch (listenerCause) {
+                this.#report(listenerCause);
+            }
+            // Try again shortly; the platform closes with 4401 if the old token lapses.
+            this.#refreshTimer = (this.#o.setTimeout ?? setTimeout)(() => {
+                this.#refreshTimer = undefined;
+                void this.#replaceToken(socket);
+            }, 5_000);
+            return;
+        }
+        if (this.#socket !== socket || !this.#authenticated)
+            return;
+        this.#send({ type: "auth", token: token.value });
+        this.#scheduleRefresh(socket, token);
+    }
+    #clearRefresh() {
+        if (this.#refreshTimer !== undefined) {
+            (this.#o.clearTimeout ?? clearTimeout)(this.#refreshTimer);
+            this.#refreshTimer = undefined;
+        }
+    }
+    /** `/voip/ws`, naming the session only for server credentials. */
+    #path(token) {
+        if (isClientToken(token.value))
+            return LIFECYCLE_SOCKET_PATH;
+        const query = new URLSearchParams();
+        if (this.#o.session !== undefined)
+            query.set("session", this.#o.session);
+        if (this.#o.participant !== undefined)
+            query.set("participant", this.#o.participant);
+        const search = query.toString();
+        return search === ""
+            ? LIFECYCLE_SOCKET_PATH
+            : `${LIFECYCLE_SOCKET_PATH}?${search}`;
+    }
+    #scheduleReconnect() {
+        if (this.#closed || this.#refused || this.#timer !== undefined)
+            return;
+        const min = this.#o.minBackoffMs ?? 1_000;
+        const max = this.#o.maxBackoffMs ?? 30_000;
+        const random = this.#o.random ?? Math.random;
+        const delay = Math.min(max, min * 2 ** this.#attempt) * (0.5 + random() / 2);
+        this.#attempt = Math.min(this.#attempt + 1, 10);
+        this.#timer = (this.#o.setTimeout ?? setTimeout)(() => {
+            this.#timer = undefined;
+            void this.#open();
+        }, delay);
+    }
+    #startHeartbeat(socket) {
+        this.#stopHeartbeat();
+        const every = this.#o.heartbeatMs ?? 15_000;
+        if (every <= 0)
+            return;
+        this.#beat = (this.#o.setInterval ?? setInterval)(() => {
+            if (this.#socket !== socket)
+                return;
+            if (this.#awaitingPong) {
+                // Half-open: still OPEN on paper, never answering. Drop it so the
+                // close path reconnects instead of silently losing every event.
+                this.#stopHeartbeat();
+                this.#clearRefresh();
+                this.#socket = undefined;
+                this.#authenticated = false;
+                detach(socket);
+                try {
+                    socket.close();
+                }
+                catch {
+                    // already gone
+                }
+                try {
+                    this.emit("state", false);
+                }
+                finally {
+                    this.#scheduleReconnect();
+                }
+                return;
+            }
+            this.#awaitingPong = this.#send({ type: "ping" });
+        }, every);
+    }
+    #clearOpenTimer() {
+        if (this.#openTimer !== undefined) {
+            (this.#o.clearTimeout ?? clearTimeout)(this.#openTimer);
+            this.#openTimer = undefined;
+        }
+    }
+    #stopHeartbeat() {
+        if (this.#beat !== undefined) {
+            (this.#o.clearInterval ?? clearInterval)(this.#beat);
+            this.#beat = undefined;
+        }
+        this.#awaitingPong = false;
+    }
+}
+function detach(socket) {
+    socket.onopen = socket.onmessage = socket.onclose = socket.onerror = null;
+}
+function closeError(code) {
+    switch (code) {
+        case SocketCloseCode.Unauthorized:
+            return new CallsAuthError();
+        case SocketCloseCode.Conflict:
+            return new CallsError("socket_conflict", "The platform refused the socket for the current session state.");
+        case SocketCloseCode.RateLimited:
+            return new CallsError("rate_limited", "Too many socket attempts; reconnecting with backoff.");
+        case SocketCloseCode.InvalidRequest:
+            return new CallsError("invalid_request", "The platform refused the socket request; check the session and participant. Reconnection stopped.");
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/calls/lifecycle.js.map

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

package/dist/calls/media.d.ts

@@ -0,0 +1,102 @@
+import type { CallsApi } from "./api.js";
+import { CallsError } from "./errors.js";
+import { Emitter } from "./events.js";
+import { type MediaClientFrame, type OutboundVideoFrame, type Participant, type VideoFrame, type VideoSourceOwner } from "./protocol.js";
+/**
+ * Close code for a call-state refusal. With the reason "call claimed" (or a
+ * preceding `call_claimed` error frame) another participant claimed the call;
+ * otherwise the call is not available (ended or not ready).
+ */
+export declare const CALL_CLAIMED_CLOSE_CODE = 4409;
+/** Close code for a connection refused because calling is turned off. */
+export declare const CALLS_DISABLED_CLOSE_CODE = 4403;
+export interface MediaSocketOptions {
+    readonly api: Pick<CallsApi, "token" | "socketUrl">;
+    readonly callId: string;
+    /** Reuse the same id to reconnect this connection. */
+    readonly connectionId: string;
+    /** Participant name for server credentials; ignored for client tokens. */
+    readonly participant?: string;
+    /** Ask the token provider for a fresh token (after a 4401 close). */
+    readonly refreshToken?: boolean;
+    readonly WebSocket?: typeof globalThis.WebSocket;
+    readonly setInterval?: typeof globalThis.setInterval;
+    readonly clearInterval?: typeof globalThis.clearInterval;
+    /** Heartbeat period; 0 disables. Default 5 000 ms — media is latency-sensitive. */
+    readonly heartbeatMs?: number;
+    /**
+     * Bound on connect(): from the attempt until the platform's `ready` frame.
+     * 0 disables. Default 10 000 ms.
+     */
+    readonly readyTimeoutMs?: number;
+    readonly setTimeout?: typeof globalThis.setTimeout;
+    readonly clearTimeout?: typeof globalThis.clearTimeout;
+}
+export interface MediaReady {
+    readonly sampleRate: number;
+    readonly video: boolean;
+    readonly callId?: string;
+    readonly connectionId?: string;
+}
+/** A remote video source announced on the media socket. */
+export type MediaVideoSource = {
+    readonly source: number;
+} & VideoSourceOwner;
+/**
+ * Why the socket closed: `local` (this client closed it), `left` (after
+ * {@link MediaSocket.leave}), `ended` (the platform closed the connection
+ * normally or the call is no longer available), `claimed` (another
+ * participant claimed the call), `unauthorized` (4401), `refused` (4400, 4403
+ * while calling is turned off, or a policy violation; retrying cannot help),
+ * or `lost` (retryable).
+ */
+export type MediaCloseReason = "local" | "left" | "ended" | "claimed" | "unauthorized" | "refused" | "lost";
+export interface MediaClose {
+    readonly reason: MediaCloseReason;
+    readonly code?: number;
+}
+type Events = {
+    ready: [MediaReady];
+    audio: [Int16Array];
+    video: [VideoFrame];
+    videoSource: [MediaVideoSource];
+    videoSourceRemoved: [source: number];
+    keyframeRequest: [];
+    participantJoined: [Participant];
+    participantLeft: [participantId: string, reason: string | undefined];
+    participantState: [Participant];
+    error: [CallsError];
+    close: [MediaClose];
+};
+/**
+ * One media connection to a call: tagged binary frames for audio and video,
+ * JSON text frames for control. The first frame authenticates the
+ * connection. A socket does not reconnect by itself; the call opens a new one
+ * with the same connection id.
+ */
+export declare class MediaSocket extends Emitter<Events> {
+    #private;
+    constructor(options: MediaSocketOptions);
+    get connectionId(): string;
+    /** The PCM rate in force; updated from the platform's `ready` frame. */
+    get sampleRate(): number;
+    get connected(): boolean;
+    /**
+     * Authenticate and attach; resolves when the platform reports `ready`.
+     * Rejects with {@link CallClaimedError} or {@link CallsAuthError} when the
+     * platform refuses the connection for those reasons.
+     */
+    connect(): Promise<void>;
+    /** Push s16le mono PCM at {@link sampleRate}. Returns false when not connected. */
+    writeAudio(pcm: Int16Array): boolean;
+    /** Push one H.264 Annex-B access unit. Send decoder configuration with keyframes. */
+    writeVideo(frame: OutboundVideoFrame): boolean;
+    send(frame: MediaClientFrame): boolean;
+    /** Close this connection only; the call continues. False when not connected. */
+    leave(): boolean;
+    /** End the call for every participant. False when not connected. */
+    endCall(): boolean;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=media.d.ts.map

package/dist/calls/media.d.ts.map

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