@zernio/node 0.2.739 → 0.2.740

package/dist/index.d.mts

@@ -26528,7 +26528,7 @@ type ListPhoneNumberCountriesResponse = ({
              */
             fulfilment?: 'instant' | 'request';
             /**
-             * Out of stock but orderable anyway. Submit KYC as usual (POST /v1/phone-numbers/kyc) and the carrier sources the number after review, usually about 3 weeks and never guaranteed. Only document tiers (3/4) qualify, and nothing is billed until the number is active.
+             * Out of stock but orderable anyway. Submit KYC as usual (POST /v1/phone-numbers/kyc): we buy regular stock the moment it returns, otherwise the carrier sources the number. Usually 2 to 4 weeks, never guaranteed. Only document tiers (3/4) qualify, and nothing is billed until the number is active.
              */
             preOrderable?: boolean;
         }>;
@@ -26605,7 +26605,7 @@ type CheckPhoneNumberAvailabilityResponse = ({
      */
     available?: boolean;
     /**
-     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and the carrier sources the number after review (usually about 3 weeks, never guaranteed). Only document tiers (3/4) qualify.
+     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and we buy regular stock the moment it returns, otherwise the carrier sources the number (usually 2 to 4 weeks, never guaranteed). Only document tiers (3/4) qualify.
      */
     preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
@@ -26873,7 +26873,7 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
      */
     available?: boolean;
     /**
-     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and the carrier sources the number after review (usually about 3 weeks, never guaranteed). Only document tiers (3/4) qualify.
+     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and we buy regular stock the moment it returns, otherwise the carrier sources the number (usually 2 to 4 weeks, never guaranteed). Only document tiers (3/4) qualify.
      */
     preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
@@ -27058,7 +27058,7 @@ type SubmitPhoneNumberKycData = {
 type SubmitPhoneNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until the carrier sources it (usually about 3 weeks) and is not billed until active. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -27822,7 +27822,7 @@ type SubmitWhatsAppNumberKycData = {
 type SubmitWhatsAppNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until the carrier sources it (usually about 3 weeks) and is not billed until active. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -34278,7 +34278,7 @@ type GetAdCommentsResponse = ({
          */
         effectiveStoryId?: string;
         /**
-         * TikTok-only video item ID. Null when the ad and comments do not expose it.
+         * TikTok-only video item ID from stored ad fields or returned comments. Null does not prevent listing; ad details are not fetched to populate it.
          */
         tiktokItemId?: (string) | null;
         /**

package/dist/index.d.ts

@@ -26528,7 +26528,7 @@ type ListPhoneNumberCountriesResponse = ({
              */
             fulfilment?: 'instant' | 'request';
             /**
-             * Out of stock but orderable anyway. Submit KYC as usual (POST /v1/phone-numbers/kyc) and the carrier sources the number after review, usually about 3 weeks and never guaranteed. Only document tiers (3/4) qualify, and nothing is billed until the number is active.
+             * Out of stock but orderable anyway. Submit KYC as usual (POST /v1/phone-numbers/kyc): we buy regular stock the moment it returns, otherwise the carrier sources the number. Usually 2 to 4 weeks, never guaranteed. Only document tiers (3/4) qualify, and nothing is billed until the number is active.
              */
             preOrderable?: boolean;
         }>;
@@ -26605,7 +26605,7 @@ type CheckPhoneNumberAvailabilityResponse = ({
      */
     available?: boolean;
     /**
-     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and the carrier sources the number after review (usually about 3 weeks, never guaranteed). Only document tiers (3/4) qualify.
+     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and we buy regular stock the moment it returns, otherwise the carrier sources the number (usually 2 to 4 weeks, never guaranteed). Only document tiers (3/4) qualify.
      */
     preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
@@ -26873,7 +26873,7 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
      */
     available?: boolean;
     /**
-     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and the carrier sources the number after review (usually about 3 weeks, never guaranteed). Only document tiers (3/4) qualify.
+     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and we buy regular stock the moment it returns, otherwise the carrier sources the number (usually 2 to 4 weeks, never guaranteed). Only document tiers (3/4) qualify.
      */
     preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
@@ -27058,7 +27058,7 @@ type SubmitPhoneNumberKycData = {
 type SubmitPhoneNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until the carrier sources it (usually about 3 weeks) and is not billed until active. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -27822,7 +27822,7 @@ type SubmitWhatsAppNumberKycData = {
 type SubmitWhatsAppNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until the carrier sources it (usually about 3 weeks) and is not billed until active. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -34278,7 +34278,7 @@ type GetAdCommentsResponse = ({
          */
         effectiveStoryId?: string;
         /**
-         * TikTok-only video item ID. Null when the ad and comments do not expose it.
+         * TikTok-only video item ID from stored ad fields or returned comments. Null does not prevent listing; ad details are not fetched to populate it.
          */
         tiktokItemId?: (string) | null;
         /**

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -9027,12 +9027,22 @@ export const updateAdTrackingTags = <ThrowOnError extends boolean = false>(optio
  * each page to this ad. A page can be empty while `pagination.hasMore` is true.
  * Reuse `pagination.cursor` with the same `limit`; the cursor retains the date window.
  * `placement` is Meta-only and returns a 400 for TikTok.
+ * Listing needs no identity or video item ID. When the ad group is stored, each
+ * page makes one comment-list call and no ad-detail lookup, including for external
+ * ads that TikTok no longer returns from ad details. `meta.tiktokItemId: null`
+ * does not prevent listing. If the ad group is missing, Zernio fetches ad details;
+ * unavailable details return 404 ad_not_found, and no ad group returns 400 ad_not_commentable.
  *
  * TikTok returns replies as separate comments with `parentId`; nested reply fetching
- * is not supported. `canReply` requires a first-level comment and an identity with
- * comment-management permission. `canDelete` reflects TikTok's own-comment deletion
- * capability. `canHide` is supported and `canLike` is false. Use the ad comment
- * reply, hide and delete operations below to moderate TikTok comments.
+ * is not supported. `canReply` requires a first-level comment, comment-management
+ * permission, a video item ID and a supported TT_USER or CUSTOMIZED_USER identity.
+ * `canDelete` requires TikTok's own-comment deletion capability, a video item ID
+ * and a supported identity. Both flags are false when identity or item is unknown.
+ * Listing uses stored and comment-specific fields without fetching identity.
+ * A direct reply or delete request can lazily resolve missing fields and succeed
+ * even after a false flag. `canHide` is true because visibility changes need only
+ * advertiser and comment IDs. `canLike` is false. Use the ad comment reply, hide
+ * and delete operations below to moderate TikTok comments.
  * Other platforms return feature_not_available.
  *
  * Requires the Ads add-on. Response shape matches GET /v1/inbox/comments/{postId}.
@@ -9055,6 +9065,14 @@ export const getAdComments = <ThrowOnError extends boolean = false>(options: Opt
  * Reply to an ad comment
  * Reply to a first-level TikTok ad comment. Requires a TT_USER or CUSTOMIZED_USER identity with comment-management permission. Replies to replies are rejected. The response commentId identifies the new reply. This operation is not idempotent; do not blindly retry an uncertain response.
  *
+ * Unknown identity and video item fields are resolved only when needed for this
+ * action, then persisted for reuse. Comment-specific fields take precedence.
+ * If TikTok no longer returns the ad needed to resolve identity, 404 ad_not_found
+ * directs you to check deletion or archival in TikTok Ads Manager. Listing can
+ * still succeed. Unsupported or unavailable identity returns 403 feature_not_available.
+ * Denied access to ad details returns 403 insufficient_permissions with reconnect
+ * guidance and the upstream platformError.
+ *
  * Requires Ads access. The ad is resolved within the caller's accessible profiles.
  * Before moderation, Zernio verifies that the comment belongs to this ad using
  * TikTok's ad-group comment listing. The default search window is the last 30 days.
@@ -9073,7 +9091,7 @@ export const replyToAdComment = <ThrowOnError extends boolean = false>(options:
 
 /**
  * Hide or unhide an ad comment
- * Hide or restore a TikTok ad comment. Send hidden=true to hide it or hidden=false to make it public again.
+ * Hide or restore a TikTok ad comment. Send hidden=true to hide it or hidden=false to make it public again. Identity and video item ID are not required; no identity lookup is performed.
  *
  * Requires Ads access. The ad is resolved within the caller's accessible profiles.
  * Before moderation, Zernio verifies that the comment belongs to this ad using
@@ -9095,6 +9113,14 @@ export const hideAdComment = <ThrowOnError extends boolean = false>(options: Opt
  * Delete an ad comment
  * Delete your own TikTok ad comment or reply. TikTok must return can_delete=true for the comment. Other users' comments can be hidden instead.
  *
+ * Unknown identity and video item fields are resolved only when needed for this
+ * action, then persisted for reuse. Comment-specific fields take precedence.
+ * If TikTok no longer returns the ad needed to resolve identity, 404 ad_not_found
+ * directs you to check deletion or archival in TikTok Ads Manager. Listing can
+ * still succeed. Unsupported or unavailable identity returns 403 feature_not_available.
+ * Denied access to ad details returns 403 insufficient_permissions with reconnect
+ * guidance and the upstream platformError.
+ *
  * Requires Ads access. The ad is resolved within the caller's accessible profiles.
  * Before moderation, Zernio verifies that the comment belongs to this ad using
  * TikTok's ad-group comment listing. The default search window is the last 30 days.

package/src/generated/types.gen.ts

@@ -26401,7 +26401,7 @@ export type ListPhoneNumberCountriesResponse = ({
              */
             fulfilment?: 'instant' | 'request';
             /**
-             * Out of stock but orderable anyway. Submit KYC as usual (POST /v1/phone-numbers/kyc) and the carrier sources the number after review, usually about 3 weeks and never guaranteed. Only document tiers (3/4) qualify, and nothing is billed until the number is active.
+             * Out of stock but orderable anyway. Submit KYC as usual (POST /v1/phone-numbers/kyc): we buy regular stock the moment it returns, otherwise the carrier sources the number. Usually 2 to 4 weeks, never guaranteed. Only document tiers (3/4) qualify, and nothing is billed until the number is active.
              */
             preOrderable?: boolean;
         }>;
@@ -26484,7 +26484,7 @@ export type CheckPhoneNumberAvailabilityResponse = ({
      */
     available?: boolean;
     /**
-     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and the carrier sources the number after review (usually about 3 weeks, never guaranteed). Only document tiers (3/4) qualify.
+     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and we buy regular stock the moment it returns, otherwise the carrier sources the number (usually 2 to 4 weeks, never guaranteed). Only document tiers (3/4) qualify.
      */
     preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
@@ -26766,7 +26766,7 @@ export type CheckWhatsAppNumberAvailabilityResponse = ({
      */
     available?: boolean;
     /**
-     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and the carrier sources the number after review (usually about 3 weeks, never guaranteed). Only document tiers (3/4) qualify.
+     * Nothing deliverable now, but this pair can be pre-ordered: submit KYC as usual and we buy regular stock the moment it returns, otherwise the carrier sources the number (usually 2 to 4 weeks, never guaranteed). Only document tiers (3/4) qualify.
      */
     preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
@@ -26957,7 +26957,7 @@ export type SubmitPhoneNumberKycData = {
 export type SubmitPhoneNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until the carrier sources it (usually about 3 weeks) and is not billed until active. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -27774,7 +27774,7 @@ export type SubmitWhatsAppNumberKycData = {
 export type SubmitWhatsAppNumberKycResponse = ({
     status?: 'kyc_submitted' | 'kyc_reused' | 'kyc_already_submitted';
     /**
-     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until the carrier sources it (usually about 3 weeks) and is not billed until active. A pre-order is one number: `quantity` above 1 is rejected with 400.
+     * True when nothing was in stock and this submission placed a pre-order. The number stays `pending_regulatory` until we get it, from regular stock the moment it returns or sourced by the carrier (usually 2 to 4 weeks), and is not billed until active. Releasing it (DELETE /v1/phone-numbers/{id}) cancels the pre-order. A pre-order is one number: `quantity` above 1 is rejected with 400.
      */
     preOrder?: boolean;
     /**
@@ -34734,7 +34734,7 @@ export type GetAdCommentsResponse = ({
          */
         effectiveStoryId?: string;
         /**
-         * TikTok-only video item ID. Null when the ad and comments do not expose it.
+         * TikTok-only video item ID from stored ad fields or returned comments. Null does not prevent listing; ad details are not fetched to populate it.
          */
         tiktokItemId?: (string) | null;
         /**