@convai/web-sdk 0.0.4-beta.1 → 0.1.1-beta.0

package/dist/react/hooks/useConvaiClient.d.ts

@@ -0,0 +1,32 @@
+import type { ConvaiConfig, IConvaiClient, ChatMessage } from "../../core/types";
+/**
+ * React hook wrapper for ConvaiClient
+ * Main hook for managing Convai client connection and functionality.
+ *
+ * Provides a complete interface for connecting to Convai's AI-powered voice assistants,
+ * managing real-time audio/video conversations, and handling various message types.
+ *
+ * @param config - Optional configuration to store for later connection
+ * @returns {ConvaiClient & { activity: string; chatMessages: ChatMessage[] }} Complete client interface with connection state, methods, and message history
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const convaiClient = useConvaiClient({
+ *     apiKey: 'your-api-key',
+ *     characterId: 'your-character-id',
+ *     endUserId: 'user-uuid', // Optional: enables memory & analytics
+ *     enableVideo: true,
+ *   });
+ *
+ *   return (
+ *     <ConvaiWidget convaiClient={convaiClient} />
+ *   );
+ * }
+ * ```
+ */
+export declare const useConvaiClient: (config?: ConvaiConfig) => IConvaiClient & {
+    activity: string;
+    chatMessages: ChatMessage[];
+};
+//# sourceMappingURL=useConvaiClient.d.ts.map

package/dist/react/hooks/useConvaiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConvaiClient.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useConvaiClient.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,YAAY,KAAG,aAAa,GAAG;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,WAAW,EAAE,CAAC;CA6H7B,CAAC"}

package/dist/react/hooks/useConvaiClient.js

@@ -0,0 +1,140 @@
+import { useState, useEffect, useCallback } from "react";
+import { ConvaiClient as CoreConvaiClient } from "../../core";
+/**
+ * React hook wrapper for ConvaiClient
+ * Main hook for managing Convai client connection and functionality.
+ *
+ * Provides a complete interface for connecting to Convai's AI-powered voice assistants,
+ * managing real-time audio/video conversations, and handling various message types.
+ *
+ * @param config - Optional configuration to store for later connection
+ * @returns {ConvaiClient & { activity: string; chatMessages: ChatMessage[] }} Complete client interface with connection state, methods, and message history
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const convaiClient = useConvaiClient({
+ *     apiKey: 'your-api-key',
+ *     characterId: 'your-character-id',
+ *     endUserId: 'user-uuid', // Optional: enables memory & analytics
+ *     enableVideo: true,
+ *   });
+ *
+ *   return (
+ *     <ConvaiWidget convaiClient={convaiClient} />
+ *   );
+ * }
+ * ```
+ */
+export const useConvaiClient = (config) => {
+    // Create client instance once
+    const [client] = useState(() => new CoreConvaiClient());
+    // React state for UI updates
+    const [state, setState] = useState(client.state);
+    const [activity, setActivity] = useState("Idle");
+    const [chatMessages, setChatMessages] = useState(client.chatMessages);
+    const [userTranscription, setUserTranscription] = useState(client.userTranscription);
+    const [isSpeaking, setIsSpeaking] = useState(false);
+    // Store config if provided
+    const [storedConfig] = useState(config);
+    // Setup event listeners
+    useEffect(() => {
+        // State change listener
+        const unsubStateChange = client.on('stateChange', (newState) => {
+            setState(newState);
+            // Update activity based on state
+            if (!newState.isConnected) {
+                setActivity("Disconnected");
+            }
+            else if (newState.isConnecting) {
+                setActivity("Connecting...");
+            }
+            else if (newState.isSpeaking) {
+                setActivity("Speaking");
+            }
+            else if (newState.isThinking) {
+                setActivity("Thinking");
+            }
+            else {
+                setActivity("Connected");
+            }
+        });
+        // Messages change listener
+        const unsubMessagesChange = client.on('messagesChange', (messages) => {
+            setChatMessages([...messages]);
+        });
+        // User transcription change listener
+        const unsubUserTranscription = client.on('userTranscriptionChange', (transcription) => {
+            setUserTranscription(transcription);
+        });
+        // Speaking change listener
+        const unsubSpeaking = client.on('speakingChange', (speaking) => {
+            setIsSpeaking(speaking);
+        });
+        // Bot ready listener
+        const unsubBotReady = client.on('botReady', () => {
+            setActivity("Connected");
+        });
+        // Connect listener
+        const unsubConnect = client.on('connect', () => {
+            setState(client.state);
+        });
+        // Disconnect listener
+        const unsubDisconnect = client.on('disconnect', () => {
+            setState(client.state);
+            setActivity("Disconnected");
+            setChatMessages([]);
+        });
+        // Cleanup listeners on unmount
+        return () => {
+            unsubStateChange();
+            unsubMessagesChange();
+            unsubUserTranscription();
+            unsubSpeaking();
+            unsubBotReady();
+            unsubConnect();
+            unsubDisconnect();
+        };
+    }, [client]);
+    // Create enhanced connect function that can use stored config  
+    const connect = useCallback(async (configOverride) => {
+        const finalConfig = configOverride || storedConfig;
+        if (!finalConfig) {
+            throw new Error("No configuration provided. Pass config to useConvaiClient() or to connect()");
+        }
+        await client.connect(finalConfig);
+    }, [client, storedConfig]);
+    // Create reconnect function wrapper
+    const reconnect = useCallback(async () => {
+        await client.reconnect();
+    }, [client]);
+    // Return client interface with React-friendly additions
+    return {
+        state,
+        connectionType: client.connectionType,
+        apiKey: client.apiKey,
+        characterId: client.characterId,
+        speakerId: client.speakerId,
+        connect,
+        disconnect: client.disconnect.bind(client),
+        reconnect,
+        resetSession: client.resetSession.bind(client),
+        room: client.room,
+        sendUserTextMessage: client.sendUserTextMessage.bind(client),
+        sendTriggerMessage: client.sendTriggerMessage.bind(client),
+        updateTemplateKeys: client.updateTemplateKeys.bind(client),
+        updateDynamicInfo: client.updateDynamicInfo.bind(client),
+        activity,
+        chatMessages,
+        userTranscription,
+        characterSessionId: client.characterSessionId,
+        isBotReady: client.isBotReady,
+        audioControls: client.audioControls,
+        videoControls: client.videoControls,
+        screenShareControls: client.screenShareControls,
+        toggleTts: client.toggleTts.bind(client),
+        on: client.on.bind(client),
+        off: client.off.bind(client),
+    };
+};
+//# sourceMappingURL=useConvaiClient.js.map

