@zernio/node 0.2.541 → 0.2.543

package/dist/index.d.mts

@@ -5036,11 +5036,11 @@ type MediaUploadResponse = {
 type MetaAdsPlatformData = {
     bidStrategy?: BidStrategy;
     /**
-     * Whole currency units (USD: 5 = $5.00). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP.
+     * Whole currency units (USD: 5 = $5.00). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. May also be sent alone, WITHOUT bidStrategy, to set the cap on an ad set joining a COST_CAP / LOWEST_COST_WITH_BID_CAP campaign (the strategy is inherited from the campaign). On POST /v1/ads/create that shape requires existingCampaignId and is a 400 otherwise; on POST /v1/ads/boost it is promoted to LOWEST_COST_WITH_BID_CAP.
      */
     bidAmount?: number;
     /**
-     * Decimal ROAS multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS.
+     * Decimal ROAS multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS; sending it without bidStrategy is a 400.
      */
     roasAverageFloor?: number;
 };
@@ -24810,6 +24810,10 @@ type ListBroadcastRecipientsResponse = ({
          * Plain-language translation of errorCode (e.g. for 131026, that the recipient has likely opted out of marketing messages). Null for unmapped codes; fall back to error.
          */
         errorExplanation?: (string) | null;
+        /**
+         * Meta trace id (fbtrace_id) for the failed send. Quote this when escalating to Meta Direct Support. Only populated for status=failed on Meta platforms.
+         */
+        errorTraceId?: (string) | null;
         sentAt?: string;
         deliveredAt?: string;
         readAt?: string;
@@ -26407,7 +26411,7 @@ type CreateAdCampaignData = {
          */
         bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
         /**
-         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise.
+         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise. Validated here but NOT stored by Meta: the campaign object has no bid_amount field, only bid_strategy lives on it. The amount takes effect once an ad set joins this campaign (existingCampaignId on POST /v1/ads/create) and supplies its own bidAmount there.
          */
         bidAmount?: number;
         /**
@@ -26794,7 +26798,10 @@ type UpdateAdSetData = {
         /**
          * Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when
          * bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's
-         * smallest-denomination integer, or (on OpenAI) to micros (× 1,000,000).
+         * smallest-denomination integer, or (on OpenAI) to micros (× 1,000,000). Meta only:
+         * may be sent alone, WITHOUT bidStrategy, to update the cap amount on an ad set whose
+         * parent campaign is COST_CAP or LOWEST_COST_WITH_BID_CAP (the strategy is inherited
+         * from the campaign and is left untouched).
          *
          */
         bidAmount?: number;
@@ -29747,7 +29754,14 @@ type CreateStandaloneAdData = {
          * Deprecated: send it inside `platformSpecificData` instead (Meta today; TikTok's nested shape is planned). The flat field keeps working during the deprecation window; sending both shapes returns a 400.
          *
          * Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when
-         * `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`.
+         * `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`. Meta only: sending
+         * `bidAmount` WITHOUT `bidStrategy` requires `existingCampaignId` (400 otherwise),
+         * and sets the new ad set's cap under the joined campaign's COST_CAP /
+         * LOWEST_COST_WITH_BID_CAP parent. The strategy itself is inherited from the
+         * campaign. Restating bidStrategy here is accepted but has no effect on the ad set.
+         *
+         * Rejected with 400 in `adSetId` attach mode: that shape inherits its cap from
+         * the platform. Use `PUT /v1/ads/ad-sets/{adSetId}` there instead.
          *
          * @deprecated
          */
@@ -29756,8 +29770,11 @@ type CreateStandaloneAdData = {
          * Deprecated: send it inside `platformSpecificData` instead (Meta today; TikTok's nested shape is planned). The flat field keeps working during the deprecation window; sending both shapes returns a 400.
          *
          * Minimum ROAS as a decimal multiplier (e.g. 2.0 = 2.0x ROAS). Required when
-         * `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`. Sent to Meta as
-         * `bid_constraints.roas_average_floor` × 10000.
+         * `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`. Sending it without `bidStrategy`
+         * is a 400. Sent to Meta as
+         * `bid_constraints.roas_average_floor` × 10000. Known gap: a CBO campaign's
+         * ROAS floor lives on the campaign only (set via `POST /v1/ads/campaigns`);
+         * there is no supported way to set it while joining a CBO campaign here.
          *
          * @deprecated
          */
@@ -29797,7 +29814,8 @@ type CreateStandaloneAdData = {
          * **Meta**: `bidStrategy`, `bidAmount` and `roasAverageFloor` may be
          * sent here instead of at the root — the preferred home going forward.
          * Sending the bid fields in BOTH places returns a 400
-         * (`mutually_exclusive_fields`).
+         * (`mutually_exclusive_fields`), and sending any of them in
+         * `adSetId` attach mode is a 400 too (the ad set already has its bid).
          *
          */
         platformSpecificData?: (LinkedInAdsPlatformData | MetaAdsPlatformData);

package/dist/index.d.ts

@@ -5036,11 +5036,11 @@ type MediaUploadResponse = {
 type MetaAdsPlatformData = {
     bidStrategy?: BidStrategy;
     /**
-     * Whole currency units (USD: 5 = $5.00). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP.
+     * Whole currency units (USD: 5 = $5.00). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. May also be sent alone, WITHOUT bidStrategy, to set the cap on an ad set joining a COST_CAP / LOWEST_COST_WITH_BID_CAP campaign (the strategy is inherited from the campaign). On POST /v1/ads/create that shape requires existingCampaignId and is a 400 otherwise; on POST /v1/ads/boost it is promoted to LOWEST_COST_WITH_BID_CAP.
      */
     bidAmount?: number;
     /**
-     * Decimal ROAS multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS.
+     * Decimal ROAS multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS; sending it without bidStrategy is a 400.
      */
     roasAverageFloor?: number;
 };
@@ -24810,6 +24810,10 @@ type ListBroadcastRecipientsResponse = ({
          * Plain-language translation of errorCode (e.g. for 131026, that the recipient has likely opted out of marketing messages). Null for unmapped codes; fall back to error.
          */
         errorExplanation?: (string) | null;
+        /**
+         * Meta trace id (fbtrace_id) for the failed send. Quote this when escalating to Meta Direct Support. Only populated for status=failed on Meta platforms.
+         */
+        errorTraceId?: (string) | null;
         sentAt?: string;
         deliveredAt?: string;
         readAt?: string;
@@ -26407,7 +26411,7 @@ type CreateAdCampaignData = {
          */
         bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
         /**
-         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise.
+         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise. Validated here but NOT stored by Meta: the campaign object has no bid_amount field, only bid_strategy lives on it. The amount takes effect once an ad set joins this campaign (existingCampaignId on POST /v1/ads/create) and supplies its own bidAmount there.
          */
         bidAmount?: number;
         /**
@@ -26794,7 +26798,10 @@ type UpdateAdSetData = {
         /**
          * Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when
          * bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's
-         * smallest-denomination integer, or (on OpenAI) to micros (× 1,000,000).
+         * smallest-denomination integer, or (on OpenAI) to micros (× 1,000,000). Meta only:
+         * may be sent alone, WITHOUT bidStrategy, to update the cap amount on an ad set whose
+         * parent campaign is COST_CAP or LOWEST_COST_WITH_BID_CAP (the strategy is inherited
+         * from the campaign and is left untouched).
          *
          */
         bidAmount?: number;
@@ -29747,7 +29754,14 @@ type CreateStandaloneAdData = {
          * Deprecated: send it inside `platformSpecificData` instead (Meta today; TikTok's nested shape is planned). The flat field keeps working during the deprecation window; sending both shapes returns a 400.
          *
          * Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when
-         * `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`.
+         * `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`. Meta only: sending
+         * `bidAmount` WITHOUT `bidStrategy` requires `existingCampaignId` (400 otherwise),
+         * and sets the new ad set's cap under the joined campaign's COST_CAP /
+         * LOWEST_COST_WITH_BID_CAP parent. The strategy itself is inherited from the
+         * campaign. Restating bidStrategy here is accepted but has no effect on the ad set.
+         *
+         * Rejected with 400 in `adSetId` attach mode: that shape inherits its cap from
+         * the platform. Use `PUT /v1/ads/ad-sets/{adSetId}` there instead.
          *
          * @deprecated
          */
@@ -29756,8 +29770,11 @@ type CreateStandaloneAdData = {
          * Deprecated: send it inside `platformSpecificData` instead (Meta today; TikTok's nested shape is planned). The flat field keeps working during the deprecation window; sending both shapes returns a 400.
          *
          * Minimum ROAS as a decimal multiplier (e.g. 2.0 = 2.0x ROAS). Required when
-         * `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`. Sent to Meta as
-         * `bid_constraints.roas_average_floor` × 10000.
+         * `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`. Sending it without `bidStrategy`
+         * is a 400. Sent to Meta as
+         * `bid_constraints.roas_average_floor` × 10000. Known gap: a CBO campaign's
+         * ROAS floor lives on the campaign only (set via `POST /v1/ads/campaigns`);
+         * there is no supported way to set it while joining a CBO campaign here.
          *
          * @deprecated
          */
@@ -29797,7 +29814,8 @@ type CreateStandaloneAdData = {
          * **Meta**: `bidStrategy`, `bidAmount` and `roasAverageFloor` may be
          * sent here instead of at the root — the preferred home going forward.
          * Sending the bid fields in BOTH places returns a 400
-         * (`mutually_exclusive_fields`).
+         * (`mutually_exclusive_fields`), and sending any of them in
+         * `adSetId` attach mode is a 400 too (the ad set already has its bid).
          *
          */
         platformSpecificData?: (LinkedInAdsPlatformData | MetaAdsPlatformData);

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -7175,6 +7175,10 @@ export const getAdSetDetails = <ThrowOnError extends boolean = false>(options: O
  * - `LOWEST_COST_WITHOUT_CAP`: no `bidAmount`, no `roasAverageFloor`.
  * - `LOWEST_COST_WITH_BID_CAP` / `COST_CAP`: `bidAmount` REQUIRED (whole currency units).
  * - `LOWEST_COST_WITH_MIN_ROAS`: `roasAverageFloor` REQUIRED (decimal multiplier, e.g. 2.0 = 2.0x ROAS).
+ * - Meta only: send `bidAmount` WITHOUT `bidStrategy` to change the cap amount on an ad set
+ * under a COST_CAP / LOWEST_COST_WITH_BID_CAP parent campaign, leaving the strategy itself
+ * (inherited from the campaign) untouched. `roasAverageFloor` without `bidStrategy` is
+ * rejected (it has no meaning outside LOWEST_COST_WITH_MIN_ROAS).
  *
  * Delivery settings are validated by Meta against the campaign objective;
  * incompatible combinations (e.g. a billingEvent the optimization goal

package/src/generated/types.gen.ts

@@ -3921,11 +3921,11 @@ export type MediaUploadResponse = {
 export type MetaAdsPlatformData = {
     bidStrategy?: BidStrategy;
     /**
-     * Whole currency units (USD: 5 = $5.00). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP.
+     * Whole currency units (USD: 5 = $5.00). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. May also be sent alone, WITHOUT bidStrategy, to set the cap on an ad set joining a COST_CAP / LOWEST_COST_WITH_BID_CAP campaign (the strategy is inherited from the campaign). On POST /v1/ads/create that shape requires existingCampaignId and is a 400 otherwise; on POST /v1/ads/boost it is promoted to LOWEST_COST_WITH_BID_CAP.
      */
     bidAmount?: number;
     /**
-     * Decimal ROAS multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS.
+     * Decimal ROAS multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS; sending it without bidStrategy is a 400.
      */
     roasAverageFloor?: number;
 };
@@ -25081,6 +25081,10 @@ export type ListBroadcastRecipientsResponse = ({
          * Plain-language translation of errorCode (e.g. for 131026, that the recipient has likely opted out of marketing messages). Null for unmapped codes; fall back to error.
          */
         errorExplanation?: (string) | null;
+        /**
+         * Meta trace id (fbtrace_id) for the failed send. Quote this when escalating to Meta Direct Support. Only populated for status=failed on Meta platforms.
+         */
+        errorTraceId?: (string) | null;
         sentAt?: string;
         deliveredAt?: string;
         readAt?: string;
@@ -26785,7 +26789,7 @@ export type CreateAdCampaignData = {
          */
         bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
         /**
-         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise.
+         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise. Validated here but NOT stored by Meta: the campaign object has no bid_amount field, only bid_strategy lives on it. The amount takes effect once an ad set joins this campaign (existingCampaignId on POST /v1/ads/create) and supplies its own bidAmount there.
          */
         bidAmount?: number;
         /**
@@ -27199,7 +27203,10 @@ export type UpdateAdSetData = {
         /**
          * Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when
          * bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's
-         * smallest-denomination integer, or (on OpenAI) to micros (× 1,000,000).
+         * smallest-denomination integer, or (on OpenAI) to micros (× 1,000,000). Meta only:
+         * may be sent alone, WITHOUT bidStrategy, to update the cap amount on an ad set whose
+         * parent campaign is COST_CAP or LOWEST_COST_WITH_BID_CAP (the strategy is inherited
+         * from the campaign and is left untouched).
          *
          */
         bidAmount?: number;
@@ -30293,7 +30300,14 @@ export type CreateStandaloneAdData = {
          * Deprecated: send it inside `platformSpecificData` instead (Meta today; TikTok's nested shape is planned). The flat field keeps working during the deprecation window; sending both shapes returns a 400.
          *
          * Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when
-         * `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`.
+         * `bidStrategy` is `LOWEST_COST_WITH_BID_CAP` or `COST_CAP`. Meta only: sending
+         * `bidAmount` WITHOUT `bidStrategy` requires `existingCampaignId` (400 otherwise),
+         * and sets the new ad set's cap under the joined campaign's COST_CAP /
+         * LOWEST_COST_WITH_BID_CAP parent. The strategy itself is inherited from the
+         * campaign. Restating bidStrategy here is accepted but has no effect on the ad set.
+         *
+         * Rejected with 400 in `adSetId` attach mode: that shape inherits its cap from
+         * the platform. Use `PUT /v1/ads/ad-sets/{adSetId}` there instead.
          *
          * @deprecated
          */
@@ -30302,8 +30316,11 @@ export type CreateStandaloneAdData = {
          * Deprecated: send it inside `platformSpecificData` instead (Meta today; TikTok's nested shape is planned). The flat field keeps working during the deprecation window; sending both shapes returns a 400.
          *
          * Minimum ROAS as a decimal multiplier (e.g. 2.0 = 2.0x ROAS). Required when
-         * `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`. Sent to Meta as
-         * `bid_constraints.roas_average_floor` × 10000.
+         * `bidStrategy` is `LOWEST_COST_WITH_MIN_ROAS`. Sending it without `bidStrategy`
+         * is a 400. Sent to Meta as
+         * `bid_constraints.roas_average_floor` × 10000. Known gap: a CBO campaign's
+         * ROAS floor lives on the campaign only (set via `POST /v1/ads/campaigns`);
+         * there is no supported way to set it while joining a CBO campaign here.
          *
          * @deprecated
          */
@@ -30343,7 +30360,8 @@ export type CreateStandaloneAdData = {
          * **Meta**: `bidStrategy`, `bidAmount` and `roasAverageFloor` may be
          * sent here instead of at the root — the preferred home going forward.
          * Sending the bid fields in BOTH places returns a 400
-         * (`mutually_exclusive_fields`).
+         * (`mutually_exclusive_fields`), and sending any of them in
+         * `adSetId` attach mode is a 400 too (the ad set already has its bid).
          *
          */
         platformSpecificData?: (LinkedInAdsPlatformData | MetaAdsPlatformData);