@getlatedev/node 0.2.1321 → 0.2.1323

package/dist/index.d.mts

@@ -46923,6 +46923,10 @@ type ListTikTokSmartPlusReviewsData = {
          * Also return Smart+ ads deleted on TikTok (listed with `primary_status: STATUS_ALL`).
          */
         includeDeleted?: boolean;
+        /**
+         * Freshness window in seconds. Reviews, refusals and the listing read within it are served without calling TikTok; older ones are still returned but read again, oldest first.
+         */
+        maxAgeSeconds?: number;
         page?: number;
         pageSize?: number;
     };
@@ -46930,6 +46934,10 @@ type ListTikTokSmartPlusReviewsData = {
 type ListTikTokSmartPlusReviewsResponse = ({
     adAccountId?: string;
     includeDeleted?: boolean;
+    /**
+     * The freshness window this page was read with.
+     */
+    maxAgeSeconds?: number;
     page?: number;
     pageSize?: number;
     totalPages?: number;
@@ -46937,6 +46945,58 @@ type ListTikTokSmartPlusReviewsResponse = ({
      * Smart+ ads of the advertiser across all pages.
      */
     totalSmartPlusAds?: number;
+    /**
+     * The Smart+ ad listing this page was cut from.
+     */
+    listing?: {
+        /**
+         * When the listing was read from TikTok.
+         */
+        readAt?: string;
+        /**
+         * `fresh`: read within `maxAgeSeconds`. `fallback`: relisting failed and this is the older stored listing.
+         */
+        source?: 'fresh' | 'fallback';
+        /**
+         * The relist error on a fallback, otherwise null.
+         */
+        error?: {
+            tiktokCode?: (number) | null;
+            message?: string;
+        } | null;
+    };
+    /**
+     * Set when TikTok refused both halves of a review batch the same way (for example a permission error) and the page was served from stored reviews instead of being refreshed. Null otherwise.
+     */
+    reviewError?: {
+        tiktokCode?: (number) | null;
+        message?: string;
+    } | null;
+    /**
+     * The Smart+ ads on this page split by state; the four counts add up to the Smart+ ads on this page (fewer than `pageSize` on the last page).
+     */
+    counts?: {
+        /**
+         * Items read within `maxAgeSeconds`.
+         */
+        fresh?: number;
+        /**
+         * Items read earlier, returned with their `readAt` and due for a refresh.
+         */
+        stale?: number;
+        /**
+         * Smart+ ads never read (`pendingSmartPlusAdIds`).
+         */
+        pending?: number;
+        /**
+         * Entries of `failedSmartPlusAds`.
+         */
+        failed?: number;
+    };
+    /**
+     * The oldest `readAt` in `items`. Null when `items` is empty.
+     */
+    oldestReadAt?: (string) | null;
     items?: Array<{
         smartPlusAdId?: string;
         adGroupId?: (string) | null;
@@ -46947,12 +47007,12 @@ type ListTikTokSmartPlusReviewsResponse = ({
          */
         materials?: Array<TikTokSmartPlusMaterialReview>;
         /**
-         * When the verdict was read from TikTok.
+         * When the verdict was read from TikTok, kept as is when served from the store. Older than `maxAgeSeconds` means stale.
          */
         readAt?: string;
     }>;
     /**
-     * Smart+ ads of this page whose review TikTok refused on its own (for example an ad deleted on TikTok since the listing was cached). Zernio splits a refused batch in halves (at most 16 extra calls per page), so the other ads of the batch are still read; ads left unresolved by that cap carry the batch error. Empty when none.
+     * Smart+ ads of this page whose review TikTok refused on its own (for example an ad deleted on TikTok since the listing was read). Zernio splits a refused batch in halves (at most 16 extra calls per page), so the other ads of the batch are still read; ads left unresolved by that cap stay in `items` with their stored review or in `pendingSmartPlusAdIds`. Empty when none.
      */
     failedSmartPlusAds?: Array<{
         smartPlusAdId?: string;
@@ -46968,17 +47028,25 @@ type ListTikTokSmartPlusReviewsResponse = ({
              */
             message?: string;
         };
+        /**
+         * When TikTok refused this ad. Null for a refusal stored before this field existed.
+         */
+        refusedAt?: (string) | null;
     }>;
     /**
-     * True when some Smart+ ads of this page could not be read because of TikTok's review quota.
+     * True while some Smart+ ads of this page were never read (`counts.pending > 0`). Stale items alone keep it false.
      */
     incomplete?: boolean;
     /**
-     * Smart+ ads of this page still to read. Empty when complete.
+     * True when every item and refusal of this page was read within `maxAgeSeconds` and nothing is pending. False with `incomplete: false` means the page is complete but some reviews are older than the window; a later read refreshes them oldest first.
+     */
+    allFresh?: boolean;
+    /**
+     * Smart+ ads of this page never read. Empty when every ad has a stored review or refusal.
      */
     pendingSmartPlusAdIds?: Array<(string)>;
     /**
-     * Seconds to wait before reading this page again. Null when complete.
+     * Seconds to wait before reading this page again, set only while `incomplete` is true and review reads are paused. Null when complete (stale items included), or when the page is incomplete without a quota pause (read it again right away).
      */
     retryAfterSeconds?: (number) | null;
 });
@@ -50016,10 +50084,25 @@ type BoostPostData = {
          * "engagement"` to objective `OUTCOME_AWARENESS`, which accepts
          * `REACH`, `IMPRESSIONS`, `AD_RECALL_LIFT`, or THRUPLAY-class values, and
          * rejects `POST_ENGAGEMENT` (that value is only valid under
-         * `OUTCOME_ENGAGEMENT`, which create uses for the same goal name).
+         * `OUTCOME_ENGAGEMENT`, which create uses for the same goal name, and
+         * which `metaObjective` selects on a boost).
          *
          */
         optimizationGoal?: string;
+        /**
+         * Meta only, with `goal: engagement` and without `adSetId` (400 otherwise).
+         * `OUTCOME_ENGAGEMENT` creates the campaign with objective `OUTCOME_ENGAGEMENT`
+         * and the ad set with `optimization_goal` `POST_ENGAGEMENT` (unless
+         * `optimizationGoal` is set) and `destination_type` `ON_POST` (unless
+         * `destinationType` is set), the shape Ads Manager uses to boost an existing
+         * post. When omitted, an engagement boost keeps `OUTCOME_AWARENESS` with
+         * `REACH`. Returns 400 with `leadGenFormId` or with a `callToAction` whose objective
+         * is not `OUTCOME_ENGAGEMENT` (`CALL_NOW`); messaging CTAs keep their own
+         * `CONVERSATIONS` ad set. Verified against Meta on Facebook posts; Instagram posts
+         * are accepted but not yet verified.
+         *
+         */
+        metaObjective?: 'OUTCOME_ENGAGEMENT';
     };
     headers?: {
         /**

package/dist/index.d.ts

@@ -46923,6 +46923,10 @@ type ListTikTokSmartPlusReviewsData = {
          * Also return Smart+ ads deleted on TikTok (listed with `primary_status: STATUS_ALL`).
          */
         includeDeleted?: boolean;
+        /**
+         * Freshness window in seconds. Reviews, refusals and the listing read within it are served without calling TikTok; older ones are still returned but read again, oldest first.
+         */
+        maxAgeSeconds?: number;
         page?: number;
         pageSize?: number;
     };
@@ -46930,6 +46934,10 @@ type ListTikTokSmartPlusReviewsData = {
 type ListTikTokSmartPlusReviewsResponse = ({
     adAccountId?: string;
     includeDeleted?: boolean;
+    /**
+     * The freshness window this page was read with.
+     */
+    maxAgeSeconds?: number;
     page?: number;
     pageSize?: number;
     totalPages?: number;
@@ -46937,6 +46945,58 @@ type ListTikTokSmartPlusReviewsResponse = ({
      * Smart+ ads of the advertiser across all pages.
      */
     totalSmartPlusAds?: number;
+    /**
+     * The Smart+ ad listing this page was cut from.
+     */
+    listing?: {
+        /**
+         * When the listing was read from TikTok.
+         */
+        readAt?: string;
+        /**
+         * `fresh`: read within `maxAgeSeconds`. `fallback`: relisting failed and this is the older stored listing.
+         */
+        source?: 'fresh' | 'fallback';
+        /**
+         * The relist error on a fallback, otherwise null.
+         */
+        error?: {
+            tiktokCode?: (number) | null;
+            message?: string;
+        } | null;
+    };
+    /**
+     * Set when TikTok refused both halves of a review batch the same way (for example a permission error) and the page was served from stored reviews instead of being refreshed. Null otherwise.
+     */
+    reviewError?: {
+        tiktokCode?: (number) | null;
+        message?: string;
+    } | null;
+    /**
+     * The Smart+ ads on this page split by state; the four counts add up to the Smart+ ads on this page (fewer than `pageSize` on the last page).
+     */
+    counts?: {
+        /**
+         * Items read within `maxAgeSeconds`.
+         */
+        fresh?: number;
+        /**
+         * Items read earlier, returned with their `readAt` and due for a refresh.
+         */
+        stale?: number;
+        /**
+         * Smart+ ads never read (`pendingSmartPlusAdIds`).
+         */
+        pending?: number;
+        /**
+         * Entries of `failedSmartPlusAds`.
+         */
+        failed?: number;
+    };
+    /**
+     * The oldest `readAt` in `items`. Null when `items` is empty.
+     */
+    oldestReadAt?: (string) | null;
     items?: Array<{
         smartPlusAdId?: string;
         adGroupId?: (string) | null;
@@ -46947,12 +47007,12 @@ type ListTikTokSmartPlusReviewsResponse = ({
          */
         materials?: Array<TikTokSmartPlusMaterialReview>;
         /**
-         * When the verdict was read from TikTok.
+         * When the verdict was read from TikTok, kept as is when served from the store. Older than `maxAgeSeconds` means stale.
          */
         readAt?: string;
     }>;
     /**
-     * Smart+ ads of this page whose review TikTok refused on its own (for example an ad deleted on TikTok since the listing was cached). Zernio splits a refused batch in halves (at most 16 extra calls per page), so the other ads of the batch are still read; ads left unresolved by that cap carry the batch error. Empty when none.
+     * Smart+ ads of this page whose review TikTok refused on its own (for example an ad deleted on TikTok since the listing was read). Zernio splits a refused batch in halves (at most 16 extra calls per page), so the other ads of the batch are still read; ads left unresolved by that cap stay in `items` with their stored review or in `pendingSmartPlusAdIds`. Empty when none.
      */
     failedSmartPlusAds?: Array<{
         smartPlusAdId?: string;
@@ -46968,17 +47028,25 @@ type ListTikTokSmartPlusReviewsResponse = ({
              */
             message?: string;
         };
+        /**
+         * When TikTok refused this ad. Null for a refusal stored before this field existed.
+         */
+        refusedAt?: (string) | null;
     }>;
     /**
-     * True when some Smart+ ads of this page could not be read because of TikTok's review quota.
+     * True while some Smart+ ads of this page were never read (`counts.pending > 0`). Stale items alone keep it false.
      */
     incomplete?: boolean;
     /**
-     * Smart+ ads of this page still to read. Empty when complete.
+     * True when every item and refusal of this page was read within `maxAgeSeconds` and nothing is pending. False with `incomplete: false` means the page is complete but some reviews are older than the window; a later read refreshes them oldest first.
+     */
+    allFresh?: boolean;
+    /**
+     * Smart+ ads of this page never read. Empty when every ad has a stored review or refusal.
      */
     pendingSmartPlusAdIds?: Array<(string)>;
     /**
-     * Seconds to wait before reading this page again. Null when complete.
+     * Seconds to wait before reading this page again, set only while `incomplete` is true and review reads are paused. Null when complete (stale items included), or when the page is incomplete without a quota pause (read it again right away).
      */
     retryAfterSeconds?: (number) | null;
 });
@@ -50016,10 +50084,25 @@ type BoostPostData = {
          * "engagement"` to objective `OUTCOME_AWARENESS`, which accepts
          * `REACH`, `IMPRESSIONS`, `AD_RECALL_LIFT`, or THRUPLAY-class values, and
          * rejects `POST_ENGAGEMENT` (that value is only valid under
-         * `OUTCOME_ENGAGEMENT`, which create uses for the same goal name).
+         * `OUTCOME_ENGAGEMENT`, which create uses for the same goal name, and
+         * which `metaObjective` selects on a boost).
          *
          */
         optimizationGoal?: string;
+        /**
+         * Meta only, with `goal: engagement` and without `adSetId` (400 otherwise).
+         * `OUTCOME_ENGAGEMENT` creates the campaign with objective `OUTCOME_ENGAGEMENT`
+         * and the ad set with `optimization_goal` `POST_ENGAGEMENT` (unless
+         * `optimizationGoal` is set) and `destination_type` `ON_POST` (unless
+         * `destinationType` is set), the shape Ads Manager uses to boost an existing
+         * post. When omitted, an engagement boost keeps `OUTCOME_AWARENESS` with
+         * `REACH`. Returns 400 with `leadGenFormId` or with a `callToAction` whose objective
+         * is not `OUTCOME_ENGAGEMENT` (`CALL_NOW`); messaging CTAs keep their own
+         * `CONVERSATIONS` ad set. Verified against Meta on Facebook posts; Instagram posts
+         * are accepted but not yet verified.
+         *
+         */
+        metaObjective?: 'OUTCOME_ENGAGEMENT';
     };
     headers?: {
         /**

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -11666,14 +11666,15 @@ 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, which behaves per advertiser. One TikTok call reads the
+ * TikTok's review endpoint has a strict quota of its own (TikTok documents neither the quota nor its scope). 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
+ * and each review is stored per connection, advertiser and Smart+ ad. This read serves a review read
+ * in the last 10 minutes from the store, so sibling ads are answered without a TikTok call and `readAt`
+ * can be up to 10 minutes old; an older one is read again. 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.
+ * and answers 429 for that advertiser and connection without calling TikTok for about 60 seconds, then
+ * 120, then 240 while TikTok keeps refusing (one step down after a successful call, each with up to 10%
+ * of random jitter), with the time left as `Retry-After`; reviews read in the last 10 minutes are still served.
  */
 export const getTikTokSmartPlusAdReview = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTikTokSmartPlusAdReviewData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetTikTokSmartPlusAdReviewResponse, GetTikTokSmartPlusAdReviewError, ThrowOnError>({
@@ -12197,13 +12198,17 @@ 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 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.
+ * Zernio lists the advertiser's Smart+ ads with `/smart_plus/ad/get/` (deleted ones only with `includeDeleted=true`) 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.
  *
- * 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.
+ * Stale while refreshing: every review is stored for 24 hours per connection, advertiser and Smart+ ad (shared with the single-ad read), and `readAt` is always the time TikTok answered, never rewritten when served from the store. `maxAgeSeconds` (default 3600) is the freshness window: a review read within it is fresh and costs no TikTok call; an older one is still returned in `items` but is read again, and so is a Smart+ ad never read. Each request first reads every Smart+ ad of the page never read (live, then deleted with `includeDeleted=true`) and only then refreshes stale ones, oldest `readAt` first, so a quota pause cannot leave never-read ads behind stale ones, progress carries over between requests and an ad already read never goes back to pending. A stored review is replaced only by a successful read. `counts` splits the Smart+ ads on this page into `fresh`, `stale`, `pending` and `failed`, and `oldestReadAt` is the oldest `readAt` of `items`. `incomplete` is true only while some Smart+ ad of the page has never been read (`pending > 0`). Staleness is reported apart: `allFresh` is true when every item and refusal of the page is within `maxAgeSeconds` and nothing is pending. A page with stale items and nothing pending is complete (`incomplete: false`, no `Retry-After`): move on, and a later read refreshes it oldest first. On 2026-10-25 TikTok's quota allowed about 130 to 230 Smart+ ads per advertiser per hour (about 11.5 ads and 4 creatives per successful call), so a larger advertiser cannot be fully refreshed within one hour and its pages stay complete but not `allFresh`.
  *
- * 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.
+ * The listing is stored with the time it was read (`listing.readAt`) and listed again when it is older than `maxAgeSeconds`, so it can be up to `maxAgeSeconds` old: a Smart+ ad created on TikTok appears after at most that long (one hour by default). If that relisting fails, Zernio serves the stored listing with `listing.source: fallback` and the relist error in `listing.error`, instead of failing the request; `listing.source: fresh` means the listing was read within `maxAgeSeconds`. Only when no listing was ever stored does the listing error fail the request.
  *
- * 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.
+ * TikTok's review endpoint has a strict quota of its own (TikTok documents neither the quota nor its scope). When it is over quota (or Zernio is holding review reads for this advertiser and connection after an overage: about 60 seconds, then 120, then 240 while TikTok keeps refusing, one step down after a successful call, each with up to 10% of random jitter), Zernio stops calling TikTok and answers 200 with the reviews it has: stale reviews in `items`, the Smart+ ads never read in `pendingSmartPlusAdIds` and, when any are pending, `incomplete: true` with `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 stale and pending ads reach TikTok.
+ *
+ * A Smart+ ad whose review TikTok refuses on its own (for example one deleted on TikTok since the listing was read) is returned in `failedSmartPlusAds` with TikTok's error and `refusedAt`, 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 keep their stored review, or stay in `pendingSmartPlusAdIds` when they have none, and are read first by the next request. A refusal of a single ad is stored for 24 hours and read again once it is older than `maxAgeSeconds`; when an ad has both a stored review and a stored refusal, the more recent one is returned. When both halves of a refused batch are refused with the same TikTok error (for example a permission error), Zernio stops calling TikTok for that page: when every Smart+ ad of the page has a stored review or refusal, it serves them and returns the refusal in `reviewError`; when some ad was never read, the whole request fails with that error.
+ *
+ * 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. Production logs suggest the quota is counted per advertiser (not confirmed by TikTok), so different advertisers have been read in parallel without throttling each other.
  */
 export const listTikTokSmartPlusReviews = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTikTokSmartPlusReviewsData, ThrowOnError>) => {
     return (options?.client ?? client).get<ListTikTokSmartPlusReviewsResponse, ListTikTokSmartPlusReviewsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -47625,6 +47625,10 @@ export type ListTikTokSmartPlusReviewsData = {
          * Also return Smart+ ads deleted on TikTok (listed with `primary_status: STATUS_ALL`).
          */
         includeDeleted?: boolean;
+        /**
+         * Freshness window in seconds. Reviews, refusals and the listing read within it are served without calling TikTok; older ones are still returned but read again, oldest first.
+         */
+        maxAgeSeconds?: number;
         page?: number;
         pageSize?: number;
     };
@@ -47633,6 +47637,10 @@ export type ListTikTokSmartPlusReviewsData = {
 export type ListTikTokSmartPlusReviewsResponse = ({
     adAccountId?: string;
     includeDeleted?: boolean;
+    /**
+     * The freshness window this page was read with.
+     */
+    maxAgeSeconds?: number;
     page?: number;
     pageSize?: number;
     totalPages?: number;
@@ -47640,6 +47648,58 @@ export type ListTikTokSmartPlusReviewsResponse = ({
      * Smart+ ads of the advertiser across all pages.
      */
     totalSmartPlusAds?: number;
+    /**
+     * The Smart+ ad listing this page was cut from.
+     */
+    listing?: {
+        /**
+         * When the listing was read from TikTok.
+         */
+        readAt?: string;
+        /**
+         * `fresh`: read within `maxAgeSeconds`. `fallback`: relisting failed and this is the older stored listing.
+         */
+        source?: 'fresh' | 'fallback';
+        /**
+         * The relist error on a fallback, otherwise null.
+         */
+        error?: {
+            tiktokCode?: (number) | null;
+            message?: string;
+        } | null;
+    };
+    /**
+     * Set when TikTok refused both halves of a review batch the same way (for example a permission error) and the page was served from stored reviews instead of being refreshed. Null otherwise.
+     */
+    reviewError?: {
+        tiktokCode?: (number) | null;
+        message?: string;
+    } | null;
+    /**
+     * The Smart+ ads on this page split by state; the four counts add up to the Smart+ ads on this page (fewer than `pageSize` on the last page).
+     */
+    counts?: {
+        /**
+         * Items read within `maxAgeSeconds`.
+         */
+        fresh?: number;
+        /**
+         * Items read earlier, returned with their `readAt` and due for a refresh.
+         */
+        stale?: number;
+        /**
+         * Smart+ ads never read (`pendingSmartPlusAdIds`).
+         */
+        pending?: number;
+        /**
+         * Entries of `failedSmartPlusAds`.
+         */
+        failed?: number;
+    };
+    /**
+     * The oldest `readAt` in `items`. Null when `items` is empty.
+     */
+    oldestReadAt?: (string) | null;
     items?: Array<{
         smartPlusAdId?: string;
         adGroupId?: (string) | null;
@@ -47650,12 +47710,12 @@ export type ListTikTokSmartPlusReviewsResponse = ({
          */
         materials?: Array<TikTokSmartPlusMaterialReview>;
         /**
-         * When the verdict was read from TikTok.
+         * When the verdict was read from TikTok, kept as is when served from the store. Older than `maxAgeSeconds` means stale.
          */
         readAt?: string;
     }>;
     /**
-     * Smart+ ads of this page whose review TikTok refused on its own (for example an ad deleted on TikTok since the listing was cached). Zernio splits a refused batch in halves (at most 16 extra calls per page), so the other ads of the batch are still read; ads left unresolved by that cap carry the batch error. Empty when none.
+     * Smart+ ads of this page whose review TikTok refused on its own (for example an ad deleted on TikTok since the listing was read). Zernio splits a refused batch in halves (at most 16 extra calls per page), so the other ads of the batch are still read; ads left unresolved by that cap stay in `items` with their stored review or in `pendingSmartPlusAdIds`. Empty when none.
      */
     failedSmartPlusAds?: Array<{
         smartPlusAdId?: string;
@@ -47671,17 +47731,25 @@ export type ListTikTokSmartPlusReviewsResponse = ({
              */
             message?: string;
         };
+        /**
+         * When TikTok refused this ad. Null for a refusal stored before this field existed.
+         */
+        refusedAt?: (string) | null;
     }>;
     /**
-     * True when some Smart+ ads of this page could not be read because of TikTok's review quota.
+     * True while some Smart+ ads of this page were never read (`counts.pending > 0`). Stale items alone keep it false.
      */
     incomplete?: boolean;
     /**
-     * Smart+ ads of this page still to read. Empty when complete.
+     * True when every item and refusal of this page was read within `maxAgeSeconds` and nothing is pending. False with `incomplete: false` means the page is complete but some reviews are older than the window; a later read refreshes them oldest first.
+     */
+    allFresh?: boolean;
+    /**
+     * Smart+ ads of this page never read. Empty when every ad has a stored review or refusal.
      */
     pendingSmartPlusAdIds?: Array<(string)>;
     /**
-     * Seconds to wait before reading this page again. Null when complete.
+     * Seconds to wait before reading this page again, set only while `incomplete` is true and review reads are paused. Null when complete (stale items included), or when the page is incomplete without a quota pause (read it again right away).
      */
     retryAfterSeconds?: (number) | null;
 });
@@ -50922,10 +50990,25 @@ export type BoostPostData = {
          * "engagement"` to objective `OUTCOME_AWARENESS`, which accepts
          * `REACH`, `IMPRESSIONS`, `AD_RECALL_LIFT`, or THRUPLAY-class values, and
          * rejects `POST_ENGAGEMENT` (that value is only valid under
-         * `OUTCOME_ENGAGEMENT`, which create uses for the same goal name).
+         * `OUTCOME_ENGAGEMENT`, which create uses for the same goal name, and
+         * which `metaObjective` selects on a boost).
          *
          */
         optimizationGoal?: string;
+        /**
+         * Meta only, with `goal: engagement` and without `adSetId` (400 otherwise).
+         * `OUTCOME_ENGAGEMENT` creates the campaign with objective `OUTCOME_ENGAGEMENT`
+         * and the ad set with `optimization_goal` `POST_ENGAGEMENT` (unless
+         * `optimizationGoal` is set) and `destination_type` `ON_POST` (unless
+         * `destinationType` is set), the shape Ads Manager uses to boost an existing
+         * post. When omitted, an engagement boost keeps `OUTCOME_AWARENESS` with
+         * `REACH`. Returns 400 with `leadGenFormId` or with a `callToAction` whose objective
+         * is not `OUTCOME_ENGAGEMENT` (`CALL_NOW`); messaging CTAs keep their own
+         * `CONVERSATIONS` ad set. Verified against Meta on Facebook posts; Instagram posts
+         * are accepted but not yet verified.
+         *
+         */
+        metaObjective?: 'OUTCOME_ENGAGEMENT';
     };
     headers?: {
         /**