package/dist/react/hooks/useConvaiClient.js.map

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

package/dist/react/hooks/useLocalCameraTrack.d.ts

@@ -0,0 +1,22 @@
+import { TrackReferenceOrPlaceholder } from "@livekit/components-react";
+/**
+ * Hook to get the local camera track reference from LiveKit.
+ *
+ * Returns a track reference that can be used with LiveKit components
+ * to display the local participant's camera feed.
+ *
+ * @returns {TrackReferenceOrPlaceholder} Track reference for the local camera
+ *
+ * @example
+ * ```tsx
+ * function VideoComponent() {
+ *   const cameraTrackRef = useLocalCameraTrack();
+ *
+ *   return (
+ *     <VideoTrack trackRef={cameraTrackRef} />
+ *   );
+ * }
+ * ```
+ */
+export declare const useLocalCameraTrack: () => TrackReferenceOrPlaceholder;
+//# sourceMappingURL=useLocalCameraTrack.d.ts.map

package/dist/react/hooks/useLocalCameraTrack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalCameraTrack.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useLocalCameraTrack.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAE5B,MAAM,2BAA2B,CAAC;AAInC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,mCAY/B,CAAC"}

package/dist/react/hooks/useLocalCameraTrack.js

@@ -0,0 +1,34 @@
+import { useLocalParticipant, } from "@livekit/components-react";
+import { Track } from "livekit-client";
+import { useMemo } from "react";
+/**
+ * Hook to get the local camera track reference from LiveKit.
+ *
+ * Returns a track reference that can be used with LiveKit components
+ * to display the local participant's camera feed.
+ *
+ * @returns {TrackReferenceOrPlaceholder} Track reference for the local camera
+ *
+ * @example
+ * ```tsx
+ * function VideoComponent() {
+ *   const cameraTrackRef = useLocalCameraTrack();
+ *
+ *   return (
+ *     <VideoTrack trackRef={cameraTrackRef} />
+ *   );
+ * }
+ * ```
+ */
+export const useLocalCameraTrack = () => {
+    const { cameraTrack, localParticipant } = useLocalParticipant();
+    const cameraTrackRef = useMemo(() => {
+        return {
+            participant: localParticipant,
+            source: Track.Source.Camera,
+            publication: cameraTrack,
+        };
+    }, [localParticipant, cameraTrack]);
+    return cameraTrackRef;
+};
+//# sourceMappingURL=useLocalCameraTrack.js.map

