@polymorfa/browser 0.1.0-dev.20260922094209

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Polymorfa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,248 @@
+# `@polymorfa/browser`
+
+Framework-neutral browser transport and product controllers for Polymorfa.
+
+## Drop-in client
+
+`PolymorfaClient` (`createPolymorfaClient({ tokenEndpoint })`) fetches client
+tokens from your `createPolymorfaHandler` route, refreshes them before expiry
+with backoff, and reports the grant through `can(permission)`. It never sends
+or chooses permissions. `InboxController` with `createHandlerInboxSource()`
+drives an inbox from the handler's `history` and `events` routes, and
+`connectWhatsApp(client)` asks the handler for a QuickLink and opens the
+hosted URL. The React and Web Component drop-ins are built on these.
+
+`@polymorfa/browser` depends on `@polymorfa/sdk` for the Calls client
+(`@polymorfa/sdk/calls`). It imports nothing else from that package, so no
+server code reaches the browser, and call errors such as `CallsDisabledError`
+are the classes exported from `@polymorfa/sdk/calls`.
+
+This package accepts only short-lived `pmfa_ct_` client tokens obtained from an application callback. It never accepts or stores server API keys.
+
+```ts
+import {
+  BrowserMessagingClient,
+  createClientTokenProvider,
+} from "@polymorfa/browser";
+
+const messaging = new BrowserMessagingClient({
+  session: "support",
+  getClientToken: createClientTokenProvider(),
+});
+
+await messaging.messages.send({
+  conversation: { phoneNumber: "+15551234567" },
+  content: { text: "Hello" },
+});
+```
+
+Requests expose status, request ID, response headers, and attempt count. Safe reads retry transient failures; mutations retry only when supplied an idempotency key. Caller cancellation and timeouts use distinct exported error types.
+
+Product controllers use immutable snapshots and `subscribe()`/`getSnapshot()` so Web Components and framework bindings share the same behavior.
+
+`BrowserMessagingClient` binds one session and exposes only the exact
+client-token allowlist: message actions, presence reads/subscriptions, contact
+reads, and permitted widget pairing actions. Session start and status require a server
+Platform credential; use QuickLink for onboarding. The browser widget start/status
+helpers are removed in this breaking contract revision. Conversation history,
+template management and media upload remain application-owned server adapters.
+`createBrowserCalls` supplies client-token call lifecycle and controls.
+
+`createBrowserComposerActions` connects a `MessageComposerController` to the
+message resource for text and reply sends. Supply an upload adapter and a
+`createMessage` mapping for attachments; client tokens cannot call the media
+routes directly.
+
+## Voice notes
+
+`VoiceNoteRecorder` records from the microphone with `getUserMedia` and
+`MediaRecorder`. Its snapshot has `status` (`idle`, `requesting`,
+`recording`, `stopping`, or `error`), `elapsed` milliseconds, an input
+`level` from 0 to 1, the container `mimeType`, and an `error` of
+`permission-denied`, `unavailable`, or `failed`.
+
+```ts
+import { VoiceNoteRecorder, localAttachmentFromFile } from "@polymorfa/browser";
+
+if (VoiceNoteRecorder.isSupported()) {
+  const recorder = new VoiceNoteRecorder();
+  await recorder.start();
+  // later
+  const file = await recorder.stop(); // File or undefined
+  if (file) await composer.addAttachment(localAttachmentFromFile(file));
+}
+```
+
+`stop()` resolves with an `audio/webm`, `audio/ogg`, or `audio/mp4` file named
+`voice-note-<time>.webm` (`.ogg` or `.m4a`); the time is ISO 8601 with `:` and `.`
+replaced by `-`. `cancel()` discards the recording. The microphone tracks
+stop when recording ends, when a pending permission request is cancelled,
+and on `dispose()`.
+
+## Calls
+
+`createBrowserCalls` is the browser calling component: incoming calls,
+placement, answer, join, leave and end, microphone, camera and device
+control, and per-participant video. Your server mints a short-lived client
+token with `POST /platform/client-tokens`, granting `voip_place`,
+`voip_answer`, and `voip_signal` and the destination and concurrency rules you
+need. That token is the only credential the component uses; it never appears
+in a URL.
+
+```ts
+import {
+  createBrowserCalls,
+  createClientTokenProvider,
+} from "@polymorfa/browser";
+
+const calls = createBrowserCalls({
+  session: "support",
+  getClientToken: createClientTokenProvider(),
+  onError: (error) => {
+    // "unauthorized": the platform stopped accepting the token.
+  },
+});
+await calls.connect();
+await calls.controller.place("+15550100");
+// When the application releases the widget:
+await calls.dispose();
+```
+
+Pass `calls.controller` to React's `CallSurface` or the `pmfa-call` element.
+`controller.call` exposes the shared `Call`, including its state, duration,
+end reason, claim state and `addParticipant()` method. Direct placement
+supports linked WhatsApp devices.
+
+### Tokens
+
+Return `{ value, audience: "browser", expiresAt }` from `getClientToken` so
+the SDK can replace the token before it expires without interrupting calls.
+When a token expires or is revoked, `onError` receives
+`code: "unauthorized"` and the next reconnect asks `getClientToken` for a new
+token. REST requests refresh a cached token before it expires; a provider
+that returns an expired token fails with `expired_client_token`.
+
+### Answering, joining, and leaving
+
+Incoming calls ring until a participant answers or declines them.
+`snapshot.invitations` lists every ringing call; several can ring at once and
+the controller never declines one for you. The first invitation is displayed;
+`controller.select(callId)` shows another while no call is active, and
+`controller.dismiss(callId?)` hides one locally without declining it.
+
+- `controller.answer({ exclusive, video, callId })` accepts the call and
+  connects microphone, camera and speaker. `exclusive` defaults to `false`, which leaves other
+  participants ringing so they can join. `exclusive: true` claims the call.
+- `controller.join({ video, callId })` joins a call another participant
+  answered without a claim (`snapshot.canJoin`).
+- `snapshot.claimedByOther` is `true` when another participant claimed the
+  call. `answer()` and `join()` then reject with `CallClaimedError`, and
+  `reject()` is refused: declining would end the claimer's call.
+- While calling is turned off for the number, `place()`, `answer()` and
+  `join()` reject with `CallsDisabledError` from `@polymorfa/sdk/calls`.
+- While an answer or join is in flight, `snapshot.answering` is `true` and
+  `answer()`, `join()`, `reject()` and `place()` are refused. `select()` and
+  `dismiss()` still work: the answered call is displayed once it is accepted,
+  even if you selected another invitation. If you dismissed it, the controller
+  leaves it (or ends it when the answer claimed it) instead of showing it.
+  Only that call ending cancels the answer; `end()` for another displayed
+  call is refused meanwhile.
+- If the platform refuses an answer, the call stays displayed as `incoming`
+  with `snapshot.error` (`answer_failed` or `join_failed`), so it can be
+  retried or declined. If media fails after the call was answered, the
+  failed call is published as `error` (or `ended` for a terminal offer)
+  and the next waiting invitation is displayed. The failure stays in
+  `snapshot.error`; `error.callId` names the call it belongs to.
+- `controller.reject()` declines a ringing call and ends it for everyone.
+- `controller.leave()` closes this browser's connection; the call continues.
+  On a call this browser placed that has not connected, it ends the call
+  instead, so the callee stops ringing.
+- `controller.end()` (and `hangup()`) ends the call for every participant.
+- Disposing the controller leaves a joined call. It ends only a call this
+  browser placed that is still ringing.
+
+After a call ends, the next waiting invitation is displayed.
+
+### Media
+
+- `controller.localStream` is your microphone and camera.
+- `controller.remoteStream` is the merged call audio; play it through one
+  element.
+- `controller.remoteVideos` holds one entry per remote participant who sends
+  video: a `MediaStream`, a stable `key`, a display `label`, and the
+  `participant` or the other connection's `connectionId` and
+  `connectionParticipant`. `snapshot.remoteVideos` carries the same entries
+  without streams, so a render can react to changes. Videos are separate
+  streams; nothing is composed.
+- `controller.setMuted()`, `enableVideo()`, `switchDevice()`,
+  `setPreferredDevices()` and `refreshDevices()` control capture and playback.
+- `snapshot.participants` lists the call's WhatsApp participants.
+- A dropped connection shows `reconnecting` and recovers or ends as
+  `connection_failed` after a bounded window.
+
+Disposal releases tracks and connections.
+
+### Diagnostics
+
+While a call's media is open, the controller sends call diagnostics for this
+browser's connection to `POST /messaging/voip/calls/{id}/reports`, where
+they appear with the call in the Console:
+
+- Every 15 seconds, and once when the connection closes: round-trip time,
+  audio jitter, packets lost and received, the audio and video codecs, the
+  ICE candidate type (`relay` means a TURN relay), and how many times the
+  connection reconnected. Figures come from `RTCPeerConnection.getStats()`.
+- When something fails: an error code (`media_permission_denied`,
+  `device_not_found`, `device_in_use`, `ice_failed`, `negotiation_failed`,
+  `media_timeout`, `reconnect_exhausted` or `unsupported_browser`).
+
+Each report names the connection and `@polymorfa/browser` with its version.
+Reports contain no phone numbers, names, device labels, IP addresses, audio or
+video. They are best-effort: a failed report is not retried, a refused one
+(other than rate limiting) stops reporting for the connection, and nothing
+about reporting affects the call. The client token needs the `voip_signal`
+action. Turn reporting off with `createBrowserCalls({ diagnostics: false })`.
+
+If a reject or hangup request fails, the call stays active and its controls remain
+available for retry. The UI shows a localized failure message and keeps existing
+media connected until the call ends. `snapshot.error` clears when ending succeeds
+or when an incoming call is successfully answered after a failed reject.
+
+## Template builder
+
+The builder uses the canonical `TemplateDefinition` contract: standard,
+carousel, authentication, and limited-time-offer templates with structured
+headers, buttons, variables, and previews. Saving and Meta submission are
+separate controller actions.
+
+```ts
+import {
+  TemplateBuilderController,
+  createSameOriginTemplateBuilderTransport,
+} from "@polymorfa/browser";
+
+const templates = new TemplateBuilderController(
+  createSameOriginTemplateBuilderTransport({
+    path: "/api/polymorfa/templates",
+  }),
+);
+
+templates.create({
+  name: "order_ready",
+  definition: {
+    version: 1,
+    kind: "standard",
+    category: "UTILITY",
+    language: "en_US",
+    body: "Hello {{name}}",
+    variables: [{ name: "name", type: "text", example: "Ada" }],
+  },
+});
+
+await templates.save();
+await templates.refreshPreview();
+```
+
+The same-origin transport sends application actions with browser cookies. It
+does not accept a server credential, project slug, or Cloud API session. The
+application route resolves those values after authorizing the request.

