@corti/dictation-web 0.3.0-rc → 0.4.0-rc

package/dist/controllers/DictationController.js

@@ -0,0 +1,130 @@
+import { CortiClient, CortiWebSocketProxyClient } from "@corti/sdk";
+import { DEFAULT_DICTATION_CONFIG } from "../constants.js";
+export class DictationController {
+    constructor(host) {
+        this._cortiClient = null;
+        this._webSocket = null;
+        this.host = host;
+        host.addController(this);
+    }
+    hostDisconnected() {
+        this.cleanup();
+    }
+    async connect(mediaRecorder, dictationConfig = DEFAULT_DICTATION_CONFIG, callbacks = {}) {
+        if (!mediaRecorder) {
+            throw new Error("MediaRecorder is required to connect");
+        }
+        if (this._webSocket?.readyState === WebSocket.OPEN) {
+            throw new Error("Already connected. Disconnect before reconnecting.");
+        }
+        this._webSocket =
+            this.host._socketUrl || this.host._socketProxy
+                ? await this.connectProxy(dictationConfig)
+                : await this.connectAuth(dictationConfig);
+        this._onNetworkActivity = callbacks.onNetworkActivity;
+        this.setupMediaRecorder(mediaRecorder);
+        this.setupWebSocketHandlers(callbacks);
+    }
+    async connectProxy(dictationConfig) {
+        const proxyOptions = this.host._socketProxy || {
+            url: this.host._socketUrl || "",
+        };
+        if (!proxyOptions.url) {
+            throw new Error("Proxy URL is required when using proxy client");
+        }
+        return await CortiWebSocketProxyClient.transcribe.connect({
+            configuration: dictationConfig,
+            proxy: proxyOptions,
+        });
+    }
+    async connectAuth(dictationConfig) {
+        if (!this.host._authConfig && !this.host._accessToken) {
+            throw new Error("Auth configuration or access token is required to connect");
+        }
+        // Use authConfig if available, otherwise create one from accessToken
+        const auth = this.host._authConfig || {
+            accessToken: this.host._accessToken || "",
+            refreshAccessToken: () => ({
+                accessToken: this.host._accessToken || "",
+            }),
+        };
+        this._cortiClient = new CortiClient({
+            auth,
+            environment: this.host._region,
+            tenantName: this.host._tenantName,
+        });
+        return await this._cortiClient.transcribe.connect({
+            configuration: dictationConfig,
+        });
+    }
+    setupWebSocketHandlers(callbacks) {
+        if (!this._webSocket) {
+            throw new Error("WebSocket not initialized");
+        }
+        this._webSocket.on("message", (message) => {
+            this._onNetworkActivity?.("received", message);
+            if (callbacks.onMessage) {
+                callbacks.onMessage(message);
+            }
+        });
+        this._webSocket.on("error", (event) => {
+            if (callbacks.onError) {
+                callbacks.onError(event);
+            }
+        });
+        this._webSocket.on("close", (event) => {
+            if (callbacks.onClose) {
+                callbacks.onClose(event);
+            }
+        });
+    }
+    setupMediaRecorder(mediaRecorder) {
+        mediaRecorder.ondataavailable = (event) => {
+            this._webSocket?.sendAudio(event.data);
+            this._onNetworkActivity?.("sent", {
+                size: event.data.size,
+                type: "audio",
+            });
+        };
+    }
+    async disconnect(onClose) {
+        await new Promise((resolve, reject) => {
+            if (!this._webSocket || this._webSocket.readyState !== WebSocket.OPEN) {
+                resolve();
+                return;
+            }
+            this._webSocket.on("close", (event) => {
+                if (this._closeTimeout) {
+                    clearTimeout(this._closeTimeout);
+                    this._closeTimeout = undefined;
+                }
+                if (onClose) {
+                    onClose(event);
+                }
+                resolve();
+            });
+            this._webSocket.sendEnd({ type: "end" });
+            this._onNetworkActivity?.("sent", { type: "end" });
+            this._closeTimeout = window.setTimeout(() => {
+                // Reject the promise before closing the web socket, so the promise rejects before close event fires
+                reject(new Error("WebSocket close timeout"));
+                if (this._webSocket?.readyState === WebSocket.OPEN) {
+                    this._webSocket.close();
+                }
+            }, 10000);
+        });
+        this.cleanup();
+    }
+    cleanup() {
+        if (this._closeTimeout) {
+            clearTimeout(this._closeTimeout);
+            this._closeTimeout = undefined;
+        }
+        if (this._webSocket?.readyState === WebSocket.OPEN) {
+            this._webSocket.close();
+        }
+        this._webSocket = null;
+        this._cortiClient = null;
+    }
+}
+//# sourceMappingURL=DictationController.js.map

