@getlatedev/node 0.2.1112 → 0.2.1114

package/dist/index.d.mts

@@ -10652,9 +10652,13 @@ type PlatformAnalytics = {
      */
     errorMessage?: (string) | null;
     /**
-     * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
+     * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. not_post_owner: the post is owned by another Page or user (collab or visitor post); its analytics cannot be read with this Page's token. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
      */
-    errorCode?: ('post_not_found' | 'permission_missing') | null;
+    errorCode?: ('post_not_found' | 'not_post_owner' | 'permission_missing') | null;
+    /**
+     * Facebook only: true when the connected Page authored the post, false when Facebook reports another author (a collab post), null when unknown or for other platforms.
+     */
+    isOwner?: (boolean) | null;
 };
 type status24 = 'published' | 'failed';
 /**
@@ -10662,9 +10666,9 @@ type status24 = 'published' | 'failed';
  */
 type syncStatus2 = 'synced' | 'pending' | 'unavailable';
 /**
- * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
+ * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. not_post_owner: the post is owned by another Page or user (collab or visitor post); its analytics cannot be read with this Page's token. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
  */
-type errorCode = 'post_not_found' | 'permission_missing';
+type errorCode = 'post_not_found' | 'not_post_owner' | 'permission_missing';
 type PlatformTarget = {
     /**
      * Supported values: twitter, threads, instagram, youtube, facebook, linkedin, pinterest, reddit, tiktok, bluesky, googlebusiness, telegram
@@ -44806,15 +44810,15 @@ type GetAdAccountFinanceError = (unknown | ErrorResponse);
 type GetAdAccountLiveEntitiesData = {
     query: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the platform token.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Meta ad account id (act_<n>) or TikTok advertiser id (digits).
          */
         adAccountId: string;
         /**
-         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level`.
+         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level` (and on TikTok the same `limit`).
          */
         after?: string;
         /**
@@ -44829,6 +44833,7 @@ type GetAdAccountLiveEntitiesData = {
          * Comma-separated Meta `effective_status` values to keep: ACTIVE, PAUSED, IN_PROCESS,
          * WITH_ISSUES, DELETED, ARCHIVED, and CAMPAIGN_PAUSED (ad sets only; the campaigns level
          * ignores it). Defaults to every status except DELETED and ARCHIVED. An unknown value is a 400.
+         * TikTok takes a single value: ACTIVE, PAUSED or DELETED (see the description).
          */
         status?: string;
     };
