@zernio/node 0.2.208 → 0.2.210

package/dist/index.d.mts

@@ -992,6 +992,15 @@ type Ad = {
         pinterestTitle?: string;
         pinterestDescription?: string;
     } | null;
+    /**
+     * The ad set's targeting (age, gender, geo, interests, placements, audience inclusions/exclusions).
+     * For ads created through Zernio this is the spec you supplied. For external ads (synced from
+     * Meta Ads Manager, `isExternal: true`) targeting lives at the ad set and isn't stored at ingest,
+     * so on the first `GET /v1/ads/{adId}` Zernio resolves it live from Meta and caches it on the ad;
+     * the value is then Meta's raw `targeting` shape (snake_case, e.g. `geo_locations`, `age_min`),
+     * the same object Ads Manager shows. May be absent if the ad set exposes no targeting or the lookup fails.
+     *
+     */
     targeting?: {
         [key: string]: unknown;
     };
@@ -18340,6 +18349,12 @@ type CreateStandaloneAdData = {
             productSetId?: string;
         };
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes create retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
+         */
+        'Idempotency-Key'?: string;
+    };
 };
 type CreateStandaloneAdResponse = (({
     ad?: Ad;

package/dist/index.d.ts

@@ -992,6 +992,15 @@ type Ad = {
         pinterestTitle?: string;
         pinterestDescription?: string;
     } | null;
+    /**
+     * The ad set's targeting (age, gender, geo, interests, placements, audience inclusions/exclusions).
+     * For ads created through Zernio this is the spec you supplied. For external ads (synced from
+     * Meta Ads Manager, `isExternal: true`) targeting lives at the ad set and isn't stored at ingest,
+     * so on the first `GET /v1/ads/{adId}` Zernio resolves it live from Meta and caches it on the ad;
+     * the value is then Meta's raw `targeting` shape (snake_case, e.g. `geo_locations`, `age_min`),
+     * the same object Ads Manager shows. May be absent if the ad set exposes no targeting or the lookup fails.
+     *
+     */
     targeting?: {
         [key: string]: unknown;
     };
@@ -18340,6 +18349,12 @@ type CreateStandaloneAdData = {
             productSetId?: string;
         };
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes create retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
+         */
+        'Idempotency-Key'?: string;
+    };
 };
 type CreateStandaloneAdResponse = (({
     ad?: Ad;

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -4584,6 +4584,8 @@ export const boostPost = <ThrowOnError extends boolean = false>(options: Options
 /**
  * Create standalone ad
  * Creates a paid ad with custom creative across Meta, Google Ads, Pinterest, TikTok, X/Twitter, and LinkedIn. Supports three mutually-exclusive request shapes selected by the body, a legacy single-creative shape (all platforms, default), a Meta-only multi-creative shape via the creatives array (one ad set with N ads sharing budget and targeting), and a Meta-only attach shape via adSetId (adds one new ad to an existing ad set). Per-platform required fields, budget minimums, and video-ad rules are documented on each property below. LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content "dark post" authored by a Company Page (see `organizationId`); supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.
+ *
+ * **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h.
  */
 export const createStandaloneAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateStandaloneAdData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateStandaloneAdResponse, CreateStandaloneAdError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -260,6 +260,15 @@ export type Ad = {
         pinterestTitle?: string;
         pinterestDescription?: string;
     } | null;
+    /**
+     * The ad set's targeting (age, gender, geo, interests, placements, audience inclusions/exclusions).
+     * For ads created through Zernio this is the spec you supplied. For external ads (synced from
+     * Meta Ads Manager, `isExternal: true`) targeting lives at the ad set and isn't stored at ingest,
+     * so on the first `GET /v1/ads/{adId}` Zernio resolves it live from Meta and caches it on the ad;
+     * the value is then Meta's raw `targeting` shape (snake_case, e.g. `geo_locations`, `age_min`),
+     * the same object Ads Manager shows. May be absent if the ad set exposes no targeting or the lookup fails.
+     *
+     */
     targeting?: {
         [key: string]: unknown;
     };
@@ -18805,6 +18814,12 @@ export type CreateStandaloneAdData = {
             productSetId?: string;
         };
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes create retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
+         */
+        'Idempotency-Key'?: string;
+    };
 };
 
 export type CreateStandaloneAdResponse = (({