@ampath/esm-reports-app 1.0.0-next.8 → 1.0.0-next.81

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

@@ -1,25 +1,25 @@
 import { openmrsFetch } from '@openmrs/esm-framework';
-import { getEtlBaseUrl } from '../utils/get-base-url';
+import { buildEtlUrl } from '../utils/get-base-url';
+import { PAGE_SIZE, toPatientListPage, pageParams, type PatientListParams } from './patient-list-page';
 
 interface Moh710Params {
   locationUuids: string;
   startDate?: string;
   endDate?: string;
+  indicator?: string | string[];
+  startIndex?: number;
+  limit?: number;
+  reportName?: string;
 }
 
 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();
@@ -32,3 +32,54 @@ export async function getMoh710(params: Moh710Params): Promise<any> {
     throw new Error(`An error occurred while fetching the MOH-710 report: ${error.message}`);
   }
 }
+
+export async function getMoh510PatientList(params: PatientListParams): Promise<any> {
+  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 || '',
+    reportName: params.reportName || 'moh710Report',
+    ...pageParams(params),
+  });
+
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch dashboard summary: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
+  } catch (error: any) {
+    throw new Error(`An error occurred while fetching the MOH-510 REgister: ${error.message}`);
+  }
+}
+
+export async function getMoh413PatientList(params: PatientListParams): Promise<any> {
+  const url = await buildEtlUrl('moh-413-patient-list', {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+    indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
+    reportName: params.reportName || 'moh710Report',
+    ...pageParams(params),
+  });
+
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch  moh-413: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
+  } catch (error: any) {
+    throw new Error(`An error occurred while fetching the MOH-413 Register: ${error.message}`);
+  }
+}

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

@@ -1,25 +1,29 @@
 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;
   startDate?: string;
   endDate?: string;
+  indicator?: string | string[];
+  reportName?: string;
 }
 
 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();
@@ -32,3 +36,196 @@ export async function getMoh711(params: Moh711Params): Promise<any> {
     throw new Error(`An error occurred while fetching the MOH-711 report: ${error.message}`);
   }
 }
