@zernio/node 0.2.1507 → 0.2.1509

package/dist/index.d.mts

@@ -10555,7 +10555,7 @@ 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.
      *
@@ -10602,12 +10602,22 @@ 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, a non-JSON body, or a 5xx with `retryOnServerError: false`) 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';
@@ -14989,6 +14999,8 @@ type ParameterEmailAccountId = string;
  *
  * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
  *
+ * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+ *
  */
 type ParameterIdempotencyKeyHeader = string;
 /**
@@ -26101,6 +26113,8 @@ type CreateTopupData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -26892,6 +26906,8 @@ type CreateTransferData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -29244,6 +29260,8 @@ type CreateProfileData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -39893,6 +39911,8 @@ type SendInboxMessageData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -41108,6 +41128,8 @@ type ReplyToInboxPostData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -41972,6 +41994,8 @@ type ReplyToInboxReviewData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -42587,6 +42611,8 @@ type InitiateWhatsAppCallData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -42833,6 +42859,8 @@ type CreateVoiceCallData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43438,6 +43466,8 @@ type SendSmsData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43496,6 +43526,8 @@ type CreateRcsAgentData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43620,6 +43652,8 @@ type SendRcsMessageData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43808,6 +43842,8 @@ type CreateBrandedCallingEnterpriseData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43895,6 +43931,8 @@ type CreateBrandedCallingIdentityData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -49618,6 +49656,8 @@ type AskSupportQuestionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -59604,6 +59644,8 @@ type BoostPostData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -61143,6 +61185,8 @@ type CreateStandaloneAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -64643,6 +64687,8 @@ type CreateMessagingAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -64684,6 +64730,8 @@ type CreateCallAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -64702,6 +64750,8 @@ type CreateCtwaAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -66228,6 +66278,8 @@ type CreateBlogArticleData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68176,6 +68228,8 @@ type CreateCreatorCampaignData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68246,6 +68300,8 @@ type RaiseCreatorCampaignBudgetData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68311,6 +68367,8 @@ type CreateCampaignParticipantData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68454,6 +68512,8 @@ type ResendCampaignParticipantInviteData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68497,6 +68557,8 @@ type SettleCampaignParticipantData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68540,6 +68602,8 @@ type CreateCampaignPayoutBatchData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68649,6 +68713,8 @@ type ApproveCampaignSubmissionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68681,6 +68747,8 @@ type RejectCampaignSubmissionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68710,6 +68778,8 @@ type ReopenCampaignSubmissionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68759,6 +68829,8 @@ type CreateCampaignAdjustmentData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };

package/dist/index.d.ts

@@ -10555,7 +10555,7 @@ 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.
      *
@@ -10602,12 +10602,22 @@ 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, a non-JSON body, or a 5xx with `retryOnServerError: false`) 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';
@@ -14989,6 +14999,8 @@ type ParameterEmailAccountId = string;
  *
  * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
  *
+ * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+ *
  */
 type ParameterIdempotencyKeyHeader = string;
 /**
@@ -26101,6 +26113,8 @@ type CreateTopupData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -26892,6 +26906,8 @@ type CreateTransferData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -29244,6 +29260,8 @@ type CreateProfileData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -39893,6 +39911,8 @@ type SendInboxMessageData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -41108,6 +41128,8 @@ type ReplyToInboxPostData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -41972,6 +41994,8 @@ type ReplyToInboxReviewData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -42587,6 +42611,8 @@ type InitiateWhatsAppCallData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -42833,6 +42859,8 @@ type CreateVoiceCallData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43438,6 +43466,8 @@ type SendSmsData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43496,6 +43526,8 @@ type CreateRcsAgentData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43620,6 +43652,8 @@ type SendRcsMessageData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43808,6 +43842,8 @@ type CreateBrandedCallingEnterpriseData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43895,6 +43931,8 @@ type CreateBrandedCallingIdentityData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -49618,6 +49656,8 @@ type AskSupportQuestionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -59604,6 +59644,8 @@ type BoostPostData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -61143,6 +61185,8 @@ type CreateStandaloneAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -64643,6 +64687,8 @@ type CreateMessagingAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -64684,6 +64730,8 @@ type CreateCallAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -64702,6 +64750,8 @@ type CreateCtwaAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -66228,6 +66278,8 @@ type CreateBlogArticleData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68176,6 +68228,8 @@ type CreateCreatorCampaignData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68246,6 +68300,8 @@ type RaiseCreatorCampaignBudgetData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68311,6 +68367,8 @@ type CreateCampaignParticipantData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68454,6 +68512,8 @@ type ResendCampaignParticipantInviteData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68497,6 +68557,8 @@ type SettleCampaignParticipantData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68540,6 +68602,8 @@ type CreateCampaignPayoutBatchData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68649,6 +68713,8 @@ type ApproveCampaignSubmissionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68681,6 +68747,8 @@ type RejectCampaignSubmissionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68710,6 +68778,8 @@ type ReopenCampaignSubmissionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -68759,6 +68829,8 @@ type CreateCampaignAdjustmentData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -17435,7 +17435,9 @@ export const browseAdTargeting = <ThrowOnError extends boolean = false>(options:
  *
  * **Meta coverage.** Political and social-issue ads are searchable worldwide. Every other ad is in the archive only if it was delivered to the EU or UK within the last year, so a US-only commercial advertiser is invisible.
  *
- * Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`. All customers share Zernio's Meta quota, so a `429` means back off for a minute.
+ * Spend, impressions and demographics are political-only fields and are left out of the default projection; request them via `fields`.
+ *
+ * **Meta rate limit.** Meta searches are capped at 30 requests per hour per team, because all customers share Zernio's Meta quota. Meta can also throttle that shared quota. Either way you get a `429` with `Retry-After`: wait that long before retrying.
  *
  * **LinkedIn coverage.** Ads served after June 1 2023, worldwide, kept for a year after their last impression. EU-delivered ads carry impression ranges and the disclosed targeting facets.
  *

package/src/generated/types.gen.ts

@@ -8610,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.
      *
@@ -8657,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, a non-JSON body, or a 5xx with `retryOnServerError: false`) 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';
@@ -13251,6 +13261,8 @@ export type ParameterEmailAccountId = string;
  *
  * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
  *
+ * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+ *
  */
 export type ParameterIdempotencyKeyHeader = string;
 
