@zernio/node 0.2.735 → 0.2.736

package/dist/index.d.mts

@@ -26379,13 +26379,20 @@ type ListPhoneNumberCountriesResponse = ({
          * Live carrier-stock snapshot (refreshed every 6h + on availability checks): false when NO offered type currently has deliverable inventory, so a purchase would fail. Treat as advisory; the purchase itself re-checks.
          */
         inStock?: boolean;
+        /**
+         * At least one out-of-stock type here can be pre-ordered (see `types[].preOrderable`).
+         */
+        preOrderable?: boolean;
         /**
          * Every number type offered in this country (default first). Capabilities, KYC tier, monthly price, and stock are per type. The country-level fields above mirror the first (default) entry. Pass the chosen `numberType` to POST /v1/phone-numbers/purchase.
          *
          */
         types?: Array<{
             numberType?: 'local' | 'mobile' | 'national' | 'toll_free';
-            tier?: 1 | 2 | 3 | 4;
+            /**
+             * Null on a `fulfilment: request` type, whose document tier is only known once its requirements are read.
+             */
+            tier?: (1 | 2 | 3 | 4) | null;
             needsKyc?: boolean;
             /**
              * Price a NEW number of this type costs per month, in cents.
@@ -26398,6 +26405,14 @@ type ListPhoneNumberCountriesResponse = ({
             smsAvailable?: boolean;
             callsAvailable?: boolean;
             inStock?: boolean;
+            /**
+             * `request`: the carrier stocks this type nowhere and only sources it to order, so it is always a pre-order.
+             */
+            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.
+             */
+            preOrderable?: boolean;
         }>;
     }>;
 });
