hanc-webrtc-widgets 2.8.2 → 2.8.3

package/dist/src/components/callback/callback-api.d.ts

@@ -0,0 +1,15 @@
+import { ApiError, Manifest, StatusResponse, SubmitResponse } from './types';
+export declare class CallbackApiError extends Error {
+    readonly status: number;
+    readonly body: ApiError;
+    constructor(status: number, body: ApiError);
+}
+export declare function fetchManifest(agentId: string, apiBaseUrl?: string): Promise<Manifest>;
+export declare function submitCallback(agentId: string, phone: string, country: string, apiBaseUrl?: string, pageUrl?: string): Promise<SubmitResponse>;
+export declare function fetchStatus(requestId: string, apiBaseUrl?: string, signal?: AbortSignal): Promise<StatusResponse>;
+export declare function cancelCallback(requestId: string, apiBaseUrl?: string): Promise<void>;
+/**
+ * Best-effort cancel using navigator.sendBeacon — used on `beforeunload`.
+ * Returns true if the beacon was queued by the browser.
+ */
+export declare function cancelCallbackBeacon(requestId: string, apiBaseUrl?: string): boolean;

package/dist/src/components/callback/callback.d.ts

@@ -0,0 +1,68 @@
+import { LitElement, nothing } from 'lit';
+import { Manifest } from './types';
+export declare class HancAiCallback extends LitElement {
+    agentId: string;
+    apiBaseUrl: string;
+    /**
+     * Skip the manifest fetch and use `manifestOverride` instead. Used in the
+     * dashboard preview where we want to render the widget with a synthetic
+     * config without hitting the API.
+     */
+    skipFetch: boolean;
+    manifestOverride: Manifest | null;
+    /** Overrides theme name (matches the dashboard color picker). */
+    theme: string;
+    private view;
+    private manifest;
+    private selectedCountry;
+    private phoneRaw;
+    private phoneError;
+    private apiError;
+    private pickerOpen;
+    private pickerSearch;
+    private pollAbort;
+    private pollTimer;
+    private lastFocusedBeforeOpen;
+    connectedCallback(): Promise<void>;
+    disconnectedCallback(): void;
+    protected updated(changed: Map<string, unknown>): void;
+    private loadManifest;
+    private adoptManifest;
+    private detectCountryFromLocale;
+    private onDocumentKey;
+    private open;
+    private close;
+    private selectCountry;
+    private onPhoneInput;
+    private validatePhoneSoft;
+    private onSubmit;
+    private handleSubmitError;
+    private onCancel;
+    private startPolling;
+    private stopPolling;
+    private onPollUpdate;
+    render(): import('lit').TemplateResult<1> | typeof nothing;
+    private renderFab;
+    private handsetIcon;
+    private renderCard;
+    private renderBody;
+    private renderForm;
+    private renderCountryPicker;
+    private renderQueued;
+    private renderDialing;
+    private renderCompleted;
+    private renderFailed;
+    private renderRateLimited;
+    private closeIcon;
+    private chevronIcon;
+    private queueIcon;
+    private ringingIcon;
+    private checkIcon;
+    private alertIcon;
+    static styles: import('lit').CSSResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hanc-ai-callback': HancAiCallback;
+    }
+}

package/dist/src/components/callback/index.d.ts

@@ -0,0 +1,2 @@
+export * from './callback';
+export type { Manifest, StatusResponse, SubmitResponse } from './types';

package/dist/src/components/callback/rate-limit.d.ts

@@ -0,0 +1,6 @@
+/** Returns true if another submit is allowed right now. */
+export declare function canSubmit(): boolean;
+/** Record a submit attempt (call after a successful server response). */
+export declare function recordSubmit(): void;
+/** Seconds until the oldest tracked submit falls out of the window. */
+export declare function timeToReset(): number;

package/dist/src/components/callback/theme-colors.d.ts

@@ -0,0 +1,7 @@
+export declare const THEME_PRIMARY: Record<string, string>;
+export declare function getThemeColor(name?: string): string;
+/**
+ * Choose a readable foreground (text/icon) colour for a given primary.
+ * Plain luminance threshold — good enough for our 11-colour palette.
+ */
+export declare function getContrastingForeground(primary: string): string;

package/dist/src/components/callback/types.d.ts

@@ -0,0 +1,76 @@
+export interface ManifestCountry {
+    code: string;
+    name: string;
+    dial_code: string;
+    flag: string;
+    enabled: boolean;
+}
+export interface ManifestTerms {
+    enabled: boolean;
+    content: string;
+    terms_url?: string;
+    privacy_url?: string;
+}
+export interface ManifestRetry {
+    max_attempts: number;
+    interval_seconds: number;
+}
+export interface Manifest {
+    agent_id: string;
+    agent_name: string;
+    agent_locale: string;
+    theme: string;
+    allow_all_domains: boolean;
+    allowed_domains: string[];
+    retry: ManifestRetry;
+    allowed_countries: ManifestCountry[];
+    terms?: ManifestTerms;
+}
+export type CallbackStatus = 'queued' | 'dialing' | 'completed' | 'failed' | 'cancelled' | 'expired';
+export interface StatusResponse {
+    status: CallbackStatus;
+    position?: number;
+    estimated_wait_seconds?: number;
+    attempts?: number;
+    max_attempts?: number;
+    failure_reason?: string;
+}
+export interface SubmitResponse {
+    request_id: string;
+    position: number;
+    estimated_wait_seconds: number;
+    expires_at: string;
+}
+export type ViewState = {
+    kind: 'loading';
+} | {
+    kind: 'closed';
+} | {
+    kind: 'form';
+} | {
+    kind: 'submitting';
+} | {
+    kind: 'queued';
+    request_id: string;
+    position: number;
+    eta_seconds: number;
+} | {
+    kind: 'dialing';
+    request_id: string;
+} | {
+    kind: 'completed';
+} | {
+    kind: 'failed';
+    reason: string;
+    can_retry: boolean;
+} | {
+    kind: 'rate_limited';
+} | {
+    kind: 'manifest_error';
+};
+export type ErrorCode = 'rate_limit_phone' | 'queue_full' | 'callback_disabled' | 'invalid_phone' | 'country_not_supported' | 'blocked_prefix' | 'insufficient_credits' | 'no_outbound_number' | 'plan_required' | 'domain_not_allowed' | 'agent_not_found' | 'config_disabled' | 'token_invalid' | 'unknown';
+export interface ApiError {
+    error_code: ErrorCode;
+    message: string;
+    retry_after_seconds?: number;
+}

package/dist/src/components/index.d.ts

@@ -2,6 +2,7 @@ export * from './inline-call';
 export * from './floating-call';
 export * from './pill-call';
 export * from './pill-floating-call';
+export * from './callback';
 export { darkPresets, lightPresets, getColorPreset, getPresetNames } from '../core/orb/colorPresets';
 export type { OrbColors } from '../core/orb';
 export { themes, darkThemes, lightThemes, getTheme, getThemeNames, applyTheme } from '../core/orb/themes';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hanc-webrtc-widgets",
-  "version": "2.8.2",
+  "version": "2.8.3",
   "type": "module",
   "main": "dist/hanc-webrtc-widgets.umd.js",
   "module": "dist/hanc-webrtc-widgets.es.js",
@@ -14,6 +14,7 @@
   },
   "dependencies": {
     "@livekit/noise-filter": "^0.1.3",
+    "libphonenumber-js": "^1.13.1",
     "lit": "^3.2.1",
     "livekit-client": "^2.15.6",
     "three": "^0.182.0"