@stacksjs/sms 0.70.87 → 0.70.90

package/dist/drivers/gupshup.d.ts

@@ -0,0 +1 @@
+

package/dist/drivers/index.js

@@ -0,0 +1,3 @@
+export * from "./twilio";
+export * from "./vonage";
+export * as nexmo from "./vonage";

package/dist/drivers/nexmo.d.ts

@@ -0,0 +1 @@
+

package/dist/drivers/plivo.d.ts

@@ -0,0 +1 @@
+

package/dist/drivers/sms77.d.ts

@@ -0,0 +1 @@
+

package/dist/drivers/sns.d.ts

@@ -0,0 +1 @@
+

package/dist/drivers/telnyx.d.ts

@@ -0,0 +1 @@
+

package/dist/drivers/termii.d.ts

@@ -0,0 +1 @@
+

package/dist/drivers/twilio.js

@@ -0,0 +1,263 @@
+const API_BASE = "https://api.twilio.com/2010-04-01", VERIFY_API_BASE = "https://verify.twilio.com/v2";
+async function fetchWithRetry(url, init, maxRetries = 3) {
+  let attempt = 0;
+  while (!0) {
+    const response = await fetch(url, init);
+    if (response.status !== 429 && response.status !== 503)
+      return response;
+    if (attempt >= maxRetries)
+      return response;
+    const retryAfter = Number(response.headers.get("retry-after")) || 2 ** attempt;
+    await new Promise((r) => setTimeout(r, Math.min(retryAfter, 30) * 1000));
+    attempt++;
+  }
+}
+
+export class TwilioDriver {
+  config;
+  verifyServiceSid;
+  constructor(config, verifyServiceSid) {
+    this.config = config;
+    this.verifyServiceSid = verifyServiceSid;
+  }
+  async send(message) {
+    const recipients = Array.isArray(message.to) ? message.to : [message.to];
+    if (recipients.length > 1)
+      return (await this.sendBulk(recipients.map((to) => ({ ...message, to }))))[0] ?? {
+        success: !1,
+        to: recipients[0] ?? "",
+        error: "No recipients supplied",
+        provider: "twilio"
+      };
+    const to = recipients[0];
+    if (!to)
+      return {
+        success: !1,
+        to: "",
+        error: "No recipient supplied",
+        provider: "twilio"
+      };
+    const from = message.from || this.config.from;
+    if (!from && !this.config.messagingServiceSid)
+      return {
+        success: !1,
+        to,
+        error: 'No "from" number or messaging service SID configured',
+        provider: "twilio"
+      };
+    try {
+      const body = new URLSearchParams;
+      body.append("To", to);
+      body.append("Body", message.body);
+      if (this.config.messagingServiceSid)
+        body.append("MessagingServiceSid", this.config.messagingServiceSid);
+      else if (from)
+        body.append("From", from);
+      if (message.statusCallback || this.config.statusCallback)
+        body.append("StatusCallback", message.statusCallback || this.config.statusCallback);
+      if (message.mediaUrls && message.mediaUrls.length > 0)
+        for (const mediaUrl of message.mediaUrls)
+          body.append("MediaUrl", mediaUrl);
+      const response = await fetchWithRetry(`${API_BASE}/Accounts/${this.config.accountSid}/Messages.json`, {
+        method: "POST",
+        headers: {
+          Authorization: `Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`,
+          "Content-Type": "application/x-www-form-urlencoded"
+        },
+        body: body.toString()
+      }), data = await response.json();
+      if (!response.ok)
+        return {
+          success: !1,
+          to,
+          error: data.message || `HTTP ${response.status}`,
+          provider: "twilio"
+        };
+      return {
+        success: !0,
+        messageId: data.sid,
+        status: mapTwilioStatus(data.status),
+        to,
+        provider: "twilio",
+        segments: data.num_segments ? Number.parseInt(data.num_segments, 10) : void 0,
+        price: data.price ? Math.abs(Number.parseFloat(data.price)) : void 0,
+        currency: data.price_unit
+      };
+    } catch (error) {
+      return {
+        success: !1,
+        to,
+        error: error instanceof Error ? error.message : "Unknown error",
+        provider: "twilio"
+      };
+    }
+  }
+  async sendBulk(messages) {
+    return Promise.all(messages.map((msg) => this.send(msg)));
+  }
+  async getStatus(messageId) {
+    const response = await fetch(`${API_BASE}/Accounts/${this.config.accountSid}/Messages/${messageId}.json`, {
+      headers: {
+        Authorization: `Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`
+      }
+    });
+    if (!response.ok)
+      throw Error(`Twilio message status API error: ${response.status}`);
+    const data = await response.json();
+    return {
+      messageId: data.sid,
+      to: data.to,
+      status: mapTwilioStatus(data.status),
+      timestamp: new Date(data.date_updated || data.date_created),
+      errorCode: data.error_code?.toString(),
+      errorMessage: data.error_message
+    };
+  }
+  async verify(phoneNumber) {
+    try {
+      const response = await fetch(`https://lookups.twilio.com/v2/PhoneNumbers/${encodeURIComponent(phoneNumber)}?Fields=line_type_intelligence`, {
+        headers: {
+          Authorization: `Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`
+        }
+      });
+      if (!response.ok)
+        return { valid: !1 };
+      const data = await response.json();
+      return {
+        valid: data.valid,
+        carrier: data.line_type_intelligence?.carrier_name,
+        type: data.line_type_intelligence?.type
+      };
+    } catch {
+      return { valid: !1 };
+    }
+  }
+  async getBalance() {
+    const response = await fetch(`${API_BASE}/Accounts/${this.config.accountSid}/Balance.json`, {
+      headers: {
+        Authorization: `Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`
+      }
+    });
+    if (!response.ok)
+      throw Error(`Twilio balance API error: ${response.status}`);
+    const data = await response.json();
+    return {
+      balance: Number.parseFloat(data.balance),
+      currency: data.currency
+    };
+  }
+  async startVerification(request) {
+    if (!this.verifyServiceSid)
+      return {
+        success: !1,
+        status: "denied",
+        error: "Verify service SID not configured"
+      };
+    try {
+      const body = new URLSearchParams;
+      body.append("To", request.to);
+      body.append("Channel", request.channel || "sms");
+      if (request.locale)
+        body.append("Locale", request.locale);
+      if (request.customMessage)
+        body.append("CustomMessage", request.customMessage);
+      const response = await fetch(`${VERIFY_API_BASE}/Services/${this.verifyServiceSid}/Verifications`, {
+        method: "POST",
+        headers: {
+          Authorization: `Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`,
+          "Content-Type": "application/x-www-form-urlencoded"
+        },
+        body: body.toString()
+      }), data = await response.json();
+      if (!response.ok)
+        return {
+          success: !1,
+          status: "denied",
+          error: data.message || `HTTP ${response.status}`
+        };
+      return {
+        success: !0,
+        verificationId: data.sid,
+        status: data.status === "pending" ? "pending" : "denied"
+      };
+    } catch (error) {
+      return {
+        success: !1,
+        status: "denied",
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  }
+  async checkVerification(request) {
+    if (!this.verifyServiceSid)
+      return {
+        success: !1,
+        status: "denied",
+        error: "Verify service SID not configured"
+      };
+    try {
+      const body = new URLSearchParams;
+      body.append("To", request.to);
+      body.append("Code", request.code);
+      const response = await fetch(`${VERIFY_API_BASE}/Services/${this.verifyServiceSid}/VerificationCheck`, {
+        method: "POST",
+        headers: {
+          Authorization: `Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`,
+          "Content-Type": "application/x-www-form-urlencoded"
+        },
+        body: body.toString()
+      }), data = await response.json();
+      if (!response.ok)
+        return {
+          success: !1,
+          status: "denied",
+          error: data.message || `HTTP ${response.status}`
+        };
+      return {
+        success: data.status === "approved",
+        verificationId: data.sid,
+        status: data.status === "approved" ? "approved" : "denied"
+      };
+    } catch (error) {
+      return {
+        success: !1,
+        status: "denied",
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  }
+  async cancelVerification(verificationId) {
+    if (!this.verifyServiceSid)
+      return !1;
+    try {
+      const body = new URLSearchParams;
+      body.append("Status", "canceled");
+      return (await fetch(`${VERIFY_API_BASE}/Services/${this.verifyServiceSid}/Verifications/${verificationId}`, {
+        method: "POST",
+        headers: {
+          Authorization: `Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`,
+          "Content-Type": "application/x-www-form-urlencoded"
+        },
+        body: body.toString()
+      })).ok;
+    } catch {
+      return !1;
+    }
+  }
+}
+function mapTwilioStatus(status) {
+  return {
+    queued: "queued",
+    sending: "sending",
+    sent: "sent",
+    delivered: "delivered",
+    undelivered: "undelivered",
+    failed: "failed",
+    canceled: "failed"
+  }[status] || "unknown";
+}
+export function createTwilioDriver(config, verifyServiceSid) {
+  return new TwilioDriver(config, verifyServiceSid);
+}
+
+export { TwilioDriver as default };

package/dist/drivers/vonage.js

@@ -0,0 +1,333 @@
+const API_BASE = "https://rest.nexmo.com", MESSAGES_API_BASE = "https://api.nexmo.com/v1/messages", _VERIFY_API_BASE = "https://api.nexmo.com/verify", VERIFY_V2_API_BASE = "https://api.nexmo.com/v2/verify";
+
+export class VonageDriver {
+  config;
+  useMessagesApi;
+  constructor(config, useMessagesApi = !1) {
+    this.config = config;
+    this.useMessagesApi = useMessagesApi;
+  }
+  async send(message) {
+    const recipients = Array.isArray(message.to) ? message.to : [message.to];
+    if (recipients.length > 1)
+      return (await this.sendBulk(recipients.map((to) => ({ ...message, to }))))[0] ?? {
+        success: !1,
+        to: recipients[0] ?? "",
+        error: "No recipients supplied",
+        provider: "vonage"
+      };
+    const to = recipients[0];
+    if (!to)
+      return {
+        success: !1,
+        to: "",
+        error: "No recipient supplied",
+        provider: "vonage"
+      };
+    const from = message.from || this.config.from;
+    if (!from)
+      return {
+        success: !1,
+        to,
+        error: 'No "from" number configured',
+        provider: "vonage"
+      };
+    if (!/^\+?[1-9]\d{1,14}$/.test(to))
+      return {
+        success: !1,
+        to,
+        error: `Invalid E.164 phone number: ${to}. Expected +<country><number> with 8\u201315 digits.`,
+        provider: "vonage"
+      };
+    try {
+      if (this.useMessagesApi)
+        return await this.sendWithMessagesApi(to, from, message);
+      return await this.sendWithSmsApi(to, from, message);
+    } catch (error) {
+      return {
+        success: !1,
+        to,
+        error: error instanceof Error ? error.message : "Unknown error",
+        provider: "vonage"
+      };
+    }
+  }
+  async sendWithSmsApi(to, from, message) {
+    const body = new URLSearchParams;
+    body.append("api_key", this.config.apiKey);
+    body.append("api_secret", this.config.apiSecret);
+    body.append("to", to);
+    body.append("from", from);
+    body.append("text", message.body);
+    if (message.statusCallback)
+      body.append("callback", message.statusCallback);
+    const response = await fetch(`${API_BASE}/sms/json`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded"
+      },
+      body: body.toString()
+    });
+    if (!response.ok)
+      throw Error(`Vonage SMS API error: ${response.status}`);
+    const data = await response.json(), [msg] = data.messages ?? [];
+    if (msg) {
+      if (msg.status !== "0")
+        return {
+          success: !1,
+          to,
+          error: msg["error-text"] || `Status: ${msg.status}`,
+          provider: "vonage"
+        };
+      return {
+        success: !0,
+        messageId: msg["message-id"],
+        status: "sent",
+        to,
+        provider: "vonage",
+        price: msg["message-price"] ? Number.parseFloat(msg["message-price"]) : void 0,
+        currency: "EUR"
+      };
+    }
+    return {
+      success: !1,
+      to,
+      error: "No response from Vonage",
+      provider: "vonage"
+    };
+  }
+  async sendWithMessagesApi(to, from, message) {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    let authHeader;
+    if (this.config.applicationId && this.config.privateKey)
+      authHeader = `Bearer ${await this.generateJwt()}`;
+    else
+      authHeader = `Basic ${btoa(`${this.config.apiKey}:${this.config.apiSecret}`)}`;
+    headers.Authorization = authHeader;
+    const body = {
+      message_type: "text",
+      channel: "sms",
+      to,
+      from,
+      text: message.body
+    };
+    if (message.statusCallback)
+      body.webhook_url = message.statusCallback;
+    const response = await fetch(MESSAGES_API_BASE, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body)
+    }), data = await response.json();
+    if (!response.ok)
+      return {
+        success: !1,
+        to,
+        error: data.title || data.detail || `HTTP ${response.status}`,
+        provider: "vonage"
+      };
+    return {
+      success: !0,
+      messageId: data.message_uuid,
+      status: "sent",
+      to,
+      provider: "vonage"
+    };
+  }
+  async sendBulk(messages) {
+    return Promise.all(messages.map((msg) => this.send(msg)));
+  }
+  async getStatus(messageId) {
+    const headers = {};
+    if (this.config.applicationId && this.config.privateKey) {
+      const jwt = await this.generateJwt();
+      headers.Authorization = `Bearer ${jwt}`;
+    } else
+      headers.Authorization = `Basic ${btoa(`${this.config.apiKey}:${this.config.apiSecret}`)}`;
+    const response = await fetch(`${MESSAGES_API_BASE}/${messageId}`, {
+      headers
+    });
+    if (!response.ok)
+      throw Error(`Vonage message status API error: ${response.status}`);
+    const data = await response.json();
+    return {
+      messageId: data.message_uuid,
+      to: data.to,
+      status: mapVonageStatus(data.status),
+      timestamp: new Date(data.timestamp),
+      errorCode: data.error?.code?.toString(),
+      errorMessage: data.error?.reason
+    };
+  }
+  async verify(phoneNumber) {
+    try {
+      const body = new URLSearchParams;
+      body.append("api_key", this.config.apiKey);
+      body.append("api_secret", this.config.apiSecret);
+      body.append("number", phoneNumber);
+      const response = await fetch(`${API_BASE}/ni/basic/json`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/x-www-form-urlencoded"
+        },
+        body: body.toString()
+      });
+      if (!response.ok)
+        throw Error(`Vonage number insight API error: ${response.status}`);
+      const data = await response.json();
+      if (data.status !== 0)
+        return { valid: !1 };
+      return {
+        valid: !0,
+        carrier: data.current_carrier?.name,
+        type: data.current_carrier?.network_type
+      };
+    } catch {
+      return { valid: !1 };
+    }
+  }
+  async getBalance() {
+    const auth = typeof Buffer < "u" ? Buffer.from(`${this.config.apiKey}:${this.config.apiSecret}`).toString("base64") : btoa(`${this.config.apiKey}:${this.config.apiSecret}`), response = await fetch(`${API_BASE}/account/get-balance`, {
+      headers: { Authorization: `Basic ${auth}` }
+    });
+    if (!response.ok)
+      throw Error(`Vonage balance API error: ${response.status}`);
+    return {
+      balance: (await response.json()).value,
+      currency: "EUR"
+    };
+  }
+  async startVerification(request) {
+    try {
+      const headers = {
+        "Content-Type": "application/json"
+      };
+      if (this.config.applicationId && this.config.privateKey) {
+        const jwt = await this.generateJwt();
+        headers.Authorization = `Bearer ${jwt}`;
+      } else
+        headers.Authorization = `Basic ${btoa(`${this.config.apiKey}:${this.config.apiSecret}`)}`;
+      const body = {
+        brand: this.config.from || "Verification",
+        workflow: [
+          {
+            channel: request.channel === "whatsapp" ? "whatsapp_interactive" : "sms",
+            to: request.to
+          }
+        ]
+      };
+      if (request.codeLength)
+        body.code_length = request.codeLength;
+      if (request.locale)
+        body.locale = request.locale;
+      const response = await fetch(VERIFY_V2_API_BASE, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body)
+      }), data = await response.json();
+      if (!response.ok)
+        return {
+          success: !1,
+          status: "denied",
+          error: data.title || data.detail || `HTTP ${response.status}`
+        };
+      return {
+        success: !0,
+        verificationId: data.request_id,
+        status: "pending"
+      };
+    } catch (error) {
+      return {
+        success: !1,
+        status: "denied",
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  }
+  async checkVerification(request) {
+    if (!request.verificationId)
+      return {
+        success: !1,
+        status: "denied",
+        error: "Verification ID is required"
+      };
+    try {
+      const headers = {
+        "Content-Type": "application/json"
+      };
+      if (this.config.applicationId && this.config.privateKey) {
+        const jwt = await this.generateJwt();
+        headers.Authorization = `Bearer ${jwt}`;
+      } else
+        headers.Authorization = `Basic ${btoa(`${this.config.apiKey}:${this.config.apiSecret}`)}`;
+      const response = await fetch(`${VERIFY_V2_API_BASE}/${request.verificationId}`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ code: request.code })
+      }), data = await response.json();
+      if (!response.ok)
+        return {
+          success: !1,
+          status: "denied",
+          error: data.title || data.detail || `HTTP ${response.status}`
+        };
+      return {
+        success: data.status === "completed",
+        verificationId: request.verificationId,
+        status: data.status === "completed" ? "approved" : "denied"
+      };
+    } catch (error) {
+      return {
+        success: !1,
+        status: "denied",
+        error: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  }
+  async cancelVerification(verificationId) {
+    try {
+      const headers = {};
+      if (this.config.applicationId && this.config.privateKey) {
+        const jwt = await this.generateJwt();
+        headers.Authorization = `Bearer ${jwt}`;
+      } else
+        headers.Authorization = `Basic ${btoa(`${this.config.apiKey}:${this.config.apiSecret}`)}`;
+      return (await fetch(`${VERIFY_V2_API_BASE}/${verificationId}`, {
+        method: "DELETE",
+        headers
+      })).ok;
+    } catch {
+      return !1;
+    }
+  }
+  async generateJwt() {
+    if (!this.config.applicationId || !this.config.privateKey)
+      throw Error("Application ID and private key required for JWT auth");
+    const header = {
+      typ: "JWT",
+      alg: "RS256"
+    }, now = Math.floor(Date.now() / 1000), payload = {
+      application_id: this.config.applicationId,
+      iat: now,
+      exp: now + 900,
+      jti: crypto.randomUUID()
+    }, encodedHeader = btoa(JSON.stringify(header)), encodedPayload = btoa(JSON.stringify(payload));
+    return `${encodedHeader}.${encodedPayload}.signature`;
+  }
+}
+function mapVonageStatus(status) {
+  return {
+    submitted: "queued",
+    delivered: "delivered",
+    expired: "undelivered",
+    failed: "failed",
+    rejected: "failed",
+    accepted: "sent"
+  }[status] || "unknown";
+}
+export function createVonageDriver(config, useMessagesApi = !1) {
+  return new VonageDriver(config, useMessagesApi);
+}
+
+export { VonageDriver as default };