@@ -26471,6 +26486,10 @@ type CheckPhoneNumberAvailabilityResponse = ({
      * Whether deliverable voice inventory exists right now.
      */
     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.
+     */
+    preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
     /**
      * For `geo` only: the area(s) the registered address must be in.
@@ -26735,6 +26754,10 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
      * Whether deliverable voice inventory exists right now.
      */
     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.
+     */
+    preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
     /**
      * For `geo` only: the area(s) the registered address must be in.
@@ -26916,6 +26939,10 @@ 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.
+     */
+    preOrder?: boolean;
     /**
      * The first/primary number, kept at the top level for backward compatibility. See `numbers` for the full set when `quantity` > 1.
      */
@@ -27676,6 +27703,10 @@ 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.
+     */
+    preOrder?: boolean;
     /**
      * The first/primary number, kept at the top level for backward compatibility. See `numbers` for the full set when `quantity` > 1.
      */

package/dist/index.d.ts

@@ -26379,13 +26379,20 @@ type ListPhoneNumberCountriesResponse = ({
          * Live carrier-stock snapshot (refreshed every 6h + on availability checks): false when NO offered type currently has deliverable inventory, so a purchase would fail. Treat as advisory; the purchase itself re-checks.
          */
         inStock?: boolean;
+        /**
+         * At least one out-of-stock type here can be pre-ordered (see `types[].preOrderable`).
+         */
+        preOrderable?: boolean;
         /**
          * Every number type offered in this country (default first). Capabilities, KYC tier, monthly price, and stock are per type. The country-level fields above mirror the first (default) entry. Pass the chosen `numberType` to POST /v1/phone-numbers/purchase.
          *
          */
         types?: Array<{
             numberType?: 'local' | 'mobile' | 'national' | 'toll_free';
-            tier?: 1 | 2 | 3 | 4;
+            /**
+             * Null on a `fulfilment: request` type, whose document tier is only known once its requirements are read.
+             */
+            tier?: (1 | 2 | 3 | 4) | null;
             needsKyc?: boolean;
             /**
              * Price a NEW number of this type costs per month, in cents.
@@ -26398,6 +26405,14 @@ type ListPhoneNumberCountriesResponse = ({
             smsAvailable?: boolean;
             callsAvailable?: boolean;
             inStock?: boolean;
+            /**
+             * `request`: the carrier stocks this type nowhere and only sources it to order, so it is always a pre-order.
+             */
+            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.
+             */
+            preOrderable?: boolean;
         }>;
     }>;
 });
@@ -26471,6 +26486,10 @@ type CheckPhoneNumberAvailabilityResponse = ({
      * Whether deliverable voice inventory exists right now.
      */
     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.
+     */
+    preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
     /**
      * For `geo` only: the area(s) the registered address must be in.
@@ -26735,6 +26754,10 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
      * Whether deliverable voice inventory exists right now.
      */
     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.
+     */
+    preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
     /**
      * For `geo` only: the area(s) the registered address must be in.
@@ -26916,6 +26939,10 @@ 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.
+     */
+    preOrder?: boolean;
     /**
      * The first/primary number, kept at the top level for backward compatibility. See `numbers` for the full set when `quantity` > 1.
      */
@@ -27676,6 +27703,10 @@ 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.
+     */
+    preOrder?: boolean;
     /**
      * The first/primary number, kept at the top level for backward compatibility. See `numbers` for the full set when `quantity` > 1.
      */

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -6483,9 +6483,9 @@ export const disableVoiceOnNumber = <ThrowOnError extends boolean = false>(optio
  * it if you miss the stock. Up to 20 watches at once.
  *
  * Countries and types marked `fulfilment: request` by
- * GET /v1/phone-numbers/countries can also be watched. Those are sourced
- * by a carrier request rather than held in stock, so a watch records
- * interest and no date is implied.
+ * GET /v1/phone-numbers/countries can also be watched, but anything with
+ * `preOrderable: true` does not need a watch: submit KYC and the carrier
+ * sources the number to order.
  *
  */
 export const createPhoneNumberStockWatch = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreatePhoneNumberStockWatchData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -26256,13 +26256,20 @@ export type ListPhoneNumberCountriesResponse = ({
          * Live carrier-stock snapshot (refreshed every 6h + on availability checks): false when NO offered type currently has deliverable inventory, so a purchase would fail. Treat as advisory; the purchase itself re-checks.
          */
         inStock?: boolean;
+        /**
+         * At least one out-of-stock type here can be pre-ordered (see `types[].preOrderable`).
+         */
+        preOrderable?: boolean;
         /**
          * Every number type offered in this country (default first). Capabilities, KYC tier, monthly price, and stock are per type. The country-level fields above mirror the first (default) entry. Pass the chosen `numberType` to POST /v1/phone-numbers/purchase.
          *
          */
         types?: Array<{
             numberType?: 'local' | 'mobile' | 'national' | 'toll_free';
-            tier?: 1 | 2 | 3 | 4;
+            /**
+             * Null on a `fulfilment: request` type, whose document tier is only known once its requirements are read.
+             */
+            tier?: (1 | 2 | 3 | 4) | null;
             needsKyc?: boolean;
             /**
              * Price a NEW number of this type costs per month, in cents.
@@ -26275,6 +26282,14 @@ export type ListPhoneNumberCountriesResponse = ({
             smsAvailable?: boolean;
             callsAvailable?: boolean;
             inStock?: boolean;
+            /**
+             * `request`: the carrier stocks this type nowhere and only sources it to order, so it is always a pre-order.
+             */
+            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.
+             */
+            preOrderable?: boolean;
         }>;
     }>;
 });
@@ -26354,6 +26369,10 @@ export type CheckPhoneNumberAvailabilityResponse = ({
      * Whether deliverable voice inventory exists right now.
      */
     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.
+     */
+    preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
     /**
      * For `geo` only: the area(s) the registered address must be in.
@@ -26632,6 +26651,10 @@ export type CheckWhatsAppNumberAvailabilityResponse = ({
      * Whether deliverable voice inventory exists right now.
      */
     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.
+     */
+    preOrderable?: boolean;
     addressConstraint?: 'geo' | 'country' | 'none';
     /**
      * For `geo` only: the area(s) the registered address must be in.
@@ -26819,6 +26842,10 @@ 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.
+     */
+    preOrder?: boolean;
     /**
      * The first/primary number, kept at the top level for backward compatibility. See `numbers` for the full set when `quantity` > 1.
      */
@@ -27632,6 +27659,10 @@ 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.
+     */
+    preOrder?: boolean;
     /**
      * The first/primary number, kept at the top level for backward compatibility. See `numbers` for the full set when `quantity` > 1.
      */