@chanl/widget-sdk 0.2.0-canary.0

package/dist/react/use-chat.js

@@ -0,0 +1,224 @@
+"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChat = useChat;
+const react_1 = require("react");
+const chat_client_1 = require("../chat/chat-client");
+const widget_config_1 = require("../chat/widget-config");
+const defaults_1 = require("../defaults");
+// ── Helpers ──
+let counter = 0;
+function id() { return `sdk-${++counter}-${Date.now()}`; }
+function toolLabel(toolName, state) {
+    // Friendly labels — in production these come from agent config
+    const labels = {
+        search_listings: { call: 'Searching listings...', result: '✓ Found results' },
+        lookup_order: { call: 'Looking up order...', result: '✓ Order found' },
+        get_available_slots: { call: 'Checking availability...', result: '✓ Slots found' },
+        check_order_status: { call: 'Checking order status...', result: '✓ Status retrieved' },
+        calendar_booking: { call: 'Booking appointment...', result: '✓ Booked' },
+        send_email: { call: 'Sending email...', result: '✓ Email sent' },
+        knowledge_search: { call: 'Searching knowledge base...', result: '✓ Found answers' },
+    };
+    const entry = labels[toolName] ?? { call: 'Working on it...', result: '✓ Done' };
+    return state === 'call' ? entry.call : entry.result;
+}
+// ── Hook ──
+function useChat({ agentId, apiKey, baseUrl, greeting, user, userHash, variables, metadata, }) {
+    const resolvedBaseUrl = (0, defaults_1.resolveBaseUrl)(baseUrl);
+    const clientRef = (0, react_1.useRef)((0, chat_client_1.createChatClient)({ apiKey, baseUrl: resolvedBaseUrl }));
+    const sessionRef = (0, react_1.useRef)(null);
+    const isStreamingRef = (0, react_1.useRef)(false);
+    // Hold latest identity in refs so `send` always reads fresh values without
+    // the `send` callback's identity changing on every identity prop change
+    // (would trigger parent re-renders that pass `send` via props).
+    const identityRef = (0, react_1.useRef)({ user, userHash, variables, metadata });
+    identityRef.current = { user, userHash, variables, metadata };
+    const [messages, setMessages] = (0, react_1.useState)([]);
+    const [isTyping, setIsTyping] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const [sessionReady, setSessionReady] = (0, react_1.useState)(false);
+    const [agentConfig, setAgentConfig] = (0, react_1.useState)(null);
+    // Fetch widget config on mount → get agent name, avatar, greeting
+    (0, react_1.useEffect)(() => {
+        let cancelled = false;
+        (0, widget_config_1.getWidgetConfig)(agentId, apiKey, resolvedBaseUrl).then((config) => {
+            if (cancelled || !config)
+                return;
+            const agent = {
+                id: agentId,
+                name: config.agent?.name ?? 'AI Assistant',
+                initials: (config.agent?.name ?? 'AI').split(' ').map((w) => w[0]).join('').slice(0, 2),
+                avatarUrl: config.style?.agentAvatar,
+                greeting: greeting ?? config.banner?.description ?? `Hi! I'm ${config.agent?.name ?? 'here to help'}. How can I assist you?`,
+                suggestions: [],
+                primaryColor: config.style?.primaryColor,
+            };
+            setAgentConfig(agent);
+            // Set greeting message
+            setMessages([{ id: id(), role: 'assistant', content: agent.greeting, timestamp: Date.now() }]);
+        });
+        return () => { cancelled = true; };
+    }, [agentId, apiKey, baseUrl, greeting]);
+    // Create session lazily (on first send). Reads latest identity from the
+    // ref so re-identify (externalId change) takes effect on the next send
+    // without recreating the `send` callback.
+    const ensureSession = (0, react_1.useCallback)(async () => {
+        if (sessionRef.current)
+            return sessionRef.current;
+        const { user, userHash, variables, metadata } = identityRef.current;
+        const session = await clientRef.current.createSession(agentId, {
+            user,
+            userHash,
+            variables,
+            metadata,
+        });
+        sessionRef.current = session;
+        setSessionReady(true);
+        return session;
+    }, [agentId]);
+    // Re-identify: when externalId changes, end the current session so the
+    // next send creates a fresh one with the new identity. Deps are primitive
+    // (`externalId` string) per react-best-practices `rerender-dependencies` —
+    // using the `user` object directly would trigger reset on every parent
+    // re-render even when externalId is stable.
+    const externalId = user?.externalId;
+    (0, react_1.useEffect)(() => {
+        if (sessionRef.current) {
+            const stale = sessionRef.current;
+            sessionRef.current = null;
+            setSessionReady(false);
+            // Best-effort cleanup; don't block the re-identify.
+            clientRef.current.endSession(stale.sessionId).catch(() => { });
+        }
+        // Intentionally NOT depending on `user` object — only externalId primitive.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [externalId]);
+    // Send message with streaming
+    const send = (0, react_1.useCallback)(async (text) => {
+        if (isStreamingRef.current)
+            return;
+        setError(null);
+        // Add user message
+        setMessages((p) => [...p, { id: id(), role: 'user', content: text, timestamp: Date.now() }]);
+        setIsTyping(true);
+        try {
+            const session = await ensureSession();
+            // Lazy placeholder: don't create the assistant bubble until the first
+            // chunk arrives. While we wait, the typing-dots indicator carries the
+            // "agent is thinking" affordance alone — otherwise we'd render BOTH the
+            // typing dots AND an empty assistant bubble for the gap between
+            // stream-connected and first-chunk, which looks like two replies.
+            let placeholderId = null;
+            const startTime = Date.now();
+            isStreamingRef.current = true;
+            // Track status pill IDs for cleanup
+            const statusIds = [];
+            const response = await clientRef.current.streamMessage(session.sessionId, text, 
+            // onChunk — text delta
+            (chunk) => {
+                // Stream parser can emit empty deltas (e.g. control packets sent
+                // before any actual tokens). Don't create the bubble until we have
+                // real content — otherwise we get the ghost-bubble bug back: an
+                // empty assistant bubble alongside the still-spinning typing dots.
+                if (!placeholderId) {
+                    if (!chunk)
+                        return;
+                    const newId = id();
+                    placeholderId = newId;
+                    setIsTyping(false); // Bubble takes over for the typing dots
+                    setMessages((p) => [
+                        ...p,
+                        { id: newId, role: 'assistant', content: chunk, timestamp: Date.now() },
+                    ]);
+                    return;
+                }
+                setMessages((p) => p.map((m) => m.id === placeholderId ? { ...m, content: m.content + chunk } : m));
+            }, 
+            // onPart — tool invocations
+            (part) => {
+                if (part.type !== 'tool-invocation' || !part.toolInvocation)
+                    return;
+                const inv = part.toolInvocation;
+                const label = toolLabel(inv.toolName, inv.state);
+                if (inv.state === 'call') {
+                    const sid = id();
+                    statusIds.push(sid);
+                    setMessages((p) => {
+                        // Insert status pill before placeholder
+                        const idx = p.findIndex((m) => m.id === placeholderId);
+                        const pill = { id: sid, role: 'status', content: label, label, timestamp: Date.now() };
+                        if (idx >= 0) {
+                            const next = [...p];
+                            next.splice(idx, 0, pill);
+                            return next;
+                        }
+                        return [...p, pill];
+                    });
+                }
+                else if (inv.state === 'result') {
+                    // Update the most recent status pill
+                    const lastSid = statusIds[statusIds.length - 1];
+                    if (lastSid) {
+                        setMessages((p) => p.map((m) => m.id === lastSid ? { ...m, content: label, label } : m));
+                    }
+                }
+            });
+            isStreamingRef.current = false;
+            // Remove status pills, add thought badge + final response
+            const elapsed = (Date.now() - startTime) / 1000;
+            const toolCount = statusIds.length;
+            // If no chunks ever streamed (non-streaming fallback or empty stream),
+            // create the bubble now from response.message so the user sees it.
+            if (!placeholderId && response.message) {
+                const newId = id();
+                placeholderId = newId;
+                setIsTyping(false);
+            }
+            const finalPlaceholderId = placeholderId;
+            setMessages((p) => {
+                let next = p.filter((m) => !statusIds.includes(m.id));
+                if (finalPlaceholderId) {
+                    const exists = next.some((m) => m.id === finalPlaceholderId);
+                    if (exists) {
+                        next = next.map((m) => m.id === finalPlaceholderId ? { ...m, content: response.message } : m);
+                    }
+                    else {
+                        next = [
+                            ...next,
+                            { id: finalPlaceholderId, role: 'assistant', content: response.message, timestamp: Date.now() },
+                        ];
+                    }
+                }
+                if (toolCount > 0 && finalPlaceholderId) {
+                    const badgeIdx = next.findIndex((m) => m.id === finalPlaceholderId);
+                    if (badgeIdx >= 0) {
+                        next.splice(badgeIdx, 0, {
+                            id: id(),
+                            role: 'tool',
+                            content: `Thought for ${elapsed.toFixed(1)}s · Used ${toolCount} tool${toolCount > 1 ? 's' : ''}`,
+                            timestamp: Date.now(),
+                            duration: elapsed,
+                        });
+                    }
+                }
+                return next;
+            });
+        }
+        catch (err) {
+            isStreamingRef.current = false;
+            setError(err instanceof Error ? err.message : 'Something went wrong');
+            setIsTyping(false);
+        }
+    }, [ensureSession]);
+    // Cleanup on unmount
+    (0, react_1.useEffect)(() => {
+        return () => {
+            if (sessionRef.current) {
+                clientRef.current.endSession(sessionRef.current.sessionId);
+            }
+        };
+    }, []);
+    return { messages, isTyping, error, send, sessionReady, agentConfig };
+}
+//# sourceMappingURL=use-chat.js.map

package/dist/react/use-chat.js.map

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

package/dist/react/use-voice.d.ts

@@ -0,0 +1,37 @@
+import type { VoiceClient } from '../voice/voice-client';
+export interface VoiceMessage {
+    id: string;
+    sender: 'agent' | 'user';
+    content: string;
+    timestamp: Date;
+}
+export type VoiceMode = 'idle' | 'voice';
+export type VoiceStatus = 'idle' | 'connecting' | 'active' | 'reconnecting' | 'closed' | 'error';
+export interface UseVoiceOptions {
+    /** Public or server API key. `pub_xxx` for browser, `ak_xxx` for server. */
+    apiKey: string;
+    /** Optional backend override (defaults to production; auto-resolves to localhost in dev). */
+    baseUrl?: string;
+    /** Log internal events to the console. */
+    debug?: boolean;
+}
+export interface UseVoiceReturn {
+    mode: VoiceMode;
+    start: (agentId: string) => void;
+    stop: () => void;
+    toggleMute: () => void;
+    sendMessage: (text: string) => void;
+    startVoice: (agentId: string) => void;
+    stopVoice: () => void;
+    status: VoiceStatus;
+    messages: VoiceMessage[];
+    isMuted: boolean;
+    isAgentSpeaking: boolean;
+    duration: number;
+    lastError?: Error;
+    voiceState: VoiceStatus;
+    error?: Error;
+    voice: VoiceClient | null;
+}
+export declare function useVoice(opts: UseVoiceOptions): UseVoiceReturn;
+//# sourceMappingURL=use-voice.d.ts.map

package/dist/react/use-voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-voice.d.ts","sourceRoot":"","sources":["../../src/react/use-voice.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMzD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAKD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AACzC,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,cAAc,GACd,QAAQ,GACR,OAAO,CAAC;AAKZ,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAE7B,IAAI,EAAE,SAAS,CAAC;IAGhB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAGpC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,SAAS,EAAE,MAAM,IAAI,CAAC;IAGtB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,KAAK,CAAC;IAGlB,UAAU,EAAE,WAAW,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;IAGd,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CAC3B;AAKD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAqQ9D"}

package/dist/react/use-voice.js

@@ -0,0 +1,268 @@
+"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useVoice = useVoice;
+/**
+ * useVoice — React hook for voice calls against a Chanl agent.
+ *
+ * Port of `packages/audial-widget/src/hooks/use-audial.tsx` from chanl-platform.
+ * Strictly copied — chat paths stripped (use-chat.ts handles text), imports swapped
+ * to use `createChanlClient().voice` (lazy VoiceClient) instead of `new Audial(...)`.
+ *
+ * The hook owns the full voice lifecycle:
+ *   start(agentId)  — instantiate VoiceClient, wire events, connect
+ *   stop()          — close transport, clear timers
+ *   toggleMute()    — toggle mic mute state
+ *   sendMessage(t)  — send a text frame over the live voice call
+ *
+ * State exposed (both audial-legacy names AND spec-contract names):
+ *   status / voiceState       — 'idle' | 'connecting' | 'active' | 'closed' | 'error'
+ *   messages                  — TranscriptMessage-derived UI list
+ *   isMuted                   — mic mute state (tracked from 'mic-muted'/'mic-unmuted')
+ *   isAgentSpeaking           — from 'speech-start'/'speech-end'
+ *   duration                  — seconds since 'ready'
+ *   lastError / error         — last error (Error | undefined)
+ */
+const react_1 = require("react");
+const client_1 = require("../client");
+/* ────────────────────────────────────────────────────────────────────────── */
+/* 4.  Hook implementation                                                   */
+/* ────────────────────────────────────────────────────────────────────────── */
+function useVoice(opts) {
+    const { apiKey, debug = false, baseUrl } = opts;
+    /* refs & state */
+    const voiceRef = (0, react_1.useRef)(null);
+    const [mode, setMode] = (0, react_1.useState)('idle');
+    const [status, setStatus] = (0, react_1.useState)('idle');
+    const [isMuted, setIsMuted] = (0, react_1.useState)(false);
+    const [messages, setMessages] = (0, react_1.useState)([]);
+    const [lastError, setLastError] = (0, react_1.useState)();
+    const [isAgentSpeaking, setIsAgentSpeaking] = (0, react_1.useState)(false);
+    // Duration state and timer ref
+    const [duration, setDuration] = (0, react_1.useState)(0);
+    const timerRef = (0, react_1.useRef)(null);
+    // Track current agentId
+    const currentAgentIdRef = (0, react_1.useRef)(null);
+    /* helper to add transcript in required shape.
+     *
+     * Pipecat + Deepgram emit INTERIM transcripts as the user speaks, then a
+     * FINAL when they stop. Interims are a growing prefix of the final:
+     *   "Can you"
+     *   "Can you tell me what"
+     *   "Can you tell me what day is it?"  ← final
+     *
+     * The wire-level TranscriptMessage has no `is_final` flag, so we dedupe
+     * by pattern: if the NEW transcript from the same sender has the LAST
+     * transcript as a prefix (or vice versa), REPLACE the last bubble in
+     * place with the longer string. This keeps one bubble per utterance.
+     */
+    const pushTranscript = (0, react_1.useCallback)((transcript) => {
+        if (!transcript?.text)
+            return;
+        const sender = transcript.sender === 'assistant' ? 'agent' : 'user';
+        const content = transcript.text;
+        setMessages((prev) => {
+            const last = prev[prev.length - 1];
+            if (last && last.sender === sender) {
+                // Exact duplicate — skip.
+                if (last.content === content)
+                    return prev;
+                // Prefix extension (or rare shrink) — replace in place with the longer.
+                if (content.startsWith(last.content) || last.content.startsWith(content)) {
+                    const longer = content.length >= last.content.length ? content : last.content;
+                    const replaced = { ...last, content: longer };
+                    return [...prev.slice(0, -1), replaced];
+                }
+            }
+            return [
+                ...prev,
+                {
+                    id: (transcript.timestamp || Date.now()).toString(),
+                    sender,
+                    content,
+                    timestamp: new Date(transcript.timestamp || Date.now()),
+                },
+            ];
+        });
+    }, []);
+    /* helper to add an immediate user message (before transcript echoes back) */
+    const addMessage = (0, react_1.useCallback)((sender, content) => {
+        setMessages((prev) => [
+            ...prev,
+            {
+                id: Date.now().toString(),
+                sender,
+                content,
+                timestamp: new Date(),
+            },
+        ]);
+    }, []);
+    /* attach SDK event listeners */
+    const bindVoiceEvents = (0, react_1.useCallback)(() => {
+        const v = voiceRef.current;
+        if (!v)
+            return undefined;
+        const onReady = () => {
+            if (debug)
+                console.debug('[useVoice] onReady');
+            setStatus('active');
+            setDuration(0);
+            if (timerRef.current)
+                clearInterval(timerRef.current);
+            timerRef.current = setInterval(() => {
+                setDuration((prev) => prev + 1);
+            }, 1000);
+        };
+        const onClose = (code, reason) => {
+            if (debug)
+                console.debug('[useVoice] onClose', { code, reason });
+            setStatus('closed');
+            setMode('idle');
+            if (timerRef.current) {
+                clearInterval(timerRef.current);
+                timerRef.current = null;
+            }
+        };
+        const onError = (e) => {
+            console.error('[useVoice] onError', e);
+            setLastError(e);
+            setStatus('error');
+            if (timerRef.current) {
+                clearInterval(timerRef.current);
+                timerRef.current = null;
+            }
+        };
+        const onTranscript = (transcript) => {
+            if (debug)
+                console.debug('[useVoice] onTranscript', transcript);
+            pushTranscript(transcript);
+        };
+        const onMicMuted = () => {
+            if (debug)
+                console.debug('[useVoice] onMicMuted');
+            setIsMuted(true);
+        };
+        const onMicUnmuted = () => {
+            if (debug)
+                console.debug('[useVoice] onMicUnmuted');
+            setIsMuted(false);
+        };
+        const onSpeechStart = () => {
+            if (debug)
+                console.debug('[useVoice] onSpeechStart');
+            setIsAgentSpeaking(true);
+        };
+        const onSpeechEnd = () => {
+            if (debug)
+                console.debug('[useVoice] onSpeechEnd');
+            setIsAgentSpeaking(false);
+        };
+        v.on('ready', onReady);
+        v.on('closed', onClose);
+        v.on('error', onError);
+        v.on('transcript', onTranscript);
+        v.on('mic-muted', onMicMuted);
+        v.on('mic-unmuted', onMicUnmuted);
+        v.on('speech-start', onSpeechStart);
+        v.on('speech-end', onSpeechEnd);
+        return () => {
+            v.off('ready', onReady);
+            v.off('closed', onClose);
+            v.off('error', onError);
+            v.off('transcript', onTranscript);
+            v.off('mic-muted', onMicMuted);
+            v.off('mic-unmuted', onMicUnmuted);
+            v.off('speech-start', onSpeechStart);
+            v.off('speech-end', onSpeechEnd);
+        };
+    }, [pushTranscript, debug]);
+    /* voice controls */
+    const start = (0, react_1.useCallback)((agentId) => {
+        if (debug)
+            console.debug(`[useVoice] start with agentId: ${agentId}`);
+        if (typeof window === 'undefined') {
+            console.warn('[useVoice] window is undefined, cannot start');
+            return;
+        }
+        // Lazy voice client via createChanlClient — browser-only require happens here.
+        const client = (0, client_1.createChanlClient)({ agentId, apiKey, baseUrl });
+        voiceRef.current = client.voice;
+        bindVoiceEvents();
+        setMessages([]);
+        setLastError(undefined);
+        setStatus('connecting');
+        setMode('voice');
+        setDuration(0);
+        currentAgentIdRef.current = agentId;
+        // Start the voice connection
+        voiceRef.current.start(agentId);
+    }, [apiKey, baseUrl, debug, bindVoiceEvents]);
+    const stop = (0, react_1.useCallback)(() => {
+        if (debug)
+            console.debug('[useVoice] stop');
+        voiceRef.current?.stop();
+        if (timerRef.current) {
+            clearInterval(timerRef.current);
+            timerRef.current = null;
+        }
+        setMode('idle');
+        setStatus('closed');
+    }, [debug]);
+    const toggleMute = (0, react_1.useCallback)(() => {
+        if (!voiceRef.current)
+            return;
+        if (debug)
+            console.debug('[useVoice] toggleMute');
+        voiceRef.current.toggleMicMute();
+    }, [debug]);
+    /* send text frame over a live voice call */
+    const sendMessage = (0, react_1.useCallback)((text) => {
+        if (!voiceRef.current || !text.trim())
+            return;
+        if (debug)
+            console.debug('[useVoice] sendMessage', text);
+        voiceRef.current.send({
+            type: 'text',
+            text: text.trim(),
+        });
+        // Optimistically add the user's message to the transcript
+        addMessage('user', text.trim());
+    }, [debug, addMessage]);
+    // Cleanup on unmount
+    (0, react_1.useEffect)(() => {
+        return () => {
+            if (debug)
+                console.debug('[useVoice] cleanup on unmount');
+            voiceRef.current?.stop();
+            if (timerRef.current) {
+                clearInterval(timerRef.current);
+                timerRef.current = null;
+            }
+        };
+    }, [debug]);
+    return {
+        // Mode
+        mode,
+        // Voice controls (audial-legacy names)
+        start,
+        stop,
+        toggleMute,
+        sendMessage,
+        // Spec-contract aliases
+        startVoice: start,
+        stopVoice: stop,
+        // State (audial-legacy field names)
+        status,
+        messages,
+        isMuted,
+        isAgentSpeaking,
+        duration,
+        lastError,
+        // Spec-contract aliases
+        voiceState: status,
+        error: lastError,
+        // Low-level access
+        voice: voiceRef.current,
+    };
+}
+//# sourceMappingURL=use-voice.js.map

package/dist/react/use-voice.js.map

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

package/dist/react/widget.d.ts

@@ -0,0 +1,43 @@
+import type { ChanlUser } from '../types';
+export interface ChanlWidgetProps {
+    /** Public key (`pub_xxx`) — origin-scoped browser-safe auth. Required. */
+    pubKey: string;
+    /** Agent to load. Required. */
+    agentId: string;
+    /** Identified end-user (Intercom-style widget identity path). */
+    user?: ChanlUser;
+    /** HMAC-SHA256 of `user.externalId` — compute via `computeUserHash` on the server. */
+    userHash?: string;
+    /** Platform API base URL (auto-resolved to localhost/prod by default). */
+    baseUrl?: string;
+    /** Chat iframe host URL (defaults to `https://chat.channel.tel` in prod). */
+    chatHost?: string;
+    /** Visual theme. Default 'dark'. */
+    theme?: 'dark' | 'light';
+    /** Launcher position. Default 'bottom-right'. */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Launcher button background color. */
+    color?: string;
+    /** Show the "Powered by Chanl" footer. Default true. */
+    branding?: boolean;
+    /** Override the agent's display name in the header. */
+    agentName?: string;
+    /** Subtitle shown under the agent name. */
+    agentSubtitle?: string;
+    /** 1–2 character initials for the avatar fallback. */
+    agentInitials?: string;
+    /** Avatar image URL. */
+    agentAvatarUrl?: string;
+    /** Override the greeting message shown when the chat panel first opens. */
+    greeting?: string;
+    /** Input placeholder text. */
+    placeholder?: string;
+    /** Override the dark theme background color. */
+    darkBg?: string;
+    /** Link to your privacy policy, shown in the disclaimer. */
+    privacyUrl?: string;
+    /** Locale code to load localized agent copy. */
+    locale?: string;
+}
+export declare function ChanlWidget(props: ChanlWidgetProps): null;
+//# sourceMappingURL=widget.d.ts.map

package/dist/react/widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../../src/react/widget.tsx"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,iEAAiE;IACjE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC;IAC1C,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CA+IzD"}