@corti/sdk 0.7.0 → 0.8.0-rc.1

package/README.md

@@ -19,6 +19,8 @@ npm i -s @corti/sdk
 
 For detailed authentication instructions, see the [Authentication Guide](./AUTHENTICATION.md).
 
+For information about proxying and securing frontend implementations, see the [Proxying Guide](./PROXYING.md).
+
 ## Usage
 
 Instantiate and use the client with the following:

package/dist/cjs/Client.js

@@ -64,8 +64,8 @@ class CortiClient {
                 "Tenant-Name": _options === null || _options === void 0 ? void 0 : _options.tenantName,
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@corti/sdk",
-                "X-Fern-SDK-Version": "0.7.0",
-                "User-Agent": "@corti/sdk/0.7.0",
+                "X-Fern-SDK-Version": "0.8.0-rc.1",
+                "User-Agent": "@corti/sdk/0.8.0-rc.1",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/stream/client/Client.js

@@ -61,7 +61,7 @@ class Stream {
             _queryParams["token"] = token;
             let _headers = Object.assign({}, headers);
             const socket = new core.ReconnectingWebSocket({
-                url: core.url.join((_a = (yield core.Supplier.get(this._options["baseUrl"]))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options["environment"])).wss, `/audio-bridge/v2/interactions/${encodeURIComponent(id)}/streams`),
+                url: core.url.join((_a = (yield core.Supplier.get(this._options["baseUrl"]))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options["environment"])).wss, `/interactions/${encodeURIComponent(id)}/streams`),
                 protocols: [],
                 queryParameters: _queryParams,
                 headers: _headers,

package/dist/cjs/api/resources/stream/client/Socket.js

@@ -121,7 +121,9 @@ class StreamSocket {
     }
     sendAudio(message) {
         this.assertSocketIsOpen();
-        const jsonPayload = core.serialization.string().jsonOrThrow(message, {
+        const jsonPayload = core.serialization
+            .string()
+            .jsonOrThrow(message, {
             unrecognizedObjectKeys: "passthrough",
             allowUnrecognizedUnionMembers: true,
             allowUnrecognizedEnumValues: true,

package/dist/cjs/api/resources/transcribe/client/Client.js

@@ -61,7 +61,7 @@ class Transcribe {
             _queryParams["token"] = token;
             let _headers = Object.assign({}, headers);
             const socket = new core.ReconnectingWebSocket({
-                url: core.url.join((_a = (yield core.Supplier.get(this._options["baseUrl"]))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options["environment"])).wss, "/audio-bridge/v2/transcribe"),
+                url: core.url.join((_a = (yield core.Supplier.get(this._options["baseUrl"]))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options["environment"])).wss, "/transcribe"),
                 protocols: [],
                 queryParameters: _queryParams,
                 headers: _headers,

package/dist/cjs/api/resources/transcribe/client/Socket.js

@@ -121,7 +121,9 @@ class TranscribeSocket {
     }
     sendAudio(message) {
         this.assertSocketIsOpen();
-        const jsonPayload = core.serialization.string().jsonOrThrow(message, {
+        const jsonPayload = core.serialization
+            .string()
+            .jsonOrThrow(message, {
             unrecognizedObjectKeys: "passthrough",
             allowUnrecognizedUnionMembers: true,
             allowUnrecognizedEnumValues: true,

package/dist/cjs/api/types/AgentsMcpServerAuthorizationType.d.ts

@@ -4,9 +4,10 @@
 /**
  * Type of authorization used by the MCP server.
  */
-export type AgentsMcpServerAuthorizationType = "none" | "oauth2.0" | "oauth2.1";
+export type AgentsMcpServerAuthorizationType = "none" | "bearer" | "inherit" | "oauth2.0";
 export declare const AgentsMcpServerAuthorizationType: {
     readonly None: "none";
+    readonly Bearer: "bearer";
+    readonly Inherit: "inherit";
     readonly Oauth20: "oauth2.0";
-    readonly Oauth21: "oauth2.1";
 };

package/dist/cjs/api/types/AgentsMcpServerAuthorizationType.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentsMcpServerAuthorizationType = void 0;
 exports.AgentsMcpServerAuthorizationType = {
     None: "none",
+    Bearer: "bearer",
+    Inherit: "inherit",
     Oauth20: "oauth2.0",
-    Oauth21: "oauth2.1",
 };

package/dist/cjs/custom/CortiAuth.d.ts

@@ -14,7 +14,7 @@
 import { Auth as FernAuth } from "../api/resources/auth/client/Client.js";
 import * as core from "../core/index.js";
 import * as Corti from "../api/index.js";
-import * as environments from "../environments.js";
+import { Environment, CortiInternalEnvironment } from "./utils/getEnvironmentFromString.js";
 /**
  * Patch: added codeChallenge to the AuthorizationCodeClient interface to support PKCE flow
  */
@@ -22,6 +22,7 @@ interface AuthorizationCodeClient {
     clientId: string;
     redirectUri: string;
     codeChallenge?: string;
+    scopes?: string[];
 }
 /**
  * Patch: renamed AuthorizationCodeClient to AuthorizationCode as it can be used for both(server and client) flows
@@ -31,6 +32,7 @@ interface AuthorizationCode {
     clientSecret: string;
     redirectUri: string;
     code: string;
+    scopes?: string[];
 }
 /**
  * Patch: added type for AuthorizationPkce request
@@ -40,6 +42,7 @@ interface AuthorizationPkce {
     redirectUri: string;
     code: string;
     codeVerifier?: string;
+    scopes?: string[];
 }
 /**
  * Patch: added type for AuthorizationRopc request
@@ -48,6 +51,7 @@ interface AuthorizationRopcServer {
     clientId: string;
     username: string;
     password: string;
+    scopes?: string[];
 }
 interface AuthorizationRefreshServer {
     clientId: string;
@@ -56,34 +60,53 @@ interface AuthorizationRefreshServer {
      */
     clientSecret?: string;
     refreshToken: string;
+    scopes?: string[];
 }
 interface Options {
     skipRedirect?: boolean;
 }
-type AuthOptions = Omit<FernAuth.Options, "environment"> & {
-    environment: core.Supplier<environments.CortiEnvironment | environments.CortiEnvironmentUrls> | string;
+type AuthOptionsBase = Omit<FernAuth.Options, "environment" | "tenantName" | "baseUrl">;
+type AuthOptionsWithBaseUrl = AuthOptionsBase & {
+    baseUrl: core.Supplier<string>;
+    environment?: Environment;
+    tenantName?: core.Supplier<string>;
 };
+type AuthOptionsWithObjectEnvironment = AuthOptionsBase & {
+    baseUrl?: core.Supplier<string>;
+    environment: CortiInternalEnvironment;
+    tenantName?: core.Supplier<string>;
+};
+type AuthOptionsWithStringEnvironment = AuthOptionsBase & {
+    baseUrl?: core.Supplier<string>;
+    environment: string;
+    tenantName: core.Supplier<string>;
+};
+type AuthOptions = AuthOptionsWithBaseUrl | AuthOptionsWithObjectEnvironment | AuthOptionsWithStringEnvironment;
 export declare class Auth extends FernAuth {
     /**
      * Patch: use custom AuthOptions type to support string-based environment
+     * When baseUrl is provided, environment and tenantName become optional
      */
     constructor(_options: AuthOptions);
     /**
      * Patch: Generate PKCE authorization URL with automatic code verifier generation
      */
-    authorizePkceUrl({ clientId, redirectUri }: AuthorizationCodeClient, options?: Options): Promise<string>;
+    authorizePkceUrl({ clientId, redirectUri, scopes }: AuthorizationCodeClient, options?: Options): Promise<string>;
     /**
      * Patch: Get the stored PKCE code verifier
      */
     getCodeVerifier(): string | null;
     /**
      * Patch: called custom implementation this.__getToken_custom instead of this.__getToken
+     * Extended to support additional scopes
      */
-    getToken(request: Corti.AuthGetTokenRequest, requestOptions?: FernAuth.RequestOptions): core.HttpResponsePromise<Corti.GetTokenResponse>;
+    getToken(request: Corti.AuthGetTokenRequest & {
+        scopes?: string[];
+    }, requestOptions?: FernAuth.RequestOptions): core.HttpResponsePromise<Corti.GetTokenResponse>;
     /**
      * Patch: added method to get Authorization URL for Authorization code flow and PKCE flow
      */
-    authorizeURL({ clientId, redirectUri, codeChallenge }: AuthorizationCodeClient, options?: Options): Promise<string>;
+    authorizeURL({ clientId, redirectUri, codeChallenge, scopes }: AuthorizationCodeClient, options?: Options): Promise<string>;
     /**
      * Patch: calls __getToken_custom with additional fields to support Authorization code flow
      */

package/dist/cjs/custom/CortiAuth.js

@@ -70,15 +70,16 @@ const CODE_VERIFIER_KEY = "corti_js_sdk_code_verifier";
 class Auth extends Client_js_1.Auth {
     /**
      * Patch: use custom AuthOptions type to support string-based environment
+     * When baseUrl is provided, environment and tenantName become optional
      */
     constructor(_options) {
-        super(Object.assign(Object.assign({}, _options), { environment: (0, getEnvironmentFromString_js_1.getEnvironment)(_options.environment) }));
+        super(Object.assign(Object.assign({}, _options), { tenantName: _options.tenantName || "", environment: (0, getEnvironmentFromString_js_1.getEnvironment)(_options.environment) }));
     }
     /**
      * Patch: Generate PKCE authorization URL with automatic code verifier generation
      */
     authorizePkceUrl(_a, options_1) {
-        return __awaiter(this, arguments, void 0, function* ({ clientId, redirectUri }, options) {
+        return __awaiter(this, arguments, void 0, function* ({ clientId, redirectUri, scopes }, options) {
             const codeVerifier = (0, pkce_js_1.generateCodeVerifier)();
             (0, localStorage_js_1.setLocalStorageItem)(CODE_VERIFIER_KEY, codeVerifier);
             const codeChallenge = yield (0, pkce_js_1.generateCodeChallenge)(codeVerifier);
@@ -86,6 +87,7 @@ class Auth extends Client_js_1.Auth {
                 clientId,
                 redirectUri,
                 codeChallenge,
+                scopes,
             }, options);
         });
     }
@@ -97,6 +99,7 @@ class Auth extends Client_js_1.Auth {
     }
     /**
      * Patch: called custom implementation this.__getToken_custom instead of this.__getToken
+     * Extended to support additional scopes
      */
     getToken(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__getToken_custom(request, requestOptions));
@@ -105,11 +108,14 @@ class Auth extends Client_js_1.Auth {
      * Patch: added method to get Authorization URL for Authorization code flow and PKCE flow
      */
     authorizeURL(_a, options_1) {
-        return __awaiter(this, arguments, void 0, function* ({ clientId, redirectUri, codeChallenge }, options) {
+        return __awaiter(this, arguments, void 0, function* ({ clientId, redirectUri, codeChallenge, scopes }, options) {
             var _b;
             const authUrl = new URL(core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)).login, yield core.Supplier.get(this._options.tenantName), "protocol/openid-connect/auth"));
             authUrl.searchParams.set("response_type", "code");
-            authUrl.searchParams.set("scope", "openid profile");
+            // Build scope string: always include "openid profile", add any additional scopes
+            const allScopes = ["openid", "profile", ...(scopes || [])];
+            const scopeString = [...new Set(allScopes)].join(" ");
+            authUrl.searchParams.set("scope", scopeString);
             if (clientId !== undefined) {
                 authUrl.searchParams.set("client_id", clientId);
             }

package/dist/cjs/custom/CortiClient.d.ts

@@ -40,6 +40,8 @@ export declare namespace CortiClient {
     interface BaseOptions {
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
     }
     interface OptionsWithClientCredentials extends BaseOptions {
         /**
@@ -59,7 +61,18 @@ export declare namespace CortiClient {
         tenantName?: core.Supplier<string>;
         auth: BearerOptions;
     }
-    type Options = OptionsWithClientCredentials | OptionsWithBearerToken;
+    interface OptionsWithBaseUrl extends BaseOptions {
+        baseUrl: core.Supplier<string>;
+        environment?: Environment;
+        tenantName?: core.Supplier<string>;
+        auth?: ClientCredentials | BearerOptions;
+    }
+    interface OptionsWithObjectEnvironment extends BaseOptions {
+        environment: CortiInternalEnvironment;
+        tenantName?: core.Supplier<string>;
+        auth?: ClientCredentials | BearerOptions;
+    }
+    type Options = OptionsWithClientCredentials | OptionsWithBearerToken | OptionsWithBaseUrl | OptionsWithObjectEnvironment;
     /**
      * Patch:
      *  - renamed `Options` to `InternalOptions`
@@ -99,8 +112,9 @@ export declare class CortiClient {
     protected readonly _options: CortiClient.InternalOptions;
     /**
      * Patch: extended `_oauthTokenProvider` to support both `RefreshBearerProvider` and `OAuthTokenProvider` options
+     * Optional - not created when auth is not provided (proxying scenarios)
      */
-    private readonly _oauthTokenProvider;
+    private readonly _oauthTokenProvider?;
     protected _interactions: Interactions | undefined;
     protected _recordings: Recordings | undefined;
     protected _transcripts: Transcripts | undefined;

package/dist/cjs/custom/CortiClient.js

@@ -104,57 +104,60 @@ class CortiClient {
                 "User-Agent": `@corti/sdk/${version_js_1.SDK_VERSION}`,
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
-            }, _options === null || _options === void 0 ? void 0 : _options.headers), clientId: "clientId" in _options.auth ? _options.auth.clientId : undefined, clientSecret: "clientSecret" in _options.auth ? _options.auth.clientSecret : undefined, token: "accessToken" in _options.auth ? _options.auth.accessToken : undefined, tenantName, environment: (0, getEnvironmentFromString_js_1.getEnvironment)(environment) });
+            }, _options === null || _options === void 0 ? void 0 : _options.headers), clientId: _options.auth && "clientId" in _options.auth ? _options.auth.clientId : undefined, clientSecret: _options.auth && "clientSecret" in _options.auth ? _options.auth.clientSecret : undefined, token: _options.auth && "accessToken" in _options.auth ? _options.auth.accessToken : undefined, tenantName, environment: (0, getEnvironmentFromString_js_1.getEnvironment)(environment) });
         /**
          * Patch: if `clientId` is provided, use OAuthTokenProvider, otherwise use BearerProvider
+         * Only create token provider when auth is provided
          */
-        this._oauthTokenProvider =
-            "clientId" in _options.auth
-                ? new core.OAuthTokenProvider({
-                    clientId: _options.auth.clientId,
-                    clientSecret: _options.auth.clientSecret,
-                    /**
-                     * Patch: provide whole `options` object to the Auth client, since it depends on both tenantName and environment
-                     */
-                    authClient: new CortiAuth_js_1.Auth(this._options),
-                })
-                : new RefreshBearerProvider_js_1.RefreshBearerProvider(Object.assign(Object.assign({}, _options.auth), { initialTokenResponse }));
+        if (_options.auth) {
+            this._oauthTokenProvider =
+                "clientId" in _options.auth
+                    ? new core.OAuthTokenProvider({
+                        clientId: _options.auth.clientId,
+                        clientSecret: _options.auth.clientSecret,
+                        /**
+                         * Patch: provide whole `options` object to the Auth client, since it depends on both tenantName and environment
+                         */
+                        authClient: new CortiAuth_js_1.Auth(this._options),
+                    })
+                    : new RefreshBearerProvider_js_1.RefreshBearerProvider(Object.assign(Object.assign({}, _options.auth), { initialTokenResponse }));
+        }
     }
     get interactions() {
         var _a;
-        return ((_a = this._interactions) !== null && _a !== void 0 ? _a : (this._interactions = new Client_js_1.Interactions(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        return ((_a = this._interactions) !== null && _a !== void 0 ? _a : (this._interactions = new Client_js_1.Interactions(Object.assign(Object.assign({}, this._options), { token: this._oauthTokenProvider ? () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) : undefined }))));
     }
     get recordings() {
         var _a;
-        return ((_a = this._recordings) !== null && _a !== void 0 ? _a : (this._recordings = new Client_js_2.Recordings(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        return ((_a = this._recordings) !== null && _a !== void 0 ? _a : (this._recordings = new Client_js_2.Recordings(Object.assign(Object.assign({}, this._options), { token: this._oauthTokenProvider ? () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) : undefined }))));
     }
     get transcripts() {
         var _a;
-        return ((_a = this._transcripts) !== null && _a !== void 0 ? _a : (this._transcripts = new Client_js_3.Transcripts(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        return ((_a = this._transcripts) !== null && _a !== void 0 ? _a : (this._transcripts = new Client_js_3.Transcripts(Object.assign(Object.assign({}, this._options), { token: this._oauthTokenProvider ? () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) : undefined }))));
     }
     get facts() {
         var _a;
-        return ((_a = this._facts) !== null && _a !== void 0 ? _a : (this._facts = new Client_js_4.Facts(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        return ((_a = this._facts) !== null && _a !== void 0 ? _a : (this._facts = new Client_js_4.Facts(Object.assign(Object.assign({}, this._options), { token: this._oauthTokenProvider ? () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) : undefined }))));
     }
     get documents() {
         var _a;
-        return ((_a = this._documents) !== null && _a !== void 0 ? _a : (this._documents = new Client_js_5.Documents(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        return ((_a = this._documents) !== null && _a !== void 0 ? _a : (this._documents = new Client_js_5.Documents(Object.assign(Object.assign({}, this._options), { token: this._oauthTokenProvider ? () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) : undefined }))));
     }
     get templates() {
         var _a;
-        return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new Client_js_6.Templates(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        return ((_a = this._templates) !== null && _a !== void 0 ? _a : (this._templates = new Client_js_6.Templates(Object.assign(Object.assign({}, this._options), { token: this._oauthTokenProvider ? () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) : undefined }))));
     }
     get agents() {
         var _a;
-        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_js_7.Agents(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_js_7.Agents(Object.assign(Object.assign({}, this._options), { token: this._oauthTokenProvider ? () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) : undefined }))));
     }
     get stream() {
         var _a;
-        return ((_a = this._stream) !== null && _a !== void 0 ? _a : (this._stream = new CustomStream_js_1.Stream(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        return ((_a = this._stream) !== null && _a !== void 0 ? _a : (this._stream = new CustomStream_js_1.Stream(Object.assign(Object.assign({}, this._options), { token: this._oauthTokenProvider ? () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) : undefined }))));
     }
     get transcribe() {
         var _a;
-        return ((_a = this._transcribe) !== null && _a !== void 0 ? _a : (this._transcribe = new CustomTranscribe_js_1.Transcribe(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+        return ((_a = this._transcribe) !== null && _a !== void 0 ? _a : (this._transcribe = new CustomTranscribe_js_1.Transcribe(Object.assign(Object.assign({}, this._options), { token: this._oauthTokenProvider ? () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) : undefined }))));
     }
 }
 exports.CortiClient = CortiClient;

package/dist/cjs/custom/CortiWebSocketProxyClient.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Patch: Lightweight proxy client with only WebSocket resources (stream and transcribe).
+ * Use this when you need direct WebSocket connections through your own proxy backend.
+ *
+ * No environment or tenantName required - proxy is required in connect().
+ */
+import { CustomProxyStream } from "./proxy/CustomProxyStream.js";
+import { CustomProxyTranscribe } from "./proxy/CustomProxyTranscribe.js";
+export declare class CortiWebSocketProxyClient {
+    private static _stream;
+    private static _transcribe;
+    static get stream(): CustomProxyStream;
+    static get transcribe(): CustomProxyTranscribe;
+}

package/dist/cjs/custom/CortiWebSocketProxyClient.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Patch: Lightweight proxy client with only WebSocket resources (stream and transcribe).
+ * Use this when you need direct WebSocket connections through your own proxy backend.
+ *
+ * No environment or tenantName required - proxy is required in connect().
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CortiWebSocketProxyClient = void 0;
+const CustomProxyStream_js_1 = require("./proxy/CustomProxyStream.js");
+const CustomProxyTranscribe_js_1 = require("./proxy/CustomProxyTranscribe.js");
+class CortiWebSocketProxyClient {
+    static get stream() {
+        var _a;
+        return ((_a = this._stream) !== null && _a !== void 0 ? _a : (this._stream = new CustomProxyStream_js_1.CustomProxyStream()));
+    }
+    static get transcribe() {
+        var _a;
+        return ((_a = this._transcribe) !== null && _a !== void 0 ? _a : (this._transcribe = new CustomProxyTranscribe_js_1.CustomProxyTranscribe()));
+    }
+}
+exports.CortiWebSocketProxyClient = CortiWebSocketProxyClient;

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

@@ -13,8 +13,15 @@ import { StreamSocket } from "./CustomStreamSocket.js";
 export declare class Stream extends FernStream {
     /**
      * Patch: use custom connect method to support passing _options parameters
+     * Added optional `proxy` parameter for direct WebSocket connection (proxy scenarios)
      */
-    connect({ configuration, ...args }: Omit<FernStream.ConnectArgs, "token" | "tenantName"> & {
+    connect({ configuration, proxy, ...args }: Omit<FernStream.ConnectArgs, "token" | "tenantName"> & {
         configuration?: api.StreamConfig;
+        /** Patch: Proxy connection options - bypasses normal URL construction */
+        proxy?: {
+            url: string;
+            protocols?: string[];
+            queryParameters?: Record<string, string>;
+        };
     }): Promise<StreamSocket>;
 }

package/dist/cjs/custom/CustomStream.js

@@ -69,15 +69,25 @@ const CustomStreamSocket_js_1 = require("./CustomStreamSocket.js");
 class Stream extends Client_js_1.Stream {
     /**
      * Patch: use custom connect method to support passing _options parameters
+     * Added optional `proxy` parameter for direct WebSocket connection (proxy scenarios)
      */
     connect(_a) {
         const _super = Object.create(null, {
             connect: { get: () => super.connect }
         });
         return __awaiter(this, void 0, void 0, function* () {
-            var { configuration } = _a, args = __rest(_a, ["configuration"]);
-            const fernWs = yield _super.connect.call(this, Object.assign(Object.assign({}, args), { token: (yield this._getAuthorizationHeader()) || "", tenantName: yield core.Supplier.get(this._options.tenantName) }));
-            const ws = new CustomStreamSocket_js_1.StreamSocket({ socket: fernWs.socket });
+            var _b, _c;
+            var { configuration, proxy } = _a, args = __rest(_a, ["configuration", "proxy"]);
+            const socket = proxy
+                ? new core.ReconnectingWebSocket({
+                    url: proxy.url,
+                    protocols: proxy.protocols || [],
+                    queryParameters: proxy.queryParameters || {},
+                    headers: args.headers || {},
+                    options: { debug: (_b = args.debug) !== null && _b !== void 0 ? _b : false, maxRetries: (_c = args.reconnectAttempts) !== null && _c !== void 0 ? _c : 30 },
+                })
+                : (yield _super.connect.call(this, Object.assign(Object.assign({}, args), { token: (yield this._getAuthorizationHeader()) || "", tenantName: yield core.Supplier.get(this._options.tenantName) }))).socket;
+            const ws = new CustomStreamSocket_js_1.StreamSocket({ socket });
             if (!configuration) {
                 return ws;
             }

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

@@ -2,6 +2,7 @@
  * Patch: file patches disability of auto-generating binary data methods for sending data to the socket
  */
 import { StreamSocket as FernStreamSocket } from "../api/resources/stream/client/Socket.js";
+import { ReconnectingWebSocket } from "../core/index.js";
 export declare class StreamSocket extends FernStreamSocket {
     sendAudio(message: ArrayBufferLike | Blob | ArrayBufferView | string): void;
     /**
@@ -12,4 +13,8 @@ export declare class StreamSocket extends FernStreamSocket {
      * Patch: added ability to remove event handlers
      */
     off<T extends keyof FernStreamSocket.EventHandlers>(event: T, callback?: FernStreamSocket.EventHandlers[T]): void;
+    /**
+     * Patch: expose underlying socket send method for direct access
+     */
+    send(data: ReconnectingWebSocket.Message): void;
 }

package/dist/cjs/custom/CustomStreamSocket.js

@@ -66,5 +66,11 @@ class StreamSocket extends Socket_js_1.StreamSocket {
             delete this.eventHandlers[event];
         }
     }
+    /**
+     * Patch: expose underlying socket send method for direct access
+     */
+    send(data) {
+        this.socket.send(data);
+    }
 }
 exports.StreamSocket = StreamSocket;

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

@@ -13,8 +13,15 @@ import { TranscribeSocket } from "./CustomTranscribeSocket.js";
 export declare class Transcribe extends FernTranscribe {
     /**
      * Patch: use custom connect method to support passing _options parameters
+     * Added optional `proxy` parameter for direct WebSocket connection (proxy scenarios)
      */
-    connect({ configuration, ...args }?: Omit<FernTranscribe.ConnectArgs, "token" | "tenantName"> & {
+    connect({ configuration, proxy, ...args }?: Omit<FernTranscribe.ConnectArgs, "token" | "tenantName"> & {
         configuration?: api.TranscribeConfig;
+        /** Patch: Proxy connection options - bypasses normal URL construction */
+        proxy?: {
+            url: string;
+            protocols?: string[];
+            queryParameters?: Record<string, string>;
+        };
     }): Promise<TranscribeSocket>;
 }

package/dist/cjs/custom/CustomTranscribe.js

@@ -69,15 +69,25 @@ const CustomTranscribeSocket_js_1 = require("./CustomTranscribeSocket.js");
 class Transcribe extends Client_js_1.Transcribe {
     /**
      * Patch: use custom connect method to support passing _options parameters
+     * Added optional `proxy` parameter for direct WebSocket connection (proxy scenarios)
      */
     connect() {
         const _super = Object.create(null, {
             connect: { get: () => super.connect }
         });
         return __awaiter(this, arguments, void 0, function* (_a = {}) {
-            var { configuration } = _a, args = __rest(_a, ["configuration"]);
-            const fernWs = yield _super.connect.call(this, Object.assign(Object.assign({}, args), { token: (yield this._getAuthorizationHeader()) || "", tenantName: yield core.Supplier.get(this._options.tenantName) }));
-            const ws = new CustomTranscribeSocket_js_1.TranscribeSocket({ socket: fernWs.socket });
+            var _b, _c;
+            var { configuration, proxy } = _a, args = __rest(_a, ["configuration", "proxy"]);
+            const socket = proxy
+                ? new core.ReconnectingWebSocket({
+                    url: proxy.url,
+                    protocols: proxy.protocols || [],
+                    queryParameters: proxy.queryParameters || {},
+                    headers: args.headers || {},
+                    options: { debug: (_b = args.debug) !== null && _b !== void 0 ? _b : false, maxRetries: (_c = args.reconnectAttempts) !== null && _c !== void 0 ? _c : 30 },
+                })
+                : (yield _super.connect.call(this, Object.assign(Object.assign({}, args), { token: (yield this._getAuthorizationHeader()) || "", tenantName: yield core.Supplier.get(this._options.tenantName) }))).socket;
+            const ws = new CustomTranscribeSocket_js_1.TranscribeSocket({ socket });
             if (!configuration) {
                 return ws;
             }

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

@@ -2,6 +2,7 @@
  * Patch: file patches disability of auto-generating binary data methods for sending data to the socket
  */
 import { TranscribeSocket as FernTranscribeSocket } from "../api/resources/transcribe/client/Socket.js";
+import { ReconnectingWebSocket } from "../core/index.js";
 export declare class TranscribeSocket extends FernTranscribeSocket {
     sendAudio(message: ArrayBufferLike | Blob | ArrayBufferView | string): void;
     /**
@@ -12,4 +13,8 @@ export declare class TranscribeSocket extends FernTranscribeSocket {
      * Patch: added ability to remove event handlers
      */
     off<T extends keyof FernTranscribeSocket.EventHandlers>(event: T, callback?: FernTranscribeSocket.EventHandlers[T]): void;
+    /**
+     * Patch: expose underlying socket send method for direct access
+     */
+    send(data: ReconnectingWebSocket.Message): void;
 }

package/dist/cjs/custom/CustomTranscribeSocket.js

@@ -66,5 +66,11 @@ class TranscribeSocket extends Socket_js_1.TranscribeSocket {
             delete this.eventHandlers[event];
         }
     }
+    /**
+     * Patch: expose underlying socket send method for direct access
+     */
+    send(data) {
+        this.socket.send(data);
+    }
 }
 exports.TranscribeSocket = TranscribeSocket;

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

@@ -0,0 +1,24 @@
+/**
+ * Patch: Proxy-specific Stream wrapper that enforces `proxy` as required.
+ *
+ * Reuses the underlying CustomStream class to preserve the logic we added on top
+ * of generated sockets (e.g., sending configuration messages, handling responses).
+ */
+import * as api from "../../api/index.js";
+import { StreamSocket } from "../CustomStreamSocket.js";
+export type ProxyOptions = {
+    url: string;
+    protocols?: string[];
+    queryParameters?: Record<string, string>;
+};
+export declare class CustomProxyStream {
+    private _stream;
+    constructor();
+    connect(args: {
+        proxy: ProxyOptions;
+        configuration?: api.StreamConfig;
+        headers?: Record<string, string>;
+        debug?: boolean;
+        reconnectAttempts?: number;
+    }): Promise<StreamSocket>;
+}