telnyx 7.27.0 → 7.29.0

package/src/resources/compute/funcs/funcs.ts

@@ -5,9 +5,17 @@ import * as FuncsAPI from './funcs';
 import * as ExportAPI from './export';
 import { Export, ExportCreateParams, FuncLogExportConfigResponse } from './export';
 import { APIPromise } from '../../../core/api-promise';
+import {
+  DefaultFlatPagination,
+  type DefaultFlatPaginationParams,
+  PagePromise,
+} from '../../../core/pagination';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
+/**
+ * Manage Edge Compute functions
+ */
 export class Funcs extends APIResource {
   export: ExportAPI.Export = new ExportAPI.Export(this._client);
 
@@ -91,8 +99,34 @@ export class Funcs extends APIResource {
   ): APIPromise<FuncRetrieveShipInspectionResponse> {
     return this._client.get(path`/compute/funcs/${id}/ship_inspection`, options);
   }
+
+  /**
+   * List functions for the authenticated organization. Each function includes its
+   * persisted function-scoped bindings. Actor bindings expose actor_type and
+   * env_name, allowing clients to identify every function attached to a Stateful
+   * Actor type.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const funcListResponse of client.compute.funcs.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: FuncListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<FuncListResponsesDefaultFlatPagination, FuncListResponse> {
+    return this._client.getAPIList('/compute/funcs', DefaultFlatPagination<FuncListResponse>, {
+      query,
+      ...options,
+    });
+  }
 }
 
+export type FuncListResponsesDefaultFlatPagination = DefaultFlatPagination<FuncListResponse>;
+
 export interface FunctionsObservabilityPaginationMeta {
   page_number?: number;
 
@@ -109,6 +143,66 @@ export interface LogsMeta {
   partial?: boolean;
 }
 
+export interface FuncListResponse {
+  id?: string;
+
+  /**
+   * Always present; empty when the function has no bindings.
+   */
+  bindings?: Array<FuncListResponse.Binding>;
+
+  created_at?: string;
+
+  invoke_url?: string;
+
+  message?: string;
+
+  name?: string;
+
+  record_type?: string;
+
+  status?: string;
+
+  status_detail?: string;
+
+  updated_at?: string;
+}
+
+export namespace FuncListResponse {
+  /**
+   * A function-scoped binding persisted at ship time. For binding_type=actor,
+   * actor_type is the referenced Stateful Actor type and env_name is the binding
+   * name exposed to the function.
+   */
+  export interface Binding {
+    actor_type?: string;
+
+    binding_id?: string;
+
+    binding_type?: string;
+
+    bucket_id?: string;
+
+    created_at?: string;
+
+    env_name?: string;
+
+    func_id?: string;
+
+    kv_id?: string;
+
+    record_type?: string;
+
+    secret_name?: string;
+
+    sqldb_id?: string;
+
+    status?: string;
+
+    updated_at?: string;
+  }
+}
+
 export type FuncRetrieveLogsResponse =
   | FuncRetrieveLogsResponse.FuncRuntimeLogsResponse
   | FuncRetrieveLogsResponse.FuncInvocationLogsResponse;
@@ -318,19 +412,24 @@ export interface FuncRetrieveRevisionsParams {
   'page[size]'?: number;
 }
 
