@corti/dictation-web 0.6.0 → 0.7.0-ambient

package/dist/types.d.ts

@@ -1,3 +1,6 @@
+import type { StreamAmbientMessage } from "./controllers/ambient-controller.js";
+import type { TranscribeMessage } from "./controllers/dictation-controller.js";
+export type RecordingSocketInboundMessage = TranscribeMessage | StreamAmbientMessage;
 export type RecordingState = "initializing" | "recording" | "stopping" | "stopped";
 export type Keybinding = string;
 export type ConfigurableSettings = "device" | "language" | "keybinding";

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type RecordingState =\n  | \"initializing\"\n  | \"recording\"\n  | \"stopping\"\n  | \"stopped\";\n\nexport type Keybinding = string;\n\nexport type ConfigurableSettings = \"device\" | \"language\" | \"keybinding\";\n\nexport type ProxyOptions = {\n  url: string;\n  protocols?: string[];\n  queryParameters?: Record<string, string>;\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { StreamAmbientMessage } from \"./controllers/ambient-controller.js\";\nimport type { TranscribeMessage } from \"./controllers/dictation-controller.js\";\n\nexport type RecordingSocketInboundMessage =\n  | TranscribeMessage\n  | StreamAmbientMessage;\n\nexport type RecordingState =\n  | \"initializing\"\n  | \"recording\"\n  | \"stopping\"\n  | \"stopped\";\n\nexport type Keybinding = string;\n\nexport type ConfigurableSettings = \"device\" | \"language\" | \"keybinding\";\n\nexport type ProxyOptions = {\n  url: string;\n  protocols?: string[];\n  queryParameters?: Record<string, string>;\n};\n"]}

package/dist/utils/devices.d.ts

@@ -1,19 +1,23 @@
 /**
- * Requests access to the microphone.
+ * Primes the document with an active microphone stream.
  *
- * This function checks if the microphone permission is in "prompt" state, then requests
- * access and stops any active tracks immediately.
+ * Opens (and immediately stops) a media stream so the document holds an
+ * active mic permission for this session. In Firefox this is what makes
+ * real deviceIds and labels appear in subsequent enumerateDevices() calls.
+ * Throws early if the user has already denied permission.
  *
- * @returns A promise that resolves when the permission request is complete.
+ * @returns A promise that resolves once the stream has been opened and stopped.
  * @throws Error if microphone access is denied or unavailable.
  */
-export declare function requestMicAccess(): Promise<void>;
+export declare function primeMicStream(): Promise<void>;
 /**
  * Retrieves available audio input devices.
  *
- * This function uses the mediaDevices API to enumerate devices and filters out those
- * which are audio inputs. In some browsers, you may need to request user media before
- * device labels are populated.
+ * Enumerates devices first; if the result looks like Firefox's pre-permission
+ * placeholder (an entry with empty deviceId/label even though the Permissions
+ * API reports access), primes the document with getUserMedia and re-enumerates.
+ * Browsers that already return populated entries (Chrome, Safari) skip the
+ * priming call entirely.
  *
  * @returns A promise that resolves with an object containing:
  *  - `devices`: an array of MediaDeviceInfo objects for audio inputs.

package/dist/utils/devices.js

@@ -1,39 +1,36 @@
 /**
- * Requests access to the microphone.
+ * Primes the document with an active microphone stream.
  *
- * This function checks if the microphone permission is in "prompt" state, then requests
- * access and stops any active tracks immediately.
+ * Opens (and immediately stops) a media stream so the document holds an
+ * active mic permission for this session. In Firefox this is what makes
+ * real deviceIds and labels appear in subsequent enumerateDevices() calls.
+ * Throws early if the user has already denied permission.
  *
- * @returns A promise that resolves when the permission request is complete.
+ * @returns A promise that resolves once the stream has been opened and stopped.
  * @throws Error if microphone access is denied or unavailable.
  */
