@sentdm/sentdm 0.36.0 → 0.38.0

package/src/resources/contacts.ts

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as WebhooksAPI from './webhooks';
 import { APIPromise } from '../core/api-promise';
+import { ContactsPage, type ContactsPageParams, PagePromise } from '../core/pagination';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
@@ -20,12 +22,12 @@ export class Contacts extends APIResource {
    *
    * @example
    * ```ts
-   * const contact = await client.contacts.create({
+   * const apiResponseOfContact = await client.contacts.create({
    *   phone_number: '+1234567890',
    * });
    * ```
    */
-  create(params: ContactCreateParams, options?: RequestOptions): APIPromise<ContactCreateResponse> {
+  create(params: ContactCreateParams, options?: RequestOptions): APIPromise<APIResponseOfContact> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.post('/v3/contacts', {
       body,
@@ -47,7 +49,7 @@ export class Contacts extends APIResource {
    *
    * @example
    * ```ts
-   * const contact = await client.contacts.retrieve(
+   * const apiResponseOfContact = await client.contacts.retrieve(
    *   '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
    * );
    * ```
@@ -56,7 +58,7 @@ export class Contacts extends APIResource {
     id: string,
     params: ContactRetrieveParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ContactRetrieveResponse> {
+  ): APIPromise<APIResponseOfContact> {
     const { 'x-profile-id': xProfileID } = params ?? {};
     return this._client.get(path`/v3/contacts/${id}`, {
       ...options,
@@ -72,7 +74,7 @@ export class Contacts extends APIResource {
    *
    * @example
    * ```ts
-   * const contact = await client.contacts.update(
+   * const apiResponseOfContact = await client.contacts.update(
    *   '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
    * );
    * ```
@@ -81,7 +83,7 @@ export class Contacts extends APIResource {
     id: string,
     params: ContactUpdateParams,
     options?: RequestOptions,
-  ): APIPromise<ContactUpdateResponse> {
+  ): APIPromise<APIResponseOfContact> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.patch(path`/v3/contacts/${id}`, {
       body,
@@ -102,15 +104,18 @@ export class Contacts extends APIResource {
    *
    * @example
    * ```ts
-   * const contacts = await client.contacts.list({
-   *   page: 0,
-   *   page_size: 0,
-   * });
+   * // Automatically fetches more pages as needed.
+   * for await (const contactResponse of client.contacts.list()) {
+   *   // ...
+   * }
    * ```
    */
-  list(params: ContactListParams, options?: RequestOptions): APIPromise<ContactListResponse> {
-    const { 'x-profile-id': xProfileID, ...query } = params;
-    return this._client.get('/v3/contacts', {
+  list(
+    params: ContactListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ContactResponsesContactsPage, ContactResponse> {
+    const { 'x-profile-id': xProfileID, ...query } = params ?? {};
+    return this._client.getAPIList('/v3/contacts', ContactsPage<ContactResponse>, {
       query,
       ...options,
       headers: buildHeaders([
@@ -154,7 +159,7 @@ export class Contacts extends APIResource {
    *
    * @example
    * ```ts
-   * const response =
+   * const apiResponseOfContactMessageSummary =
    *   await client.contacts.retrieveMessageSummary(
    *     '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
    *   );
@@ -164,7 +169,7 @@ export class Contacts extends APIResource {
     contactID: string,
     params: ContactRetrieveMessageSummaryParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ContactRetrieveMessageSummaryResponse> {
+  ): APIPromise<APIResponseOfContactMessageSummary> {
     const { 'x-profile-id': xProfileID } = params ?? {};
     return this._client.get(path`/v3/contacts/${contactID}/message-summary`, {
       ...options,
@@ -176,24 +181,26 @@ export class Contacts extends APIResource {
   }
 }
 
+export type ContactResponsesContactsPage = ContactsPage<ContactResponse>;
+
 /**
  * Standard API response envelope for all v3 endpoints
  */
-export interface ContactCreateResponse {
+export interface APIResponseOfContact {
   /**
    * Contact response for v3 API Uses snake_case for JSON property names
    */
-  data?: ContactCreateResponse.Data | null;
+  data?: ContactResponse | null;
 
   /**
    * Error information
    */
-  error?: ContactCreateResponse.Error | null;
+  error?: WebhooksAPI.ErrorDetail | null;
 
   /**
    * Request and response metadata
    */
-  meta?: ContactCreateResponse.Meta;
+  meta?: WebhooksAPI.APIMeta;
 
   /**
    * Indicates whether the request was successful
@@ -201,155 +208,24 @@ export interface ContactCreateResponse {
   success?: boolean;
 }
 
-export namespace ContactCreateResponse {
-  /**
-   * Contact response for v3 API Uses snake_case for JSON property names
-   */
-  export interface Data {
-    /**
-     * Unique identifier for the contact
-     */
-    id?: string;
-
-    /**
-     * Comma-separated list of available messaging channels (e.g., "sms,whatsapp")
-     */
-    available_channels?: string;
-
-    /**
-     * Country calling code (e.g., 1 for US/Canada)
-     */
-    country_code?: string;
-
-    /**
-     * When the contact was created
-     */
-    created_at?: string;
-
-    /**
-     * Which customer owns this — the key's own, or the profile named in x-profile-id.
-     * Says whose resource this is, which the resource's own id does not.
-     */
-    customer_id?: string;
-
-    /**
-     * Default messaging channel to use (e.g., "sms" or "whatsapp")
-     */
-    default_channel?: string;
-
-    /**
-     * Phone number in E.164 format (e.g., +1234567890)
-     */
-    format_e164?: string;
-
-    /**
-     * Phone number in international format (e.g., +1 234-567-890)
-     */
-    format_international?: string;
-
-    /**
-     * Phone number in national format (e.g., (234) 567-890)
-     */
-    format_national?: string;
-
-    /**
-     * Phone number in RFC 3966 format (e.g., tel:+1-234-567-890)
-     */
-    format_rfc?: string;
-
-    /**
-     * @deprecated Always false. Contacts are no longer shared or inherited between
-     * sender profiles — a profile sees only the contacts it owns. Retained so existing
-     * v3 clients reading is_inherited keep deserializing; it carries no information.
-     */
-    is_inherited?: boolean;
-
-    /**
-     * Whether the contact has opted out of messaging. Single source of truth — opt-out
-     * is per-contact, not per-channel.
-     */
-    opt_out?: boolean;
-
-    /**
-     * Phone number in original format
-     */
-    phone_number?: string;
-
-    /**
-     * ISO 3166-1 alpha-2 country code (e.g., US, CA, GB)
-     */
-    region_code?: string;
-
-    /**
-     * When the contact was last updated
-     */
-    updated_at?: string | null;
-  }
-
-  /**
-   * Error information
-   */
-  export interface Error {
-    /**
-     * Machine-readable error code (e.g., "RESOURCE_001")
-     */
-    code?: string;
-
-    /**
-     * Additional validation error details (field-level errors)
-     */
-    details?: { [key: string]: Array<string> } | null;
-
-    /**
-     * URL to documentation about this error
-     */
-    doc_url?: string | null;
-
-    /**
-     * Human-readable error message
-     */
-    message?: string;
-  }
-
-  /**
-   * Request and response metadata
-   */
-  export interface Meta {
-    /**
-     * Unique identifier for this request (for tracing and support)
-     */
-    request_id?: string;
-
-    /**
-     * Server timestamp when the response was generated
-     */
-    timestamp?: string;
-
-    /**
-     * API version used for this request
-     */
-    version?: string;
-  }
-}
-
 /**
  * Standard API response envelope for all v3 endpoints
  */
-export interface ContactRetrieveResponse {
+export interface APIResponseOfContactMessageSummary {
   /**
-   * Contact response for v3 API Uses snake_case for JSON property names
+   * The response data (null if error)
    */
-  data?: ContactRetrieveResponse.Data | null;
+  data?: ContactMessageSummary | null;
 
   /**
    * Error information
    */
-  error?: ContactRetrieveResponse.Error | null;
+  error?: WebhooksAPI.ErrorDetail | null;
 
   /**
    * Request and response metadata
    */
-  meta?: ContactRetrieveResponse.Meta;
+  meta?: WebhooksAPI.APIMeta;
 
   /**
    * Indicates whether the request was successful
@@ -357,622 +233,119 @@ export interface ContactRetrieveResponse {
   success?: boolean;
 }
 
-export namespace ContactRetrieveResponse {
-  /**
-   * Contact response for v3 API Uses snake_case for JSON property names
-   */
-  export interface Data {
-    /**
-     * Unique identifier for the contact
-     */
-    id?: string;
-
-    /**
-     * Comma-separated list of available messaging channels (e.g., "sms,whatsapp")
-     */
-    available_channels?: string;
-
-    /**
-     * Country calling code (e.g., 1 for US/Canada)
-     */
-    country_code?: string;
-
-    /**
-     * When the contact was created
-     */
-    created_at?: string;
+export interface ContactMessageSummary {
+  channel_scores?: Array<ContactMessageSummary.ChannelScore>;
 
-    /**
-     * Which customer owns this — the key's own, or the profile named in x-profile-id.
-     * Says whose resource this is, which the resource's own id does not.
-     */
-    customer_id?: string;
+  channels_used?: Array<string>;
 
-    /**
-     * Default messaging channel to use (e.g., "sms" or "whatsapp")
-     */
-    default_channel?: string;
-
-    /**
-     * Phone number in E.164 format (e.g., +1234567890)
-     */
-    format_e164?: string;
-
-    /**
-     * Phone number in international format (e.g., +1 234-567-890)
-     */
-    format_international?: string;
-
-    /**
-     * Phone number in national format (e.g., (234) 567-890)
-     */
-    format_national?: string;
-
-    /**
-     * Phone number in RFC 3966 format (e.g., tel:+1-234-567-890)
-     */
-    format_rfc?: string;
-
-    /**
-     * @deprecated Always false. Contacts are no longer shared or inherited between
-     * sender profiles — a profile sees only the contacts it owns. Retained so existing
-     * v3 clients reading is_inherited keep deserializing; it carries no information.
-     */
-    is_inherited?: boolean;
-
-    /**
-     * Whether the contact has opted out of messaging. Single source of truth — opt-out
-     * is per-contact, not per-channel.
-     */
-    opt_out?: boolean;
-
-    /**
-     * Phone number in original format
-     */
-    phone_number?: string;
-
-    /**
-     * ISO 3166-1 alpha-2 country code (e.g., US, CA, GB)
-     */
-    region_code?: string;
-
-    /**
-     * When the contact was last updated
-     */
-    updated_at?: string | null;
-  }
-
-  /**
-   * Error information
-   */
-  export interface Error {
-    /**
-     * Machine-readable error code (e.g., "RESOURCE_001")
-     */
-    code?: string;
+  contact_id?: string;
 
-    /**
-     * Additional validation error details (field-level errors)
-     */
-    details?: { [key: string]: Array<string> } | null;
+  first_message_at?: string | null;
 
-    /**
-     * URL to documentation about this error
-     */
-    doc_url?: string | null;
+  last_message_at?: string | null;
 
-    /**
-     * Human-readable error message
-     */
-    message?: string;
-  }
+  message_count?: number;
+}
 
-  /**
-   * Request and response metadata
-   */
-  export interface Meta {
-    /**
-     * Unique identifier for this request (for tracing and support)
-     */
-    request_id?: string;
+export namespace ContactMessageSummary {
+  export interface ChannelScore {
+    channel?: string;
 
     /**
-     * Server timestamp when the response was generated
+     * Percentage (0-100) of messages on this channel that ended in FAILED.
      */
-    timestamp?: string;
+    fail_score?: number;
 
     /**
-     * API version used for this request
+     * Percentage (0-100) of messages on this channel that reached a successful
+     * terminal state: SENT/DELIVERED/READ for outbound, RECEIVED for inbound.
      */
-    version?: string;
+    success_score?: number;
   }
 }
 
 /**
- * Standard API response envelope for all v3 endpoints
+ * Contact response for v3 API Uses snake_case for JSON property names
  */
-export interface ContactUpdateResponse {
+export interface ContactResponse {
   /**
-   * Contact response for v3 API Uses snake_case for JSON property names
+   * Unique identifier for the contact
    */
-  data?: ContactUpdateResponse.Data | null;
+  id?: string;
 
   /**
-   * Error information
+   * Comma-separated list of available messaging channels (e.g., "sms,whatsapp")
    */
-  error?: ContactUpdateResponse.Error | null;
+  available_channels?: string;
 
   /**
-   * Request and response metadata
+   * Country calling code (e.g., 1 for US/Canada)
    */
-  meta?: ContactUpdateResponse.Meta;
+  country_code?: string;
 
   /**
-   * Indicates whether the request was successful
+   * When the contact was created
    */
-  success?: boolean;
-}
+  created_at?: string;
 
-export namespace ContactUpdateResponse {
   /**
-   * Contact response for v3 API Uses snake_case for JSON property names
+   * Which customer owns this — the key's own, or the profile named in x-profile-id.
+   * Says whose resource this is, which the resource's own id does not.
    */
-  export interface Data {
-    /**
-     * Unique identifier for the contact
-     */
-    id?: string;
-
-    /**
-     * Comma-separated list of available messaging channels (e.g., "sms,whatsapp")
-     */
-    available_channels?: string;
-
-    /**
-     * Country calling code (e.g., 1 for US/Canada)
-     */
-    country_code?: string;
-
-    /**
-     * When the contact was created
-     */
-    created_at?: string;
-
-    /**
-     * Which customer owns this — the key's own, or the profile named in x-profile-id.
-     * Says whose resource this is, which the resource's own id does not.
-     */
-    customer_id?: string;
-
-    /**
-     * Default messaging channel to use (e.g., "sms" or "whatsapp")
-     */
-    default_channel?: string;
-
-    /**
-     * Phone number in E.164 format (e.g., +1234567890)
-     */
-    format_e164?: string;
-
-    /**
-     * Phone number in international format (e.g., +1 234-567-890)
-     */
-    format_international?: string;
-
-    /**
-     * Phone number in national format (e.g., (234) 567-890)
-     */
-    format_national?: string;
-
-    /**
-     * Phone number in RFC 3966 format (e.g., tel:+1-234-567-890)
-     */
-    format_rfc?: string;
-
-    /**
-     * @deprecated Always false. Contacts are no longer shared or inherited between
-     * sender profiles — a profile sees only the contacts it owns. Retained so existing
-     * v3 clients reading is_inherited keep deserializing; it carries no information.
-     */
-    is_inherited?: boolean;
-
-    /**
-     * Whether the contact has opted out of messaging. Single source of truth — opt-out
-     * is per-contact, not per-channel.
-     */
-    opt_out?: boolean;
-
-    /**
-     * Phone number in original format
-     */
-    phone_number?: string;
-
-    /**
-     * ISO 3166-1 alpha-2 country code (e.g., US, CA, GB)
-     */
-    region_code?: string;
-
-    /**
-     * When the contact was last updated
-     */
-    updated_at?: string | null;
-  }
+  customer_id?: string;
 
   /**
-   * Error information
+   * Default messaging channel to use (e.g., "sms" or "whatsapp")
    */
-  export interface Error {
-    /**
-     * Machine-readable error code (e.g., "RESOURCE_001")
-     */
-    code?: string;
-
-    /**
-     * Additional validation error details (field-level errors)
-     */
-    details?: { [key: string]: Array<string> } | null;
-
-    /**
-     * URL to documentation about this error
-     */
-    doc_url?: string | null;
-
-    /**
-     * Human-readable error message
-     */
-    message?: string;
-  }
+  default_channel?: string;
 
   /**
-   * Request and response metadata
+   * Phone number in E.164 format (e.g., +1234567890)
    */
-  export interface Meta {
-    /**
-     * Unique identifier for this request (for tracing and support)
-     */
-    request_id?: string;
-
-    /**
-     * Server timestamp when the response was generated
-     */
-    timestamp?: string;
-
-    /**
-     * API version used for this request
-     */
-    version?: string;
-  }
-}
+  format_e164?: string;
 
-/**
- * Standard API response envelope for all v3 endpoints
- */
-export interface ContactListResponse {
   /**
-   * A paginated list of contacts.
+   * Phone number in international format (e.g., +1 234-567-890)
    */
-  data?: ContactListResponse.Data | null;
+  format_international?: string;
 
   /**
-   * Error information
+   * Phone number in national format (e.g., (234) 567-890)
    */
-  error?: ContactListResponse.Error | null;
+  format_national?: string;
 
   /**
-   * Request and response metadata
+   * Phone number in RFC 3966 format (e.g., tel:+1-234-567-890)
    */
-  meta?: ContactListResponse.Meta;
+  format_rfc?: string;
 
   /**
-   * Indicates whether the request was successful
+   * @deprecated Always false. Contacts are no longer shared or inherited between
+   * sender profiles — a profile sees only the contacts it owns. Retained so existing
+   * v3 clients reading is_inherited keep deserializing; it carries no information.
    */
-  success?: boolean;
-}
+  is_inherited?: boolean;
 
-export namespace ContactListResponse {
   /**
-   * A paginated list of contacts.
+   * Whether the contact has opted out of messaging. Single source of truth — opt-out
+   * is per-contact, not per-channel.
    */
-  export interface Data {
-    /**
-     * The contacts on this page.
-     */
-    contacts?: Array<Data.Contact>;
-
-    /**
-     * Pagination metadata for list responses
-     */
-    pagination?: Data.Pagination;
-  }
-
-  export namespace Data {
-    /**
-     * Contact response for v3 API Uses snake_case for JSON property names
-     */
-    export interface Contact {
-      /**
-       * Unique identifier for the contact
-       */
-      id?: string;
-
-      /**
-       * Comma-separated list of available messaging channels (e.g., "sms,whatsapp")
-       */
-      available_channels?: string;
-
-      /**
-       * Country calling code (e.g., 1 for US/Canada)
-       */
-      country_code?: string;
-
-      /**
-       * When the contact was created
-       */
-      created_at?: string;
-
-      /**
-       * Which customer owns this — the key's own, or the profile named in x-profile-id.
-       * Says whose resource this is, which the resource's own id does not.
-       */
-      customer_id?: string;
-
-      /**
-       * Default messaging channel to use (e.g., "sms" or "whatsapp")
-       */
-      default_channel?: string;
-
-      /**
-       * Phone number in E.164 format (e.g., +1234567890)
-       */
-      format_e164?: string;
-
-      /**
-       * Phone number in international format (e.g., +1 234-567-890)
-       */
-      format_international?: string;
-
-      /**
-       * Phone number in national format (e.g., (234) 567-890)
-       */
-      format_national?: string;
-
-      /**
-       * Phone number in RFC 3966 format (e.g., tel:+1-234-567-890)
-       */
-      format_rfc?: string;
-
-      /**
-       * @deprecated Always false. Contacts are no longer shared or inherited between
-       * sender profiles — a profile sees only the contacts it owns. Retained so existing
-       * v3 clients reading is_inherited keep deserializing; it carries no information.
-       */
-      is_inherited?: boolean;
-
-      /**
-       * Whether the contact has opted out of messaging. Single source of truth — opt-out
-       * is per-contact, not per-channel.
-       */
-      opt_out?: boolean;
-
-      /**
-       * Phone number in original format
-       */
-      phone_number?: string;
-
-      /**
-       * ISO 3166-1 alpha-2 country code (e.g., US, CA, GB)
-       */
-      region_code?: string;
-
-      /**
-       * When the contact was last updated
-       */
-      updated_at?: string | null;
-    }
-
-    /**
-     * Pagination metadata for list responses
-     */
-    export interface Pagination {
-      /**
-       * @deprecated Cursor-based pagination. Never populated — see Cursors.
-       */
-      cursors?: Pagination.Cursors | null;
-
-      /**
-       * Whether there are more pages after this one
-       */
-      has_more?: boolean;
-
-      /**
-       * Current page number (1-indexed)
-       */
-      page?: number;
-
-      /**
-       * Number of items per page
-       */
-      page_size?: number;
-
-      /**
-       * Total number of items across all pages
-       */
-      total_count?: number;
-
-      /**
-       * Total number of pages
-       */
-      total_pages?: number;
-    }
-
-    export namespace Pagination {
-      /**
-       * @deprecated Cursor-based pagination. Never populated — see Cursors.
-       */
-      export interface Cursors {
-        /**
-         * Cursor to fetch the next page.
-         */
-        after?: string | null;
-
-        /**
-         * Cursor to fetch the previous page.
-         */
-        before?: string | null;
-      }
-    }
-  }
+  opt_out?: boolean;
 
   /**
-   * Error information
+   * Phone number in original format
    */
-  export interface Error {
-    /**
-     * Machine-readable error code (e.g., "RESOURCE_001")
-     */
-    code?: string;
-
-    /**
-     * Additional validation error details (field-level errors)
-     */
-    details?: { [key: string]: Array<string> } | null;
-
-    /**
-     * URL to documentation about this error
-     */
-    doc_url?: string | null;
-
-    /**
-     * Human-readable error message
-     */
-    message?: string;
-  }
+  phone_number?: string;
 
   /**
-   * Request and response metadata
+   * ISO 3166-1 alpha-2 country code (e.g., US, CA, GB)
    */
-  export interface Meta {
-    /**
-     * Unique identifier for this request (for tracing and support)
-     */
-    request_id?: string;
-
-    /**
-     * Server timestamp when the response was generated
-     */
-    timestamp?: string;
-
-    /**
-     * API version used for this request
-     */
-    version?: string;
-  }
-}
-
-/**
- * Standard API response envelope for all v3 endpoints
- */
-export interface ContactRetrieveMessageSummaryResponse {
-  /**
-   * The response data (null if error)
-   */
-  data?: ContactRetrieveMessageSummaryResponse.Data | null;
-
-  /**
-   * Error information
-   */
-  error?: ContactRetrieveMessageSummaryResponse.Error | null;
-
-  /**
-   * Request and response metadata
-   */
-  meta?: ContactRetrieveMessageSummaryResponse.Meta;
+  region_code?: string;
 
   /**
-   * Indicates whether the request was successful
+   * When the contact was last updated
    */
-  success?: boolean;
-}
-
-export namespace ContactRetrieveMessageSummaryResponse {
-  /**
-   * The response data (null if error)
-   */
-  export interface Data {
-    channel_scores?: Array<Data.ChannelScore>;
-
-    channels_used?: Array<string>;
-
-    contact_id?: string;
-
-    first_message_at?: string | null;
-
-    last_message_at?: string | null;
-
-    message_count?: number;
-  }
-
-  export namespace Data {
-    export interface ChannelScore {
-      channel?: string;
-
-      /**
-       * Percentage (0-100) of messages on this channel that ended in FAILED.
-       */
-      fail_score?: number;
-
-      /**
-       * Percentage (0-100) of messages on this channel that reached a successful
-       * terminal state: SENT/DELIVERED/READ for outbound, RECEIVED for inbound.
-       */
-      success_score?: number;
-    }
-  }
-
-  /**
-   * Error information
-   */
-  export interface Error {
-    /**
-     * Machine-readable error code (e.g., "RESOURCE_001")
-     */
-    code?: string;
-
-    /**
-     * Additional validation error details (field-level errors)
-     */
-    details?: { [key: string]: Array<string> } | null;
-
-    /**
-     * URL to documentation about this error
-     */
-    doc_url?: string | null;
-
-    /**
-     * Human-readable error message
-     */
-    message?: string;
-  }
-
-  /**
-   * Request and response metadata
-   */
-  export interface Meta {
-    /**
-     * Unique identifier for this request (for tracing and support)
-     */
-    request_id?: string;
-
-    /**
-     * Server timestamp when the response was generated
-     */
-    timestamp?: string;
-
-    /**
-     * API version used for this request
-     */
-    version?: string;
-  }
+  updated_at?: string | null;
 }
 
 export interface ContactCreateParams {
@@ -1043,17 +416,7 @@ export interface ContactUpdateParams {
   'x-profile-id'?: string;
 }
 
-export interface ContactListParams {
-  /**
-   * Query param: Page number (1-indexed)
-   */
-  page: number;
-
-  /**
-   * Query param: Number of items per page
-   */
-  page_size: number;
-
+export interface ContactListParams extends ContactsPageParams {
   /**
    * Query param: Optional channel filter (sms, whatsapp)
    */
@@ -1102,11 +465,11 @@ export interface ContactRetrieveMessageSummaryParams {
 
 export declare namespace Contacts {
   export {
-    type ContactCreateResponse as ContactCreateResponse,
-    type ContactRetrieveResponse as ContactRetrieveResponse,
-    type ContactUpdateResponse as ContactUpdateResponse,
-    type ContactListResponse as ContactListResponse,
-    type ContactRetrieveMessageSummaryResponse as ContactRetrieveMessageSummaryResponse,
+    type APIResponseOfContact as APIResponseOfContact,
+    type APIResponseOfContactMessageSummary as APIResponseOfContactMessageSummary,
+    type ContactMessageSummary as ContactMessageSummary,
+    type ContactResponse as ContactResponse,
+    type ContactResponsesContactsPage as ContactResponsesContactsPage,
     type ContactCreateParams as ContactCreateParams,
     type ContactRetrieveParams as ContactRetrieveParams,
     type ContactUpdateParams as ContactUpdateParams,