@voiceinput/provider 0.1.0-beta.1

package/dist/test.d.ts

@@ -0,0 +1,72 @@
+import { VoiceInputError, VoiceInputProviderV1, VoiceInputProviderV1CallOptions, VoiceInputProviderV1StreamPart, VoiceTranscriptionOptions } from "./index.js";
+//#region src/test.d.ts
+interface FakeVoiceInputProviderOptions {
+  provider?: string;
+  modelId?: string;
+  sampleRate?: number;
+  autoOpen?: boolean;
+  autoCloseOnFinish?: boolean;
+  validateOptions?: (options: VoiceTranscriptionOptions) => void;
+}
+interface FakeVoiceInputProviderSessionSnapshot {
+  readonly callOptions: VoiceInputProviderV1CallOptions;
+  readonly audioChunks: readonly Int16Array[];
+  readonly finishCallCount: number;
+  readonly abortCallCount: number;
+  readonly closed: boolean;
+  readonly aborted: boolean;
+}
+interface FakeVoiceInputProviderController {
+  readonly sessions: readonly FakeVoiceInputProviderSessionSnapshot[];
+  waitForSession(index?: number): Promise<FakeVoiceInputProviderSessionSnapshot>;
+  resolveOpen(index?: number): void;
+  rejectOpen(error: unknown, index?: number): void;
+  emit(part: VoiceInputProviderV1StreamPart, index?: number): void;
+  close(index?: number): void;
+  fail(error: VoiceInputError, index?: number): void;
+  timeout(index?: number): PromiseLike<void> | void;
+}
+interface FakeVoiceInputProvider {
+  provider: VoiceInputProviderV1;
+  controller: FakeVoiceInputProviderController;
+}
+declare function createFakeVoiceInputProvider(options?: FakeVoiceInputProviderOptions): FakeVoiceInputProvider;
+interface VoiceInputProviderV1ConformanceHarness {
+  provider: VoiceInputProviderV1;
+  controller: FakeVoiceInputProviderController;
+}
+interface VoiceInputProviderV1ConformanceCase {
+  name: string;
+  run(): Promise<void>;
+}
+interface VoiceInputProviderV1ConformanceOptions {
+  createHarness(): VoiceInputProviderV1ConformanceHarness;
+  createAccumulatorSession(provider: VoiceInputProviderV1, audioSource: {
+    prepare(): PromiseLike<{
+      readonly stream: ReadableStream<Int16Array>;
+      start(): PromiseLike<void> | void;
+      stop(): PromiseLike<void> | void;
+      abort(reason?: unknown): void;
+    }>;
+  }): {
+    getSnapshot(): {
+      readonly finalTranscript: string;
+    };
+    start(): PromiseLike<void> | void;
+    cancel(): PromiseLike<void> | void;
+  };
+  errorTaxonomy: {
+    readonly createProvider?: () => VoiceInputProviderV1;
+    readonly createUnsupportedBrowserProvider: () => VoiceInputProviderV1;
+    readonly invalidOptions: VoiceTranscriptionOptions;
+    readonly malformedUnsupportedOptions: VoiceTranscriptionOptions;
+    readonly unsupportedOptions: VoiceTranscriptionOptions;
+  };
+}
+declare class VoiceInputProviderConformanceError extends Error {
+  constructor(message: string);
+}
+declare function createVoiceInputProviderV1ConformanceCases(options: VoiceInputProviderV1ConformanceOptions): readonly VoiceInputProviderV1ConformanceCase[];
+//#endregion
+export { FakeVoiceInputProvider, FakeVoiceInputProviderController, FakeVoiceInputProviderOptions, FakeVoiceInputProviderSessionSnapshot, VoiceInputProviderConformanceError, VoiceInputProviderV1ConformanceCase, VoiceInputProviderV1ConformanceHarness, VoiceInputProviderV1ConformanceOptions, createFakeVoiceInputProvider, createVoiceInputProviderV1ConformanceCases };
+//# sourceMappingURL=test.d.ts.map

package/dist/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","names":[],"sources":["../src/test.ts"],"mappings":";;UASiB;EACf;EACA;EACA;EACA;EACA;EACA,mBAAmB,SAAS;;UAGb;WACN,aAAa;WACb,sBAAsB;WACtB;WACA;WACA;WACA;;UAGM;WACN,mBAAmB;EAC5B,eACE,iBACC,QAAQ;EACX,YAAY;EACZ,WAAW,gBAAgB;EAC3B,KAAK,MAAM,gCAAgC;EAC3C,MAAM;EACN,KAAK,OAAO,iBAAiB;EAC7B,QAAQ,iBAAiB;;UAGV;EACf,UAAU;EACV,YAAY;;iBAoBE,6BACd,UAAS,gCACR;UA6Oc;EACf,UAAU;EACV,YAAY;;UAGG;EACf;EACA,OAAO;;UAGQ;EACf,iBAAiB;EACjB,yBACE,UAAU,sBACV;IACE,WAAW;eACA,QAAQ,eAAe;MAChC,SAAS;MACT,QAAQ;MACR,MAAM;;;IAIV;eAA0B;;IAC1B,SAAS;IACT,UAAU;;EAEZ;aACW,uBAAuB;aACvB,wCAAwC;aACxC,gBAAgB;aAChB,6BAA6B;aAC7B,oBAAoB;;;cAIpB,2CAA2C;EACtD,YAAY;;iBAwEE,2CACd,SAAS,kDACC"}

package/dist/test.js

