@polymorfa/sdk 0.1.0-dev.20260922093854

package/dist/calls/protocol.js

@@ -0,0 +1,268 @@
+/**
+ * The wire contract between this client and the platform (Calls contract
+ * revision 1). Two sockets carry a call:
+ *
+ * 1. The **lifecycle socket** (`GET /voip/ws`) — one per client. No credential
+ *    travels in the URL: the first frame is `{ type: "auth", token }` and the
+ *    platform answers `ready`. Server credentials name the session with
+ *    `?session=` (and optionally `&participant=`); client tokens send no query
+ *    parameters. A later `auth` frame replaces an expiring token and must
+ *    resolve to the same organization, project, session and participant. The
+ *    platform closes the socket with 4401 once the token stops authorizing
+ *    the session.
+ *
+ * 2. The **media socket** (`GET /voip/calls/{callId}/media`, subprotocol
+ *    `pmfa.calls.v2`) — one per media connection. The first frame is
+ *    `{ type: "auth", token, connectionId, participant? }`; the URL carries no
+ *    query parameters. Replacement auth frames cannot change the connection
+ *    or participant. Binary frames
+ *    carry media, text frames carry JSON control. Every binary frame starts
+ *    with a one-byte kind tag so audio and video share the socket.
+ */
+// ── Identifiers ──────────────────────────────────────────────────────────
+/** Lifecycle socket path on the API host. */
+export const LIFECYCLE_SOCKET_PATH = "/voip/ws";
+/** Close code for a token that no longer authorizes the socket. */
+export const AUTH_FAILED_CLOSE_CODE = 4401;
+/** Media socket subprotocol. */
+export const MEDIA_SUBPROTOCOL = "pmfa.calls.v2";
+export function mediaSocketPath(callId) {
+    return `/voip/calls/${encodeURIComponent(callId)}/media`;
+}
+const CONNECTION_ID = /^[A-Za-z0-9_-]{8,64}$/;
+const PARTICIPANT = /^[A-Za-z0-9._:@-]{1,128}$/;
+/** A media connection id: 8–64 characters of `[A-Za-z0-9_-]`. */
+export function isConnectionId(value) {
+    return typeof value === "string" && CONNECTION_ID.test(value);
+}
+/** A server-credential participant name: 1–128 characters of `[A-Za-z0-9._:@-]`. */
+export function isParticipantName(value) {
+    return typeof value === "string" && PARTICIPANT.test(value);
+}
+/**
+ * A new connection id: 18 crypto-random bytes as base64url (24 characters).
+ * Reuse the same id to reconnect the same connection.
+ */
+export function createConnectionId(random = (bytes) => globalThis.crypto.getRandomValues(bytes)) {
+    const bytes = random(new Uint8Array(new ArrayBuffer(18)));
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary)
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=+$/, "");
+}
+/** Parse one lifecycle frame; unknown or malformed frames yield `undefined`. */
+export function parseLifecycleFrame(data) {
+    const f = parseObject(data);
+    if (f === undefined)
+        return undefined;
+    switch (f["type"]) {
+        case "ready":
+            return optionalString(f["session"]) && optionalString(f["participant"])
+                ? f
+                : undefined;
+        case "event":
+            return isString(f["event"]) &&
+                isString(f["callId"]) &&
+                isString(f["timestamp"]) &&
+                "payload" in f
+                ? f
+                : undefined;
+        case "candidate":
+            return isString(f["callId"]) &&
+                (f["connectionId"] === undefined ||
+                    isConnectionId(f["connectionId"])) &&
+                isCandidate(f["candidate"])
+                ? f
+                : undefined;
+        case "error":
+            return isString(f["code"]) && isString(f["message"])
+                ? f
+                : undefined;
+        case "pong":
+            return f;
+        default:
+            return undefined;
+    }
+}
+// ── Media socket ──────────────────────────────────────────────────────────
+/** First byte of every binary media frame. */
+export const MediaFrameKind = {
+    /** s16le mono PCM at the `ready` frame's sample rate. */
+    Audio: 0x01,
+    /** One encoded access unit; payload is {@link VIDEO_HEADER_BYTES} of header then the bytes. */
+    Video: 0x02,
+};
+/** Default PCM rate until the `ready` frame names one. */
+export const DEFAULT_SAMPLE_RATE = 16_000;
+/**
+ * Header that follows the {@link MediaFrameKind.Video} tag. Fixed 14 bytes,
+ * big-endian: codec (1) · flags (1) · source (4) · timestamp µs (8), then one
+ * Annex-B access unit.
+ */
+export const VIDEO_HEADER_BYTES = 14;
+export const VideoCodec = { H264: 0x01 };
+export const VideoFlags = { Keyframe: 0x01 };
+export function encodeAudioFrame(pcm) {
+    const out = new Uint8Array(new ArrayBuffer(1 + pcm.length * 2));
+    out[0] = MediaFrameKind.Audio;
+    const view = new DataView(out.buffer, out.byteOffset + 1);
+    for (let i = 0; i < pcm.length; i += 1)
+        view.setInt16(i * 2, pcm[i] ?? 0, true);
+    return out;
+}
+export function encodeVideoFrame(frame) {
+    const out = new Uint8Array(new ArrayBuffer(1 + VIDEO_HEADER_BYTES + frame.data.byteLength));
+    out[0] = MediaFrameKind.Video;
+    const view = new DataView(out.buffer, out.byteOffset + 1, VIDEO_HEADER_BYTES);
+    view.setUint8(0, frame.codec ?? VideoCodec.H264);
+    view.setUint8(1, frame.keyframe ? VideoFlags.Keyframe : 0);
+    view.setUint32(2, (frame.source ?? 0) >>> 0);
+    view.setBigUint64(6, BigInt(Math.max(0, Math.floor(frame.timestampUs))));
+    out.set(frame.data, 1 + VIDEO_HEADER_BYTES);
+    return out;
+}
+/** Decode one binary media frame; malformed frames yield `undefined`. */
+export function decodeMediaFrame(bytes) {
+    if (bytes.byteLength < 1)
+        return undefined;
+    const kind = bytes[0];
+    const body = bytes.subarray(1);
+    if (kind === MediaFrameKind.Audio) {
+        if (body.byteLength % 2 !== 0)
+            return undefined;
+        const pcm = new Int16Array(body.byteLength / 2);
+        const view = new DataView(body.buffer, body.byteOffset, body.byteLength);
+        for (let i = 0; i < pcm.length; i += 1)
+            pcm[i] = view.getInt16(i * 2, true);
+        return { kind: "audio", pcm };
+    }
+    if (kind === MediaFrameKind.Video) {
+        if (body.byteLength <= VIDEO_HEADER_BYTES)
+            return undefined;
+        const view = new DataView(body.buffer, body.byteOffset, VIDEO_HEADER_BYTES);
+        const codec = view.getUint8(0);
+        if (codec !== VideoCodec.H264)
+            return undefined;
+        return {
+            kind: "video",
+            frame: {
+                codec,
+                keyframe: (view.getUint8(1) & VideoFlags.Keyframe) !== 0,
+                source: view.getUint32(2),
+                timestampUs: Number(view.getBigUint64(6)),
+                data: body.subarray(VIDEO_HEADER_BYTES),
+            },
+        };
+    }
+    return undefined;
+}
+export function parseMediaControl(data) {
+    const parsed = parseObject(data);
+    return parsed === undefined ? undefined : parseMediaControlValue(parsed);
+}
+/** Validate an already-decoded media control value. @internal */
+export function parseMediaControlValue(parsed) {
+    if (parsed === null || typeof parsed !== "object")
+        return undefined;
+    const f = parsed;
+    switch (f["type"]) {
+        case "pong":
+        case "keyframe_request":
+            return parsed;
+        case "ready":
+            return typeof f["sampleRate"] === "number" &&
+                Number.isFinite(f["sampleRate"]) &&
+                f["sampleRate"] > 0 &&
+                typeof f["video"] === "boolean" &&
+                optionalString(f["callId"]) &&
+                optionalString(f["connectionId"])
+                ? parsed
+                : undefined;
+        case "participant_joined":
+        case "participant_state":
+            return isParticipant(f["participant"])
+                ? parsed
+                : undefined;
+        case "participant_left":
+            return isString(f["participantId"]) && optionalString(f["reason"])
+                ? parsed
+                : undefined;
+        case "video_source": {
+            if (!isSourceHandle(f["source"]))
+                return undefined;
+            const byConnection = isConnectionId(f["connectionId"]) &&
+                optionalString(f["connectionParticipant"]) &&
+                f["participant"] === undefined;
+            const byParticipant = isParticipant(f["participant"]) &&
+                f["connectionId"] === undefined &&
+                f["connectionParticipant"] === undefined;
+            return byConnection || byParticipant
+                ? parsed
+                : undefined;
+        }
+        case "video_source_removed":
+            return isSourceHandle(f["source"])
+                ? parsed
+                : undefined;
+        case "error":
+            return isString(f["code"]) && optionalString(f["message"])
+                ? parsed
+                : undefined;
+        default:
+            return undefined;
+    }
+}
+/** A positive uint32 source handle. */
+export function isSourceHandle(value) {
+    return (typeof value === "number" &&
+        Number.isInteger(value) &&
+        value > 0 &&
+        value <= 0xffff_ffff);
+}
+export function isParticipant(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const p = value;
+    return (isString(p["id"]) &&
+        p["id"].length > 0 &&
+        !Object.hasOwn(p, "handle") &&
+        ["phoneNumber", "bsuid", "username"].every((key) => optionalString(p[key])) &&
+        typeof p["audioMuted"] === "boolean" &&
+        typeof p["video"] === "boolean" &&
+        ["invited", "ringing", "connected", "left"].includes(p["state"]));
+}
+function isCandidate(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const candidate = value;
+    // `null` is what a serialized `RTCIceCandidate` carries for an absent
+    // `sdpMid` / `sdpMLineIndex`, so it is tolerated.
+    return (isString(candidate["candidate"]) &&
+        (candidate["sdpMid"] == null || isString(candidate["sdpMid"])) &&
+        (candidate["sdpMLineIndex"] == null ||
+            typeof candidate["sdpMLineIndex"] === "number"));
+}
+function parseObject(data) {
+    if (typeof data !== "string")
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(data);
+    }
+    catch {
+        return undefined;
+    }
+    return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)
+        ? parsed
+        : undefined;
+}
+function isString(value) {
+    return typeof value === "string";
+}
+function optionalString(value) {
+    return value === undefined || typeof value === "string";
+}
+//# sourceMappingURL=protocol.js.map

