@convai/web-sdk 0.0.1

package/dist/hooks/useTemplateKeysUpdater.js

@@ -0,0 +1,53 @@
+import { useCallback } from "react";
+import { logger } from "../utils/logger";
+/**
+ * Hook for updating template keys in Convai.
+ *
+ * Updates dynamic template variables that can be used in AI responses
+ * to provide personalized and contextual information.
+ *
+ * @param {Room} room - LiveKit room instance
+ * @param {string} participantSid - Participant session ID
+ * @returns {Object} Object containing updateTemplateKeys function
+ *
+ * @example
+ * ```tsx
+ * function TemplateComponent() {
+ *   const { updateTemplateKeys } = useTemplateKeysUpdater(room, participantSid);
+ *
+ *   const handleUpdate = () => {
+ *     updateTemplateKeys({
+ *       user_name: "John",
+ *       location: "New York",
+ *       mood: "happy"
+ *     });
+ *   };
+ *
+ *   return <button onClick={handleUpdate}>Update Templates</button>;
+ * }
+ * ```
+ */
+export const useTemplateKeysUpdater = (room, participantSid) => {
+    const updateTemplateKeys = useCallback((templateKeys) => {
+        if (room &&
+            room.localParticipant &&
+            Object.keys(templateKeys).length > 0) {
+            const message = {
+                type: "update-template-keys",
+                data: {
+                    template_keys: templateKeys,
+                    participant_sid: participantSid || room.localParticipant.sid,
+                },
+            };
+            const encodedData = new TextEncoder().encode(JSON.stringify(message));
+            room.localParticipant.publishData(encodedData, {
+                reliable: true,
+            });
+            logger.log("🔑 Template keys updated:", templateKeys, "SID:", participantSid || room.localParticipant.sid);
+        }
+    }, [room, participantSid]);
+    return {
+        updateTemplateKeys,
+    };
+};
+//# sourceMappingURL=useTemplateKeysUpdater.js.map

package/dist/hooks/useTemplateKeysUpdater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTemplateKeysUpdater.js","sourceRoot":"","sources":["../../src/hooks/useTemplateKeysUpdater.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAMzC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,IAAU,EACV,cAAsB,EACtB,EAAE;IACF,MAAM,kBAAkB,GAAG,WAAW,CACpC,CAAC,YAA0B,EAAE,EAAE;QAC7B,IACE,IAAI;YACJ,IAAI,CAAC,gBAAgB;YACrB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EACpC,CAAC;YACD,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,sBAAsB;gBAC5B,IAAI,EAAE;oBACJ,aAAa,EAAE,YAAY;oBAC3B,eAAe,EAAE,cAAc,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG;iBAC7D;aACF,CAAC;YAEF,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,WAAW,EAAE;gBAC7C,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC,2BAA2B,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC,EACD,CAAC,IAAI,EAAE,cAAc,CAAC,CACvB,CAAC;IAEF,OAAO;QACL,kBAAkB;KACnB,CAAC;AACJ,CAAC,CAAC"}

package/dist/hooks/useTriggerMessageSender.d.ts

@@ -0,0 +1,28 @@
+import { Room } from "livekit-client";
+/**
+ * Hook for sending trigger messages to Convai.
+ *
+ * Sends system trigger messages that can activate specific behaviors
+ * or responses from the AI assistant.
+ *
+ * @param {Room} room - LiveKit room instance
+ * @param {string} participantSid - Participant session ID
+ * @returns {Object} Object containing sendTriggerMessage function
+ *
+ * @example
+ * ```tsx
+ * function TriggerComponent() {
+ *   const { sendTriggerMessage } = useTriggerMessageSender(room, participantSid);
+ *
+ *   const handleTrigger = () => {
+ *     sendTriggerMessage("character_introduction", "User just entered the room");
+ *   };
+ *
+ *   return <button onClick={handleTrigger}>Send Trigger</button>;
+ * }
+ * ```
+ */
+export declare const useTriggerMessageSender: (room: Room, participantSid: string) => {
+    sendTriggerMessage: (triggerName?: string, triggerMessage?: string) => void;
+};
+//# sourceMappingURL=useTriggerMessageSender.d.ts.map

