@convai/web-sdk 0.3.1-beta.2 → 0.3.2-beta.0

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/{types/react → react}/index.d.ts

@@ -1,9 +1,7 @@
 export { useConvaiClient } from './hooks/useConvaiClient';
-export type { BlendshapeFrame, BlendshapeControls } from './hooks/useConvaiClient';
 export { ConvaiWidget } from './components/ConvaiWidget';
 export * from './hooks';
 export * from '../core/types';
 export { ConvaiClient } from '../core';
 export { RoomAudioRenderer as AudioRenderer, RoomContext as AudioContext } from '@livekit/components-react';
-export * from '../lipsync-helpers';
 //# 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,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,13 @@
+// Main hook (backward compatible)
+export { useConvaiClient } from './hooks/useConvaiClient';
+// Components
+export { ConvaiWidget } from './components/ConvaiWidget';
+// Additional hooks (for advanced usage)
+export * from './hooks';
+// 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,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

@@ -1,2 +1,261 @@
-export * from './react';
+import { Room } from 'livekit-client';
+/**
+ * Audio processing settings for the microphone input.
+ * These settings help optimize the audio quality and reduce interruptions.
+ * @internal - This is a fixed configuration and should not be modified by users
+ */
+interface AudioSettings {
+    /** Enable echo cancellation to prevent audio feedback (default: true) */
+    echoCancellation?: boolean;
+    /** Enable noise suppression to reduce background noise (default: true) */
+    noiseSuppression?: boolean;
+    /** Enable automatic gain control for consistent volume (default: true) */
+    autoGainControl?: boolean;
+    /** Audio sample rate in Hz (default: 48000) */
+    sampleRate?: number;
+    /** Number of audio channels, 1 for mono, 2 for stereo (default: 1) */
+    channelCount?: number;
+}
+export type { AudioSettings };
+/**
+ * Configuration object for connecting to a Convai character.
+ *
+ * @example
+ * ```tsx
+ * 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"
+ * };
+ * ```
+ */
+export interface ConvaiConfig {
+    /** Your Convai API key from convai.com dashboard (required) */
+    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;
+    /**
+     * Enable video capability (default: false).
+     * If true, connection_type will be "video" (supports audio, video, and screenshare).
+     * If false, connection_type will be "audio" (audio only).
+     */
+    enableVideo?: boolean;
+    /**
+     * Start with video camera on when connecting (default: false).
+     * Only works if enableVideo is true. If false, camera stays off until user enables it.
+     */
+    startWithVideoOn?: boolean;
+    /**
+     * Start with microphone on when connecting (default: false).
+     * If false, microphone stays off until user enables it using audioControls.enableAudio().
+     * Useful for text-only modes where you want to defer microphone permission until voice mode.
+     */
+    startWithAudioOn?: boolean;
+    /** Enable text-to-speech audio generation (default: true) */
+    ttsEnabled?: boolean;
+    /** Configuration for character actions and environmental context */
+    actionConfig?: {
+        /** List of action names the character can perform */
+        actions: string[];
+        /** Other characters present in the scene or conversation */
+        characters: Array<{
+            /** Character name */
+            name: string;
+            /** Character biography or description */
+            bio: string;
+        }>;
+        /** Objects available in the scene or environment */
+        objects: Array<{
+            /** Object name */
+            name: string;
+            /** Object description or properties */
+            description: string;
+        }>;
+        /** Name of the object the character is currently focused on */
+        currentAttentionObject?: string;
+    };
+}
+/**
+ * Represents a single message in the chat conversation.
+ * Different message types are used for various parts of the conversation flow.
+ */
+export interface ChatMessage {
+    /** Unique identifier for the message */
+    id: string;
+    /**
+     * Type of message:
+     * - `user`: User's sent message
+     * - `convai`: Character's response
+     * - `user-transcription`: Real-time speech-to-text from user
+     * - `bot-llm-text`: Character's LLM-generated text
+     * - `emotion`: Character's emotional state
+     * - `behavior-tree`: Behavior tree response
+     * - `action`: Action execution
+     * - `bot-emotion`: Bot emotional response
+     * - `user-llm-text`: User text processed by LLM
+     */
+    type: 'user' | 'convai' | 'emotion' | 'behavior-tree' | 'action' | 'user-transcription' | 'bot-llm-text' | 'bot-emotion' | 'user-llm-text';
+    /** The text content of the message */
+    content: string;
+    /** ISO timestamp string of when the message was created */
+    timestamp: string;
+    /** Whether this is the final version of the message (for streaming) */
+    isFinal?: boolean;
+}
+/**
+ * Represents the current state of the Convai client connection and activity.
+ * Use this to provide UI feedback about the conversation state.
+ *
+ * @example
+ * ```tsx
+ * const { state } = convaiClient;
+ *
+ * if (state.isConnected) {
+ *   console.log('Connected to character');
+ * }
+ *
+ * if (state.isSpeaking) {
+ *   console.log('Character is speaking');
+ * }
+ *
+ * // Or use the combined state
+ * console.log(state.agentState); // 'listening' | 'thinking' | 'speaking'
+ * ```
+ */
+export interface ConvaiClientState {
+    /** Whether the client is currently connected to Convai */
+    isConnected: boolean;
+    /** Whether a connection attempt is in progress */
+    isConnecting: boolean;
+    /** Whether the system is actively listening to user input */
+    isListening: boolean;
+    /** Whether the character is processing/thinking about a response */
+    isThinking: boolean;
+    /** Whether the character is currently speaking */
+    isSpeaking: boolean;
+    /**
+     * Combined state indicator for the character's current activity.
+     * Use this as a single source of truth for UI state.
+     */
+    agentState: 'disconnected' | 'connected' | 'listening' | 'thinking' | 'speaking';
+}
+import type { AudioControls, VideoControls, ScreenShareControls } from "../core/types";
+/**
+ * Main Convai client interface returned by useConvaiClient() hook.
+ * Provides complete control over Convai character connections and interactions.
+ *
+ * @example
+ * ```tsx
+ * import { useConvaiClient } from '@convai/web-sdk';
+ *
+ * function App() {
+ *   const convaiClient = useConvaiClient();
+ *
+ *   // Connect to character
+ *   await convaiClient.connect({
+ *     apiKey: 'your-api-key',
+ *     characterId: 'your-character-id'
+ *   });
+ *
+ *   // Send a message
+ *   convaiClient.sendUserTextMessage('Hello!');
+ *
+ *   // Check state
+ *   console.log(convaiClient.state.isConnected);
+ * }
+ * ```
+ */
+export interface ConvaiClient {
+    /** Current connection and activity state of the client */
+    state: ConvaiClientState;
+    /**
+     * Connection type: "audio" (audio only) or "video" (audio + video + screenshare).
+     * Set based on enableVideo in connect config.
+     */
+    connectionType: 'audio' | 'video' | null;
+    /** API key used for the current connection (null if not connected) */
+    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.
+     */
+    connect: (config?: ConvaiConfig) => Promise<void>;
+    /** Disconnect from the current character session */
+    disconnect: () => Promise<void>;
+    /** Reconnect - disconnect and connect again using stored config */
+    reconnect: () => Promise<void>;
+    /** Reset the session ID to start a new conversation (clears history) */
+    resetSession: () => void;
+    /** Internal LiveKit Room instance (for advanced usage) */
+    room: Room;
+    /** Current video track (for advanced usage) */
+    videoTrack: any;
+    /** Current audio track (for advanced usage) */
+    audioTrack: any;
+    /** Send a text message to the character */
+    sendUserTextMessage: (text: string) => void;
+    /**
+     * Send a trigger message to invoke specific character actions or responses.
+     * @param triggerName - Name of the trigger to invoke
+     * @param triggerMessage - Optional message to accompany the trigger
+     */
+    sendTriggerMessage: (triggerName?: string, triggerMessage?: string) => void;
+    /**
+     * Update template keys in the character's context (e.g., user name, location).
+     * These keys can be referenced in the character's responses.
+     */
+    updateTemplateKeys: (templateKeys: {
+        [key: string]: string;
+    }) => void;
+    /**
+     * Update dynamic information about the current context.
+     * This helps the character understand the current situation.
+     */
+    updateDynamicInfo: (dynamicInfo: {
+        text: string;
+    }) => void;
+    /** Array of all chat messages in the current conversation */
+    chatMessages: ChatMessage[];
+    /** Current real-time transcription of user speech */
+    userTranscription: string;
+    /** Unique session ID for the current character conversation */
+    characterSessionId: string | null;
+    /** Whether the bot is ready to receive messages (true after bot-ready message) */
+    isBotReady: boolean;
+    /** Audio control methods for managing microphone mute/unmute */
+    audioControls: AudioControls;
+    /** Video control methods for enabling/disabling camera */
+    videoControls: VideoControls;
+    /** Screen sharing control methods */
+    screenShareControls: ScreenShareControls;
+    /**
+     * Toggle text-to-speech on or off.
+     * When disabled, character responses won't be spoken aloud.
+     */
+    toggleTts: (enabled: boolean) => void;
+}
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"LatencyMonitor.d.ts","sourceRoot":"","sources":["../../src/utils/LatencyMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,kBAAkB,CAKV;IAChB,OAAO,CAAC,eAAe,CAAe;IACtC,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,GAAE,OAAe;IAKpC;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAYpE;;OAEG;IACH,cAAc,IAAI,IAAI;IA+BtB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACH,eAAe,IAAI,kBAAkB,EAAE;IAIvC;;OAEG;IACH,oBAAoB,IAAI,kBAAkB,GAAG,IAAI;IAMjD;;OAEG;IACH,QAAQ,IAAI,YAAY,GAAG,IAAI;IAkB/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,qBAAqB,IAAI,OAAO,CAEnC;IAED;;OAEG;IACH,qBAAqB;YApJf,MAAM;mBACC,MAAM;cACX,MAAM,GAAG,OAAO;sBACR,MAAM;;CAoJvB"}