package/dist/controllers/DictationController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DictationController.js","sourceRoot":"","sources":["../../src/controllers/DictationController.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Corti, CortiClient, CortiWebSocketProxyClient } from \"@corti/sdk\";\nimport type { ReactiveController, ReactiveControllerHost } from \"lit\";\nimport { DEFAULT_DICTATION_CONFIG } from \"../constants.js\";\nimport type { ProxyOptions } from \"../types.js\";\n\ntype TranscribeSocket = Awaited<\n  ReturnType<CortiClient[\"transcribe\"][\"connect\"]>\n>;\n\ninterface DictationControllerHost extends ReactiveControllerHost {\n  _accessToken?: string;\n  _authConfig?: Corti.BearerOptions;\n  _region?: string;\n  _tenantName?: string;\n  _socketUrl?: string;\n  _socketProxy?: ProxyOptions;\n}\n\nexport type TranscribeMessage =\n  | Corti.TranscribeConfigStatusMessage\n  | Corti.TranscribeUsageMessage\n  | Corti.TranscribeEndedMessage\n  | Corti.TranscribeErrorMessage\n  | Corti.TranscribeTranscriptMessage\n  | Corti.TranscribeCommandMessage\n  | Corti.TranscribeFlushedMessage;\n\ninterface WebSocketCallbacks {\n  onMessage?: (message: TranscribeMessage) => void;\n  onError?: (error: Error) => void;\n  onClose?: (event: unknown) => void;\n  onNetworkActivity?: (direction: \"sent\" | \"received\", data: unknown) => void;\n}\n\nexport class DictationController implements ReactiveController {\n  host: DictationControllerHost;\n\n  private _cortiClient: CortiClient | null = null;\n  private _webSocket: TranscribeSocket | null = null;\n  private _closeTimeout?: number;\n  private _onNetworkActivity?: WebSocketCallbacks[\"onNetworkActivity\"];\n\n  constructor(host: DictationControllerHost) {\n    this.host = host;\n    host.addController(this);\n  }\n\n  hostDisconnected(): void {\n    this.cleanup();\n  }\n\n  async connect(\n    mediaRecorder: MediaRecorder | null,\n    dictationConfig: Corti.TranscribeConfig = DEFAULT_DICTATION_CONFIG,\n    callbacks: WebSocketCallbacks = {},\n  ): Promise<void> {\n    if (!mediaRecorder) {\n      throw new Error(\"MediaRecorder is required to connect\");\n    }\n\n    if (this._webSocket?.readyState === WebSocket.OPEN) {\n      throw new Error(\"Already connected. Disconnect before reconnecting.\");\n    }\n\n    this._webSocket =\n      this.host._socketUrl || this.host._socketProxy\n        ? await this.connectProxy(dictationConfig)\n        : await this.connectAuth(dictationConfig);\n\n    this._onNetworkActivity = callbacks.onNetworkActivity;\n    this.setupMediaRecorder(mediaRecorder);\n    this.setupWebSocketHandlers(callbacks);\n  }\n\n  private async connectProxy(\n    dictationConfig: Corti.TranscribeConfig,\n  ): Promise<TranscribeSocket> {\n    const proxyOptions = this.host._socketProxy || {\n      url: this.host._socketUrl || \"\",\n    };\n\n    if (!proxyOptions.url) {\n      throw new Error(\"Proxy URL is required when using proxy client\");\n    }\n\n    return await CortiWebSocketProxyClient.transcribe.connect({\n      configuration: dictationConfig,\n      proxy: proxyOptions,\n    });\n  }\n\n  private async connectAuth(\n    dictationConfig: Corti.TranscribeConfig,\n  ): Promise<TranscribeSocket> {\n    if (!this.host._authConfig && !this.host._accessToken) {\n      throw new Error(\n        \"Auth configuration or access token is required to connect\",\n      );\n    }\n\n    // Use authConfig if available, otherwise create one from accessToken\n    const auth: Corti.BearerOptions = this.host._authConfig || {\n      accessToken: this.host._accessToken || \"\",\n      refreshAccessToken: () => ({\n        accessToken: this.host._accessToken || \"\",\n      }),\n    };\n\n    this._cortiClient = new CortiClient({\n      auth,\n      environment: this.host._region,\n      tenantName: this.host._tenantName,\n    });\n\n    return await this._cortiClient.transcribe.connect({\n      configuration: dictationConfig,\n    });\n  }\n\n  private setupWebSocketHandlers(callbacks: WebSocketCallbacks): void {\n    if (!this._webSocket) {\n      throw new Error(\"WebSocket not initialized\");\n    }\n\n    this._webSocket.on(\"message\", (message: TranscribeMessage) => {\n      this._onNetworkActivity?.(\"received\", message);\n\n      if (callbacks.onMessage) {\n        callbacks.onMessage(message);\n      }\n    });\n\n    this._webSocket.on(\"error\", (event: Error) => {\n      if (callbacks.onError) {\n        callbacks.onError(event);\n      }\n    });\n\n    this._webSocket.on(\"close\", (event: unknown) => {\n      if (callbacks.onClose) {\n        callbacks.onClose(event);\n      }\n    });\n  }\n\n  private setupMediaRecorder(mediaRecorder: MediaRecorder): void {\n    mediaRecorder.ondataavailable = (event) => {\n      this._webSocket?.sendAudio(event.data);\n      this._onNetworkActivity?.(\"sent\", {\n        size: event.data.size,\n        type: \"audio\",\n      });\n    };\n  }\n\n  async disconnect(onClose?: (event: unknown) => void): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      if (!this._webSocket || this._webSocket.readyState !== WebSocket.OPEN) {\n        resolve();\n        return;\n      }\n\n      this._webSocket.on(\"close\", (event) => {\n        if (this._closeTimeout) {\n          clearTimeout(this._closeTimeout);\n          this._closeTimeout = undefined;\n        }\n\n        if (onClose) {\n          onClose(event);\n        }\n\n        resolve();\n      });\n\n      this._webSocket.sendEnd({ type: \"end\" });\n      this._onNetworkActivity?.(\"sent\", { type: \"end\" });\n\n      this._closeTimeout = window.setTimeout(() => {\n        // Reject the promise before closing the web socket, so the promise rejects before close event fires\n        reject(new Error(\"WebSocket close timeout\"));\n\n        if (this._webSocket?.readyState === WebSocket.OPEN) {\n          this._webSocket.close();\n        }\n      }, 10000);\n    });\n\n    this.cleanup();\n  }\n\n  cleanup(): void {\n    if (this._closeTimeout) {\n      clearTimeout(this._closeTimeout);\n      this._closeTimeout = undefined;\n    }\n\n    if (this._webSocket?.readyState === WebSocket.OPEN) {\n      this._webSocket.close();\n    }\n\n    this._webSocket = null;\n    this._cortiClient = null;\n  }\n}\n"]}

package/dist/controllers/MediaController.d.ts