+export interface FuncListParams extends DefaultFlatPaginationParams {}
+
 Funcs.Export = Export;
 
 export declare namespace Funcs {
   export {
     type FunctionsObservabilityPaginationMeta as FunctionsObservabilityPaginationMeta,
     type LogsMeta as LogsMeta,
+    type FuncListResponse as FuncListResponse,
     type FuncRetrieveLogsResponse as FuncRetrieveLogsResponse,
     type FuncRetrieveMetricAggregatesResponse as FuncRetrieveMetricAggregatesResponse,
     type FuncRetrieveRevisionsResponse as FuncRetrieveRevisionsResponse,
     type FuncRetrieveShipInspectionResponse as FuncRetrieveShipInspectionResponse,
+    type FuncListResponsesDefaultFlatPagination as FuncListResponsesDefaultFlatPagination,
     type FuncRetrieveLogsParams as FuncRetrieveLogsParams,
     type FuncRetrieveMetricAggregatesParams as FuncRetrieveMetricAggregatesParams,
     type FuncRetrieveRevisionsParams as FuncRetrieveRevisionsParams,
+    type FuncListParams as FuncListParams,
   };
 
   export {

package/src/resources/compute/funcs/index.ts

@@ -5,6 +5,7 @@ export {
   Funcs,
   type FunctionsObservabilityPaginationMeta,
   type LogsMeta,
+  type FuncListResponse,
   type FuncRetrieveLogsResponse,
   type FuncRetrieveMetricAggregatesResponse,
   type FuncRetrieveRevisionsResponse,
@@ -12,4 +13,6 @@ export {
   type FuncRetrieveLogsParams,
   type FuncRetrieveMetricAggregatesParams,
   type FuncRetrieveRevisionsParams,
+  type FuncListParams,
+  type FuncListResponsesDefaultFlatPagination,
 } from './funcs';

package/src/resources/compute/index.ts

@@ -1,10 +1,11 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Compute } from './compute';
+export { Compute, type ComputeRetrieveResponse } from './compute';
 export {
   Funcs,
   type FunctionsObservabilityPaginationMeta,
   type LogsMeta,
+  type FuncListResponse,
   type FuncRetrieveLogsResponse,
   type FuncRetrieveMetricAggregatesResponse,
   type FuncRetrieveRevisionsResponse,
@@ -12,4 +13,6 @@ export {
   type FuncRetrieveLogsParams,
   type FuncRetrieveMetricAggregatesParams,
   type FuncRetrieveRevisionsParams,
+  type FuncListParams,
+  type FuncListResponsesDefaultFlatPagination,
 } from './funcs/index';

package/src/resources/conferences/actions.ts

@@ -787,8 +787,9 @@ export interface ActionSpeakParams {
    *   `Minimax.speech-02-hd.Wise_Woman`). Supported models: `speech-02-turbo`,
    *   `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
    *   to configure speed, volume, pitch, and language_boost.
-   * - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
-   *   `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
+   * - **Resemble:** Use `Resemble.<ModelId>.<VoiceId>` (e.g.,
+   *   `Resemble.Turbo.Aaron_en-US`). Supported models: `Pro`, `Turbo`, `Urdu`.
+   *   `<VoiceId>` is a stock voice name or the ID of a Resemble voice clone. Use
    *   `voice_settings` to configure precision, sample_rate, and format.
    * - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
    *   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,

package/src/resources/email/dedicated-ips/actions.ts

@@ -0,0 +1,87 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as DedicatedIPsAPI from './dedicated-ips';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Purchase and manage dedicated sending IP addresses for your Telnyx email traffic.
+ */
+export class Actions extends APIResource {
+  /**
+   * Manually complete the warm-up ramp (`warming_up` to `active`), bypassing the
+   * schedule. Use only for an IP already warmed elsewhere. Completion sets
+   * `warmup.progress` to `100`, clears `warmup.daily_cap`, and applies the
+   * ramp-complete allowance to the current UTC day: `warmup.today.cap` becomes
+   * `100000000`, `warmup.today.granted` keeps the sends already released today, and
+   * `warmup.today.remaining` becomes `cap` minus `granted`. Once completion applies
+   * this allowance, an exhausted stage allowance does not block the next eligible
+   * first-attempt send. The response reports these values. On an `active` IP,
+   * `warmup.progress` and `warmup.daily_cap` are informational: they can keep
+   * earlier values after a suspension is lifted and do not limit sending.
+   *
+   * @example
+   * ```ts
+   * const dedicatedIPShowResponse =
+   *   await client.email.dedicatedIPs.actions.completeWarmup(
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   );
+   * ```
+   */
+  completeWarmup(id: string, options?: RequestOptions): APIPromise<DedicatedIPsAPI.DedicatedIPShowResponse> {
+    return this._client.post(path`/email/dedicated_ips/${id}/actions/complete_warmup`, options);
+  }
+
+  /**
+   * Pause the warm-up ramp at its current stage. While paused, the IP releases no
+   * first-attempt sends from hold and the ramp does not advance. Only a `warming_up`
+   * IP can be paused; pausing an already paused IP refreshes `paused_at`.
+   *
+   * @example
+   * ```ts
+   * const dedicatedIPShowResponse =
+   *   await client.email.dedicatedIPs.actions.pauseWarmup(
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   );
+   * ```
+   */
+  pauseWarmup(id: string, options?: RequestOptions): APIPromise<DedicatedIPsAPI.DedicatedIPShowResponse> {
+    return this._client.post(path`/email/dedicated_ips/${id}/actions/pause_warmup`, options);
+  }
+
+  /**
+   * Resume a paused warm-up ramp from its held stage. Only a `warming_up` IP can be
+   * resumed; resuming a ramp that is not paused returns the IP unchanged.
+   *
+   * @example
+   * ```ts
+   * const dedicatedIPShowResponse =
+   *   await client.email.dedicatedIPs.actions.resumeWarmup(
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   );
+   * ```
+   */
+  resumeWarmup(id: string, options?: RequestOptions): APIPromise<DedicatedIPsAPI.DedicatedIPShowResponse> {
+    return this._client.post(path`/email/dedicated_ips/${id}/actions/resume_warmup`, options);
+  }
+
+  /**
+   * Start the warm-up ramp (`provisioning` to `warming_up`). The ramp never starts
+   * automatically. Only a `provisioning` IP can be started; a `suspended` IP returns
+   * `409`. Starting does not check DNS: the IP carries mail only while
+   * `dns_confirmed_at` is set and the IP is in a pool that routes mail.
+   *
+   * @example
+   * ```ts
+   * const dedicatedIPShowResponse =
+   *   await client.email.dedicatedIPs.actions.startWarmup(
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   );
+   * ```
+   */
+  startWarmup(id: string, options?: RequestOptions): APIPromise<DedicatedIPsAPI.DedicatedIPShowResponse> {
+    return this._client.post(path`/email/dedicated_ips/${id}/actions/start_warmup`, options);
+  }
+}