telnyx 7.26.0 → 7.27.0

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

@@ -0,0 +1,221 @@
+// 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 HostedSignups extends APIResource {
+  /**
+   * List hosted signups created by the account, newest first. Expired hosted signups
+   * are included.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const hostedSignupListResponse of client.whatsapp.hostedSignups.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: HostedSignupListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<HostedSignupListResponsesDefaultFlatPagination, HostedSignupListResponse> {
+    return this._client.getAPIList(
+      '/whatsapp/hosted_signups',
+      DefaultFlatPagination<HostedSignupListResponse>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Create a time-limited onboarding URL on the Telnyx-hosted Embedded Signup page
+   * for a Tech Provider's end customer. Set `signup_type` to `coexistence` to launch
+   * Meta's WhatsApp Business app coexistence flow instead of standard Cloud API
+   * onboarding.
+   *
+   * @example
+   * ```ts
+   * const hostedSignup =
+   *   await client.whatsapp.hostedSignups.create({
+   *     app_id: '123456789012345',
+   *     signup_type: 'coexistence',
+   *   });
+   * ```
+   */
+  create(body: HostedSignupCreateParams, options?: RequestOptions): APIPromise<HostedSignupCreateResponse> {
+    return this._client.post('/whatsapp/hosted_signups', { body, ...options });
+  }
+
+  /**
+   * Retrieve a hosted signup and its onboarding URL.
+   *
+   * @example
+   * ```ts
+   * const hostedSignup =
+   *   await client.whatsapp.hostedSignups.retrieve('id');
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<HostedSignupRetrieveResponse> {
+    return this._client.get(path`/whatsapp/hosted_signups/${id}`, options);
+  }
+}
+
+export type HostedSignupListResponsesDefaultFlatPagination = DefaultFlatPagination<HostedSignupListResponse>;
+
+export interface HostedSignupCreateResponse {
+  data?: HostedSignupCreateResponse.Data;
+}
+
+export namespace HostedSignupCreateResponse {
+  export interface Data {
+    /**
+     * Hosted signup ID
+     */
+    id?: string;
+
+    /**
+     * Meta App ID the hosted signup onboards customers into
+     */
+    app_id?: string;
+
+    created_at?: string;
+
+    /**
+     * When the onboarding URL stops working
+     */
+    expires_at?: string;
+
+    /**
+     * Signed token embedded in `url`
+     */
+    jwt?: string;
+
+    record_type?: 'whatsapp_jwt';
+
+    /**
+     * Meta Partner Solution ID linked to the app. Returned only when creating a hosted
+     * signup.
+     */
+    solution_id?: string;
+
+    /**
+     * Hosted onboarding URL to share with the end customer
+     */
+    url?: string;
+  }
+}
+
+export interface HostedSignupRetrieveResponse {
+  data?: HostedSignupRetrieveResponse.Data;
+}
+
+export namespace HostedSignupRetrieveResponse {
+  export interface Data {
+    /**
+     * Hosted signup ID
+     */
+    id?: string;
+
+    /**
+     * Meta App ID the hosted signup onboards customers into
+     */
+    app_id?: string;
+
+    created_at?: string;
+
+    /**
+     * When the onboarding URL stops working
+     */
+    expires_at?: string;
+
+    /**
+     * Signed token embedded in `url`
+     */
+    jwt?: string;
+
+    record_type?: 'whatsapp_jwt';
+
+    /**
+     * Meta Partner Solution ID linked to the app. Returned only when creating a hosted
+     * signup.
+     */
+    solution_id?: string;
+
+    /**
+     * Hosted onboarding URL to share with the end customer
+     */
+    url?: string;
+  }
+}
+
+export interface HostedSignupListResponse {
+  /**
+   * Hosted signup ID
+   */
+  id?: string;
+
+  /**
+   * Meta App ID the hosted signup onboards customers into
+   */
+  app_id?: string;
+
+  created_at?: string;
+
+  /**
+   * When the onboarding URL stops working
+   */
+  expires_at?: string;
+
+  /**
+   * Signed token embedded in `url`
+   */
+  jwt?: string;
+
+  record_type?: 'whatsapp_jwt';
+
+  /**
+   * Meta Partner Solution ID linked to the app. Returned only when creating a hosted
+   * signup.
+   */
+  solution_id?: string;
+
+  /**
+   * Hosted onboarding URL to share with the end customer
+   */
+  url?: string;
+}
+
+export interface HostedSignupListParams extends DefaultFlatPaginationParams {}
+
+export interface HostedSignupCreateParams {
+  /**
+   * Meta App ID linked to the Telnyx account. The app must be enabled.
+   */
+  app_id: string;
+
+  /**
+   * When the onboarding URL expires, in RFC 3339 format. Must be in the future and
+   * at most 3 days ahead. Defaults to 24 hours after creation.
+   */
+  expires_at?: string;
+
+  /**
+   * Onboarding flow the hosted page launches. Use `coexistence` for a number that
+   * remains active in the WhatsApp Business app.
+   */
+  signup_type?: 'standard' | 'coexistence';
+}
+
+export declare namespace HostedSignups {
+  export {
+    type HostedSignupCreateResponse as HostedSignupCreateResponse,
+    type HostedSignupRetrieveResponse as HostedSignupRetrieveResponse,
+    type HostedSignupListResponse as HostedSignupListResponse,
+    type HostedSignupListResponsesDefaultFlatPagination as HostedSignupListResponsesDefaultFlatPagination,
+    type HostedSignupListParams as HostedSignupListParams,
+    type HostedSignupCreateParams as HostedSignupCreateParams,
+  };
+}