package/dist/react/hooks/useLocalCameraTrack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalCameraTrack.js","sourceRoot":"","sources":["../../../src/react/hooks/useLocalCameraTrack.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE;IACtC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAEhE,MAAM,cAAc,GAAgC,OAAO,CAAC,GAAG,EAAE;QAC/D,OAAO;YACL,WAAW,EAAE,gBAAgB;YAC7B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAC3B,WAAW,EAAE,WAAW;SACzB,CAAC;IACJ,CAAC,EAAE,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC;IAEpC,OAAO,cAAc,CAAC;AACxB,CAAC,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,8 @@
+export { useConvaiClient } from './hooks/useConvaiClient';
+export { ConvaiWidget } from './components/ConvaiWidget';
+export * from './hooks';
+export * from './components/rtc-widget';
+export * from '../core/types';
+export { ConvaiClient } from '../core';
+export { RoomAudioRenderer as AudioRenderer, RoomContext as AudioContext } from '@livekit/components-react';
+//# 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":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,cAAc,SAAS,CAAC;AAGxB,cAAc,yBAAyB,CAAC;AAGxC,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAE,iBAAiB,IAAI,aAAa,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,15 @@
+// Main hook (backward compatible)
+export { useConvaiClient } from './hooks/useConvaiClient';
+// Components
+export { ConvaiWidget } from './components/ConvaiWidget';
+// Additional hooks (for advanced usage)
+export * from './hooks';
+// RTC widget components (for advanced usage)
+export * from './components/rtc-widget';
+// Re-export core types for convenience
+export * from '../core/types';
+// Re-export core client for advanced usage
+export { ConvaiClient } from '../core';
+// Re-export LiveKit components for convenience (backward compatible)
+export { RoomAudioRenderer as AudioRenderer, RoomContext as AudioContext } from '@livekit/components-react';
+//# 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,kCAAkC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,wCAAwC;AACxC,cAAc,SAAS,CAAC;AAExB,6CAA6C;AAC7C,cAAc,yBAAyB,CAAC;AAExC,uCAAuC;AACvC,cAAc,eAAe,CAAC;AAE9B,2CAA2C;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,qEAAqE;AACrE,OAAO,EAAE,iBAAiB,IAAI,aAAa,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/types/index.d.ts

