@voiceinput/provider 0.1.0-beta.1

package/dist/transport.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.cjs","names":["VoiceInputError"],"sources":["../src/transport.ts"],"sourcesContent":["import { VoiceInputError } from \"./index.js\";\n\nconst MAX_BUFFERED_BYTES = 1024 * 1024;\nconst DRAIN_TIMEOUT_MS = 5_000;\n\n/** Keeps nominal sends synchronous; congested sends are abortable and bounded. */\nexport function sendWithBackpressure(\n  socket: { readonly bufferedAmount: number; readonly readyState: number },\n  bytes: number,\n  signal: AbortSignal,\n  provider: string,\n  send: () => void,\n): Promise<void> | void {\n  const failure = () =>\n    new VoiceInputError({\n      code: \"network-error\",\n      provider,\n      retryable: true,\n      message: `The ${provider} audio connection is stalled or closed.`,\n    });\n  if (signal.aborted || socket.readyState !== 1 || bytes > MAX_BUFFERED_BYTES)\n    throw failure();\n  if ((socket.bufferedAmount ?? 0) + bytes <= MAX_BUFFERED_BYTES) return send();\n  return new Promise<void>((resolve, reject) => {\n    const started = Date.now();\n    let timer: ReturnType<typeof setTimeout>;\n    const cleanup = (): void => {\n      clearTimeout(timer);\n      signal.removeEventListener(\"abort\", abort);\n    };\n    const abort = (): void => {\n      cleanup();\n      reject(failure());\n    };\n    const check = (): void => {\n      if (\n        signal.aborted ||\n        socket.readyState !== 1 ||\n        Date.now() - started >= DRAIN_TIMEOUT_MS\n      ) {\n        abort();\n      } else if ((socket.bufferedAmount ?? 0) + bytes <= MAX_BUFFERED_BYTES) {\n        cleanup();\n        try {\n          send();\n          resolve();\n        } catch (error) {\n          reject(error);\n        }\n      } else timer = setTimeout(check, 25);\n    };\n    signal.addEventListener(\"abort\", abort, { once: true });\n    timer = setTimeout(check, 25);\n  });\n}\n"],"mappings":";;;AAEA,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;;AAGzB,SAAgB,qBACd,QACA,OACA,QACA,UACA,MACsB;CACtB,MAAM,gBACJ,IAAIA,cAAAA,gBAAgB;EAClB,MAAM;EACN;EACA,WAAW;EACX,SAAS,OAAO,SAAS;CAC3B,CAAC;CACH,IAAI,OAAO,WAAW,OAAO,eAAe,KAAK,QAAQ,oBACvD,MAAM,QAAQ;CAChB,KAAK,OAAO,kBAAkB,KAAK,SAAS,oBAAoB,OAAO,KAAK;CAC5E,OAAO,IAAI,SAAe,SAAS,WAAW;EAC5C,MAAM,UAAU,KAAK,IAAI;EACzB,IAAI;EACJ,MAAM,gBAAsB;GAC1B,aAAa,KAAK;GAClB,OAAO,oBAAoB,SAAS,KAAK;EAC3C;EACA,MAAM,cAAoB;GACxB,QAAQ;GACR,OAAO,QAAQ,CAAC;EAClB;EACA,MAAM,cAAoB;GACxB,IACE,OAAO,WACP,OAAO,eAAe,KACtB,KAAK,IAAI,IAAI,WAAW,kBAExB,MAAM;QACD,KAAK,OAAO,kBAAkB,KAAK,SAAS,oBAAoB;IACrE,QAAQ;IACR,IAAI;KACF,KAAK;KACL,QAAQ;IACV,SAAS,OAAO;KACd,OAAO,KAAK;IACd;GACF,OAAO,QAAQ,WAAW,OAAO,EAAE;EACrC;EACA,OAAO,iBAAiB,SAAS,OAAO,EAAE,MAAM,KAAK,CAAC;EACtD,QAAQ,WAAW,OAAO,EAAE;CAC9B,CAAC;AACH"}

package/dist/transport.d.cts

@@ -0,0 +1,9 @@
+//#region src/transport.d.ts
+/** Keeps nominal sends synchronous; congested sends are abortable and bounded. */
+declare function sendWithBackpressure(socket: {
+  readonly bufferedAmount: number;
+  readonly readyState: number;
+}, bytes: number, signal: AbortSignal, provider: string, send: () => void): Promise<void> | void;
+//#endregion
+export { sendWithBackpressure };
+//# sourceMappingURL=transport.d.cts.map

package/dist/transport.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.cts","names":[],"sources":["../src/transport.ts"],"mappings":";;iBAMgB,qBACd;WAAmB;WAAiC;GACpD,eACA,QAAQ,aACR,kBACA,mBACC"}

package/dist/transport.d.ts

@@ -0,0 +1,9 @@
+//#region src/transport.d.ts
+/** Keeps nominal sends synchronous; congested sends are abortable and bounded. */
+declare function sendWithBackpressure(socket: {
+  readonly bufferedAmount: number;
+  readonly readyState: number;
+}, bytes: number, signal: AbortSignal, provider: string, send: () => void): Promise<void> | void;
+//#endregion
+export { sendWithBackpressure };
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","names":[],"sources":["../src/transport.ts"],"mappings":";;iBAMgB,qBACd;WAAmB;WAAiC;GACpD,eACA,QAAQ,aACR,kBACA,mBACC"}

package/dist/transport.js

