@madewithremy/admin 0.1.52 → 0.1.53

package/CHANGELOG.md

@@ -4,6 +4,16 @@ What changed in `@madewithremy/admin`, newest first, each version under its own
 
 Versions before 0.1.44 aren't recorded here.
 
+## 0.1.53
+
+### Changed behavior
+
+- `remy-admin voice numbers buy` (`admin.voice.numbersBuy`) buys a number for an app that already has one: an app can hold several, one per tenant say, and app code can buy, list and release them through `createAdminClient`. The limit is the workspace's, 10 numbers across its apps unless support raised it, and a buy past it is refused with `phone_number_limit_reached` (422). `number_already_assigned` is gone, so code that branched on it should branch on `phone_number_limit_reached` instead.
+
+### Fixed
+
+- The voice ops' docs give `number_unavailable`, `telnyx_not_configured`, `order_in_progress` and `number_not_active` their real status, 412.
+
 ## 0.1.52
 
 ### New

package/dist/index.d.ts

@@ -8888,7 +8888,7 @@ interface NumbersSearchParams {
  *
  * @throws AdminApiError `missing_search_filter` (400) — neither areaCode nor
  *   locality provided; `invalid_area_code` (400) — area code is not 3 digits;
- *   `telnyx_not_configured` (422) — phone numbers are not available on this
+ *   `telnyx_not_configured` (412) — phone numbers are not available on this
  *   platform host.
  * @example
  * const { results } = await admin.voice.numbersSearch({ areaCode: '310', limit: 5 });
@@ -8906,17 +8906,21 @@ interface NumbersBuyParams {
 }
 /**
  * Buy and attach a dedicated phone number to the app ($1/month billed to the
- * workspace starting immediately — always confirm with the user before calling).
+ * workspace starting immediately — an agent acting for the user always
+ * confirms with them first).
  *
- * The number is both the outbound caller-ID for `voice.call()` and the app's
- * inbound line. A `pending` status usually activates within seconds; poll
- * `numbersList` to confirm. One number per app in v1 — release before switching.
+ * The number is an inbound line to the app's voice agent and a caller ID for
+ * `voice.call()`. An app can hold several, one per tenant say, up to its
+ * workspace's limit (10 unless support raised it), and app code can buy and
+ * release them with this client. A `pending` status usually activates within
+ * seconds; poll `numbersList` to confirm.
  *
  * @throws AdminApiError `invalid_phone_number` (400) — not a valid +1 E.164
- *   US number; `number_already_assigned` (422) — this app already has a live
- *   number; `number_unavailable` (422) — the number is no longer available;
- *   `insufficient_credits/*` (402) — the workspace can't cover it;
- *   `telnyx_not_configured` (422) — phone numbers unavailable on this host.
+ *   US number; `phone_number_limit_reached` (422) — the workspace holds as
+ *   many numbers as it may; `number_unavailable` (412) — the number is no
+ *   longer available; `insufficient_credits/*` (402) — the workspace can't
+ *   cover it; `telnyx_not_configured` (412) — phone numbers unavailable on
+ *   this host.
  * @example
  * const { number } = await admin.voice.numbersBuy({
  *   phoneNumber: '+13105551234',
@@ -8930,13 +8934,14 @@ declare function numbersBuy(ctx: AdminContext, params: NumbersBuyParams): Promis
  * Release a dedicated phone number from the app (permanent).
  *
  * The monthly rental stops immediately (no refund for the current month),
- * the carrier quarantines the number for ~15 days, and both inbound calls
- * and outbound `voice.call()` stop working until a new number is attached.
+ * the carrier quarantines the number for ~15 days, and the number stops
+ * ringing the app and can't be a `voice.call()` caller ID. The app's other
+ * numbers are unaffected.
  *
  * @param e164 The phone number in E.164 or bare 10-digit US format.
  * @throws Error `No phone number "${e164}" on this app` when not found;
  *   AdminApiError `number_not_found` (404) if the resolved id has gone stale;
- *   `order_in_progress` (422) — the purchase is still settling, try again in
+ *   `order_in_progress` (412) — the purchase is still settling, try again in
  *   a minute.
  * @example
  * await admin.voice.numbersRelease('+13105551234');
@@ -8953,7 +8958,7 @@ declare function numbersRelease(ctx: AdminContext, e164: string): Promise<VoiceN
  * @param displayName 1–15 character CNAM string, or `""` to remove the listing.
  * @throws Error `No phone number "${e164}" on this app` when not found;
  *   AdminApiError `number_not_found` (404) if the resolved id has gone stale;
- *   `number_not_active` (422) — the number must be active before setting a
+ *   `number_not_active` (412) — the number must be active before setting a
  *   display name; `invalid_display_name` (400) — value is not 1–15 letters,
  *   numbers, or spaces.
  * @example