@transcribe-api/sdk 0.1.1 → 0.1.3

package/README.md

@@ -10,8 +10,8 @@ npm install @transcribe-api/sdk
 
 ## Usage
 
-```js
-import { TranscribeAPI } from "@transcribe-api/sdk";
+```js
+import { TranscribeAPI } from "@transcribe-api/sdk";
 
 const client = new TranscribeAPI({
   apiKey: "YOUR_API_KEY",
@@ -54,8 +54,14 @@ const mixedBatchJob = await client.batch.transcribe({
     { reference_id: "episode_1", file: "local.mp3" },
     { reference_id: "episode_2", url: "https://signed-get-url-2" },
   ],
-});
-```
+});
+```
+
+For Cloudflare Workers and other web-style runtimes, use the Worker entrypoint:
+
+```js
+import { TranscribeAPI } from "@transcribe-api/sdk/worker";
+```
 
 Async uploads use signed R2 URLs returned by the API. Multipart upload is used automatically when the backend returns a multipart flow.
 Async job creation now goes through `POST /v1/transcribe` for single-file and batch jobs. For batch calls, each item must be `{ reference_id, file }` or `{ reference_id, url }`, and local plus remote entries can be mixed in the same batch. The SDK adds `size_bytes` automatically for large local files when the backend needs multipart upload.
@@ -65,3 +71,5 @@ The SDK defaults `multipartConcurrency` to `8` for reliability. You can increase
 For Node path uploads, multipart progress is persisted to a sidecar resume file and the SDK will resume the existing big-file job on the next run instead of starting over.
 Multipart uploads also adaptively reduce concurrency on retryable transport errors instead of failing the whole upload immediately.
 Set `showLogs: true` on the client or per async call to let the SDK print upload URL receipt, upload progress, and the final `/upload-completed` response automatically. Pass a custom `logger` object if you want those messages redirected somewhere other than `console`.
+
+Use `@transcribe-api/sdk/worker` when you need a runtime-safe build for Cloudflare Workers. The Worker entrypoint supports remote URLs, `Blob`, `File`, and byte inputs, but does not support local file path strings or Node.js filesystem resume state.

package/index.js

@@ -15,24 +15,34 @@ const TERMINAL_JOB_STATUSES = new Set(["completed", "failed", "insufficient_fund
 const BATCH_MP4_UNSUPPORTED_MESSAGE = "Batch uploads do not support .mp4 for MVP. Supported batch audio formats: mp3, mpeg, mpga, m4a, wav, webm.";
 const BATCH_UNSUPPORTED_MESSAGE = "Unsupported batch audio format. Supported batch audio formats: mp3, mpeg, mpga, m4a, wav, webm.";
 
-export class TranscribeAPIError extends Error {
-  constructor(error, { status = null, code = null, extra = null, response = null } = {}) {
-    super(error);
-    this.name = "TranscribeAPIError";
-    this.status = status;
-    this.code = code;
-    this.error = error;
-    this.response = response;
-    if (extra && typeof extra === "object") {
-      for (const [key, value] of Object.entries(extra)) {
-        if (key === "status" || key === "stack" || key === "name") {
-          continue;
-        }
-        this[key] = value;
-      }
-    }
-  }
-}
+export class TranscribeAPIError extends Error {
+  constructor(message, { status = null, code = null, extra = null, response = null } = {}) {
+    super(message);
+    this.name = "TranscribeAPIError";
+    this.status = status;
+    this.code = code;
+    this.response = response || { message, ...(code ? { code } : {}) };
+    if (extra && typeof extra === "object") {
+      for (const [key, value] of Object.entries(extra)) {
+        if (key === "status" || key === "stack" || key === "name" || key === "message" || key === "code") {
+          continue;
+        }
+        this[key] = value;
+      }
+    }
+  }
+
+  toJSON() {
+    return {
+      message: this.message,
+      ...(this.code ? { code: this.code } : {}),
+      ...Object.fromEntries(
+        Object.entries(this)
+          .filter(([key]) => !["name", "status", "code", "response"].includes(key)),
+      ),
+    };
+  }
+}
 
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -803,16 +813,25 @@ async function parseApiResponse(response) {
   } catch {
     data = { raw: text };
   }
-  if (!response.ok) {
-    throw new TranscribeAPIError(data.error || text || `HTTP ${response.status}`, {
-      status: response.status,
-      code: data.code || null,
-      extra: data,
-      response: data,
-    });
-  }
-  return data;
-}
+  if (!response.ok) {
+    const message = data.message || data.error || text || `HTTP ${response.status}`;
+    const extra = { ...data };
+    delete extra.message;
+    delete extra.error;
+    delete extra.code;
+    throw new TranscribeAPIError(message, {
+      status: response.status,
+      code: data.code || null,
+      extra,
+      response: {
+        message,
+        ...(data.code ? { code: data.code } : {}),
+        ...extra,
+      },
+    });
+  }
+  return data;
+}
 
 function normalizeHeaders(headers = {}) {
   return Object.fromEntries(

package/package.json

@@ -1,26 +1,28 @@
-{
-  "name": "@transcribe-api/sdk",
-  "version": "0.1.1",
-  "description": "Official JavaScript SDK for Transcribe API.",
-  "type": "module",
-  "main": "index.js",
+{
+  "name": "@transcribe-api/sdk",
+  "version": "0.1.3",
+  "description": "Official JavaScript SDK for Transcribe API.",
+  "type": "module",
+  "main": "index.js",
   "exports": {
-    ".": "./index.js"
+    ".": "./index.js",
+    "./worker": "./worker.js"
   },
   "scripts": {
     "test": "node --test"
   },
   "files": [
     "index.js",
+    "worker.js",
     "README.md"
   ],
-  "keywords": [
-    "transcription",
-    "speech-to-text",
-    "whisper",
-    "audio",
-    "api"
-  ],
-  "author": "Transcribe API",
-  "license": "MIT"
-}
+  "keywords": [
+    "transcription",
+    "speech-to-text",
+    "whisper",
+    "audio",
+    "api"
+  ],
+  "author": "Transcribe API",
+  "license": "MIT"
+}