@polymorfa/browser 0.1.0-dev.20260922094209

package/dist/calls/client.d.ts

@@ -0,0 +1,56 @@
+import { type CallsClientOptions } from "@polymorfa/sdk/calls/internal";
+import { type BrowserTransportOptions } from "../transport.js";
+import { CallsController, type CallsControllerOptions } from "./controller.js";
+import { type CallMediaFactory, type WebRtcMediaFactoryOptions } from "./media.js";
+export interface BrowserCallsOptions extends BrowserTransportOptions {
+    /** Local call identity. Requests use the client token's bound session. */
+    readonly session: string;
+    readonly WebSocket?: CallsClientOptions["WebSocket"];
+    readonly controller?: CallsControllerOptions;
+    /**
+     * Send call diagnostics (default `true`): connection quality figures every
+     * 15 seconds and when a connection closes, and an error code when media
+     * fails. No personal data is sent. Same as `controller.diagnostics`.
+     */
+    readonly diagnostics?: boolean;
+    /**
+     * Failures that do not belong to one call. `code: "unauthorized"` means the
+     * platform stopped accepting the client token; the next attempt asks
+     * `getClientToken` for a new one.
+     */
+    readonly onError?: (error: {
+        code: string;
+        message: string;
+    }) => void;
+}
+/**
+ * Media overrides used by Polymorfa's own tests and embedded runtimes.
+ * @internal
+ */
+export interface InternalBrowserCallsOptions extends BrowserCallsOptions {
+    readonly media?: Omit<WebRtcMediaFactoryOptions, "signaling">;
+    readonly mediaFactory?: CallMediaFactory;
+}
+/** @internal */
+export declare function createInternalBrowserCalls(options: InternalBrowserCallsOptions): BrowserCalls;
+export interface BrowserCalls {
+    readonly controller: CallsController;
+    readonly connected: boolean;
+    /** Connect the authenticated lifecycle stream; rejects if the first attempt fails. */
+    connect(): Promise<void>;
+    /**
+     * Release the widget, media and lifecycle stream. Joined calls are left,
+     * not ended; a placed call that is still ringing is ended. Create a new
+     * instance to reconnect.
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * The browser calling component: incoming calls, placement, answer, join,
+ * leave and end, microphone, camera and device control, with a
+ * `CallsController` for the UI packages. The client token from
+ * `getClientToken` is the only credential. Incoming calls ring until the
+ * application answers, joins, or declines them.
+ */
+export declare function createBrowserCalls(publicOptions: BrowserCallsOptions): BrowserCalls;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/calls/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EAGf,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IAClE,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,sBAAsB,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACvE;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,WAAW,CAAC,CAAC;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC;CAC1C;AAED,gBAAgB;AAChB,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,YAAY,CAEd;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,sFAAsF;IACtF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,mBAAmB,GACjC,YAAY,CA0Pd"}

package/dist/calls/client.js

@@ -0,0 +1,260 @@
+import { CallsClient, } from "@polymorfa/sdk/calls/internal";
+import { BrowserTransport, } from "../transport.js";
+import { BrowserCallsApi } from "./api.js";
+import { CallsController, } from "./controller.js";
+import { WebRtcMediaFactory, } from "./media.js";
+import { CallsSignalingClient } from "./signaling.js";
+/** @internal */
+export function createInternalBrowserCalls(options) {
+    return createBrowserCalls(options);
+}
+/**
+ * The browser calling component: incoming calls, placement, answer, join,
+ * leave and end, microphone, camera and device control, with a
+ * `CallsController` for the UI packages. The client token from
+ * `getClientToken` is the only credential. Incoming calls ring until the
+ * application answers, joins, or declines them.
+ */
+export function createBrowserCalls(publicOptions) {
+    const options = publicOptions;
+    const transport = new BrowserTransport(options);
+    const api = new BrowserCallsApi(transport);
+    const clientOptions = {
+        session: options.session,
+        api,
+        mediaMode: "external",
+        ...(options.WebSocket === undefined
+            ? {}
+            : { WebSocket: options.WebSocket }),
+        ...(options.now === undefined ? {} : { now: options.now }),
+    };
+    const client = new CallsClient(clientOptions);
+    const listeners = new Set();
+    const emit = (event) => {
+        for (const listener of [...listeners])
+            listener(event);
+    };
+    let disposed = false;
+    let placing = false;
+    let disposal;
+    let connecting;
+    const requireCall = (id) => {
+        const call = client.getCall(id);
+        if (!call)
+            throw new Error("Call is no longer available.");
+        return call;
+    };
+    const backend = {
+        dispose: () => {
+            void dispose();
+        },
+        getCall: (id) => client.getCall(id),
+        connectionId: (id) => client.getCall(id)?.connectionId,
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        place: async (input, signal) => {
+            if (disposed || !client.connected)
+                throw new Error("Connect browser calls before placing a call.");
+            if (placing || client.calls.some((call) => call.state !== "incoming"))
+                throw new Error("Finish the active call before placing another.");
+            placing = true;
+            try {
+                const call = await client.place(input.to, {
+                    video: input.video,
+                    idempotencyKey: input.idempotencyKey,
+                    ...(input.exclusive === undefined
+                        ? {}
+                        : { exclusive: input.exclusive }),
+                    signal,
+                });
+                return { callId: call.id };
+            }
+            finally {
+                placing = false;
+            }
+        },
+        answer: async (id, signal, input) => {
+            signal.throwIfAborted();
+            const call = requireCall(id);
+            await call.answer({
+                exclusive: input?.exclusive === true,
+                ...(input === undefined ? {} : { video: input.video }),
+            });
+            return {
+                answered: true,
+                answeredBy: call.claim.answeredBy ?? "",
+                exclusive: call.claim.exclusive,
+            };
+        },
+        join: async (id, signal, input) => {
+            signal.throwIfAborted();
+            const call = requireCall(id);
+            await call.join({ video: input.video });
+            return {
+                answered: true,
+                answeredBy: call.claim.answeredBy ?? "",
+                exclusive: call.claim.exclusive,
+            };
+        },
+        reject: async (id, signal) => {
+            signal.throwIfAborted();
+            await requireCall(id).reject();
+        },
+        leave: async (id, _connectionId, signal) => {
+            signal.throwIfAborted();
+            // The call's own connection id is the one the media session used.
+            await requireCall(id).leave();
+        },
+        hangup: async (id, signal) => {
+            signal.throwIfAborted();
+            // Keep the model live if the request fails, so the widget can retry.
+            await requireCall(id).end();
+        },
+        report: (id, report) => api.report(id, report),
+    };
+    const media = options.mediaFactory ??
+        new WebRtcMediaFactory({
+            ...options.media,
+            signaling: new CallsSignalingClient(transport),
+        });
+    const controller = new CallsController(backend, media, {
+        ...options.controller,
+        ...(options.diagnostics === undefined
+            ? {}
+            : { diagnostics: options.diagnostics }),
+    });
+    client.on("incoming", (call) => {
+        if (disposed || call.ended)
+            return;
+        // Every invitation is listed; none is declined on the application's behalf.
+        emit({
+            type: "incomingCall",
+            call: {
+                callId: call.id,
+                from: call.peer,
+                video: call.hasVideo,
+                capabilities: call.capabilities,
+            },
+        });
+        for (const participant of call.participants)
+            emit({ type: "participant", callId: call.id, participant });
+    });
+    client.on("call", (call) => {
+        call.on("connected", () => emit({ type: "connected", callId: call.id }));
+        call.on("error", (error) => options.onError?.(error));
+        call.on("claim", (claim) => {
+            if (call.direction === "outbound")
+                return;
+            emit({
+                type: "accepted",
+                callId: call.id,
+                ...(claim.answeredBy === undefined
+                    ? {}
+                    : { answeredBy: claim.answeredBy }),
+                exclusive: claim.exclusive,
+                claimedByOther: claim.claimedByOther,
+            });
+        });
+        call.on("state", (state, previous) => {
+            if (call.direction === "outbound" && previous === "ringing")
+                if (state === "connecting" || state === "connected")
+                    emit({ type: "accepted", callId: call.id });
+        });
+        call.on("capabilities", (capabilities) => emit({ type: "capabilities", callId: call.id, capabilities }));
+        call.on("participantJoined", (participant) => emit({ type: "participant", callId: call.id, participant }));
+        call.on("participantState", (participant) => emit({ type: "participant", callId: call.id, participant }));
+        call.on("participantLeft", (participantId) => emit({ type: "participantLeft", callId: call.id, participantId }));
+    });
+    client.on("ended", (call, reason) => {
+        const snapshot = controller.getSnapshot();
+        const listed = snapshot.invitations.some((i) => i.callId === call.id);
+        if (snapshot.callId !== call.id && !listed)
+            return;
+        // Early outbound events are replayed before place() returns. The
+        // controller adopts the terminal Call after the HTTP response.
+        if (snapshot.callId === call.id &&
+            ["error", "ended"].includes(snapshot.status))
+            return;
+        emit({ type: "ended", callId: call.id, reason });
+    });
+    client.on("error", (error) => options.onError?.(error));
+    // Keep the shared call's terminal state in sync with browser media failures.
+    const unsubscribe = controller.subscribe(() => {
+        const snapshot = controller.getSnapshot();
+        const call = client.getCall(snapshot.callId ?? "");
+        if (call &&
+            !call.ended &&
+            call.state !== "incoming" &&
+            snapshot.error?.code !== "call_control_failed" &&
+            (snapshot.status === "ended" || snapshot.status === "error")) {
+            const reason = snapshot.endReason === "capacity"
+                ? "capacity"
+                : snapshot.endReason === "pod_lost"
+                    ? "pod_lost"
+                    : "connection_failed";
+            // Nobody else is on an outbound call that is still ringing, and nobody
+            // can take over a call this client claimed (exclusive answer or
+            // placement). Leaving either would strand the other party, so end it,
+            // as @polymorfa/sdk/calls does for socket media.
+            const release = (call.direction === "outbound" && call.state === "ringing") ||
+                call._claimedBySelf;
+            call._remoteEnded(reason);
+            if (release)
+                void api
+                    .end(call.id)
+                    .catch((cause) => options.onError?.({ code: "end_failed", message: message(cause) }));
+            // Media failed locally: leave the connection; the call continues for
+            // others. The platform requires a connection id; the call's own id is
+            // the one the media session offers with.
+            else
+                void api.leave(call.id, call.connectionId).catch((cause) => options.onError?.({
+                    code: "leave_failed",
+                    message: message(cause),
+                }));
+        }
+    });
+    function dispose() {
+        if (disposal)
+            return disposal;
+        if (disposed)
+            return Promise.resolve();
+        disposed = true;
+        unsubscribe();
+        listeners.clear();
+        controller.dispose();
+        disposal = client.disconnect();
+        return disposal;
+    }
+    return {
+        controller,
+        get connected() {
+            return client.connected;
+        },
+        connect: () => {
+            if (disposed)
+                return Promise.reject(new Error("Browser calls is disposed."));
+            if (connecting)
+                return connecting;
+            controller.initialize();
+            connecting = client
+                .connect()
+                .then(() => {
+                if (!client.connected)
+                    throw new Error("Calls lifecycle stream is not connected; reconnection continues until disposal.");
+            })
+                .finally(() => {
+                connecting = undefined;
+            });
+            return connecting;
+        },
+        dispose,
+    };
+}
+function message(cause) {
+    return cause instanceof Error ? cause.message : "Call operation failed.";
+}
+//# sourceMappingURL=client.js.map

package/dist/calls/client.js.map

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

package/dist/calls/controller.d.ts

@@ -0,0 +1,329 @@
+import { type AcceptCallResult, type Call, type CallReport, type Participant } from "@polymorfa/sdk/calls/internal";
+import { ObservableController, type ControllerSnapshot } from "../controller.js";
+import type { CallMediaFactory } from "./media.js";
+export type CallStatus = "idle" | "ready" | "incoming" | "ringing" | "accepted" | "connecting" | "connected" | "reconnecting" | "ended" | "error";
+export type CallEndReason = "hangup" | "left" | "rejected" | "missed" | "busy" | "connection_failed" | "ice_timeout" | "capacity" | "remote_hangup" | "pod_lost" | (string & {});
+/**
+ * What the displayed call supports. The platform reports video and invite
+ * support per call; muting is always available.
+ */
+export interface CallCapabilities {
+    readonly video: boolean;
+    readonly mute: boolean;
+    readonly invite: boolean;
+}
+export type CallDeviceKind = "audioinput" | "videoinput" | "audiooutput";
+export interface CallDevice {
+    readonly deviceId: string;
+    readonly kind: CallDeviceKind;
+    readonly label: string;
+}
+/** Capture/playback device choices. `audioOutput` needs `setSinkId` support. */
+export interface SelectedCallDevices {
+    readonly audioInput?: string;
+    readonly videoInput?: string;
+    readonly audioOutput?: string;
+}
+export interface IncomingCall {
+    readonly callId: string;
+    readonly from: string;
+    readonly video: boolean;
+    /** Platform-reported capabilities; defaults allow video and invitations. */
+    readonly capabilities?: {
+        readonly video: boolean;
+        readonly invite: boolean;
+    };
+}
+/** A call participant as the platform reports it. */
+export type CallParticipant = Participant;
+/**
+ * An incoming call this client knows about. Several can ring at once; the
+ * controller never declines one on its own.
+ */
+export interface CallInvitation {
+    readonly callId: string;
+    readonly from: string;
+    readonly video: boolean;
+    readonly capabilities: CallCapabilities;
+    /** Somebody answered the call. */
+    readonly answered: boolean;
+    /** Participant reference that answered first, when known. */
+    readonly answeredBy?: string;
+    /** The answer claimed the call. */
+    readonly exclusive: boolean;
+    /** Another participant claimed the call: stop ringing, do not decline. */
+    readonly claimedByOther: boolean;
+    /** Answered without a claim: this client can join. */
+    readonly canJoin: boolean;
+}
+/** One remote participant's video with its stream. */
+export interface ParticipantVideo extends RemoteVideoInfo {
+    readonly stream: MediaStream;
+}
+/** A remote video tile, without its media stream (see `controller.remoteVideos`). */
+export interface RemoteVideoInfo {
+    /** Stable key for rendering one participant's video. */
+    readonly key: string;
+    /** Display label: the participant's number or ID, or the other connection's participant reference. */
+    readonly label: string;
+    readonly connectionId?: string;
+    /** Participant reference behind `connectionId`, when known. */
+    readonly connectionParticipant?: string;
+    readonly participant?: CallParticipant;
+}
+export type CallLifecycleEvent = {
+    readonly type: "incomingCall";
+    readonly call: IncomingCall;
+} | {
+    readonly type: "ringing" | "connected";
+    readonly callId: string;
+} | {
+    /**
+     * The call was answered. On a call this client placed, the remote party
+     * picked up. On an incoming call, `answeredBy` and `exclusive` say who
+     * answered and whether they claimed it.
+     */
+    readonly type: "accepted";
+    readonly callId: string;
+    readonly answeredBy?: string;
+    readonly exclusive?: boolean;
+    /** Set by backends that know this client's participant reference. */
+    readonly claimedByOther?: boolean;
+    /**
+     * Capabilities the platform reported with the answer. Reported fields
+     * only: an absent field keeps the call's current value.
+     */
+    readonly capabilities?: {
+        readonly video?: boolean;
+        readonly invite?: boolean;
+    };
+} | {
+    /** The platform reported different capabilities for a call. */
+    readonly type: "capabilities";
+    readonly callId: string;
+    /** Reported fields only; an absent field keeps the current value. */
+    readonly capabilities: {
+        readonly video?: boolean;
+        readonly invite?: boolean;
+    };
+} | {
+    readonly type: "ended";
+    readonly callId: string;
+    readonly reason?: CallEndReason;
+} | {
+    readonly type: "videostate";
+    readonly callId: string;
+    readonly video: boolean;
+} | {
+    readonly type: "participant";
+    readonly callId: string;
+    readonly participant: CallParticipant;
+} | {
+    readonly type: "participantLeft";
+    readonly callId: string;
+    readonly participantId: string;
+};
+export interface PlaceCallInput {
+    readonly to: string;
+    readonly video: boolean;
+    readonly idempotencyKey: string;
+    /** Claim the placed call. Default `false`. */
+    readonly exclusive?: boolean;
+}
+export interface AnswerCallInput {
+    /** Claim the call. `false` leaves other participants ringing so they can join. */
+    readonly exclusive: boolean;
+    readonly video: boolean;
+}
+export interface CallsBackend {
+    /** Shared call model, when this backend uses the Calls client. */
+    getCall?(callId: string): Call | undefined;
+    /** Media connection id to use for a call, when the backend owns one. */
+    connectionId?(callId: string): string | undefined;
+    /** Release an owned lifecycle client when the controller is disposed. */
+    dispose?(): void;
+    subscribe(listener: (event: CallLifecycleEvent) => void): () => void;
+    place(input: PlaceCallInput, signal: AbortSignal): Promise<{
+        readonly callId: string;
+    }>;
+    /**
+     * Answer a ringing call. Rejects with `CallClaimedError` when another
+     * participant claimed it.
+     */
+    answer(callId: string, signal: AbortSignal, input?: AnswerCallInput): Promise<void | AcceptCallResult>;
+    /** Join an answered, unclaimed call. Defaults to `answer` without a claim. */
+    join?(callId: string, signal: AbortSignal, input: {
+        readonly video: boolean;
+    }): Promise<void | AcceptCallResult>;
+    /** Decline a ringing call. Ends it for every participant. */
+    reject(callId: string, signal: AbortSignal): Promise<void>;
+    /** End the call for every participant. */
+    hangup(callId: string, signal: AbortSignal): Promise<void>;
+    /**
+     * Send a diagnostics report for one of this browser's connections.
+     * Optional: without it the controller sends none.
+     */
+    report?(callId: string, report: CallReport): Promise<void>;
+    /**
+     * Leave one media connection. When omitted, the media session leaves on
+     * its own when it closes.
+     */
+    leave?(callId: string, connectionId: string | undefined, signal: AbortSignal): Promise<void>;
+}
+export interface CallsSnapshot extends ControllerSnapshot {
+    readonly status: CallStatus;
+    readonly callId?: string;
+    readonly peer?: string;
+    readonly direction?: "incoming" | "outgoing";
+    readonly capabilities: CallCapabilities;
+    readonly video: boolean;
+    readonly audioMuted: boolean;
+    readonly videoMuted: boolean;
+    /** Set once media connected; drives the call duration display. */
+    readonly connectedAt?: number;
+    readonly devices: readonly CallDevice[];
+    readonly selectedDevices: SelectedCallDevices;
+    readonly endReason?: CallEndReason;
+    readonly error?: {
+        readonly code: string;
+        readonly message: string;
+        readonly recoverable: boolean;
+        /**
+         * The call the error is about. It differs from `callId` when a failed
+         * call gave way to a waiting invitation.
+         */
+        readonly callId?: string;
+    };
+    /** Every incoming call this client knows about, displayed one included. */
+    readonly invitations: readonly CallInvitation[];
+    /** The displayed incoming call was claimed by another participant. */
+    readonly claimedByOther: boolean;
+    /** The displayed incoming call is answered without a claim; `join()` it. */
+    readonly canJoin: boolean;
+    /** Who answered the displayed call, when known. */
+    readonly answeredBy?: string;
+    /** The displayed call is claimed. */
+    readonly exclusive: boolean;
+    /** Participants of the displayed call. */
+    readonly participants: readonly CallParticipant[];
+    /** Remote video tiles of the displayed call; streams are on the controller. */
+    readonly remoteVideos: readonly RemoteVideoInfo[];
+    /**
+     * An answer or join is in progress. Until it settles, `answer()`, `join()`,
+     * `reject()` and `place()` are refused; `select()` and `dismiss()` stay
+     * available.
+     */
+    readonly answering?: boolean;
+}
+export interface CallsControllerOptions {
+    readonly createIdempotencyKey?: () => string;
+    readonly now?: () => number;
+    /**
+     * Resumption window: how long media may stay disconnected before the call
+     * is given up (default 15 000 ms), and how long `disconnected` may last
+     * before an ICE restart is attempted (default 2 000 ms).
+     */
+    readonly resumptionWindowMs?: number;
+    readonly iceRestartAfterMs?: number;
+    readonly setTimeout?: typeof globalThis.setTimeout;
+    readonly clearTimeout?: typeof globalThis.clearTimeout;
+    /**
+     * Send call diagnostics for this browser's media connections (default
+     * `true`): round-trip time, jitter, packet counts, codecs, candidate type
+     * and reconnect count every 15 seconds and when the connection closes, and
+     * an error code when media fails. Reports carry no personal data. `false`
+     * sends none.
+     */
+    readonly diagnostics?: boolean;
+}
+export declare class CallsController extends ObservableController<CallsSnapshot> {
+    #private;
+    constructor(backend: CallsBackend, mediaFactory: CallMediaFactory, options?: CallsControllerOptions);
+    initialize(): void;
+    /** The shared call model for the displayed call, when supplied by the backend. */
+    get call(): Call | undefined;
+    place(to: string, options?: {
+        readonly video?: boolean;
+        /** Claim the placed call. Default `false`. */
+        readonly exclusive?: boolean;
+    }): Promise<void>;
+    /**
+     * Answer the displayed incoming call, or the invitation named by `callId`.
+     * `exclusive` defaults to `false`: other participants keep ringing and can
+     * join. A call claimed by another participant is not answered; the snapshot
+     * reports `claimedByOther`.
+     */
+    answer(options?: {
+        readonly video?: boolean;
+        readonly exclusive?: boolean;
+        readonly callId?: string;
+    }): Promise<void>;
+    /**
+     * Join the displayed (or named) call that another participant answered
+     * without claiming it. Never claims.
+     */
+    join(options?: {
+        readonly video?: boolean;
+        readonly callId?: string;
+    }): Promise<void>;
+    /**
+     * Decline the displayed (or named) ringing call. This ends the call for
+     * every participant; only call it on an explicit user action.
+     */
+    reject(options?: {
+        readonly callId?: string;
+    }): Promise<void>;
+    /**
+     * Stop showing an incoming call without declining it. Other participants
+     * keep ringing; the call is not affected.
+     */
+    dismiss(callId?: string): void;
+    /** Show a known invitation while no call is active. */
+    select(callId: string): void;
+    /**
+     * Leave the displayed call: close this client's media connection. The call
+     * continues for the other participants. An outgoing call that has not
+     * connected has no other participants, so leaving it ends it instead;
+     * otherwise the callee would keep ringing.
+     */
+    leave(): Promise<void>;
+    /** End the displayed call for every participant. */
+    end(): Promise<void>;
+    /** Same as {@link end}: ends the call for every participant. */
+    hangup(): Promise<void>;
+    setMuted(muted: {
+        readonly audio?: boolean;
+        readonly video?: boolean;
+    }): void;
+    /**
+     * Whether an audio→video upgrade is possible right now: the call carries
+     * video, the call is not already video, and the media session can
+     * renegotiate.
+     */
+    get canEnableVideo(): boolean;
+    /**
+     * Start sending the camera on an audio call and renegotiate on the same
+     * connection. No-op when the call has no video, when video is already on,
+     * or when the media session cannot renegotiate.
+     */
+    enableVideo(): Promise<void>;
+    /** Choose the devices the next call acquires (and the speaker the UI plays through). */
+    setPreferredDevices(devices: SelectedCallDevices): void;
+    /**
+     * Switch the live microphone or camera mid-call (the outgoing track is
+     * replaced in place, mute state carries over) and remember the choice for
+     * the next call.
+     */
+    switchDevice(kind: "audioInput" | "videoInput", deviceId: string): Promise<void>;
+    /** Re-enumerate capture/playback devices into the snapshot. */
+    refreshDevices(): Promise<void>;
+    get localStream(): MediaStream | undefined;
+    /** Merged call audio. */
+    get remoteStream(): MediaStream | undefined;
+    /** One video per remote source, keyed like `snapshot.remoteVideos`. */
+    get remoteVideos(): readonly ParticipantVideo[];
+    protected onDispose(): void;
+    /** Keeps `invitations` and `answering` current on every transition. */
+    protected transition(next: Omit<CallsSnapshot, "revision" | "updatedAt">): void;
+}
+//# sourceMappingURL=controller.d.ts.map