assemblyai 4.35.0 → 4.35.4

package/dist/browser.mjs

@@ -28,7 +28,7 @@ if (typeof navigator !== "undefined" && navigator.userAgent) {
     defaultUserAgentString += navigator.userAgent;
 }
 const defaultUserAgent = {
-    sdk: { name: "JavaScript", version: "4.35.0" },
+    sdk: { name: "JavaScript", version: "4.35.4" },
 };
 if (typeof process !== "undefined") {
     if (process.versions.node && defaultUserAgentString.indexOf("Node") === -1) {
@@ -1053,6 +1053,10 @@ class StreamingTranscriber {
         if (!(this.token || this.apiKey)) {
             throw new Error("API key or temporary token is required.");
         }
+        const isOpus = params.encoding === "opus" || params.encoding === "ogg_opus";
+        if (params.sampleRate === undefined && (!isOpus || params.channels)) {
+            throw new Error('`sampleRate` is required; it may only be omitted when `encoding` is "opus" or "ogg_opus" (the Opus stream is self-describing) and dual-channel mode is not used.');
+        }
         if (params.channels) {
             if (params.channels.length !== 2) {
                 throw new Error("StreamingTranscriber.channels must have exactly 2 entries.");
@@ -1078,10 +1082,12 @@ class StreamingTranscriber {
                 "speaker-history") {
                 this.speakerHistory = new Map();
             }
-            // 20 ms VAD frames at the transcriber's target sample rate.
-            this.vadFrameSamples = Math.max(1, Math.round(params.sampleRate * 0.02));
-            this.minChunkSamples = Math.max(1, Math.round(params.sampleRate * (MIN_CHUNK_MS / 1000)));
-            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(params.sampleRate * (MAX_CHUNK_MS / 1000)));
+            // 20 ms VAD frames at the transcriber's target sample rate. The
+            // constructor check above guarantees sampleRate in dual-channel mode.
+            const sampleRate = params.sampleRate;
+            this.vadFrameSamples = Math.max(1, Math.round(sampleRate * 0.02));
+            this.minChunkSamples = Math.max(1, Math.round(sampleRate * (MIN_CHUNK_MS / 1000)));
+            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(sampleRate * (MAX_CHUNK_MS / 1000)));
             this.channelBuffers = new Map(names.map((n) => [n, []]));
             this.channelSamplesReceived = new Map(names.map((n) => [n, 0]));
             this.channelVadFloatBuffers = new Map(names.map((n) => [n, new Float32Array(this.vadFrameSamples)]));
@@ -1099,7 +1105,9 @@ class StreamingTranscriber {
         if (this.token) {
             searchParams.set("token", this.token);
         }
-        searchParams.set("sample_rate", this.params.sampleRate.toString());
+        if (this.params.sampleRate !== undefined) {
+            searchParams.set("sample_rate", this.params.sampleRate.toString());
+        }
         if (this.params.endOfTurnConfidenceThreshold) {
             searchParams.set("end_of_turn_confidence_threshold", this.params.endOfTurnConfidenceThreshold.toString());
         }
@@ -1151,8 +1159,12 @@ class StreamingTranscriber {
             searchParams.set("speech_model", this.params.speechModel.toString());
         }
         if (this.params.languageCode !== undefined) {
+            console.warn("[Deprecation Warning] `languageCode` is deprecated and will be removed in a future release. Please use `languageCodes` instead.");
             searchParams.set("language_code", this.params.languageCode);
         }
+        if (this.params.languageCodes !== undefined) {
+            searchParams.set("language_codes", JSON.stringify(this.params.languageCodes));
+        }
         if (this.params.languageDetection !== undefined) {
             searchParams.set("language_detection", this.params.languageDetection.toString());
         }

package/dist/bun.mjs

@@ -30,7 +30,7 @@ if (typeof navigator !== "undefined" && navigator.userAgent) {
     defaultUserAgentString += navigator.userAgent;
 }
 const defaultUserAgent = {
-    sdk: { name: "JavaScript", version: "4.35.0" },
+    sdk: { name: "JavaScript", version: "4.35.4" },
 };
 if (typeof process !== "undefined") {
     if (process.versions.node && defaultUserAgentString.indexOf("Node") === -1) {
@@ -1034,6 +1034,10 @@ class StreamingTranscriber {
         if (!(this.token || this.apiKey)) {
             throw new Error("API key or temporary token is required.");
         }
+        const isOpus = params.encoding === "opus" || params.encoding === "ogg_opus";
+        if (params.sampleRate === undefined && (!isOpus || params.channels)) {
+            throw new Error('`sampleRate` is required; it may only be omitted when `encoding` is "opus" or "ogg_opus" (the Opus stream is self-describing) and dual-channel mode is not used.');
+        }
         if (params.channels) {
             if (params.channels.length !== 2) {
                 throw new Error("StreamingTranscriber.channels must have exactly 2 entries.");
@@ -1059,10 +1063,12 @@ class StreamingTranscriber {
                 "speaker-history") {
                 this.speakerHistory = new Map();
             }
-            // 20 ms VAD frames at the transcriber's target sample rate.
-            this.vadFrameSamples = Math.max(1, Math.round(params.sampleRate * 0.02));
-            this.minChunkSamples = Math.max(1, Math.round(params.sampleRate * (MIN_CHUNK_MS / 1000)));
-            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(params.sampleRate * (MAX_CHUNK_MS / 1000)));
+            // 20 ms VAD frames at the transcriber's target sample rate. The
+            // constructor check above guarantees sampleRate in dual-channel mode.
+            const sampleRate = params.sampleRate;
+            this.vadFrameSamples = Math.max(1, Math.round(sampleRate * 0.02));
+            this.minChunkSamples = Math.max(1, Math.round(sampleRate * (MIN_CHUNK_MS / 1000)));
+            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(sampleRate * (MAX_CHUNK_MS / 1000)));
             this.channelBuffers = new Map(names.map((n) => [n, []]));
             this.channelSamplesReceived = new Map(names.map((n) => [n, 0]));
             this.channelVadFloatBuffers = new Map(names.map((n) => [n, new Float32Array(this.vadFrameSamples)]));
@@ -1080,7 +1086,9 @@ class StreamingTranscriber {
         if (this.token) {
             searchParams.set("token", this.token);
         }
-        searchParams.set("sample_rate", this.params.sampleRate.toString());
+        if (this.params.sampleRate !== undefined) {
+            searchParams.set("sample_rate", this.params.sampleRate.toString());
+        }
         if (this.params.endOfTurnConfidenceThreshold) {
             searchParams.set("end_of_turn_confidence_threshold", this.params.endOfTurnConfidenceThreshold.toString());
         }
@@ -1132,8 +1140,12 @@ class StreamingTranscriber {
             searchParams.set("speech_model", this.params.speechModel.toString());
         }
         if (this.params.languageCode !== undefined) {
+            console.warn("[Deprecation Warning] `languageCode` is deprecated and will be removed in a future release. Please use `languageCodes` instead.");
             searchParams.set("language_code", this.params.languageCode);
         }
+        if (this.params.languageCodes !== undefined) {
+            searchParams.set("language_codes", JSON.stringify(this.params.languageCodes));
+        }
         if (this.params.languageDetection !== undefined) {
             searchParams.set("language_detection", this.params.languageDetection.toString());
         }

package/dist/deno.mjs

@@ -30,7 +30,7 @@ if (typeof navigator !== "undefined" && navigator.userAgent) {
     defaultUserAgentString += navigator.userAgent;
 }
 const defaultUserAgent = {
-    sdk: { name: "JavaScript", version: "4.35.0" },
+    sdk: { name: "JavaScript", version: "4.35.4" },
 };
 if (typeof process !== "undefined") {
     if (process.versions.node && defaultUserAgentString.indexOf("Node") === -1) {
@@ -1034,6 +1034,10 @@ class StreamingTranscriber {
         if (!(this.token || this.apiKey)) {
             throw new Error("API key or temporary token is required.");
         }
+        const isOpus = params.encoding === "opus" || params.encoding === "ogg_opus";
+        if (params.sampleRate === undefined && (!isOpus || params.channels)) {
+            throw new Error('`sampleRate` is required; it may only be omitted when `encoding` is "opus" or "ogg_opus" (the Opus stream is self-describing) and dual-channel mode is not used.');
+        }
         if (params.channels) {
             if (params.channels.length !== 2) {
                 throw new Error("StreamingTranscriber.channels must have exactly 2 entries.");
@@ -1059,10 +1063,12 @@ class StreamingTranscriber {
                 "speaker-history") {
                 this.speakerHistory = new Map();
             }
-            // 20 ms VAD frames at the transcriber's target sample rate.
-            this.vadFrameSamples = Math.max(1, Math.round(params.sampleRate * 0.02));
-            this.minChunkSamples = Math.max(1, Math.round(params.sampleRate * (MIN_CHUNK_MS / 1000)));
-            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(params.sampleRate * (MAX_CHUNK_MS / 1000)));
+            // 20 ms VAD frames at the transcriber's target sample rate. The
+            // constructor check above guarantees sampleRate in dual-channel mode.
+            const sampleRate = params.sampleRate;
+            this.vadFrameSamples = Math.max(1, Math.round(sampleRate * 0.02));
+            this.minChunkSamples = Math.max(1, Math.round(sampleRate * (MIN_CHUNK_MS / 1000)));
+            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(sampleRate * (MAX_CHUNK_MS / 1000)));
             this.channelBuffers = new Map(names.map((n) => [n, []]));
             this.channelSamplesReceived = new Map(names.map((n) => [n, 0]));
             this.channelVadFloatBuffers = new Map(names.map((n) => [n, new Float32Array(this.vadFrameSamples)]));
@@ -1080,7 +1086,9 @@ class StreamingTranscriber {
         if (this.token) {
             searchParams.set("token", this.token);
         }
-        searchParams.set("sample_rate", this.params.sampleRate.toString());
+        if (this.params.sampleRate !== undefined) {
+            searchParams.set("sample_rate", this.params.sampleRate.toString());
+        }
         if (this.params.endOfTurnConfidenceThreshold) {
             searchParams.set("end_of_turn_confidence_threshold", this.params.endOfTurnConfidenceThreshold.toString());
         }
@@ -1132,8 +1140,12 @@ class StreamingTranscriber {
             searchParams.set("speech_model", this.params.speechModel.toString());
         }
         if (this.params.languageCode !== undefined) {
+            console.warn("[Deprecation Warning] `languageCode` is deprecated and will be removed in a future release. Please use `languageCodes` instead.");
             searchParams.set("language_code", this.params.languageCode);
         }
+        if (this.params.languageCodes !== undefined) {
+            searchParams.set("language_codes", JSON.stringify(this.params.languageCodes));
+        }
         if (this.params.languageDetection !== undefined) {
             searchParams.set("language_detection", this.params.languageDetection.toString());
         }

package/dist/exports/streaming.d.ts

@@ -1,7 +1,7 @@
 export * from "../types/asyncapi.generated";
 export * from "../types/realtime";
 export * from "../types/helpers";
-export * from "../types/streaming/dual-channel";
+export * from "../types/streaming";
 export * from "../services/realtime/service";
 export * from "../services/streaming/service";
 export * from "../services/streaming/factory";

package/dist/index.cjs

@@ -76,7 +76,7 @@ if (typeof navigator !== "undefined" && navigator.userAgent) {
     defaultUserAgentString += navigator.userAgent;
 }
 const defaultUserAgent = {
-    sdk: { name: "JavaScript", version: "4.35.0" },
+    sdk: { name: "JavaScript", version: "4.35.4" },
 };
 if (typeof process !== "undefined") {
     if (process.versions.node && defaultUserAgentString.indexOf("Node") === -1) {
@@ -1128,6 +1128,10 @@ class StreamingTranscriber {
         if (!(this.token || this.apiKey)) {
             throw new Error("API key or temporary token is required.");
         }
+        const isOpus = params.encoding === "opus" || params.encoding === "ogg_opus";
+        if (params.sampleRate === undefined && (!isOpus || params.channels)) {
+            throw new Error('`sampleRate` is required; it may only be omitted when `encoding` is "opus" or "ogg_opus" (the Opus stream is self-describing) and dual-channel mode is not used.');
+        }
         if (params.channels) {
             if (params.channels.length !== 2) {
                 throw new Error("StreamingTranscriber.channels must have exactly 2 entries.");
@@ -1153,10 +1157,12 @@ class StreamingTranscriber {
                 "speaker-history") {
                 this.speakerHistory = new Map();
             }
-            // 20 ms VAD frames at the transcriber's target sample rate.
-            this.vadFrameSamples = Math.max(1, Math.round(params.sampleRate * 0.02));
-            this.minChunkSamples = Math.max(1, Math.round(params.sampleRate * (MIN_CHUNK_MS / 1000)));
-            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(params.sampleRate * (MAX_CHUNK_MS / 1000)));
+            // 20 ms VAD frames at the transcriber's target sample rate. The
+            // constructor check above guarantees sampleRate in dual-channel mode.
+            const sampleRate = params.sampleRate;
+            this.vadFrameSamples = Math.max(1, Math.round(sampleRate * 0.02));
+            this.minChunkSamples = Math.max(1, Math.round(sampleRate * (MIN_CHUNK_MS / 1000)));
+            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(sampleRate * (MAX_CHUNK_MS / 1000)));
             this.channelBuffers = new Map(names.map((n) => [n, []]));
             this.channelSamplesReceived = new Map(names.map((n) => [n, 0]));
             this.channelVadFloatBuffers = new Map(names.map((n) => [n, new Float32Array(this.vadFrameSamples)]));
@@ -1175,7 +1181,9 @@ class StreamingTranscriber {
         if (this.token) {
             searchParams.set("token", this.token);
         }
-        searchParams.set("sample_rate", this.params.sampleRate.toString());
+        if (this.params.sampleRate !== undefined) {
+            searchParams.set("sample_rate", this.params.sampleRate.toString());
+        }
         if (this.params.endOfTurnConfidenceThreshold) {
             searchParams.set("end_of_turn_confidence_threshold", this.params.endOfTurnConfidenceThreshold.toString());
         }
@@ -1226,8 +1234,12 @@ class StreamingTranscriber {
             searchParams.set("speech_model", this.params.speechModel.toString());
         }
         if (this.params.languageCode !== undefined) {
+            console.warn("[Deprecation Warning] `languageCode` is deprecated and will be removed in a future release. Please use `languageCodes` instead.");
             searchParams.set("language_code", this.params.languageCode);
         }
+        if (this.params.languageCodes !== undefined) {
+            searchParams.set("language_codes", JSON.stringify(this.params.languageCodes));
+        }
         if (this.params.languageDetection !== undefined) {
             searchParams.set("language_detection", this.params.languageDetection.toString());
         }

package/dist/index.mjs

@@ -74,7 +74,7 @@ if (typeof navigator !== "undefined" && navigator.userAgent) {
     defaultUserAgentString += navigator.userAgent;
 }
 const defaultUserAgent = {
-    sdk: { name: "JavaScript", version: "4.35.0" },
+    sdk: { name: "JavaScript", version: "4.35.4" },
 };
 if (typeof process !== "undefined") {
     if (process.versions.node && defaultUserAgentString.indexOf("Node") === -1) {
@@ -1126,6 +1126,10 @@ class StreamingTranscriber {
         if (!(this.token || this.apiKey)) {
             throw new Error("API key or temporary token is required.");
         }
+        const isOpus = params.encoding === "opus" || params.encoding === "ogg_opus";
+        if (params.sampleRate === undefined && (!isOpus || params.channels)) {
+            throw new Error('`sampleRate` is required; it may only be omitted when `encoding` is "opus" or "ogg_opus" (the Opus stream is self-describing) and dual-channel mode is not used.');
+        }
         if (params.channels) {
             if (params.channels.length !== 2) {
                 throw new Error("StreamingTranscriber.channels must have exactly 2 entries.");
@@ -1151,10 +1155,12 @@ class StreamingTranscriber {
                 "speaker-history") {
                 this.speakerHistory = new Map();
             }
-            // 20 ms VAD frames at the transcriber's target sample rate.
-            this.vadFrameSamples = Math.max(1, Math.round(params.sampleRate * 0.02));
-            this.minChunkSamples = Math.max(1, Math.round(params.sampleRate * (MIN_CHUNK_MS / 1000)));
-            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(params.sampleRate * (MAX_CHUNK_MS / 1000)));
+            // 20 ms VAD frames at the transcriber's target sample rate. The
+            // constructor check above guarantees sampleRate in dual-channel mode.
+            const sampleRate = params.sampleRate;
+            this.vadFrameSamples = Math.max(1, Math.round(sampleRate * 0.02));
+            this.minChunkSamples = Math.max(1, Math.round(sampleRate * (MIN_CHUNK_MS / 1000)));
+            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(sampleRate * (MAX_CHUNK_MS / 1000)));
             this.channelBuffers = new Map(names.map((n) => [n, []]));
             this.channelSamplesReceived = new Map(names.map((n) => [n, 0]));
             this.channelVadFloatBuffers = new Map(names.map((n) => [n, new Float32Array(this.vadFrameSamples)]));
@@ -1173,7 +1179,9 @@ class StreamingTranscriber {
         if (this.token) {
             searchParams.set("token", this.token);
         }
-        searchParams.set("sample_rate", this.params.sampleRate.toString());
+        if (this.params.sampleRate !== undefined) {
+            searchParams.set("sample_rate", this.params.sampleRate.toString());
+        }
         if (this.params.endOfTurnConfidenceThreshold) {
             searchParams.set("end_of_turn_confidence_threshold", this.params.endOfTurnConfidenceThreshold.toString());
         }
@@ -1224,8 +1232,12 @@ class StreamingTranscriber {
             searchParams.set("speech_model", this.params.speechModel.toString());
         }
         if (this.params.languageCode !== undefined) {
+            console.warn("[Deprecation Warning] `languageCode` is deprecated and will be removed in a future release. Please use `languageCodes` instead.");
             searchParams.set("language_code", this.params.languageCode);
         }
+        if (this.params.languageCodes !== undefined) {
+            searchParams.set("language_codes", JSON.stringify(this.params.languageCodes));
+        }
         if (this.params.languageDetection !== undefined) {
             searchParams.set("language_detection", this.params.languageDetection.toString());
         }

package/dist/node.cjs

@@ -35,7 +35,7 @@ if (typeof navigator !== "undefined" && navigator.userAgent) {
     defaultUserAgentString += navigator.userAgent;
 }
 const defaultUserAgent = {
-    sdk: { name: "JavaScript", version: "4.35.0" },
+    sdk: { name: "JavaScript", version: "4.35.4" },
 };
 if (typeof process !== "undefined") {
     if (process.versions.node && defaultUserAgentString.indexOf("Node") === -1) {
@@ -1033,6 +1033,10 @@ class StreamingTranscriber {
         if (!(this.token || this.apiKey)) {
             throw new Error("API key or temporary token is required.");
         }
+        const isOpus = params.encoding === "opus" || params.encoding === "ogg_opus";
+        if (params.sampleRate === undefined && (!isOpus || params.channels)) {
+            throw new Error('`sampleRate` is required; it may only be omitted when `encoding` is "opus" or "ogg_opus" (the Opus stream is self-describing) and dual-channel mode is not used.');
+        }
         if (params.channels) {
             if (params.channels.length !== 2) {
                 throw new Error("StreamingTranscriber.channels must have exactly 2 entries.");
@@ -1058,10 +1062,12 @@ class StreamingTranscriber {
                 "speaker-history") {
                 this.speakerHistory = new Map();
             }
-            // 20 ms VAD frames at the transcriber's target sample rate.
-            this.vadFrameSamples = Math.max(1, Math.round(params.sampleRate * 0.02));
-            this.minChunkSamples = Math.max(1, Math.round(params.sampleRate * (MIN_CHUNK_MS / 1000)));
-            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(params.sampleRate * (MAX_CHUNK_MS / 1000)));
+            // 20 ms VAD frames at the transcriber's target sample rate. The
+            // constructor check above guarantees sampleRate in dual-channel mode.
+            const sampleRate = params.sampleRate;
+            this.vadFrameSamples = Math.max(1, Math.round(sampleRate * 0.02));
+            this.minChunkSamples = Math.max(1, Math.round(sampleRate * (MIN_CHUNK_MS / 1000)));
+            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(sampleRate * (MAX_CHUNK_MS / 1000)));
             this.channelBuffers = new Map(names.map((n) => [n, []]));
             this.channelSamplesReceived = new Map(names.map((n) => [n, 0]));
             this.channelVadFloatBuffers = new Map(names.map((n) => [n, new Float32Array(this.vadFrameSamples)]));
@@ -1079,7 +1085,9 @@ class StreamingTranscriber {
         if (this.token) {
             searchParams.set("token", this.token);
         }
-        searchParams.set("sample_rate", this.params.sampleRate.toString());
+        if (this.params.sampleRate !== undefined) {
+            searchParams.set("sample_rate", this.params.sampleRate.toString());
+        }
         if (this.params.endOfTurnConfidenceThreshold) {
             searchParams.set("end_of_turn_confidence_threshold", this.params.endOfTurnConfidenceThreshold.toString());
         }
@@ -1131,8 +1139,12 @@ class StreamingTranscriber {
             searchParams.set("speech_model", this.params.speechModel.toString());
         }
         if (this.params.languageCode !== undefined) {
+            console.warn("[Deprecation Warning] `languageCode` is deprecated and will be removed in a future release. Please use `languageCodes` instead.");
             searchParams.set("language_code", this.params.languageCode);
         }
+        if (this.params.languageCodes !== undefined) {
+            searchParams.set("language_codes", JSON.stringify(this.params.languageCodes));
+        }
         if (this.params.languageDetection !== undefined) {
             searchParams.set("language_detection", this.params.languageDetection.toString());
         }

package/dist/node.mjs

@@ -33,7 +33,7 @@ if (typeof navigator !== "undefined" && navigator.userAgent) {
     defaultUserAgentString += navigator.userAgent;
 }
 const defaultUserAgent = {
-    sdk: { name: "JavaScript", version: "4.35.0" },
+    sdk: { name: "JavaScript", version: "4.35.4" },
 };
 if (typeof process !== "undefined") {
     if (process.versions.node && defaultUserAgentString.indexOf("Node") === -1) {
@@ -1031,6 +1031,10 @@ class StreamingTranscriber {
         if (!(this.token || this.apiKey)) {
             throw new Error("API key or temporary token is required.");
         }
+        const isOpus = params.encoding === "opus" || params.encoding === "ogg_opus";
+        if (params.sampleRate === undefined && (!isOpus || params.channels)) {
+            throw new Error('`sampleRate` is required; it may only be omitted when `encoding` is "opus" or "ogg_opus" (the Opus stream is self-describing) and dual-channel mode is not used.');
+        }
         if (params.channels) {
             if (params.channels.length !== 2) {
                 throw new Error("StreamingTranscriber.channels must have exactly 2 entries.");
@@ -1056,10 +1060,12 @@ class StreamingTranscriber {
                 "speaker-history") {
                 this.speakerHistory = new Map();
             }
-            // 20 ms VAD frames at the transcriber's target sample rate.
-            this.vadFrameSamples = Math.max(1, Math.round(params.sampleRate * 0.02));
-            this.minChunkSamples = Math.max(1, Math.round(params.sampleRate * (MIN_CHUNK_MS / 1000)));
-            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(params.sampleRate * (MAX_CHUNK_MS / 1000)));
+            // 20 ms VAD frames at the transcriber's target sample rate. The
+            // constructor check above guarantees sampleRate in dual-channel mode.
+            const sampleRate = params.sampleRate;
+            this.vadFrameSamples = Math.max(1, Math.round(sampleRate * 0.02));
+            this.minChunkSamples = Math.max(1, Math.round(sampleRate * (MIN_CHUNK_MS / 1000)));
+            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(sampleRate * (MAX_CHUNK_MS / 1000)));
             this.channelBuffers = new Map(names.map((n) => [n, []]));
             this.channelSamplesReceived = new Map(names.map((n) => [n, 0]));
             this.channelVadFloatBuffers = new Map(names.map((n) => [n, new Float32Array(this.vadFrameSamples)]));
@@ -1077,7 +1083,9 @@ class StreamingTranscriber {
         if (this.token) {
             searchParams.set("token", this.token);
         }
-        searchParams.set("sample_rate", this.params.sampleRate.toString());
+        if (this.params.sampleRate !== undefined) {
+            searchParams.set("sample_rate", this.params.sampleRate.toString());
+        }
         if (this.params.endOfTurnConfidenceThreshold) {
             searchParams.set("end_of_turn_confidence_threshold", this.params.endOfTurnConfidenceThreshold.toString());
         }
@@ -1129,8 +1137,12 @@ class StreamingTranscriber {
             searchParams.set("speech_model", this.params.speechModel.toString());
         }
         if (this.params.languageCode !== undefined) {
+            console.warn("[Deprecation Warning] `languageCode` is deprecated and will be removed in a future release. Please use `languageCodes` instead.");
             searchParams.set("language_code", this.params.languageCode);
         }
+        if (this.params.languageCodes !== undefined) {
+            searchParams.set("language_codes", JSON.stringify(this.params.languageCodes));
+        }
         if (this.params.languageDetection !== undefined) {
             searchParams.set("language_detection", this.params.languageDetection.toString());
         }

package/dist/streaming.browser.mjs

@@ -584,6 +584,10 @@ class StreamingTranscriber {
         if (!(this.token || this.apiKey)) {
             throw new Error("API key or temporary token is required.");
         }
+        const isOpus = params.encoding === "opus" || params.encoding === "ogg_opus";
+        if (params.sampleRate === undefined && (!isOpus || params.channels)) {
+            throw new Error('`sampleRate` is required; it may only be omitted when `encoding` is "opus" or "ogg_opus" (the Opus stream is self-describing) and dual-channel mode is not used.');
+        }
         if (params.channels) {
             if (params.channels.length !== 2) {
                 throw new Error("StreamingTranscriber.channels must have exactly 2 entries.");
@@ -609,10 +613,12 @@ class StreamingTranscriber {
                 "speaker-history") {
                 this.speakerHistory = new Map();
             }
-            // 20 ms VAD frames at the transcriber's target sample rate.
-            this.vadFrameSamples = Math.max(1, Math.round(params.sampleRate * 0.02));
-            this.minChunkSamples = Math.max(1, Math.round(params.sampleRate * (MIN_CHUNK_MS / 1000)));
-            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(params.sampleRate * (MAX_CHUNK_MS / 1000)));
+            // 20 ms VAD frames at the transcriber's target sample rate. The
+            // constructor check above guarantees sampleRate in dual-channel mode.
+            const sampleRate = params.sampleRate;
+            this.vadFrameSamples = Math.max(1, Math.round(sampleRate * 0.02));
+            this.minChunkSamples = Math.max(1, Math.round(sampleRate * (MIN_CHUNK_MS / 1000)));
+            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(sampleRate * (MAX_CHUNK_MS / 1000)));
             this.channelBuffers = new Map(names.map((n) => [n, []]));
             this.channelSamplesReceived = new Map(names.map((n) => [n, 0]));
             this.channelVadFloatBuffers = new Map(names.map((n) => [n, new Float32Array(this.vadFrameSamples)]));
@@ -630,7 +636,9 @@ class StreamingTranscriber {
         if (this.token) {
             searchParams.set("token", this.token);
         }
-        searchParams.set("sample_rate", this.params.sampleRate.toString());
+        if (this.params.sampleRate !== undefined) {
+            searchParams.set("sample_rate", this.params.sampleRate.toString());
+        }
         if (this.params.endOfTurnConfidenceThreshold) {
             searchParams.set("end_of_turn_confidence_threshold", this.params.endOfTurnConfidenceThreshold.toString());
         }
@@ -682,8 +690,12 @@ class StreamingTranscriber {
             searchParams.set("speech_model", this.params.speechModel.toString());
         }
         if (this.params.languageCode !== undefined) {
+            console.warn("[Deprecation Warning] `languageCode` is deprecated and will be removed in a future release. Please use `languageCodes` instead.");
             searchParams.set("language_code", this.params.languageCode);
         }
+        if (this.params.languageCodes !== undefined) {
+            searchParams.set("language_codes", JSON.stringify(this.params.languageCodes));
+        }
         if (this.params.languageDetection !== undefined) {
             searchParams.set("language_detection", this.params.languageDetection.toString());
         }
@@ -1300,7 +1312,7 @@ if (typeof navigator !== "undefined" && navigator.userAgent) {
     defaultUserAgentString += navigator.userAgent;
 }
 const defaultUserAgent = {
-    sdk: { name: "JavaScript", version: "4.35.0" },
+    sdk: { name: "JavaScript", version: "4.35.4" },
 };
 if (typeof process !== "undefined") {
     if (process.versions.node && defaultUserAgentString.indexOf("Node") === -1) {

package/dist/streaming.cjs

@@ -630,6 +630,10 @@ class StreamingTranscriber {
         if (!(this.token || this.apiKey)) {
             throw new Error("API key or temporary token is required.");
         }
+        const isOpus = params.encoding === "opus" || params.encoding === "ogg_opus";
+        if (params.sampleRate === undefined && (!isOpus || params.channels)) {
+            throw new Error('`sampleRate` is required; it may only be omitted when `encoding` is "opus" or "ogg_opus" (the Opus stream is self-describing) and dual-channel mode is not used.');
+        }
         if (params.channels) {
             if (params.channels.length !== 2) {
                 throw new Error("StreamingTranscriber.channels must have exactly 2 entries.");
@@ -655,10 +659,12 @@ class StreamingTranscriber {
                 "speaker-history") {
                 this.speakerHistory = new Map();
             }
-            // 20 ms VAD frames at the transcriber's target sample rate.
-            this.vadFrameSamples = Math.max(1, Math.round(params.sampleRate * 0.02));
-            this.minChunkSamples = Math.max(1, Math.round(params.sampleRate * (MIN_CHUNK_MS / 1000)));
-            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(params.sampleRate * (MAX_CHUNK_MS / 1000)));
+            // 20 ms VAD frames at the transcriber's target sample rate. The
+            // constructor check above guarantees sampleRate in dual-channel mode.
+            const sampleRate = params.sampleRate;
+            this.vadFrameSamples = Math.max(1, Math.round(sampleRate * 0.02));
+            this.minChunkSamples = Math.max(1, Math.round(sampleRate * (MIN_CHUNK_MS / 1000)));
+            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(sampleRate * (MAX_CHUNK_MS / 1000)));
             this.channelBuffers = new Map(names.map((n) => [n, []]));
             this.channelSamplesReceived = new Map(names.map((n) => [n, 0]));
             this.channelVadFloatBuffers = new Map(names.map((n) => [n, new Float32Array(this.vadFrameSamples)]));
@@ -677,7 +683,9 @@ class StreamingTranscriber {
         if (this.token) {
             searchParams.set("token", this.token);
         }
-        searchParams.set("sample_rate", this.params.sampleRate.toString());
+        if (this.params.sampleRate !== undefined) {
+            searchParams.set("sample_rate", this.params.sampleRate.toString());
+        }
         if (this.params.endOfTurnConfidenceThreshold) {
             searchParams.set("end_of_turn_confidence_threshold", this.params.endOfTurnConfidenceThreshold.toString());
         }
@@ -728,8 +736,12 @@ class StreamingTranscriber {
             searchParams.set("speech_model", this.params.speechModel.toString());
         }
         if (this.params.languageCode !== undefined) {
+            console.warn("[Deprecation Warning] `languageCode` is deprecated and will be removed in a future release. Please use `languageCodes` instead.");
             searchParams.set("language_code", this.params.languageCode);
         }
+        if (this.params.languageCodes !== undefined) {
+            searchParams.set("language_codes", JSON.stringify(this.params.languageCodes));
+        }
         if (this.params.languageDetection !== undefined) {
             searchParams.set("language_detection", this.params.languageDetection.toString());
         }

package/dist/streaming.mjs

@@ -628,6 +628,10 @@ class StreamingTranscriber {
         if (!(this.token || this.apiKey)) {
             throw new Error("API key or temporary token is required.");
         }
+        const isOpus = params.encoding === "opus" || params.encoding === "ogg_opus";
+        if (params.sampleRate === undefined && (!isOpus || params.channels)) {
+            throw new Error('`sampleRate` is required; it may only be omitted when `encoding` is "opus" or "ogg_opus" (the Opus stream is self-describing) and dual-channel mode is not used.');
+        }
         if (params.channels) {
             if (params.channels.length !== 2) {
                 throw new Error("StreamingTranscriber.channels must have exactly 2 entries.");
@@ -653,10 +657,12 @@ class StreamingTranscriber {
                 "speaker-history") {
                 this.speakerHistory = new Map();
             }
-            // 20 ms VAD frames at the transcriber's target sample rate.
-            this.vadFrameSamples = Math.max(1, Math.round(params.sampleRate * 0.02));
-            this.minChunkSamples = Math.max(1, Math.round(params.sampleRate * (MIN_CHUNK_MS / 1000)));
-            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(params.sampleRate * (MAX_CHUNK_MS / 1000)));
+            // 20 ms VAD frames at the transcriber's target sample rate. The
+            // constructor check above guarantees sampleRate in dual-channel mode.
+            const sampleRate = params.sampleRate;
+            this.vadFrameSamples = Math.max(1, Math.round(sampleRate * 0.02));
+            this.minChunkSamples = Math.max(1, Math.round(sampleRate * (MIN_CHUNK_MS / 1000)));
+            this.maxChunkSamples = Math.max(this.minChunkSamples, Math.round(sampleRate * (MAX_CHUNK_MS / 1000)));
             this.channelBuffers = new Map(names.map((n) => [n, []]));
             this.channelSamplesReceived = new Map(names.map((n) => [n, 0]));
             this.channelVadFloatBuffers = new Map(names.map((n) => [n, new Float32Array(this.vadFrameSamples)]));
@@ -675,7 +681,9 @@ class StreamingTranscriber {
         if (this.token) {
             searchParams.set("token", this.token);
         }
-        searchParams.set("sample_rate", this.params.sampleRate.toString());
+        if (this.params.sampleRate !== undefined) {
+            searchParams.set("sample_rate", this.params.sampleRate.toString());
+        }
         if (this.params.endOfTurnConfidenceThreshold) {
             searchParams.set("end_of_turn_confidence_threshold", this.params.endOfTurnConfidenceThreshold.toString());
         }
@@ -726,8 +734,12 @@ class StreamingTranscriber {
             searchParams.set("speech_model", this.params.speechModel.toString());
         }
         if (this.params.languageCode !== undefined) {
+            console.warn("[Deprecation Warning] `languageCode` is deprecated and will be removed in a future release. Please use `languageCodes` instead.");
             searchParams.set("language_code", this.params.languageCode);
         }
+        if (this.params.languageCodes !== undefined) {
+            searchParams.set("language_codes", JSON.stringify(this.params.languageCodes));
+        }
         if (this.params.languageDetection !== undefined) {
             searchParams.set("language_detection", this.params.languageDetection.toString());
         }

package/dist/types/asyncapi.generated.d.ts

@@ -6,7 +6,7 @@ export type AudioData = ArrayBufferLike;
  * The encoding of the audio data
  * @defaultValue "pcm_s16"le
  */
-export type AudioEncoding = "pcm_s16le" | "pcm_mulaw";
+export type AudioEncoding = "pcm_s16le" | "pcm_mulaw" | "opus" | "ogg_opus";
 /**
  * Configure the threshold for how long to wait before ending an utterance. Default is 700ms.
  */