@ampath/esm-dha-workflow-app 4.0.0-next.340 → 4.0.0-next.344

package/src/billing/dashboard/v3/patient-bill-details/bill-details/bill-details.tsx

@@ -1,7 +1,7 @@
 import React, { useEffect, useMemo, useState } from 'react';
 import { type PatientPayment, type PatientFacilityBillDetails, ClaimsVisit } from '../../types';
 import styles from './bill-details.scss';
-import { Button, OverflowMenu, OverflowMenuItem, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Tag } from '@carbon/react';
+import { Button, OverflowMenu, OverflowMenuItem, RadioButton, RadioButtonGroup, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Tag } from '@carbon/react';
 import { formatDate, parseDate } from '@openmrs/esm-framework';
 import BillItemPaymentModal from '../modals/bill-item-payment/bill-item-payment.modal';
 import AddClaimLineModal from '../modals/add-claim-line/add-claim-line.modal';
@@ -17,13 +17,19 @@ interface billDetailsProps {
   locationUuid: string;
   claimsVisit: ClaimsVisit;
 }
+type BillingScope = 'OPD' | 'INPATIENT';
 const BillDetails: React.FC<billDetailsProps> = ({ patientBillDetails, patientPayments, amrsVisitDiagnosis, consentToken, locationUuid, claimsVisit }) => {
   const [showPaymentModal, setShowPaymentModal] = useState<boolean>(false);
   const [showAddClaimLineModal, setShowAddClaimLineModal] = useState<boolean>(false);
   const [selectedBillItem, setSelectedBillItem] = useState<PatientFacilityBillDetails | null>(null);
   const setDiagnosisInterventionCode = useMemo(() => getConsultationBillIntervantionCode(), [patientBillDetails]);
+  const [billingScope, setBillingScope] = useState<BillingScope>('OPD');
   const invalidateProviderClaimPreview = useInvalidateProviderClaimPreview();
 
+  const scopedBillDetails = patientBillDetails;
+  const scopedPayments = patientPayments;
+  const scopedDiagnosis = amrsVisitDiagnosis;
+
   if (!patientBillDetails && !patientPayments) {
     return <>No Data</>;
   }
@@ -61,6 +67,7 @@ const BillDetails: React.FC<billDetailsProps> = ({ patientBillDetails, patientPa
     handleCloseAddClaimItemModal();
     invalidateProviderClaimPreview();
   }
+
   function interventionAddedToClaimLine(b: PatientFacilityBillDetails) {
     if (b.intervention_code && b.has_claim_line === 0) {
       if (claimsVisit && claimsVisit.invoices) {
@@ -73,163 +80,154 @@ const BillDetails: React.FC<billDetailsProps> = ({ patientBillDetails, patientPa
     }
     return true;
   }
+
+  const billDetailsLayout = (
+    <div className={styles.billDetailsLayout}>
+      {scopedBillDetails.length > 0 ? (
+        <div className={styles.billRow}>
+          <div>
+            <h6>Bill Items</h6>
+          </div>
+          <div>
+            <Table aria-label="bill details" size="sm">
+              <TableHead>
+                <TableRow>
+                  <TableHeader>No</TableHeader>
+                  <TableHeader>Bill Item</TableHeader>
+                  <TableHeader>Intervention Code</TableHeader>
+                  <TableHeader>Order No</TableHeader>
+                  <TableHeader>Service Type</TableHeader>
+                  <TableHeader>Payer</TableHeader>
+                  <TableHeader>Payment Status</TableHeader>
+                  <TableHeader>Quantity</TableHeader>
+                  <TableHeader>Total</TableHeader>
+                  <TableHeader>Actions</TableHeader>
+                </TableRow>
+              </TableHead>
+              <TableBody>
+                {scopedBillDetails.map((b, index) => (
+                  <TableRow key={b.patient_uuid}>
+                    <TableCell>{index + 1}</TableCell>
+                    <TableCell>{b.billable_service}</TableCell>
+                    <TableCell>{b.intervention_code ?? ''}</TableCell>
+                    <TableCell>{b.order_no ?? ''}</TableCell>
+                    <TableCell>{b.service_type ?? ''}</TableCell>
+                    <TableCell>{b.payment_scheme}</TableCell>
+                    <TableCell>{b.payment_status}</TableCell>
+                    <TableCell>{b.item_quantity}</TableCell>
+                    <TableCell>Ksh {b.item_total_price}</TableCell>
+                    <TableCell>
+                      {
+                        (b.paid_status !== 'PAID' && !b.intervention_code) && <Button size="sm" kind="tertiary" onClick={() => handleBillItemPayment(b)}>Pay</Button>
+                      }
+                      {
+                        b.intervention_code ?
+                          (
+                            claimsVisit ?
+                              (
+                                claimsVisit.workflow_state === 'DRAFT' ?
+                                  (!interventionAddedToClaimLine(b) && <Button size="sm" kind="tertiary" onClick={() => handleClaimLineAddition(b)}>Add Claim Line</Button>)
+                                  : <Tag>{claimsVisit.workflow_state}</Tag>
+                              )
+                              : <></>
+                          )
+                          : <></>
+                      }
+                    </TableCell>
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+          </div>
+        </div>
+      ) : null}
+
+      {scopedPayments.length > 0 ? (
+        <div className={styles.billRow}>
+          <div>
+            <h6>Bill Payments</h6>
+          </div>
+          <div>
+            <Table aria-label="bill details" size="sm">
+              <TableHead>
+                <TableRow>
+                  <TableHeader>No</TableHeader>
+                  <TableHeader>Payment Type</TableHeader>
+                  <TableHeader>Amount</TableHeader>
+                  <TableHeader>Amount Tendered</TableHeader>
+                  <TableHeader>Date / Time</TableHeader>
+                </TableRow>
+              </TableHead>
+              <TableBody>
+                {scopedPayments.map((p, index) => (
+                  <TableRow key={p.cashier_bill_payment_uuid}>
+                    <TableCell>{index + 1}</TableCell>
+                    <TableCell>{p.payment_mode}</TableCell>
+                    <TableCell>Ksh {p.amount}</TableCell>
+                    <TableCell>Ksh {p.amount_tendered}</TableCell>
+                    <TableCell>{formatDate(parseDate(p.payment_time))}</TableCell>
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+          </div>
+        </div>
+      ) : null}
+
+      {scopedDiagnosis.length > 0 ? (
+        <div className={styles.billRow}>
+          <div>
+            <h6>Patient Dignosis</h6>
+          </div>
+          <div>
+            <VisitDiagnosisDetails
+              amrsVisitDiagnosis={scopedDiagnosis}
+              consentToken={consentToken}
+              locationUuid={locationUuid}
+              interventionCode={setDiagnosisInterventionCode}
+              claimsVisit={claimsVisit}
+            />
+          </div>
+        </div>
+      ) : null}
+    </div>
+  );
+
   return (
     <>
-      <div className={styles.billDetailsLayout}>
-        {patientBillDetails.length > 0 ? (
-          <>
-            <div className={styles.billRow}>
-              <div>
-                <h6>Bill Items</h6>
-              </div>
-              <div>
-                <Table aria-label="bill details" size="sm">
-                  <TableHead>
-                    <TableRow>
-                      <TableHeader>No</TableHeader>
-                      <TableHeader>Bill Item</TableHeader>
-                      <TableHeader>Intervention Code</TableHeader>
-                      <TableHeader>Order No</TableHeader>
-                      <TableHeader>Service Type</TableHeader>
-                      <TableHeader>Payer</TableHeader>
-                      <TableHeader>Payment Status</TableHeader>
-                      <TableHeader>Quantity</TableHeader>
-                      <TableHeader>Total</TableHeader>
-                      <TableHeader>Actions</TableHeader>
-                    </TableRow>
-                  </TableHead>
-                  <TableBody>
-                    {patientBillDetails &&
-                      patientBillDetails.map((b, index) => {
-                        return (
-                          <>
-                            <TableRow key={b.patient_uuid}>
-                              <TableCell>{index + 1}</TableCell>
-                              <TableCell>{b.billable_service}</TableCell>
-                              <TableCell>{b.intervention_code ?? ''}</TableCell>
-                              <TableCell>{b.order_no ?? ''}</TableCell>
-                              <TableCell>{b.service_type ?? ''}</TableCell>
-                              <TableCell>{b.payment_scheme}</TableCell>
-                              <TableCell>{b.paid_status}</TableCell>
-                              <TableCell>{b.item_quantity}</TableCell>
-                              <TableCell>Ksh {b.item_total_price}</TableCell>
-                              <TableCell>
-                                {/* <OverflowMenu aria-label="overflow-menu">
-                                  {
-                                    (b.paid_status !== 'PAID' && !b.intervention_code) && <OverflowMenuItem itemText="Pay" onClick={() => handleBillItemPayment(b)} />
-                                  }
-                                  {
-                                    (b.intervention_code && b.has_claim_line === 0) && <OverflowMenuItem itemText="Add Claim Line" onClick={() => handleClaimLineAddition(b)} />
-                                  }
-                                </OverflowMenu> */}
-                                {
-                                  (b.paid_status !== 'PAID' && !b.intervention_code) && <Button size="sm" kind="tertiary" onClick={() => handleBillItemPayment(b)}>Pay</Button>
-                                }
-                                {
-                                  b.intervention_code ?
-                                    (
-                                      claimsVisit ?
-                                        (
-                                          claimsVisit.workflow_state === 'DRAFT' ?
-                                            (!interventionAddedToClaimLine(b) && <Button size="sm" kind="tertiary" onClick={() => handleClaimLineAddition(b)}>Add Claim Line</Button>)
-                                            : <Tag>{claimsVisit.workflow_state}</Tag>
-                                        )
-                                        : <></>
-                                    )
-                                    : <></>
-                                }
-                              </TableCell>
-                            </TableRow>
-                          </>
-                        );
-                      })}
-                  </TableBody>
-                </Table>
-              </div>
-            </div>
-          </>
-        ) : (
-          <></>
-        )}
-        {patientPayments.length > 0 ? (
-          <>
-            <div className={styles.billRow}>
-              <div>
-                <h6>Bill Payments</h6>
-              </div>
-              <div>
-                <Table aria-label="bill details" size="sm">
-                  <TableHead>
-                    <TableRow>
-                      <TableHeader>No</TableHeader>
-                      <TableHeader>Payment Type</TableHeader>
-                      <TableHeader>Amount</TableHeader>
-                      <TableHeader>Amount Tendered</TableHeader>
-                      <TableHeader>Date / Time</TableHeader>
-                    </TableRow>
-                  </TableHead>
-                  <TableBody>
-                    {patientPayments &&
-                      patientPayments.map((p, index) => {
-                        return (
-                          <>
-                            <TableRow key={p.cashier_bill_payment_uuid}>
-                              <TableCell>{index + 1}</TableCell>
-                              <TableCell>{p.payment_mode}</TableCell>
-                              <TableCell>Ksh {p.amount}</TableCell>
-                              <TableCell>Ksh {p.amount_tendered}</TableCell>
-                              <TableCell>
-                                {formatDate(parseDate(p.payment_time))}</TableCell>
-                            </TableRow>
-                          </>
-                        );
-                      })}
-                  </TableBody>
-                </Table>
-              </div>
-            </div>
-          </>
-        ) : (
-          <></>
-        )}
-        {
-          amrsVisitDiagnosis.length > 0 ? (<>
-            <div className={styles.billRow}>
-              <div>
-                <h6>Patient Dignosis</h6>
-              </div>
-              <div>
-                <VisitDiagnosisDetails
-                  amrsVisitDiagnosis={amrsVisitDiagnosis}
-                  consentToken={consentToken}
-                  locationUuid={locationUuid}
-                  interventionCode={setDiagnosisInterventionCode}
-                  claimsVisit={claimsVisit}
-                />
-              </div>
-            </div>
+      <RadioButtonGroup
+        className={styles.radioGroup}
+        name="billing-scope"
+        valueSelected={billingScope}
+        onChange={(value) => setBillingScope(value as BillingScope)}
+        invalidText="Invalid selection"
+        warnText="Please notice the warning"
+      >
+        <RadioButton id="outpatient" labelText="OPD" value="OPD" />
+        <RadioButton id="inpatient" labelText="INPATIENT" value="INPATIENT" />
+      </RadioButtonGroup>
 
-          </>) : (<></>)
-        }
-        {
-          (showPaymentModal && selectedBillItem) && <BillItemPaymentModal
-            open={showPaymentModal}
-            billItem={selectedBillItem}
-            onClose={handleClosePayModal}
-            onPay={handleSuccessfullPayment} />
-        }
-        {
-          (showAddClaimLineModal && selectedBillItem) && <AddClaimLineModal
-            open={showAddClaimLineModal}
-            billItem={selectedBillItem}
-            onClose={handleCloseAddClaimItemModal}
-            onSuccess={onSuccess}
-            locationUuid={locationUuid}
-            consentToken={consentToken}
-          />
-        }
-      </div>
-    </>
-  );
+      {billDetailsLayout}
+
+      {showPaymentModal && selectedBillItem && (
+        <BillItemPaymentModal
+          open={showPaymentModal}
+          billItem={selectedBillItem}
+          onClose={handleClosePayModal}
+          onPay={handleSuccessfullPayment}
+        />
+      )}
+      {showAddClaimLineModal && selectedBillItem && (
+        <AddClaimLineModal
+          open={showAddClaimLineModal}
+          billItem={selectedBillItem}
+          onClose={handleCloseAddClaimItemModal}
+          onSuccess={onSuccess}
+          locationUuid={locationUuid}
+          consentToken={consentToken}
+        />
+      )}
+      </>
+      );
 };
 export default BillDetails;

package/src/billing/dashboard/v3/patient-bill-details/claim-details/patient-claim-details.component.tsx

@@ -1,17 +1,18 @@
-import React, { useEffect } from "react";
-import { useState } from "react";
-import { type ProviderClaimPreviewDto, type ClaimsVisit, type PatientFacilityBillDetails } from "../../types";
-import { showSnackbar } from "@openmrs/esm-framework";
-import { fetchProviderClaimPreview, useProviderClaimPreview } from "../../../../billing-claims.resource";
+import React, { useEffect } from 'react';
+import { useState } from 'react';
+import { type ProviderClaimPreviewDto, type ClaimsVisit, type PatientFacilityBillDetails } from '../../types';
+import { showSnackbar } from '@openmrs/esm-framework';
+import { fetchProviderClaimPreview, useProviderClaimPreview } from '../../../../billing-claims.resource';
 import styles from './patient-claim-details.component.scss';
-import ClaimVisitDetails from "../../claim-visits/claim-visit-details/claim-visit-details.component";
-import { InlineLoading } from "@carbon/react";
+import ClaimVisitDetails from '../../claim-visits/claim-visit-details/claim-visit-details.component';
+import { InlineLoading } from '@carbon/react';
 
 interface patientClaimDetailsProps {
   consentToken: string;
   locationUuid: string;
   patientBillDetails: PatientFacilityBillDetails[];
   onBillDetailsChange?: () => void;
+  billingDate: string;
   onLoadingClaimVisit?: (claimVisit: ClaimsVisit) => void;
 }
 const PatientClaimDetails: React.FC<patientClaimDetailsProps> = ({
@@ -19,6 +20,7 @@ const PatientClaimDetails: React.FC<patientClaimDetailsProps> = ({
   locationUuid,
   patientBillDetails,
   onBillDetailsChange,
+  billingDate,
   onLoadingClaimVisit
 }) => {
   const [patientBill, setPatientBill] = useState<PatientFacilityBillDetails>();
@@ -37,33 +39,30 @@ const PatientClaimDetails: React.FC<patientClaimDetailsProps> = ({
   }, [consentToken, locationUuid]);
 
   if (isLoading && !claimVisit) {
-    return <InlineLoading description='Loading data...please wait' />
+    return <InlineLoading description="Loading data...please wait" />;
   }
 
   function getPatientBill() {
-    const bill = patientBillDetails.find(details => details.consent_token === consentToken);
+    const bill = patientBillDetails.find((details) => details.consent_token === consentToken);
     setPatientBill(bill);
   }
 
-  return <>
-    {
-      isValidating &&
-      <InlineLoading description='Refreshing data...' />
-    }
-    <div className={styles.pcLayout}>
-      {
-        claimVisit && (
+  return (
+    <>
+      {isValidating && <InlineLoading description="Refreshing data..." />}
+      <div className={styles.pcLayout}>
+        {claimVisit && (
           <ClaimVisitDetails
             patientBillDetails={patientBill}
             claimsVisit={claimVisit}
             locationUuid={locationUuid}
             onBillDetailsChange={onBillDetailsChange}
             claimRefreshing={isValidating}
+            billingDate={billingDate}
           />
-        )
-      }
-
-    </div>
-  </>
+        )}
+      </div>
+    </>
+  );
 };
-export default PatientClaimDetails;
+export default PatientClaimDetails;

package/src/billing/dashboard/v3/patient-bill-details/patient-bill-details.tsx

@@ -139,7 +139,7 @@ const PatientBillDetails: React.FC<patientBillDetailsProps> = ({ patientUuid, lo
         return s.paid_status === 'POSTED';
       });
       if (hasPostedBill) {
-        return 'PARTIALLY PAID'
+        return 'PARTIALLY PAID';
       }
       const hasPendingBill = patientBillDetails.some((s) => {
         return s.paid_status === 'PENDING';
@@ -208,13 +208,13 @@ const PatientBillDetails: React.FC<patientBillDetailsProps> = ({ patientUuid, lo
     return {
       patientUuid: patientUuid,
       visitDate: billingDate,
-      locationUuid: locationUuid
+      locationUuid: locationUuid,
     };
   }
   function getPatientAmrsMaternityDiagnosisPayload(): AmrsMaternityDiagnosisDto {
     return {
       patientUuid: patientUuid,
-      billingDate: billingDate
+      billingDate: billingDate,
     };
   }
   function onLoadingClaimVisit(claimVisit: ClaimsVisit) {
@@ -324,6 +324,7 @@ const PatientBillDetails: React.FC<patientBillDetailsProps> = ({ patientUuid, lo
                       patientBillDetails={patientBillDetails}
                       consentToken={consentToken}
                       onBillDetailsChange={getPatientBillDetails}
+                      billingDate={billingDate}
                       onLoadingClaimVisit={onLoadingClaimVisit}
                     />
                   </>
@@ -339,4 +340,4 @@ const PatientBillDetails: React.FC<patientBillDetailsProps> = ({ patientUuid, lo
   );
 };
 
-export default PatientBillDetails;
+export default PatientBillDetails;

package/src/dashboard/dashboard.component.tsx

@@ -3,12 +3,11 @@ import { Analytics } from '@carbon/react/icons';
 
 import styles from './dashboard.component.scss';
 import Overview from './overview/overview.component';
-import { getServiceQueueByLocationUuid } from '../service-queues/service-queues.resource';
 import { type QueueEntryResult } from '../registry/types';
 import { useSession } from '@openmrs/esm-framework';
-import { QUEUE_SERVICE_UUIDS } from '../shared/constants/concepts';
 import { getDashBoardSummary } from '../resources/dashboard.resource';
 import FacilityAndWorkerSlot from '../shared/ui/facility-worker-slot/facility-worker.component-slot.component';
+import { usePendingReferrals } from '../emt/emt.resource';
 
 interface DashboardProps {}
 
@@ -18,6 +17,7 @@ const Dashboard: React.FC<DashboardProps> = () => {
   const [dashboardSummary, setDashboardSummary] = useState<any[]>([]);
   const session = useSession();
   const locationUuid = session.sessionLocation.uuid;
+  const { count: emtCount } = usePendingReferrals(1, 0);
   useEffect(() => {
     getDashBoardData();
   }, []);
@@ -45,6 +45,7 @@ const Dashboard: React.FC<DashboardProps> = () => {
         triageCount={triageQueueEntries}
         consultationCount={consultationQueueEntries}
         dashboardSummary={dashboardSummary}
+        emtCount={emtCount}
       />
     </div>
   );

package/src/dashboard/overview/overview.component.tsx

@@ -16,9 +16,10 @@ interface OverviewProps {
   triageCount?: QueueEntryResult[];
   consultationCount?: QueueEntryResult[];
   dashboardSummary?: any;
+  emtCount?: number;
 }
 
-const Overview: React.FC<OverviewProps> = ({ triageCount, consultationCount, dashboardSummary }) => {
+const Overview: React.FC<OverviewProps> = ({ triageCount, consultationCount, dashboardSummary, emtCount }) => {
   const totalPatients: QueueEntryResult[] = [...triageCount, ...consultationCount];
   const patientsInQueue = totalPatients.filter(
     (patient) => patient.status === 'WAITING' || patient.status === 'IN SERVICE',
@@ -72,6 +73,7 @@ const Overview: React.FC<OverviewProps> = ({ triageCount, consultationCount, das
     { key: 'labs', title: 'Labs', unit: 'Orders', value: dashboardSummary?.labs ?? 0 },
     { key: 'pharmacy', title: 'Pharmacy', unit: 'Orders', value: dashboardSummary?.pharmacy ?? 0 },
     { key: 'emergencies', title: 'Emergencies', unit: 'Patients', value: dashboardSummary?.emergencies ?? 0 },
+    { key: 'emt', title: 'EMT Referrals', unit: 'Pending', value: emtCount ?? 0 },
     {
       key: 'waiting',
       title: 'Avg. Waiting Time',

package/src/dashboard-meta/emt-dashboard.meta.ts

@@ -0,0 +1,6 @@
+export const emtDashboardMeta = {
+  path: 'emt',
+  slot: 'emt-queue-dashboard-slot',
+  title: 'EMT / Referral',
+  basePath: `${window.spaBase}/home`,
+};

package/src/emt/cr-lookup.resource.test.ts

@@ -0,0 +1,88 @@
+/**
+ * Tests for the CR-by-crId lookup helper and clientDisplayName utility.
+ */
+jest.mock('../registry/registry.resource', () => ({
+  fetchClientRegistryData: jest.fn(),
+}));
+
+import { fetchClientRegistryData } from '../registry/registry.resource';
+import { fetchClientByCrId, clientDisplayName } from './cr-lookup.resource';
+
+const mockFetchClientRegistryData = jest.mocked(fetchClientRegistryData);
+
+beforeEach(() => {
+  jest.resetAllMocks();
+});
+
+describe('fetchClientByCrId', () => {
+  it('searches the client registry by CR id and returns the first match', async () => {
+    const client = {
+      id: 'CR5617849204955-8',
+      first_name: 'Jane',
+      middle_name: '',
+      last_name: 'Doe',
+      gender: 'F',
+      date_of_birth: '1990-01-15',
+      identification_type: 'id',
+      identification_number: 'CR5617849204955-8',
+    };
+    mockFetchClientRegistryData.mockResolvedValueOnce([client]);
+
+    const result = await fetchClientByCrId('CR5617849204955-8', 'loc-uuid-1');
+
+    expect(mockFetchClientRegistryData).toHaveBeenCalledWith({
+      identificationNumber: 'CR5617849204955-8',
+      identificationType: 'CR id',
+      locationUuid: 'loc-uuid-1',
+    });
+    expect(result?.first_name).toBe('Jane');
+  });
+
+  it('returns null when the search finds no matching client', async () => {
+    mockFetchClientRegistryData.mockResolvedValueOnce([]);
+    const result = await fetchClientByCrId('CR-MISSING', 'loc-uuid-1');
+    expect(result).toBeNull();
+  });
+
+  it('returns null when the search fails (graceful degradation)', async () => {
+    mockFetchClientRegistryData.mockRejectedValueOnce(new Error('Request failed with 404: Not found'));
+    const result = await fetchClientByCrId('CR-MISSING', 'loc-uuid-1');
+    expect(result).toBeNull();
+  });
+
+  it('returns null for an empty cr_id without searching', async () => {
+    const result = await fetchClientByCrId('', 'loc-uuid-1');
+    expect(result).toBeNull();
+    expect(mockFetchClientRegistryData).not.toHaveBeenCalled();
+  });
+
+  it('returns null for a missing location uuid without searching', async () => {
+    const result = await fetchClientByCrId('CR5617849204955-8', '');
+    expect(result).toBeNull();
+    expect(mockFetchClientRegistryData).not.toHaveBeenCalled();
+  });
+});
+
+describe('clientDisplayName', () => {
+  it('joins first, middle, last names', () => {
+    const client = {
+      first_name: 'Jane',
+      middle_name: 'Akinyi',
+      last_name: 'Doe',
+    } as any;
+    expect(clientDisplayName(client, 'CR123')).toBe('Jane Akinyi Doe');
+  });
+
+  it('skips missing name parts', () => {
+    const client = {
+      first_name: 'Jane',
+      middle_name: '',
+      last_name: 'Doe',
+    } as any;
+    expect(clientDisplayName(client, 'CR123')).toBe('Jane Doe');
+  });
+
+  it('falls back to cr_id when client is null', () => {
+    expect(clientDisplayName(null, 'CR123')).toBe('CR123');
+  });
+});

package/src/emt/cr-lookup.resource.ts

@@ -0,0 +1,42 @@
+import { fetchClientRegistryData } from '../registry/registry.resource';
+import { HieIdentificationType, type HieClient } from '../registry/types';
+
+/**
+ * Client Registry lookup for an EMT referral.
+ *
+ * The referral only carries a `cr_id` (the CR record's id). We fetch the full
+ * CR record so the queue can show a human-readable patient (name, sex, DOB,
+ * national ID, …) instead of a bare identifier.
+ *
+ * The CR is only queryable through its search endpoint, so we reuse the
+ * established `fetchClientRegistryData` search with
+ * `identificationType: CR_SEARCH_IDENTIFICATION_TYPE` ('CR id'). The search
+ * returns an array; a CR id is unique, so the first entry is the record we want.
+ *
+ * Lookups are done lazily per-row (on expand / on render of a small page) so a
+ * single failed or slow CR fetch never blocks the whole queue.
+ */
+export async function fetchClientByCrId(crId: string, locationUuid: string): Promise<HieClient | null> {
+  if (!crId || !locationUuid) return null;
+  try {
+    const result = await fetchClientRegistryData({
+      identificationNumber: crId,
+      identificationType: HieIdentificationType.Cr,
+      locationUuid,
+    });
+    return Array.isArray(result) && result.length > 0 ? (result[0] as HieClient) : null;
+  } catch {
+    // Graceful degradation: a missing CR record must not break the queue row.
+    // Callers surface "patient details unavailable" and keep the cr_id visible.
+    return null;
+  }
+}
+
+/** Display name from a CR record, falling back gracefully. */
+export function clientDisplayName(client: HieClient | null | undefined, crId: string): string {
+  if (!client) return crId;
+  return [client.first_name, client.middle_name, client.last_name]
+    .filter(Boolean)
+    .join(' ')
+    .trim() || crId;
+}