@zernio/node 0.2.1008 → 0.2.1010

package/dist/index.d.mts

@@ -808,7 +808,7 @@ declare class Zernio {
         remediatePhoneNumber: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RemediatePhoneNumberData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<RemediatePhoneNumberResponse, unknown, ThrowOnError>;
         replyToPhoneNumberReviewer: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ReplyToPhoneNumberReviewerData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ReplyToPhoneNumberReviewerResponse, unknown, ThrowOnError>;
         respondToPhoneNumberReviewer: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RespondToPhoneNumberReviewerData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<RespondToPhoneNumberReviewerResponse, unknown, ThrowOnError>;
-        createPhoneNumberStockWatch: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreatePhoneNumberStockWatchData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<PhoneNumberStockWatch, unknown, ThrowOnError>;
+        createPhoneNumberStockWatch: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreatePhoneNumberStockWatchData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreatePhoneNumberStockWatchResponse, unknown, ThrowOnError>;
         listPhoneNumberStockWatches: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListPhoneNumberStockWatchesResponse, ListPhoneNumberStockWatchesError, ThrowOnError>;
         deletePhoneNumberStockWatch: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<DeletePhoneNumberStockWatchData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DeletePhoneNumberStockWatchResponse, unknown, ThrowOnError>;
     };
