@kenyaemr/esm-ward-app 8.0.1-pre.99 → 8.0.3-pre.131

package/src/config-schema.ts

@@ -1,14 +1,5 @@
 import { type ConfigSchema, Type, validators } from '@openmrs/esm-framework';
 
-export const defaultWardPatientCard: WardPatientCardDefinition = {
-  id: 'default',
-  headerRowElements: ['patient-age', 'patient-address', 'patient-identifier'],
-  footerRowElements: [],
-  appliedTo: null,
-};
-
-export const builtInPatientCardElements = ['patient-age', 'time-on-ward', 'time-since-admission'];
-
 export const addressFields = [
   'cityVillage',
   'stateProvince',
@@ -37,11 +28,12 @@ export const addressFields = [
 type AddressField = keyof typeof addressFields;
 
 export const configSchema: ConfigSchema = {
-  wardPatientCards: {
-    _description: 'Configure the display of ward patient cards',
-    obsElementDefinitions: {
+  patientCardElements: {
+    _description:
+      'Configuration of various patient card elements. Each configured element must have a unique id, defined in the ward React component being used.',
+    obs: {
       _type: Type.Array,
-      _description: 'Defines obs display elements that can be included in the card header or footer.',
+      _description: 'Configures obs values to display.',
       _default: [],
       _elements: {
         id: {
@@ -58,12 +50,6 @@ export const configSchema: ConfigSchema = {
             "Optional. The custom label or i18n key to the translated label to display. If not provided, defaults to the concept's name. (Note that this can be set to an empty string to not show a label)",
           _default: null,
         },
-        labelI18nModule: {
-          _type: Type.String,
-          _description:
-            'Optional. The custom module to use for translation of the label. If not provided, the label will not be translated.',
-          _default: null,
-        },
         orderBy: {
           _type: Type.String,
           _description:
@@ -85,12 +71,16 @@ export const configSchema: ConfigSchema = {
         },
       },
     },
-    identifierElementDefinitions: {
+    pendingItems: {
       _type: Type.Array,
-      _description: `Defines patient identifier elements that can be included in the card header or footer. The default element 'patient-identifier' displays the preferred identifier.`,
+      _description: 'Configures pending orders and transfers to display.',
       _default: [
         {
-          id: 'patient-identifier',
+          id: 'pending-items',
+          orders: {
+            orderTypes: [{ label: 'Labs', uuid: '52a447d3-a64a-11e3-9aeb-50e549534c5e' }],
+          },
+          showPendingItems: true,
         },
       ],
       _elements: {
@@ -98,28 +88,55 @@ export const configSchema: ConfigSchema = {
           _type: Type.String,
           _description: 'The unique identifier for this patient card element',
         },
-        identifierTypeUuid: {
-          _type: Type.UUID,
-          _description:
-            'The UUID of the identifier type to display. If not provided, defaults to the preferred identifier.',
-          _default: null,
+        orders: {
+          orderTypes: {
+            _type: Type.Array,
+            _description: 'Configures pending orders and transfers to display.',
+            _elements: {
+              uuid: {
+                _type: Type.UUID,
+                _description: 'Identifies the order type.',
+              },
+              label: {
+                _type: Type.String,
+                _description:
+                  "The label or i18n key to the translated label to display. If not provided, defaults to 'Orders'",
+                _default: null,
+              },
+            },
+          },
         },
-        label: {
-          _type: Type.String,
+        showPendingItems: {
+          _type: Type.Boolean,
           _description:
-            'the custom label or i18n key to the translated label to display for patient identifier. If not provided, defaults to the patient-identifier name.',
-          _default: null,
+            'Optional. If true, pending items (e.g., number of pending orders) will be displayed on the patient card.',
+        },
+      },
+    },
+    patientIdentifier: {
+      _type: Type.Array,
+      _description: `Configures patient identifier to display. An unconfigured element displays the preferred identifier.`,
+      _default: [
+        {
+          id: 'patient-identifier',
+          showIdentifierLabel: false,
         },
-        labelI18nModule: {
+      ],
+      _elements: {
+        id: {
           _type: Type.String,
-          _description: 'Optional. The custom module to use for translation of the label',
-          _default: null,
+          _description: 'The unique identifier for this patient card element',
+        },
+        showIdentifierLabel: {
+          _type: Type.Boolean,
+          _description:
+            'If true, the identifier type (eg: "OpenMRS ID") is shown along with the identifier itself. Defaults to false',
         },
       },
     },
-    addressElementDefinitions: {
+    patientAddress: {
       _type: Type.Array,
-      _description: 'Defines patient address elements that can be included in the card header or footer.',
+      _description: 'Configures patient address elements.',
       _default: [
         {
           id: 'patient-address',
@@ -143,90 +160,151 @@ export const configSchema: ConfigSchema = {
         },
       },
     },
-    cardDefinitions: {
+    admissionRequestNote: {
       _type: Type.Array,
-      _default: [defaultWardPatientCard],
-      _description: `An array of card configuration. A card configuration can be applied to different ward locations.
-         If multiple card configurations apply to a location, only the first one is chosen.`,
+      _description: 'Configures admission request notes to display.',
+      _default: [
+        {
+          id: 'admission-request-note',
+          conceptUuid: '161011AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+        },
+      ],
       _elements: {
-        id: {
-          _type: Type.String,
-          _description:
-            'The unique identifier for this card definition. This is used to set the name of the extension slot the card has, where the rows go. The slot name is "ward-patient-card-<id>", unless the id is "default", in which case the slot name is "ward-patient-card".',
-          _default: 'default',
-        },
-        headerRowElements: {
-          _type: Type.Array,
-          _description: `IDs of patient card elements to appear in the header row. These can be built-in, or custom ones can be defined in patientCardElementDefinitions. Built-in elements are: '${builtInPatientCardElements.join(
-            "', '",
-          )}'.`,
-          _elements: {
+        fields: {
+          id: {
             _type: Type.String,
+            _description: 'The unique identifier for this patient card element',
+          },
+          conceptUuid: {
+            _type: Type.UUID,
+            _description: 'Required. Identifies the concept for the admission request note.',
           },
         },
-        footerRowElements: {
-          _type: Type.Array,
-          _description: `IDs of patient card elements to appear in the footer row. These can be built-in, or custom ones can be defined in patientCardElementDefinitions. Built-in elements are: '${builtInPatientCardElements.join(
-            "', '",
-          )}'.`,
-          _elements: {
+      },
+      coloredObsTags: {
+        _type: Type.Array,
+        _description: 'Configures observation values to display as Carbon tags.',
+        _elements: {
+          conceptUuid: {
+            _type: Type.UUID,
+            _description: 'Required. Identifies the concept to use to identify the desired observations.',
+            // Problem list
+            _default: '1284AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+          },
+          summaryLabel: {
             _type: Type.String,
+            _description: `Optional. The custom label or i18n key to the translated label to display for the summary tag. The summary tag shows the count of the number of answers that are present but not configured to show as their own tags. If not provided, defaults to the name of the concept.`,
+            _default: null,
           },
-        },
-        appliedTo: {
-          _type: Type.Array,
-          _description:
-            'Conditions under which this card definition should be used. If not provided, the configuration is applied to all wards.',
-          _elements: {
-            location: {
-              _type: Type.UUID,
-              _description: 'The UUID of the location. If not provided, applies to all wards.',
-              _default: null,
+          summaryLabelI18nModule: {
+            _type: Type.String,
+            _description: 'Optional. The custom module to use for translation of the summary label',
+            _default: null,
+          },
+          summaryLabelColor: {
+            _type: Type.String,
+            _description:
+              'The color of the summary tag. See https://react.carbondesignsystem.com/?path=/docs/components-tag--overview for a list of supported colors',
+            _default: null,
+          },
+          tags: {
+            _type: Type.Array,
+            _description: `An array specifying concept sets and color. Observations with coded values that are members of the specified concept sets will be displayed as their own tags with the specified color. Any observation with coded values not belonging to any concept sets specified will be summarized as a count in the summary tag. If a concept set is listed multiple times, the first matching applied-to rule takes precedence.`,
+            _default: [],
+            _elements: {
+              color: {
+                _type: Type.String,
+                _description:
+                  'Color of the tag. See https://react.carbondesignsystem.com/?path=/docs/components-tag--overview for a list of supported colors.',
+              },
+              appliedToConceptSets: {
+                _type: Type.Array,
+                _description: `The concept sets which the color applies to. Observations with coded values that are members of the specified concept sets will be displayed as their own tag with the specified color. If an observation's coded value belongs to multiple concept sets, the first matching applied-to rule takes precedence.`,
+                _elements: {
+                  _type: Type.UUID,
+                },
+              },
             },
           },
         },
       },
     },
   },
+  wards: {
+    _description: 'Configuration of what type of ward to use at different ward locations.',
+    _type: Type.Array,
+    _default: [{ id: 'default-ward' }],
+    _elements: {
+      id: {
+        _type: Type.String,
+        _description:
+          'The ward type to use. Currently, "default-ward" and "maternal-ward" are supported. This string also serves as the extension slot name for the ward view.',
+      },
+      appliedTo: {
+        _type: Type.Array,
+        _description:
+          'Optional. Conditions under which this card definition should be used. If not provided, the configuration is applied to all wards.',
+        _elements: {
+          location: {
+            _type: Type.UUID,
+            _description: 'The UUID of the location. If not provided, applies to all wards.',
+            _default: null,
+          },
+        },
+      },
+    },
+  },
 };
 
 export interface WardConfigObject {
-  wardPatientCards: WardPatientCardsConfig;
+  patientCardElements: {
+    obs: Array<ObsElementConfig>;
+    pendingItems: Array<PendingItemsElementConfig>;
+    patientIdentifier: Array<IdentifierElementConfig>;
+    patientAddress: Array<PatientAddressElementConfig>;
+    coloredObsTags: Array<ColoredObsTagsElementConfig>;
+    admissionRequestNote: Array<AdmissionRequestNoteElementConfig>;
+  };
+  wards: Array<WardDefinition>;
 }
 
-export interface WardPatientCardsConfig {
-  obsElementDefinitions: Array<ObsElementDefinition>;
-  identifierElementDefinitions: Array<IdentifierElementDefinition>;
-  addressElementDefinitions: Array<AddressElementDefinition>;
-  cardDefinitions: Array<WardPatientCardDefinition>;
+export interface PendingItemsElementConfig {
+  id: string;
+  showPendingItems: boolean;
+  orders: {
+    orderTypes: Array<{
+      label?: string;
+      uuid: string;
+    }>;
+  };
 }
 
-export interface ObsElementDefinition {
+export interface ObsElementConfig {
   id: string;
   conceptUuid: string;
   onlyWithinCurrentVisit: boolean;
   orderBy: 'ascending' | 'descending';
   limit: number;
   label?: string;
-  labelI18nModule?: string;
 }
 
-export interface IdentifierElementDefinition {
+export interface IdentifierElementConfig {
   id: string;
-  identifierTypeUuid: string;
-  label?: string;
-  labelI18nModule?: string;
+  showIdentifierLabel: boolean;
 }
 
-export interface AddressElementDefinition {
+export interface PatientAddressElementConfig {
   id: string;
   fields: Array<AddressField>;
 }
 
-export interface WardPatientCardDefinition {
+export interface AdmissionRequestNoteElementConfig {
+  id: string;
+  conceptUuid: string;
+}
+
+export interface WardDefinition {
   id: string;
-  headerRowElements: Array<string>;
-  footerRowElements: Array<string>;
   appliedTo?: Array<{
     /**
      * locationUuid. If given, only applies to patients at the specified ward locations. (If not provided, applies to all locations)
@@ -234,3 +312,44 @@ export interface WardPatientCardDefinition {
     location: string;
   }>;
 }
+export interface ColoredObsTagsElementConfig {
+  /**
+   * Required. Identifies the concept to use to identify the desired observations.
+   */
+  conceptUuid: string;
+
+  /**
+   * Optional. The custom label or i18n key to the translated label to display for the summary tag. The summary tag
+   * shows the count of the number of answers that are present but not configured to show as their own tags. If not
+   * provided, defaults to the name of the concept.
+   */
+  summaryLabel?: string;
+
+  /**
+   * The color of the summary tag.
+   * See https://react.carbondesignsystem.com/?path=/docs/components-tag--overview for a list of supported colors
+   */
+  summaryLabelColor?: string;
+
+  /**
+   * An array specifying concept sets and color. Observations with coded values that are members of the specified concept sets
+   * will be displayed as their own tags with the specified color. Any observation with coded values not belonging to
+   * any concept sets specified will be summarized as a count in the summary tag. If a concept set is listed multiple times,
+   * the first matching applied-to rule takes precedence.
+   */
+  tags: Array<ColoredObsTagConfig>;
+}
+
+export interface ColoredObsTagConfig {
+  /**
+   * Color of the tag. See https://react.carbondesignsystem.com/?path=/docs/components-tag--overview for a list of supported colors.
+   */
+  color: string;
+
+  /**
+   * The concept sets which the color applies to. Observations with coded values that are members of the specified concept sets
+   * will be displayed as their own tag with the specified color.
+   * If an observation's coded value belongs to multiple concept sets, the first matching applied-to rule takes precedence.
+   */
+  appliedToConceptSets: Array<string>;
+}

package/src/constant.ts

@@ -1 +1 @@
-export const moduleName = '@openmrs/esm-ward-app';
+export const moduleName = '@kenyaemr/esm-ward-app';

package/src/hooks/useAdmissionLocation.ts

@@ -1,16 +1,34 @@
-import { type FetchResponse, openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import { type FetchResponse, openmrsFetch, restBaseUrl, useFeatureFlag } from '@openmrs/esm-framework';
+import useSWR from 'swr';
 import { type AdmissionLocationFetchResponse } from '../types/index';
-import useSWRImmutable from 'swr/immutable';
 import useWardLocation from './useWardLocation';
 
 const requestRep =
   'custom:(ward,totalBeds,occupiedBeds,bedLayouts:(rowNumber,columnNumber,bedNumber,bedId,bedUuid,status,location,patients:(person:full,identifiers,uuid)))';
 
-// note "admissionLocation" sn't the clearest name, but it matches the endpoint; endpoint fetches bed information (including info about patients in those beds) for a location (as provided by the bed management module)
+/**
+ *
+ * Fetches bed information (including info about patients in those beds) for a location,
+ * as provided by the bed management module. If the bed management module is not installed,
+ * then no request will be made, the return object's
+ * `isLoading` field will be false, and the `admissionLocation` field will be undefined.
+ *
+ * Note that "admissionLocation" isn't the clearest name, but it matches the endpoint name
+ *
+ * @param rep the "v=" representation parameter
+ * @returns
+ */
 export function useAdmissionLocation(rep: string = requestRep) {
   const { location } = useWardLocation();
+
+  const isBedManagementModuleInstalled = useFeatureFlag('bedmanagement-module');
+
   const apiUrl = location?.uuid ? `${restBaseUrl}/admissionLocation/${location?.uuid}?v=${rep}` : null;
-  const { data, ...rest } = useSWRImmutable<FetchResponse<AdmissionLocationFetchResponse>, Error>(apiUrl, openmrsFetch);
+  const { data, ...rest } = useSWR<FetchResponse<AdmissionLocationFetchResponse>, Error>(
+    isBedManagementModuleInstalled ? apiUrl : null,
+    openmrsFetch,
+  );
+
   return {
     admissionLocation: data?.data,
     ...rest,

package/src/hooks/useAssignedBedByPatient.ts

@@ -0,0 +1,9 @@
+import { openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import { type BedDetail } from '../types';
+import useSWR from 'swr';
+
+export function useAssignedBedByPatient(patientUuid: string) {
+  const url = `${restBaseUrl}/beds?patientUuid=${patientUuid}`;
+
+  return useSWR<{ data: { results: Array<BedDetail> } }, Error>(url, openmrsFetch);
+}

package/src/hooks/useBeds.ts

@@ -1,5 +1,4 @@
-import { openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
-import useSWR from 'swr';
+import { restBaseUrl, useOpenmrsFetchAll } from '@openmrs/esm-framework';
 import { type Bed, type BedStatus } from '../types/index';
 
 interface BedSearchCriteria {
@@ -17,10 +16,10 @@ export function useBeds(searchCriteria?: BedSearchCriteria) {
   }
 
   const apiUrl = `${restBaseUrl}/bed?${searchParam}`;
-  const { data, ...rest } = useSWR<{ data: { results: Array<Bed> } }, Error>(apiUrl, openmrsFetch);
+  const { data, ...rest } = useOpenmrsFetchAll<Bed>(apiUrl);
 
   return {
-    beds: data?.data?.results ?? [],
+    beds: data,
     ...rest,
   };
 }

package/src/hooks/useConcept.ts

@@ -1,11 +1,10 @@
-import { type Concept, openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
-import useSWRImmutable from 'swr/immutable';
+import { type Concept, restBaseUrl, useOpenmrsFetchAll } from '@openmrs/esm-framework';
 
 export function useConcepts(uuids: string[], rep = 'default') {
   const apiUrl = `${restBaseUrl}/concept?references=${uuids.join()}&v=${rep}`;
-  const { data, ...rest } = useSWRImmutable<{ data: { results: Array<Concept> } }, Error>(apiUrl, openmrsFetch);
+  const { data, ...rest } = useOpenmrsFetchAll<Concept>(apiUrl, { immutable: true });
   return {
-    concepts: data?.data?.results,
+    concepts: data,
     ...rest,
   };
 }

package/src/hooks/useEmrConfiguration.ts

@@ -12,7 +12,10 @@ interface EmrApiConfigurationResponse {
   clinicianEncounterRole: OpenmrsResource;
   consultFreeTextCommentsConcept: OpenmrsResource;
   visitNoteEncounterType: OpenmrsResource;
+  inpatientNoteEncounterType: OpenmrsResource;
+  transferRequestEncounterType: OpenmrsResource;
   transferWithinHospitalEncounterType: OpenmrsResource;
+  exitFromInpatientEncounterType: OpenmrsResource;
   supportsTransferLocationTag: LocationTag;
   supportsAdmissionLocationTag: LocationTag;
   supportsLoginLocationTag: LocationTag;
@@ -64,6 +67,8 @@ const customRepProps = [
   ['diagnosisSets', 'ref'],
   ['personImageDirectory', 'ref'],
   ['visitNoteEncounterType', 'ref'],
+  ['inpatientNoteEncounterType', 'ref'],
+  ['transferRequestEncounterType', 'ref'],
   ['consultEncounterType', 'ref'],
   ['diagnosisMetadata', 'ref'],
   ['narrowerThanConceptMapType', 'ref'],

package/src/hooks/useInpatientAdmission.ts

@@ -1,6 +1,5 @@
-import useSWR from 'swr';
-import { type FetchResponse, openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
-import { type InpatientAdmissionFetchResponse } from '../types';
+import { restBaseUrl, useOpenmrsFetchAll } from '@openmrs/esm-framework';
+import { type InpatientAdmission } from '../types';
 import useWardLocation from './useWardLocation';
 
 export function useInpatientAdmission() {
@@ -9,20 +8,16 @@ export function useInpatientAdmission() {
   // prettier-ignore
   const customRepresentation =
     'custom:(visit,' +
-      'patient:(uuid,identifiers,voided,' +
-        'person:(uuid,display,gender,age,birthdate,birthtime,preferredName,preferredAddress,dead,deathDate)),' + 
-      'encounterAssigningToCurrentInpatientLocation:(encounterDatetime),' +
-      'firstAdmissionOrTransferEncounter:(encounterDatetime),' +
+    'patient:(uuid,identifiers:(uuid,display,identifier,identifierType),voided,' +
+    'person:(uuid,display,gender,age,birthdate,birthtime,preferredName,preferredAddress,dead,deathDate)),' +
+    'encounterAssigningToCurrentInpatientLocation:(encounterDatetime),' +
+    'currentInpatientRequest:(dispositionLocation,dispositionType,disposition:(uuid,display),dispositionEncounter:(uuid,display),dispositionObsGroup:(uuid,display),visit:(uuid),patient:(uuid)),' +
+    'firstAdmissionOrTransferEncounter:(encounterDatetime),' +
     ')';
-  const { data, ...rest } = useSWR<FetchResponse<InpatientAdmissionFetchResponse>, Error>(
+
+  return useOpenmrsFetchAll<InpatientAdmission>(
     location
       ? `${restBaseUrl}/emrapi/inpatient/admission?currentInpatientLocation=${location.uuid}&v=${customRepresentation}`
       : null,
-    openmrsFetch,
   );
-
-  return {
-    inpatientAdmissions: data?.data?.results,
-    ...rest,
-  };
 }

package/src/hooks/useInpatientRequest.ts

@@ -1,8 +1,6 @@
-import { type FetchResponse, openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
-import type { DispositionType, InpatientRequestFetchResponse } from '../types';
-import useSWR from 'swr';
+import { restBaseUrl, useOpenmrsFetchAll } from '@openmrs/esm-framework';
+import type { DispositionType, InpatientRequest } from '../types';
 import useWardLocation from './useWardLocation';
-import { useMemo } from 'react';
 
 // prettier-ignore
 const defaultRep =
@@ -26,18 +24,9 @@ export function useInpatientRequest(
   searchParams.set('dispositionLocation', location?.uuid);
   searchParams.set('v', rep);
 
-  const { data, ...rest } = useSWR<FetchResponse<InpatientRequestFetchResponse>, Error>(
+  const { data, ...rest } = useOpenmrsFetchAll<InpatientRequest>(
     location?.uuid ? `${restBaseUrl}/emrapi/inpatient/request?${searchParams.toString()}` : null,
-    openmrsFetch,
   );
 
-  const results = useMemo(
-    () => ({
-      inpatientRequests: data?.data?.results,
-      ...rest,
-    }),
-    [data, rest],
-  );
-
-  return results;
+  return { inpatientRequests: data, ...rest };
 }

package/src/hooks/useLocations.ts

@@ -1,54 +1,11 @@
-import { type FetchResponse, fhirBaseUrl, openmrsFetch } from '@openmrs/esm-framework';
-import { useEffect, useMemo, useState } from 'react';
-import useSWRImmutable from 'swr/immutable';
+import { fhirBaseUrl, useFhirPagination } from '@openmrs/esm-framework';
 
-interface FhirLocation {
-  fullUrl: string;
-  resource: {
-    resourceType: 'Location';
-    id: string;
-    name: string;
-    description: string;
-  };
-}
-
-interface FhirResponse {
-  resourceType: 'Bundle';
-  id: '6a107c31-d760-4df0-bb70-89ad742225ca';
-  meta: {
-    lastUpdated: '2024-08-08T06:28:01.495+00:00';
-  };
-  type: 'searchset';
-  total: number;
-  link: Array<{
-    relation: 'self' | 'prev' | 'next';
-    url: string;
-  }>;
-  entry: Array<FhirLocation>;
-}
-
-export default function useLocations(filterCriteria: Array<Array<string>> = [], skip: boolean = false) {
-  const [totalLocations, setTotalLocations] = useState(0);
-  const [url, setUrl] = useState(`${fhirBaseUrl}/Location`);
+export default function useLocations(
+  filterCriteria: Array<Array<string>> = [],
+  pageSize: number,
+  skip: boolean = false,
+) {
   const searchParams = new URLSearchParams(filterCriteria);
-  const urlWithSearchParams = `${url}?${searchParams.toString()}`;
-  const { data, ...rest } = useSWRImmutable<FetchResponse<FhirResponse>>(
-    !skip ? urlWithSearchParams : null,
-    openmrsFetch,
-  );
-
-  useEffect(() => {
-    if (data?.data) {
-      setTotalLocations(data.data.total);
-    }
-  }, [data]);
-
-  const results = useMemo(() => {
-    return {
-      locations: data?.data?.entry?.map((entry) => entry.resource),
-      totalLocations,
-      ...rest,
-    };
-  }, [data, rest, totalLocations]);
-  return results;
+  const urlWithSearchParams = `${fhirBaseUrl}/Location?${searchParams.toString()}`;
+  return useFhirPagination<fhir.Location>(skip ? null : urlWithSearchParams, pageSize, { immutable: true });
 }

package/src/hooks/useMotherAndChildren.ts

@@ -0,0 +1,46 @@
+import { makeUrl, restBaseUrl, useOpenmrsFetchAll } from '@openmrs/esm-framework';
+import { type MotherAndChild } from '../types';
+
+export interface MothersAndChildrenSearchCriteria {
+  mothers?: Array<string>;
+  children?: Array<string>;
+  requireMotherHasActiveVisit?: boolean;
+  requireChildHasActiveVisit?: boolean;
+  requireChildBornDuringMothersActiveVisit?: boolean;
+}
+
+export function useMotherAndChildren(
+  criteria: MothersAndChildrenSearchCriteria,
+  fetch: boolean = true,
+  rep: string = null,
+) {
+  const url = makeUrlUrl(`${restBaseUrl}/emrapi/maternal/mothersAndChildren`);
+  const {
+    mothers,
+    children,
+    requireChildBornDuringMothersActiveVisit,
+    requireChildHasActiveVisit,
+    requireMotherHasActiveVisit,
+  } = criteria;
+
+  for (const m of mothers ?? []) {
+    url.searchParams.append('mother', m);
+  }
+
+  for (const c of children ?? []) {
+    url.searchParams.append('child', c);
+  }
+
+  url.searchParams.append('requireMotherHasActiveVisit', requireMotherHasActiveVisit?.toString() ?? 'false');
+  url.searchParams.append('requireChildHasActiveVisit', requireChildHasActiveVisit?.toString() ?? 'false');
+  url.searchParams.append(
+    'requireChildBornDuringMothersActiveVisit',
+    requireChildBornDuringMothersActiveVisit?.toString() ?? 'false',
+  );
+  rep && url.searchParams.append('v', rep);
+  return useOpenmrsFetchAll<MotherAndChild>(fetch ? url : null);
+}
+
+function makeUrlUrl(path: string) {
+  return new URL(makeUrl(path), window.location.toString());
+}