@@ -0,0 +1,31 @@
+import type { ReactiveController, ReactiveControllerHost } from "lit";
+interface MediaControllerHost extends ReactiveControllerHost {
+    _selectedDevice?: MediaDeviceInfo;
+    _debug_displayAudio?: boolean;
+}
+export declare class MediaController implements ReactiveController {
+    host: MediaControllerHost;
+    private _mediaStream;
+    private _audioContext;
+    private _analyser;
+    private _mediaRecorder;
+    private _visualiserInterval?;
+    private _audioLevel;
+    private _onTrackEnded?;
+    private _onAudioLevelChange?;
+    constructor(host: MediaControllerHost);
+    hostDisconnected(): void;
+    initialize(onTrackEnded?: () => void): Promise<void>;
+    getAudioLevel(): number;
+    startAudioLevelMonitoring(onAudioLevelChange?: (level: number) => void): void;
+    stopAudioLevelMonitoring(): void;
+    cleanup(): Promise<void>;
+    /**
+     * Stops the media recorder and waits for all buffered data to be flushed.
+     * This ensures the final ondataavailable event fires before resolving.
+     */
+    stopRecording(): Promise<void>;
+    get mediaRecorder(): MediaRecorder | null;
+    get audioLevel(): number;
+}
+export {};

package/dist/controllers/MediaController.js

@@ -0,0 +1,99 @@
+import { calculateAudioLevel, createAudioAnalyzer, getMediaStream, } from "../utils/media.js";
+export class MediaController {
+    constructor(host) {
+        this._mediaStream = null;
+        this._audioContext = null;
+        this._analyser = null;
+        this._mediaRecorder = null;
+        this._audioLevel = 0;
+        this.host = host;
+        host.addController(this);
+    }
+    hostDisconnected() {
+        this.cleanup();
+    }
+    async initialize(onTrackEnded) {
+        await this.cleanup();
+        this._onTrackEnded = onTrackEnded;
+        this._mediaStream = await getMediaStream(this.host._selectedDevice?.deviceId, this.host._debug_displayAudio);
+        this._mediaStream.getTracks().forEach((track) => {
+            track.addEventListener("ended", () => {
+                if (this._onTrackEnded) {
+                    this._onTrackEnded();
+                }
+            });
+        });
+        const { audioContext, analyser } = createAudioAnalyzer(this._mediaStream);
+        this._audioContext = audioContext;
+        this._analyser = analyser;
+        this._mediaRecorder = new MediaRecorder(this._mediaStream);
+    }
+    getAudioLevel() {
+        return this._analyser ? calculateAudioLevel(this._analyser) : 0;
+    }
+    startAudioLevelMonitoring(onAudioLevelChange) {
+        this.stopAudioLevelMonitoring();
+        this._onAudioLevelChange = onAudioLevelChange;
+        this._visualiserInterval = window.setInterval(() => {
+            this._audioLevel = this.getAudioLevel() * 3;
+            this.host.requestUpdate();
+            if (this._onAudioLevelChange) {
+                this._onAudioLevelChange(this._audioLevel);
+            }
+        }, 150);
+    }
+    stopAudioLevelMonitoring() {
+        if (this._visualiserInterval) {
+            clearInterval(this._visualiserInterval);
+            this._visualiserInterval = undefined;
+        }
+        this._audioLevel = 0;
+        this.host.requestUpdate();
+        if (this._onAudioLevelChange) {
+            this._onAudioLevelChange(this._audioLevel);
+        }
+    }
+    async cleanup() {
+        this.stopAudioLevelMonitoring();
+        if (this._mediaRecorder?.state === "recording") {
+            this._mediaRecorder.stop();
+        }
+        if (this._mediaStream) {
+            this._mediaStream.getTracks().forEach((track) => {
+                track.stop();
+            });
+            this._mediaStream = null;
+        }
+        if (this._audioContext && this._audioContext.state !== "closed") {
+            await this._audioContext.close();
+        }
+        this._audioContext = null;
+        this._analyser = null;
+        this._mediaRecorder = null;
+        this._onTrackEnded = undefined;
+        this._onAudioLevelChange = undefined;
+    }
+    /**
+     * Stops the media recorder and waits for all buffered data to be flushed.
+     * This ensures the final ondataavailable event fires before resolving.
+     */
+    async stopRecording() {
+        return new Promise((resolve) => {
+            if (!this._mediaRecorder || this._mediaRecorder.state !== "recording") {
+                resolve();
+                return;
+            }
+            this._mediaRecorder.onstop = () => {
+                resolve();
+            };
+            this._mediaRecorder.stop();
+        });
+    }
+    get mediaRecorder() {
+        return this._mediaRecorder;
+    }
+    get audioLevel() {
+        return this._audioLevel;
+    }
+}
+//# sourceMappingURL=MediaController.js.map