package/dist/calls/protocol.js.map

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

package/dist/calls/token.d.ts

@@ -0,0 +1,43 @@
+/** A credential value and, when known, its expiry in Unix epoch milliseconds. */
+export interface CallsToken {
+    readonly value: string;
+    readonly expiresAt?: number;
+}
+export interface CallsTokenRequest {
+    /** True when a cached token must not be reused (expiry or a 4401 close). */
+    readonly refresh?: boolean;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Supplies the credential for REST calls and socket authentication. Browser
+ * applications return a client token minted by their own server with
+ * `POST /platform/client-tokens`. Server applications may return an
+ * organization API key or project token.
+ */
+export type CallsTokenProvider = (request: CallsTokenRequest) => Promise<string | CallsToken>;
+export interface CallsTokenSourceOptions {
+    readonly now?: () => number;
+    /** Treat a token as expired this long before `expiresAt`. Default 30 000 ms. */
+    readonly expirySkewMs?: number;
+}
+/** Client tokens are bound to one session and one participant by the platform. */
+export declare function isClientToken(value: string): boolean;
+/**
+ * Caches a provider's token until shortly before it expires. A static string
+ * never expires from the client's point of view; the platform still closes
+ * sockets with 4401 when it stops authorizing the session.
+ */
+export declare class CallsTokenSource {
+    #private;
+    constructor(provider: string | CallsTokenProvider, options?: CallsTokenSourceOptions);
+    /** Resolve the current token, calling the provider when none is usable. */
+    get(request?: CallsTokenRequest): Promise<CallsToken>;
+    /**
+     * Drop the cached token so the next `get()` asks the provider. A provider
+     * call already in flight may return the refused token: it neither answers
+     * later requests nor replaces the cache.
+     */
+    invalidate(): void;
+}
+export declare function normalizeToken(supplied: unknown): CallsToken;
+//# sourceMappingURL=token.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../calls/src/token.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,iBAAiB,KACvB,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;AAElC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;;gBAUzB,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EACrC,OAAO,GAAE,uBAA4B;IAmBvC,2EAA2E;IAC3E,GAAG,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IAoFzD;;;;OAIG;IACH,UAAU,IAAI,IAAI;CAgBnB;AAYD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,UAAU,CAe5D"}

package/dist/calls/token.js

@@ -0,0 +1,146 @@
+import { CallsError } from "./errors.js";
+/** Client tokens are bound to one session and one participant by the platform. */
+export function isClientToken(value) {
+    return value.startsWith("pmfa_ct_");
+}
+/**
+ * Caches a provider's token until shortly before it expires. A static string
+ * never expires from the client's point of view; the platform still closes
+ * sockets with 4401 when it stops authorizing the session.
+ */
+export class CallsTokenSource {
+    #provider;
+    #now;
+    #skew;
+    #cached;
+    #pending;
+    // Only the latest provider call may replace the cached token.
+    #fetchGeneration = 0;
+    constructor(provider, options = {}) {
+        if (typeof provider === "string") {
+            if (provider.length === 0)
+                throw new CallsError("invalid_token", "The token must not be empty.");
+            const token = { value: provider };
+            this.#provider = async () => token;
+        }
+        else if (typeof provider === "function") {
+            this.#provider = provider;
+        }
+        else {
+            throw new CallsError("invalid_token", "Pass a token string or a token provider function.");
+        }
+        this.#now = options.now ?? Date.now;
+        this.#skew = options.expirySkewMs ?? 30_000;
+    }
+    /** Resolve the current token, calling the provider when none is usable. */
+    get(request = {}) {
+        const cached = this.#cached;
+        if (request.refresh !== true &&
+            cached !== undefined &&
+            (cached.expiresAt === undefined ||
+                cached.expiresAt - this.#skew > this.#now()))
+            return Promise.resolve(cached);
+        const refresh = request.refresh === true;
+        if (refresh)
+            this.#cached = undefined;
+        // A refresh never takes the result of a provider call that was not asked
+        // to refresh: that call may return the refused token.
+        let pending = this.#pending;
+        if (pending === undefined || (refresh && !pending.refresh)) {
+            const generation = ++this.#fetchGeneration;
+            const controller = new AbortController();
+            const entry = {
+                promise: Promise.resolve(),
+                refresh,
+                controller,
+                waiters: 0,
+                anchored: false,
+            };
+            entry.promise = this.#fetch(refresh, controller.signal, generation).finally(() => {
+                if (this.#pending === entry)
+                    this.#pending = undefined;
+            });
+            // Every caller may have gone before it settles.
+            entry.promise.catch(() => undefined);
+            this.#pending = entry;
+            pending = entry;
+        }
+        return this.#wait(pending, request.signal);
+    }
+    /**
+     * Hand one caller the shared provider call. The call runs under its own
+     * signal: a caller's cancellation rejects only that caller, and the call
+     * itself is cancelled once every caller that could cancel has done so and
+     * no caller without a signal is waiting.
+     */
+    #wait(entry, signal) {
+        if (signal === undefined) {
+            entry.anchored = true;
+            return entry.promise;
+        }
+        if (signal.aborted)
+            return Promise.reject(signal.reason);
+        entry.waiters += 1;
+        return new Promise((resolve, reject) => {
+            let done = false;
+            const leave = () => {
+                if (done)
+                    return false;
+                done = true;
+                entry.waiters -= 1;
+                signal.removeEventListener("abort", onAbort);
+                return true;
+            };
+            const onAbort = () => {
+                if (!leave())
+                    return;
+                reject(signal.reason);
+                if (entry.waiters === 0 && !entry.anchored) {
+                    if (this.#pending === entry)
+                        this.#pending = undefined;
+                    entry.controller.abort(signal.reason);
+                }
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+            entry.promise.then((token) => {
+                if (leave())
+                    resolve(token);
+            }, (cause) => {
+                if (leave())
+                    reject(cause);
+            });
+        });
+    }
+    /**
+     * Drop the cached token so the next `get()` asks the provider. A provider
+     * call already in flight may return the refused token: it neither answers
+     * later requests nor replaces the cache.
+     */
+    invalidate() {
+        this.#cached = undefined;
+        this.#pending = undefined;
+        this.#fetchGeneration += 1;
+    }
+    async #fetch(refresh, signal, generation) {
+        const supplied = await this.#provider({ refresh, signal });
+        const token = normalizeToken(supplied);
+        if (generation === this.#fetchGeneration)
+            this.#cached = token;
+        return token;
+    }
+}
+export function normalizeToken(supplied) {
+    if (typeof supplied === "string" && supplied.length > 0)
+        return { value: supplied };
+    if (supplied !== null && typeof supplied === "object") {
+        const t = supplied;
+        if (typeof t.value === "string" && t.value.length > 0) {
+            if (t.expiresAt === undefined)
+                return { value: t.value };
+            if (typeof t.expiresAt === "number" && Number.isFinite(t.expiresAt))
+                return { value: t.value, expiresAt: t.expiresAt };
+        }
+    }
+    throw new CallsError("invalid_token", "The token provider returned an invalid token.");
+}
+//# sourceMappingURL=token.js.map

package/dist/calls/token.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,65 @@
+import { SessionConfigurationResource } from "./platform/session-configuration.js";
+import { type OrganizationClientOptions, type ProjectScopedClientOptions } from "./credentials.js";
+import { RawClient, type ProjectScopedRawClient } from "./raw.js";
+import { ApiKeysResource } from "./platform/api-keys.js";
+import { AudiencesResource } from "./platform/audiences.js";
+import { AuditLogsResource } from "./platform/audit-logs.js";
+import { BillingResource } from "./platform/billing.js";
+import { BanSafeResource } from "./platform/bansafe.js";
+import { CampaignsResource } from "./platform/campaigns.js";
+import { CustomersResource } from "./platform/customers.js";
+import { EventsResource, OperationsResource, WebhookDeliveriesResource, WebhooksResource } from "./platform/developer-resources.js";
+import type { ClientOwner } from "./platform/developer-types.js";
+import { MediaResource } from "./platform/media.js";
+import { MembersResource } from "./platform/members.js";
+import { OptOutsResource } from "./platform/opt-outs.js";
+import { OrganizationsResource } from "./platform/organizations.js";
+import { ProjectTokensResource } from "./platform/project-tokens.js";
+import { ProjectsResource } from "./platform/projects.js";
+import { QuickLinkSettingsResource } from "./platform/quicklink-settings.js";
+import { SecurityIncidentsResource } from "./platform/security-incidents.js";
+import { SessionBansResource } from "./platform/session-bans.js";
+import { PlatformSessionsResource } from "./platform/sessions.js";
+import { SipTrunksResource } from "./platform/sip-trunks.js";
+export type EventsResourceFor<O extends ClientOwner> = EventsResource<O>;
+export type WebhooksResourceFor<O extends ClientOwner> = WebhooksResource<O>;
+export type WebhookDeliveriesResourceFor<O extends ClientOwner> = WebhookDeliveriesResource<O>;
+export type RawResourceFor<O extends ClientOwner> = O extends "project" ? ProjectScopedRawClient : RawClient;
+export interface ClientBase<O extends ClientOwner> {
+    readonly owner: O;
+    readonly projectId: O extends "project" ? string : null;
+    readonly events: EventsResourceFor<O>;
+    readonly webhooks: WebhooksResourceFor<O>;
+    readonly webhookDeliveries: WebhookDeliveriesResourceFor<O>;
+    readonly operations: OperationsResource<O>;
+    readonly sessionConfiguration: SessionConfigurationResource;
+    readonly quickLinkSettings: QuickLinkSettingsResource<O>;
+    readonly sipTrunks: SipTrunksResource<O>;
+    readonly raw: RawResourceFor<O>;
+    project(projectId: string): Client<"project">;
+}
+export interface OrganizationControlPlaneResources {
+    readonly apiKeys: ApiKeysResource;
+    readonly audiences: AudiencesResource;
+    readonly auditLogs: AuditLogsResource;
+    readonly billing: BillingResource;
+    readonly banSafe: BanSafeResource;
+    readonly campaigns: CampaignsResource;
+    readonly customers: CustomersResource;
+    readonly members: MembersResource;
+    readonly organizations: OrganizationsResource;
+    readonly media: MediaResource;
+    readonly optOuts: OptOutsResource;
+    readonly projects: ProjectsResource;
+    readonly projectTokens: ProjectTokensResource;
+    readonly securityIncidents: SecurityIncidentsResource;
+    readonly sessionBans: SessionBansResource;
+    readonly sessions: PlatformSessionsResource;
+}
+export type Client<O extends ClientOwner = "organization"> = ClientBase<O> & (O extends "organization" ? OrganizationControlPlaneResources : object);
+export interface ClientConstructor {
+    new (options: OrganizationClientOptions): Client<"organization">;
+    new (options: ProjectScopedClientOptions): Client<"project">;
+}
+export declare const Client: ClientConstructor;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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