@oxygen-agent/cli 1.1014.779 → 1.1014.913

package/node_modules/@oxygen/shared/dist/voice-countries.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Where OXYGEN sells phone numbers, and on what terms.
+ *
+ * One catalog, read by the buy dialog, the numbers route and the verification
+ * route, so a country cannot be buyable on one surface and locked on another.
+ *
+ * Three kinds of country:
+ *
+ *   instant       the carrier releases a number with no paperwork (US, CA).
+ *   verification  the carrier sells local numbers only after a regulatory
+ *                 bundle — the customer's business details, address and usually
+ *                 one register extract — is approved by a human at Twilio
+ *                 (about three business days). Locked, never hidden, until then.
+ *   unavailable   the carrier sells no local numbers here on our account, so no
+ *                 amount of paperwork unlocks it. Shown with the reason.
+ *
+ * Every row was checked against the live Twilio API on 2026-10-15
+ * (Regulations and AvailablePhoneNumbers, business end user, local numbers):
+ *
+ * - GB needs a business address and NO document; DE, AT, CH and FR need a
+ *   commercial register extract (AT also an ID of the authorized
+ *   representative) plus a local address. DE and AT addresses must lie inside
+ *   the number's own dialing area: a Berlin 030 number needs a Berlin address.
+ * - NL, ES and IT publish regulations, but AvailablePhoneNumbers returns 404 for
+ *   their Local inventory (IT and NL sell mobile only, ES nothing at all).
+ * - PL sells no local or mobile numbers (404); a second carrier is undecided.
+ *
+ * Inventory changes. Re-run those reads before moving a country between kinds,
+ * and refresh the regulation fixtures in packages/integrations at the same time.
+ */
+export type VoiceCountryAccess = "instant" | "verification" | "unavailable";
+/**
+ * Where the registered address has to be. `number_area` is the German and
+ * Austrian rule: inside the dialing area of the number being bought.
+ */
+export type VoiceAddressRule = "in_country" | "number_area";
+export type VoiceCountry = {
+    iso: string;
+    name: string;
+    /** International dialing code without the plus, e.g. "49". */
+    dialCode: string;
+    access: VoiceCountryAccess;
+    /** Verification countries only. */
+    addressRule?: VoiceAddressRule;
+    /** Unavailable countries only: one sentence a customer can act on. */
+    unavailableReason?: string;
+};
+/** Twilio regulations differ by number type and end user; the dialer sells local business numbers. */
+export declare const VOICE_NUMBER_TYPE = "local";
+export declare const VOICE_END_USER_TYPE = "business";
+export declare const VOICE_COUNTRIES: readonly VoiceCountry[];
+export declare function voiceCountry(iso: string | null | undefined): VoiceCountry | null;
+export declare function voiceCountriesWithAccess(access: VoiceCountryAccess): VoiceCountry[];
+/**
+ * The AvailablePhoneNumbers `Contains` pattern for an area code outside the
+ * NANP, or null when the country searches by `AreaCode` (US/CA) or no area code
+ * was given. Twilio's `AreaCode` filter only works for NANP numbers; elsewhere a
+ * leading `+<country><area>` pattern pins the dialing area (verified live for
+ * DE 30/40/89/221, GB 20/161, AT 1/732, CH 44/22, FR 1-4 on 2026-10-15).
+ */
+export declare function voiceNumberSearchPattern(iso: string, areaCode: string | null | undefined): string | null;
+/** The AvailablePhoneNumbers filter an area code implies: `AreaCode` for NANP, a `Contains` pattern elsewhere. */
+export declare function voiceNumberAreaFilter(iso: string, areaCode: string | null | undefined): {
+    areaCode?: string;
+    contains?: string;
+};

package/node_modules/@oxygen/shared/dist/voice-countries.js

