@corti/sdk 1.0.0-alpha → 1.0.0-alpha.1

package/dist/cjs/custom/overrides/index.d.ts

@@ -0,0 +1,14 @@
+export * as Corti from "../../api/index.js";
+export type { BaseClientOptions, BaseRequestOptions } from "../../BaseClient.js";
+export { CortiEnvironment, type CortiEnvironmentUrls } from "../../environments.js";
+export { CortiError, CortiTimeoutError } from "../../errors/index.js";
+export * from "../../exports.js";
+export * as serialization from "../../serialization/index.js";
+export { CortiAuth } from "../auth/CortiAuth.js";
+export { CortiClient } from "../CortiClient.js";
+export { CortiWebSocketProxyClient } from "../CortiWebSocketProxyClient.js";
+export { type ProxyOptions } from "../utils/encodeHeadersAsWsProtocols.js";
+export { type CortiInternalEnvironment, type Environment } from "../utils/environment.js";
+export { CortiSDKError, CortiSDKErrorCodes } from "../CortiSDKError.js";
+export { ParseError } from "../../core/schemas/builders/schema-utils/ParseError.js";
+export { JsonError } from "../../core/schemas/builders/schema-utils/JsonError.js";

package/dist/cjs/custom/overrides/index.js

@@ -0,0 +1,61 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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 });
+exports.JsonError = exports.ParseError = exports.CortiSDKErrorCodes = exports.CortiSDKError = exports.CortiWebSocketProxyClient = exports.CortiClient = exports.CortiAuth = exports.serialization = exports.CortiTimeoutError = exports.CortiError = exports.CortiEnvironment = exports.Corti = void 0;
+exports.Corti = __importStar(require("../../api/index.js"));
+var environments_js_1 = require("../../environments.js");
+Object.defineProperty(exports, "CortiEnvironment", { enumerable: true, get: function () { return environments_js_1.CortiEnvironment; } });
+var index_js_1 = require("../../errors/index.js");
+Object.defineProperty(exports, "CortiError", { enumerable: true, get: function () { return index_js_1.CortiError; } });
+Object.defineProperty(exports, "CortiTimeoutError", { enumerable: true, get: function () { return index_js_1.CortiTimeoutError; } });
+__exportStar(require("../../exports.js"), exports);
+exports.serialization = __importStar(require("../../serialization/index.js"));
+// Custom additions / replacements
+var CortiAuth_js_1 = require("../auth/CortiAuth.js");
+Object.defineProperty(exports, "CortiAuth", { enumerable: true, get: function () { return CortiAuth_js_1.CortiAuth; } });
+var CortiClient_js_1 = require("../CortiClient.js");
+Object.defineProperty(exports, "CortiClient", { enumerable: true, get: function () { return CortiClient_js_1.CortiClient; } });
+var CortiWebSocketProxyClient_js_1 = require("../CortiWebSocketProxyClient.js");
+Object.defineProperty(exports, "CortiWebSocketProxyClient", { enumerable: true, get: function () { return CortiWebSocketProxyClient_js_1.CortiWebSocketProxyClient; } });
+var CortiSDKError_js_1 = require("../CortiSDKError.js");
+Object.defineProperty(exports, "CortiSDKError", { enumerable: true, get: function () { return CortiSDKError_js_1.CortiSDKError; } });
+Object.defineProperty(exports, "CortiSDKErrorCodes", { enumerable: true, get: function () { return CortiSDKError_js_1.CortiSDKErrorCodes; } });
+var ParseError_js_1 = require("../../core/schemas/builders/schema-utils/ParseError.js");
+Object.defineProperty(exports, "ParseError", { enumerable: true, get: function () { return ParseError_js_1.ParseError; } });
+var JsonError_js_1 = require("../../core/schemas/builders/schema-utils/JsonError.js");
+Object.defineProperty(exports, "JsonError", { enumerable: true, get: function () { return JsonError_js_1.JsonError; } });

package/dist/cjs/custom/proxy/CustomProxyStream.d.ts

