@speechos/core 0.2.2 → 0.2.4

package/dist/config.d.cts

@@ -39,4 +39,14 @@ export declare function resetConfig(): void;
  * @param userId - The user identifier to set
  */
 export declare function updateUserId(userId: string): void;
+/**
+ * Get or generate a persistent anonymous ID for Mixpanel tracking.
+ *
+ * This ID is stored in localStorage to persist across sessions,
+ * allowing consistent anonymous user tracking without identifying
+ * the account owner's customers.
+ *
+ * @returns A UUID string for anonymous identification
+ */
+export declare function getAnonymousId(): string;
 export {};

package/dist/config.d.ts

@@ -39,4 +39,14 @@ export declare function resetConfig(): void;
  * @param userId - The user identifier to set
  */
 export declare function updateUserId(userId: string): void;
+/**
+ * Get or generate a persistent anonymous ID for Mixpanel tracking.
+ *
+ * This ID is stored in localStorage to persist across sessions,
+ * allowing consistent anonymous user tracking without identifying
+ * the account owner's customers.
+ *
+ * @returns A UUID string for anonymous identification
+ */
+export declare function getAnonymousId(): string;
 export {};

package/dist/index.cjs

@@ -84,6 +84,28 @@ function updateUserId(userId) {
 		userId
 	};
 }
+/**
+* LocalStorage key for anonymous ID persistence
+*/
+const ANONYMOUS_ID_KEY = "speechos_anonymous_id";
+/**
+* Get or generate a persistent anonymous ID for Mixpanel tracking.
+*
+* This ID is stored in localStorage to persist across sessions,
+* allowing consistent anonymous user tracking without identifying
+* the account owner's customers.
+*
+* @returns A UUID string for anonymous identification
+*/
+function getAnonymousId() {
+	if (typeof localStorage === "undefined") return crypto.randomUUID();
+	let anonymousId = localStorage.getItem(ANONYMOUS_ID_KEY);
+	if (!anonymousId) {
+		anonymousId = crypto.randomUUID();
+		localStorage.setItem(ANONYMOUS_ID_KEY, anonymousId);
+	}
+	return anonymousId;
+}
 
 //#endregion
 //#region src/events.ts
@@ -1550,10 +1572,12 @@ var WebSocketManager = class {
 		const config = getConfig();
 		const audioFormat = getSupportedAudioFormat();
 		const settings = this.sessionSettings;
+		const anonymousId = getAnonymousId();
 		const authMessage = {
 			type: MESSAGE_TYPE_AUTH,
 			api_key: config.apiKey,
 			user_id: config.userId || null,
+			anonymous_id: anonymousId,
 			input_language: settings.inputLanguageCode ?? "en-US",
 			output_language: settings.outputLanguageCode ?? "en-US",
 			smart_format: settings.smartFormat ?? true,