@peopl-health/nexus 2.0.5 → 2.0.7

package/lib/config/interactionConfig.js

@@ -0,0 +1,3 @@
+const INTERACTION_QUALITY_VALUES = ['correct', 'correct but not helpful', 'incorrect', 'harmful'];
+
+module.exports = { INTERACTION_QUALITY_VALUES };

package/lib/controllers/interactionController.js

@@ -0,0 +1,33 @@
+const { Interaction } = require('../models/interactionModel');
+const { INTERACTION_QUALITY_VALUES } = require('../config/interactionConfig');
+
+const addInteractionController = async (req, res) => {
+  try {
+    const { messages, whatsapp_id, quality, description } = req.body;
+    if (!messages || !Array.isArray(messages) || messages.length === 0) {
+      return res.status(400).json({ success: false, error: 'Messages array is required and must not be empty' });
+    }
+    if (!whatsapp_id) return res.status(400).json({ success: false, error: 'WhatsApp ID is required' });
+    if (!quality || !INTERACTION_QUALITY_VALUES.includes(quality)) {
+      return res.status(400).json({ success: false, error: `Quality must be one of: ${INTERACTION_QUALITY_VALUES.join(', ')}` });
+    }
+    const interaction = await Interaction.create({ messages, whatsapp_id, quality, description });
+    res.status(201).json({ success: true, interaction });
+  } catch (error) {
+    console.error('Error adding interaction:', error);
+    res.status(500).json({ success: false, error: error.message });
+  }
+};
+
+const getInteractionsByWhatsappIdController = async (req, res) => {
+  try {
+    const { whatsapp_id } = req.params;
+    const interactions = await Interaction.find({ whatsapp_id }).populate('messages').sort({ createdAt: -1 });
+    res.status(200).json({ success: true, whatsappId: whatsapp_id, count: interactions.length, interactions });
+  } catch (error) {
+    console.error('Error fetching interactions:', error);
+    res.status(500).json({ success: false, error: error.message });
+  }
+};
+
+module.exports = { addInteractionController, getInteractionsByWhatsappIdController };

package/lib/controllers/messageController.js

@@ -348,10 +348,40 @@ const getLastInteractionController = async (req, res) => {
   }
 };
 
+const getMessageQualityController = async (req, res) => {
+  try {
+    const { id } = req.params;
+    const message = await Message.findById(id);
+    if (!message) return res.status(404).json({ success: false, error: 'Message not found' });
+    res.status(200).json({ success: true, messageId: id, quality: message.quality });
+  } catch (error) {
+    console.error('Error fetching message quality:', error);
+    res.status(500).json({ success: false, error: error.message });
+  }
+};
+
+const updateMessageQualityController = async (req, res) => {
+  try {
+    const { id } = req.params;
+    const { quality } = req.body;
+    if (!['low', 'medium', 'high'].includes(quality)) {
+      return res.status(400).json({ success: false, error: 'Invalid quality value. Must be low, medium, or high' });
+    }
+    const message = await Message.findByIdAndUpdate(id, { quality }, { new: true });
+    if (!message) return res.status(404).json({ success: false, error: 'Message not found' });
+    res.status(200).json({ success: true, messageId: id, quality: message.quality });
+  } catch (error) {
+    console.error('Error updating message quality:', error);
+    res.status(500).json({ success: false, error: error.message });
+  }
+};
+
 module.exports = {
   sendMessageController,
   sendBulkMessageController,
   sendBulkMessageAirtableController,
   getLastInteractionController,
+  getMessageQualityController,
+  updateMessageQualityController,
   configureMessageController
 };

package/lib/controllers/patientController.js

@@ -0,0 +1,23 @@
+const { getRecordByFilter } = require('../services/airtableService');
+const { Monitoreo_ID } = require('../config/airtableConfig');
+
+const getPatientInfoController = async (req, res) => {
+  try {
+    const { id } = req.params;
+    if (!id) return res.status(400).json({ success: false, error: 'WhatsApp ID is required' });
+
+    const records = await getRecordByFilter(Monitoreo_ID, 'estado_general', `{whatsapp_id}='${id}'`);
+    
+    if (!records || records.length === 0) {
+      return res.status(404).json({ success: false, error: 'Patient not found' });
+    }
+
+    const clinicalContext = records[0]['clinical-context-json'];
+    res.status(200).json({ success: true, whatsappId: id, clinicalContext });
+  } catch (error) {
+    console.error('Error fetching patient info:', error);
+    res.status(500).json({ success: false, error: error.message });
+  }
+};
+
+module.exports = { getPatientInfoController };

