@zernio/node 0.2.184 → 0.2.186

package/dist/index.d.mts

@@ -2191,6 +2191,16 @@ type InboxWebhookConversation = {
     participantUsername?: string;
     participantPicture?: string;
     status: 'active' | 'archived';
+    /**
+     * Zernio CRM Contact ID for the participant, when one exists. Resolved by
+     * joining `participantId` to the ContactChannel collection. Best-effort:
+     * omitted when no channel matches or `participantId` is absent. Lets
+     * integrators join any inbox webhook back to the CRM Contact without
+     * needing to look at the sender — which matters for outgoing and
+     * delivery-status events whose sender is the business.
+     *
+     */
+    contactId?: string;
 };
 type status3 = 'active' | 'archived';
 /**
@@ -4311,6 +4321,16 @@ type WebhookPayloadConversationStarted = {
         participantUsername?: string;
         participantPicture?: string;
         status: 'active' | 'archived';
+        /**
+         * Zernio CRM Contact ID for the participant, when one exists. Resolved by
+         * joining `participantId` to the ContactChannel collection (same join
+         * used by message.*, reaction.received, and call.* webhooks). Best-effort:
+         * omitted when no channel matches or `participantId` is absent. Lets
+         * integrators seed the CRM straight from `conversation.started` without
+         * waiting for the first `message.*` event.
+         *
+         */
+        contactId?: string;
     };
     account: InboxWebhookAccount;
     /**
@@ -4498,24 +4518,8 @@ type WebhookPayloadMessage = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     /**
      * Interactive message metadata (present when message is a quick reply tap, postback button tap, or inline keyboard callback)
      */
@@ -4827,24 +4831,8 @@ type WebhookPayloadMessageSent = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 type event12 = 'message.sent';
@@ -4992,24 +4980,8 @@ type WebhookPayloadReaction = {
         };
         reactedAt: string;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 type event15 = 'reaction.received';
