@convbased/sdk 0.1.0

package/dist/tts.js

@@ -0,0 +1,223 @@
+// Text-to-speech client for the Convbased IndexTTS2 service. This path is pure
+// GraphQL — it does not touch WebRTC or the signaling socket. Synthesis is
+// asynchronous: you submit a job, then poll until it reaches a terminal state.
+//
+// Typical flow:
+//   const tts = new TtsClient({ apiKey });
+//   const { key } = await tts.uploadReferenceAudio(file); // reference voice
+//   const result = await tts.synthesize({ referenceKey: key, text: "你好" });
+//   audio.src = result.url; // presigned, ~1h
+import { DEFAULT_GRAPHQL_URL } from "./endpoints.js";
+import { graphqlRequest } from "./graphql.js";
+import { uploadAudio } from "./upload.js";
+const JOB_FIELDS = /* GraphQL */ `
+	job_id
+	status
+	position
+	result {
+		key
+		url
+		token_count
+		audio_duration_sec
+		amount_charged
+		balance_after
+	}
+	error
+`;
+export class TtsClient {
+    constructor(options) {
+        if (!options.apiKey && !options.accessToken) {
+            throw new Error("TtsClient requires either `apiKey` or `accessToken`");
+        }
+        this.graphqlUrl = options.graphqlUrl ?? DEFAULT_GRAPHQL_URL;
+        this.apiKey = options.apiKey;
+        this.accessToken = options.accessToken;
+        const provided = options.logger ?? {};
+        this.logger = {
+            debug: provided.debug ?? (() => { }),
+            info: provided.info ?? (() => { }),
+            warn: provided.warn ?? console.warn.bind(console),
+            error: provided.error ?? console.error.bind(console),
+        };
+    }
+    /** Upload a reference-voice `Blob`/`File` and resolve its COS key. */
+    async uploadReferenceAudio(file, opts) {
+        return uploadAudio({
+            graphqlUrl: this.graphqlUrl,
+            apiKey: this.apiKey,
+            accessToken: this.accessToken,
+            file,
+            filename: opts?.filename,
+            contentType: opts?.contentType,
+            signal: opts?.signal,
+        });
+    }
+    /** Current billing rule: `cost = max(tokens * pricePerToken, minCharge)`. */
+    async getPricing(signal) {
+        const data = await graphqlRequest({
+            graphqlUrl: this.graphqlUrl,
+            apiKey: this.apiKey,
+            accessToken: this.accessToken,
+            signal,
+            query: /* GraphQL */ `
+				query {
+					ttsPricing {
+						price_per_token
+						min_charge
+					}
+				}
+			`,
+        });
+        return {
+            pricePerToken: data.ttsPricing.price_per_token,
+            minCharge: data.ttsPricing.min_charge,
+        };
+    }
+    /** Enqueue a synthesis job; resolves immediately with the queued job. */
+    async submit(opts, signal) {
+        const data = await graphqlRequest({
+            graphqlUrl: this.graphqlUrl,
+            apiKey: this.apiKey,
+            accessToken: this.accessToken,
+            signal,
+            query: /* GraphQL */ `
+				mutation SubmitTts($input: SynthesizeTtsInput!) {
+					submitTts(input: $input) {
+						${JOB_FIELDS}
+					}
+				}
+			`,
+            variables: {
+                input: {
+                    reference_key: opts.referenceKey,
+                    text: opts.text,
+                    params: opts.params ?? null,
+                },
+            },
+        });
+        return toJob(data.submitTts);
+    }
+    /** Read the current status/result of a job. */
+    async getJob(jobId, signal) {
+        const data = await graphqlRequest({
+            graphqlUrl: this.graphqlUrl,
+            apiKey: this.apiKey,
+            accessToken: this.accessToken,
+            signal,
+            query: /* GraphQL */ `
+				query TtsJob($jobId: String!) {
+					ttsJob(jobId: $jobId) {
+						${JOB_FIELDS}
+					}
+				}
+			`,
+            variables: { jobId },
+        });
+        return toJob(data.ttsJob);
+    }
+    /** Cancel a job. Only effective while it is still `queued`. */
+    async cancel(jobId, signal) {
+        const data = await graphqlRequest({
+            graphqlUrl: this.graphqlUrl,
+            apiKey: this.apiKey,
+            accessToken: this.accessToken,
+            signal,
+            query: /* GraphQL */ `
+				mutation CancelTtsJob($jobId: String!) {
+					cancelTtsJob(jobId: $jobId) {
+						${JOB_FIELDS}
+					}
+				}
+			`,
+            variables: { jobId },
+        });
+        return toJob(data.cancelTtsJob);
+    }
+    /**
+     * One-call synthesis: (optionally upload the reference voice,) submit, then
+     * poll until the job finishes. Resolves with the `TtsResult` on success;
+     * rejects if the job fails/cancels, times out, or `signal` aborts.
+     */
+    async synthesize(opts) {
+        if (!opts.referenceKey && !opts.referenceAudio) {
+            throw new Error("synthesize() requires either `referenceKey` or `referenceAudio`");
+        }
+        const pollIntervalMs = opts.pollIntervalMs ?? 1500;
+        const timeoutMs = opts.timeoutMs ?? 300000;
+        const deadline = Date.now() + timeoutMs;
+        const referenceKey = opts.referenceKey ??
+            (await this.uploadReferenceAudio(opts.referenceAudio, {
+                signal: opts.signal,
+            })).key;
+        const submitted = await this.submit({ referenceKey, text: opts.text, params: opts.params }, opts.signal);
+        opts.onJob?.(submitted);
+        let job = submitted;
+        try {
+            while (job.status !== "done") {
+                if (opts.signal?.aborted) {
+                    throw new DOMException("Aborted", "AbortError");
+                }
+                if (job.status === "failed") {
+                    throw new Error(job.error || "TTS job failed");
+                }
+                if (job.status === "cancelled") {
+                    throw new Error("TTS job was cancelled");
+                }
+                if (Date.now() > deadline) {
+                    throw new Error(`Timed out waiting for TTS job ${job.jobId} after ${timeoutMs}ms`);
+                }
+                await delay(pollIntervalMs, opts.signal);
+                job = await this.getJob(job.jobId, opts.signal);
+                opts.onJob?.(job);
+            }
+        }
+        catch (err) {
+            // Best-effort: stop a still-queued job so we don't pay for a result
+            // nobody is waiting for.
+            if (opts.signal?.aborted) {
+                this.cancel(job.jobId).catch(() => { });
+            }
+            throw err;
+        }
+        if (!job.result) {
+            throw new Error("TTS job is done but carried no result");
+        }
+        return job.result;
+    }
+}
+function toJob(wire) {
+    return {
+        jobId: wire.job_id,
+        status: wire.status,
+        position: wire.position,
+        result: wire.result
+            ? {
+                key: wire.result.key,
+                url: wire.result.url,
+                tokenCount: wire.result.token_count,
+                audioDurationSec: wire.result.audio_duration_sec,
+                amountCharged: wire.result.amount_charged,
+                balanceAfter: wire.result.balance_after,
+            }
+            : null,
+        error: wire.error,
+    };
+}
+function delay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new DOMException("Aborted", "AbortError"));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new DOMException("Aborted", "AbortError"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=tts.js.map

package/dist/tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.js","sourceRoot":"","sources":["../src/tts.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,2EAA2E;AAC3E,+EAA+E;AAC/E,EAAE;AACF,gBAAgB;AAChB,2CAA2C;AAC3C,6EAA6E;AAC7E,4EAA4E;AAC5E,8CAA8C;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgH1C,MAAM,UAAU,GAAG,aAAa,CAAC;;;;;;;;;;;;;CAahC,CAAC;AAEF,MAAM,OAAO,SAAS;IAMrB,YAAY,OAAyB;QACpC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG;YACb,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YACnC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YACjC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACjD,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;SACpD,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,oBAAoB,CACzB,IAAU,EACV,IAAwE;QAExE,OAAO,WAAW,CAAC;YAClB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI;YACJ,QAAQ,EAAE,IAAI,EAAE,QAAQ;YACxB,WAAW,EAAE,IAAI,EAAE,WAAW;YAC9B,MAAM,EAAE,IAAI,EAAE,MAAM;SACpB,CAAC,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,UAAU,CAAC,MAAoB;QACpC,MAAM,IAAI,GAAG,MAAM,cAAc,CAE9B;YACF,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM;YACN,KAAK,EAAE,aAAa,CAAC;;;;;;;IAOpB;SACD,CAAC,CAAC;QACH,OAAO;YACN,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,eAAe;YAC9C,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU;SACrC,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,MAAM,CAAC,IAAsB,EAAE,MAAoB;QACxD,MAAM,IAAI,GAAG,MAAM,cAAc,CAA4B;YAC5D,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM;YACN,KAAK,EAAE,aAAa,CAAC;;;QAGhB,UAAU;;;IAGd;YACD,SAAS,EAAE;gBACV,KAAK,EAAE;oBACN,aAAa,EAAE,IAAI,CAAC,YAAY;oBAChC,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;iBAC3B;aACD;SACD,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,MAAoB;QAC/C,MAAM,IAAI,GAAG,MAAM,cAAc,CAAyB;YACzD,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM;YACN,KAAK,EAAE,aAAa,CAAC;;;QAGhB,UAAU;;;IAGd;YACD,SAAS,EAAE,EAAE,KAAK,EAAE;SACpB,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,MAAoB;QAC/C,MAAM,IAAI,GAAG,MAAM,cAAc,CAA+B;YAC/D,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM;YACN,KAAK,EAAE,aAAa,CAAC;;;QAGhB,UAAU;;;IAGd;YACD,SAAS,EAAE,EAAE,KAAK,EAAE;SACpB,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,IAAuB;QACvC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACd,iEAAiE,CACjE,CAAC;QACH,CAAC;QACD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAO,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAExC,MAAM,YAAY,GACjB,IAAI,CAAC,YAAY;YACjB,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAe,EAAE;gBACtD,MAAM,EAAE,IAAI,CAAC,MAAM;aACnB,CAAC,CAAC,CAAC,GAAG,CAAC;QAET,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAClC,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EACtD,IAAI,CAAC,MAAM,CACX,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC;QAExB,IAAI,GAAG,GAAG,SAAS,CAAC;QACpB,IAAI,CAAC;YACJ,OAAO,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC9B,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;oBAC1B,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;gBACjD,CAAC;gBACD,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC7B,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAAC;gBAChD,CAAC;gBACD,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBAC1C,CAAC;gBACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CACd,iCAAiC,GAAG,CAAC,KAAK,UAAU,SAAS,IAAI,CACjE,CAAC;gBACH,CAAC;gBACD,MAAM,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBACzC,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChD,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,oEAAoE;YACpE,yBAAyB;YACzB,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACxC,CAAC;YACD,MAAM,GAAG,CAAC;QACX,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,GAAG,CAAC,MAAM,CAAC;IACnB,CAAC;CACD;AAED,SAAS,KAAK,CAAC,IAAgB;IAC9B,OAAO;QACN,KAAK,EAAE,IAAI,CAAC,MAAM;QAClB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YAClB,CAAC,CAAC;gBACA,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;gBACpB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;gBACpB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBACnC,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB;gBAChD,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;gBACzC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;aACvC;YACF,CAAC,CAAC,IAAI;QACP,KAAK,EAAE,IAAI,CAAC,KAAK;KACjB,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC9C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC5C,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;YAClD,OAAO;QACR,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC7B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACX,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAG,EAAE;YACpB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,194 @@
+export interface RTCServersConfig {
+    urls: string[];
+    username?: string;
+    credential?: string;
+}
+export interface RTCPreferences {
+    model_id: string;
+    sample_rate: number;
+    pitch?: number;
+    rms_mix_rate?: number;
+    f0_threshold?: number;
+    block_time?: number;
+    crossfade_time?: number;
+    extra_time?: number;
+    f0_autotune?: boolean;
+    f0_autotune_strength?: number;
+    proposed_pitch?: boolean;
+    proposed_pitch_threshold?: number;
+    enable_limiter?: boolean;
+    limiter_threshold?: number;
+    enable_lookahead?: boolean;
+    lookahead_time?: number;
+    formant?: number;
+    index_rate?: number;
+    protect?: number;
+    threshold?: number;
+    [key: string]: unknown;
+}
+/**
+ * Per-task parameters for offline file inference (voice-to-voice). Forwarded
+ * verbatim to the inference node alongside `task_start`. Distinct from the
+ * live `RTCPreferences` — file inference exposes `f0_method`, `use_pv`, etc.
+ */
+export interface FileInferencePreferences {
+    pitch?: number;
+    f0_method?: "rmvpe" | "fcpe";
+    f0_threshold?: number;
+    index_rate?: number;
+    protect?: number;
+    f0_autotune?: boolean;
+    f0_autotune_strength?: number;
+    proposed_pitch?: boolean;
+    proposed_pitch_threshold?: number;
+    sample_rate?: number;
+    formant?: number;
+    block_time?: number;
+    crossfade_time?: number;
+    extra_time?: number;
+    use_pv?: boolean;
+    rms_mix_rate?: number;
+    threshold?: number;
+    enable_limiter?: boolean;
+    limiter_threshold?: number;
+    enable_lookahead?: boolean;
+    lookahead_time?: number;
+    [key: string]: unknown;
+}
+export type OutgoingMessage = {
+    type: "offer";
+    sdp?: string;
+    preferences: RTCPreferences;
+} | {
+    type: "ice_candidate";
+    candidate: RTCIceCandidateInit;
+} | {
+    type: "config";
+    preferences: Partial<RTCPreferences>;
+} | {
+    type: "task_start";
+    task_id: string;
+    audio_key: string;
+    generate_name?: string;
+    format?: string;
+    preferences?: FileInferencePreferences;
+} | {
+    type: "task_stop";
+    task_id?: string;
+} | {
+    type: "exit";
+} | {
+    type: "ping";
+} | {
+    type: "pong";
+};
+export declare enum RTCStatusCode {
+    ERROR = 2000,
+    GPU_INSUFFICIENT = 2001,
+    DUPLICATE_CONNECTION = 2002,
+    MODEL_NOT_FOUND = 2003,
+    UNPAID_SERVICE = 2004,
+    REQUEST_TOO_FAST = 2005,
+    CONNECTED = 3000,
+    REQUEST_RECEIVED = 3001,
+    TRACK_READY = 3002,
+    RESPONSE_SENT = 3003,
+    LOADING_MODEL = 3004,
+    SERVICE_READY = 3009,
+    TASK_PROGRESS = 3010,
+    TASK_FINISHED = 3011,
+    TASK_ACK = 3012,
+    SHUTDOWN = 4000,
+    SERVER_CLOSED = 5000
+}
+export type TaskStatus = "success" | "failure" | "cancelled";
+export type IncomingMessage = {
+    type: "message" | "shutdown" | "error";
+    message?: string;
+    code?: number;
+} | {
+    type: "answer";
+    sdp: string;
+} | {
+    type: "ice_candidate";
+    candidate: RTCIceCandidateInit;
+} | {
+    type: "task_ack";
+    task_id: string;
+    status: "queued" | "started";
+    queue_position?: number;
+    code?: number;
+} | {
+    type: "task_progress";
+    task_id: string;
+    progress: number;
+    code?: number;
+} | {
+    type: "task_finished";
+    task_id: string;
+    status: TaskStatus;
+    result_key?: string;
+    download_url?: string;
+    error?: string;
+    code?: number;
+} | {
+    type: "ping";
+} | {
+    type: "pong";
+} | Record<string, unknown>;
+export type ConnectionState = "idle" | "signaling" | "negotiating" | "connecting" | "connected" | "closing" | "closed" | "error";
+export interface ConvbasedClientOptions {
+    /** Convbased API key issued in the Web console. Required unless `accessToken` is provided. */
+    apiKey?: string;
+    /** Optional JWT access token; takes a back seat to `apiKey` if both are provided. */
+    accessToken?: string;
+    /**
+     * Signaling WebSocket URL. Defaults to the production Convbased endpoint
+     * (`wss://api.weights.chat/api/signaling/ws`). Override only for
+     * self-hosted deployments. URLs ending in `/ws` are used as-is; bare
+     * hosts get `/signaling/ws` appended.
+     */
+    signalingUrl?: string;
+    /**
+     * GraphQL endpoint used to fetch TURN credentials. Defaults to the
+     * production Convbased endpoint (`https://api.weights.chat/api/v1/graphql`).
+     * Pass `false` to disable the auto-fetch entirely (will fall back to
+     * `iceServers` if provided, else public STUN).
+     */
+    graphqlUrl?: string | false;
+    /** Statically-configured ICE servers. If omitted and `graphqlUrl` is set, the SDK fetches `rtcServers`. */
+    iceServers?: RTCServersConfig[];
+    /** `relay` forces TURN-only — useful when STUN is blocked. */
+    iceTransportPolicy?: RTCIceTransportPolicy;
+    /** Opus bitrate in kbps. Default 64. */
+    bitrate?: number;
+    /** Send stereo. Default false. */
+    stereo?: boolean;
+    /** How long to wait for `SERVICE_READY` after sending the offer, in ms. Default 120_000. */
+    signalingTimeoutMs?: number;
+    /** How long to wait for the initial WebSocket open, in ms. Default 20_000. */
+    connectTimeoutMs?: number;
+    /** Optional logger; defaults to `console` for warn/error only. */
+    logger?: Partial<Pick<Console, "debug" | "info" | "warn" | "error">>;
+}
+export interface ConnectOptions {
+    /** Model ID to load on the inference node — required. */
+    modelId: string;
+    /** Microphone constraints. Pass an existing `MediaStream` to skip getUserMedia entirely. */
+    audio?: MediaStream | MediaTrackConstraints | boolean;
+    /** Additional RVC preferences forwarded to the node. */
+    preferences?: Partial<Omit<RTCPreferences, "model_id" | "sample_rate">>;
+    /** Sample rate to advertise to the node. Defaults to the AudioContext's `sampleRate`, falling back to 48000. */
+    sampleRate?: number;
+}
+export interface ConnectionStats {
+    rttMs: number;
+    jitter: number;
+    packetsLost: number;
+}
+export interface ServerMessageEvent {
+    code?: number;
+    message?: string;
+    raw: IncomingMessage;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,23 @@
+// Wire-protocol types mirrored from ServerAPI / signaling.
+export var RTCStatusCode;
+(function (RTCStatusCode) {
+    RTCStatusCode[RTCStatusCode["ERROR"] = 2000] = "ERROR";
+    RTCStatusCode[RTCStatusCode["GPU_INSUFFICIENT"] = 2001] = "GPU_INSUFFICIENT";
+    RTCStatusCode[RTCStatusCode["DUPLICATE_CONNECTION"] = 2002] = "DUPLICATE_CONNECTION";
+    RTCStatusCode[RTCStatusCode["MODEL_NOT_FOUND"] = 2003] = "MODEL_NOT_FOUND";
+    RTCStatusCode[RTCStatusCode["UNPAID_SERVICE"] = 2004] = "UNPAID_SERVICE";
+    RTCStatusCode[RTCStatusCode["REQUEST_TOO_FAST"] = 2005] = "REQUEST_TOO_FAST";
+    RTCStatusCode[RTCStatusCode["CONNECTED"] = 3000] = "CONNECTED";
+    RTCStatusCode[RTCStatusCode["REQUEST_RECEIVED"] = 3001] = "REQUEST_RECEIVED";
+    RTCStatusCode[RTCStatusCode["TRACK_READY"] = 3002] = "TRACK_READY";
+    RTCStatusCode[RTCStatusCode["RESPONSE_SENT"] = 3003] = "RESPONSE_SENT";
+    RTCStatusCode[RTCStatusCode["LOADING_MODEL"] = 3004] = "LOADING_MODEL";
+    RTCStatusCode[RTCStatusCode["SERVICE_READY"] = 3009] = "SERVICE_READY";
+    // File inference (voice-to-voice) task lifecycle codes.
+    RTCStatusCode[RTCStatusCode["TASK_PROGRESS"] = 3010] = "TASK_PROGRESS";
+    RTCStatusCode[RTCStatusCode["TASK_FINISHED"] = 3011] = "TASK_FINISHED";
+    RTCStatusCode[RTCStatusCode["TASK_ACK"] = 3012] = "TASK_ACK";
+    RTCStatusCode[RTCStatusCode["SHUTDOWN"] = 4000] = "SHUTDOWN";
+    RTCStatusCode[RTCStatusCode["SERVER_CLOSED"] = 5000] = "SERVER_CLOSED";
+})(RTCStatusCode || (RTCStatusCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2DAA2D;AA+E3D,MAAM,CAAN,IAAY,aAsBX;AAtBD,WAAY,aAAa;IACxB,sDAAY,CAAA;IACZ,4EAAuB,CAAA;IACvB,oFAA2B,CAAA;IAC3B,0EAAsB,CAAA;IACtB,wEAAqB,CAAA;IACrB,4EAAuB,CAAA;IAEvB,8DAAgB,CAAA;IAChB,4EAAuB,CAAA;IACvB,kEAAkB,CAAA;IAClB,sEAAoB,CAAA;IACpB,sEAAoB,CAAA;IACpB,sEAAoB,CAAA;IAEpB,wDAAwD;IACxD,sEAAoB,CAAA;IACpB,sEAAoB,CAAA;IACpB,4DAAe,CAAA;IAEf,4DAAe,CAAA;IACf,sEAAoB,CAAA;AACrB,CAAC,EAtBW,aAAa,KAAb,aAAa,QAsBxB"}

package/dist/upload.d.ts

@@ -0,0 +1,46 @@
+import { type GraphQLAuth } from "./graphql.js";
+export interface HeaderKV {
+    name: string;
+    value: string;
+}
+export interface PresignedUpload {
+    /** COS object key — pass this back to the service (e.g. as `reference_key` / `audio_key`). */
+    key: string;
+    /** Presigned URL to PUT the bytes to. */
+    upload_url: string;
+    /** HTTP method to use for the upload (always `PUT` today). */
+    method: string;
+    /** Headers the upload request must include (notably `Content-Type`). */
+    headers: HeaderKV[];
+    /** Seconds until the presigned URL expires. */
+    expires_in: number;
+    bucket?: string | null;
+    region?: string | null;
+    /** CDN base URL for the bucket, when configured. */
+    url?: string | null;
+}
+/** Ask the service for a presigned PUT for an audio file. */
+export declare function requestAudioUpload(args: GraphQLAuth & {
+    graphqlUrl: string;
+    filename: string;
+    contentType: string;
+    size: number;
+    signal?: AbortSignal;
+}): Promise<PresignedUpload>;
+/** PUT raw bytes to a presigned upload target. */
+export declare function putToPresigned(presigned: PresignedUpload, body: Blob | ArrayBuffer | ArrayBufferView, signal?: AbortSignal): Promise<void>;
+/**
+ * Upload an audio `Blob`/`File` end-to-end (presign + PUT) and resolve the COS
+ * `key`. Filename and content type are taken from the `File` when available;
+ * override via `opts` when uploading a bare `Blob`.
+ */
+export declare function uploadAudio(args: GraphQLAuth & {
+    graphqlUrl: string;
+    file: Blob;
+    filename?: string;
+    contentType?: string;
+    signal?: AbortSignal;
+}): Promise<{
+    key: string;
+}>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAMA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,8FAA8F;IAC9F,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAoBD,6DAA6D;AAC7D,wBAAsB,kBAAkB,CACvC,IAAI,EAAE,WAAW,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,GACC,OAAO,CAAC,eAAe,CAAC,CAgB1B;AAED,kDAAkD;AAClD,wBAAsB,cAAc,CACnC,SAAS,EAAE,eAAe,EAC1B,IAAI,EAAE,IAAI,GAAG,WAAW,GAAG,eAAe,EAC1C,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAChC,IAAI,EAAE,WAAW,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,GACC,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB1B"}

package/dist/upload.js

@@ -0,0 +1,82 @@
+// Audio upload helpers shared by TTS (reference voice) and file inference
+// (source audio). Two steps mirror Convbased-Web: ask the GraphQL service for
+// a presigned PUT (`requestAudioUpload`), then PUT the bytes straight to object
+// storage. The returned COS `key` is what you hand to `submitTts` /
+// `startTask`.
+import { graphqlRequest } from "./graphql.js";
+const REQUEST_AUDIO_UPLOAD = /* GraphQL */ `
+	mutation RequestAudioUpload($input: RequestUploadInput!) {
+		requestAudioUpload(input: $input) {
+			key
+			upload_url
+			method
+			expires_in
+			headers {
+				name
+				value
+			}
+			bucket
+			region
+			url
+		}
+	}
+`;
+/** Ask the service for a presigned PUT for an audio file. */
+export async function requestAudioUpload(args) {
+    const data = await graphqlRequest({
+        graphqlUrl: args.graphqlUrl,
+        apiKey: args.apiKey,
+        accessToken: args.accessToken,
+        signal: args.signal,
+        query: REQUEST_AUDIO_UPLOAD,
+        variables: {
+            input: {
+                filename: args.filename,
+                content_type: args.contentType,
+                size: args.size,
+            },
+        },
+    });
+    return data.requestAudioUpload;
+}
+/** PUT raw bytes to a presigned upload target. */
+export async function putToPresigned(presigned, body, signal) {
+    const headers = {};
+    for (const h of presigned.headers ?? []) {
+        if (h?.name)
+            headers[h.name] = h.value;
+    }
+    const res = await fetch(presigned.upload_url, {
+        method: presigned.method || "PUT",
+        headers,
+        body: body,
+        signal,
+    });
+    if (!res.ok) {
+        throw new Error(`Audio upload failed: HTTP ${res.status} ${res.statusText}`);
+    }
+}
+/**
+ * Upload an audio `Blob`/`File` end-to-end (presign + PUT) and resolve the COS
+ * `key`. Filename and content type are taken from the `File` when available;
+ * override via `opts` when uploading a bare `Blob`.
+ */
+export async function uploadAudio(args) {
+    const maybeFile = args.file;
+    const filename = args.filename ?? maybeFile.name ?? "audio.wav";
+    const contentType = args.contentType ||
+        args.file.type ||
+        "application/octet-stream";
+    const presigned = await requestAudioUpload({
+        graphqlUrl: args.graphqlUrl,
+        apiKey: args.apiKey,
+        accessToken: args.accessToken,
+        signal: args.signal,
+        filename,
+        contentType,
+        size: args.file.size,
+    });
+    await putToPresigned(presigned, args.file, args.signal);
+    return { key: presigned.key };
+}
+//# sourceMappingURL=upload.js.map

package/dist/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,gFAAgF;AAChF,oEAAoE;AACpE,eAAe;AAEf,OAAO,EAAE,cAAc,EAAoB,MAAM,cAAc,CAAC;AAwBhE,MAAM,oBAAoB,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;CAgB1C,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,IAMC;IAED,MAAM,IAAI,GAAG,MAAM,cAAc,CAA0C;QAC1E,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,oBAAoB;QAC3B,SAAS,EAAE;YACV,KAAK,EAAE;gBACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,YAAY,EAAE,IAAI,CAAC,WAAW;gBAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;aACf;SACD;KACD,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,kBAAkB,CAAC;AAChC,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,SAA0B,EAC1B,IAA0C,EAC1C,MAAoB;IAEpB,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,CAAC,EAAE,IAAI;YAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IACxC,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE;QAC7C,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,KAAK;QACjC,OAAO;QACP,IAAI,EAAE,IAAgB;QACtB,MAAM;KACN,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,6BAA6B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAC3D,CAAC;IACH,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,IAMC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAY,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,IAAI,WAAW,CAAC;IAChE,MAAM,WAAW,GAChB,IAAI,CAAC,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI;QACd,0BAA0B,CAAC;IAE5B,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC;QAC1C,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ;QACR,WAAW;QACX,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;KACpB,CAAC,CAAC;IAEH,MAAM,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,CAAC;AAC/B,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+	"name": "@convbased/sdk",
+	"version": "0.1.0",
+	"description": "Convbased real-time voice conversion SDK — connect to the signaling service with an API key and stream audio through WebRTC.",
+	"type": "module",
+	"main": "./dist/cjs/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/cjs/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"src",
+		"README.md",
+		"LICENSE"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/emit-cjs-pkg.mjs && node scripts/bundle.mjs",
+		"build:bundle": "node scripts/bundle.mjs",
+		"typecheck": "tsc --noEmit",
+		"clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+		"prepublishOnly": "npm run clean && npm run build",
+		"demo": "npm run build && node scripts/serve-demo.mjs",
+		"serve": "node scripts/serve-demo.mjs"
+	},
+	"keywords": [
+		"convbased",
+		"webrtc",
+		"voice-conversion",
+		"realtime",
+		"audio",
+		"sdk"
+	],
+	"author": "Convbased",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Convbased/convbased-sdk.git",
+		"directory": "packages/sdk-js"
+	},
+	"homepage": "https://github.com/Convbased/convbased-sdk/tree/main/packages/sdk-js#readme",
+	"bugs": "https://github.com/Convbased/convbased-sdk/issues",
+	"devDependencies": {
+		"typescript": "^5.9.3"
+	},
+	"engines": {
+		"node": ">=18"
+	}
+}