@callembed/sdk 0.0.0-stage → 0.1.0

package/dist/core/types.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Shared public types for the CallEmbed headless core.
+ * UI types that only apply to panels live under `src/ui/`.
+ */
+/** Locale packs shipped with the optional UI layer (also accepted by `init`). */
+export type Locale = "zh-TW" | "en";
+/**
+ * Call lifecycle statuses.
+ * Legal transitions are enforced by the state machine in `state-machine.ts`.
+ */
+export type CallStatus = "idle" | "connecting" | "ringing" | "answered" | "ended" | "error";
+/**
+ * Options for {@link CallEmbed.init}.
+ *
+ * @remarks
+ * Only a **publishable** key (`pk_…`) is accepted. Never pass secret / agent /
+ * service-role keys into the browser SDK.
+ */
+export interface InitOptions {
+    /** Project publishable key (`pk_…`). */
+    publishableKey: string;
+    /**
+     * API origin. Use `""` for same-origin (Vite proxy / reverse proxy).
+     */
+    apiBaseUrl: string;
+    /**
+     * Default UI locale when using `@callembed/sdk/ui`.
+     * When omitted: `zh-TW` if `navigator.language` starts with `zh`, else `en`.
+     */
+    locale?: Locale;
+    /**
+     * Partial copy overrides (merged over the locale pack).
+     * Values are always inserted with `textContent` — never interpreted as HTML.
+     */
+    copy?: Partial<Record<string, string>>;
+    /**
+     * When `false`, the default panel hides the CallEmbed brand line.
+     * Default: `true`.
+     */
+    branding?: boolean;
+    /**
+     * When `true`, the default panel may show `callId` (never tokens or keys).
+     * Default: `false`.
+     */
+    debug?: boolean;
+}
+/**
+ * Options for {@link CallEmbed.startCall}.
+ * (`on` handlers are typed via {@link StartCallEventHandlers} below.)
+ */
+export interface StartCallOptions {
+    /** Queue name configured on the project (e.g. `onboarding`). */
+    queue: string;
+    /** Opaque JSON object forwarded to the API / webhooks (size-capped). */
+    metadata?: Record<string, unknown>;
+    /** Optional caller display name (not used for agent detection). */
+    displayName?: string;
+    /**
+     * When `true`, no default panel is created (headless).
+     * Remote audio still plays via a hidden core-managed host.
+     */
+    hidePanel?: boolean;
+    /**
+     * Mount the default panel into this element (UI layer only).
+     * Ignored when `hidePanel` is true. Requires `enableDefaultUi()` or `mountButton`.
+     */
+    container?: HTMLElement | string;
+    /**
+     * Typed listeners attached before connection starts.
+     * Startup failures (e.g. `no_agent_online`) also emit `error` here;
+     * the returned Promise still rejects.
+     */
+    on?: StartCallEventHandlers;
+}
+/**
+ * Successful `POST /v1/calls` payload.
+ * `token` (LiveKit JWT) and `endToken` are kept in memory only —
+ * never localStorage, URL query, logs, or webhook payloads.
+ */
+export interface CallSession {
+    callId: string;
+    roomName: string;
+    livekitUrl: string;
+    token: string;
+    identity: string;
+    role: string;
+    ttlSeconds: number;
+    expiresAt: string;
+    queue: string;
+    metadata: Record<string, unknown>;
+    status: string;
+    /**
+     * One-time capability to end this call as the caller.
+     * Required on `POST /v1/calls/:id/end` when using the publishable key.
+     */
+    endToken?: string;
+}
+export interface ApiErrorBody {
+    error?: string;
+    message?: string;
+}
+/** Typed event names emitted by an active call. */
+export type CallEventName = "statusChange" | "ringing" | "answered" | "ended" | "error" | "muteChange";
+/** Payload map for {@link CallEventName}. */
+export interface CallEventMap {
+    statusChange: {
+        status: CallStatus;
+        previousStatus: CallStatus;
+    };
+    ringing: {
+        callId: string;
+    };
+    answered: {
+        callId: string;
+        agentIdentity: string;
+    };
+    ended: {
+        callId: string;
+        status: "ended";
+    };
+    error: {
+        callId: string;
+        code: string;
+        message: string;
+    };
+    muteChange: {
+        muted: boolean;
+    };
+}
+export type CallEventHandler<E extends CallEventName> = (payload: CallEventMap[E]) => void;
+/**
+ * Event handlers registered **before** the call connects.
+ * Use these to observe `connecting` / `ringing` (and startup `error`)
+ * without missing events that fire during `await startCall(...)`.
+ */
+export type StartCallEventHandlers = {
+    [E in CallEventName]?: CallEventHandler<E>;
+};
+/**
+ * Handle returned by {@link CallEmbed.startCall}.
+ */
+export interface ActiveCall {
+    /** Server call id once created; `"pending"` before `POST /v1/calls` returns. */
+    readonly callId: string;
+    /** Current lifecycle status (see state machine). */
+    readonly status: CallStatus;
+    /**
+     * End the call, stop microphone tracks, disconnect LiveKit, and notify the API.
+     * Safe to call multiple times (idempotent).
+     */
+    hangUp(): Promise<void>;
+    /**
+     * Mute / unmute the local microphone.
+     * May be called before the room connects; the preference is applied on connect.
+     */
+    setMuted(muted: boolean): Promise<void>;
+    /** Whether the local microphone is muted. */
+    isMuted(): boolean;
+    /**
+     * Subscribe to a typed call event.
+     * @returns Unsubscribe function.
+     */
+    on<E extends CallEventName>(event: E, handler: CallEventHandler<E>): () => void;
+    /** Remove a previously registered handler. */
+    off<E extends CallEventName>(event: E, handler: CallEventHandler<E>): void;
+}
+/** Resolved runtime config held after `init` (no secrets beyond publishable key). */
+export interface RuntimeConfig {
+    publishableKey: string;
+    apiBaseUrl: string;
+    locale: Locale;
+    copyOverrides: Partial<Record<string, string>>;
+    branding: boolean;
+    debug: boolean;
+}