-export async function requestMicAccess() {
-    if (!navigator.permissions) {
-        const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
-        stream.getTracks().forEach((track) => {
-            track.stop();
+export async function primeMicStream() {
+    if (navigator.permissions) {
+        const permissionStatus = await navigator.permissions.query({
+            name: "microphone",
         });
-        return;
+        if (permissionStatus.state === "denied") {
+            throw new Error("Microphone permission is denied");
+        }
     }
-    const permissionStatus = await navigator.permissions.query({
-        name: "microphone",
+    const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+    stream.getTracks().forEach((track) => {
+        track.stop();
     });
-    if (permissionStatus.state === "denied") {
-        throw new Error("Microphone permission is denied");
-    }
-    if (permissionStatus.state === "prompt") {
-        const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
-        stream.getTracks().forEach((track) => {
-            track.stop();
-        });
-    }
 }
 /**
  * Retrieves available audio input devices.
  *
- * This function uses the mediaDevices API to enumerate devices and filters out those
- * which are audio inputs. In some browsers, you may need to request user media before
- * device labels are populated.
+ * Enumerates devices first; if the result looks like Firefox's pre-permission
+ * placeholder (an entry with empty deviceId/label even though the Permissions
+ * API reports access), primes the document with getUserMedia and re-enumerates.
+ * Browsers that already return populated entries (Chrome, Safari) skip the
+ * priming call entirely.
  *
  * @returns A promise that resolves with an object containing:
  *  - `devices`: an array of MediaDeviceInfo objects for audio inputs.
@@ -44,10 +41,24 @@ export async function getAudioDevices() {
     if (!navigator.mediaDevices?.enumerateDevices) {
         throw new Error("MediaDevices API is not available");
     }
-    await requestMicAccess();
+    let audioDevices = await listAudioInputs();
+    if (needsMicPriming(audioDevices)) {
+        await primeMicStream();
+        audioDevices = await listAudioInputs();
+    }
+    return {
+        defaultDevice: audioDevices[0],
+        devices: audioDevices,
+    };
+}
+async function listAudioInputs() {
     const devices = await navigator.mediaDevices.enumerateDevices();
-    const audioDevices = devices.filter((device) => device.kind === "audioinput");
-    const defaultDevice = audioDevices.length > 0 ? audioDevices[0] : undefined;
-    return { defaultDevice, devices: audioDevices };
+    return devices.filter((device) => device.kind === "audioinput");
+}
+function needsMicPriming(audioInputs) {
+    if (audioInputs.length === 0) {
+        return false; // no mic hardware — don't trigger a permission prompt
+    }
+    return audioInputs.some((d) => d.deviceId === "" || d.label === "");
 }
 //# sourceMappingURL=devices.js.map

package/dist/utils/devices.js.map

@@ -1 +1 @@
-{"version":3,"file":"devices.js","sourceRoot":"","sources":["../../src/utils/devices.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1E,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACnC,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,OAAO;IACT,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC;QACzD,IAAI,EAAE,YAA8B;KACrC,CAAC,CAAC;IAEH,IAAI,gBAAgB,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1E,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACnC,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IAInC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,gBAAgB,EAAE,CAAC;IAEzB,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAChE,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5E,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AAClD,CAAC","sourcesContent":["/**\n * Requests access to the microphone.\n *\n * This function checks if the microphone permission is in \"prompt\" state, then requests\n * access and stops any active tracks immediately.\n *\n * @returns A promise that resolves when the permission request is complete.\n * @throws Error if microphone access is denied or unavailable.\n */\nexport async function requestMicAccess(): Promise<void> {\n  if (!navigator.permissions) {\n    const stream = await navigator.mediaDevices.getUserMedia({ audio: true });\n\n    stream.getTracks().forEach((track) => {\n      track.stop();\n    });\n\n    return;\n  }\n\n  const permissionStatus = await navigator.permissions.query({\n    name: \"microphone\" as PermissionName,\n  });\n\n  if (permissionStatus.state === \"denied\") {\n    throw new Error(\"Microphone permission is denied\");\n  }\n\n  if (permissionStatus.state === \"prompt\") {\n    const stream = await navigator.mediaDevices.getUserMedia({ audio: true });\n\n    stream.getTracks().forEach((track) => {\n      track.stop();\n    });\n  }\n}\n\n/**\n * Retrieves available audio input devices.\n *\n * This function uses the mediaDevices API to enumerate devices and filters out those\n * which are audio inputs. In some browsers, you may need to request user media before\n * device labels are populated.\n *\n * @returns A promise that resolves with an object containing:\n *  - `devices`: an array of MediaDeviceInfo objects for audio inputs.\n *  - `defaultDevice`: the first audio input device, if available.\n * @throws Error if mediaDevices API is unavailable or device enumeration fails.\n */\nexport async function getAudioDevices(): Promise<{\n  devices: MediaDeviceInfo[];\n  defaultDevice?: MediaDeviceInfo;\n}> {\n  if (!navigator.mediaDevices?.enumerateDevices) {\n    throw new Error(\"MediaDevices API is not available\");\n  }\n\n  await requestMicAccess();\n\n  const devices = await navigator.mediaDevices.enumerateDevices();\n  const audioDevices = devices.filter((device) => device.kind === \"audioinput\");\n  const defaultDevice = audioDevices.length > 0 ? audioDevices[0] : undefined;\n\n  return { defaultDevice, devices: audioDevices };\n}\n"]}
+{"version":3,"file":"devices.js","sourceRoot":"","sources":["../../src/utils/devices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,gBAAgB,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC;YACzD,IAAI,EAAE,YAA8B;SACrC,CAAC,CAAC;QAEH,IAAI,gBAAgB,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1E,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACnC,KAAK,CAAC,IAAI,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IAInC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,YAAY,GAAG,MAAM,eAAe,EAAE,CAAC;IAE3C,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,MAAM,cAAc,EAAE,CAAC;QACvB,YAAY,GAAG,MAAM,eAAe,EAAE,CAAC;IACzC,CAAC;IAED,OAAO;QACL,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;QAC9B,OAAO,EAAE,YAAY;KACtB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAChE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,eAAe,CAAC,WAA8B;IACrD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,CAAC,sDAAsD;IACtE,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;AACtE,CAAC","sourcesContent":["/**\n * Primes the document with an active microphone stream.\n *\n * Opens (and immediately stops) a media stream so the document holds an\n * active mic permission for this session. In Firefox this is what makes\n * real deviceIds and labels appear in subsequent enumerateDevices() calls.\n * Throws early if the user has already denied permission.\n *\n * @returns A promise that resolves once the stream has been opened and stopped.\n * @throws Error if microphone access is denied or unavailable.\n */\nexport async function primeMicStream(): Promise<void> {\n  if (navigator.permissions) {\n    const permissionStatus = await navigator.permissions.query({\n      name: \"microphone\" as PermissionName,\n    });\n\n    if (permissionStatus.state === \"denied\") {\n      throw new Error(\"Microphone permission is denied\");\n    }\n  }\n\n  const stream = await navigator.mediaDevices.getUserMedia({ audio: true });\n\n  stream.getTracks().forEach((track) => {\n    track.stop();\n  });\n}\n\n/**\n * Retrieves available audio input devices.\n *\n * Enumerates devices first; if the result looks like Firefox's pre-permission\n * placeholder (an entry with empty deviceId/label even though the Permissions\n * API reports access), primes the document with getUserMedia and re-enumerates.\n * Browsers that already return populated entries (Chrome, Safari) skip the\n * priming call entirely.\n *\n * @returns A promise that resolves with an object containing:\n *  - `devices`: an array of MediaDeviceInfo objects for audio inputs.\n *  - `defaultDevice`: the first audio input device, if available.\n * @throws Error if mediaDevices API is unavailable or device enumeration fails.\n */\nexport async function getAudioDevices(): Promise<{\n  devices: MediaDeviceInfo[];\n  defaultDevice?: MediaDeviceInfo;\n}> {\n  if (!navigator.mediaDevices?.enumerateDevices) {\n    throw new Error(\"MediaDevices API is not available\");\n  }\n\n  let audioDevices = await listAudioInputs();\n\n  if (needsMicPriming(audioDevices)) {\n    await primeMicStream();\n    audioDevices = await listAudioInputs();\n  }\n\n  return {\n    defaultDevice: audioDevices[0],\n    devices: audioDevices,\n  };\n}\n\nasync function listAudioInputs(): Promise<MediaDeviceInfo[]> {\n  const devices = await navigator.mediaDevices.enumerateDevices();\n  return devices.filter((device) => device.kind === \"audioinput\");\n}\n\nfunction needsMicPriming(audioInputs: MediaDeviceInfo[]): boolean {\n  if (audioInputs.length === 0) {\n    return false; // no mic hardware — don't trigger a permission prompt\n  }\n  return audioInputs.some((d) => d.deviceId === \"\" || d.label === \"\");\n}\n"]}

package/dist/utils/events.d.ts

@@ -19,10 +19,11 @@ export type RecordingStateChangedEventDetail = {
 export type AudioLevelChangedEventDetail = {
     audioLevel: number;
 };
-export type TranscriptEventDetail = Corti.TranscribeTranscriptMessage;
+export type TranscriptEventDetail = Corti.TranscribeTranscriptMessage | Corti.StreamTranscriptMessage;
 export type CommandEventDetail = Corti.TranscribeCommandMessage;
-export type UsageEventDetail = Corti.TranscribeUsageMessage;
-export type DeltaUsageEventDetail = Corti.TranscribeDeltaUsageMessage;
+export type UsageEventDetail = Corti.TranscribeUsageMessage | Corti.StreamUsageMessage;
+export type DeltaUsageEventDetail = Corti.TranscribeDeltaUsageMessage | Corti.StreamDeltaUsageMessage;
+export type FactsEventDetail = Corti.StreamFactsMessage;
 export type ErrorEventDetail = {
     message: string;
 };
@@ -40,6 +41,7 @@ export declare function transcriptEvent(detail: TranscriptEventDetail): CustomEv
 export declare function commandEvent(detail: CommandEventDetail): CustomEvent<CommandEventDetail>;
 export declare function usageEvent(detail: UsageEventDetail): CustomEvent<UsageEventDetail>;
 export declare function deltaUsageEvent(detail: DeltaUsageEventDetail): CustomEvent<DeltaUsageEventDetail>;
+export declare function factsEvent(detail: FactsEventDetail): CustomEvent<FactsEventDetail>;
 export declare function errorEvent(error: unknown): CustomEvent<ErrorEventDetail>;
 /**
  * @deprecated Use recording-state-changed event with detail.connection field instead.

package/dist/utils/events.js

@@ -61,6 +61,13 @@ export function deltaUsageEvent(detail) {
         detail,
     });
 }
+export function factsEvent(detail) {
+    return new CustomEvent("facts", {
+        bubbles: true,
+        composed: true,
+        detail,
+    });
+}
 function errorToMessage(error) {
     if (error instanceof Error) {
         return error.message;

package/dist/utils/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Corti } from \"@corti/sdk\";\nimport type { RecordingState } from \"../types.js\";\n\nexport type LanguagesChangedEventDetail = {\n  languages: Corti.TranscribeSupportedLanguage[];\n  selectedLanguage: string | undefined;\n};\n\nexport type LanguageChangedEventDetail = {\n  language: string;\n};\n\nexport type RecordingDevicesChangedEventDetail = {\n  devices: MediaDeviceInfo[];\n  selectedDevice: MediaDeviceInfo | undefined;\n};\n\nexport type RecordingStateChangedEventDetail = {\n  state: RecordingState;\n  connection?: \"CONNECTING\" | \"OPEN\" | \"CLOSING\" | \"CLOSED\" | null;\n  processing?: boolean;\n};\n\nexport type AudioLevelChangedEventDetail = {\n  audioLevel: number;\n};\n\nexport type TranscriptEventDetail = Corti.TranscribeTranscriptMessage;\nexport type CommandEventDetail = Corti.TranscribeCommandMessage;\nexport type UsageEventDetail = Corti.TranscribeUsageMessage;\nexport type DeltaUsageEventDetail = Corti.TranscribeDeltaUsageMessage;\n\nexport type ErrorEventDetail = {\n  message: string;\n};\n\nexport function languagesChangedEvent(\n  languages: Corti.TranscribeSupportedLanguage[],\n  selectedLanguage: string | undefined,\n): CustomEvent<LanguagesChangedEventDetail> {\n  return new CustomEvent(\"languages-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: { languages, selectedLanguage },\n  });\n}\n\n/**\n * @deprecated Use languagesChangedEvent instead. This event is kept for backward compatibility.\n */\nexport function languageChangedEvent(\n  language: string,\n): CustomEvent<LanguageChangedEventDetail> {\n  return new CustomEvent(\"language-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: { language },\n  });\n}\n\nexport function recordingDevicesChangedEvent(\n  devices: MediaDeviceInfo[],\n  selectedDevice: MediaDeviceInfo | undefined,\n): CustomEvent<RecordingDevicesChangedEventDetail> {\n  return new CustomEvent(\"recording-devices-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: { devices, selectedDevice },\n  });\n}\n\nexport function recordingStateChangedEvent(\n  state: RecordingState,\n  options: Partial<{\n    connection: \"CONNECTING\" | \"OPEN\" | \"CLOSING\" | \"CLOSED\" | null;\n    processing: boolean;\n  }> = {},\n): CustomEvent<RecordingStateChangedEventDetail> {\n  return new CustomEvent(\"recording-state-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: {\n      connection: options.connection,\n      processing: options.processing,\n      state,\n    },\n  });\n}\n\nexport function transcriptEvent(\n  detail: TranscriptEventDetail,\n): CustomEvent<TranscriptEventDetail> {\n  return new CustomEvent(\"transcript\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nexport function commandEvent(\n  detail: CommandEventDetail,\n): CustomEvent<CommandEventDetail> {\n  return new CustomEvent(\"command\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nexport function usageEvent(\n  detail: UsageEventDetail,\n): CustomEvent<UsageEventDetail> {\n  return new CustomEvent(\"usage\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nexport function deltaUsageEvent(\n  detail: DeltaUsageEventDetail,\n): CustomEvent<DeltaUsageEventDetail> {\n  return new CustomEvent(\"delta-usage\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nfunction errorToMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  if (typeof error === \"object\" && error !== null) {\n    try {\n      return JSON.stringify(error);\n    } catch {\n      return String(error);\n    }\n  }\n\n  return String(error);\n}\n\nexport function errorEvent(error: unknown): CustomEvent<ErrorEventDetail> {\n  const message = errorToMessage(error);\n\n  return new CustomEvent(\"error\", {\n    bubbles: false,\n    composed: true,\n    detail: { message },\n  });\n}\n\n/**\n * @deprecated Use recording-state-changed event with detail.connection field instead.\n */\nexport function streamClosedEvent(detail: unknown): CustomEvent {\n  return new CustomEvent(\"stream-closed\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nexport function readyEvent(): CustomEvent {\n  return new CustomEvent(\"ready\", {\n    bubbles: true,\n    composed: true,\n  });\n}\n\nexport function audioLevelChangedEvent(\n  audioLevel: number,\n): CustomEvent<AudioLevelChangedEventDetail> {\n  return new CustomEvent(\"audio-level-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: { audioLevel },\n  });\n}\n\nexport type NetworkActivityEventDetail = {\n  direction: \"sent\" | \"received\";\n  data: unknown;\n};\n\nexport function networkActivityEvent(\n  direction: \"sent\" | \"received\",\n  data: unknown,\n): CustomEvent<NetworkActivityEventDetail> {\n  return new CustomEvent(\"network-activity\", {\n    bubbles: true,\n    composed: true,\n    detail: { data, direction },\n  });\n}\n\nexport type KeybindingChangedEventDetail = {\n  key: string | null | undefined;\n  code: string | null | undefined;\n  keybinding: string | null;\n  type?: \"push-to-talk\" | \"toggle-to-talk\";\n};\n\nexport type KeybindingActivatedEventDetail = {\n  keyboardEvent: KeyboardEvent;\n};\n\nexport function keybindingChangedEvent(\n  key: string | null | undefined,\n  code: string | null | undefined,\n  keybinding: string | null,\n  type?: \"push-to-talk\" | \"toggle-to-talk\",\n): CustomEvent<KeybindingChangedEventDetail> {\n  return new CustomEvent(\"keybinding-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: { code, key, keybinding, type },\n  });\n}\n\nexport function keybindingActivatedEvent(\n  keyboardEvent: KeyboardEvent,\n): CustomEvent<KeybindingActivatedEventDetail> {\n  return new CustomEvent(\"keybinding-activated\", {\n    bubbles: true,\n    cancelable: true,\n    composed: true,\n    detail: { keyboardEvent },\n  });\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Corti } from \"@corti/sdk\";\nimport type { RecordingState } from \"../types.js\";\n\nexport type LanguagesChangedEventDetail = {\n  languages: Corti.TranscribeSupportedLanguage[];\n  selectedLanguage: string | undefined;\n};\n\nexport type LanguageChangedEventDetail = {\n  language: string;\n};\n\nexport type RecordingDevicesChangedEventDetail = {\n  devices: MediaDeviceInfo[];\n  selectedDevice: MediaDeviceInfo | undefined;\n};\n\nexport type RecordingStateChangedEventDetail = {\n  state: RecordingState;\n  connection?: \"CONNECTING\" | \"OPEN\" | \"CLOSING\" | \"CLOSED\" | null;\n  processing?: boolean;\n};\n\nexport type AudioLevelChangedEventDetail = {\n  audioLevel: number;\n};\n\nexport type TranscriptEventDetail =\n  | Corti.TranscribeTranscriptMessage\n  | Corti.StreamTranscriptMessage;\n\nexport type CommandEventDetail = Corti.TranscribeCommandMessage;\n\nexport type UsageEventDetail =\n  | Corti.TranscribeUsageMessage\n  | Corti.StreamUsageMessage;\n\nexport type DeltaUsageEventDetail =\n  | Corti.TranscribeDeltaUsageMessage\n  | Corti.StreamDeltaUsageMessage;\n\nexport type FactsEventDetail = Corti.StreamFactsMessage;\n\nexport type ErrorEventDetail = {\n  message: string;\n};\n\nexport function languagesChangedEvent(\n  languages: Corti.TranscribeSupportedLanguage[],\n  selectedLanguage: string | undefined,\n): CustomEvent<LanguagesChangedEventDetail> {\n  return new CustomEvent(\"languages-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: { languages, selectedLanguage },\n  });\n}\n\n/**\n * @deprecated Use languagesChangedEvent instead. This event is kept for backward compatibility.\n */\nexport function languageChangedEvent(\n  language: string,\n): CustomEvent<LanguageChangedEventDetail> {\n  return new CustomEvent(\"language-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: { language },\n  });\n}\n\nexport function recordingDevicesChangedEvent(\n  devices: MediaDeviceInfo[],\n  selectedDevice: MediaDeviceInfo | undefined,\n): CustomEvent<RecordingDevicesChangedEventDetail> {\n  return new CustomEvent(\"recording-devices-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: { devices, selectedDevice },\n  });\n}\n\nexport function recordingStateChangedEvent(\n  state: RecordingState,\n  options: Partial<{\n    connection: \"CONNECTING\" | \"OPEN\" | \"CLOSING\" | \"CLOSED\" | null;\n    processing: boolean;\n  }> = {},\n): CustomEvent<RecordingStateChangedEventDetail> {\n  return new CustomEvent(\"recording-state-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: {\n      connection: options.connection,\n      processing: options.processing,\n      state,\n    },\n  });\n}\n\nexport function transcriptEvent(\n  detail: TranscriptEventDetail,\n): CustomEvent<TranscriptEventDetail> {\n  return new CustomEvent(\"transcript\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nexport function commandEvent(\n  detail: CommandEventDetail,\n): CustomEvent<CommandEventDetail> {\n  return new CustomEvent(\"command\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nexport function usageEvent(\n  detail: UsageEventDetail,\n): CustomEvent<UsageEventDetail> {\n  return new CustomEvent(\"usage\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nexport function deltaUsageEvent(\n  detail: DeltaUsageEventDetail,\n): CustomEvent<DeltaUsageEventDetail> {\n  return new CustomEvent(\"delta-usage\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nexport function factsEvent(\n  detail: FactsEventDetail,\n): CustomEvent<FactsEventDetail> {\n  return new CustomEvent(\"facts\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nfunction errorToMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  if (typeof error === \"object\" && error !== null) {\n    try {\n      return JSON.stringify(error);\n    } catch {\n      return String(error);\n    }\n  }\n\n  return String(error);\n}\n\nexport function errorEvent(error: unknown): CustomEvent<ErrorEventDetail> {\n  const message = errorToMessage(error);\n\n  return new CustomEvent(\"error\", {\n    bubbles: false,\n    composed: true,\n    detail: { message },\n  });\n}\n\n/**\n * @deprecated Use recording-state-changed event with detail.connection field instead.\n */\nexport function streamClosedEvent(detail: unknown): CustomEvent {\n  return new CustomEvent(\"stream-closed\", {\n    bubbles: true,\n    composed: true,\n    detail,\n  });\n}\n\nexport function readyEvent(): CustomEvent {\n  return new CustomEvent(\"ready\", {\n    bubbles: true,\n    composed: true,\n  });\n}\n\nexport function audioLevelChangedEvent(\n  audioLevel: number,\n): CustomEvent<AudioLevelChangedEventDetail> {\n  return new CustomEvent(\"audio-level-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: { audioLevel },\n  });\n}\n\nexport type NetworkActivityEventDetail = {\n  direction: \"sent\" | \"received\";\n  data: unknown;\n};\n\nexport function networkActivityEvent(\n  direction: \"sent\" | \"received\",\n  data: unknown,\n): CustomEvent<NetworkActivityEventDetail> {\n  return new CustomEvent(\"network-activity\", {\n    bubbles: true,\n    composed: true,\n    detail: { data, direction },\n  });\n}\n\nexport type KeybindingChangedEventDetail = {\n  key: string | null | undefined;\n  code: string | null | undefined;\n  keybinding: string | null;\n  type?: \"push-to-talk\" | \"toggle-to-talk\";\n};\n\nexport type KeybindingActivatedEventDetail = {\n  keyboardEvent: KeyboardEvent;\n};\n\nexport function keybindingChangedEvent(\n  key: string | null | undefined,\n  code: string | null | undefined,\n  keybinding: string | null,\n  type?: \"push-to-talk\" | \"toggle-to-talk\",\n): CustomEvent<KeybindingChangedEventDetail> {\n  return new CustomEvent(\"keybinding-changed\", {\n    bubbles: true,\n    composed: true,\n    detail: { code, key, keybinding, type },\n  });\n}\n\nexport function keybindingActivatedEvent(\n  keyboardEvent: KeyboardEvent,\n): CustomEvent<KeybindingActivatedEventDetail> {\n  return new CustomEvent(\"keybinding-activated\", {\n    bubbles: true,\n    cancelable: true,\n    composed: true,\n    detail: { keyboardEvent },\n  });\n}\n"]}

package/dist/utils/keybinding.d.ts

@@ -5,8 +5,9 @@
  * @returns Normalized keybinding string or null if empty
  *
  * @example
- * normalizeKeybinding("k") // "k"
+ * normalizeKeybinding("k") // "K"
  * normalizeKeybinding("meta") // "Cmd" on Mac
+ * normalizeKeybinding(" ") // "Space"
  * normalizeKeybinding(" space ") // "Space"
  */
 export declare function normalizeKeybinding(keybinding: string | null | undefined): string | null;

package/dist/utils/keybinding.js

@@ -27,7 +27,7 @@ function capitalize(str) {
  * Normalizes a key string to the keybinding format.
  * Handles platform-specific mappings and capitalization.
  *
- * @param key - Key string to normalize (will be trimmed and lowercased)
+ * @param key - Key string to normalize (will be trimmed and uppercased)
  * @returns Formatted key string for keybinding
  *
  * @example
@@ -35,7 +35,8 @@ function capitalize(str) {
  * normalizeKeyForKeybinding("META") // "Cmd" on Mac, "Meta" elsewhere
  * normalizeKeyForKeybinding(" alt ") // "Opt" on Mac, "Alt" elsewhere
  * normalizeKeyForKeybinding("shift") // "Shift"
- * normalizeKeyForKeybinding("k") // "k"
+ * normalizeKeyForKeybinding("k") // "K"
+ * normalizeKeyForKeybinding(" ") // "Space"
  */
 function normalizeKeyForKeybinding(key) {
     if (key === " ") {
@@ -54,6 +55,11 @@ function normalizeKeyForKeybinding(key) {
     if (normalized === "space") {
         return "Space";
     }
+    // TODO: Uncomment this for v1 to avoid breaking changes now
+    // Capitalize single letters (a-z) for consistent display
+    // if (/^[a-z]$/.test(normalized)) {
+    //   return normalized.toUpperCase();
+    // }
     return normalized.length > 1 ? capitalize(normalized) : normalized;
 }
 /**
@@ -63,19 +69,19 @@ function normalizeKeyForKeybinding(key) {
  * @returns Normalized keybinding string or null if empty
  *
  * @example
- * normalizeKeybinding("k") // "k"
+ * normalizeKeybinding("k") // "K"
  * normalizeKeybinding("meta") // "Cmd" on Mac
+ * normalizeKeybinding(" ") // "Space"
  * normalizeKeybinding(" space ") // "Space"
  */
 export function normalizeKeybinding(keybinding) {
     if (!keybinding) {
         return null;
     }
-    const trimmed = keybinding.trim();
-    if (trimmed === "") {
+    if (keybinding !== " " && keybinding.trim() === "") {
         return null;
     }
-    return normalizeKeyForKeybinding(trimmed);
+    return normalizeKeyForKeybinding(keybinding);
 }
 /**
  * Checks if a pressed key matches the keybinding.

package/dist/utils/keybinding.js.map

@@ -1 +1 @@
-{"version":3,"file":"keybinding.js","sourceRoot":"","sources":["../../src/utils/keybinding.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Checks if the current platform is macOS.\n * Uses userAgent string for reliable cross-browser detection.\n *\n * @returns true if running on macOS\n */\nfunction isMac(): boolean {\n  if (typeof navigator === \"undefined\") {\n    return false;\n  }\n\n  // Check user agent for Mac patterns (most reliable method)\n  return /Mac|iPhone|iPad|iPod/.test(navigator.userAgent);\n}\n\n/**\n * Capitalizes the first letter of a string.\n *\n * @param str - String to capitalize\n * @returns String with first letter capitalized\n */\nfunction capitalize(str: string): string {\n  if (str.length === 0) {\n    return str;\n  }\n\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/**\n * Normalizes a key string to the keybinding format.\n * Handles platform-specific mappings and capitalization.\n *\n * @param key - Key string to normalize (will be trimmed and lowercased)\n * @returns Formatted key string for keybinding\n *\n * @example\n * normalizeKeyForKeybinding(\"Control\") // \"Ctrl\"\n * normalizeKeyForKeybinding(\"META\") // \"Cmd\" on Mac, \"Meta\" elsewhere\n * normalizeKeyForKeybinding(\" alt \") // \"Opt\" on Mac, \"Alt\" elsewhere\n * normalizeKeyForKeybinding(\"shift\") // \"Shift\"\n * normalizeKeyForKeybinding(\"k\") // \"k\"\n */\nfunction normalizeKeyForKeybinding(key: string): string {\n  if (key === \" \") {\n    return \"Space\";\n  }\n\n  const normalized = key.trim().toLowerCase();\n\n  if (normalized === \"control\") {\n    return \"Ctrl\";\n  }\n  if (normalized === \"meta\" || normalized === \"cmd\") {\n    return isMac() ? \"Cmd\" : \"Meta\";\n  }\n  if (normalized === \"alt\" || normalized === \"opt\") {\n    return isMac() ? \"Opt\" : \"Alt\";\n  }\n  if (normalized === \"space\") {\n    return \"Space\";\n  }\n\n  return normalized.length > 1 ? capitalize(normalized) : normalized;\n}\n\n/**\n * Normalizes a keybinding string.\n *\n * @param keybinding - Keybinding string to normalize\n * @returns Normalized keybinding string or null if empty\n *\n * @example\n * normalizeKeybinding(\"k\") // \"k\"\n * normalizeKeybinding(\"meta\") // \"Cmd\" on Mac\n * normalizeKeybinding(\" space \") // \"Space\"\n */\nexport function normalizeKeybinding(\n  keybinding: string | null | undefined,\n): string | null {\n  if (!keybinding) {\n    return null;\n  }\n\n  const trimmed = keybinding.trim();\n\n  if (trimmed === \"\") {\n    return null;\n  }\n\n  return normalizeKeyForKeybinding(trimmed);\n}\n\n/**\n * Checks if a pressed key matches the keybinding.\n * Checks both event.key and event.code for better reliability.\n *\n * @param event - KeyboardEvent to check\n * @param keybinding - Keybinding string to match against\n * @returns true if either the key or code matches the keybinding\n *\n * @example\n * matchesKeybinding(event, \"k\") // true if event.key is \"k\" or event.code is \"KeyK\"\n * matchesKeybinding(event, \"`\") // true if event.key is \"`\" or event.code is \"Backquote\"\n */\nexport function matchesKeybinding(\n  event: KeyboardEvent,\n  keybinding: string | null | undefined,\n): boolean {\n  const normalizedKeybinding = normalizeKeybinding(keybinding);\n\n  if (!normalizedKeybinding) {\n    return false;\n  }\n\n  const normalizedKey = normalizeKeyForKeybinding(event.key);\n  const normalizedCode = normalizeKeyForKeybinding(event.code);\n\n  return (\n    normalizedKey === normalizedKeybinding ||\n    normalizedCode === normalizedKeybinding\n  );\n}\n\n/**\n * Checks if keybindings should be ignored for the current active element.\n * Returns true if the user is typing in an input field.\n *\n * @param element - Element to check\n * @returns true if keybindings should be ignored for this element\n *\n * @example\n * shouldIgnoreKeybinding(document.activeElement) // true if input/textarea/contenteditable\n */\nexport function shouldIgnoreKeybinding(element: Element | null): boolean {\n  if (!element) {\n    return false;\n  }\n\n  const tagName = element.tagName.toLowerCase();\n\n  if (tagName === \"input\" || tagName === \"textarea\") {\n    return true;\n  }\n\n  if (element instanceof HTMLElement && element.contentEditable === \"true\") {\n    return true;\n  }\n\n  return false;\n}\n"]}
+{"version":3,"file":"keybinding.js","sourceRoot":"","sources":["../../src/utils/keybinding.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Checks if the current platform is macOS.\n * Uses userAgent string for reliable cross-browser detection.\n *\n * @returns true if running on macOS\n */\nfunction isMac(): boolean {\n  if (typeof navigator === \"undefined\") {\n    return false;\n  }\n\n  // Check user agent for Mac patterns (most reliable method)\n  return /Mac|iPhone|iPad|iPod/.test(navigator.userAgent);\n}\n\n/**\n * Capitalizes the first letter of a string.\n *\n * @param str - String to capitalize\n * @returns String with first letter capitalized\n */\nfunction capitalize(str: string): string {\n  if (str.length === 0) {\n    return str;\n  }\n\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/**\n * Normalizes a key string to the keybinding format.\n * Handles platform-specific mappings and capitalization.\n *\n * @param key - Key string to normalize (will be trimmed and uppercased)\n * @returns Formatted key string for keybinding\n *\n * @example\n * normalizeKeyForKeybinding(\"Control\") // \"Ctrl\"\n * normalizeKeyForKeybinding(\"META\") // \"Cmd\" on Mac, \"Meta\" elsewhere\n * normalizeKeyForKeybinding(\" alt \") // \"Opt\" on Mac, \"Alt\" elsewhere\n * normalizeKeyForKeybinding(\"shift\") // \"Shift\"\n * normalizeKeyForKeybinding(\"k\") // \"K\"\n * normalizeKeyForKeybinding(\" \") // \"Space\"\n */\nfunction normalizeKeyForKeybinding(key: string): string {\n  if (key === \" \") {\n    return \"Space\";\n  }\n\n  const normalized = key.trim().toLowerCase();\n\n  if (normalized === \"control\") {\n    return \"Ctrl\";\n  }\n  if (normalized === \"meta\" || normalized === \"cmd\") {\n    return isMac() ? \"Cmd\" : \"Meta\";\n  }\n  if (normalized === \"alt\" || normalized === \"opt\") {\n    return isMac() ? \"Opt\" : \"Alt\";\n  }\n  if (normalized === \"space\") {\n    return \"Space\";\n  }\n\n  // TODO: Uncomment this for v1 to avoid breaking changes now\n  // Capitalize single letters (a-z) for consistent display\n  // if (/^[a-z]$/.test(normalized)) {\n  //   return normalized.toUpperCase();\n  // }\n\n  return normalized.length > 1 ? capitalize(normalized) : normalized;\n}\n\n/**\n * Normalizes a keybinding string.\n *\n * @param keybinding - Keybinding string to normalize\n * @returns Normalized keybinding string or null if empty\n *\n * @example\n * normalizeKeybinding(\"k\") // \"K\"\n * normalizeKeybinding(\"meta\") // \"Cmd\" on Mac\n * normalizeKeybinding(\" \") // \"Space\"\n * normalizeKeybinding(\" space \") // \"Space\"\n */\nexport function normalizeKeybinding(\n  keybinding: string | null | undefined,\n): string | null {\n  if (!keybinding) {\n    return null;\n  }\n  if (keybinding !== \" \" && keybinding.trim() === \"\") {\n    return null;\n  }\n\n  return normalizeKeyForKeybinding(keybinding);\n}\n\n/**\n * Checks if a pressed key matches the keybinding.\n * Checks both event.key and event.code for better reliability.\n *\n * @param event - KeyboardEvent to check\n * @param keybinding - Keybinding string to match against\n * @returns true if either the key or code matches the keybinding\n *\n * @example\n * matchesKeybinding(event, \"k\") // true if event.key is \"k\" or event.code is \"KeyK\"\n * matchesKeybinding(event, \"`\") // true if event.key is \"`\" or event.code is \"Backquote\"\n */\nexport function matchesKeybinding(\n  event: KeyboardEvent,\n  keybinding: string | null | undefined,\n): boolean {\n  const normalizedKeybinding = normalizeKeybinding(keybinding);\n\n  if (!normalizedKeybinding) {\n    return false;\n  }\n\n  const normalizedKey = normalizeKeyForKeybinding(event.key);\n  const normalizedCode = normalizeKeyForKeybinding(event.code);\n\n  return (\n    normalizedKey === normalizedKeybinding ||\n    normalizedCode === normalizedKeybinding\n  );\n}\n\n/**\n * Checks if keybindings should be ignored for the current active element.\n * Returns true if the user is typing in an input field.\n *\n * @param element - Element to check\n * @returns true if keybindings should be ignored for this element\n *\n * @example\n * shouldIgnoreKeybinding(document.activeElement) // true if input/textarea/contenteditable\n */\nexport function shouldIgnoreKeybinding(element: Element | null): boolean {\n  if (!element) {\n    return false;\n  }\n\n  const tagName = element.tagName.toLowerCase();\n\n  if (tagName === \"input\" || tagName === \"textarea\") {\n    return true;\n  }\n\n  if (element instanceof HTMLElement && element.contentEditable === \"true\") {\n    return true;\n  }\n\n  return false;\n}\n"]}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@corti/dictation-web",
   "description": "Web component for Corti Dictation",
   "author": "Corti ApS",
-  "version": "0.6.0",
+  "version": "0.7.0-ambient",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",