feat(sp6): inbox api client + types

2026-06-20 18:36:14 -06:00
parent f4baceb574
commit f3e5d800e1
2 changed files with 192 additions and 0 deletions
@@ -0,0 +1,121 @@
+// ---------------------------------------------------------------------------
+// Inbox API client (sub-project 6).
+//
+// Mirrors the four-lane working surface: rejected / candidates / unmatched /
+// done_today. Plus the actions: manual match, dismiss, resubmit, export.
+// All non-2xx responses throw (so callers can branch on status).
+// ---------------------------------------------------------------------------
+
+export type ScoreBreakdown = {
+  patient: number;
+  date: number;
+  amount: number;
+  provider: number;
+};
+
+export type ScoreTier = "strong" | "weak" | "hidden";
+
+export type InboxClaimRow = {
+  id: string;
+  kind: "claim";
+  patient_control_number: string;
+  charge_amount: number | null;
+  payer_id: string | null;
+  provider_npi: string | null;
+  state: string;
+  rejection_reason: string | null;
+  rejected_at: string | null;
+  service_date_from: string | null;
+  score?: number | null;
+  score_tier?: ScoreTier | null;
+  score_breakdown?: ScoreBreakdown | null;
+};
+
+export type InboxCandidateRow = {
+  id: string;
+  kind: "remit";
+  payer_claim_control_number: string;
+  charge_amount: number | null;
+  payer_id: string | null;
+  rendering_provider_npi: string | null;
+  service_date: string | null;
+  candidates: Array<{
+    claim_id: string;
+    score: number;
+    tier: ScoreTier;
+    breakdown: ScoreBreakdown;
+  }>;
+};
+
+export type InboxLanes = {
+  rejected: InboxClaimRow[];
+  candidates: InboxCandidateRow[];
+  unmatched: InboxClaimRow[];
+  done_today: InboxClaimRow[];
+};
+
+const BASE_URL =
+  (import.meta.env.VITE_API_BASE_URL as string | undefined) ?? "";
+
+function joinUrl(path: string): string {
+  return `${BASE_URL.replace(/\/$/, "")}${path}`;
+}
+
+async function getJson<T>(path: string): Promise<T> {
+  const r = await fetch(joinUrl(path));
+  if (!r.ok) {
+    throw new Error(`GET ${path} failed: ${r.status}`);
+  }
+  return (await r.json()) as T;
+}
+
+async function postJson<T>(path: string, body: unknown): Promise<T> {
+  const r = await fetch(joinUrl(path), {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(body),
+  });
+  if (!r.ok) {
+    throw new Error(`POST ${path} failed: ${r.status}`);
+  }
+  return (await r.json()) as T;
+}
+
+export async function fetchInboxLanes(): Promise<InboxLanes> {
+  return getJson<InboxLanes>("/api/inbox/lanes");
+}
+
+export async function matchCandidate(
+  remitId: string,
+  claimId: string,
+): Promise<void> {
+  await postJson(`/api/inbox/candidates/${encodeURIComponent(remitId)}/match`, {
+    claim_id: claimId,
+  });
+}
+
+export async function dismissCandidates(
+  pairs: Array<{ claim_id: string; remit_id: string }>,
+): Promise<void> {
+  await postJson("/api/inbox/candidates/dismiss", { pairs });
+}
+
+export type ResubmitResult = {
+  ok: boolean;
+  resubmitted: string[];
+  conflicts: Array<{ claim_id: string; current_state: string }>;
+};
+
+export async function resubmitRejected(
+  claimIds: string[],
+): Promise<ResubmitResult> {
+  return postJson<ResubmitResult>("/api/inbox/rejected/resubmit", {
+    claim_ids: claimIds,
+  });
+}
+
+export function exportInboxCsvUrl(
+  lane: "rejected" | "candidates" | "unmatched" | "done_today",
+): string {
+  return joinUrl(`/api/inbox/export.csv?lane=${lane}`);
+}