@@ -0,0 +1,474 @@
+import { VoiceInputError } from "./index.js";
+//#region src/test.ts
+function createFakeVoiceInputProvider(options = {}) {
+	const sessions = [];
+	const waiters = /* @__PURE__ */ new Map();
+	const autoOpen = options.autoOpen ?? true;
+	const autoCloseOnFinish = options.autoCloseOnFinish ?? true;
+	const getSession = (index = sessions.length - 1) => {
+		const session = sessions[index];
+		if (session === void 0) throw new Error(`Fake provider session ${index} does not exist.`);
+		return session;
+	};
+	const getSnapshot = (session) => Object.freeze({
+		callOptions: Object.freeze({ ...session.callOptions }),
+		audioChunks: Object.freeze([...session.audioChunks]),
+		finishCallCount: session.finishCallCount,
+		abortCallCount: session.abortCallCount,
+		closed: session.closed,
+		aborted: session.aborted
+	});
+	const close = (session) => {
+		if (session.closed) return;
+		session.closed = true;
+		session.streamController.close();
+	};
+	const emit = (part, index) => {
+		const session = getSession(index);
+		if (session.closed) return;
+		if (part.type === "interim" || part.type === "final") {
+			session.streamController.enqueue({
+				...part,
+				segmentId: part.segmentId ?? `fake:${session.segmentSequence}`
+			});
+			if (part.type === "final") session.segmentSequence += 1;
+		} else session.streamController.enqueue(part);
+	};
+	const controller = {
+		get sessions() {
+			return Object.freeze(sessions.map(getSnapshot));
+		},
+		async waitForSession(index = 0) {
+			const session = sessions[index];
+			if (session !== void 0) return getSnapshot(session);
+			return await new Promise((resolve) => {
+				const existingWaiters = waiters.get(index) ?? [];
+				existingWaiters.push(resolve);
+				waiters.set(index, existingWaiters);
+			});
+		},
+		resolveOpen(index) {
+			getSession(index).open();
+		},
+		rejectOpen(error, index) {
+			getSession(index).reject(error);
+		},
+		emit,
+		close(index) {
+			close(getSession(index));
+		},
+		fail(error, index) {
+			emit({
+				type: "error",
+				error
+			}, index);
+			close(getSession(index));
+		},
+		timeout(index) {
+			const session = getSession(index);
+			emit({
+				type: "error",
+				error: new VoiceInputError({
+					code: "network-error",
+					message: "The fake provider timed out.",
+					provider: options.provider ?? "fake",
+					retryable: true
+				})
+			}, index);
+			close(session);
+		}
+	};
+	return {
+		provider: {
+			specificationVersion: "v1",
+			provider: options.provider ?? "fake",
+			modelId: options.modelId ?? "fake-model",
+			sampleRate: options.sampleRate ?? 16e3,
+			validateOptions: options.validateOptions ?? (() => {}),
+			doOpen(callOptions) {
+				let streamController;
+				const stream = new ReadableStream({ start(controller_) {
+					streamController = controller_;
+				} });
+				if (streamController === void 0) throw new Error("The fake provider stream did not initialize.");
+				let resolveOpen = () => {};
+				let rejectOpen = () => {};
+				const openPromise = new Promise((resolve, reject) => {
+					resolveOpen = resolve;
+					rejectOpen = reject;
+				});
+				const mutableSession = {
+					segmentSequence: 0,
+					callOptions,
+					audioChunks: [],
+					finishCallCount: 0,
+					abortCallCount: 0,
+					closed: false,
+					aborted: false,
+					finished: false,
+					opened: false,
+					settled: false,
+					streamController,
+					publicSession: void 0,
+					open() {
+						if (mutableSession.settled) return;
+						mutableSession.opened = true;
+						mutableSession.settled = true;
+						resolveOpen(mutableSession.publicSession);
+					},
+					reject(error) {
+						if (mutableSession.settled) return;
+						mutableSession.settled = true;
+						close(mutableSession);
+						rejectOpen(error);
+					}
+				};
+				const publicSession = {
+					stream,
+					sendAudio(chunk) {
+						if (!mutableSession.closed && !mutableSession.aborted) mutableSession.audioChunks.push(chunk);
+					},
+					finish() {
+						if (mutableSession.closed || mutableSession.aborted || mutableSession.finished) return;
+						mutableSession.finished = true;
+						mutableSession.finishCallCount += 1;
+						if (autoCloseOnFinish) close(mutableSession);
+					},
+					abort(reason) {
+						if (mutableSession.closed || mutableSession.aborted) return;
+						mutableSession.aborted = true;
+						mutableSession.abortCallCount += 1;
+						close(mutableSession);
+						if (!mutableSession.settled) {
+							mutableSession.settled = true;
+							rejectOpen(reason);
+						}
+					}
+				};
+				mutableSession.publicSession = publicSession;
+				const index = sessions.push(mutableSession) - 1;
+				for (const resolve of waiters.get(index) ?? []) resolve(getSnapshot(mutableSession));
+				waiters.delete(index);
+				callOptions.abortSignal.addEventListener("abort", () => publicSession.abort(callOptions.abortSignal.reason), { once: true });
+				if (callOptions.abortSignal.aborted) publicSession.abort(callOptions.abortSignal.reason);
+				else if (autoOpen) mutableSession.open();
+				return openPromise;
+			}
+		},
+		controller
+	};
+}
+var VoiceInputProviderConformanceError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "VoiceInputProviderConformanceError";
+	}
+};
+function assert(condition, message) {
+	if (!condition) throw new VoiceInputProviderConformanceError(message);
+}
+async function readStream(stream) {
+	const parts = [];
+	for await (const part of stream) parts.push(part);
+	return parts;
+}
+async function openSession(harness) {
+	const sessionPromise = Promise.resolve().then(() => harness.provider.doOpen({ abortSignal: new AbortController().signal }));
+	await harness.controller.waitForSession();
+	harness.controller.resolveOpen();
+	return await sessionPromise;
+}
+function createConformanceAudioSource() {
+	return { prepare() {
+		let closed = false;
+		let streamController;
+		const stream = new ReadableStream({ start(controller) {
+			streamController = controller;
+		} });
+		const close = () => {
+			if (!closed) {
+				closed = true;
+				streamController?.close();
+			}
+		};
+		return Promise.resolve({
+			stream,
+			start() {},
+			stop: close,
+			abort: close
+		});
+	} };
+}
+async function waitFor(condition, message) {
+	for (let attempt = 0; attempt < 20; attempt += 1) {
+		if (condition()) return;
+		await new Promise((resolve) => setTimeout(resolve, 0));
+	}
+	throw new VoiceInputProviderConformanceError(message);
+}
+function createVoiceInputProviderV1ConformanceCases(options) {
+	return [
+		{
+			name: "declares valid v1 metadata and accepts baseline options",
+			async run() {
+				const { provider } = options.createHarness();
+				assert(provider.specificationVersion === "v1", "Expected v1 spec.");
+				assert(provider.provider.length > 0, "Provider ID must not be empty.");
+				assert(provider.modelId.length > 0, "Model ID must not be empty.");
+				assert(Number.isInteger(provider.sampleRate) && provider.sampleRate > 0, "Sample rate must be a positive integer.");
+				provider.validateOptions({});
+			}
+		},
+		{
+			name: "streams normalized parts in order and closes terminally",
+			async run() {
+				const harness = options.createHarness();
+				const session = await openSession(harness);
+				const partsPromise = readStream(session.stream);
+				harness.controller.emit({ type: "speech-start" });
+				harness.controller.emit({
+					type: "interim",
+					text: "hel"
+				});
+				harness.controller.emit({
+					type: "interim",
+					text: "hello"
+				});
+				harness.controller.emit({
+					type: "final",
+					text: "hello"
+				});
+				harness.controller.emit({ type: "speech-end" });
+				harness.controller.close();
+				const parts = await partsPromise;
+				const transcripts = parts.filter((part) => part.type === "interim" || part.type === "final");
+				assert(transcripts.every((part) => typeof part.segmentId === "string" && part.segmentId.length > 0), "Normalized transcript parts must include a non-empty segmentId.");
+				assert(new Set(transcripts.map((part) => part.segmentId)).size === 1, "Interim revisions and their final must keep the same segmentId.");
+				const partTypes = parts.map((part) => part.type);
+				assert(partTypes.join(",") === "speech-start,interim,interim,final,speech-end", `Unexpected stream order: ${partTypes.join(",")}`);
+				harness.controller.emit({
+					type: "final",
+					text: "late"
+				});
+				const lateReader = session.stream.getReader();
+				const lateResult = await lateReader.read();
+				lateReader.releaseLock();
+				assert(lateResult.done, `Output must not be emitted after closure: ${JSON.stringify(lateResult)}.`);
+			}
+		},
+		{
+			name: "accepts audio chunks and finishes idempotently",
+			async run() {
+				const harness = options.createHarness();
+				const session = await openSession(harness);
+				await session.sendAudio(new Int16Array([1, 2]));
+				await session.sendAudio(new Int16Array([3, 4]));
+				await session.finish();
+				await session.finish();
+				const snapshot = harness.controller.sessions[0];
+				assert(snapshot !== void 0, "Expected a provider session.");
+				assert(snapshot.audioChunks.length === 2, "Expected two audio chunks.");
+				assert(snapshot.finishCallCount === 1, "finish() must have only one observable effect.");
+			}
+		},
+		{
+			name: "drains a delayed provider final after finish",
+			async run() {
+				const harness = options.createHarness();
+				const session = await openSession(harness);
+				const partsPromise = readStream(session.stream);
+				await session.sendAudio(new Int16Array([1]));
+				harness.controller.emit({
+					type: "interim",
+					text: "draft"
+				});
+				const finishPromise = Promise.resolve(session.finish());
+				await Promise.resolve();
+				harness.controller.emit({
+					type: "final",
+					text: "corrected."
+				});
+				harness.controller.close();
+				await finishPromise;
+				const finals = (await partsPromise).filter((part) => part.type === "final" && part.text.length > 0);
+				assert(finals.length === 1, "Expected one delayed final part.");
+				assert(finals[0]?.type === "final" && finals[0].text === "corrected.", "finish() must preserve the provider's corrected final text.");
+			}
+		},
+		{
+			name: "never promotes interim text when finish has no final",
+			async run() {
+				const harness = options.createHarness();
+				const session = await openSession(harness);
+				const partsPromise = readStream(session.stream);
+				await session.sendAudio(new Int16Array([1]));
+				harness.controller.emit({
+					type: "interim",
+					text: "mutable draft"
+				});
+				const finishPromise = Promise.resolve(session.finish());
+				await Promise.resolve();
+				harness.controller.close();
+				await finishPromise;
+				assert(!(await partsPromise).some((part) => part.type === "final" && part.text.length > 0), "Interim text must not be relabeled as final during finish().");
+			}
+		},
+		{
+			name: "feeds multiple final chunks through the shared accumulator",
+			async run() {
+				const harness = options.createHarness();
+				const accumulator = options.createAccumulatorSession(harness.provider, createConformanceAudioSource());
+				const startPromise = Promise.resolve(accumulator.start());
+				await harness.controller.waitForSession();
+				harness.controller.resolveOpen();
+				await startPromise;
+				harness.controller.emit({
+					type: "final",
+					text: "one"
+				});
+				harness.controller.emit({
+					type: "final",
+					text: "two"
+				});
+				harness.controller.emit({
+					type: "final",
+					text: ","
+				});
+				harness.controller.emit({
+					type: "final",
+					text: "three"
+				});
+				await waitFor(() => accumulator.getSnapshot().finalTranscript === "one two, three", `Unexpected accumulated transcript: ${accumulator.getSnapshot().finalTranscript}`);
+				await accumulator.cancel();
+			}
+		},
+		{
+			name: "maps a terminal timeout and closes the stream",
+			async run() {
+				const harness = options.createHarness();
+				const session = await openSession(harness);
+				const partsPromise = readStream(session.stream);
+				await session.sendAudio(new Int16Array([1]));
+				const finishOutcome = Promise.resolve(session.finish()).then(() => void 0, () => void 0);
+				await harness.controller.timeout();
+				await finishOutcome;
+				const errorParts = (await partsPromise).filter((part) => part.type === "error");
+				assert(errorParts.length === 1, "Expected one terminal timeout error.");
+				assert(errorParts[0]?.error.code === "network-error", `Expected network-error, received ${errorParts[0]?.error.code}.`);
+				assert(errorParts[0]?.error.retryable, "Provider timeouts must be retryable.");
+			}
+		},
+		{
+			name: "aborts immediately and idempotently",
+			async run() {
+				const harness = options.createHarness();
+				const session = await openSession(harness);
+				const partsPromise = readStream(session.stream);
+				session.abort("test");
+				session.abort("test-again");
+				await partsPromise;
+				const snapshot = harness.controller.sessions[0];
+				assert(snapshot?.aborted, "Session was not marked aborted.");
+				assert(snapshot.closed, "Abort must close the provider session.");
+				assert(snapshot.abortCallCount === 1, "abort() must have only one observable effect.");
+				harness.controller.emit({
+					type: "final",
+					text: "late"
+				});
+				const lateReader = session.stream.getReader();
+				const lateResult = await lateReader.read();
+				lateReader.releaseLock();
+				assert(lateResult.done, `Output must not be emitted after abort: ${JSON.stringify(lateResult)}.`);
+			}
+		},
+		{
+			name: "honors abort signals while opening",
+			async run() {
+				const harness = options.createHarness();
+				const abortController = new AbortController();
+				const sessionPromise = Promise.resolve().then(() => harness.provider.doOpen({ abortSignal: abortController.signal }));
+				await harness.controller.waitForSession();
+				abortController.abort("cancelled");
+				let rejected = false;
+				try {
+					await sessionPromise;
+				} catch {
+					rejected = true;
+				}
+				assert(rejected, "An aborted open must reject.");
+				assert(harness.controller.sessions[0]?.aborted, "An aborted open must tear down its pending session.");
+			}
+		},
+		{
+			name: "reports an abnormal failure before stream completion",
+			async run() {
+				const harness = options.createHarness();
+				const partsPromise = readStream((await openSession(harness)).stream);
+				harness.controller.fail(new VoiceInputError({
+					code: "provider-error",
+					message: "Synthetic provider failure.",
+					provider: harness.provider.provider
+				}));
+				const parts = await partsPromise;
+				assert(parts.length === 1, "Expected exactly one error part.");
+				assert(parts[0]?.type === "error", "Expected an error part.");
+				assert(parts[0]?.type === "error" && VoiceInputError.isInstance(parts[0].error), "Provider failures must use VoiceInputError.");
+			}
+		},
+		{
+			name: "classifies malformed portable options as invalid configuration",
+			async run() {
+				const provider = options.errorTaxonomy.createProvider?.() ?? options.createHarness().provider;
+				const error = captureValidationError(provider, options.errorTaxonomy.invalidOptions);
+				assert(error.code === "invalid-configuration", `Expected invalid-configuration, received ${error.code}.`);
+				assert(error.provider === provider.provider, "Validation errors must identify their provider.");
+				assert(error.cause instanceof Error, "Invalid configuration must preserve its validation cause.");
+			}
+		},
+		{
+			name: "classifies valid unavailable options as unsupported features",
+			async run() {
+				const provider = options.errorTaxonomy.createProvider?.() ?? options.createHarness().provider;
+				const error = captureValidationError(provider, options.errorTaxonomy.unsupportedOptions);
+				assert(error.code === "unsupported-feature", `Expected unsupported-feature, received ${error.code}.`);
+				assert(error.provider === provider.provider, "Unsupported-feature errors must identify their provider.");
+			}
+		},
+		{
+			name: "reports malformed options before capability limits",
+			async run() {
+				const error = captureValidationError(options.errorTaxonomy.createProvider?.() ?? options.createHarness().provider, options.errorTaxonomy.malformedUnsupportedOptions);
+				assert(error.code === "invalid-configuration", `Expected malformed precedence, received ${error.code}.`);
+			}
+		},
+		{
+			name: "classifies missing runtime APIs as unsupported browser",
+			async run() {
+				const provider = options.errorTaxonomy.createUnsupportedBrowserProvider();
+				let caught;
+				try {
+					await provider.doOpen({ abortSignal: new AbortController().signal });
+				} catch (error) {
+					caught = error;
+				}
+				assert(VoiceInputError.isInstance(caught), "Missing browser APIs must produce VoiceInputError.");
+				assert(caught.code === "unsupported-browser", `Expected unsupported-browser, received ${caught.code}.`);
+				assert(caught.provider === provider.provider, "Unsupported-browser errors must identify their provider.");
+			}
+		}
+	];
+}
+function captureValidationError(provider, options) {
+	let caught;
+	try {
+		provider.validateOptions(options);
+	} catch (error) {
+		caught = error;
+	}
+	assert(VoiceInputError.isInstance(caught), "Validation failures must use VoiceInputError.");
+	return caught;
+}
+//#endregion
+export { VoiceInputProviderConformanceError, createFakeVoiceInputProvider, createVoiceInputProviderV1ConformanceCases };
+
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","names":[],"sources":["../src/test.ts"],"sourcesContent":["import type {\n  VoiceInputProviderV1,\n  VoiceInputProviderV1CallOptions,\n  VoiceInputProviderV1Session,\n  VoiceInputProviderV1StreamPart,\n  VoiceTranscriptionOptions,\n} from \"./index.js\";\nimport { VoiceInputError } from \"./index.js\";\n\nexport interface FakeVoiceInputProviderOptions {\n  provider?: string;\n  modelId?: string;\n  sampleRate?: number;\n  autoOpen?: boolean;\n  autoCloseOnFinish?: boolean;\n  validateOptions?: (options: VoiceTranscriptionOptions) => void;\n}\n\nexport interface FakeVoiceInputProviderSessionSnapshot {\n  readonly callOptions: VoiceInputProviderV1CallOptions;\n  readonly audioChunks: readonly Int16Array[];\n  readonly finishCallCount: number;\n  readonly abortCallCount: number;\n  readonly closed: boolean;\n  readonly aborted: boolean;\n}\n\nexport interface FakeVoiceInputProviderController {\n  readonly sessions: readonly FakeVoiceInputProviderSessionSnapshot[];\n  waitForSession(\n    index?: number,\n  ): Promise<FakeVoiceInputProviderSessionSnapshot>;\n  resolveOpen(index?: number): void;\n  rejectOpen(error: unknown, index?: number): void;\n  emit(part: VoiceInputProviderV1StreamPart, index?: number): void;\n  close(index?: number): void;\n  fail(error: VoiceInputError, index?: number): void;\n  timeout(index?: number): PromiseLike<void> | void;\n}\n\nexport interface FakeVoiceInputProvider {\n  provider: VoiceInputProviderV1;\n  controller: FakeVoiceInputProviderController;\n}\n\ninterface MutableFakeSession {\n  segmentSequence: number;\n  callOptions: VoiceInputProviderV1CallOptions;\n  audioChunks: Int16Array[];\n  finishCallCount: number;\n  abortCallCount: number;\n  closed: boolean;\n  aborted: boolean;\n  finished: boolean;\n  opened: boolean;\n  settled: boolean;\n  streamController: ReadableStreamDefaultController<VoiceInputProviderV1StreamPart>;\n  publicSession: VoiceInputProviderV1Session;\n  open(): void;\n  reject(error: unknown): void;\n}\n\nexport function createFakeVoiceInputProvider(\n  options: FakeVoiceInputProviderOptions = {},\n): FakeVoiceInputProvider {\n  const sessions: MutableFakeSession[] = [];\n  const waiters = new Map<\n    number,\n    Array<(session: FakeVoiceInputProviderSessionSnapshot) => void>\n  >();\n  const autoOpen = options.autoOpen ?? true;\n  const autoCloseOnFinish = options.autoCloseOnFinish ?? true;\n\n  const getSession = (index = sessions.length - 1): MutableFakeSession => {\n    const session = sessions[index];\n\n    if (session === undefined) {\n      throw new Error(`Fake provider session ${index} does not exist.`);\n    }\n\n    return session;\n  };\n\n  const getSnapshot = (\n    session: MutableFakeSession,\n  ): FakeVoiceInputProviderSessionSnapshot =>\n    Object.freeze({\n      callOptions: Object.freeze({ ...session.callOptions }),\n      audioChunks: Object.freeze([...session.audioChunks]),\n      finishCallCount: session.finishCallCount,\n      abortCallCount: session.abortCallCount,\n      closed: session.closed,\n      aborted: session.aborted,\n    });\n\n  const close = (session: MutableFakeSession): void => {\n    if (session.closed) {\n      return;\n    }\n\n    session.closed = true;\n    session.streamController.close();\n  };\n\n  const emit = (part: VoiceInputProviderV1StreamPart, index?: number): void => {\n    const session = getSession(index);\n\n    if (session.closed) {\n      return;\n    }\n\n    if (part.type === \"interim\" || part.type === \"final\") {\n      session.streamController.enqueue({\n        ...part,\n        segmentId: part.segmentId ?? `fake:${session.segmentSequence}`,\n      });\n      if (part.type === \"final\") session.segmentSequence += 1;\n    } else session.streamController.enqueue(part);\n  };\n\n  const controller: FakeVoiceInputProviderController = {\n    get sessions() {\n      return Object.freeze(sessions.map(getSnapshot));\n    },\n    async waitForSession(index = 0) {\n      const session = sessions[index];\n\n      if (session !== undefined) {\n        return getSnapshot(session);\n      }\n\n      return await new Promise<FakeVoiceInputProviderSessionSnapshot>(\n        (resolve) => {\n          const existingWaiters = waiters.get(index) ?? [];\n          existingWaiters.push(resolve);\n          waiters.set(index, existingWaiters);\n        },\n      );\n    },\n    resolveOpen(index) {\n      getSession(index).open();\n    },\n    rejectOpen(error, index) {\n      getSession(index).reject(error);\n    },\n    emit,\n    close(index) {\n      close(getSession(index));\n    },\n    fail(error, index) {\n      emit({ type: \"error\", error }, index);\n      close(getSession(index));\n    },\n    timeout(index) {\n      const session = getSession(index);\n      emit(\n        {\n          type: \"error\",\n          error: new VoiceInputError({\n            code: \"network-error\",\n            message: \"The fake provider timed out.\",\n            provider: options.provider ?? \"fake\",\n            retryable: true,\n          }),\n        },\n        index,\n      );\n      close(session);\n    },\n  };\n\n  const provider: VoiceInputProviderV1 = {\n    specificationVersion: \"v1\",\n    provider: options.provider ?? \"fake\",\n    modelId: options.modelId ?? \"fake-model\",\n    sampleRate: options.sampleRate ?? 16_000,\n    validateOptions: options.validateOptions ?? (() => {}),\n    doOpen(callOptions) {\n      let streamController:\n        | ReadableStreamDefaultController<VoiceInputProviderV1StreamPart>\n        | undefined;\n      const stream = new ReadableStream<VoiceInputProviderV1StreamPart>({\n        start(controller_) {\n          streamController = controller_;\n        },\n      });\n\n      if (streamController === undefined) {\n        throw new Error(\"The fake provider stream did not initialize.\");\n      }\n\n      let resolveOpen: (\n        session: VoiceInputProviderV1Session,\n      ) => void = () => {};\n      let rejectOpen: (error: unknown) => void = () => {};\n      const openPromise = new Promise<VoiceInputProviderV1Session>(\n        (resolve, reject) => {\n          resolveOpen = resolve;\n          rejectOpen = reject;\n        },\n      );\n\n      const mutableSession: MutableFakeSession = {\n        segmentSequence: 0,\n        callOptions,\n        audioChunks: [],\n        finishCallCount: 0,\n        abortCallCount: 0,\n        closed: false,\n        aborted: false,\n        finished: false,\n        opened: false,\n        settled: false,\n        streamController,\n        publicSession: undefined as unknown as VoiceInputProviderV1Session,\n        open() {\n          if (mutableSession.settled) {\n            return;\n          }\n\n          mutableSession.opened = true;\n          mutableSession.settled = true;\n          resolveOpen(mutableSession.publicSession);\n        },\n        reject(error) {\n          if (mutableSession.settled) {\n            return;\n          }\n\n          mutableSession.settled = true;\n          close(mutableSession);\n          rejectOpen(error);\n        },\n      };\n\n      const publicSession: VoiceInputProviderV1Session = {\n        stream,\n        sendAudio(chunk) {\n          if (!mutableSession.closed && !mutableSession.aborted) {\n            mutableSession.audioChunks.push(chunk);\n          }\n        },\n        finish() {\n          if (\n            mutableSession.closed ||\n            mutableSession.aborted ||\n            mutableSession.finished\n          ) {\n            return;\n          }\n\n          mutableSession.finished = true;\n          mutableSession.finishCallCount += 1;\n\n          if (autoCloseOnFinish) {\n            close(mutableSession);\n          }\n        },\n        abort(reason) {\n          if (mutableSession.closed || mutableSession.aborted) {\n            return;\n          }\n\n          mutableSession.aborted = true;\n          mutableSession.abortCallCount += 1;\n          close(mutableSession);\n\n          if (!mutableSession.settled) {\n            mutableSession.settled = true;\n            rejectOpen(reason);\n          }\n        },\n      };\n\n      mutableSession.publicSession = publicSession;\n      const index = sessions.push(mutableSession) - 1;\n\n      for (const resolve of waiters.get(index) ?? []) {\n        resolve(getSnapshot(mutableSession));\n      }\n      waiters.delete(index);\n\n      callOptions.abortSignal.addEventListener(\n        \"abort\",\n        () => publicSession.abort(callOptions.abortSignal.reason),\n        { once: true },\n      );\n\n      if (callOptions.abortSignal.aborted) {\n        publicSession.abort(callOptions.abortSignal.reason);\n      } else if (autoOpen) {\n        mutableSession.open();\n      }\n\n      return openPromise;\n    },\n  };\n\n  return { provider, controller };\n}\n\nexport interface VoiceInputProviderV1ConformanceHarness {\n  provider: VoiceInputProviderV1;\n  controller: FakeVoiceInputProviderController;\n}\n\nexport interface VoiceInputProviderV1ConformanceCase {\n  name: string;\n  run(): Promise<void>;\n}\n\nexport interface VoiceInputProviderV1ConformanceOptions {\n  createHarness(): VoiceInputProviderV1ConformanceHarness;\n  createAccumulatorSession(\n    provider: VoiceInputProviderV1,\n    audioSource: {\n      prepare(): PromiseLike<{\n        readonly stream: ReadableStream<Int16Array>;\n        start(): PromiseLike<void> | void;\n        stop(): PromiseLike<void> | void;\n        abort(reason?: unknown): void;\n      }>;\n    },\n  ): {\n    getSnapshot(): { readonly finalTranscript: string };\n    start(): PromiseLike<void> | void;\n    cancel(): PromiseLike<void> | void;\n  };\n  errorTaxonomy: {\n    readonly createProvider?: () => VoiceInputProviderV1;\n    readonly createUnsupportedBrowserProvider: () => VoiceInputProviderV1;\n    readonly invalidOptions: VoiceTranscriptionOptions;\n    readonly malformedUnsupportedOptions: VoiceTranscriptionOptions;\n    readonly unsupportedOptions: VoiceTranscriptionOptions;\n  };\n}\n\nexport class VoiceInputProviderConformanceError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"VoiceInputProviderConformanceError\";\n  }\n}\n\nfunction assert(condition: unknown, message: string): asserts condition {\n  if (!condition) {\n    throw new VoiceInputProviderConformanceError(message);\n  }\n}\n\nasync function readStream(\n  stream: ReadableStream<VoiceInputProviderV1StreamPart>,\n): Promise<VoiceInputProviderV1StreamPart[]> {\n  const parts: VoiceInputProviderV1StreamPart[] = [];\n\n  for await (const part of stream) {\n    parts.push(part);\n  }\n\n  return parts;\n}\n\nasync function openSession(\n  harness: VoiceInputProviderV1ConformanceHarness,\n): Promise<VoiceInputProviderV1Session> {\n  const sessionPromise = Promise.resolve().then(() =>\n    harness.provider.doOpen({\n      abortSignal: new AbortController().signal,\n    }),\n  );\n  await harness.controller.waitForSession();\n  harness.controller.resolveOpen();\n  return await sessionPromise;\n}\n\nfunction createConformanceAudioSource() {\n  return {\n    prepare() {\n      let closed = false;\n      let streamController:\n        ReadableStreamDefaultController<Int16Array> | undefined;\n      const stream = new ReadableStream<Int16Array>({\n        start(controller) {\n          streamController = controller;\n        },\n      });\n      const close = (): void => {\n        if (!closed) {\n          closed = true;\n          streamController?.close();\n        }\n      };\n      return Promise.resolve({ stream, start() {}, stop: close, abort: close });\n    },\n  };\n}\n\nasync function waitFor(\n  condition: () => boolean,\n  message: string,\n): Promise<void> {\n  for (let attempt = 0; attempt < 20; attempt += 1) {\n    if (condition()) {\n      return;\n    }\n    await new Promise<void>((resolve) => setTimeout(resolve, 0));\n  }\n  throw new VoiceInputProviderConformanceError(message);\n}\n\nexport function createVoiceInputProviderV1ConformanceCases(\n  options: VoiceInputProviderV1ConformanceOptions,\n): readonly VoiceInputProviderV1ConformanceCase[] {\n  return [\n    {\n      name: \"declares valid v1 metadata and accepts baseline options\",\n      async run() {\n        const { provider } = options.createHarness();\n        assert(provider.specificationVersion === \"v1\", \"Expected v1 spec.\");\n        assert(provider.provider.length > 0, \"Provider ID must not be empty.\");\n        assert(provider.modelId.length > 0, \"Model ID must not be empty.\");\n        assert(\n          Number.isInteger(provider.sampleRate) && provider.sampleRate > 0,\n          \"Sample rate must be a positive integer.\",\n        );\n        provider.validateOptions({});\n      },\n    },\n    {\n      name: \"streams normalized parts in order and closes terminally\",\n      async run() {\n        const harness = options.createHarness();\n        const session = await openSession(harness);\n        const partsPromise = readStream(session.stream);\n        harness.controller.emit({ type: \"speech-start\" });\n        harness.controller.emit({ type: \"interim\", text: \"hel\" });\n        harness.controller.emit({ type: \"interim\", text: \"hello\" });\n        harness.controller.emit({ type: \"final\", text: \"hello\" });\n        harness.controller.emit({ type: \"speech-end\" });\n        harness.controller.close();\n        const parts = await partsPromise;\n        const transcripts = parts.filter(\n          (part) => part.type === \"interim\" || part.type === \"final\",\n        );\n        assert(\n          transcripts.every(\n            (part) =>\n              typeof part.segmentId === \"string\" && part.segmentId.length > 0,\n          ),\n          \"Normalized transcript parts must include a non-empty segmentId.\",\n        );\n        assert(\n          new Set(transcripts.map((part) => part.segmentId)).size === 1,\n          \"Interim revisions and their final must keep the same segmentId.\",\n        );\n        const partTypes = parts.map((part) => part.type);\n        assert(\n          partTypes.join(\",\") ===\n            \"speech-start,interim,interim,final,speech-end\",\n          `Unexpected stream order: ${partTypes.join(\",\")}`,\n        );\n\n        harness.controller.emit({ type: \"final\", text: \"late\" });\n        const lateReader = session.stream.getReader();\n        const lateResult = await lateReader.read();\n        lateReader.releaseLock();\n        assert(\n          lateResult.done,\n          `Output must not be emitted after closure: ${JSON.stringify(lateResult)}.`,\n        );\n      },\n    },\n    {\n      name: \"accepts audio chunks and finishes idempotently\",\n      async run() {\n        const harness = options.createHarness();\n        const session = await openSession(harness);\n        await session.sendAudio(new Int16Array([1, 2]));\n        await session.sendAudio(new Int16Array([3, 4]));\n        await session.finish();\n        await session.finish();\n        const snapshot = harness.controller.sessions[0];\n        assert(snapshot !== undefined, \"Expected a provider session.\");\n        assert(snapshot.audioChunks.length === 2, \"Expected two audio chunks.\");\n        assert(\n          snapshot.finishCallCount === 1,\n          \"finish() must have only one observable effect.\",\n        );\n      },\n    },\n    {\n      name: \"drains a delayed provider final after finish\",\n      async run() {\n        const harness = options.createHarness();\n        const session = await openSession(harness);\n        const partsPromise = readStream(session.stream);\n        await session.sendAudio(new Int16Array([1]));\n        harness.controller.emit({ type: \"interim\", text: \"draft\" });\n        const finishPromise = Promise.resolve(session.finish());\n\n        await Promise.resolve();\n        harness.controller.emit({ type: \"final\", text: \"corrected.\" });\n        harness.controller.close();\n        await finishPromise;\n\n        const parts = await partsPromise;\n        const finals = parts.filter(\n          (part) => part.type === \"final\" && part.text.length > 0,\n        );\n        assert(finals.length === 1, \"Expected one delayed final part.\");\n        assert(\n          finals[0]?.type === \"final\" && finals[0].text === \"corrected.\",\n          \"finish() must preserve the provider's corrected final text.\",\n        );\n      },\n    },\n    {\n      name: \"never promotes interim text when finish has no final\",\n      async run() {\n        const harness = options.createHarness();\n        const session = await openSession(harness);\n        const partsPromise = readStream(session.stream);\n        await session.sendAudio(new Int16Array([1]));\n        harness.controller.emit({ type: \"interim\", text: \"mutable draft\" });\n        const finishPromise = Promise.resolve(session.finish());\n\n        await Promise.resolve();\n        harness.controller.close();\n        await finishPromise;\n\n        const parts = await partsPromise;\n        assert(\n          !parts.some((part) => part.type === \"final\" && part.text.length > 0),\n          \"Interim text must not be relabeled as final during finish().\",\n        );\n      },\n    },\n    {\n      name: \"feeds multiple final chunks through the shared accumulator\",\n      async run() {\n        const harness = options.createHarness();\n        const accumulator = options.createAccumulatorSession(\n          harness.provider,\n          createConformanceAudioSource(),\n        );\n        const startPromise = Promise.resolve(accumulator.start());\n        await harness.controller.waitForSession();\n        harness.controller.resolveOpen();\n        await startPromise;\n        harness.controller.emit({ type: \"final\", text: \"one\" });\n        harness.controller.emit({ type: \"final\", text: \"two\" });\n        harness.controller.emit({ type: \"final\", text: \",\" });\n        harness.controller.emit({ type: \"final\", text: \"three\" });\n        await waitFor(\n          () => accumulator.getSnapshot().finalTranscript === \"one two, three\",\n          `Unexpected accumulated transcript: ${accumulator.getSnapshot().finalTranscript}`,\n        );\n        await accumulator.cancel();\n      },\n    },\n    {\n      name: \"maps a terminal timeout and closes the stream\",\n      async run() {\n        const harness = options.createHarness();\n        const session = await openSession(harness);\n        const partsPromise = readStream(session.stream);\n        await session.sendAudio(new Int16Array([1]));\n        const finishOutcome = Promise.resolve(session.finish()).then(\n          () => undefined,\n          () => undefined,\n        );\n\n        await harness.controller.timeout();\n        await finishOutcome;\n        const parts = await partsPromise;\n        const errorParts = parts.filter((part) => part.type === \"error\");\n        assert(errorParts.length === 1, \"Expected one terminal timeout error.\");\n        assert(\n          errorParts[0]?.error.code === \"network-error\",\n          `Expected network-error, received ${errorParts[0]?.error.code}.`,\n        );\n        assert(\n          errorParts[0]?.error.retryable,\n          \"Provider timeouts must be retryable.\",\n        );\n      },\n    },\n    {\n      name: \"aborts immediately and idempotently\",\n      async run() {\n        const harness = options.createHarness();\n        const session = await openSession(harness);\n        const partsPromise = readStream(session.stream);\n        session.abort(\"test\");\n        session.abort(\"test-again\");\n        await partsPromise;\n        const snapshot = harness.controller.sessions[0];\n        assert(snapshot?.aborted, \"Session was not marked aborted.\");\n        assert(snapshot.closed, \"Abort must close the provider session.\");\n        assert(\n          snapshot.abortCallCount === 1,\n          \"abort() must have only one observable effect.\",\n        );\n        harness.controller.emit({ type: \"final\", text: \"late\" });\n        const lateReader = session.stream.getReader();\n        const lateResult = await lateReader.read();\n        lateReader.releaseLock();\n        assert(\n          lateResult.done,\n          `Output must not be emitted after abort: ${JSON.stringify(lateResult)}.`,\n        );\n      },\n    },\n    {\n      name: \"honors abort signals while opening\",\n      async run() {\n        const harness = options.createHarness();\n        const abortController = new AbortController();\n        const sessionPromise = Promise.resolve().then(() =>\n          harness.provider.doOpen({ abortSignal: abortController.signal }),\n        );\n        await harness.controller.waitForSession();\n        abortController.abort(\"cancelled\");\n\n        let rejected = false;\n        try {\n          await sessionPromise;\n        } catch {\n          rejected = true;\n        }\n\n        assert(rejected, \"An aborted open must reject.\");\n        assert(\n          harness.controller.sessions[0]?.aborted,\n          \"An aborted open must tear down its pending session.\",\n        );\n      },\n    },\n    {\n      name: \"reports an abnormal failure before stream completion\",\n      async run() {\n        const harness = options.createHarness();\n        const session = await openSession(harness);\n        const partsPromise = readStream(session.stream);\n        harness.controller.fail(\n          new VoiceInputError({\n            code: \"provider-error\",\n            message: \"Synthetic provider failure.\",\n            provider: harness.provider.provider,\n          }),\n        );\n        const parts = await partsPromise;\n        assert(parts.length === 1, \"Expected exactly one error part.\");\n        assert(parts[0]?.type === \"error\", \"Expected an error part.\");\n        assert(\n          parts[0]?.type === \"error\" &&\n            VoiceInputError.isInstance(parts[0].error),\n          \"Provider failures must use VoiceInputError.\",\n        );\n      },\n    },\n    {\n      name: \"classifies malformed portable options as invalid configuration\",\n      async run() {\n        const provider =\n          options.errorTaxonomy.createProvider?.() ??\n          options.createHarness().provider;\n        const error = captureValidationError(\n          provider,\n          options.errorTaxonomy.invalidOptions,\n        );\n        assert(\n          error.code === \"invalid-configuration\",\n          `Expected invalid-configuration, received ${error.code}.`,\n        );\n        assert(\n          error.provider === provider.provider,\n          \"Validation errors must identify their provider.\",\n        );\n        assert(\n          error.cause instanceof Error,\n          \"Invalid configuration must preserve its validation cause.\",\n        );\n      },\n    },\n    {\n      name: \"classifies valid unavailable options as unsupported features\",\n      async run() {\n        const provider =\n          options.errorTaxonomy.createProvider?.() ??\n          options.createHarness().provider;\n        const error = captureValidationError(\n          provider,\n          options.errorTaxonomy.unsupportedOptions,\n        );\n        assert(\n          error.code === \"unsupported-feature\",\n          `Expected unsupported-feature, received ${error.code}.`,\n        );\n        assert(\n          error.provider === provider.provider,\n          \"Unsupported-feature errors must identify their provider.\",\n        );\n      },\n    },\n    {\n      name: \"reports malformed options before capability limits\",\n      async run() {\n        const provider =\n          options.errorTaxonomy.createProvider?.() ??\n          options.createHarness().provider;\n        const error = captureValidationError(\n          provider,\n          options.errorTaxonomy.malformedUnsupportedOptions,\n        );\n        assert(\n          error.code === \"invalid-configuration\",\n          `Expected malformed precedence, received ${error.code}.`,\n        );\n      },\n    },\n    {\n      name: \"classifies missing runtime APIs as unsupported browser\",\n      async run() {\n        const provider =\n          options.errorTaxonomy.createUnsupportedBrowserProvider();\n        let caught: unknown;\n        try {\n          await provider.doOpen({\n            abortSignal: new AbortController().signal,\n          });\n        } catch (error) {\n          caught = error;\n        }\n        assert(\n          VoiceInputError.isInstance(caught),\n          \"Missing browser APIs must produce VoiceInputError.\",\n        );\n        assert(\n          caught.code === \"unsupported-browser\",\n          `Expected unsupported-browser, received ${caught.code}.`,\n        );\n        assert(\n          caught.provider === provider.provider,\n          \"Unsupported-browser errors must identify their provider.\",\n        );\n      },\n    },\n  ];\n}\n\nfunction captureValidationError(\n  provider: VoiceInputProviderV1,\n  options: VoiceTranscriptionOptions,\n): VoiceInputError {\n  let caught: unknown;\n  try {\n    provider.validateOptions(options);\n  } catch (error) {\n    caught = error;\n  }\n  assert(\n    VoiceInputError.isInstance(caught),\n    \"Validation failures must use VoiceInputError.\",\n  );\n  return caught;\n}\n"],"mappings":"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"}

