@polymorfa/sdk 0.1.0-dev.20260922093854

package/dist/bridge.d.ts

@@ -0,0 +1,31 @@
+import { type SharedClientOptions } from "./credentials.js";
+import { HttpTransport } from "./transport/http.js";
+import type { ApiResponse, RequestOptions } from "./transport/types.js";
+export interface BridgeClientOptions extends SharedClientOptions {
+    readonly credential: {
+        readonly type: "projectToken";
+        readonly value: string;
+    };
+}
+export type BridgeRegion = "BR" | "US" | "IN" | "Auto";
+export type BridgeKind = "sandbox" | "production";
+export type BridgeSignal = "customer" | "bartender";
+export interface BridgeRoute {
+    readonly wsUrl: string;
+    readonly region: BridgeRegion;
+    readonly kind: BridgeKind;
+    readonly signal: BridgeSignal;
+    readonly tokenKind: "project";
+    readonly expiresAt: number;
+}
+export declare class BridgeRoutesResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    resolve(options?: RequestOptions): Promise<ApiResponse<BridgeRoute>>;
+}
+/** Project-token client for regional Bridge route discovery only. */
+export declare class BridgeClient {
+    readonly routes: BridgeRoutesResource;
+    constructor(options: BridgeClientOptions);
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAErD,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;CAOzE;AAED,qEAAqE;AACrE,qBAAa,YAAY;IACvB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;gBAE1B,OAAO,EAAE,mBAAmB;CAqBzC"}

package/dist/bridge.js

@@ -0,0 +1,39 @@
+import { assertServerRuntime, validateClientCredential, } from "./credentials.js";
+import { PolymorfaConfigurationError } from "./errors.js";
+import { HttpTransport } from "./transport/http.js";
+export class BridgeRoutesResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    resolve(options = {}) {
+        return this.transport.request({
+            method: "GET",
+            path: "/messaging/bridge/route",
+            ...options,
+        });
+    }
+}
+/** Project-token client for regional Bridge route discovery only. */
+export class BridgeClient {
+    routes;
+    constructor(options) {
+        const credential = validateClientCredential(options.credential);
+        if (credential.type !== "projectToken") {
+            throw new PolymorfaConfigurationError("BridgeClient requires a project token.", "credential");
+        }
+        assertServerRuntime();
+        const transport = new HttpTransport({
+            baseUrl: options.baseUrl ?? "https://api.polymorfa.com",
+            authorization: `Bearer ${credential.value}`,
+            timeoutMs: options.timeoutMs ?? 30_000,
+            maxNetworkRetries: options.maxNetworkRetries ?? 2,
+            ...(options.apiVersion === undefined
+                ? {}
+                : { apiVersion: options.apiVersion }),
+            ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+        });
+        this.routes = new BridgeRoutesResource(transport);
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAuBpD,MAAM,OAAO,oBAAoB;IACF;IAA7B,YAA6B,SAAwB;QAAxB,cAAS,GAAT,SAAS,CAAe;IAAG,CAAC;IAEzD,OAAO,CAAC,UAA0B,EAAE;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB;YAC/B,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,YAAY;IACd,MAAM,CAAuB;IAEtC,YAAY,OAA4B;QACtC,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChE,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACvC,MAAM,IAAI,2BAA2B,CACnC,wCAAwC,EACxC,YAAY,CACb,CAAC;QACJ,CAAC;QACD,mBAAmB,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC;YAClC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,2BAA2B;YACvD,aAAa,EAAE,UAAU,UAAU,CAAC,KAAK,EAAE;YAC3C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;YACtC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,CAAC;YACjD,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS;gBAClC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;YACvC,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;SACjE,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/calls/api.d.ts

@@ -0,0 +1,109 @@
+import { CallsApiError } from "./errors.js";
+import type { CallReport } from "./diagnostics.js";
+import { type Participant } from "./protocol.js";
+import { type CallsToken, type CallsTokenProvider, type CallsTokenRequest } from "./token.js";
+export { CallClaimedError, CallsApiError, CallsDisabledError, } from "./errors.js";
+/** Minimal request seam so tests and other transports can stand in for fetch. */
+export type FetchLike = (input: string, init: RequestInit) => Promise<Response>;
+export interface AcceptCallOptions {
+    /**
+     * Claim the call. Other participants then receive `call_claimed` for
+     * accept and media, and their open connections close. Default `false`:
+     * others keep ringing and can join.
+     */
+    readonly exclusive?: boolean;
+    readonly video?: boolean;
+    /** Participant name for organization API keys and project tokens. */
+    readonly participant?: string;
+}
+export interface AcceptCallResult {
+    /** True once the call is answered (by this or an earlier accept). */
+    readonly answered: boolean;
+    /** Participant reference that answered the call first. */
+    readonly answeredBy: string;
+    /** True when `answeredBy` claimed the call. */
+    readonly exclusive: boolean;
+}
+export interface PlaceCallRequest {
+    /** Source session. Sent for server credentials; client tokens are bound to one. */
+    readonly session: string;
+    readonly to: string;
+    readonly video: boolean;
+    /** Claim the call for the placing participant. Default `false`. */
+    readonly exclusive?: boolean;
+    /** Participant name for organization API keys and project tokens. */
+    readonly participant?: string;
+    readonly idempotencyKey: string;
+}
+/**
+ * The platform operations the client needs, as one swappable seam — tests fake
+ * it and the browser package backs it with its client-token transport.
+ */
+export interface CallsApi {
+    /** Credential for socket authentication frames. */
+    token(request?: CallsTokenRequest): Promise<CallsToken>;
+    /** Absolute `ws(s)://` URL for a socket path on the API host. */
+    socketUrl(path: string): string;
+    /** Start an outbound call; resolves the platform call id. */
+    place(input: PlaceCallRequest, signal?: AbortSignal): Promise<{
+        readonly callId: string;
+    }>;
+    /**
+     * Answer a ringing call, or join an answered one that nobody claimed.
+     * Rejects with {@link CallClaimedError} when another participant claimed it.
+     */
+    accept(callId: string, options: AcceptCallOptions, signal?: AbortSignal): Promise<AcceptCallResult>;
+    /**
+     * Decline a ringing call. This ends the call for everyone. `participant`
+     * applies to server credentials only.
+     */
+    reject(callId: string, signal?: AbortSignal, participant?: string): Promise<void>;
+    /** Close one media connection. The call continues. */
+    leave(callId: string, connectionId: string, signal?: AbortSignal, participant?: string): Promise<void>;
+    /** End the call for every participant. */
+    end(callId: string, signal?: AbortSignal): Promise<void>;
+    /**
+     * Send a diagnostics report for one connection. Optional: without it the
+     * client sends none. `participant` is dropped for client tokens.
+     */
+    report?(callId: string, report: CallReport, signal?: AbortSignal): Promise<void>;
+    addParticipant(callId: string, to: string, signal?: AbortSignal): Promise<Participant>;
+}
+export interface HttpCallsApiOptions {
+    /**
+     * Credential: a server API key or project token string, or a provider that
+     * returns a client token minted by your server.
+     */
+    readonly token?: string | CallsTokenProvider;
+    /** Server credential string; same as passing it as `token`. */
+    readonly apiKey?: string;
+    /** Defaults to `https://api.polymorfa.com`. */
+    readonly baseUrl?: string;
+    readonly fetch?: FetchLike;
+    /** Socket host; defaults to `ws(s)://` on the API host. */
+    readonly socketBaseUrl?: string;
+    readonly now?: () => number;
+}
+/** Validate an accept response body. @internal */
+export declare function parseAcceptResult(data: unknown): AcceptCallResult;
+/** Validate an add-participant response body. @internal */
+export declare function parseParticipant(data: unknown): Participant;
+/** Map an HTTP failure to the Calls error vocabulary. @internal */
+export declare function callsHttpError(status: number, code: string | undefined, message: string): CallsApiError;
+/** Credential-bearing implementation over the platform's REST routes. */
+export declare class HttpCallsApi implements CallsApi {
+    #private;
+    constructor(options: HttpCallsApiOptions);
+    token(request?: CallsTokenRequest): Promise<CallsToken>;
+    socketUrl(path: string): string;
+    place(input: PlaceCallRequest, signal?: AbortSignal): Promise<{
+        readonly callId: string;
+    }>;
+    accept(callId: string, options: AcceptCallOptions, signal?: AbortSignal): Promise<AcceptCallResult>;
+    reject(callId: string, signal?: AbortSignal, participant?: string): Promise<void>;
+    leave(callId: string, connectionId: string, signal?: AbortSignal, participant?: string): Promise<void>;
+    report(callId: string, report: CallReport, signal?: AbortSignal): Promise<void>;
+    end(callId: string, signal?: AbortSignal): Promise<void>;
+    addParticipant(callId: string, to: string, signal?: AbortSignal): Promise<Participant>;
+}
+//# sourceMappingURL=api.d.ts.map

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

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

package/dist/calls/api.js

@@ -0,0 +1,179 @@
+import { CallClaimedError, CallsApiError, CallsDisabledError, } from "./errors.js";
+import { isParticipant } from "./protocol.js";
+import { CallsTokenSource, isClientToken, } from "./token.js";
+export { CallClaimedError, CallsApiError, CallsDisabledError, } from "./errors.js";
+/** Validate an accept response body. @internal */
+export function parseAcceptResult(data) {
+    if (data !== null &&
+        typeof data === "object" &&
+        typeof data["answered"] === "boolean" &&
+        typeof data["answeredBy"] === "string" &&
+        typeof data["exclusive"] === "boolean") {
+        const d = data;
+        return {
+            answered: d["answered"],
+            answeredBy: d["answeredBy"],
+            exclusive: d["exclusive"],
+        };
+    }
+    throw malformed("accept");
+}
+/** Validate an add-participant response body. @internal */
+export function parseParticipant(data) {
+    if (isParticipant(data))
+        return data;
+    throw malformed("participant");
+}
+/** Map an HTTP failure to the Calls error vocabulary. @internal */
+export function callsHttpError(status, code, message) {
+    if (status === 409 && code === "call_claimed")
+        return new CallClaimedError(message);
+    if (status === 403 && code === "calls_disabled")
+        return new CallsDisabledError(message);
+    return new CallsApiError(status, code ?? `http_${status}`, message);
+}
+function malformed(operation) {
+    return new CallsApiError(200, "malformed_response", `${operation}: response body did not carry the expected fields`);
+}
+/** Credential-bearing implementation over the platform's REST routes. */
+export class HttpCallsApi {
+    #tokens;
+    #baseUrl;
+    #fetch;
+    #socketBaseUrl;
+    constructor(options) {
+        const credential = options.token ?? options.apiKey;
+        if (credential === undefined)
+            throw new CallsApiError(0, "missing_credential", "HttpCallsApi needs a `token`.");
+        this.#tokens = new CallsTokenSource(credential, {
+            ...(options.now === undefined ? {} : { now: options.now }),
+        });
+        this.#baseUrl = (options.baseUrl ?? "https://api.polymorfa.com").replace(/\/+$/, "");
+        this.#fetch =
+            options.fetch ?? ((input, init) => globalThis.fetch(input, init));
+        this.#socketBaseUrl = (options.socketBaseUrl ?? this.#baseUrl)
+            .replace(/^http:/, "ws:")
+            .replace(/^https:/, "wss:")
+            .replace(/\/+$/, "");
+    }
+    token(request = {}) {
+        return this.#tokens.get(request);
+    }
+    socketUrl(path) {
+        return `${this.#socketBaseUrl}${path.startsWith("/") ? "" : "/"}${path}`;
+    }
+    async place(input, signal) {
+        const data = await this.#request("POST", "/messaging/voip/calls", async (token) => ({
+            ...(isClientToken(token) ? {} : { session: input.session }),
+            to: input.to,
+            video: input.video,
+            ...(input.exclusive === undefined
+                ? {}
+                : { exclusive: input.exclusive }),
+            ...(input.participant === undefined || isClientToken(token)
+                ? {}
+                : { participant: input.participant }),
+        }), signal, { "idempotency-key": input.idempotencyKey });
+        const callId = data?.callId;
+        if (typeof callId !== "string" || callId.length === 0)
+            throw malformed("place");
+        return { callId };
+    }
+    async accept(callId, options, signal) {
+        const data = await this.#request("POST", callPath(callId, "/accept"), async (token) => ({
+            exclusive: options.exclusive === true,
+            ...(options.video === undefined ? {} : { video: options.video }),
+            ...(options.participant === undefined || isClientToken(token)
+                ? {}
+                : { participant: options.participant }),
+        }), signal);
+        return parseAcceptResult(data);
+    }
+    async reject(callId, signal, participant) {
+        await this.#request("POST", callPath(callId, "/reject"), participant === undefined
+            ? undefined
+            : async (token) => (isClientToken(token) ? {} : { participant }), signal);
+    }
+    async leave(callId, connectionId, signal, participant) {
+        await this.#request("POST", callPath(callId, "/leave"), async (token) => ({
+            connectionId,
+            ...(participant === undefined || isClientToken(token)
+                ? {}
+                : { participant }),
+        }), signal);
+    }
+    async report(callId, report, signal) {
+        await this.#request("POST", callPath(callId, "/reports"), async (token) => {
+            if (!isClientToken(token) || report.participant === undefined)
+                return report;
+            // A client token acts as its own participant and must not name one.
+            const body = { ...report };
+            delete body["participant"];
+            return body;
+        }, signal);
+    }
+    async end(callId, signal) {
+        await this.#request("DELETE", callPath(callId), undefined, signal, {
+            "idempotency-key": `voip-end:${callId}`,
+        });
+    }
+    async addParticipant(callId, to, signal) {
+        const data = await this.#request("POST", callPath(callId, "/participants"), async () => ({ to }), signal);
+        return parseParticipant(data);
+    }
+    async #request(method, path, body, signal, headers = {}) {
+        const token = await this.#tokens.get(signal === undefined ? {} : { signal });
+        const payload = body === undefined ? undefined : await body(token.value);
+        const init = {
+            method,
+            headers: {
+                authorization: `Bearer ${token.value}`,
+                accept: "application/json",
+                ...(payload === undefined
+                    ? {}
+                    : { "content-type": "application/json" }),
+                ...headers,
+            },
+            ...(payload === undefined ? {} : { body: JSON.stringify(payload) }),
+            ...(signal === undefined ? {} : { signal }),
+        };
+        const response = await this.#fetch(`${this.#baseUrl}${path}`, init);
+        const text = await response.text();
+        let parsed = undefined;
+        if (text.length > 0) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                parsed = undefined;
+            }
+        }
+        if (!response.ok) {
+            if (response.status === 401)
+                this.#tokens.invalidate();
+            const record = (parsed ?? {});
+            const error = record["error"];
+            const code = error !== null && typeof error === "object"
+                ? error["code"]
+                : record["code"];
+            const message = error !== null && typeof error === "object"
+                ? error["message"]
+                : typeof error === "string"
+                    ? error
+                    : record["message"];
+            throw callsHttpError(response.status, typeof code === "string" ? code : undefined, typeof message === "string"
+                ? message
+                : `${method} ${path} failed with ${response.status}`);
+        }
+        const envelope = parsed;
+        return envelope !== null &&
+            typeof envelope === "object" &&
+            "data" in envelope
+            ? envelope.data
+            : parsed;
+    }
+}
+function callPath(callId, suffix = "") {
+    return `/messaging/voip/calls/${encodeURIComponent(callId)}${suffix}`;
+}
+//# sourceMappingURL=api.js.map

package/dist/calls/api.js.map

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