@@ -25,6 +25,7 @@ export type { AudioSettings };
  * const config: ConvaiConfig = {
  *   apiKey: 'your-api-key',
  *   characterId: 'your-character-id',
+ *   endUserId: 'user-uuid', // Optional: enables long-term memory and analytics
  *   enableVideo: false, // If false, connection_type will be "audio"
  * };
  * ```
@@ -34,6 +35,20 @@ export interface ConvaiConfig {
     apiKey: string;
     /** The Character ID to connect to (required) */
     characterId: string;
+    /**
+     * End user identifier for speaker management (optional).
+     *
+     * When provided:
+     * - Enables long-term memory: Character remembers context from previous conversations with this user
+     * - Enables analytics: Track user engagement and behavior
+     *
+     * When not provided:
+     * - Anonymous mode: No persistent memory or user tracking
+     * - Each session is independent with no conversation history
+     *
+     * Use a unique UUID or device ID for persistent user experiences.
+     */
+    endUserId?: string;
     /** Custom Convai API URL (optional, defaults to production endpoint) */
     url?: string;
     /**
@@ -175,6 +190,11 @@ export interface ConvaiClient {
     apiKey: string | null;
     /** Character ID used for the current connection (null if not connected) */
     characterId: string | null;
+    /**
+     * Speaker ID for the current user (null if not connected).
+     * Used for long-term memory and user analytics.
+     */
+    speakerId: string | null;
     /**
      * Connect to a Convai character.
      * Uses stored config from useConvaiClient() or accepts override config.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC;;;;GAIG;AACH,UAAU,aAAa;IACrB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,YAAY,CAAC,EAAE;QACb,qDAAqD;QACrD,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,4DAA4D;QAC5D,UAAU,EAAE,KAAK,CAAC;YAChB,qBAAqB;YACrB,IAAI,EAAE,MAAM,CAAC;YACb,yCAAyC;YACzC,GAAG,EAAE,MAAM,CAAC;SACb,CAAC,CAAC;QACH,oDAAoD;QACpD,OAAO,EAAE,KAAK,CAAC;YACb,kBAAkB;YAClB,IAAI,EAAE,MAAM,CAAC;YACb,uCAAuC;YACvC,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;QACH,+DAA+D;QAC/D,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,GAAG,QAAQ,GAAG,oBAAoB,GAAG,cAAc,GAAG,aAAa,GAAG,eAAe,CAAC;IAC3I,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,WAAW,EAAE,OAAO,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,UAAU,EAAE,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;CAClF;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,KAAK,EAAE,iBAAiB,CAAC;IAEzB;;;OAGG;IACH,cAAc,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;IAEzC,sEAAsE;IACtE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;OAGG;IACH,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,oDAAoD;IACpD,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC,mEAAmE;IACnE,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,wEAAwE;IACxE,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB,0DAA0D;IAC1D,IAAI,EAAE,IAAI,CAAC;IAEX,+CAA+C;IAC/C,UAAU,EAAE,GAAG,CAAC;IAEhB,+CAA+C;IAC/C,UAAU,EAAE,GAAG,CAAC;IAEhB,2CAA2C;IAC3C,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5E;;;OAGG;IACH,kBAAkB,EAAE,CAAC,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAEtE;;;OAGG;IACH,iBAAiB,EAAE,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAE3D,6DAA6D;IAC7D,YAAY,EAAE,WAAW,EAAE,CAAC;IAE5B,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,+DAA+D;IAC/D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,kFAAkF;IAClF,UAAU,EAAE,OAAO,CAAC;IAEpB,gEAAgE;IAChE,aAAa,EAAE,aAAa,CAAC;IAE7B,0DAA0D;IAC1D,aAAa,EAAE,aAAa,CAAC;IAE7B,qCAAqC;IACrC,mBAAmB,EAAE,mBAAmB,CAAC;IAEzC;;;OAGG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC;;;;GAIG;AACH,UAAU,aAAa;IACrB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,YAAY,CAAC,EAAE;QACb,qDAAqD;QACrD,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,4DAA4D;QAC5D,UAAU,EAAE,KAAK,CAAC;YAChB,qBAAqB;YACrB,IAAI,EAAE,MAAM,CAAC;YACb,yCAAyC;YACzC,GAAG,EAAE,MAAM,CAAC;SACb,CAAC,CAAC;QACH,oDAAoD;QACpD,OAAO,EAAE,KAAK,CAAC;YACb,kBAAkB;YAClB,IAAI,EAAE,MAAM,CAAC;YACb,uCAAuC;YACvC,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;QACH,+DAA+D;QAC/D,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,GAAG,QAAQ,GAAG,oBAAoB,GAAG,cAAc,GAAG,aAAa,GAAG,eAAe,CAAC;IAC3I,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,WAAW,EAAE,OAAO,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,UAAU,EAAE,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;CAClF;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,KAAK,EAAE,iBAAiB,CAAC;IAEzB;;;OAGG;IACH,cAAc,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;IAEzC,sEAAsE;IACtE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;;OAGG;IACH,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,oDAAoD;IACpD,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC,mEAAmE;IACnE,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,wEAAwE;IACxE,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB,0DAA0D;IAC1D,IAAI,EAAE,IAAI,CAAC;IAEX,+CAA+C;IAC/C,UAAU,EAAE,GAAG,CAAC;IAEhB,+CAA+C;IAC/C,UAAU,EAAE,GAAG,CAAC;IAEhB,2CAA2C;IAC3C,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5E;;;OAGG;IACH,kBAAkB,EAAE,CAAC,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAEtE;;;OAGG;IACH,iBAAiB,EAAE,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAE3D,6DAA6D;IAC7D,YAAY,EAAE,WAAW,EAAE,CAAC;IAE5B,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,+DAA+D;IAC/D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,kFAAkF;IAClF,UAAU,EAAE,OAAO,CAAC;IAEpB,gEAAgE;IAChE,aAAa,EAAE,aAAa,CAAC;IAE7B,0DAA0D;IAC1D,aAAa,EAAE,aAAa,CAAC;IAE7B,qCAAqC;IACrC,mBAAmB,EAAE,mBAAmB,CAAC;IAEzC;;;OAGG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC"}

package/dist/utils/speakerManagement.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Resolves the speaker ID based on the end user ID.
+ *
+ * - If endUserId is not provided (anonymous mode), returns the API key as the speaker ID (no persistent memory)
+ * - If endUserId is provided, calls Convai API to get or create a speaker ID for the user
+ *
+ * @param endUserId - The end user identifier (optional). If not provided, anonymous mode is used.
+ * @param apiKey - Convai API key for authentication
+ * @returns Promise resolving to the speaker ID
+ */
+export declare function resolveSpeakerId(endUserId: string | undefined, apiKey: string): Promise<string>;
+/**
+ * Gets or creates a speaker ID from Convai's speaker management API.
+ * If the same endUserId is used multiple times, the same speaker ID is returned (idempotent).
+ *
+ * @param endUserId - The device or user identifier
+ * @param apiKey - Convai API key for authentication
+ * @returns Promise resolving to the speaker ID
+ * @throws Error if API request fails
+ */
+export declare function getOrCreateSpeakerId(endUserId: string, apiKey: string): Promise<string>;
+//# sourceMappingURL=speakerManagement.d.ts.map

package/dist/utils/speakerManagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speakerManagement.d.ts","sourceRoot":"","sources":["../../src/utils/speakerManagement.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAqCjB"}

package/dist/utils/speakerManagement.js

@@ -0,0 +1,71 @@
+import { logger } from './logger';
+/**
+ * Resolves the speaker ID based on the end user ID.
+ *
+ * - If endUserId is not provided (anonymous mode), returns the API key as the speaker ID (no persistent memory)
+ * - If endUserId is provided, calls Convai API to get or create a speaker ID for the user
+ *
+ * @param endUserId - The end user identifier (optional). If not provided, anonymous mode is used.
+ * @param apiKey - Convai API key for authentication
+ * @returns Promise resolving to the speaker ID
+ */
+export async function resolveSpeakerId(endUserId, apiKey) {
+    // Anonymous mode: Use API key as speaker ID (no persistent memory or analytics)
+    if (!endUserId) {
+        logger.info('Anonymous mode: No persistent speaker ID or user tracking');
+        return apiKey;
+    }
+    // User tracking mode: Get or create speaker ID via Convai API (enables memory and analytics)
+    try {
+        const speakerId = await getOrCreateSpeakerId(endUserId, apiKey);
+        logger.info(`Resolved speaker ID: ${speakerId.substring(0, 8)}...`);
+        return speakerId;
+    }
+    catch (error) {
+        logger.error('Failed to resolve speaker ID:', error);
+        // Fallback to API key if speaker ID resolution fails
+        logger.warn('Falling back to API key as speaker ID');
+        return apiKey;
+    }
+}
+/**
+ * Gets or creates a speaker ID from Convai's speaker management API.
+ * If the same endUserId is used multiple times, the same speaker ID is returned (idempotent).
+ *
+ * @param endUserId - The device or user identifier
+ * @param apiKey - Convai API key for authentication
+ * @returns Promise resolving to the speaker ID
+ * @throws Error if API request fails
+ */
+export async function getOrCreateSpeakerId(endUserId, apiKey) {
+    const url = 'https://api.convai.com/user/speaker/new';
+    logger.info(`Requesting speaker ID for endUserId: ${endUserId.substring(0, 8)}...`);
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'CONVAI-API-KEY': apiKey,
+            },
+            body: JSON.stringify({
+                deviceId: endUserId,
+            }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Speaker API request failed: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        const data = await response.json();
+        if (!data.speakerId) {
+            throw new Error('Speaker API did not return a speaker ID');
+        }
+        return data.speakerId;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to get speaker ID: ${error.message}`);
+        }
+        throw new Error('Failed to get speaker ID: Unknown error');
+    }
+}
+//# sourceMappingURL=speakerManagement.js.map

