@zernio/node 0.2.698 → 0.2.700

package/dist/index.d.mts

@@ -2240,7 +2240,7 @@ type AdTreeAdSet = {
         page_id?: string;
     } | null;
     /**
-     * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
+     * Individual ads within this ad set (capped at 100). When the ad set has more than 100 ads these are the 100 highest-spending over the requested date range, so this array depends on `fromDate`/`toDate`; `adCount` is always the true ad set size. Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
      */
     ads?: Array<Ad>;
     /**
@@ -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;
@@ -13304,6 +13304,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 +13398,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 +21619,7 @@ type SendPrivateReplyToCommentResponse = ({
     commentId?: string;
     platform?: 'instagram' | 'facebook';
 });
-type SendPrivateReplyToCommentError = ({
-    error?: string;
-    code?: 'PLATFORM_LIMITATION';
-} | {
+type SendPrivateReplyToCommentError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type RetweetPostData = {

package/dist/index.d.ts

@@ -2240,7 +2240,7 @@ type AdTreeAdSet = {
         page_id?: string;
     } | null;
     /**
-     * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
+     * Individual ads within this ad set (capped at 100). When the ad set has more than 100 ads these are the 100 highest-spending over the requested date range, so this array depends on `fromDate`/`toDate`; `adCount` is always the true ad set size. Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
      */
     ads?: Array<Ad>;
     /**
@@ -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;
@@ -13304,6 +13304,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 +13398,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 +21619,7 @@ type SendPrivateReplyToCommentResponse = ({
     commentId?: string;
     platform?: 'instagram' | 'facebook';
 });
-type SendPrivateReplyToCommentError = ({
-    error?: string;
-    code?: 'PLATFORM_LIMITATION';
-} | {
+type SendPrivateReplyToCommentError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type RetweetPostData = {

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.698",
+  version: "0.2.700",
   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.698",
+  version: "0.2.700",
   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.698",
+  "version": "0.2.700",
   "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

@@ -925,7 +925,7 @@ export type AdTreeAdSet = {
         page_id?: string;
     } | null;
     /**
-     * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
+     * Individual ads within this ad set (capped at 100). When the ad set has more than 100 ads these are the 100 highest-spending over the requested date range, so this array depends on `fromDate`/`toDate`; `adCount` is always the true ad set size. Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
      */
     ads?: Array<Ad>;
     /**
@@ -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;
@@ -12528,6 +12528,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 +12628,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 +21371,7 @@ export type SendPrivateReplyToCommentResponse = ({
     platform?: 'instagram' | 'facebook';
 });
 
-export type SendPrivateReplyToCommentError = ({
-    error?: string;
-    code?: 'PLATFORM_LIMITATION';
-} | {
+export type SendPrivateReplyToCommentError = (ErrorResponse | {
     error?: string;
 } | unknown);