@peopl-health/nexus 5.52.0-dev.7696 → 5.52.0-dev.7705

package/lib/controllers/escalationReviewController.js

@@ -4,6 +4,7 @@ const { redactDirectIdentifiers } = require('../utils/sanitizerUtils');
 const {
   addCallLog,
   addDraft,
+  cancelEscalationReview,
   closeEscalationReview,
   getEscalationReviewById,
   handOffToDoctor,
@@ -135,6 +136,16 @@ const closeEscalationReviewController = async (req, res) => {
   }
 };
 
+const cancelEscalationReviewController = async (req, res) => {
+  try {
+    const { triggeredBy, reason = null } = req.body || {};
+    const review = await cancelEscalationReview({ id: req.params.id, cancelledBy: triggeredBy, reason, requestId: req.requestId });
+    res.status(200).json({ success: true, review });
+  } catch (error) {
+    respondWithError(res, error, 'cancelling escalation review', { reviewId: req.params?.id });
+  }
+};
+
 const syncEscalationReviewCaseController = async (req, res) => {
   try {
     const { triggeredBy } = req.body || {};
@@ -152,6 +163,7 @@ const syncEscalationReviewCaseController = async (req, res) => {
 module.exports = {
   addEscalationReviewCallLogController,
   addEscalationReviewDraftController,
+  cancelEscalationReviewController,
   closeEscalationReviewController,
   getEscalationReviewController,
   handOffEscalationReviewController,

package/lib/models/escalationReviewModel.js

@@ -7,6 +7,7 @@ const { logger } = require('../utils/logger');
 const CALL_OUTCOMES = ['contacted', 'no_answer', 'voicemail'];
 const HANDOFF_MODES = ['sent_whatsapp', 'copied'];
 const INTERRUPTED_STATUSES = ['handing_off', 'sending'];
+const CANCELLABLE_STATUSES = ['open', 'documenting', 'draft_ready'];
 const DOCTOR_DECISIONS = ['approved', 'edited_approved', 'needs_intervention', 'returned'];
 const DECISION_SOURCES = ['platform', 'registered_by_navigator'];
 
@@ -83,6 +84,7 @@ const escalationReviewSchema = new mongoose.Schema({
       'indications_queued',
       'indications_sent',
       'closed',
+      'cancelled',
     ],
     default: 'open',
   },
@@ -100,6 +102,7 @@ const escalationReviewSchema = new mongoose.Schema({
 
 escalationReviewSchema.index({ patientCode: 1, createdAt: -1 });
 escalationReviewSchema.index({ activeCaseKey: 1 }, { unique: true, sparse: true });
+escalationReviewSchema.index({ patientCode: 1 }, { unique: true, partialFilterExpression: { closedAt: null } });
 
 const getEscalationReview = () => {
   const dbName = getModelDatabase('EscalationReview');
@@ -110,6 +113,7 @@ const getEscalationReview = () => {
 
 module.exports = {
   CALL_OUTCOMES,
+  CANCELLABLE_STATUSES,
   DECISION_SOURCES,
   DOCTOR_DECISIONS,
   HANDOFF_MODES,

package/lib/routes/index.js

@@ -126,6 +126,7 @@ const escalationReviewRouteDefinitions = {
   'POST /:id/decisions': 'recordEscalationReviewDecisionController',
   'POST /:id/patient-deliveries': 'sendEscalationReviewIndicationsController',
   'POST /:id/close': 'closeEscalationReviewController',
+  'POST /:id/cancel': 'cancelEscalationReviewController',
   'POST /:id/case-sync': 'syncEscalationReviewCaseController'
 };
 
@@ -285,6 +286,7 @@ const builtInControllers = {
   recordEscalationReviewDecisionController: escalationReviewController.recordEscalationReviewDecisionController,
   sendEscalationReviewIndicationsController: escalationReviewController.sendEscalationReviewIndicationsController,
   closeEscalationReviewController: escalationReviewController.closeEscalationReviewController,
+  cancelEscalationReviewController: escalationReviewController.cancelEscalationReviewController,
   syncEscalationReviewCaseController: escalationReviewController.syncEscalationReviewCaseController
 };
 

package/lib/services/escalationReviewService.js

@@ -6,6 +6,7 @@ const { logger } = require('../utils/logger');
 const { PATIENT_CODE, redactDirectIdentifiers } = require('../utils/sanitizerUtils');
 const {
   CALL_OUTCOMES,
+  CANCELLABLE_STATUSES,
   DECISION_SOURCES,
   DOCTOR_DECISIONS,
   HANDOFF_MODES,
@@ -248,6 +249,24 @@ const deliveryTransport = (message, result) => {
   return result.deferred ? 'template_recovery' : 'text';
 };
 
+let indexesReady = new WeakMap();
+
+function ensureActiveReviewIndex(EscalationReview) {
+  const pending = indexesReady.get(EscalationReview);
+  if (pending) return pending;
+
+  const building = EscalationReview.ensureIndexes().catch((error) => {
+    indexesReady.delete(EscalationReview);
+    if (error?.code !== DUPLICATE_KEY_ERROR) throw error;
+    logger.error('[EscalationReview] A uniqueness index could not be built', { error: redactedError(error) });
+    throw httpError(409, 'Escalation reviews cannot be opened: a uniqueness index could not be built. The server log names the index and the conflict; resolve it and retry.');
+  });
+  indexesReady.set(EscalationReview, building);
+  return building;
+}
+
+const _resetEscalationReviewIndexes = () => { indexesReady = new WeakMap(); };
+
 async function openEscalationReview({ code, patientCaseRecordId = null, openedBy, requestId = null } = {}) {
   const patientCode = patientCodeOf(code);
   const operator = requiredText(openedBy, 'openedBy');
@@ -264,14 +283,14 @@ async function openEscalationReview({ code, patientCaseRecordId = null, openedBy
   }
 
   const EscalationReview = getEscalationReview();
-  await EscalationReview.init();
+  await ensureActiveReviewIndex(EscalationReview);
   let review;
   try {
     review = (await EscalationReview.create(fields)).toObject();
   } catch (error) {
-    if (error?.code !== DUPLICATE_KEY_ERROR || !fields.activeCaseKey) throw error;
-    const existing = await EscalationReview.findOne({ activeCaseKey: fields.activeCaseKey }).lean();
-    if (!existing) throw httpError(409, 'The patient case review changed while opening; try again');
+    if (error?.code !== DUPLICATE_KEY_ERROR) throw error;
+    const existing = await EscalationReview.findOne({ patientCode, closedAt: null }).lean();
+    if (!existing) throw httpError(409, 'A closed review still holds this patient case; try again in a moment');
     return { review: existing, created: false };
   }
   await audit(review, operator, requestId, { action: 'opened', patientCaseRecordId });
@@ -524,6 +543,17 @@ async function closeEscalationReview({ id, closedBy, deliveryConfirmed = false,
   return syncCase(review, operator, requestId);
 }
 
+async function cancelEscalationReview({ id, cancelledBy, reason = null, requestId = null } = {}) {
+  const reviewId = reviewIdOf(id);
+  const operator = requiredText(cancelledBy, 'cancelledBy');
+  const review = await updateReview(reviewId, CANCELLABLE_STATUSES, {
+    $set: { status: 'cancelled', closedBy: operator, closedAt: new Date() },
+    $unset: { activeCaseKey: '' },
+  });
+  await audit(review, operator, requestId, { action: 'cancelled', reason: optionalText(reason) });
+  return review;
+}
+
 async function syncEscalationReviewCase({ id, syncedBy, requestId = null } = {}) {
   const reviewId = reviewIdOf(id);
   const operator = requiredText(syncedBy, 'syncedBy');
@@ -531,8 +561,10 @@ async function syncEscalationReviewCase({ id, syncedBy, requestId = null } = {})
 }
 
 module.exports = {
+  _resetEscalationReviewIndexes,
   addCallLog,
   addDraft,
+  cancelEscalationReview,
   closeEscalationReview,
   getEscalationReviewById,
   handOffToDoctor,

package/package.json

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