@@ -0,0 +1,17 @@
+import * as Corti from "../../api/index.js";
+import type { CustomStreamSocket } from "../stream/CustomStreamSocket.js";
+import type { ProxyOptions } from "../utils/encodeHeadersAsWsProtocols.js";
+/**
+ * Lightweight proxy stream client — no CortiClient or auth needed.
+ * Pass a proxy URL (and optionally protocols/queryParameters) directly in connect().
+ */
+export declare class CustomProxyStream {
+    private readonly _stream;
+    connect(args: {
+        proxy: ProxyOptions;
+        configuration?: Corti.StreamConfig;
+        awaitConfiguration?: boolean;
+        debug?: boolean;
+        reconnectAttempts?: number;
+    }): Promise<CustomStreamSocket>;
+}

package/dist/cjs/custom/proxy/CustomProxyStream.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomProxyStream = void 0;
+const environments_js_1 = require("../../environments.js");
+const CustomStream_js_1 = require("../stream/CustomStream.js");
+/**
+ * Lightweight proxy stream client — no CortiClient or auth needed.
+ * Pass a proxy URL (and optionally protocols/queryParameters) directly in connect().
+ */
+class CustomProxyStream {
+    constructor() {
+        this._stream = new CustomStream_js_1.CustomStream({ environment: environments_js_1.CortiEnvironment.Eu, tenantName: "" });
+    }
+    connect(args) {
+        return this._stream.connect(Object.assign(Object.assign({}, args), { id: "" }));
+    }
+}
+exports.CustomProxyStream = CustomProxyStream;

package/dist/cjs/custom/proxy/CustomProxyTranscribe.d.ts

@@ -0,0 +1,17 @@
+import * as Corti from "../../api/index.js";
+import type { CustomTranscribeSocket } from "../transcribe/CustomTranscribeSocket.js";
+import type { ProxyOptions } from "../utils/encodeHeadersAsWsProtocols.js";
+/**
+ * Lightweight proxy transcribe client — no CortiClient or auth needed.
+ * Pass a proxy URL (and optionally protocols/queryParameters) directly in connect().
+ */
+export declare class CustomProxyTranscribe {
+    private readonly _transcribe;
+    connect(args: {
+        proxy: ProxyOptions;
+        configuration?: Corti.TranscribeConfig;
+        awaitConfiguration?: boolean;
+        debug?: boolean;
+        reconnectAttempts?: number;
+    }): Promise<CustomTranscribeSocket>;
+}

package/dist/cjs/custom/proxy/CustomProxyTranscribe.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomProxyTranscribe = void 0;
+const environments_js_1 = require("../../environments.js");
+const CustomTranscribe_js_1 = require("../transcribe/CustomTranscribe.js");
+/**
+ * Lightweight proxy transcribe client — no CortiClient or auth needed.
+ * Pass a proxy URL (and optionally protocols/queryParameters) directly in connect().
+ */
+class CustomProxyTranscribe {
+    constructor() {
+        this._transcribe = new CustomTranscribe_js_1.CustomTranscribe({
+            environment: environments_js_1.CortiEnvironment.Eu,
+            tenantName: "",
+        });
+    }
+    connect(args) {
+        return this._transcribe.connect(args);
+    }
+}
+exports.CustomProxyTranscribe = CustomProxyTranscribe;

package/dist/cjs/custom/stream/CustomStream.d.ts