package/lib/core/NexusMessaging.js

@@ -434,7 +434,8 @@ class NexusMessaging {
         await this.sendMessage({
           code: from,
           body: response,
-          processed: true
+          processed: true,
+          origin: 'assistant'
         });
       }
     } catch (error) {
@@ -443,13 +444,8 @@ class NexusMessaging {
   }
 
   async handleInteractive(messageData) {
-    if (this.messageStorage) {
-      await this.messageStorage.saveInteractive(messageData);
-    }
-
     this.events.emit('interactive:received', messageData);
     
-    // Run interactive handler if available
     const result = await this._runPipeline('interactive', messageData, async (ctx) => {
       const handler = this.handlers.onInteractive;
       if (handler) {
@@ -502,7 +498,8 @@ class NexusMessaging {
         await this.sendMessage({
           code: from,
           body: response,
-          processed: true
+          processed: true,
+          origin: 'assistant'
         });
       }
     } catch (error) {
@@ -642,7 +639,8 @@ class NexusMessaging {
         await this.sendMessage({
           code: chatId,
           body: botResponse,
-          processed: true
+          processed: true,
+          origin: 'assistant'
         });
       }
       

package/lib/models/index.js

@@ -1,9 +1,11 @@
 const { Message, getMessageValues, formatTimestamp } = require('./messageModel');
 const { Thread } = require('./threadModel');
+const { Interaction } = require('./interactionModel');
 
 module.exports = {
   Message,
   Thread,
+  Interaction,
   getMessageValues,
   formatTimestamp
 };

package/lib/models/interactionModel.js

@@ -0,0 +1,17 @@
+const mongoose = require('mongoose');
+const { INTERACTION_QUALITY_VALUES } = require('../config/interactionConfig');
+
+const interactionSchema = new mongoose.Schema({
+  messages: [{ type: mongoose.Schema.Types.ObjectId, ref: 'Message', required: true }],
+  whatsapp_id: { type: String, required: true, index: true },
+  quality: { 
+    type: String, 
+    enum: INTERACTION_QUALITY_VALUES, 
+    required: true 
+  },
+  description: { type: String, default: null }
+}, { timestamps: true });
+
+const Interaction = mongoose.model('Interaction', interactionSchema);
+
+module.exports = { Interaction, interactionSchema };

package/lib/models/messageModel.js

@@ -1,8 +1,11 @@
 const mongoose = require('mongoose');
 const moment = require('moment-timezone');
+const { getRecordByFilter } = require('../services/airtableService');
+const { Monitoreo_ID } = require('../config/airtableConfig');
 
 
 const messageSchema = new mongoose.Schema({
+  raw: { type: Object, required: false },
   nombre_whatsapp: { type: String, required: true },
   numero: { type: String, required: true },
   body: { type: String, required: true },
@@ -11,11 +14,12 @@ const messageSchema = new mongoose.Schema({
   is_group: { type: Boolean, required: true },
   is_media: { type: Boolean, required: true },
   is_interactive: { type: Boolean, default: false },
-  interaction_type: { 
+  interactive_type: { 
     type: String, 
     enum: ['button', 'list', 'flow', 'quick_reply'], 
     default: null 
   },
+  interactive_data: { type: Object, default: null },
   group_id: { type: String, default: null },
   reply_id: { type: String, default: null },
   processed: { type: Boolean, default: false },
@@ -23,6 +27,10 @@ const messageSchema = new mongoose.Schema({
   assistant_id: { type: String, default: null },
   content_sid: { type: String, default: null },
   from_me: { type: Boolean, default: false },
+  origin: { 
+    type: String, 
+    enum: ['whatsapp', 'assistant', 'patient'], 
+    default: 'whatsapp' },
   media: {
     contentType: { type: String, default: null },
     bucketName: { type: String, default: null },
@@ -35,6 +43,12 @@ const messageSchema = new mongoose.Schema({
     thumbnail: { type: String, default: null },
     metadata: { type: Object, default: null }
   },
+  clinical_context: { type: Object, default: null },
+  quality: { 
+    type: String,
+    enum: ['low', 'medium', 'high'],
+    default: 'medium'
+  },
   memoryType: {
     type: String,
     enum: ['active', 'archived'],
@@ -58,10 +72,23 @@ messageSchema.pre('save', function (next) {
 
 const Message = mongoose.model('Message', messageSchema);
 
+async function getClinicalContext(whatsappId) {
+  try {
+    const records = await getRecordByFilter(Monitoreo_ID, 'estado_general', `{whatsapp_id}='${whatsappId}'`);
+    if (records && records.length > 0 && records[0]['clinical-context-json']) {
+      return records[0]['clinical-context-json'];
+    }
+    return null;
+  } catch (error) {
+    console.error('Error fetching clinical context from Airtable:', error);
+    return null;
+  }
+}
 
 async function insertMessage(values) {
   try {
     const skipNumbers = ['5215592261426@s.whatsapp.net', '5215547411345@s.whatsapp.net', '51985959446@s.whatsapp.net'];
+    const clinical_context = await getClinicalContext(values.numero);
     const messageData = {
       nombre_whatsapp: values.nombre_whatsapp,
       numero: values.numero,
@@ -71,13 +98,16 @@ async function insertMessage(values) {
       is_group: values.is_group,
       is_media: values.is_media,
       is_interactive: values.is_interactive || false,
-      interaction_type: values.interaction_type || null,
+      interactive_type: values.interactive_type || null,
+      interactive_data: values.interactive_data || null,
       group_id: values.group_id,
       reply_id: values.reply_id,
       from_me: values.from_me,
       processed: values.processed || skipNumbers.includes(values.numero),
       media: values.media ? values.media : null,
-      content_sid: values.content_sid || null
+      content_sid: values.content_sid || null,
+      clinical_context: clinical_context,
+      raw: values.raw || null
     };
     console.log('Inserting message', messageData);
 

package/lib/routes/index.js

@@ -32,7 +32,18 @@ const messageRouteDefinitions = {
   'POST /send': 'sendMessageController',
   'POST /send-bulk': 'sendBulkMessageController',
   'POST /send-bulk-airtable': 'sendBulkMessageAirtableController',
-  'GET /last': 'getLastInteractionController'
+  'GET /last': 'getLastInteractionController',
+  'GET /:id/quality': 'getMessageQualityController',
+  'PUT /:id/quality': 'updateMessageQualityController'
+};
+
+const interactionRouteDefinitions = {
+  'POST /': 'addInteractionController',
+  'GET /:whatsapp_id': 'getInteractionsByWhatsappIdController'
+};
+
+const patientRouteDefinitions = {
+  'GET /:id': 'getPatientInfoController'
 };
 
 const templateRouteDefinitions = {
@@ -68,8 +79,10 @@ const createRouter = (routeDefinitions, controllers) => {
 // Import built-in controllers
 const assistantController = require('../controllers/assistantController');
 const conversationController = require('../controllers/conversationController');
+const interactionController = require('../controllers/interactionController');
 const mediaController = require('../controllers/mediaController');
 const messageController = require('../controllers/messageController');
+const patientController = require('../controllers/patientController');
 const templateController = require('../controllers/templateController');
 const templateFlowController = require('../controllers/templateFlowController');
 const uploadController = require('../controllers/uploadController');
@@ -96,6 +109,10 @@ const builtInControllers = {
   sendTemplateToNewNumberController: conversationController.sendTemplateToNewNumberController,
   markMessagesAsReadController: conversationController.markMessagesAsReadController,
   
+  // Interaction controllers
+  addInteractionController: interactionController.addInteractionController,
+  getInteractionsByWhatsappIdController: interactionController.getInteractionsByWhatsappIdController,
+  
   // Media controllers
   getMediaController: mediaController.getMediaController,
   handleFileUpload: uploadController.handleFileUpload,
@@ -105,6 +122,11 @@ const builtInControllers = {
   sendBulkMessageController: messageController.sendBulkMessageController,
   sendBulkMessageAirtableController: messageController.sendBulkMessageAirtableController,
   getLastInteractionController: messageController.getLastInteractionController,
+  getMessageQualityController: messageController.getMessageQualityController,
+  updateMessageQualityController: messageController.updateMessageQualityController,
+  
+  // Patient controllers
+  getPatientInfoController: patientController.getPatientInfoController,
   
   // Template controllers
   createTemplate: templateController.createTemplate,
@@ -123,8 +145,10 @@ const builtInControllers = {
 const setupDefaultRoutes = (app) => {
   app.use('/api/assistant', createRouter(assistantRouteDefinitions, builtInControllers));
   app.use('/api/conversation', createRouter(conversationRouteDefinitions, builtInControllers));
+  app.use('/api/interaction', createRouter(interactionRouteDefinitions, builtInControllers));
   app.use('/api/media', createRouter(mediaRouteDefinitions, builtInControllers));
   app.use('/api/message', createRouter(messageRouteDefinitions, builtInControllers));
+  app.use('/api/patient', createRouter(patientRouteDefinitions, builtInControllers));
   app.use('/api/template', createRouter(templateRouteDefinitions, builtInControllers));
 };
 
@@ -132,8 +156,10 @@ module.exports = {
   // Route definitions for customers to use with their own controllers
   assistantRoutes: assistantRouteDefinitions,
   conversationRoutes: conversationRouteDefinitions,
+  interactionRoutes: interactionRouteDefinitions,
   mediaRoutes: mediaRouteDefinitions,
   messageRoutes: messageRouteDefinitions,
+  patientRoutes: patientRouteDefinitions,
   templateRoutes: templateRouteDefinitions,
   
   // Helper functions

package/lib/storage/MongoStorage.js

@@ -21,7 +21,7 @@ class MongoStorage {
     const interactionSchema = new mongoose.Schema({
       messageId: String,
       numero: String,
-      interaction_type: String, // 'button', 'list', 'flow'
+      interactive_type: String, // 'button', 'list', 'flow'
       payload: mongoose.Schema.Types.Mixed,
       timestamp: String,
       createdAt: { type: Date, default: Date.now }
@@ -202,34 +202,18 @@ class MongoStorage {
       is_group: isGroup,
       is_media: isMedia,
       is_interactive: messageData.isInteractive || false,
-      interaction_type: messageData.interactionType || null,
+      interactive_type: messageData.interactionType || null,
+      interactive_data: messageData.interactiveData || null,
       group_id: isGroup ? normalizedNumero : null,
       reply_id: messageData.reply_id || messageData.replyId || null,
       from_me: messageData.fromMe !== undefined ? messageData.fromMe : true,
       media,
       content_sid: messageData.contentSid || null,
-      template_variables: messageData.variables ? JSON.stringify(messageData.variables) : null
+      template_variables: messageData.variables ? JSON.stringify(messageData.variables) : null,
+      raw: messageData.raw || null
     };
   }
 
-  async saveInteractive(interactionData) {
-    try {
-      const interaction = new this.schemas.Interaction({
-        messageId: interactionData.messageId,
-        numero: interactionData.from,
-        interaction_type: interactionData.type, // 'button', 'list', 'flow'
-        payload: interactionData.payload,
-        timestamp: this.formatTimestamp(interactionData.timestamp)
-      });
-
-      await interaction.save();
-      return interaction;
-    } catch (error) {
-      console.error('Error saving interaction:', error);
-      throw error;
-    }
-  }
-
   async getMessages(numero, limit = 50) {
     try {
       return await this.schemas.Message

package/lib/utils/messageParser.js

@@ -33,7 +33,8 @@ class MessageParser {
         type: 'interactive',
         interactive: interactive,
         isInteractive: true,      // Flag to indicate this is an interactive message
-        interactionType: interactive.type // Store the specific interaction type
+        interactionType: interactive.type, // Store the specific interaction type
+        interactiveData: interactive
       };
     }
 

package/package.json

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