@convbased/sdk 0.1.0

package/dist/endpoints.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_SIGNALING_URL = "wss://api.weights.chat/api/signaling/ws";
+export declare const DEFAULT_GRAPHQL_URL = "https://api.weights.chat/api/v1/graphql";
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,4CACQ,CAAC;AAC3C,eAAO,MAAM,mBAAmB,4CACU,CAAC"}

package/dist/endpoints.js

@@ -0,0 +1,7 @@
+// Production endpoints baked into the SDK. These mirror Convbased-Web's
+// `.env` (VITE_WS_ENDPOINT / VITE_API_BASE_URL) and are considered stable —
+// they're consumed by every Convbased client today. Override only for
+// self-hosted deployments or local development.
+export const DEFAULT_SIGNALING_URL = "wss://api.weights.chat/api/signaling/ws";
+export const DEFAULT_GRAPHQL_URL = "https://api.weights.chat/api/v1/graphql";
+//# sourceMappingURL=endpoints.js.map

package/dist/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,4EAA4E;AAC5E,sEAAsE;AACtE,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GACjC,yCAAyC,CAAC;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAC/B,yCAAyC,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,9 @@
+export type Listener<T> = (payload: T) => void;
+export declare class TypedEmitter<TEvents extends Record<string, unknown>> {
+    private readonly listeners;
+    on<K extends keyof TEvents>(event: K, fn: Listener<TEvents[K]>): () => void;
+    off<K extends keyof TEvents>(event: K, fn: Listener<TEvents[K]>): void;
+    emit<K extends keyof TEvents>(event: K, payload: TEvents[K]): void;
+    removeAllListeners(): void;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAE/C,qBAAa,YAAY,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAEnB;IAEP,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAK3E,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAItE,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAalE,kBAAkB,IAAI,IAAI;CAK1B"}

package/dist/events.js

@@ -0,0 +1,35 @@
+// Minimal typed event emitter; we avoid pulling Node's EventEmitter so the
+// SDK stays browser-first with no polyfill chain.
+export class TypedEmitter {
+    constructor() {
+        this.listeners = {};
+    }
+    on(event, fn) {
+        var _a;
+        ((_a = this.listeners)[event] ?? (_a[event] = new Set())).add(fn);
+        return () => this.off(event, fn);
+    }
+    off(event, fn) {
+        this.listeners[event]?.delete(fn);
+    }
+    emit(event, payload) {
+        const set = this.listeners[event];
+        if (!set)
+            return;
+        for (const fn of set) {
+            try {
+                fn(payload);
+            }
+            catch (e) {
+                // Listeners shouldn't crash the emitter.
+                console.error(`[convbased-sdk] listener for "${String(event)}" threw:`, e);
+            }
+        }
+    }
+    removeAllListeners() {
+        for (const key of Object.keys(this.listeners)) {
+            delete this.listeners[key];
+        }
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,kDAAkD;AAIlD,MAAM,OAAO,YAAY;IAAzB;QACkB,cAAS,GAEtB,EAAE,CAAC;IA6BR,CAAC;IA3BA,EAAE,CAA0B,KAAQ,EAAE,EAAwB;;QAC7D,OAAC,IAAI,CAAC,SAAS,EAAC,KAAK,SAAL,KAAK,IAAM,IAAI,GAAG,EAAE,EAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAA0B,KAAQ,EAAE,EAAwB;QAC9D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAA0B,KAAQ,EAAE,OAAmB;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC;gBACJ,EAAE,CAAC,OAAO,CAAC,CAAC;YACb,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,yCAAyC;gBACzC,OAAO,CAAC,KAAK,CAAC,iCAAiC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YAC5E,CAAC;QACF,CAAC;IACF,CAAC;IAED,kBAAkB;QACjB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAoB,CAAC,CAAC;QAC7C,CAAC;IACF,CAAC;CACD"}

package/dist/graphql.d.ts

@@ -0,0 +1,18 @@
+export interface GraphQLAuth {
+    apiKey?: string;
+    accessToken?: string;
+}
+export interface GraphQLRequestArgs<V> extends GraphQLAuth {
+    graphqlUrl: string;
+    query: string;
+    variables?: V;
+    signal?: AbortSignal;
+}
+/**
+ * Issue a single GraphQL operation and return `data`. Throws on HTTP failure
+ * or when the response carries a non-empty `errors` array — the thrown
+ * `Error.message` is the first server-reported message (often an i18n key the
+ * caller can localize).
+ */
+export declare function graphqlRequest<T, V = Record<string, unknown>>(args: GraphQLRequestArgs<V>): Promise<T>;
+//# sourceMappingURL=graphql.d.ts.map

package/dist/graphql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,WAAW;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,CAAC,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAiCZ"}

package/dist/graphql.js

@@ -0,0 +1,37 @@
+// Shared GraphQL transport for the Convbased service. Authentication mirrors
+// the server middleware: `x-api-key: <key>` for API keys, or
+// `Authorization: Bearer <jwt>` for access tokens.
+/**
+ * Issue a single GraphQL operation and return `data`. Throws on HTTP failure
+ * or when the response carries a non-empty `errors` array — the thrown
+ * `Error.message` is the first server-reported message (often an i18n key the
+ * caller can localize).
+ */
+export async function graphqlRequest(args) {
+    const headers = {
+        "content-type": "application/json",
+    };
+    if (args.apiKey)
+        headers["x-api-key"] = args.apiKey;
+    else if (args.accessToken) {
+        headers["authorization"] = `Bearer ${args.accessToken}`;
+    }
+    const res = await fetch(args.graphqlUrl, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ query: args.query, variables: args.variables }),
+        signal: args.signal,
+    });
+    if (!res.ok) {
+        throw new Error(`GraphQL request failed: HTTP ${res.status} ${res.statusText}`);
+    }
+    const json = (await res.json());
+    if (json.errors?.length) {
+        throw new Error(json.errors.map((e) => e.message).join("; "));
+    }
+    if (json.data === undefined || json.data === null) {
+        throw new Error("GraphQL response contained no data");
+    }
+    return json.data;
+}
+//# sourceMappingURL=graphql.js.map

