@getlatedev/node 0.2.317 → 0.2.319

package/dist/index.d.mts

@@ -698,12 +698,12 @@ declare class Zernio {
      * ads API
      */
     ads: {
-        listAds: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<ListAdsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListAdsResponse, unknown, ThrowOnError>;
+        listAds: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<ListAdsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
         getAd: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdResponse, GetAdError, ThrowOnError>;
         updateAd: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateAdData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateAdResponse, unknown, ThrowOnError>;
         deleteAd: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<DeleteAdData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DeleteAdResponse, DeleteAdError, ThrowOnError>;
-        getCampaignAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetCampaignAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetCampaignAnalyticsResponse, unknown, ThrowOnError>;
-        getAdAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdAnalyticsResponse, unknown, ThrowOnError>;
+        getCampaignAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetCampaignAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
+        getAdAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
         getAdTrackingTags: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdTrackingTagsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdTrackingTagsResponse, unknown, ThrowOnError>;
         updateAdTrackingTags: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateAdTrackingTagsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
         getAdComments: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdCommentsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdCommentsResponse, unknown, ThrowOnError>;
@@ -749,8 +749,8 @@ declare class Zernio {
         duplicateAdCampaign: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<DuplicateAdCampaignData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DuplicateAdCampaignResponse, unknown, ThrowOnError>;
         updateAdSet: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateAdSetData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateAdSetResponse, unknown, ThrowOnError>;
         updateAdSetStatus: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateAdSetStatusData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateAdSetStatusResponse, unknown, ThrowOnError>;
-        getAdTree: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<GetAdTreeData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdTreeResponse, unknown, ThrowOnError>;
-        getAdsTimeline: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdsTimelineData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdsTimelineResponse, unknown, ThrowOnError>;
+        getAdTree: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<GetAdTreeData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
+        getAdsTimeline: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdsTimelineData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
     };
     /**
      * adaudiences API
@@ -5640,6 +5640,56 @@ type WebhookPayloadMessage = {
         flowResponseData?: {
             [key: string]: unknown;
         };
+        /**
+         * WhatsApp only. Cart submitted by the user from a commerce message
+         * (catalog, product, or product-list message). Meta's `order` object
+         * forwarded verbatim.
+         *
+         */
+        order?: {
+            /**
+             * Meta catalog the ordered products belong to.
+             */
+            catalog_id?: string;
+            /**
+             * Optional free-text note the user attached to the cart.
+             */
+            text?: string;
+            product_items?: Array<{
+                /**
+                 * Retailer ID (SKU) of the ordered product.
+                 */
+                product_retailer_id?: string;
+                /**
+                 * Quantity ordered for this line item.
+                 */
+                quantity?: number;
+                /**
+                 * Unit price of the item.
+                 */
+                item_price?: number;
+                /**
+                 * ISO 4217 currency code (e.g. USD).
+                 */
+                currency?: string;
+            }>;
+        };
+        /**
+         * WhatsApp only. The product the user is asking about. Set when an
+         * inbound text carries Meta's `context.referred_product` (the user
+         * tapped "Message business" on a product). Forwarded verbatim.
+         *
+         */
+        referredProduct?: {
+            /**
+             * Meta catalog the product belongs to.
+             */
+            catalog_id?: string;
+            /**
+             * Retailer ID (SKU) of the product being asked about.
+             */
+            product_retailer_id?: string;
+        };
         /**
          * Instagram only. Populated when an IG user replies to one of the
          * account's stories (Meta `messaging_story_replies`). Mutually
@@ -13717,16 +13767,32 @@ type SendInboxMessageData = {
         };
         /**
          * WhatsApp-only. Rich interactive payload for list messages, CTA URL
-         * buttons, Flow prompts, and location requests. When set, takes
-         * priority over `buttons` and `quickReplies`. The shape mirrors
-         * Meta's Cloud API `interactive` object verbatim, so any payload
-         * that works against Meta directly will also work here.
+         * buttons, Flow prompts, location requests, voice-call buttons, and
+         * commerce messages (single product, product list, catalog, and
+         * carousel). When set, takes priority over `buttons` and
+         * `quickReplies`. The shape mirrors Meta's Cloud API `interactive`
+         * object verbatim, so any payload that works against Meta directly
+         * will also work here.
          *
          * Use `buttons` / `quickReplies` for simple button replies
-         * (WhatsApp's `interactive.type: "button"`) — the abstraction caps at
+         * (WhatsApp's `interactive.type: "button"`): the abstraction caps at
          * 3 buttons and handles the auto-conversion for you. Use this field
-         * only for `list`, `cta_url`, `flow`, `location_request_message`, or
-         * `voice_call` messages.
+         * only for the types listed in the enum below.
+         *
+         * All interactive messages are session messages: they can only be
+         * sent inside the 24-hour customer service window opened by the
+         * user's last inbound message.
+         *
+         * Commerce types (`product`, `product_list`, `catalog_message`, and
+         * product carousels) require a Meta catalog connected to the
+         * WhatsApp Business Account in Commerce Manager. Media carousels
+         * (image/video cards) do not need a catalog.
+         *
+         * For `product`, `body` is optional (WhatsApp renders the product
+         * card itself) and `header` is not allowed (the product image is
+         * the header). For `product_list`, a `header` with `type: "text"`
+         * is required. For `carousel`, top-level `header`/`footer` are not
+         * supported; media goes on each card instead.
          *
          * For `voice_call`, the message renders WhatsApp's native call
          * button; tapping it starts a voice call to your business number.
@@ -13739,17 +13805,25 @@ type SendInboxMessageData = {
          * "Send location" button; the user's reply arrives as a regular
          * location message in the conversation.
          *
+         * For `catalog_message`, `action` may also be omitted (we default it
+         * to `{ "name": "catalog_message" }`).
+         *
          * Tap events come back via the `message.received` webhook with
          * `metadata.interactiveType` set to `list_reply` or `nfm_reply`.
+         * Carts submitted from commerce messages arrive as `metadata.order`;
+         * product inquiries arrive as `metadata.referredProduct`.
          *
          */
         interactive?: {
             /**
              * Which interactive layout to render.
              */
-            type: 'list' | 'cta_url' | 'flow' | 'location_request_message' | 'voice_call';
+            type: 'list' | 'cta_url' | 'flow' | 'location_request_message' | 'voice_call' | 'product' | 'product_list' | 'catalog_message' | 'carousel';
             /**
-             * Optional header shown above the body.
+             * Optional header shown above the body. Required with
+             * `type: "text"` for `product_list`; not allowed for `product`
+             * or `carousel`.
+             *
              */
             header?: {
                 type?: 'text' | 'image' | 'video' | 'document';
@@ -13767,7 +13841,10 @@ type SendInboxMessageData = {
                     link?: string;
                 };
             };
-            body: {
+            /**
+             * Required for every type except `product`, where it is optional.
+             */
+            body?: {
                 /**
                  * Main body text.
                  */
@@ -13883,6 +13960,73 @@ type SendInboxMessageData = {
                 };
             } | {
                 name: 'send_location';
+            } | {
+                /**
+                 * Meta catalog ID connected to the WhatsApp Business Account.
+                 */
+                catalog_id: string;
+                /**
+                 * Retailer ID (SKU) of the product inside the catalog.
+                 */
+                product_retailer_id: string;
+            } | {
+                /**
+                 * Meta catalog ID connected to the WhatsApp Business Account.
+                 */
+                catalog_id: string;
+                /**
+                 * 1-10 sections. Total products across all sections cannot exceed 30.
+                 */
+                sections: Array<{
+                    /**
+                     * Optional section header.
+                     */
+                    title?: string;
+                    product_items: Array<{
+                        /**
+                         * Retailer ID (SKU) of the product inside the catalog.
+                         */
+                        product_retailer_id: string;
+                    }>;
+                }>;
+            } | {
+                name: 'catalog_message';
+                parameters?: {
+                    /**
+                     * Optional product whose image is used as the message thumbnail. Falls back to the first catalog item when omitted.
+                     */
+                    thumbnail_product_retailer_id?: string;
+                };
+            } | {
+                cards: Array<{
+                    /**
+                     * Card position. Auto-filled sequentially when omitted.
+                     */
+                    card_index?: number;
+                    /**
+                     * `product` for a product card; media cards use `cta_url` or a quick-reply type.
+                     */
+                    type?: string;
+                    /**
+                     * Media cards only
+                     */
+                    header?: {
+                        [key: string]: unknown;
+                    };
+                    /**
+                     * Optional card body text.
+                     */
+                    body?: {
+                        [key: string]: unknown;
+                    };
+                    /**
+                     * Product cards: `{ catalog_id, product_retailer_id }` (required). Media cards: the card's button action (e.g. `cta_url` with `parameters.display_text` and `parameters.url`).
+                     */
+                    action?: {
+                        [key: string]: unknown;
+                    };
+                    [key: string]: unknown | number | string;
+                }>;
             });
         };
         /**
@@ -20890,8 +21034,12 @@ type ListAdsData = {
 };
 type ListAdsResponse = ({
     ads?: Array<Ad>;
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     pagination?: Pagination;
-});
+} | unknown);
 type ListAdsError = ({
     error?: string;
 } | unknown);
@@ -21236,8 +21384,12 @@ type GetAdTreeData = {
 };
 type GetAdTreeResponse = ({
     campaigns?: Array<AdTreeCampaign>;
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     pagination?: Pagination;
-});
+} | unknown);
 type GetAdTreeError = ({
     error?: string;
 } | unknown);
@@ -21314,7 +21466,11 @@ type GetAdsTimelineResponse = ({
          */
         roas?: number;
     }>;
-});
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
+} | unknown);
 type GetAdsTimelineError = ({
     error?: string;
 } | unknown);