@@ -0,0 +1,75 @@
+/**
+ * Where OXYGEN sells phone numbers, and on what terms.
+ *
+ * One catalog, read by the buy dialog, the numbers route and the verification
+ * route, so a country cannot be buyable on one surface and locked on another.
+ *
+ * Three kinds of country:
+ *
+ *   instant       the carrier releases a number with no paperwork (US, CA).
+ *   verification  the carrier sells local numbers only after a regulatory
+ *                 bundle — the customer's business details, address and usually
+ *                 one register extract — is approved by a human at Twilio
+ *                 (about three business days). Locked, never hidden, until then.
+ *   unavailable   the carrier sells no local numbers here on our account, so no
+ *                 amount of paperwork unlocks it. Shown with the reason.
+ *
+ * Every row was checked against the live Twilio API on 2026-10-15
+ * (Regulations and AvailablePhoneNumbers, business end user, local numbers):
+ *
+ * - GB needs a business address and NO document; DE, AT, CH and FR need a
+ *   commercial register extract (AT also an ID of the authorized
+ *   representative) plus a local address. DE and AT addresses must lie inside
+ *   the number's own dialing area: a Berlin 030 number needs a Berlin address.
+ * - NL, ES and IT publish regulations, but AvailablePhoneNumbers returns 404 for
+ *   their Local inventory (IT and NL sell mobile only, ES nothing at all).
+ * - PL sells no local or mobile numbers (404); a second carrier is undecided.
+ *
+ * Inventory changes. Re-run those reads before moving a country between kinds,
+ * and refresh the regulation fixtures in packages/integrations at the same time.
+ */
+/** Twilio regulations differ by number type and end user; the dialer sells local business numbers. */
+export const VOICE_NUMBER_TYPE = "local";
+export const VOICE_END_USER_TYPE = "business";
+const NO_LOCAL_NUMBERS = "Our carrier sells no local numbers here yet.";
+export const VOICE_COUNTRIES = [
+    { iso: "US", name: "United States", dialCode: "1", access: "instant" },
+    { iso: "CA", name: "Canada", dialCode: "1", access: "instant" },
+    { iso: "GB", name: "United Kingdom", dialCode: "44", access: "verification", addressRule: "in_country" },
+    { iso: "DE", name: "Germany", dialCode: "49", access: "verification", addressRule: "number_area" },
+    { iso: "AT", name: "Austria", dialCode: "43", access: "verification", addressRule: "number_area" },
+    { iso: "CH", name: "Switzerland", dialCode: "41", access: "verification", addressRule: "in_country" },
+    { iso: "FR", name: "France", dialCode: "33", access: "verification", addressRule: "in_country" },
+    { iso: "NL", name: "Netherlands", dialCode: "31", access: "unavailable", unavailableReason: NO_LOCAL_NUMBERS },
+    { iso: "ES", name: "Spain", dialCode: "34", access: "unavailable", unavailableReason: NO_LOCAL_NUMBERS },
+    { iso: "IT", name: "Italy", dialCode: "39", access: "unavailable", unavailableReason: NO_LOCAL_NUMBERS },
+    { iso: "PL", name: "Poland", dialCode: "48", access: "unavailable", unavailableReason: NO_LOCAL_NUMBERS },
+];
+export function voiceCountry(iso) {
+    const code = (iso ?? "").trim().toUpperCase();
+    return VOICE_COUNTRIES.find((entry) => entry.iso === code) ?? null;
+}
+export function voiceCountriesWithAccess(access) {
+    return VOICE_COUNTRIES.filter((entry) => entry.access === access);
+}
+/**
+ * The AvailablePhoneNumbers `Contains` pattern for an area code outside the
+ * NANP, or null when the country searches by `AreaCode` (US/CA) or no area code
+ * was given. Twilio's `AreaCode` filter only works for NANP numbers; elsewhere a
+ * leading `+<country><area>` pattern pins the dialing area (verified live for
+ * DE 30/40/89/221, GB 20/161, AT 1/732, CH 44/22, FR 1-4 on 2026-10-15).
+ */
+export function voiceNumberSearchPattern(iso, areaCode) {
+    const country = voiceCountry(iso);
+    const digits = (areaCode ?? "").replace(/\D/g, "").replace(/^0+/, "");
+    if (!country || country.dialCode === "1" || !digits)
+        return null;
+    return `+${country.dialCode}${digits}`;
+}
+/** The AvailablePhoneNumbers filter an area code implies: `AreaCode` for NANP, a `Contains` pattern elsewhere. */
+export function voiceNumberAreaFilter(iso, areaCode) {
+    if (!areaCode)
+        return {};
+    const pattern = voiceNumberSearchPattern(iso, areaCode);
+    return pattern ? { contains: pattern } : { areaCode };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.1014.779",
+  "version": "1.1014.913",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",