Dispute Service

pnpm add @aicr/dispute-core

import { createCase, resolveCase, getCaseStatus } from '@aicr/dispute-core';
 
// Create a dispute case
const case = await createCase({
  type: 'payment-discrepancy',
  claimant: userId,
  description: 'Commission calculation error for Q4',
  evidence: [documentId],
  slaHours: 72
});
 
// Check status
const status = await getCaseStatus(case.id);
 
// Resolve
await resolveCase(case.id, {
  resolution: 'approved',
  adjustmentAmount: 1500,
  notes: 'Commission recalculated per policy'
});

interface CreateCaseInput {
  type: 'payment-discrepancy' | 'policy-violation' | 'territory-dispute' | 'quota-challenge' | 'other';
  claimant: string;        // User ID
  description: string;
  evidence?: string[];     // Document IDs
  slaHours?: number;       // SLA deadline in hours
  priority?: 'low' | 'medium' | 'high' | 'critical';
  assignTo?: string;       // Resolver ID
}
 
interface Case {
  id: string;
  type: string;
  status: 'open' | 'in-review' | 'pending-info' | 'resolved' | 'escalated';
  claimant: string;
  assignedTo?: string;
  slaDeadline: Date;
  createdAt: Date;
  updatedAt: Date;
}

interface Resolution {
  resolution: 'approved' | 'denied' | 'partial' | 'withdrawn';
  adjustmentAmount?: number;
  notes: string;
  evidence?: string[];
}

await escalateCase(caseId, {
  reason: 'Policy exception required',
  escalateTo: 'compensation-committee'
});

await addCaseNote(caseId, {
  content: 'Requested additional documentation from claimant',
  visibility: 'internal'
});

curl -X POST /api/dispute/cases \
  -d '{"type": "payment-discrepancy", "claimant": "user-123", "description": "..."}'

curl -X PUT /api/dispute/cases/case-123/resolve \
  -d '{"resolution": "approved", "notes": "..."}'

curl /api/dispute/cases/case-123

import { getSLAStatus, getOverdueCases } from '@aicr/dispute-core';
 
// Check SLA status
const sla = await getSLAStatus(caseId);
console.log(sla.hoursRemaining);
console.log(sla.isOverdue);
 
// Get all overdue cases
const overdue = await getOverdueCases({ assignedTo: 'user-123' });