@kirimdev/sdk 3.8.0 → 3.10.0

package/dist/generated/schema.d.ts

@@ -260,7 +260,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -320,7 +320,16 @@ export interface paths {
                         messaging_product: "whatsapp";
                         /** @enum {string} */
                         recipient_type?: "individual";
-                        to: string;
+                        /**
+                         * @description Recipient's WhatsApp phone number in E.164 (e.g. `628123456789`). Either `to` or `recipient` is required; if both are supplied, Meta uses `to` (documented precedence).
+                         * @example 628123456789
+                         */
+                        to?: string;
+                        /**
+                         * @description Recipient's Business-Scoped User ID (e.g. `US.13491208655302741918`) or parent BSUID. Alternative to `to`. Auth OTP templates (one-tap / zero-tap / copy-code) do NOT support BSUID recipients — Meta rejects with error 131062.
+                         * @example US.13491208655302741918
+                         */
+                        recipient?: string;
                         /** Reply context */
                         context?: {
                             /**
@@ -340,7 +349,16 @@ export interface paths {
                         messaging_product: "whatsapp";
                         /** @enum {string} */
                         recipient_type?: "individual";
-                        to: string;
+                        /**
+                         * @description Recipient's WhatsApp phone number in E.164 (e.g. `628123456789`). Either `to` or `recipient` is required; if both are supplied, Meta uses `to` (documented precedence).
+                         * @example 628123456789
+                         */
+                        to?: string;
+                        /**
+                         * @description Recipient's Business-Scoped User ID (e.g. `US.13491208655302741918`) or parent BSUID. Alternative to `to`. Auth OTP templates (one-tap / zero-tap / copy-code) do NOT support BSUID recipients — Meta rejects with error 131062.
+                         * @example US.13491208655302741918
+                         */
+                        recipient?: string;
                         /** Reply context */
                         context?: {
                             /**
@@ -363,7 +381,16 @@ export interface paths {
                         messaging_product: "whatsapp";
                         /** @enum {string} */
                         recipient_type?: "individual";
-                        to: string;
+                        /**
+                         * @description Recipient's WhatsApp phone number in E.164 (e.g. `628123456789`). Either `to` or `recipient` is required; if both are supplied, Meta uses `to` (documented precedence).
+                         * @example 628123456789
+                         */
+                        to?: string;
+                        /**
+                         * @description Recipient's Business-Scoped User ID (e.g. `US.13491208655302741918`) or parent BSUID. Alternative to `to`. Auth OTP templates (one-tap / zero-tap / copy-code) do NOT support BSUID recipients — Meta rejects with error 131062.
+                         * @example US.13491208655302741918
+                         */
+                        recipient?: string;
                         /** Reply context */
                         context?: {
                             /**
@@ -386,7 +413,16 @@ export interface paths {
                         messaging_product: "whatsapp";
                         /** @enum {string} */
                         recipient_type?: "individual";
-                        to: string;
+                        /**
+                         * @description Recipient's WhatsApp phone number in E.164 (e.g. `628123456789`). Either `to` or `recipient` is required; if both are supplied, Meta uses `to` (documented precedence).
+                         * @example 628123456789
+                         */
+                        to?: string;
+                        /**
+                         * @description Recipient's Business-Scoped User ID (e.g. `US.13491208655302741918`) or parent BSUID. Alternative to `to`. Auth OTP templates (one-tap / zero-tap / copy-code) do NOT support BSUID recipients — Meta rejects with error 131062.
+                         * @example US.13491208655302741918
+                         */
+                        recipient?: string;
                         /** Reply context */
                         context?: {
                             /**
@@ -409,7 +445,16 @@ export interface paths {
                         messaging_product: "whatsapp";
                         /** @enum {string} */
                         recipient_type?: "individual";
-                        to: string;
+                        /**
+                         * @description Recipient's WhatsApp phone number in E.164 (e.g. `628123456789`). Either `to` or `recipient` is required; if both are supplied, Meta uses `to` (documented precedence).
+                         * @example 628123456789
+                         */
+                        to?: string;
+                        /**
+                         * @description Recipient's Business-Scoped User ID (e.g. `US.13491208655302741918`) or parent BSUID. Alternative to `to`. Auth OTP templates (one-tap / zero-tap / copy-code) do NOT support BSUID recipients — Meta rejects with error 131062.
+                         * @example US.13491208655302741918
+                         */
+                        recipient?: string;
                         /** Reply context */
                         context?: {
                             /**
@@ -433,7 +478,16 @@ export interface paths {
                         messaging_product: "whatsapp";
                         /** @enum {string} */
                         recipient_type?: "individual";
-                        to: string;
+                        /**
+                         * @description Recipient's WhatsApp phone number in E.164 (e.g. `628123456789`). Either `to` or `recipient` is required; if both are supplied, Meta uses `to` (documented precedence).
+                         * @example 628123456789
+                         */
+                        to?: string;
+                        /**
+                         * @description Recipient's Business-Scoped User ID (e.g. `US.13491208655302741918`) or parent BSUID. Alternative to `to`. Auth OTP templates (one-tap / zero-tap / copy-code) do NOT support BSUID recipients — Meta rejects with error 131062.
+                         * @example US.13491208655302741918
+                         */
+                        recipient?: string;
                         /** Reply context */
                         context?: {
                             /**
@@ -468,7 +522,16 @@ export interface paths {
                         messaging_product: "whatsapp";
                         /** @enum {string} */
                         recipient_type?: "individual";
-                        to: string;
+                        /**
+                         * @description Recipient's WhatsApp phone number in E.164 (e.g. `628123456789`). Either `to` or `recipient` is required; if both are supplied, Meta uses `to` (documented precedence).
+                         * @example 628123456789
+                         */
+                        to?: string;
+                        /**
+                         * @description Recipient's Business-Scoped User ID (e.g. `US.13491208655302741918`) or parent BSUID. Alternative to `to`. Auth OTP templates (one-tap / zero-tap / copy-code) do NOT support BSUID recipients — Meta rejects with error 131062.
+                         * @example US.13491208655302741918
+                         */
+                        recipient?: string;
                         /** Reply context */
                         context?: {
                             /**
@@ -669,7 +732,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -720,7 +783,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Fetch a sent message by id */
+        /**
+         * Fetch a sent message by id
+         * @description Retrieve a single message by `msg_*` id. Supports short-lived server-side caching for high-frequency status polling, and `ETag`/`If-None-Match` for unchanged responses.
+         */
         get: {
             parameters: {
                 query?: never;
@@ -737,12 +803,23 @@ export interface paths {
                 /** @description Message resource */
                 200: {
                     headers: {
+                        /** @description Weak entity tag derived from `status` and error fields. Send as `If-None-Match` on the next poll — unchanged messages return `304`. */
+                        ETag?: string;
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": components["schemas"]["GetMessageResponse"];
                     };
                 };
+                /** @description Not modified — request carried a matching `If-None-Match` ETag. */
+                304: {
+                    headers: {
+                        /** @description Same weak entity tag as the cached representation. */
+                        ETag?: string;
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
                 /** @description Validation failure */
                 400: {
                     headers: {
@@ -770,7 +847,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -871,7 +948,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -903,7 +980,7 @@ export interface paths {
         put?: never;
         /**
          * Create a template
-         * @description Create a new message template and submit it to Meta for review. The request body is components-only (mirrors Meta's `message_templates` create shape). On success the template is persisted with `status: "pending"`; Meta reviews asynchronously, so poll `GET /{phone_number_id}/templates/{name}` (or re-run `POST .../templates/sync`) for the eventual `approved` / `rejected` transition. A `name`+`language` pair that already exists for the account returns `400 invalid_field_value`.
+         * @description Create a new message template and submit it to Meta for review. The request body is components-only (mirrors Meta's `message_templates` create shape). For IMAGE/VIDEO/DOCUMENT headers, supply `example.header_url` with a public https:// URL — Kirimdev uploads the sample to Meta on your behalf — or a Meta asset handle in `example.header_handle`. On success the template is persisted with `status: "pending"`; Meta reviews asynchronously, so poll `GET /{phone_number_id}/templates/{name}` (or re-run `POST .../templates/sync`) for the eventual `approved` / `rejected` transition. A duplicate `name`+`language` pair returns `409 template_already_exists`.
          */
         post: {
             parameters: {
@@ -1012,7 +1089,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -1115,7 +1192,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -1213,7 +1290,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -1343,7 +1420,7 @@ export interface paths {
                         /** Format: uri */
                         url: string;
                         description?: string;
-                        events: ("message.received" | "message.status" | "conversation.assigned" | "conversation.closed" | "contact.created" | "contact.updated" | "customer.created" | "customer.updated" | "customer.archived" | "customer.onboarded" | "customer.setup_link.created" | "customer.setup_link.consumed")[];
+                        events: ("message.received" | "message.status" | "message.sent" | "conversation.assigned" | "conversation.closed" | "contact.created" | "contact.updated" | "customer.created" | "customer.updated" | "customer.archived" | "customer.onboarded" | "customer.setup_link.created" | "customer.setup_link.consumed")[];
                     };
                 };
             };
@@ -1576,7 +1653,7 @@ export interface paths {
                         /** Format: uri */
                         url?: string;
                         description?: string | null;
-                        events?: ("message.received" | "message.status" | "conversation.assigned" | "conversation.closed" | "contact.created" | "contact.updated" | "customer.created" | "customer.updated" | "customer.archived" | "customer.onboarded" | "customer.setup_link.created" | "customer.setup_link.consumed")[];
+                        events?: ("message.received" | "message.status" | "message.sent" | "conversation.assigned" | "conversation.closed" | "contact.created" | "contact.updated" | "customer.created" | "customer.updated" | "customer.archived" | "customer.onboarded" | "customer.setup_link.created" | "customer.setup_link.consumed")[];
                         /** @enum {string} */
                         status?: "active" | "paused";
                     };
@@ -1810,7 +1887,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -2220,13 +2297,14 @@ export interface paths {
         };
         /**
          * List conversations
-         * @description List conversations for the WhatsApp account identified by `phone_number_id`. Ordered newest-active first by `last_message_at` (NULLS LAST).
+         * @description List conversations for the WhatsApp account identified by `phone_number_id`. Default order: newest-active first by `last_message_at` (NULLS LAST). With `updated_since`, order switches to `updated_at DESC` so assignment/status changes are not buried. Supports short-lived server-side caching, and `ETag`/`If-None-Match` for unchanged responses.
          */
         get: {
             parameters: {
                 query?: {
                     status?: "open" | "resolved" | "pending";
                     contact_id?: string;
+                    updated_since?: string;
                     limit?: string;
                     cursor?: string;
                 };
@@ -2242,12 +2320,23 @@ export interface paths {
                 /** @description Conversation list */
                 200: {
                     headers: {
+                        /** @description Weak entity tag derived from the newest `updated_at` in the page. Send as `If-None-Match` on the next poll — unchanged lists return `304`. */
+                        ETag?: string;
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": components["schemas"]["ListConversationsResponse"];
                     };
                 };
+                /** @description Not modified — request carried a matching `If-None-Match` ETag. */
+                304: {
+                    headers: {
+                        /** @description Same weak entity tag as the prior response. */
+                        ETag?: string;
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
                 /** @description Validation failure */
                 400: {
                     headers: {
@@ -2275,7 +2364,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -2369,7 +2458,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -2464,7 +2553,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -2510,6 +2599,8 @@ export interface paths {
             parameters: {
                 query?: {
                     phone?: string;
+                    bsuid?: string;
+                    username?: string;
                     search?: string;
                     limit?: string;
                     cursor?: string;
@@ -2559,7 +2650,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -2606,7 +2697,9 @@ export interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
-                        phone_number: string;
+                        phone_number?: string;
+                        bsuid?: string;
+                        username?: string;
                         name?: string;
                         /** Format: email */
                         email?: string | null;
@@ -2653,7 +2746,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -2745,7 +2838,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -2829,7 +2922,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -2879,6 +2972,7 @@ export interface paths {
                 content: {
                     "application/json": {
                         name?: string | null;
+                        username?: string | null;
                         email?: string | "" | null;
                         metadata?: {
                             [key: string]: unknown;
@@ -2923,7 +3017,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -3014,7 +3108,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -3119,7 +3213,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -3215,7 +3309,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -3319,7 +3413,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -3419,7 +3513,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -3515,7 +3609,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Semantic failure (e.g. idempotency key reuse) */
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
                 422: {
                     headers: {
                         [name: string]: unknown;
@@ -3978,7 +4072,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Plan / quota / subscription gate (e.g. feature_not_entitled, quota_exceeded, subscription_inactive) */
+                /** @description Billing / entitlement gate — subscription inactive, quota exceeded, or plan tier missing a feature (feature_not_entitled). Upgrade to continue. */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -4060,7 +4154,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Plan / quota / subscription gate (e.g. feature_not_entitled, quota_exceeded, subscription_inactive) */
+                /** @description Billing / entitlement gate — subscription inactive, quota exceeded, or plan tier missing a feature (feature_not_entitled). Upgrade to continue. */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -4141,7 +4235,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Plan / quota / subscription gate (e.g. feature_not_entitled, quota_exceeded, subscription_inactive) */
+                /** @description Billing / entitlement gate — subscription inactive, quota exceeded, or plan tier missing a feature (feature_not_entitled). Upgrade to continue. */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -4223,7 +4317,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Plan / quota / subscription gate (e.g. feature_not_entitled, quota_exceeded, subscription_inactive) */
+                /** @description Billing / entitlement gate — subscription inactive, quota exceeded, or plan tier missing a feature (feature_not_entitled). Upgrade to continue. */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -4315,7 +4409,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Plan / quota / subscription gate (e.g. feature_not_entitled, quota_exceeded, subscription_inactive) */
+                /** @description Billing / entitlement gate — subscription inactive, quota exceeded, or plan tier missing a feature (feature_not_entitled). Upgrade to continue. */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -4406,7 +4500,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Plan / quota / subscription gate (e.g. feature_not_entitled, quota_exceeded, subscription_inactive) */
+                /** @description Billing / entitlement gate — subscription inactive, quota exceeded, or plan tier missing a feature (feature_not_entitled). Upgrade to continue. */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -4497,7 +4591,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Plan / quota / subscription gate (e.g. feature_not_entitled, quota_exceeded, subscription_inactive) */
+                /** @description Billing / entitlement gate — subscription inactive, quota exceeded, or plan tier missing a feature (feature_not_entitled). Upgrade to continue. */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -4594,7 +4688,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Plan / quota / subscription gate (e.g. feature_not_entitled, quota_exceeded, subscription_inactive) */
+                /** @description Billing / entitlement gate — subscription inactive, quota exceeded, or plan tier missing a feature (feature_not_entitled). Upgrade to continue. */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -4693,7 +4787,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Plan / quota / subscription gate (e.g. feature_not_entitled, quota_exceeded, subscription_inactive) */
+                /** @description Billing / entitlement gate — subscription inactive, quota exceeded, or plan tier missing a feature (feature_not_entitled). Upgrade to continue. */
                 402: {
                     headers: {
                         [name: string]: unknown;
@@ -4748,8 +4842,11 @@ export interface components {
     schemas: {
         ApiErrorEnvelope: {
             error: {
-                /** @example invalid_request_error */
-                type: string;
+                /**
+                 * @example invalid_request_error
+                 * @enum {string}
+                 */
+                type: "invalid_request_error" | "authentication_error" | "permission_error" | "not_found" | "conflict" | "rate_limit_error" | "api_error";
                 /** @example invalid_phone_number */
                 code: string;
                 message: string;
@@ -4777,12 +4874,36 @@ export interface components {
             id: string;
             /** @enum {string} */
             object: "message";
-            to?: string;
+            /**
+             * @description Recipient's phone number in E.164 (with leading `+`). NULL when the message targeted a Business-Scoped User ID (BSUID) recipient and the contact has no known phone number. See docs/meta-docs/bsuid.md.
+             * @example +628123456789
+             */
+            to?: string | null;
+            /**
+             * @description Recipient contact's Business-Scoped User ID. Present when the contact has been enriched with a BSUID from a Meta webhook (or from a BSUID-first send). NULL for phone-only contacts.
+             * @example US.13491208655302741918
+             */
+            bsuid?: string | null;
+            /**
+             * @description Parent BSUID for managed businesses with linked business portfolios. NULL for regular accounts.
+             * @example US.ENT.11815799212886844830
+             */
+            parent_bsuid?: string | null;
+            /**
+             * @description Recipient contact's WhatsApp username (case-insensitive comparison; case-preserving in storage). NULL when the contact has not adopted the WhatsApp username feature.
+             * @example pablomorales
+             */
+            username?: string | null;
             type?: string;
             /** @enum {string} */
             status: "queued" | "pending" | "sent" | "delivered" | "read" | "failed";
             /** Format: date-time */
             created_at?: string;
+            /**
+             * Format: date-time
+             * @description ISO-8601 timestamp when the recipient first played an outbound voice note. Populated from Meta's `played` status webhook; omitted on non-voice messages and until playback occurs.
+             */
+            played_at?: string;
             conversation_id?: string;
             message_id?: string;
             error?: {
@@ -4917,7 +5038,26 @@ export interface components {
             id: string;
             /** @enum {string} */
             object: "contact";
+            /**
+             * @description Phone number in E.164. NULL when the contact was created via BSUID (username-adopted user with no shared phone number). See docs/meta-docs/bsuid.md.
+             * @example +628123456789
+             */
             phone_number: string | null;
+            /**
+             * @description Business-Scoped User ID. Populated by inbound webhooks or when the contact was created via BSUID. Format: `{ISO alpha-2 country}.{alphanumeric ≤128}`.
+             * @example US.13491208655302741918
+             */
+            bsuid: string | null;
+            /**
+             * @description Parent BSUID (managed businesses only). Format: `{ISO alpha-2 country}.ENT.{alphanumeric ≤128}`.
+             * @example US.ENT.11815799212886844830
+             */
+            parent_bsuid: string | null;
+            /**
+             * @description WhatsApp username of the contact, if the user has adopted the username feature. Case-insensitive when comparing per Meta rules; `.` and `_` are significant.
+             * @example pablomorales
+             */
+            username: string | null;
             name: string | null;
             email: string | null;
             metadata: {

package/dist/generated/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION: "3.8.0";
+export declare const SDK_VERSION: "3.10.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,EAAG,OAAgB,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,EAAG,QAAiB,CAAA"}

package/dist/generated/version.js

@@ -2,5 +2,5 @@
 // Regenerated on every prebuild / pretypecheck / pretest from
 // package.json so the User-Agent header stays in sync with the
 // published version.
-export const SDK_VERSION = "3.8.0";
+export const SDK_VERSION = "3.10.0";
 //# sourceMappingURL=version.js.map

package/dist/generated/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8DAA8D;AAC9D,+DAA+D;AAC/D,qBAAqB;AAErB,MAAM,CAAC,MAAM,WAAW,GAAG,OAAgB,CAAA"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8DAA8D;AAC9D,+DAA+D;AAC/D,qBAAqB;AAErB,MAAM,CAAC,MAAM,WAAW,GAAG,QAAiB,CAAA"}

package/dist/generated/version.ts

@@ -3,4 +3,4 @@
 // package.json so the User-Agent header stays in sync with the
 // published version.
 
-export const SDK_VERSION = "3.8.0" as const
+export const SDK_VERSION = "3.10.0" as const