package/dist/core/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared public types for the CallEmbed headless core.
+ * UI types that only apply to panels live under `src/ui/`.
+ */
+export {};

package/dist/iife.d.ts

@@ -0,0 +1,23 @@
+import { CallEmbedError } from "./core/errors.js";
+import { mountButton } from "./ui/button.js";
+import { enableDefaultUi } from "./ui/bind.js";
+import { zhTwCopy, enCopy } from "./ui/copy.js";
+import { THEME_VARIABLES, ensureStyles } from "./ui/theme.js";
+/**
+ * Full browser global: init / startCall / mountButton.
+ */
+export declare const CallEmbed: {
+    init: (options: import("./index.js").InitOptions) => void;
+    startCall: (options: import("./index.js").StartCallOptions) => Promise<import("./index.js").ActiveCall>;
+    getActiveCall: () => import("./index.js").ActiveCall | null;
+    mountButton: typeof mountButton;
+    enableDefaultUi: typeof enableDefaultUi;
+};
+export { CallEmbedError, zhTwCopy, enCopy, THEME_VARIABLES, ensureStyles };
+declare global {
+    interface Window {
+        CallEmbed: typeof CallEmbed;
+        CallEmbedError: typeof CallEmbedError;
+    }
+}
+export default CallEmbed;

package/dist/iife.js

@@ -0,0 +1,27 @@
+/**
+ * CDN / IIFE entry: headless core + default UI on `window.CallEmbed`.
+ */
+import { CallEmbed as Core } from "./core/client.js";
+import { CallEmbedError } from "./core/errors.js";
+import { mountButton } from "./ui/button.js";
+import { enableDefaultUi } from "./ui/bind.js";
+import { zhTwCopy, enCopy } from "./ui/copy.js";
+import { THEME_VARIABLES, ensureStyles } from "./ui/theme.js";
+// CDN one-liner expects panel on startCall / mountButton.
+enableDefaultUi();
+/**
+ * Full browser global: init / startCall / mountButton.
+ */
+export const CallEmbed = {
+    init: Core.init.bind(Core),
+    startCall: Core.startCall.bind(Core),
+    getActiveCall: Core.getActiveCall.bind(Core),
+    mountButton,
+    enableDefaultUi,
+};
+export { CallEmbedError, zhTwCopy, enCopy, THEME_VARIABLES, ensureStyles };
+if (typeof window !== "undefined") {
+    window.CallEmbed = CallEmbed;
+    window.CallEmbedError = CallEmbedError;
+}
+export default CallEmbed;

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @callembed/sdk — headless core entry.
+ *
+ * For the default panel / `mountButton`, import `@callembed/sdk/ui` and call
+ * `mountButton()` or `enableDefaultUi()`.
+ */
+export { CallEmbed } from "./core/client.js";
+export { CallEmbedError, type ErrorCode } from "./core/errors.js";
+export { METADATA_MAX_BYTES, assertValidMetadata } from "./core/metadata.js";
+export type { ActiveCall, ApiErrorBody, CallEventHandler, CallEventMap, CallEventName, CallSession, CallStatus, InitOptions, Locale, RuntimeConfig, StartCallEventHandlers, StartCallOptions, } from "./core/types.js";
+export { CallEmbed as default } from "./core/client.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @callembed/sdk — headless core entry.
+ *
+ * For the default panel / `mountButton`, import `@callembed/sdk/ui` and call
+ * `mountButton()` or `enableDefaultUi()`.
+ */
+export { CallEmbed } from "./core/client.js";
+export { CallEmbedError } from "./core/errors.js";
+export { METADATA_MAX_BYTES, assertValidMetadata } from "./core/metadata.js";
+export { CallEmbed as default } from "./core/client.js";

