@speechos/core 0.2.7 → 0.2.8

package/dist/config.d.cts

@@ -1,7 +1,7 @@
 /**
  * Configuration management for SpeechOS Core SDK
  */
-import type { SpeechOSCoreConfig, WebSocketFactory } from "./types.js";
+import type { SpeechOSCoreConfig, WebSocketFactory, FetchHandler } from "./types.js";
 /**
  * Default host - can be overridden by SPEECHOS_HOST env var at build time
  */
@@ -16,6 +16,10 @@ interface ResolvedConfig {
     debug: boolean;
     /** Custom WebSocket factory (undefined means use native WebSocket) */
     webSocketFactory: WebSocketFactory | undefined;
+    /** Custom fetch handler (undefined means use native fetch) */
+    fetchHandler: FetchHandler | undefined;
+    /** JWT token for server-side settings persistence (undefined means no sync) */
+    settingsToken: string | undefined;
 }
 /**
  * Validates and merges user config with defaults
@@ -41,6 +45,20 @@ export declare function resetConfig(): void;
  * @param userId - The user identifier to set
  */
 export declare function updateUserId(userId: string): void;
+/**
+ * Get the settings token from the current configuration
+ * @returns The settings token or undefined if not configured
+ */
+export declare function getSettingsToken(): string | undefined;
+/**
+ * Clear the settings token (e.g., when it expires)
+ */
+export declare function clearSettingsToken(): void;
+/**
+ * Get the fetch handler from the current configuration
+ * @returns The fetch handler or undefined if not configured
+ */
+export declare function getFetchHandler(): FetchHandler | undefined;
 /**
  * Get or generate a persistent anonymous ID for Mixpanel tracking.
  *

package/dist/config.d.ts

@@ -1,7 +1,7 @@
 /**
  * Configuration management for SpeechOS Core SDK
  */
-import type { SpeechOSCoreConfig, WebSocketFactory } from "./types.js";
+import type { SpeechOSCoreConfig, WebSocketFactory, FetchHandler } from "./types.js";
 /**
  * Default host - can be overridden by SPEECHOS_HOST env var at build time
  */
@@ -16,6 +16,10 @@ interface ResolvedConfig {
     debug: boolean;
     /** Custom WebSocket factory (undefined means use native WebSocket) */
     webSocketFactory: WebSocketFactory | undefined;
+    /** Custom fetch handler (undefined means use native fetch) */
+    fetchHandler: FetchHandler | undefined;
+    /** JWT token for server-side settings persistence (undefined means no sync) */
+    settingsToken: string | undefined;
 }
 /**
  * Validates and merges user config with defaults
@@ -41,6 +45,20 @@ export declare function resetConfig(): void;
  * @param userId - The user identifier to set
  */
 export declare function updateUserId(userId: string): void;
+/**
+ * Get the settings token from the current configuration
+ * @returns The settings token or undefined if not configured
+ */
+export declare function getSettingsToken(): string | undefined;
+/**
+ * Clear the settings token (e.g., when it expires)
+ */
+export declare function clearSettingsToken(): void;
+/**
+ * Get the fetch handler from the current configuration
+ * @returns The fetch handler or undefined if not configured
+ */
+export declare function getFetchHandler(): FetchHandler | undefined;
 /**
  * Get or generate a persistent anonymous ID for Mixpanel tracking.
  *

package/dist/index.cjs

@@ -36,7 +36,9 @@ const defaultConfig = {
 	userId: "",
 	host: DEFAULT_HOST,
 	debug: false,
-	webSocketFactory: void 0
+	webSocketFactory: void 0,
+	fetchHandler: void 0,
+	settingsToken: void 0
 };
 /**
 * Validates and merges user config with defaults
@@ -50,7 +52,9 @@ function validateConfig(userConfig) {
 		userId: userConfig.userId ?? defaultConfig.userId,
 		host: userConfig.host ?? defaultConfig.host,
 		debug: userConfig.debug ?? defaultConfig.debug,
-		webSocketFactory: userConfig.webSocketFactory ?? defaultConfig.webSocketFactory
+		webSocketFactory: userConfig.webSocketFactory ?? defaultConfig.webSocketFactory,
+		fetchHandler: userConfig.fetchHandler ?? defaultConfig.fetchHandler,
+		settingsToken: userConfig.settingsToken ?? defaultConfig.settingsToken
 	};
 }
 /**
@@ -87,6 +91,29 @@ function updateUserId(userId) {
 	};
 }
 /**
+* Get the settings token from the current configuration
+* @returns The settings token or undefined if not configured
+*/
+function getSettingsToken() {
+	return currentConfig.settingsToken;
+}
+/**
+* Clear the settings token (e.g., when it expires)
+*/
+function clearSettingsToken() {
+	currentConfig = {
+		...currentConfig,
+		settingsToken: void 0
+	};
+}
+/**
+* Get the fetch handler from the current configuration
+* @returns The fetch handler or undefined if not configured
+*/
+function getFetchHandler() {
+	return currentConfig.fetchHandler;
+}
+/**
 * LocalStorage key for anonymous ID persistence
 */
 const ANONYMOUS_ID_KEY = "speechos_anonymous_id";
@@ -2270,10 +2297,13 @@ exports.DEFAULT_HOST = DEFAULT_HOST;
 exports.Deferred = Deferred;
 exports.SpeechOSEventEmitter = SpeechOSEventEmitter;
 exports.VERSION = VERSION;
+exports.clearSettingsToken = clearSettingsToken;
 exports.createStateManager = createStateManager;
 exports.events = events;
 exports.getBackend = getBackend;
 exports.getConfig = getConfig;
+exports.getFetchHandler = getFetchHandler;
+exports.getSettingsToken = getSettingsToken;
 exports.livekit = livekit;
 exports.resetConfig = resetConfig;
 exports.setConfig = setConfig;