package/dist/calls/api.d.ts

@@ -0,0 +1,22 @@
+import { type AcceptCallOptions, type AcceptCallResult, type CallReport, type CallsApi, type CallsToken, type CallsTokenRequest, type Participant, type PlaceCallRequest } from "@polymorfa/sdk/calls/internal";
+import { BrowserTransport } from "../transport.js";
+/**
+ * Client-token call controls. The token determines the session and the
+ * participant, so `session` and `participant` are never sent.
+ */
+export declare class BrowserCallsApi implements CallsApi {
+    #private;
+    constructor(transport: BrowserTransport);
+    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): Promise<void>;
+    leave(callId: string, connectionId: string, signal?: AbortSignal): Promise<void>;
+    end(callId: string, signal?: AbortSignal): Promise<void>;
+    report(callId: string, report: CallReport, 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":["../../src/calls/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,QAAQ;;gBAIlC,SAAS,EAAE,gBAAgB;IAKvC,KAAK,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMzB,KAAK,CACT,KAAK,EAAE,gBAAgB,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAyBjC,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC;IA4B5B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,KAAK,CACH,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAIhB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAIV,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC;CAexB"}

package/dist/calls/api.js

@@ -0,0 +1,104 @@
+import { CallsApiError, isParticipant, } from "@polymorfa/sdk/calls/internal";
+import { BrowserTransport } from "../transport.js";
+import { CallsSignalingClient, claimedError } from "./signaling.js";
+/**
+ * Client-token call controls. The token determines the session and the
+ * participant, so `session` and `participant` are never sent.
+ */
+export class BrowserCallsApi {
+    #transport;
+    #signaling;
+    constructor(transport) {
+        this.#transport = transport;
+        this.#signaling = new CallsSignalingClient(transport);
+    }
+    token(request = {}) {
+        return this.#signaling.token(request);
+    }
+    socketUrl(path) {
+        const url = this.#signaling.socketUrl(path);
+        if (!/^wss?:\/\//.test(url))
+            throw malformed("socket URL");
+        return url;
+    }
+    async place(input, signal) {
+        const response = await this.#transport
+            .request({
+            method: "POST",
+            path: "/messaging/voip/calls",
+            body: {
+                to: input.to,
+                video: input.video,
+                ...(input.exclusive === undefined
+                    ? {}
+                    : { exclusive: input.exclusive }),
+            },
+            idempotencyKey: input.idempotencyKey,
+            ...(signal === undefined ? {} : { signal }),
+        })
+            .catch((cause) => {
+            throw claimedError(cause);
+        });
+        const callId = response.data?.data?.callId;
+        if (typeof callId !== "string" || !callId)
+            throw malformed("call id");
+        return { callId };
+    }
+    async accept(callId, options, signal) {
+        const response = await this.#transport
+            .request({
+            method: "POST",
+            path: `/messaging/voip/calls/${encodeURIComponent(callId)}/accept`,
+            body: {
+                exclusive: options.exclusive === true,
+                ...(options.video === undefined ? {} : { video: options.video }),
+            },
+            ...(signal === undefined ? {} : { signal }),
+        })
+            .catch((cause) => {
+            throw claimedError(cause);
+        });
+        const data = response.data?.data;
+        if (typeof data?.["answered"] !== "boolean" ||
+            typeof data["answeredBy"] !== "string" ||
+            typeof data["exclusive"] !== "boolean")
+            throw malformed("accept result");
+        return {
+            answered: data["answered"],
+            answeredBy: data["answeredBy"],
+            exclusive: data["exclusive"],
+        };
+    }
+    reject(callId, signal) {
+        return this.#signaling.reject(callId, signal);
+    }
+    leave(callId, connectionId, signal) {
+        return this.#signaling.leave(callId, connectionId, signal);
+    }
+    end(callId, signal) {
+        return this.#signaling.end(callId, signal);
+    }
+    report(callId, report, signal) {
+        return this.#signaling.report(callId, report, signal);
+    }
+    async addParticipant(callId, to, signal) {
+        const response = await this.#transport
+            .request({
+            method: "POST",
+            path: `/messaging/voip/calls/${encodeURIComponent(callId)}/participants`,
+            body: { to },
+            ...(signal === undefined ? {} : { signal }),
+        })
+            .catch((cause) => {
+            throw claimedError(cause);
+        });
+        const p = response.data?.data;
+        if (!isParticipant(p))
+            throw malformed("participant");
+        return p;
+    }
+}
+function malformed(field) {
+    return new CallsApiError(200, "malformed_response", `Calls response has an invalid ${field}.`);
+}
+//# sourceMappingURL=api.js.map

package/dist/calls/api.js.map

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

package/dist/calls/backend.d.ts

@@ -0,0 +1,85 @@
+import type { CallEndReason, CallLifecycleEvent, CallsBackend, IncomingCall, PlaceCallInput } from "./controller.js";
+import type { CallsSignaling } from "./signaling.js";
+/**
+ * The parts of the `call.received` webhook payload the browser needs. The
+ * caller is a public identity reference; a bare string is accepted for hand-built
+ * payloads.
+ */
+export interface CallReceivedWebhookPayload {
+    readonly callId: string;
+    readonly from: string | {
+        readonly id?: string;
+        readonly phoneNumber?: string;
+        readonly bsuid?: string;
+        readonly username?: string;
+    };
+    readonly hasVideo?: boolean;
+    readonly capabilities?: {
+        readonly video?: boolean;
+        readonly invite?: boolean;
+    };
+}
+/**
+ * Turn a `call.received` webhook payload into an {@link IncomingCall}. The
+ * application receives the webhook on its server, relays it to the browser
+ * over its own realtime channel, and hands it to {@link IncomingCallRelay}.
+ * The caller is shown by phone number when present, otherwise by public ID.
+ */
+export declare function incomingCallFromWebhook(payload: CallReceivedWebhookPayload): IncomingCall;
+/**
+ * Application-fed source of inbound call notifications for deployments that
+ * relay `call.received`, `call.accepted`, and `call.ended` webhook events over
+ * their own realtime channel. {@link CallsSocket} is the push alternative:
+ * it subscribes to the same lifecycle stream directly from the API.
+ */
+export declare class IncomingCallRelay {
+    #private;
+    /** Announce an inbound call; the controller moves to `incoming`. */
+    receive(call: IncomingCall): void;
+    /**
+     * Announce that a call was answered (from `call.accepted`). Pass its
+     * `answeredBy` and `exclusive` so other browsers stop ringing for a claimed
+     * call or offer Join for a shared one.
+     */
+    accepted(callId: string, claim?: {
+        readonly answeredBy?: string;
+        readonly exclusive?: boolean;
+        /** The webhook's `capabilities`, when present. */
+        readonly capabilities?: {
+            readonly video?: boolean;
+            readonly invite?: boolean;
+        };
+    }): void;
+    /** Announce that the remote side ended a call (from `call.ended`). */
+    ended(callId: string, reason?: CallEndReason): void;
+    subscribe(listener: (event: CallLifecycleEvent) => void): () => void;
+}
+export interface SignalingCallsBackendOptions {
+    /** REST signaling client for the `/messaging/voip/calls/{id}` paths. */
+    readonly signaling: CallsSignaling;
+    /** Inbound call notifications: a {@link CallsSocket} or an application-fed {@link IncomingCallRelay}. */
+    readonly incoming: Pick<IncomingCallRelay, "subscribe">;
+    /**
+     * Places an outbound call through the application's own server and resolves
+     * the call id the platform assigned it.
+     *
+     * This custom backend delegates placement to the supplied hook. Use
+     * createBrowserCalls for built-in client-token placement. Without a hook,
+     * outbound calling reports place_failed instead of inventing a call id.
+     */
+    readonly place?: (input: PlaceCallInput, signal: AbortSignal) => Promise<string | {
+        readonly callId: string;
+    }>;
+}
+/**
+ * A {@link CallsBackend} over the REST signaling surface alone. Answering an
+ * inbound call accepts it (claiming it only when the caller asks for
+ * `exclusive`), then the media factory offers SDP for its connection. Reject
+ * declines a ringing call and hang-up ends the call for everyone; leaving
+ * closes only this browser's connection. Everything runs on the client token.
+ *
+ * Supply place for custom outbound placement. createBrowserCalls provides
+ * direct client-token placement through the shared Calls client.
+ */
+export declare function createSignalingCallsBackend(options: SignalingCallsBackendOptions): CallsBackend;
+//# sourceMappingURL=backend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/calls/backend.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EACT,MAAM,GACN;QACE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACN,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,0BAA0B,GAClC,YAAY,CAad;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;;IAG5B,oEAAoE;IACpE,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIjC;;;;OAIG;IACH,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,KAAK,GAAE;QACL,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAC7B,kDAAkD;QAClD,QAAQ,CAAC,YAAY,CAAC,EAAE;YACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;SAC3B,CAAC;KACE,GACL,IAAI;IAyBP,sEAAsE;IACtE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI;IAQnD,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;CAQrE;AAED,MAAM,WAAW,4BAA4B;IAC3C,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,yGAAyG;IACzG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;IACxD;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CACf,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,MAAM,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,YAAY,CAqDd"}

package/dist/calls/backend.js

@@ -0,0 +1,141 @@
+import { capabilitiesFrom, } from "@polymorfa/sdk/calls/internal";
+/**
+ * Turn a `call.received` webhook payload into an {@link IncomingCall}. The
+ * application receives the webhook on its server, relays it to the browser
+ * over its own realtime channel, and hands it to {@link IncomingCallRelay}.
+ * The caller is shown by phone number when present, otherwise by public ID.
+ */
+export function incomingCallFromWebhook(payload) {
+    // Empty strings fall through like absent fields, matching `peerFrom` on the
+    // socket path — the two inbound routes must agree on the same payload.
+    const from = typeof payload.from === "string"
+        ? payload.from
+        : (firstNonEmpty(payload.from.phoneNumber, payload.from.id) ?? "");
+    return {
+        callId: payload.callId,
+        from,
+        video: payload.hasVideo === true,
+        capabilities: capabilitiesFrom(payload.capabilities),
+    };
+}
+/**
+ * Application-fed source of inbound call notifications for deployments that
+ * relay `call.received`, `call.accepted`, and `call.ended` webhook events over
+ * their own realtime channel. {@link CallsSocket} is the push alternative:
+ * it subscribes to the same lifecycle stream directly from the API.
+ */
+export class IncomingCallRelay {
+    #listeners = new Set();
+    /** Announce an inbound call; the controller moves to `incoming`. */
+    receive(call) {
+        this.#emit({ type: "incomingCall", call });
+    }
+    /**
+     * Announce that a call was answered (from `call.accepted`). Pass its
+     * `answeredBy` and `exclusive` so other browsers stop ringing for a claimed
+     * call or offer Join for a shared one.
+     */
+    accepted(callId, claim = {}) {
+        this.#emit({
+            type: "accepted",
+            callId,
+            ...(claim.answeredBy === undefined
+                ? {}
+                : { answeredBy: claim.answeredBy }),
+            exclusive: claim.exclusive === true,
+            // Reported fields only; the controller merges them with the call's
+            // current capabilities.
+            ...(claim.capabilities === undefined
+                ? {}
+                : {
+                    capabilities: {
+                        ...(typeof claim.capabilities.video === "boolean"
+                            ? { video: claim.capabilities.video }
+                            : {}),
+                        ...(typeof claim.capabilities.invite === "boolean"
+                            ? { invite: claim.capabilities.invite }
+                            : {}),
+                    },
+                }),
+        });
+    }
+    /** Announce that the remote side ended a call (from `call.ended`). */
+    ended(callId, reason) {
+        this.#emit(reason === undefined
+            ? { type: "ended", callId }
+            : { type: "ended", callId, reason });
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    #emit(event) {
+        for (const listener of [...this.#listeners])
+            listener(event);
+    }
+}
+/**
+ * A {@link CallsBackend} over the REST signaling surface alone. Answering an
+ * inbound call accepts it (claiming it only when the caller asks for
+ * `exclusive`), then the media factory offers SDP for its connection. Reject
+ * declines a ringing call and hang-up ends the call for everyone; leaving
+ * closes only this browser's connection. Everything runs on the client token.
+ *
+ * Supply place for custom outbound placement. createBrowserCalls provides
+ * direct client-token placement through the shared Calls client.
+ */
+export function createSignalingCallsBackend(options) {
+    return {
+        subscribe: (listener) => options.incoming.subscribe(listener),
+        place: async (input, signal) => {
+            throwIfAborted(signal);
+            const placeWith = options.place;
+            if (placeWith === undefined)
+                throw new Error("This backend needs a `place` hook. Use createBrowserCalls for direct client-token placement.");
+            const placed = await placeWith(input, signal);
+            throwIfAborted(signal);
+            // `place` is application code behind a public interface: a response that
+            // did not match its declared shape must not reach signaling as an
+            // `undefined` call id.
+            const callId = typeof placed === "string"
+                ? placed
+                : placed?.callId;
+            if (typeof callId !== "string" || callId === "")
+                throw new Error("`place` resolved without a call id.");
+            return { callId };
+        },
+        answer: async (callId, signal, input) => {
+            throwIfAborted(signal);
+            const accept = options.signaling.accept;
+            if (accept === undefined)
+                throw new Error("This signaling client cannot answer calls.");
+            return accept.call(options.signaling, callId, {
+                exclusive: input?.exclusive === true,
+                ...(input === undefined ? {} : { video: input.video }),
+            }, signal);
+        },
+        reject: async (callId, signal) => {
+            const reject = options.signaling.reject;
+            if (reject === undefined)
+                throw new Error("This signaling client cannot decline calls.");
+            await reject.call(options.signaling, callId, signal);
+        },
+        hangup: (callId, signal) => options.signaling.end(callId, signal),
+        ...(options.signaling.report === undefined
+            ? {}
+            : {
+                report: (callId, report) => options.signaling.report(callId, report),
+            }),
+    };
+}
+function firstNonEmpty(...values) {
+    for (const value of values)
+        if (typeof value === "string" && value.length > 0)
+            return value;
+    return undefined;
+}
+function throwIfAborted(signal) {
+    if (signal.aborted)
+        throw signal.reason;
+}
+//# sourceMappingURL=backend.js.map

package/dist/calls/backend.js.map

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