@zernio/node 0.2.77 → 0.2.79

package/dist/index.d.mts

@@ -928,6 +928,20 @@ type AdMetrics = {
     actions?: {
         [key: string]: (number);
     };
+    /**
+     * Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}.
+     */
+    actionValues?: {
+        [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.
+     */
+    purchaseValue?: number;
+    /**
+     * Return on ad spend — derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level.
+     */
+    roas?: number;
     /**
      * Present on individual ads only, not on campaign aggregations
      */
@@ -7474,10 +7488,6 @@ type GetDiscordSettingsError = (unknown | {
 });
 type UpdateDiscordSettingsData = {
     body: {
-        /**
-         * Discord account ID
-         */
-        accountId: string;
         /**
          * Custom display name for the webhook (1-80 chars). Empty string resets to default ("Zernio"). Cannot contain "clyde" or "discord".
          */
@@ -11644,7 +11654,7 @@ type ListAdsData = {
          */
         profileId?: string;
         /**
-         * zernio = Zernio-created only, all = include external ads
+         * all (default) = Zernio-created + platform-discovered ads. zernio = restrict to Zernio-created only.
          */
         source?: 'zernio' | 'all';
         status?: AdStatus;
@@ -11682,7 +11692,7 @@ type ListAdCampaignsData = {
          */
         profileId?: string;
         /**
-         * `zernio` (default) returns only ads created via Zernio (isExternal=false). `all` additionally returns ads discovered from the platform's ad manager (isExternal=true). Status is NOT filtered by default — use the `status` param for that.
+         * `all` (default) returns both Zernio-created ads and those discovered from the platform's ad manager — matches the web UI's default view. Pass `zernio` to restrict to isExternal=false only. Status is NOT filtered by default — use the `status` param for that.
          */
         source?: 'zernio' | 'all';
         /**
@@ -11925,7 +11935,7 @@ type GetAdTreeData = {
          */
         profileId?: string;
         /**
-         * `zernio` (default) returns only ads created via Zernio (isExternal=false). `all` additionally returns ads discovered from the platform's ad manager (isExternal=true). Status is NOT filtered by default — use the `status` param for that.
+         * `all` (default) returns both Zernio-created ads and those discovered from the platform's ad manager — matches the web UI's default view. Pass `zernio` to restrict to isExternal=false only. Status is NOT filtered by default — use the `status` param for that.
          */
         source?: 'zernio' | 'all';
         /**

package/dist/index.d.ts

@@ -928,6 +928,20 @@ type AdMetrics = {
     actions?: {
         [key: string]: (number);
     };
+    /**
+     * Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}.
+     */
+    actionValues?: {
+        [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.
+     */
+    purchaseValue?: number;
+    /**
+     * Return on ad spend — derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level.
+     */
+    roas?: number;
     /**
      * Present on individual ads only, not on campaign aggregations
      */
@@ -7474,10 +7488,6 @@ type GetDiscordSettingsError = (unknown | {
 });
 type UpdateDiscordSettingsData = {
     body: {
-        /**
-         * Discord account ID
-         */
-        accountId: string;
         /**
          * Custom display name for the webhook (1-80 chars). Empty string resets to default ("Zernio"). Cannot contain "clyde" or "discord".
          */
@@ -11644,7 +11654,7 @@ type ListAdsData = {
          */
         profileId?: string;
         /**
-         * zernio = Zernio-created only, all = include external ads
+         * all (default) = Zernio-created + platform-discovered ads. zernio = restrict to Zernio-created only.
          */
         source?: 'zernio' | 'all';
         status?: AdStatus;
@@ -11682,7 +11692,7 @@ type ListAdCampaignsData = {
          */
         profileId?: string;
         /**
-         * `zernio` (default) returns only ads created via Zernio (isExternal=false). `all` additionally returns ads discovered from the platform's ad manager (isExternal=true). Status is NOT filtered by default — use the `status` param for that.
+         * `all` (default) returns both Zernio-created ads and those discovered from the platform's ad manager — matches the web UI's default view. Pass `zernio` to restrict to isExternal=false only. Status is NOT filtered by default — use the `status` param for that.
          */
         source?: 'zernio' | 'all';
         /**
@@ -11925,7 +11935,7 @@ type GetAdTreeData = {
          */
         profileId?: string;
         /**
-         * `zernio` (default) returns only ads created via Zernio (isExternal=false). `all` additionally returns ads discovered from the platform's ad manager (isExternal=true). Status is NOT filtered by default — use the `status` param for that.
+         * `all` (default) returns both Zernio-created ads and those discovered from the platform's ad manager — matches the web UI's default view. Pass `zernio` to restrict to isExternal=false only. Status is NOT filtered by default — use the `status` param for that.
          */
         source?: 'zernio' | 'all';
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.77",
+  "version": "0.2.79",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/types.gen.ts

@@ -343,6 +343,20 @@ export type AdMetrics = {
     actions?: {
         [key: string]: (number);
     };
+    /**
+     * Monetary mirror of `actions`, from Meta's Insights `action_values[]` array. Same keying — values are the revenue attributed to each action_type, in ad-account native currency (same unit as `spend`; see the campaign node's `currency` field). Use this to compute revenue-per-event (e.g. avg purchase value). Meta-only; other platforms return {}.
+     */
+    actionValues?: {
+        [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.
+     */
+    purchaseValue?: number;
+    /**
+     * Return on ad spend — derived as `purchaseValue / spend`. 0 when `spend` is 0. Equivalent to Meta's `purchase_roas` under default attribution. At ad-set and campaign levels this is recomputed from summed purchaseValue + spend (NOT averaged across children) so it's mathematically correct at every rollup level.
+     */
+    roas?: number;
     /**
      * Present on individual ads only, not on campaign aggregations
      */
@@ -7356,10 +7370,6 @@ export type GetDiscordSettingsError = (unknown | {
 
 export type UpdateDiscordSettingsData = {
     body: {
-        /**
-         * Discord account ID
-         */
-        accountId: string;
         /**
          * Custom display name for the webhook (1-80 chars). Empty string resets to default ("Zernio"). Cannot contain "clyde" or "discord".
          */
@@ -11906,7 +11916,7 @@ export type ListAdsData = {
          */
         profileId?: string;
         /**
-         * zernio = Zernio-created only, all = include external ads
+         * all (default) = Zernio-created + platform-discovered ads. zernio = restrict to Zernio-created only.
          */
         source?: 'zernio' | 'all';
         status?: AdStatus;
@@ -11947,7 +11957,7 @@ export type ListAdCampaignsData = {
          */
         profileId?: string;
         /**
-         * `zernio` (default) returns only ads created via Zernio (isExternal=false). `all` additionally returns ads discovered from the platform's ad manager (isExternal=true). Status is NOT filtered by default — use the `status` param for that.
+         * `all` (default) returns both Zernio-created ads and those discovered from the platform's ad manager — matches the web UI's default view. Pass `zernio` to restrict to isExternal=false only. Status is NOT filtered by default — use the `status` param for that.
          */
         source?: 'zernio' | 'all';
         /**
@@ -12214,7 +12224,7 @@ export type GetAdTreeData = {
          */
         profileId?: string;
         /**
-         * `zernio` (default) returns only ads created via Zernio (isExternal=false). `all` additionally returns ads discovered from the platform's ad manager (isExternal=true). Status is NOT filtered by default — use the `status` param for that.
+         * `all` (default) returns both Zernio-created ads and those discovered from the platform's ad manager — matches the web UI's default view. Pass `zernio` to restrict to isExternal=false only. Status is NOT filtered by default — use the `status` param for that.
          */
         source?: 'zernio' | 'all';
         /**