@polymorfa/sdk 0.1.0-dev.20260922093854

package/dist/calls/diagnostics.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Call diagnostics an app reports for one of its media connections through
+ * `POST /messaging/voip/calls/{id}/reports`. Only technical figures and error
+ * codes are sent: no phone numbers, names, audio, video or device labels.
+ */
+/** Package version sent with reports from `@polymorfa/sdk/calls`. */
+export declare const CALLS_SDK_VERSION = "0.1.0-dev.0";
+export type CallErrorCode = "media_permission_denied" | "device_not_found" | "device_in_use" | "ice_failed" | "negotiation_failed" | "media_timeout" | "reconnect_exhausted" | "token_refresh_failed" | "unsupported_browser" | "other";
+/** Figures measured for one connection. Omit what was not measured. */
+export interface CallQualityFigures {
+    readonly rttMs?: number;
+    readonly jitterMs?: number;
+    readonly packetsLost?: number;
+    readonly packetsReceived?: number;
+    readonly audioCodec?: string;
+    readonly videoCodec?: string;
+    readonly candidateType?: "host" | "srflx" | "prflx" | "relay";
+    readonly reconnects?: number;
+}
+export interface CallReportClient {
+    readonly sdk: string;
+    readonly version: string;
+    readonly platform: "browser" | "node" | "other";
+}
+/** A report body as the platform accepts it. */
+export type CallReport = {
+    readonly kind: "quality";
+    readonly connectionId: string;
+    readonly participant?: string;
+    readonly client?: CallReportClient;
+    readonly quality: CallQualityFigures;
+} | {
+    readonly kind: "error";
+    readonly connectionId: string;
+    readonly participant?: string;
+    readonly client?: CallReportClient;
+    readonly error: {
+        readonly code: CallErrorCode;
+    };
+};
+export interface CallReporterOptions {
+    readonly connectionId: string;
+    readonly client: CallReportClient;
+    /** Sends one report. Rejections are absorbed by the reporter. */
+    readonly send: (report: CallReport) => Promise<unknown>;
+    readonly now?: () => number;
+}
+/**
+ * Sends a connection's reports without ever affecting the call: nothing it
+ * does throws, sends are not awaited by callers, failed sends are not
+ * retried, and after a refusal other than 429 it sends nothing more (the
+ * credential, scope or call does not accept reports).
+ */
+export declare class CallReporter {
+    #private;
+    constructor(options: CallReporterOptions);
+    get stopped(): boolean;
+    /** Report an error as it happens. */
+    error(code: CallErrorCode): void;
+    /**
+     * Report measured figures. Invalid or absent figures are dropped; nothing is
+     * sent without at least one. `force` sends even within 5 seconds of the
+     * previous quality report (the final report when a connection closes); the
+     * platform may then refuse it with 429, which is dropped.
+     */
+    quality(figures: CallQualityFigures, force?: boolean): void;
+    /** Stop reporting; later calls do nothing. */
+    stop(): void;
+}
+/** The HTTP status a transport error carries, when it carries one. */
+export declare function statusOf(cause: unknown): number | undefined;
+/** The runtime a report comes from, for SDKs that run in several. */
+export declare function reportPlatform(): "node" | "other";
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../calls/src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,MAAM,MAAM,aAAa,GACrB,yBAAyB,GACzB,kBAAkB,GAClB,eAAe,GACf,YAAY,GACZ,oBAAoB,GACpB,eAAe,GACf,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,GACrB,OAAO,CAAC;AAEZ,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;CACjD;AAED,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAClB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC;CAClD,CAAC;AAEN,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAeD;;;;;GAKG;AACH,qBAAa,YAAY;;gBAOX,OAAO,EAAE,mBAAmB;IAKxC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,qCAAqC;IACrC,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAchC;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,UAAQ,GAAG,IAAI;IAoBzD,8CAA8C;IAC9C,IAAI,IAAI,IAAI;CAuBb;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI3D;AAED,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,MAAM,GAAG,OAAO,CAKjD"}

package/dist/calls/diagnostics.js

