@chanl/widget-sdk 0.2.0-canary.0

package/dist/chat/stream-parser.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Stream protocol parser for chat responses.
+ * Ported from platform-sdk/modules/chat.ts.
+ *
+ * Protocol:
+ *   0:"text delta"                                   - text chunk
+ *   9:{"toolCallId":"x","toolName":"y","args":{}}    - tool call started
+ *   a:{"toolCallId":"x","result":{...}}              - tool result
+ *   e:{"finishReason":"stop"}                        - stream finished
+ *
+ * Falls back to raw text mode if first chunk doesn't match protocol prefix.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStream = parseStream;
+async function parseStream(body, onChunk, onPart) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let fullText = '';
+    let lineBuffer = '';
+    const parts = [];
+    const toolCalls = [];
+    const pendingTools = new Map();
+    let textIdx = -1;
+    const processLine = (line) => {
+        if (!line || line.length < 2)
+            return;
+        const prefix = line.slice(0, 2);
+        const payload = line.slice(2);
+        switch (prefix) {
+            case '0:': {
+                try {
+                    const text = JSON.parse(payload);
+                    fullText += text;
+                    onChunk(text);
+                    if (textIdx >= 0 && parts[textIdx]?.type === 'text') {
+                        parts[textIdx].text = (parts[textIdx].text || '') + text;
+                    }
+                    else {
+                        textIdx = parts.length;
+                        parts.push({ type: 'text', text });
+                    }
+                }
+                catch {
+                    fullText += payload;
+                    onChunk(payload);
+                }
+                break;
+            }
+            case '9:': {
+                try {
+                    const data = JSON.parse(payload);
+                    textIdx = -1;
+                    const invocation = {
+                        toolCallId: data.toolCallId,
+                        toolName: data.toolName,
+                        state: 'call',
+                        args: data.args,
+                    };
+                    const part = { type: 'tool-invocation', toolInvocation: invocation };
+                    pendingTools.set(data.toolCallId, parts.length);
+                    parts.push(part);
+                    onPart?.(part);
+                }
+                catch { /* skip */ }
+                break;
+            }
+            case 'a:': {
+                try {
+                    const data = JSON.parse(payload);
+                    textIdx = -1;
+                    const idx = pendingTools.get(data.toolCallId);
+                    if (idx !== undefined && parts[idx]?.toolInvocation) {
+                        parts[idx].toolInvocation.state = 'result';
+                        parts[idx].toolInvocation.result = data.result;
+                        onPart?.({ ...parts[idx] });
+                    }
+                    pendingTools.delete(data.toolCallId);
+                    toolCalls.push({
+                        toolName: parts[idx ?? -1]?.toolInvocation?.toolName || 'unknown',
+                        args: parts[idx ?? -1]?.toolInvocation?.args,
+                        result: data.result,
+                    });
+                }
+                catch { /* skip */ }
+                break;
+            }
+            case 'e:':
+                break;
+            default:
+                fullText += line;
+                onChunk(line);
+                break;
+        }
+    };
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const chunk = decoder.decode(value, { stream: true });
+            if (!chunk)
+                continue;
+            // Detect raw text (non-protocol) mode
+            if (fullText === '' && lineBuffer === '' && !chunk.match(/^[0-9a-e]:/)) {
+                fullText += chunk;
+                onChunk(chunk);
+                while (true) {
+                    const { done: d, value: v } = await reader.read();
+                    if (d)
+                        break;
+                    const c = decoder.decode(v, { stream: true });
+                    if (c) {
+                        fullText += c;
+                        onChunk(c);
+                    }
+                }
+                break;
+            }
+            lineBuffer += chunk;
+            const lines = lineBuffer.split('\n');
+            lineBuffer = lines.pop() || '';
+            for (const line of lines)
+                processLine(line);
+        }
+        if (lineBuffer)
+            processLine(lineBuffer);
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return { text: fullText, parts, toolCalls };
+}
+//# sourceMappingURL=stream-parser.js.map

package/dist/chat/stream-parser.js.map

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

package/dist/chat/widget-config.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fetch agent widget config from the platform API.
+ * Used to get agent name, avatar, style, greeting, etc.
+ */
+import type { WidgetConfig } from '../types';
+export declare function getWidgetConfig(agentId: string, apiKey: string, baseUrl: string): Promise<WidgetConfig | null>;
+//# sourceMappingURL=widget-config.d.ts.map

package/dist/chat/widget-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-config.d.ts","sourceRoot":"","sources":["../../src/chat/widget-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAe9B"}

