@zernio/node 0.2.556 → 0.2.557

package/dist/index.d.mts

@@ -29374,6 +29374,12 @@ type BoostPostData = {
          */
         optimizationGoal?: string;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
+         */
+        'Idempotency-Key'?: string;
+    };
 };
 type BoostPostResponse = ({
     ad?: Ad;

package/dist/index.d.ts

@@ -29374,6 +29374,12 @@ type BoostPostData = {
          */
         optimizationGoal?: string;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
+         */
+        'Idempotency-Key'?: string;
+    };
 };
 type BoostPostResponse = ({
     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.556",
+  version: "0.2.557",
   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.556",
+  version: "0.2.557",
   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.556",
+  "version": "0.2.557",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -8098,6 +8098,16 @@ export const getDsaRecommendations = <ThrowOnError extends boolean = false>(opti
  * `instagramAccountId`, `destinationType` and `adSetId` are Meta-only and
  * return 400 on other platforms.
  *
+ * **Retries.** Boosts are NOT idempotent and can take minutes when Meta requires re-hosting an
+ * Instagram video, so do not retry on client timeout. Send an
+ * Idempotency-Key header to make retries safe: same key and body replays
+ * the original 201, and distinct keys always create distinct ads.
+ * Without the header, an identical request is treated as a retry: while
+ * one is in flight it returns 409, and within 10 minutes of a completed
+ * boost it returns the already-created ad instead of creating another.
+ * To intentionally duplicate an ad, send distinct Idempotency-Keys (or
+ * vary the body, e.g. the name).
+ *
  */
 export const boostPost = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<BoostPostData, ThrowOnError>) => {
     return (options?.client ?? client).post<BoostPostResponse, BoostPostError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -29907,6 +29907,12 @@ export type BoostPostData = {
          */
         optimizationGoal?: string;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.
+         */
+        'Idempotency-Key'?: string;
+    };
 };
 
 export type BoostPostResponse = ({