telnyx 6.70.0 → 6.72.0

package/resources/speech-to-text/ws-base.d.mts

@@ -0,0 +1,106 @@
+import { SpeechToTextEmitter, SpeechToTextStreamMessage } from "./internal-base.mjs";
+import { type WebSocketLike } from "../../internal/ws-adapter.mjs";
+import { type RawWebSocketData, type ReconnectingEvent, type ReconnectingOverrides } from "../../internal/ws.mjs";
+import * as SpeechToTextAPI from "./speech-to-text.mjs";
+import { Telnyx } from "../../client.mjs";
+export interface SpeechToTextWSReconnectOptions {
+    /**
+     * Called before each reconnect attempt. Return an object with
+     * `parameters` to override query parameters for the next connection.
+     */
+    onReconnecting(event: ReconnectingEvent<Record<string, unknown>>): ReconnectingOverrides<Record<string, unknown>> | void;
+    /**
+     * Maximum number of reconnection attempts. Default: 5.
+     * Set to 0 to disable reconnection entirely.
+     */
+    maxRetries?: number;
+    /**
+     * Initial backoff delay in milliseconds. Default: 500.
+     */
+    initialDelay?: number;
+    /**
+     * Maximum backoff delay in milliseconds. Default: 8000.
+     */
+    maxDelay?: number;
+}
+export interface SpeechToTextWSBaseOptions {
+    /**
+     * Options for automatic reconnection on recoverable close codes.
+     * Automatic reconnection is only enabled when this has a non-null value.
+     */
+    reconnect?: SpeechToTextWSReconnectOptions | null | undefined;
+    /**
+     * Maximum size of the outgoing message queue in bytes.
+     * Messages queued while the socket is connecting or reconnecting are held
+     * in memory up to this limit. Once the limit is reached, new messages are
+     * discarded and an `error` event is emitted.
+     * Default: 1 MB
+     */
+    maxQueueSize?: number | undefined;
+}
+export declare abstract class SpeechToTextWSBase<TSocket extends WebSocketLike> extends SpeechToTextEmitter {
+    url: URL;
+    socket: TSocket;
+    protected _client: Telnyx;
+    protected _parameters: Record<string, unknown> | null | undefined;
+    private _reconnectOptions;
+    private _sendQueue;
+    private _isReconnecting;
+    private _intentionallyClosed;
+    private _closeCode;
+    private _closeReason;
+    private _lastCloseCode;
+    private _lastCloseReason;
+    private _internalEvents;
+    constructor(client: Telnyx, parameters?: Record<string, unknown> | undefined, options?: SpeechToTextWSBaseOptions | undefined);
+    /** Establishes the initial WebSocket connection. */
+    protected _connectInitial(): void;
+    /** Creates a platform-specific WebSocket for the given URL and auth headers. */
+    protected abstract _createSocket(url: URL, authHeaders: Record<string, string>): TSocket;
+    send(event: SpeechToTextAPI.TranscribeClientEvent): void;
+    sendRaw(data: RawWebSocketData): void;
+    close(props?: {
+        code: number;
+        reason: string;
+    }): void;
+    /**
+     * Returns an async iterator over WebSocket lifecycle and message events,
+     * providing an alternative to the event-based `.on()` API.
+     * The iterator will exit if the socket closes but exiting the iterator
+     * does not close the socket.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.stream()) {
+     *   switch (event.type) {
+     *     case 'message':
+     *       console.log('received:', event.message);
+     *       break;
+     *     case 'error':
+     *       console.error(event.error);
+     *       break;
+     *     case 'close':
+     *       console.log('connection closed');
+     *       break;
+     *   }
+     * }
+     * ```
+     */
+    stream(): AsyncIterableIterator<SpeechToTextStreamMessage>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<SpeechToTextStreamMessage>;
+    private _connect;
+    private _canReconnect;
+    private _reconnect;
+    /**
+     * Resolves once the socket is open, rejects if it errors or closes first
+     */
+    private _awaitOpen;
+    private _flushSendQueue;
+    /**
+     * Emits the public `close` event with unsent messages and the internal
+     * `close` event used by the async iterator.
+     */
+    private _emitPermanentClose;
+    protected _authHeaders(): Record<string, string>;
+}
+//# sourceMappingURL=ws-base.d.mts.map

