telnyx 7.27.0 → 7.28.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/index.ts

@@ -197,7 +197,7 @@ export {
   type CommentListParams,
   type CommentCreateParams,
 } from './comments';
-export { Compute } from './compute/compute';
+export { Compute, type ComputeRetrieveResponse } from './compute/compute';
 export {
   Conferences,
   type Conference,
@@ -1411,6 +1411,18 @@ export {
   type SubNumberOrdersReportDownloadResponse,
   type SubNumberOrdersReportCreateParams,
 } from './sub-number-orders-report';
+export {
+  TailscaleSubnetRouters,
+  type TailscaleSubnetRouter,
+  type TailscaleSubnetRouterCreateResponse,
+  type TailscaleSubnetRouterRetrieveResponse,
+  type TailscaleSubnetRouterUpdateResponse,
+  type TailscaleSubnetRouterDeleteResponse,
+  type TailscaleSubnetRouterListParams,
+  type TailscaleSubnetRouterCreateParams,
+  type TailscaleSubnetRouterUpdateParams,
+  type TailscaleSubnetRoutersDefaultFlatPagination,
+} from './tailscale-subnet-routers';
 export {
   TelephonyCredentials,
   type TelephonyCredential,

package/src/resources/network-coverage.ts

@@ -23,7 +23,11 @@ export class NetworkCoverage extends APIResource {
 export type NetworkCoverageListResponsesDefaultFlatPagination =
   DefaultFlatPagination<NetworkCoverageListResponse>;
 
-export type AvailableService = 'cloud_vpn' | 'private_wireless_gateway' | 'virtual_cross_connect';
+export type AvailableService =
+  | 'cloud_vpn'
+  | 'private_wireless_gateway'
+  | 'tailscale_subnet_router'
+  | 'virtual_cross_connect';
 
 export interface NetappsLocation17904fcfbc {
   /**

package/src/resources/number-lookup.ts

@@ -27,6 +27,12 @@ export interface NumberLookupRetrieveResponse {
 
 export namespace NumberLookupRetrieveResponse {
   export interface Data {
+    /**
+     * Identity information for the phone number's owner, including name and postal
+     * address. Populated when `type=caller-identity` is requested.
+     */
+    caller_identity?: Data.CallerIdentity;
+
     caller_name?: Data.CallerName;
 
     carrier?: Data.Carrier;
@@ -36,6 +42,12 @@ export namespace NumberLookupRetrieveResponse {
      */
     country_code?: string;
 
+    /**
+     * Enhanced caller name for the phone number's owner. Populated when
+     * `type=enhanced-caller-name` is requested.
+     */
+    enhanced_caller_name?: Data.EnhancedCallerName;
+
     /**
      * Unused
      */
@@ -47,6 +59,12 @@ export namespace NumberLookupRetrieveResponse {
      */
     national_format?: string;
 
+    /**
+     * Network number ID (NNID) override for the phone number, when one applies
+     * (available only to accounts enabled for NNID); otherwise null.
+     */
+    nnid_override?: Data.NnidOverride | null;
+
     /**
      * E164-formatted phone number
      */
@@ -58,9 +76,87 @@ export namespace NumberLookupRetrieveResponse {
      * Identifies the type of record
      */
     record_type?: string;
+
+    /**
+     * Indicates whether the phone number is valid.
+     */
+    valid_number?: boolean;
   }
 
   export namespace Data {
+    /**
+     * Identity information for the phone number's owner, including name and postal
+     * address. Populated when `type=caller-identity` is requested.
+     */
+    export interface CallerIdentity {
+      /**
+       * Postal address associated with the phone number's owner.
+       */
+      address?: CallerIdentity.Address;
+
+      /**
+       * How strongly the phone number is linked to the returned name, on a scale of 50
+       * to 90 (higher means more supporting signals). Reflects signal strength, not
+       * probability: 70 indicates stronger, more consistent evidence than 60, not a 70%
+       * chance of being correct. As a guide, 70+ is high confidence, 60 moderate, and 50
+       * limited. Below 50 no name is returned, so scores under 50 are never present.
+       */
+      confidence_score?: number | null;
+
+      /**
+       * A lookup-specific error code if the identity could not be resolved; otherwise
+       * null.
+       */
+      error_code?: string | null;
+
+      /**
+       * The name associated with the phone number.
+       */
+      name?: string | null;
+    }
+
+    export namespace CallerIdentity {
+      /**
+       * Postal address associated with the phone number's owner.
+       */
+      export interface Address {
+        /**
+         * City.
+         */
+        city?: string | null;
+
+        /**
+         * Two-letter ISO 3166-1 country code.
+         */
+        country_code?: string | null;
+
+        /**
+         * Postal or ZIP code.
+         */
+        postal_code?: string | null;
+
+        /**
+         * Two-letter state or province code.
+         */
+        state_code?: string | null;
+
+        /**
+         * First line of the street address.
+         */
+        street_line_1?: string | null;
+
+        /**
+         * Second line of the street address, if any.
+         */
+        street_line_2?: string | null;
+
+        /**
+         * ZIP+4 extension, if available.
+         */
+        zip4?: string | null;
+      }
+    }
+
     export interface CallerName {
       /**
        * The name of the requested phone number's owner as per the CNAM database
@@ -122,6 +218,44 @@ export namespace NumberLookupRetrieveResponse {
         | 'unknown';
     }
 
+    /**
+     * Enhanced caller name for the phone number's owner. Populated when
+     * `type=enhanced-caller-name` is requested.
+     */
+    export interface EnhancedCallerName {
+      /**
+       * The name associated with the phone number.
+       */
+      caller_name?: string | null;
+
+      /**
+       * A lookup-specific error code if the enhanced caller name could not be resolved;
+       * otherwise null.
+       */
+      error_code?: string | null;
+    }
+
+    /**
+     * Network number ID (NNID) override for the phone number, when one applies
+     * (available only to accounts enabled for NNID); otherwise null.
+     */
+    export interface NnidOverride {
+      /**
+       * Name associated with the NNID.
+       */
+      name?: string;
+
+      /**
+       * The network number ID.
+       */
+      nnid?: string;
+
+      /**
+       * The NNID type.
+       */
+      type?: string;
+    }
+
     export interface Portability {
       /**
        * Alternative SPID (Service Provider ID). Often used when a carrier is using a
@@ -146,9 +280,22 @@ export namespace NumberLookupRetrieveResponse {
       city?: string;
 
       /**
-       * Type of number
+       * The line type of the phone number. Uses the same value set as carrier.type; see
+       * the API reference for the full list.
        */
-      line_type?: string;
+      line_type?:
+        | 'fixed line'
+        | 'mobile'
+        | 'voip'
+        | 'fixed line or mobile'
+        | 'toll free'
+        | 'premium rate'
+        | 'shared cost'
+        | 'personal number'
+        | 'pager'
+        | 'uan'
+        | 'voicemail'
+        | 'unknown';
 
       /**
        * Local Routing Number, if assigned to the requested phone number
@@ -193,9 +340,12 @@ export namespace NumberLookupRetrieveResponse {
 
 export interface NumberLookupRetrieveParams {
   /**
-   * Specifies the type of number lookup to be performed
+   * Specifies the type of number lookup to be performed. May be supplied more than
+   * once to request several data sources in a single call (for example,
+   * `?type=carrier&type=enhanced-caller-name`). Each requested type populates the
+   * corresponding object in the response.
    */
-  type?: 'carrier' | 'caller-name';
+  type?: 'carrier' | 'caller-name' | 'caller-identity' | 'enhanced-caller-name';
 }
 
 export declare namespace NumberLookup {