@getlatedev/node 0.2.1294 → 0.2.1296

package/dist/index.d.mts

@@ -6724,6 +6724,11 @@ type ConversionEvent = {
      * for Business Messaging). `channel` is sent as the event's `messaging_channel`
      * (`instagram_direct` goes out as `instagram`). Each id lands in Meta's
      * `user_data` unhashed, and an id that does not belong to `channel` is ignored.
+     * Meta accepts only its business messaging event names here (`LeadSubmitted`,
+     * `QualifiedLead`, `Purchase`, `AddToCart`, `InitiateCheckout`, `ViewContent`,
+     * `OrderCreated`, `OrderShipped`, `OrderDelivered`, `OrderCanceled`,
+     * `OrderReturned`, `CartAbandoned`, `RatingProvided`, `ReviewProvided`);
+     * `eventName` is forwarded unchanged.
      *
      */
     messaging?: {
@@ -53785,7 +53790,7 @@ type ListWhatsAppConversionsResponse = ({
          */
         timestamp?: string;
         /**
-         * One of LeadSubmitted, Purchase, AddToCart, InitiateCheckout, ViewContent.
+         * One of LeadSubmitted, QualifiedLead, Purchase, AddToCart, InitiateCheckout, ViewContent, OrderCreated, OrderCanceled, OrderReturned.
          */
         eventName?: string;
         conversationId?: (string) | null;
@@ -53812,9 +53817,8 @@ type SendWhatsAppConversionData = {
          */
         accountId: string;
         /**
-         * Live-verified allowlist of event names accepted by Meta's
-         * CAPI for Business Messaging (Graph API v25.0). Other
-         * standard pixel events including `Lead`,
+         * Event names accepted by Meta's CAPI for Business
+         * Messaging. Other standard pixel events including `Lead`,
          * `CompleteRegistration`, `Subscribe`, `Schedule`, `Contact`,
          * `StartTrial`, `AddPaymentInfo`, `Search`, and
          * `SubmitApplication` are rejected with subcode 2804066
@@ -53822,10 +53826,14 @@ type SendWhatsAppConversionData = {
          * `action_source = business_messaging` events. Custom event
          * names are also rejected.
          *
-         * Use `LeadSubmitted` (NOT `Lead`) for lead-style conversions.
+         * Use `LeadSubmitted` (NOT `Lead`) when a lead comes in and
+         * `QualifiedLead` once your team qualifies it. `OrderCreated`,
+         * `OrderCanceled` and `OrderReturned` track an order placed in
+         * the chat; send `value` and `currency` with them (and with
+         * `Purchase`) to report the order amount.
          *
          */
-        eventName: 'LeadSubmitted' | 'Purchase' | 'AddToCart' | 'InitiateCheckout' | 'ViewContent';
+        eventName: 'LeadSubmitted' | 'QualifiedLead' | 'Purchase' | 'AddToCart' | 'InitiateCheckout' | 'ViewContent' | 'OrderCreated' | 'OrderCanceled' | 'OrderReturned';
         /**
          * Unix seconds. Defaults to the time of the request when
          * omitted. Meta's attribution window is 7 days from click;

package/dist/index.d.ts

@@ -6724,6 +6724,11 @@ type ConversionEvent = {
      * for Business Messaging). `channel` is sent as the event's `messaging_channel`
      * (`instagram_direct` goes out as `instagram`). Each id lands in Meta's
      * `user_data` unhashed, and an id that does not belong to `channel` is ignored.
+     * Meta accepts only its business messaging event names here (`LeadSubmitted`,
+     * `QualifiedLead`, `Purchase`, `AddToCart`, `InitiateCheckout`, `ViewContent`,
+     * `OrderCreated`, `OrderShipped`, `OrderDelivered`, `OrderCanceled`,
+     * `OrderReturned`, `CartAbandoned`, `RatingProvided`, `ReviewProvided`);
+     * `eventName` is forwarded unchanged.
      *
      */
     messaging?: {
@@ -53785,7 +53790,7 @@ type ListWhatsAppConversionsResponse = ({
          */
         timestamp?: string;
         /**
-         * One of LeadSubmitted, Purchase, AddToCart, InitiateCheckout, ViewContent.
+         * One of LeadSubmitted, QualifiedLead, Purchase, AddToCart, InitiateCheckout, ViewContent, OrderCreated, OrderCanceled, OrderReturned.
          */
         eventName?: string;
         conversationId?: (string) | null;
@@ -53812,9 +53817,8 @@ type SendWhatsAppConversionData = {
          */
         accountId: string;
         /**
-         * Live-verified allowlist of event names accepted by Meta's
-         * CAPI for Business Messaging (Graph API v25.0). Other
-         * standard pixel events including `Lead`,
+         * Event names accepted by Meta's CAPI for Business
+         * Messaging. Other standard pixel events including `Lead`,
          * `CompleteRegistration`, `Subscribe`, `Schedule`, `Contact`,
          * `StartTrial`, `AddPaymentInfo`, `Search`, and
          * `SubmitApplication` are rejected with subcode 2804066
@@ -53822,10 +53826,14 @@ type SendWhatsAppConversionData = {
          * `action_source = business_messaging` events. Custom event
          * names are also rejected.
          *
-         * Use `LeadSubmitted` (NOT `Lead`) for lead-style conversions.
+         * Use `LeadSubmitted` (NOT `Lead`) when a lead comes in and
+         * `QualifiedLead` once your team qualifies it. `OrderCreated`,
+         * `OrderCanceled` and `OrderReturned` track an order placed in
+         * the chat; send `value` and `currency` with them (and with
+         * `Purchase`) to report the order amount.
          *
          */
-        eventName: 'LeadSubmitted' | 'Purchase' | 'AddToCart' | 'InitiateCheckout' | 'ViewContent';
+        eventName: 'LeadSubmitted' | 'QualifiedLead' | 'Purchase' | 'AddToCart' | 'InitiateCheckout' | 'ViewContent' | 'OrderCreated' | 'OrderCanceled' | 'OrderReturned';
         /**
          * Unix seconds. Defaults to the time of the request when
          * omitted. Meta's attribution window is 7 days from click;

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1294",
+  version: "0.2.1296",
   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.1294",
+  version: "0.2.1296",
   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.1294",
+  "version": "0.2.1296",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -11462,13 +11462,14 @@ export const getAdReview = <ThrowOnError extends boolean = false>(options: Optio
  * carousel under its own material id, so those entries come back with the review verdict and
  * null descriptive fields. TikTok returns no review timestamp; `readAt` is when Zernio read it.
  *
- * TikTok's review endpoint has a strict quota of its own. One TikTok call reads the review of
- * every live Smart+ ad of the ad group (up to 100), and each review is cached for 10 minutes per
- * connection, advertiser and Smart+ ad, so sibling ads are answered from the cache and `readAt`
- * can be up to 10 minutes old. Read reviews when you need them instead of sweeping every ad on a
- * loop. When TikTok answers over quota, Zernio returns 429 with `Retry-After: 60` and answers
- * 429 for that advertiser and connection without calling TikTok until the minute is over; cached
- * reviews are still served.
+ * TikTok's review endpoint has a strict quota of its own, which behaves per advertiser. One TikTok call reads the
+ * review of the live Smart+ ads of the ad group up to 50 creatives in total (TikTok refuses more),
+ * and each review is cached for 10 minutes per connection, advertiser and Smart+ ad, so sibling ads
+ * are answered from the cache and `readAt` can be up to 10 minutes old. Read reviews when you need
+ * them instead of sweeping every ad on a loop. When TikTok answers over quota, Zernio returns 429
+ * and answers 429 for that advertiser and connection without calling TikTok for 60 seconds, then
+ * 120, then 240 while TikTok keeps refusing (back to 60 after a successful call), with the time left
+ * as `Retry-After`; cached reviews are still served.
  */
 export const getTikTokSmartPlusAdReview = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTikTokSmartPlusAdReviewData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTikTokSmartPlusAdReviewResponse, GetTikTokSmartPlusAdReviewError, ThrowOnError>({
@@ -11992,13 +11993,13 @@ export const getTikTokSmartPlusMaterialReport = <ThrowOnError extends boolean =
  * Review status of every TikTok Smart+ ad of an advertiser
  * Returns the review verdict of every Upgraded Smart+ ad of one TikTok advertiser, with each creative's verdict, in one paginated read. Use it to refresh reviews periodically: one call (plus its pages) per advertiser per refresh, instead of `GET /v1/ads/{adId}/tiktok-smart-plus-review` per ad.
  *
- * Zernio lists the advertiser's Smart+ ads with `/smart_plus/ad/get/` (deleted ones only with `includeDeleted=true`; the listing is cached for 5 minutes) and reads `/smart_plus/ad/review_info/` for up to 100 Smart+ ads per call, across ad groups, one call after another. A full refresh of N Smart+ ads costs about `ceil(N / 100)` listing calls and `ceil(N / 100)` review calls on TikTok. Each review is cached for 10 minutes per connection, advertiser and Smart+ ad, shared with the single-ad read, so cached reviews are served without calling TikTok and `readAt` can be up to 10 minutes old.
+ * Zernio lists the advertiser's Smart+ ads with `/smart_plus/ad/get/` (deleted ones only with `includeDeleted=true`; the listing is cached for 10 minutes) and reads `/smart_plus/ad/review_info/` for Smart+ ads holding up to 50 creatives in total per call (TikTok refuses more; a Smart+ ad with more than 50 creatives is read alone), across ad groups, one call after another. A full refresh of N Smart+ ads with C creatives in total costs about `ceil(N / 100)` listing calls and `ceil(C / 50)` review calls on TikTok. When TikTok still refuses a call for its creative count, Zernio lowers the creative cap for that advertiser and reads the same ads again in smaller calls, never resending the refused size. Each review is cached for 10 minutes per connection, advertiser and Smart+ ad, shared with the single-ad read, so cached reviews are served without calling TikTok and `readAt` can be up to 10 minutes old.
  *
- * TikTok's review endpoint has a strict quota of its own. When it is over quota (or Zernio is holding review reads for this advertiser and connection after an overage), Zernio stops calling TikTok and answers 200 with the reviews it has: `incomplete: true`, the Smart+ ads still to read in `pendingSmartPlusAdIds`, and `retryAfterSeconds` (also in the `Retry-After` header). Every Smart+ ad of the page is in `items`, `failedSmartPlusAds` or `pendingSmartPlusAdIds`. Wait `retryAfterSeconds` and read the same page again: only the pending ads reach TikTok.
+ * TikTok's review endpoint has a strict quota of its own, which behaves per advertiser. When it is over quota (or Zernio is holding review reads for this advertiser and connection after an overage: 60 seconds, then 120, then 240 while TikTok keeps refusing, back to 60 after a successful call), Zernio stops calling TikTok and answers 200 with the reviews it has: `incomplete: true`, the Smart+ ads still to read in `pendingSmartPlusAdIds`, and `retryAfterSeconds` (also in the `Retry-After` header). Every Smart+ ad of the page is in `items`, `failedSmartPlusAds` or `pendingSmartPlusAdIds`. Wait `retryAfterSeconds` and read the same page again: only the pending ads reach TikTok.
  *
  * A Smart+ ad whose review TikTok refuses on its own (for example one deleted on TikTok since the listing was cached) is returned in `failedSmartPlusAds` with TikTok's error, and the rest of the page is still read. Zernio finds it by splitting the refused batch in halves, at most 16 extra TikTok calls per page; ads still unresolved after that come back in `failedSmartPlusAds` with the batch error. A refusal of a single ad is remembered for 10 minutes. When both halves of a refused batch are refused with the same TikTok error (for example a permission error), the whole request fails with that error instead.
  *
- * Items are sorted by `adGroupId`, then `smartPlusAdId`, so pages are stable. Read the pages of one advertiser one after another, not in parallel: parallel pages spend the review quota at the same time and come back incomplete.
+ * Items are sorted by `adGroupId`, then `smartPlusAdId`, so pages are stable. Keep one page in flight per advertiser and read its pages one after another: parallel pages of one advertiser spend its review quota at the same time and come back incomplete. The quota behaves per advertiser (observed, not documented by TikTok), so different advertisers can be read in parallel.
  */
 export const listTikTokSmartPlusReviews = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTikTokSmartPlusReviewsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTikTokSmartPlusReviewsResponse, ListTikTokSmartPlusReviewsError, ThrowOnError>({
@@ -15026,8 +15027,9 @@ export const listWhatsAppConversions = <ThrowOnError extends boolean = false>(op
 /**
  * Send WhatsApp conversion event
  * Forward a WhatsApp Business Messaging conversion event (`LeadSubmitted`,
- * `Purchase`, `AddToCart`, `InitiateCheckout`, `ViewContent`) to Meta's
- * Conversions API with `action_source = business_messaging` and
+ * `QualifiedLead`, `Purchase`, `AddToCart`, `InitiateCheckout`,
+ * `ViewContent`, `OrderCreated`, `OrderCanceled`, `OrderReturned`) to
+ * Meta's Conversions API with `action_source = business_messaging` and
  * `messaging_channel = whatsapp`. The endpoint looks up the originating
  * CTWA click ID (`ctwa_clid`) captured on the first inbound message of
  * the conversation and replays it on every event so Meta can attribute

package/src/generated/types.gen.ts

@@ -4864,6 +4864,11 @@ export type ConversionEvent = {
      * for Business Messaging). `channel` is sent as the event's `messaging_channel`
      * (`instagram_direct` goes out as `instagram`). Each id lands in Meta's
      * `user_data` unhashed, and an id that does not belong to `channel` is ignored.
+     * Meta accepts only its business messaging event names here (`LeadSubmitted`,
+     * `QualifiedLead`, `Purchase`, `AddToCart`, `InitiateCheckout`, `ViewContent`,
+     * `OrderCreated`, `OrderShipped`, `OrderDelivered`, `OrderCanceled`,
+     * `OrderReturned`, `CartAbandoned`, `RatingProvided`, `ReviewProvided`);
+     * `eventName` is forwarded unchanged.
      *
      */
     messaging?: {
@@ -54898,7 +54903,7 @@ export type ListWhatsAppConversionsResponse = ({
          */
         timestamp?: string;
         /**
-         * One of LeadSubmitted, Purchase, AddToCart, InitiateCheckout, ViewContent.
+         * One of LeadSubmitted, QualifiedLead, Purchase, AddToCart, InitiateCheckout, ViewContent, OrderCreated, OrderCanceled, OrderReturned.
          */
         eventName?: string;
         conversationId?: (string) | null;
@@ -54927,9 +54932,8 @@ export type SendWhatsAppConversionData = {
          */
         accountId: string;
         /**
-         * Live-verified allowlist of event names accepted by Meta's
-         * CAPI for Business Messaging (Graph API v25.0). Other
-         * standard pixel events including `Lead`,
+         * Event names accepted by Meta's CAPI for Business
+         * Messaging. Other standard pixel events including `Lead`,
          * `CompleteRegistration`, `Subscribe`, `Schedule`, `Contact`,
          * `StartTrial`, `AddPaymentInfo`, `Search`, and
          * `SubmitApplication` are rejected with subcode 2804066
@@ -54937,10 +54941,14 @@ export type SendWhatsAppConversionData = {
          * `action_source = business_messaging` events. Custom event
          * names are also rejected.
          *
-         * Use `LeadSubmitted` (NOT `Lead`) for lead-style conversions.
+         * Use `LeadSubmitted` (NOT `Lead`) when a lead comes in and
+         * `QualifiedLead` once your team qualifies it. `OrderCreated`,
+         * `OrderCanceled` and `OrderReturned` track an order placed in
+         * the chat; send `value` and `currency` with them (and with
+         * `Purchase`) to report the order amount.
          *
          */
-        eventName: 'LeadSubmitted' | 'Purchase' | 'AddToCart' | 'InitiateCheckout' | 'ViewContent';
+        eventName: 'LeadSubmitted' | 'QualifiedLead' | 'Purchase' | 'AddToCart' | 'InitiateCheckout' | 'ViewContent' | 'OrderCreated' | 'OrderCanceled' | 'OrderReturned';
         /**
          * Unix seconds. Defaults to the time of the request when
          * omitted. Meta's attribution window is 7 days from click;