+
+export async function getMoh406PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const endPoint = (() => {
+    if (params.from && params.from?.toLowerCase() === 'moh-717') {
+      return 'moh-717-patient-list';
+    }
+    return 'moh-406-patient-list';
+  })();
+  const url = await buildEtlUrl(endPoint, {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+    indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
+    reportName: params.reportName || '',
+    ...pageParams(params),
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch patient list: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    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: PatientListParams): Promise<PatientListPage> {
+  const endPoint = (() => {
+    if (params.from && params.from?.toLowerCase() === 'moh-717') {
+      return 'moh-717-patient-list';
+    }
+    return 'moh-405-patient-list';
+  })();
+  const url = await buildEtlUrl(endPoint, {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+    indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
+    reportName: params.reportName || '',
+    ...pageParams(params),
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch patient list: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    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: PatientListParams): Promise<PatientListPage> {
+  const endPoint = (() => {
+    if (params.from && params.from?.toLowerCase() === 'moh-717') {
+      return 'moh-717-patient-list';
+    }
+    return 'moh-333-patient-list';
+  })();
+  const url = await buildEtlUrl(endPoint, {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+    indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
+    reportName: params.reportName || '',
+    ...pageParams(params),
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch patient list: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    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: 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 || '',
+    ...pageParams(params),
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch patient list: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    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 getTBPatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('tb-patient-list', {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+    indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
+    reportName: params.reportName || 'moh711Report',
+    ...pageParams(params),
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch patient list: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    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 getMoh512PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('moh-512-patient-list', {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+    indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
+    reportName: params.reportName || 'moh711Report',
+    ...pageParams(params),
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch patient list: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
+  } catch (error: any) {
+    throw new Error(`An error occurred while fetching the MOH-512 patient list: ${error.message}`);
+  }
+}
+
+export async function getMoh407PatientList(params: PatientListParams): Promise<PatientListPage> {
+  const url = await buildEtlUrl('moh-407-patient-list', {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+    indicator: Array.isArray(params.indicator) ? params.indicator.join(',') : params.indicator || '',
+    reportName: params.reportName || 'moh711Report',
+    ...pageParams(params),
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch patient list: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    return toPatientListPage(data, params.startIndex ?? 0, params.limit ?? PAGE_SIZE);
+  } catch (error: any) {
+    throw new Error(`An error occurred while fetching the MOH-407 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,36 @@ 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();
+      throw new Error(`Failed to fetch dashboard summary: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+    return data;
+  } catch (error: any) {
+    throw new Error(`An error occurred while fetching the MOH-717 report: ${error.message}`);
+  }
+}
+
+export async function getNutritionRegister(params: Moh717Params): Promise<any> {
+  const url = await buildEtlUrl('moh-717', {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+  });
+
+  try {
+    const response = await openmrsFetch(url);
 
     if (!response.ok) {
       const errorText = await response.text();

package/src/resources/moh-729b.resource.ts

@@ -0,0 +1,25 @@
+import { openmrsFetch } from '@openmrs/esm-framework';
+import { buildEtlUrl } from '../utils/get-base-url';
+
+interface Moh729bParams {
+  locationUuids: string;
+  endDate: string;
+}
+
+/**
+ * MOH 729B F-MAPS: one row per client active on ART in the month ending on
+ * `endDate`, for the whole facility of the location, with the form's regimen
+ * code. The form counts these rows and its linelists list them.
+ */
+export async function getMoh729b(params: Moh729bParams): Promise<Array<Record<string, unknown>>> {
+  const url = await buildEtlUrl('moh-729b', {
+    locationUuids: params.locationUuids,
+    endDate: params.endDate,
+  });
+  const response = await openmrsFetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch MOH 729B: ${response.status} - ${await response.text()}`);
+  }
+  const data = await response.json();
+  return Array.isArray(data) ? data : [];
+}

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

@@ -0,0 +1,90 @@
+import { openmrsFetch } from '@openmrs/esm-framework';
+import { buildEtlUrl } from '../utils/get-base-url';
+import {
+  PAGE_SIZE,
+  pageParams,
+  toPatientListPage,
+  type PatientListPage,
+  type PatientListParams,
+} from './patient-list-page';
+
+interface Moh745Params {
+  locationUuids: string;
+  startDate?: string;
+  endDate?: string;
+  indicator?: string;
+  gender?: string;
+}
+
+export async function getMoh731(params: Moh745Params): Promise<any> {
+  const url = await buildEtlUrl('moh-731-monthly-summary', {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch dashboard summary: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+    return data;
+  } catch (error: any) {
+    throw new Error(`An error occurred while fetching the MOH-731 report: ${error.message}`);
+  }
+}
+
+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 || '',
+    ...pageParams(params),
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch patient list: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    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: 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 || '',
+    ...pageParams(params),
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch patient list: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    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

@@ -0,0 +1,76 @@
+import { openmrsFetch } from '@openmrs/esm-framework';
+import { buildEtlUrl } from '../utils/get-base-url';
+import {
+  PAGE_SIZE,
+  pageParams,
+  toPatientListPage,
+  type PatientListPage,
+  type PatientListParams,
+} from './patient-list-page';
+import {type  Moh745reponse, type CancerScreeningResult } from '../reports/moh-745/registers/type';
+
+interface Moh745Params {
+  locationUuids: string;
+  startDate?: string;
+  endDate?: string;
+  indicator?: string | string[];
+}
+
+export async function getMoh745(params: Moh745Params): Promise<CancerScreeningResult> {
+  const url = await buildEtlUrl('moh-745', {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    const data = await response.json() as Moh745reponse;
+    return data?.result[0] ?? null;
+  } catch (error: any) {
+    throw new Error(`An error occurred while fetching the MOH-710 report: ${error.message}`);
+  }
+}
+
+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 || '',
+    ...pageParams(params),
+  });
+  try {
+    const response = await openmrsFetch(url);
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Failed to fetch patient list: ${response.status} - ${errorText}`);
+    }
+
+    const data = await response.json();
+
+    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 fetchMoh745PatientList(params: PatientListParams): Promise<any[]> {
+  const url = await buildEtlUrl('moh-412-patient-list', {
+    locationUuids: params.locationUuids || '',
+    startDate: params.startDate || '',
+    endDate: params.endDate || '',
+    indicators: Array.isArray(params.indicators) ? params.indicators.join(',') : params.indicators || '',
+    limit:1000
+  });
+  try {
+    const response = await openmrsFetch(url);
+    const data = await response.json();
+    return data?.result ?? [];
+  } 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;
+  from?: string | null;
+}
+
+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,
+  };
+}

package/src/resources/presumptive-tb.resource.ts

@@ -0,0 +1,27 @@
+import { openmrsFetch } from '@openmrs/esm-framework';
+import { buildEtlUrl } from '../utils/get-base-url';
+
+interface PresumptiveTbParams {
+  locationUuids: string;
+  startDate: string;
+  endDate: string;
+}
+
+/**
+ * Presumptive TB Register (MOH/REG/DNTLDP/02): one row per TB encounter (331)
+ * in the period, for the whole facility of the location, in the register's
+ * columns (PresumptiveTbRow).
+ */
+export async function getPresumptiveTb(params: PresumptiveTbParams): Promise<Array<Record<string, unknown>>> {
+  const url = await buildEtlUrl('presumptive-tb-register', {
+    locationUuids: params.locationUuids,
+    startDate: params.startDate,
+    endDate: params.endDate,
+  });
+  const response = await openmrsFetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch the Presumptive TB register: ${response.status} - ${await response.text()}`);
+  }
+  const data = await response.json();
+  return Array.isArray(data) ? data : [];
+}