package/dist/graphql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6DAA6D;AAC7D,mDAAmD;AAcnD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,IAA2B;IAE3B,MAAM,OAAO,GAA2B;QACvC,cAAc,EAAE,kBAAkB;KAClC,CAAC;IACF,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;SAC/C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE;QACxC,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtE,MAAM,EAAE,IAAI,CAAC,MAAM;KACnB,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,gCAAgC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAC9D,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { ConvbasedClient, type TaskAckEvent, type TaskProgressEvent, type TaskFinishedEvent, type StartTaskOptions, type RunFileInferenceOptions, } from "./client.js";
+export { TtsClient, type TtsClientOptions, type TtsParams, type TtsJob, type TtsJobStatus, type TtsResult, type TtsPricing, type SubmitTtsOptions, type SynthesizeOptions, } from "./tts.js";
+export { uploadAudio, requestAudioUpload, putToPresigned, type PresignedUpload, type HeaderKV, } from "./upload.js";
+export { graphqlRequest, type GraphQLAuth } from "./graphql.js";
+export { applyOpusSdpOptions } from "./sdp.js";
+export { fetchRTCServers, DEFAULT_STUN_SERVERS, } from "./rtcServers.js";
+export { DEFAULT_SIGNALING_URL, DEFAULT_GRAPHQL_URL, } from "./endpoints.js";
+export { RTCStatusCode, type ConnectOptions, type ConnectionState, type ConnectionStats, type ConvbasedClientOptions, type FileInferencePreferences, type IncomingMessage, type OutgoingMessage, type RTCPreferences, type RTCServersConfig, type ServerMessageEvent, type TaskStatus, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,QAAQ,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EACN,eAAe,EACf,oBAAoB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,UAAU,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { ConvbasedClient, } from "./client.js";
+export { TtsClient, } from "./tts.js";
+export { uploadAudio, requestAudioUpload, putToPresigned, } from "./upload.js";
+export { graphqlRequest } from "./graphql.js";
+export { applyOpusSdpOptions } from "./sdp.js";
+export { fetchRTCServers, DEFAULT_STUN_SERVERS, } from "./rtcServers.js";
+export { DEFAULT_SIGNALING_URL, DEFAULT_GRAPHQL_URL, } from "./endpoints.js";
+export { RTCStatusCode, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,GAMf,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,SAAS,GAST,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,WAAW,EACX,kBAAkB,EAClB,cAAc,GAGd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAoB,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EACN,eAAe,EACf,oBAAoB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,aAAa,GAYb,MAAM,YAAY,CAAC"}

package/dist/rtcServers.d.ts

@@ -0,0 +1,13 @@
+import { type GraphQLAuth } from "./graphql.js";
+import type { RTCServersConfig } from "./types.js";
+/**
+ * Fetch TURN credentials from the Convbased GraphQL service. The query matches
+ * the one used by Convbased-Web's `getRTCServers`. Authentication uses the
+ * same API key / access token passed to the SDK.
+ */
+export declare function fetchRTCServers(args: GraphQLAuth & {
+    graphqlUrl: string;
+    signal?: AbortSignal;
+}): Promise<RTCServersConfig>;
+export declare const DEFAULT_STUN_SERVERS: RTCServersConfig[];
+//# sourceMappingURL=rtcServers.d.ts.map

package/dist/rtcServers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtcServers.d.ts","sourceRoot":"","sources":["../src/rtcServers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;GAIG;AACH,wBAAsB,eAAe,CACpC,IAAI,EAAE,WAAW,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,GACC,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,EAElD,CAAC"}

package/dist/rtcServers.js

@@ -0,0 +1,31 @@
+import { graphqlRequest } from "./graphql.js";
+/**
+ * Fetch TURN credentials from the Convbased GraphQL service. The query matches
+ * the one used by Convbased-Web's `getRTCServers`. Authentication uses the
+ * same API key / access token passed to the SDK.
+ */
+export async function fetchRTCServers(args) {
+    const data = await graphqlRequest({
+        graphqlUrl: args.graphqlUrl,
+        apiKey: args.apiKey,
+        accessToken: args.accessToken,
+        signal: args.signal,
+        query: /* GraphQL */ `
+			query {
+				rtcServers {
+					urls
+					username
+					credential
+				}
+			}
+		`,
+    });
+    if (!data.rtcServers) {
+        throw new Error("rtcServers returned an empty payload");
+    }
+    return data.rtcServers;
+}
+export const DEFAULT_STUN_SERVERS = [
+    { urls: ["stun:stun.l.google.com:19302"] },
+];
+//# sourceMappingURL=rtcServers.js.map

package/dist/rtcServers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtcServers.js","sourceRoot":"","sources":["../src/rtcServers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAoB,MAAM,cAAc,CAAC;AAGhE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,IAGC;IAED,MAAM,IAAI,GAAG,MAAM,cAAc,CAAoC;QACpE,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,aAAa,CAAC;;;;;;;;GAQpB;KACD,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC,UAAU,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAuB;IACvD,EAAE,IAAI,EAAE,CAAC,8BAA8B,CAAC,EAAE;CAC1C,CAAC"}

package/dist/sdp.d.ts

@@ -0,0 +1,6 @@
+export interface OpusSdpOptions {
+    bitrateKbps: number;
+    stereo: boolean;
+}
+export declare function applyOpusSdpOptions(sdp: string, opts: OpusSdpOptions): string;
+//# sourceMappingURL=sdp.d.ts.map

package/dist/sdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdp.d.ts","sourceRoot":"","sources":["../src/sdp.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAiC7E"}

package/dist/sdp.js

@@ -0,0 +1,34 @@
+// SDP mangling helpers. Mirrors `setAudioParameters` in Convbased-Web — we
+// rewrite the Opus `a=fmtp:` line so the offer requests our target bitrate,
+// stereo mode, and inband FEC. The signaling node passes the SDP through to
+// aiortc largely unchanged, so changes here directly shape the negotiated
+// audio.
+export function applyOpusSdpOptions(sdp, opts) {
+    const lines = sdp.split("\r\n");
+    let payloadType = null;
+    for (const line of lines) {
+        const match = line.match(/a=rtpmap:(\d+) opus\/48000\/2/);
+        if (match) {
+            payloadType = match[1];
+            break;
+        }
+    }
+    if (!payloadType)
+        return sdp;
+    let fmtpIndex = lines.findIndex((line) => line.startsWith(`a=fmtp:${payloadType}`));
+    if (fmtpIndex === -1) {
+        lines.push(`a=fmtp:${payloadType}`);
+        fmtpIndex = lines.length - 1;
+    }
+    let fmtp = lines[fmtpIndex];
+    fmtp = fmtp.replace(/;\s*stereo=\d/, "");
+    fmtp = fmtp.replace(/;\s*maxaveragebitrate=\d+/, "");
+    if (opts.stereo)
+        fmtp += "; stereo=1";
+    fmtp += `; maxaveragebitrate=${opts.bitrateKbps * 1000}`;
+    if (!fmtp.includes("useinbandfec=1"))
+        fmtp += "; useinbandfec=1";
+    lines[fmtpIndex] = fmtp;
+    return lines.join("\r\n");
+}
+//# sourceMappingURL=sdp.js.map

package/dist/sdp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdp.js","sourceRoot":"","sources":["../src/sdp.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,SAAS;AAOT,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,IAAoB;IACpE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,WAAW,GAAkB,IAAI,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC1D,IAAI,KAAK,EAAE,CAAC;YACX,WAAW,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACxB,MAAM;QACP,CAAC;IACF,CAAC;IAED,IAAI,CAAC,WAAW;QAAE,OAAO,GAAG,CAAC;IAE7B,IAAI,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CACxC,IAAI,CAAC,UAAU,CAAC,UAAU,WAAW,EAAE,CAAC,CACxC,CAAC;IAEF,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,UAAU,WAAW,EAAE,CAAC,CAAC;QACpC,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI,GAAG,KAAK,CAAC,SAAS,CAAE,CAAC;IAC7B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;IAErD,IAAI,IAAI,CAAC,MAAM;QAAE,IAAI,IAAI,YAAY,CAAC;IACtC,IAAI,IAAI,uBAAuB,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,CAAC;IACzD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,IAAI,IAAI,kBAAkB,CAAC;IAEjE,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}

package/dist/signaling.d.ts

@@ -0,0 +1,33 @@
+import type { IncomingMessage, OutgoingMessage } from "./types.js";
+export interface SignalingChannelOptions {
+    signalingUrl: string;
+    apiKey?: string;
+    accessToken?: string;
+    connectTimeoutMs: number;
+    logger: Pick<Console, "debug" | "info" | "warn" | "error">;
+}
+export interface SignalingHandlers {
+    onMessage: (msg: IncomingMessage) => void;
+    onClose: (event: CloseEvent) => void;
+    onError: (event: Event) => void;
+}
+/**
+ * Thin WebSocket wrapper for the Convbased signaling endpoint. Builds the URL
+ * (`${base}/signaling/ws?api_key=…`), waits for `open`, and exposes JSON
+ * send/recv plus a 10s keepalive ping to match the server's expectations.
+ */
+export declare class SignalingChannel {
+    private readonly opts;
+    private ws;
+    private pingTimer;
+    private handlers;
+    constructor(opts: SignalingChannelOptions);
+    get isOpen(): boolean;
+    connect(handlers: SignalingHandlers): Promise<void>;
+    send(msg: OutgoingMessage): void;
+    close(code?: number, reason?: string): void;
+    private handleMessage;
+    private handleClose;
+    private buildUrl;
+}
+//# sourceMappingURL=signaling.d.ts.map

package/dist/signaling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signaling.d.ts","sourceRoot":"","sources":["../src/signaling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACrC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAKhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAAkC;gBAErB,IAAI,EAAE,uBAAuB;IAE1D,IAAI,MAAM,IAAI,OAAO,CAEpB;IAEK,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiEzD,IAAI,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAOhC,KAAK,CAAC,IAAI,SAAO,EAAE,MAAM,SAAiB,GAAG,IAAI;IAejD,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,QAAQ;CAwBhB"}

package/dist/signaling.js

@@ -0,0 +1,142 @@
+/**
+ * Thin WebSocket wrapper for the Convbased signaling endpoint. Builds the URL
+ * (`${base}/signaling/ws?api_key=…`), waits for `open`, and exposes JSON
+ * send/recv plus a 10s keepalive ping to match the server's expectations.
+ */
+export class SignalingChannel {
+    constructor(opts) {
+        this.opts = opts;
+        this.ws = null;
+        this.pingTimer = null;
+        this.handlers = null;
+    }
+    get isOpen() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    async connect(handlers) {
+        if (this.ws) {
+            throw new Error("SignalingChannel is already connected");
+        }
+        this.handlers = handlers;
+        const url = this.buildUrl();
+        this.opts.logger.debug?.("[convbased-sdk] connecting signaling:", url);
+        const ws = new WebSocket(url);
+        this.ws = ws;
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                cleanup();
+                try {
+                    ws.close();
+                }
+                catch {
+                    /* ignore */
+                }
+                reject(new Error("Signaling WebSocket connect timeout"));
+            }, this.opts.connectTimeoutMs);
+            const onOpen = () => {
+                cleanup();
+                resolve();
+            };
+            const onError = (e) => {
+                cleanup();
+                reject(new Error(`Signaling WebSocket failed to open: ${describeEvent(e)}`));
+            };
+            const onClose = (e) => {
+                cleanup();
+                reject(new Error(`Signaling WebSocket closed before open (code=${e.code}, reason=${e.reason || "?"})`));
+            };
+            const cleanup = () => {
+                clearTimeout(timeout);
+                ws.removeEventListener("open", onOpen);
+                ws.removeEventListener("error", onError);
+                ws.removeEventListener("close", onClose);
+            };
+            ws.addEventListener("open", onOpen);
+            ws.addEventListener("error", onError);
+            ws.addEventListener("close", onClose);
+        });
+        ws.addEventListener("message", (e) => this.handleMessage(e));
+        ws.addEventListener("close", (e) => this.handleClose(e));
+        ws.addEventListener("error", (e) => this.handlers?.onError(e));
+        // The signaling server pings every 10s and expects us to keep the
+        // socket warm. We mirror that cadence rather than relying on TCP
+        // keepalive, which most browsers don't expose.
+        this.pingTimer = setInterval(() => {
+            if (this.isOpen)
+                this.send({ type: "ping" });
+        }, 10000);
+    }
+    send(msg) {
+        if (!this.isOpen) {
+            throw new Error("Signaling WebSocket is not open");
+        }
+        this.ws.send(JSON.stringify(msg));
+    }
+    close(code = 1000, reason = "client close") {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        if (this.ws && this.ws.readyState <= WebSocket.OPEN) {
+            try {
+                this.ws.close(code, reason);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.ws = null;
+    }
+    handleMessage(event) {
+        if (typeof event.data !== "string")
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(event.data);
+        }
+        catch (e) {
+            this.opts.logger.warn?.("[convbased-sdk] dropping non-JSON signaling frame:", event.data);
+            return;
+        }
+        this.handlers?.onMessage(parsed);
+    }
+    handleClose(event) {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        this.handlers?.onClose(event);
+    }
+    buildUrl() {
+        // `signalingUrl` may be:
+        //   - the full final URL ending in `/ws` (production default — used as-is)
+        //   - a bare host (e.g. `ws://localhost:3010`) — we append `/signaling/ws`
+        //   - something already containing `/signaling` — we append `/ws`
+        let base = this.opts.signalingUrl.trim();
+        if (base.endsWith("/"))
+            base = base.slice(0, -1);
+        let finalUrl;
+        if (/\/ws$/i.test(base)) {
+            finalUrl = base;
+        }
+        else if (/\/signaling$/i.test(base)) {
+            finalUrl = `${base}/ws`;
+        }
+        else {
+            finalUrl = `${base}/signaling/ws`;
+        }
+        const url = new URL(finalUrl);
+        if (this.opts.apiKey)
+            url.searchParams.set("api_key", this.opts.apiKey);
+        if (this.opts.accessToken && !this.opts.apiKey) {
+            url.searchParams.set("token", this.opts.accessToken);
+        }
+        return url.toString();
+    }
+}
+function describeEvent(e) {
+    if (e instanceof ErrorEvent && e.message)
+        return e.message;
+    return e.type || "unknown error";
+}
+//# sourceMappingURL=signaling.js.map