package/dist/ui/bind.d.ts

@@ -0,0 +1,14 @@
+import type { CallSessionController, CallUiHooks } from "../core/call.js";
+import type { StartCallOptions } from "../core/types.js";
+/**
+ * Build UI hooks that mirror call status onto a default panel.
+ */
+export declare function createPanelHooks(call: CallSessionController, opts: StartCallOptions): CallUiHooks;
+/**
+ * Register the default panel factory on the headless client.
+ * Must be called explicitly (or via {@link mountButton}); importing the UI
+ * package alone does not change core `startCall` behaviour.
+ */
+export declare function enableDefaultUi(): void;
+/** @internal Test helper */
+export declare function _resetDefaultUiForTests(): void;

package/dist/ui/bind.js

@@ -0,0 +1,82 @@
+import { CallEmbed, registerUiHooksFactory } from "../core/client.js";
+import { friendlyErrorMessage, resolveCopy } from "./copy.js";
+import { createCallPanel, destroyPanel, setPanelStatus, } from "./panel.js";
+function resolveContainer(input) {
+    if (!input)
+        return undefined;
+    if (typeof input === "string") {
+        const found = document.querySelector(input);
+        return found instanceof HTMLElement ? found : undefined;
+    }
+    return input;
+}
+/**
+ * Build UI hooks that mirror call status onto a default panel.
+ */
+export function createPanelHooks(call, opts) {
+    if (opts.hidePanel)
+        return {};
+    const runtime = CallEmbed._getRuntime();
+    const copy = resolveCopy(runtime);
+    const panel = createCallPanel({
+        copy,
+        branding: runtime?.branding !== false,
+        container: resolveContainer(opts.container),
+    });
+    panel.muteBtn.addEventListener("click", () => {
+        void call.setMuted(!call.isMuted());
+    });
+    panel.hangupBtn.addEventListener("click", () => {
+        void call.hangUp();
+    });
+    setPanelStatus(panel, "connecting", copy, copy.creating);
+    call.on("error", ({ code, message }) => {
+        setPanelStatus(panel, "error", copy, friendlyErrorMessage(copy, code, message));
+        panel.muteBtn.disabled = true;
+        panel.hangupBtn.textContent = copy.close;
+        panel.hangupBtn.onclick = () => {
+            destroyPanel(panel);
+        };
+    });
+    return {
+        onStatus: (status, message) => {
+            if (status === "error") {
+                // Friendly copy handled by the `error` event listener above.
+                return;
+            }
+            setPanelStatus(panel, status, copy, message);
+            if (runtime?.debug && call.callId && call.callId !== "pending") {
+                panel.metaEl.hidden = false;
+                panel.metaEl.textContent = `callId ${call.callId}`;
+            }
+            if (status === "ended") {
+                panel.muteBtn.disabled = true;
+                panel.hangupBtn.disabled = true;
+                window.setTimeout(() => destroyPanel(panel), 900);
+            }
+        },
+        onMuteChange: (muted) => {
+            panel.muteBtn.textContent = muted ? copy.unmute : copy.mute;
+        },
+        onTerminal: () => {
+            // Panel self-destruct handled in onStatus / error listener.
+        },
+    };
+}
+let bound = false;
+/**
+ * Register the default panel factory on the headless client.
+ * Must be called explicitly (or via {@link mountButton}); importing the UI
+ * package alone does not change core `startCall` behaviour.
+ */
+export function enableDefaultUi() {
+    if (bound)
+        return;
+    bound = true;
+    registerUiHooksFactory((call, opts) => createPanelHooks(call, opts));
+}
+/** @internal Test helper */
+export function _resetDefaultUiForTests() {
+    bound = false;
+    registerUiHooksFactory(null);
+}

