@mobilerun/sdk 5.4.0 → 5.6.0

package/resources/numbers/numbers.d.ts

@@ -1,22 +1,21 @@
 import { APIResource } from "../../core/resource.js";
 import * as Shared from "../shared.js";
 import * as MessagesAPI from "./messages.js";
-import { MessageListParams, MessageListResponse, Messages } from "./messages.js";
+import { MessageListParams, MessageListResponse, MessageSendParams, MessageSendResponse, Messages } from "./messages.js";
 import { APIPromise } from "../../core/api-promise.js";
 import { RequestOptions } from "../../internal/request-options.js";
 export declare class Numbers extends APIResource {
     messages: MessagesAPI.Messages;
     /**
-     * Starts a Mobilerun Phone purchase for the authenticated owner. Accepted requests
-     * always return the same asynchronous envelope; poll GET /numbers/phones/{id} for
-     * its business state. `purpose` and `country` are mutually exclusive.
+     * Starts a phone-number purchase. Poll the returned phone number for status
+     * updates. `purpose` and `country` cannot be combined.
      *
      * @example
      * ```ts
      * const number = await client.numbers.create();
      * ```
      */
-    create(params?: NumberCreateParams | null | undefined, options?: RequestOptions): APIPromise<NumberCreateResponse>;
+    create(body?: NumberCreateParams | null | undefined, options?: RequestOptions): APIPromise<NumberCreateResponse>;
     /**
      * Retrieves a single phone number.
      *
@@ -29,11 +28,8 @@ export declare class Numbers extends APIResource {
      */
     retrieve(id: string, options?: RequestOptions): APIPromise<NumberRetrieveResponse>;
     /**
-     * Updates the phone number's user-defined display label. Omitting `label` leaves
-     * it unchanged; setting it to null or an empty string clears it. The label is
-     * capped at 100 characters, is display-only, and never affects routing. It also
-     * seeds the billing entity name when set at purchase time; a later change here
-     * does not rename the already-created billing entity.
+     * Updates the display label. Omitting `label` leaves it unchanged; null or an
+     * empty string clears it.
      *
      * @example
      * ```ts
@@ -44,8 +40,7 @@ export declare class Numbers extends APIResource {
      */
     update(id: string, body?: NumberUpdateParams | null | undefined, options?: RequestOptions): APIPromise<NumberUpdateResponse>;
     /**
-     * Lists phone numbers owned by the authenticated user — both BYO (`user`) and
-     * provisioned (`mobilerun`) numbers.
+     * Lists the caller's phone numbers.
      *
      * @example
      * ```ts
@@ -54,23 +49,9 @@ export declare class Numbers extends APIResource {
      */
     list(query?: NumberListParams | null | undefined, options?: RequestOptions): APIPromise<NumberListResponse>;
     /**
-     * Cancels a Mobilerun Phone. The outcome depends on the number's current state:
-     *
-     * - If the number is still awaiting payment and no payment for it is currently
-     *   being processed, the checkout is closed immediately and the number is retired.
-     * - If the number is on the standard paid plan and already paid and in service,
-     *   cancellation is scheduled for the end of the current billing period rather
-     *   than taking effect immediately. The number stays usable through the period
-     *   already paid for, with no partial refund. Calling this again while a
-     *   cancellation is already scheduled is a no-op that returns the same result. The
-     *   response's `state` reflects this as `cancel_scheduled` with
-     *   `cancelAtPeriodEnd: true`; `currentPeriodEnd` is populated once billing
-     *   confirms the cancellation.
-     *
-     * Any other state (already refunding, a permanent billing failure, a payment
-     * currently being processed, an included-plan number, or a non-hosted/BYO number)
-     * returns 409 `not_cancellable`. Returns 404 if the number doesn't exist or isn't
-     * owned by the caller.
+     * Cancels a pending purchase or schedules cancellation of an active paid phone
+     * number. Repeating a scheduled cancellation is safe. Returns 409 when
+     * cancellation is not available.
      *
      * @example
      * ```ts
@@ -81,8 +62,19 @@ export declare class Numbers extends APIResource {
      */
     delete(id: string, options?: RequestOptions): APIPromise<NumberDeleteResponse>;
     /**
-     * Lists the countries currently offered for a dedicated Mobilerun Phone, with live
-     * stock status. Pass `country` as the `country` field on POST /numbers/phones.
+     * Returns included phone capacity for a country. Creating a phone is
+     * authoritative.
+     *
+     * @example
+     * ```ts
+     * const response = await client.numbers.capacity({
+     *   country: 'de',
+     * });
+     * ```
+     */
+    capacity(query: NumberCapacityParams, options?: RequestOptions): APIPromise<NumberCapacityResponse>;
+    /**
+     * Lists available countries and current phone-number availability.
      *
      * @example
      * ```ts
@@ -116,8 +108,18 @@ export interface NumberRetrieveResponse {
 export declare namespace NumberRetrieveResponse {
     interface Data {
         id: string;
+        /**
+         * Actions currently available for this phone number.
+         */
+        actions: Data.Actions;
         cancelAtPeriodEnd: boolean;
+        /**
+         * @deprecated Deprecated: use `actions.cancel`
+         */
         cancellable: boolean;
+        /**
+         * @deprecated Deprecated: use `actions.send`
+         */
         canSend: boolean;
         capabilities: Array<'sms' | 'voice'> | null;
         checkoutUrl: string | null;
@@ -130,6 +132,24 @@ export declare namespace NumberRetrieveResponse {
         state: 'awaiting_payment' | 'provisioning' | 'active' | 'cancel_scheduled' | 'expired' | 'failed';
         updatedAt: string | null;
     }
+    namespace Data {
+        /**
+         * Actions currently available for this phone number.
+         */
+        interface Actions {
+            /**
+             * True when DELETE /numbers/phones/{id} would currently succeed.
+             */
+            cancel: boolean;
+            /**
+             * True when this number passes the send gate of POST
+             * /numbers/phones/{id}/messages: self-service sending is switched on and the
+             * number is active and able to send SMS. Daily and burst limits and recipient/body
+             * checks still apply; the send endpoint stays the final judge.
+             */
+            send: boolean;
+        }
+    }
 }
 export interface NumberUpdateResponse {
     data: NumberUpdateResponse.Data;
@@ -137,8 +157,18 @@ export interface NumberUpdateResponse {
 export declare namespace NumberUpdateResponse {
     interface Data {
         id: string;
+        /**
+         * Actions currently available for this phone number.
+         */
+        actions: Data.Actions;
         cancelAtPeriodEnd: boolean;
+        /**
+         * @deprecated Deprecated: use `actions.cancel`
+         */
         cancellable: boolean;
+        /**
+         * @deprecated Deprecated: use `actions.send`
+         */
         canSend: boolean;
         capabilities: Array<'sms' | 'voice'> | null;
         checkoutUrl: string | null;
@@ -151,6 +181,24 @@ export declare namespace NumberUpdateResponse {
         state: 'awaiting_payment' | 'provisioning' | 'active' | 'cancel_scheduled' | 'expired' | 'failed';
         updatedAt: string | null;
     }
+    namespace Data {
+        /**
+         * Actions currently available for this phone number.
+         */
+        interface Actions {
+            /**
+             * True when DELETE /numbers/phones/{id} would currently succeed.
+             */
+            cancel: boolean;
+            /**
+             * True when this number passes the send gate of POST
+             * /numbers/phones/{id}/messages: self-service sending is switched on and the
+             * number is active and able to send SMS. Daily and burst limits and recipient/body
+             * checks still apply; the send endpoint stays the final judge.
+             */
+            send: boolean;
+        }
+    }
 }
 export interface NumberListResponse {
     items: Array<NumberListResponse.Item>;
@@ -159,8 +207,18 @@ export interface NumberListResponse {
 export declare namespace NumberListResponse {
     interface Item {
         id: string;
+        /**
+         * Actions currently available for this phone number.
+         */
+        actions: Item.Actions;
         cancelAtPeriodEnd: boolean;
+        /**
+         * @deprecated Deprecated: use `actions.cancel`
+         */
         cancellable: boolean;
+        /**
+         * @deprecated Deprecated: use `actions.send`
+         */
         canSend: boolean;
         capabilities: Array<'sms' | 'voice'> | null;
         checkoutUrl: string | null;
@@ -173,6 +231,24 @@ export declare namespace NumberListResponse {
         state: 'awaiting_payment' | 'provisioning' | 'active' | 'cancel_scheduled' | 'expired' | 'failed';
         updatedAt: string | null;
     }
+    namespace Item {
+        /**
+         * Actions currently available for this phone number.
+         */
+        interface Actions {
+            /**
+             * True when DELETE /numbers/phones/{id} would currently succeed.
+             */
+            cancel: boolean;
+            /**
+             * True when this number passes the send gate of POST
+             * /numbers/phones/{id}/messages: self-service sending is switched on and the
+             * number is active and able to send SMS. Daily and burst limits and recipient/body
+             * checks still apply; the send endpoint stays the final judge.
+             */
+            send: boolean;
+        }
+    }
 }
 export interface NumberDeleteResponse {
     data: NumberDeleteResponse.Data;
@@ -180,8 +256,18 @@ export interface NumberDeleteResponse {
 export declare namespace NumberDeleteResponse {
     interface Data {
         id: string;
+        /**
+         * Actions currently available for this phone number.
+         */
+        actions: Data.Actions;
         cancelAtPeriodEnd: boolean;
+        /**
+         * @deprecated Deprecated: use `actions.cancel`
+         */
         cancellable: boolean;
+        /**
+         * @deprecated Deprecated: use `actions.send`
+         */
         canSend: boolean;
         capabilities: Array<'sms' | 'voice'> | null;
         checkoutUrl: string | null;
@@ -194,6 +280,39 @@ export declare namespace NumberDeleteResponse {
         state: 'awaiting_payment' | 'provisioning' | 'active' | 'cancel_scheduled' | 'expired' | 'failed';
         updatedAt: string | null;
     }
+    namespace Data {
+        /**
+         * Actions currently available for this phone number.
+         */
+        interface Actions {
+            /**
+             * True when DELETE /numbers/phones/{id} would currently succeed.
+             */
+            cancel: boolean;
+            /**
+             * True when this number passes the send gate of POST
+             * /numbers/phones/{id}/messages: self-service sending is switched on and the
+             * number is active and able to send SMS. Daily and burst limits and recipient/body
+             * checks still apply; the send endpoint stays the final judge.
+             */
+            send: boolean;
+        }
+    }
+}
+export interface NumberCapacityResponse {
+    data: NumberCapacityResponse.Data;
+}
+export declare namespace NumberCapacityResponse {
+    interface Data {
+        included: number;
+        /**
+         * @deprecated Deprecated — always equal to `remaining`. Migrate to `remaining`;
+         * this field will be removed in a future revision.
+         */
+        includedRemaining: number;
+        remaining: number;
+        status: 'available' | 'exhausted' | 'not_included';
+    }
 }
 export interface NumberCountriesResponse {
     data: NumberCountriesResponse.Data;
@@ -227,29 +346,25 @@ export declare namespace NumberPurposesResponse {
 }
 export interface NumberCreateParams {
     /**
-     * Body param: Prefer a free package seat ('included', default) or force the paid
-     * checkout ('rent')
+     * Use included capacity when available, require included capacity without paid
+     * fallback (included_only), or start a paid checkout (rent).
      */
-    billingPreference?: 'included' | 'rent';
+    billingPreference?: 'included' | 'included_only' | 'rent';
     /**
-     * Body param: Optional ISO 3166-1 alpha-2 country code from GET
-     * /numbers/countries. Cannot be combined with `purpose`.
+     * Optional ISO 3166-1 alpha-2 country code from GET /numbers/phones/countries.
+     * Cannot be combined with `purpose`.
      */
     country?: string;
     /**
-     * Body param: User-defined display label — NFC-normalized, up to 100 GRAPHEMES
-     * (not UTF-16 code units; an emoji/flag may span several). Display-only, never
-     * used for routing. Also seeds the billing entity name at purchase.
+     * User-defined display label — NFC-normalized, up to 100 GRAPHEMES (not UTF-16
+     * code units; an emoji/flag may span several). Display-only, never used for
+     * routing. Also seeds the billing entity name at purchase.
      */
     label?: string | null;
     /**
-     * Body param: Optional Mobilerun Phone purpose slug from GET /numbers/purposes.
+     * Optional purpose from GET /numbers/phones/purposes.
      */
     purpose?: string;
-    /**
-     * Header param: Optional request idempotency key.
-     */
-    'Idempotency-Key'?: string;
 }
 export interface NumberUpdateParams {
     /**
@@ -263,8 +378,14 @@ export interface NumberListParams {
     page?: number;
     pageSize?: number;
 }
+export interface NumberCapacityParams {
+    /**
+     * ISO 3166-1 alpha-2 country code from GET /numbers/phones/countries.
+     */
+    country: string;
+}
 export declare namespace Numbers {
-    export { type NumberCreateResponse as NumberCreateResponse, type NumberRetrieveResponse as NumberRetrieveResponse, type NumberUpdateResponse as NumberUpdateResponse, type NumberListResponse as NumberListResponse, type NumberDeleteResponse as NumberDeleteResponse, type NumberCountriesResponse as NumberCountriesResponse, type NumberPurposesResponse as NumberPurposesResponse, type NumberCreateParams as NumberCreateParams, type NumberUpdateParams as NumberUpdateParams, type NumberListParams as NumberListParams, };
-    export { Messages as Messages, type MessageListResponse as MessageListResponse, type MessageListParams as MessageListParams, };
+    export { type NumberCreateResponse as NumberCreateResponse, type NumberRetrieveResponse as NumberRetrieveResponse, type NumberUpdateResponse as NumberUpdateResponse, type NumberListResponse as NumberListResponse, type NumberDeleteResponse as NumberDeleteResponse, type NumberCapacityResponse as NumberCapacityResponse, type NumberCountriesResponse as NumberCountriesResponse, type NumberPurposesResponse as NumberPurposesResponse, type NumberCreateParams as NumberCreateParams, type NumberUpdateParams as NumberUpdateParams, type NumberListParams as NumberListParams, type NumberCapacityParams as NumberCapacityParams, };
+    export { Messages as Messages, type MessageListResponse as MessageListResponse, type MessageSendResponse as MessageSendResponse, type MessageListParams as MessageListParams, type MessageSendParams as MessageSendParams, };
 }
 //# sourceMappingURL=numbers.d.ts.map

package/resources/numbers/numbers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../src/resources/numbers/numbers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../src/resources/numbers/numbers.ts"],"names":[],"mappings":"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"}

package/resources/numbers/numbers.js

@@ -6,7 +6,6 @@ const tslib_1 = require("../../internal/tslib.js");
 const resource_1 = require("../../core/resource.js");
 const MessagesAPI = tslib_1.__importStar(require("./messages.js"));
 const messages_1 = require("./messages.js");
-const headers_1 = require("../../internal/headers.js");
 const path_1 = require("../../internal/utils/path.js");
 class Numbers extends resource_1.APIResource {
     constructor() {
@@ -14,25 +13,16 @@ class Numbers extends resource_1.APIResource {
         this.messages = new MessagesAPI.Messages(this._client);
     }
     /**
-     * Starts a Mobilerun Phone purchase for the authenticated owner. Accepted requests
-     * always return the same asynchronous envelope; poll GET /numbers/phones/{id} for
-     * its business state. `purpose` and `country` are mutually exclusive.
+     * Starts a phone-number purchase. Poll the returned phone number for status
+     * updates. `purpose` and `country` cannot be combined.
      *
      * @example
      * ```ts
      * const number = await client.numbers.create();
      * ```
      */
-    create(params = {}, options) {
-        const { 'Idempotency-Key': idempotencyKey, ...body } = params ?? {};
-        return this._client.post('/numbers/phones', {
-            body,
-            ...options,
-            headers: (0, headers_1.buildHeaders)([
-                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
-                options?.headers,
-            ]),
-        });
+    create(body = {}, options) {
+        return this._client.post('/numbers/phones', { body, ...options });
     }
     /**
      * Retrieves a single phone number.
@@ -48,11 +38,8 @@ class Numbers extends resource_1.APIResource {
         return this._client.get((0, path_1.path) `/numbers/phones/${id}`, options);
     }
     /**
-     * Updates the phone number's user-defined display label. Omitting `label` leaves
-     * it unchanged; setting it to null or an empty string clears it. The label is
-     * capped at 100 characters, is display-only, and never affects routing. It also
-     * seeds the billing entity name when set at purchase time; a later change here
-     * does not rename the already-created billing entity.
+     * Updates the display label. Omitting `label` leaves it unchanged; null or an
+     * empty string clears it.
      *
      * @example
      * ```ts
@@ -65,8 +52,7 @@ class Numbers extends resource_1.APIResource {
         return this._client.patch((0, path_1.path) `/numbers/phones/${id}`, { body, ...options });
     }
     /**
-     * Lists phone numbers owned by the authenticated user — both BYO (`user`) and
-     * provisioned (`mobilerun`) numbers.
+     * Lists the caller's phone numbers.
      *
      * @example
      * ```ts
@@ -77,23 +63,9 @@ class Numbers extends resource_1.APIResource {
         return this._client.get('/numbers/phones', { query, ...options });
     }
     /**
-     * Cancels a Mobilerun Phone. The outcome depends on the number's current state:
-     *
-     * - If the number is still awaiting payment and no payment for it is currently
-     *   being processed, the checkout is closed immediately and the number is retired.
-     * - If the number is on the standard paid plan and already paid and in service,
-     *   cancellation is scheduled for the end of the current billing period rather
-     *   than taking effect immediately. The number stays usable through the period
-     *   already paid for, with no partial refund. Calling this again while a
-     *   cancellation is already scheduled is a no-op that returns the same result. The
-     *   response's `state` reflects this as `cancel_scheduled` with
-     *   `cancelAtPeriodEnd: true`; `currentPeriodEnd` is populated once billing
-     *   confirms the cancellation.
-     *
-     * Any other state (already refunding, a permanent billing failure, a payment
-     * currently being processed, an included-plan number, or a non-hosted/BYO number)
-     * returns 409 `not_cancellable`. Returns 404 if the number doesn't exist or isn't
-     * owned by the caller.
+     * Cancels a pending purchase or schedules cancellation of an active paid phone
+     * number. Repeating a scheduled cancellation is safe. Returns 409 when
+     * cancellation is not available.
      *
      * @example
      * ```ts
@@ -106,8 +78,21 @@ class Numbers extends resource_1.APIResource {
         return this._client.delete((0, path_1.path) `/numbers/phones/${id}`, options);
     }
     /**
-     * Lists the countries currently offered for a dedicated Mobilerun Phone, with live
-     * stock status. Pass `country` as the `country` field on POST /numbers/phones.
+     * Returns included phone capacity for a country. Creating a phone is
+     * authoritative.
+     *
+     * @example
+     * ```ts
+     * const response = await client.numbers.capacity({
+     *   country: 'de',
+     * });
+     * ```
+     */
+    capacity(query, options) {
+        return this._client.get('/numbers/phones/capacity', { query, ...options });
+    }
+    /**
+     * Lists available countries and current phone-number availability.
      *
      * @example
      * ```ts

package/resources/numbers/numbers.js.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../src/resources/numbers/numbers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,mEAA0C;AAC1C,4CAA8E;AAE9E,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAqI1E,CAAC;IAnIC;;;;;;;;;OASG;IACH,MAAM,CACJ,SAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC1C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CACJ,EAAU,EACV,OAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CACF,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,OAAwB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAwB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;CACF;AAtID,0BAsIC;AAwPD,OAAO,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}
+{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../src/resources/numbers/numbers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,mEAA0C;AAC1C,4CAMoB;AAGpB,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAwH1E,CAAC;IAtHC;;;;;;;;OAQG;IACH,MAAM,CACJ,OAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,EAAU,EACV,OAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAA2B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,OAAwB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAwB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;CACF;AAzHD,0BAyHC;AA0YD,OAAO,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}

package/resources/numbers/numbers.mjs

@@ -1,8 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../core/resource.mjs";
 import * as MessagesAPI from "./messages.mjs";
-import { Messages } from "./messages.mjs";
-import { buildHeaders } from "../../internal/headers.mjs";
+import { Messages, } from "./messages.mjs";
 import { path } from "../../internal/utils/path.mjs";
 export class Numbers extends APIResource {
     constructor() {
@@ -10,25 +9,16 @@ export class Numbers extends APIResource {
         this.messages = new MessagesAPI.Messages(this._client);
     }
     /**
-     * Starts a Mobilerun Phone purchase for the authenticated owner. Accepted requests
-     * always return the same asynchronous envelope; poll GET /numbers/phones/{id} for
-     * its business state. `purpose` and `country` are mutually exclusive.
+     * Starts a phone-number purchase. Poll the returned phone number for status
+     * updates. `purpose` and `country` cannot be combined.
      *
      * @example
      * ```ts
      * const number = await client.numbers.create();
      * ```
      */
-    create(params = {}, options) {
-        const { 'Idempotency-Key': idempotencyKey, ...body } = params ?? {};
-        return this._client.post('/numbers/phones', {
-            body,
-            ...options,
-            headers: buildHeaders([
-                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
-                options?.headers,
-            ]),
-        });
+    create(body = {}, options) {
+        return this._client.post('/numbers/phones', { body, ...options });
     }
     /**
      * Retrieves a single phone number.
@@ -44,11 +34,8 @@ export class Numbers extends APIResource {
         return this._client.get(path `/numbers/phones/${id}`, options);
     }
     /**
-     * Updates the phone number's user-defined display label. Omitting `label` leaves
-     * it unchanged; setting it to null or an empty string clears it. The label is
-     * capped at 100 characters, is display-only, and never affects routing. It also
-     * seeds the billing entity name when set at purchase time; a later change here
-     * does not rename the already-created billing entity.
+     * Updates the display label. Omitting `label` leaves it unchanged; null or an
+     * empty string clears it.
      *
      * @example
      * ```ts
@@ -61,8 +48,7 @@ export class Numbers extends APIResource {
         return this._client.patch(path `/numbers/phones/${id}`, { body, ...options });
     }
     /**
-     * Lists phone numbers owned by the authenticated user — both BYO (`user`) and
-     * provisioned (`mobilerun`) numbers.
+     * Lists the caller's phone numbers.
      *
      * @example
      * ```ts
@@ -73,23 +59,9 @@ export class Numbers extends APIResource {
         return this._client.get('/numbers/phones', { query, ...options });
     }
     /**
-     * Cancels a Mobilerun Phone. The outcome depends on the number's current state:
-     *
-     * - If the number is still awaiting payment and no payment for it is currently
-     *   being processed, the checkout is closed immediately and the number is retired.
-     * - If the number is on the standard paid plan and already paid and in service,
-     *   cancellation is scheduled for the end of the current billing period rather
-     *   than taking effect immediately. The number stays usable through the period
-     *   already paid for, with no partial refund. Calling this again while a
-     *   cancellation is already scheduled is a no-op that returns the same result. The
-     *   response's `state` reflects this as `cancel_scheduled` with
-     *   `cancelAtPeriodEnd: true`; `currentPeriodEnd` is populated once billing
-     *   confirms the cancellation.
-     *
-     * Any other state (already refunding, a permanent billing failure, a payment
-     * currently being processed, an included-plan number, or a non-hosted/BYO number)
-     * returns 409 `not_cancellable`. Returns 404 if the number doesn't exist or isn't
-     * owned by the caller.
+     * Cancels a pending purchase or schedules cancellation of an active paid phone
+     * number. Repeating a scheduled cancellation is safe. Returns 409 when
+     * cancellation is not available.
      *
      * @example
      * ```ts
@@ -102,8 +74,21 @@ export class Numbers extends APIResource {
         return this._client.delete(path `/numbers/phones/${id}`, options);
     }
     /**
-     * Lists the countries currently offered for a dedicated Mobilerun Phone, with live
-     * stock status. Pass `country` as the `country` field on POST /numbers/phones.
+     * Returns included phone capacity for a country. Creating a phone is
+     * authoritative.
+     *
+     * @example
+     * ```ts
+     * const response = await client.numbers.capacity({
+     *   country: 'de',
+     * });
+     * ```
+     */
+    capacity(query, options) {
+        return this._client.get('/numbers/phones/capacity', { query, ...options });
+    }
+    /**
+     * Lists available countries and current phone-number availability.
      *
      * @example
      * ```ts

package/resources/numbers/numbers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.mjs","sourceRoot":"","sources":["../../src/resources/numbers/numbers.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAA0C,QAAQ,EAAE,uBAAmB;AAE9E,OAAO,EAAE,YAAY,EAAE,mCAA+B;AAEtD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAqI1E,CAAC;IAnIC;;;;;;;;;OASG;IACH,MAAM,CACJ,SAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC1C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CACJ,EAAU,EACV,OAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,mBAAmB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CACF,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,OAAwB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAwB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;CACF;AAwPD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"numbers.mjs","sourceRoot":"","sources":["../../src/resources/numbers/numbers.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAKL,QAAQ,GACT,uBAAmB;AAGpB,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAwH1E,CAAC;IAtHC;;;;;;;;OAQG;IACH,MAAM,CACJ,OAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,EAAU,EACV,OAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,mBAAmB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAA2B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,OAAwB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAwB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;CACF;AA0YD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC"}