@ada-cx/messaging-sdk 1.0.0-setup.0

package/dist/voice/voice-manager.d.ts

@@ -0,0 +1,120 @@
+export interface VoiceManagerCallbacks {
+    /** Called when speech recognition updates transcript (interim or final) */
+    onTranscriptUpdate: (transcript: string, isFinal: boolean) => void;
+    /** Called when speech recognition encounters an error */
+    onError: (error: string) => void;
+    /** Called periodically with audio level 0-1 for waveform visualization */
+    onAudioLevel: (level: number) => void;
+}
+export interface VoiceManagerConfig {
+    /** Language code for speech recognition (e.g., "en-US") */
+    language: string;
+    /** Recording mode: toggle (click to start/stop) or push-to-talk (hold button) */
+    mode: "toggle" | "push-to-talk";
+    /** Callbacks for voice events */
+    callbacks: VoiceManagerCallbacks;
+}
+export declare class VoiceManager {
+    private recognition;
+    private audioContext;
+    private analyser;
+    private audioSource;
+    private mediaStream;
+    private audioLevelRafId;
+    /** Set to true when a fatal recognition error occurs to prevent restart loops. */
+    private _hadFatalError;
+    private config;
+    constructor(config: VoiceManagerConfig);
+    /**
+     * Check if Web Speech API is supported in the current browser.
+     */
+    static isSupported(): boolean;
+    /**
+     * Start voice recording.
+     * Requests microphone permission and begins speech recognition.
+     * @returns Promise<boolean> - true if started successfully, false otherwise
+     */
+    startRecording(): Promise<boolean>;
+    /**
+     * Stop voice recording and cleanup resources.
+     */
+    stopRecording(): void;
+    /**
+     * Update recognition language.
+     */
+    setLanguage(language: string): void;
+    /**
+     * Update recording mode (toggle or push-to-talk).
+     */
+    setMode(mode: "toggle" | "push-to-talk"): void;
+    /**
+     * Start monitoring audio levels for waveform visualization.
+     * Uses requestAnimationFrame instead of setInterval to avoid firing
+     * while the tab is hidden and to align with the display refresh rate.
+     */
+    private startAudioLevelMonitoring;
+    /**
+     * Stop audio level monitoring.
+     */
+    private stopAudioLevelMonitoring;
+    /**
+     * Cleanup resources on destroy.
+     */
+    destroy(): void;
+}
+/**
+ * Text-to-Speech helper function.
+ * Uses Web Speech Synthesis API to speak text.
+ *
+ * Note: `speechSynthesis.cancel()` cancels ALL pending speech globally —
+ * there is no namespacing in the Web Speech API. If the host page also uses
+ * speechSynthesis, Ada will cancel its speech. This is a known browser API
+ * limitation with no available workaround.
+ */
+export declare function speakText(text: string, language: string): void;
+/**
+ * Type declarations for Web Speech API (may not be in all TypeScript versions).
+ */
+declare global {
+    interface Window {
+        SpeechRecognition: typeof SpeechRecognition;
+        webkitSpeechRecognition: typeof SpeechRecognition;
+    }
+    interface SpeechRecognition extends EventTarget {
+        continuous: boolean;
+        interimResults: boolean;
+        lang: string;
+        onresult: ((event: SpeechRecognitionEvent) => void) | null;
+        onerror: ((event: SpeechRecognitionErrorEvent) => void) | null;
+        onend: (() => void) | null;
+        start(): void;
+        stop(): void;
+    }
+    interface SpeechRecognitionEvent extends Event {
+        results: SpeechRecognitionResultList;
+        resultIndex: number;
+    }
+    interface SpeechRecognitionResultList {
+        readonly length: number;
+        item(index: number): SpeechRecognitionResult;
+        [index: number]: SpeechRecognitionResult;
+    }
+    interface SpeechRecognitionResult {
+        readonly isFinal: boolean;
+        readonly length: number;
+        item(index: number): SpeechRecognitionAlternative;
+        [index: number]: SpeechRecognitionAlternative;
+    }
+    interface SpeechRecognitionAlternative {
+        readonly transcript: string;
+        readonly confidence: number;
+    }
+    interface SpeechRecognitionErrorEvent extends Event {
+        error: string;
+        message: string;
+    }
+    const SpeechRecognition: {
+        prototype: SpeechRecognition;
+        new (): SpeechRecognition;
+    };
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+	"name": "@ada-cx/messaging-sdk",
+	"version": "1.0.0-setup.0",
+	"description": "TypeScript types, test mocks, and a thin CDN loader for the Ada Messaging SDK. The runtime always resolves from Ada's CDN and is never bundled into this package.",
+	"homepage": "https://github.com/AdaSupport/monorepo/tree/main/messaging/packages/sdk#readme",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/AdaSupport/monorepo.git",
+		"directory": "messaging/packages/sdk"
+	},
+	"bugs": {
+		"url": "https://github.com/AdaSupport/monorepo/issues"
+	},
+	"keywords": [
+		"ada",
+		"ada.cx",
+		"chat",
+		"messaging",
+		"sdk",
+		"embed",
+		"loader"
+	],
+	"license": "ISC",
+	"type": "module",
+	"sideEffects": false,
+	"main": "./dist/npm/index.cjs",
+	"module": "./dist/npm/index.js",
+	"types": "./dist/npm/index.d.ts",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/npm/index.d.ts",
+				"default": "./dist/npm/index.js"
+			},
+			"require": {
+				"types": "./dist/npm/index.d.cts",
+				"default": "./dist/npm/index.cjs"
+			}
+		},
+		"./testing": {
+			"import": {
+				"types": "./dist/npm/testing.d.ts",
+				"default": "./dist/npm/testing.js"
+			},
+			"require": {
+				"types": "./dist/npm/testing.d.cts",
+				"default": "./dist/npm/testing.cjs"
+			}
+		}
+	},
+	"typesVersions": {
+		"*": {
+			"testing": [
+				"dist/npm/testing.d.ts"
+			]
+		}
+	},
+	"files": [
+		"dist/npm/",
+		"dist/**/*.d.ts",
+		"!dist/**/*.test.d.ts",
+		"!dist/npm/types-drift.d.ts",
+		"README_NPM.md"
+	],
+	"publishConfig": {
+		"access": "public",
+		"provenance": true
+	},
+	"scripts": {
+		"build": "vite build && vite build --mode npm && tsc -b && node scripts/finish-npm-package.mjs",
+		"dev": "vite",
+		"lint": "npx biome check"
+	},
+	"devDependencies": {
+		"uuid": "*"
+	}
+}