@@ -0,0 +1,45 @@
+import { VoiceInputError } from "./index.js";
+//#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 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
+export { sendWithBackpressure };
+
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","names":[],"sources":["../src/transport.ts"],"sourcesContent":["import { VoiceInputError } from \"./index.js\";\n\nconst MAX_BUFFERED_BYTES = 1024 * 1024;\nconst DRAIN_TIMEOUT_MS = 5_000;\n\n/** Keeps nominal sends synchronous; congested sends are abortable and bounded. */\nexport function sendWithBackpressure(\n  socket: { readonly bufferedAmount: number; readonly readyState: number },\n  bytes: number,\n  signal: AbortSignal,\n  provider: string,\n  send: () => void,\n): Promise<void> | void {\n  const failure = () =>\n    new VoiceInputError({\n      code: \"network-error\",\n      provider,\n      retryable: true,\n      message: `The ${provider} audio connection is stalled or closed.`,\n    });\n  if (signal.aborted || socket.readyState !== 1 || bytes > MAX_BUFFERED_BYTES)\n    throw failure();\n  if ((socket.bufferedAmount ?? 0) + bytes <= MAX_BUFFERED_BYTES) return send();\n  return new Promise<void>((resolve, reject) => {\n    const started = Date.now();\n    let timer: ReturnType<typeof setTimeout>;\n    const cleanup = (): void => {\n      clearTimeout(timer);\n      signal.removeEventListener(\"abort\", abort);\n    };\n    const abort = (): void => {\n      cleanup();\n      reject(failure());\n    };\n    const check = (): void => {\n      if (\n        signal.aborted ||\n        socket.readyState !== 1 ||\n        Date.now() - started >= DRAIN_TIMEOUT_MS\n      ) {\n        abort();\n      } else if ((socket.bufferedAmount ?? 0) + bytes <= MAX_BUFFERED_BYTES) {\n        cleanup();\n        try {\n          send();\n          resolve();\n        } catch (error) {\n          reject(error);\n        }\n      } else timer = setTimeout(check, 25);\n    };\n    signal.addEventListener(\"abort\", abort, { once: true });\n    timer = setTimeout(check, 25);\n  });\n}\n"],"mappings":";;AAEA,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;;AAGzB,SAAgB,qBACd,QACA,OACA,QACA,UACA,MACsB;CACtB,MAAM,gBACJ,IAAI,gBAAgB;EAClB,MAAM;EACN;EACA,WAAW;EACX,SAAS,OAAO,SAAS;CAC3B,CAAC;CACH,IAAI,OAAO,WAAW,OAAO,eAAe,KAAK,QAAQ,oBACvD,MAAM,QAAQ;CAChB,KAAK,OAAO,kBAAkB,KAAK,SAAS,oBAAoB,OAAO,KAAK;CAC5E,OAAO,IAAI,SAAe,SAAS,WAAW;EAC5C,MAAM,UAAU,KAAK,IAAI;EACzB,IAAI;EACJ,MAAM,gBAAsB;GAC1B,aAAa,KAAK;GAClB,OAAO,oBAAoB,SAAS,KAAK;EAC3C;EACA,MAAM,cAAoB;GACxB,QAAQ;GACR,OAAO,QAAQ,CAAC;EAClB;EACA,MAAM,cAAoB;GACxB,IACE,OAAO,WACP,OAAO,eAAe,KACtB,KAAK,IAAI,IAAI,WAAW,kBAExB,MAAM;QACD,KAAK,OAAO,kBAAkB,KAAK,SAAS,oBAAoB;IACrE,QAAQ;IACR,IAAI;KACF,KAAK;KACL,QAAQ;IACV,SAAS,OAAO;KACd,OAAO,KAAK;IACd;GACF,OAAO,QAAQ,WAAW,OAAO,EAAE;EACrC;EACA,OAAO,iBAAiB,SAAS,OAAO,EAAE,MAAM,KAAK,CAAC;EACtD,QAAQ,WAAW,OAAO,EAAE;CAC9B,CAAC;AACH"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@voiceinput/provider",
+  "version": "0.1.0-beta.1",
+  "description": "Versioned provider contracts and conformance tools for VoiceInput.",
+  "keywords": [
+    "voice-input",
+    "speech-to-text",
+    "transcription",
+    "provider"
+  ],
+  "homepage": "https://voiceinput.dev/docs/provider",
+  "bugs": {
+    "url": "https://github.com/VoiceInput/voiceinput/issues"
+  },
+  "author": "VoiceInput contributors",
+  "maintainers": [
+    "Hirad Arshadi (https://github.com/hiradary)"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VoiceInput/voiceinput.git",
+    "directory": "packages/provider"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./test": {
+      "import": {
+        "types": "./dist/test.d.ts",
+        "default": "./dist/test.js"
+      },
+      "require": {
+        "types": "./dist/test.d.cts",
+        "default": "./dist/test.cjs"
+      }
+    },
+    "./transport": {
+      "import": {
+        "types": "./dist/transport.d.ts",
+        "default": "./dist/transport.js"
+      },
+      "require": {
+        "types": "./dist/transport.d.cts",
+        "default": "./dist/transport.cjs"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/test.ts src/transport.ts",
+    "dev": "tsdown src/index.ts src/test.ts --watch --no-clean",
+    "pack": "pnpm pack --pack-destination .",
+    "test": "vitest run",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "lint": "oxlint --config ../../.oxlintrc.json .",
+    "format:check": "prettier --check ."
+  }
+}