@convai/web-sdk 1.8.0-beta.5 → 1.8.0-beta.7

package/dist/vanilla/WidgetEventSubscriptions.d.ts

@@ -0,0 +1,15 @@
+type WidgetEventListener = (...args: unknown[]) => void;
+type SubscribeToWidgetEvent = (listener: WidgetEventListener) => (() => void) | void;
+/**
+ * Owns widget event listeners so a destroyed widget cannot mutate detached DOM
+ * or notify its host when a client event arrives late.
+ */
+export declare class WidgetEventSubscriptions {
+    private readonly isDestroyed;
+    private readonly unsubscribes;
+    constructor(isDestroyed: () => boolean);
+    register(subscribe: SubscribeToWidgetEvent, listener: WidgetEventListener): void;
+    unsubscribeAll(): void;
+}
+export {};
+//# sourceMappingURL=WidgetEventSubscriptions.d.ts.map

package/dist/vanilla/WidgetEventSubscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetEventSubscriptions.d.ts","sourceRoot":"","sources":["../../src/vanilla/WidgetEventSubscriptions.ts"],"names":[],"mappings":"AAAA,KAAK,mBAAmB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AACxD,KAAK,sBAAsB,GAAG,CAAC,QAAQ,EAAE,mBAAmB,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;AAErF;;;GAGG;AACH,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAFxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAEzB,WAAW,EAAE,MAAM,OAAO;IAEvD,QAAQ,CACN,SAAS,EAAE,sBAAsB,EACjC,QAAQ,EAAE,mBAAmB,GAC5B,IAAI;IAuBP,cAAc,IAAI,IAAI;CAKvB"}

package/dist/vanilla/WidgetEventSubscriptions.js

@@ -0,0 +1,37 @@
+/**
+ * Owns widget event listeners so a destroyed widget cannot mutate detached DOM
+ * or notify its host when a client event arrives late.
+ */
+export class WidgetEventSubscriptions {
+    constructor(isDestroyed) {
+        this.isDestroyed = isDestroyed;
+        this.unsubscribes = [];
+    }
+    register(subscribe, listener) {
+        if (this.isDestroyed())
+            return;
+        const unsubscribe = subscribe((...args) => {
+            if (!this.isDestroyed()) {
+                listener(...args);
+            }
+        });
+        // A hand-rolled IConvaiClient (the vanilla types allow one) may return
+        // nothing from on(); there is then nothing to tear down, and that is not
+        // an error -- the isDestroyed gate above still silences its listener.
+        if (typeof unsubscribe !== "function")
+            return;
+        // The browser event loop cannot interleave normal synchronous code, but
+        // preserve the lifecycle boundary for unusual synchronous subscriptions.
+        if (this.isDestroyed()) {
+            unsubscribe();
+            return;
+        }
+        this.unsubscribes.push(unsubscribe);
+    }
+    unsubscribeAll() {
+        for (const unsubscribe of this.unsubscribes.splice(0)) {
+            unsubscribe();
+        }
+    }
+}
+//# sourceMappingURL=WidgetEventSubscriptions.js.map