@@ -17374,9 +17346,65 @@ type CreateCtwaAdData = {
          */
         endDate?: string;
         /**
-         * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]`.
+         * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]` only
+         * when no other geo (`cities`, `regions`, `zips`, `metros`,
+         * `customLocations`) is supplied.
+         *
          */
         countries?: Array<(string)>;
+        /**
+         * City-level geo targeting for local CTWA campaigns (e.g.
+         * 25km radius around Milan). Each entry maps to Meta's
+         * TargetingGeoLocationCity. `key` is Meta's city ID
+         * (lookupable via GET /v1/ads/targeting/search). `radius`
+         * and `distance_unit` are coupled: set both or neither.
+         *
+         */
+        cities?: Array<{
+            key: string;
+            radius?: number;
+            distance_unit?: 'mile' | 'kilometer';
+        }>;
+        /**
+         * Region / state-level geo targeting. `key` is Meta's region
+         * ID (lookupable via GET /v1/ads/targeting/search?type=region).
+         *
+         */
+        regions?: Array<{
+            key: string;
+        }>;
+        /**
+         * ZIP / postal-code geo targeting. `key` is the platform's
+         * postal id resolved via /v1/ads/targeting/search.
+         *
+         */
+        zips?: Array<{
+            key: string;
+            name?: string;
+        }>;
+        /**
+         * DMA / metro-area geo targeting. `key` is Meta's metro id
+         * (e.g. `DMA:807`).
+         *
+         */
+        metros?: Array<{
+            key: string;
+            name?: string;
+        }>;
+        /**
+         * Point-radius geo (Meta `geo_locations.custom_locations`).
+         * Use for targeting a radius around a specific lat/long when
+         * no Meta city/region key fits. `distanceUnit` is required.
+         *
+         */
+        customLocations?: Array<{
+            latitude: number;
+            longitude: number;
+            radius: number;
+            distanceUnit: 'mile' | 'kilometer';
+            name?: string;
+            address?: string;
+        }>;
         ageMin?: number;
         ageMax?: number;
         interests?: Array<{

package/dist/index.d.ts

@@ -2191,6 +2191,16 @@ type InboxWebhookConversation = {
     participantUsername?: string;
     participantPicture?: string;
     status: 'active' | 'archived';
+    /**
+     * Zernio CRM Contact ID for the participant, when one exists. Resolved by
+     * joining `participantId` to the ContactChannel collection. Best-effort:
+     * omitted when no channel matches or `participantId` is absent. Lets
+     * integrators join any inbox webhook back to the CRM Contact without
+     * needing to look at the sender — which matters for outgoing and
+     * delivery-status events whose sender is the business.
+     *
+     */
+    contactId?: string;
 };
 type status3 = 'active' | 'archived';
 /**
@@ -4311,6 +4321,16 @@ type WebhookPayloadConversationStarted = {
         participantUsername?: string;
         participantPicture?: string;
         status: 'active' | 'archived';
+        /**
+         * Zernio CRM Contact ID for the participant, when one exists. Resolved by
+         * joining `participantId` to the ContactChannel collection (same join
+         * used by message.*, reaction.received, and call.* webhooks). Best-effort:
+         * omitted when no channel matches or `participantId` is absent. Lets
+         * integrators seed the CRM straight from `conversation.started` without
+         * waiting for the first `message.*` event.
+         *
+         */
+        contactId?: string;
     };
     account: InboxWebhookAccount;
     /**
@@ -4498,24 +4518,8 @@ type WebhookPayloadMessage = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     /**
      * Interactive message metadata (present when message is a quick reply tap, postback button tap, or inline keyboard callback)
      */
@@ -4827,24 +4831,8 @@ type WebhookPayloadMessageSent = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 type event12 = 'message.sent';
@@ -4992,24 +4980,8 @@ type WebhookPayloadReaction = {
         };
         reactedAt: string;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 type event15 = 'reaction.received';
@@ -17374,9 +17346,65 @@ type CreateCtwaAdData = {
          */
         endDate?: string;
         /**
-         * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]`.
+         * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]` only
+         * when no other geo (`cities`, `regions`, `zips`, `metros`,
+         * `customLocations`) is supplied.
+         *
          */
         countries?: Array<(string)>;
+        /**
+         * City-level geo targeting for local CTWA campaigns (e.g.
+         * 25km radius around Milan). Each entry maps to Meta's
+         * TargetingGeoLocationCity. `key` is Meta's city ID
+         * (lookupable via GET /v1/ads/targeting/search). `radius`
+         * and `distance_unit` are coupled: set both or neither.
+         *
+         */
+        cities?: Array<{
+            key: string;
+            radius?: number;
+            distance_unit?: 'mile' | 'kilometer';
+        }>;
+        /**
+         * Region / state-level geo targeting. `key` is Meta's region
+         * ID (lookupable via GET /v1/ads/targeting/search?type=region).
+         *
+         */
+        regions?: Array<{
+            key: string;
+        }>;
+        /**
+         * ZIP / postal-code geo targeting. `key` is the platform's
+         * postal id resolved via /v1/ads/targeting/search.
+         *
+         */
+        zips?: Array<{
+            key: string;
+            name?: string;
+        }>;
+        /**
+         * DMA / metro-area geo targeting. `key` is Meta's metro id
+         * (e.g. `DMA:807`).
+         *
+         */
+        metros?: Array<{
+            key: string;
+            name?: string;
+        }>;
+        /**
+         * Point-radius geo (Meta `geo_locations.custom_locations`).
+         * Use for targeting a radius around a specific lat/long when
+         * no Meta city/region key fits. `distanceUnit` is required.
+         *
+         */
+        customLocations?: Array<{
+            latitude: number;
+            longitude: number;
+            radius: number;
+            distanceUnit: 'mile' | 'kilometer';
+            name?: string;
+            address?: string;
+        }>;
         ageMin?: number;
         ageMax?: number;
         interests?: Array<{

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -1574,6 +1574,16 @@ export type InboxWebhookConversation = {
     participantUsername?: string;
     participantPicture?: string;
     status: 'active' | 'archived';
+    /**
+     * Zernio CRM Contact ID for the participant, when one exists. Resolved by
+     * joining `participantId` to the ContactChannel collection. Best-effort:
+     * omitted when no channel matches or `participantId` is absent. Lets
+     * integrators join any inbox webhook back to the CRM Contact without
+     * needing to look at the sender — which matters for outgoing and
+     * delivery-status events whose sender is the business.
+     *
+     */
+    contactId?: string;
 };
 
 export type status3 = 'active' | 'archived';
@@ -3803,6 +3813,16 @@ export type WebhookPayloadConversationStarted = {
         participantUsername?: string;
         participantPicture?: string;
         status: 'active' | 'archived';
+        /**
+         * Zernio CRM Contact ID for the participant, when one exists. Resolved by
+         * joining `participantId` to the ContactChannel collection (same join
+         * used by message.*, reaction.received, and call.* webhooks). Best-effort:
+         * omitted when no channel matches or `participantId` is absent. Lets
+         * integrators seed the CRM straight from `conversation.started` without
+         * waiting for the first `message.*` event.
+         *
+         */
+        contactId?: string;
     };
     account: InboxWebhookAccount;
     /**
@@ -3996,24 +4016,8 @@ export type WebhookPayloadMessage = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     /**
      * Interactive message metadata (present when message is a quick reply tap, postback button tap, or inline keyboard callback)
      */
@@ -4334,24 +4338,8 @@ export type WebhookPayloadMessageSent = {
         sentAt: string;
         isRead: boolean;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 
@@ -4505,24 +4493,8 @@ export type WebhookPayloadReaction = {
         };
         reactedAt: string;
     };
-    conversation: {
-        id: string;
-        platformConversationId: string;
-        participantId?: string;
-        participantName?: string;
-        participantUsername?: string;
-        participantPicture?: string;
-        status: 'active' | 'archived';
-    };
-    account: {
-        /**
-         * Social account ID
-         */
-        id: string;
-        platform: string;
-        username: string;
-        displayName?: string;
-    };
+    conversation: InboxWebhookConversation;
+    account: InboxWebhookAccount;
     timestamp: string;
 };
 
@@ -17828,9 +17800,65 @@ export type CreateCtwaAdData = {
          */
         endDate?: string;
         /**
-         * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]`.
+         * ISO 3166-1 alpha-2 country codes. Defaults to `["US"]` only
+         * when no other geo (`cities`, `regions`, `zips`, `metros`,
+         * `customLocations`) is supplied.
+         *
          */
         countries?: Array<(string)>;
+        /**
+         * City-level geo targeting for local CTWA campaigns (e.g.
+         * 25km radius around Milan). Each entry maps to Meta's
+         * TargetingGeoLocationCity. `key` is Meta's city ID
+         * (lookupable via GET /v1/ads/targeting/search). `radius`
+         * and `distance_unit` are coupled: set both or neither.
+         *
+         */
+        cities?: Array<{
+            key: string;
+            radius?: number;
+            distance_unit?: 'mile' | 'kilometer';
+        }>;
+        /**
+         * Region / state-level geo targeting. `key` is Meta's region
+         * ID (lookupable via GET /v1/ads/targeting/search?type=region).
+         *
+         */
+        regions?: Array<{
+            key: string;
+        }>;
+        /**
+         * ZIP / postal-code geo targeting. `key` is the platform's
+         * postal id resolved via /v1/ads/targeting/search.
+         *
+         */
+        zips?: Array<{
+            key: string;
+            name?: string;
+        }>;
+        /**
+         * DMA / metro-area geo targeting. `key` is Meta's metro id
+         * (e.g. `DMA:807`).
+         *
+         */
+        metros?: Array<{
+            key: string;
+            name?: string;
+        }>;
+        /**
+         * Point-radius geo (Meta `geo_locations.custom_locations`).
+         * Use for targeting a radius around a specific lat/long when
+         * no Meta city/region key fits. `distanceUnit` is required.
+         *
+         */
+        customLocations?: Array<{
+            latitude: number;
+            longitude: number;
+            radius: number;
+            distanceUnit: 'mile' | 'kilometer';
+            name?: string;
+            address?: string;
+        }>;
         ageMin?: number;
         ageMax?: number;
         interests?: Array<{