@cartesia/cartesia-js 1.3.0 → 2.0.0

package/dist/api/resources/voices/types/CloneMode.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloneMode = void 0;
+exports.CloneMode = {
+    Similarity: "similarity",
+    Stability: "stability",
+};

package/dist/api/resources/voices/types/CreateVoiceRequest.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export interface CreateVoiceRequest {
+    /** The name of the voice. */
+    name: string;
+    /** The description of the voice. */
+    description: string;
+    embedding: Cartesia.Embedding;
+    language?: Cartesia.SupportedLanguage;
+    baseVoiceId?: Cartesia.BaseVoiceId;
+}

package/dist/api/resources/voices/types/CreateVoiceRequest.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/EmbeddingResponse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export interface EmbeddingResponse {
+    embedding: Cartesia.Embedding;
+}

package/dist/api/resources/voices/types/EmbeddingResponse.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/EmbeddingSpecifier.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export interface EmbeddingSpecifier {
+    embedding: Cartesia.Embedding;
+    weight: Cartesia.Weight;
+}

package/dist/api/resources/voices/types/EmbeddingSpecifier.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/Gender.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export declare type Gender = "male" | "female";
+export declare const Gender: {
+    readonly Male: "male";
+    readonly Female: "female";
+};

package/dist/api/resources/voices/types/Gender.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Gender = void 0;
+exports.Gender = {
+    Male: "male",
+    Female: "female",
+};

package/dist/api/resources/voices/types/IdSpecifier.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export interface IdSpecifier {
+    id: Cartesia.VoiceId;
+    weight: Cartesia.Weight;
+}

package/dist/api/resources/voices/types/IdSpecifier.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/LocalizeDialect.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * The dialect to localize to. This is only available when language is set to English.
+ *
+ * Options: Australian (au), Indian (in), Southern American (so), UK (uk), US (us).
+ */
+export declare type LocalizeDialect = "au" | "in" | "so" | "uk" | "us";
+export declare const LocalizeDialect: {
+    readonly Au: "au";
+    readonly In: "in";
+    readonly So: "so";
+    readonly Uk: "uk";
+    readonly Us: "us";
+};

package/dist/api/resources/voices/types/LocalizeDialect.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalizeDialect = void 0;
+exports.LocalizeDialect = {
+    Au: "au",
+    In: "in",
+    So: "so",
+    Uk: "uk",
+    Us: "us",
+};

package/dist/api/resources/voices/types/LocalizeTargetLanguage.d.ts

@@ -0,0 +1,26 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Target language to localize the voice to.
+ *
+ * Options: English (en), German (de), Spanish (es), French (fr), Japanese (ja), Portuguese (pt), Chinese (zh), Hindi (hi), Italian (it), Korean (ko), Dutch (nl), Polish (pl), Russian (ru), Swedish (sv), Turkish (tr).
+ */
+export declare type LocalizeTargetLanguage = "en" | "de" | "es" | "fr" | "ja" | "pt" | "zh" | "hi" | "it" | "ko" | "nl" | "pl" | "ru" | "sv" | "tr";
+export declare const LocalizeTargetLanguage: {
+    readonly En: "en";
+    readonly De: "de";
+    readonly Es: "es";
+    readonly Fr: "fr";
+    readonly Ja: "ja";
+    readonly Pt: "pt";
+    readonly Zh: "zh";
+    readonly Hi: "hi";
+    readonly It: "it";
+    readonly Ko: "ko";
+    readonly Nl: "nl";
+    readonly Pl: "pl";
+    readonly Ru: "ru";
+    readonly Sv: "sv";
+    readonly Tr: "tr";
+};

package/dist/api/resources/voices/types/LocalizeTargetLanguage.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalizeTargetLanguage = void 0;
+exports.LocalizeTargetLanguage = {
+    En: "en",
+    De: "de",
+    Es: "es",
+    Fr: "fr",
+    Ja: "ja",
+    Pt: "pt",
+    Zh: "zh",
+    Hi: "hi",
+    It: "it",
+    Ko: "ko",
+    Nl: "nl",
+    Pl: "pl",
+    Ru: "ru",
+    Sv: "sv",
+    Tr: "tr",
+};

package/dist/api/resources/voices/types/LocalizeVoiceRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export interface LocalizeVoiceRequest {
+    embedding: Cartesia.Embedding;
+    language: Cartesia.LocalizeTargetLanguage;
+    originalSpeakerGender: Cartesia.Gender;
+    dialect?: Cartesia.LocalizeDialect;
+}

package/dist/api/resources/voices/types/LocalizeVoiceRequest.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/MixVoiceSpecifier.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export declare type MixVoiceSpecifier = Cartesia.IdSpecifier | Cartesia.EmbeddingSpecifier;

package/dist/api/resources/voices/types/MixVoiceSpecifier.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/MixVoicesRequest.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export interface MixVoicesRequest {
+    voices: Cartesia.MixVoiceSpecifier[];
+}