@@ -0,0 +1,133 @@
+/**
+ * Call diagnostics an app reports for one of its media connections through
+ * `POST /messaging/voip/calls/{id}/reports`. Only technical figures and error
+ * codes are sent: no phone numbers, names, audio, video or device labels.
+ */
+/** Package version sent with reports from `@polymorfa/sdk/calls`. */
+export const CALLS_SDK_VERSION = "0.1.0-dev.0";
+/** Platform limits per connection, applied locally to avoid refusals. */
+const QUALITY_INTERVAL_MS = 5_000;
+const ERRORS_PER_MINUTE = 20;
+const CODEC = /^[A-Za-z0-9/.-]{1,32}$/;
+const LIMITS = {
+    rttMs: 60_000,
+    jitterMs: 60_000,
+    packetsLost: 2_147_483_647,
+    packetsReceived: 2_147_483_647,
+    reconnects: 1_000,
+};
+/**
+ * Sends a connection's reports without ever affecting the call: nothing it
+ * does throws, sends are not awaited by callers, failed sends are not
+ * retried, and after a refusal other than 429 it sends nothing more (the
+ * credential, scope or call does not accept reports).
+ */
+export class CallReporter {
+    #options;
+    #now;
+    #stopped = false;
+    #lastQuality;
+    #errorTimes = [];
+    constructor(options) {
+        this.#options = options;
+        this.#now = options.now ?? Date.now;
+    }
+    get stopped() {
+        return this.#stopped;
+    }
+    /** Report an error as it happens. */
+    error(code) {
+        if (this.#stopped)
+            return;
+        const now = this.#now();
+        this.#errorTimes = this.#errorTimes.filter((t) => now - t < 60_000);
+        if (this.#errorTimes.length >= ERRORS_PER_MINUTE)
+            return;
+        this.#errorTimes.push(now);
+        this.#send({
+            kind: "error",
+            connectionId: this.#options.connectionId,
+            client: this.#options.client,
+            error: { code },
+        });
+    }
+    /**
+     * Report measured figures. Invalid or absent figures are dropped; nothing is
+     * sent without at least one. `force` sends even within 5 seconds of the
+     * previous quality report (the final report when a connection closes); the
+     * platform may then refuse it with 429, which is dropped.
+     */
+    quality(figures, force = false) {
+        if (this.#stopped)
+            return;
+        const quality = cleanFigures(figures);
+        if (quality === undefined)
+            return;
+        const now = this.#now();
+        if (!force &&
+            this.#lastQuality !== undefined &&
+            now - this.#lastQuality < QUALITY_INTERVAL_MS)
+            return;
+        this.#lastQuality = now;
+        this.#send({
+            kind: "quality",
+            connectionId: this.#options.connectionId,
+            client: this.#options.client,
+            quality,
+        });
+    }
+    /** Stop reporting; later calls do nothing. */
+    stop() {
+        this.#stopped = true;
+    }
+    #send(report) {
+        let sending;
+        try {
+            sending = this.#options.send(report);
+        }
+        catch (cause) {
+            this.#refused(cause);
+            return;
+        }
+        void Promise.resolve(sending).catch((cause) => this.#refused(cause));
+    }
+    #refused(cause) {
+        const status = statusOf(cause);
+        // 429 and 5xx are transient: this report is dropped, later ones are sent.
+        if (status !== undefined && status >= 400 && status < 500 && status !== 429)
+            this.#stopped = true;
+    }
+}
+/** The HTTP status a transport error carries, when it carries one. */
+export function statusOf(cause) {
+    if (cause === null || typeof cause !== "object")
+        return undefined;
+    const status = cause.status;
+    return typeof status === "number" ? status : undefined;
+}
+/** The runtime a report comes from, for SDKs that run in several. */
+export function reportPlatform() {
+    const process = globalThis.process;
+    return typeof process?.versions?.node === "string" ? "node" : "other";
+}
+function cleanFigures(figures) {
+    const out = {};
+    for (const [key, max] of Object.entries(LIMITS)) {
+        const value = figures[key];
+        if (typeof value !== "number" || !Number.isFinite(value))
+            continue;
+        out[key] = Math.min(max, Math.max(0, Math.round(value)));
+    }
+    for (const key of ["audioCodec", "videoCodec"]) {
+        const value = figures[key];
+        if (typeof value === "string" && CODEC.test(value))
+            out[key] = value;
+    }
+    if (figures.candidateType !== undefined &&
+        ["host", "srflx", "prflx", "relay"].includes(figures.candidateType))
+        out["candidateType"] = figures.candidateType;
+    return Object.keys(out).length === 0
+        ? undefined
+        : out;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/calls/diagnostics.js.map

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

package/dist/calls/errors.d.ts

@@ -0,0 +1,37 @@
+/** Base class for every error the Calls client raises with a stable `code`. */
+export declare class CallsError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** A REST operation failed; `status` is the HTTP status (200 for a malformed success body). */
+export declare class CallsApiError extends CallsError {
+    readonly status: number;
+    constructor(status: number, code: string, message: string);
+}
+/**
+ * Another participant answered the call with `exclusive: true`. Accepting or
+ * attaching media is refused for everyone else. Stop ringing; do not decline,
+ * which would end the call for the participant who claimed it.
+ */
+export declare class CallClaimedError extends CallsApiError {
+    constructor(message?: string);
+}
+/**
+ * Calling is turned off for the session in its call settings. Placing,
+ * answering, joining, inviting and attaching media are refused until it is
+ * turned back on; calls in progress continue.
+ */
+export declare class CallsDisabledError extends CallsApiError {
+    constructor(message?: string);
+}
+/**
+ * The credential no longer authorizes the socket: it expired, was revoked, or
+ * its client rules changed. The platform closes the socket with code 4401.
+ * The client asks the token provider for a fresh token before reconnecting.
+ */
+export declare class CallsAuthError extends CallsError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../calls/src/errors.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKzE;AAED,+FAA+F;AAC/F,qBAAa,aAAc,SAAQ,UAAU;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1D;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,OAAO,SAA2C;CAI/D;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,SAA2C;CAI/D;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,SAAsD;CAI1E"}

package/dist/calls/errors.js

@@ -0,0 +1,52 @@
+/** Base class for every error the Calls client raises with a stable `code`. */
+export class CallsError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "CallsError";
+        this.code = code;
+    }
+}
+/** A REST operation failed; `status` is the HTTP status (200 for a malformed success body). */
+export class CallsApiError extends CallsError {
+    status;
+    constructor(status, code, message) {
+        super(code, message);
+        this.name = "CallsApiError";
+        this.status = status;
+    }
+}
+/**
+ * Another participant answered the call with `exclusive: true`. Accepting or
+ * attaching media is refused for everyone else. Stop ringing; do not decline,
+ * which would end the call for the participant who claimed it.
+ */
+export class CallClaimedError extends CallsApiError {
+    constructor(message = "Another participant claimed this call.") {
+        super(409, "call_claimed", message);
+        this.name = "CallClaimedError";
+    }
+}
+/**
+ * Calling is turned off for the session in its call settings. Placing,
+ * answering, joining, inviting and attaching media are refused until it is
+ * turned back on; calls in progress continue.
+ */
+export class CallsDisabledError extends CallsApiError {
+    constructor(message = "Calling is turned off for this number.") {
+        super(403, "calls_disabled", message);
+        this.name = "CallsDisabledError";
+    }
+}
+/**
+ * The credential no longer authorizes the socket: it expired, was revoked, or
+ * its client rules changed. The platform closes the socket with code 4401.
+ * The client asks the token provider for a fresh token before reconnecting.
+ */
+export class CallsAuthError extends CallsError {
+    constructor(message = "The credential no longer authorizes this session.") {
+        super("unauthorized", message);
+        this.name = "CallsAuthError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/calls/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../calls/src/errors.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAS;IACtB,YAAY,IAAY,EAAE,OAAe,EAAE,OAA6B;QACtE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,+FAA+F;AAC/F,MAAM,OAAO,aAAc,SAAQ,UAAU;IAClC,MAAM,CAAS;IACxB,YAAY,MAAc,EAAE,IAAY,EAAE,OAAe;QACvD,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACjD,YAAY,OAAO,GAAG,wCAAwC;QAC5D,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAO,GAAG,wCAAwC;QAC5D,KAAK,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,OAAO,GAAG,mDAAmD;QACvE,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/calls/events.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A small typed event emitter. Platform-neutral on purpose: the client model is
+ * consumed both by Node bots and by the browser kit, so nothing here may reach
+ * for `node:events`.
+ */
+export type Listener<T extends unknown[]> = (...args: T) => void;
+export declare class Emitter<Events extends Record<string, unknown[]>> {
+    #private;
+    on<K extends keyof Events>(event: K, listener: Listener<Events[K]>): () => void;
+    once<K extends keyof Events>(event: K, listener: Listener<Events[K]>): () => void;
+    off<K extends keyof Events>(event: K, listener: Listener<Events[K]>): void;
+    protected emit<K extends keyof Events>(event: K, ...args: Events[K]): void;
+    protected removeAllListeners(): void;
+}
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../calls/src/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEjE,qBAAa,OAAO,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;;IAG3D,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EACvB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAC5B,MAAM,IAAI;IAUb,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EACzB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAC5B,MAAM,IAAI;IAQb,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI1E,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAO1E,SAAS,CAAC,kBAAkB,IAAI,IAAI;CAGrC"}

package/dist/calls/events.js

@@ -0,0 +1,34 @@
+export class Emitter {
+    #listeners = new Map();
+    on(event, listener) {
+        let set = this.#listeners.get(event);
+        if (set === undefined) {
+            set = new Set();
+            this.#listeners.set(event, set);
+        }
+        set.add(listener);
+        return () => this.off(event, listener);
+    }
+    once(event, listener) {
+        const off = this.on(event, ((...args) => {
+            off();
+            listener(...args);
+        }));
+        return off;
+    }
+    off(event, listener) {
+        this.#listeners.get(event)?.delete(listener);
+    }
+    emit(event, ...args) {
+        const set = this.#listeners.get(event);
+        if (set === undefined)
+            return;
+        // Copy first: a listener may unsubscribe itself or others while we iterate.
+        for (const listener of [...set])
+            listener(...args);
+    }
+    removeAllListeners() {
+        this.#listeners.clear();
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/calls/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../calls/src/events.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,OAAO;IACT,UAAU,GAAG,IAAI,GAAG,EAAsC,CAAC;IAEpE,EAAE,CACA,KAAQ,EACR,QAA6B;QAE7B,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAA2B,CAAC,CAAC;QACrC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CACF,KAAQ,EACR,QAA6B;QAE7B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE;YACjD,GAAG,EAAE,CAAC;YACN,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC,CAAwB,CAAC,CAAC;QAC3B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,GAAG,CAAyB,KAAQ,EAAE,QAA6B;QACjE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAA2B,CAAC,CAAC;IAClE,CAAC;IAES,IAAI,CAAyB,KAAQ,EAAE,GAAG,IAAe;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO;QAC9B,4EAA4E;QAC5E,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC;YAAG,QAAgC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9E,CAAC;IAES,kBAAkB;QAC1B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/calls/index.d.ts

@@ -0,0 +1,6 @@
+export { CallsClient, type CallsClientOptions, type PlaceOptions, } from "./client.js";
+export { Call, AudioTrack, VideoTrack, type AnswerOptions, type CallCapabilities, type CallClaim, type CallDirection, type CallEndReason, type CallState, type CallVideoFrame, type CallVideoSource, type OutgoingVideoFrame, } from "./call.js";
+export { CallClaimedError, CallsApiError, CallsAuthError, CallsDisabledError, CallsError, } from "./errors.js";
+export type { CallsToken, CallsTokenProvider, CallsTokenRequest, } from "./token.js";
+export { DEFAULT_SAMPLE_RATE, type Participant } from "./protocol.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../calls/src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,IAAI,EACJ,UAAU,EACV,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/calls/index.js

@@ -0,0 +1,7 @@
+// Public entry point: neutral calling operations only. Transport, signaling
+// and media framing live in internal modules (see `./internal`).
+export { CallsClient, } from "./client.js";
+export { Call, AudioTrack, VideoTrack, } from "./call.js";
+export { CallClaimedError, CallsApiError, CallsAuthError, CallsDisabledError, CallsError, } from "./errors.js";
+export { DEFAULT_SAMPLE_RATE } from "./protocol.js";
+//# sourceMappingURL=index.js.map

package/dist/calls/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../calls/src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,iEAAiE;AACjE,OAAO,EACL,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,IAAI,EACJ,UAAU,EACV,UAAU,GAUX,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAE,mBAAmB,EAAoB,MAAM,eAAe,CAAC"}

package/dist/calls/internal.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Internal building blocks shared with other Polymorfa packages. Not part of
+ * the public API: no stability guarantee, and applications must not import
+ * this entry point.
+ * @packageDocumentation
+ * @internal
+ */
+export * from "./index.js";
+export { HttpCallsApi, callsHttpError, parseAcceptResult, parseParticipant, type AcceptCallOptions, type AcceptCallResult, type CallsApi, type FetchLike, type HttpCallsApiOptions, type PlaceCallRequest, } from "./api.js";
+export { capabilitiesFrom, type CallInit } from "./call.js";
+export { createInternalCallsClient, type InternalCallsClientOptions, } from "./client.js";
+export { CallsTokenSource, isClientToken, normalizeToken, type CallsTokenSourceOptions, } from "./token.js";
+export { LifecycleSocket, SocketCloseCode, type LifecycleCandidate, type LifecycleEvent, type LifecycleReady, type LifecycleSocketOptions, } from "./lifecycle.js";
+export { CALL_CLAIMED_CLOSE_CODE, MediaSocket, type MediaClose, type MediaCloseReason, type MediaReady, type MediaSocketOptions, type MediaVideoSource, } from "./media.js";
+export { AUTH_FAILED_CLOSE_CODE, LIFECYCLE_SOCKET_PATH, MEDIA_SUBPROTOCOL, MediaFrameKind, VideoCodec, VideoFlags, VIDEO_HEADER_BYTES, createConnectionId, decodeMediaFrame, encodeAudioFrame, encodeVideoFrame, isConnectionId, isParticipant, isParticipantName, isSourceHandle, mediaSocketPath, parseLifecycleFrame, parseMediaControl, parseMediaControlValue, type DecodedMediaFrame, type LifecycleClientFrame, type LifecycleFrame, type MediaClientFrame, type MediaControlFrame, type OutboundVideoFrame, type TrickleCandidate, type VideoFrame, type VideoFrameHeader, type VideoSourceFrame, type VideoSourceOwner, } from "./protocol.js";
+export { Emitter } from "./events.js";
+export { CALLS_SDK_VERSION, CallReporter, reportPlatform, statusOf, type CallErrorCode, type CallQualityFigures, type CallReport, type CallReportClient, type CallReporterOptions, } from "./diagnostics.js";
+//# sourceMappingURL=internal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../calls/src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/calls/internal.js

@@ -0,0 +1,18 @@
+/**
+ * Internal building blocks shared with other Polymorfa packages. Not part of
+ * the public API: no stability guarantee, and applications must not import
+ * this entry point.
+ * @packageDocumentation
+ * @internal
+ */
+export * from "./index.js";
+export { HttpCallsApi, callsHttpError, parseAcceptResult, parseParticipant, } from "./api.js";
+export { capabilitiesFrom } from "./call.js";
+export { createInternalCallsClient, } from "./client.js";
+export { CallsTokenSource, isClientToken, normalizeToken, } from "./token.js";
+export { LifecycleSocket, SocketCloseCode, } from "./lifecycle.js";
+export { CALL_CLAIMED_CLOSE_CODE, MediaSocket, } from "./media.js";
+export { AUTH_FAILED_CLOSE_CODE, LIFECYCLE_SOCKET_PATH, MEDIA_SUBPROTOCOL, MediaFrameKind, VideoCodec, VideoFlags, VIDEO_HEADER_BYTES, createConnectionId, decodeMediaFrame, encodeAudioFrame, encodeVideoFrame, isConnectionId, isParticipant, isParticipantName, isSourceHandle, mediaSocketPath, parseLifecycleFrame, parseMediaControl, parseMediaControlValue, } from "./protocol.js";
+export { Emitter } from "./events.js";
+export { CALLS_SDK_VERSION, CallReporter, reportPlatform, statusOf, } from "./diagnostics.js";
+//# sourceMappingURL=internal.js.map

package/dist/calls/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../../calls/src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GAOjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAiB,MAAM,WAAW,CAAC;AAC5D,OAAO,EACL,yBAAyB,GAE1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,GAEf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,eAAe,GAKhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,WAAW,GAMZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GAYvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,QAAQ,GAMT,MAAM,kBAAkB,CAAC"}

package/dist/calls/lifecycle.d.ts

@@ -0,0 +1,111 @@
+import type { CallsApi } from "./api.js";
+import { CallsError } from "./errors.js";
+import { Emitter } from "./events.js";
+import { type TrickleCandidate } from "./protocol.js";
+/** A `call.*` event as the platform emits it, before the client shapes it. */
+export interface LifecycleEvent {
+    readonly event: string;
+    readonly callId: string;
+    readonly payload: Record<string, unknown>;
+    readonly timestamp: string;
+}
+export interface LifecycleCandidate {
+    readonly callId: string;
+    readonly connectionId?: string;
+    readonly candidate: TrickleCandidate;
+}
+export interface LifecycleReady {
+    readonly session?: string;
+    /** Participant reference of the authenticated credential, when the platform sends it. */
+    readonly participant?: string;
+}
+export interface LifecycleSocketOptions {
+    readonly api: Pick<CallsApi, "token" | "socketUrl">;
+    /**
+     * Session to follow. Sent as `?session=` for server credentials only;
+     * client tokens are bound to one session and send no query parameters.
+     */
+    readonly session?: string;
+    /**
+     * Participant name for server credentials, sent as `?participant=`.
+     * Ignored for client tokens.
+     */
+    readonly participant?: string;
+    readonly WebSocket?: typeof globalThis.WebSocket;
+    readonly setTimeout?: typeof globalThis.setTimeout;
+    readonly clearTimeout?: typeof globalThis.clearTimeout;
+    readonly setInterval?: typeof globalThis.setInterval;
+    readonly clearInterval?: typeof globalThis.clearInterval;
+    readonly random?: () => number;
+    readonly now?: () => number;
+    /** Reconnect backoff bounds; defaults 1 000 → 30 000 ms. */
+    readonly minBackoffMs?: number;
+    readonly maxBackoffMs?: number;
+    /** Heartbeat period; 0 disables. Default 15 000 ms. */
+    readonly heartbeatMs?: number;
+    /**
+     * Bound on one attempt, from construction until the platform's `ready`
+     * frame. 0 disables. Default 10 000 ms.
+     */
+    readonly connectTimeoutMs?: number;
+    /**
+     * Send a replacement token this long before the current one expires.
+     * Default 60 000 ms. Tokens without an expiry are not replaced.
+     */
+    readonly refreshBeforeExpiryMs?: number;
+    /**
+     * Where a listener exception raised at an asynchronous boundary (a `state`
+     * or `error` listener throwing after a token request settled) is reported.
+     * Defaults to the platform's `reportError`, else a microtask rethrow.
+     */
+    readonly reportError?: (cause: unknown) => void;
+}
+type Events = {
+    event: [LifecycleEvent];
+    candidate: [LifecycleCandidate];
+    ready: [LifecycleReady];
+    /** True once authenticated (`ready`), false when that socket goes away. */
+    state: [connected: boolean];
+    error: [CallsError];
+};
+/** Close codes the platform uses on the lifecycle and media sockets. */
+export declare const SocketCloseCode: {
+    /** The credential does not (or no longer) authorize the socket. */
+    readonly Unauthorized: 4401;
+    /** Call or session state refused the socket (for example a claimed call). */
+    readonly Conflict: 4409;
+    /** Too many attempts. */
+    readonly RateLimited: 4429;
+    /** The request is invalid (for example an unknown session or participant). */
+    readonly InvalidRequest: 4400;
+    /** A policy violation, including no auth frame within 5 seconds. */
+    readonly PolicyViolation: 1008;
+    /** Authorization or the call is temporarily unavailable. */
+    readonly 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 declare class LifecycleSocket extends Emitter<Events> {
+    #private;
+    constructor(options: LifecycleSocketOptions);
+    /** True while an authenticated socket is open. */
+    get connected(): boolean;
+    /** Participant reference from the last `ready` frame, when the platform sent one. */
+    get participant(): string | undefined;
+    /**
+     * Resolves once the first attempt settles: authenticated, failed (a retry
+     * is scheduled), or closed.
+     */
+    connect(): Promise<void>;
+    /** Send a local ICE candidate; false while no authenticated socket is open. */
+    sendCandidate(callId: string, connectionId: string, candidate: TrickleCandidate): boolean;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../calls/src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAkB,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAGvB,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC;IACpD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,SAAS,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC,UAAU,CAAC;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,UAAU,CAAC,YAAY,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,UAAU,CAAC,WAAW,CAAC;IACrD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,UAAU,CAAC,aAAa,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD;AAED,KAAK,MAAM,GAAG;IACZ,KAAK,EAAE,CAAC,cAAc,CAAC,CAAC;IACxB,SAAS,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,cAAc,CAAC,CAAC;IACxB,2EAA2E;IAC3E,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,UAAU,CAAC,CAAC;CACrB,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,eAAe;IAC1B,mEAAmE;;IAEnE,6EAA6E;;IAE7E,yBAAyB;;IAEzB,8EAA8E;;IAE9E,oEAAoE;;IAEpE,4DAA4D;;CAEpD,CAAC;AAEX;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,OAAO,CAAC,MAAM,CAAC;;gBAqBtC,OAAO,EAAE,sBAAsB;IAW3C,kDAAkD;IAClD,IAAI,SAAS,IAAI,OAAO,CAMvB;IAED,qFAAqF;IACrF,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,+EAA+E;IAC/E,aAAa,CACX,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,gBAAgB,GAC1B,OAAO;IAIV,KAAK,IAAI,IAAI;CA2Yd"}