package/dist/utils/LatencyMonitor.js

@@ -0,0 +1,136 @@
+import { EventEmitter } from "../core/EventEmitter";
+/**
+ * LatencyMonitor - Tracks and manages latency measurements
+ * This is for dev/debugging purposes only
+ */
+export class LatencyMonitor extends EventEmitter {
+    constructor(enabled = false) {
+        super();
+        this.measurements = [];
+        this.pendingMeasurement = null;
+        this.maxMeasurements = 100; // Keep last 100 measurements
+        this.isEnabled = false;
+        this.isEnabled = enabled;
+    }
+    /**
+     * Enable latency monitoring
+     */
+    enable() {
+        this.isEnabled = true;
+        this.emit("enabledChange", true);
+    }
+    /**
+     * Disable latency monitoring
+     */
+    disable() {
+        this.isEnabled = false;
+        this.emit("enabledChange", false);
+    }
+    /**
+     * Check if monitoring is enabled
+     */
+    get enabled() {
+        return this.isEnabled;
+    }
+    /**
+     * Start a new latency measurement
+     */
+    startMeasurement(type, userMessage) {
+        if (!this.isEnabled)
+            return;
+        const id = `${type}-${Date.now()}-${Math.random()}`;
+        this.pendingMeasurement = {
+            id,
+            startTime: Date.now(),
+            type,
+            userMessage: userMessage?.substring(0, 50), // Keep first 50 chars
+        };
+    }
+    /**
+     * Complete the current measurement
+     */
+    endMeasurement() {
+        if (!this.isEnabled || !this.pendingMeasurement)
+            return;
+        const endTime = Date.now();
+        const latency = endTime - this.pendingMeasurement.startTime;
+        const measurement = {
+            id: this.pendingMeasurement.id,
+            startTime: this.pendingMeasurement.startTime,
+            endTime,
+            latency,
+            type: this.pendingMeasurement.type,
+            userMessage: this.pendingMeasurement.userMessage,
+        };
+        // Add to measurements array
+        this.measurements.push(measurement);
+        // Keep only the last N measurements
+        if (this.measurements.length > this.maxMeasurements) {
+            this.measurements.shift();
+        }
+        // Clear pending measurement
+        this.pendingMeasurement = null;
+        // Emit new measurement
+        this.emit("measurement", measurement);
+        this.emit("measurementsChange", this.measurements);
+    }
+    /**
+     * Cancel the current pending measurement
+     */
+    cancelMeasurement() {
+        this.pendingMeasurement = null;
+    }
+    /**
+     * Get all measurements
+     */
+    getMeasurements() {
+        return [...this.measurements];
+    }
+    /**
+     * Get the latest measurement
+     */
+    getLatestMeasurement() {
+        return this.measurements.length > 0
+            ? this.measurements[this.measurements.length - 1]
+            : null;
+    }
+    /**
+     * Get latency statistics
+     */
+    getStats() {
+        if (this.measurements.length === 0)
+            return null;
+        const latencies = this.measurements.map((m) => m.latency).sort((a, b) => a - b);
+        const sum = latencies.reduce((acc, val) => acc + val, 0);
+        const p95Index = Math.floor(latencies.length * 0.95);
+        return {
+            average: sum / latencies.length,
+            min: latencies[0],
+            max: latencies[latencies.length - 1],
+            median: latencies[Math.floor(latencies.length / 2)],
+            p95: latencies[p95Index],
+            count: latencies.length,
+        };
+    }
+    /**
+     * Clear all measurements
+     */
+    clear() {
+        this.measurements = [];
+        this.pendingMeasurement = null;
+        this.emit("measurementsChange", this.measurements);
+    }
+    /**
+     * Check if there's a pending measurement
+     */
+    get hasPendingMeasurement() {
+        return this.pendingMeasurement !== null;
+    }
+    /**
+     * Get pending measurement info
+     */
+    getPendingMeasurement() {
+        return this.pendingMeasurement ? { ...this.pendingMeasurement } : null;
+    }
+}
+//# sourceMappingURL=LatencyMonitor.js.map