@@ -24880,6 +24892,8 @@ export type CreateTopupData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -25700,6 +25714,8 @@ export type CreateTransferData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -28249,6 +28265,8 @@ export type CreateProfileData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -39587,6 +39605,8 @@ export type SendInboxMessageData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -40916,6 +40936,8 @@ export type ReplyToInboxPostData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -41852,6 +41874,8 @@ export type ReplyToInboxReviewData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -42512,6 +42536,8 @@ export type InitiateWhatsAppCallData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -42782,6 +42808,8 @@ export type CreateVoiceCallData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43471,6 +43499,8 @@ export type SendSmsData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43537,6 +43567,8 @@ export type CreateRcsAgentData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43688,6 +43720,8 @@ export type SendRcsMessageData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -43899,6 +43933,8 @@ export type CreateBrandedCallingEnterpriseData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -44002,6 +44038,8 @@ export type CreateBrandedCallingIdentityData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -50219,6 +50257,8 @@ export type AskSupportQuestionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -60812,6 +60852,8 @@ export type BoostPostData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -62375,6 +62417,8 @@ export type CreateStandaloneAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -66118,6 +66162,8 @@ export type CreateMessagingAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -66162,6 +66208,8 @@ export type CreateCallAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -66183,6 +66231,8 @@ export type CreateCtwaAdData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -67961,6 +68011,8 @@ export type CreateBlogArticleData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -70185,6 +70237,8 @@ export type CreateCreatorCampaignData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -70267,6 +70321,8 @@ export type RaiseCreatorCampaignBudgetData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -70344,6 +70400,8 @@ export type CreateCampaignParticipantData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -70508,6 +70566,8 @@ export type ResendCampaignParticipantInviteData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -70554,6 +70614,8 @@ export type SettleCampaignParticipantData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -70600,6 +70662,8 @@ export type CreateCampaignPayoutBatchData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -70724,6 +70788,8 @@ export type ApproveCampaignSubmissionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -70759,6 +70825,8 @@ export type RejectCampaignSubmissionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -70791,6 +70859,8 @@ export type ReopenCampaignSubmissionData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };
@@ -70846,6 +70916,8 @@ export type CreateCampaignAdjustmentData = {
          *
          * A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          *
+         * On the Ads create, boost and duplicate endpoints, a same-body retry runs again once the cut-off request started more than 15 minutes ago.
+         *
          */
         'Idempotency-Key'?: string;
     };