@zernio/node 0.2.1487 → 0.2.1489

package/dist/index.d.mts

@@ -52189,6 +52189,13 @@ type DuplicateAdCampaignResponse = ({
     adIdMap?: {
         [key: string]: (string);
     };
+    /**
+     * The copy exists on the platform in all three cases.
+     *
+     * - `triggered`: an ads sync started and runs after this response, so the copy may not be readable through Zernio yet.
+     * - `skipped`: no sync started, so the copy appears on a later scheduled sync.
+     * - `failed`: the sync could not start. A sync that errors after the response is not reported here.
+     */
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
      * Platform-native response from the copy (TikTok and LinkedIn). Absent on Meta, which returns `adSetIdMap` and `adIdMap` instead.
@@ -52791,6 +52798,13 @@ type DuplicateAdSetResponse = ({
     adIdMap?: {
         [key: string]: (string);
     };
+    /**
+     * The copy exists on the platform in all three cases.
+     *
+     * - `triggered`: an ads sync started and runs after this response, so the copy may not be readable through Zernio yet.
+     * - `skipped`: no sync started, so the copy appears on a later scheduled sync.
+     * - `failed`: the sync could not start. A sync that errors after the response is not reported here.
+     */
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
      * Platform-native response from the copy (TikTok). Absent on Meta, which returns `adIdMap` instead.
@@ -52855,6 +52869,13 @@ type DuplicateAdResponse = ({
      * Platform ID of the new ad
      */
     copiedAdId?: string;
+    /**
+     * The copy exists on the platform in all three cases.
+     *
+     * - `triggered`: an ads sync started and runs after this response, so the copy may not be readable through Zernio yet.
+     * - `skipped`: no sync started, so the copy appears on a later scheduled sync.
+     * - `failed`: the sync could not start. A sync that errors after the response is not reported here.
+     */
     discovery?: 'triggered' | 'skipped' | 'failed';
     raw?: {
         [key: string]: unknown;
@@ -58788,7 +58809,7 @@ type BoostPostData = {
          * - New campaign: held paused with its ad set and ad on. One PUT /v1/ads/campaigns/{campaignId}/status with `active` brings it live.
          * - Into an existing campaign (TikTok `existingCampaignId`): the new ad set is held paused.
          * - Attached to an existing ad set (`adSetId`): the new ad itself is paused.
-         * - LinkedIn: the held campaign group is PAUSED, its campaign and creative ACTIVE.
+         * - LinkedIn: every object the boost creates is held. A new campaign group is PAUSED, and its campaign and creative stay DRAFT. Resume each held object top-down to go live.
          * - X: has no per-ad switch, so its lowest level is the line item.
          *
          * `campaignStatus`, `adSetStatus` and `adStatus` set one level each and always win for that level. `status: PAUSED` adds a hold of its own only when none of them is PAUSED. To create every object paused, send all three as PAUSED.
@@ -59359,7 +59380,7 @@ type CreateStandaloneAdData = {
          *
          * **Platform notes:**
          *
-         * - LinkedIn: a held campaign group is PAUSED with its campaign and creative ACTIVE. A new campaign in an existing group stays DRAFT. A held creative (with `adSetId`) is created DRAFT, as LinkedIn refuses PAUSED until its review is APPROVED.
+         * - LinkedIn: every object the call creates is held. A new campaign group is PAUSED. A new campaign or creative stays DRAFT, as LinkedIn refuses PAUSED on a creative until its review is APPROVED. Resume each held object top-down to go live.
          * - X: no per-ad switch, so its lowest level is the line item.
          * - Google Performance Max and Demand Gen: accept PAUSED only (the campaign is created paused).
          *

package/dist/index.d.ts

@@ -52189,6 +52189,13 @@ type DuplicateAdCampaignResponse = ({
     adIdMap?: {
         [key: string]: (string);
     };
+    /**
+     * The copy exists on the platform in all three cases.
+     *
+     * - `triggered`: an ads sync started and runs after this response, so the copy may not be readable through Zernio yet.
+     * - `skipped`: no sync started, so the copy appears on a later scheduled sync.
+     * - `failed`: the sync could not start. A sync that errors after the response is not reported here.
+     */
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
      * Platform-native response from the copy (TikTok and LinkedIn). Absent on Meta, which returns `adSetIdMap` and `adIdMap` instead.
@@ -52791,6 +52798,13 @@ type DuplicateAdSetResponse = ({
     adIdMap?: {
         [key: string]: (string);
     };
+    /**
+     * The copy exists on the platform in all three cases.
+     *
+     * - `triggered`: an ads sync started and runs after this response, so the copy may not be readable through Zernio yet.
+     * - `skipped`: no sync started, so the copy appears on a later scheduled sync.
+     * - `failed`: the sync could not start. A sync that errors after the response is not reported here.
+     */
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
      * Platform-native response from the copy (TikTok). Absent on Meta, which returns `adIdMap` instead.
@@ -52855,6 +52869,13 @@ type DuplicateAdResponse = ({
      * Platform ID of the new ad
      */
     copiedAdId?: string;
+    /**
+     * The copy exists on the platform in all three cases.
+     *
+     * - `triggered`: an ads sync started and runs after this response, so the copy may not be readable through Zernio yet.
+     * - `skipped`: no sync started, so the copy appears on a later scheduled sync.
+     * - `failed`: the sync could not start. A sync that errors after the response is not reported here.
+     */
     discovery?: 'triggered' | 'skipped' | 'failed';
     raw?: {
         [key: string]: unknown;
@@ -58788,7 +58809,7 @@ type BoostPostData = {
          * - New campaign: held paused with its ad set and ad on. One PUT /v1/ads/campaigns/{campaignId}/status with `active` brings it live.
          * - Into an existing campaign (TikTok `existingCampaignId`): the new ad set is held paused.
          * - Attached to an existing ad set (`adSetId`): the new ad itself is paused.
-         * - LinkedIn: the held campaign group is PAUSED, its campaign and creative ACTIVE.
+         * - LinkedIn: every object the boost creates is held. A new campaign group is PAUSED, and its campaign and creative stay DRAFT. Resume each held object top-down to go live.
          * - X: has no per-ad switch, so its lowest level is the line item.
          *
          * `campaignStatus`, `adSetStatus` and `adStatus` set one level each and always win for that level. `status: PAUSED` adds a hold of its own only when none of them is PAUSED. To create every object paused, send all three as PAUSED.
@@ -59359,7 +59380,7 @@ type CreateStandaloneAdData = {
          *
          * **Platform notes:**
          *
-         * - LinkedIn: a held campaign group is PAUSED with its campaign and creative ACTIVE. A new campaign in an existing group stays DRAFT. A held creative (with `adSetId`) is created DRAFT, as LinkedIn refuses PAUSED until its review is APPROVED.
+         * - LinkedIn: every object the call creates is held. A new campaign group is PAUSED. A new campaign or creative stays DRAFT, as LinkedIn refuses PAUSED on a creative until its review is APPROVED. Resume each held object top-down to go live.
          * - X: no per-ad switch, so its lowest level is the line item.
          * - Google Performance Max and Demand Gen: accept PAUSED only (the campaign is created paused).
          *

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -13115,7 +13115,9 @@ export const bulkUpdateAdCampaignStatus = <ThrowOnError extends boolean = false>
  *
  * ### Sync
  *
- * The new hierarchy is asynchronous to materialize in our DB, and we trigger sync discovery automatically. Set `syncAfter: false` to skip and poll `/v1/ads/tree` on your own cadence.
+ * The copy exists on the platform when this call returns. The new hierarchy reaches our DB through a sync discovery that starts automatically and runs after the response, usually within a few minutes.
+ *
+ * Poll `/v1/ads/tree` until it appears; until then, calls that take a copied id return 404, so retry them. Set `syncAfter: false` to skip the sync; the copy then appears on a later scheduled sync.
  *
  */
 export const duplicateAdCampaign = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DuplicateAdCampaignData, ThrowOnError>) => {
@@ -13319,7 +13321,7 @@ export const createAdSet = <ThrowOnError extends boolean = false>(options: Optio
  * - So an ad set with any number of ads copies: Meta refuses a single deep copy of 3 or more objects.
  * - `statusOption` applies to the ad set and every ad.
  * - If an ad copy fails, the partial ad set copy is deleted and the request fails with Meta's error.
- * - Sync discovery is triggered automatically (`syncAfter: false` to skip).
+ * - A sync discovery starts automatically and runs after the response (`syncAfter: false` to skip). The copy is readable through Zernio once it finishes, usually within a few minutes. Until then, calls that take a copied id return 404, so retry them.
  *
  * TikTok: the ad group is read and recreated under the campaign with its targeting, bidding,
  * budget and schedule (start reset to now); `deepCopy: true` recreates its ads too (default
@@ -13342,7 +13344,7 @@ export const duplicateAdSet = <ThrowOnError extends boolean = false>(options: Op
  *
  * - `adSetId` retargets the copy into another ad set; omitted = the source's own ad set.
  * - Accepts the Zernio ad id or the platform ad id.
- * - Sync discovery is triggered automatically (`syncAfter: false` to skip).
+ * - A sync discovery starts automatically and runs after the response (`syncAfter: false` to skip). The copy is readable through Zernio once it finishes, usually within a few minutes. Until then, calls that take a copied id return 404, so retry them.
  *
  * ### Creative settings
  *

package/src/generated/types.gen.ts

@@ -53013,6 +53013,13 @@ export type DuplicateAdCampaignResponse = ({
     adIdMap?: {
         [key: string]: (string);
     };
+    /**
+     * The copy exists on the platform in all three cases.
+     *
+     * - `triggered`: an ads sync started and runs after this response, so the copy may not be readable through Zernio yet.
+     * - `skipped`: no sync started, so the copy appears on a later scheduled sync.
+     * - `failed`: the sync could not start. A sync that errors after the response is not reported here.
+     */
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
      * Platform-native response from the copy (TikTok and LinkedIn). Absent on Meta, which returns `adSetIdMap` and `adIdMap` instead.
@@ -53630,6 +53637,13 @@ export type DuplicateAdSetResponse = ({
     adIdMap?: {
         [key: string]: (string);
     };
+    /**
+     * The copy exists on the platform in all three cases.
+     *
+     * - `triggered`: an ads sync started and runs after this response, so the copy may not be readable through Zernio yet.
+     * - `skipped`: no sync started, so the copy appears on a later scheduled sync.
+     * - `failed`: the sync could not start. A sync that errors after the response is not reported here.
+     */
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
      * Platform-native response from the copy (TikTok). Absent on Meta, which returns `adIdMap` instead.
@@ -53697,6 +53711,13 @@ export type DuplicateAdResponse = ({
      * Platform ID of the new ad
      */
     copiedAdId?: string;
+    /**
+     * The copy exists on the platform in all three cases.
+     *
+     * - `triggered`: an ads sync started and runs after this response, so the copy may not be readable through Zernio yet.
+     * - `skipped`: no sync started, so the copy appears on a later scheduled sync.
+     * - `failed`: the sync could not start. A sync that errors after the response is not reported here.
+     */
     discovery?: 'triggered' | 'skipped' | 'failed';
     raw?: {
         [key: string]: unknown;
@@ -59986,7 +60007,7 @@ export type BoostPostData = {
          * - New campaign: held paused with its ad set and ad on. One PUT /v1/ads/campaigns/{campaignId}/status with `active` brings it live.
          * - Into an existing campaign (TikTok `existingCampaignId`): the new ad set is held paused.
          * - Attached to an existing ad set (`adSetId`): the new ad itself is paused.
-         * - LinkedIn: the held campaign group is PAUSED, its campaign and creative ACTIVE.
+         * - LinkedIn: every object the boost creates is held. A new campaign group is PAUSED, and its campaign and creative stay DRAFT. Resume each held object top-down to go live.
          * - X: has no per-ad switch, so its lowest level is the line item.
          *
          * `campaignStatus`, `adSetStatus` and `adStatus` set one level each and always win for that level. `status: PAUSED` adds a hold of its own only when none of them is PAUSED. To create every object paused, send all three as PAUSED.
@@ -60581,7 +60602,7 @@ export type CreateStandaloneAdData = {
          *
          * **Platform notes:**
          *
-         * - LinkedIn: a held campaign group is PAUSED with its campaign and creative ACTIVE. A new campaign in an existing group stays DRAFT. A held creative (with `adSetId`) is created DRAFT, as LinkedIn refuses PAUSED until its review is APPROVED.
+         * - LinkedIn: every object the call creates is held. A new campaign group is PAUSED. A new campaign or creative stays DRAFT, as LinkedIn refuses PAUSED on a creative until its review is APPROVED. Resume each held object top-down to go live.
          * - X: no per-ad switch, so its lowest level is the line item.
          * - Google Performance Max and Demand Gen: accept PAUSED only (the campaign is created paused).
          *