@sentdm/sentdm 0.36.0 → 0.38.0

package/resources/templates.d.mts

@@ -1,5 +1,7 @@
 import { APIResource } from "../core/resource.mjs";
+import * as WebhooksAPI from "./webhooks.mjs";
 import { APIPromise } from "../core/api-promise.mjs";
+import { PagePromise, TemplatesPage, type TemplatesPageParams } from "../core/pagination.mjs";
 import { RequestOptions } from "../internal/request-options.mjs";
 /**
  * Reusable message bodies with named variables.
@@ -14,47 +16,47 @@ export declare class Templates extends APIResource {
      *
      * @example
      * ```ts
-     * const template = await client.templates.create();
+     * const apiResponseTemplate = await client.templates.create();
      * ```
      */
-    create(params: TemplateCreateParams, options?: RequestOptions): APIPromise<TemplateCreateResponse>;
+    create(params: TemplateCreateParams, options?: RequestOptions): APIPromise<APIResponseTemplate>;
     /**
      * Retrieves a specific template by its ID. Returns template details including
      * name, category, language, status, and definition.
      *
      * @example
      * ```ts
-     * const template = await client.templates.retrieve(
+     * const apiResponseTemplate = await client.templates.retrieve(
      *   '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
      * );
      * ```
      */
-    retrieve(id: string, params?: TemplateRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<TemplateRetrieveResponse>;
+    retrieve(id: string, params?: TemplateRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<APIResponseTemplate>;
     /**
      * Updates an existing template's name, category, language, definition, or submits
      * it for review.
      *
      * @example
      * ```ts
-     * const template = await client.templates.update(
+     * const apiResponseTemplate = await client.templates.update(
      *   '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
      * );
      * ```
      */
-    update(id: string, params: TemplateUpdateParams, options?: RequestOptions): APIPromise<TemplateUpdateResponse>;
+    update(id: string, params: TemplateUpdateParams, options?: RequestOptions): APIPromise<APIResponseTemplate>;
     /**
      * Retrieves a paginated list of message templates for the authenticated customer.
      * Supports filtering by status, category, and search term.
      *
      * @example
      * ```ts
-     * const templates = await client.templates.list({
-     *   page: 0,
-     *   page_size: 0,
-     * });
+     * // Automatically fetches more pages as needed.
+     * for await (const template of client.templates.list()) {
+     *   // ...
+     * }
      * ```
      */
-    list(params: TemplateListParams, options?: RequestOptions): APIPromise<TemplateListResponse>;
+    list(params?: TemplateListParams | null | undefined, options?: RequestOptions): PagePromise<TemplatesTemplatesPage, Template>;
     /**
      * Deletes a template by ID. Optionally, you can also delete the template from
      * WhatsApp/Meta by setting delete_from_meta=true.
@@ -68,6 +70,28 @@ export declare class Templates extends APIResource {
      */
     delete(id: string, params: TemplateDeleteParams, options?: RequestOptions): APIPromise<void>;
 }
+export type TemplatesTemplatesPage = TemplatesPage<Template>;
+/**
+ * Standard API response envelope for all v3 endpoints
+ */
+export interface APIResponseTemplate {
+    /**
+     * Template response for v3 API
+     */
+    data?: Template | null;
+    /**
+     * Error information
+     */
+    error?: WebhooksAPI.ErrorDetail | null;
+    /**
+     * Request and response metadata
+     */
+    meta?: WebhooksAPI.APIMeta;
+    /**
+     * Indicates whether the request was successful
+     */
+    success?: boolean;
+}
 /**
  * Configuration for AUTHENTICATION category templates
  */
@@ -83,6 +107,56 @@ export interface AuthenticationConfig {
      */
     codeExpirationMinutes?: number | null;
 }
+/**
+ * Template response for v3 API
+ */
+export interface Template {
+    /**
+     * 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;
+    /**
+     * Unique template identifier
+     */
+    id?: string;
+    /**
+     * Template category: MARKETING, UTILITY, AUTHENTICATION
+     */
+    category?: string;
+    /**
+     * Supported channels: sms, whatsapp
+     */
+    channels?: Array<string> | null;
+    /**
+     * When the template was created
+     */
+    created_at?: string;
+    /**
+     * Whether the template is published and active
+     */
+    is_published?: boolean;
+    /**
+     * Template language code (e.g., en_US)
+     */
+    language?: string;
+    /**
+     * Template display name
+     */
+    name?: string;
+    /**
+     * Template status: APPROVED, PENDING, REJECTED
+     */
+    status?: string;
+    /**
+     * When the template was last updated
+     */
+    updated_at?: string | null;
+    /**
+     * Template variables for personalization
+     */
+    variables?: Array<string> | null;
+}
 /**
  * Body section of a message template with channel-specific content
  */
@@ -230,517 +304,6 @@ export declare namespace TemplateVariable {
         shortUrl?: string | null;
     }
 }