@@ -44836,13 +44841,13 @@ type GetAdAccountLiveEntitiesData = {
 type GetAdAccountLiveEntitiesResponse = ({
     accountId?: string;
     adAccountId?: string;
-    platform?: 'facebook';
+    platform?: 'facebook' | 'tiktok';
     /**
      * ISO 4217 code every budget and bid amount is expressed in.
      */
     currency?: string;
     /**
-     * When Meta was read.
+     * When the platform was read.
      */
     readAt?: string;
     /**
@@ -44852,11 +44857,11 @@ type GetAdAccountLiveEntitiesResponse = ({
         platformCampaignId?: string;
         campaignName?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, WITH_ISSUES.
+         * Meta `effective_status` (ACTIVE, PAUSED, WITH_ISSUES...) or TikTok `secondary_status` (CAMPAIGN_STATUS_ENABLE...).
          */
         platformCampaignStatus?: (string) | null;
         /**
-         * Meta `status`: the campaign's own switch (ACTIVE, PAUSED, DELETED, ARCHIVED).
+         * The campaign's own switch: Meta `status` (ACTIVE, PAUSED, DELETED, ARCHIVED), or TikTok `operation_status` as ACTIVE (ENABLE) / PAUSED (DISABLE).
          */
         configuredStatus?: (string) | null;
         /**
@@ -44871,23 +44876,27 @@ type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency` (Meta `daily_budget`; TikTok `budget` under a daily budget mode).
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency` (Meta `lifetime_budget`; TikTok `budget` under BUDGET_MODE_TOTAL).
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it (BUDGET_MODE_DAY, BUDGET_MODE_DYNAMIC_DAILY_BUDGET, BUDGET_MODE_TOTAL, BUDGET_MODE_INFINITE).
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set.
+         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set, and always on TikTok.
          */
         spendCap?: (number) | null;
         /**
-         * Meta `bid_strategy`, set on campaigns with a campaign budget.
+         * Meta `bid_strategy`, set on campaigns with a campaign budget. Null on TikTok.
          */
         bidStrategy?: (string) | null;
     }>;
@@ -44899,11 +44908,11 @@ type GetAdAccountLiveEntitiesResponse = ({
         adSetName?: (string) | null;
         platformCampaignId?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, CAMPAIGN_PAUSED.
+         * Meta `effective_status` (ACTIVE, PAUSED, CAMPAIGN_PAUSED...) or TikTok `secondary_status` (ADGROUP_STATUS_DELIVERY_OK, ADGROUP_STATUS_AUDIT...).
          */
         platformAdSetStatus?: (string) | null;
         /**
-         * Meta `status`: the ad set's own switch.
+         * The ad set's own switch: Meta `status`, or TikTok `operation_status` as ACTIVE / PAUSED.
          */
         configuredStatus?: (string) | null;
         /**
@@ -44918,41 +44927,45 @@ type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency`.
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency`.
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it.
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Meta `bid_strategy`.
+         * Meta `bid_strategy`. On TikTok the ad group's `bid_type` normalized to the same vocabulary (LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, LOWEST_COST_WITH_MIN_ROAS).
          */
         bidStrategy?: (string) | null;
         /**
-         * Meta `bid_amount` (bid cap or cost target) in whole units of `currency`. Null when the strategy has none.
+         * Bid cap or cost target in whole units of `currency` (Meta `bid_amount`; TikTok `bid_price`, else `conversion_bid_price`, else `deep_cpa_bid`). Null when the strategy has none.
          */
         bidAmount?: (number) | null;
         /**
-         * Meta `optimization_goal`.
+         * Meta or TikTok `optimization_goal`.
          */
         optimizationGoal?: (string) | null;
         /**
-         * Meta `billing_event`.
+         * Meta or TikTok `billing_event`.
          */
         billingEvent?: (string) | null;
         /**
-         * Meta `promoted_object` verbatim (snake_case).
+         * Meta `promoted_object` verbatim (snake_case). On TikTok `{ pixelId, customEventType, applicationId, customConversionId }` from `pixel_id`, `optimization_event`, `app_id` and `custom_conversion_id`, only the keys TikTok has set; null when none is.
          */
         promotedObject?: {
             [key: string]: unknown;
         } | null;
         /**
-         * Meta `targeting` verbatim (snake_case), as Meta returns it now.
+         * The platform's targeting verbatim (snake_case), as it reports it now: Meta `targeting`, or TikTok's ad group targeting fields (location_ids, age_groups, gender, languages, interest_category_ids, audience_ids, placements...).
          */
         targeting?: {
             [key: string]: unknown;

package/dist/index.d.ts

@@ -10652,9 +10652,13 @@ type PlatformAnalytics = {
      */
     errorMessage?: (string) | null;
     /**
-     * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
+     * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. not_post_owner: the post is owned by another Page or user (collab or visitor post); its analytics cannot be read with this Page's token. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
      */
-    errorCode?: ('post_not_found' | 'permission_missing') | null;
+    errorCode?: ('post_not_found' | 'not_post_owner' | 'permission_missing') | null;
+    /**
+     * Facebook only: true when the connected Page authored the post, false when Facebook reports another author (a collab post), null when unknown or for other platforms.
+     */
+    isOwner?: (boolean) | null;
 };
 type status24 = 'published' | 'failed';
 /**
@@ -10662,9 +10666,9 @@ type status24 = 'published' | 'failed';
  */
 type syncStatus2 = 'synced' | 'pending' | 'unavailable';
 /**
- * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
+ * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. not_post_owner: the post is owned by another Page or user (collab or visitor post); its analytics cannot be read with this Page's token. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
  */
-type errorCode = 'post_not_found' | 'permission_missing';
+type errorCode = 'post_not_found' | 'not_post_owner' | 'permission_missing';
 type PlatformTarget = {
     /**
      * Supported values: twitter, threads, instagram, youtube, facebook, linkedin, pinterest, reddit, tiktok, bluesky, googlebusiness, telegram
@@ -44806,15 +44810,15 @@ type GetAdAccountFinanceError = (unknown | ErrorResponse);
 type GetAdAccountLiveEntitiesData = {
     query: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the platform token.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Meta ad account id (act_<n>) or TikTok advertiser id (digits).
          */
         adAccountId: string;
         /**
-         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level`.
+         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level` (and on TikTok the same `limit`).
          */
         after?: string;
         /**
@@ -44829,6 +44833,7 @@ type GetAdAccountLiveEntitiesData = {
          * Comma-separated Meta `effective_status` values to keep: ACTIVE, PAUSED, IN_PROCESS,
          * WITH_ISSUES, DELETED, ARCHIVED, and CAMPAIGN_PAUSED (ad sets only; the campaigns level
          * ignores it). Defaults to every status except DELETED and ARCHIVED. An unknown value is a 400.
+         * TikTok takes a single value: ACTIVE, PAUSED or DELETED (see the description).
          */
         status?: string;
     };
@@ -44836,13 +44841,13 @@ type GetAdAccountLiveEntitiesData = {
 type GetAdAccountLiveEntitiesResponse = ({
     accountId?: string;
     adAccountId?: string;
-    platform?: 'facebook';
+    platform?: 'facebook' | 'tiktok';
     /**
      * ISO 4217 code every budget and bid amount is expressed in.
      */
     currency?: string;
     /**
-     * When Meta was read.
+     * When the platform was read.
      */
     readAt?: string;
     /**
@@ -44852,11 +44857,11 @@ type GetAdAccountLiveEntitiesResponse = ({
         platformCampaignId?: string;
         campaignName?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, WITH_ISSUES.
+         * Meta `effective_status` (ACTIVE, PAUSED, WITH_ISSUES...) or TikTok `secondary_status` (CAMPAIGN_STATUS_ENABLE...).
          */
         platformCampaignStatus?: (string) | null;
         /**
-         * Meta `status`: the campaign's own switch (ACTIVE, PAUSED, DELETED, ARCHIVED).
+         * The campaign's own switch: Meta `status` (ACTIVE, PAUSED, DELETED, ARCHIVED), or TikTok `operation_status` as ACTIVE (ENABLE) / PAUSED (DISABLE).
          */
         configuredStatus?: (string) | null;
         /**
@@ -44871,23 +44876,27 @@ type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency` (Meta `daily_budget`; TikTok `budget` under a daily budget mode).
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency` (Meta `lifetime_budget`; TikTok `budget` under BUDGET_MODE_TOTAL).
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it (BUDGET_MODE_DAY, BUDGET_MODE_DYNAMIC_DAILY_BUDGET, BUDGET_MODE_TOTAL, BUDGET_MODE_INFINITE).
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set.
+         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set, and always on TikTok.
          */
         spendCap?: (number) | null;
         /**
-         * Meta `bid_strategy`, set on campaigns with a campaign budget.
+         * Meta `bid_strategy`, set on campaigns with a campaign budget. Null on TikTok.
          */
         bidStrategy?: (string) | null;
     }>;
@@ -44899,11 +44908,11 @@ type GetAdAccountLiveEntitiesResponse = ({
         adSetName?: (string) | null;
         platformCampaignId?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, CAMPAIGN_PAUSED.
+         * Meta `effective_status` (ACTIVE, PAUSED, CAMPAIGN_PAUSED...) or TikTok `secondary_status` (ADGROUP_STATUS_DELIVERY_OK, ADGROUP_STATUS_AUDIT...).
          */
         platformAdSetStatus?: (string) | null;
         /**
-         * Meta `status`: the ad set's own switch.
+         * The ad set's own switch: Meta `status`, or TikTok `operation_status` as ACTIVE / PAUSED.
          */
         configuredStatus?: (string) | null;
         /**
@@ -44918,41 +44927,45 @@ type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency`.
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency`.
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it.
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Meta `bid_strategy`.
+         * Meta `bid_strategy`. On TikTok the ad group's `bid_type` normalized to the same vocabulary (LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, LOWEST_COST_WITH_MIN_ROAS).
          */
         bidStrategy?: (string) | null;
         /**
-         * Meta `bid_amount` (bid cap or cost target) in whole units of `currency`. Null when the strategy has none.
+         * Bid cap or cost target in whole units of `currency` (Meta `bid_amount`; TikTok `bid_price`, else `conversion_bid_price`, else `deep_cpa_bid`). Null when the strategy has none.
          */
         bidAmount?: (number) | null;
         /**
-         * Meta `optimization_goal`.
+         * Meta or TikTok `optimization_goal`.
          */
         optimizationGoal?: (string) | null;
         /**
-         * Meta `billing_event`.
+         * Meta or TikTok `billing_event`.
          */
         billingEvent?: (string) | null;
         /**
-         * Meta `promoted_object` verbatim (snake_case).
+         * Meta `promoted_object` verbatim (snake_case). On TikTok `{ pixelId, customEventType, applicationId, customConversionId }` from `pixel_id`, `optimization_event`, `app_id` and `custom_conversion_id`, only the keys TikTok has set; null when none is.
          */
         promotedObject?: {
             [key: string]: unknown;
         } | null;
         /**
-         * Meta `targeting` verbatim (snake_case), as Meta returns it now.
+         * The platform's targeting verbatim (snake_case), as it reports it now: Meta `targeting`, or TikTok's ad group targeting fields (location_ids, age_groups, gender, languages, interest_category_ids, audience_ids, placements...).
          */
         targeting?: {
             [key: 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.1112",
+  version: "0.2.1114",
   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.1112",
+  version: "0.2.1114",
   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.1112",
+  "version": "0.2.1114",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -11811,25 +11811,40 @@ export const getAdAccountFinance = <ThrowOnError extends boolean = false>(option
 
 /**
  * Read an ad account's campaigns and ad sets live
- * Reads the campaigns and ad sets of one Meta ad account **live from Meta**, in a single
- * Graph call per request (the account's `/campaigns` and `/adsets` edges, filtered by
- * `effective_status`), so it is cheap enough to run before every write: for example a
- * per-ad-account spend ceiling that must see the current `daily_budget` / `lifetime_budget`
- * rather than the synced copy.
+ * Reads the campaigns and ad sets of one Meta ad account or TikTok advertiser **live from
+ * the platform**, so it is cheap enough to run before every write: for example a
+ * per-ad-account spend ceiling that must see the current daily / lifetime budget rather
+ * than the synced copy. On Meta it is a single Graph call per request (the account's
+ * `/campaigns` and `/adsets` edges, filtered by `effective_status`); on TikTok one
+ * `campaign/get` and one `adgroup/get` page (TikTok ad groups are returned as `adSets`).
  *
  * **Live vs synced.** GET /v1/ads/campaigns and GET /v1/ads/ad-sets serve Zernio's synced
  * store, refreshed by background sync (typically 15 to 60 minutes behind Meta), and their
  * `live=true` re-reads only the on/off switches of at most 20 objects. This endpoint returns
  * what Meta reports at `readAt`, for every matching campaign and ad set, and stores nothing.
  *
- * Budgets and bid amounts are converted from Meta's minor units to whole units of
- * `currency`, the same units as the synced rows. A campaign with a campaign budget
- * (Advantage+ campaign budget) carries `budget` and its ad sets have `budget: null`;
- * otherwise each ad set carries its own.
+ * Budgets and bid amounts are in whole units of `currency`, the same units as the synced
+ * rows (Meta's minor units are converted; TikTok already reports whole units). A campaign
+ * with a campaign budget (Meta Advantage+ campaign budget, TikTok campaign budget
+ * optimization) carries `budget`; otherwise each ad set carries its own.
  *
  * Each level returns at most `limit` rows. When more match, `paging.<level>.after` is a
  * cursor: pass it back as `after` together with `level` to read the next page of that
- * level only. Other platforms answer 501 rather than serving synced data.
+ * level only. TikTok pages by number, so a TikTok cursor must be sent with the same
+ * `limit` that produced it (another `limit` is a 400). Other platforms answer 501 rather
+ * than serving synced data.
+ *
+ * **TikTok specifics.** `status` maps to TikTok's `primary_status` filter, which takes one
+ * value: ACTIVE = delivering (`STATUS_DELIVERY_OK`), PAUSED = switched off
+ * (`STATUS_DISABLE`), DELETED = `STATUS_DELETE`; omitted = every status except deleted
+ * (`STATUS_NOT_DELETE`, which includes enabled entities that are not delivering, such as
+ * an ad group in review). Several values, or IN_PROCESS, WITH_ISSUES, CAMPAIGN_PAUSED and
+ * ARCHIVED, are a 400. `budgetRemaining` and `spendCap` are always null (TikTok reports
+ * neither), campaign `bidStrategy` is null (TikTok bids per ad group), ad set `bidStrategy`
+ * is normalized to the Meta vocabulary like GET /v1/ads, `promotedObject` is
+ * `{ pixelId, customEventType, applicationId, customConversionId }` (the keys TikTok has
+ * set, as POST /v1/ads/create takes them), and `targeting` holds TikTok's targeting
+ * fields verbatim.
  */
 export const getAdAccountLiveEntities = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAdAccountLiveEntitiesData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetAdAccountLiveEntitiesResponse, GetAdAccountLiveEntitiesError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -9041,9 +9041,13 @@ export type PlatformAnalytics = {
      */
     errorMessage?: (string) | null;
     /**
-     * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
+     * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. not_post_owner: the post is owned by another Page or user (collab or visitor post); its analytics cannot be read with this Page's token. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
      */
-    errorCode?: ('post_not_found' | 'permission_missing') | null;
+    errorCode?: ('post_not_found' | 'not_post_owner' | 'permission_missing') | null;
+    /**
+     * Facebook only: true when the connected Page authored the post, false when Facebook reports another author (a collab post), null when unknown or for other platforms.
+     */
+    isOwner?: (boolean) | null;
 };
 
 export type status24 = 'published' | 'failed';
@@ -9054,9 +9058,9 @@ export type status24 = 'published' | 'failed';
 export type syncStatus2 = 'synced' | 'pending' | 'unavailable';
 
 /**
- * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
+ * Stable machine-readable reason for errorMessage. post_not_found: the post was deleted or is no longer visible to the account. not_post_owner: the post is owned by another Page or user (collab or visitor post); its analytics cannot be read with this Page's token. permission_missing: the last analytics sync of the Facebook account failed because the Page no longer grants pages_read_engagement (pending entries only). null: no stable code, read errorMessage. New values may be added.
  */
-export type errorCode = 'post_not_found' | 'permission_missing';
+export type errorCode = 'post_not_found' | 'not_post_owner' | 'permission_missing';
 
 export type PlatformTarget = {
     /**
@@ -45563,15 +45567,15 @@ export type GetAdAccountFinanceError = (unknown | ErrorResponse);
 export type GetAdAccountLiveEntitiesData = {
     query: {
         /**
-         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the platform token.
          */
         accountId: string;
         /**
-         * Meta ad account id (act_<n>).
+         * Meta ad account id (act_<n>) or TikTok advertiser id (digits).
          */
         adAccountId: string;
         /**
-         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level`.
+         * Cursor from `paging.campaigns.after` or `paging.adSets.after` of a previous response. Requires `level` (and on TikTok the same `limit`).
          */
         after?: string;
         /**
@@ -45586,6 +45590,7 @@ export type GetAdAccountLiveEntitiesData = {
          * Comma-separated Meta `effective_status` values to keep: ACTIVE, PAUSED, IN_PROCESS,
          * WITH_ISSUES, DELETED, ARCHIVED, and CAMPAIGN_PAUSED (ad sets only; the campaigns level
          * ignores it). Defaults to every status except DELETED and ARCHIVED. An unknown value is a 400.
+         * TikTok takes a single value: ACTIVE, PAUSED or DELETED (see the description).
          */
         status?: string;
     };
@@ -45594,13 +45599,13 @@ export type GetAdAccountLiveEntitiesData = {
 export type GetAdAccountLiveEntitiesResponse = ({
     accountId?: string;
     adAccountId?: string;
-    platform?: 'facebook';
+    platform?: 'facebook' | 'tiktok';
     /**
      * ISO 4217 code every budget and bid amount is expressed in.
      */
     currency?: string;
     /**
-     * When Meta was read.
+     * When the platform was read.
      */
     readAt?: string;
     /**
@@ -45610,11 +45615,11 @@ export type GetAdAccountLiveEntitiesResponse = ({
         platformCampaignId?: string;
         campaignName?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, WITH_ISSUES.
+         * Meta `effective_status` (ACTIVE, PAUSED, WITH_ISSUES...) or TikTok `secondary_status` (CAMPAIGN_STATUS_ENABLE...).
          */
         platformCampaignStatus?: (string) | null;
         /**
-         * Meta `status`: the campaign's own switch (ACTIVE, PAUSED, DELETED, ARCHIVED).
+         * The campaign's own switch: Meta `status` (ACTIVE, PAUSED, DELETED, ARCHIVED), or TikTok `operation_status` as ACTIVE (ENABLE) / PAUSED (DISABLE).
          */
         configuredStatus?: (string) | null;
         /**
@@ -45629,23 +45634,27 @@ export type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency` (Meta `daily_budget`; TikTok `budget` under a daily budget mode).
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency` (Meta `lifetime_budget`; TikTok `budget` under BUDGET_MODE_TOTAL).
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it (BUDGET_MODE_DAY, BUDGET_MODE_DYNAMIC_DAILY_BUDGET, BUDGET_MODE_TOTAL, BUDGET_MODE_INFINITE).
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the campaign has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set.
+         * Campaign spending limit (Meta `spend_cap`) in whole units of `currency`. Null when none is set, and always on TikTok.
          */
         spendCap?: (number) | null;
         /**
-         * Meta `bid_strategy`, set on campaigns with a campaign budget.
+         * Meta `bid_strategy`, set on campaigns with a campaign budget. Null on TikTok.
          */
         bidStrategy?: (string) | null;
     }>;
@@ -45657,11 +45666,11 @@ export type GetAdAccountLiveEntitiesResponse = ({
         adSetName?: (string) | null;
         platformCampaignId?: (string) | null;
         /**
-         * Meta `effective_status`, for example ACTIVE, PAUSED, CAMPAIGN_PAUSED.
+         * Meta `effective_status` (ACTIVE, PAUSED, CAMPAIGN_PAUSED...) or TikTok `secondary_status` (ADGROUP_STATUS_DELIVERY_OK, ADGROUP_STATUS_AUDIT...).
          */
         platformAdSetStatus?: (string) | null;
         /**
-         * Meta `status`: the ad set's own switch.
+         * The ad set's own switch: Meta `status`, or TikTok `operation_status` as ACTIVE / PAUSED.
          */
         configuredStatus?: (string) | null;
         /**
@@ -45676,41 +45685,45 @@ export type GetAdAccountLiveEntitiesResponse = ({
             type?: 'daily' | 'lifetime';
         } | null;
         /**
-         * Meta `daily_budget` in whole units of `currency`.
+         * Daily budget in whole units of `currency`.
          */
         dailyBudget?: (number) | null;
         /**
-         * Meta `lifetime_budget` in whole units of `currency`.
+         * Lifetime budget in whole units of `currency`.
          */
         lifetimeBudget?: (number) | null;
         /**
-         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own.
+         * TikTok only: `budget_mode` as TikTok reports it.
+         */
+        budgetMode?: (string) | null;
+        /**
+         * Meta `budget_remaining` in whole units of `currency`. Null when the ad set has no budget of its own, and always on TikTok.
          */
         budgetRemaining?: (number) | null;
         /**
-         * Meta `bid_strategy`.
+         * Meta `bid_strategy`. On TikTok the ad group's `bid_type` normalized to the same vocabulary (LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, LOWEST_COST_WITH_MIN_ROAS).
          */
         bidStrategy?: (string) | null;
         /**
-         * Meta `bid_amount` (bid cap or cost target) in whole units of `currency`. Null when the strategy has none.
+         * Bid cap or cost target in whole units of `currency` (Meta `bid_amount`; TikTok `bid_price`, else `conversion_bid_price`, else `deep_cpa_bid`). Null when the strategy has none.
          */
         bidAmount?: (number) | null;
         /**
-         * Meta `optimization_goal`.
+         * Meta or TikTok `optimization_goal`.
          */
         optimizationGoal?: (string) | null;
         /**
-         * Meta `billing_event`.
+         * Meta or TikTok `billing_event`.
          */
         billingEvent?: (string) | null;
         /**
-         * Meta `promoted_object` verbatim (snake_case).
+         * Meta `promoted_object` verbatim (snake_case). On TikTok `{ pixelId, customEventType, applicationId, customConversionId }` from `pixel_id`, `optimization_event`, `app_id` and `custom_conversion_id`, only the keys TikTok has set; null when none is.
          */
         promotedObject?: {
             [key: string]: unknown;
         } | null;
         /**
-         * Meta `targeting` verbatim (snake_case), as Meta returns it now.
+         * The platform's targeting verbatim (snake_case), as it reports it now: Meta `targeting`, or TikTok's ad group targeting fields (location_ids, age_groups, gender, languages, interest_category_ids, audience_ids, placements...).
          */
         targeting?: {
             [key: string]: unknown;