package/dist/api/resources/voices/types/MixVoicesRequest.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/UpdateVoiceRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface UpdateVoiceRequest {
+    /** The name of the voice. */
+    name: string;
+    /** The description of the voice. */
+    description: string;
+}

package/dist/api/resources/voices/types/UpdateVoiceRequest.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/Voice.d.ts

@@ -0,0 +1,20 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export interface Voice {
+    id: Cartesia.VoiceId;
+    /** The ID of the user who owns the voice. */
+    userId?: string;
+    /** Whether the voice is publicly accessible. */
+    isPublic: boolean;
+    /** The name of the voice. */
+    name: string;
+    /** The description of the voice. */
+    description: string;
+    /** The date and time the voice was created. */
+    createdAt: Date;
+    embedding: Cartesia.Embedding;
+    language: Cartesia.SupportedLanguage;
+    baseVoiceId?: Cartesia.BaseVoiceId;
+}

package/dist/api/resources/voices/types/Voice.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/VoiceId.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * The ID of the voice.
+ */
+export declare type VoiceId = string;

package/dist/api/resources/voices/types/VoiceId.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/VoiceMetadata.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export interface VoiceMetadata {
+    id: Cartesia.VoiceId;
+    /** The ID of the user who owns the voice. */
+    userId: string;
+    /** Whether the voice is publicly accessible. */
+    isPublic: boolean;
+    /** The name of the voice. */
+    name: string;
+    /** The description of the voice. */
+    description: string;
+    /** The date and time the voice was created. */
+    createdAt: Date;
+    language: Cartesia.SupportedLanguage;
+}

package/dist/api/resources/voices/types/VoiceMetadata.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/Weight.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * The weight of the voice or embedding in the mix. If weights do not sum to 1, they will be normalized.
+ */
+export declare type Weight = number;

package/dist/api/resources/voices/types/Weight.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voices/types/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./VoiceId";
+export * from "./BaseVoiceId";
+export * from "./Voice";
+export * from "./VoiceMetadata";
+export * from "./CreateVoiceRequest";
+export * from "./UpdateVoiceRequest";
+export * from "./LocalizeTargetLanguage";
+export * from "./LocalizeDialect";
+export * from "./Gender";
+export * from "./LocalizeVoiceRequest";
+export * from "./EmbeddingResponse";
+export * from "./MixVoicesRequest";
+export * from "./Weight";
+export * from "./IdSpecifier";
+export * from "./EmbeddingSpecifier";
+export * from "./MixVoiceSpecifier";
+export * from "./CloneMode";

package/dist/api/resources/voices/types/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./VoiceId"), exports);
+__exportStar(require("./BaseVoiceId"), exports);
+__exportStar(require("./Voice"), exports);
+__exportStar(require("./VoiceMetadata"), exports);
+__exportStar(require("./CreateVoiceRequest"), exports);
+__exportStar(require("./UpdateVoiceRequest"), exports);
+__exportStar(require("./LocalizeTargetLanguage"), exports);
+__exportStar(require("./LocalizeDialect"), exports);
+__exportStar(require("./Gender"), exports);
+__exportStar(require("./LocalizeVoiceRequest"), exports);
+__exportStar(require("./EmbeddingResponse"), exports);
+__exportStar(require("./MixVoicesRequest"), exports);
+__exportStar(require("./Weight"), exports);
+__exportStar(require("./IdSpecifier"), exports);
+__exportStar(require("./EmbeddingSpecifier"), exports);
+__exportStar(require("./MixVoiceSpecifier"), exports);
+__exportStar(require("./CloneMode"), exports);

package/dist/core/fetcher/APIResponse.d.ts

@@ -0,0 +1,10 @@
+export declare type APIResponse<Success, Failure> = SuccessfulResponse<Success> | FailedResponse<Failure>;
+export interface SuccessfulResponse<T> {
+    ok: true;
+    body: T;
+    headers?: Record<string, any>;
+}
+export interface FailedResponse<T> {
+    ok: false;
+    error: T;
+}

package/dist/core/fetcher/APIResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/fetcher/Fetcher.d.ts

@@ -0,0 +1,39 @@
+import { APIResponse } from "./APIResponse";
+export declare type FetchFunction = <R = unknown>(args: Fetcher.Args) => Promise<APIResponse<R, Fetcher.Error>>;
+export declare namespace Fetcher {
+    interface Args {
+        url: string;
+        method: string;
+        contentType?: string;
+        headers?: Record<string, string | undefined>;
+        queryParameters?: Record<string, string | string[] | object | object[]>;
+        body?: unknown;
+        timeoutMs?: number;
+        maxRetries?: number;
+        withCredentials?: boolean;
+        abortSignal?: AbortSignal;
+        requestType?: "json" | "file" | "bytes";
+        responseType?: "json" | "blob" | "sse" | "streaming" | "text";
+        duplex?: "half";
+    }
+    type Error = FailedStatusCodeError | NonJsonError | TimeoutError | UnknownError;
+    interface FailedStatusCodeError {
+        reason: "status-code";
+        statusCode: number;
+        body: unknown;
+    }
+    interface NonJsonError {
+        reason: "non-json";
+        statusCode: number;
+        rawBody: string;
+    }
+    interface TimeoutError {
+        reason: "timeout";
+    }
+    interface UnknownError {
+        reason: "unknown";
+        errorMessage: string;
+    }
+}
+export declare function fetcherImpl<R = unknown>(args: Fetcher.Args): Promise<APIResponse<R, Fetcher.Error>>;
+export declare const fetcher: FetchFunction;