package/resources/speech-to-text/ws-base.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-base.d.mts","sourceRoot":"","sources":["../../src/resources/speech-to-text/ws-base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAA4B,4BAAwB;AAG3G,OAAO,EAAE,KAAK,aAAa,EAAc,sCAAkC;AAC3E,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAE3B,8BAA0B;AAC3B,OAAO,KAAK,eAAe,6BAAyB;AACpD,OAAO,EAAE,MAAM,EAAE,yBAAqB;AAGtC,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,cAAc,CACZ,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAChD,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAEzD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,8BAA8B,GAAG,IAAI,GAAG,SAAS,CAAC;IAE9D;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,8BAAsB,kBAAkB,CAAC,OAAO,SAAS,aAAa,CAAE,SAAQ,mBAAmB;IACjG,GAAG,EAAG,GAAG,CAAC;IACV,MAAM,EAAG,OAAO,CAAC;IAEjB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAClE,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,UAAU,CAAmD;IACrE,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,gBAAgB,CAAc;IAGtC,OAAO,CAAC,eAAe,CASlB;gBAGH,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAChD,OAAO,CAAC,EAAE,yBAAyB,GAAG,SAAS;IASjD,oDAAoD;IACpD,SAAS,CAAC,eAAe,IAAI,IAAI;IAKjC,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAExF,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,qBAAqB;IAsBjD,OAAO,CAAC,IAAI,EAAE,gBAAgB;IAsB9B,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAe9C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,IAAI,qBAAqB,CAAC,yBAAyB,CAAC;IAI1D,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,yBAAyB,CAAC;IAwJ1E,OAAO,CAAC,QAAQ;IA2DhB,OAAO,CAAC,aAAa;YAQP,UAAU;IA+IxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAU3B,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAMjD"}

package/resources/speech-to-text/ws-base.d.ts

