From deca1999514a64a9844c0a14f2589322cd40c09f Mon Sep 17 00:00:00 2001
From: Tyler <tyler@crispygoat.com>
Date: Fri, 19 Jun 2026 19:44:28 -0600
Subject: [PATCH] feat(frontend): refactor Remittances page to useRemittances +
 primitives

---
 src/pages/Remittances.tsx | 154 ++++++++++++++++++++++++++------------
 1 file changed, 107 insertions(+), 47 deletions(-)

diff --git a/src/pages/Remittances.tsx b/src/pages/Remittances.tsx
index 3a3f48b..38e4274 100644
--- a/src/pages/Remittances.tsx
+++ b/src/pages/Remittances.tsx
@@ -1,3 +1,4 @@
+import { useState } from "react";
 import {
   Table,
   TableBody,
@@ -7,13 +8,37 @@ import {
   TableRow,
 } from "@/components/ui/table";
 import { RemitStatusBadge } from "@/components/StatusBadge";
-import { useAppStore } from "@/store";
+import { Skeleton } from "@/components/ui/skeleton";
+import { EmptyState } from "@/components/ui/empty-state";
+import { ErrorState } from "@/components/ui/error-state";
+import { FilterChips, type FilterChipOption } from "@/components/ui/filter-chips";
+import { Pagination } from "@/components/ui/pagination";
+import { useRemittances } from "@/hooks/useRemittances";
 import { fmt } from "@/lib/format";
+import { cn } from "@/lib/utils";
+import type { RemittanceStatus } from "@/types";
+
+const PAGE_SIZE = 25;
+
+const STATUS_OPTIONS: FilterChipOption[] = [
+  { value: "received", label: "Received" },
+  { value: "posted", label: "Posted" },
+  { value: "reconciled", label: "Reconciled" },
+];
 
 export function Remittances() {
-  const remits = useAppStore((s) => s.remittances);
+  const [page, setPage] = useState(1);
+  const [status, setStatus] = useState<RemittanceStatus | null>(null);
 
-  const total = remits.reduce(
+  const { data, isLoading, isError, error, refetch } = useRemittances({
+    sort: "receivedDate",
+    order: "desc",
+    limit: PAGE_SIZE,
+    offset: (page - 1) * PAGE_SIZE,
+  });
+  const items = data?.items ?? [];
+
+  const total = items.reduce(
     (acc, r) => ({
       paid: acc.paid + r.paidAmount,
       adjustments: acc.adjustments + r.adjustmentAmount,
@@ -34,12 +59,20 @@ export function Remittances() {
         </p>
       </header>
 
+      {isError ? (
+        <ErrorState
+          message="Couldn't load remittances from the backend."
+          detail={error instanceof Error ? error.message : String(error)}
+          onRetry={() => refetch()}
+        />
+      ) : null}
+
       <div className="grid gap-4 grid-cols-2 lg:grid-cols-3">
         <div className="surface rounded-xl p-5">
           <div className="text-[11px] font-semibold uppercase tracking-[0.16em] text-muted-foreground">
             Remits
           </div>
-          <div className="display text-[28px] leading-none mt-3">{fmt.num(remits.length)}</div>
+          <div className="display text-[28px] leading-none mt-3">{fmt.num(data?.total ?? 0)}</div>
         </div>
         <div className="surface rounded-xl p-5">
           <div className="text-[11px] font-semibold uppercase tracking-[0.16em] text-muted-foreground">
@@ -55,51 +88,78 @@ export function Remittances() {
         </div>
       </div>
 
+      <div className="surface rounded-xl p-4">
+        <FilterChips
+          options={STATUS_OPTIONS}
+          value={status}
+          onChange={(v) => {
+            setStatus((v as RemittanceStatus | null) ?? null);
+            setPage(1);
+          }}
+          eyebrow="Status"
+        />
+      </div>
+
       <div className="surface rounded-xl overflow-hidden">
-        <Table>
-          <TableHeader>
-            <TableRow>
-              <TableHead>Remit</TableHead>
-              <TableHead>Claim</TableHead>
-              <TableHead>Payer</TableHead>
-              <TableHead className="text-right">Paid</TableHead>
-              <TableHead className="text-right">Adjustment</TableHead>
-              <TableHead>Status</TableHead>
-              <TableHead>Received</TableHead>
-            </TableRow>
-          </TableHeader>
-          <TableBody>
-            {remits.length === 0 ? (
-              <TableRow>
-                <TableCell colSpan={7} className="text-center py-12 text-muted-foreground">
-                  No remittances yet.
-                </TableCell>
-              </TableRow>
-            ) : (
-              remits.map((r) => (
-                <TableRow key={r.id}>
-                  <TableCell className="display num text-[13px]">{r.id}</TableCell>
-                  <TableCell className="display num text-[13px] text-muted-foreground">
-                    {r.claimId}
-                  </TableCell>
-                  <TableCell>{r.payerName}</TableCell>
-                  <TableCell className="text-right display num">
-                    {fmt.usdPrecise(r.paidAmount)}
-                  </TableCell>
-                  <TableCell className="text-right display num text-muted-foreground">
-                    {fmt.usdPrecise(r.adjustmentAmount)}
-                  </TableCell>
-                  <TableCell>
-                    <RemitStatusBadge status={r.status} />
-                  </TableCell>
-                  <TableCell className="text-muted-foreground num text-[13px]">
-                    {fmt.dateShort(r.receivedDate)}
-                  </TableCell>
+        {isLoading ? (
+          <div className="p-4 space-y-2">
+            {Array.from({ length: 5 }).map((_, i) => (
+              <Skeleton key={i} variant="row" />
+            ))}
+          </div>
+        ) : items.length === 0 ? (
+          <EmptyState
+            eyebrow="Remittances · awaiting first 835"
+            message="Drop an 835 file on the Upload page to populate this list."
+          />
+        ) : (
+          <>
+            <Table>
+              <TableHeader>
+                <TableRow>
+                  <TableHead>Remit</TableHead>
+                  <TableHead>Claim</TableHead>
+                  <TableHead>Payer</TableHead>
+                  <TableHead className="text-right">Paid</TableHead>
+                  <TableHead className="text-right">Adjustment</TableHead>
+                  <TableHead>Status</TableHead>
+                  <TableHead>Received</TableHead>
                 </TableRow>
-              ))
-            )}
-          </TableBody>
-        </Table>
+              </TableHeader>
+              <TableBody>
+                {items.map((r) => (
+                  <TableRow key={r.id} className={cn("animate-row-flash")}>
+                    <TableCell className="display num text-[13px]">{r.id}</TableCell>
+                    <TableCell className="display num text-[13px] text-muted-foreground">
+                      {r.claimId}
+                    </TableCell>
+                    <TableCell>{r.payerName}</TableCell>
+                    <TableCell className="text-right display num">
+                      {fmt.usdPrecise(r.paidAmount)}
+                    </TableCell>
+                    <TableCell className="text-right display num text-muted-foreground">
+                      {fmt.usdPrecise(r.adjustmentAmount)}
+                    </TableCell>
+                    <TableCell>
+                      <RemitStatusBadge status={r.status} />
+                    </TableCell>
+                    <TableCell className="text-muted-foreground num text-[13px]">
+                      {fmt.dateShort(r.receivedDate)}
+                    </TableCell>
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+            <div className="px-4 pb-4">
+              <Pagination
+                page={page}
+                pageSize={PAGE_SIZE}
+                total={data?.total ?? 0}
+                onPageChange={setPage}
+              />
+            </div>
+          </>
+        )}
       </div>
     </div>
   );