@speechos/core 0.2.7 → 0.2.9

package/dist/types.d.cts

@@ -42,6 +42,12 @@ export interface SpeechOSCoreConfig {
      * If not provided, uses the native WebSocket constructor.
      */
     webSocketFactory?: WebSocketFactory;
+    /**
+     * 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 +229,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;

package/dist/types.d.ts

@@ -42,6 +42,12 @@ export interface SpeechOSCoreConfig {
      * If not provided, uses the native WebSocket constructor.
      */
     webSocketFactory?: WebSocketFactory;
+    /**
+     * 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 +229,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;

package/package.json

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