telnyx 7.25.0 → 7.26.0

package/src/resources/whatsapp/index.ts

@@ -20,6 +20,13 @@ export {
   type PhoneNumberGetParams,
   type PhoneNumberListResponsesDefaultFlatPagination,
 } from './phone-numbers/index';
+export {
+  Signup,
+  type SignupListResponse,
+  type SignupRetrieveStatusResponse,
+  type SignupListParams,
+  type SignupListResponsesDefaultFlatPagination,
+} from './signup';
 export {
   Templates,
   type WhatsappTemplateBodyComponent,

package/src/resources/whatsapp/phone-numbers/calling-routing.ts

@@ -10,9 +10,9 @@ import { path } from '../../../internal/utils/path';
  */
 export class CallingRouting extends APIResource {
   /**
-   * Retrieve the routing connection currently stored for a BYON (Bring Your Own
-   * Number) phone number: the connection that inbound WhatsApp calls to the number
-   * are delivered to.
+   * Retrieve the connection ID currently stored for a WhatsApp Calling BYON (Bring
+   * Your Own Number) phone number: the connection that inbound WhatsApp calls to the
+   * number are delivered to.
    *
    * Use it to check the result of
    * `PATCH /whatsapp/phone_numbers/{id}/calling_routing`. A read made immediately
@@ -33,8 +33,9 @@ export class CallingRouting extends APIResource {
   }
 
   /**
-   * Set or clear the connection that inbound WhatsApp calls to a BYON (Bring Your
-   * Own Number) phone number are delivered to.
+   * Set or clear the connection ID for a WhatsApp Calling BYON (Bring Your Own
+   * Number) phone number: the connection that inbound WhatsApp calls to the number
+   * are delivered to.
    *
    * The update is processed asynchronously. A `202` response means the request was
    * accepted, not that the routing changed. Check the result with

package/src/resources/whatsapp/signup.ts

@@ -0,0 +1,188 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+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';
+
+export class Signup extends APIResource {
+  /**
+   * List finished WhatsApp Embedded Signup sessions, with status `SUCCESS` or
+   * `FAILURE`, newest first. Use the `errors` of a failed session to see why
+   * provisioning stopped.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const signupListResponse of client.whatsapp.signup.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: SignupListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<SignupListResponsesDefaultFlatPagination, SignupListResponse> {
+    return this._client.getAPIList('/whatsapp/signup', DefaultFlatPagination<SignupListResponse>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Retrieve the current state and status of a WhatsApp Embedded Signup session.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.whatsapp.signup.retrieveStatus('id');
+   * ```
+   */
+  retrieveStatus(id: string, options?: RequestOptions): APIPromise<SignupRetrieveStatusResponse> {
+    return this._client.get(path`/whatsapp/signup/${id}/status`, options);
+  }
+}
+
+export type SignupListResponsesDefaultFlatPagination = DefaultFlatPagination<SignupListResponse>;
+
+export interface SignupListResponse {
+  created_at?: string;
+
+  /**
+   * Tech provider customer reference submitted with the signup
+   */
+  customer_id?: string;
+
+  /**
+   * Errors recorded during provisioning
+   */
+  errors?: Array<string>;
+
+  record_type?: 'whatsapp_session_id';
+
+  /**
+   * Signup session ID
+   */
+  session_id?: string;
+
+  /**
+   * Current provisioning step, or the step that failed. `REGISTER_PHONE_NUMBER` is
+   * skipped for coexistence signups.
+   */
+  state?:
+    | 'SUBSCRIBE_WEBHOOKS'
+    | 'ASSIGNED_USERS'
+    | 'SHARE_CREDIT_LINE'
+    | 'REGISTER_PHONE_NUMBER'
+    | 'ADD_WABA_TO_DB'
+    | 'ADD_PHONE_NUMBERS_TO_DB'
+    | 'COMPLETE';
+
+  /**
+   * `INCOMPLETE` waits for the Meta signup code, `PENDING` is in progress, `SUCCESS`
+   * finished provisioning, and `FAILURE` stopped at `state`.
+   */
+  status?: 'INCOMPLETE' | 'PENDING' | 'SUCCESS' | 'FAILURE';
+
+  updated_at?: string;
+
+  /**
+   * Telnyx user ID that owns the signup session
+   */
+  user_id?: string;
+
+  /**
+   * Meta WhatsApp Business Account ID
+   */
+  waba_id?: string;
+}
+
+export interface SignupRetrieveStatusResponse {
+  data?: SignupRetrieveStatusResponse.Data;
+}
+
+export namespace SignupRetrieveStatusResponse {
+  export interface Data {
+    created_at?: string;
+
+    /**
+     * Tech provider customer reference submitted with the signup
+     */
+    customer_id?: string;
+
+    /**
+     * Errors recorded during provisioning
+     */
+    errors?: Array<string>;
+
+    record_type?: 'whatsapp_session_id';
+
+    /**
+     * Signup session ID
+     */
+    session_id?: string;
+
+    /**
+     * Current provisioning step, or the step that failed. `REGISTER_PHONE_NUMBER` is
+     * skipped for coexistence signups.
+     */
+    state?:
+      | 'SUBSCRIBE_WEBHOOKS'
+      | 'ASSIGNED_USERS'
+      | 'SHARE_CREDIT_LINE'
+      | 'REGISTER_PHONE_NUMBER'
+      | 'ADD_WABA_TO_DB'
+      | 'ADD_PHONE_NUMBERS_TO_DB'
+      | 'COMPLETE';
+
+    /**
+     * `INCOMPLETE` waits for the Meta signup code, `PENDING` is in progress, `SUCCESS`
+     * finished provisioning, and `FAILURE` stopped at `state`.
+     */
+    status?: 'INCOMPLETE' | 'PENDING' | 'SUCCESS' | 'FAILURE';
+
+    updated_at?: string;
+
+    /**
+     * Telnyx user ID that owns the signup session
+     */
+    user_id?: string;
+
+    /**
+     * Meta WhatsApp Business Account ID
+     */
+    waba_id?: string;
+  }
+}
+
+export interface SignupListParams extends DefaultFlatPaginationParams {
+  /**
+   * Return sessions created at or after this time (RFC 3339)
+   */
+  'filter[created_at][gte]'?: string;
+
+  /**
+   * Return sessions created at or before this time (RFC 3339)
+   */
+  'filter[created_at][lte]'?: string;
+
+  /**
+   * Filter by the tech provider customer reference
+   */
+  'filter[customer_id]'?: string;
+
+  /**
+   * Filter by Meta WABA ID
+   */
+  'filter[waba_id]'?: string;
+}
+
+export declare namespace Signup {
+  export {
+    type SignupListResponse as SignupListResponse,
+    type SignupRetrieveStatusResponse as SignupRetrieveStatusResponse,
+    type SignupListResponsesDefaultFlatPagination as SignupListResponsesDefaultFlatPagination,
+    type SignupListParams as SignupListParams,
+  };
+}

package/src/resources/whatsapp/whatsapp.ts

@@ -1,6 +1,14 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as SignupAPI from './signup';
+import {
+  Signup,
+  SignupListParams,
+  SignupListResponse,
+  SignupListResponsesDefaultFlatPagination,
+  SignupRetrieveStatusResponse,
+} from './signup';
 import * as TemplatesAPI from './templates';
 import {
   TemplateCreateParams,
@@ -51,12 +59,14 @@ export class Whatsapp extends APIResource {
   templates: TemplatesAPI.Templates = new TemplatesAPI.Templates(this._client);
   phoneNumbers: PhoneNumbersAPI.PhoneNumbers = new PhoneNumbersAPI.PhoneNumbers(this._client);
   userData: UserDataAPI.UserData = new UserDataAPI.UserData(this._client);
+  signup: SignupAPI.Signup = new SignupAPI.Signup(this._client);
 }
 
 Whatsapp.BusinessAccounts = BusinessAccounts;
 Whatsapp.Templates = Templates;
 Whatsapp.PhoneNumbers = PhoneNumbers;
 Whatsapp.UserData = UserData;
+Whatsapp.Signup = Signup;
 
 export declare namespace Whatsapp {
   export {
@@ -100,4 +110,12 @@ export declare namespace Whatsapp {
     type UserDataUpdateResponse as UserDataUpdateResponse,
     type UserDataUpdateParams as UserDataUpdateParams,
   };
+
+  export {
+    Signup as Signup,
+    type SignupListResponse as SignupListResponse,
+    type SignupRetrieveStatusResponse as SignupRetrieveStatusResponse,
+    type SignupListResponsesDefaultFlatPagination as SignupListResponsesDefaultFlatPagination,
+    type SignupListParams as SignupListParams,
+  };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '7.25.0'; // x-release-please-version
+export const VERSION = '7.26.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.25.0";
+export declare const VERSION = "7.26.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.25.0'; // x-release-please-version
+exports.VERSION = '7.26.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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