package/dist/ui/button.d.ts

@@ -0,0 +1,28 @@
+import { CallEmbedError } from "../core/errors.js";
+import type { ActiveCall, StartCallOptions } from "../core/types.js";
+/** Options for {@link mountButton}. */
+export interface MountButtonOptions extends StartCallOptions {
+    /** Button label; defaults to locale `launchDefault`. */
+    label?: string;
+    /**
+     * Called when `startCall` rejects (also receives `error` events via `options.on`).
+     */
+    onError?: (error: CallEmbedError) => void;
+}
+/** Handle returned by {@link mountButton}. */
+export interface MountButtonResult {
+    /** The injected launch button. */
+    button: HTMLButtonElement;
+    /** Call started by the latest click, if any. */
+    getCall(): ActiveCall | null;
+}
+/**
+ * One-line default UI: inject a launch button that starts a call with the panel.
+ *
+ * Explicitly enables default UI (does not rely on import side effects).
+ * Never calls `window.alert`.
+ *
+ * @param selector - CSS selector for the host element.
+ * @param options - Queue / metadata / label / error callback.
+ */
+export declare function mountButton(selector: string, options: MountButtonOptions): MountButtonResult;

package/dist/ui/button.js

@@ -0,0 +1,57 @@
+import { CallEmbed } from "../core/client.js";
+import { CallEmbedError } from "../core/errors.js";
+import { enableDefaultUi } from "./bind.js";
+import { resolveCopy } from "./copy.js";
+import { ensureStyles } from "./theme.js";
+/**
+ * One-line default UI: inject a launch button that starts a call with the panel.
+ *
+ * Explicitly enables default UI (does not rely on import side effects).
+ * Never calls `window.alert`.
+ *
+ * @param selector - CSS selector for the host element.
+ * @param options - Queue / metadata / label / error callback.
+ */
+export function mountButton(selector, options) {
+    enableDefaultUi();
+    if (!CallEmbed._getRuntime()) {
+        throw new CallEmbedError("not_initialized", "Call CallEmbed.init({ publishableKey, apiBaseUrl }) first.");
+    }
+    ensureStyles();
+    const host = document.querySelector(selector);
+    if (!(host instanceof HTMLElement)) {
+        throw new CallEmbedError("invalid_selector", `Element not found: ${selector}`);
+    }
+    const copy = resolveCopy(CallEmbed._getRuntime());
+    const btn = document.createElement("button");
+    btn.type = "button";
+    btn.className = "ce-launch";
+    btn.textContent = options.label ?? copy.launchDefault;
+    host.appendChild(btn);
+    let lastCall = null;
+    btn.addEventListener("click", async () => {
+        btn.disabled = true;
+        try {
+            lastCall = await CallEmbed.startCall({
+                ...options,
+                hidePanel: false,
+            });
+        }
+        catch (err) {
+            lastCall = CallEmbed.getActiveCall();
+            if (err instanceof CallEmbedError) {
+                options.onError?.(err);
+            }
+            else {
+                options.onError?.(new CallEmbedError("call_failed", err instanceof Error ? err.message : String(err)));
+            }
+        }
+        finally {
+            btn.disabled = false;
+        }
+    });
+    return {
+        button: btn,
+        getCall: () => lastCall,
+    };
+}

package/dist/ui/copy-en.d.ts

@@ -0,0 +1,3 @@
+import type { PanelCopy } from "./copy-zh-tw.js";
+/** English default panel / button copy. */
+export declare const enCopy: PanelCopy;

package/dist/ui/copy-en.js

