@getlatedev/node 0.2.1129 → 0.2.1131

package/dist/index.d.mts

@@ -2933,7 +2933,7 @@ type AdMetrics = {
     cpm?: number;
     engagement?: number;
     /**
-     * Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
+     * Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: the ad set's Ads Manager Results, derived per ad set: the optimization goal's result (LEAD_GENERATION and QUALITY_LEAD = leads, CONVERSATIONS = messaging conversations started, APP_INSTALLS = installs, LANDING_PAGE_VIEWS = landing page views, LINK_CLICKS = link clicks, THRUPLAY = ThruPlays; REACH, IMPRESSIONS, POST_ENGAGEMENT and PAGE_LIKES report 0), otherwise the promoted_object event (custom_conversion_id when set, else custom_event_type, else PURCHASE). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
      */
     conversions?: number;
     /**
@@ -2957,7 +2957,7 @@ type AdMetrics = {
         [key: string]: (number);
     };
     /**
-     * Convenience sum of purchase-type action values, picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only.
+     * Convenience sum of purchase-type action values, picked from `actionValues` for the ad set promoted_object event (custom conversion, custom_event_type, else PURCHASE). It matches `conversions` for conversion-optimized ad sets; when the optimization goal reports a different result (LINK_CLICKS, LANDING_PAGE_VIEWS, ...) it stays on the promoted event so ROAS keeps its purchase basis. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only.
      */
     purchaseValue?: number;
     /**
@@ -3277,7 +3277,7 @@ type AdsTimelineResponse = {
          */
         cpm?: number;
         /**
-         * Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
+         * Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: the ad set Ads Manager Results (see AdMetrics.conversions). Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
          */
         conversions?: number;
         /**
@@ -22044,7 +22044,17 @@ type ConfigureTikTokAdsBrandIdentityResponse = ({
 });
 type ConfigureTikTokAdsBrandIdentityError = (unknown | ErrorResponse);
 type ListFacebookPagesData = {
+    headers?: {
+        /**
+         * The OAuth user token, in place of the tempToken query parameter. Prefer it: a query string is written to request logs along the way.
+         */
+        'X-Temp-Token'?: string;
+    };
     query?: {
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Profile ID from your classic connection flow. Required with tempToken.
          */
@@ -22054,7 +22064,7 @@ type ListFacebookPagesData = {
          */
         selectionToken?: string;
         /**
-         * Temporary Facebook access token from the classic OAuth callback. Required with profileId.
+         * Temporary Facebook access token from the classic OAuth callback. Required with profileId unless sent in the X-Temp-Token header.
          */
         tempToken?: string;
     };
@@ -22109,9 +22119,13 @@ type SelectFacebookPageData = {
          */
         pageIds?: Array<(string)>;
         /**
-         * Temporary Facebook access token from OAuth.
+         * Temporary Facebook access token from OAuth. Required unless sent in the X-Temp-Token header.
          */
-        tempToken: string;
+        tempToken?: string;
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Decoded user profile object from the OAuth callback.
          */
@@ -22177,15 +22191,25 @@ type SelectFacebookPageResponse = ({
 });
 type SelectFacebookPageError = (unknown | ErrorResponse);
 type ListInstagramPagesData = {
+    headers?: {
+        /**
+         * The OAuth user token, in place of the tempToken query parameter. Prefer it: a query string is written to request logs along the way.
+         */
+        'X-Temp-Token'?: string;
+    };
     query: {
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Profile ID from your connection flow
          */
         profileId: string;
         /**
-         * Long-lived Facebook user access token from the OAuth callback redirect
+         * Long-lived Facebook user access token from the OAuth callback redirect. Required unless sent in the X-Temp-Token header.
          */
-        tempToken: string;
+        tempToken?: string;
     };
 };
 type ListInstagramPagesResponse = ({
@@ -22231,9 +22255,13 @@ type SelectInstagramAccountData = {
          */
         pageIds?: Array<(string)>;
         /**
-         * Long-lived Facebook user access token from the OAuth callback redirect
+         * Long-lived Facebook user access token from the OAuth callback redirect. Required unless sent in the X-Temp-Token header.
          */
-        tempToken: string;
+        tempToken?: string;
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Optional custom redirect URL to return to after selection
          */

package/dist/index.d.ts

@@ -2933,7 +2933,7 @@ type AdMetrics = {
     cpm?: number;
     engagement?: number;
     /**
-     * Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
+     * Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: the ad set's Ads Manager Results, derived per ad set: the optimization goal's result (LEAD_GENERATION and QUALITY_LEAD = leads, CONVERSATIONS = messaging conversations started, APP_INSTALLS = installs, LANDING_PAGE_VIEWS = landing page views, LINK_CLICKS = link clicks, THRUPLAY = ThruPlays; REACH, IMPRESSIONS, POST_ENGAGEMENT and PAGE_LIKES report 0), otherwise the promoted_object event (custom_conversion_id when set, else custom_event_type, else PURCHASE). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
      */
     conversions?: number;
     /**
@@ -2957,7 +2957,7 @@ type AdMetrics = {
         [key: string]: (number);
     };
     /**
-     * Convenience sum of purchase-type action values, picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only.
+     * Convenience sum of purchase-type action values, picked from `actionValues` for the ad set promoted_object event (custom conversion, custom_event_type, else PURCHASE). It matches `conversions` for conversion-optimized ad sets; when the optimization goal reports a different result (LINK_CLICKS, LANDING_PAGE_VIEWS, ...) it stays on the promoted event so ROAS keeps its purchase basis. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only.
      */
     purchaseValue?: number;
     /**
@@ -3277,7 +3277,7 @@ type AdsTimelineResponse = {
          */
         cpm?: number;
         /**
-         * Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
+         * Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: the ad set Ads Manager Results (see AdMetrics.conversions). Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
          */
         conversions?: number;
         /**
@@ -22044,7 +22044,17 @@ type ConfigureTikTokAdsBrandIdentityResponse = ({
 });
 type ConfigureTikTokAdsBrandIdentityError = (unknown | ErrorResponse);
 type ListFacebookPagesData = {
+    headers?: {
+        /**
+         * The OAuth user token, in place of the tempToken query parameter. Prefer it: a query string is written to request logs along the way.
+         */
+        'X-Temp-Token'?: string;
+    };
     query?: {
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Profile ID from your classic connection flow. Required with tempToken.
          */
@@ -22054,7 +22064,7 @@ type ListFacebookPagesData = {
          */
         selectionToken?: string;
         /**
-         * Temporary Facebook access token from the classic OAuth callback. Required with profileId.
+         * Temporary Facebook access token from the classic OAuth callback. Required with profileId unless sent in the X-Temp-Token header.
          */
         tempToken?: string;
     };
@@ -22109,9 +22119,13 @@ type SelectFacebookPageData = {
          */
         pageIds?: Array<(string)>;
         /**
-         * Temporary Facebook access token from OAuth.
+         * Temporary Facebook access token from OAuth. Required unless sent in the X-Temp-Token header.
          */
-        tempToken: string;
+        tempToken?: string;
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Decoded user profile object from the OAuth callback.
          */
@@ -22177,15 +22191,25 @@ type SelectFacebookPageResponse = ({
 });
 type SelectFacebookPageError = (unknown | ErrorResponse);
 type ListInstagramPagesData = {
+    headers?: {
+        /**
+         * The OAuth user token, in place of the tempToken query parameter. Prefer it: a query string is written to request logs along the way.
+         */
+        'X-Temp-Token'?: string;
+    };
     query: {
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Profile ID from your connection flow
          */
         profileId: string;
         /**
-         * Long-lived Facebook user access token from the OAuth callback redirect
+         * Long-lived Facebook user access token from the OAuth callback redirect. Required unless sent in the X-Temp-Token header.
          */
-        tempToken: string;
+        tempToken?: string;
     };
 };
 type ListInstagramPagesResponse = ({
@@ -22231,9 +22255,13 @@ type SelectInstagramAccountData = {
          */
         pageIds?: Array<(string)>;
         /**
-         * Long-lived Facebook user access token from the OAuth callback redirect
+         * Long-lived Facebook user access token from the OAuth callback redirect. Required unless sent in the X-Temp-Token header.
          */
-        tempToken: string;
+        tempToken?: string;
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Optional custom redirect URL to return to after selection
          */

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -962,7 +962,7 @@ export type AdMetrics = {
     cpm?: number;
     engagement?: number;
     /**
-     * Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
+     * Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: the ad set's Ads Manager Results, derived per ad set: the optimization goal's result (LEAD_GENERATION and QUALITY_LEAD = leads, CONVERSATIONS = messaging conversations started, APP_INSTALLS = installs, LANDING_PAGE_VIEWS = landing page views, LINK_CLICKS = link clicks, THRUPLAY = ThruPlays; REACH, IMPRESSIONS, POST_ENGAGEMENT and PAGE_LIKES report 0), otherwise the promoted_object event (custom_conversion_id when set, else custom_event_type, else PURCHASE). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
      */
     conversions?: number;
     /**
@@ -986,7 +986,7 @@ export type AdMetrics = {
         [key: string]: (number);
     };
     /**
-     * Convenience sum of purchase-type action values, picked from `actionValues` via the same priority list as `conversions` so both fields describe the same events. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only.
+     * Convenience sum of purchase-type action values, picked from `actionValues` for the ad set promoted_object event (custom conversion, custom_event_type, else PURCHASE). It matches `conversions` for conversion-optimized ad sets; when the optimization goal reports a different result (LINK_CLICKS, LANDING_PAGE_VIEWS, ...) it stays on the promoted event so ROAS keeps its purchase basis. In ad-account native currency. 0 when the campaign has no purchase event configured. Meta-only.
      */
     purchaseValue?: number;
     /**
@@ -1318,7 +1318,7 @@ export type AdsTimelineResponse = {
          */
         cpm?: number;
         /**
-         * Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
+         * Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: the ad set Ads Manager Results (see AdMetrics.conversions). Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
          */
         conversions?: number;
         /**
@@ -21020,7 +21020,17 @@ export type ConfigureTikTokAdsBrandIdentityResponse = ({
 export type ConfigureTikTokAdsBrandIdentityError = (unknown | ErrorResponse);
 
 export type ListFacebookPagesData = {
+    headers?: {
+        /**
+         * The OAuth user token, in place of the tempToken query parameter. Prefer it: a query string is written to request logs along the way.
+         */
+        'X-Temp-Token'?: string;
+    };
     query?: {
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Profile ID from your classic connection flow. Required with tempToken.
          */
@@ -21030,7 +21040,7 @@ export type ListFacebookPagesData = {
          */
         selectionToken?: string;
         /**
-         * Temporary Facebook access token from the classic OAuth callback. Required with profileId.
+         * Temporary Facebook access token from the classic OAuth callback. Required with profileId unless sent in the X-Temp-Token header.
          */
         tempToken?: string;
     };
@@ -21088,9 +21098,13 @@ export type SelectFacebookPageData = {
      */
     pageIds?: Array<(string)>;
     /**
-     * Temporary Facebook access token from OAuth.
+     * Temporary Facebook access token from OAuth. Required unless sent in the X-Temp-Token header.
      */
-    tempToken: string;
+    tempToken?: string;
+    /**
+     * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+     */
+    connectFlow?: string;
     /**
      * Decoded user profile object from the OAuth callback.
      */
@@ -21159,15 +21173,25 @@ export type SelectFacebookPageResponse = ({
 export type SelectFacebookPageError = (unknown | ErrorResponse);
 
 export type ListInstagramPagesData = {
+    headers?: {
+        /**
+         * The OAuth user token, in place of the tempToken query parameter. Prefer it: a query string is written to request logs along the way.
+         */
+        'X-Temp-Token'?: string;
+    };
     query: {
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Profile ID from your connection flow
          */
         profileId: string;
         /**
-         * Long-lived Facebook user access token from the OAuth callback redirect
+         * Long-lived Facebook user access token from the OAuth callback redirect. Required unless sent in the X-Temp-Token header.
          */
-        tempToken: string;
+        tempToken?: string;
     };
 };
 
@@ -21216,9 +21240,13 @@ export type SelectInstagramAccountData = {
          */
         pageIds?: Array<(string)>;
         /**
-         * Long-lived Facebook user access token from the OAuth callback redirect
+         * Long-lived Facebook user access token from the OAuth callback redirect. Required unless sent in the X-Temp-Token header.
          */
-        tempToken: string;
+        tempToken?: string;
+        /**
+         * Set by the Zernio-hosted picker, whose user token stays in an httpOnly cookie. Integrators send tempToken instead.
+         */
+        connectFlow?: string;
         /**
          * Optional custom redirect URL to return to after selection
          */