@@ -0,0 +1,39 @@
+import { StreamClient } from "../../api/resources/stream/client/Client.js";
+import { CustomStreamSocket } from "./CustomStreamSocket.js";
+import * as Corti from "../../api/index.js";
+import { type ProxyOptions } from "../utils/encodeHeadersAsWsProtocols.js";
+export type CustomStreamConnectArgs = {
+    id: string;
+    /** When provided, connect() resolves after CONFIG_ACCEPTED or rejects on failure. */
+    configuration?: Corti.StreamConfig;
+    /**
+     * When true (default), connect() resolves after CONFIG_ACCEPTED or rejects on failure.
+     * When false, returns socket immediately; config errors are dispatched as ErrorEvent.
+     */
+    awaitConfiguration?: boolean;
+    /**
+     * When provided, bypasses normal URL construction and auth. The WebSocket connects
+     * directly to proxy.url. Useful for proxy backends that handle auth themselves.
+     */
+    proxy?: ProxyOptions;
+} & Partial<Omit<StreamClient.ConnectArgs, "id" | "tenantName" | "token">>;
+export declare class CustomStream extends StreamClient {
+    private readonly _encodeHeadersAsWsProtocols;
+    constructor(options: StreamClient.Options & {
+        encodeHeadersAsWsProtocols?: boolean;
+    });
+    connect(args: CustomStreamConnectArgs): Promise<CustomStreamSocket>;
+    /**
+     * Sends configuration on open, then resolves after CONFIG_ACCEPTED.
+     * Rejects and closes socket on CONFIG_DENIED / CONFIG_MISSING / CONFIG_TIMEOUT /
+     * CONFIG_NOT_PROVIDED / connection error / ENDED.
+     */
+    private _connectWithConfigAck;
+    /**
+     * Sends configuration on open and returns the socket immediately.
+     * Config errors are dispatched as ErrorEvent and the socket is closed.
+     */
+    private _connectWithConfigListeners;
+    /** Resolves on CONFIG_ACCEPTED; rejects on rejection types, socket error, or ENDED. */
+    private _buildConfigAckPromise;
+}

package/dist/cjs/custom/stream/CustomStream.js

