@ampath/esm-reports-app 1.0.0-next.41 → 1.0.0-next.42

package/src/resources/moh-706.resource.ts

@@ -1,5 +1,12 @@
 import { openmrsFetch } from '@openmrs/esm-framework';
-import { getEtlBaseUrl } from '../utils/get-base-url';
+import { buildEtlUrl } from '../utils/get-base-url';
+import {
+  PAGE_SIZE,
+  pageParams,
+  toPatientListPage,
+  type PatientListPage,
+  type PatientListParams,
+} from './patient-list-page';
 
 interface Moh706Params {
   locationUuids: string;
@@ -11,30 +18,18 @@ interface Moh706Response {
   result: Array<Record<string, unknown>>;
 }
 
-interface Moh706PatientListParams {
-  locationUuids: string;
-  startDate?: string;
-  endDate?: string;
-  indicators: string;
-}
-
 interface Moh706PatientListResponse {
   result: Array<Record<string, unknown>>;
 }
 
 export async function getMoh706(params: Moh706Params): Promise<Array<Record<string, unknown>>> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/lab-706`;
-  const queryparams = {
+  const url = await buildEtlUrl('lab-706', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -53,20 +48,16 @@ export async function getMoh706(params: Moh706Params): Promise<Array<Record<stri
   }
 }
 
-export async function getMoh706PatientList(params: Moh706PatientListParams): Promise<Array<Record<string, unknown>>> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/lab-706/patient-list`;
-  const queryparams = {
+export async function getMoh706PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('lab-706/patient-list', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
     indicators: params.indicators || '',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+    ...pageParams(params),
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -75,11 +66,7 @@ export async function getMoh706PatientList(params: Moh706PatientListParams): Pro
 
     const data = await response.json();
 
-    if (!Array.isArray(data.result)) {
-      throw new Error('Invalid MOH-706 patient list response format: missing result array.');
-    }
-
-    return data.result;
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
   } catch (error: any) {
     throw new Error(`An error occurred while fetching the MOH-706 patient list: ${error.message}`);
   }

package/src/resources/moh-710.resource.ts

@@ -1,5 +1,5 @@
 import { openmrsFetch } from '@openmrs/esm-framework';
-import { getEtlBaseUrl } from '../utils/get-base-url';
+import { buildEtlUrl } from '../utils/get-base-url';
 
 interface Moh710Params {
   locationUuids: string;
@@ -9,18 +9,13 @@ interface Moh710Params {
 }
 
 export async function getMoh710(params: Moh710Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-710`;
-  const queryparams = {
+  const url = await buildEtlUrl('moh-710', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -35,19 +30,14 @@ export async function getMoh710(params: Moh710Params): Promise<any> {
 }
 
 export async function getMoh710PatientList(params: Moh710Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-710-patient-list`;
-  const queryparams = {
+  const url = await buildEtlUrl('moh-710-patient-list', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
     indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();

package/src/resources/moh-711.resource.ts

@@ -1,5 +1,12 @@
 import { openmrsFetch } from '@openmrs/esm-framework';
-import { getEtlBaseUrl } from '../utils/get-base-url';
+import { buildEtlUrl } from '../utils/get-base-url';
+import {
+  PAGE_SIZE,
+  pageParams,
+  toPatientListPage,
+  type PatientListPage,
+  type PatientListParams,
+} from './patient-list-page';
 
 interface Moh711Params {
   locationUuids: string;
@@ -10,18 +17,13 @@ interface Moh711Params {
 }
 
 export async function getMoh711(params: Moh711Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-711`;
-  const queryparams = {
+  const url = await buildEtlUrl('moh-711', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -35,22 +37,17 @@ export async function getMoh711(params: Moh711Params): Promise<any> {
   }
 }
 
-export async function getMoh406PatientList(params: Moh711Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-406-patient-list`;
-  const queryparams = {
+export async function getMoh406PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('moh-406-patient-list', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
     indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
     reportName: params.reportName || '',
-    limit: '300',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+    ...pageParams(params),
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -58,28 +55,24 @@ export async function getMoh406PatientList(params: Moh711Params): Promise<any> {
     }
 
     const data = await response.json();
-    return data;
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
   } catch (error: any) {
     throw new Error(`An error occurred while fetching the MOH-705 patient list: ${error.message}`);
   }
 }
 
-export async function getMoh405PatientList(params: Moh711Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-405-patient-list`;
-  const queryparams = {
+export async function getMoh405PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('moh-405-patient-list', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
     indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
     reportName: params.reportName || '',
-    limit: '300',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+    ...pageParams(params),
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -87,28 +80,24 @@ export async function getMoh405PatientList(params: Moh711Params): Promise<any> {
     }
 
     const data = await response.json();
-    return data;
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
   } catch (error: any) {
     throw new Error(`An error occurred while fetching the MOH-705 patient list: ${error.message}`);
   }
 }
 
-export async function getMoh333PatientList(params: Moh711Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-333-patient-list`;
-  const queryparams = {
+export async function getMoh333PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('moh-333-patient-list', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
     indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
     reportName: params.reportName || '',
-    limit: '300',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+    ...pageParams(params),
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -116,27 +105,23 @@ export async function getMoh333PatientList(params: Moh711Params): Promise<any> {
     }
 
     const data = await response.json();
-    return data;
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
   } catch (error: any) {
     throw new Error(`An error occurred while fetching the MOH-705 patient list: ${error.message}`);
   }
 }
 
-export async function getMoh510PatientList(params: Moh711Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-510-patient-list`;
-  const queryparams = {
+export async function getMoh510PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('moh-510-patient-list', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
     indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
-    limit: '300',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+    ...pageParams(params),
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -144,28 +129,24 @@ export async function getMoh510PatientList(params: Moh711Params): Promise<any> {
     }
 
     const data = await response.json();
-    return data;
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
   } catch (error: any) {
     throw new Error(`An error occurred while fetching the MOH-705 patient list: ${error.message}`);
   }
 }
 
-export async function getMoh511PatientList(params: Moh711Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-511-patient-list`;
-  const queryparams = {
+export async function getMoh511PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('moh-511-patient-list', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
     indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
     reportName: params.reportName || '',
-    limit: '300',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+    ...pageParams(params),
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -173,7 +154,8 @@ export async function getMoh511PatientList(params: Moh711Params): Promise<any> {
     }
 
     const data = await response.json();
-    return data;
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
   } catch (error: any) {
     throw new Error(`An error occurred while fetching the MOH-705 patient list: ${error.message}`);
   }

package/src/resources/moh-717.resource.ts

@@ -1,5 +1,5 @@
 import { openmrsFetch } from '@openmrs/esm-framework';
-import { getEtlBaseUrl } from '../utils/get-base-url';
+import { buildEtlUrl } from '../utils/get-base-url';
 
 interface Moh717Params {
   locationUuids: string;
@@ -8,19 +8,14 @@ interface Moh717Params {
 }
 
 export async function getMoh717(params: Moh717Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-717`;
-  const queryparams = {
+  const url = await buildEtlUrl('moh-717', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+  });
 
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -35,19 +30,14 @@ export async function getMoh717(params: Moh717Params): Promise<any> {
 }
 
 export async function getNutritionRegister(params: Moh717Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-717`;
-  const queryparams = {
+  const url = await buildEtlUrl('moh-717', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+  });
 
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();

package/src/resources/moh-731.resource.ts

@@ -1,5 +1,12 @@
 import { openmrsFetch } from '@openmrs/esm-framework';
-import { getEtlBaseUrl } from '../utils/get-base-url';
+import { buildEtlUrl } from '../utils/get-base-url';
+import {
+  PAGE_SIZE,
+  pageParams,
+  toPatientListPage,
+  type PatientListPage,
+  type PatientListParams,
+} from './patient-list-page';
 
 interface Moh745Params {
   locationUuids: string;
@@ -10,18 +17,13 @@ interface Moh745Params {
 }
 
 export async function getMoh731(params: Moh745Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-731-monthly-summary`;
-  const queryparams = {
+  const url = await buildEtlUrl('moh-731-monthly-summary', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -31,26 +33,21 @@ export async function getMoh731(params: Moh745Params): Promise<any> {
     const data = await response.json();
     return data;
   } catch (error: any) {
-    throw new Error(`An error occurred while fetching the MOH-710 report: ${error.message}`);
+    throw new Error(`An error occurred while fetching the MOH-731 report: ${error.message}`);
   }
 }
 
-export async function getMoh366PatientList(params: Moh745Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-731-monthly-summary-patient-list`;
-  const queryparams = {
+export async function getMoh366PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('moh-731-monthly-summary-patient-list', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
     indicator: params.indicator || '',
     gender: params.gender || '',
-    limit: '300',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+    ...pageParams(params),
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -58,29 +55,25 @@ export async function getMoh366PatientList(params: Moh745Params): Promise<any> {
     }
 
     const data = await response.json();
-    return data;
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
   } catch (error: any) {
     console.error('Failed to fetch MOH 412 PATIENT LIST data', error);
     throw new Error(`An error occurred while fetching the MOH-705 patient list: ${error.message}`);
   }
 }
 
-export async function getPrepPatientList(params: Moh745Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/prep-patient-list`;
-  const queryparams = {
+export async function getPrepPatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('prep-patient-list', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
     indicator: params.indicator || '',
     gender: params.gender || '',
-    limit: '300',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+    ...pageParams(params),
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -88,7 +81,8 @@ export async function getPrepPatientList(params: Moh745Params): Promise<any> {
     }
 
     const data = await response.json();
-    return data;
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
   } catch (error: any) {
     console.error('Failed to fetch MOH 412 PATIENT LIST data', error);
     throw new Error(`An error occurred while fetching the MOH-705 patient list: ${error.message}`);

package/src/resources/moh-745.resource.ts

@@ -1,5 +1,12 @@
 import { openmrsFetch } from '@openmrs/esm-framework';
-import { getEtlBaseUrl } from '../utils/get-base-url';
+import { buildEtlUrl } from '../utils/get-base-url';
+import {
+  PAGE_SIZE,
+  pageParams,
+  toPatientListPage,
+  type PatientListPage,
+  type PatientListParams,
+} from './patient-list-page';
 
 interface Moh745Params {
   locationUuids: string;
@@ -9,18 +16,13 @@ interface Moh745Params {
 }
 
 export async function getMoh745(params: Moh745Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-745`;
-  const queryparams = {
+  const url = await buildEtlUrl('moh-745', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -34,21 +36,16 @@ export async function getMoh745(params: Moh745Params): Promise<any> {
   }
 }
 
-export async function getMoh412PatientList(params: Moh745Params): Promise<any> {
-  const etlBaseUrl = await getEtlBaseUrl();
-  const url = `${etlBaseUrl}/moh-412-patient-list`;
-  const queryparams = {
+export async function getMoh412PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('moh-412-patient-list', {
     locationUuids: params.locationUuids || '',
     startDate: params.startDate || '',
     endDate: params.endDate || '',
     indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
-    limit: '300',
-  };
-  const queryString = new URLSearchParams(
-    Object.fromEntries(Object.entries(queryparams).filter(([_, v]) => v !== undefined && v !== null)),
-  ).toString();
+    ...pageParams(params),
+  });
   try {
-    const response = await openmrsFetch(`${url}?${queryString}`);
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();
@@ -56,7 +53,8 @@ export async function getMoh412PatientList(params: Moh745Params): Promise<any> {
     }
 
     const data = await response.json();
-    return data;
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
   } catch (error: any) {
     console.error('Failed to fetch MOH 412 PATIENT LIST data', error);
     throw new Error(`An error occurred while fetching the MOH-705 patient list: ${error.message}`);

package/src/resources/patient-list-page.ts

@@ -0,0 +1,66 @@
+/** How many rows a register asks for at a time */
+export const PAGE_SIZE = 50;
+
+export interface PatientListParams {
+  locationUuids: string;
+  startDate?: string;
+  endDate?: string;
+  indicator?: string;
+  indicators?: string;
+  gender?: string;
+  /** MOH-711 endpoints scope the list by report */
+  reportName?: string;
+  /** Row to start at, 0-based, as the ETL expects */
+  startIndex?: number;
+  limit?: number;
+}
+
+export interface PatientListPage {
+  results: Array<Record<string, any>>;
+  /** Rows across every page */
+  total: number;
+  /** `false` when the total had to be inferred rather than read from the response */
+  isTotalExact: boolean;
+}
+
+/** The paging arguments every patient-list endpoint takes */
+export function pageParams(params: PatientListParams) {
+  return {
+    startIndex: String(params.startIndex ?? 0),
+    limit: String(params.limit ?? PAGE_SIZE),
+  };
+}
+
+/**
+ * Normalises a patient-list response into a page of rows plus a total.
+ *
+ * The endpoints nest their payload differently and do not all report a count,
+ * so the total is read from whichever field carries it and inferred otherwise:
+ * a short page means we are on the last one, a full page means there is at
+ * least one more. Inferring keeps the pager usable without ever overstating
+ * what we know -- `isTotalExact` says which it is.
+ */
+export function toPatientListPage(data: any, startIndex: number, limit: number): PatientListPage {
+  const container = data?.results ?? data ?? {};
+  const results: Array<Record<string, any>> = Array.isArray(container?.results)
+    ? container.results
+    : Array.isArray(container)
+      ? container
+      : [];
+
+  const reported = [container?.total, container?.totalCount, container?.count, data?.total, data?.totalCount].find(
+    (value) => typeof value === 'number',
+  );
+
+  if (typeof reported === 'number') {
+    return { results, total: reported, isTotalExact: true };
+  }
+
+  const isLastPage = results.length < limit;
+
+  return {
+    results,
+    total: isLastPage ? startIndex + results.length : startIndex + results.length + 1,
+    isTotalExact: isLastPage,
+  };
+}