@getlatedev/node 0.2.1379 → 0.2.1381

package/dist/index.d.mts

@@ -4253,6 +4253,27 @@ type AdTreeAdSet = {
         pixel_id?: string;
         page_id?: string;
     } | null;
+    /**
+     * Meta only. Where the ad set sends people (Meta `destination_type`), e.g. WEBSITE, MESSENGER, WHATSAPP, INSTAGRAM_DIRECT, ON_AD. Meta answers UNDEFINED for an ad set with no explicit destination. As of the last sync; null on other platforms and for ad sets not yet synced.
+     */
+    destinationType?: (string) | null;
+    /**
+     * Meta only. The ad set's conversion attribution windows (Meta `attribution_spec`), in the same shape `attributionSpec` takes on ad creation so a clone can send it back unchanged. As of the last sync; null on other platforms, for ad sets not yet synced and when Meta reports none.
+     */
+    attributionSpec?: Array<{
+        eventType?: 'CLICK_THROUGH' | 'VIEW_THROUGH' | 'ENGAGED_VIDEO_VIEW';
+        windowDays?: 1 | 7 | 28;
+    }> | null;
+    /**
+     * Meta only. Regional regulated categories declared on the ad set (Meta `regional_regulated_categories`), e.g. AUSTRALIA_FINSERV, TAIWAN_UNIVERSAL, SINGAPORE_UNIVERSAL or VOLUNTARY_VERIFICATION. As of the last sync; null on other platforms, for ad sets not yet synced and when Meta reports none.
+     */
+    regionalRegulatedCategories?: Array<(string)> | null;
+    /**
+     * Meta only. Verified identity IDs per regional regulation role (Meta `regional_regulation_identities`), keyed by Meta's role name. IDs are strings because they can exceed a JSON number's precision. As of the last sync; null on other platforms, for ad sets not yet synced and when Meta reports none.
+     */
+    regionalRegulationIdentities?: {
+        [key: string]: (string);
+    } | null;
     /**
      * Individual ads within this ad set (capped at 100). When the ad set has more than 100 ads these are the 100 highest-spending over the requested date range, so this array depends on `fromDate`/`toDate`; `adCount` is always the true ad set size. Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
      */