@@ -0,0 +1,106 @@
+import { SpeechToTextEmitter, SpeechToTextStreamMessage } from "./internal-base.js";
+import { type WebSocketLike } from "../../internal/ws-adapter.js";
+import { type RawWebSocketData, type ReconnectingEvent, type ReconnectingOverrides } from "../../internal/ws.js";
+import * as SpeechToTextAPI from "./speech-to-text.js";
+import { Telnyx } from "../../client.js";
+export interface SpeechToTextWSReconnectOptions {
+    /**
+     * Called before each reconnect attempt. Return an object with
+     * `parameters` to override query parameters for the next connection.
+     */
+    onReconnecting(event: ReconnectingEvent<Record<string, unknown>>): ReconnectingOverrides<Record<string, unknown>> | void;
+    /**
+     * Maximum number of reconnection attempts. Default: 5.
+     * Set to 0 to disable reconnection entirely.
+     */
+    maxRetries?: number;
+    /**
+     * Initial backoff delay in milliseconds. Default: 500.
+     */
+    initialDelay?: number;
+    /**
+     * Maximum backoff delay in milliseconds. Default: 8000.
+     */
+    maxDelay?: number;
+}
+export interface SpeechToTextWSBaseOptions {
+    /**
+     * Options for automatic reconnection on recoverable close codes.
+     * Automatic reconnection is only enabled when this has a non-null value.
+     */
+    reconnect?: SpeechToTextWSReconnectOptions | null | undefined;
+    /**
+     * Maximum size of the outgoing message queue in bytes.
+     * Messages queued while the socket is connecting or reconnecting are held
+     * in memory up to this limit. Once the limit is reached, new messages are
+     * discarded and an `error` event is emitted.
+     * Default: 1 MB
+     */
+    maxQueueSize?: number | undefined;
+}
+export declare abstract class SpeechToTextWSBase<TSocket extends WebSocketLike> extends SpeechToTextEmitter {
+    url: URL;
+    socket: TSocket;
+    protected _client: Telnyx;
+    protected _parameters: Record<string, unknown> | null | undefined;
+    private _reconnectOptions;
+    private _sendQueue;
+    private _isReconnecting;
+    private _intentionallyClosed;
+    private _closeCode;
+    private _closeReason;
+    private _lastCloseCode;
+    private _lastCloseReason;
+    private _internalEvents;
+    constructor(client: Telnyx, parameters?: Record<string, unknown> | undefined, options?: SpeechToTextWSBaseOptions | undefined);
+    /** Establishes the initial WebSocket connection. */
+    protected _connectInitial(): void;
+    /** Creates a platform-specific WebSocket for the given URL and auth headers. */
+    protected abstract _createSocket(url: URL, authHeaders: Record<string, string>): TSocket;
+    send(event: SpeechToTextAPI.TranscribeClientEvent): void;
+    sendRaw(data: RawWebSocketData): void;
+    close(props?: {
+        code: number;
+        reason: string;
+    }): void;
+    /**
+     * Returns an async iterator over WebSocket lifecycle and message events,
+     * providing an alternative to the event-based `.on()` API.
+     * The iterator will exit if the socket closes but exiting the iterator
+     * does not close the socket.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.stream()) {
+     *   switch (event.type) {
+     *     case 'message':
+     *       console.log('received:', event.message);
+     *       break;
+     *     case 'error':
+     *       console.error(event.error);
+     *       break;
+     *     case 'close':
+     *       console.log('connection closed');
+     *       break;
+     *   }
+     * }
+     * ```
+     */
+    stream(): AsyncIterableIterator<SpeechToTextStreamMessage>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<SpeechToTextStreamMessage>;
+    private _connect;
+    private _canReconnect;
+    private _reconnect;
+    /**
+     * Resolves once the socket is open, rejects if it errors or closes first
+     */
+    private _awaitOpen;
+    private _flushSendQueue;
+    /**
+     * Emits the public `close` event with unsent messages and the internal
+     * `close` event used by the async iterator.
+     */
+    private _emitPermanentClose;
+    protected _authHeaders(): Record<string, string>;
+}
+//# sourceMappingURL=ws-base.d.ts.map

package/resources/speech-to-text/ws-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-base.d.ts","sourceRoot":"","sources":["../../src/resources/speech-to-text/ws-base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAA4B,2BAAwB;AAG3G,OAAO,EAAE,KAAK,aAAa,EAAc,qCAAkC;AAC3E,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAE3B,6BAA0B;AAC3B,OAAO,KAAK,eAAe,4BAAyB;AACpD,OAAO,EAAE,MAAM,EAAE,wBAAqB;AAGtC,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,cAAc,CACZ,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAChD,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAEzD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,8BAA8B,GAAG,IAAI,GAAG,SAAS,CAAC;IAE9D;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,8BAAsB,kBAAkB,CAAC,OAAO,SAAS,aAAa,CAAE,SAAQ,mBAAmB;IACjG,GAAG,EAAG,GAAG,CAAC;IACV,MAAM,EAAG,OAAO,CAAC;IAEjB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAClE,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,UAAU,CAAmD;IACrE,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,gBAAgB,CAAc;IAGtC,OAAO,CAAC,eAAe,CASlB;gBAGH,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAChD,OAAO,CAAC,EAAE,yBAAyB,GAAG,SAAS;IASjD,oDAAoD;IACpD,SAAS,CAAC,eAAe,IAAI,IAAI;IAKjC,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAExF,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,qBAAqB;IAsBjD,OAAO,CAAC,IAAI,EAAE,gBAAgB;IAsB9B,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAe9C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,IAAI,qBAAqB,CAAC,yBAAyB,CAAC;IAI1D,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,yBAAyB,CAAC;IAwJ1E,OAAO,CAAC,QAAQ;IA2DhB,OAAO,CAAC,aAAa;YAQP,UAAU;IA+IxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAU3B,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAMjD"}