@@ -21452,6 +21608,10 @@ type GetCampaignAnalyticsResponse = ({
          */
         currency?: (string) | null;
     };
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     analytics?: {
         summary?: AdMetrics;
         daily?: Array<(AdMetrics & {
@@ -21463,7 +21623,7 @@ type GetCampaignAnalyticsResponse = ({
             }>;
         };
     };
-});
+} | unknown);
 type GetCampaignAnalyticsError = ({
     error?: string;
 } | unknown);
@@ -21498,6 +21658,10 @@ type GetAdAnalyticsResponse = ({
          */
         currency?: (string) | null;
     };
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     analytics?: {
         summary?: AdMetrics;
         daily?: Array<(AdMetrics & {
@@ -21509,7 +21673,7 @@ type GetAdAnalyticsResponse = ({
             }>;
         };
     };
-});
+} | unknown);
 type GetAdAnalyticsError = ({
     error?: string;
 } | unknown);

package/dist/index.d.ts

@@ -698,12 +698,12 @@ declare class Zernio {
      * ads API
      */
     ads: {
-        listAds: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<ListAdsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListAdsResponse, unknown, ThrowOnError>;
+        listAds: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<ListAdsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
         getAd: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdResponse, GetAdError, ThrowOnError>;
         updateAd: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateAdData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateAdResponse, unknown, ThrowOnError>;
         deleteAd: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<DeleteAdData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DeleteAdResponse, DeleteAdError, ThrowOnError>;
-        getCampaignAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetCampaignAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetCampaignAnalyticsResponse, unknown, ThrowOnError>;
-        getAdAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdAnalyticsResponse, unknown, ThrowOnError>;
+        getCampaignAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetCampaignAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
+        getAdAnalytics: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdAnalyticsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
         getAdTrackingTags: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdTrackingTagsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdTrackingTagsResponse, unknown, ThrowOnError>;
         updateAdTrackingTags: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateAdTrackingTagsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
         getAdComments: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdCommentsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdCommentsResponse, unknown, ThrowOnError>;
@@ -749,8 +749,8 @@ declare class Zernio {
         duplicateAdCampaign: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<DuplicateAdCampaignData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DuplicateAdCampaignResponse, unknown, ThrowOnError>;
         updateAdSet: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateAdSetData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateAdSetResponse, unknown, ThrowOnError>;
         updateAdSetStatus: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateAdSetStatusData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateAdSetStatusResponse, unknown, ThrowOnError>;
-        getAdTree: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<GetAdTreeData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdTreeResponse, unknown, ThrowOnError>;
-        getAdsTimeline: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdsTimelineData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAdsTimelineResponse, unknown, ThrowOnError>;
+        getAdTree: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<GetAdTreeData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
+        getAdsTimeline: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetAdsTimelineData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<unknown, unknown, ThrowOnError>;
     };
     /**
      * adaudiences API
@@ -5640,6 +5640,56 @@ type WebhookPayloadMessage = {
         flowResponseData?: {
             [key: string]: unknown;
         };
+        /**
+         * WhatsApp only. Cart submitted by the user from a commerce message
+         * (catalog, product, or product-list message). Meta's `order` object
+         * forwarded verbatim.
+         *
+         */
+        order?: {
+            /**
+             * Meta catalog the ordered products belong to.
+             */
+            catalog_id?: string;
+            /**
+             * Optional free-text note the user attached to the cart.
+             */
+            text?: string;
+            product_items?: Array<{
+                /**
+                 * Retailer ID (SKU) of the ordered product.
+                 */
+                product_retailer_id?: string;
+                /**
+                 * Quantity ordered for this line item.
+                 */
+                quantity?: number;
+                /**
+                 * Unit price of the item.
+                 */
+                item_price?: number;
+                /**
+                 * ISO 4217 currency code (e.g. USD).
+                 */
+                currency?: string;
+            }>;
+        };
+        /**
+         * WhatsApp only. The product the user is asking about. Set when an
+         * inbound text carries Meta's `context.referred_product` (the user
+         * tapped "Message business" on a product). Forwarded verbatim.
+         *
+         */
+        referredProduct?: {
+            /**
+             * Meta catalog the product belongs to.
+             */
+            catalog_id?: string;
+            /**
+             * Retailer ID (SKU) of the product being asked about.
+             */
+            product_retailer_id?: string;
+        };
         /**
          * Instagram only. Populated when an IG user replies to one of the
          * account's stories (Meta `messaging_story_replies`). Mutually
@@ -13717,16 +13767,32 @@ type SendInboxMessageData = {
         };
         /**
          * WhatsApp-only. Rich interactive payload for list messages, CTA URL
-         * buttons, Flow prompts, and location requests. When set, takes
-         * priority over `buttons` and `quickReplies`. The shape mirrors
-         * Meta's Cloud API `interactive` object verbatim, so any payload
-         * that works against Meta directly will also work here.
+         * buttons, Flow prompts, location requests, voice-call buttons, and
+         * commerce messages (single product, product list, catalog, and
+         * carousel). When set, takes priority over `buttons` and
+         * `quickReplies`. The shape mirrors Meta's Cloud API `interactive`
+         * object verbatim, so any payload that works against Meta directly
+         * will also work here.
          *
          * Use `buttons` / `quickReplies` for simple button replies
-         * (WhatsApp's `interactive.type: "button"`) — the abstraction caps at
+         * (WhatsApp's `interactive.type: "button"`): the abstraction caps at
          * 3 buttons and handles the auto-conversion for you. Use this field
-         * only for `list`, `cta_url`, `flow`, `location_request_message`, or
-         * `voice_call` messages.
+         * only for the types listed in the enum below.
+         *
+         * All interactive messages are session messages: they can only be
+         * sent inside the 24-hour customer service window opened by the
+         * user's last inbound message.
+         *
+         * Commerce types (`product`, `product_list`, `catalog_message`, and
+         * product carousels) require a Meta catalog connected to the
+         * WhatsApp Business Account in Commerce Manager. Media carousels
+         * (image/video cards) do not need a catalog.
+         *
+         * For `product`, `body` is optional (WhatsApp renders the product
+         * card itself) and `header` is not allowed (the product image is
+         * the header). For `product_list`, a `header` with `type: "text"`
+         * is required. For `carousel`, top-level `header`/`footer` are not
+         * supported; media goes on each card instead.
          *
          * For `voice_call`, the message renders WhatsApp's native call
          * button; tapping it starts a voice call to your business number.
@@ -13739,17 +13805,25 @@ type SendInboxMessageData = {
          * "Send location" button; the user's reply arrives as a regular
          * location message in the conversation.
          *
+         * For `catalog_message`, `action` may also be omitted (we default it
+         * to `{ "name": "catalog_message" }`).
+         *
          * Tap events come back via the `message.received` webhook with
          * `metadata.interactiveType` set to `list_reply` or `nfm_reply`.
+         * Carts submitted from commerce messages arrive as `metadata.order`;
+         * product inquiries arrive as `metadata.referredProduct`.
          *
          */
         interactive?: {
             /**
              * Which interactive layout to render.
              */
-            type: 'list' | 'cta_url' | 'flow' | 'location_request_message' | 'voice_call';
+            type: 'list' | 'cta_url' | 'flow' | 'location_request_message' | 'voice_call' | 'product' | 'product_list' | 'catalog_message' | 'carousel';
             /**
-             * Optional header shown above the body.
+             * Optional header shown above the body. Required with
+             * `type: "text"` for `product_list`; not allowed for `product`
+             * or `carousel`.
+             *
              */
             header?: {
                 type?: 'text' | 'image' | 'video' | 'document';
@@ -13767,7 +13841,10 @@ type SendInboxMessageData = {
                     link?: string;
                 };
             };
-            body: {
+            /**
+             * Required for every type except `product`, where it is optional.
+             */
+            body?: {
                 /**
                  * Main body text.
                  */
@@ -13883,6 +13960,73 @@ type SendInboxMessageData = {
                 };
             } | {
                 name: 'send_location';
+            } | {
+                /**
+                 * Meta catalog ID connected to the WhatsApp Business Account.
+                 */
+                catalog_id: string;
+                /**
+                 * Retailer ID (SKU) of the product inside the catalog.
+                 */
+                product_retailer_id: string;
+            } | {
+                /**
+                 * Meta catalog ID connected to the WhatsApp Business Account.
+                 */
+                catalog_id: string;
+                /**
+                 * 1-10 sections. Total products across all sections cannot exceed 30.
+                 */
+                sections: Array<{
+                    /**
+                     * Optional section header.
+                     */
+                    title?: string;
+                    product_items: Array<{
+                        /**
+                         * Retailer ID (SKU) of the product inside the catalog.
+                         */
+                        product_retailer_id: string;
+                    }>;
+                }>;
+            } | {
+                name: 'catalog_message';
+                parameters?: {
+                    /**
+                     * Optional product whose image is used as the message thumbnail. Falls back to the first catalog item when omitted.
+                     */
+                    thumbnail_product_retailer_id?: string;
+                };
+            } | {
+                cards: Array<{
+                    /**
+                     * Card position. Auto-filled sequentially when omitted.
+                     */
+                    card_index?: number;
+                    /**
+                     * `product` for a product card; media cards use `cta_url` or a quick-reply type.
+                     */
+                    type?: string;
+                    /**
+                     * Media cards only
+                     */
+                    header?: {
+                        [key: string]: unknown;
+                    };
+                    /**
+                     * Optional card body text.
+                     */
+                    body?: {
+                        [key: string]: unknown;
+                    };
+                    /**
+                     * Product cards: `{ catalog_id, product_retailer_id }` (required). Media cards: the card's button action (e.g. `cta_url` with `parameters.display_text` and `parameters.url`).
+                     */
+                    action?: {
+                        [key: string]: unknown;
+                    };
+                    [key: string]: unknown | number | string;
+                }>;
             });
         };
         /**
@@ -20890,8 +21034,12 @@ type ListAdsData = {
 };
 type ListAdsResponse = ({
     ads?: Array<Ad>;
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     pagination?: Pagination;
-});
+} | unknown);
 type ListAdsError = ({
     error?: string;
 } | unknown);
@@ -21236,8 +21384,12 @@ type GetAdTreeData = {
 };
 type GetAdTreeResponse = ({
     campaigns?: Array<AdTreeCampaign>;
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     pagination?: Pagination;
-});
+} | unknown);
 type GetAdTreeError = ({
     error?: string;
 } | unknown);
@@ -21314,7 +21466,11 @@ type GetAdsTimelineResponse = ({
          */
         roas?: number;
     }>;
-});
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
+} | unknown);
 type GetAdsTimelineError = ({
     error?: string;
 } | unknown);