package/dist/transport.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_index = require("./index.cjs");
+//#region src/transport.ts
+const MAX_BUFFERED_BYTES = 1048576;
+const DRAIN_TIMEOUT_MS = 5e3;
+/** Keeps nominal sends synchronous; congested sends are abortable and bounded. */
+function sendWithBackpressure(socket, bytes, signal, provider, send) {
+	const failure = () => new require_index.VoiceInputError({
+		code: "network-error",
+		provider,
+		retryable: true,
+		message: `The ${provider} audio connection is stalled or closed.`
+	});
+	if (signal.aborted || socket.readyState !== 1 || bytes > MAX_BUFFERED_BYTES) throw failure();
+	if ((socket.bufferedAmount ?? 0) + bytes <= MAX_BUFFERED_BYTES) return send();
+	return new Promise((resolve, reject) => {
+		const started = Date.now();
+		let timer;
+		const cleanup = () => {
+			clearTimeout(timer);
+			signal.removeEventListener("abort", abort);
+		};
+		const abort = () => {
+			cleanup();
+			reject(failure());
+		};
+		const check = () => {
+			if (signal.aborted || socket.readyState !== 1 || Date.now() - started >= DRAIN_TIMEOUT_MS) abort();
+			else if ((socket.bufferedAmount ?? 0) + bytes <= MAX_BUFFERED_BYTES) {
+				cleanup();
+				try {
+					send();
+					resolve();
+				} catch (error) {
+					reject(error);
+				}
+			} else timer = setTimeout(check, 25);
+		};
+		signal.addEventListener("abort", abort, { once: true });
+		timer = setTimeout(check, 25);
+	});
+}
+//#endregion
+exports.sendWithBackpressure = sendWithBackpressure;
+
+//# sourceMappingURL=transport.cjs.map