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

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/{serialization/requests/AuthGetCodeFlowTokenRequest.js → stream/parseStreamResponseType.js}

@@ -1,7 +1,4 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -36,11 +33,17 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AuthGetCodeFlowTokenRequest = void 0;
-const core = __importStar(require("../../../core/index.js"));
-exports.AuthGetCodeFlowTokenRequest = core.serialization.object({
-    clientId: core.serialization.property("client_id", core.serialization.string()),
-    clientSecret: core.serialization.property("client_secret", core.serialization.string()),
-    code: core.serialization.property("code", core.serialization.string()),
-    redirectUri: core.serialization.property("redirect_uri", core.serialization.string()),
-});
+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;
+}

package/dist/cjs/custom/transcribe/CustomTranscribe.js

@@ -0,0 +1,181 @@
+"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.CustomTranscribe = void 0;
+const Client_js_1 = require("../../api/resources/transcribe/client/Client.js");
+const CustomTranscribeSocket_js_1 = require("./CustomTranscribeSocket.js");
+const Corti = __importStar(require("../../api/index.js"));
+const events_js_1 = require("../../core/websocket/events.js");
+const parseTranscribeResponseType_js_1 = require("./parseTranscribeResponseType.js");
+const core = __importStar(require("../../core/index.js"));
+const encodeHeadersAsWsProtocols_js_1 = require("../utils/encodeHeadersAsWsProtocols.js");
+const TRANSCRIBE_CONFIG_REJECTION_TYPES = [
+    Corti.TranscribeConfigStatusMessageType.ConfigDenied,
+    Corti.TranscribeConfigStatusMessageType.ConfigTimeout,
+];
+class CustomTranscribe extends Client_js_1.TranscribeClient {
+    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 _j = args !== null && args !== void 0 ? args : {}, { configuration, awaitConfiguration = true, proxy } = _j, rest = __rest(_j, ["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, "/transcribe"),
+                    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 CustomTranscribeSocket_js_1.CustomTranscribeSocket({ 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_TIMEOUT /
+     * 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, parseTranscribeResponseType_js_1.parseTranscribeResponseType)(event.data);
+            if (type == null || type === Corti.TranscribeConfigStatusMessageType.ConfigAccepted) {
+                return;
+            }
+            if (TRANSCRIBE_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, parseTranscribeResponseType_js_1.parseTranscribeResponseType)(event.data);
+                if (type == null)
+                    return;
+                if (type === Corti.TranscribeConfigStatusMessageType.ConfigAccepted) {
+                    cleanup();
+                    resolve();
+                }
+                else if (TRANSCRIBE_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.CustomTranscribe = CustomTranscribe;

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

@@ -0,0 +1,7 @@
+import { TranscribeSocket } from "../../api/resources/transcribe/client/Socket.js";
+export declare class CustomTranscribeSocket extends TranscribeSocket {
+    /** Remove the handler for an event. If callback is supplied, only removes if it matches. */
+    off<T extends keyof TranscribeSocket.EventHandlers>(event: T, callback?: TranscribeSocket.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/transcribe/CustomTranscribeSocket.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomTranscribeSocket = void 0;
+const Socket_js_1 = require("../../api/resources/transcribe/client/Socket.js");
+class CustomTranscribeSocket extends Socket_js_1.TranscribeSocket {
+    /** 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.CustomTranscribeSocket = CustomTranscribeSocket;

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

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

package/dist/cjs/{serialization/resources/auth/client/requests/AuthGetCodeFlowTokenRequest.js → custom/transcribe/parseTranscribeResponseType.js}

@@ -1,7 +1,4 @@
 "use strict";
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -36,11 +33,17 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AuthGetCodeFlowTokenRequest = void 0;
-const core = __importStar(require("../../../../../core/index.js"));
-exports.AuthGetCodeFlowTokenRequest = core.serialization.object({
-    clientId: core.serialization.property("client_id", core.serialization.string()),
-    clientSecret: core.serialization.property("client_secret", core.serialization.string()),
-    code: core.serialization.property("code", core.serialization.string()),
-    redirectUri: core.serialization.property("redirect_uri", core.serialization.string()),
-});
+exports.parseTranscribeResponseType = parseTranscribeResponseType;
+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 parseTranscribeResponseType(raw) {
+    const parsed = serializers.TranscribeSocketResponse.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/utils/encodeHeadersAsWsProtocols.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Utilities to encode client headers as WebSocket subprotocols (for proxy scenarios).
+ * Format: [headerName1, encodeURIComponent(value1), headerName2, encodeURIComponent(value2), ...]
+ */
+import * as core from "../../core/index.js";
+export type HeadersRecord = Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+/**
+ * Resolves header values (including suppliers/functions) and returns a flat array
+ * of [name, encodeURIComponent(value)] for each header, skipping undefined/empty values.
+ * When filterSdkHeaders is true, SDK-added headers are excluded.
+ */
+export declare function buildProtocolsFromHeaders(headers: HeadersRecord | undefined, filterSdkHeaders?: boolean): Promise<string[]>;
+/** Options shape for getWsProtocols (encodeHeadersAsWsProtocols + headers). */
+export type WsProtocolsOptions = {
+    encodeHeadersAsWsProtocols?: boolean;
+    headers?: HeadersRecord;
+};
+/** Proxy protocols as array (pass-through) or object (encoded like headers). */
+export type ProxyProtocolsInput = string[] | HeadersRecord;
+export type ProxyOptions = {
+    url: string;
+    /** string[] passed as-is; Record → encoded as [name, encodeURIComponent(value), ...] pairs. */
+    protocols?: ProxyProtocolsInput;
+    queryParameters?: Record<string, string>;
+};
+/**
+ * Returns WebSocket protocols array for connect (header-derived + proxy protocols).
+ * proxyProtocols: array is passed as-is; object is encoded like headers.
+ */
+export declare function getWsProtocols(options: WsProtocolsOptions, proxyProtocols?: ProxyProtocolsInput): Promise<string[]>;