package/dist/utils/speakerManagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speakerManagement.js","sourceRoot":"","sources":["../../src/utils/speakerManagement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AASlC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAA6B,EAC7B,MAAc;IAEd,gFAAgF;IAChF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6FAA6F;IAC7F,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,wBAAwB,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACrD,qDAAqD;QACrD,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,MAAc;IAEd,MAAM,GAAG,GAAG,yCAAyC,CAAC;IAEtD,MAAM,CAAC,IAAI,CAAC,wCAAwC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAEpF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,gBAAgB,EAAE,MAAM;aACzB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,QAAQ,EAAE,SAAS;aACpB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE,CACvF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAoB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEpD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/dist/vanilla/index.d.ts

@@ -0,0 +1,3 @@
+export { ConvaiClient } from '../core';
+export * from '../core/types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vanilla/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,cAAc,eAAe,CAAC"}

package/dist/vanilla/index.js

@@ -0,0 +1,5 @@
+// Core client (re-exported from core)
+export { ConvaiClient } from '../core';
+// Re-export types for convenience
+export * from '../core/types';
+//# sourceMappingURL=index.js.map

package/dist/vanilla/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vanilla/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,kCAAkC;AAClC,cAAc,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@convai/web-sdk",
-  "version": "0.0.4-beta.1",
+  "version": "0.1.1-beta.0",
   "description": "The convai/web-sdk helps power characters in websites (brain) and the communication UI with Convai characters. This SDK facilitates the capture of user audio streams and provides appropriate responses in the form of audio, actions, and facial expressions.",
   "private": false,
   "type": "module",
