@getlatedev/node 0.2.372 → 0.2.374

package/dist/index.d.mts

@@ -4420,19 +4420,19 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
+     * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
      */
     cities?: Array<{
         key: string;
         name?: string;
         /**
-         * Radius around the city. Requires distance_unit.
+         * Radius around the city. Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng), which allows a smaller radius.
          */
         radius?: number;
         /**
          * Required if radius is set.
          */
-        distance_unit?: 'mile' | 'kilometer';
+        distanceUnit?: 'mile' | 'kilometer';
     }>;
     /**
      * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`). Supported on Meta, Google, TikTok, Pinterest, X.
@@ -4475,18 +4475,18 @@ type TargetingSpec = {
             name?: string;
         }>;
         /**
-         * Cities to exclude. Optional `radius` + `distance_unit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
+         * Cities to exclude. Optional `radius` + `distanceUnit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
          */
         cities?: Array<{
             key: string;
             /**
-             * Radius around the excluded city. Requires distance_unit.
+             * Radius around the excluded city. Requires distanceUnit.
              */
             radius?: number;
             /**
              * Required if radius is set.
              */
-            distance_unit?: 'mile' | 'kilometer';
+            distanceUnit?: 'mile' | 'kilometer';
         }>;
         zips?: Array<{
             key: string;
@@ -7195,6 +7195,18 @@ type YouTubeDemographicsResponse = {
      */
     accountId?: string;
     platform?: string;
+    /**
+     * Present only when demographics are scoped to a single video
+     */
+    videoId?: string;
+    /**
+     * Video title (video mode only)
+     */
+    title?: (string) | null;
+    /**
+     * Video publish date (video mode only)
+     */
+    publishedAt?: (string) | null;
     /**
      * Object keyed by breakdown dimension (age, gender, country)
      */
@@ -7910,10 +7922,17 @@ type GetYouTubeDemographicsData = {
          */
         endDate?: string;
         /**
-         * Start date in YYYY-MM-DD format. Defaults to 90 days ago.
+         * Start date in YYYY-MM-DD format. Defaults to 90 days ago, or to the video's
+         * publish date (lifetime) when videoId is provided.
          *
          */
         startDate?: string;
+        /**
+         * YouTube video ID. When provided, demographics are scoped to this single video
+         * (must belong to the connected channel; otherwise 404 video_not_found).
+         *
+         */
+        videoId?: string;
     };
 };
 type GetYouTubeDemographicsResponse = (YouTubeDemographicsResponse);
@@ -14662,10 +14681,21 @@ type SendInboxMessageData = {
         }>;
         /**
          * Action buttons. Mutually exclusive with quickReplies. Max 3 items.
+         *
+         * WhatsApp: buttons always render as interactive reply buttons.
+         * Only `title` and `payload` are used — `type`, `url`, and `phone`
+         * are ignored (WhatsApp has no URL/phone button in this field; use
+         * the `interactive` field with `type: cta_url` for a link button).
+         * `payload` becomes the button reply ID delivered on the
+         * `message.received` webhook when the user taps. To send a simple
+         * reply-button message, provide `title` + `payload` and set
+         * `type: postback`, e.g.
+         * `{ "type": "postback", "title": "Yes", "payload": "yes" }`.
+         *
          */
         buttons?: Array<{
             /**
-             * Button type. phone is Facebook only.
+             * Button type. phone is Facebook only. Ignored on WhatsApp (buttons always render as reply buttons).
              */
             type: 'url' | 'postback' | 'phone';
             /**
@@ -14673,11 +14703,11 @@ type SendInboxMessageData = {
              */
             title: string;
             /**
-             * URL for url-type buttons
+             * URL for url-type buttons (Facebook/Instagram only)
              */
             url?: string;
             /**
-             * Payload for postback-type buttons
+             * Payload for postback-type buttons. On WhatsApp, this is the reply ID returned on the message.received webhook when the button is tapped.
              */
             payload?: string;
             /**
@@ -23412,16 +23442,16 @@ type BoostPostData = {
                 name?: string;
             }>;
             /**
-             * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
+             * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits (both set together, Meta only).
              */
             cities?: Array<{
                 key: string;
                 name?: string;
                 /**
-                 * Requires distance_unit.
+                 * Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
                  */
                 radius?: number;
-                distance_unit?: 'mile' | 'kilometer';
+                distanceUnit?: 'mile' | 'kilometer';
             }>;
             /**
              * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
@@ -23824,7 +23854,7 @@ type CreateStandaloneAdData = {
              */
             key: string;
             /**
-             * Optional radius around the city. Must be set together with distance_unit.
+             * Optional radius around the city. Must be set together with distance_unit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
              */
             radius?: number;
             /**
@@ -25863,6 +25893,10 @@ type CreateCtwaAdData = {
          * TargetingGeoLocationCity. `key` is Meta's city ID
          * (lookupable via GET /v1/ads/targeting/search). `radius`
          * and `distance_unit` are coupled: set both or neither.
+         * Meta enforces a minimum city radius (~17 km / 10 mi);
+         * smaller values resolve to a 0-size audience and the ad
+         * fails at launch. For a tighter catchment use customLocations
+         * (lat/lng).
          *
          */
         cities?: Array<{

package/dist/index.d.ts

@@ -4420,19 +4420,19 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
+     * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
      */
     cities?: Array<{
         key: string;
         name?: string;
         /**
-         * Radius around the city. Requires distance_unit.
+         * Radius around the city. Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng), which allows a smaller radius.
          */
         radius?: number;
         /**
          * Required if radius is set.
          */
-        distance_unit?: 'mile' | 'kilometer';
+        distanceUnit?: 'mile' | 'kilometer';
     }>;
     /**
      * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`). Supported on Meta, Google, TikTok, Pinterest, X.
@@ -4475,18 +4475,18 @@ type TargetingSpec = {
             name?: string;
         }>;
         /**
-         * Cities to exclude. Optional `radius` + `distance_unit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
+         * Cities to exclude. Optional `radius` + `distanceUnit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
          */
         cities?: Array<{
             key: string;
             /**
-             * Radius around the excluded city. Requires distance_unit.
+             * Radius around the excluded city. Requires distanceUnit.
              */
             radius?: number;
             /**
              * Required if radius is set.
              */
-            distance_unit?: 'mile' | 'kilometer';
+            distanceUnit?: 'mile' | 'kilometer';
         }>;
         zips?: Array<{
             key: string;
@@ -7195,6 +7195,18 @@ type YouTubeDemographicsResponse = {
      */
     accountId?: string;
     platform?: string;
+    /**
+     * Present only when demographics are scoped to a single video
+     */
+    videoId?: string;
+    /**
+     * Video title (video mode only)
+     */
+    title?: (string) | null;
+    /**
+     * Video publish date (video mode only)
+     */
+    publishedAt?: (string) | null;
     /**
      * Object keyed by breakdown dimension (age, gender, country)
      */
@@ -7910,10 +7922,17 @@ type GetYouTubeDemographicsData = {
          */
         endDate?: string;
         /**
-         * Start date in YYYY-MM-DD format. Defaults to 90 days ago.
+         * Start date in YYYY-MM-DD format. Defaults to 90 days ago, or to the video's
+         * publish date (lifetime) when videoId is provided.
          *
          */
         startDate?: string;
+        /**
+         * YouTube video ID. When provided, demographics are scoped to this single video
+         * (must belong to the connected channel; otherwise 404 video_not_found).
+         *
+         */
+        videoId?: string;
     };
 };
 type GetYouTubeDemographicsResponse = (YouTubeDemographicsResponse);
@@ -14662,10 +14681,21 @@ type SendInboxMessageData = {
         }>;
         /**
          * Action buttons. Mutually exclusive with quickReplies. Max 3 items.
+         *
+         * WhatsApp: buttons always render as interactive reply buttons.
+         * Only `title` and `payload` are used — `type`, `url`, and `phone`
+         * are ignored (WhatsApp has no URL/phone button in this field; use
+         * the `interactive` field with `type: cta_url` for a link button).
+         * `payload` becomes the button reply ID delivered on the
+         * `message.received` webhook when the user taps. To send a simple
+         * reply-button message, provide `title` + `payload` and set
+         * `type: postback`, e.g.
+         * `{ "type": "postback", "title": "Yes", "payload": "yes" }`.
+         *
          */
         buttons?: Array<{
             /**
-             * Button type. phone is Facebook only.
+             * Button type. phone is Facebook only. Ignored on WhatsApp (buttons always render as reply buttons).
              */
             type: 'url' | 'postback' | 'phone';
             /**
@@ -14673,11 +14703,11 @@ type SendInboxMessageData = {
              */
             title: string;
             /**
-             * URL for url-type buttons
+             * URL for url-type buttons (Facebook/Instagram only)
              */
             url?: string;
             /**
-             * Payload for postback-type buttons
+             * Payload for postback-type buttons. On WhatsApp, this is the reply ID returned on the message.received webhook when the button is tapped.
              */
             payload?: string;
             /**
@@ -23412,16 +23442,16 @@ type BoostPostData = {
                 name?: string;
             }>;
             /**
-             * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
+             * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits (both set together, Meta only).
              */
             cities?: Array<{
                 key: string;
                 name?: string;
                 /**
-                 * Requires distance_unit.
+                 * Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
                  */
                 radius?: number;
-                distance_unit?: 'mile' | 'kilometer';
+                distanceUnit?: 'mile' | 'kilometer';
             }>;
             /**
              * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
@@ -23824,7 +23854,7 @@ type CreateStandaloneAdData = {
              */
             key: string;
             /**
-             * Optional radius around the city. Must be set together with distance_unit.
+             * Optional radius around the city. Must be set together with distance_unit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
              */
             radius?: number;
             /**
@@ -25863,6 +25893,10 @@ type CreateCtwaAdData = {
          * TargetingGeoLocationCity. `key` is Meta's city ID
          * (lookupable via GET /v1/ads/targeting/search). `radius`
          * and `distance_unit` are coupled: set both or neither.
+         * Meta enforces a minimum city radius (~17 km / 10 mi);
+         * smaller values resolve to a 0-size audience and the ad
+         * fails at launch. For a tighter catchment use customLocations
+         * (lat/lng).
          *
          */
         cities?: Array<{

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -279,8 +279,11 @@ export const getInstagramDemographics = <ThrowOnError extends boolean = false>(o
 /**
  * Get YouTube demographics
  * Returns audience demographic insights for a YouTube channel, broken down by age, gender, and/or country.
+ * Pass videoId to get the audience profile of a single video instead of the whole channel.
  * Age and gender values are viewer percentages (0-100). Country values are view counts.
- * Data is based on signed-in viewers only, with a 2-3 day delay. Requires the Analytics add-on.
+ * Data is based on signed-in viewers only, with a 2-3 day delay. YouTube suppresses demographics
+ * for videos with too few signed-in views, so low-traffic videos can return empty breakdowns.
+ * Requires the Analytics add-on.
  *
  */
 export const getYouTubeDemographics = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetYouTubeDemographicsData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -3692,19 +3692,19 @@ export type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
+     * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
      */
     cities?: Array<{
         key: string;
         name?: string;
         /**
-         * Radius around the city. Requires distance_unit.
+         * Radius around the city. Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng), which allows a smaller radius.
          */
         radius?: number;
         /**
          * Required if radius is set.
          */
-        distance_unit?: 'mile' | 'kilometer';
+        distanceUnit?: 'mile' | 'kilometer';
     }>;
     /**
      * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`). Supported on Meta, Google, TikTok, Pinterest, X.
@@ -3747,18 +3747,18 @@ export type TargetingSpec = {
             name?: string;
         }>;
         /**
-         * Cities to exclude. Optional `radius` + `distance_unit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
+         * Cities to exclude. Optional `radius` + `distanceUnit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
          */
         cities?: Array<{
             key: string;
             /**
-             * Radius around the excluded city. Requires distance_unit.
+             * Radius around the excluded city. Requires distanceUnit.
              */
             radius?: number;
             /**
              * Required if radius is set.
              */
-            distance_unit?: 'mile' | 'kilometer';
+            distanceUnit?: 'mile' | 'kilometer';
         }>;
         zips?: Array<{
             key: string;
@@ -6577,6 +6577,18 @@ export type YouTubeDemographicsResponse = {
      */
     accountId?: string;
     platform?: string;
+    /**
+     * Present only when demographics are scoped to a single video
+     */
+    videoId?: string;
+    /**
+     * Video title (video mode only)
+     */
+    title?: (string) | null;
+    /**
+     * Video publish date (video mode only)
+     */
+    publishedAt?: (string) | null;
     /**
      * Object keyed by breakdown dimension (age, gender, country)
      */
@@ -7338,10 +7350,17 @@ export type GetYouTubeDemographicsData = {
          */
         endDate?: string;
         /**
-         * Start date in YYYY-MM-DD format. Defaults to 90 days ago.
+         * Start date in YYYY-MM-DD format. Defaults to 90 days ago, or to the video's
+         * publish date (lifetime) when videoId is provided.
          *
          */
         startDate?: string;
+        /**
+         * YouTube video ID. When provided, demographics are scoped to this single video
+         * (must belong to the connected channel; otherwise 404 video_not_found).
+         *
+         */
+        videoId?: string;
     };
 };
 
@@ -14594,10 +14613,21 @@ export type SendInboxMessageData = {
         }>;
         /**
          * Action buttons. Mutually exclusive with quickReplies. Max 3 items.
+         *
+         * WhatsApp: buttons always render as interactive reply buttons.
+         * Only `title` and `payload` are used — `type`, `url`, and `phone`
+         * are ignored (WhatsApp has no URL/phone button in this field; use
+         * the `interactive` field with `type: cta_url` for a link button).
+         * `payload` becomes the button reply ID delivered on the
+         * `message.received` webhook when the user taps. To send a simple
+         * reply-button message, provide `title` + `payload` and set
+         * `type: postback`, e.g.
+         * `{ "type": "postback", "title": "Yes", "payload": "yes" }`.
+         *
          */
         buttons?: Array<{
             /**
-             * Button type. phone is Facebook only.
+             * Button type. phone is Facebook only. Ignored on WhatsApp (buttons always render as reply buttons).
              */
             type: 'url' | 'postback' | 'phone';
             /**
@@ -14605,11 +14635,11 @@ export type SendInboxMessageData = {
              */
             title: string;
             /**
-             * URL for url-type buttons
+             * URL for url-type buttons (Facebook/Instagram only)
              */
             url?: string;
             /**
-             * Payload for postback-type buttons
+             * Payload for postback-type buttons. On WhatsApp, this is the reply ID returned on the message.received webhook when the button is tapped.
              */
             payload?: string;
             /**
@@ -24071,16 +24101,16 @@ export type BoostPostData = {
                 name?: string;
             }>;
             /**
-             * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
+             * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits (both set together, Meta only).
              */
             cities?: Array<{
                 key: string;
                 name?: string;
                 /**
-                 * Requires distance_unit.
+                 * Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
                  */
                 radius?: number;
-                distance_unit?: 'mile' | 'kilometer';
+                distanceUnit?: 'mile' | 'kilometer';
             }>;
             /**
              * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
@@ -24486,7 +24516,7 @@ export type CreateStandaloneAdData = {
              */
             key: string;
             /**
-             * Optional radius around the city. Must be set together with distance_unit.
+             * Optional radius around the city. Must be set together with distance_unit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
              */
             radius?: number;
             /**
@@ -26630,6 +26660,10 @@ export type CreateCtwaAdData = {
          * TargetingGeoLocationCity. `key` is Meta's city ID
          * (lookupable via GET /v1/ads/targeting/search). `radius`
          * and `distance_unit` are coupled: set both or neither.
+         * Meta enforces a minimum city radius (~17 km / 10 mi);
+         * smaller values resolve to a 0-size audience and the ad
+         * fails at launch. For a tighter catchment use customLocations
+         * (lat/lng).
          *
          */
         cities?: Array<{