package/dist/hooks/useTriggerMessageSender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTriggerMessageSender.d.ts","sourceRoot":"","sources":["../../src/hooks/useTriggerMessageSender.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,IAAI,EACV,gBAAgB,MAAM;uCAGL,MAAM,mBAAmB,MAAM;CA6BjD,CAAC"}

package/dist/hooks/useTriggerMessageSender.js

@@ -0,0 +1,52 @@
+import { useCallback } from "react";
+import { logger } from "../utils/logger";
+/**
+ * Hook for sending trigger messages to Convai.
+ *
+ * Sends system trigger messages that can activate specific behaviors
+ * or responses from the AI assistant.
+ *
+ * @param {Room} room - LiveKit room instance
+ * @param {string} participantSid - Participant session ID
+ * @returns {Object} Object containing sendTriggerMessage function
+ *
+ * @example
+ * ```tsx
+ * function TriggerComponent() {
+ *   const { sendTriggerMessage } = useTriggerMessageSender(room, participantSid);
+ *
+ *   const handleTrigger = () => {
+ *     sendTriggerMessage("character_introduction", "User just entered the room");
+ *   };
+ *
+ *   return <button onClick={handleTrigger}>Send Trigger</button>;
+ * }
+ * ```
+ */
+export const useTriggerMessageSender = (room, participantSid) => {
+    const sendTriggerMessage = useCallback((triggerName, triggerMessage) => {
+        if (room && room.localParticipant) {
+            const message = {
+                type: "trigger-message",
+                data: {
+                    ...(triggerName && { trigger_name: triggerName }),
+                    ...(triggerMessage && { trigger_message: triggerMessage }),
+                    participant_sid: participantSid || room.localParticipant.sid,
+                },
+            };
+            const encodedData = new TextEncoder().encode(JSON.stringify(message));
+            room.localParticipant.publishData(encodedData, {
+                reliable: true,
+            });
+            logger.log("🎯 Trigger message sent:", {
+                triggerName,
+                triggerMessage,
+                sid: participantSid || room.localParticipant.sid,
+            });
+        }
+    }, [room, participantSid]);
+    return {
+        sendTriggerMessage,
+    };
+};
+//# sourceMappingURL=useTriggerMessageSender.js.map

package/dist/hooks/useTriggerMessageSender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTriggerMessageSender.js","sourceRoot":"","sources":["../../src/hooks/useTriggerMessageSender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAAU,EACV,cAAsB,EACtB,EAAE;IACF,MAAM,kBAAkB,GAAG,WAAW,CACpC,CAAC,WAAoB,EAAE,cAAuB,EAAE,EAAE;QAChD,IAAI,IAAI,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE;oBACJ,GAAG,CAAC,WAAW,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;oBACjD,GAAG,CAAC,cAAc,IAAI,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;oBAC1D,eAAe,EAAE,cAAc,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG;iBAC7D;aACF,CAAC;YAEF,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,WAAW,EAAE;gBAC7C,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC,0BAA0B,EAAE;gBACrC,WAAW;gBACX,cAAc;gBACd,GAAG,EAAE,cAAc,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG;aACjD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EACD,CAAC,IAAI,EAAE,cAAc,CAAC,CACvB,CAAC;IAEF,OAAO;QACL,kBAAkB;KACnB,CAAC;AACJ,CAAC,CAAC"}

package/dist/hooks/useTtsToggle.d.ts