package/dist/vanilla/WidgetEventSubscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetEventSubscriptions.js","sourceRoot":"","sources":["../../src/vanilla/WidgetEventSubscriptions.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,wBAAwB;IAGnC,YAA6B,WAA0B;QAA1B,gBAAW,GAAX,WAAW,CAAe;QAFtC,iBAAY,GAAsB,EAAE,CAAC;IAEI,CAAC;IAE3D,QAAQ,CACN,SAAiC,EACjC,QAA6B;QAE7B,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO;QAE/B,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE;YACxC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,uEAAuE;QACvE,yEAAyE;QACzE,sEAAsE;QACtE,IAAI,OAAO,WAAW,KAAK,UAAU;YAAE,OAAO;QAE9C,wEAAwE;QACxE,yEAAyE;QACzE,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,WAAW,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,cAAc;QACZ,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;CACF","sourcesContent":["type WidgetEventListener = (...args: unknown[]) => void;\ntype SubscribeToWidgetEvent = (listener: WidgetEventListener) => (() => void) | void;\n\n/**\n * Owns widget event listeners so a destroyed widget cannot mutate detached DOM\n * or notify its host when a client event arrives late.\n */\nexport class WidgetEventSubscriptions {\n  private readonly unsubscribes: Array<() => void> = [];\n\n  constructor(private readonly isDestroyed: () => boolean) {}\n\n  register(\n    subscribe: SubscribeToWidgetEvent,\n    listener: WidgetEventListener,\n  ): void {\n    if (this.isDestroyed()) return;\n\n    const unsubscribe = subscribe((...args) => {\n      if (!this.isDestroyed()) {\n        listener(...args);\n      }\n    });\n\n    // A hand-rolled IConvaiClient (the vanilla types allow one) may return\n    // nothing from on(); there is then nothing to tear down, and that is not\n    // an error -- the isDestroyed gate above still silences its listener.\n    if (typeof unsubscribe !== \"function\") return;\n\n    // The browser event loop cannot interleave normal synchronous code, but\n    // preserve the lifecycle boundary for unusual synchronous subscriptions.\n    if (this.isDestroyed()) {\n      unsubscribe();\n      return;\n    }\n    this.unsubscribes.push(unsubscribe);\n  }\n\n  unsubscribeAll(): void {\n    for (const unsubscribe of this.unsubscribes.splice(0)) {\n      unsubscribe();\n    }\n  }\n}\n"]}

package/dist/vanilla/index.d.ts

@@ -28,8 +28,9 @@
  * // - client.audioControls, videoControls, etc.
  * ```
  */
-export { ConvaiClient } from '../core/ConvaiClient.js';
+export { ActionResultAckError, ConvaiClient } from '../core/ConvaiClient.js';
 export { CharacterVersionManager, CharacterApiError } from '../core/CharacterVersionManager.js';
+export { ConvaiRoomError } from '../core/ConvaiRoomError.js';
 export { AudioRenderer } from './AudioRenderer.js';
 export { createConvaiWidget, destroyConvaiWidget } from './ConvaiWidget.js';
 export * from '../core/types.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vanilla/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAG7F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGzE,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vanilla/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGzE,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/vanilla/index.js

@@ -29,8 +29,9 @@
  * ```
  */
 // Main client for managing connections
-export { ConvaiClient } from '../core/ConvaiClient.js';
+export { ActionResultAckError, ConvaiClient } from '../core/ConvaiClient.js';
 export { CharacterVersionManager, CharacterApiError } from '../core/CharacterVersionManager.js';
+export { ConvaiRoomError } from '../core/ConvaiRoomError.js';
 // AudioRenderer for custom UI builders (handles audio playback)
 export { AudioRenderer } from './AudioRenderer.js';
 // Vanilla widget - complete UI solution

package/dist/vanilla/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vanilla/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAE7F,gEAAgE;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,wCAAwC;AACxC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEzE,0DAA0D;AAC1D,cAAc,eAAe,CAAC","sourcesContent":["/**\n * Convai Web SDK - Vanilla JavaScript/TypeScript Export\n * \n * This module provides vanilla JS/TS exports for the Convai SDK.\n * Use this for non-React applications.\n * \n * @example\n * ```typescript\n * import { ConvaiClient, createConvaiWidget } from '@convai/web-sdk/vanilla';\n * \n * // Pass config to constructor (same pattern as React's useConvaiClient)\n * const client = new ConvaiClient({\n *   apiKey: 'your-api-key',\n *   characterId: 'your-character-id',\n *   enableVideo: true,\n * });\n * \n * // Create widget - auto-connects on first click\n * const widget = createConvaiWidget(document.body, {\n *   convaiClient: client\n * });\n * \n * // Client has all functions for advanced usage:\n * // - client.connect() - manual connection\n * // - client.disconnect() - disconnect\n * // - client.reconnect() - reconnect\n * // - client.sendUserTextMessage() - send messages\n * // - client.audioControls, videoControls, etc.\n * ```\n */\n\n// Main client for managing connections\nexport { ConvaiClient } from '../core/ConvaiClient';\nexport { CharacterVersionManager, CharacterApiError } from '../core/CharacterVersionManager';\n\n// AudioRenderer for custom UI builders (handles audio playback)\nexport { AudioRenderer } from './AudioRenderer';\n\n// Vanilla widget - complete UI solution\nexport { createConvaiWidget, destroyConvaiWidget } from './ConvaiWidget';\n\n// Re-export ALL core types for complete parity with React\nexport * from '../core/types';\n\n// Widget-specific types\nexport type {\n  VanillaWidget,\n  VanillaWidgetOptions,\n  WidgetPlacement,\n} from './types';\n\n\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vanilla/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,uCAAuC;AACvC,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,gEAAgE;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,wCAAwC;AACxC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEzE,0DAA0D;AAC1D,cAAc,eAAe,CAAC","sourcesContent":["/**\n * Convai Web SDK - Vanilla JavaScript/TypeScript Export\n * \n * This module provides vanilla JS/TS exports for the Convai SDK.\n * Use this for non-React applications.\n * \n * @example\n * ```typescript\n * import { ConvaiClient, createConvaiWidget } from '@convai/web-sdk/vanilla';\n * \n * // Pass config to constructor (same pattern as React's useConvaiClient)\n * const client = new ConvaiClient({\n *   apiKey: 'your-api-key',\n *   characterId: 'your-character-id',\n *   enableVideo: true,\n * });\n * \n * // Create widget - auto-connects on first click\n * const widget = createConvaiWidget(document.body, {\n *   convaiClient: client\n * });\n * \n * // Client has all functions for advanced usage:\n * // - client.connect() - manual connection\n * // - client.disconnect() - disconnect\n * // - client.reconnect() - reconnect\n * // - client.sendUserTextMessage() - send messages\n * // - client.audioControls, videoControls, etc.\n * ```\n */\n\n// Main client for managing connections\nexport { ActionResultAckError, ConvaiClient } from '../core/ConvaiClient';\nexport { CharacterVersionManager, CharacterApiError } from '../core/CharacterVersionManager';\nexport { ConvaiRoomError } from '../core/ConvaiRoomError';\n\n// AudioRenderer for custom UI builders (handles audio playback)\nexport { AudioRenderer } from './AudioRenderer';\n\n// Vanilla widget - complete UI solution\nexport { createConvaiWidget, destroyConvaiWidget } from './ConvaiWidget';\n\n// Re-export ALL core types for complete parity with React\nexport * from '../core/types';\n\n// Widget-specific types\nexport type {\n  VanillaWidget,\n  VanillaWidgetOptions,\n  WidgetPlacement,\n} from './types';\n\n"]}

package/dist/vanilla/types.d.ts

@@ -1,4 +1,5 @@
-import type { IConvaiClient, ChatMessage } from '../core/types.js';
+import type { IConvaiClient, ChatMessage, PublishedChatConnectOptions } from '../core/types.js';
+import type { PublishedChatDescriptor } from '../embed/publicationApi.js';
 /** Where the widget anchors itself. `inline` renders it in normal document flow. */
 export type WidgetPlacement = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | 'inline';
 /**
@@ -67,6 +68,12 @@ export interface VanillaWidgetOptions {
      * When true, the widget will open directly in voice mode with microphone enabled.
      */
     defaultVoiceMode?: boolean;
+    /** Mint a fresh single-use grant when a published-chat session is reopened. */
+    requestPublicationGrant?: () => Promise<string>;
+    /** Core endpoint override used with requestPublicationGrant. */
+    publishedChatConnectOptions?: PublishedChatConnectOptions;
+    /** Public descriptor used to label a credential-free published session. */
+    publishedChatDescriptor?: Pick<PublishedChatDescriptor, 'display_name' | 'image_url'>;
     /**
      * Where the widget's `<style>` and `@keyframes` nodes are injected.
      *

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

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

package/dist/vanilla/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/vanilla/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { IConvaiClient, ChatMessage } from '../core/types';\n\n/** Where the widget anchors itself. `inline` renders it in normal document flow. */\nexport type WidgetPlacement =\n  | 'bottom-right'\n  | 'bottom-left'\n  | 'top-right'\n  | 'top-left'\n  | 'inline';\n\n/**\n * Options for creating a vanilla ConvaiWidget\n * \n * You can either:\n * 1. Pass an existing convaiClient instance, OR\n * 2. Pass connection config (apiKey, characterId, etc.) directly\n */\nexport interface VanillaWidgetOptions {\n  /** \n   * Option 1: Pass an existing Convai client instance.\n   * Should be initialized with config: new ConvaiClient({ apiKey, characterId, ... })\n   * The widget will auto-connect on first click.\n   */\n  convaiClient?: IConvaiClient & {\n    activity?: string;\n    chatMessages: ChatMessage[];\n    /**\n     * Present on the real `ConvaiClient` (it extends `EventEmitter`) and on\n     * the test stubs; absent only if a caller hand-rolls a minimal\n     * `IConvaiClient`. Optional so that case still type-checks -- the widget\n     * calls it defensively (`client.emit?.(...)`) to surface mic-permission\n     * failures on the same `error` channel `ConvaiClient` already uses.\n     */\n    emit?: (event: string, ...args: any[]) => void;\n  };\n  \n  /** Option 2: Pass connection config directly (convenience shortcut). Either apiKey or authToken is required. */\n  apiKey?: string;\n  /** Auth token for realtime API (alternative to apiKey). See https://realtime-api.convai.com/docs */\n  authToken?: string;\n  characterId?: string;\n  enableVideo?: boolean;\n  startWithVideoOn?: boolean;\n  /** Enable lipsync/facial animation blendshapes (default: false) */\n  enableLipsync?: boolean;\n  /** Enable emotion detection and bot-emotion updates (default: false) */\n  enableEmotion?: boolean;\n  /** Log incoming and outgoing decoded RTVI data messages to the browser console (default: true) */\n  logRtviMessages?: boolean;\n  /** Blendshape configuration for facial animation format */\n  blendshapeConfig?: {\n    /** Format of blendshapes: \"arkit\" or \"mha\" (Meta Human Animation, default: \"mha\") */\n    format?: \"arkit\" | \"mha\";\n    /** Custom mapper function to transform incoming blendshapes */\n    customMapper?: (input: number[] | Float32Array) => Float32Array;\n    /** Indexed NeuroSync ahead-delivery. Defaults to true; set false for the legacy paced path. */\n    deliver_chunks_ahead?: boolean;\n    /** Ahead-delivery timeline FPS override; ignored when deliver_chunks_ahead is false. */\n    output_fps?: number;\n    /** Seconds the server buffers blendshapes before releasing them. */\n    frames_buffer_duration?: number;\n  };\n  \n  /** \n   * Show video toggle button in settings (default: true).\n   * Only works if connection type is \"video\". If false, hides the video button.\n   */\n  showVideo?: boolean;\n  /** \n   * Show screen share toggle button in settings (default: true).\n   * Only works if connection type is \"video\". If false, hides the screen share button.\n   */\n  showScreenShare?: boolean;\n  /**\n   * Start in voice mode by default when widget opens (default: true).\n   * When true, the widget will open directly in voice mode with microphone enabled.\n   */\n  defaultVoiceMode?: boolean;\n  \n  /**\n   * Where the widget's `<style>` and `@keyframes` nodes are injected.\n   *\n   * Omit it and the target is derived from `container.getRootNode()` at\n   * construction time — correct only when the container is *already* inside\n   * its final root. A custom element that builds its subtree first and appends\n   * it to its shadow root afterwards (the usual pattern) constructs the widget\n   * while the container is still detached, so the derivation sees the\n   * document and the shadow root never receives the stylesheet or the `popIn`\n   * keyframes — silently, with no error. Pass the shadow root here in that\n   * case; when supplied it is used verbatim and no derivation happens.\n   */\n  styleTarget?: Document | ShadowRoot;\n\n  /** Corner to anchor to, or `inline` for normal flow. Default `bottom-right`. */\n  placement?: WidgetPlacement;\n\n  /** Optional callbacks */\n  onConnect?: () => void;\n  onDisconnect?: () => void;\n  onMessage?: (message: ChatMessage) => void;\n}\n\n/**\n * Vanilla ConvaiWidget instance with cleanup method\n */\nexport interface VanillaWidget {\n  /** Root DOM element of the widget */\n  element: HTMLElement;\n  /** Cleanup and destroy the widget */\n  destroy: () => void;\n  /** The Convai client instance */\n  client: IConvaiClient & {\n    activity?: string;\n    chatMessages: ChatMessage[];\n    emit?: (event: string, ...args: any[]) => void;\n  };\n  /** Update widget state (for future extensions) */\n  update?: (options: Partial<VanillaWidgetOptions>) => void;\n\n  /**\n   * Open the panel. Drives the same internal open path as the launcher\n   * click (connect-on-first-open, then the morph to the panel). Idempotent:\n   * calling `open()` while already open — or while a first open is still\n   * waiting on `connect()` — is a no-op. It will not re-run the morph\n   * animation, and it will not start a second connect.\n   */\n  open: () => void;\n  /**\n   * Close the panel. Drives the same internal path as the header's close\n   * button. Idempotent: calling `close()` while already closed is a no-op.\n   *\n   * Called while a first open is still connecting, it *cancels* that open:\n   * the connect completes (the client ends up connected) but the panel stays\n   * collapsed rather than popping open once the promise resolves.\n   */\n  close: () => void;\n  /**\n   * Toggle the panel open or closed, per the current {@link isOpen} state.\n   * Mid-connect this closes — i.e. a second click cancels the open in flight,\n   * rather than queueing a second one.\n   */\n  toggle: () => void;\n  /**\n   * Whether the panel is open, or is opening. This is *requested* state, and\n   * it updates synchronously: `widget.open(); widget.isOpen` is always `true`,\n   * including on a cold client where the panel is only committed once\n   * `connect()` resolves seconds later. Cancelling that open (via `close()`,\n   * `toggle()`, or a second launcher click) returns it to `false`\n   * immediately.\n   *\n   * The distinction matters only for the first open on a disconnected client;\n   * every other transition is synchronous, so rendered and requested state\n   * coincide. Consumers reconciling their own open/close events against this\n   * flag get the answer that matches the user's last instruction, not the\n   * animation frame.\n   */\n  readonly isOpen: boolean;\n  /**\n   * Insert a message into the transcript locally, without sending it to the\n   * character. Use this for client-side lines — e.g. a greeting — that must\n   * appear in the chat but must never reach the LLM and must never be billed\n   * as a turn. This is not `sendUserTextMessage`: nothing is transmitted.\n   */\n  appendMessage: (message: { sender: \"user\" | \"bot\"; content: string }) => void;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/vanilla/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  IConvaiClient,\n  ChatMessage,\n  PublishedChatConnectOptions,\n} from '../core/types';\nimport type { PublishedChatDescriptor } from '../embed/publicationApi';\n\n/** Where the widget anchors itself. `inline` renders it in normal document flow. */\nexport type WidgetPlacement =\n  | 'bottom-right'\n  | 'bottom-left'\n  | 'top-right'\n  | 'top-left'\n  | 'inline';\n\n/**\n * Options for creating a vanilla ConvaiWidget\n * \n * You can either:\n * 1. Pass an existing convaiClient instance, OR\n * 2. Pass connection config (apiKey, characterId, etc.) directly\n */\nexport interface VanillaWidgetOptions {\n  /** \n   * Option 1: Pass an existing Convai client instance.\n   * Should be initialized with config: new ConvaiClient({ apiKey, characterId, ... })\n   * The widget will auto-connect on first click.\n   */\n  convaiClient?: IConvaiClient & {\n    activity?: string;\n    chatMessages: ChatMessage[];\n    /**\n     * Present on the real `ConvaiClient` (it extends `EventEmitter`) and on\n     * the test stubs; absent only if a caller hand-rolls a minimal\n     * `IConvaiClient`. Optional so that case still type-checks -- the widget\n     * calls it defensively (`client.emit?.(...)`) to surface mic-permission\n     * failures on the same `error` channel `ConvaiClient` already uses.\n     */\n    emit?: (event: string, ...args: any[]) => void;\n  };\n  \n  /** Option 2: Pass connection config directly (convenience shortcut). Either apiKey or authToken is required. */\n  apiKey?: string;\n  /** Auth token for realtime API (alternative to apiKey). See https://realtime-api.convai.com/docs */\n  authToken?: string;\n  characterId?: string;\n  enableVideo?: boolean;\n  startWithVideoOn?: boolean;\n  /** Enable lipsync/facial animation blendshapes (default: false) */\n  enableLipsync?: boolean;\n  /** Enable emotion detection and bot-emotion updates (default: false) */\n  enableEmotion?: boolean;\n  /** Log incoming and outgoing decoded RTVI data messages to the browser console (default: true) */\n  logRtviMessages?: boolean;\n  /** Blendshape configuration for facial animation format */\n  blendshapeConfig?: {\n    /** Format of blendshapes: \"arkit\" or \"mha\" (Meta Human Animation, default: \"mha\") */\n    format?: \"arkit\" | \"mha\";\n    /** Custom mapper function to transform incoming blendshapes */\n    customMapper?: (input: number[] | Float32Array) => Float32Array;\n    /** Indexed NeuroSync ahead-delivery. Defaults to true; set false for the legacy paced path. */\n    deliver_chunks_ahead?: boolean;\n    /** Ahead-delivery timeline FPS override; ignored when deliver_chunks_ahead is false. */\n    output_fps?: number;\n    /** Seconds the server buffers blendshapes before releasing them. */\n    frames_buffer_duration?: number;\n  };\n  \n  /** \n   * Show video toggle button in settings (default: true).\n   * Only works if connection type is \"video\". If false, hides the video button.\n   */\n  showVideo?: boolean;\n  /** \n   * Show screen share toggle button in settings (default: true).\n   * Only works if connection type is \"video\". If false, hides the screen share button.\n   */\n  showScreenShare?: boolean;\n  /**\n   * Start in voice mode by default when widget opens (default: true).\n   * When true, the widget will open directly in voice mode with microphone enabled.\n   */\n  defaultVoiceMode?: boolean;\n  /** Mint a fresh single-use grant when a published-chat session is reopened. */\n  requestPublicationGrant?: () => Promise<string>;\n  /** Core endpoint override used with requestPublicationGrant. */\n  publishedChatConnectOptions?: PublishedChatConnectOptions;\n  /** Public descriptor used to label a credential-free published session. */\n  publishedChatDescriptor?: Pick<\n    PublishedChatDescriptor,\n    'display_name' | 'image_url'\n  >;\n  \n  /**\n   * Where the widget's `<style>` and `@keyframes` nodes are injected.\n   *\n   * Omit it and the target is derived from `container.getRootNode()` at\n   * construction time — correct only when the container is *already* inside\n   * its final root. A custom element that builds its subtree first and appends\n   * it to its shadow root afterwards (the usual pattern) constructs the widget\n   * while the container is still detached, so the derivation sees the\n   * document and the shadow root never receives the stylesheet or the `popIn`\n   * keyframes — silently, with no error. Pass the shadow root here in that\n   * case; when supplied it is used verbatim and no derivation happens.\n   */\n  styleTarget?: Document | ShadowRoot;\n\n  /** Corner to anchor to, or `inline` for normal flow. Default `bottom-right`. */\n  placement?: WidgetPlacement;\n\n  /** Optional callbacks */\n  onConnect?: () => void;\n  onDisconnect?: () => void;\n  onMessage?: (message: ChatMessage) => void;\n}\n\n/**\n * Vanilla ConvaiWidget instance with cleanup method\n */\nexport interface VanillaWidget {\n  /** Root DOM element of the widget */\n  element: HTMLElement;\n  /** Cleanup and destroy the widget */\n  destroy: () => void;\n  /** The Convai client instance */\n  client: IConvaiClient & {\n    activity?: string;\n    chatMessages: ChatMessage[];\n    emit?: (event: string, ...args: any[]) => void;\n  };\n  /** Update widget state (for future extensions) */\n  update?: (options: Partial<VanillaWidgetOptions>) => void;\n\n  /**\n   * Open the panel. Drives the same internal open path as the launcher\n   * click (connect-on-first-open, then the morph to the panel). Idempotent:\n   * calling `open()` while already open — or while a first open is still\n   * waiting on `connect()` — is a no-op. It will not re-run the morph\n   * animation, and it will not start a second connect.\n   */\n  open: () => void;\n  /**\n   * Close the panel. Drives the same internal path as the header's close\n   * button. Idempotent: calling `close()` while already closed is a no-op.\n   *\n   * Called while a first open is still connecting, it *cancels* that open:\n   * the connect completes (the client ends up connected) but the panel stays\n   * collapsed rather than popping open once the promise resolves.\n   */\n  close: () => void;\n  /**\n   * Toggle the panel open or closed, per the current {@link isOpen} state.\n   * Mid-connect this closes — i.e. a second click cancels the open in flight,\n   * rather than queueing a second one.\n   */\n  toggle: () => void;\n  /**\n   * Whether the panel is open, or is opening. This is *requested* state, and\n   * it updates synchronously: `widget.open(); widget.isOpen` is always `true`,\n   * including on a cold client where the panel is only committed once\n   * `connect()` resolves seconds later. Cancelling that open (via `close()`,\n   * `toggle()`, or a second launcher click) returns it to `false`\n   * immediately.\n   *\n   * The distinction matters only for the first open on a disconnected client;\n   * every other transition is synchronous, so rendered and requested state\n   * coincide. Consumers reconciling their own open/close events against this\n   * flag get the answer that matches the user's last instruction, not the\n   * animation frame.\n   */\n  readonly isOpen: boolean;\n  /**\n   * Insert a message into the transcript locally, without sending it to the\n   * character. Use this for client-side lines — e.g. a greeting — that must\n   * appear in the chat but must never reach the LLM and must never be billed\n   * as a turn. This is not `sendUserTextMessage`: nothing is transmitted.\n   */\n  appendMessage: (message: { sender: \"user\" | \"bot\"; content: string }) => void;\n}\n"]}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "1.8.0-beta.5";
+export declare const SDK_VERSION = "1.8.0-beta.7";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,4 +1,4 @@
 // GENERATED by scripts/sync-version.mjs — do not edit by hand.
 // Regenerated from package.json on every build.
-export const SDK_VERSION = "1.8.0-beta.5";
+export const SDK_VERSION = "1.8.0-beta.7";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gDAAgD;AAChD,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC","sourcesContent":["// GENERATED by scripts/sync-version.mjs — do not edit by hand.\n// Regenerated from package.json on every build.\nexport const SDK_VERSION = \"1.8.0-beta.5\";\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gDAAgD;AAChD,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC","sourcesContent":["// GENERATED by scripts/sync-version.mjs — do not edit by hand.\n// Regenerated from package.json on every build.\nexport const SDK_VERSION = \"1.8.0-beta.7\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@convai/web-sdk",
-  "version": "1.8.0-beta.5",
+  "version": "1.8.0-beta.7",
   "description": "Build web apps with lifelike AI characters. The Convai Web SDK gives you real-time voice, lipsync, emotions, and dynamic context — with first-class support for React and vanilla TypeScript.",
   "private": false,
   "type": "module",
@@ -24,6 +24,14 @@
       "import": "./dist/vanilla/websocket.js",
       "types": "./dist/vanilla/websocket.d.ts"
     },
+    "./embed": {
+      "import": "./dist/embed/index.js",
+      "types": "./dist/embed/index.d.ts"
+    },
+    "./embed/browser": {
+      "import": "./dist/embed/chat-embed-v1.js",
+      "types": "./dist/embed/browser.d.ts"
+    },
     "./react": {
       "import": "./dist/react/index.js",
       "types": "./dist/react/index.d.ts"
@@ -35,23 +43,28 @@
     "./package.json": "./package.json"
   },
   "sideEffects": [
+    "./dist/embed/browser.js",
+    "./dist/embed/chat-embed-v1.js",
     "./dist/vanilla/websocket.js",
+    "./src/embed/browser.ts",
     "./src/vanilla/websocket.ts"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "node scripts/sync-version.mjs && tsc -p tsconfig.build.json && node scripts/fix-dist-extensions.mjs && pnpm typecheck:downstream",
-    "build:fast": "node scripts/sync-version.mjs && tsc -p tsconfig.build.json && node scripts/fix-dist-extensions.mjs",
-    "build:prod": "node scripts/sync-version.mjs && NODE_ENV=production tsc -p tsconfig.build.json && node scripts/fix-dist-extensions.mjs && pnpm typecheck:downstream",
+    "build": "node scripts/sync-version.mjs && tsc -p tsconfig.build.json && node scripts/fix-dist-extensions.mjs && pnpm build:embed && pnpm typecheck:downstream",
+    "build:fast": "node scripts/sync-version.mjs && tsc -p tsconfig.build.json && node scripts/fix-dist-extensions.mjs && pnpm build:embed",
+    "build:prod": "node scripts/sync-version.mjs && NODE_ENV=production tsc -p tsconfig.build.json && node scripts/fix-dist-extensions.mjs && pnpm build:embed && pnpm typecheck:downstream",
+    "build:embed": "esbuild src/embed/browser.ts --bundle --format=esm --platform=browser --target=es2020 --outfile=dist/embed/chat-embed-v1.js --minify --sourcemap",
     "dev": "tsc -p tsconfig.build.json --watch",
     "clean": "rimraf dist",
     "fix:ext": "node scripts/fix-dist-extensions.mjs",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:protocol": "tsc && node --test tests/modelOutput.test.mjs tests/actionResultAck.test.mjs tests/visionPromptMode.test.mjs",
     "typecheck:downstream": "pnpm -r --filter './examples/**' exec tsc -b --noEmit && pnpm -r --filter './doc-tests/**' exec tsc --noEmit",
     "typecheck:all": "pnpm typecheck && pnpm typecheck:downstream",
-    "test": "vitest run",
     "test:watch": "vitest",
     "verify": "vitest run && tsc && tsc -p tsconfig.build.json && pnpm -r --filter './doc-tests/**' exec tsc --noEmit",
     "test:lipsync": "tsc && node scripts/test-neurosync-ahead.mjs",
@@ -129,7 +142,7 @@
     "happy-dom": "^15.11.7",
     "rimraf": "^5.0.0",
     "typescript": "^5.7.3",
-    "vitest": "^2.1.9"
+    "vitest": "^3.2.4"
   },
   "files": [
     "dist",