@transcribe-api/sdk 0.1.6 → 0.1.7

package/README.md

@@ -185,7 +185,7 @@ You can also pass a comma-separated string:
 exclude: "metadata,billing"
 ```
 
-If `exclude` leaves only one transcript field and removes metadata, billing, and detected language, the API returns that remaining value directly instead of a JSON object. For example, text-only responses return a plain string, VTT-only responses return a plain string, and segments-only responses return an array.
+For single-file outputs, if `exclude` leaves only one transcript field and removes metadata, billing, and detected language, the API returns that remaining value directly instead of a JSON object. Text-only responses return a plain string, VTT-only responses return a plain string, and segments-only responses return an array. Multi-file outputs still return JSON so each result stays associated with its `reference_id`.
 
 ## Webhooks
 

package/index.js

@@ -1364,8 +1364,6 @@ export class TranscribeAPI {
         : (normalizedItem.durationEstimateSec || await estimateDurationFromFile(normalizedSingleFile));
       const effectiveLanguage = normalizedItem.hasLanguage ? normalizedItem.language : normalizeLanguageCode(language);
       const isAsync = files.length > 1
-        || Boolean(normalizedItem.url)
-        || Boolean(webhookUrl)
         || (
           normalizedSingleFile
           && (
@@ -1387,6 +1385,18 @@ export class TranscribeAPI {
         });
       }
 
+      if (normalizedItem.url) {
+        return this.transcribeUrlDirect({
+          url: normalizedItem.url,
+          referenceId: normalizedItem.referenceId,
+          language: effectiveLanguage,
+          exclude,
+          webhookUrl,
+          showLogs: showLogs ?? this.showLogs,
+          logger: logger ?? this.logger,
+        });
+      }
+
       return this.transcribeDirect({
         file: normalizedSingleFile,
         referenceId: normalizedItem.referenceId,
@@ -1485,6 +1495,44 @@ export class TranscribeAPI {
     return result;
   }
 
+  async transcribeUrlDirect({
+    url,
+    referenceId,
+    language,
+    exclude,
+    webhookUrl,
+    showLogs = false,
+    logger = console,
+  } = {}) {
+    const form = new FormData();
+    form.set("url", String(url || "").trim());
+    if (String(referenceId || "").trim()) form.set("reference_id", String(referenceId).trim());
+    if (language) form.set("language", language);
+    if (exclude) form.set("exclude", Array.isArray(exclude) ? exclude.join(",") : exclude);
+    if (webhookUrl) form.set("webhook_url", webhookUrl);
+
+    const response = await fetch(`${this.baseUrl}/transcribe`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+      },
+      body: form,
+    });
+    const result = await parseApiResponse(response);
+    if (this.polling && result && typeof result === "object" && result.job_status && !TERMINAL_JOB_STATUSES.has(String(result.job_status))) {
+      return this.waitForJobCompletion(result.job_id, {
+        polling: this.polling,
+        showLogs,
+        logger,
+        initialJob: result,
+      });
+    }
+    if (showLogs && typeof logger?.log === "function") {
+      logger.log(typeof result === "string" ? result : JSON.stringify(result, null, 2));
+    }
+    return result;
+  }
+
   async transcribeMany({
     files,
     webhookUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@transcribe-api/sdk",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Official JavaScript SDK for Transcribe API.",
   "type": "module",
   "main": "index.js",

package/worker.js

@@ -1364,8 +1364,6 @@ export class TranscribeAPI {
         : (normalizedItem.durationEstimateSec || await estimateDurationFromFile(normalizedSingleFile));
       const effectiveLanguage = normalizedItem.hasLanguage ? normalizedItem.language : normalizeLanguageCode(language);
       const isAsync = files.length > 1
-        || Boolean(normalizedItem.url)
-        || Boolean(webhookUrl)
         || (
           normalizedSingleFile
           && (
@@ -1387,6 +1385,18 @@ export class TranscribeAPI {
         });
       }
 
+      if (normalizedItem.url) {
+        return this.transcribeUrlDirect({
+          url: normalizedItem.url,
+          referenceId: normalizedItem.referenceId,
+          language: effectiveLanguage,
+          exclude,
+          webhookUrl,
+          showLogs: showLogs ?? this.showLogs,
+          logger: logger ?? this.logger,
+        });
+      }
+
       return this.transcribeDirect({
         file: normalizedSingleFile,
         referenceId: normalizedItem.referenceId,
@@ -1485,6 +1495,44 @@ export class TranscribeAPI {
     return result;
   }
 
+  async transcribeUrlDirect({
+    url,
+    referenceId,
+    language,
+    exclude,
+    webhookUrl,
+    showLogs = false,
+    logger = console,
+  } = {}) {
+    const form = new FormData();
+    form.set("url", String(url || "").trim());
+    if (String(referenceId || "").trim()) form.set("reference_id", String(referenceId).trim());
+    if (language) form.set("language", language);
+    if (exclude) form.set("exclude", Array.isArray(exclude) ? exclude.join(",") : exclude);
+    if (webhookUrl) form.set("webhook_url", webhookUrl);
+
+    const response = await fetch(`${this.baseUrl}/transcribe`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+      },
+      body: form,
+    });
+    const result = await parseApiResponse(response);
+    if (this.polling && result && typeof result === "object" && result.job_status && !TERMINAL_JOB_STATUSES.has(String(result.job_status))) {
+      return this.waitForJobCompletion(result.job_id, {
+        polling: this.polling,
+        showLogs,
+        logger,
+        initialJob: result,
+      });
+    }
+    if (showLogs && typeof logger?.log === "function") {
+      logger.log(typeof result === "string" ? result : JSON.stringify(result, null, 2));
+    }
+    return result;
+  }
+
   async transcribeMany({
     files,
     webhookUrl,