@speechos/core 0.2.4 → 0.2.6

package/dist/types.d.cts

@@ -35,6 +35,13 @@ export interface SpeechOSCoreConfig {
     host?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Custom WebSocket factory for creating connections.
+     * Used by the Chrome extension to route WebSocket traffic through the
+     * service worker, bypassing page CSP restrictions.
+     * If not provided, uses the native WebSocket constructor.
+     */
+    webSocketFactory?: WebSocketFactory;
 }
 /**
  * Session settings passed when starting a voice session
@@ -187,7 +194,12 @@ export interface SpeechOSEventMap {
     "state:change": {
         state: SpeechOSState;
     };
-    /** Emitted when transcription is received from the server */
+    /** Emitted when intermediate transcription is received from server (indicates audio is being processed) */
+    "transcription:interim": {
+        transcript: string;
+        isFinal: boolean;
+    };
+    /** Emitted when final transcription is received from the server */
     "transcription:complete": {
         text: string;
     };
@@ -231,3 +243,31 @@ export type StateChangeCallback = (newState: SpeechOSState, prevState: SpeechOSS
  * Unsubscribe function returned by event listeners
  */
 export type UnsubscribeFn = () => void;
+/**
+ * Minimal WebSocket-like interface used by the SDK.
+ * This allows the extension to provide a proxy WebSocket that routes
+ * traffic through the service worker to bypass page CSP restrictions.
+ */
+export interface WebSocketLike {
+    /** Current connection state (0=CONNECTING, 1=OPEN, 2=CLOSING, 3=CLOSED) */
+    readonly readyState: number;
+    /** Number of bytes of data queued for transmission */
+    readonly bufferedAmount: number;
+    /** Send data over the connection */
+    send(data: string | ArrayBuffer | Blob): void;
+    /** Close the connection */
+    close(code?: number, reason?: string): void;
+    /** Called when connection opens */
+    onopen: ((event: Event) => void) | null;
+    /** Called when a message is received */
+    onmessage: ((event: MessageEvent) => void) | null;
+    /** Called when an error occurs */
+    onerror: ((event: Event) => void) | null;
+    /** Called when connection closes */
+    onclose: ((event: CloseEvent) => void) | null;
+}
+/**
+ * Factory function type for creating WebSocket-like connections.
+ * Used by extensions to provide a proxy WebSocket that bypasses page CSP.
+ */
+export type WebSocketFactory = (url: string) => WebSocketLike;

package/dist/types.d.ts

@@ -35,6 +35,13 @@ export interface SpeechOSCoreConfig {
     host?: string;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Custom WebSocket factory for creating connections.
+     * Used by the Chrome extension to route WebSocket traffic through the
+     * service worker, bypassing page CSP restrictions.
+     * If not provided, uses the native WebSocket constructor.
+     */
+    webSocketFactory?: WebSocketFactory;
 }
 /**
  * Session settings passed when starting a voice session
@@ -187,7 +194,12 @@ export interface SpeechOSEventMap {
     "state:change": {
         state: SpeechOSState;
     };
-    /** Emitted when transcription is received from the server */
+    /** Emitted when intermediate transcription is received from server (indicates audio is being processed) */
+    "transcription:interim": {
+        transcript: string;
+        isFinal: boolean;
+    };
+    /** Emitted when final transcription is received from the server */
     "transcription:complete": {
         text: string;
     };
@@ -231,3 +243,31 @@ export type StateChangeCallback = (newState: SpeechOSState, prevState: SpeechOSS
  * Unsubscribe function returned by event listeners
  */
 export type UnsubscribeFn = () => void;
+/**
+ * Minimal WebSocket-like interface used by the SDK.
+ * This allows the extension to provide a proxy WebSocket that routes
+ * traffic through the service worker to bypass page CSP restrictions.
+ */
+export interface WebSocketLike {
+    /** Current connection state (0=CONNECTING, 1=OPEN, 2=CLOSING, 3=CLOSED) */
+    readonly readyState: number;
+    /** Number of bytes of data queued for transmission */
+    readonly bufferedAmount: number;
+    /** Send data over the connection */
+    send(data: string | ArrayBuffer | Blob): void;
+    /** Close the connection */
+    close(code?: number, reason?: string): void;
+    /** Called when connection opens */
+    onopen: ((event: Event) => void) | null;
+    /** Called when a message is received */
+    onmessage: ((event: MessageEvent) => void) | null;
+    /** Called when an error occurs */
+    onerror: ((event: Event) => void) | null;
+    /** Called when connection closes */
+    onclose: ((event: CloseEvent) => void) | null;
+}
+/**
+ * Factory function type for creating WebSocket-like connections.
+ * Used by extensions to provide a proxy WebSocket that bypasses page CSP.
+ */
+export type WebSocketFactory = (url: string) => WebSocketLike;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speechos/core",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Headless core SDK for SpeechOS - state, events, LiveKit integration",
   "type": "module",
   "main": "./dist/index.cjs",