package/dist/signaling.js.map

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

package/dist/tts.d.ts

@@ -0,0 +1,111 @@
+/** Optional emotion / sampling controls forwarded verbatim to IndexTTS2. */
+export interface TtsParams {
+    emo_alpha?: number;
+    emo_vector?: number[];
+    use_emo_text?: boolean;
+    emo_text?: string;
+    temperature?: number;
+    top_p?: number;
+    top_k?: number;
+}
+export type TtsJobStatus = "queued" | "warming" | "processing" | "done" | "failed" | "cancelled";
+export interface TtsResult {
+    /** COS key of the synthesized audio. */
+    key: string;
+    /** Presigned URL of the synthesized audio (valid ~1h), or null if unsigned. */
+    url: string | null;
+    /** Input-text token count the charge was based on. */
+    tokenCount: number;
+    /** Duration of the synthesized audio, in seconds. */
+    audioDurationSec: number;
+    /** Amount deducted from the wallet for this synthesis. */
+    amountCharged: number;
+    /** Wallet balance after the deduction. */
+    balanceAfter: number;
+}
+export interface TtsJob {
+    jobId: string;
+    status: TtsJobStatus;
+    /** 1-based queue position while `queued`; 0 otherwise. */
+    position: number;
+    /** Result, populated once `status === "done"`. */
+    result: TtsResult | null;
+    /** Server-reported error key when `status === "failed"`. */
+    error: string | null;
+}
+export interface TtsPricing {
+    /** Price charged per input-text token. */
+    pricePerToken: number;
+    /** Minimum charge applied to any single synthesis. */
+    minCharge: number;
+}
+export interface TtsClientOptions {
+    /** Convbased API key. Required unless `accessToken` is provided. */
+    apiKey?: string;
+    /** Short-lived JWT access token (alternative to `apiKey`). */
+    accessToken?: string;
+    /**
+     * GraphQL endpoint. Defaults to the production Convbased endpoint
+     * (`https://api.weights.chat/api/v1/graphql`). Override for self-hosted
+     * deployments.
+     */
+    graphqlUrl?: string;
+    /** Optional logger; defaults to `console` for warn/error only. */
+    logger?: Partial<Pick<Console, "debug" | "info" | "warn" | "error">>;
+}
+export interface SubmitTtsOptions {
+    /** COS key of an already-uploaded reference voice (see `uploadReferenceAudio`). */
+    referenceKey: string;
+    /** Text to synthesize. */
+    text: string;
+    /** Optional emotion / sampling controls. */
+    params?: TtsParams;
+}
+export interface SynthesizeOptions {
+    /** COS key of an already-uploaded reference voice. Provide this or `referenceAudio`. */
+    referenceKey?: string;
+    /** A reference-voice `Blob`/`File` to upload first. Provide this or `referenceKey`. */
+    referenceAudio?: Blob;
+    /** Text to synthesize. */
+    text: string;
+    /** Optional emotion / sampling controls. */
+    params?: TtsParams;
+    /** Poll interval while waiting for the job, in ms. Default 1500. */
+    pollIntervalMs?: number;
+    /** Give up waiting after this many ms. Default 300_000 (5 min). */
+    timeoutMs?: number;
+    /** Abort the wait (and cancel the job if still queued). */
+    signal?: AbortSignal;
+    /** Called on every poll with the latest job snapshot (queue position, status…). */
+    onJob?: (job: TtsJob) => void;
+}
+export declare class TtsClient {
+    private readonly graphqlUrl;
+    private readonly apiKey?;
+    private readonly accessToken?;
+    private readonly logger;
+    constructor(options: TtsClientOptions);
+    /** Upload a reference-voice `Blob`/`File` and resolve its COS key. */
+    uploadReferenceAudio(file: Blob, opts?: {
+        filename?: string;
+        contentType?: string;
+        signal?: AbortSignal;
+    }): Promise<{
+        key: string;
+    }>;
+    /** Current billing rule: `cost = max(tokens * pricePerToken, minCharge)`. */
+    getPricing(signal?: AbortSignal): Promise<TtsPricing>;
+    /** Enqueue a synthesis job; resolves immediately with the queued job. */
+    submit(opts: SubmitTtsOptions, signal?: AbortSignal): Promise<TtsJob>;
+    /** Read the current status/result of a job. */
+    getJob(jobId: string, signal?: AbortSignal): Promise<TtsJob>;
+    /** Cancel a job. Only effective while it is still `queued`. */
+    cancel(jobId: string, signal?: AbortSignal): Promise<TtsJob>;
+    /**
+     * 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.
+     */
+    synthesize(opts: SynthesizeOptions): Promise<TtsResult>;
+}
+//# sourceMappingURL=tts.d.ts.map

package/dist/tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../src/tts.ts"],"names":[],"mappings":"AAcA,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GACrB,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,WAAW,CAAC;AAEf,MAAM,WAAW,SAAS;IACzB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAChC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,gBAAgB;IAChC,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IACjC,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mFAAmF;IACnF,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAgCD,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqD;gBAEhE,OAAO,EAAE,gBAAgB;IAgBrC,sEAAsE;IAChE,oBAAoB,CACzB,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACtE,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAY3B,6EAA6E;IACvE,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB3D,yEAAyE;IACnE,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB3E,+CAA+C;IACzC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBlE,+DAA+D;IACzD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBlE;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;CAyD7D"}