package/dist/chat/widget-config.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Fetch agent widget config from the platform API.
+ * Used to get agent name, avatar, style, greeting, etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWidgetConfig = getWidgetConfig;
+async function getWidgetConfig(agentId, apiKey, baseUrl) {
+    try {
+        const url = `${baseUrl.replace(/\/$/, '')}/api/v1/agents/widget/by-agent?agentId=${encodeURIComponent(agentId)}&publicKey=${encodeURIComponent(apiKey)}`;
+        const res = await fetch(url, {
+            headers: {
+                'Content-Type': 'application/json',
+                'x-public-key': apiKey,
+            },
+        });
+        if (!res.ok)
+            return null;
+        const json = await res.json();
+        return json.data || json;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=widget-config.js.map

package/dist/chat/widget-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-config.js","sourceRoot":"","sources":["../../src/chat/widget-config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAIH,0CAmBC;AAnBM,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,MAAc,EACd,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,0CAA0C,kBAAkB,CAAC,OAAO,CAAC,cAAc,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QACzJ,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,cAAc,EAAE,MAAM;aACvB;SACF,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,66 @@
+/**
+ * createChanlClient — unified text + voice client.
+ *
+ * One factory, three things: chat, voice, getWidgetConfig.
+ * Auto-resolves baseUrl when not provided. Handles pub_/ak_ keys.
+ *
+ * Usage:
+ *   const client = createChanlClient({ agentId, apiKey: 'pub_xxx' });
+ *   await client.chat.createSession();
+ *   await client.chat.streamMessage(...);
+ *   await client.voice.start(agentId);
+ *   const config = await client.getWidgetConfig();
+ */
+import type { WidgetConfig } from './types';
+import type { VoiceClient } from './voice/voice-client';
+export interface ChanlClientConfig {
+    agentId: string;
+    apiKey: string;
+    /** Optional. Defaults to the production Chanl platform; override for local dev or self-hosting. */
+    baseUrl?: string;
+}
+export declare function createChanlClient(config: ChanlClientConfig): {
+    /** Text chat client (sessions, streaming, history) */
+    chat: {
+        createSession(agentId: string, input?: import("./types").CreateSessionInput): Promise<import("./types").ChatSession>;
+        resumeSession(interactionId: string, sessionToken: string): Promise<import("./types").ResumedChatSession>;
+        streamMessage(sessionId: string, message: string, onChunk: (text: string) => void, onPart?: (part: import("./types").MessagePart) => void): Promise<import("./types").ChatMessageResponse>;
+        sendMessage(sessionId: string, message: string): Promise<import("./types").ChatMessageResponse>;
+        endSession(sessionId: string): Promise<void>;
+        identify(sessionId: string, input: {
+            user: {
+                externalId: string;
+                email?: string;
+                name?: string;
+                avatarUrl?: string;
+                attributes?: Record<string, unknown>;
+            };
+            userHash?: string;
+        }): Promise<{
+            sessionId: string;
+            customerId: string;
+            created: boolean;
+        }>;
+        getMessages(sessionId: string): Promise<{
+            sessionId: string;
+            messages: Array<{
+                role: string;
+                content: string;
+                timestamp?: string | number;
+            }>;
+            toolCalls: unknown[];
+        } | null>;
+    };
+    /** Voice client — lazy-loaded on first access (browser only) */
+    readonly voice: VoiceClient;
+    /** Fetch agent widget config (name, avatar, style, greeting) */
+    getWidgetConfig(): Promise<WidgetConfig | null>;
+    /** Resolved configuration for inspection */
+    config: {
+        agentId: string;
+        apiKey: string;
+        baseUrl: string;
+    };
+};
+export type ChanlClient = ReturnType<typeof createChanlClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,mGAAmG;IACnG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB;IAiBvD,sDAAsD;;;;;;;;;;qBAmB+kJ,CAAC;oBAAc,CAAC;yBAAmB,CAAC;0BAAoB,CAAC;;oBAA6C,CAAC;;;;;;;;;;;yBAA8uC,CAAC;;;;;IAhB39L,gEAAgE;oBACnD,WAAW;IAIxB,gEAAgE;uBAC7C,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAI/C,4CAA4C;;;;;;EAG/C;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/client.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * createChanlClient — unified text + voice client.
+ *
+ * One factory, three things: chat, voice, getWidgetConfig.
+ * Auto-resolves baseUrl when not provided. Handles pub_/ak_ keys.
+ *
+ * Usage:
+ *   const client = createChanlClient({ agentId, apiKey: 'pub_xxx' });
+ *   await client.chat.createSession();
+ *   await client.chat.streamMessage(...);
+ *   await client.voice.start(agentId);
+ *   const config = await client.getWidgetConfig();
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createChanlClient = createChanlClient;
+const chat_client_1 = require("./chat/chat-client");
+const widget_config_1 = require("./chat/widget-config");
+const defaults_1 = require("./defaults");
+function createChanlClient(config) {
+    const { agentId, apiKey } = config;
+    const baseUrl = (0, defaults_1.resolveBaseUrl)(config.baseUrl);
+    // Lazy voice client — require() at access time avoids loading
+    // browser-only deps (Worker, extendable-media-recorder) in node.
+    let voiceClient = null;
+    const getVoice = () => {
+        if (!voiceClient) {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { VoiceClient: VC } = require('./voice/voice-client');
+            voiceClient = new VC(apiKey, { baseUrl });
+        }
+        return voiceClient;
+    };
+    return {
+        /** Text chat client (sessions, streaming, history) */
+        chat: (0, chat_client_1.createChatClient)({ apiKey, baseUrl }),
+        /** Voice client — lazy-loaded on first access (browser only) */
+        get voice() {
+            return getVoice();
+        },
+        /** Fetch agent widget config (name, avatar, style, greeting) */
+        getWidgetConfig() {
+            return (0, widget_config_1.getWidgetConfig)(agentId, apiKey, baseUrl);
+        },
+        /** Resolved configuration for inspection */
+        config: { agentId, apiKey, baseUrl },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAiBH,8CAiCC;AAhDD,oDAAsD;AACtD,wDAAuD;AACvD,yCAA4C;AAa5C,SAAgB,iBAAiB,CAAC,MAAyB;IACzD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACnC,MAAM,OAAO,GAAG,IAAA,yBAAc,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE/C,8DAA8D;IAC9D,iEAAiE;IACjE,IAAI,WAAW,GAAuB,IAAI,CAAC;IAC3C,MAAM,QAAQ,GAAG,GAAgB,EAAE;QACjC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,iEAAiE;YACjE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;YAC5D,WAAW,GAAG,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,WAAY,CAAC;IACtB,CAAC,CAAC;IAEF,OAAO;QACL,sDAAsD;QACtD,IAAI,EAAE,IAAA,8BAAgB,EAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAE3C,gEAAgE;QAChE,IAAI,KAAK;YACP,OAAO,QAAQ,EAAE,CAAC;QACpB,CAAC;QAED,gEAAgE;QAChE,eAAe;YACb,OAAO,IAAA,+BAAe,EAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QAED,4CAA4C;QAC5C,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;KACrC,CAAC;AACJ,CAAC"}

package/dist/defaults.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Smart defaults for SDK config.
+ * Auto-detects localhost vs production.
+ */
+/**
+ * Resolves the platform API base URL.
+ * - Explicit value wins
+ * - localhost/127.0.0.1 → dev
+ * - Otherwise → production
+ */
+export declare function resolveBaseUrl(explicit?: string): string;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQxD"}

package/dist/defaults.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Smart defaults for SDK config.
+ * Auto-detects localhost vs production.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBaseUrl = resolveBaseUrl;
+const PROD_BASE_URL = 'https://platform.channel.tel';
+const DEV_BASE_URL = 'http://localhost:3100';
+/**
+ * Resolves the platform API base URL.
+ * - Explicit value wins
+ * - localhost/127.0.0.1 → dev
+ * - Otherwise → production
+ */
+function resolveBaseUrl(explicit) {
+    if (explicit)
+        return explicit;
+    if (typeof window === 'undefined')
+        return PROD_BASE_URL;
+    const host = window.location.hostname;
+    if (host === 'localhost' || host === '127.0.0.1' || host.endsWith('.local')) {
+        return DEV_BASE_URL;
+    }
+    return PROD_BASE_URL;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAWH,wCAQC;AAjBD,MAAM,aAAa,GAAG,8BAA8B,CAAC;AACrD,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAE7C;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,QAAiB;IAC9C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,aAAa,CAAC;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACtC,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5E,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/embed/loader-types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Loader types — extracted from `loader.ts` so React consumers (and any
+ * other type consumer) can import these without pulling in the loader's
+ * `declare global { interface Window { ChanlChat } }` block.
+ *
+ * `loader.ts` re-exports these + adds the runtime IIFE + declare global.
+ * `widget.tsx` imports from HERE only (types), then dynamically imports
+ * `loader.ts` at runtime inside a useEffect.
+ *
+ * Why: if `widget.tsx` imported types directly from `loader.ts`,
+ * TypeScript would process the whole `loader.ts` file during type
+ * resolution — including its `declare global` — and that leaks the
+ * `window.ChanlChat` type into every transitive consumer of
+ * `@chanl/widget-sdk/react`. That conflicts with apps (e.g. chat-host's
+ * `widget-config-form.tsx`) that declare their own local simplified
+ * `window.ChanlChat` shape.
+ */
+export interface ChanlChatProactiveMessage {
+    text: string;
+    delay?: number;
+}
+/**
+ * Identified end-user (Intercom-style widget identity).
+ *
+ * The host app's SERVER resolves this user from its own auth system
+ * (Firebase, Clerk, NextAuth, Auth0, custom) and passes the stable
+ * `externalId` + an HMAC-SHA256 hash computed via `computeUserHash`
+ * from `@chanl/widget-sdk/next`.
+ */
+export interface ChanlChatUser {
+    externalId: string;
+    email?: string;
+    name?: string;
+    avatarUrl?: string;
+    /** Custom attributes — flow into the agent prompt as `customer:<key>` vars. */
+    attributes?: Record<string, unknown>;
+}
+export interface ChanlChatInitConfig {
+    /** Agent to load. Required. */
+    agentId: string;
+    /** Public key (`pub_xxx`) for origin-scoped auth. Recommended. */
+    apiKey?: string;
+    /**
+     * Identified end-user. Activates the widget identity path — the
+     * chat.channel.tel iframe forwards these fields to `/interactions/chat`,
+     * the backend verifies `userHash` + upserts a Customer by `externalId`,
+     * and custom attributes flow into the agent prompt as `customer:<key>`
+     * variables. Required if the host workspace has an `identitySecret`.
+     */
+    user?: ChanlChatUser;
+    /** HMAC-SHA256 of `user.externalId` using workspace identity secret. */
+    userHash?: string;
+    /** Visual theme for the chat iframe. */
+    theme?: 'dark' | 'light';
+    /** Launcher position. */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Launcher button background color. */
+    color?: string;
+    /** Show the "Powered by Chanl" footer. Default true. */
+    branding?: boolean;
+    /** Locale code to load localized agent copy. */
+    locale?: string;
+    /** Link to your privacy policy, shown in the disclaimer. */
+    privacyUrl?: string;
+    /** 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;
+    /** Proactive toast messages shown before the user opens the chat. */
+    proactiveMessages?: Array<string | ChanlChatProactiveMessage>;
+    /** Override the Chanl platform API base URL (auto-resolved by default). */
+    baseUrl?: string;
+    /**
+     * Override the chat iframe host URL. Defaults to `window.location.origin`,
+     * which is the correct value when the loader is served from the same origin
+     * as the chat UI (e.g. `chat.channel.tel`).
+     */
+    chatHost?: string;
+}
+export interface ChanlChatApi {
+    _initialized: boolean;
+    init: (cfg: ChanlChatInitConfig) => void;
+    /**
+     * Apply config changes in-place WITHOUT re-mounting the iframe.
+     *
+     * Launcher-level options (`color`, `position`, `proactiveMessages`) are
+     * patched directly on the DOM. Iframe-level options (`theme`, `agentName`,
+     * `agentSubtitle`, `agentInitials`, `agentAvatarUrl`, `greeting`,
+     * `placeholder`, `privacyUrl`, `branding`, `darkBg`, `locale`) are
+     * pushed into the iframe via postMessage. The chat page inside the iframe
+     * listens for `chanl:update-config` and patches its own React state.
+     *
+     * Auth/identity fields (`agentId`, `apiKey`, `chatHost`, `baseUrl`,
+     * `user`, `userHash`) cannot be updated live — they change which agent is
+     * loaded, which identity the session is for, or where the iframe is
+     * served from. Pass those via `init()` + `destroy()` instead.
+     */
+    update: (partial: Partial<ChanlChatInitConfig>) => void;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    destroy: () => void;
+    setUser: (user: Record<string, unknown>) => void;
+    setContext: (ctx: Record<string, unknown>) => void;
+    sendMessage: (text: string) => void;
+    on: (event: string, fn: (data?: unknown) => void) => void;
+    off: (event: string, fn: (data?: unknown) => void) => void;
+}
+//# sourceMappingURL=loader-types.d.ts.map

package/dist/embed/loader-types.d.ts.map

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

package/dist/embed/loader-types.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Loader types — extracted from `loader.ts` so React consumers (and any
+ * other type consumer) can import these without pulling in the loader's
+ * `declare global { interface Window { ChanlChat } }` block.
+ *
+ * `loader.ts` re-exports these + adds the runtime IIFE + declare global.
+ * `widget.tsx` imports from HERE only (types), then dynamically imports
+ * `loader.ts` at runtime inside a useEffect.
+ *
+ * Why: if `widget.tsx` imported types directly from `loader.ts`,
+ * TypeScript would process the whole `loader.ts` file during type
+ * resolution — including its `declare global` — and that leaks the
+ * `window.ChanlChat` type into every transitive consumer of
+ * `@chanl/widget-sdk/react`. That conflicts with apps (e.g. chat-host's
+ * `widget-config-form.tsx`) that declare their own local simplified
+ * `window.ChanlChat` shape.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=loader-types.js.map

package/dist/embed/loader-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-types.js","sourceRoot":"","sources":["../../src/embed/loader-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/embed/loader.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Chanl Chat Widget — Embed Loader
+ *
+ * <script src="https://chat.channel.tel/widget/v1.js"></script>
+ * <script>
+ *   ChanlChat.init({
+ *     agentId: 'ag_xxx',
+ *     apiKey:  'pub_xxx',
+ *     theme:   'dark',
+ *     proactiveMessages: [
+ *       { text: 'Hey! Need help?', delay: 2000 },
+ *       { text: 'Ask me anything.', delay: 4000 },
+ *     ],
+ *   });
+ * </script>
+ *
+ * This file is the source of truth for the embed loader. It is bundled to
+ * `dist/embed/v1.js` as a self-contained IIFE with zero external deps. Any
+ * visual or behavioral change must preserve the current launcher + iframe
+ * look & feel — embedders rely on it.
+ */
+export interface ChanlChatProactiveMessage {
+    text: string;
+    delay?: number;
+}
+export interface ChanlChatInitConfig {
+    /** Agent to load. Required. */
+    agentId: string;
+    /** Public key (`pub_xxx`) for origin-scoped auth. Recommended. */
+    apiKey?: string;
+    /** Visual theme for the chat iframe. */
+    theme?: 'dark' | 'light';
+    /** Launcher position. */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Launcher button background color. */
+    color?: string;
+    /** Show the "Powered by Chanl" footer. Default true. */
+    branding?: boolean;
+    /** Locale code to load localized agent copy. */
+    locale?: string;
+    /** Link to your privacy policy, shown in the disclaimer. */
+    privacyUrl?: string;
+    /** 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;
+    /** Proactive toast messages shown before the user opens the chat. */
+    proactiveMessages?: Array<string | ChanlChatProactiveMessage>;
+    /** Override the Chanl platform API base URL (auto-resolved by default). */
+    baseUrl?: string;
+    /**
+     * Override the chat iframe host URL. Defaults to `window.location.origin`,
+     * which is the correct value when the loader is served from the same origin
+     * as the chat UI (e.g. `chat.channel.tel`).
+     */
+    chatHost?: string;
+}
+export interface ChanlChatApi {
+    _initialized: boolean;
+    init: (cfg: ChanlChatInitConfig) => void;
+    /**
+     * Apply config changes in-place WITHOUT re-mounting the iframe.
+     *
+     * Launcher-level options (`color`, `position`, `proactiveMessages`) are
+     * patched directly on the DOM. Iframe-level options (`theme`, `agentName`,
+     * `agentSubtitle`, `agentInitials`, `agentAvatarUrl`, `greeting`,
+     * `placeholder`, `privacyUrl`, `branding`, `darkBg`, `locale`) are
+     * pushed into the iframe via postMessage. The chat page inside the iframe
+     * listens for `chanl:update-config` and patches its own React state.
+     *
+     * Auth/identity fields (`agentId`, `apiKey`, `chatHost`, `baseUrl`) cannot
+     * be updated live — they change which agent is loaded or where the iframe
+     * is served from. Pass those via `init()` + `destroy()` instead.
+     */
+    update: (partial: Partial<ChanlChatInitConfig>) => void;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    destroy: () => void;
+    setUser: (user: Record<string, unknown>) => void;
+    setContext: (ctx: Record<string, unknown>) => void;
+    sendMessage: (text: string) => void;
+    on: (event: string, fn: (data?: unknown) => void) => void;
+    off: (event: string, fn: (data?: unknown) => void) => void;
+}
+declare global {
+    interface Window {
+        ChanlChat: ChanlChatApi;
+    }
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/embed/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/embed/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC;IAC1C,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,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,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,yBAAyB,CAAC,CAAC;IAC9D,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACzC;;;;;;;;;;;;;OAaG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,KAAK,IAAI,CAAC;IACxD,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;IAC1D,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;CAC5D;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,EAAE,YAAY,CAAC;KACzB;CACF"}