package/dist/controllers/MediaController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaController.js","sourceRoot":"","sources":["../../src/controllers/MediaController.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from \"lit\";\nimport {\n  calculateAudioLevel,\n  createAudioAnalyzer,\n  getMediaStream,\n} from \"../utils/media.js\";\n\ninterface MediaControllerHost extends ReactiveControllerHost {\n  _selectedDevice?: MediaDeviceInfo;\n  _debug_displayAudio?: boolean;\n}\n\nexport class MediaController implements ReactiveController {\n  host: MediaControllerHost;\n\n  private _mediaStream: MediaStream | null = null;\n  private _audioContext: AudioContext | null = null;\n  private _analyser: AnalyserNode | null = null;\n  private _mediaRecorder: MediaRecorder | null = null;\n  private _visualiserInterval?: number;\n  private _audioLevel: number = 0;\n  private _onTrackEnded?: () => void;\n  private _onAudioLevelChange?: (level: number) => void;\n\n  constructor(host: MediaControllerHost) {\n    this.host = host;\n    host.addController(this);\n  }\n\n  hostDisconnected(): void {\n    this.cleanup();\n  }\n\n  async initialize(onTrackEnded?: () => void): Promise<void> {\n    await this.cleanup();\n\n    this._onTrackEnded = onTrackEnded;\n    this._mediaStream = await getMediaStream(\n      this.host._selectedDevice?.deviceId,\n      this.host._debug_displayAudio,\n    );\n\n    this._mediaStream.getTracks().forEach((track: MediaStreamTrack) => {\n      track.addEventListener(\"ended\", () => {\n        if (this._onTrackEnded) {\n          this._onTrackEnded();\n        }\n      });\n    });\n\n    const { audioContext, analyser } = createAudioAnalyzer(this._mediaStream);\n\n    this._audioContext = audioContext;\n    this._analyser = analyser;\n\n    this._mediaRecorder = new MediaRecorder(this._mediaStream);\n  }\n\n  getAudioLevel(): number {\n    return this._analyser ? calculateAudioLevel(this._analyser) : 0;\n  }\n\n  startAudioLevelMonitoring(\n    onAudioLevelChange?: (level: number) => void,\n  ): void {\n    this.stopAudioLevelMonitoring();\n\n    this._onAudioLevelChange = onAudioLevelChange;\n\n    this._visualiserInterval = window.setInterval(() => {\n      this._audioLevel = this.getAudioLevel() * 3;\n      this.host.requestUpdate();\n\n      if (this._onAudioLevelChange) {\n        this._onAudioLevelChange(this._audioLevel);\n      }\n    }, 150);\n  }\n\n  stopAudioLevelMonitoring(): void {\n    if (this._visualiserInterval) {\n      clearInterval(this._visualiserInterval);\n      this._visualiserInterval = undefined;\n    }\n\n    this._audioLevel = 0;\n    this.host.requestUpdate();\n\n    if (this._onAudioLevelChange) {\n      this._onAudioLevelChange(this._audioLevel);\n    }\n  }\n\n  async cleanup(): Promise<void> {\n    this.stopAudioLevelMonitoring();\n\n    if (this._mediaRecorder?.state === \"recording\") {\n      this._mediaRecorder.stop();\n    }\n\n    if (this._mediaStream) {\n      this._mediaStream.getTracks().forEach((track) => {\n        track.stop();\n      });\n      this._mediaStream = null;\n    }\n\n    if (this._audioContext && this._audioContext.state !== \"closed\") {\n      await this._audioContext.close();\n    }\n\n    this._audioContext = null;\n\n    this._analyser = null;\n    this._mediaRecorder = null;\n    this._onTrackEnded = undefined;\n    this._onAudioLevelChange = undefined;\n  }\n\n  /**\n   * Stops the media recorder and waits for all buffered data to be flushed.\n   * This ensures the final ondataavailable event fires before resolving.\n   */\n  async stopRecording(): Promise<void> {\n    return new Promise<void>((resolve) => {\n      if (!this._mediaRecorder || this._mediaRecorder.state !== \"recording\") {\n        resolve();\n        return;\n      }\n\n      this._mediaRecorder.onstop = () => {\n        resolve();\n      };\n\n      this._mediaRecorder.stop();\n    });\n  }\n\n  get mediaRecorder(): MediaRecorder | null {\n    return this._mediaRecorder;\n  }\n\n  get audioLevel(): number {\n    return this._audioLevel;\n  }\n}\n"]}

package/dist/controllers/devices-controller.d.ts

@@ -0,0 +1,26 @@
+import type { ReactiveController, ReactiveControllerHost } from "lit";
+interface DevicesControllerHost extends ReactiveControllerHost {
+    devices?: MediaDeviceInfo[];
+    selectedDevice?: MediaDeviceInfo;
+    dispatchEvent(event: CustomEvent): boolean;
+    requestUpdate(): void;
+    _devices?: MediaDeviceInfo[];
+}
+/**
+ * Controller that manages automatic device loading.
+ * Loads devices when they're not present and handles device changes.
+ * Reacts to updates and automatically loads devices when needed.
+ */
+export declare class DevicesController implements ReactiveController {
+    #private;
+    host: DevicesControllerHost;
+    constructor(host: DevicesControllerHost);
+    initialize(): void;
+    hostDisconnected(): void;
+    hostUpdate(): void;
+    /**
+     * Clear the auto-loaded flag (when devices are set externally)
+     */
+    clearAutoLoadedFlag(): void;
+}
+export {};

package/dist/controllers/devices-controller.js