@@ -0,0 +1,37 @@
+import { Room } from "livekit-client";
+/**
+ * Hook for toggling TTS (Text-to-Speech) generation in Convai.
+ *
+ * Sends a tts-toggle message to control whether the bot generates audio.
+ * This is more efficient than muting audio after generation, as it prevents
+ * audio generation at the source.
+ *
+ * @param {Room} room - LiveKit room instance
+ * @returns {Object} Object containing toggleTts function
+ *
+ * @example
+ * ```tsx
+ * function AudioControlComponent() {
+ *   const { toggleTts } = useTtsToggle(room);
+ *
+ *   const handleMute = () => {
+ *     toggleTts(false); // Disable TTS generation
+ *   };
+ *
+ *   const handleUnmute = () => {
+ *     toggleTts(true); // Enable TTS generation
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={handleMute}>Mute TTS</button>
+ *       <button onClick={handleUnmute}>Unmute TTS</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare const useTtsToggle: (room: Room) => {
+    toggleTts: (enabled: boolean) => void;
+};
+//# sourceMappingURL=useTtsToggle.d.ts.map

package/dist/hooks/useTtsToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTtsToggle.d.ts","sourceRoot":"","sources":["../../src/hooks/useTtsToggle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,IAAI;yBAEzB,OAAO;CAiCpB,CAAC"}

package/dist/hooks/useTtsToggle.js

@@ -0,0 +1,65 @@
+import { useCallback } from "react";
+import { logger } from "../utils/logger";
+/**
+ * Hook for toggling TTS (Text-to-Speech) generation in Convai.
+ *
+ * Sends a tts-toggle message to control whether the bot generates audio.
+ * This is more efficient than muting audio after generation, as it prevents
+ * audio generation at the source.
+ *
+ * @param {Room} room - LiveKit room instance
+ * @returns {Object} Object containing toggleTts function
+ *
+ * @example
+ * ```tsx
+ * function AudioControlComponent() {
+ *   const { toggleTts } = useTtsToggle(room);
+ *
+ *   const handleMute = () => {
+ *     toggleTts(false); // Disable TTS generation
+ *   };
+ *
+ *   const handleUnmute = () => {
+ *     toggleTts(true); // Enable TTS generation
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={handleMute}>Mute TTS</button>
+ *       <button onClick={handleUnmute}>Unmute TTS</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export const useTtsToggle = (room) => {
+    const toggleTts = useCallback((enabled) => {
+        // Check if room is connected and localParticipant exists
+        if (!room || room.state === 'disconnected' || !room.localParticipant) {
+            logger.warn("Cannot toggle TTS: room is disconnected or localParticipant is unavailable");
+            return;
+        }
+        try {
+            const message = {
+                type: "tts-toggle",
+                data: {
+                    "enabled": enabled
+                }
+            };
+            const encodedData = new TextEncoder().encode(JSON.stringify(message));
+            room.localParticipant.publishData(encodedData, {
+                reliable: true,
+            });
+            logger.log(`🔊 TTS ${enabled ? 'enabled' : 'disabled'}`);
+        }
+        catch (error) {
+            logger.error("Failed to toggle TTS:", error);
+            // Re-throw to allow caller to handle
+            throw error;
+        }
+    }, [room]);
+    return {
+        toggleTts,
+    };
+};
+//# sourceMappingURL=useTtsToggle.js.map

package/dist/hooks/useTtsToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTtsToggle.js","sourceRoot":"","sources":["../../src/hooks/useTtsToggle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAU,EAAE,EAAE;IACzC,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,OAAgB,EAAE,EAAE;QACnB,yDAAyD;QACzD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,cAAc,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;YAC1F,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE;oBACJ,SAAS,EAAE,OAAO;iBACnB;aACF,CAAC;YAEF,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,WAAW,EAAE;gBAC7C,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;YAC7C,qCAAqC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,EACD,CAAC,IAAI,CAAC,CACP,CAAC;IAEF,OAAO;QACL,SAAS;KACV,CAAC;AACJ,CAAC,CAAC"}

package/dist/hooks/useUserTextMessageSender.d.ts

@@ -0,0 +1,28 @@
+import { Room } from "livekit-client";
+/**
+ * Hook for sending user text messages to Convai.
+ *
+ * Sends programmatic text messages that are processed by the AI assistant
+ * but not displayed in the chat interface.
+ *
+ * @param {Room} room - LiveKit room instance
+ * @param {string} participantSid - Participant session ID
+ * @returns {Object} Object containing sendUserTextMessage function
+ *
+ * @example
+ * ```tsx
+ * function ChatComponent() {
+ *   const { sendUserTextMessage } = useUserTextMessageSender(room, participantSid);
+ *
+ *   const handleSendMessage = () => {
+ *     sendUserTextMessage("Hello, how are you?");
+ *   };
+ *
+ *   return <button onClick={handleSendMessage}>Send Message</button>;
+ * }
+ * ```
+ */
+export declare const useUserTextMessageSender: (room: Room, participantSid: string) => {
+    sendUserTextMessage: (text: string) => void;
+};
+//# sourceMappingURL=useUserTextMessageSender.d.ts.map

