nexus-ai-pro 1.2.1 → 1.3.0

package/CHANGELOG.md

@@ -4,6 +4,16 @@ Notable changes to this project are recorded here. The format follows [Keep a Ch
 
 ## [Unreleased]
 
+### Added
+
+- SMS routing on `updatePhoneNumber`. `UpdatePhoneNumberRequest` now carries `smsUrl`, `smsMethod`,
+  `smsFallbackUrl`, and `smsFallbackMethod`, and the Twilio provider maps them to `SmsUrl`,
+  `SmsMethod`, `SmsFallbackUrl`, and `SmsFallbackMethod`. Only the voice leg could be repointed
+  before, so an application holding SMS-enabled numbers had to drop to the provider SDK to say where
+  inbound messages should be delivered.
+- `TelephonyPhoneNumber` reports the number's current `smsUrl`, `smsMethod`, `smsFallbackUrl`, and
+  `smsFallbackMethod`, so message routing can be verified the same way voice routing already is.
+
 ## [1.2.1] - 2026-08-10
 
 ### Fixed

package/dist/telephony/providers/twilio.js

@@ -158,6 +158,14 @@ export class TwilioTelephonyProvider {
             body.set('StatusCallback', request.statusCallbackUrl);
         if (request.statusCallbackMethod !== undefined)
             body.set('StatusCallbackMethod', request.statusCallbackMethod);
+        if (request.smsUrl !== undefined)
+            body.set('SmsUrl', request.smsUrl);
+        if (request.smsMethod !== undefined)
+            body.set('SmsMethod', request.smsMethod);
+        if (request.smsFallbackUrl !== undefined)
+            body.set('SmsFallbackUrl', request.smsFallbackUrl);
+        if (request.smsFallbackMethod !== undefined)
+            body.set('SmsFallbackMethod', request.smsFallbackMethod);
         if (!body.size) {
             throw new TelephonyProviderError('Twilio phone number update requires at least one field to change', 'twilio');
         }
@@ -296,6 +304,10 @@ export class TwilioTelephonyProvider {
             voiceMethod: normalizeHttpMethod(stringValue(raw.voice_method)),
             statusCallbackUrl: stringValue(raw.status_callback),
             statusCallbackMethod: normalizeHttpMethod(stringValue(raw.status_callback_method)),
+            smsUrl: stringValue(raw.sms_url),
+            smsMethod: normalizeHttpMethod(stringValue(raw.sms_method)),
+            smsFallbackUrl: stringValue(raw.sms_fallback_url),
+            smsFallbackMethod: normalizeHttpMethod(stringValue(raw.sms_fallback_method)),
             capabilities: {
                 voice: capabilities.voice === true,
                 sms: capabilities.sms === true,

package/dist/types/telephony.d.ts

@@ -139,6 +139,11 @@ export interface TelephonyPhoneNumber {
     voiceMethod?: TelephonyHttpMethod;
     statusCallbackUrl?: string;
     statusCallbackMethod?: TelephonyHttpMethod;
+    /** Where the provider currently posts inbound SMS for this number. */
+    smsUrl?: string;
+    smsMethod?: TelephonyHttpMethod;
+    smsFallbackUrl?: string;
+    smsFallbackMethod?: TelephonyHttpMethod;
     capabilities?: {
         voice?: boolean;
         sms?: boolean;
@@ -160,8 +165,20 @@ export interface UpdatePhoneNumberRequest {
     friendlyName?: string;
     voiceUrl?: string;
     voiceMethod?: TelephonyHttpMethod;
+    /**
+     * Where the provider posts call status events.
+     *
+     * This covers the voice leg only. Message delivery receipts are requested per message when
+     * sending, rather than being configured on the number.
+     */
     statusCallbackUrl?: string;
     statusCallbackMethod?: TelephonyHttpMethod;
+    /** Where the provider posts inbound SMS sent to this number. */
+    smsUrl?: string;
+    smsMethod?: TelephonyHttpMethod;
+    /** Used by the provider when {@link smsUrl} errors or times out. */
+    smsFallbackUrl?: string;
+    smsFallbackMethod?: TelephonyHttpMethod;
     signal?: AbortSignal;
 }
 export interface TelephonyWebhookValidationRequest {

package/dist-cjs/telephony/providers/twilio.js

@@ -161,6 +161,14 @@ class TwilioTelephonyProvider {
             body.set('StatusCallback', request.statusCallbackUrl);
         if (request.statusCallbackMethod !== undefined)
             body.set('StatusCallbackMethod', request.statusCallbackMethod);
+        if (request.smsUrl !== undefined)
+            body.set('SmsUrl', request.smsUrl);
+        if (request.smsMethod !== undefined)
+            body.set('SmsMethod', request.smsMethod);
+        if (request.smsFallbackUrl !== undefined)
+            body.set('SmsFallbackUrl', request.smsFallbackUrl);
+        if (request.smsFallbackMethod !== undefined)
+            body.set('SmsFallbackMethod', request.smsFallbackMethod);
         if (!body.size) {
             throw new errors_js_1.TelephonyProviderError('Twilio phone number update requires at least one field to change', 'twilio');
         }
@@ -299,6 +307,10 @@ class TwilioTelephonyProvider {
             voiceMethod: normalizeHttpMethod(stringValue(raw.voice_method)),
             statusCallbackUrl: stringValue(raw.status_callback),
             statusCallbackMethod: normalizeHttpMethod(stringValue(raw.status_callback_method)),
+            smsUrl: stringValue(raw.sms_url),
+            smsMethod: normalizeHttpMethod(stringValue(raw.sms_method)),
+            smsFallbackUrl: stringValue(raw.sms_fallback_url),
+            smsFallbackMethod: normalizeHttpMethod(stringValue(raw.sms_fallback_method)),
             capabilities: {
                 voice: capabilities.voice === true,
                 sms: capabilities.sms === true,

package/dist-cjs/types/telephony.d.ts

@@ -139,6 +139,11 @@ export interface TelephonyPhoneNumber {
     voiceMethod?: TelephonyHttpMethod;
     statusCallbackUrl?: string;
     statusCallbackMethod?: TelephonyHttpMethod;
+    /** Where the provider currently posts inbound SMS for this number. */
+    smsUrl?: string;
+    smsMethod?: TelephonyHttpMethod;
+    smsFallbackUrl?: string;
+    smsFallbackMethod?: TelephonyHttpMethod;
     capabilities?: {
         voice?: boolean;
         sms?: boolean;
@@ -160,8 +165,20 @@ export interface UpdatePhoneNumberRequest {
     friendlyName?: string;
     voiceUrl?: string;
     voiceMethod?: TelephonyHttpMethod;
+    /**
+     * Where the provider posts call status events.
+     *
+     * This covers the voice leg only. Message delivery receipts are requested per message when
+     * sending, rather than being configured on the number.
+     */
     statusCallbackUrl?: string;
     statusCallbackMethod?: TelephonyHttpMethod;
+    /** Where the provider posts inbound SMS sent to this number. */
+    smsUrl?: string;
+    smsMethod?: TelephonyHttpMethod;
+    /** Used by the provider when {@link smsUrl} errors or times out. */
+    smsFallbackUrl?: string;
+    smsFallbackMethod?: TelephonyHttpMethod;
     signal?: AbortSignal;
 }
 export interface TelephonyWebhookValidationRequest {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-ai-pro",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "A typed multi-provider AI pipeline for Node.js with routing, streaming, tools, and guardrails",
   "type": "module",
   "main": "dist-cjs/index.js",