@stacksjs/sms 0.70.87 → 0.70.88

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/sms",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.87",
+  "version": "0.70.88",
   "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.88",
+    "@stacksjs/config": "0.70.88",
     "better-dx": "^0.2.16",
-    "@stacksjs/error-handling": "0.70.87",
-    "@stacksjs/types": "0.70.87"
+    "@stacksjs/error-handling": "0.70.88",
+    "@stacksjs/types": "0.70.88"
   }
 }

package/dist/drivers/index.d.ts

@@ -1,5 +0,0 @@
-// Primary SMS Drivers
-export * from './twilio';
-export * from './vonage';
-// Legacy driver aliases
-export * as nexmo from './vonage';

package/dist/drivers/twilio.d.ts

@@ -1,17 +0,0 @@
-import type { SmsDriver, SmsMessage, SmsSendResult, SmsStatusUpdate, SmsVerificationDriver, TwilioConfig, VerificationCheckRequest, VerificationRequest, VerificationResult } from '@stacksjs/types';
-// =============================================================================
-// Factory Function
-// =============================================================================
-export declare function createTwilioDriver(config: TwilioConfig, verifyServiceSid?: string): TwilioDriver;
-export declare class TwilioDriver implements SmsDriver, SmsVerificationDriver {
-  constructor(config: TwilioConfig, verifyServiceSid?: string);
-  send(message: SmsMessage): Promise<SmsSendResult>;
-  sendBulk(messages: SmsMessage[]): Promise<SmsSendResult[]>;
-  getStatus(messageId: string): Promise<SmsStatusUpdate>;
-  verify(phoneNumber: string): Promise<{ valid: boolean, carrier?: string, type?: string }>;
-  getBalance(): Promise<{ balance: number, currency: string }>;
-  startVerification(request: VerificationRequest): Promise<VerificationResult>;
-  checkVerification(request: VerificationCheckRequest): Promise<VerificationResult>;
-  cancelVerification(verificationId: string): Promise<boolean>;
-}
-export { TwilioDriver as default };

package/dist/drivers/vonage.d.ts

@@ -1,17 +0,0 @@
-import type { SmsDriver, SmsMessage, SmsSendResult, SmsStatusUpdate, SmsVerificationDriver, VerificationCheckRequest, VerificationRequest, VerificationResult, VonageConfig } from '@stacksjs/types';
-// =============================================================================
-// Factory Function
-// =============================================================================
-export declare function createVonageDriver(config: VonageConfig, useMessagesApi?: boolean): VonageDriver;
-export declare class VonageDriver implements SmsDriver, SmsVerificationDriver {
-  constructor(config: VonageConfig, useMessagesApi?: boolean);
-  send(message: SmsMessage): Promise<SmsSendResult>;
-  sendBulk(messages: SmsMessage[]): Promise<SmsSendResult[]>;
-  getStatus(messageId: string): Promise<SmsStatusUpdate>;
-  verify(phoneNumber: string): Promise<{ valid: boolean, carrier?: string, type?: string }>;
-  getBalance(): Promise<{ balance: number, currency: string }>;
-  startVerification(request: VerificationRequest): Promise<VerificationResult>;
-  checkVerification(request: VerificationCheckRequest): Promise<VerificationResult>;
-  cancelVerification(verificationId: string): Promise<boolean>;
-}
-export { VonageDriver as default };

package/dist/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * SMS Package
- *
- * Provides SMS messaging capabilities with support for multiple providers.
- */
-// Main SMS facade
-export * from './sms';
-export { default as SMS } from './sms';
-// Drivers
-export * from './drivers/index';
-export { TwilioDriver, createTwilioDriver } from './drivers/twilio';
-export { VonageDriver, createVonageDriver } from './drivers/vonage';

package/dist/index.js

@@ -1,2 +0,0 @@
-// @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};

package/dist/sms.d.ts

