@zernio/node 0.2.554 → 0.2.555

package/dist/index.d.mts

@@ -1790,20 +1790,24 @@ type AdDailyMetrics = AdMetrics & {
  * Use these fields when you need a specific interaction, and `engagement`
  * only as the coarse total it has always been.
  *
- * Meta-only; other platforms leave these at 0.
+ * Populated for Meta and, since 2026-08, TikTok (`reactions` = paid
+ * likes, `comments`, `shares`; TikTok's `follow` count lives in
+ * `actions.follow`, not here). Other platforms leave these at 0.
+ * TikTok history note: paused TikTok ads are not re-synced, so
+ * campaigns that ended before the rollout keep 0s here.
  *
  */
 type AdEngagementCounts = {
     /**
-     * Meta's own post-engagement total (`post_engagement`).
+     * Meta's own post-engagement total (`post_engagement`). Meta-only.
      */
     postEngagement?: number;
     /**
-     * Meta's own page-engagement total (`page_engagement`).
+     * Meta's own page-engagement total (`page_engagement`). Meta-only.
      */
     pageEngagement?: number;
     /**
-     * Reactions on the ad's post (`post_reaction`).
+     * Reactions on the ad's post (`post_reaction`). For TikTok these are its paid likes.
      */
     reactions?: number;
     /**
@@ -1811,7 +1815,7 @@ type AdEngagementCounts = {
      */
     comments?: number;
     /**
-     * Shares of the ad's post. Meta reports these under the action type literally named `post`.
+     * Shares of the ad's post. Meta reports these under the action type literally named `post`; TikTok under `share`.
      */
     shares?: number;
     /**
@@ -1933,7 +1937,7 @@ type AdMetrics = {
      */
     costPerConversion?: number;
     /**
-     * Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them.
+     * Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share) — follow is how FOLLOWERS-goal campaigns report their result. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them.
      */
     actions?: {
         [key: string]: (number);

package/dist/index.d.ts

@@ -1790,20 +1790,24 @@ type AdDailyMetrics = AdMetrics & {
  * Use these fields when you need a specific interaction, and `engagement`
  * only as the coarse total it has always been.
  *
- * Meta-only; other platforms leave these at 0.
+ * Populated for Meta and, since 2026-08, TikTok (`reactions` = paid
+ * likes, `comments`, `shares`; TikTok's `follow` count lives in
+ * `actions.follow`, not here). Other platforms leave these at 0.
+ * TikTok history note: paused TikTok ads are not re-synced, so
+ * campaigns that ended before the rollout keep 0s here.
  *
  */
 type AdEngagementCounts = {
     /**
-     * Meta's own post-engagement total (`post_engagement`).
+     * Meta's own post-engagement total (`post_engagement`). Meta-only.
      */
     postEngagement?: number;
     /**
-     * Meta's own page-engagement total (`page_engagement`).
+     * Meta's own page-engagement total (`page_engagement`). Meta-only.
      */
     pageEngagement?: number;
     /**
-     * Reactions on the ad's post (`post_reaction`).
+     * Reactions on the ad's post (`post_reaction`). For TikTok these are its paid likes.
      */
     reactions?: number;
     /**
@@ -1811,7 +1815,7 @@ type AdEngagementCounts = {
      */
     comments?: number;
     /**
-     * Shares of the ad's post. Meta reports these under the action type literally named `post`.
+     * Shares of the ad's post. Meta reports these under the action type literally named `post`; TikTok under `share`.
      */
     shares?: number;
     /**
@@ -1933,7 +1937,7 @@ type AdMetrics = {
      */
     costPerConversion?: number;
     /**
-     * Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them.
+     * Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share) — follow is how FOLLOWERS-goal campaigns report their result. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them.
      */
     actions?: {
         [key: string]: (number);

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -538,20 +538,24 @@ export type AdDailyMetrics = AdMetrics & {
  * Use these fields when you need a specific interaction, and `engagement`
  * only as the coarse total it has always been.
  *
- * Meta-only; other platforms leave these at 0.
+ * Populated for Meta and, since 2026-08, TikTok (`reactions` = paid
+ * likes, `comments`, `shares`; TikTok's `follow` count lives in
+ * `actions.follow`, not here). Other platforms leave these at 0.
+ * TikTok history note: paused TikTok ads are not re-synced, so
+ * campaigns that ended before the rollout keep 0s here.
  *
  */
 export type AdEngagementCounts = {
     /**
-     * Meta's own post-engagement total (`post_engagement`).
+     * Meta's own post-engagement total (`post_engagement`). Meta-only.
      */
     postEngagement?: number;
     /**
-     * Meta's own page-engagement total (`page_engagement`).
+     * Meta's own page-engagement total (`page_engagement`). Meta-only.
      */
     pageEngagement?: number;
     /**
-     * Reactions on the ad's post (`post_reaction`).
+     * Reactions on the ad's post (`post_reaction`). For TikTok these are its paid likes.
      */
     reactions?: number;
     /**
@@ -559,7 +563,7 @@ export type AdEngagementCounts = {
      */
     comments?: number;
     /**
-     * Shares of the ad's post. Meta reports these under the action type literally named `post`.
+     * Shares of the ad's post. Meta reports these under the action type literally named `post`; TikTok under `share`.
      */
     shares?: number;
     /**
@@ -683,7 +687,7 @@ export type AdMetrics = {
      */
     costPerConversion?: number;
     /**
-     * Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them.
+     * Per-action-type counts summed over the date range, keyed by the platform's action-type names. Meta: raw Insights action_type keys (link_click, offsite_conversion.fb_pixel_purchase, onsite_conversion.lead_grouped, ...) — both engagement and conversion events. TikTok: pixel conversions (purchase, add_to_cart, initiate_checkout, view_content, complete_payment, lead) plus the paid-engagement family (follow, post_reaction for paid likes, comment, share) — follow is how FOLLOWERS-goal campaigns report their result. X: conversion types (purchase, sign_up, site_visit, download, custom). LinkedIn: conversion types (post_click, post_view, lead_gen). Google returns {} (its per-action names aren't synced per ad). Empty object when no actions are reported. NOTE: keys differ by platform, so branch on the ad's platform when interpreting them.
      */
     actions?: {
         [key: string]: (number);