@zernio/node 0.2.272 → 0.2.274

package/dist/index.d.mts

@@ -12495,6 +12495,26 @@ type ListInboxConversationsResponse = ({
              */
             fetchedAt?: (string) | null;
         } | null;
+        /**
+         * Ad-click attribution captured on the first inbound message of the
+         * conversation. Only present when the conversation originated from a
+         * click-to-message ad. Absent on organic conversations.
+         *
+         * Two sources populate this field:
+         * - WhatsApp CTWA (Click-to-WhatsApp): `ctwa_clid`, `ctwa_source_id`,
+         * `ctwa_source_url`, `ctwa_headline`, `ctwa_source_type`, `ctwa_captured_at`.
+         * - Facebook Messenger CTM / Instagram CTD: `meta_ad_id`, `meta_ad_title`,
+         * `meta_ad_source`, `meta_ad_type`, `meta_ad_ref`, `meta_ad_captured_at`,
+         * `meta_ad_photo_url`, `meta_ad_video_url`, `meta_ad_post_id`,
+         * `meta_ad_product_id`, `meta_ad_flow_id`.
+         *
+         * Note: `meta_ad_photo_url` and `meta_ad_video_url` are Facebook CDN URLs
+         * that may expire. Use `meta_ad_id` for a permanent reference to the ad.
+         *
+         */
+        metadata?: {
+            [key: string]: (string);
+        } | null;
     }>;
     pagination?: {
         hasMore?: boolean;
@@ -12652,6 +12672,27 @@ type GetInboxConversationResponse = ({
              */
             fetchedAt?: (string) | null;
         } | null;
+        /**
+         * Ad-click attribution captured on the first inbound message of the
+         * conversation. Only present when the conversation originated from a
+         * click-to-message ad. Absent on organic conversations.
+         *
+         * Two sources populate this field:
+         * - WhatsApp CTWA (Click-to-WhatsApp): `ctwa_clid`, `ctwa_source_id`,
+         * `ctwa_source_url`, `ctwa_headline`, `ctwa_source_type`, `ctwa_captured_at`.
+         * - Facebook Messenger CTM / Instagram CTD: `meta_ad_id`, `meta_ad_title`,
+         * `meta_ad_source`, `meta_ad_type`, `meta_ad_ref`, `meta_ad_captured_at`,
+         * `meta_ad_photo_url`, `meta_ad_video_url`, `meta_ad_post_id`,
+         * `meta_ad_product_id`, `meta_ad_flow_id`.
+         *
+         * Note: `meta_ad_photo_url` and `meta_ad_video_url` are Facebook CDN URLs
+         * that may expire. Use `meta_ad_id` for a permanent reference to the ad
+         * (e.g. to link to Meta Ads Manager).
+         *
+         */
+        metadata?: {
+            [key: string]: (string);
+        } | null;
     };
 });
 type GetInboxConversationError = ({
@@ -20004,8 +20045,47 @@ type GetLeadFormData = {
 };
 type GetLeadFormResponse = ({
     status?: string;
+    /**
+     * Full form config — sufficient to duplicate the form via POST /v1/ads/lead-forms.
+     */
     form?: {
-        [key: string]: unknown;
+        id?: string;
+        name?: string;
+        /**
+         * ARCHIVED forms can't receive new leads.
+         */
+        status?: 'ACTIVE' | 'ARCHIVED';
+        locale?: string;
+        created_time?: string;
+        leads_count?: number;
+        privacy_policy_url?: string;
+        follow_up_action_url?: (string) | null;
+        questions?: Array<{
+            key?: string;
+            label?: string;
+            /**
+             * EMAIL, PHONE, FULL_NAME, FIRST_NAME, LAST_NAME, CUSTOM, …
+             */
+            type?: string;
+            options?: Array<{
+                key?: string;
+                value?: string;
+            }>;
+            inline_context?: string;
+        }>;
+        thank_you_page?: {
+            title?: string;
+            body?: string;
+            button_text?: string;
+            button_type?: string;
+            website_url?: string;
+        } | null;
+        /**
+         * Intro card shown before the form questions (title, content, button label).
+         */
+        context_card?: {
+            [key: string]: unknown;
+        } | null;
     };
 });
 type GetLeadFormError = ({
@@ -20121,9 +20201,9 @@ type SearchAdTargetingData = {
          */
         dimension?: 'geo' | 'interest' | 'behavior' | 'income';
         /**
-         * Only used when `dimension=geo`. The kind of location to resolve. Defaults to `city`.
+         * Only used when `dimension=geo`. The kind of location to resolve. `place` resolves named points of interest (businesses, landmarks) by proximity. `neighborhood` resolves named neighbourhood areas. Defaults to `city`.
          */
-        geoType?: 'country' | 'region' | 'city' | 'zip' | 'metro';
+        geoType?: 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
         /**
          * Maximum results to return.
          */

package/dist/index.d.ts

@@ -12495,6 +12495,26 @@ type ListInboxConversationsResponse = ({
              */
             fetchedAt?: (string) | null;
         } | null;
+        /**
+         * Ad-click attribution captured on the first inbound message of the
+         * conversation. Only present when the conversation originated from a
+         * click-to-message ad. Absent on organic conversations.
+         *
+         * Two sources populate this field:
+         * - WhatsApp CTWA (Click-to-WhatsApp): `ctwa_clid`, `ctwa_source_id`,
+         * `ctwa_source_url`, `ctwa_headline`, `ctwa_source_type`, `ctwa_captured_at`.
+         * - Facebook Messenger CTM / Instagram CTD: `meta_ad_id`, `meta_ad_title`,
+         * `meta_ad_source`, `meta_ad_type`, `meta_ad_ref`, `meta_ad_captured_at`,
+         * `meta_ad_photo_url`, `meta_ad_video_url`, `meta_ad_post_id`,
+         * `meta_ad_product_id`, `meta_ad_flow_id`.
+         *
+         * Note: `meta_ad_photo_url` and `meta_ad_video_url` are Facebook CDN URLs
+         * that may expire. Use `meta_ad_id` for a permanent reference to the ad.
+         *
+         */
+        metadata?: {
+            [key: string]: (string);
+        } | null;
     }>;
     pagination?: {
         hasMore?: boolean;
@@ -12652,6 +12672,27 @@ type GetInboxConversationResponse = ({
              */
             fetchedAt?: (string) | null;
         } | null;
+        /**
+         * Ad-click attribution captured on the first inbound message of the
+         * conversation. Only present when the conversation originated from a
+         * click-to-message ad. Absent on organic conversations.
+         *
+         * Two sources populate this field:
+         * - WhatsApp CTWA (Click-to-WhatsApp): `ctwa_clid`, `ctwa_source_id`,
+         * `ctwa_source_url`, `ctwa_headline`, `ctwa_source_type`, `ctwa_captured_at`.
+         * - Facebook Messenger CTM / Instagram CTD: `meta_ad_id`, `meta_ad_title`,
+         * `meta_ad_source`, `meta_ad_type`, `meta_ad_ref`, `meta_ad_captured_at`,
+         * `meta_ad_photo_url`, `meta_ad_video_url`, `meta_ad_post_id`,
+         * `meta_ad_product_id`, `meta_ad_flow_id`.
+         *
+         * Note: `meta_ad_photo_url` and `meta_ad_video_url` are Facebook CDN URLs
+         * that may expire. Use `meta_ad_id` for a permanent reference to the ad
+         * (e.g. to link to Meta Ads Manager).
+         *
+         */
+        metadata?: {
+            [key: string]: (string);
+        } | null;
     };
 });
 type GetInboxConversationError = ({
@@ -20004,8 +20045,47 @@ type GetLeadFormData = {
 };
 type GetLeadFormResponse = ({
     status?: string;
+    /**
+     * Full form config — sufficient to duplicate the form via POST /v1/ads/lead-forms.
+     */
     form?: {
-        [key: string]: unknown;
+        id?: string;
+        name?: string;
+        /**
+         * ARCHIVED forms can't receive new leads.
+         */
+        status?: 'ACTIVE' | 'ARCHIVED';
+        locale?: string;
+        created_time?: string;
+        leads_count?: number;
+        privacy_policy_url?: string;
+        follow_up_action_url?: (string) | null;
+        questions?: Array<{
+            key?: string;
+            label?: string;
+            /**
+             * EMAIL, PHONE, FULL_NAME, FIRST_NAME, LAST_NAME, CUSTOM, …
+             */
+            type?: string;
+            options?: Array<{
+                key?: string;
+                value?: string;
+            }>;
+            inline_context?: string;
+        }>;
+        thank_you_page?: {
+            title?: string;
+            body?: string;
+            button_text?: string;
+            button_type?: string;
+            website_url?: string;
+        } | null;
+        /**
+         * Intro card shown before the form questions (title, content, button label).
+         */
+        context_card?: {
+            [key: string]: unknown;
+        } | null;
     };
 });
 type GetLeadFormError = ({
@@ -20121,9 +20201,9 @@ type SearchAdTargetingData = {
          */
         dimension?: 'geo' | 'interest' | 'behavior' | 'income';
         /**
-         * Only used when `dimension=geo`. The kind of location to resolve. Defaults to `city`.
+         * Only used when `dimension=geo`. The kind of location to resolve. `place` resolves named points of interest (businesses, landmarks) by proximity. `neighborhood` resolves named neighbourhood areas. Defaults to `city`.
          */
-        geoType?: 'country' | 'region' | 'city' | 'zip' | 'metro';
+        geoType?: 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
         /**
          * Maximum results to return.
          */

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -12457,6 +12457,26 @@ export type ListInboxConversationsResponse = ({
              */
             fetchedAt?: (string) | null;
         } | null;
+        /**
+         * Ad-click attribution captured on the first inbound message of the
+         * conversation. Only present when the conversation originated from a
+         * click-to-message ad. Absent on organic conversations.
+         *
+         * Two sources populate this field:
+         * - WhatsApp CTWA (Click-to-WhatsApp): `ctwa_clid`, `ctwa_source_id`,
+         * `ctwa_source_url`, `ctwa_headline`, `ctwa_source_type`, `ctwa_captured_at`.
+         * - Facebook Messenger CTM / Instagram CTD: `meta_ad_id`, `meta_ad_title`,
+         * `meta_ad_source`, `meta_ad_type`, `meta_ad_ref`, `meta_ad_captured_at`,
+         * `meta_ad_photo_url`, `meta_ad_video_url`, `meta_ad_post_id`,
+         * `meta_ad_product_id`, `meta_ad_flow_id`.
+         *
+         * Note: `meta_ad_photo_url` and `meta_ad_video_url` are Facebook CDN URLs
+         * that may expire. Use `meta_ad_id` for a permanent reference to the ad.
+         *
+         */
+        metadata?: {
+            [key: string]: (string);
+        } | null;
     }>;
     pagination?: {
         hasMore?: boolean;
@@ -12620,6 +12640,27 @@ export type GetInboxConversationResponse = ({
              */
             fetchedAt?: (string) | null;
         } | null;
+        /**
+         * Ad-click attribution captured on the first inbound message of the
+         * conversation. Only present when the conversation originated from a
+         * click-to-message ad. Absent on organic conversations.
+         *
+         * Two sources populate this field:
+         * - WhatsApp CTWA (Click-to-WhatsApp): `ctwa_clid`, `ctwa_source_id`,
+         * `ctwa_source_url`, `ctwa_headline`, `ctwa_source_type`, `ctwa_captured_at`.
+         * - Facebook Messenger CTM / Instagram CTD: `meta_ad_id`, `meta_ad_title`,
+         * `meta_ad_source`, `meta_ad_type`, `meta_ad_ref`, `meta_ad_captured_at`,
+         * `meta_ad_photo_url`, `meta_ad_video_url`, `meta_ad_post_id`,
+         * `meta_ad_product_id`, `meta_ad_flow_id`.
+         *
+         * Note: `meta_ad_photo_url` and `meta_ad_video_url` are Facebook CDN URLs
+         * that may expire. Use `meta_ad_id` for a permanent reference to the ad
+         * (e.g. to link to Meta Ads Manager).
+         *
+         */
+        metadata?: {
+            [key: string]: (string);
+        } | null;
     };
 });
 
@@ -20519,8 +20560,47 @@ export type GetLeadFormData = {
 
 export type GetLeadFormResponse = ({
     status?: string;
+    /**
+     * Full form config — sufficient to duplicate the form via POST /v1/ads/lead-forms.
+     */
     form?: {
-        [key: string]: unknown;
+        id?: string;
+        name?: string;
+        /**
+         * ARCHIVED forms can't receive new leads.
+         */
+        status?: 'ACTIVE' | 'ARCHIVED';
+        locale?: string;
+        created_time?: string;
+        leads_count?: number;
+        privacy_policy_url?: string;
+        follow_up_action_url?: (string) | null;
+        questions?: Array<{
+            key?: string;
+            label?: string;
+            /**
+             * EMAIL, PHONE, FULL_NAME, FIRST_NAME, LAST_NAME, CUSTOM, …
+             */
+            type?: string;
+            options?: Array<{
+                key?: string;
+                value?: string;
+            }>;
+            inline_context?: string;
+        }>;
+        thank_you_page?: {
+            title?: string;
+            body?: string;
+            button_text?: string;
+            button_type?: string;
+            website_url?: string;
+        } | null;
+        /**
+         * Intro card shown before the form questions (title, content, button label).
+         */
+        context_card?: {
+            [key: string]: unknown;
+        } | null;
     };
 });
 
@@ -20650,9 +20730,9 @@ export type SearchAdTargetingData = {
          */
         dimension?: 'geo' | 'interest' | 'behavior' | 'income';
         /**
-         * Only used when `dimension=geo`. The kind of location to resolve. Defaults to `city`.
+         * Only used when `dimension=geo`. The kind of location to resolve. `place` resolves named points of interest (businesses, landmarks) by proximity. `neighborhood` resolves named neighbourhood areas. Defaults to `city`.
          */
-        geoType?: 'country' | 'region' | 'city' | 'zip' | 'metro';
+        geoType?: 'country' | 'region' | 'city' | 'subcity' | 'neighborhood' | 'place' | 'zip' | 'metro_area' | 'geo_market';
         /**
          * Maximum results to return.
          */