@@ -0,0 +1,183 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomStream = void 0;
+const Client_js_1 = require("../../api/resources/stream/client/Client.js");
+const CustomStreamSocket_js_1 = require("./CustomStreamSocket.js");
+const Corti = __importStar(require("../../api/index.js"));
+const events_js_1 = require("../../core/websocket/events.js");
+const parseStreamResponseType_js_1 = require("./parseStreamResponseType.js");
+const core = __importStar(require("../../core/index.js"));
+const encodeHeadersAsWsProtocols_js_1 = require("../utils/encodeHeadersAsWsProtocols.js");
+const STREAM_CONFIG_REJECTION_TYPES = [
+    Corti.StreamConfigStatusMessageType.ConfigDenied,
+    Corti.StreamConfigStatusMessageType.ConfigMissing,
+    Corti.StreamConfigStatusMessageType.ConfigTimeout,
+    Corti.StreamConfigStatusMessageType.ConfigNotProvided,
+];
+class CustomStream extends Client_js_1.StreamClient {
+    constructor(options) {
+        super(options);
+        this._encodeHeadersAsWsProtocols = options.encodeHeadersAsWsProtocols;
+    }
+    connect(args) {
+        const _super = Object.create(null, {
+            connect: { get: () => super.connect }
+        });
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { configuration, awaitConfiguration = true, proxy } = args, rest = __rest(args, ["configuration", "awaitConfiguration", "proxy"]);
+            const useProxyPath = proxy || this._encodeHeadersAsWsProtocols;
+            const protocols = yield (0, encodeHeadersAsWsProtocols_js_1.getWsProtocols)(Object.assign(Object.assign({}, this._options), { encodeHeadersAsWsProtocols: this._encodeHeadersAsWsProtocols }), proxy === null || proxy === void 0 ? void 0 : proxy.protocols);
+            const socket = useProxyPath
+                ? new core.ReconnectingWebSocket({
+                    url: (_a = proxy === null || proxy === void 0 ? void 0 : proxy.url) !== null && _a !== void 0 ? _a : core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)).wss, `/interactions/${core.url.encodePathParam(rest.id)}/streams`),
+                    protocols,
+                    queryParameters: (_c = proxy === null || proxy === void 0 ? void 0 : proxy.queryParameters) !== null && _c !== void 0 ? _c : {},
+                    headers: (_d = rest.headers) !== null && _d !== void 0 ? _d : {},
+                    options: { debug: (_e = rest.debug) !== null && _e !== void 0 ? _e : false, maxRetries: (_f = rest.reconnectAttempts) !== null && _f !== void 0 ? _f : 30 },
+                })
+                : (yield _super.connect.call(this, Object.assign(Object.assign({}, rest), { token: ((_h = (yield ((_g = this._options.authProvider) === null || _g === void 0 ? void 0 : _g.getAuthRequest()))) === null || _h === void 0 ? void 0 : _h.headers.Authorization) || "", tenantName: yield core.Supplier.get(this._options.tenantName) }))).socket;
+            const ws = new CustomStreamSocket_js_1.CustomStreamSocket({ socket });
+            if (!configuration) {
+                return ws;
+            }
+            if (awaitConfiguration) {
+                return this._connectWithConfigAck(ws, configuration);
+            }
+            return this._connectWithConfigListeners(ws, configuration);
+        });
+    }
+    /**
+     * Sends configuration on open, then resolves after CONFIG_ACCEPTED.
+     * Rejects and closes socket on CONFIG_DENIED / CONFIG_MISSING / CONFIG_TIMEOUT /
+     * CONFIG_NOT_PROVIDED / connection error / ENDED.
+     */
+    _connectWithConfigAck(socket, configuration) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const configAck = this._buildConfigAckPromise(socket);
+            yield socket.waitForOpen();
+            socket.sendConfiguration({ type: "config", configuration });
+            try {
+                yield configAck;
+            }
+            catch (err) {
+                socket.close();
+                throw err;
+            }
+            // Persistent listener re-sends config on each reconnect
+            socket.socket.addEventListener("open", () => {
+                socket.sendConfiguration({ type: "config", configuration });
+            });
+            return socket;
+        });
+    }
+    /**
+     * Sends configuration on open and returns the socket immediately.
+     * Config errors are dispatched as ErrorEvent and the socket is closed.
+     */
+    _connectWithConfigListeners(socket, configuration) {
+        socket.socket.addEventListener("open", () => {
+            socket.sendConfiguration({ type: "config", configuration });
+        });
+        socket.socket.addEventListener("message", (event) => {
+            const type = (0, parseStreamResponseType_js_1.parseStreamResponseType)(event.data);
+            if (type == null || type === Corti.StreamConfigStatusMessageType.ConfigAccepted) {
+                return;
+            }
+            if (STREAM_CONFIG_REJECTION_TYPES.includes(type) || type === "error") {
+                socket.socket.dispatchEvent(new events_js_1.ErrorEvent(new Error(type), socket.socket));
+                socket.close();
+            }
+            else if (type === "ENDED") {
+                socket.close();
+            }
+        });
+        return socket;
+    }
+    /** Resolves on CONFIG_ACCEPTED; rejects on rejection types, socket error, or ENDED. */
+    _buildConfigAckPromise(socket) {
+        return new Promise((resolve, reject) => {
+            const cleanup = () => {
+                socket.socket.removeEventListener("message", onMessage);
+                socket.socket.removeEventListener("error", onError);
+            };
+            const onError = (event) => {
+                cleanup();
+                reject(new Error(event.message));
+            };
+            const onMessage = (event) => {
+                const type = (0, parseStreamResponseType_js_1.parseStreamResponseType)(event.data);
+                if (type == null)
+                    return;
+                if (type === Corti.StreamConfigStatusMessageType.ConfigAccepted) {
+                    cleanup();
+                    resolve();
+                }
+                else if (STREAM_CONFIG_REJECTION_TYPES.includes(type)) {
+                    cleanup();
+                    reject(new Error(type));
+                }
+                else if (type === "ENDED") {
+                    cleanup();
+                    reject(new Error("Connection ended before config was accepted"));
+                }
+            };
+            socket.socket.addEventListener("message", onMessage);
+            socket.socket.addEventListener("error", onError);
+        });
+    }
+}
+exports.CustomStream = CustomStream;

package/dist/cjs/custom/stream/CustomStreamSocket.d.ts

@@ -0,0 +1,7 @@
+import { StreamSocket } from "../../api/resources/stream/client/Socket.js";
+export declare class CustomStreamSocket extends StreamSocket {
+    /** Remove the handler for an event. If callback is supplied, only removes if it matches. */
+    off<T extends keyof StreamSocket.EventHandlers>(event: T, callback?: StreamSocket.EventHandlers[T]): void;
+    /** Send raw data directly on the underlying WebSocket (e.g. binary audio, custom frames). */
+    send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;
+}

