@zernio/node 0.2.699 → 0.2.701

package/dist/index.d.mts

@@ -4253,7 +4253,7 @@ type ErrorResponse = {
         [key: string]: unknown;
     };
     /**
-     * Additional structured context (e.g. field-level validation errors).
+     * Additional structured context (e.g. field-level validation errors), for example `privateReplyConsumed` on the private-reply endpoint's 400 when the comment's single reply is already spent.
      */
     details?: {
         [key: string]: unknown;
@@ -5857,6 +5857,14 @@ type MetaAdsPlatformData = {
      * 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;
+    /**
+     * Meta daily_min_spend_target on the ad set being created: the least it should spend per day, in whole currency units. It reserves a share of a CAMPAIGN budget, so it requires budgetLevel campaign or an existingCampaignId whose campaign has the budget (Advantage campaign budget / CBO); with an ad-set budget it is a 400, because Meta rejects a spend limit on an ad set that owns its budget. A target, not a guarantee. Mutually exclusive with lifetimeMinSpendTarget: the flavour must match the campaign budget type. Rejected with 400 on POST /v1/ads/boost and in adSetId attach mode: use PUT /v1/ads/ad-sets/{adSetId} for an ad set that already exists.
+     */
+    dailyMinSpendTarget?: number;
+    /**
+     * Meta lifetime_min_spend_target: the lifetime-budget flavour of dailyMinSpendTarget, in whole currency units. Same rules and same rejections.
+     */
+    lifetimeMinSpendTarget?: number;
 };
 type Money = {
     /**
@@ -13304,6 +13312,15 @@ type GetAllAccountsHealthResponse = ({
         tokenExpiresAt?: string;
         needsReconnect?: boolean;
         issues?: Array<(string)>;
+        /**
+         * Observed from Meta's own error subcodes on our own sends (2534122, 1893063, 2534029), not a live probe. Set on the first refused send and cleared when a later send succeeds, so it lags reality by one send in each direction.
+         */
+        messagingRestriction?: {
+            subcode?: number;
+            message?: string;
+            firstSeenAt?: string;
+            lastSeenAt?: string;
+        } | null;
     }>;
 });
 type GetAllAccountsHealthError = (ErrorResponse | {
@@ -13389,6 +13406,15 @@ type GetAccountHealthResponse = ({
      * Actionable recommendations to fix issues
      */
     recommendations?: Array<(string)>;
+    /**
+     * Observed from Meta's own error subcodes on our own sends (2534122, 1893063, 2534029), not a live probe. Set on the first refused send and cleared when a later send succeeds, so it lags reality by one send in each direction.
+     */
+    messagingRestriction?: {
+        subcode?: number;
+        message?: string;
+        firstSeenAt?: string;
+        lastSeenAt?: string;
+    } | null;
     /**
      * WhatsApp accounts only. Live probe of the Meta link behind the channel, performed at request time (the same read as GET /v1/whatsapp/number-info).
      */
@@ -21601,10 +21627,7 @@ type SendPrivateReplyToCommentResponse = ({
     commentId?: string;
     platform?: 'instagram' | 'facebook';
 });
-type SendPrivateReplyToCommentError = ({
-    error?: string;
-    code?: 'PLATFORM_LIMITATION';
-} | {
+type SendPrivateReplyToCommentError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type RetweetPostData = {
@@ -30359,6 +30382,27 @@ type UpdateAdSetData = {
              * Ad set end_time (ISO 8601).
              */
             endDate?: string;
+            /**
+             * Meta `daily_min_spend_target`: the least this ad set should spend per day, in whole
+             * currency units of the ad account. It reserves a share of a CAMPAIGN budget for one ad
+             * set, so it requires a campaign using Advantage campaign budget (CBO). On an ad set
+             * that owns its budget (ABO) this returns 409 — move the budget to the campaign with
+             * `PUT /v1/ads/campaigns/{campaignId}` first. Meta treats it as a target, not a
+             * guarantee, and rejects the combined minimum of a campaign's ad sets going over the
+             * campaign budget.
+             * Mutually exclusive with `lifetimeMinSpendTarget` (400): the flavour must match the
+             * campaign budget type, a daily budget takes a daily target.
+             * Read it back with `GET /v1/ads/ad-sets/{adSetId}?fields=daily_min_spend_target`.
+             *
+             */
+            dailyMinSpendTarget?: number;
+            /**
+             * Meta `lifetime_min_spend_target`: the lifetime-budget flavour of
+             * `dailyMinSpendTarget`, in whole currency units. Send this one when the campaign
+             * budget is a lifetime budget. Same rules and same rejections.
+             *
+             */
+            lifetimeMinSpendTarget?: number;
             /**
              * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create). Unknown keys are rejected with 400.
              */
@@ -33568,6 +33612,9 @@ type CreateStandaloneAdData = {
          * Sending the bid fields in BOTH places returns a 400
          * (`mutually_exclusive_fields`), and sending any of them in
          * `adSetId` attach mode is a 400 too (the ad set already has its bid).
+         * `dailyMinSpendTarget` / `lifetimeMinSpendTarget` set the new ad set's
+         * minimum spend and live here only; they are rejected in `adSetId` attach
+         * mode as well.
          *
          */
         platformSpecificData?: (LinkedInAdsPlatformData | MetaAdsPlatformData);

package/dist/index.d.ts

@@ -4253,7 +4253,7 @@ type ErrorResponse = {
         [key: string]: unknown;
     };
     /**
-     * Additional structured context (e.g. field-level validation errors).
+     * Additional structured context (e.g. field-level validation errors), for example `privateReplyConsumed` on the private-reply endpoint's 400 when the comment's single reply is already spent.
      */
     details?: {
         [key: string]: unknown;
@@ -5857,6 +5857,14 @@ type MetaAdsPlatformData = {
      * 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;
+    /**
+     * Meta daily_min_spend_target on the ad set being created: the least it should spend per day, in whole currency units. It reserves a share of a CAMPAIGN budget, so it requires budgetLevel campaign or an existingCampaignId whose campaign has the budget (Advantage campaign budget / CBO); with an ad-set budget it is a 400, because Meta rejects a spend limit on an ad set that owns its budget. A target, not a guarantee. Mutually exclusive with lifetimeMinSpendTarget: the flavour must match the campaign budget type. Rejected with 400 on POST /v1/ads/boost and in adSetId attach mode: use PUT /v1/ads/ad-sets/{adSetId} for an ad set that already exists.
+     */
+    dailyMinSpendTarget?: number;
+    /**
+     * Meta lifetime_min_spend_target: the lifetime-budget flavour of dailyMinSpendTarget, in whole currency units. Same rules and same rejections.
+     */
+    lifetimeMinSpendTarget?: number;
 };
 type Money = {
     /**
@@ -13304,6 +13312,15 @@ type GetAllAccountsHealthResponse = ({
         tokenExpiresAt?: string;
         needsReconnect?: boolean;
         issues?: Array<(string)>;
+        /**
+         * Observed from Meta's own error subcodes on our own sends (2534122, 1893063, 2534029), not a live probe. Set on the first refused send and cleared when a later send succeeds, so it lags reality by one send in each direction.
+         */
+        messagingRestriction?: {
+            subcode?: number;
+            message?: string;
+            firstSeenAt?: string;
+            lastSeenAt?: string;
+        } | null;
     }>;
 });
 type GetAllAccountsHealthError = (ErrorResponse | {
@@ -13389,6 +13406,15 @@ type GetAccountHealthResponse = ({
      * Actionable recommendations to fix issues
      */
     recommendations?: Array<(string)>;
+    /**
+     * Observed from Meta's own error subcodes on our own sends (2534122, 1893063, 2534029), not a live probe. Set on the first refused send and cleared when a later send succeeds, so it lags reality by one send in each direction.
+     */
+    messagingRestriction?: {
+        subcode?: number;
+        message?: string;
+        firstSeenAt?: string;
+        lastSeenAt?: string;
+    } | null;
     /**
      * WhatsApp accounts only. Live probe of the Meta link behind the channel, performed at request time (the same read as GET /v1/whatsapp/number-info).
      */
@@ -21601,10 +21627,7 @@ type SendPrivateReplyToCommentResponse = ({
     commentId?: string;
     platform?: 'instagram' | 'facebook';
 });
-type SendPrivateReplyToCommentError = ({
-    error?: string;
-    code?: 'PLATFORM_LIMITATION';
-} | {
+type SendPrivateReplyToCommentError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type RetweetPostData = {
@@ -30359,6 +30382,27 @@ type UpdateAdSetData = {
              * Ad set end_time (ISO 8601).
              */
             endDate?: string;
+            /**
+             * Meta `daily_min_spend_target`: the least this ad set should spend per day, in whole
+             * currency units of the ad account. It reserves a share of a CAMPAIGN budget for one ad
+             * set, so it requires a campaign using Advantage campaign budget (CBO). On an ad set
+             * that owns its budget (ABO) this returns 409 — move the budget to the campaign with
+             * `PUT /v1/ads/campaigns/{campaignId}` first. Meta treats it as a target, not a
+             * guarantee, and rejects the combined minimum of a campaign's ad sets going over the
+             * campaign budget.
+             * Mutually exclusive with `lifetimeMinSpendTarget` (400): the flavour must match the
+             * campaign budget type, a daily budget takes a daily target.
+             * Read it back with `GET /v1/ads/ad-sets/{adSetId}?fields=daily_min_spend_target`.
+             *
+             */
+            dailyMinSpendTarget?: number;
+            /**
+             * Meta `lifetime_min_spend_target`: the lifetime-budget flavour of
+             * `dailyMinSpendTarget`, in whole currency units. Send this one when the campaign
+             * budget is a lifetime budget. Same rules and same rejections.
+             *
+             */
+            lifetimeMinSpendTarget?: number;
             /**
              * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create). Unknown keys are rejected with 400.
              */
@@ -33568,6 +33612,9 @@ type CreateStandaloneAdData = {
          * Sending the bid fields in BOTH places returns a 400
          * (`mutually_exclusive_fields`), and sending any of them in
          * `adSetId` attach mode is a 400 too (the ad set already has its bid).
+         * `dailyMinSpendTarget` / `lifetimeMinSpendTarget` set the new ad set's
+         * minimum spend and live here only; they are rejected in `adSetId` attach
+         * mode as well.
          *
          */
         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.699",
+  version: "0.2.701",
   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.699",
+  version: "0.2.701",
   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.699",
+  "version": "0.2.701",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -4167,7 +4167,9 @@ export const unlikePost = <ThrowOnError extends boolean = false>(options: Option
  * cards and attachments to commenters who do not follow the account (Meta code 2, subcode
  * 1545133, returned here as a non-retryable 400 that says so), and the failed call still
  * consumes the comment's single private reply. To reach non-followers send plain text and
- * add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive.
+ * add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive. When
+ * the comment's single private reply is spent (by this call or an earlier one) the 400
+ * carries `details.privateReplyConsumed: true`; never retry it.
  *
  */
 export const sendPrivateReplyToComment = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SendPrivateReplyToCommentData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -3004,7 +3004,7 @@ export type ErrorResponse = {
         [key: string]: unknown;
     };
     /**
-     * Additional structured context (e.g. field-level validation errors).
+     * Additional structured context (e.g. field-level validation errors), for example `privateReplyConsumed` on the private-reply endpoint's 400 when the comment's single reply is already spent.
      */
     details?: {
         [key: string]: unknown;
@@ -4668,6 +4668,14 @@ export type MetaAdsPlatformData = {
      * 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;
+    /**
+     * Meta daily_min_spend_target on the ad set being created: the least it should spend per day, in whole currency units. It reserves a share of a CAMPAIGN budget, so it requires budgetLevel campaign or an existingCampaignId whose campaign has the budget (Advantage campaign budget / CBO); with an ad-set budget it is a 400, because Meta rejects a spend limit on an ad set that owns its budget. A target, not a guarantee. Mutually exclusive with lifetimeMinSpendTarget: the flavour must match the campaign budget type. Rejected with 400 on POST /v1/ads/boost and in adSetId attach mode: use PUT /v1/ads/ad-sets/{adSetId} for an ad set that already exists.
+     */
+    dailyMinSpendTarget?: number;
+    /**
+     * Meta lifetime_min_spend_target: the lifetime-budget flavour of dailyMinSpendTarget, in whole currency units. Same rules and same rejections.
+     */
+    lifetimeMinSpendTarget?: number;
 };
 
 export type Money = {
@@ -12528,6 +12536,15 @@ export type GetAllAccountsHealthResponse = ({
         tokenExpiresAt?: string;
         needsReconnect?: boolean;
         issues?: Array<(string)>;
+        /**
+         * Observed from Meta's own error subcodes on our own sends (2534122, 1893063, 2534029), not a live probe. Set on the first refused send and cleared when a later send succeeds, so it lags reality by one send in each direction.
+         */
+        messagingRestriction?: {
+            subcode?: number;
+            message?: string;
+            firstSeenAt?: string;
+            lastSeenAt?: string;
+        } | null;
     }>;
 });
 
@@ -12619,6 +12636,15 @@ export type GetAccountHealthResponse = ({
      * Actionable recommendations to fix issues
      */
     recommendations?: Array<(string)>;
+    /**
+     * Observed from Meta's own error subcodes on our own sends (2534122, 1893063, 2534029), not a live probe. Set on the first refused send and cleared when a later send succeeds, so it lags reality by one send in each direction.
+     */
+    messagingRestriction?: {
+        subcode?: number;
+        message?: string;
+        firstSeenAt?: string;
+        lastSeenAt?: string;
+    } | null;
     /**
      * WhatsApp accounts only. Live probe of the Meta link behind the channel, performed at request time (the same read as GET /v1/whatsapp/number-info).
      */
@@ -21353,10 +21379,7 @@ export type SendPrivateReplyToCommentResponse = ({
     platform?: 'instagram' | 'facebook';
 });
 
-export type SendPrivateReplyToCommentError = ({
-    error?: string;
-    code?: 'PLATFORM_LIMITATION';
-} | {
+export type SendPrivateReplyToCommentError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
@@ -30818,6 +30841,27 @@ export type UpdateAdSetData = {
              * Ad set end_time (ISO 8601).
              */
             endDate?: string;
+            /**
+             * Meta `daily_min_spend_target`: the least this ad set should spend per day, in whole
+             * currency units of the ad account. It reserves a share of a CAMPAIGN budget for one ad
+             * set, so it requires a campaign using Advantage campaign budget (CBO). On an ad set
+             * that owns its budget (ABO) this returns 409 — move the budget to the campaign with
+             * `PUT /v1/ads/campaigns/{campaignId}` first. Meta treats it as a target, not a
+             * guarantee, and rejects the combined minimum of a campaign's ad sets going over the
+             * campaign budget.
+             * Mutually exclusive with `lifetimeMinSpendTarget` (400): the flavour must match the
+             * campaign budget type, a daily budget takes a daily target.
+             * Read it back with `GET /v1/ads/ad-sets/{adSetId}?fields=daily_min_spend_target`.
+             *
+             */
+            dailyMinSpendTarget?: number;
+            /**
+             * Meta `lifetime_min_spend_target`: the lifetime-budget flavour of
+             * `dailyMinSpendTarget`, in whole currency units. Send this one when the campaign
+             * budget is a lifetime budget. Same rules and same rejections.
+             *
+             */
+            lifetimeMinSpendTarget?: number;
             /**
              * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create). Unknown keys are rejected with 400.
              */
@@ -34177,6 +34221,9 @@ export type CreateStandaloneAdData = {
          * Sending the bid fields in BOTH places returns a 400
          * (`mutually_exclusive_fields`), and sending any of them in
          * `adSetId` attach mode is a 400 too (the ad set already has its bid).
+         * `dailyMinSpendTarget` / `lifetimeMinSpendTarget` set the new ad set's
+         * minimum spend and live here only; they are rejected in `adSetId` attach
+         * mode as well.
          *
          */
         platformSpecificData?: (LinkedInAdsPlatformData | MetaAdsPlatformData);