@@ -0,0 +1,25 @@
+/** English default panel / button copy. */
+export const enCopy = {
+    brand: "CallEmbed",
+    title: "Voice call",
+    ariaLabel: "CallEmbed call panel",
+    connecting: "Connecting…",
+    creating: "Creating call…",
+    ringing: "Connected — waiting for an agent…",
+    answered: "In call",
+    ended: "Call ended",
+    disconnected: "Disconnected",
+    reconnecting: "Reconnecting…",
+    error: "Something went wrong. Please try again.",
+    errNoAgent: "No agent is online right now. Please try again later.",
+    errQuota: "Call unavailable right now. Please try again later.",
+    errMicDenied: "Microphone permission is required to place a call.",
+    errNoMic: "No microphone device was found.",
+    errConnection: "Connection failed. Check your network and try again.",
+    ready: "Ready",
+    mute: "Mute",
+    unmute: "Unmute",
+    hangup: "Hang up",
+    close: "Close",
+    launchDefault: "Talk to a person",
+};

package/dist/ui/copy-zh-tw.d.ts

@@ -0,0 +1,28 @@
+/** Traditional Chinese (zh-TW) default panel / button copy. */
+export declare const zhTwCopy: {
+    readonly brand: "CallEmbed";
+    readonly title: "語音通話";
+    readonly ariaLabel: "CallEmbed 通話面板";
+    readonly connecting: "連線中…";
+    readonly creating: "正在建立通話…";
+    readonly ringing: "已連線 — 等待客服接聽…";
+    readonly answered: "通話中";
+    readonly ended: "通話已結束";
+    readonly disconnected: "已斷線";
+    readonly reconnecting: "重新連線中…";
+    readonly error: "發生錯誤，請稍後再試。";
+    readonly errNoAgent: "目前沒有客服在線，請稍後再試。";
+    readonly errQuota: "目前無法通話，請稍後再試。";
+    readonly errMicDenied: "需要麥克風權限才能通話。";
+    readonly errNoMic: "找不到麥克風裝置。";
+    readonly errConnection: "連線失敗，請檢查網路後再試。";
+    readonly ready: "就緒";
+    readonly mute: "靜音";
+    readonly unmute: "取消靜音";
+    readonly hangup: "掛斷";
+    readonly close: "關閉";
+    readonly launchDefault: "找真人聊聊";
+};
+export type PanelCopy = {
+    [K in keyof typeof zhTwCopy]: string;
+};

package/dist/ui/copy-zh-tw.js

@@ -0,0 +1,25 @@
+/** Traditional Chinese (zh-TW) default panel / button copy. */
+export const zhTwCopy = {
+    brand: "CallEmbed",
+    title: "語音通話",
+    ariaLabel: "CallEmbed 通話面板",
+    connecting: "連線中…",
+    creating: "正在建立通話…",
+    ringing: "已連線 — 等待客服接聽…",
+    answered: "通話中",
+    ended: "通話已結束",
+    disconnected: "已斷線",
+    reconnecting: "重新連線中…",
+    error: "發生錯誤，請稍後再試。",
+    errNoAgent: "目前沒有客服在線，請稍後再試。",
+    errQuota: "目前無法通話，請稍後再試。",
+    errMicDenied: "需要麥克風權限才能通話。",
+    errNoMic: "找不到麥克風裝置。",
+    errConnection: "連線失敗，請檢查網路後再試。",
+    ready: "就緒",
+    mute: "靜音",
+    unmute: "取消靜音",
+    hangup: "掛斷",
+    close: "關閉",
+    launchDefault: "找真人聊聊",
+};

package/dist/ui/copy.d.ts

@@ -0,0 +1,18 @@
+import type { RuntimeConfig } from "../core/types.js";
+import { enCopy } from "./copy-en.js";
+import { zhTwCopy, type PanelCopy } from "./copy-zh-tw.js";
+/**
+ * Resolve panel copy from locale + safe string overrides.
+ * Override values are coerced to strings (never used as HTML).
+ */
+export declare function resolveCopy(runtime: RuntimeConfig | null): PanelCopy;
+/**
+ * Map machine error codes to friendly panel copy (never show raw codes to B).
+ */
+/**
+ * Map machine error codes to friendly panel copy.
+ * Unknown codes use the locale generic `error` string — never raw server text.
+ */
+export declare function friendlyErrorMessage(copy: PanelCopy, code: string, _fallback?: string): string;
+export { zhTwCopy, enCopy };
+export type { PanelCopy };

