@peopl-health/nexus 1.6.6 → 1.7.1

package/lib/core/NexusMessaging.js

@@ -36,6 +36,13 @@ class NexusMessaging {
       keyword: [],
       flow: []
     };
+    // Message batching
+    this.pendingResponses = new Map();
+    this.batchingConfig = {
+      enabled: config.messageBatching?.enabled ?? true,
+      baseWaitTime: config.messageBatching?.baseWaitTime ?? 15000,
+      randomVariation: config.messageBatching?.randomVariation ?? 5000
+    };
   }
 
   /**
@@ -316,7 +323,9 @@ class NexusMessaging {
       });
     }
 
-    // Determine message type and call appropriate handler
+    const chatId = messageData.from || messageData.From;
+    
+    // Handle immediate response messages (interactive, flows, etc.)
     if (messageData.interactive) {
       return await this.handleInteractive(messageData);
     } else if (messageData.media) {
@@ -328,7 +337,12 @@ class NexusMessaging {
     } else if (messageData.flow) {
       return await this.handleFlow(messageData);
     } else {
-      return await this.handleMessage(messageData);
+      // For regular messages, use batching if enabled
+      if (this.batchingConfig.enabled && chatId) {
+        return await this._handleWithBatching(messageData, chatId);
+      } else {
+        return await this.handleMessage(messageData);
+      }
     }
   }
 
@@ -548,15 +562,86 @@ class NexusMessaging {
       await this.provider.disconnect();
     }
   }
+
+  /**
+   * Handle message with batching - waits for additional messages before processing
+   */
+  async _handleWithBatching(messageData, chatId) {
+    // Clear existing timeout if there is one
+    if (this.pendingResponses.has(chatId)) {
+      clearTimeout(this.pendingResponses.get(chatId));
+      console.log(`Received additional message from ${chatId}, resetting wait timer`);
+    }
+    
+    // Calculate wait time with random variation
+    const waitTime = this.batchingConfig.baseWaitTime + 
+      Math.floor(Math.random() * this.batchingConfig.randomVariation);
+    
+    // Set new timeout
+    const timeoutId = setTimeout(async () => {
+      try {
+        this.pendingResponses.delete(chatId);
+        await this._handleBatchedMessages(chatId);
+      } catch (error) {
+        console.error(`Error handling batched messages for ${chatId}:`, error);
+      }
+    }, waitTime);
+    
+    this.pendingResponses.set(chatId, timeoutId);
+    console.log(`Waiting ${Math.round(waitTime/1000)} seconds for more messages from ${chatId}`);
+  }
+
+  /**
+   * Process all batched messages for a chat
+   */
+  async _handleBatchedMessages(chatId) {
+    try {
+      console.log(`Processing batched messages from ${chatId}`);
+      
+      const botResponse = await replyAssistant(chatId);
+      if (botResponse && this.provider) {
+        await this.sendMessage({
+          code: chatId,
+          message: botResponse
+        });
+      }
+      
+      this.events.emit('messages:batched', { chatId, response: botResponse });
+
+    } catch (error) {
+      console.error('Error in batched message handling:', error);
+    }
+  }
+
+  /**
+   * Clear pending response for a chat (useful for cleanup)
+   */
+  clearPendingResponse(chatId) {
+    if (this.pendingResponses.has(chatId)) {
+      clearTimeout(this.pendingResponses.get(chatId));
+      this.pendingResponses.delete(chatId);
+    }
+  }
+
+  /**
+   * Get batching status for a chat
+   */
+  hasPendingResponse(chatId) {
+    return this.pendingResponses.has(chatId);
+  }
 }
 
-let defaultInstance = new NexusMessaging();
+// Global instance management
+let defaultInstance = null;
 
 const setDefaultInstance = (instance) => {
   if (!instance) {
     throw new Error('setDefaultInstance requires a NexusMessaging instance');
   }
-
+  if (defaultInstance) {
+    throw new Error('setDefaultInstance called multiple times');
+  }
+  
   const isCompatible = typeof instance.sendMessage === 'function' &&
     typeof instance.sendScheduledMessage === 'function' &&
     typeof instance.processIncomingMessage === 'function';

package/lib/helpers/assistantHelper.js

@@ -185,7 +185,7 @@ async function downloadMediaAndCreateFile(code, reply) {
   return fileNames;
 }
 
-async function processMessage(code, reply, thread) {
+async function processIndividualMessage(code, reply, thread) {
   try {
     const provider = llmConfig.requireOpenAIProvider();
     const formattedMessage = formatMessage(reply);
@@ -299,5 +299,5 @@ module.exports = {
   getCurRow,
   formatMessage,
   downloadMediaAndCreateFile,
-  processMessage
+  processIndividualMessage
 };

package/lib/services/assistantService.js

@@ -30,7 +30,7 @@ const { Message, formatTimestamp } = require('../models/messageModel.js');
 const { Thread } = require('../models/threadModel.js');
 
 const { checkRunStatus, getCurRow } = require('../helpers/assistantHelper.js');
-const { processMessage, getLastMessages } = require('../helpers/assistantHelper.js');
+const { processIndividualMessage, getLastMessages } = require('../helpers/assistantHelper.js');
 const { delay } = require('../helpers/whatsappHelper.js');
 
 const configureAssistants = (config) => {
@@ -375,7 +375,7 @@ const replyAssistant = async function (code, message_ = null, thread_ = null, ru
     let patientMsg = false;
     let urls = [];
     for (const reply of patientReply) {
-      const { isNotAssistant, url } = await processMessage(code, reply, thread);
+      const { isNotAssistant, url } = await processIndividualMessage(code, reply, thread);
       console.log(`isNotAssistant ${isNotAssistant} ${url}`);
       patientMsg = patientMsg || isNotAssistant;
       if (url) urls.push({ 'url': url });

package/package.json

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