telnyx 7.28.0 → 7.29.0

package/src/resources/tunnels/tunnels.ts

@@ -0,0 +1,260 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as NetworkRoutesAPI from '../network-routes';
+import * as ActionsAPI from './actions';
+import { ActionRotateTokenResponse, Actions } from './actions';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Tunnels connect a Network to hosts behind a tunnel process within the user's network.
+ */
+export class Tunnels extends APIResource {
+  actions: ActionsAPI.Actions = new ActionsAPI.Actions(this._client);
+
+  /**
+   * Lists the tunnels on the account with their status and connected tunnel
+   * processes. Responses never include `tunnel_token`.
+   *
+   * @example
+   * ```ts
+   * const tunnels = await client.tunnels.list();
+   * ```
+   */
+  list(
+    query: TunnelListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TunnelListResponse> {
+    return this._client.get('/tunnels', { query, ...options });
+  }
+
+  /**
+   * Creates a tunnel and returns its `tunnel_token`. The token is the only
+   * credential the tunnel process needs, and this response and
+   * `POST /tunnels/{id}/actions/rotate_token` are the only ones that return it. A
+   * new tunnel is `inactive` until a tunnel process connects with the token.
+   *
+   * @example
+   * ```ts
+   * const tunnel = await client.tunnels.create({
+   *   name: 'chicago-dc',
+   * });
+   * ```
+   */
+  create(body: TunnelCreateParams, options?: RequestOptions): APIPromise<TunnelCreateResponse> {
+    return this._client.post('/tunnels', { body, ...options });
+  }
+
+  /**
+   * Deletes a tunnel. A tunnel that a route names as its next hop cannot be deleted;
+   * delete those routes first. Connected tunnel processes are disconnected and
+   * cannot reconnect with the tunnel's token.
+   *
+   * @example
+   * ```ts
+   * await client.tunnels.delete(
+   *   '62d438d2-8a51-4c5e-9d0c-1f6b2a7e4c39',
+   * );
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/tunnels/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Retrieves a tunnel with its status and the tunnel processes connected to it. The
+   * response never includes `tunnel_token`.
+   *
+   * @example
+   * ```ts
+   * const tunnel = await client.tunnels.retrieve(
+   *   '62d438d2-8a51-4c5e-9d0c-1f6b2a7e4c39',
+   * );
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<TunnelRetrieveResponse> {
+    return this._client.get(path`/tunnels/${id}`, options);
+  }
+}
+
+export interface Tunnel {
+  /**
+   * Identifies the resource.
+   */
+  id?: string;
+
+  /**
+   * The number of tunnel processes connected with the tunnel's token.
+   */
+  connection_count?: number;
+
+  /**
+   * The tunnel processes connected with the tunnel's token.
+   */
+  connections?: Array<Tunnel.Connection>;
+
+  /**
+   * ISO 8601 formatted date-time indicating when the resource was created.
+   */
+  created_at?: string;
+
+  /**
+   * A user specified name for the tunnel.
+   */
+  name?: string;
+
+  /**
+   * Identifies the type of the resource.
+   */
+  record_type?: string;
+
+  /**
+   * `inactive` when no tunnel process is connected, and `healthy` when one or more
+   * are. `degraded` (Preview, not reported yet) when a process is connected but
+   * fails to reach its destinations.
+   */
+  status?: 'inactive' | 'healthy' | 'degraded';
+}
+
+export namespace Tunnel {
+  /**
+   * A tunnel process connected to the tunnel.
+   */
+  export interface Connection {
+    /**
+     * When the process connected.
+     */
+    connected_at?: string;
+
+    /**
+     * The name the host reports for itself. Preview: empty until the CLI reports it.
+     */
+    hostname?: string;
+
+    /**
+     * The Telnyx region the process is connected to. Preview: empty until the CLI
+     * reports it.
+     */
+    region_code?: string;
+
+    /**
+     * The `telnyx-edge` CLI version of the process. Preview: empty until the CLI
+     * reports it.
+     */
+    version?: string;
+  }
+}
+
+export interface TunnelWithToken extends Tunnel {
+  /**
+   * The credential that a tunnel process presents with
+   * `telnyx-edge tunnel run --token`. Returned only by create and rotate_token.
+   * Telnyx stores only a hash of it.
+   */
+  tunnel_token?: string;
+}
+
+export interface TunnelCreateResponse {
+  data?: TunnelWithToken;
+}
+
+export interface TunnelRetrieveResponse {
+  data?: Tunnel;
+}
+
+export interface TunnelListResponse {
+  data?: Array<Tunnel>;
+
+  meta?: NetworkRoutesAPI.NetappsCursorPaginationMeta;
+}
+
+export interface TunnelListParams {
+  /**
+   * Consolidated filter parameter (deepObject style). Originally: filter[name],
+   * filter[status]
+   */
+  filter?: TunnelListParams.Filter;
+
+  /**
+   * Consolidated page parameter (deepObject style). Originally: page[after],
+   * page[limit]
+   */
+  page?: TunnelListParams.Page;
+
+  /**
+   * Sorts the results by a field, ascending, or descending with a leading `-`. The
+   * default is `-created_at`.
+   */
+  sort?:
+    | 'name'
+    | '-name'
+    | 'status'
+    | '-status'
+    | 'created_at'
+    | '-created_at'
+    | 'updated_at'
+    | '-updated_at';
+}
+
+export namespace TunnelListParams {
+  /**
+   * Consolidated filter parameter (deepObject style). Originally: filter[name],
+   * filter[status]
+   */
+  export interface Filter {
+    /**
+     * The name of the tunnel.
+     */
+    name?: string;
+
+    /**
+     * The status of the tunnel.
+     */
+    status?: 'inactive' | 'healthy' | 'degraded';
+  }
+
+  /**
+   * Consolidated page parameter (deepObject style). Originally: page[after],
+   * page[limit]
+   */
+  export interface Page {
+    /**
+     * The cursor from `meta.cursors.after` of the previous page.
+     */
+    after?: string;
+
+    /**
+     * The number of results per page.
+     */
+    limit?: number;
+  }
+}
+
+export interface TunnelCreateParams {
+  /**
+   * A user specified name for the tunnel.
+   */
+  name: string;
+}
+
+Tunnels.Actions = Actions;
+
+export declare namespace Tunnels {
+  export {
+    type Tunnel as Tunnel,
+    type TunnelWithToken as TunnelWithToken,
+    type TunnelCreateResponse as TunnelCreateResponse,
+    type TunnelRetrieveResponse as TunnelRetrieveResponse,
+    type TunnelListResponse as TunnelListResponse,
+    type TunnelListParams as TunnelListParams,
+    type TunnelCreateParams as TunnelCreateParams,
+  };
+
+  export { Actions as Actions, type ActionRotateTokenResponse as ActionRotateTokenResponse };
+}

package/src/resources/tunnels.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './tunnels/index';

package/src/resources/voice-clones.ts

@@ -59,11 +59,12 @@ export class VoiceClones extends APIResource {
   /**
    * Creates a new voice clone by uploading an audio file directly. Supported
    * formats: WAV, MP3, FLAC, OGG, M4A. Maximum file size: 20MB. Reference audio is
-   * trimmed per model: Qwen3TTS and Bayan use the first 10 seconds, Ultra uses up to
-   * 60 seconds, and Minimax accepts 10 seconds to 5 minutes. Ultra clones return
-   * `202` with status `pending`; all other models return `201` with status `active`.
-   * Bayan clones require `ref_text` (the exact transcript of the reference audio)
-   * and support `ar` (default) and `en` only.
+   * trimmed per model: Qwen3TTS, Bayan, and Resemble use the first 10 seconds, Ultra
+   * uses up to 60 seconds, and Minimax accepts 10 seconds to 5 minutes. Ultra clones
+   * return `202` with status `pending`; all other models return `201` with status
+   * `active`. Bayan clones require `ref_text` (the exact transcript of the reference
+   * audio) and support `ar` (default) and `en` only. Resemble clones
+   * (`provider: resemble`) take `model_id` `Pro`, `Turbo`, or `Urdu`.
    *
    * @example
    * ```ts
@@ -172,14 +173,15 @@ export interface VoiceCloneData {
   label?: string | null;
 
   /**
-   * ISO 639-1 language code of the voice clone.
+   * Language code of the voice clone (ISO 639-1, or the Resemble catalogue code such
+   * as `en-US`).
    */
   language?: string | null;
 
   /**
    * TTS model identifier for the voice clone.
    */
-  model_id?: 'Qwen3TTS' | 'Ultra' | 'Bayan' | 'speech-2.8-turbo';
+  model_id?: 'Qwen3TTS' | 'Ultra' | 'Bayan' | 'speech-2.8-turbo' | 'Pro' | 'Turbo' | 'Urdu';
 
   /**
    * Name of the voice clone.
@@ -265,6 +267,11 @@ export interface VoiceDesignsPaginationMeta {
 }
 
 export interface VoiceCloneListParams extends DefaultFlatPaginationParams {
+  /**
+   * Filter by TTS model. Case-insensitive.
+   */
+  'filter[model_id]'?: 'Qwen3TTS' | 'Ultra' | 'Bayan' | 'speech-2.8-turbo' | 'Pro' | 'Turbo' | 'Urdu';
+
   /**
    * Case-insensitive substring filter on the name field.
    */
@@ -360,7 +367,8 @@ export interface VoiceCloneCreateFromUploadParams {
     | VoiceCloneCreateFromUploadParams.TelnyxQwen3TtsClone
     | VoiceCloneCreateFromUploadParams.TelnyxUltraClone
     | VoiceCloneCreateFromUploadParams.TelnyxBayanClone
-    | VoiceCloneCreateFromUploadParams.MinimaxClone;
+    | VoiceCloneCreateFromUploadParams.MinimaxClone
+    | VoiceCloneCreateFromUploadParams.ResembleClone;
 }
 
 export namespace VoiceCloneCreateFromUploadParams {
@@ -557,6 +565,78 @@ export namespace VoiceCloneCreateFromUploadParams {
      */
     ref_text?: string;
   }
+
+  /**
+   * Upload-based voice clone using the Resemble provider. The clone is `active` on
+   * creation. Use it as voice `Resemble.<model_id>.<clone_id>`.
+   */
+  export interface ResembleClone {
+    /**
+     * Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A.
+     * Converted to WAV and trimmed to the first 10 seconds. For best quality, provide
+     * about 10 seconds of clean, single-speaker speech. Maximum size: 20MB.
+     */
+    audio_file: Uploadable;
+
+    /**
+     * Gender of the voice clone.
+     */
+    gender: 'male' | 'female' | 'neutral';
+
+    /**
+     * Resemble model: `Pro`, `Turbo` (English only), or `Urdu`. A clone works only
+     * with this model.
+     */
+    model_id: 'Pro' | 'Turbo' | 'Urdu';
+
+    /**
+     * Name for the voice clone.
+     */
+    name: string;
+
+    /**
+     * Voice synthesis provider. Must be `resemble`.
+     */
+    provider: 'resemble' | 'Resemble';
+
+    /**
+     * Optional custom label describing the voice style.
+     */
+    label?: string;
+
+    /**
+     * Language of the reference audio, matched case-insensitively. Pro: required, one
+     * of `ar`, `da`, `de`, `el`, `en-US`, `es`, `fi`, `fr-fr`, `he`, `hi`, `it`, `ja`,
+     * `ko`, `ms`, `nl`, `no`, `pl`, `pt`, `ru`, `sv`, `sw`, `tr`, `zh`. Turbo: `en` or
+     * `en-US` (default `en-US`). Urdu: `ur` (default). Other values return `422`.
+     */
+    language?:
+      | 'ar'
+      | 'da'
+      | 'de'
+      | 'el'
+      | 'en'
+      | 'en-US'
+      | 'es'
+      | 'fi'
+      | 'fr-fr'
+      | 'he'
+      | 'hi'
+      | 'it'
+      | 'ja'
+      | 'ko'
+      | 'ms'
+      | 'nl'
+      | 'no'
+      | 'pl'
+      | 'pt'
+      | 'ru'
+      | 'sv'
+      | 'sw'
+      | 'tr'
+      | 'ur'
+      | 'zh';
+  }
 }
 
 export interface VoiceCloneUpdateParams {

package/src/resources/whatsapp/hosted-signups.ts

@@ -192,7 +192,8 @@ export interface HostedSignupListParams extends DefaultFlatPaginationParams {}
 
 export interface HostedSignupCreateParams {
   /**
-   * Meta App ID linked to the Telnyx account. The app must be enabled.
+   * Meta App ID linked to the Telnyx account or its manager account. The app must be
+   * enabled.
    */
   app_id: string;
 

package/src/resources/wireguard-interfaces.ts

@@ -64,16 +64,6 @@ export interface WireguardInterface
    * Enable SIP traffic forwarding over VPN interface.
    */
   enable_sip_trunking?: boolean;
-
-  /**
-   * The Telnyx WireGuard peers `Peer.endpoint` value.
-   */
-  endpoint?: string;
-
-  /**
-   * The Telnyx WireGuard peers `Peer.PublicKey`.
-   */
-  public_key?: string;
 }
 
 export interface WireguardInterfaceRead {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '7.28.0'; // x-release-please-version
+export const VERSION = '7.29.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.28.0";
+export declare const VERSION = "7.29.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.28.0";
+export declare const VERSION = "7.29.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '7.28.0'; // x-release-please-version
+exports.VERSION = '7.29.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '7.28.0'; // x-release-please-version
+export const VERSION = '7.29.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map