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

package/dist/src/contexts/dictation-context.js

@@ -0,0 +1,208 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { createContext, provide } from "@lit/context";
+import { html, LitElement } from "lit";
+import { customElement, property, state } from "lit/decorators.js";
+import ComponentStyles from "../styles/ComponentStyles.js";
+import { getInitialToken } from "../utils/auth.js";
+import { commaSeparatedConverter } from "../utils/converters.js";
+import { errorEvent } from "../utils/events.js";
+import { decodeToken } from "../utils/token.js";
+export const regionContext = createContext(Symbol("region"));
+export const tenantNameContext = createContext(Symbol("tenantName"));
+export const languagesContext = createContext(Symbol("languages"));
+export const devicesContext = createContext(Symbol("devices"));
+export const selectedDeviceContext = createContext(Symbol("selectedDevice"));
+export const recordingStateContext = createContext(Symbol("recordingState"));
+export const accessTokenContext = createContext(Symbol("accessToken"));
+export const dictationConfigContext = createContext(Symbol("dictationConfig"));
+export const authConfigContext = createContext(Symbol("authConfig"));
+export const socketUrlContext = createContext(Symbol("socketUrl"));
+export const socketProxyContext = createContext(Symbol("socketProxy"));
+export const debugDisplayAudioContext = createContext(Symbol("debugDisplayAudio"));
+let DictationContext = class DictationContext extends LitElement {
+    set accessToken(token) {
+        this.setAccessToken(token);
+    }
+    get accessToken() {
+        return this._accessToken;
+    }
+    set authConfig(config) {
+        this.setAuthConfig(config);
+    }
+    get authConfig() {
+        return this._authConfig;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Lifecycle
+    // ─────────────────────────────────────────────────────────────────────────────
+    constructor() {
+        super();
+        this.recordingState = "stopped";
+        this.noWrapper = false;
+        // ─────────────────────────────────────────────────────────────────────────────
+        // Private event handlers
+        // ─────────────────────────────────────────────────────────────────────────────
+        this._handleLanguageChanged = (e) => {
+            const event = e;
+            this.languages = event.detail.languages;
+            this.dictationConfig = {
+                ...this.dictationConfig,
+                primaryLanguage: event.detail.selectedLanguage,
+            };
+        };
+        this._handleDeviceChanged = (e) => {
+            const event = e;
+            this.devices = event.detail.devices;
+            this.selectedDevice = event.detail.selectedDevice;
+        };
+        this._handleRecordingStateChanged = (e) => {
+            const event = e;
+            this.recordingState = event.detail.state;
+        };
+        this.addEventListener("languages-changed", this._handleLanguageChanged);
+        this.addEventListener("recording-devices-changed", this._handleDeviceChanged);
+        this.addEventListener("recording-state-changed", this._handleRecordingStateChanged);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Public methods
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Sets the access token and parses region/tenant from it.
+     * @returns ServerConfig with environment, tenant, and accessToken
+     * @deprecated Use 'accessToken' property instead.
+     */
+    setAccessToken(token) {
+        this._accessToken = token;
+        this.region = undefined;
+        this.tenantName = undefined;
+        if (!token) {
+            return { accessToken: token, environment: undefined, tenant: undefined };
+        }
+        try {
+            const decoded = decodeToken(token);
+            this.region = decoded?.environment;
+            this.tenantName = decoded?.tenant;
+            return {
+                accessToken: token,
+                environment: decoded?.environment,
+                tenant: decoded?.tenant,
+            };
+        }
+        catch (error) {
+            this.dispatchEvent(errorEvent(error));
+        }
+        return { accessToken: token, environment: undefined, tenant: undefined };
+    }
+    /**
+     * Sets the auth config and parses region/tenant from the initial token.
+     * @returns Promise with ServerConfig containing environment, tenant, and accessToken
+     * @deprecated Use 'authConfig' property instead.
+     */
+    async setAuthConfig(config) {
+        this._authConfig = config;
+        if (!config) {
+            return {
+                accessToken: undefined,
+                environment: undefined,
+                tenant: undefined,
+            };
+        }
+        try {
+            const { accessToken } = await getInitialToken(config);
+            return this.setAccessToken(accessToken);
+        }
+        catch (error) {
+            this.dispatchEvent(errorEvent(error));
+        }
+        return {
+            accessToken: undefined,
+            environment: undefined,
+            tenant: undefined,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Render
+    // ─────────────────────────────────────────────────────────────────────────────
+    render() {
+        if (this.noWrapper) {
+            return html `<slot></slot>`;
+        }
+        return html `<div class="wrapper">
+      <slot></slot>
+    </div>`;
+    }
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Static
+// ─────────────────────────────────────────────────────────────────────────────
+DictationContext.styles = [ComponentStyles];
+__decorate([
+    provide({ context: regionContext }),
+    state()
+], DictationContext.prototype, "region", void 0);
+__decorate([
+    provide({ context: tenantNameContext }),
+    state()
+], DictationContext.prototype, "tenantName", void 0);
+__decorate([
+    provide({ context: recordingStateContext }),
+    state()
+], DictationContext.prototype, "recordingState", void 0);
+__decorate([
+    provide({ context: accessTokenContext }),
+    state()
+], DictationContext.prototype, "_accessToken", void 0);
+__decorate([
+    property({ type: String })
+], DictationContext.prototype, "accessToken", null);
+__decorate([
+    provide({ context: authConfigContext }),
+    state()
+], DictationContext.prototype, "_authConfig", void 0);
+__decorate([
+    property({ attribute: false, type: Object })
+], DictationContext.prototype, "authConfig", null);
+__decorate([
+    provide({ context: socketUrlContext }),
+    property({ type: String })
+], DictationContext.prototype, "socketUrl", void 0);
+__decorate([
+    provide({ context: socketProxyContext }),
+    property({ attribute: false, type: Object })
+], DictationContext.prototype, "socketProxy", void 0);
+__decorate([
+    provide({ context: dictationConfigContext }),
+    property({ attribute: false, type: Object })
+], DictationContext.prototype, "dictationConfig", void 0);
+__decorate([
+    provide({ context: languagesContext }),
+    property({
+        converter: commaSeparatedConverter,
+        type: Array,
+    })
+], DictationContext.prototype, "languages", void 0);
+__decorate([
+    provide({ context: devicesContext }),
+    property({ attribute: false, type: Array })
+], DictationContext.prototype, "devices", void 0);
+__decorate([
+    provide({ context: selectedDeviceContext }),
+    property({ attribute: false, type: Object })
+], DictationContext.prototype, "selectedDevice", void 0);
+__decorate([
+    provide({ context: debugDisplayAudioContext }),
+    property({ attribute: "debug-display-audio", type: Boolean })
+], DictationContext.prototype, "debug_displayAudio", void 0);
+__decorate([
+    property({ type: Boolean })
+], DictationContext.prototype, "noWrapper", void 0);
+DictationContext = __decorate([
+    customElement("dictation-context-provider")
+], DictationContext);
+export { DictationContext };
+//# sourceMappingURL=dictation-context.js.map

package/dist/src/contexts/dictation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictation-context.js","sourceRoot":"","sources":["../../../src/contexts/dictation-context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Corti } from \"@corti/sdk\";\nimport { createContext, provide } from \"@lit/context\";\nimport { type CSSResultGroup, html, LitElement } from \"lit\";\nimport { customElement, property, state } from \"lit/decorators.js\";\nimport ComponentStyles from \"../styles/ComponentStyles.js\";\nimport type { ProxyOptions, RecordingState } from \"../types.js\";\nimport { getInitialToken } from \"../utils/auth.js\";\nimport { commaSeparatedConverter } from \"../utils/converters.js\";\nimport { errorEvent } from \"../utils/events.js\";\nimport { decodeToken } from \"../utils/token.js\";\n\nexport const regionContext = createContext<string | undefined>(Symbol(\"region\"));\nexport const tenantNameContext = createContext<string | undefined>(\n  Symbol(\"tenantName\"),\n);\nexport const languagesContext = createContext<string[] | undefined>(\n  Symbol(\"languages\"),\n);\nexport const devicesContext = createContext<MediaDeviceInfo[] | undefined>(\n  Symbol(\"devices\"),\n);\nexport const selectedDeviceContext = createContext<MediaDeviceInfo | undefined>(\n  Symbol(\"selectedDevice\"),\n);\nexport const recordingStateContext =\n  createContext<RecordingState>(Symbol(\"recordingState\"));\nexport const accessTokenContext = createContext<string | undefined>(\n  Symbol(\"accessToken\"),\n);\nexport const dictationConfigContext = createContext<\n  Corti.TranscribeConfig | undefined\n>(Symbol(\"dictationConfig\"));\nexport const authConfigContext = createContext<Corti.BearerOptions | undefined>(\n  Symbol(\"authConfig\"),\n);\nexport const socketUrlContext = createContext<string | undefined>(Symbol(\"socketUrl\"));\nexport const socketProxyContext = createContext<ProxyOptions | undefined>(\n  Symbol(\"socketProxy\"),\n);\nexport const debugDisplayAudioContext = createContext<boolean | undefined>(\n  Symbol(\"debugDisplayAudio\"),\n);\n\n@customElement(\"dictation-context-provider\")\nexport class DictationContext extends LitElement {\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Context state\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  @provide({ context: regionContext })\n  @state()\n  region?: string;\n\n  @provide({ context: tenantNameContext })\n  @state()\n  tenantName?: string;\n\n  @provide({ context: recordingStateContext })\n  @state()\n  recordingState: RecordingState = \"stopped\";\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Properties\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  @provide({ context: accessTokenContext })\n  @state()\n  private _accessToken?: string;\n\n  @property({ type: String })\n  set accessToken(token: string | undefined) {\n    this.setAccessToken(token);\n  }\n\n  get accessToken(): string | undefined {\n    return this._accessToken;\n  }\n\n  @provide({ context: authConfigContext })\n  @state()\n  private _authConfig?: Corti.BearerOptions;\n\n  @property({ attribute: false, type: Object })\n  set authConfig(config: Corti.BearerOptions | undefined) {\n    this.setAuthConfig(config);\n  }\n\n  get authConfig(): Corti.BearerOptions | undefined {\n    return this._authConfig;\n  }\n\n  @provide({ context: socketUrlContext })\n  @property({ type: String })\n  socketUrl?: string;\n\n  @provide({ context: socketProxyContext })\n  @property({ attribute: false, type: Object })\n  socketProxy?: ProxyOptions;\n\n  @provide({ context: dictationConfigContext })\n  @property({ attribute: false, type: Object })\n  dictationConfig?: Corti.TranscribeConfig;\n\n  @provide({ context: languagesContext })\n  @property({\n    converter: commaSeparatedConverter,\n    type: Array,\n  })\n  languages?: string[];\n\n  @provide({ context: devicesContext })\n  @property({ attribute: false, type: Array })\n  devices?: MediaDeviceInfo[];\n\n  @provide({ context: selectedDeviceContext })\n  @property({ attribute: false, type: Object })\n  selectedDevice?: MediaDeviceInfo;\n\n  @provide({ context: debugDisplayAudioContext })\n  @property({ attribute: \"debug-display-audio\", type: Boolean })\n  debug_displayAudio?: boolean;\n\n  @property({ type: Boolean })\n  noWrapper: boolean = false;\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Static\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  static styles: CSSResultGroup = [ComponentStyles];\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Lifecycle\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  constructor() {\n    super();\n    this.addEventListener(\"languages-changed\", this._handleLanguageChanged);\n    this.addEventListener(\n      \"recording-devices-changed\",\n      this._handleDeviceChanged,\n    );\n    this.addEventListener(\n      \"recording-state-changed\",\n      this._handleRecordingStateChanged,\n    );\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Public methods\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Sets the access token and parses region/tenant from it.\n   * @returns ServerConfig with environment, tenant, and accessToken\n   * @deprecated Use 'accessToken' property instead.\n   */\n  public setAccessToken(token: string | undefined) {\n    this._accessToken = token;\n    this.region = undefined;\n    this.tenantName = undefined;\n\n    if (!token) {\n      return { accessToken: token, environment: undefined, tenant: undefined };\n    }\n\n    try {\n      const decoded = decodeToken(token);\n\n      this.region = decoded?.environment;\n      this.tenantName = decoded?.tenant;\n\n      return {\n        accessToken: token,\n        environment: decoded?.environment,\n        tenant: decoded?.tenant,\n      };\n    } catch (error) {\n      this.dispatchEvent(errorEvent(error));\n    }\n\n    return { accessToken: token, environment: undefined, tenant: undefined };\n  }\n\n  /**\n   * Sets the auth config and parses region/tenant from the initial token.\n   * @returns Promise with ServerConfig containing environment, tenant, and accessToken\n   * @deprecated Use 'authConfig' property instead.\n   */\n  public async setAuthConfig(config?: Corti.BearerOptions) {\n    this._authConfig = config;\n\n    if (!config) {\n      return {\n        accessToken: undefined,\n        environment: undefined,\n        tenant: undefined,\n      };\n    }\n\n    try {\n      const { accessToken } = await getInitialToken(config);\n\n      return this.setAccessToken(accessToken);\n    } catch (error) {\n      this.dispatchEvent(errorEvent(error));\n    }\n\n    return {\n      accessToken: undefined,\n      environment: undefined,\n      tenant: undefined,\n    };\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Private event handlers\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  private _handleLanguageChanged = (e: Event) => {\n    const event = e as CustomEvent;\n\n    this.languages = event.detail.languages;\n    this.dictationConfig = {\n      ...this.dictationConfig,\n      primaryLanguage: event.detail.selectedLanguage,\n    };\n  };\n\n  private _handleDeviceChanged = (e: Event) => {\n    const event = e as CustomEvent;\n\n    this.devices = event.detail.devices;\n    this.selectedDevice = event.detail.selectedDevice;\n  };\n\n  private _handleRecordingStateChanged = (e: Event) => {\n    const event = e as CustomEvent;\n\n    this.recordingState = event.detail.state;\n  };\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Render\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  render() {\n    if (this.noWrapper) {\n      return html`<slot></slot>`;\n    }\n\n    return html`<div class=\"wrapper\">\n      <slot></slot>\n    </div>`;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"dictation-context-provider\": DictationContext;\n  }\n}\n"]}

package/dist/src/controllers/DictationController.d.ts

@@ -0,0 +1,35 @@
+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 {
+    host: DictationControllerHost;
+    private _cortiClient;
+    private _webSocket;
+    private _closeTimeout?;
+    private _onNetworkActivity?;
+    constructor(host: DictationControllerHost);
+    hostDisconnected(): void;
+    connect(mediaRecorder: MediaRecorder | null, dictationConfig?: Corti.TranscribeConfig, callbacks?: WebSocketCallbacks): Promise<void>;
+    private connectProxy;
+    private connectAuth;
+    private setupWebSocketHandlers;
+    private setupMediaRecorder;
+    disconnect(onClose?: (event: unknown) => void): Promise<void>;
+    cleanup(): void;
+}
+export {};

package/dist/src/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/src/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/src/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/src/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/src/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/src/icons/icons.d.ts

@@ -0,0 +1,17 @@
+import { LitElement } from 'lit';
+export declare class IconMicOn extends LitElement {
+    render(): import("lit-html").TemplateResult<1>;
+}
+export declare class IconMicOff extends LitElement {
+    render(): import("lit-html").TemplateResult<1>;
+}
+export declare class IconRecording extends LitElement {
+    render(): import("lit-html").TemplateResult<1>;
+}
+export declare class IconSettings extends LitElement {
+    render(): import("lit-html").TemplateResult<1>;
+}
+export declare class IconLoadingSpinner extends LitElement {
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}