@@ -1,115 +0,0 @@
-import type { SmsDriver, SmsMessage, SmsOptions, SmsProvider, SmsSendResult, SmsStatusUpdate, SmsVerificationDriver, VerificationCheckRequest, VerificationRequest, VerificationResult } from '@stacksjs/types';
-/**
- * Configure the SMS system
- */
-export declare function configure(config: Partial<SmsOptions>): void;
-/**
- * Get the default SMS driver based on configuration
- */
-export declare function getDriver(provider?: SmsProvider): SmsDriver;
-/**
- * Get the verification driver
- */
-export declare function getVerificationDriver(provider?: SmsProvider): SmsVerificationDriver;
-/**
- * Send an SMS message
- */
-export declare function send(message: SmsMessage): Promise<SmsSendResult>;
-/**
- * Send multiple SMS messages
- */
-export declare function sendBulk(messages: SmsMessage[]): Promise<SmsSendResult[]>;
-/**
- * Get message status
- */
-export declare function getStatus(messageId: string): Promise<SmsStatusUpdate | null>;
-/**
- * Verify a phone number format and carrier
- */
-export declare function verifyNumber(phoneNumber: string): Promise<{ valid: boolean, carrier?: string, type?: string }>;
-/**
- * Get account balance
- */
-export declare function getBalance(): Promise<{ balance: number, currency: string } | null>;
-/**
- * Start a phone verification (send OTP)
- */
-export declare function startVerification(request: VerificationRequest): Promise<VerificationResult>;
-/**
- * Check a verification code
- */
-export declare function checkVerification(request: VerificationCheckRequest): Promise<VerificationResult>;
-/**
- * Cancel a pending verification
- */
-export declare function cancelVerification(verificationId: string): Promise<boolean>;
-/**
- * Create a new SMS builder
- */
-export declare function sms(): SmsBuilder;
-/**
- * Send an SMS using a template
- */
-export declare function sendTemplate(to: string | string[], templateName: string, variables?: Record<string, string>): Promise<SmsSendResult>;
-/**
- * Format a phone number to E.164 format
- */
-export declare function formatE164(phoneNumber: string, defaultCountryCode?: string): string;
-/**
- * Check if a phone number appears valid
- */
-export declare function isValidPhoneNumber(phoneNumber: string): boolean;
-/**
- * Initialize the SMS system (loads config)
- */
-export declare function init(): Promise<void>;
-/**
- * Check if SMS is enabled in config
- */
-export declare function isEnabled(): boolean;
-/**
- * Get the current SMS configuration
- */
-export declare function getConfig(): Partial<SmsOptions>;
-/**
- * Send an SMS message (alias)
- */
-export declare const sendSms: unknown;
-// =============================================================================
-// SMS Facade Object
-// =============================================================================
-export declare const SMS: {
-  init: typeof init;
-  configure: typeof configure;
-  isEnabled: typeof isEnabled;
-  getConfig: typeof getConfig;
-  send: typeof send;
-  sendSms: typeof sendSms;
-  sendBulk: typeof sendBulk;
-  sendTemplate: typeof sendTemplate;
-  getStatus: typeof getStatus;
-  getBalance: typeof getBalance;
-  verifyNumber: typeof verifyNumber;
-  startVerification: typeof startVerification;
-  checkVerification: typeof checkVerification;
-  cancelVerification: typeof cancelVerification;
-  formatE164: typeof formatE164;
-  isValidPhoneNumber: typeof isValidPhoneNumber;
-  sms: typeof sms;
-  getDriver: typeof getDriver;
-  getVerificationDriver: typeof getVerificationDriver
-};
-// =============================================================================
-// SMS Builder (Fluent API)
-// =============================================================================
-export declare class SmsBuilder {
-  to(phoneNumber: string | string[]): this;
-  body(text: string): this;
-  text(text: string): this;
-  from(sender: string): this;
-  media(urls: string | string[]): this;
-  callback(url: string): this;
-  via(provider: SmsProvider): this;
-  send(): Promise<SmsSendResult>;
-}
-export default SMS;