@kirimdev/sdk 3.9.0 → 3.11.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?: {
                             /**
@@ -482,9 +545,38 @@ export interface paths {
                         interactive: {
                             /** @enum {string} */
                             type: "cta_url";
+                            header?: {
+                                /** @enum {string} */
+                                type: "text";
+                                text: string;
+                            } | {
+                                /** @enum {string} */
+                                type: "image";
+                                image: {
+                                    /** Format: uri */
+                                    link: string;
+                                };
+                            } | {
+                                /** @enum {string} */
+                                type: "video";
+                                video: {
+                                    /** Format: uri */
+                                    link: string;
+                                };
+                            } | {
+                                /** @enum {string} */
+                                type: "document";
+                                document: {
+                                    /** Format: uri */
+                                    link: string;
+                                };
+                            };
                             body: {
                                 text: string;
                             };
+                            footer?: {
+                                text: string;
+                            };
                             action: {
                                 /** @enum {string} */
                                 name: "cta_url";
@@ -669,7 +761,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;
@@ -784,7 +876,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;
@@ -885,7 +977,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;
@@ -1026,7 +1118,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;
@@ -1129,7 +1221,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;
@@ -1227,7 +1319,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;
@@ -1357,7 +1449,8 @@ export interface paths {
                         /** Format: uri */
                         url: string;
                         description?: string;
-                        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")[];
+                        events: ("message.received" | "message.status" | "message.sent" | "conversation.assigned" | "conversation.closed" | "contact.created" | "contact.updated" | "contact.identity_updated" | "customer.created" | "customer.updated" | "customer.archived" | "customer.onboarded" | "customer.setup_link.created" | "customer.setup_link.consumed")[];
+                        phone_number_ids?: string[];
                     };
                 };
             };
@@ -1389,6 +1482,15 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorEnvelope"];
+                    };
+                };
                 /** @description Rate limit exceeded */
                 429: {
                     headers: {
@@ -1590,9 +1692,10 @@ export interface paths {
                         /** Format: uri */
                         url?: string;
                         description?: string | null;
-                        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")[];
+                        events?: ("message.received" | "message.status" | "message.sent" | "conversation.assigned" | "conversation.closed" | "contact.created" | "contact.updated" | "contact.identity_updated" | "customer.created" | "customer.updated" | "customer.archived" | "customer.onboarded" | "customer.setup_link.created" | "customer.setup_link.consumed")[];
                         /** @enum {string} */
                         status?: "active" | "paused";
+                        phone_number_ids?: string[] | null;
                     };
                 };
             };
@@ -1633,6 +1736,15 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
+                /** @description Semantic failure (e.g. idempotency key reuse, pre-send compliance guard, media not found) */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorEnvelope"];
+                    };
+                };
                 /** @description Rate limit exceeded */
                 429: {
                     headers: {
@@ -1824,7 +1936,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;
@@ -2301,7 +2413,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;
@@ -2395,7 +2507,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;
@@ -2490,7 +2602,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;
@@ -2536,6 +2648,8 @@ export interface paths {
             parameters: {
                 query?: {
                     phone?: string;
+                    bsuid?: string;
+                    username?: string;
                     search?: string;
                     limit?: string;
                     cursor?: string;
@@ -2585,7 +2699,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;
@@ -2632,7 +2746,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;
@@ -2679,7 +2795,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;
@@ -2771,7 +2887,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;
@@ -2855,7 +2971,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;
@@ -2905,6 +3021,7 @@ export interface paths {
                 content: {
                     "application/json": {
                         name?: string | null;
+                        username?: string | null;
                         email?: string | "" | null;
                         metadata?: {
                             [key: string]: unknown;
@@ -2949,7 +3066,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;
@@ -3040,7 +3157,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;
@@ -3145,7 +3262,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;
@@ -3241,7 +3358,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;
@@ -3345,7 +3462,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;
@@ -3445,7 +3562,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;
@@ -3541,7 +3658,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;
@@ -4004,7 +4121,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;
@@ -4086,7 +4203,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;
@@ -4167,7 +4284,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;
@@ -4249,7 +4366,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;
@@ -4341,7 +4458,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;
@@ -4432,7 +4549,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;
@@ -4523,7 +4640,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;
@@ -4620,7 +4737,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;
@@ -4719,7 +4836,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;
@@ -4774,8 +4891,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;
@@ -4803,7 +4923,26 @@ 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";
@@ -4874,6 +5013,13 @@ export interface components {
             url: string;
             description: string | null;
             events: string[];
+            /**
+             * @description Optional whitelist of Meta `business_phone_number_id` values. When `null` (default), the subscription fires for events from every WhatsApp account in the organization. When an array, only for events originating from these accounts. Org-level events (e.g. `customer.*`) IGNORE this filter and always fire.
+             * @example [
+             *       "1234567890"
+             *     ]
+             */
+            phone_number_ids: string[] | null;
             /** @enum {string} */
             status: "active" | "paused" | "disabled";
             disabled_reason: string | null;
@@ -4948,7 +5094,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.9.0";
+export declare const SDK_VERSION: "3.11.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.9.0";
+export const SDK_VERSION = "3.11.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.9.0" as const
+export const SDK_VERSION = "3.11.0" as const