@peopl-health/nexus 1.6.1 → 1.6.3

package/MIGRATION_GUIDE.md

@@ -20,7 +20,7 @@ await nexus.sendMessage({ code: 'whatsapp:+521555...', message: 'Hi' });
 ```
 After (preferred):
 ```js
-await nexus.sendMessage({ to: '+521555...', message: 'Hi' });
+await nexus.sendMessage({ code: '+521555...', message: 'Hi' });
 ```
 
 ## Templates & Flows (Twilio)

package/README.md

@@ -88,10 +88,10 @@ registerFlow('greeting_qr', {
   type: 'quick-reply', language: 'es', body: 'Hola {{1}}', variables: { '1': 'Nombre' },
   buttons: [{ text: 'Sí' }, { text: 'No' }]
 });
-await sendInteractive(nexus, { to: '+521555...', id: 'greeting_qr' });
+await sendInteractive(nexus, { code: '+521555...', id: 'greeting_qr' });
 
 registerInteractiveHandler({ type: 'button', id: /sí|si/i }, async (msg, messaging) => {
-  await messaging.sendMessage({ to: msg.from, message: '¡Confirmado!' });
+  await messaging.sendMessage({ code: msg.from, message: '¡Confirmado!' });
 });
 attachInteractiveRouter(nexus);
 ```

package/examples/consumer-server.js