-/**
- * Standard API response envelope for all v3 endpoints
- */
-export interface TemplateCreateResponse {
-    /**
-     * Template response for v3 API
-     */
-    data?: TemplateCreateResponse.Data | null;
-    /**
-     * Error information
-     */
-    error?: TemplateCreateResponse.Error | null;
-    /**
-     * Request and response metadata
-     */
-    meta?: TemplateCreateResponse.Meta;
-    /**
-     * Indicates whether the request was successful
-     */
-    success?: boolean;
-}
-export declare namespace TemplateCreateResponse {
-    /**
-     * Template response for v3 API
-     */
-    interface Data {
-        /**
-         * 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;
-        /**
-         * Unique template identifier
-         */
-        id?: string;
-        /**
-         * Template category: MARKETING, UTILITY, AUTHENTICATION
-         */
-        category?: string;
-        /**
-         * Supported channels: sms, whatsapp
-         */
-        channels?: Array<string> | null;
-        /**
-         * When the template was created
-         */
-        created_at?: string;
-        /**
-         * Whether the template is published and active
-         */
-        is_published?: boolean;
-        /**
-         * Template language code (e.g., en_US)
-         */
-        language?: string;
-        /**
-         * Template display name
-         */
-        name?: string;
-        /**
-         * Template status: APPROVED, PENDING, REJECTED
-         */
-        status?: string;
-        /**
-         * When the template was last updated
-         */
-        updated_at?: string | null;
-        /**
-         * Template variables for personalization
-         */
-        variables?: Array<string> | null;
-    }
-    /**
-     * Error information
-     */
-    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
-     */
-    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 TemplateRetrieveResponse {
-    /**
-     * Template response for v3 API
-     */
-    data?: TemplateRetrieveResponse.Data | null;
-    /**
-     * Error information
-     */
-    error?: TemplateRetrieveResponse.Error | null;
-    /**
-     * Request and response metadata
-     */
-    meta?: TemplateRetrieveResponse.Meta;
-    /**
-     * Indicates whether the request was successful
-     */
-    success?: boolean;
-}
-export declare namespace TemplateRetrieveResponse {
-    /**
-     * Template response for v3 API
-     */
-    interface Data {
-        /**
-         * 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;
-        /**
-         * Unique template identifier
-         */
-        id?: string;
-        /**
-         * Template category: MARKETING, UTILITY, AUTHENTICATION
-         */
-        category?: string;
-        /**
-         * Supported channels: sms, whatsapp
-         */
-        channels?: Array<string> | null;
-        /**
-         * When the template was created
-         */
-        created_at?: string;
-        /**
-         * Whether the template is published and active
-         */
-        is_published?: boolean;
-        /**
-         * Template language code (e.g., en_US)
-         */
-        language?: string;
-        /**
-         * Template display name
-         */
-        name?: string;
-        /**
-         * Template status: APPROVED, PENDING, REJECTED
-         */
-        status?: string;
-        /**
-         * When the template was last updated
-         */
-        updated_at?: string | null;
-        /**
-         * Template variables for personalization
-         */
-        variables?: Array<string> | null;
-    }
-    /**
-     * Error information
-     */
-    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
-     */
-    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 TemplateUpdateResponse {
-    /**
-     * Template response for v3 API
-     */
-    data?: TemplateUpdateResponse.Data | null;
-    /**
-     * Error information
-     */
-    error?: TemplateUpdateResponse.Error | null;
-    /**
-     * Request and response metadata
-     */
-    meta?: TemplateUpdateResponse.Meta;
-    /**
-     * Indicates whether the request was successful
-     */
-    success?: boolean;
-}
-export declare namespace TemplateUpdateResponse {
-    /**
-     * Template response for v3 API
-     */
-    interface Data {
-        /**
-         * 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;
-        /**
-         * Unique template identifier
-         */
-        id?: string;
-        /**
-         * Template category: MARKETING, UTILITY, AUTHENTICATION
-         */
-        category?: string;
-        /**
-         * Supported channels: sms, whatsapp
-         */
-        channels?: Array<string> | null;
-        /**
-         * When the template was created
-         */
-        created_at?: string;
-        /**
-         * Whether the template is published and active
-         */
-        is_published?: boolean;
-        /**
-         * Template language code (e.g., en_US)
-         */
-        language?: string;
-        /**
-         * Template display name
-         */
-        name?: string;
-        /**
-         * Template status: APPROVED, PENDING, REJECTED
-         */
-        status?: string;
-        /**
-         * When the template was last updated
-         */
-        updated_at?: string | null;
-        /**
-         * Template variables for personalization
-         */
-        variables?: Array<string> | null;
-    }
-    /**
-     * Error information
-     */
-    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
-     */
-    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 TemplateListResponse {
-    /**
-     * A paginated list of templates.
-     */
-    data?: TemplateListResponse.Data | null;
-    /**
-     * Error information
-     */
-    error?: TemplateListResponse.Error | null;
-    /**
-     * Request and response metadata
-     */
-    meta?: TemplateListResponse.Meta;
-    /**
-     * Indicates whether the request was successful
-     */
-    success?: boolean;
-}
-export declare namespace TemplateListResponse {
-    /**
-     * A paginated list of templates.
-     */
-    interface Data {
-        /**
-         * Pagination metadata for list responses
-         */
-        pagination?: Data.Pagination;
-        /**
-         * The templates on this page.
-         */
-        templates?: Array<Data.Template>;
-    }
-    namespace Data {
-        /**
-         * Pagination metadata for list responses
-         */
-        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;
-        }
-        namespace Pagination {
-            /**
-             * @deprecated Cursor-based pagination. Never populated — see Cursors.
-             */
-            interface Cursors {
-                /**
-                 * Cursor to fetch the next page.
-                 */
-                after?: string | null;
-                /**
-                 * Cursor to fetch the previous page.
-                 */
-                before?: string | null;
-            }
-        }
-        /**
-         * Template response for v3 API
-         */
-        interface Template {
-            /**
-             * 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;
-            /**
-             * Unique template identifier
-             */
-            id?: string;
-            /**
-             * Template category: MARKETING, UTILITY, AUTHENTICATION
-             */
-            category?: string;
-            /**
-             * Supported channels: sms, whatsapp
-             */
-            channels?: Array<string> | null;
-            /**
-             * When the template was created
-             */
-            created_at?: string;
-            /**
-             * Whether the template is published and active
-             */
-            is_published?: boolean;
-            /**
-             * Template language code (e.g., en_US)
-             */
-            language?: string;
-            /**
-             * Template display name
-             */
-            name?: string;
-            /**
-             * Template status: APPROVED, PENDING, REJECTED
-             */
-            status?: string;
-            /**
-             * When the template was last updated
-             */
-            updated_at?: string | null;
-            /**
-             * Template variables for personalization
-             */
-            variables?: Array<string> | null;
-        }
-    }
-    /**
-     * Error information
-     */
-    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
-     */
-    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;
-    }
-}
 export interface TemplateCreateParams {
     /**
      * Body param: Template category: MARKETING, UTILITY, AUTHENTICATION (optional,
@@ -832,15 +395,7 @@ export interface TemplateUpdateParams {
      */
     'x-profile-id'?: string;
 }
-export interface TemplateListParams {
-    /**
-     * Query param: Page number (1-indexed)
-     */
-    page: number;
-    /**
-     * Query param: Number of items per page
-     */
-    page_size: number;
+export interface TemplateListParams extends TemplatesPageParams {
     /**
      * Query param: Optional category filter: MARKETING, UTILITY, AUTHENTICATION
      */
@@ -887,6 +442,6 @@ export interface TemplateDeleteParams {
     'x-profile-id'?: string;
 }
 export declare namespace Templates {
-    export { type AuthenticationConfig as AuthenticationConfig, type TemplateBody as TemplateBody, type TemplateBodyContent as TemplateBodyContent, type TemplateButton as TemplateButton, type TemplateButtonProps as TemplateButtonProps, type TemplateDefinition as TemplateDefinition, type TemplateFooter as TemplateFooter, type TemplateHeader as TemplateHeader, type TemplateVariable as TemplateVariable, type TemplateCreateResponse as TemplateCreateResponse, type TemplateRetrieveResponse as TemplateRetrieveResponse, type TemplateUpdateResponse as TemplateUpdateResponse, type TemplateListResponse as TemplateListResponse, type TemplateCreateParams as TemplateCreateParams, type TemplateRetrieveParams as TemplateRetrieveParams, type TemplateUpdateParams as TemplateUpdateParams, type TemplateListParams as TemplateListParams, type TemplateDeleteParams as TemplateDeleteParams, };
+    export { type APIResponseTemplate as APIResponseTemplate, type AuthenticationConfig as AuthenticationConfig, type Template as Template, type TemplateBody as TemplateBody, type TemplateBodyContent as TemplateBodyContent, type TemplateButton as TemplateButton, type TemplateButtonProps as TemplateButtonProps, type TemplateDefinition as TemplateDefinition, type TemplateFooter as TemplateFooter, type TemplateHeader as TemplateHeader, type TemplateVariable as TemplateVariable, type TemplatesTemplatesPage as TemplatesTemplatesPage, type TemplateCreateParams as TemplateCreateParams, type TemplateRetrieveParams as TemplateRetrieveParams, type TemplateUpdateParams as TemplateUpdateParams, type TemplateListParams as TemplateListParams, type TemplateDeleteParams as TemplateDeleteParams, };
 }
 //# sourceMappingURL=templates.d.mts.map