@@ -21452,6 +21608,10 @@ type GetCampaignAnalyticsResponse = ({
          */
         currency?: (string) | null;
     };
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     analytics?: {
         summary?: AdMetrics;
         daily?: Array<(AdMetrics & {
@@ -21463,7 +21623,7 @@ type GetCampaignAnalyticsResponse = ({
             }>;
         };
     };
-});
+} | unknown);
 type GetCampaignAnalyticsError = ({
     error?: string;
 } | unknown);
@@ -21498,6 +21658,10 @@ type GetAdAnalyticsResponse = ({
          */
         currency?: (string) | null;
     };
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     analytics?: {
         summary?: AdMetrics;
         daily?: Array<(AdMetrics & {
@@ -21509,7 +21673,7 @@ type GetAdAnalyticsResponse = ({
             }>;
         };
     };
-});
+} | unknown);
 type GetAdAnalyticsError = ({
     error?: string;
 } | unknown);

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.317",
+  version: "0.2.319",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.317",
+  version: "0.2.319",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlatedev/node",
-  "version": "0.2.317",
+  "version": "0.2.319",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -5936,8 +5936,9 @@ export const getAdTree = <ThrowOnError extends boolean = false>(options?: Option
  * (and vice-versa) — same convention as `/v1/ads/tree` and `/v1/ads`.
  *
  * Date range defaults to the last 90 days. Capped at 730 days. Ranges older
- * than the 90-day cache window trigger an on-demand backfill from the platform
- * before returning.
+ * than the ingested history return a `202` immediately with the covered part
+ * and `backfillPending: true` while the rest is backfilled in the background;
+ * repeat the request shortly until it returns 200 with full data.
  *
  */
 export const getAdsTimeline = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAdsTimelineData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -4992,6 +4992,56 @@ export type WebhookPayloadMessage = {
         flowResponseData?: {
             [key: string]: unknown;
         };
+        /**
+         * WhatsApp only. Cart submitted by the user from a commerce message
+         * (catalog, product, or product-list message). Meta's `order` object
+         * forwarded verbatim.
+         *
+         */
+        order?: {
+            /**
+             * Meta catalog the ordered products belong to.
+             */
+            catalog_id?: string;
+            /**
+             * Optional free-text note the user attached to the cart.
+             */
+            text?: string;
+            product_items?: Array<{
+                /**
+                 * Retailer ID (SKU) of the ordered product.
+                 */
+                product_retailer_id?: string;
+                /**
+                 * Quantity ordered for this line item.
+                 */
+                quantity?: number;
+                /**
+                 * Unit price of the item.
+                 */
+                item_price?: number;
+                /**
+                 * ISO 4217 currency code (e.g. USD).
+                 */
+                currency?: string;
+            }>;
+        };
+        /**
+         * WhatsApp only. The product the user is asking about. Set when an
+         * inbound text carries Meta's `context.referred_product` (the user
+         * tapped "Message business" on a product). Forwarded verbatim.
+         *
+         */
+        referredProduct?: {
+            /**
+             * Meta catalog the product belongs to.
+             */
+            catalog_id?: string;
+            /**
+             * Retailer ID (SKU) of the product being asked about.
+             */
+            product_retailer_id?: string;
+        };
         /**
          * Instagram only. Populated when an IG user replies to one of the
          * account's stories (Meta `messaging_story_replies`). Mutually
@@ -13629,16 +13679,32 @@ export type SendInboxMessageData = {
         };
         /**
          * WhatsApp-only. Rich interactive payload for list messages, CTA URL
-         * buttons, Flow prompts, and location requests. When set, takes
-         * priority over `buttons` and `quickReplies`. The shape mirrors
-         * Meta's Cloud API `interactive` object verbatim, so any payload
-         * that works against Meta directly will also work here.
+         * buttons, Flow prompts, location requests, voice-call buttons, and
+         * commerce messages (single product, product list, catalog, and
+         * carousel). When set, takes priority over `buttons` and
+         * `quickReplies`. The shape mirrors Meta's Cloud API `interactive`
+         * object verbatim, so any payload that works against Meta directly
+         * will also work here.
          *
          * Use `buttons` / `quickReplies` for simple button replies
-         * (WhatsApp's `interactive.type: "button"`) — the abstraction caps at
+         * (WhatsApp's `interactive.type: "button"`): the abstraction caps at
          * 3 buttons and handles the auto-conversion for you. Use this field
-         * only for `list`, `cta_url`, `flow`, `location_request_message`, or
-         * `voice_call` messages.
+         * only for the types listed in the enum below.
+         *
+         * All interactive messages are session messages: they can only be
+         * sent inside the 24-hour customer service window opened by the
+         * user's last inbound message.
+         *
+         * Commerce types (`product`, `product_list`, `catalog_message`, and
+         * product carousels) require a Meta catalog connected to the
+         * WhatsApp Business Account in Commerce Manager. Media carousels
+         * (image/video cards) do not need a catalog.
+         *
+         * For `product`, `body` is optional (WhatsApp renders the product
+         * card itself) and `header` is not allowed (the product image is
+         * the header). For `product_list`, a `header` with `type: "text"`
+         * is required. For `carousel`, top-level `header`/`footer` are not
+         * supported; media goes on each card instead.
          *
          * For `voice_call`, the message renders WhatsApp's native call
          * button; tapping it starts a voice call to your business number.
@@ -13651,17 +13717,25 @@ export type SendInboxMessageData = {
          * "Send location" button; the user's reply arrives as a regular
          * location message in the conversation.
          *
+         * For `catalog_message`, `action` may also be omitted (we default it
+         * to `{ "name": "catalog_message" }`).
+         *
          * Tap events come back via the `message.received` webhook with
          * `metadata.interactiveType` set to `list_reply` or `nfm_reply`.
+         * Carts submitted from commerce messages arrive as `metadata.order`;
+         * product inquiries arrive as `metadata.referredProduct`.
          *
          */
         interactive?: {
             /**
              * Which interactive layout to render.
              */
-            type: 'list' | 'cta_url' | 'flow' | 'location_request_message' | 'voice_call';
+            type: 'list' | 'cta_url' | 'flow' | 'location_request_message' | 'voice_call' | 'product' | 'product_list' | 'catalog_message' | 'carousel';
             /**
-             * Optional header shown above the body.
+             * Optional header shown above the body. Required with
+             * `type: "text"` for `product_list`; not allowed for `product`
+             * or `carousel`.
+             *
              */
             header?: {
                 type?: 'text' | 'image' | 'video' | 'document';
@@ -13679,7 +13753,10 @@ export type SendInboxMessageData = {
                     link?: string;
                 };
             };
-            body: {
+            /**
+             * Required for every type except `product`, where it is optional.
+             */
+            body?: {
                 /**
                  * Main body text.
                  */
@@ -13795,6 +13872,73 @@ export type SendInboxMessageData = {
     };
 } | {
     name: 'send_location';
+} | {
+    /**
+     * Meta catalog ID connected to the WhatsApp Business Account.
+     */
+    catalog_id: string;
+    /**
+     * Retailer ID (SKU) of the product inside the catalog.
+     */
+    product_retailer_id: string;
+} | {
+    /**
+     * Meta catalog ID connected to the WhatsApp Business Account.
+     */
+    catalog_id: string;
+    /**
+     * 1-10 sections. Total products across all sections cannot exceed 30.
+     */
+    sections: Array<{
+        /**
+         * Optional section header.
+         */
+        title?: string;
+        product_items: Array<{
+            /**
+             * Retailer ID (SKU) of the product inside the catalog.
+             */
+            product_retailer_id: string;
+        }>;
+    }>;
+} | {
+    name: 'catalog_message';
+    parameters?: {
+        /**
+         * Optional product whose image is used as the message thumbnail. Falls back to the first catalog item when omitted.
+         */
+        thumbnail_product_retailer_id?: string;
+    };
+} | {
+    cards: Array<{
+        /**
+         * Card position. Auto-filled sequentially when omitted.
+         */
+        card_index?: number;
+        /**
+         * `product` for a product card; media cards use `cta_url` or a quick-reply type.
+         */
+        type?: string;
+        /**
+         * Media cards only
+         */
+        header?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Optional card body text.
+         */
+        body?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Product cards: `{ catalog_id, product_retailer_id }` (required). Media cards: the card's button action (e.g. `cta_url` with `parameters.display_text` and `parameters.url`).
+         */
+        action?: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown | number | string;
+    }>;
 });
         };
         /**
@@ -21433,8 +21577,12 @@ export type ListAdsData = {
 
 export type ListAdsResponse = ({
     ads?: Array<Ad>;
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     pagination?: Pagination;
-});
+} | unknown);
 
 export type ListAdsError = ({
     error?: string;
@@ -21806,8 +21954,12 @@ export type GetAdTreeData = {
 
 export type GetAdTreeResponse = ({
     campaigns?: Array<AdTreeCampaign>;
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     pagination?: Pagination;
-});
+} | unknown);
 
 export type GetAdTreeError = ({
     error?: string;
@@ -21887,7 +22039,11 @@ export type GetAdsTimelineResponse = ({
          */
         roas?: number;
     }>;
-});
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
+} | unknown);
 
 export type GetAdsTimelineError = ({
     error?: string;
@@ -22037,6 +22193,10 @@ export type GetCampaignAnalyticsResponse = ({
          */
         currency?: (string) | null;
     };
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     analytics?: {
         summary?: AdMetrics;
         daily?: Array<(AdMetrics & {
@@ -22048,7 +22208,7 @@ export type GetCampaignAnalyticsResponse = ({
             }>;
         };
     };
-});
+} | unknown);
 
 export type GetCampaignAnalyticsError = ({
     error?: string;
@@ -22086,6 +22246,10 @@ export type GetAdAnalyticsResponse = ({
          */
         currency?: (string) | null;
     };
+    /**
+     * Present and true only on `202` responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.
+     */
+    backfillPending?: boolean;
     analytics?: {
         summary?: AdMetrics;
         daily?: Array<(AdMetrics & {
@@ -22097,7 +22261,7 @@ export type GetAdAnalyticsResponse = ({
             }>;
         };
     };
-});
+} | unknown);
 
 export type GetAdAnalyticsError = ({
     error?: string;