package/dist/cjs/custom/stream/CustomStreamSocket.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomStreamSocket = void 0;
+const Socket_js_1 = require("../../api/resources/stream/client/Socket.js");
+class CustomStreamSocket extends Socket_js_1.StreamSocket {
+    /** Remove the handler for an event. If callback is supplied, only removes if it matches. */
+    off(event, callback) {
+        if (callback === undefined || this.eventHandlers[event] === callback) {
+            this.eventHandlers[event] = undefined;
+        }
+    }
+    /** Send raw data directly on the underlying WebSocket (e.g. binary audio, custom frames). */
+    send(data) {
+        this.socket.send(data);
+    }
+}
+exports.CustomStreamSocket = CustomStreamSocket;

package/dist/cjs/custom/stream/parseStreamResponseType.d.ts

@@ -0,0 +1,2 @@
+/** Parses a raw WebSocket message and returns its type string, or null on failure. */
+export declare function parseStreamResponseType(raw: string): string | null;

package/dist/cjs/custom/stream/parseStreamResponseType.js

@@ -0,0 +1,49 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStreamResponseType = parseStreamResponseType;
+const json_js_1 = require("../../core/json.js");
+const serializers = __importStar(require("../../serialization/index.js"));
+/** Parses a raw WebSocket message and returns its type string, or null on failure. */
+function parseStreamResponseType(raw) {
+    const parsed = serializers.StreamSocketResponse.parse((0, json_js_1.fromJson)(raw), {
+        unrecognizedObjectKeys: "passthrough",
+        allowUnrecognizedUnionMembers: true,
+        allowUnrecognizedEnumValues: true,
+        skipValidation: true,
+        omitUndefined: true,
+    });
+    return parsed.ok ? parsed.value.type : null;
+}

package/dist/cjs/custom/transcribe/CustomTranscribe.d.ts

@@ -0,0 +1,38 @@
+import { TranscribeClient } from "../../api/resources/transcribe/client/Client.js";
+import { CustomTranscribeSocket } from "./CustomTranscribeSocket.js";
+import * as Corti from "../../api/index.js";
+import { type ProxyOptions } from "../utils/encodeHeadersAsWsProtocols.js";
+export type CustomTranscribeConnectArgs = {
+    /** When provided, connect() resolves after CONFIG_ACCEPTED or rejects on failure. */
+    configuration?: Corti.TranscribeConfig;
+    /**
+     * When true (default), connect() resolves after CONFIG_ACCEPTED or rejects on failure.
+     * When false, returns socket immediately; config errors are dispatched as ErrorEvent.
+     */
+    awaitConfiguration?: boolean;
+    /**
+     * When provided, bypasses normal URL construction and auth. The WebSocket connects
+     * directly to proxy.url. Useful for proxy backends that handle auth themselves.
+     */
+    proxy?: ProxyOptions;
+} & Partial<Omit<TranscribeClient.ConnectArgs, "tenantName" | "token">>;
+export declare class CustomTranscribe extends TranscribeClient {
+    private readonly _encodeHeadersAsWsProtocols;
+    constructor(options: TranscribeClient.Options & {
+        encodeHeadersAsWsProtocols?: boolean;
+    });
+    connect(args?: CustomTranscribeConnectArgs): Promise<CustomTranscribeSocket>;
+    /**
+     * Sends configuration on open, then resolves after CONFIG_ACCEPTED.
+     * Rejects and closes socket on CONFIG_DENIED / CONFIG_TIMEOUT /
+     * connection error / ended.
+     */
+    private _connectWithConfigAck;
+    /**
+     * Sends configuration on open and returns the socket immediately.
+     * Config errors are dispatched as ErrorEvent and the socket is closed.
+     */
+    private _connectWithConfigListeners;
+    /** Resolves on CONFIG_ACCEPTED; rejects on rejection types, socket error, or ended. */
+    private _buildConfigAckPromise;
+}