@@ -51,7 +51,7 @@ async function initializeNexus() {
       const response = await processTextMessage(messageData);
       if (response) {
         await nexus.sendMessage({
-          to: messageData.from,
+          code: messageData.from,
           message: response
         });
       }
@@ -64,7 +64,7 @@ async function initializeNexus() {
     switch (command) {
       case 'help':
         await nexus.sendMessage({
-          to: messageData.from,
+          code: messageData.from,
           message: `🤖 Available Commands:
 /help - Show this help
 /support - Connect to support assistant
@@ -78,7 +78,7 @@ async function initializeNexus() {
         const supportResponse = await assistants.support.handleMessage(messageData.from, 'Hello, I need support.');
         if (supportResponse) {
           await nexus.sendMessage({
-            to: messageData.from,
+            code: messageData.from,
             message: supportResponse
           });
         }
@@ -88,7 +88,7 @@ async function initializeNexus() {
         const salesResponse = await assistants.sales.handleMessage(messageData.from, 'Hello, I\'m interested in your products.');
         if (salesResponse) {
           await nexus.sendMessage({
-            to: messageData.from,
+            code: messageData.from,
             message: salesResponse
           });
         }
@@ -96,7 +96,7 @@ async function initializeNexus() {
         
       case 'status':
         await nexus.sendMessage({
-          to: messageData.from,
+          code: messageData.from,
           message: `System Status: ${nexus.isConnected() ? '✅ Connected' : '❌ Disconnected'}`
         });
         break;
@@ -106,14 +106,14 @@ async function initializeNexus() {
           await nexus.getStorage().clearThread(messageData.from);
         }
         await nexus.sendMessage({
-          to: messageData.from,
+          code: messageData.from,
           message: 'Conversation reset! You can start fresh now.'
         });
         break;
         
       default:
         await nexus.sendMessage({
-          to: messageData.from,
+          code: messageData.from,
           message: `Unknown command: /${command}. Type /help for available commands.`
         });
     }
@@ -136,10 +136,10 @@ app.post('/webhook', async (req, res) => {
 // API endpoints
 app.post('/api/send-message', async (req, res) => {
   try {
-    const { to, message, fileUrl, fileType } = req.body;
+    const { code, message, fileUrl, fileType } = req.body;
     
     const result = await nexus.sendMessage({
-      to,
+      code,
       message,
       fileUrl,
       fileType
@@ -153,10 +153,10 @@ app.post('/api/send-message', async (req, res) => {
 
 app.post('/api/send-template', async (req, res) => {
   try {
-    const { to, contentSid, variables } = req.body;
+    const { code, contentSid, variables } = req.body;
     
     const result = await nexus.sendMessage({
-      to,
+      code,
       contentSid,
       variables
     });

package/lib/adapters/BaileysProvider.js

@@ -84,9 +84,9 @@ class BaileysProvider extends MessageProvider {
       throw new Error('Baileys provider not connected');
     }
 
-    const { to, message, fileUrl, fileType, hidePreview = false } = messageData;
+    const { code, message, fileUrl, fileType, hidePreview = false } = messageData;
     
-    if (!to) {
+    if (!code) {
       throw new Error('Recipient is required');
     }
 
@@ -94,7 +94,7 @@ class BaileysProvider extends MessageProvider {
       throw new Error('Message or file URL is required');
     }
 
-    const code = this.formatCode(to);
+    const formattedCode = this.formatCode(code);
     let sendOptions = {};
     let formattedMessage = this.formatMessage(message || '');
 
@@ -135,7 +135,7 @@ class BaileysProvider extends MessageProvider {
     }
 
     try {
-      const result = await this.waSocket.sendMessage(code, sendOptions);
+      const result = await this.waSocket.sendMessage(formattedCode, sendOptions);
       return {
         success: true,
         messageId: result?.key?.id,
@@ -156,7 +156,7 @@ class BaileysProvider extends MessageProvider {
       : async (payload) => await this.sendMessage(payload);
 
     console.log('[BaileysProvider] Scheduled message created', {
-      to: scheduledMessage.to || scheduledMessage.code,
+      code: scheduledMessage.code,
       delay,
       hasMedia: Boolean(scheduledMessage.fileUrl)
     });
@@ -166,7 +166,7 @@ class BaileysProvider extends MessageProvider {
         const payload = { ...scheduledMessage };
         delete payload.__nexusSend;
         console.log('[BaileysProvider] Timer fired', {
-          to: payload.to || payload.code,
+          code: payload.to || payload.code,
           hasMessage: Boolean(payload.message || payload.body),
           hasMedia: Boolean(payload.fileUrl)
         });

package/lib/adapters/TwilioProvider.js

@@ -47,16 +47,16 @@ class TwilioProvider extends MessageProvider {
     const { code, message, fileUrl, fileType, variables, contentSid } = messageData;
 
     const formattedFrom = this.ensureWhatsAppFormat(this.whatsappNumber);
-    const formattedTo = this.ensureWhatsAppFormat(code);
+    const formattedCode = this.ensureWhatsAppFormat(code);
 
 
-    if (!formattedFrom || !formattedTo) {
+    if (!formattedFrom || !formattedCode) {
       throw new Error('Invalid sender or recipient number');
     }
 
     const messageParams = {
       from: formattedFrom,
-      to: formattedTo
+      to: formattedCode
     };
 
     // Handle template messages
@@ -83,7 +83,7 @@ class TwilioProvider extends MessageProvider {
 
     // Handle media messages
     if (fileUrl && fileType !== 'text') {
-      const mediaPrep = await this.prepareOutboundMedia(messageData, formattedTo);
+      const mediaPrep = await this.prepareOutboundMedia(messageData, formattedCode);
       const outboundMediaUrl = mediaPrep.mediaUrl || fileUrl;
       messageParams.mediaUrl = [outboundMediaUrl];
       if (!messageParams.body || messageParams.body.trim() === '') {
@@ -91,7 +91,7 @@ class TwilioProvider extends MessageProvider {
       }
       if (mediaPrep.uploaded) {
         console.log('[TwilioProvider] Outbound media uploaded to S3', {
-          to: formattedTo,
+          code: formattedCode,
           bucket: mediaPrep.bucketName,
           key: mediaPrep.key
         });
@@ -108,14 +108,14 @@ class TwilioProvider extends MessageProvider {
       if (this.messageStorage && typeof this.messageStorage.saveMessage === 'function') {
         try {
           console.log('[TwilioProvider] Persisting outbound message', {
-            to: formattedTo,
+            code: formattedCode,
             from: formattedFrom,
             hasMedia: Boolean(messageParams.mediaUrl && messageParams.mediaUrl.length),
             hasTemplate: Boolean(messageParams.contentSid)
           });
           await this.messageStorage.saveMessage({
             ...messageData,
-            to: formattedTo,
+            code: formattedCode,
             from: formattedFrom,
             messageId: result.sid,
             provider: 'twilio',
@@ -147,7 +147,7 @@ class TwilioProvider extends MessageProvider {
       : async (payload) => await this.sendMessage(payload);
 
     console.log('[TwilioProvider] Scheduled message created', {
-      to: scheduledMessage.code,
+      code: scheduledMessage.code,
       delay,
       hasContentSid: Boolean(scheduledMessage.contentSid)
     });
@@ -158,7 +158,7 @@ class TwilioProvider extends MessageProvider {
         const payload = scheduledMessage.toObject ? scheduledMessage.toObject() : { ...scheduledMessage };
         delete payload.__nexusSend;
         console.log('[TwilioProvider] Timer fired', {
-          to: payload.code,
+          code: payload.code,
           hasMessage: Boolean(payload.message || payload.body),
           hasMedia: Boolean(payload.fileUrl)
         });
@@ -176,7 +176,7 @@ class TwilioProvider extends MessageProvider {
     return true;
   }
 
-  async prepareOutboundMedia(messageData, formattedTo) {
+  async prepareOutboundMedia(messageData, formattedCode) {
     const bucketName = runtimeConfig.get('AWS_S3_BUCKET_NAME') || process.env.AWS_S3_BUCKET_NAME;
     const fileUrl = messageData.fileUrl;
 
@@ -221,7 +221,7 @@ class TwilioProvider extends MessageProvider {
 
       if (!validation.valid) {
         console.warn('[TwilioProvider] Outbound media validation warning', {
-          to: formattedTo,
+          code: formattedCode,
           message: validation.message
         });
       }
@@ -270,7 +270,7 @@ class TwilioProvider extends MessageProvider {
       };
     } catch (error) {
       console.error('[TwilioProvider] Failed to upload outbound media to S3. Using original URL.', {
-        to: formattedTo,
+        code: formattedCode,
         error: error?.message || error
       });
 
@@ -556,7 +556,7 @@ class TwilioProvider extends MessageProvider {
     const content = await this.getTemplate(contentSid);
     try {
       const links = (content && content.links) || {};
-      let approvalsUrl = links.approvals || links.approvalRequests || links.approval_requests;
+      let approvalsUrl = links.approval_create || links.approvals || links.approvalRequests || links.approval_requests;
       if (!approvalsUrl) {
         return {
           success: false,

package/lib/core/MessageProvider.js

@@ -27,7 +27,7 @@ class MessageProvider {
   /**
    * Send a message
    * @param {Object} messageData - Message data
-   * @param {string} messageData.to - Recipient
+   * @param {string} messageData.code - Recipient
    * @param {string} messageData.message - Message text
    * @param {string} messageData.fileUrl - Optional file URL
    * @param {string} messageData.fileType - File type (text, image, document, audio)

package/lib/core/NexusMessaging.js

@@ -270,13 +270,7 @@ class NexusMessaging {
       throw new Error('No provider initialized');
     }
 
-    // Backward compatibility: accept `code` as destination
-    const normalized = { ...messageData };
-    if (!normalized.to && normalized.code) {
-      normalized.to = normalized.code;
-    }
-
-    const result = await this.provider.sendMessage(normalized);
+    const result = await this.provider.sendMessage(messageData);
 
     // Store message only if provider does not handle persistence itself
     const providerStoresMessage = typeof this.provider.supportsMessageStorage === 'function'
@@ -285,7 +279,7 @@ class NexusMessaging {
 
     if (this.messageStorage && !providerStoresMessage) {
       await this.messageStorage.saveMessage({
-        ...normalized,
+        ...messageData,
         messageId: result.messageId,
         provider: result.provider,
         timestamp: new Date(),
@@ -405,7 +399,7 @@ class NexusMessaging {
 
       if (response) {
         await this.sendMessage({
-          to: from,
+          code: from,
           message: response
         });
       }
@@ -455,7 +449,7 @@ class NexusMessaging {
 
       if (response) {
         await this.sendMessage({
-          to: from,
+          code: from,
           message: response
         });
       }

package/lib/index.d.ts

@@ -6,7 +6,7 @@ declare module '@peopl-health/nexus' {
   export interface MessageData {
     id?: string;
     from: string;
-    to?: string;
+    code?: string;
     message?: string;
     fileUrl?: string;
     fileType?: 'text' | 'image' | 'document' | 'audio' | 'video';

package/lib/index.js

@@ -198,7 +198,7 @@ class Nexus {
   /**
    * Send a message
    * @param {Object} messageData - Message data
-   * @param {string} messageData.to - Recipient phone number
+   * @param {string} messageData.code - Recipient phone number
    * @param {string} messageData.message - Message text
    * @param {string} [messageData.fileUrl] - Optional file URL
    * @param {string} [messageData.fileType] - File type
@@ -216,7 +216,7 @@ class Nexus {
   /**
    * Send a scheduled message
    * @param {Object} scheduledMessage - Scheduled message data
-   * @param {string} scheduledMessage.to - Recipient phone number
+   * @param {string} scheduledMessage.code - Recipient phone number
    * @param {string} scheduledMessage.message - Message text
    * @param {Date|string} scheduledMessage.sendAt - When to send the message
    * @returns {Promise<Object>} Scheduled message result

package/lib/interactive/index.js

@@ -3,7 +3,7 @@ const { toTwilioContent } = require('./twilioMapper');
 const { registerFlow, getFlow, listFlows, registerInteractiveHandler, listInteractiveHandlers } = require('./registry');
 
 async function sendInteractive(nexusOrMessaging, params) {
-  const { to, spec, id, variables } = params || {};
+  const { code, spec, id, variables } = params || {};
   if (!nexusOrMessaging) throw new Error('sendInteractive requires a Nexus or NexusMessaging instance');
   const messaging = typeof nexusOrMessaging.getMessaging === 'function' ? nexusOrMessaging.getMessaging() : nexusOrMessaging;
   const provider = typeof messaging.getProvider === 'function' ? messaging.getProvider() : null;
@@ -14,14 +14,14 @@ async function sendInteractive(nexusOrMessaging, params) {
 
   // If user supplied a contentSid directly in spec, just send it
   if (useSpec.contentSid) {
-    return await provider.sendMessage({ to, contentSid: useSpec.contentSid, variables });
+    return await provider.sendMessage({ code, contentSid: useSpec.contentSid, variables });
   }
 
   // Twilio mapping
   if (provider.constructor && provider.constructor.name === 'TwilioProvider') {
     const content = toTwilioContent(useSpec);
     const created = await provider.createTemplate(content);
-    return await provider.sendMessage({ to, contentSid: created.sid, variables });
+    return await provider.sendMessage({ code, contentSid: created.sid, variables });
   }
 
   // Baileys or others: not supported yet

package/lib/storage/MongoStorage.js

@@ -62,7 +62,7 @@ class MongoStorage {
   async saveMessage(messageData) {
     try {
       console.log('[MongoStorage] saveMessage called', {
-        to: messageData?.to || messageData?.code || messageData?.numero,
+        code: messageData?.to || messageData?.code || messageData?.numero,
         from: messageData?.from,
         provider: messageData?.provider || 'unknown',
         hasRaw: Boolean(messageData?.raw),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peopl-health/nexus",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Core messaging and assistant library for WhatsApp communication platforms",
   "keywords": [
     "whatsapp",