@@ -49046,9 +49067,21 @@ type DuplicateAdCampaignResponse = ({
      * Platform ID of the new campaign
      */
     copiedCampaignId?: string;
+    /**
+     * Meta only: source ad set ID to copied ad set ID. Empty when `deepCopy` is false.
+     */
+    adSetIdMap?: {
+        [key: string]: (string);
+    };
+    /**
+     * Meta only: source ad ID to copied ad ID, across every copied ad set. Empty when `deepCopy` is false.
+     */
+    adIdMap?: {
+        [key: string]: (string);
+    };
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
-     * Platform-native response from the copy endpoint (Meta includes ad_object_ids for child copies)
+     * Platform-native response from the copy (TikTok and LinkedIn). Absent on Meta, which returns `adSetIdMap` and `adIdMap` instead.
      */
     raw?: {
         [key: string]: unknown;
@@ -49599,9 +49632,19 @@ type DuplicateAdSetResponse = ({
      * Platform ID of the new ad set
      */
     copiedAdSetId?: string;
+    /**
+     * Platform IDs of the copied ads
+     */
+    copiedAdIds?: Array<(string)>;
+    /**
+     * Meta only: source ad ID to copied ad ID. Empty when `deepCopy` is false.
+     */
+    adIdMap?: {
+        [key: string]: (string);
+    };
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
-     * Meta's native copy response (includes ad_object_ids for child copies)
+     * Platform-native response from the copy (TikTok). Absent on Meta, which returns `adIdMap` instead.
      */
     raw?: {
         [key: string]: unknown;

package/dist/index.d.ts

@@ -4253,6 +4253,27 @@ type AdTreeAdSet = {
         pixel_id?: string;
         page_id?: string;
     } | null;
+    /**
+     * Meta only. Where the ad set sends people (Meta `destination_type`), e.g. WEBSITE, MESSENGER, WHATSAPP, INSTAGRAM_DIRECT, ON_AD. Meta answers UNDEFINED for an ad set with no explicit destination. As of the last sync; null on other platforms and for ad sets not yet synced.
+     */
+    destinationType?: (string) | null;
+    /**
+     * Meta only. The ad set's conversion attribution windows (Meta `attribution_spec`), in the same shape `attributionSpec` takes on ad creation so a clone can send it back unchanged. As of the last sync; null on other platforms, for ad sets not yet synced and when Meta reports none.
+     */
+    attributionSpec?: Array<{
+        eventType?: 'CLICK_THROUGH' | 'VIEW_THROUGH' | 'ENGAGED_VIDEO_VIEW';
+        windowDays?: 1 | 7 | 28;
+    }> | null;
+    /**
+     * Meta only. Regional regulated categories declared on the ad set (Meta `regional_regulated_categories`), e.g. AUSTRALIA_FINSERV, TAIWAN_UNIVERSAL, SINGAPORE_UNIVERSAL or VOLUNTARY_VERIFICATION. As of the last sync; null on other platforms, for ad sets not yet synced and when Meta reports none.
+     */
+    regionalRegulatedCategories?: Array<(string)> | null;
+    /**
+     * Meta only. Verified identity IDs per regional regulation role (Meta `regional_regulation_identities`), keyed by Meta's role name. IDs are strings because they can exceed a JSON number's precision. As of the last sync; null on other platforms, for ad sets not yet synced and when Meta reports none.
+     */
+    regionalRegulationIdentities?: {
+        [key: string]: (string);
+    } | null;
     /**
      * Individual ads within this ad set (capped at 100). When the ad set has more than 100 ads these are the 100 highest-spending over the requested date range, so this array depends on `fromDate`/`toDate`; `adCount` is always the true ad set size. Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
      */
@@ -49046,9 +49067,21 @@ type DuplicateAdCampaignResponse = ({
      * Platform ID of the new campaign
      */
     copiedCampaignId?: string;
+    /**
+     * Meta only: source ad set ID to copied ad set ID. Empty when `deepCopy` is false.
+     */
+    adSetIdMap?: {
+        [key: string]: (string);
+    };
+    /**
+     * Meta only: source ad ID to copied ad ID, across every copied ad set. Empty when `deepCopy` is false.
+     */
+    adIdMap?: {
+        [key: string]: (string);
+    };
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
-     * Platform-native response from the copy endpoint (Meta includes ad_object_ids for child copies)
+     * Platform-native response from the copy (TikTok and LinkedIn). Absent on Meta, which returns `adSetIdMap` and `adIdMap` instead.
      */
     raw?: {
         [key: string]: unknown;
@@ -49599,9 +49632,19 @@ type DuplicateAdSetResponse = ({
      * Platform ID of the new ad set
      */
     copiedAdSetId?: string;
+    /**
+     * Platform IDs of the copied ads
+     */
+    copiedAdIds?: Array<(string)>;
+    /**
+     * Meta only: source ad ID to copied ad ID. Empty when `deepCopy` is false.
+     */
+    adIdMap?: {
+        [key: string]: (string);
+    };
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
-     * Meta's native copy response (includes ad_object_ids for child copies)
+     * Platform-native response from the copy (TikTok). Absent on Meta, which returns `adIdMap` instead.
      */
     raw?: {
         [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.1379",
+  version: "0.2.1381",
   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.1379",
+  version: "0.2.1381",
   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.1379",
+  "version": "0.2.1381",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -11783,7 +11783,14 @@ export const bulkUpdateAdCampaignStatus = <ThrowOnError extends boolean = false>
  * so callers can review before launching.
  *
  * Per-platform implementation:
- * - **Meta** uses the native `POST /{campaign-id}/copies` endpoint.
+ * - **Meta** copies one level at a time with Meta's `/copies` endpoint:
+ * the campaign, then each of its ad sets (DELETED and ARCHIVED ones
+ * are skipped), then each ad of every ad set, so a campaign of any
+ * size copies (Meta refuses a single deep copy of 3 or more objects).
+ * `statusOption` applies at every level. If any child copy fails,
+ * the partial copy is deleted and the request fails with Meta's error,
+ * so a retry starts clean. Each copied object takes a few seconds,
+ * so a large campaign takes minutes to answer.
  * - **TikTok** has no native copy primitive; Zernio walks the source
  * graph (`/v2/campaign/get/`, `/v2/adgroup/get/`, `/v2/ad/get/`) and
  * recreates each entity via the corresponding `/create/` endpoints,
@@ -12009,9 +12016,12 @@ export const createAdSet = <ThrowOnError extends boolean = false>(options: Optio
  * The copy is created paused so callers can review before launching.
  * `campaignId` retargets the copy into another campaign; omitted = the source's own campaign.
  *
- * Meta: ads and creatives are included by default (`deepCopy: true`) via Meta's native
- * `POST /{adset-id}/copies`; the new hierarchy materializes asynchronously and sync discovery
- * is triggered automatically (`syncAfter: false` to skip).
+ * Meta: ads and creatives are included by default (`deepCopy: true`). The ad set is copied
+ * with Meta's `/copies` endpoint, then each of its ads (DELETED and ARCHIVED ones are skipped)
+ * into the new ad set, 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).
  *
  * 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

package/src/generated/types.gen.ts

@@ -2078,6 +2078,27 @@ export type AdTreeAdSet = {
         pixel_id?: string;
         page_id?: string;
     } | null;
+    /**
+     * Meta only. Where the ad set sends people (Meta `destination_type`), e.g. WEBSITE, MESSENGER, WHATSAPP, INSTAGRAM_DIRECT, ON_AD. Meta answers UNDEFINED for an ad set with no explicit destination. As of the last sync; null on other platforms and for ad sets not yet synced.
+     */
+    destinationType?: (string) | null;
+    /**
+     * Meta only. The ad set's conversion attribution windows (Meta `attribution_spec`), in the same shape `attributionSpec` takes on ad creation so a clone can send it back unchanged. As of the last sync; null on other platforms, for ad sets not yet synced and when Meta reports none.
+     */
+    attributionSpec?: Array<{
+        eventType?: 'CLICK_THROUGH' | 'VIEW_THROUGH' | 'ENGAGED_VIDEO_VIEW';
+        windowDays?: 1 | 7 | 28;
+    }> | null;
+    /**
+     * Meta only. Regional regulated categories declared on the ad set (Meta `regional_regulated_categories`), e.g. AUSTRALIA_FINSERV, TAIWAN_UNIVERSAL, SINGAPORE_UNIVERSAL or VOLUNTARY_VERIFICATION. As of the last sync; null on other platforms, for ad sets not yet synced and when Meta reports none.
+     */
+    regionalRegulatedCategories?: Array<(string)> | null;
+    /**
+     * Meta only. Verified identity IDs per regional regulation role (Meta `regional_regulation_identities`), keyed by Meta's role name. IDs are strings because they can exceed a JSON number's precision. As of the last sync; null on other platforms, for ad sets not yet synced and when Meta reports none.
+     */
+    regionalRegulationIdentities?: {
+        [key: string]: (string);
+    } | null;
     /**
      * Individual ads within this ad set (capped at 100). When the ad set has more than 100 ads these are the 100 highest-spending over the requested date range, so this array depends on `fromDate`/`toDate`; `adCount` is always the true ad set size. Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
      */
@@ -49815,9 +49836,21 @@ export type DuplicateAdCampaignResponse = ({
      * Platform ID of the new campaign
      */
     copiedCampaignId?: string;
+    /**
+     * Meta only: source ad set ID to copied ad set ID. Empty when `deepCopy` is false.
+     */
+    adSetIdMap?: {
+        [key: string]: (string);
+    };
+    /**
+     * Meta only: source ad ID to copied ad ID, across every copied ad set. Empty when `deepCopy` is false.
+     */
+    adIdMap?: {
+        [key: string]: (string);
+    };
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
-     * Platform-native response from the copy endpoint (Meta includes ad_object_ids for child copies)
+     * Platform-native response from the copy (TikTok and LinkedIn). Absent on Meta, which returns `adSetIdMap` and `adIdMap` instead.
      */
     raw?: {
         [key: string]: unknown;
@@ -50383,9 +50416,19 @@ export type DuplicateAdSetResponse = ({
      * Platform ID of the new ad set
      */
     copiedAdSetId?: string;
+    /**
+     * Platform IDs of the copied ads
+     */
+    copiedAdIds?: Array<(string)>;
+    /**
+     * Meta only: source ad ID to copied ad ID. Empty when `deepCopy` is false.
+     */
+    adIdMap?: {
+        [key: string]: (string);
+    };
     discovery?: 'triggered' | 'skipped' | 'failed';
     /**
-     * Meta's native copy response (includes ad_object_ids for child copies)
+     * Platform-native response from the copy (TikTok). Absent on Meta, which returns `adIdMap` instead.
      */
     raw?: {
         [key: string]: unknown;