@zernio/node 0.2.1506 → 0.2.1508

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -7292,6 +7292,13 @@ export type CreatorPortalSubmission = {
  *
  */
 export type CtwaAdRequestBody = {
+    /**
+     * When Meta answers a create with a 5xx and reading the parent back by name finds no such object, Zernio sends the create again (at most 3 POSTs per object, never for an object created ACTIVE) and reports it in `recoveredWrites`.
+     *
+     * `false` never sends it again: the request fails with 502 and `details.unconfirmedWrite`, so you can check the parent yourself. One object found by name is still reused.
+     *
+     */
+    retryOnServerError?: boolean;
     /**
      * Meta enhancement settings for single or attached ads, and defaults for creatives[]. An item replaces the entire map, including with an empty object.
      */
@@ -8024,6 +8031,7 @@ export type CtwaMultiResponse = {
     platformCampaignId: string;
     platformAdSetId: string;
     message: string;
+    recoveredWrites?: MetaRecoveredWrites;
     /**
      * Present when Meta created the ad set differently from the request:
      *
@@ -8052,6 +8060,7 @@ export type CtwaSingleResponse = {
         [key: string]: unknown;
     };
     message: string;
+    recoveredWrites?: MetaRecoveredWrites;
     /**
      * Present when Meta created the ad set differently from the request:
      *
@@ -8601,7 +8610,7 @@ export type ErrorResponse = {
      * **Failed Meta ad create** (`POST /v1/ads/create`, `POST /v1/ads/boost`, `POST /v1/ads/ctwa`). Carries `stage` (where it failed), `adAccountId` (on which ad account) and `createdObjects` (every object this request had already created, with what cleanup did to it).
      *
      * - `left_behind` objects still exist on the ad account (Meta refused the delete, typically on a held account, or the delete hit a network error). Delete them yourself or reuse them.
-     * - `unconfirmedWrite` is set when Meta answered a create with a 5xx or dropped the connection and Zernio could not confirm whether the object exists. Check that parent before creating it again.
+     * - `unconfirmedWrite` is set when Meta answered a create with a 5xx or a non-JSON body, or dropped the connection, and Zernio could not confirm whether the object exists. Check that parent before creating it again.
      *
      * **Ineligible ad account: 422 `ad_account_unusable`.** When Meta refuses a write because the ad account's status is ineligible to manage ads (Meta subcode 2490592 or 4841021, on the write itself or on a cleanup delete), any Meta ads write answers it.
      *
@@ -8648,12 +8657,22 @@ export type ErrorResponse = {
              */
             id?: string;
             /**
-             * `deleted`: Zernio deleted it. `left_behind`: cleanup could not delete it (Meta refused the delete, or the delete hit a network error), so it still exists. `kept`: deliberately not deleted: an image (hashes are shared by every upload of the same file), or an object Zernio found by name after Meta lost its answer to the create, which may belong to another request with the same name.
+             * - `deleted`: Zernio deleted it.
+             * - `left_behind`: cleanup could not delete it (Meta refused the delete, or the delete hit a network error), so it still exists.
+             * - `kept`: deliberately not deleted. Either an image (hashes are shared by every upload of the same file), or an object Zernio found by name after Meta lost its answer to the create, which may belong to another request with the same name.
+             *
              */
             cleanup?: 'deleted' | 'left_behind' | 'kept';
         }>;
         /**
-         * Meta ad create failures only, when Meta answered a create with a 5xx or a non-JSON body, or dropped the connection after the request was sent, and reading the parent back by name did not settle it: several objects of the same name, a parent that could not be read, or (after a dropped connection or a non-JSON body) no such object. Zernio did not retry it.
+         * Meta ad create failures only. Set when Meta answered a create with a 5xx or a non-JSON body, or dropped the connection after the request was sent, and reading the parent back by name did not settle it. Zernio did not retry it.
+         *
+         * One of these left it open:
+         *
+         * - The read-back found several objects of the same name.
+         * - The parent could not be read, or the object is a creative, which has no reliable read-back.
+         * - The read-back found no such object, after a dropped connection, a non-JSON body, a 5xx with `retryOnServerError: false`, or a 5xx on a create whose own body is `status: ACTIVE`.
+         *
          */
         unconfirmedWrite?: {
             type?: 'campaign' | 'adset' | 'creative' | 'ad';
@@ -12846,6 +12865,28 @@ export type MetaPromotion = {
     [key: string]: unknown;
 } | null;
 
+/**
+ * Meta only, present only when needed. Every object this request did not get confirmed by its first POST: found by name after Meta lost or failed its answer (`adopted`), or created by a second POST after a Meta 5xx (`repostedAfter`).
+ *
+ * A re-POSTed object may have a twin from the first POST that Meta wrote late: check its parent for a duplicate name. Send `retryOnServerError: false` to never re-POST.
+ *
+ */
+export type MetaRecoveredWrites = Array<{
+    type: 'campaign' | 'adset' | 'ad';
+    /**
+     * The Meta object id this response uses.
+     */
+    id: string;
+    /**
+     * Always true when present. Zernio found this object by name under its parent and reused it instead of creating it again.
+     */
+    adopted?: boolean;
+    /**
+     * Zernio sent the create again after Meta answered a 5xx and the read-back found no such object.
+     */
+    repostedAfter?: 'server_error';
+}>;
+
 export type Money = {
     /**
      * ISO 4217 currency code (e.g. USD, EUR)
@@ -60688,6 +60729,13 @@ export type BoostPostData = {
          *
          */
         bodies?: Array<(string)>;
+        /**
+         * Meta only (a 400 elsewhere). When Meta answers a create with a 5xx and reading the parent back by name finds no such object, Zernio sends the create again (at most 3 POSTs per object, never for an object created ACTIVE) and reports it in `recoveredWrites`.
+         *
+         * `false` never sends it again: the request fails with 502 and `details.unconfirmedWrite`, so you can check the parent yourself. One object found by name is still reused.
+         *
+         */
+        retryOnServerError?: boolean;
         /**
          * Meta only (a 400 elsewhere). Controls the fallback when Meta refuses an existing Instagram video as the ad (subcode 1815279).
          *
@@ -60797,6 +60845,7 @@ export type BoostPostResponse = ({
     ad?: Ad;
     message?: string;
     instagramVideoFallback?: InstagramVideoFallback;
+    recoveredWrites?: MetaRecoveredWrites;
     /**
      * Human-readable notes about the boost.
      *
@@ -61170,6 +61219,13 @@ export type CreateStandaloneAdData = {
          *
          */
         aiDisclosure?: 'OPT_IN' | 'OPT_OUT';
+        /**
+         * Meta only (a 400 elsewhere). When Meta answers a create with a 5xx and reading the parent back by name finds no such object, Zernio sends the create again (at most 3 POSTs per object, never for an object created ACTIVE) and reports it in `recoveredWrites`.
+         *
+         * `false` never sends it again: the request fails with 502 and `details.unconfirmedWrite`, so you can check the parent yourself. One object found by name is still reused.
+         *
+         */
+        retryOnServerError?: boolean;
         /**
          * Validate the request without creating anything. Supported on Meta, TikTok, ChatGPT (OpenAI) and Google Performance Max / Demand Gen. Any other platform, or a Google campaignType other than pmax or demand_gen, returns 501 `feature_not_available`.
          *
@@ -62360,6 +62416,7 @@ export type CreateStandaloneAdResponse = ({
     ad?: Ad;
     appliedDefaults?: AdAppliedDefaults;
     message?: string;
+    recoveredWrites?: MetaRecoveredWrites;
     /**
      * Meta only, present only when needed.
      *
@@ -62373,6 +62430,7 @@ export type CreateStandaloneAdResponse = ({
     platformAdSetId?: string;
     appliedDefaults?: AdAppliedDefaults;
     message?: string;
+    recoveredWrites?: MetaRecoveredWrites;
     /**
      * Meta only, present only when needed.
      *