@cartesia/cartesia-js 1.0.3 → 1.2.1-alpha.2

package/dist/tts/websocket.cjs

@@ -9,6 +9,9 @@ var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __spreadValues = (a, b) => {
   for (var prop in b || (b = {}))
@@ -22,18 +25,6 @@ var __spreadValues = (a, b) => {
   return a;
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-var __objRest = (source, exclude) => {
-  var target = {};
-  for (var prop in source)
-    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
-      target[prop] = source[prop];
-  if (source != null && __getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(source)) {
-      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
-        target[prop] = source[prop];
-    }
-  return target;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -55,28 +46,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var __accessCheck = (obj, member, msg) => {
-  if (!member.has(obj))
-    throw TypeError("Cannot " + msg);
-};
-var __privateGet = (obj, member, getter) => {
-  __accessCheck(obj, member, "read from private field");
-  return getter ? getter.call(obj) : member.get(obj);
-};
-var __privateAdd = (obj, member, value) => {
-  if (member.has(obj))
-    throw TypeError("Cannot add the same private member more than once");
-  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-};
-var __privateSet = (obj, member, value, setter) => {
-  __accessCheck(obj, member, "write to private field");
-  setter ? setter.call(obj, value) : member.set(obj, value);
-  return value;
-};
-var __privateMethod = (obj, member, method) => {
-  __accessCheck(obj, member, "access private method");
-  return method;
-};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
@@ -155,7 +129,7 @@ var ENCODING_MAP = {
   pcm_alaw: { arrayType: Uint8Array, bytesPerElement: 1 },
   pcm_mulaw: { arrayType: Uint8Array, bytesPerElement: 1 }
 };
-var _emitter, _buffer, _readIndex, _writeIndex, _closed, _sampleRate, _encoding, _container, _createBuffer, createBuffer_fn;
+var _emitter, _buffer, _readIndex, _writeIndex, _closed, _sampleRate, _encoding, _container, _Source_instances, createBuffer_fn;
 var Source = class {
   /**
    * Create a new Source.
@@ -168,21 +142,15 @@ var Source = class {
     encoding,
     container
   }) {
-    /**
-     * Create a new buffer for the source.
-     *
-     * @param size - The size of the buffer to create.
-     * @returns The new buffer as a TypedArray based on the encoding.
-     */
-    __privateAdd(this, _createBuffer);
+    __privateAdd(this, _Source_instances);
     __privateAdd(this, _emitter, new import_emittery.default());
-    __privateAdd(this, _buffer, void 0);
+    __privateAdd(this, _buffer);
     __privateAdd(this, _readIndex, 0);
     __privateAdd(this, _writeIndex, 0);
     __privateAdd(this, _closed, false);
-    __privateAdd(this, _sampleRate, void 0);
-    __privateAdd(this, _encoding, void 0);
-    __privateAdd(this, _container, void 0);
+    __privateAdd(this, _sampleRate);
+    __privateAdd(this, _encoding);
+    __privateAdd(this, _container);
     this.on = __privateGet(this, _emitter).on.bind(__privateGet(this, _emitter));
     this.once = __privateGet(this, _emitter).once.bind(__privateGet(this, _emitter));
     this.events = __privateGet(this, _emitter).events.bind(__privateGet(this, _emitter));
@@ -190,7 +158,7 @@ var Source = class {
     __privateSet(this, _sampleRate, sampleRate);
     __privateSet(this, _encoding, encoding);
     __privateSet(this, _container, container);
-    __privateSet(this, _buffer, __privateMethod(this, _createBuffer, createBuffer_fn).call(this, 1024));
+    __privateSet(this, _buffer, __privateMethod(this, _Source_instances, createBuffer_fn).call(this, 1024));
   }
   get sampleRate() {
     return __privateGet(this, _sampleRate);
@@ -214,7 +182,7 @@ var Source = class {
         while (newCapacity < requiredCapacity) {
           newCapacity *= 2;
         }
-        const newBuffer = __privateMethod(this, _createBuffer, createBuffer_fn).call(this, newCapacity);
+        const newBuffer = __privateMethod(this, _Source_instances, createBuffer_fn).call(this, newCapacity);
         newBuffer.set(__privateGet(this, _buffer));
         __privateSet(this, _buffer, newBuffer);
       }
@@ -247,6 +215,37 @@ var Source = class {
       return read;
     });
   }
+  /**
+   * Seek in the buffer.
+   *
+   * @param offset The offset to seek to.
+   * @param whence The position to seek from.
+   * @returns The new position in the buffer.
+   * @throws {Error} If the seek is invalid.
+   */
+  seek(offset, whence) {
+    return __async(this, null, function* () {
+      let position = __privateGet(this, _readIndex);
+      switch (whence) {
+        case "start":
+          position = offset;
+          break;
+        case "current":
+          position += offset;
+          break;
+        case "end":
+          position = __privateGet(this, _writeIndex) + offset;
+          break;
+        default:
+          throw new Error(`Invalid seek mode: ${whence}`);
+      }
+      if (position < 0 || position > __privateGet(this, _writeIndex)) {
+        throw new Error("Seek out of bounds");
+      }
+      __privateSet(this, _readIndex, position);
+      return position;
+    });
+  }
   /**
    * Get the number of samples in a given duration.
    *
@@ -288,7 +287,13 @@ _closed = new WeakMap();
 _sampleRate = new WeakMap();
 _encoding = new WeakMap();
 _container = new WeakMap();
-_createBuffer = new WeakSet();
+_Source_instances = new WeakSet();
+/**
+ * Create a new buffer for the source.
+ *
+ * @param size - The size of the buffer to create.
+ * @returns The new buffer as a TypedArray based on the encoding.
+ */
 createBuffer_fn = function(size) {
   const { arrayType: ArrayType } = ENCODING_MAP[__privateGet(this, _encoding)];
   return new ArrayType(size);
@@ -351,7 +356,7 @@ function getEmitteryCallbacks(emitter) {
 }
 
 // src/tts/websocket.ts
-var _isConnected, _sampleRate2, _container2, _encoding2, _generateId, generateId_fn;
+var _isConnected, _sampleRate2, _container2, _encoding2, _WebSocket_instances, generateId_fn;
 var WebSocket = class extends Client {
   /**
    * Create a new WebSocket client.
@@ -360,19 +365,11 @@ var WebSocket = class extends Client {
    */
   constructor({ sampleRate, container, encoding }, ...args) {
     super(...args);
-    /**
-     * Generate a unique ID suitable for a streaming context.
-     *
-     * Not suitable for security purposes or as a primary key, since
-     * it lacks the amount of entropy required for those use cases.
-     *
-     * @returns A unique ID.
-     */
-    __privateAdd(this, _generateId);
+    __privateAdd(this, _WebSocket_instances);
     __privateAdd(this, _isConnected, false);
-    __privateAdd(this, _sampleRate2, void 0);
-    __privateAdd(this, _container2, void 0);
-    __privateAdd(this, _encoding2, void 0);
+    __privateAdd(this, _sampleRate2);
+    __privateAdd(this, _container2);
+    __privateAdd(this, _encoding2);
     __privateSet(this, _sampleRate2, sampleRate);
     __privateSet(this, _container2, container != null ? container : "raw");
     __privateSet(this, _encoding2, encoding != null ? encoding : "pcm_f32le");
@@ -380,7 +377,7 @@ var WebSocket = class extends Client {
   /**
    * Send a message over the WebSocket to start a stream.
    *
-   * @param inputs - Stream options. Defined in the StreamRequest type.
+   * @param inputs - Generation parameters. Defined in the StreamRequest type.
    * @param options - Options for the stream.
    * @param options.timeout - The maximum time to wait for a chunk before cancelling the stream.
    *                          If set to `0`, the stream will not time out.
@@ -388,14 +385,13 @@ var WebSocket = class extends Client {
    * @returns An Emittery instance that emits messages from the WebSocket.
    * @returns An abort function that can be called to cancel the stream.
    */
-  send(_a, { timeout = 0 } = {}) {
-    var inputs = __objRest(_a, []);
-    var _a2, _b, _c, _d;
+  send(inputs, { timeout = 0 } = {}) {
+    var _a, _b, _c, _d;
     if (!__privateGet(this, _isConnected)) {
       throw new Error("Not connected to WebSocket. Call .connect() first.");
     }
     if (!inputs.context_id) {
-      inputs.context_id = __privateMethod(this, _generateId, generateId_fn).call(this);
+      inputs.context_id = __privateMethod(this, _WebSocket_instances, generateId_fn).call(this);
     }
     if (!inputs.output_format) {
       inputs.output_format = {
@@ -404,7 +400,7 @@ var WebSocket = class extends Client {
         sample_rate: __privateGet(this, _sampleRate2)
       };
     }
-    (_a2 = this.socket) == null ? void 0 : _a2.send(
+    (_a = this.socket) == null ? void 0 : _a.send(
       JSON.stringify(__spreadValues({}, inputs))
     );
     const emitter = new import_emittery2.default();
@@ -474,6 +470,32 @@ var WebSocket = class extends Client {
       stop: streamCompleteController.abort.bind(streamCompleteController)
     });
   }
+  /**
+   * Continue a stream.
+   *
+   * @param inputs - Generation parameters. Defined in the StreamRequest type, but must include a `context_id` field. `continue` is set to true by default.
+   */
+  continue(inputs) {
+    var _a;
+    if (!__privateGet(this, _isConnected)) {
+      throw new Error("Not connected to WebSocket. Call .connect() first.");
+    }
+    if (!inputs.context_id) {
+      throw new Error("context_id is required to continue a context.");
+    }
+    if (!inputs.output_format) {
+      inputs.output_format = {
+        container: __privateGet(this, _container2),
+        encoding: __privateGet(this, _encoding2),
+        sample_rate: __privateGet(this, _sampleRate2)
+      };
+    }
+    (_a = this.socket) == null ? void 0 : _a.send(
+      JSON.stringify(__spreadValues({
+        continue: true
+      }, inputs))
+    );
+  }
   /**
    * Authenticate and connect to a Cartesia streaming WebSocket.
    *
@@ -549,7 +571,15 @@ _isConnected = new WeakMap();
 _sampleRate2 = new WeakMap();
 _container2 = new WeakMap();
 _encoding2 = new WeakMap();
-_generateId = new WeakSet();
+_WebSocket_instances = new WeakSet();
+/**
+ * Generate a unique ID suitable for a streaming context.
+ *
+ * Not suitable for security purposes or as a primary key, since
+ * it lacks the amount of entropy required for those use cases.
+ *
+ * @returns A unique ID.
+ */
 generateId_fn = function() {
   return (0, import_human_id.humanId)({
     separator: "-",

package/dist/tts/websocket.d.cts

@@ -1,7 +1,7 @@
 import * as emittery from 'emittery';
 import { WebSocket as WebSocket$1 } from 'partysocket';
 import { Client } from '../lib/client.cjs';
-import { WebSocketOptions, StreamRequest, StreamOptions, WordTimestamps, EmitteryCallbacks, ConnectionEventData } from '../types/index.cjs';
+import { WebSocketOptions, StreamRequest, StreamOptions, WordTimestamps, ContinueRequest, EmitteryCallbacks, ConnectionEventData } from '../types/index.cjs';
 import Source from './source.cjs';
 
 declare class WebSocket extends Client {
@@ -16,7 +16,7 @@ declare class WebSocket extends Client {
     /**
      * Send a message over the WebSocket to start a stream.
      *
-     * @param inputs - Stream options. Defined in the StreamRequest type.
+     * @param inputs - Generation parameters. Defined in the StreamRequest type.
      * @param options - Options for the stream.
      * @param options.timeout - The maximum time to wait for a chunk before cancelling the stream.
      *                          If set to `0`, the stream will not time out.
@@ -24,7 +24,7 @@ declare class WebSocket extends Client {
      * @returns An Emittery instance that emits messages from the WebSocket.
      * @returns An abort function that can be called to cancel the stream.
      */
-    send({ ...inputs }: StreamRequest, { timeout }?: StreamOptions): {
+    send(inputs: StreamRequest, { timeout }?: StreamOptions): {
         stop: {
             (reason?: any): void;
             (reason?: any): void;
@@ -33,20 +33,26 @@ declare class WebSocket extends Client {
             message: string;
             timestamps: WordTimestamps;
         } & emittery.OmnipresentEventData)[Name]) => void | Promise<void>) => emittery.UnsubscribeFunction;
-        off: <Name_1 extends "timestamps" | keyof emittery.OmnipresentEventData | "message">(eventName: Name_1 | readonly Name_1[], listener: (eventData: ({
+        off: <Name extends "timestamps" | keyof emittery.OmnipresentEventData | "message">(eventName: Name | readonly Name[], listener: (eventData: ({
             message: string;
             timestamps: WordTimestamps;
-        } & emittery.OmnipresentEventData)[Name_1]) => void | Promise<void>) => void;
-        once: <Name_2 extends "timestamps" | keyof emittery.OmnipresentEventData | "message">(eventName: Name_2 | readonly Name_2[]) => emittery.EmitteryOncePromise<({
+        } & emittery.OmnipresentEventData)[Name]) => void | Promise<void>) => void;
+        once: <Name extends "timestamps" | keyof emittery.OmnipresentEventData | "message">(eventName: Name | readonly Name[]) => emittery.EmitteryOncePromise<({
             message: string;
             timestamps: WordTimestamps;
-        } & emittery.OmnipresentEventData)[Name_2]>;
-        events: <Name_3 extends "timestamps" | "message">(eventName: Name_3 | readonly Name_3[]) => AsyncIterableIterator<{
+        } & emittery.OmnipresentEventData)[Name]>;
+        events: <Name extends "timestamps" | "message">(eventName: Name | readonly Name[]) => AsyncIterableIterator<{
             message: string;
             timestamps: WordTimestamps;
-        }[Name_3]>;
+        }[Name]>;
         source: Source;
     };
+    /**
+     * Continue a stream.
+     *
+     * @param inputs - Generation parameters. Defined in the StreamRequest type, but must include a `context_id` field. `continue` is set to true by default.
+     */
+    continue(inputs: ContinueRequest): void;
     /**
      * Authenticate and connect to a Cartesia streaming WebSocket.
      *

package/dist/tts/websocket.d.ts

@@ -1,7 +1,7 @@
 import * as emittery from 'emittery';
 import { WebSocket as WebSocket$1 } from 'partysocket';
 import { Client } from '../lib/client.js';
-import { WebSocketOptions, StreamRequest, StreamOptions, WordTimestamps, EmitteryCallbacks, ConnectionEventData } from '../types/index.js';
+import { WebSocketOptions, StreamRequest, StreamOptions, WordTimestamps, ContinueRequest, EmitteryCallbacks, ConnectionEventData } from '../types/index.js';
 import Source from './source.js';
 
 declare class WebSocket extends Client {
@@ -16,7 +16,7 @@ declare class WebSocket extends Client {
     /**
      * Send a message over the WebSocket to start a stream.
      *
-     * @param inputs - Stream options. Defined in the StreamRequest type.
+     * @param inputs - Generation parameters. Defined in the StreamRequest type.
      * @param options - Options for the stream.
      * @param options.timeout - The maximum time to wait for a chunk before cancelling the stream.
      *                          If set to `0`, the stream will not time out.
@@ -24,7 +24,7 @@ declare class WebSocket extends Client {
      * @returns An Emittery instance that emits messages from the WebSocket.
      * @returns An abort function that can be called to cancel the stream.
      */
-    send({ ...inputs }: StreamRequest, { timeout }?: StreamOptions): {
+    send(inputs: StreamRequest, { timeout }?: StreamOptions): {
         stop: {
             (reason?: any): void;
             (reason?: any): void;
@@ -33,20 +33,26 @@ declare class WebSocket extends Client {
             message: string;
             timestamps: WordTimestamps;
         } & emittery.OmnipresentEventData)[Name]) => void | Promise<void>) => emittery.UnsubscribeFunction;
-        off: <Name_1 extends "timestamps" | keyof emittery.OmnipresentEventData | "message">(eventName: Name_1 | readonly Name_1[], listener: (eventData: ({
+        off: <Name extends "timestamps" | keyof emittery.OmnipresentEventData | "message">(eventName: Name | readonly Name[], listener: (eventData: ({
             message: string;
             timestamps: WordTimestamps;
-        } & emittery.OmnipresentEventData)[Name_1]) => void | Promise<void>) => void;
-        once: <Name_2 extends "timestamps" | keyof emittery.OmnipresentEventData | "message">(eventName: Name_2 | readonly Name_2[]) => emittery.EmitteryOncePromise<({
+        } & emittery.OmnipresentEventData)[Name]) => void | Promise<void>) => void;
+        once: <Name extends "timestamps" | keyof emittery.OmnipresentEventData | "message">(eventName: Name | readonly Name[]) => emittery.EmitteryOncePromise<({
             message: string;
             timestamps: WordTimestamps;
-        } & emittery.OmnipresentEventData)[Name_2]>;
-        events: <Name_3 extends "timestamps" | "message">(eventName: Name_3 | readonly Name_3[]) => AsyncIterableIterator<{
+        } & emittery.OmnipresentEventData)[Name]>;
+        events: <Name extends "timestamps" | "message">(eventName: Name | readonly Name[]) => AsyncIterableIterator<{
             message: string;
             timestamps: WordTimestamps;
-        }[Name_3]>;
+        }[Name]>;
         source: Source;
     };
+    /**
+     * Continue a stream.
+     *
+     * @param inputs - Generation parameters. Defined in the StreamRequest type, but must include a `context_id` field. `continue` is set to true by default.
+     */
+    continue(inputs: ContinueRequest): void;
     /**
      * Authenticate and connect to a Cartesia streaming WebSocket.
      *

package/dist/tts/websocket.js

@@ -1,11 +1,11 @@
 import {
   WebSocket
-} from "../chunk-EUW2435M.js";
-import "../chunk-PISCPZK4.js";
+} from "../chunk-WSIVWXEI.js";
+import "../chunk-FLWYXP5Z.js";
 import "../chunk-2BFEKY3F.js";
-import "../chunk-BHY7MNGT.js";
-import "../chunk-6YQ6KDIQ.js";
-import "../chunk-GHY2WEOK.js";
+import "../chunk-5SBAQNWQ.js";
+import "../chunk-I5YVYTNK.js";
+import "../chunk-NJDRWDQ3.js";
 export {
   WebSocket as default
 };

package/dist/types/index.d.cts

@@ -38,9 +38,14 @@ type StreamRequest = {
     context_id?: string;
     continue?: boolean;
     duration?: number;
-    language?: string;
+    language?: Language;
     add_timestamps?: boolean;
 };
+type BytesRequest = Omit<StreamRequest, "continue" | "add_timestamps" | "context_id">;
+type ContinueRequest = StreamRequest & {
+    context_id: string;
+};
+type Language = "en" | "es" | "fr" | "de" | "ja" | "zh" | "pt" | (string & {});
 type StreamOptions = {
     timeout?: number;
 };
@@ -83,6 +88,34 @@ type CloneOptions = {
     clip: Blob;
     enhance?: boolean;
 };
+type VoiceChangerOptions = {
+    clip: File;
+    voice: {
+        id: string;
+    };
+    output_format: {
+        container: "mp3";
+        bit_rate: number;
+        sample_rate: number;
+    } | {
+        container: "wav";
+        encoding: Encoding;
+        sample_rate: number;
+        bit_rate: number;
+    } | {
+        container: "raw";
+        encoding: Encoding;
+        sample_rate: number;
+    };
+};
+type LocalizeOptions = {
+    mode: "embedding";
+    embedding: number[];
+} & {
+    language: Language;
+    dialect: string & {};
+    original_speaker_gender: "male" | "female" | (string & {});
+};
 interface VoiceToMix {
     id?: string;
     embedding?: number[];
@@ -99,13 +132,19 @@ type Voice = {
     is_public: boolean;
     user_id: string;
     created_at: string;
-    language: string;
+    language: Language;
 };
 type CreateVoice = Pick<Voice, "name" | "description" | "embedding"> & Partial<Omit<Voice, "name" | "description" | "embedding">>;
 type UpdateVoice = Partial<Pick<Voice, "name" | "description" | "embedding">>;
 type CloneResponse = {
     embedding: number[];
 };
+type VoiceChangerBytesResponse = {
+    buffer: ArrayBuffer;
+};
+type LocalizeResponse = {
+    embedding: number[];
+};
 type MixVoicesResponse = {
     embedding: number[];
 };
@@ -123,4 +162,4 @@ type SourceEventData = {
 type TypedArray = Float32Array | Int16Array | Uint8Array;
 type Encoding = "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
 
-export type { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };
+export type { BytesRequest, Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceChangerBytesResponse, VoiceChangerOptions, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };

package/dist/types/index.d.ts

@@ -38,9 +38,14 @@ type StreamRequest = {
     context_id?: string;
     continue?: boolean;
     duration?: number;
-    language?: string;
+    language?: Language;
     add_timestamps?: boolean;
 };
+type BytesRequest = Omit<StreamRequest, "continue" | "add_timestamps" | "context_id">;
+type ContinueRequest = StreamRequest & {
+    context_id: string;
+};
+type Language = "en" | "es" | "fr" | "de" | "ja" | "zh" | "pt" | (string & {});
 type StreamOptions = {
     timeout?: number;
 };
@@ -83,6 +88,34 @@ type CloneOptions = {
     clip: Blob;
     enhance?: boolean;
 };
+type VoiceChangerOptions = {
+    clip: File;
+    voice: {
+        id: string;
+    };
+    output_format: {
+        container: "mp3";
+        bit_rate: number;
+        sample_rate: number;
+    } | {
+        container: "wav";
+        encoding: Encoding;
+        sample_rate: number;
+        bit_rate: number;
+    } | {
+        container: "raw";
+        encoding: Encoding;
+        sample_rate: number;
+    };
+};
+type LocalizeOptions = {
+    mode: "embedding";
+    embedding: number[];
+} & {
+    language: Language;
+    dialect: string & {};
+    original_speaker_gender: "male" | "female" | (string & {});
+};
 interface VoiceToMix {
     id?: string;
     embedding?: number[];
@@ -99,13 +132,19 @@ type Voice = {
     is_public: boolean;
     user_id: string;
     created_at: string;
-    language: string;
+    language: Language;
 };
 type CreateVoice = Pick<Voice, "name" | "description" | "embedding"> & Partial<Omit<Voice, "name" | "description" | "embedding">>;
 type UpdateVoice = Partial<Pick<Voice, "name" | "description" | "embedding">>;
 type CloneResponse = {
     embedding: number[];
 };
+type VoiceChangerBytesResponse = {
+    buffer: ArrayBuffer;
+};
+type LocalizeResponse = {
+    embedding: number[];
+};
 type MixVoicesResponse = {
     embedding: number[];
 };
@@ -123,4 +162,4 @@ type SourceEventData = {
 type TypedArray = Float32Array | Int16Array | Uint8Array;
 type Encoding = "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
 
-export type { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };
+export type { BytesRequest, Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, ContinueRequest, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Language, LocalizeOptions, LocalizeResponse, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceChangerBytesResponse, VoiceChangerOptions, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };