@xuda.io/notification_module 1.1.128 → 1.1.129

package/index.mjs

@@ -1,6 +1,7 @@
 import path from 'path';
 import _ from 'lodash';
 import admin from 'firebase-admin';
+import { parsePhoneNumberFromString } from 'libphonenumber-js';
 
 console.log('Notifications Module loaded...');
 
@@ -23,6 +24,78 @@ admin.initializeApp({
 const messaging = admin.messaging();
 //////////////////////////////////////////////
 
+//////////////////// SMS (Twilio) /////////////////////
+// Best-effort HTML->plain for SMS bodies (templates are authored as HTML).
+const _strip_html = (s) =>
+  String(s || '')
+    .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+    .replace(/<[^>]+>/g, ' ')
+    .replace(/&nbsp;/gi, ' ')
+    .replace(/&amp;/gi, '&')
+    .replace(/\s+/g, ' ')
+    .trim();
+
+// Normalize a stored phone (+ its account country) to E.164 for Twilio.
+const _to_e164 = (phone, country) => {
+  if (!phone) return null;
+  const raw = String(phone).trim();
+  try {
+    const pn = parsePhoneNumberFromString(raw, (country || '').toUpperCase() || undefined);
+    if (pn && pn.isValid()) return pn.number; // E.164
+  } catch (e) { /* fall through */ }
+  const digits = raw.replace(/[^\d+]/g, '');
+  if (/^\+\d{7,15}$/.test(digits)) return digits;
+  if (/^00\d{7,15}$/.test(digits)) return '+' + digits.slice(2);
+  return null;
+};
+
+// Send an SMS via Twilio (Messaging Service). Returns
+// { sent, log_only?, sid?, status?, to?, error? }.
+// GATED: unless _conf.bounce_monitor.sms_enabled === true (or opts.force) AND the
+// twilio creds + a sender (messaging_service_sid|from) exist, it composes + LOGS
+// only and sends nothing — so we can build/test before toll-free verification is
+// approved. Never logs credential values.
+export const send_sms = async (to, body, opts = {}) => {
+  const tw = _conf.twilio || {};
+  const enabled = _conf.bounce_monitor?.sms_enabled === true || opts.force === true;
+  const to_e164 = _to_e164(to, opts.country);
+  const text = _strip_html(body).slice(0, 480);
+  if (!to_e164) {
+    console.warn(`[sms] skip: cannot normalize "${to}" (country=${opts.country || '?'})`);
+    return { sent: false, error: 'invalid_phone' };
+  }
+  const have_creds = tw.account_sid && tw.api_key_sid && tw.api_key_secret && (tw.messaging_service_sid || tw.from);
+  if (!enabled || !have_creds) {
+    console.log(`[sms log_only]${enabled ? '' : ' (disabled)'}${have_creds ? '' : ' (no creds)'} -> ${to_e164} :: ${text}`);
+    return { sent: false, log_only: true, to: to_e164 };
+  }
+  try {
+    const url = `https://api.twilio.com/2010-04-01/Accounts/${tw.account_sid}/Messages.json`;
+    const form = new URLSearchParams();
+    form.set('To', to_e164);
+    if (tw.messaging_service_sid) form.set('MessagingServiceSid', tw.messaging_service_sid);
+    else form.set('From', tw.from);
+    form.set('Body', text);
+    const auth = Buffer.from(`${tw.api_key_sid}:${tw.api_key_secret}`).toString('base64');
+    const resp = await fetch(url, {
+      method: 'POST',
+      headers: { Authorization: `Basic ${auth}`, 'Content-Type': 'application/x-www-form-urlencoded' },
+      body: form.toString(),
+    });
+    const data = await resp.json().catch(() => ({}));
+    if (!resp.ok) {
+      console.error(`[sms] Twilio ${resp.status} (code ${data?.code || '?'}):`, data?.message || data);
+      return { sent: false, error: data?.message || `http_${resp.status}`, code: data?.code, to: to_e164 };
+    }
+    console.log(`[sms] sent sid=${data.sid} to=${to_e164} status=${data.status}`);
+    return { sent: true, sid: data.sid, status: data.status, to: to_e164 };
+  } catch (err) {
+    console.error('[sms] send error:', err.message);
+    return { sent: false, error: err.message, to: to_e164 };
+  }
+};
+//////////////////////////////////////////////
+
 export const get_new_notification_count = async (req) => {
   return await db_module.get_couch_view('xuda_notification', 'new_notifications_count', {
     key: [req.uid],
@@ -61,7 +134,7 @@ export const update_notification_status = async (req) => {
 //, _ch= global[`_notification_module_ch`]
 export const submit_notification = async (req) => {
   try {
-    let { type, app_id, to_app_id, uid_arr, subject = '', body = '', delivery_method = [], display_type = 'info', ref, email, sender_uid, system, topic, params } = req;
+    let { type, app_id, to_app_id, uid_arr, subject = '', body = '', sms_body = '', delivery_method = [], display_type = 'info', ref, email, sender_uid, system, topic, params } = req;
     let obj = {};
     const { notification_categories } = await import(path.join(process.env.XUDA_HOME, 'notification_templates.mjs'));
 
@@ -89,6 +162,9 @@ export const submit_notification = async (req) => {
         if (!body) {
           body = _.template(_topic.body)(params);
         }
+        if (!sms_body && _topic.sms_body) {
+          sms_body = _.template(_topic.sms_body)(params);
+        }
       } else {
         return {
           code: -1,
@@ -237,6 +313,27 @@ export const submit_notification = async (req) => {
             }
             break;
 
+          case 'sms': {
+            if (!account_ret) {
+              account_ret = await db_module.get_couch_doc('xuda_accounts', uid).catch(() => null);
+            }
+            const ai = account_ret?.data?.account_info || {};
+            const phone = req.phone || ai.phone_number;
+            const country = req.country || ai.country;
+            const text = sms_body || _strip_html(body);
+            if (!phone) {
+              console.warn(`[sms] no phone on ${uid}; sms channel skipped`);
+              send_result[uid] = false;
+              obj.sms_status = 'no_phone';
+              break;
+            }
+            const r = await send_sms(phone, text, { country });
+            obj.sms_to = r.to;
+            obj.sms_status = r.sent ? (r.sid || 'sent') : r.log_only ? 'log_only' : r.error || 'failed';
+            if (!r.sent && !r.log_only) send_result[uid] = false;
+            break;
+          }
+
           default:
             send_result[uid] = false;
             break;

package/index_ms.mjs

@@ -17,6 +17,10 @@
 
  
 
+export const send_sms = async function (...args) {
+  return await broker.send_to_queue("send_sms", ...args);
+};
+
 export const get_new_notification_count = async function (...args) {
   return await broker.send_to_queue("get_new_notification_count", ...args);
 };

package/index_msa.mjs

@@ -17,6 +17,10 @@
 
  
 
+export const send_sms =  function (...args) {
+   broker.send_to_queue_async("send_sms", ...args);
+};
+
 export const get_new_notification_count =  function (...args) {
    broker.send_to_queue_async("get_new_notification_count", ...args);
 };

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@xuda.io/notification_module",
-  "version": "1.1.128",
+  "version": "1.1.129",
   "description": "Xuda Notification Server Module",
   "main": "index.mjs",
   "dependencies": {
     "lodash": "^4.17.21",
     "amqplib": "^0.10.9",
-    "firebase-admin": "^12.0.0"
+    "firebase-admin": "^12.0.0",
+    "libphonenumber-js": "^1.11.4"
   },
   "devDependencies": {},
   "scripts": {