@@ -19711,6 +19711,32 @@ type GetConnectUrlData = {
          *
          */
         redirect_url?: string;
+        /**
+         * Comma-separated permission areas to request instead of the platform's full permission set. Values: `posting`, `analytics`, `comments`, `messaging`, `ads`. Omit it (the default, and what the dashboard does) to request everything the platform supports.
+         *
+         * When present, the consent dialog asks only for the platform scopes behind those areas plus the scopes every connection needs (identity, token refresh, and listing the pages, organizations or channels the user picks from). Scopes the user was never asked for are absent from the account's `permissions`, and the health endpoints report them as not granted, so a `posting`-only account cannot read analytics or the inbox until it is connected again with more areas. First comments need `comments`: a `posting`-only account publishes the post and skips the first comment. Scopes the platform lists under none of the areas (X likes, bookmarks and follows, Pinterest ads-only extras) are requested only when the parameter is omitted.
+         *
+         * Supported on facebook, instagram (both login methods), linkedin, twitter, tiktok, youtube, threads, reddit, pinterest, googlebusiness and slack (via `GET /v1/connect/slack`). Rejected with 400 `INVALID_FIELD_VALUE` (`param: scopes`) on bluesky, telegram, discord, snapchat and whatsapp, whose dialog cannot be reduced, and for an empty list or an unknown area.
+         *
+         * What each area asks for, per platform (Google scopes shortened to their last path segment):
+         *
+         * | Platform | `posting` | `analytics` | `comments` | `messaging` | `ads` | Always requested |
+         * |---|---|---|---|---|---|---|
+         * | facebook | `pages_manage_posts` | `read_insights`, `pages_read_user_content` | `pages_manage_engagement`, `pages_read_user_content` | (in the always-requested set) | `ads_management`, `ads_read`, `leads_retrieval`, `pages_manage_ads`, `instagram_basic`, `business_management` | `pages_show_list`, `pages_read_engagement`, `pages_manage_metadata`, `pages_messaging` |
+         * | instagram (Instagram Login) | `instagram_business_content_publish` | `instagram_business_manage_insights` | `instagram_business_manage_comments` | `instagram_business_manage_messages` | none | `instagram_business_basic` |
+         * | instagram (`loginMethod=facebook_login`) | `instagram_content_publish` | `instagram_manage_insights` | `instagram_manage_comments` | `instagram_manage_messages` | `ads_management`, `ads_read`, `leads_retrieval`, `pages_manage_ads` | `instagram_basic`, `pages_show_list`, `pages_read_engagement`, `business_management`, `pages_messaging`, `pages_manage_metadata` |
+         * | linkedin | `w_member_social`, `w_organization_social`, `r_organization_social`, `r_organization_followers` | `r_member_postAnalytics`, `r_member_profileAnalytics`, `rw_organization_admin`, `r_organization_social`, `r_organization_followers` | `w_member_social`, `w_member_social_feed`, `w_organization_social`, `w_organization_social_feed`, `r_organization_social`, `r_organization_social_feed` | none | `r_ads`, `rw_ads`, `r_ads_reporting`, `r_marketing_leadgen_automation`, `rw_conversions` | `openid`, `profile`, `email`, `r_basicprofile`, `rw_organization_admin` |
+         * | twitter | `tweet.write`, `media.write` | (in the always-requested set) | `tweet.write`, `like.write`, `tweet.moderate.write` | `dm.read`, `dm.write`, `media.write` | none | `tweet.read`, `users.read`, `offline.access` |
+         * | tiktok | `video.publish` | `user.info.stats`, `user.insights`, `video.list`, `video.insights` | `comment.list`, `comment.list.manage`, `video.list` | `message.list.read`, `message.list.send`, `message.list.manage` | none | `user.info.basic`, `user.info.username`, `user.info.profile`, `user.account.type`, `video.publish`, `video.upload`, `video.list` |
+         * | youtube | `youtube.upload` | `yt-analytics.readonly` | `youtube.force-ssl` | none | none | `youtube` |
+         * | threads | `threads_content_publish`, `threads_manage_replies`, `threads_delete` | `threads_manage_insights` | `threads_content_publish`, `threads_read_replies`, `threads_manage_replies`, `threads_delete` | none | none | `threads_basic` |
+         * | reddit | `submit`, `read`, `mysubreddits`, `flair`, `history`, `edit` | `read`, `history` | `read`, `history`, `edit`, `vote` | `privatemessages` | none | `identity` |
+         * | pinterest | `boards:write`, `pins:read`, `pins:write` | `pins:read`, `user_accounts:read` | none | none | `ads:read`, `ads:write`, `boards:write`, `pins:read`, `pins:write` | `boards:read`, `user_accounts:read` |
+         * | googlebusiness | `business.manage` | `business.manage` | `business.manage` | none | none | `business.manage`, `userinfo.profile`, `userinfo.email` |
+         * | slack | `chat:write`, `chat:write.public`, `chat:write.customize`, `files:write`, `files:read` | none | none | `chat:write`, `chat:write.customize`, `files:write`, `files:read`, `channels:history`, `groups:history`, `im:history`, `mpim:history`, `im:read`, `im:write`, `mpim:read`, `users:read`, `reactions:read`, `reactions:write` | none | `channels:join`, `channels:read`, `groups:read`, `team:read` |
+         *
+         */
+        scopes?: string;
         /**
          * WhatsApp only. Rejected with 400 `INVALID_FIELD_VALUE` on any other platform.
          *
@@ -22896,6 +22922,10 @@ type ListSlackChannelsData = {
          * Start-OAuth mode only: where to send the user after the connect completes. `redirectUrl` is accepted as an alias.
          */
         redirect_url?: string;
+        /**
+         * Start-OAuth mode only. Comma-separated permission areas to request instead of the full Slack scope set, with the same semantics as `scopes` on `GET /v1/connect/{platform}`: `posting` installs the bot with the channel scopes it needs to post, `messaging` adds the history, DM and reaction scopes the inbox reads; `analytics`, `comments` and `ads` add nothing on Slack. Omit it to request everything.
+         */
+        scopes?: string;
     };
 };
 type ListSlackChannelsResponse = (({
@@ -32717,7 +32747,7 @@ type CheckPhoneNumberAvailabilityResponse = ({
      */
     areas?: Array<(string)>;
     /**
-     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area.
+     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area. Equal to `areaAvailability.inStock`.
      *
      */
     areaOptions?: Array<{
@@ -32735,7 +32765,7 @@ type CheckPhoneNumberAvailabilityResponse = ({
         count?: number;
     }>;
     /**
-     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     * Every area of the country's numbering plan with nothing deliverable now: `areaAvailability.preOrder` plus `areaAvailability.outOfStock`, kept for older clients. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
      *
      */
     soldOutAreas?: Array<{
@@ -32752,6 +32782,38 @@ type CheckPhoneNumberAvailabilityResponse = ({
          */
         preOrderable?: boolean;
     }>;
+    /**
+     * Every area of the country's numbering plan (Google libphonenumber geocoding, one row per city: Madrid covers 910 to 919), in one of three states, refreshed every 6 hours from the carrier's own inventory counts. The same answer the dashboard picker and the public country pages show. Empty lists mean the pair has no cached coverage yet, not that the country has no areas.
+     *
+     */
+    areaAvailability?: {
+        /**
+         * Deliverable numbers now, deepest first. Pass `ndc` as `areaCode` to hold the order to it.
+         */
+        inStock?: Array<{
+            ndc?: string;
+            name?: string;
+            /**
+             * Numbers we can sell there: the carrier count minus the numbers we hold back (WhatsApp refused them or another order holds them).
+             */
+            count?: number;
+        }>;
+        /**
+         * The carrier lists nothing there and the number type is a document tier: submit KYC with `areaCode` and `preOrder: true`, the carrier sources one (usually 2 to 4 weeks, never guaranteed), nothing is billed until it is active.
+         */
+        preOrder?: Array<{
+            ndc?: string;
+            name?: string;
+        }>;
+        /**
+         * Nothing deliverable and no pre-order: `listed` > 0 is stock the carrier shows that WhatsApp refused recently (held back until it clears), 0 is a dry area of an instant tier. A stock watch (POST /v1/phone-numbers/stock-watches with `areaCode`) is the way to hear when it is back.
+         */
+        outOfStock?: Array<{
+            ndc?: string;
+            name?: string;
+            listed?: number;
+        }>;
+    };
 });
 type CheckPhoneNumberAvailabilityError = (unknown | {
     error?: string;
@@ -32987,7 +33049,7 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
      */
     areas?: Array<(string)>;
     /**
-     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area.
+     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area. Equal to `areaAvailability.inStock`.
      *
      */
     areaOptions?: Array<{
@@ -33005,7 +33067,7 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
         count?: number;
     }>;
     /**
-     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     * Every area of the country's numbering plan with nothing deliverable now: `areaAvailability.preOrder` plus `areaAvailability.outOfStock`, kept for older clients. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
      *
      */
     soldOutAreas?: Array<{
@@ -33022,6 +33084,38 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
          */
         preOrderable?: boolean;
     }>;
+    /**
+     * Every area of the country's numbering plan (Google libphonenumber geocoding, one row per city: Madrid covers 910 to 919), in one of three states, refreshed every 6 hours from the carrier's own inventory counts. The same answer the dashboard picker and the public country pages show. Empty lists mean the pair has no cached coverage yet, not that the country has no areas.
+     *
+     */
+    areaAvailability?: {
+        /**
+         * Deliverable numbers now, deepest first. Pass `ndc` as `areaCode` to hold the order to it.
+         */
+        inStock?: Array<{
+            ndc?: string;
+            name?: string;
+            /**
+             * Numbers we can sell there: the carrier count minus the numbers we hold back (WhatsApp refused them or another order holds them).
+             */
+            count?: number;
+        }>;
+        /**
+         * The carrier lists nothing there and the number type is a document tier: submit KYC with `areaCode` and `preOrder: true`, the carrier sources one (usually 2 to 4 weeks, never guaranteed), nothing is billed until it is active.
+         */
+        preOrder?: Array<{
+            ndc?: string;
+            name?: string;
+        }>;
+        /**
+         * Nothing deliverable and no pre-order: `listed` > 0 is stock the carrier shows that WhatsApp refused recently (held back until it clears), 0 is a dry area of an instant tier. A stock watch (POST /v1/phone-numbers/stock-watches with `areaCode`) is the way to hear when it is back.
+         */
+        outOfStock?: Array<{
+            ndc?: string;
+            name?: string;
+            listed?: number;
+        }>;
+    };
 });
 type CheckWhatsAppNumberAvailabilityError = (unknown | {
     error?: string;
@@ -34355,7 +34449,17 @@ type CreatePhoneNumberStockWatchData = {
         areaCode?: string;
     };
 };
-type CreatePhoneNumberStockWatchResponse = (PhoneNumberStockWatch);
+type CreatePhoneNumberStockWatchResponse = ((PhoneNumberStockWatch & {
+    /**
+     * See the 201 response.
+     */
+    preOrderable?: boolean;
+}) | (PhoneNumberStockWatch & {
+    /**
+     * True when the watched area can be bought today as a pre-order (the carrier lists nothing there and the type is a document tier): submit KYC with `areaCode` and `preOrder: true` instead of waiting, usually 2 to 4 weeks, nothing billed until active. The watch is armed either way.
+     */
+    preOrderable?: boolean;
+}));
 type CreatePhoneNumberStockWatchError = (ErrorResponse | {
     error?: string;
 } | unknown);

package/dist/index.d.ts

@@ -808,7 +808,7 @@ declare class Zernio {
         remediatePhoneNumber: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RemediatePhoneNumberData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<RemediatePhoneNumberResponse, unknown, ThrowOnError>;
         replyToPhoneNumberReviewer: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ReplyToPhoneNumberReviewerData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ReplyToPhoneNumberReviewerResponse, unknown, ThrowOnError>;
         respondToPhoneNumberReviewer: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RespondToPhoneNumberReviewerData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<RespondToPhoneNumberReviewerResponse, unknown, ThrowOnError>;
-        createPhoneNumberStockWatch: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreatePhoneNumberStockWatchData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<PhoneNumberStockWatch, unknown, ThrowOnError>;
+        createPhoneNumberStockWatch: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<CreatePhoneNumberStockWatchData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreatePhoneNumberStockWatchResponse, unknown, ThrowOnError>;
         listPhoneNumberStockWatches: <ThrowOnError extends boolean = false>(options?: _hey_api_client_fetch.OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListPhoneNumberStockWatchesResponse, ListPhoneNumberStockWatchesError, ThrowOnError>;
         deletePhoneNumberStockWatch: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<DeletePhoneNumberStockWatchData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DeletePhoneNumberStockWatchResponse, unknown, ThrowOnError>;
     };
@@ -19711,6 +19711,32 @@ type GetConnectUrlData = {
          *
          */
         redirect_url?: string;
+        /**
+         * Comma-separated permission areas to request instead of the platform's full permission set. Values: `posting`, `analytics`, `comments`, `messaging`, `ads`. Omit it (the default, and what the dashboard does) to request everything the platform supports.
+         *
+         * When present, the consent dialog asks only for the platform scopes behind those areas plus the scopes every connection needs (identity, token refresh, and listing the pages, organizations or channels the user picks from). Scopes the user was never asked for are absent from the account's `permissions`, and the health endpoints report them as not granted, so a `posting`-only account cannot read analytics or the inbox until it is connected again with more areas. First comments need `comments`: a `posting`-only account publishes the post and skips the first comment. Scopes the platform lists under none of the areas (X likes, bookmarks and follows, Pinterest ads-only extras) are requested only when the parameter is omitted.
+         *
+         * Supported on facebook, instagram (both login methods), linkedin, twitter, tiktok, youtube, threads, reddit, pinterest, googlebusiness and slack (via `GET /v1/connect/slack`). Rejected with 400 `INVALID_FIELD_VALUE` (`param: scopes`) on bluesky, telegram, discord, snapchat and whatsapp, whose dialog cannot be reduced, and for an empty list or an unknown area.
+         *
+         * What each area asks for, per platform (Google scopes shortened to their last path segment):
+         *
+         * | Platform | `posting` | `analytics` | `comments` | `messaging` | `ads` | Always requested |
+         * |---|---|---|---|---|---|---|
+         * | facebook | `pages_manage_posts` | `read_insights`, `pages_read_user_content` | `pages_manage_engagement`, `pages_read_user_content` | (in the always-requested set) | `ads_management`, `ads_read`, `leads_retrieval`, `pages_manage_ads`, `instagram_basic`, `business_management` | `pages_show_list`, `pages_read_engagement`, `pages_manage_metadata`, `pages_messaging` |
+         * | instagram (Instagram Login) | `instagram_business_content_publish` | `instagram_business_manage_insights` | `instagram_business_manage_comments` | `instagram_business_manage_messages` | none | `instagram_business_basic` |
+         * | instagram (`loginMethod=facebook_login`) | `instagram_content_publish` | `instagram_manage_insights` | `instagram_manage_comments` | `instagram_manage_messages` | `ads_management`, `ads_read`, `leads_retrieval`, `pages_manage_ads` | `instagram_basic`, `pages_show_list`, `pages_read_engagement`, `business_management`, `pages_messaging`, `pages_manage_metadata` |
+         * | linkedin | `w_member_social`, `w_organization_social`, `r_organization_social`, `r_organization_followers` | `r_member_postAnalytics`, `r_member_profileAnalytics`, `rw_organization_admin`, `r_organization_social`, `r_organization_followers` | `w_member_social`, `w_member_social_feed`, `w_organization_social`, `w_organization_social_feed`, `r_organization_social`, `r_organization_social_feed` | none | `r_ads`, `rw_ads`, `r_ads_reporting`, `r_marketing_leadgen_automation`, `rw_conversions` | `openid`, `profile`, `email`, `r_basicprofile`, `rw_organization_admin` |
+         * | twitter | `tweet.write`, `media.write` | (in the always-requested set) | `tweet.write`, `like.write`, `tweet.moderate.write` | `dm.read`, `dm.write`, `media.write` | none | `tweet.read`, `users.read`, `offline.access` |
+         * | tiktok | `video.publish` | `user.info.stats`, `user.insights`, `video.list`, `video.insights` | `comment.list`, `comment.list.manage`, `video.list` | `message.list.read`, `message.list.send`, `message.list.manage` | none | `user.info.basic`, `user.info.username`, `user.info.profile`, `user.account.type`, `video.publish`, `video.upload`, `video.list` |
+         * | youtube | `youtube.upload` | `yt-analytics.readonly` | `youtube.force-ssl` | none | none | `youtube` |
+         * | threads | `threads_content_publish`, `threads_manage_replies`, `threads_delete` | `threads_manage_insights` | `threads_content_publish`, `threads_read_replies`, `threads_manage_replies`, `threads_delete` | none | none | `threads_basic` |
+         * | reddit | `submit`, `read`, `mysubreddits`, `flair`, `history`, `edit` | `read`, `history` | `read`, `history`, `edit`, `vote` | `privatemessages` | none | `identity` |
+         * | pinterest | `boards:write`, `pins:read`, `pins:write` | `pins:read`, `user_accounts:read` | none | none | `ads:read`, `ads:write`, `boards:write`, `pins:read`, `pins:write` | `boards:read`, `user_accounts:read` |
+         * | googlebusiness | `business.manage` | `business.manage` | `business.manage` | none | none | `business.manage`, `userinfo.profile`, `userinfo.email` |
+         * | slack | `chat:write`, `chat:write.public`, `chat:write.customize`, `files:write`, `files:read` | none | none | `chat:write`, `chat:write.customize`, `files:write`, `files:read`, `channels:history`, `groups:history`, `im:history`, `mpim:history`, `im:read`, `im:write`, `mpim:read`, `users:read`, `reactions:read`, `reactions:write` | none | `channels:join`, `channels:read`, `groups:read`, `team:read` |
+         *
+         */
+        scopes?: string;
         /**
          * WhatsApp only. Rejected with 400 `INVALID_FIELD_VALUE` on any other platform.
          *
@@ -22896,6 +22922,10 @@ type ListSlackChannelsData = {
          * Start-OAuth mode only: where to send the user after the connect completes. `redirectUrl` is accepted as an alias.
          */
         redirect_url?: string;
+        /**
+         * Start-OAuth mode only. Comma-separated permission areas to request instead of the full Slack scope set, with the same semantics as `scopes` on `GET /v1/connect/{platform}`: `posting` installs the bot with the channel scopes it needs to post, `messaging` adds the history, DM and reaction scopes the inbox reads; `analytics`, `comments` and `ads` add nothing on Slack. Omit it to request everything.
+         */
+        scopes?: string;
     };
 };
 type ListSlackChannelsResponse = (({
@@ -32717,7 +32747,7 @@ type CheckPhoneNumberAvailabilityResponse = ({
      */
     areas?: Array<(string)>;
     /**
-     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area.
+     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area. Equal to `areaAvailability.inStock`.
      *
      */
     areaOptions?: Array<{
@@ -32735,7 +32765,7 @@ type CheckPhoneNumberAvailabilityResponse = ({
         count?: number;
     }>;
     /**
-     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     * Every area of the country's numbering plan with nothing deliverable now: `areaAvailability.preOrder` plus `areaAvailability.outOfStock`, kept for older clients. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
      *
      */
     soldOutAreas?: Array<{
@@ -32752,6 +32782,38 @@ type CheckPhoneNumberAvailabilityResponse = ({
          */
         preOrderable?: boolean;
     }>;
+    /**
+     * Every area of the country's numbering plan (Google libphonenumber geocoding, one row per city: Madrid covers 910 to 919), in one of three states, refreshed every 6 hours from the carrier's own inventory counts. The same answer the dashboard picker and the public country pages show. Empty lists mean the pair has no cached coverage yet, not that the country has no areas.
+     *
+     */
+    areaAvailability?: {
+        /**
+         * Deliverable numbers now, deepest first. Pass `ndc` as `areaCode` to hold the order to it.
+         */
+        inStock?: Array<{
+            ndc?: string;
+            name?: string;
+            /**
+             * Numbers we can sell there: the carrier count minus the numbers we hold back (WhatsApp refused them or another order holds them).
+             */
+            count?: number;
+        }>;
+        /**
+         * The carrier lists nothing there and the number type is a document tier: submit KYC with `areaCode` and `preOrder: true`, the carrier sources one (usually 2 to 4 weeks, never guaranteed), nothing is billed until it is active.
+         */
+        preOrder?: Array<{
+            ndc?: string;
+            name?: string;
+        }>;
+        /**
+         * Nothing deliverable and no pre-order: `listed` > 0 is stock the carrier shows that WhatsApp refused recently (held back until it clears), 0 is a dry area of an instant tier. A stock watch (POST /v1/phone-numbers/stock-watches with `areaCode`) is the way to hear when it is back.
+         */
+        outOfStock?: Array<{
+            ndc?: string;
+            name?: string;
+            listed?: number;
+        }>;
+    };
 });
 type CheckPhoneNumberAvailabilityError = (unknown | {
     error?: string;
@@ -32987,7 +33049,7 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
      */
     areas?: Array<(string)>;
     /**
-     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area.
+     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area. Equal to `areaAvailability.inStock`.
      *
      */
     areaOptions?: Array<{
@@ -33005,7 +33067,7 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
         count?: number;
     }>;
     /**
-     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     * Every area of the country's numbering plan with nothing deliverable now: `areaAvailability.preOrder` plus `areaAvailability.outOfStock`, kept for older clients. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
      *
      */
     soldOutAreas?: Array<{
@@ -33022,6 +33084,38 @@ type CheckWhatsAppNumberAvailabilityResponse = ({
          */
         preOrderable?: boolean;
     }>;
+    /**
+     * Every area of the country's numbering plan (Google libphonenumber geocoding, one row per city: Madrid covers 910 to 919), in one of three states, refreshed every 6 hours from the carrier's own inventory counts. The same answer the dashboard picker and the public country pages show. Empty lists mean the pair has no cached coverage yet, not that the country has no areas.
+     *
+     */
+    areaAvailability?: {
+        /**
+         * Deliverable numbers now, deepest first. Pass `ndc` as `areaCode` to hold the order to it.
+         */
+        inStock?: Array<{
+            ndc?: string;
+            name?: string;
+            /**
+             * Numbers we can sell there: the carrier count minus the numbers we hold back (WhatsApp refused them or another order holds them).
+             */
+            count?: number;
+        }>;
+        /**
+         * The carrier lists nothing there and the number type is a document tier: submit KYC with `areaCode` and `preOrder: true`, the carrier sources one (usually 2 to 4 weeks, never guaranteed), nothing is billed until it is active.
+         */
+        preOrder?: Array<{
+            ndc?: string;
+            name?: string;
+        }>;
+        /**
+         * Nothing deliverable and no pre-order: `listed` > 0 is stock the carrier shows that WhatsApp refused recently (held back until it clears), 0 is a dry area of an instant tier. A stock watch (POST /v1/phone-numbers/stock-watches with `areaCode`) is the way to hear when it is back.
+         */
+        outOfStock?: Array<{
+            ndc?: string;
+            name?: string;
+            listed?: number;
+        }>;
+    };
 });
 type CheckWhatsAppNumberAvailabilityError = (unknown | {
     error?: string;
@@ -34355,7 +34449,17 @@ type CreatePhoneNumberStockWatchData = {
         areaCode?: string;
     };
 };
-type CreatePhoneNumberStockWatchResponse = (PhoneNumberStockWatch);
+type CreatePhoneNumberStockWatchResponse = ((PhoneNumberStockWatch & {
+    /**
+     * See the 201 response.
+     */
+    preOrderable?: boolean;
+}) | (PhoneNumberStockWatch & {
+    /**
+     * True when the watched area can be bought today as a pre-order (the carrier lists nothing there and the type is a document tier): submit KYC with `areaCode` and `preOrder: true` instead of waiting, usually 2 to 4 weeks, nothing billed until active. The watch is armed either way.
+     */
+    preOrderable?: boolean;
+}));
 type CreatePhoneNumberStockWatchError = (ErrorResponse | {
     error?: string;
 } | unknown);

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -18623,6 +18623,32 @@ export type GetConnectUrlData = {
          *
          */
         redirect_url?: string;
+        /**
+         * Comma-separated permission areas to request instead of the platform's full permission set. Values: `posting`, `analytics`, `comments`, `messaging`, `ads`. Omit it (the default, and what the dashboard does) to request everything the platform supports.
+         *
+         * When present, the consent dialog asks only for the platform scopes behind those areas plus the scopes every connection needs (identity, token refresh, and listing the pages, organizations or channels the user picks from). Scopes the user was never asked for are absent from the account's `permissions`, and the health endpoints report them as not granted, so a `posting`-only account cannot read analytics or the inbox until it is connected again with more areas. First comments need `comments`: a `posting`-only account publishes the post and skips the first comment. Scopes the platform lists under none of the areas (X likes, bookmarks and follows, Pinterest ads-only extras) are requested only when the parameter is omitted.
+         *
+         * Supported on facebook, instagram (both login methods), linkedin, twitter, tiktok, youtube, threads, reddit, pinterest, googlebusiness and slack (via `GET /v1/connect/slack`). Rejected with 400 `INVALID_FIELD_VALUE` (`param: scopes`) on bluesky, telegram, discord, snapchat and whatsapp, whose dialog cannot be reduced, and for an empty list or an unknown area.
+         *
+         * What each area asks for, per platform (Google scopes shortened to their last path segment):
+         *
+         * | Platform | `posting` | `analytics` | `comments` | `messaging` | `ads` | Always requested |
+         * |---|---|---|---|---|---|---|
+         * | facebook | `pages_manage_posts` | `read_insights`, `pages_read_user_content` | `pages_manage_engagement`, `pages_read_user_content` | (in the always-requested set) | `ads_management`, `ads_read`, `leads_retrieval`, `pages_manage_ads`, `instagram_basic`, `business_management` | `pages_show_list`, `pages_read_engagement`, `pages_manage_metadata`, `pages_messaging` |
+         * | instagram (Instagram Login) | `instagram_business_content_publish` | `instagram_business_manage_insights` | `instagram_business_manage_comments` | `instagram_business_manage_messages` | none | `instagram_business_basic` |
+         * | instagram (`loginMethod=facebook_login`) | `instagram_content_publish` | `instagram_manage_insights` | `instagram_manage_comments` | `instagram_manage_messages` | `ads_management`, `ads_read`, `leads_retrieval`, `pages_manage_ads` | `instagram_basic`, `pages_show_list`, `pages_read_engagement`, `business_management`, `pages_messaging`, `pages_manage_metadata` |
+         * | linkedin | `w_member_social`, `w_organization_social`, `r_organization_social`, `r_organization_followers` | `r_member_postAnalytics`, `r_member_profileAnalytics`, `rw_organization_admin`, `r_organization_social`, `r_organization_followers` | `w_member_social`, `w_member_social_feed`, `w_organization_social`, `w_organization_social_feed`, `r_organization_social`, `r_organization_social_feed` | none | `r_ads`, `rw_ads`, `r_ads_reporting`, `r_marketing_leadgen_automation`, `rw_conversions` | `openid`, `profile`, `email`, `r_basicprofile`, `rw_organization_admin` |
+         * | twitter | `tweet.write`, `media.write` | (in the always-requested set) | `tweet.write`, `like.write`, `tweet.moderate.write` | `dm.read`, `dm.write`, `media.write` | none | `tweet.read`, `users.read`, `offline.access` |
+         * | tiktok | `video.publish` | `user.info.stats`, `user.insights`, `video.list`, `video.insights` | `comment.list`, `comment.list.manage`, `video.list` | `message.list.read`, `message.list.send`, `message.list.manage` | none | `user.info.basic`, `user.info.username`, `user.info.profile`, `user.account.type`, `video.publish`, `video.upload`, `video.list` |
+         * | youtube | `youtube.upload` | `yt-analytics.readonly` | `youtube.force-ssl` | none | none | `youtube` |
+         * | threads | `threads_content_publish`, `threads_manage_replies`, `threads_delete` | `threads_manage_insights` | `threads_content_publish`, `threads_read_replies`, `threads_manage_replies`, `threads_delete` | none | none | `threads_basic` |
+         * | reddit | `submit`, `read`, `mysubreddits`, `flair`, `history`, `edit` | `read`, `history` | `read`, `history`, `edit`, `vote` | `privatemessages` | none | `identity` |
+         * | pinterest | `boards:write`, `pins:read`, `pins:write` | `pins:read`, `user_accounts:read` | none | none | `ads:read`, `ads:write`, `boards:write`, `pins:read`, `pins:write` | `boards:read`, `user_accounts:read` |
+         * | googlebusiness | `business.manage` | `business.manage` | `business.manage` | none | none | `business.manage`, `userinfo.profile`, `userinfo.email` |
+         * | slack | `chat:write`, `chat:write.public`, `chat:write.customize`, `files:write`, `files:read` | none | none | `chat:write`, `chat:write.customize`, `files:write`, `files:read`, `channels:history`, `groups:history`, `im:history`, `mpim:history`, `im:read`, `im:write`, `mpim:read`, `users:read`, `reactions:read`, `reactions:write` | none | `channels:join`, `channels:read`, `groups:read`, `team:read` |
+         *
+         */
+        scopes?: string;
         /**
          * WhatsApp only. Rejected with 400 `INVALID_FIELD_VALUE` on any other platform.
          *
@@ -21971,6 +21997,10 @@ export type ListSlackChannelsData = {
          * Start-OAuth mode only: where to send the user after the connect completes. `redirectUrl` is accepted as an alias.
          */
         redirect_url?: string;
+        /**
+         * Start-OAuth mode only. Comma-separated permission areas to request instead of the full Slack scope set, with the same semantics as `scopes` on `GET /v1/connect/{platform}`: `posting` installs the bot with the channel scopes it needs to post, `messaging` adds the history, DM and reaction scopes the inbox reads; `analytics`, `comments` and `ads` add nothing on Slack. Omit it to request everything.
+         */
+        scopes?: string;
     };
 };
 
@@ -32590,7 +32620,7 @@ export type CheckPhoneNumberAvailabilityResponse = ({
      */
     areas?: Array<(string)>;
     /**
-     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area.
+     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area. Equal to `areaAvailability.inStock`.
      *
      */
     areaOptions?: Array<{
@@ -32608,7 +32638,7 @@ export type CheckPhoneNumberAvailabilityResponse = ({
         count?: number;
     }>;
     /**
-     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     * Every area of the country's numbering plan with nothing deliverable now: `areaAvailability.preOrder` plus `areaAvailability.outOfStock`, kept for older clients. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
      *
      */
     soldOutAreas?: Array<{
@@ -32625,6 +32655,38 @@ export type CheckPhoneNumberAvailabilityResponse = ({
          */
         preOrderable?: boolean;
     }>;
+    /**
+     * Every area of the country's numbering plan (Google libphonenumber geocoding, one row per city: Madrid covers 910 to 919), in one of three states, refreshed every 6 hours from the carrier's own inventory counts. The same answer the dashboard picker and the public country pages show. Empty lists mean the pair has no cached coverage yet, not that the country has no areas.
+     *
+     */
+    areaAvailability?: {
+        /**
+         * Deliverable numbers now, deepest first. Pass `ndc` as `areaCode` to hold the order to it.
+         */
+        inStock?: Array<{
+            ndc?: string;
+            name?: string;
+            /**
+             * Numbers we can sell there: the carrier count minus the numbers we hold back (WhatsApp refused them or another order holds them).
+             */
+            count?: number;
+        }>;
+        /**
+         * The carrier lists nothing there and the number type is a document tier: submit KYC with `areaCode` and `preOrder: true`, the carrier sources one (usually 2 to 4 weeks, never guaranteed), nothing is billed until it is active.
+         */
+        preOrder?: Array<{
+            ndc?: string;
+            name?: string;
+        }>;
+        /**
+         * Nothing deliverable and no pre-order: `listed` > 0 is stock the carrier shows that WhatsApp refused recently (held back until it clears), 0 is a dry area of an instant tier. A stock watch (POST /v1/phone-numbers/stock-watches with `areaCode`) is the way to hear when it is back.
+         */
+        outOfStock?: Array<{
+            ndc?: string;
+            name?: string;
+            listed?: number;
+        }>;
+    };
 });
 
 export type CheckPhoneNumberAvailabilityError = (unknown | {
@@ -32874,7 +32936,7 @@ export type CheckWhatsAppNumberAvailabilityResponse = ({
      */
     areas?: Array<(string)>;
     /**
-     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area.
+     * Live inventory grouped by area code. For US and CA this is the full country inventory (every area code with stock, recognizable metros listed first, then alphabetical); other countries are ordered largest stock first; they list the areas in the latest inventory page (up to 500 numbers, which for most countries is the entire pool). Empty when out of stock (or the area lookup failed). Pass a chosen `ndc` as `areaCode` on POST /v1/phone-numbers/purchase (or on the KYC submit for regulated countries) to require that area. Equal to `areaAvailability.inStock`.
      *
      */
     areaOptions?: Array<{
@@ -32892,7 +32954,7 @@ export type CheckWhatsAppNumberAvailabilityResponse = ({
         count?: number;
     }>;
     /**
-     * Areas that had stock in the last 90 days and have none now. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
+     * Every area of the country's numbering plan with nothing deliverable now: `areaAvailability.preOrder` plus `areaAvailability.outOfStock`, kept for older clients. Pass one as `areaCode` with `preOrder: true` on the KYC submit when `preOrderable` is true, or watch it with POST /v1/phone-numbers/stock-watches.
      *
      */
     soldOutAreas?: Array<{
@@ -32909,6 +32971,38 @@ export type CheckWhatsAppNumberAvailabilityResponse = ({
          */
         preOrderable?: boolean;
     }>;
+    /**
+     * Every area of the country's numbering plan (Google libphonenumber geocoding, one row per city: Madrid covers 910 to 919), in one of three states, refreshed every 6 hours from the carrier's own inventory counts. The same answer the dashboard picker and the public country pages show. Empty lists mean the pair has no cached coverage yet, not that the country has no areas.
+     *
+     */
+    areaAvailability?: {
+        /**
+         * Deliverable numbers now, deepest first. Pass `ndc` as `areaCode` to hold the order to it.
+         */
+        inStock?: Array<{
+            ndc?: string;
+            name?: string;
+            /**
+             * Numbers we can sell there: the carrier count minus the numbers we hold back (WhatsApp refused them or another order holds them).
+             */
+            count?: number;
+        }>;
+        /**
+         * The carrier lists nothing there and the number type is a document tier: submit KYC with `areaCode` and `preOrder: true`, the carrier sources one (usually 2 to 4 weeks, never guaranteed), nothing is billed until it is active.
+         */
+        preOrder?: Array<{
+            ndc?: string;
+            name?: string;
+        }>;
+        /**
+         * Nothing deliverable and no pre-order: `listed` > 0 is stock the carrier shows that WhatsApp refused recently (held back until it clears), 0 is a dry area of an instant tier. A stock watch (POST /v1/phone-numbers/stock-watches with `areaCode`) is the way to hear when it is back.
+         */
+        outOfStock?: Array<{
+            ndc?: string;
+            name?: string;
+            listed?: number;
+        }>;
+    };
 });
 
 export type CheckWhatsAppNumberAvailabilityError = (unknown | {
@@ -34331,7 +34425,17 @@ export type CreatePhoneNumberStockWatchData = {
     };
 };
 
-export type CreatePhoneNumberStockWatchResponse = (PhoneNumberStockWatch);
+export type CreatePhoneNumberStockWatchResponse = ((PhoneNumberStockWatch & {
+    /**
+     * See the 201 response.
+     */
+    preOrderable?: boolean;
+}) | (PhoneNumberStockWatch & {
+    /**
+     * True when the watched area can be bought today as a pre-order (the carrier lists nothing there and the type is a document tier): submit KYC with `areaCode` and `preOrder: true` instead of waiting, usually 2 to 4 weeks, nothing billed until active. The watch is armed either way.
+     */
+    preOrderable?: boolean;
+}));
 
 export type CreatePhoneNumberStockWatchError = (ErrorResponse | {
     error?: string;