@@ -0,0 +1,99 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _DevicesController_instances, _DevicesController_autoLoadedDevices, _DevicesController_loadingDevices, _DevicesController_deviceChangeHandler, _DevicesController_initialized, _DevicesController_setupDeviceChangeListener, _DevicesController_removeDeviceChangeListener, _DevicesController_loadDevices;
+import { getAudioDevices } from "../utils/devices.js";
+import { errorEvent, readyEvent, recordingDevicesChangedEvent, } from "../utils/events.js";
+/**
+ * Controller that manages automatic device loading.
+ * Loads devices when they're not present and handles device changes.
+ * Reacts to updates and automatically loads devices when needed.
+ */
+export class DevicesController {
+    constructor(host) {
+        _DevicesController_instances.add(this);
+        _DevicesController_autoLoadedDevices.set(this, false);
+        _DevicesController_loadingDevices.set(this, false);
+        _DevicesController_deviceChangeHandler.set(this, void 0);
+        _DevicesController_initialized.set(this, false);
+        this.host = host;
+        host.addController(this);
+    }
+    initialize() {
+        __classPrivateFieldSet(this, _DevicesController_initialized, true, "f");
+        if (this.host.devices === undefined) {
+            __classPrivateFieldGet(this, _DevicesController_instances, "m", _DevicesController_loadDevices).call(this);
+            __classPrivateFieldGet(this, _DevicesController_instances, "m", _DevicesController_setupDeviceChangeListener).call(this);
+        }
+    }
+    hostDisconnected() {
+        __classPrivateFieldGet(this, _DevicesController_instances, "m", _DevicesController_removeDeviceChangeListener).call(this);
+    }
+    hostUpdate() {
+        // Only react to updates after initialization
+        if (!__classPrivateFieldGet(this, _DevicesController_initialized, "f")) {
+            return;
+        }
+        // When devices are accessed but not present, load them
+        if (this.host.devices === undefined) {
+            __classPrivateFieldGet(this, _DevicesController_instances, "m", _DevicesController_loadDevices).call(this);
+        }
+    }
+    /**
+     * Clear the auto-loaded flag (when devices are set externally)
+     */
+    clearAutoLoadedFlag() {
+        __classPrivateFieldSet(this, _DevicesController_autoLoadedDevices, false, "f");
+    }
+}
+_DevicesController_autoLoadedDevices = new WeakMap(), _DevicesController_loadingDevices = new WeakMap(), _DevicesController_deviceChangeHandler = new WeakMap(), _DevicesController_initialized = new WeakMap(), _DevicesController_instances = new WeakSet(), _DevicesController_setupDeviceChangeListener = function _DevicesController_setupDeviceChangeListener() {
+    if (__classPrivateFieldGet(this, _DevicesController_deviceChangeHandler, "f")) {
+        return;
+    }
+    __classPrivateFieldSet(this, _DevicesController_deviceChangeHandler, () => {
+        if (__classPrivateFieldGet(this, _DevicesController_autoLoadedDevices, "f")) {
+            __classPrivateFieldGet(this, _DevicesController_instances, "m", _DevicesController_loadDevices).call(this);
+        }
+    }, "f");
+    navigator.mediaDevices.addEventListener("devicechange", __classPrivateFieldGet(this, _DevicesController_deviceChangeHandler, "f"));
+}, _DevicesController_removeDeviceChangeListener = function _DevicesController_removeDeviceChangeListener() {
+    if (!__classPrivateFieldGet(this, _DevicesController_deviceChangeHandler, "f")) {
+        return;
+    }
+    navigator.mediaDevices.removeEventListener("devicechange", __classPrivateFieldGet(this, _DevicesController_deviceChangeHandler, "f"));
+    __classPrivateFieldSet(this, _DevicesController_deviceChangeHandler, undefined, "f");
+}, _DevicesController_loadDevices = async function _DevicesController_loadDevices() {
+    if (__classPrivateFieldGet(this, _DevicesController_loadingDevices, "f")) {
+        return;
+    }
+    __classPrivateFieldSet(this, _DevicesController_loadingDevices, true, "f");
+    try {
+        const { devices, defaultDevice } = await getAudioDevices();
+        __classPrivateFieldSet(this, _DevicesController_autoLoadedDevices, true, "f");
+        this.host._devices = devices;
+        // Use selected device if it still exists, otherwise fall back to default
+        const previousDevice = this.host.selectedDevice;
+        const selectedDevice = (previousDevice &&
+            devices.find((d) => d.deviceId === previousDevice.deviceId)) ??
+            defaultDevice;
+        this.host.selectedDevice = selectedDevice;
+        this.host.requestUpdate();
+        this.host.dispatchEvent(recordingDevicesChangedEvent(devices, selectedDevice));
+        this.host.dispatchEvent(readyEvent());
+    }
+    catch (error) {
+        this.host.dispatchEvent(errorEvent(error));
+    }
+    finally {
+        __classPrivateFieldSet(this, _DevicesController_loadingDevices, false, "f");
+    }
+};
+//# sourceMappingURL=devices-controller.js.map

package/dist/controllers/devices-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices-controller.js","sourceRoot":"","sources":["../../src/controllers/devices-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from \"lit\";\nimport { getAudioDevices } from \"../utils/devices.js\";\nimport {\n  errorEvent,\n  readyEvent,\n  recordingDevicesChangedEvent,\n} from \"../utils/events.js\";\n\ninterface DevicesControllerHost extends ReactiveControllerHost {\n  devices?: MediaDeviceInfo[];\n  selectedDevice?: MediaDeviceInfo;\n  dispatchEvent(event: CustomEvent): boolean;\n  requestUpdate(): void;\n  _devices?: MediaDeviceInfo[];\n}\n\n/**\n * Controller that manages automatic device loading.\n * Loads devices when they're not present and handles device changes.\n * Reacts to updates and automatically loads devices when needed.\n */\nexport class DevicesController implements ReactiveController {\n  host: DevicesControllerHost;\n  #autoLoadedDevices: boolean = false;\n  #loadingDevices: boolean = false;\n  #deviceChangeHandler?: () => void;\n  #initialized: boolean = false;\n\n  constructor(host: DevicesControllerHost) {\n    this.host = host;\n    host.addController(this);\n  }\n\n  initialize(): void {\n    this.#initialized = true;\n    if (this.host.devices === undefined) {\n      this.#loadDevices();\n      this.#setupDeviceChangeListener();\n    }\n  }\n\n  hostDisconnected(): void {\n    this.#removeDeviceChangeListener();\n  }\n\n  hostUpdate(): void {\n    // Only react to updates after initialization\n    if (!this.#initialized) {\n      return;\n    }\n\n    // When devices are accessed but not present, load them\n    if (this.host.devices === undefined) {\n      this.#loadDevices();\n    }\n  }\n\n  #setupDeviceChangeListener(): void {\n    if (this.#deviceChangeHandler) {\n      return;\n    }\n\n    this.#deviceChangeHandler = () => {\n      if (this.#autoLoadedDevices) {\n        this.#loadDevices();\n      }\n    };\n\n    navigator.mediaDevices.addEventListener(\n      \"devicechange\",\n      this.#deviceChangeHandler,\n    );\n  }\n\n  #removeDeviceChangeListener(): void {\n    if (!this.#deviceChangeHandler) {\n      return;\n    }\n\n    navigator.mediaDevices.removeEventListener(\n      \"devicechange\",\n      this.#deviceChangeHandler,\n    );\n    this.#deviceChangeHandler = undefined;\n  }\n\n  async #loadDevices(): Promise<void> {\n    if (this.#loadingDevices) {\n      return;\n    }\n\n    this.#loadingDevices = true;\n\n    try {\n      const { devices, defaultDevice } = await getAudioDevices();\n\n      this.#autoLoadedDevices = true;\n      this.host._devices = devices;\n\n      // Use selected device if it still exists, otherwise fall back to default\n      const previousDevice = this.host.selectedDevice;\n      const selectedDevice =\n        (previousDevice &&\n          devices.find((d) => d.deviceId === previousDevice.deviceId)) ??\n        defaultDevice;\n\n      this.host.selectedDevice = selectedDevice;\n\n      this.host.requestUpdate();\n      this.host.dispatchEvent(\n        recordingDevicesChangedEvent(devices, selectedDevice),\n      );\n      this.host.dispatchEvent(readyEvent());\n    } catch (error) {\n      this.host.dispatchEvent(errorEvent(error));\n    } finally {\n      this.#loadingDevices = false;\n    }\n  }\n\n  /**\n   * Clear the auto-loaded flag (when devices are set externally)\n   */\n  clearAutoLoadedFlag(): void {\n    this.#autoLoadedDevices = false;\n  }\n}\n"]}

