@hamsa-ai/voice-agents-sdk 0.4.3-beta.2 → 0.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamsa-ai/voice-agents-sdk",
-  "version": "0.4.3-beta.2",
+  "version": "0.4.3",
   "description": "Hamsa AI - Voice Agents JavaScript SDK",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/types/classes/livekit-connection.d.ts

@@ -188,8 +188,8 @@ export declare class LiveKitConnection extends EventEmitter {
     private reconnectionAttempts;
     /** Whether we've already emitted a 'connected' event for the current session */
     private hasEmittedConnected;
-    /** Enable debug logging for troubleshooting */
-    private readonly debug;
+    /** Debug logger instance for conditional logging */
+    private readonly logger;
     /**
      * Creates a new LiveKitConnection instance
      *

package/types/classes/livekit-manager.d.ts

@@ -33,6 +33,7 @@
  */
 import { EventEmitter } from 'events';
 import type { Room } from 'livekit-client';
+import { type DebugLogger } from '../utils';
 import { LiveKitAnalytics } from './livekit-analytics';
 import { LiveKitAudioManager } from './livekit-audio-manager';
 import { LiveKitConnection } from './livekit-connection';
@@ -59,6 +60,8 @@ export default class LiveKitManager extends EventEmitter {
     lkUrl: string;
     /** JWT access token for authentication */
     accessToken: string;
+    /** Debug logger instance for conditional logging */
+    logger: DebugLogger;
     /**
      * Creates a new LiveKitManager instance
      *

package/types/main.d.ts

@@ -320,6 +320,8 @@ declare class HamsaVoiceAgent extends EventEmitter {
     wakeLockManager: ScreenWakeLock;
     /** Flag to track if the user initiated the call end to prevent duplicate disconnection logic */
     private userInitiatedEnd;
+    /** Debug logger instance for conditional logging */
+    private readonly logger;
     /**
      * Creates a new HamsaVoiceAgent instance
      *

package/types/utils/debug.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Debug utility for conditional logging throughout the SDK
+ *
+ * This utility provides a centralized way to handle debug logging without
+ * needing biome-ignore comments for console statements. It only logs when
+ * debug mode is enabled.
+ *
+ * @example
+ * ```typescript
+ * const logger = createDebugLogger(this.debug);
+ * logger.log('Connection established', { source: 'LiveKitConnection' });
+ * logger.error('Failed to connect', { source: 'LiveKitConnection', error });
+ * ```
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+type LogOptions = {
+    source?: string;
+    level?: LogLevel;
+    error?: unknown;
+};
+/**
+ * Debug logger interface
+ */
+export type DebugLogger = {
+    /**
+     * Log a debug message (only when debug mode is enabled)
+     */
+    log: (message: unknown, options?: LogOptions) => void;
+    /**
+     * Log an info message (only when debug mode is enabled)
+     */
+    info: (message: unknown, options?: LogOptions) => void;
+    /**
+     * Log a warning message (only when debug mode is enabled)
+     */
+    warn: (message: unknown, options?: LogOptions) => void;
+    /**
+     * Log an error message (always logs, regardless of debug mode)
+     */
+    error: (message: unknown, options?: LogOptions) => void;
+};
+/**
+ * Creates a debug logger instance
+ *
+ * @param debug - Whether debug mode is enabled
+ * @returns A debug logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createDebugLogger(true);
+ * logger.log('Starting connection', { source: 'LiveKitConnection' });
+ * logger.error('Connection failed', { source: 'LiveKitConnection', error });
+ * ```
+ */
+export declare const createDebugLogger: (debug: boolean) => DebugLogger;
+export {};

package/types/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Utility functions for the Voice Agents SDK
+ */
+export type { DebugLogger } from './debug';
+export { createDebugLogger } from './debug';