package/dist/hooks/useUserTextMessageSender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserTextMessageSender.d.ts","sourceRoot":"","sources":["../../src/hooks/useUserTextMessageSender.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,IAAI,EACV,gBAAgB,MAAM;gCAGb,MAAM;CAuChB,CAAC"}

package/dist/hooks/useUserTextMessageSender.js

@@ -0,0 +1,61 @@
+import { useCallback } from "react";
+import { logger } from "../utils/logger";
+/**
+ * Hook for sending user text messages to Convai.
+ *
+ * Sends programmatic text messages that are processed by the AI assistant
+ * but not displayed in the chat interface.
+ *
+ * @param {Room} room - LiveKit room instance
+ * @param {string} participantSid - Participant session ID
+ * @returns {Object} Object containing sendUserTextMessage function
+ *
+ * @example
+ * ```tsx
+ * function ChatComponent() {
+ *   const { sendUserTextMessage } = useUserTextMessageSender(room, participantSid);
+ *
+ *   const handleSendMessage = () => {
+ *     sendUserTextMessage("Hello, how are you?");
+ *   };
+ *
+ *   return <button onClick={handleSendMessage}>Send Message</button>;
+ * }
+ * ```
+ */
+export const useUserTextMessageSender = (room, participantSid) => {
+    const sendUserTextMessage = useCallback((text) => {
+        // Check if room is connected and localParticipant exists
+        if (!room || room.state === 'disconnected' || !room.localParticipant) {
+            logger.warn("Cannot send message: room is disconnected or localParticipant is unavailable");
+            return;
+        }
+        if (!text || !text.trim()) {
+            logger.warn("Cannot send message: text is empty");
+            return;
+        }
+        try {
+            const message = {
+                type: "user_text_message",
+                data: {
+                    text: text.trim(),
+                    participant_sid: participantSid || room.localParticipant.sid,
+                },
+            };
+            const encodedData = new TextEncoder().encode(JSON.stringify(message));
+            room.localParticipant.publishData(encodedData, {
+                reliable: true,
+            });
+            logger.log("💬 User text message sent:", text.trim(), "SID:", participantSid || room.localParticipant.sid);
+        }
+        catch (error) {
+            logger.error("Failed to send user text message:", error);
+            // Re-throw to allow caller to handle
+            throw error;
+        }
+    }, [room, participantSid]);
+    return {
+        sendUserTextMessage,
+    };
+};
+//# sourceMappingURL=useUserTextMessageSender.js.map

package/dist/hooks/useUserTextMessageSender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserTextMessageSender.js","sourceRoot":"","sources":["../../src/hooks/useUserTextMessageSender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,IAAU,EACV,cAAsB,EACtB,EAAE;IACF,MAAM,mBAAmB,GAAG,WAAW,CACrC,CAAC,IAAY,EAAE,EAAE;QACf,yDAAyD;QACzD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,cAAc,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;YAC5F,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE;oBACJ,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;oBACjB,eAAe,EAAE,cAAc,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG;iBAC7D;aACF,CAAC;YAEF,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,WAAW,EAAE;gBAC7C,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC,4BAA4B,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,cAAc,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC7G,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YACzD,qCAAqC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,EACD,CAAC,IAAI,EAAE,cAAc,CAAC,CACvB,CAAC;IAEF,OAAO;QACL,mBAAmB;KACpB,CAAC;AACJ,CAAC,CAAC"}

package/dist/hooks/useVideoControls.d.ts