@@ -12,9 +12,21 @@
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
+    "./core": {
+      "import": "./dist/core/index.js",
+      "types": "./dist/core/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts"
+    },
+    "./vanilla": {
+      "import": "./dist/vanilla/index.js",
+      "types": "./dist/vanilla/index.d.ts"
+    },
     "./rtc-widget": {
-      "import": "./dist/components/rtc-widget/index.js",
-      "types": "./dist/components/rtc-widget/index.d.ts"
+      "import": "./dist/react/components/rtc-widget/index.js",
+      "types": "./dist/react/components/rtc-widget/index.d.ts"
     }
   },
   "sideEffects": false,
@@ -37,16 +49,19 @@
     "publish:beta": "npm run build:prod && changeset publish --tag beta",
     "example:react": "cd examples/react && pnpm dev",
     "example:react:build": "cd examples/react && pnpm build",
+    "example:vanilla-ts": "cd examples/vanilla-ts && pnpm dev",
     "examples:dev": "pnpm example:react",
     "examples:build": "pnpm example:react:build",
-    "examples:install": "pnpm install && cd examples/react && pnpm install",
+    "examples:install": "pnpm install && cd examples/react && pnpm install && cd ../vanilla-ts && pnpm install",
     "examples:clean": "pnpm clean && cd examples/react && pnpm clean"
   },
   "keywords": [
     "convai",
     "livekit",
     "react",
+    "vanilla",
     "typescript",
+    "javascript",
     "ai",
     "voice-assistant",
     "video-chat",
@@ -61,18 +76,20 @@
     "text-to-speech",
     "rtc",
     "character-ai",
-    "interactive-characters"
+    "interactive-characters",
+    "tree-shaking",
+    "multi-platform"
   ],
   "author": "Convai <support@convai.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/convai/web-handsfree.git"
+    "url": "https://github.com/convai/web-sdk.git"
   },
   "bugs": {
-    "url": "https://github.com/convai/web-handsfree/issues"
+    "url": "https://github.com/convai/web-sdk/issues"
   },
-  "homepage": "https://github.com/convai/web-handsfree#readme",
+  "homepage": "https://github.com/convai/web-sdk#readme",
   "dependencies": {
     "@livekit/components-react": "^2.9.3",
     "@livekit/components-styles": "^1.1.4",