@peopl-health/nexus 3.1.0 → 3.1.1

package/lib/controllers/bugReportController.js

@@ -46,8 +46,8 @@ const reportBugController = async (req, res) => {
 
     if (!reporter) return res.status(400).json({ success: false, error: 'Reporter username is required' });
     if (!whatsapp_id) return res.status(400).json({ success: false, error: 'WhatsApp ID is required' });
-    if (!severity || !['low', 'medium', 'high'].includes(severity)) {
-      return res.status(400).json({ success: false, error: 'Severity must be low, medium, or high' });
+    if (!severity || !['low', 'medium', 'high', 'critical'].includes(severity)) {
+      return res.status(400).json({ success: false, error: 'Severity must be low, medium, high, or critical' });
     }
 
     logBugReportToAirtable(reporter, whatsapp_id, description, severity, messages).catch(err =>

package/lib/helpers/messageStatusHelper.js

@@ -1,27 +1,28 @@
 const { Message } = require('../models/messageModel');
 const { logger } = require('../utils/logger');
+const { handle24HourWindowError } = require('./templateRecoveryHelper');
 
 /**
  * Update message delivery status in the database based on Twilio status callback data
  */
 async function updateMessageStatus(messageSid, status, errorCode = null, errorMessage = null) {
   try {
-    const statusInfo = {
-      status,
-      updatedAt: new Date()
+    const updateData = {
+      'statusInfo.status': status,
+      'statusInfo.updatedAt': new Date()
     };
 
     if (errorCode) {
-      statusInfo.errorCode = errorCode;
+      updateData['statusInfo.errorCode'] = errorCode;
     }
 
     if (errorMessage) {
-      statusInfo.errorMessage = errorMessage;
+      updateData['statusInfo.errorMessage'] = errorMessage;
     }
 
     const updated = await Message.findOneAndUpdate(
       { message_id: messageSid },
-      { $set: { statusInfo } },
+      { $set: updateData },
       { new: true }
     );
 
@@ -62,12 +63,20 @@ async function handleStatusCallback(twilioStatusData) {
     return null;
   }
 
-  return await updateMessageStatus(
+  const updated = await updateMessageStatus(
     MessageSid,
     MessageStatus.toLowerCase(),
     ErrorCode || null,
     ErrorMessage || null
   );
+
+  if ((ErrorCode === 63016 || ErrorCode === '63016') && updated) {
+    handle24HourWindowError(updated, MessageSid).catch(err => 
+      logger.error('[MessageStatus] Recovery error', { messageSid: MessageSid, error: err.message })
+    );
+  }
+
+  return updated;
 }
 
 /**

package/lib/helpers/processHelper.js

@@ -147,9 +147,41 @@ const processAudioFileCore = async (fileName, provider) => {
   };
   
   try {
+    const fileExtension = fileName.split('.').pop().toLowerCase();
+    const needsConversion = fileExtension === 'ogg'; // Convert OGG for OpenAI compatibility
+    let transcriptionFile = fileName;
+    let convertedFile = null;
+    
+    if (needsConversion) {
+      logger.info('[processAudioFile] Converting OGG to MP3 for transcription', {
+        originalFile: fileName ? fileName.split('/').pop().replace(/^[^-]+-[^-]+-/, 'xxx-xxx-') : 'unknown',
+        format: fileExtension
+      });
+      
+      convertedFile = fileName.replace('.ogg', '_converted.mp3');
+      
+      try {
+        const { execSync } = require('child_process');
+        execSync(`ffmpeg -i "${fileName}" -acodec mp3 -ab 128k "${convertedFile}" -y`, { 
+          stdio: 'pipe' 
+        });
+        transcriptionFile = convertedFile;
+        
+        logger.info('[processAudioFile] Conversion successful', {
+          convertedFile: convertedFile.split('/').pop().replace(/^[^-]+-[^-]+-/, 'xxx-xxx-')
+        });
+      } catch (conversionError) {
+        logger.error('[processAudioFile] Conversion failed, attempting with original file', {
+          error: conversionError.message,
+          originalFile: fileName ? fileName.split('/').pop().replace(/^[^-]+-[^-]+-/, 'xxx-xxx-') : 'unknown'
+        });
+        transcriptionFile = fileName;
+      }
+    }
+    
     const { result: audioTranscript, duration: transcribeDuration } = await withTracing(
       async () => provider.transcribeAudio({
-        file: fs.createReadStream(fileName),
+        file: fs.createReadStream(transcriptionFile),
         responseFormat: 'text',
         language: 'es'
       }),
@@ -157,6 +189,17 @@ const processAudioFileCore = async (fileName, provider) => {
       () => ({ 'audio.file_name': fileName ? fileName.split('/').pop().replace(/^[^-]+-[^-]+-/, 'xxx-xxx-') : 'unknown' }),
       { returnTiming: true }
     )();
+    
+    if (convertedFile && fs.existsSync(convertedFile)) {
+      try {
+        fs.unlinkSync(convertedFile);
+        logger.debug('[processAudioFile] Cleaned up converted file');
+      } catch (cleanupError) {
+        logger.warn('[processAudioFile] Failed to cleanup converted file', {
+          error: cleanupError.message
+        });
+      }
+    }
     timings.transcribe_ms = transcribeDuration;
     
     const transcriptText = audioTranscript?.text || audioTranscript;

package/lib/helpers/templateRecoveryHelper.js

@@ -0,0 +1,72 @@
+const { logger } = require('../utils/logger');
+const { getDefaultInstance } = require('../core/NexusMessaging');
+const { Template, configureNexusProvider: configureTemplateProvider } = require('../templates/templateStructure');
+const { sendMessage } = require('../core/NexusMessaging');
+const { Message } = require('../models/messageModel');
+
+/**
+ * Handle 24-hour window error by creating template and sending when approved
+ */
+async function handle24HourWindowError(message, messageSid) {
+  try {
+    if (!message?.body || !message?.numero) return;
+
+    const messaging = getDefaultInstance();
+    const provider = messaging?.getProvider();
+    if (!provider?.createTemplate) return;
+
+    configureTemplateProvider(provider);
+
+    const templateName = `auto_${Date.now()}_${Math.floor(Math.random() * 1000)}`;
+    const template = new Template(templateName, 'UTILITY', 'es');
+    template.setBody(message.body, []);
+    const twilioContent = await template.save();
+
+    // Submit for approval
+    const approvalName = `${templateName}_${Date.now()}`.toLowerCase().replace(/[^a-z0-9_]/g, '_');
+    await provider.submitForApproval(twilioContent.sid, approvalName, 'UTILITY');
+
+    await Message.updateOne(
+      { message_id: messageSid },
+      { $set: { 'statusInfo.recoveryTemplateSid': twilioContent.sid } }
+    );
+
+    logger.info('[TemplateRecovery] Template created', { messageSid, templateSid: twilioContent.sid });
+
+    const checkApproval = async (attempt = 0, maxAttempts = 40) => {
+      if (attempt >= maxAttempts) {
+        logger.warn('[TemplateRecovery] Max attempts reached, template not approved yet', { messageSid, templateSid: twilioContent.sid });
+        return;
+      }
+
+      setTimeout(async () => {
+        try {
+          const status = await provider.checkApprovalStatus(twilioContent.sid);
+          const approvalStatus = status?.approvalRequest?.status?.toUpperCase();
+          
+          if (approvalStatus === 'APPROVED') {
+            await sendMessage({ code: message.numero, contentSid: twilioContent.sid, variables: {} });
+            logger.info('[TemplateRecovery] Template sent', { messageSid, templateSid: twilioContent.sid });
+          } else if (approvalStatus === 'REJECTED') {
+            logger.warn('[TemplateRecovery] Template rejected', { messageSid, templateSid: twilioContent.sid });
+          } else {
+            checkApproval(attempt + 1, maxAttempts);
+          }
+        } catch (err) {
+          logger.error('[TemplateRecovery] Error checking approval', { error: err.message, attempt });
+          // Retry on error (but count as attempt)
+          if (attempt + 1 < maxAttempts) {
+            checkApproval(attempt + 1, maxAttempts);
+          }
+        }
+      }, 15 * 60 * 1000);
+    };
+
+    checkApproval(0);
+
+  } catch (error) {
+    logger.error('[TemplateRecovery] Error', { messageSid, error: error.message });
+  }
+}
+
+module.exports = { handle24HourWindowError };

package/lib/models/messageModel.js

@@ -124,6 +124,9 @@ async function insertMessage(values) {
         updatedAt: values.delivery_status_updated_at || null
       };
     }
+    if (messageData.tools_executed === undefined) {
+      messageData.tools_executed = [];
+    }
 
     await Message.findOneAndUpdate(
       { message_id: values.message_id, body: values.body },

package/lib/routes/index.js

@@ -39,6 +39,8 @@ const messageRouteDefinitions = {
   'GET /last': 'getLastInteractionController',
   'GET /scheduled-status': 'checkScheduledMessageStatusController',
   'GET /status': 'checkMessageStatusController',
+  'GET /status/:messageSid': 'getMessageStatusController',
+  'POST /status-callback': 'messageStatusCallbackController',
   'POST /quality': 'addQualityVoteController',
   'GET /quality/:message_id': 'getQualityVotesByMessageController',
   'GET /quality/:message_id/voter/:voter_username': 'getQualityVoteByMessageAndVoterController',
@@ -97,6 +99,7 @@ const conversationController = require('../controllers/conversationController');
 const interactionController = require('../controllers/interactionController');
 const mediaController = require('../controllers/mediaController');
 const messageController = require('../controllers/messageController');
+const messageStatusController = require('../controllers/messageStatusController');
 const patientController = require('../controllers/patientController');
 const qualityMessageController = require('../controllers/qualityMessageController');
 const templateController = require('../controllers/templateController');
@@ -144,6 +147,8 @@ const builtInControllers = {
   getLastInteractionController: messageController.getLastInteractionController,
   checkScheduledMessageStatusController: messageController.checkScheduledMessageStatusController,
   checkMessageStatusController: messageController.checkMessageStatusController,
+  getMessageStatusController: messageStatusController.getMessageStatusController,
+  messageStatusCallbackController: messageStatusController.messageStatusCallbackController,
   addQualityVoteController: qualityMessageController.addQualityVoteController,
   getQualityVotesByMessageController: qualityMessageController.getQualityVotesByMessageController,
   getQualityVoteByMessageAndVoterController: qualityMessageController.getQualityVoteByMessageAndVoterController,

package/package.json

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