@sanseng/livekit-ws-sdk 0.1.10 → 0.1.12

package/dist/index.d.ts

@@ -137,6 +137,16 @@ interface AudioEvents {
   'inner:audio:unmuted': void;
 }
 
+/**
+ * Camera-related events (local camera capture)
+ *
+ * @author sansen
+ */
+interface CameraEvents {
+  'inner:camera:started': void;
+  'inner:camera:stopped': void;
+}
+
 /**
  * Conversation-related events
  *
@@ -150,6 +160,7 @@ interface ConversationEvents {
   'inner:conversation:answer:completed': { questionId: string; fullAnswer: string };
   'inner:conversation:server:message': { questionId: string; message: string; type: string };
   'inner:conversation:asr:received': { questionId: string; text: string };
+  'inner:conversation:server:command': { code: number; command: string };
 }
 
 /**
@@ -205,6 +216,9 @@ interface PublicSDKEvents {
   'media:audio:captureStarted': undefined;
   'media:audio:captureStopped': undefined;
 
+  'media:camera:started': undefined;
+  'media:camera:stopped': undefined;
+
   'media:audio:volumeChanged': { volume: number };
   'media:audio:muted': undefined;
   'media:audio:unmuted': undefined;
@@ -223,7 +237,13 @@ interface PublicSDKEvents {
  * @author sansen
  * @typedef {SDKEvents}
  */
-type SDKEvents = PublicSDKEvents & VideoEvents & AudioEvents & ConversationEvents & ConnectionEvents & InternalConnectionFactEvents;
+type SDKEvents = PublicSDKEvents &
+  VideoEvents &
+  AudioEvents &
+  CameraEvents &
+  ConversationEvents &
+  ConnectionEvents &
+  InternalConnectionFactEvents;
 
 /**
  * Event listener function type
@@ -820,6 +840,7 @@ declare class SDKContext {
     private _token;
     private _roomId;
     private _wsUrl;
+    private _httpToken;
     /**
      * Creates an SDK context instance
      *
@@ -836,6 +857,8 @@ declare class SDKContext {
      * @author sansen
      */
     setLivekitConfig(livekitUrl: string, token: string, roomId: string): void;
+    setAuthToken(token: string): void;
+    get authToken(): string | undefined;
     /**
      * Emits an error event and creates SDKError instance
      *
@@ -976,6 +999,11 @@ declare class SDKClient extends Disposable {
      * @author sansen
      */
     private _conversationController;
+    /**
+     * Camera controller (local camera capture + screenshot send)
+     * @author sansen
+     */
+    private _cameraController;
     /**
      * LiveKit service
      * @author sansen
@@ -1094,6 +1122,42 @@ declare class SDKClient extends Disposable {
      * @author sansen
      */
     get isAudioCapturing(): boolean;
+    /**
+     * Set authentication token
+     * @param token Authentication token
+     * @author sansen
+     */
+    setAuthToken(token: string): void;
+    /**
+     * Start camera capture and periodic screenshot sending over WebSocket
+     * @returns Promise<void>
+     * @throws SDKError if not connected or camera controller unavailable
+     * @author sansen
+     */
+    startCamera(): Promise<void>;
+    /**
+     * Stop camera capture and screenshot sending
+     * @author sansen
+     */
+    stopCamera(): void;
+    /**
+     * Get the local camera MediaStream (null if camera not running)
+     * @returns MediaStream | null
+     * @author sansen
+     */
+    getCameraStream(): MediaStream | null;
+    /**
+     * Get the local camera video track (null if camera not running)
+     * @returns MediaStreamTrack | null
+     * @author sansen
+     */
+    getCameraTrack(): MediaStreamTrack | null;
+    /**
+     * Attach the local camera stream to a video element for preview
+     * @param videoElement HTML video element to show the stream
+     * @author sansen
+     */
+    attachCameraTo(videoElement: HTMLVideoElement): void;
     /**
      * Pre-connect to remote services
      * Performs pre-connection steps: fetches auth token and LiveKit configuration