package/dist/controllers/dictation-controller.d.ts

@@ -0,0 +1,28 @@
+import { type Corti } from "@corti/sdk";
+import type { ReactiveController, ReactiveControllerHost } from "lit";
+import type { ProxyOptions } from "../types.js";
+interface DictationControllerHost extends ReactiveControllerHost {
+    _accessToken?: string;
+    _authConfig?: Corti.BearerOptions;
+    _region?: string;
+    _tenantName?: string;
+    _socketUrl?: string;
+    _socketProxy?: ProxyOptions;
+}
+export type TranscribeMessage = Corti.TranscribeConfigStatusMessage | Corti.TranscribeUsageMessage | Corti.TranscribeEndedMessage | Corti.TranscribeErrorMessage | Corti.TranscribeTranscriptMessage | Corti.TranscribeCommandMessage | Corti.TranscribeFlushedMessage;
+interface WebSocketCallbacks {
+    onMessage?: (message: TranscribeMessage) => void;
+    onError?: (error: Error) => void;
+    onClose?: (event: unknown) => void;
+    onNetworkActivity?: (direction: "sent" | "received", data: unknown) => void;
+}
+export declare class DictationController implements ReactiveController {
+    #private;
+    host: DictationControllerHost;
+    constructor(host: DictationControllerHost);
+    hostDisconnected(): void;
+    connect(mediaRecorder: MediaRecorder | null, dictationConfig?: Corti.TranscribeConfig, callbacks?: WebSocketCallbacks): Promise<void>;
+    disconnect(onClose?: (event: unknown) => void): Promise<void>;
+    cleanup(): void;
+}
+export {};

package/dist/controllers/dictation-controller.js

