@zernio/node 0.2.926 → 0.2.928

package/dist/index.d.mts

@@ -9935,11 +9935,14 @@ type UsageAttributionSlice = {
     byProduct?: {
         accounts?: number;
         numbers?: number;
+        imessage?: number;
         calls?: number;
         sms?: number;
+        messages?: number;
         verify?: number;
         dlc?: number;
         xApi?: number;
+        ads?: number;
         credits?: number;
         other?: number;
     };
@@ -9963,13 +9966,29 @@ type UsageMetering = {
         date?: string;
         accounts?: number;
         numbers?: number;
+        /**
+         * iMessage sender fees.
+         */
+        imessage?: number;
         calls?: number;
         sms?: number;
+        /**
+         * Managed outbound message fees.
+         */
+        messages?: number;
+        /**
+         * Verify (per verification) fees.
+         */
+        verify?: number;
         /**
          * 10DLC registration (brand + campaign) fees.
          */
         dlc?: number;
         xApi?: number;
+        /**
+         * Managed ads fees.
+         */
+        ads?: number;
         /**
          * Applied credits/discounts (negative).
          */
@@ -9982,10 +10001,14 @@ type UsageMetering = {
     totals?: {
         accounts?: number;
         numbers?: number;
+        imessage?: number;
         calls?: number;
         sms?: number;
+        messages?: number;
+        verify?: number;
         dlc?: number;
         xApi?: number;
+        ads?: number;
         credits?: number;
         other?: number;
         total?: number;
@@ -9995,7 +10018,7 @@ type UsageMetering = {
      */
     lineItems?: Array<{
         name?: string;
-        product?: 'accounts' | 'numbers' | 'calls' | 'sms' | 'dlc' | 'xApi' | 'credits' | 'other';
+        product?: 'accounts' | 'numbers' | 'imessage' | 'calls' | 'sms' | 'messages' | 'verify' | 'dlc' | 'xApi' | 'ads' | 'credits' | 'other';
         totalUsd?: number;
         quantity?: number;
     }>;
@@ -11360,6 +11383,10 @@ type WebhookPayloadLead = {
          */
         accountId?: string;
         platform: 'facebook';
+        /**
+         * Profile ID of the account that received the lead. Null when the lead has no profile on record.
+         */
+        profileId: (string) | null;
     };
     /**
      * UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.
@@ -43980,6 +44007,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 +44029,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 +44042,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

@@ -9935,11 +9935,14 @@ type UsageAttributionSlice = {
     byProduct?: {
         accounts?: number;
         numbers?: number;
+        imessage?: number;
         calls?: number;
         sms?: number;
+        messages?: number;
         verify?: number;
         dlc?: number;
         xApi?: number;
+        ads?: number;
         credits?: number;
         other?: number;
     };
@@ -9963,13 +9966,29 @@ type UsageMetering = {
         date?: string;
         accounts?: number;
         numbers?: number;
+        /**
+         * iMessage sender fees.
+         */
+        imessage?: number;
         calls?: number;
         sms?: number;
+        /**
+         * Managed outbound message fees.
+         */
+        messages?: number;
+        /**
+         * Verify (per verification) fees.
+         */
+        verify?: number;
         /**
          * 10DLC registration (brand + campaign) fees.
          */
         dlc?: number;
         xApi?: number;
+        /**
+         * Managed ads fees.
+         */
+        ads?: number;
         /**
          * Applied credits/discounts (negative).
          */
@@ -9982,10 +10001,14 @@ type UsageMetering = {
     totals?: {
         accounts?: number;
         numbers?: number;
+        imessage?: number;
         calls?: number;
         sms?: number;
+        messages?: number;
+        verify?: number;
         dlc?: number;
         xApi?: number;
+        ads?: number;
         credits?: number;
         other?: number;
         total?: number;
@@ -9995,7 +10018,7 @@ type UsageMetering = {
      */
     lineItems?: Array<{
         name?: string;
-        product?: 'accounts' | 'numbers' | 'calls' | 'sms' | 'dlc' | 'xApi' | 'credits' | 'other';
+        product?: 'accounts' | 'numbers' | 'imessage' | 'calls' | 'sms' | 'messages' | 'verify' | 'dlc' | 'xApi' | 'ads' | 'credits' | 'other';
         totalUsd?: number;
         quantity?: number;
     }>;
@@ -11360,6 +11383,10 @@ type WebhookPayloadLead = {
          */
         accountId?: string;
         platform: 'facebook';
+        /**
+         * Profile ID of the account that received the lead. Null when the lead has no profile on record.
+         */
+        profileId: (string) | null;
     };
     /**
      * UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.
@@ -43980,6 +44007,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 +44029,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 +44042,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: "@zernio/node",
-  version: "0.2.926",
+  version: "0.2.928",
   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.926",
+  version: "0.2.928",
   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.926",
+  "version": "0.2.928",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -767,8 +767,9 @@ export const getXApiPricing = <ThrowOnError extends boolean = false>(options?: O
  * working unchanged.
  *
  * **With `range`, `granularity`, `from`, or `to`:** usage METERING:
- * billed spend (USD) by product family (`accounts`, `numbers`, `calls`,
- * `sms`, `dlc`, `xApi`, `credits`, `other`) over the window, at
+ * billed spend (USD) by product family (`accounts`, `numbers`,
+ * `imessage`, `calls`, `sms`, `messages`, `verify`, `dlc`, `xApi`, `ads`,
+ * `credits`, `other`) over the window, at
  * `day` / `month` / `total` granularity, from the usage-based invoice
  * breakdown (the CHARGE view, which always reconciles with what gets billed).
  * Also served at `GET /v1/usage/daily`. Usage-based accounts only:
@@ -11944,6 +11945,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 +11961,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 +11991,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

@@ -8583,11 +8583,14 @@ export type UsageAttributionSlice = {
     byProduct?: {
         accounts?: number;
         numbers?: number;
+        imessage?: number;
         calls?: number;
         sms?: number;
+        messages?: number;
         verify?: number;
         dlc?: number;
         xApi?: number;
+        ads?: number;
         credits?: number;
         other?: number;
     };
@@ -8612,13 +8615,29 @@ export type UsageMetering = {
         date?: string;
         accounts?: number;
         numbers?: number;
+        /**
+         * iMessage sender fees.
+         */
+        imessage?: number;
         calls?: number;
         sms?: number;
+        /**
+         * Managed outbound message fees.
+         */
+        messages?: number;
+        /**
+         * Verify (per verification) fees.
+         */
+        verify?: number;
         /**
          * 10DLC registration (brand + campaign) fees.
          */
         dlc?: number;
         xApi?: number;
+        /**
+         * Managed ads fees.
+         */
+        ads?: number;
         /**
          * Applied credits/discounts (negative).
          */
@@ -8631,10 +8650,14 @@ export type UsageMetering = {
     totals?: {
         accounts?: number;
         numbers?: number;
+        imessage?: number;
         calls?: number;
         sms?: number;
+        messages?: number;
+        verify?: number;
         dlc?: number;
         xApi?: number;
+        ads?: number;
         credits?: number;
         other?: number;
         total?: number;
@@ -8644,7 +8667,7 @@ export type UsageMetering = {
      */
     lineItems?: Array<{
         name?: string;
-        product?: 'accounts' | 'numbers' | 'calls' | 'sms' | 'dlc' | 'xApi' | 'credits' | 'other';
+        product?: 'accounts' | 'numbers' | 'imessage' | 'calls' | 'sms' | 'messages' | 'verify' | 'dlc' | 'xApi' | 'ads' | 'credits' | 'other';
         totalUsd?: number;
         quantity?: number;
     }>;
@@ -10065,6 +10088,10 @@ export type WebhookPayloadLead = {
          */
         accountId?: string;
         platform: 'facebook';
+        /**
+         * Profile ID of the account that received the lead. Null when the lead has no profile on record.
+         */
+        profileId: (string) | null;
     };
     /**
      * UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.
@@ -44824,6 +44851,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 +44876,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 +44892,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));