package/dist/ui/copy.js

@@ -0,0 +1,45 @@
+import { enCopy } from "./copy-en.js";
+import { zhTwCopy } from "./copy-zh-tw.js";
+const PACKS = {
+    "zh-TW": { ...zhTwCopy },
+    en: { ...enCopy },
+};
+/**
+ * Resolve panel copy from locale + safe string overrides.
+ * Override values are coerced to strings (never used as HTML).
+ */
+export function resolveCopy(runtime) {
+    const locale = runtime?.locale ?? "en";
+    const base = { ...(PACKS[locale] ?? PACKS.en) };
+    const overrides = runtime?.copyOverrides ?? {};
+    for (const [key, value] of Object.entries(overrides)) {
+        if (key in base && value !== undefined && value !== null) {
+            base[key] = String(value);
+        }
+    }
+    return base;
+}
+/**
+ * Map machine error codes to friendly panel copy (never show raw codes to B).
+ */
+/**
+ * Map machine error codes to friendly panel copy.
+ * Unknown codes use the locale generic `error` string — never raw server text.
+ */
+export function friendlyErrorMessage(copy, code, _fallback) {
+    switch (code) {
+        case "no_agent_online":
+            return copy.errNoAgent;
+        case "quota_exceeded":
+            return copy.errQuota;
+        case "mic_permission_denied":
+            return copy.errMicDenied;
+        case "no_microphone":
+            return copy.errNoMic;
+        case "connection_failed":
+            return copy.errConnection;
+        default:
+            return copy.error;
+    }
+}
+export { zhTwCopy, enCopy };

package/dist/ui/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Optional CallEmbed UI layer (panel, launch button, theme, copy).
+ * Depends on the headless core; core never imports this module.
+ *
+ * Importing this package does **not** change `CallEmbed.startCall` behaviour.
+ * Call {@link enableDefaultUi} or {@link mountButton} to attach the default panel.
+ */
+export { enableDefaultUi, createPanelHooks } from "./bind.js";
+export { mountButton, type MountButtonOptions, type MountButtonResult, } from "./button.js";
+export { createCallPanel, destroyPanel, setPanelStatus, type CallPanelElements, type CreatePanelOptions, } from "./panel.js";
+export { ensureStyles, THEME_VARIABLES } from "./theme.js";
+export { resolveCopy, friendlyErrorMessage, zhTwCopy, enCopy, type PanelCopy, } from "./copy.js";

package/dist/ui/index.js

@@ -0,0 +1,12 @@
+/**
+ * Optional CallEmbed UI layer (panel, launch button, theme, copy).
+ * Depends on the headless core; core never imports this module.
+ *
+ * Importing this package does **not** change `CallEmbed.startCall` behaviour.
+ * Call {@link enableDefaultUi} or {@link mountButton} to attach the default panel.
+ */
+export { enableDefaultUi, createPanelHooks } from "./bind.js";
+export { mountButton, } from "./button.js";
+export { createCallPanel, destroyPanel, setPanelStatus, } from "./panel.js";
+export { ensureStyles, THEME_VARIABLES } from "./theme.js";
+export { resolveCopy, friendlyErrorMessage, zhTwCopy, enCopy, } from "./copy.js";

package/dist/ui/panel.d.ts

@@ -0,0 +1,26 @@
+import type { CallStatus } from "../core/types.js";
+import type { PanelCopy } from "./copy-zh-tw.js";
+export interface CallPanelElements {
+    root: HTMLElement;
+    brandEl: HTMLElement;
+    titleEl: HTMLElement;
+    statusEl: HTMLElement;
+    muteBtn: HTMLButtonElement;
+    hangupBtn: HTMLButtonElement;
+    metaEl: HTMLElement;
+}
+export interface CreatePanelOptions {
+    copy: PanelCopy;
+    branding?: boolean;
+    container?: HTMLElement;
+}
+/**
+ * Build the default call panel with `createElement` / `textContent` only.
+ * Never interprets copy strings as HTML.
+ */
+export declare function createCallPanel(options: CreatePanelOptions): CallPanelElements;
+/**
+ * Update panel status line (always via `textContent`).
+ */
+export declare function setPanelStatus(panel: CallPanelElements, status: CallStatus, copy: PanelCopy, message?: string): void;
+export declare function destroyPanel(panel: CallPanelElements): void;