package/dist/utils/LatencyMonitor.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuFH,eAAO,MAAM,MAAM;mBAnBF,GAAG,EAAE;oBACJ,GAAG,EAAE;qBACJ,GAAG,EAAE;oBACN,GAAG,EAAE;qBACJ,GAAG,EAAE;qBACL,GAAG,EAAE;CAcoC,CAAC;AAG7D,eAAO,MAAM,YAAY;;;;CAIxB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,96 @@
+/**
+ * Logger utility that only logs in development mode.
+ * Completely silent in production builds and npm packages.
+ *
+ * This logger is designed to be tree-shakeable and completely removed
+ * from production builds when not used.
+ *
+ * To test logger behavior:
+ * - Development: Set NODE_ENV=development or run on localhost
+ * - Production: Set NODE_ENV=production or deploy to production
+ *
+ * In npm packages, this logger will be completely silent by default.
+ */
+// Environment detection with multiple fallbacks
+const detectEnvironment = () => {
+    // Check if we're in a browser environment
+    const isBrowser = typeof window !== 'undefined';
+    // Safe process.env access (Vite/Webpack replaces this at build time)
+    const getEnv = (key) => {
+        try {
+            // @ts-ignore - process.env is replaced at build time by bundlers
+            return typeof process !== 'undefined' && process.env ? process.env[key] : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    // Priority 1: Check NEXT_PUBLIC_ENVIRONMENT first (most explicit)
+    const publicEnv = getEnv('NEXT_PUBLIC_ENVIRONMENT');
+    if (publicEnv === 'PRODUCTION') {
+        return 'production';
+    }
+    if (publicEnv === 'PREVIEW' || publicEnv === 'STAGING') {
+        return 'development';
+    }
+    // Priority 2: Check NODE_ENV and REACT_APP_ENV (Vite replaces import.meta.env.MODE)
+    const nodeEnv = getEnv('NODE_ENV');
+    const reactEnv = getEnv('REACT_APP_ENV');
+    if (nodeEnv === 'production' || reactEnv === 'production') {
+        return 'production';
+    }
+    if (nodeEnv === 'development' || reactEnv === 'development') {
+        return 'development';
+    }
+    // Priority 3: Check for Vite dev server
+    const viteDevUrl = getEnv('VITE_DEV_SERVER_URL');
+    if (viteDevUrl !== undefined) {
+        return 'development';
+    }
+    // Priority 4: Check browser environment (only if no explicit env vars are set)
+    if (isBrowser) {
+        // Localhost is typically development
+        if (window.location?.hostname === 'localhost' || window.location?.hostname === '127.0.0.1') {
+            return 'development';
+        }
+        // Check for development ports
+        if (window.location?.port && ['3000', '3001', '5173', '8080'].includes(window.location.port)) {
+            return 'development';
+        }
+    }
+    // Default to production for safety
+    return 'production';
+};
+const environment = detectEnvironment();
+const isDevelopment = environment === 'development';
+// No-op function that gets completely removed by tree shaking
+const noop = () => {
+    // This function is intentionally empty and will be removed in production
+};
+// Development logger functions
+const devLogger = {
+    log: (...args) => console.log('[Convai]', ...args),
+    warn: (...args) => console.warn('[Convai]', ...args),
+    error: (...args) => console.error('[Convai]', ...args),
+    info: (...args) => console.info('[Convai]', ...args),
+    debug: (...args) => console.debug('[Convai]', ...args),
+    trace: (...args) => console.trace('[Convai]', ...args),
+};
+// Production logger functions (all no-ops)
+const prodLogger = {
+    log: noop,
+    warn: noop,
+    error: noop,
+    info: noop,
+    debug: noop,
+    trace: noop,
+};
+// Export the appropriate logger based on environment
+export const logger = isDevelopment ? devLogger : prodLogger;
+// Export environment info for debugging
+export const loggerConfig = {
+    environment,
+    isDevelopment,
+    isProduction: !isDevelopment,
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,gDAAgD;AAChD,MAAM,iBAAiB,GAAG,GAAG,EAAE;IAC7B,0CAA0C;IAC1C,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC;IAEhD,qEAAqE;IACrE,MAAM,MAAM,GAAG,CAAC,GAAW,EAAsB,EAAE;QACjD,IAAI,CAAC;YACH,iEAAiE;YACjE,OAAO,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,kEAAkE;IAClE,MAAM,SAAS,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACpD,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAC/B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACvD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,oFAAoF;IACpF,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,YAAY,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1D,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,KAAK,aAAa,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC5D,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,wCAAwC;IACxC,MAAM,UAAU,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACjD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,+EAA+E;IAC/E,IAAI,SAAS,EAAE,CAAC;QACd,qCAAqC;QACrC,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3F,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,8BAA8B;QAC9B,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7F,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;AACxC,MAAM,aAAa,GAAG,WAAW,KAAK,aAAa,CAAC;AAEpD,8DAA8D;AAC9D,MAAM,IAAI,GAAG,GAAG,EAAE;IAChB,yEAAyE;AAC3E,CAAC,CAAC;AAEF,+BAA+B;AAC/B,MAAM,SAAS,GAAG;IAChB,GAAG,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IACzD,IAAI,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAC3D,KAAK,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAC7D,IAAI,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAC3D,KAAK,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAC7D,KAAK,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;CAC9D,CAAC;AAEF,2CAA2C;AAC3C,MAAM,UAAU,GAAG;IACjB,GAAG,EAAE,IAAI;IACT,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF,qDAAqD;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AAE7D,wCAAwC;AACxC,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW;IACX,aAAa;IACb,YAAY,EAAE,CAAC,aAAa;CAC7B,CAAC"}

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,GAAG,IAAI,CAAC,CAaxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAmCjB"}