package/src/resources/whatsapp/index.ts

@@ -7,6 +7,15 @@ export {
   type BusinessAccountListParams,
   type BusinessAccountListResponsesDefaultFlatPagination,
 } from './business-accounts/index';
+export {
+  HostedSignups,
+  type HostedSignupCreateResponse,
+  type HostedSignupRetrieveResponse,
+  type HostedSignupListResponse,
+  type HostedSignupListParams,
+  type HostedSignupCreateParams,
+  type HostedSignupListResponsesDefaultFlatPagination,
+} from './hosted-signups';
 export {
   PhoneNumbers,
   type PhoneNumberListResponse,

package/src/resources/whatsapp/whatsapp.ts

@@ -1,6 +1,16 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as HostedSignupsAPI from './hosted-signups';
+import {
+  HostedSignupCreateParams,
+  HostedSignupCreateResponse,
+  HostedSignupListParams,
+  HostedSignupListResponse,
+  HostedSignupListResponsesDefaultFlatPagination,
+  HostedSignupRetrieveResponse,
+  HostedSignups,
+} from './hosted-signups';
 import * as SignupAPI from './signup';
 import {
   Signup,
@@ -60,6 +70,7 @@ export class Whatsapp extends APIResource {
   phoneNumbers: PhoneNumbersAPI.PhoneNumbers = new PhoneNumbersAPI.PhoneNumbers(this._client);
   userData: UserDataAPI.UserData = new UserDataAPI.UserData(this._client);
   signup: SignupAPI.Signup = new SignupAPI.Signup(this._client);
+  hostedSignups: HostedSignupsAPI.HostedSignups = new HostedSignupsAPI.HostedSignups(this._client);
 }
 
 Whatsapp.BusinessAccounts = BusinessAccounts;
@@ -67,6 +78,7 @@ Whatsapp.Templates = Templates;
 Whatsapp.PhoneNumbers = PhoneNumbers;
 Whatsapp.UserData = UserData;
 Whatsapp.Signup = Signup;
+Whatsapp.HostedSignups = HostedSignups;
 
 export declare namespace Whatsapp {
   export {
@@ -118,4 +130,14 @@ export declare namespace Whatsapp {
     type SignupListResponsesDefaultFlatPagination as SignupListResponsesDefaultFlatPagination,
     type SignupListParams as SignupListParams,
   };
+
+  export {
+    HostedSignups as HostedSignups,
+    type HostedSignupCreateResponse as HostedSignupCreateResponse,
+    type HostedSignupRetrieveResponse as HostedSignupRetrieveResponse,
+    type HostedSignupListResponse as HostedSignupListResponse,
+    type HostedSignupListResponsesDefaultFlatPagination as HostedSignupListResponsesDefaultFlatPagination,
+    type HostedSignupListParams as HostedSignupListParams,
+    type HostedSignupCreateParams as HostedSignupCreateParams,
+  };
 }

package/src/version.ts

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

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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