@@ -0,0 +1,39 @@
+import { Room } from "livekit-client";
+export interface VideoControls {
+    isVideoEnabled: boolean;
+    isVideoHidden: boolean;
+    enableVideo: () => Promise<void>;
+    disableVideo: () => Promise<void>;
+    hideVideo: () => Promise<void>;
+    showVideo: () => Promise<void>;
+    toggleVideo: () => Promise<void>;
+    setVideoDevice: (deviceId: string) => Promise<void>;
+    getVideoDevices: () => Promise<MediaDeviceInfo[]>;
+    setVideoQuality: (quality: 'low' | 'medium' | 'high') => Promise<void>;
+}
+/**
+ * Hook for managing video controls in LiveKit.
+ *
+ * Provides methods to enable/disable camera, manage video devices,
+ * and control video visibility state.
+ *
+ * @param {Room | null} room - LiveKit room instance
+ * @returns {VideoControls} Object containing video control methods and state
+ *
+ * @example
+ * ```tsx
+ * function VideoControls() {
+ *   const videoControls = useVideoControls(room);
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={videoControls.toggleVideo}>
+ *         {videoControls.isVideoEnabled ? 'Disable Camera' : 'Enable Camera'}
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare const useVideoControls: (room: Room | null) => VideoControls;
+//# sourceMappingURL=useVideoControls.d.ts.map

package/dist/hooks/useVideoControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVideoControls.d.ts","sourceRoot":"","sources":["../../src/hooks/useVideoControls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGtC,MAAM,WAAW,aAAa;IAE5B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IAGvB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,eAAe,EAAE,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAGlD,eAAe,EAAE,CAAC,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,GAAG,IAAI,KAAG,aA0MpD,CAAC"}

package/dist/hooks/useVideoControls.js

@@ -0,0 +1,211 @@
+import { useCallback, useState, useEffect } from "react";
+import { logger } from "../utils/logger";
+/**
+ * Hook for managing video controls in LiveKit.
+ *
+ * Provides methods to enable/disable camera, manage video devices,
+ * and control video visibility state.
+ *
+ * @param {Room | null} room - LiveKit room instance
+ * @returns {VideoControls} Object containing video control methods and state
+ *
+ * @example
+ * ```tsx
+ * function VideoControls() {
+ *   const videoControls = useVideoControls(room);
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={videoControls.toggleVideo}>
+ *         {videoControls.isVideoEnabled ? 'Disable Camera' : 'Enable Camera'}
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export const useVideoControls = (room) => {
+    const [isVideoEnabled, setIsVideoEnabled] = useState(false);
+    const [isVideoHidden, setIsVideoHidden] = useState(false);
+    // Update video state when room changes
+    useEffect(() => {
+        if (!room) {
+            setIsVideoEnabled(false);
+            setIsVideoHidden(false);
+            return;
+        }
+        const localParticipant = room.localParticipant;
+        // Set initial state
+        setIsVideoEnabled(localParticipant.isCameraEnabled);
+        setIsVideoHidden(false); // LiveKit doesn't have a direct hidden state for video
+        // Listen for video state changes
+        const handleTrackMuted = (track) => {
+            if (track.source === 'camera') {
+                setIsVideoHidden(true);
+                logger.log("📹 Video hidden");
+            }
+        };
+        const handleTrackUnmuted = (track) => {
+            if (track.source === 'camera') {
+                setIsVideoHidden(false);
+                logger.log("📹 Video shown");
+            }
+        };
+        const handleTrackPublished = (publication) => {
+            if (publication.source === 'camera') {
+                setIsVideoEnabled(true);
+                logger.log("📹 Camera track published - video enabled");
+            }
+        };
+        const handleTrackUnpublished = (publication) => {
+            if (publication.source === 'camera') {
+                setIsVideoEnabled(false);
+                logger.log("📹 Camera track unpublished - video disabled");
+            }
+        };
+        // Subscribe to events
+        localParticipant.on('trackMuted', handleTrackMuted);
+        localParticipant.on('trackUnmuted', handleTrackUnmuted);
+        localParticipant.on('trackPublished', handleTrackPublished);
+        localParticipant.on('trackUnpublished', handleTrackUnpublished);
+        return () => {
+            localParticipant.off('trackMuted', handleTrackMuted);
+            localParticipant.off('trackUnmuted', handleTrackUnmuted);
+            localParticipant.off('trackPublished', handleTrackPublished);
+            localParticipant.off('trackUnpublished', handleTrackUnpublished);
+        };
+    }, [room]);
+    // Enable video
+    const enableVideo = useCallback(async () => {
+        if (!room) {
+            logger.warn("Cannot enable video: no room connection");
+            return;
+        }
+        try {
+            await room.localParticipant.setCameraEnabled(true);
+            setIsVideoEnabled(true); // Update state immediately
+            logger.log("📹 Video enabled successfully");
+        }
+        catch (error) {
+            logger.error("Failed to enable video:", error);
+            throw error;
+        }
+    }, [room]);
+    // Disable video
+    const disableVideo = useCallback(async () => {
+        if (!room) {
+            logger.warn("Cannot disable video: no room connection");
+            return;
+        }
+        try {
+            await room.localParticipant.setCameraEnabled(false);
+            setIsVideoEnabled(false); // Update state immediately
+            logger.log("📹 Video disabled successfully");
+        }
+        catch (error) {
+            logger.error("Failed to disable video:", error);
+            throw error;
+        }
+    }, [room]);
+    // Hide video
+    const hideVideo = useCallback(async () => {
+        if (!room) {
+            logger.warn("Cannot hide video: no room connection");
+            return;
+        }
+        try {
+            // For now, we'll just disable the camera as LiveKit doesn't have a direct hide method
+            await room.localParticipant.setCameraEnabled(false);
+            logger.log("📹 Video hidden successfully");
+        }
+        catch (error) {
+            logger.error("Failed to hide video:", error);
+            throw error;
+        }
+    }, [room]);
+    // Show video
+    const showVideo = useCallback(async () => {
+        if (!room) {
+            logger.warn("Cannot show video: no room connection");
+            return;
+        }
+        try {
+            await room.localParticipant.setCameraEnabled(true);
+            logger.log("📹 Video shown successfully");
+        }
+        catch (error) {
+            logger.error("Failed to show video:", error);
+            throw error;
+        }
+    }, [room]);
+    // Toggle video
+    const toggleVideo = useCallback(async () => {
+        if (isVideoEnabled) {
+            await disableVideo();
+        }
+        else {
+            await enableVideo();
+        }
+    }, [isVideoEnabled, enableVideo, disableVideo]);
+    // Set video device
+    const setVideoDevice = useCallback(async (deviceId) => {
+        if (!room) {
+            logger.warn("Cannot set video device: no room connection");
+            return;
+        }
+        try {
+            await room.localParticipant.setCameraEnabled(true, { deviceId });
+            logger.log("📹 Video device changed to:", deviceId);
+        }
+        catch (error) {
+            logger.error("Failed to set video device:", error);
+            throw error;
+        }
+    }, [room]);
+    // Get available video devices
+    const getVideoDevices = useCallback(async () => {
+        try {
+            const devices = await navigator.mediaDevices.enumerateDevices();
+            const videoDevices = devices.filter(device => device.kind === 'videoinput');
+            logger.log("📹 Available video devices:", videoDevices);
+            return videoDevices;
+        }
+        catch (error) {
+            logger.error("Failed to get video devices:", error);
+            throw error;
+        }
+    }, []);
+    // Set video quality
+    const setVideoQuality = useCallback(async (quality) => {
+        if (!room) {
+            logger.warn("Cannot set video quality: no room connection");
+            return;
+        }
+        try {
+            // TODO: Implement video quality settings when LiveKit provides the API
+            logger.log("📹 Video quality set to:", quality);
+            logger.log("📹 Video quality settings not implemented yet");
+        }
+        catch (error) {
+            logger.error("Failed to set video quality:", error);
+            throw error;
+        }
+    }, [room]);
+    return {
+        // Video state
+        isVideoEnabled,
+        isVideoHidden,
+        // Video controls
+        enableVideo,
+        disableVideo,
+        hideVideo,
+        showVideo,
+        toggleVideo,
+        // Video settings
+        setVideoDevice,
+        getVideoDevices,
+        // Video quality
+        setVideoQuality,
+    };
+};
+//# sourceMappingURL=useVideoControls.js.map

package/dist/hooks/useVideoControls.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { useConvaiClient } from './hooks/useConvaiClient';
+export * from './types';
+export * from './components';
+export * from './hooks';
+//# 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":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Main unified client export
+export { useConvaiClient } from './hooks/useConvaiClient';
+// Types
+export * from './types';
+// Components (for advanced usage)
+export * from './components';
+// Individual hooks (for advanced usage)
+export * from './hooks';
+//# 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,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,QAAQ;AACR,cAAc,SAAS,CAAC;AAExB,kCAAkC;AAClC,cAAc,cAAc,CAAC;AAE7B,wCAAwC;AACxC,cAAc,SAAS,CAAC"}