@@ -0,0 +1,141 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _DictationController_instances, _DictationController_cortiClient, _DictationController_webSocket, _DictationController_closeTimeout, _DictationController_onNetworkActivity, _DictationController_connectProxy, _DictationController_connectAuth, _DictationController_setupWebSocketHandlers, _DictationController_setupMediaRecorder;
+import { CortiClient, CortiWebSocketProxyClient } from "@corti/sdk";
+import { DEFAULT_DICTATION_CONFIG } from "../constants.js";
+export class DictationController {
+    constructor(host) {
+        _DictationController_instances.add(this);
+        _DictationController_cortiClient.set(this, null);
+        _DictationController_webSocket.set(this, null);
+        _DictationController_closeTimeout.set(this, void 0);
+        _DictationController_onNetworkActivity.set(this, void 0);
+        this.host = host;
+        host.addController(this);
+    }
+    hostDisconnected() {
+        this.cleanup();
+    }
+    async connect(mediaRecorder, dictationConfig = DEFAULT_DICTATION_CONFIG, callbacks = {}) {
+        if (!mediaRecorder) {
+            throw new Error("MediaRecorder is required to connect");
+        }
+        if (__classPrivateFieldGet(this, _DictationController_webSocket, "f")?.readyState === WebSocket.OPEN) {
+            throw new Error("Already connected. Disconnect before reconnecting.");
+        }
+        __classPrivateFieldSet(this, _DictationController_webSocket, this.host._socketUrl || this.host._socketProxy
+            ? await __classPrivateFieldGet(this, _DictationController_instances, "m", _DictationController_connectProxy).call(this, dictationConfig)
+            : await __classPrivateFieldGet(this, _DictationController_instances, "m", _DictationController_connectAuth).call(this, dictationConfig), "f");
+        __classPrivateFieldSet(this, _DictationController_onNetworkActivity, callbacks.onNetworkActivity, "f");
+        __classPrivateFieldGet(this, _DictationController_instances, "m", _DictationController_setupMediaRecorder).call(this, mediaRecorder);
+        __classPrivateFieldGet(this, _DictationController_instances, "m", _DictationController_setupWebSocketHandlers).call(this, callbacks);
+    }
+    async disconnect(onClose) {
+        await new Promise((resolve, reject) => {
+            if (!__classPrivateFieldGet(this, _DictationController_webSocket, "f") || __classPrivateFieldGet(this, _DictationController_webSocket, "f").readyState !== WebSocket.OPEN) {
+                resolve();
+                return;
+            }
+            __classPrivateFieldGet(this, _DictationController_webSocket, "f").on("close", (event) => {
+                if (__classPrivateFieldGet(this, _DictationController_closeTimeout, "f")) {
+                    clearTimeout(__classPrivateFieldGet(this, _DictationController_closeTimeout, "f"));
+                    __classPrivateFieldSet(this, _DictationController_closeTimeout, undefined, "f");
+                }
+                if (onClose) {
+                    onClose(event);
+                }
+                resolve();
+            });
+            __classPrivateFieldGet(this, _DictationController_webSocket, "f").sendEnd({ type: "end" });
+            __classPrivateFieldGet(this, _DictationController_onNetworkActivity, "f")?.call(this, "sent", { type: "end" });
+            __classPrivateFieldSet(this, _DictationController_closeTimeout, window.setTimeout(() => {
+                // Reject the promise before closing the web socket, so the promise rejects before close event fires
+                reject(new Error("WebSocket close timeout"));
+                if (__classPrivateFieldGet(this, _DictationController_webSocket, "f")?.readyState === WebSocket.OPEN) {
+                    __classPrivateFieldGet(this, _DictationController_webSocket, "f").close();
+                }
+            }, 10000), "f");
+        });
+        this.cleanup();
+    }
+    cleanup() {
+        if (__classPrivateFieldGet(this, _DictationController_closeTimeout, "f")) {
+            clearTimeout(__classPrivateFieldGet(this, _DictationController_closeTimeout, "f"));
+            __classPrivateFieldSet(this, _DictationController_closeTimeout, undefined, "f");
+        }
+        if (__classPrivateFieldGet(this, _DictationController_webSocket, "f")?.readyState === WebSocket.OPEN) {
+            __classPrivateFieldGet(this, _DictationController_webSocket, "f").close();
+        }
+        __classPrivateFieldSet(this, _DictationController_webSocket, null, "f");
+        __classPrivateFieldSet(this, _DictationController_cortiClient, null, "f");
+    }
+}
+_DictationController_cortiClient = new WeakMap(), _DictationController_webSocket = new WeakMap(), _DictationController_closeTimeout = new WeakMap(), _DictationController_onNetworkActivity = new WeakMap(), _DictationController_instances = new WeakSet(), _DictationController_connectProxy = async function _DictationController_connectProxy(dictationConfig) {
+    const proxyOptions = this.host._socketProxy || {
+        url: this.host._socketUrl || "",
+    };
+    if (!proxyOptions.url) {
+        throw new Error("Proxy URL is required when using proxy client");
+    }
+    return await CortiWebSocketProxyClient.transcribe.connect({
+        configuration: dictationConfig,
+        proxy: proxyOptions,
+    });
+}, _DictationController_connectAuth = async function _DictationController_connectAuth(dictationConfig) {
+    if (!this.host._authConfig && !this.host._accessToken) {
+        throw new Error("Auth configuration or access token is required to connect");
+    }
+    // Use authConfig if available, otherwise create one from accessToken
+    const auth = this.host._authConfig || {
+        accessToken: this.host._accessToken || "",
+        refreshAccessToken: () => ({
+            accessToken: this.host._accessToken || "",
+        }),
+    };
+    __classPrivateFieldSet(this, _DictationController_cortiClient, new CortiClient({
+        auth,
+        environment: this.host._region,
+        tenantName: this.host._tenantName,
+    }), "f");
+    return await __classPrivateFieldGet(this, _DictationController_cortiClient, "f").transcribe.connect({
+        configuration: dictationConfig,
+    });
+}, _DictationController_setupWebSocketHandlers = function _DictationController_setupWebSocketHandlers(callbacks) {
+    if (!__classPrivateFieldGet(this, _DictationController_webSocket, "f")) {
+        throw new Error("WebSocket not initialized");
+    }
+    __classPrivateFieldGet(this, _DictationController_webSocket, "f").on("message", (message) => {
+        __classPrivateFieldGet(this, _DictationController_onNetworkActivity, "f")?.call(this, "received", message);
+        if (callbacks.onMessage) {
+            callbacks.onMessage(message);
+        }
+    });
+    __classPrivateFieldGet(this, _DictationController_webSocket, "f").on("error", (event) => {
+        if (callbacks.onError) {
+            callbacks.onError(event);
+        }
+    });
+    __classPrivateFieldGet(this, _DictationController_webSocket, "f").on("close", (event) => {
+        if (callbacks.onClose) {
+            callbacks.onClose(event);
+        }
+    });
+}, _DictationController_setupMediaRecorder = function _DictationController_setupMediaRecorder(mediaRecorder) {
+    mediaRecorder.ondataavailable = (event) => {
+        __classPrivateFieldGet(this, _DictationController_webSocket, "f")?.sendAudio(event.data);
+        __classPrivateFieldGet(this, _DictationController_onNetworkActivity, "f")?.call(this, "sent", {
+            size: event.data.size,
+            type: "audio",
+        });
+    };
+};
+//# sourceMappingURL=dictation-controller.js.map