package/dist/core/fetcher/Fetcher.js

@@ -0,0 +1,99 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetcher = exports.fetcherImpl = void 0;
+const createRequestUrl_1 = require("./createRequestUrl");
+const getFetchFn_1 = require("./getFetchFn");
+const getRequestBody_1 = require("./getRequestBody");
+const getResponseBody_1 = require("./getResponseBody");
+const makeRequest_1 = require("./makeRequest");
+const requestWithRetries_1 = require("./requestWithRetries");
+function fetcherImpl(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const headers = {};
+        if (args.body !== undefined && args.contentType != null) {
+            headers["Content-Type"] = args.contentType;
+        }
+        if (args.headers != null) {
+            for (const [key, value] of Object.entries(args.headers)) {
+                if (value != null) {
+                    headers[key] = value;
+                }
+            }
+        }
+        const url = (0, createRequestUrl_1.createRequestUrl)(args.url, args.queryParameters);
+        let requestBody = yield (0, getRequestBody_1.getRequestBody)({
+            body: args.body,
+            type: args.requestType === "json" ? "json" : "other",
+        });
+        const fetchFn = yield (0, getFetchFn_1.getFetchFn)();
+        try {
+            const response = yield (0, requestWithRetries_1.requestWithRetries)(() => __awaiter(this, void 0, void 0, function* () {
+                return (0, makeRequest_1.makeRequest)(fetchFn, url, args.method, headers, requestBody, args.timeoutMs, args.abortSignal, args.withCredentials, args.duplex);
+            }), args.maxRetries);
+            let responseBody = yield (0, getResponseBody_1.getResponseBody)(response, args.responseType);
+            if (response.status >= 200 && response.status < 400) {
+                return {
+                    ok: true,
+                    body: responseBody,
+                    headers: response.headers,
+                };
+            }
+            else {
+                return {
+                    ok: false,
+                    error: {
+                        reason: "status-code",
+                        statusCode: response.status,
+                        body: responseBody,
+                    },
+                };
+            }
+        }
+        catch (error) {
+            if (args.abortSignal != null && args.abortSignal.aborted) {
+                return {
+                    ok: false,
+                    error: {
+                        reason: "unknown",
+                        errorMessage: "The user aborted a request",
+                    },
+                };
+            }
+            else if (error instanceof Error && error.name === "AbortError") {
+                return {
+                    ok: false,
+                    error: {
+                        reason: "timeout",
+                    },
+                };
+            }
+            else if (error instanceof Error) {
+                return {
+                    ok: false,
+                    error: {
+                        reason: "unknown",
+                        errorMessage: error.message,
+                    },
+                };
+            }
+            return {
+                ok: false,
+                error: {
+                    reason: "unknown",
+                    errorMessage: JSON.stringify(error),
+                },
+            };
+        }
+    });
+}
+exports.fetcherImpl = fetcherImpl;
+exports.fetcher = fetcherImpl;

package/dist/core/fetcher/Supplier.d.ts

@@ -0,0 +1,4 @@
+export declare type Supplier<T> = T | Promise<T> | (() => T | Promise<T>);
+export declare const Supplier: {
+    get: <T>(supplier: Supplier<T>) => Promise<T>;
+};

package/dist/core/fetcher/Supplier.js

@@ -0,0 +1,22 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Supplier = void 0;
+exports.Supplier = {
+    get: (supplier) => __awaiter(void 0, void 0, void 0, function* () {
+        if (typeof supplier === "function") {
+            return supplier();
+        }
+        else {
+            return supplier;
+        }
+    }),
+};

package/dist/core/fetcher/createRequestUrl.d.ts

@@ -0,0 +1 @@
+export declare function createRequestUrl(baseUrl: string, queryParameters?: Record<string, string | string[] | object | object[]>): string;

package/dist/core/fetcher/createRequestUrl.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRequestUrl = void 0;
+const qs_1 = __importDefault(require("qs"));
+function createRequestUrl(baseUrl, queryParameters) {
+    return Object.keys(queryParameters !== null && queryParameters !== void 0 ? queryParameters : {}).length > 0
+        ? `${baseUrl}?${qs_1.default.stringify(queryParameters, { arrayFormat: "repeat" })}`
+        : baseUrl;
+}
+exports.createRequestUrl = createRequestUrl;

package/dist/core/fetcher/getFetchFn.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Returns a fetch function based on the runtime
+ */
+export declare function getFetchFn(): Promise<any>;