@speechos/core 0.2.7 → 0.2.8

package/dist/types.d.cts

@@ -42,6 +42,19 @@ export interface SpeechOSCoreConfig {
      * If not provided, uses the native WebSocket constructor.
      */
     webSocketFactory?: WebSocketFactory;
+    /**
+     * Custom fetch handler for making HTTP requests.
+     * Used by the Chrome extension to route fetch traffic through the
+     * service worker, bypassing page CSP restrictions.
+     * If not provided, uses the native fetch function.
+     */
+    fetchHandler?: FetchHandler;
+    /**
+     * JWT token for server-side settings persistence.
+     * When provided, user settings (language, vocabulary, snippets) are synced to the server.
+     * Generate this token server-side via POST /api/user-settings-token/ with your UserAPIKey.
+     */
+    settingsToken?: string;
 }
 /**
  * Session settings passed when starting a voice session
@@ -223,11 +236,21 @@ export interface SpeechOSEventMap {
         editedContent: string;
         element: HTMLElement;
     };
-    /** Emitted when user settings change (language, snippets, vocabulary, smartFormat) */
+    /** Emitted when user settings change (language, snippets, vocabulary, smartFormat, history) */
     "settings:changed": {
         /** Type of setting that changed */
-        setting: "language" | "snippets" | "vocabulary" | "smartFormat";
+        setting: "language" | "snippets" | "vocabulary" | "smartFormat" | "history";
+    };
+    /** Emitted when settings are loaded from the server */
+    "settings:loaded": void;
+    /** Emitted when settings are synced to the server */
+    "settings:synced": void;
+    /** Emitted when settings sync fails */
+    "settings:syncFailed": {
+        error: string;
     };
+    /** Emitted when the settings token expires (user should request a new one) */
+    "settings:tokenExpired": void;
     /** Emitted when an error occurs */
     error: {
         code: string;
@@ -271,3 +294,38 @@ export interface WebSocketLike {
  * Used by extensions to provide a proxy WebSocket that bypasses page CSP.
  */
 export type WebSocketFactory = (url: string) => WebSocketLike;
+/**
+ * Options for fetch requests (subset of RequestInit used by settings sync).
+ * Used by extensions to route fetch traffic through the service worker.
+ */
+export interface FetchOptions {
+    /** HTTP method (GET, POST, PUT, DELETE, etc.) */
+    method?: string;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request body (JSON string) */
+    body?: string;
+}
+/**
+ * Response from fetch handler (subset of Response used by settings sync).
+ * Provides a Response-like interface that can be serialized through message passing.
+ */
+export interface FetchResponse {
+    /** Whether the response was successful (status 200-299) */
+    ok: boolean;
+    /** HTTP status code */
+    status: number;
+    /** HTTP status text */
+    statusText: string;
+    /** Parse response body as JSON */
+    json(): Promise<unknown>;
+    /** Get response body as text */
+    text(): Promise<string>;
+}
+/**
+ * Custom fetch handler for making HTTP requests.
+ * Used by the Chrome extension to route fetch traffic through the
+ * service worker, bypassing page CSP restrictions.
+ * If not provided, uses the native fetch function.
+ */
+export type FetchHandler = (url: string, options?: FetchOptions) => Promise<FetchResponse>;

package/dist/types.d.ts

@@ -42,6 +42,19 @@ export interface SpeechOSCoreConfig {
      * If not provided, uses the native WebSocket constructor.
      */
     webSocketFactory?: WebSocketFactory;
+    /**
+     * Custom fetch handler for making HTTP requests.
+     * Used by the Chrome extension to route fetch traffic through the
+     * service worker, bypassing page CSP restrictions.
+     * If not provided, uses the native fetch function.
+     */
+    fetchHandler?: FetchHandler;
+    /**
+     * JWT token for server-side settings persistence.
+     * When provided, user settings (language, vocabulary, snippets) are synced to the server.
+     * Generate this token server-side via POST /api/user-settings-token/ with your UserAPIKey.
+     */
+    settingsToken?: string;
 }
 /**
  * Session settings passed when starting a voice session
@@ -223,11 +236,21 @@ export interface SpeechOSEventMap {
         editedContent: string;
         element: HTMLElement;
     };
-    /** Emitted when user settings change (language, snippets, vocabulary, smartFormat) */
+    /** Emitted when user settings change (language, snippets, vocabulary, smartFormat, history) */
     "settings:changed": {
         /** Type of setting that changed */
-        setting: "language" | "snippets" | "vocabulary" | "smartFormat";
+        setting: "language" | "snippets" | "vocabulary" | "smartFormat" | "history";
+    };
+    /** Emitted when settings are loaded from the server */
+    "settings:loaded": void;
+    /** Emitted when settings are synced to the server */
+    "settings:synced": void;
+    /** Emitted when settings sync fails */
+    "settings:syncFailed": {
+        error: string;
     };
+    /** Emitted when the settings token expires (user should request a new one) */
+    "settings:tokenExpired": void;
     /** Emitted when an error occurs */
     error: {
         code: string;
@@ -271,3 +294,38 @@ export interface WebSocketLike {
  * Used by extensions to provide a proxy WebSocket that bypasses page CSP.
  */
 export type WebSocketFactory = (url: string) => WebSocketLike;
+/**
+ * Options for fetch requests (subset of RequestInit used by settings sync).
+ * Used by extensions to route fetch traffic through the service worker.
+ */
+export interface FetchOptions {
+    /** HTTP method (GET, POST, PUT, DELETE, etc.) */
+    method?: string;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request body (JSON string) */
+    body?: string;
+}
+/**
+ * Response from fetch handler (subset of Response used by settings sync).
+ * Provides a Response-like interface that can be serialized through message passing.
+ */
+export interface FetchResponse {
+    /** Whether the response was successful (status 200-299) */
+    ok: boolean;
+    /** HTTP status code */
+    status: number;
+    /** HTTP status text */
+    statusText: string;
+    /** Parse response body as JSON */
+    json(): Promise<unknown>;
+    /** Get response body as text */
+    text(): Promise<string>;
+}
+/**
+ * Custom fetch handler for making HTTP requests.
+ * Used by the Chrome extension to route fetch traffic through the
+ * service worker, bypassing page CSP restrictions.
+ * If not provided, uses the native fetch function.
+ */
+export type FetchHandler = (url: string, options?: FetchOptions) => Promise<FetchResponse>;

package/package.json

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