xytara 1.0.0

package/lib/commerce_cases.js

@@ -0,0 +1,303 @@
+"use strict";
+
+const crypto = require("crypto");
+
+function setResultRemediation(state, transactionId, patch) {
+  if (!transactionId || !state.transactions.has(transactionId)) {
+    return;
+  }
+  const current = state.transactions.get(transactionId);
+  const currentTransactionRemediation = current.transaction && current.transaction.remediation && typeof current.transaction.remediation === "object"
+    ? current.transaction.remediation
+    : {};
+  const currentReceiptRemediation = current.receipt && current.receipt.remediation && typeof current.receipt.remediation === "object"
+    ? current.receipt.remediation
+    : {};
+  const nextRemediation = {
+    ...currentTransactionRemediation,
+    ...currentReceiptRemediation,
+    ...(patch || {}),
+    updated_at_iso: new Date().toISOString()
+  };
+  current.transaction.remediation = nextRemediation;
+  current.receipt.remediation = nextRemediation;
+}
+
+function appendHistory(record, event, body, nextStatus) {
+  const timestamp = new Date().toISOString();
+  const actor = body && body.actor && typeof body.actor === "object" ? body.actor : { type: "operator", role: "reviewer" };
+  const context = body && body.context && typeof body.context === "object" ? body.context : null;
+  const previousStatus = record.status || null;
+  return {
+    ...record,
+    status: nextStatus || record.status,
+    updated_at_iso: timestamp,
+    history: [
+      ...(Array.isArray(record.history) ? record.history : []),
+      {
+        at_iso: timestamp,
+        event,
+        note: body && typeof body.note === "string" ? body.note : null,
+        reason_code: body && typeof body.reason_code === "string" ? body.reason_code : record.reason_code || null,
+        action_code: body && typeof body.action_code === "string" ? body.action_code : null,
+        previous_status: previousStatus,
+        next_status: nextStatus || record.status,
+        actor,
+        context
+      }
+    ].slice(-20)
+  };
+}
+
+function createDispute(state, body) {
+  const timestamp = new Date().toISOString();
+  const actor = body && body.actor && typeof body.actor === "object" ? body.actor : { type: "operator", role: "creator" };
+  const context = body && body.context && typeof body.context === "object" ? body.context : null;
+  const dispute = {
+    dispute_id: `dsp_${crypto.randomBytes(6).toString("hex")}`,
+    title: typeof body.title === "string" && body.title.trim() ? body.title.trim() : "Dispute",
+    description: typeof body.description === "string" && body.description.trim() ? body.description.trim() : null,
+    status: "open",
+    transaction_id: body.transaction_id || null,
+    receipt_id: body.receipt_id || null,
+    reason_code: body.reason_code || "other",
+    note: body.note || null,
+    evidence: body && body.evidence && typeof body.evidence === "object" ? body.evidence : {},
+    created_at_iso: timestamp,
+    updated_at_iso: timestamp,
+    created_actor: actor,
+    created_context: context,
+    history: [
+      {
+        at_iso: timestamp,
+        event: "opened",
+        note: body.note || body.description || null,
+        reason_code: body.reason_code || "other",
+        action_code: null,
+        previous_status: null,
+        next_status: "open",
+        actor,
+        context
+      }
+    ]
+  };
+  state.disputes.set(dispute.dispute_id, dispute);
+  setResultRemediation(state, dispute.transaction_id, {
+    status: "under_dispute",
+    reason_code: dispute.reason_code,
+    active_case_type: "dispute",
+    active_case_id: dispute.dispute_id,
+    compensating_action_status: "none"
+  });
+  return dispute;
+}
+
+function createRefund(state, body) {
+  const timestamp = new Date().toISOString();
+  const actor = body && body.actor && typeof body.actor === "object" ? body.actor : { type: "operator", role: "creator" };
+  const context = body && body.context && typeof body.context === "object" ? body.context : null;
+  const refund = {
+    refund_id: `rfd_${crypto.randomBytes(6).toString("hex")}`,
+    status: "requested",
+    transaction_id: body.transaction_id || null,
+    receipt_id: body.receipt_id || null,
+    reason_code: body.reason_code || "other",
+    note: body.note || null,
+    requested_by: typeof body.requested_by === "string" && body.requested_by.trim() ? body.requested_by.trim() : "operator",
+    created_at_iso: timestamp,
+    updated_at_iso: timestamp,
+    created_actor: actor,
+    created_context: context,
+    history: [
+      {
+        at_iso: timestamp,
+        event: "requested",
+        note: body.note || null,
+        reason_code: body.reason_code || "other",
+        action_code: null,
+        previous_status: null,
+        next_status: "requested",
+        actor,
+        context
+      }
+    ]
+  };
+  state.refunds.set(refund.refund_id, refund);
+  setResultRemediation(state, refund.transaction_id, {
+    status: "remediation_pending",
+    reason_code: refund.reason_code,
+    active_case_type: "refund",
+    active_case_id: refund.refund_id,
+    compensating_action_status: "none"
+  });
+  return refund;
+}
+
+function actOnDispute(state, disputeId, body) {
+  const current = state.disputes.get(disputeId);
+  if (!current) return null;
+  const action = String((body && body.action) || "").trim();
+  const statusByAction = {
+    review: "under_review",
+    escalate: "escalated",
+    reopen: "open",
+    resolve: "resolved",
+    dismiss: "dismissed"
+  };
+  const nextStatus = statusByAction[action] || current.status;
+  const next = appendHistory(current, action || "review", body, nextStatus);
+  if (body && typeof body.resolution_code === "string" && body.resolution_code.trim()) {
+    next.resolution_code = body.resolution_code.trim();
+  }
+  state.disputes.set(disputeId, next);
+  const remediationStatus = next.status === "resolved" || next.status === "dismissed"
+    ? "none"
+    : next.status === "escalated"
+      ? "escalated"
+      : "under_dispute";
+  setResultRemediation(state, next.transaction_id, {
+    status: remediationStatus,
+    reason_code: remediationStatus === "none" ? null : next.reason_code,
+    active_case_type: remediationStatus === "none" ? null : "dispute",
+    active_case_id: remediationStatus === "none" ? null : next.dispute_id,
+    compensating_action_status: remediationStatus === "none" ? null : "none"
+  });
+  return next;
+}
+
+function actOnRefund(state, refundId, body) {
+  const current = state.refunds.get(refundId);
+  if (!current) return null;
+  const action = String((body && body.action) || "").trim();
+  const statusByAction = {
+    review: "under_review",
+    approve: "approved",
+    complete: "completed",
+    cancel: "cancelled",
+    fail: "failed",
+    pending_manual: "pending_manual"
+  };
+  const nextStatus = statusByAction[action] || current.status;
+  const next = appendHistory(current, action || "review", body, nextStatus);
+  if (body && typeof body.action_code === "string" && body.action_code.trim()) {
+    next.action_code = body.action_code.trim();
+  }
+  state.refunds.set(refundId, next);
+  const remediationStatus = next.status === "completed"
+    ? "compensated"
+    : next.status === "cancelled"
+      ? "none"
+    : next.status === "approved"
+      ? "remediation_pending"
+    : next.status === "pending_manual"
+      ? "remediation_pending"
+    : next.status === "failed"
+      ? "compensation_failed"
+      : "remediation_pending";
+  setResultRemediation(state, next.transaction_id, {
+    status: remediationStatus,
+    reason_code: remediationStatus === "none" ? null : next.reason_code,
+    active_case_type: remediationStatus === "compensated" || remediationStatus === "none" ? null : "refund",
+    active_case_id: remediationStatus === "compensated" || remediationStatus === "none" ? null : next.refund_id,
+    compensating_action_status: remediationStatus === "none" ? null : next.status
+  });
+  return next;
+}
+
+function createRemediationTicket(state, body) {
+  const timestamp = new Date().toISOString();
+  const actor = body && body.actor && typeof body.actor === "object" ? body.actor : { type: "operator", role: "creator" };
+  const context = body && body.context && typeof body.context === "object" ? body.context : null;
+  const ticket = {
+    ticket_id: `rmt_${crypto.randomBytes(6).toString("hex")}`,
+    status: "open",
+    transaction_id: body.transaction_id || null,
+    receipt_id: body.receipt_id || null,
+    reason_code: body.reason_code || "other",
+    action_code: body.action_code || "investigate",
+    assigned_owner: typeof body.assigned_owner === "string" && body.assigned_owner.trim() ? body.assigned_owner.trim() : null,
+    note: body.note || null,
+    created_at_iso: timestamp,
+    updated_at_iso: timestamp,
+    created_actor: actor,
+    created_context: context,
+    history: [
+      {
+        at_iso: timestamp,
+        event: "opened",
+        note: body.note || null,
+        reason_code: body.reason_code || "other",
+        action_code: body.action_code || "investigate",
+        previous_status: null,
+        next_status: "open",
+        actor,
+        context
+      }
+    ]
+  };
+  state.remediationTickets.set(ticket.ticket_id, ticket);
+  setResultRemediation(state, ticket.transaction_id, {
+    status: "remediation_pending",
+    reason_code: ticket.reason_code,
+    active_case_type: "remediation_ticket",
+    active_case_id: ticket.ticket_id,
+    compensating_action_status: ticket.action_code
+  });
+  return ticket;
+}
+
+function actOnRemediationTicket(state, ticketId, body) {
+  const current = state.remediationTickets.get(ticketId);
+  if (!current) return null;
+  const action = String((body && body.action) || "").trim();
+  const statusByAction = {
+    acknowledge: "acknowledged",
+    assign: "assigned",
+    escalate: "escalated",
+    resolve: "resolved",
+    clear: "cleared"
+  };
+  const next = appendHistory(current, action || "acknowledge", body, statusByAction[action] || current.status);
+  if (body && body.reason_code) {
+    next.reason_code = body.reason_code;
+  }
+  if (body && body.action_code) {
+    next.action_code = body.action_code;
+  }
+  if (body && typeof body.assigned_owner === "string" && body.assigned_owner.trim()) {
+    next.assigned_owner = body.assigned_owner.trim();
+  }
+  if (body && typeof body.note === "string" && body.note.trim()) {
+    if (next.status === "assigned") {
+      next.assignment_note = body.note.trim();
+    }
+    if (next.status === "cleared") {
+      next.cleared_note = body.note.trim();
+    }
+  }
+  state.remediationTickets.set(ticketId, next);
+  const remediationStatus = next.status === "cleared"
+    ? "none"
+    : next.status === "resolved"
+      ? "none"
+    : next.status === "escalated"
+      ? "escalated"
+      : "remediation_pending";
+  setResultRemediation(state, next.transaction_id, {
+    status: remediationStatus,
+    reason_code: remediationStatus === "none" ? null : next.reason_code,
+    active_case_type: remediationStatus === "none" ? null : "remediation_ticket",
+    active_case_id: remediationStatus === "none" ? null : next.ticket_id,
+    compensating_action_status: remediationStatus === "none" ? null : next.action_code
+  });
+  return next;
+}
+
+module.exports = {
+  actOnDispute,
+  actOnRefund,
+  actOnRemediationTicket,
+  createDispute,
+  createRefund,
+  createRemediationTicket
+};