@chanl/widget-sdk 0.2.0-canary.0

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @chanl/widget-sdk — Embeddable chat + voice widget SDK for Chanl AI agents.
+ *
+ * This is the public-facing SDK that powers chanl-site's embed widget and
+ * any third-party integration that wants chat or voice with a Chanl agent.
+ *
+ * Story 1 exports text chat only. Voice (Story 2) and unified client (Story 3)
+ * land in subsequent commits.
+ */
+export { createChanlClient } from './client';
+export type { ChanlClient, ChanlClientConfig } from './client';
+export { createChatClient } from './chat/chat-client';
+export { getWidgetConfig } from './chat/widget-config';
+export { parseStream } from './chat/stream-parser';
+export type { VoiceClient } from './voice/voice-client';
+export { resolveBaseUrl } from './defaults';
+export { buildAuthHeaders, isPublicKey } from './auth';
+export type { ChatClientConfig, ChatSession, ChatMessageResponse, CreateSessionInput, MessagePart, ToolInvocation, WidgetConfig, ChanlUser, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKnD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGvD,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * @chanl/widget-sdk — Embeddable chat + voice widget SDK for Chanl AI agents.
+ *
+ * This is the public-facing SDK that powers chanl-site's embed widget and
+ * any third-party integration that wants chat or voice with a Chanl agent.
+ *
+ * Story 1 exports text chat only. Voice (Story 2) and unified client (Story 3)
+ * land in subsequent commits.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPublicKey = exports.buildAuthHeaders = exports.resolveBaseUrl = exports.parseStream = exports.getWidgetConfig = exports.createChatClient = exports.createChanlClient = void 0;
+// ── Unified client (recommended) ──
+var client_1 = require("./client");
+Object.defineProperty(exports, "createChanlClient", { enumerable: true, get: function () { return client_1.createChanlClient; } });
+// ── Chat (text) ──
+var chat_client_1 = require("./chat/chat-client");
+Object.defineProperty(exports, "createChatClient", { enumerable: true, get: function () { return chat_client_1.createChatClient; } });
+var widget_config_1 = require("./chat/widget-config");
+Object.defineProperty(exports, "getWidgetConfig", { enumerable: true, get: function () { return widget_config_1.getWidgetConfig; } });
+var stream_parser_1 = require("./chat/stream-parser");
+Object.defineProperty(exports, "parseStream", { enumerable: true, get: function () { return stream_parser_1.parseStream; } });
+// ── Shared ──
+var defaults_1 = require("./defaults");
+Object.defineProperty(exports, "resolveBaseUrl", { enumerable: true, get: function () { return defaults_1.resolveBaseUrl; } });
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "buildAuthHeaders", { enumerable: true, get: function () { return auth_1.buildAuthHeaders; } });
+Object.defineProperty(exports, "isPublicKey", { enumerable: true, get: function () { return auth_1.isPublicKey; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,qCAAqC;AACrC,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA;AAG1B,oBAAoB;AACpB,kDAAsD;AAA7C,+GAAA,gBAAgB,OAAA;AACzB,sDAAuD;AAA9C,gHAAA,eAAe,OAAA;AACxB,sDAAmD;AAA1C,4GAAA,WAAW,OAAA;AAOpB,eAAe;AACf,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AACvB,+BAAuD;AAA9C,wGAAA,gBAAgB,OAAA;AAAE,mGAAA,WAAW,OAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logger.ts - Minimal injectable logging contract
+ *
+ * Defines the minimum interface required for logging functionality.
+ * The default implementation is the browser's console object.
+ */
+export interface Logger {
+    log(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC"}

package/dist/logger.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":""}

package/dist/next/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Compute the HMAC-SHA256 hex digest of a user's `externalId` using the
+ * workspace identity secret. Call this on the **server** only — your
+ * `CHANL_IDENTITY_SECRET` must never reach the browser.
+ *
+ * The widget identity flow mirrors Intercom's `user_hash` pattern:
+ *
+ * 1. Host app picks a stable `externalId` (Firebase uid, Clerk user id,
+ *    Auth0 sub, database id — whatever its auth system already uses).
+ * 2. Host app's server calls `computeUserHash(externalId, secret)` where
+ *    `secret` matches the `identitySecret` set on the Chanl workspace.
+ * 3. Host app renders `<ChanlWidget user={...} userHash={userHash} />` in
+ *    a client component; only the hash crosses the server/client boundary,
+ *    never the raw secret.
+ * 4. Chanl verifies the hash on every chat session creation. Pass → Chanl
+ *    upserts a Customer by externalId + exposes custom attributes as
+ *    `{{customer:<key>}}` prompt variables. Fail → 403.
+ *
+ * @param externalId - The stable user identifier from the host app.
+ * @param secret     - The workspace identity secret, from server env only.
+ * @returns HMAC-SHA256 hex digest, ready to pass as `userHash`.
+ *
+ * @throws if `externalId` or `secret` is empty/not a string.
+ *
+ * @example
+ * ```tsx
+ * // app/dashboard/page.tsx  (React Server Component)
+ * import { computeUserHash } from '@chanl/widget-sdk/next';
+ * import { ChanlWidget } from '@chanl/widget-sdk/react';
+ *
+ * export default async function Page() {
+ *   const user = await getCurrentUser(); // Firebase / Clerk / NextAuth / anything
+ *   const userHash = computeUserHash(
+ *     user.id,
+ *     process.env.CHANL_IDENTITY_SECRET!,
+ *   );
+ *
+ *   return (
+ *     <>
+ *       <main>...</main>
+ *       <ChanlWidget
+ *         pubKey={process.env.NEXT_PUBLIC_CHANL_PUB_KEY!}
+ *         agentId="agent_xxx"
+ *         user={{
+ *           externalId: user.id,
+ *           email: user.email,
+ *           name: user.name,
+ *           attributes: { plan: user.plan, role: user.role },
+ *         }}
+ *         userHash={userHash}
+ *       />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export declare function computeUserHash(externalId: string, secret: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/next/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAc1E"}

package/dist/next/index.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeUserHash = computeUserHash;
+/**
+ * @chanl/widget-sdk/next — Next.js-specific helpers.
+ *
+ * For use in React Server Components, route handlers, and server actions.
+ * Computes the HMAC-SHA256 identity hash on the server so the host app's
+ * workspace identity secret never reaches the browser.
+ *
+ * This subpath uses `node:crypto` and is Node-only — do not import from
+ * a client component. The rest of the widget SDK (components, hooks,
+ * loader) lives in the main entry and `./react` subpath.
+ */
+const node_crypto_1 = require("node:crypto");
+/**
+ * Compute the HMAC-SHA256 hex digest of a user's `externalId` using the
+ * workspace identity secret. Call this on the **server** only — your
+ * `CHANL_IDENTITY_SECRET` must never reach the browser.
+ *
+ * The widget identity flow mirrors Intercom's `user_hash` pattern:
+ *
+ * 1. Host app picks a stable `externalId` (Firebase uid, Clerk user id,
+ *    Auth0 sub, database id — whatever its auth system already uses).
+ * 2. Host app's server calls `computeUserHash(externalId, secret)` where
+ *    `secret` matches the `identitySecret` set on the Chanl workspace.
+ * 3. Host app renders `<ChanlWidget user={...} userHash={userHash} />` in
+ *    a client component; only the hash crosses the server/client boundary,
+ *    never the raw secret.
+ * 4. Chanl verifies the hash on every chat session creation. Pass → Chanl
+ *    upserts a Customer by externalId + exposes custom attributes as
+ *    `{{customer:<key>}}` prompt variables. Fail → 403.
+ *
+ * @param externalId - The stable user identifier from the host app.
+ * @param secret     - The workspace identity secret, from server env only.
+ * @returns HMAC-SHA256 hex digest, ready to pass as `userHash`.
+ *
+ * @throws if `externalId` or `secret` is empty/not a string.
+ *
+ * @example
+ * ```tsx
+ * // app/dashboard/page.tsx  (React Server Component)
+ * import { computeUserHash } from '@chanl/widget-sdk/next';
+ * import { ChanlWidget } from '@chanl/widget-sdk/react';
+ *
+ * export default async function Page() {
+ *   const user = await getCurrentUser(); // Firebase / Clerk / NextAuth / anything
+ *   const userHash = computeUserHash(
+ *     user.id,
+ *     process.env.CHANL_IDENTITY_SECRET!,
+ *   );
+ *
+ *   return (
+ *     <>
+ *       <main>...</main>
+ *       <ChanlWidget
+ *         pubKey={process.env.NEXT_PUBLIC_CHANL_PUB_KEY!}
+ *         agentId="agent_xxx"
+ *         user={{
+ *           externalId: user.id,
+ *           email: user.email,
+ *           name: user.name,
+ *           attributes: { plan: user.plan, role: user.role },
+ *         }}
+ *         userHash={userHash}
+ *       />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+function computeUserHash(externalId, secret) {
+    if (!externalId || typeof externalId !== 'string') {
+        throw new Error('computeUserHash: externalId must be a non-empty string');
+    }
+    if (!secret || typeof secret !== 'string') {
+        throw new Error('computeUserHash: CHANL_IDENTITY_SECRET is missing or empty. ' +
+            'Set it as a server-side environment variable (e.g. `CHANL_IDENTITY_SECRET` ' +
+            'in your Vercel project or `.env.local`) and never expose it to the client.');
+    }
+    return (0, node_crypto_1.createHmac)('sha256', secret).update(externalId).digest('hex');
+}
+//# sourceMappingURL=index.js.map

package/dist/next/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":";;AAqEA,0CAcC;AAnFD;;;;;;;;;;GAUG;AACH,6CAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,SAAgB,eAAe,CAAC,UAAkB,EAAE,MAAc;IAChE,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,8DAA8D;YAC5D,6EAA6E;YAC7E,4EAA4E,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,IAAA,wBAAU,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @chanl/widget-sdk/react — React hooks + component for the chat widget.
+ *
+ * Subpath import:
+ *   import { ChanlWidget, useChat, useVoice, useChanl } from '@chanl/widget-sdk/react';
+ */
+export { ChanlWidget } from './widget';
+export type { ChanlWidgetProps } from './widget';
+export { useChat } from './use-chat';
+export { useVoice } from './use-voice';
+export type { UseVoiceOptions, UseVoiceReturn, VoiceMessage, VoiceMode, VoiceStatus, } from './use-voice';
+export { useChanl } from './use-chanl';
+export type { UseChanlOptions, UseChanlReturn } from './use-chanl';
+export type { UIChatMessage, AgentConfig, ChatTheme } from './types';
+export type { ChanlUser } from '../types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGnE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAErE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * @chanl/widget-sdk/react — React hooks + component for the chat widget.
+ *
+ * Subpath import:
+ *   import { ChanlWidget, useChat, useVoice, useChanl } from '@chanl/widget-sdk/react';
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChanl = exports.useVoice = exports.useChat = exports.ChanlWidget = void 0;
+// ── v1: drop-in widget component ──
+var widget_1 = require("./widget");
+Object.defineProperty(exports, "ChanlWidget", { enumerable: true, get: function () { return widget_1.ChanlWidget; } });
+// ── Hooks (headless) ──
+var use_chat_1 = require("./use-chat");
+Object.defineProperty(exports, "useChat", { enumerable: true, get: function () { return use_chat_1.useChat; } });
+var use_voice_1 = require("./use-voice");
+Object.defineProperty(exports, "useVoice", { enumerable: true, get: function () { return use_voice_1.useVoice; } });
+var use_chanl_1 = require("./use-chanl");
+Object.defineProperty(exports, "useChanl", { enumerable: true, get: function () { return use_chanl_1.useChanl; } });
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qCAAqC;AACrC,mCAAuC;AAA9B,qGAAA,WAAW,OAAA;AAGpB,yBAAyB;AACzB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAChB,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AAQjB,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA"}

package/dist/react/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * UI-facing types for React hooks. Distinct from the SDK transport types
+ * (which are in src/types.ts) — these include UI metadata like display
+ * labels and durations for status pills.
+ */
+export type ChatTheme = 'dark' | 'light';
+export interface UIChatMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'tool' | 'thinking' | 'status';
+    content: string;
+    timestamp: number;
+    /** User-friendly label for tool/status messages (e.g. "Searching listings...") */
+    label?: string;
+    /** Duration in seconds for thought/tool badges */
+    duration?: number;
+}
+export interface AgentConfig {
+    id: string;
+    name: string;
+    subtitle?: string;
+    avatarUrl?: string;
+    initials: string;
+    greeting: string;
+    suggestions: string[];
+    primaryColor?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/react/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * UI-facing types for React hooks. Distinct from the SDK transport types
+ * (which are in src/types.ts) — these include UI metadata like display
+ * labels and durations for status pills.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/react/types.js.map

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

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

@@ -0,0 +1,27 @@
+import type { UIChatMessage, AgentConfig } from './types';
+import type { VoiceMessage, VoiceStatus } from './use-voice';
+export interface UseChanlOptions {
+    agentId: string;
+    apiKey: string;
+    baseUrl?: string;
+    greeting?: string;
+    debug?: boolean;
+}
+export interface UseChanlReturn {
+    messages: UIChatMessage[];
+    isTyping: boolean;
+    send: (text: string) => void;
+    sessionReady: boolean;
+    agentConfig: AgentConfig | null;
+    voiceState: VoiceStatus;
+    startVoice: (agentId?: string) => void;
+    stopVoice: () => void;
+    toggleMute: () => void;
+    isMuted: boolean;
+    isAgentSpeaking: boolean;
+    duration: number;
+    voiceMessages: VoiceMessage[];
+    error: string | null;
+}
+export declare function useChanl(opts: UseChanlOptions): UseChanlReturn;
+//# sourceMappingURL=use-chanl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-chanl.d.ts","sourceRoot":"","sources":["../../src/react/use-chanl.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAE7B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAGhC,UAAU,EAAE,WAAW,CAAC;IACxB,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,YAAY,EAAE,CAAC;IAG9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAmC9D"}

package/dist/react/use-chanl.js

@@ -0,0 +1,57 @@
+"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChanl = useChanl;
+/**
+ * useChanl — unified text + voice React hook.
+ *
+ * Thin wrapper over useChat + useVoice so consumers can drive both modalities
+ * from a single hook. For voice-only or text-only use cases, import the
+ * dedicated hook directly (smaller bundle, clearer types).
+ *
+ * Usage:
+ *   const {
+ *     // text
+ *     messages, isTyping, send, sessionReady, agentConfig,
+ *     // voice
+ *     voiceState, startVoice, stopVoice, toggleMute, isMuted,
+ *     isAgentSpeaking, duration, voiceMessages,
+ *     // shared
+ *     error,
+ *   } = useChanl({ agentId, apiKey });
+ */
+const use_chat_1 = require("./use-chat");
+const use_voice_1 = require("./use-voice");
+function useChanl(opts) {
+    const chat = (0, use_chat_1.useChat)({
+        agentId: opts.agentId,
+        apiKey: opts.apiKey,
+        baseUrl: opts.baseUrl,
+        greeting: opts.greeting,
+    });
+    const voice = (0, use_voice_1.useVoice)({
+        apiKey: opts.apiKey,
+        baseUrl: opts.baseUrl,
+        debug: opts.debug,
+    });
+    return {
+        // text
+        messages: chat.messages,
+        isTyping: chat.isTyping,
+        send: chat.send,
+        sessionReady: chat.sessionReady,
+        agentConfig: chat.agentConfig,
+        // voice — default to the hook's configured agentId unless caller overrides
+        voiceState: voice.status,
+        startVoice: (agentId) => voice.start(agentId ?? opts.agentId),
+        stopVoice: voice.stop,
+        toggleMute: voice.toggleMute,
+        isMuted: voice.isMuted,
+        isAgentSpeaking: voice.isAgentSpeaking,
+        duration: voice.duration,
+        voiceMessages: voice.messages,
+        // shared — prefer chat error, fall back to voice error message
+        error: chat.error ?? voice.lastError?.message ?? null,
+    };
+}
+//# sourceMappingURL=use-chanl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-chanl.js","sourceRoot":"","sources":["../../src/react/use-chanl.ts"],"names":[],"mappings":";AAAA,YAAY,CAAC;;AAwDb,4BAmCC;AAzFD;;;;;;;;;;;;;;;;;GAiBG;AAEH,yCAAqC;AACrC,2CAAuC;AAkCvC,SAAgB,QAAQ,CAAC,IAAqB;IAC5C,MAAM,IAAI,GAAG,IAAA,kBAAO,EAAC;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAA,oBAAQ,EAAC;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAE7B,2EAA2E;QAC3E,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,UAAU,EAAE,CAAC,OAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;QACtE,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,aAAa,EAAE,KAAK,CAAC,QAAQ;QAE7B,+DAA+D;QAC/D,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,EAAE,OAAO,IAAI,IAAI;KACtD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,32 @@
+import type { ChanlUser } from '../types';
+import type { AgentConfig, UIChatMessage as ChatMessage } from './types';
+interface UseChat {
+    messages: ChatMessage[];
+    isTyping: boolean;
+    error: string | null;
+    send: (text: string) => void;
+    sessionReady: boolean;
+    agentConfig: AgentConfig | null;
+}
+interface UseChatOptions {
+    agentId: string;
+    apiKey: string;
+    baseUrl?: string;
+    greeting?: string;
+    /**
+     * Identified end-user — Intercom-style widget identity path.
+     * When present, the backend verifies `userHash` + upserts a Customer by
+     * externalId + exposes attributes as `{{customer:<key>}}` prompt variables.
+     * Changing `user.externalId` recreates the session.
+     */
+    user?: ChanlUser;
+    /** HMAC-SHA256 of `user.externalId` using workspace identity secret. */
+    userHash?: string;
+    /** Optional extra variables merged into prompt substitution. */
+    variables?: Record<string, string>;
+    /** Optional metadata (pageUrl, source, etc.). */
+    metadata?: Record<string, unknown>;
+}
+export declare function useChat({ agentId, apiKey, baseUrl, greeting, user, userHash, variables, metadata, }: UseChatOptions): UseChat;
+export {};
+//# sourceMappingURL=use-chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat.d.ts","sourceRoot":"","sources":["../../src/react/use-chat.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAIzE,UAAU,OAAO;IACf,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;CACjC;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAwBD,wBAAgB,OAAO,CAAC,EACtB,OAAO,EACP,MAAM,EACN,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,EAAE,cAAc,GAAG,OAAO,CAwN1B"}