package/dist/controllers/dictation-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictation-controller.js","sourceRoot":"","sources":["../../src/controllers/dictation-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Corti, CortiClient, CortiWebSocketProxyClient } from \"@corti/sdk\";\nimport type { ReactiveController, ReactiveControllerHost } from \"lit\";\nimport { DEFAULT_DICTATION_CONFIG } from \"../constants.js\";\nimport type { ProxyOptions } from \"../types.js\";\n\ntype TranscribeSocket = Awaited<\n  ReturnType<CortiClient[\"transcribe\"][\"connect\"]>\n>;\n\ninterface DictationControllerHost extends ReactiveControllerHost {\n  _accessToken?: string;\n  _authConfig?: Corti.BearerOptions;\n  _region?: string;\n  _tenantName?: string;\n  _socketUrl?: string;\n  _socketProxy?: ProxyOptions;\n}\n\nexport type TranscribeMessage =\n  | Corti.TranscribeConfigStatusMessage\n  | Corti.TranscribeUsageMessage\n  | Corti.TranscribeEndedMessage\n  | Corti.TranscribeErrorMessage\n  | Corti.TranscribeTranscriptMessage\n  | Corti.TranscribeCommandMessage\n  | Corti.TranscribeFlushedMessage;\n\ninterface WebSocketCallbacks {\n  onMessage?: (message: TranscribeMessage) => void;\n  onError?: (error: Error) => void;\n  onClose?: (event: unknown) => void;\n  onNetworkActivity?: (direction: \"sent\" | \"received\", data: unknown) => void;\n}\n\nexport class DictationController implements ReactiveController {\n  host: DictationControllerHost;\n\n  #cortiClient: CortiClient | null = null;\n  #webSocket: TranscribeSocket | null = null;\n  #closeTimeout?: number;\n  #onNetworkActivity?: WebSocketCallbacks[\"onNetworkActivity\"];\n\n  constructor(host: DictationControllerHost) {\n    this.host = host;\n    host.addController(this);\n  }\n\n  hostDisconnected(): void {\n    this.cleanup();\n  }\n\n  async connect(\n    mediaRecorder: MediaRecorder | null,\n    dictationConfig: Corti.TranscribeConfig = DEFAULT_DICTATION_CONFIG,\n    callbacks: WebSocketCallbacks = {},\n  ): Promise<void> {\n    if (!mediaRecorder) {\n      throw new Error(\"MediaRecorder is required to connect\");\n    }\n\n    if (this.#webSocket?.readyState === WebSocket.OPEN) {\n      throw new Error(\"Already connected. Disconnect before reconnecting.\");\n    }\n\n    this.#webSocket =\n      this.host._socketUrl || this.host._socketProxy\n        ? await this.#connectProxy(dictationConfig)\n        : await this.#connectAuth(dictationConfig);\n\n    this.#onNetworkActivity = callbacks.onNetworkActivity;\n    this.#setupMediaRecorder(mediaRecorder);\n    this.#setupWebSocketHandlers(callbacks);\n  }\n\n  async #connectProxy(\n    dictationConfig: Corti.TranscribeConfig,\n  ): Promise<TranscribeSocket> {\n    const proxyOptions = this.host._socketProxy || {\n      url: this.host._socketUrl || \"\",\n    };\n\n    if (!proxyOptions.url) {\n      throw new Error(\"Proxy URL is required when using proxy client\");\n    }\n\n    return await CortiWebSocketProxyClient.transcribe.connect({\n      configuration: dictationConfig,\n      proxy: proxyOptions,\n    });\n  }\n\n  async #connectAuth(\n    dictationConfig: Corti.TranscribeConfig,\n  ): Promise<TranscribeSocket> {\n    if (!this.host._authConfig && !this.host._accessToken) {\n      throw new Error(\n        \"Auth configuration or access token is required to connect\",\n      );\n    }\n\n    // Use authConfig if available, otherwise create one from accessToken\n    const auth: Corti.BearerOptions = this.host._authConfig || {\n      accessToken: this.host._accessToken || \"\",\n      refreshAccessToken: () => ({\n        accessToken: this.host._accessToken || \"\",\n      }),\n    };\n\n    this.#cortiClient = new CortiClient({\n      auth,\n      environment: this.host._region,\n      tenantName: this.host._tenantName,\n    });\n\n    return await this.#cortiClient.transcribe.connect({\n      configuration: dictationConfig,\n    });\n  }\n\n  #setupWebSocketHandlers(callbacks: WebSocketCallbacks): void {\n    if (!this.#webSocket) {\n      throw new Error(\"WebSocket not initialized\");\n    }\n\n    this.#webSocket.on(\"message\", (message: TranscribeMessage) => {\n      this.#onNetworkActivity?.(\"received\", message);\n\n      if (callbacks.onMessage) {\n        callbacks.onMessage(message);\n      }\n    });\n\n    this.#webSocket.on(\"error\", (event: Error) => {\n      if (callbacks.onError) {\n        callbacks.onError(event);\n      }\n    });\n\n    this.#webSocket.on(\"close\", (event: unknown) => {\n      if (callbacks.onClose) {\n        callbacks.onClose(event);\n      }\n    });\n  }\n\n  #setupMediaRecorder(mediaRecorder: MediaRecorder): void {\n    mediaRecorder.ondataavailable = (event) => {\n      this.#webSocket?.sendAudio(event.data);\n      this.#onNetworkActivity?.(\"sent\", {\n        size: event.data.size,\n        type: \"audio\",\n      });\n    };\n  }\n\n  async disconnect(onClose?: (event: unknown) => void): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      if (!this.#webSocket || this.#webSocket.readyState !== WebSocket.OPEN) {\n        resolve();\n        return;\n      }\n\n      this.#webSocket.on(\"close\", (event) => {\n        if (this.#closeTimeout) {\n          clearTimeout(this.#closeTimeout);\n          this.#closeTimeout = undefined;\n        }\n\n        if (onClose) {\n          onClose(event);\n        }\n\n        resolve();\n      });\n\n      this.#webSocket.sendEnd({ type: \"end\" });\n      this.#onNetworkActivity?.(\"sent\", { type: \"end\" });\n\n      this.#closeTimeout = window.setTimeout(() => {\n        // Reject the promise before closing the web socket, so the promise rejects before close event fires\n        reject(new Error(\"WebSocket close timeout\"));\n\n        if (this.#webSocket?.readyState === WebSocket.OPEN) {\n          this.#webSocket.close();\n        }\n      }, 10000);\n    });\n\n    this.cleanup();\n  }\n\n  cleanup(): void {\n    if (this.#closeTimeout) {\n      clearTimeout(this.#closeTimeout);\n      this.#closeTimeout = undefined;\n    }\n\n    if (this.#webSocket?.readyState === WebSocket.OPEN) {\n      this.#webSocket.close();\n    }\n\n    this.#webSocket = null;\n    this.#cortiClient = null;\n  }\n}\n"]}