package/dist/index.js

@@ -1,2 +1,5 @@
-// @bun
-var I=Object.defineProperty;var V=(x)=>x;function w(x,M){this[x]=V.bind(null,M)}var k=(x,M)=>{for(var G in M)I(x,G,{get:M[G],enumerable:!0,configurable:!0,set:w.bind(M,G)})};var N=(x,M)=>()=>(x&&(M=x(x=0)),M);var U={};k(U,{default:()=>C});import{env as Z}from"@stacksjs/env";var C;var _=N(()=>{C={enabled:!1,provider:"twilio",from:String(Z.SMS_FROM_NUMBER||""),defaultCountryCode:"US",messageType:"TRANSACTIONAL",drivers:{twilio:{accountSid:String(Z.TWILIO_ACCOUNT_SID||""),authToken:String(Z.TWILIO_AUTH_TOKEN||""),from:String(Z.TWILIO_FROM_NUMBER||""),messagingServiceSid:String(Z.TWILIO_MESSAGING_SERVICE_SID||"")},vonage:{apiKey:String(Z.VONAGE_API_KEY||""),apiSecret:String(Z.VONAGE_API_SECRET||""),from:String(Z.VONAGE_FROM_NUMBER||"")},pinpoint:{region:String(Z.AWS_REGION||"us-east-1"),accessKeyId:String(Z.AWS_ACCESS_KEY_ID||""),secretAccessKey:String(Z.AWS_SECRET_ACCESS_KEY||""),senderId:String(Z.SMS_SENDER_ID||""),originationNumber:String(Z.SMS_ORIGINATION_NUMBER||"")}},maxSpendPerMonth:100,optOut:{enabled:!0,keywords:["STOP","UNSUBSCRIBE","CANCEL","END","QUIT"]},templates:[],twoWay:{enabled:!1}}});async function h(x,M,G=3){let J=0;while(!0){let L=await fetch(x,M);if(L.status!==429&&L.status!==503)return L;if(J>=G)return L;let X=Number(L.headers.get("retry-after"))||2**J;await new Promise((Q)=>setTimeout(Q,Math.min(X,30)*1000)),J++}}class E{config;verifyServiceSid;constructor(x,M){this.config=x,this.verifyServiceSid=M}async send(x){let M=Array.isArray(x.to)?x.to:[x.to];if(M.length>1)return(await this.sendBulk(M.map((X)=>({...x,to:X}))))[0]??{success:!1,to:M[0]??"",error:"No recipients supplied",provider:"twilio"};let G=M[0];if(!G)return{success:!1,to:"",error:"No recipient supplied",provider:"twilio"};let J=x.from||this.config.from;if(!J&&!this.config.messagingServiceSid)return{success:!1,to:G,error:'No "from" number or messaging service SID configured',provider:"twilio"};try{let L=new URLSearchParams;if(L.append("To",G),L.append("Body",x.body),this.config.messagingServiceSid)L.append("MessagingServiceSid",this.config.messagingServiceSid);else if(J)L.append("From",J);if(x.statusCallback||this.config.statusCallback)L.append("StatusCallback",x.statusCallback||this.config.statusCallback);if(x.mediaUrls&&x.mediaUrls.length>0)for(let z of x.mediaUrls)L.append("MediaUrl",z);let X=await h(`https://api.twilio.com/2010-04-01/Accounts/${this.config.accountSid}/Messages.json`,{method:"POST",headers:{Authorization:`Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`,"Content-Type":"application/x-www-form-urlencoded"},body:L.toString()}),Q=await X.json();if(!X.ok)return{success:!1,to:G,error:Q.message||`HTTP ${X.status}`,provider:"twilio"};return{success:!0,messageId:Q.sid,status:B(Q.status),to:G,provider:"twilio",segments:Q.num_segments?Number.parseInt(Q.num_segments,10):void 0,price:Q.price?Math.abs(Number.parseFloat(Q.price)):void 0,currency:Q.price_unit}}catch(L){return{success:!1,to:G,error:L instanceof Error?L.message:"Unknown error",provider:"twilio"}}}async sendBulk(x){return Promise.all(x.map((M)=>this.send(M)))}async getStatus(x){let M=await fetch(`https://api.twilio.com/2010-04-01/Accounts/${this.config.accountSid}/Messages/${x}.json`,{headers:{Authorization:`Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`}});if(!M.ok)throw Error(`Twilio message status API error: ${M.status}`);let G=await M.json();return{messageId:G.sid,to:G.to,status:B(G.status),timestamp:new Date(G.date_updated||G.date_created),errorCode:G.error_code?.toString(),errorMessage:G.error_message}}async verify(x){try{let M=await fetch(`https://lookups.twilio.com/v2/PhoneNumbers/${encodeURIComponent(x)}?Fields=line_type_intelligence`,{headers:{Authorization:`Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`}});if(!M.ok)return{valid:!1};let G=await M.json();return{valid:G.valid,carrier:G.line_type_intelligence?.carrier_name,type:G.line_type_intelligence?.type}}catch{return{valid:!1}}}async getBalance(){let x=await fetch(`https://api.twilio.com/2010-04-01/Accounts/${this.config.accountSid}/Balance.json`,{headers:{Authorization:`Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`}});if(!x.ok)throw Error(`Twilio balance API error: ${x.status}`);let M=await x.json();return{balance:Number.parseFloat(M.balance),currency:M.currency}}async startVerification(x){if(!this.verifyServiceSid)return{success:!1,status:"denied",error:"Verify service SID not configured"};try{let M=new URLSearchParams;if(M.append("To",x.to),M.append("Channel",x.channel||"sms"),x.locale)M.append("Locale",x.locale);if(x.customMessage)M.append("CustomMessage",x.customMessage);let G=await fetch(`https://verify.twilio.com/v2/Services/${this.verifyServiceSid}/Verifications`,{method:"POST",headers:{Authorization:`Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`,"Content-Type":"application/x-www-form-urlencoded"},body:M.toString()}),J=await G.json();if(!G.ok)return{success:!1,status:"denied",error:J.message||`HTTP ${G.status}`};return{success:!0,verificationId:J.sid,status:J.status==="pending"?"pending":"denied"}}catch(M){return{success:!1,status:"denied",error:M instanceof Error?M.message:"Unknown error"}}}async checkVerification(x){if(!this.verifyServiceSid)return{success:!1,status:"denied",error:"Verify service SID not configured"};try{let M=new URLSearchParams;M.append("To",x.to),M.append("Code",x.code);let G=await fetch(`https://verify.twilio.com/v2/Services/${this.verifyServiceSid}/VerificationCheck`,{method:"POST",headers:{Authorization:`Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`,"Content-Type":"application/x-www-form-urlencoded"},body:M.toString()}),J=await G.json();if(!G.ok)return{success:!1,status:"denied",error:J.message||`HTTP ${G.status}`};return{success:J.status==="approved",verificationId:J.sid,status:J.status==="approved"?"approved":"denied"}}catch(M){return{success:!1,status:"denied",error:M instanceof Error?M.message:"Unknown error"}}}async cancelVerification(x){if(!this.verifyServiceSid)return!1;try{let M=new URLSearchParams;return M.append("Status","canceled"),(await fetch(`https://verify.twilio.com/v2/Services/${this.verifyServiceSid}/Verifications/${x}`,{method:"POST",headers:{Authorization:`Basic ${btoa(`${this.config.accountSid}:${this.config.authToken}`)}`,"Content-Type":"application/x-www-form-urlencoded"},body:M.toString()})).ok}catch{return!1}}}function B(x){return{queued:"queued",sending:"sending",sent:"sent",delivered:"delivered",undelivered:"undelivered",failed:"failed",canceled:"failed"}[x]||"unknown"}var P={};k(P,{default:()=>K,createVonageDriver:()=>q,VonageDriver:()=>K});class K{config;useMessagesApi;constructor(x,M=!1){this.config=x,this.useMessagesApi=M}async send(x){let M=Array.isArray(x.to)?x.to:[x.to];if(M.length>1)return(await this.sendBulk(M.map((X)=>({...x,to:X}))))[0]??{success:!1,to:M[0]??"",error:"No recipients supplied",provider:"vonage"};let G=M[0];if(!G)return{success:!1,to:"",error:"No recipient supplied",provider:"vonage"};let J=x.from||this.config.from;if(!J)return{success:!1,to:G,error:'No "from" number configured',provider:"vonage"};if(!/^\+?[1-9]\d{1,14}$/.test(G))return{success:!1,to:G,error:`Invalid E.164 phone number: ${G}. Expected +<country><number> with 8\u201315 digits.`,provider:"vonage"};try{if(this.useMessagesApi)return await this.sendWithMessagesApi(G,J,x);return await this.sendWithSmsApi(G,J,x)}catch(L){return{success:!1,to:G,error:L instanceof Error?L.message:"Unknown error",provider:"vonage"}}}async sendWithSmsApi(x,M,G){let J=new URLSearchParams;if(J.append("api_key",this.config.apiKey),J.append("api_secret",this.config.apiSecret),J.append("to",x),J.append("from",M),J.append("text",G.body),G.statusCallback)J.append("callback",G.statusCallback);let L=await fetch("https://rest.nexmo.com/sms/json",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:J.toString()});if(!L.ok)throw Error(`Vonage SMS API error: ${L.status}`);let X=await L.json(),[Q]=X.messages??[];if(Q){if(Q.status!=="0")return{success:!1,to:x,error:Q["error-text"]||`Status: ${Q.status}`,provider:"vonage"};return{success:!0,messageId:Q["message-id"],status:"sent",to:x,provider:"vonage",price:Q["message-price"]?Number.parseFloat(Q["message-price"]):void 0,currency:"EUR"}}return{success:!1,to:x,error:"No response from Vonage",provider:"vonage"}}async sendWithMessagesApi(x,M,G){let J={"Content-Type":"application/json"},L;if(this.config.applicationId&&this.config.privateKey)L=`Bearer ${await this.generateJwt()}`;else L=`Basic ${btoa(`${this.config.apiKey}:${this.config.apiSecret}`)}`;J.Authorization=L;let X={message_type:"text",channel:"sms",to:x,from:M,text:G.body};if(G.statusCallback)X.webhook_url=G.statusCallback;let Q=await fetch("https://api.nexmo.com/v1/messages",{method:"POST",headers:J,body:JSON.stringify(X)}),z=await Q.json();if(!Q.ok)return{success:!1,to:x,error:z.title||z.detail||`HTTP ${Q.status}`,provider:"vonage"};return{success:!0,messageId:z.message_uuid,status:"sent",to:x,provider:"vonage"}}async sendBulk(x){return Promise.all(x.map((M)=>this.send(M)))}async getStatus(x){let M={};if(this.config.applicationId&&this.config.privateKey){let L=await this.generateJwt();M.Authorization=`Bearer ${L}`}else M.Authorization=`Basic ${btoa(`${this.config.apiKey}:${this.config.apiSecret}`)}`;let G=await fetch(`https://api.nexmo.com/v1/messages/${x}`,{headers:M});if(!G.ok)throw Error(`Vonage message status API error: ${G.status}`);let J=await G.json();return{messageId:J.message_uuid,to:J.to,status:D(J.status),timestamp:new Date(J.timestamp),errorCode:J.error?.code?.toString(),errorMessage:J.error?.reason}}async verify(x){try{let M=new URLSearchParams;M.append("api_key",this.config.apiKey),M.append("api_secret",this.config.apiSecret),M.append("number",x);let G=await fetch("https://rest.nexmo.com/ni/basic/json",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:M.toString()});if(!G.ok)throw Error(`Vonage number insight API error: ${G.status}`);let J=await G.json();if(J.status!==0)return{valid:!1};return{valid:!0,carrier:J.current_carrier?.name,type:J.current_carrier?.network_type}}catch{return{valid:!1}}}async getBalance(){let x=typeof Buffer<"u"?Buffer.from(`${this.config.apiKey}:${this.config.apiSecret}`).toString("base64"):btoa(`${this.config.apiKey}:${this.config.apiSecret}`),M=await fetch("https://rest.nexmo.com/account/get-balance",{headers:{Authorization:`Basic ${x}`}});if(!M.ok)throw Error(`Vonage balance API error: ${M.status}`);return{balance:(await M.json()).value,currency:"EUR"}}async startVerification(x){try{let M={"Content-Type":"application/json"};if(this.config.applicationId&&this.config.privateKey){let X=await this.generateJwt();M.Authorization=`Bearer ${X}`}else M.Authorization=`Basic ${btoa(`${this.config.apiKey}:${this.config.apiSecret}`)}`;let G={brand:this.config.from||"Verification",workflow:[{channel:x.channel==="whatsapp"?"whatsapp_interactive":"sms",to:x.to}]};if(x.codeLength)G.code_length=x.codeLength;if(x.locale)G.locale=x.locale;let J=await fetch("https://api.nexmo.com/v2/verify",{method:"POST",headers:M,body:JSON.stringify(G)}),L=await J.json();if(!J.ok)return{success:!1,status:"denied",error:L.title||L.detail||`HTTP ${J.status}`};return{success:!0,verificationId:L.request_id,status:"pending"}}catch(M){return{success:!1,status:"denied",error:M instanceof Error?M.message:"Unknown error"}}}async checkVerification(x){if(!x.verificationId)return{success:!1,status:"denied",error:"Verification ID is required"};try{let M={"Content-Type":"application/json"};if(this.config.applicationId&&this.config.privateKey){let L=await this.generateJwt();M.Authorization=`Bearer ${L}`}else M.Authorization=`Basic ${btoa(`${this.config.apiKey}:${this.config.apiSecret}`)}`;let G=await fetch(`https://api.nexmo.com/v2/verify/${x.verificationId}`,{method:"POST",headers:M,body:JSON.stringify({code:x.code})}),J=await G.json();if(!G.ok)return{success:!1,status:"denied",error:J.title||J.detail||`HTTP ${G.status}`};return{success:J.status==="completed",verificationId:x.verificationId,status:J.status==="completed"?"approved":"denied"}}catch(M){return{success:!1,status:"denied",error:M instanceof Error?M.message:"Unknown error"}}}async cancelVerification(x){try{let M={};if(this.config.applicationId&&this.config.privateKey){let J=await this.generateJwt();M.Authorization=`Bearer ${J}`}else M.Authorization=`Basic ${btoa(`${this.config.apiKey}:${this.config.apiSecret}`)}`;return(await fetch(`https://api.nexmo.com/v2/verify/${x}`,{method:"DELETE",headers:M})).ok}catch{return!1}}async generateJwt(){if(!this.config.applicationId||!this.config.privateKey)throw Error("Application ID and private key required for JWT auth");let x={typ:"JWT",alg:"RS256"},M=Math.floor(Date.now()/1000),G={application_id:this.config.applicationId,iat:M,exp:M+900,jti:crypto.randomUUID()},J=btoa(JSON.stringify(x)),L=btoa(JSON.stringify(G));return`${J}.${L}.signature`}}function D(x){return{submitted:"queued",delivered:"delivered",expired:"undelivered",failed:"failed",rejected:"failed",accepted:"sent"}[x]||"unknown"}function q(x,M=!1){return new K(x,M)}var O=null,W=null,Y={},H=null;async function A(){try{Y=(await Promise.resolve().then(() => (_(),U))).default}catch{}}async function $(){if(!H)H=A();await H}function m(x){Y={...Y,...x},O=null,W=null}function R(x){let M=x||Y.provider||"twilio";switch(M){case"twilio":{let G=Y.drivers?.twilio;if(!G?.accountSid||!G?.authToken)throw Error("Twilio configuration is incomplete. Please provide accountSid and authToken.");return new E({...G,from:G.from||Y.from})}case"vonage":{let G=Y.drivers?.vonage;if(!G?.apiKey||!G?.apiSecret)throw Error("Vonage configuration is incomplete. Please provide apiKey and apiSecret.");return new K({...G,from:G.from||Y.from})}default:throw Error(`Unsupported SMS provider: ${M}`)}}function y(x){let M=R(x);if(!("startVerification"in M))throw Error(`Provider does not support verification: ${x||Y.provider}`);return M}function F(){if(!O)O=R();return O}function j(){if(!W)W=y();return W}async function T(x){return await $(),F().send(x)}var g=T;async function d(x){return await $(),F().sendBulk(x)}async function n(x){await $();let M=F();if(M.getStatus)return M.getStatus(x);return null}async function i(x){await $();let M=F();if(M.verify)return M.verify(x);return{valid:!0}}async function o(){await $();let x=F();if(x.getBalance)return x.getBalance();return null}async function t(x){return await $(),j().startVerification(x)}async function a(x){return await $(),j().checkVerification(x)}async function r(x){await $();let M=j();if(M.cancelVerification)return M.cancelVerification(x);return!1}class S{message={};provider;to(x){return this.message.to=x,this}body(x){return this.message.body=x,this}text(x){return this.body(x)}from(x){return this.message.from=x,this}media(x){return this.message.mediaUrls=Array.isArray(x)?x:[x],this}callback(x){return this.message.statusCallback=x,this}via(x){return this.provider=x,this}async send(){if(await $(),!this.message.to)return{success:!1,to:"",error:"Recipient is required",provider:this.provider||Y.provider||"twilio"};if(!this.message.body)return{success:!1,to:Array.isArray(this.message.to)?this.message.to[0]??"":this.message.to,error:"Message body is required",provider:this.provider||Y.provider||"twilio"};return(this.provider?R(this.provider):F()).send(this.message)}}function s(){return new S}async function e(x,M,G={}){await $();let J=Y.templates?.find((X)=>X.name===M);if(!J)return{success:!1,to:Array.isArray(x)?x[0]??"":x,error:`Template not found: ${M}`,provider:Y.provider||"twilio"};let L=J.body;for(let[X,Q]of Object.entries(G)){let z=X.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");L=L.replace(new RegExp(`\\{${z}\\}`,"g"),Q)}return T({to:x,body:L})}function b(x,M){let G=x.replace(/[\s\-()]/g,"");if(G.startsWith("+"))return G;let J=M||Y.defaultCountryCode||"1";if(G.startsWith("00"))G=`+${G.slice(2)}`;else if(!G.startsWith("+"))G=`+${J}${G}`;return G}function xx(x){let M=/^\+[1-9]\d{6,14}$/,G=b(x);return M.test(G)}async function Mx(){await A()}function Gx(){return Y.enabled===!0}function Jx(){return{...Y}}export{i as verifyNumber,t as startVerification,s as sms,e as sendTemplate,g as sendSms,d as sendBulk,T as send,P as nexmo,xx as isValidPhoneNumber,Gx as isEnabled,Mx as init,y as getVerificationDriver,n as getStatus,R as getDriver,Jx as getConfig,o as getBalance,b as formatE164,Hx as createVonageDriver,Ex as createTwilioDriver,m as configure,a as checkVerification,r as cancelVerification,_x as VonageDriver,Wx as TwilioDriver,S as SmsBuilder,Fx as SMS};
+export * from "./sms";
+export { default as SMS } from "./sms";
+export * from "./drivers";
+export { TwilioDriver, createTwilioDriver } from "./drivers/twilio";
+export { VonageDriver, createVonageDriver } from "./drivers/vonage";

package/dist/sms.js

@@ -0,0 +1,220 @@
+import { TwilioDriver } from "./drivers/twilio";
+import { VonageDriver } from "./drivers/vonage";
+let defaultDriver = null, verificationDriver = null, smsConfig = {}, _configPromise = null;
+async function loadConfig() {
+  try {
+    smsConfig = (await import("../../../../../config/sms")).default;
+  } catch {}
+}
+async function ensureConfig() {
+  if (!_configPromise)
+    _configPromise = loadConfig();
+  await _configPromise;
+}
+export function configure(config) {
+  smsConfig = { ...smsConfig, ...config };
+  defaultDriver = null;
+  verificationDriver = null;
+}
+export function getDriver(provider) {
+  const targetProvider = provider || smsConfig.provider || "twilio";
+  switch (targetProvider) {
+    case "twilio": {
+      const twilioConfig = smsConfig.drivers?.twilio;
+      if (!twilioConfig?.accountSid || !twilioConfig?.authToken)
+        throw Error("Twilio configuration is incomplete. Please provide accountSid and authToken.");
+      return new TwilioDriver({
+        ...twilioConfig,
+        from: twilioConfig.from || smsConfig.from
+      });
+    }
+    case "vonage": {
+      const vonageConfig = smsConfig.drivers?.vonage;
+      if (!vonageConfig?.apiKey || !vonageConfig?.apiSecret)
+        throw Error("Vonage configuration is incomplete. Please provide apiKey and apiSecret.");
+      return new VonageDriver({
+        ...vonageConfig,
+        from: vonageConfig.from || smsConfig.from
+      });
+    }
+    default:
+      throw Error(`Unsupported SMS provider: ${targetProvider}`);
+  }
+}
+export function getVerificationDriver(provider) {
+  const driver = getDriver(provider);
+  if (!("startVerification" in driver))
+    throw Error(`Provider does not support verification: ${provider || smsConfig.provider}`);
+  return driver;
+}
+function getDefaultDriver() {
+  if (!defaultDriver)
+    defaultDriver = getDriver();
+  return defaultDriver;
+}
+function getDefaultVerificationDriver() {
+  if (!verificationDriver)
+    verificationDriver = getVerificationDriver();
+  return verificationDriver;
+}
+export async function send(message) {
+  await ensureConfig();
+  return getDefaultDriver().send(message);
+}
+export const sendSms = send;
+export async function sendBulk(messages) {
+  await ensureConfig();
+  return getDefaultDriver().sendBulk(messages);
+}
+export async function getStatus(messageId) {
+  await ensureConfig();
+  const driver = getDefaultDriver();
+  if (driver.getStatus)
+    return driver.getStatus(messageId);
+  return null;
+}
+export async function verifyNumber(phoneNumber) {
+  await ensureConfig();
+  const driver = getDefaultDriver();
+  if (driver.verify)
+    return driver.verify(phoneNumber);
+  return { valid: !0 };
+}
+export async function getBalance() {
+  await ensureConfig();
+  const driver = getDefaultDriver();
+  if (driver.getBalance)
+    return driver.getBalance();
+  return null;
+}
+export async function startVerification(request) {
+  await ensureConfig();
+  return getDefaultVerificationDriver().startVerification(request);
+}
+export async function checkVerification(request) {
+  await ensureConfig();
+  return getDefaultVerificationDriver().checkVerification(request);
+}
+export async function cancelVerification(verificationId) {
+  await ensureConfig();
+  const driver = getDefaultVerificationDriver();
+  if (driver.cancelVerification)
+    return driver.cancelVerification(verificationId);
+  return !1;
+}
+
+export class SmsBuilder {
+  message = {};
+  provider;
+  to(phoneNumber) {
+    this.message.to = phoneNumber;
+    return this;
+  }
+  body(text) {
+    this.message.body = text;
+    return this;
+  }
+  text(text) {
+    return this.body(text);
+  }
+  from(sender) {
+    this.message.from = sender;
+    return this;
+  }
+  media(urls) {
+    this.message.mediaUrls = Array.isArray(urls) ? urls : [urls];
+    return this;
+  }
+  callback(url) {
+    this.message.statusCallback = url;
+    return this;
+  }
+  via(provider) {
+    this.provider = provider;
+    return this;
+  }
+  async send() {
+    await ensureConfig();
+    if (!this.message.to)
+      return {
+        success: !1,
+        to: "",
+        error: "Recipient is required",
+        provider: this.provider || smsConfig.provider || "twilio"
+      };
+    if (!this.message.body)
+      return {
+        success: !1,
+        to: Array.isArray(this.message.to) ? this.message.to[0] ?? "" : this.message.to,
+        error: "Message body is required",
+        provider: this.provider || smsConfig.provider || "twilio"
+      };
+    return (this.provider ? getDriver(this.provider) : getDefaultDriver()).send(this.message);
+  }
+}
+export function sms() {
+  return new SmsBuilder;
+}
+export async function sendTemplate(to, templateName, variables = {}) {
+  await ensureConfig();
+  const template = smsConfig.templates?.find((t) => t.name === templateName);
+  if (!template)
+    return {
+      success: !1,
+      to: Array.isArray(to) ? to[0] ?? "" : to,
+      error: `Template not found: ${templateName}`,
+      provider: smsConfig.provider || "twilio"
+    };
+  let body = template.body;
+  for (const [key, value] of Object.entries(variables)) {
+    const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    body = body.replace(new RegExp(`\\{${escapedKey}\\}`, "g"), value);
+  }
+  return send({ to, body });
+}
+export function formatE164(phoneNumber, defaultCountryCode) {
+  let cleaned = phoneNumber.replace(/[\s\-()]/g, "");
+  if (cleaned.startsWith("+"))
+    return cleaned;
+  const countryCode = defaultCountryCode || smsConfig.defaultCountryCode || "1";
+  if (cleaned.startsWith("00"))
+    cleaned = `+${cleaned.slice(2)}`;
+  else if (!cleaned.startsWith("+"))
+    cleaned = `+${countryCode}${cleaned}`;
+  return cleaned;
+}
+export function isValidPhoneNumber(phoneNumber) {
+  const e164Regex = /^\+[1-9]\d{6,14}$/, formatted = formatE164(phoneNumber);
+  return e164Regex.test(formatted);
+}
+export async function init() {
+  await loadConfig();
+}
+export function isEnabled() {
+  return smsConfig.enabled === !0;
+}
+export function getConfig() {
+  return { ...smsConfig };
+}
+export const SMS = {
+  init,
+  configure,
+  isEnabled,
+  getConfig,
+  send,
+  sendSms,
+  sendBulk,
+  sendTemplate,
+  getStatus,
+  getBalance,
+  verifyNumber,
+  startVerification,
+  checkVerification,
+  cancelVerification,
+  formatE164,
+  isValidPhoneNumber,
+  sms,
+  getDriver,
+  getVerificationDriver
+};
+export default SMS;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/sms",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.87",
+  "version": "0.70.90",
   "description": "The Stacks SMS integration. Painlessly create & manage your inboxes, templates, and send sms.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,10 +58,10 @@
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
-    "@stacksjs/cli": "0.70.87",
-    "@stacksjs/config": "0.70.87",
+    "@stacksjs/cli": "0.70.90",
+    "@stacksjs/config": "0.70.90",
     "better-dx": "^0.2.16",
-    "@stacksjs/error-handling": "0.70.87",
-    "@stacksjs/types": "0.70.87"
+    "@stacksjs/error-handling": "0.70.90",
+    "@stacksjs/types": "0.70.90"
   }
 }