@getlatedev/node 0.2.926 → 0.2.927

package/dist/index.d.mts

@@ -43980,6 +43980,12 @@ type CreateMessagingAdData = {
          */
         destinations?: Array<('whatsapp' | 'messenger' | 'instagram_direct')>;
     });
+    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 CreateMessagingAdResponse = ((CtwaSingleResponse | CtwaMultiResponse));
 type CreateMessagingAdError = (unknown | {
@@ -43996,6 +44002,12 @@ type CreateCallAdData = {
          */
         linkUrl: 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 CreateCallAdResponse = ((CtwaSingleResponse | CtwaMultiResponse));
 type CreateCallAdError = (unknown | {
@@ -44003,6 +44015,12 @@ type CreateCallAdError = (unknown | {
 } | ErrorResponse);
 type CreateCtwaAdData = {
     body: CtwaAdRequestBody;
+    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 CreateCtwaAdResponse = ((CtwaSingleResponse | CtwaMultiResponse));
 type CreateCtwaAdError = (unknown | {

package/dist/index.d.ts

@@ -43980,6 +43980,12 @@ type CreateMessagingAdData = {
          */
         destinations?: Array<('whatsapp' | 'messenger' | 'instagram_direct')>;
     });
+    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 CreateMessagingAdResponse = ((CtwaSingleResponse | CtwaMultiResponse));
 type CreateMessagingAdError = (unknown | {
@@ -43996,6 +44002,12 @@ type CreateCallAdData = {
          */
         linkUrl: 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 CreateCallAdResponse = ((CtwaSingleResponse | CtwaMultiResponse));
 type CreateCallAdError = (unknown | {
@@ -44003,6 +44015,12 @@ type CreateCallAdError = (unknown | {
 } | ErrorResponse);
 type CreateCtwaAdData = {
     body: CtwaAdRequestBody;
+    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 CreateCtwaAdResponse = ((CtwaSingleResponse | CtwaMultiResponse));
 type CreateCtwaAdError = (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.926",
+  version: "0.2.927",
   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.926",
+  version: "0.2.927",
   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.926",
+  "version": "0.2.927",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -11944,6 +11944,8 @@ export const sendWhatsAppConversion = <ThrowOnError extends boolean = false>(opt
  * a number already paired with the Page (WhatsApp destination only).
  * `accountId` is a Facebook, Instagram or Meta ads (business login) connection;
  * `pageId` picks the Page when that connection was granted several.
+ *
+ * **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 createMessagingAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateMessagingAdData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateMessagingAdResponse, CreateMessagingAdError, ThrowOnError>({
@@ -11958,6 +11960,8 @@ export const createMessagingAd = <ThrowOnError extends boolean = false>(options:
  * via a tel: link. The ad set is destination_type PHONE_CALL optimizing QUALITY_CALL
  * and the campaign objective defaults to OUTCOME_LEADS.
  * Supports the same single-creative and multi-creative shapes as CTWA.
+ *
+ * **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 createCallAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateCallAdData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateCallAdResponse, CreateCallAdError, ThrowOnError>({
@@ -11986,6 +11990,8 @@ export const createCallAd = <ThrowOnError extends boolean = false>(options: Opti
  * `existingPostId`) or `objectStoryId`, either per creative or at the top level. Omit fresh
  * media and copy for that creative. Optional `whatsappPhoneNumber` selects
  * a number already paired with the Page (WhatsApp destination only).
+ *
+ * **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 createCtwaAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateCtwaAdData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateCtwaAdResponse, CreateCtwaAdError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -44824,6 +44824,12 @@ export type CreateMessagingAdData = {
      */
     destinations?: Array<('whatsapp' | 'messenger' | 'instagram_direct')>;
 });
+    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 CreateMessagingAdResponse = ((CtwaSingleResponse | CtwaMultiResponse));
@@ -44843,6 +44849,12 @@ export type CreateCallAdData = {
      */
     linkUrl: 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 CreateCallAdResponse = ((CtwaSingleResponse | CtwaMultiResponse));
@@ -44853,6 +44865,12 @@ export type CreateCallAdError = (unknown | {
 
 export type CreateCtwaAdData = {
     body: CtwaAdRequestBody;
+    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 CreateCtwaAdResponse = ((CtwaSingleResponse | CtwaMultiResponse));