@ampath/esm-dha-workflow-app 4.0.0-claim-workflows.159

package/src/registry/utils/hie-client-adapter.ts

@@ -0,0 +1,312 @@
+import { IdentifierTypesUuids } from '../../resources/identifier-types';
+import { CivilStatusUids } from '../../shared/constants/civil-status';
+import { PersonAttributeTypeUuids } from '../../shared/constants/person-attributes';
+import {
+  type AlternateContact,
+  type CreatePersonDto,
+  type HieClient,
+  type HieIdentifications,
+  HieIdentificationType,
+} from '../types';
+
+const clientDatailsFields = [
+  'id',
+  'other_identifications',
+  'first_name',
+  'middle_name',
+  'last_name',
+  'gender',
+  'date_of_birth',
+  'is_alive',
+  'deceased_datetime',
+  'phone',
+  'email',
+  'civil_status',
+  'place_of_birth',
+  'citizenship',
+  'country',
+  'county',
+  'sub_county',
+  'ward',
+  'village_estate',
+  'longitude',
+  'latitude',
+  'identification_type',
+];
+
+const nameFields = ['first_name', 'middle_name', 'last_name'];
+const otherPersonFields = ['gender', 'date_of_birth', 'is_alive', 'deceased_datetime'];
+const attributeFields = ['phone', 'email', 'civil_status', 'place_of_birth', 'citizenship'];
+const addressFields = ['country', 'county', 'sub_county', 'ward', 'village_estate', 'longitude', 'latitude'];
+const otherFields = ['gender', 'date_of_birth'];
+const identifierFields = [
+  HieIdentificationType.Cr,
+  HieIdentificationType.SHANumber,
+  HieIdentificationType.HouseholdNumber,
+  HieIdentificationType.RefugeeID,
+  HieIdentificationType.MandateNumber,
+  HieIdentificationType.AlienID,
+  HieIdentificationType.NationalID,
+  HieIdentificationType.TemporaryDependantID,
+];
+const hieAmrsSyncFields = [
+  ...identifierFields,
+  ...nameFields,
+  ...otherPersonFields,
+  ...attributeFields,
+  ...addressFields,
+];
+
+export function generateHieClientDetails(hieClient: HieClient) {
+  let data = {};
+  Object.keys(hieClient)
+    .filter((key) => {
+      return clientDatailsFields.includes(key);
+    })
+    .forEach((key) => {
+      if (key === 'other_identifications') {
+        const otherIds = generateOtherIdentifications(hieClient[key]);
+        data = {
+          ...data,
+          ...otherIds,
+        };
+      } else if (key === 'identification_type') {
+        data[hieClient['identification_type']] = hieClient.identification_number;
+      } else {
+        const value = hieClient[key];
+        data[key] = value;
+      }
+    });
+  return data;
+}
+function generateOtherIdentifications(hieIdentifications: HieIdentifications[]) {
+  const other = {};
+  hieIdentifications.forEach((id) => {
+    other[id.identification_type] = id.identification_number;
+  });
+  return other;
+}
+
+export function generateAmrsPersonPayload(hieClient: HieClient): CreatePersonDto {
+  const createPersonPayload: CreatePersonDto = {};
+  const namesAttribute = {};
+  const addresses = {};
+  let attributes = [];
+  hieAmrsSyncFields.forEach((d) => {
+    if (d === 'first_name') {
+      namesAttribute['givenName'] = hieClient.first_name;
+    }
+    if (d === 'middle_name') {
+      namesAttribute['middleName'] = hieClient.middle_name;
+    }
+    if (d === 'last_name') {
+      namesAttribute['familyName'] = hieClient.last_name;
+    }
+    if (d === 'gender') {
+      createPersonPayload['gender'] = hieClient.gender === 'Male' ? 'M' : 'F';
+    }
+    if (d === 'date_of_birth') {
+      createPersonPayload['birthdate'] = hieClient.date_of_birth;
+      createPersonPayload['birthdateEstimated'] = false;
+    }
+    if (d === 'is_alive') {
+      createPersonPayload['dead'] = hieClient.is_alive === 0 ? true : false;
+    }
+    if (d === 'deceased_datetime') {
+      if (hieClient.deceased_datetime.length > 0) {
+        createPersonPayload['deathDate'] = hieClient.deceased_datetime;
+      }
+    }
+    if (d === 'country' && hieClient.country.length > 0) {
+      addresses['country'] = hieClient.country;
+      addresses['address1'] = hieClient.country;
+    }
+    if (d === 'place_of_birth' && hieClient.place_of_birth.length > 0) {
+      addresses['address10'] = hieClient.place_of_birth;
+    }
+    if (d === 'county' && hieClient.county.length > 0) {
+      addresses['countyDistrict'] = hieClient.county;
+    }
+    if (d === 'sub_county' && hieClient.sub_county.length > 0) {
+      addresses['address2'] = hieClient.sub_county;
+      addresses['stateProvince'] = hieClient.sub_county;
+    }
+    if (d === 'ward' && hieClient.sub_county.length > 0) {
+      addresses['address7'] = hieClient.sub_county;
+      addresses['address4'] = hieClient.sub_county;
+    }
+    if (d === 'village_estate' && hieClient.village_estate.length > 0) {
+      addresses['cityVillage'] = hieClient.village_estate;
+    }
+    if (d === 'longitude' && hieClient.longitude.length > 0) {
+      addresses['longitude'] = hieClient.longitude;
+    }
+    if (d === 'latitude' && hieClient.latitude.length > 0) {
+      addresses['latitude'] = hieClient.latitude;
+    }
+    if (d === 'place_of_birth' && hieClient.place_of_birth.length > 0) {
+      attributes.push({
+        value: hieClient.place_of_birth,
+        attributeType: PersonAttributeTypeUuids.PLACE_OF_BIRTH_UUID,
+      });
+    }
+    if (d === 'phone' && hieClient.phone.length > 0) {
+      attributes.push({
+        value: hieClient.phone,
+        attributeType: PersonAttributeTypeUuids.CONTACT_PHONE_NUMBER_UUID,
+      });
+    }
+    if (d === 'email' && hieClient.email.length > 0) {
+      attributes.push({
+        value: hieClient.email,
+        attributeType: PersonAttributeTypeUuids.CONTACT_EMAIL_ADDRESS_UUID,
+      });
+    }
+    if (d === 'civil_status' && hieClient.civil_status.length > 0) {
+      attributes.push({
+        value: getAmrsConceptUuidFromField(hieClient.civil_status),
+        attributeType: PersonAttributeTypeUuids.CIVIL_STATUS_UUID,
+      });
+    }
+    if (d === 'id' && hieClient.id) {
+      attributes.push({
+        value: hieClient.id,
+        attributeType: PersonAttributeTypeUuids.CLIENT_REGISTRY_ID_UUID,
+      });
+    }
+    if (d === 'citizenship' && hieClient.citizenship) {
+      attributes.push({
+        value: hieClient.citizenship,
+        attributeType: PersonAttributeTypeUuids.CITIZENSHIP_UUID,
+      });
+    }
+  });
+  // Add next of kin details
+  const nextOfKinAndAlternativeAttributes = generateNextOfKinAndAlternateContactDetails(hieClient.alternative_contacts);
+  attributes = [...attributes, ...nextOfKinAndAlternativeAttributes];
+  if (Object.keys(namesAttribute).length > 0) {
+    createPersonPayload['names'] = [namesAttribute];
+  }
+  if (Object.keys(addresses).length > 0) {
+    createPersonPayload['addresses'] = [addresses];
+  }
+  if (attributes.length > 0) {
+    createPersonPayload['attributes'] = attributes;
+  }
+  return createPersonPayload;
+}
+function generateNextOfKinAndAlternateContactDetails(alternativeContacts: AlternateContact[]) {
+  const attributes = [];
+  const alterNativeClientContact = alternativeContacts.find((a) => {
+    return a.relationship === 'Alternative Phone Number';
+  });
+  const nextOfKinContact = alternativeContacts.find((a) => {
+    return a.remarks === 'Next Of Kin';
+  });
+  if (alterNativeClientContact) {
+    if (alterNativeClientContact.contact_type === 'Phone') {
+      attributes.push({
+        value: alterNativeClientContact.contact_id,
+        attributeType: PersonAttributeTypeUuids.ALTERNATIVE_CONTACT_PHONE_NUMBER_UUID,
+      });
+    }
+  }
+  if (nextOfKinContact) {
+    if (nextOfKinContact.contact_type === 'Phone') {
+      attributes.push({
+        value: nextOfKinContact.contact_id,
+        attributeType: PersonAttributeTypeUuids.NEXT_OF_KIN_CONTACT_PHONE_NUMBER_UUID,
+      });
+    }
+    attributes.push({
+      value: nextOfKinContact.relationship,
+      attributeType: PersonAttributeTypeUuids.NEXT_OF_KIN_RELATIONSHIP_UUID,
+    });
+    attributes.push({
+      value: nextOfKinContact.contact_name,
+      attributeType: PersonAttributeTypeUuids.NEXT_OF_KIN_NAME_UUID,
+    });
+  }
+  return attributes;
+}
+function getAmrsConceptUuidFromField(fieldName: string): string {
+  let conceptUuid = '';
+  switch (fieldName) {
+    case 'Divorced':
+      conceptUuid = CivilStatusUids.DIVORCED_UUID;
+      break;
+    case 'Married':
+      conceptUuid = CivilStatusUids.MARRIED_UUID;
+      break;
+    case 'Single':
+      conceptUuid = CivilStatusUids.SINGLE_UUID;
+      break;
+    default:
+      conceptUuid = CivilStatusUids.NOT_APPLICABLE_UUID;
+  }
+  return conceptUuid;
+}
+export function generateAmrsCreatePatientIdentifiersPayload(hieClient: HieClient, identifierLocation: string) {
+  const identifiers = [];
+  // add CR number
+  identifiers.push({
+    identifierType: getAmrsIdentifierTypeUuid(HieIdentificationType.Cr),
+    identifier: hieClient.id,
+    location: identifierLocation,
+  });
+
+  // add main identifier
+  identifiers.push({
+    identifierType: getAmrsIdentifierTypeUuid(hieClient.identification_type),
+    identifier: hieClient.identification_number,
+    location: identifierLocation,
+  });
+
+  // add other idenfications
+  hieClient.other_identifications.forEach((id) => {
+    identifiers.push({
+      identifierType: getAmrsIdentifierTypeUuid(id.identification_type),
+      identifier: id.identification_number,
+      location: identifierLocation,
+    });
+  });
+
+  return identifiers;
+}
+
+export function getAmrsIdentifierTypeUuid(hieIdentifierName: string) {
+  let idTypeUuid;
+  switch (hieIdentifierName) {
+    case HieIdentificationType.NationalID:
+      idTypeUuid = IdentifierTypesUuids.NATIONAL_ID_UUID;
+      break;
+    case HieIdentificationType.HouseholdNumber:
+      idTypeUuid = IdentifierTypesUuids.HOUSE_HOLD_NUMBER_UUID;
+      break;
+    case HieIdentificationType.AlienID:
+      idTypeUuid = IdentifierTypesUuids.ALIEN_ID_UUID;
+      break;
+    case HieIdentificationType.SHANumber:
+      idTypeUuid = IdentifierTypesUuids.SHA_UUID;
+      break;
+    case HieIdentificationType.MandateNumber:
+      idTypeUuid = IdentifierTypesUuids.MANDATE_NUMBER_UUID;
+      break;
+    case HieIdentificationType.RefugeeID:
+      idTypeUuid = IdentifierTypesUuids.REFUGEE_ID_UUID;
+      break;
+    case HieIdentificationType.Cr:
+      idTypeUuid = IdentifierTypesUuids.CLIENT_REGISTRY_NO_UUID;
+      break;
+    case HieIdentificationType.BirthCertificate:
+      idTypeUuid = IdentifierTypesUuids.BIRTH_CERTIFICATE_NUMBER_UUID;
+      break;
+    case HieIdentificationType.TemporaryDependantID:
+      idTypeUuid = IdentifierTypesUuids.TEMPORARY_DEPENDANT_ID_UUID;
+      break;
+    case HieIdentificationType.BirthNotification:
+      idTypeUuid = IdentifierTypesUuids.BIRTH_NOTIFICATION_UUID;
+      break;
+  }
+  return idTypeUuid;
+}

package/src/registry/utils/mask-data.ts

@@ -0,0 +1,32 @@
+export const maskValue = (value: string): string => {
+  let arrValue = value.split('');
+  for (let i = 0; i < value.length; i++) {
+    if (i % 2 === 0) {
+      arrValue[i] = '*';
+    }
+  }
+  const maskedValue = arrValue.join('');
+  return maskedValue;
+};
+
+export const maskExceptFirstAndLast = (value: string): string => {
+  let arrValue = value.split('');
+  for (let i = 0; i < value.length; i++) {
+    if (!(i == 0 || i === value.length - 1)) {
+      arrValue[i] = '*';
+    }
+  }
+  const maskedValue = arrValue.join('');
+  return maskedValue;
+};
+
+export const maskAllButFirstAndLastThree = (value: string): string => {
+  let arrValue = value.split('');
+  for (let i = 0; i < value.length; i++) {
+    if (i > 3 && i < value.length - 3) {
+      arrValue[i] = '*';
+    }
+  }
+  const maskedValue = arrValue.join('');
+  return maskedValue;
+};

package/src/registry/utils/phone-number-formatter.ts

@@ -0,0 +1,11 @@
+export function formatPhoneNumberForOTP(phone: string): string {
+  let cleaned = phone.replace(/[^\d+]/g, '');
+
+  if (cleaned.startsWith('+')) {
+    cleaned = cleaned.slice(1);
+  }
+  if (cleaned.startsWith('0')) {
+    cleaned = '254' + cleaned.slice(1);
+  }
+  return cleaned;
+}

package/src/resources/dashboard.resource.ts

@@ -0,0 +1,20 @@
+import { openmrsFetch } from '@openmrs/esm-framework';
+import { getEtlBaseUrl } from '../shared/utils/get-base-url';
+
+export async function getDashBoardSummary(locationUuid: string): Promise<any> {
+  const etlBaseUrl = await getEtlBaseUrl();
+  const dashboardSummaryUrl = `${etlBaseUrl}/dashboard-summary`;
+  const params = {
+    locationUuid: locationUuid,
+  };
+  const queryString = new URLSearchParams(params).toString();
+  const response = await openmrsFetch(`${dashboardSummaryUrl}?${queryString}`);
+
+  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.data;
+}

package/src/resources/hie-amrs-automatic-registration.service.ts

@@ -0,0 +1,16 @@
+import { type Patient } from '@openmrs/esm-framework';
+import { type HieClient } from '../registry/types';
+import { generateAmrsPersonPayload } from '../registry/utils/hie-client-adapter';
+import { createPatient, generatePatientIdentifiers } from './patient-resource';
+
+export async function registerHieClientInAmrs(client: HieClient, identifierLocation: string): Promise<Patient> {
+  const createPersonPayload = generateAmrsPersonPayload(client);
+  const identifiers = await generatePatientIdentifiers(identifierLocation, client);
+  const resp = await createPatient({
+    person: createPersonPayload,
+    identifiers: identifiers,
+  });
+
+  const res = await resp.json();
+  return res;
+}

package/src/resources/identifier-types.ts

@@ -0,0 +1,29 @@
+const HOUSE_HOLD_NUMBER_UUID = 'bb74b20e-dcee-4f59-bdf1-2dffc3abf106';
+const SHA_UUID = 'cf5362b2-8049-4442-b3c6-36f870e320cb';
+const CLIENT_REGISTRY_NO_UUID = 'e88dc246-3614-4ee3-8141-1f2a83054e72';
+const NATIONAL_ID_UUID = '58a47054-1359-11df-a1f1-0026b9348838';
+const PROVIDER_NATIONAL_ID_UUID = '4550df92-c684-4597-8ab8-d6b10eabdcfb';
+const REFUGEE_ID_UUID = '465e81af-8d69-47e9-9127-53a94adc75fb';
+const MANDATE_NUMBER_UUID = 'aae2d097-20ba-43ca-9b71-fd8296068f39';
+const ALIEN_ID_UUID = '12f5b147-3403-4a73-913d-7ded9ffec094';
+const TEMPORARY_DEPENDANT_ID_UUID = 'a3d34214-93e8-4faf-bf4d-0272eee079eb';
+const AMRS_UNIVERSAL_ID_UUID = '58a4732e-1359-11df-a1f1-0026b9348838';
+const UPI_NUMBER_UUID = 'cba702b9-4664-4b43-83f1-9ab473cbd64d';
+const BIRTH_CERTIFICATE_NUMBER_UUID = '7924e13b-131a-4da8-8efa-e294184a1b0d';
+const BIRTH_NOTIFICATION_UUID = '10a4349d-dd1b-4b0c-bd35-a00a22394266';
+
+export const IdentifierTypesUuids = {
+  HOUSE_HOLD_NUMBER_UUID,
+  SHA_UUID,
+  CLIENT_REGISTRY_NO_UUID,
+  NATIONAL_ID_UUID,
+  PROVIDER_NATIONAL_ID_UUID,
+  REFUGEE_ID_UUID,
+  MANDATE_NUMBER_UUID,
+  ALIEN_ID_UUID,
+  TEMPORARY_DEPENDANT_ID_UUID,
+  AMRS_UNIVERSAL_ID_UUID,
+  UPI_NUMBER_UUID,
+  BIRTH_CERTIFICATE_NUMBER_UUID,
+  BIRTH_NOTIFICATION_UUID,
+};

package/src/resources/patient-resource.ts

@@ -0,0 +1,62 @@
+import { openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import { type HieClient, type CreatePatientDto, HieIdentificationType } from '../registry/types';
+import { IdentifierTypesUuids } from './identifier-types';
+import { getAmrsIdentifierTypeUuid } from '../registry/utils/hie-client-adapter';
+import { getSubDomainUrl } from '../shared/utils/get-base-url';
+
+export async function createPatient(payload: CreatePatientDto) {
+  return await openmrsFetch(`${restBaseUrl}/patient`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: payload,
+  });
+}
+
+export const generatePatientIdentifiers = async (identifierLocation: string, client: HieClient) => {
+  const amrsUniverSalId = await generateAmrsUniversalIdentifier();
+  const identifiers = generateAmrsCreatePatientIdentifiersPayload(client, identifierLocation);
+  identifiers.push({
+    identifierType: IdentifierTypesUuids.AMRS_UNIVERSAL_ID_UUID,
+    identifier: amrsUniverSalId,
+    location: identifierLocation,
+    preferred: true,
+  });
+  return identifiers;
+};
+
+export function generateAmrsCreatePatientIdentifiersPayload(hieClient: HieClient, identifierLocation: string) {
+  const identifiers = [];
+  // add CR number
+  identifiers.push({
+    identifierType: getAmrsIdentifierTypeUuid(HieIdentificationType.Cr),
+    identifier: hieClient.id,
+    location: identifierLocation,
+  });
+
+  // add main identifier
+  identifiers.push({
+    identifierType: getAmrsIdentifierTypeUuid(hieClient.identification_type),
+    identifier: hieClient.identification_number,
+    location: identifierLocation,
+  });
+  return identifiers;
+}
+
+export async function generateAmrsUniversalIdentifier() {
+  const subDomainUrl = await getSubDomainUrl();
+  const abortController = new AbortController();
+  const resp = await openmrsFetch(`${subDomainUrl}/amrs-id-generator/generateidentifier`, {
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    method: 'POST',
+    body: {
+      user: 1,
+    },
+    signal: abortController.signal,
+  });
+  const data = await resp.json();
+  return data['identifier'] ?? '';
+}

package/src/resources/patient-search.resource.ts

@@ -0,0 +1,22 @@
+import { openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import { type PatientSearchResponse } from '../registry/types';
+
+export async function searchPatientByCrNumber<T>(cr_id: string): Promise<PatientSearchResponse> {
+  const url = `${restBaseUrl}/patient`;
+  const params = {
+    q: cr_id,
+    v: 'full',
+    includeDead: 'true',
+    limit: '10',
+    totalCount: 'true',
+  };
+  const queryString = new URLSearchParams(params).toString();
+  const response = await openmrsFetch(`${url}?${queryString}`);
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Request failed with ${response.status}: ${errorText}`);
+  }
+
+  return response.json();
+}

package/src/resources/queue.resource.ts

@@ -0,0 +1,60 @@
+import { openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import { type ServiceQueue, type QueueEntryDto, type ServiceQueueApiResponse } from '../registry/types';
+import { getLocationByUuid } from '../shared/services/location.resource';
+
+export async function fetchServiceQueuesByLocationUuid<T>(locationUuid: string): Promise<ServiceQueueApiResponse> {
+  const url = `${restBaseUrl}/queue`;
+  const params = {
+    v: 'custom:(uuid,display,name,description,service:(uuid,display),allowedPriorities:(uuid,display),allowedStatuses:(uuid,display),location:(uuid,display))',
+    location: locationUuid,
+  };
+  const queryString = new URLSearchParams(params).toString();
+  const response = await openmrsFetch(`${url}?${queryString}`);
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Request failed with ${response.status}: ${errorText}`);
+  }
+
+  return response.json();
+}
+
+export async function createQueueEntry(createQueueEntryDto: QueueEntryDto) {
+  const url = `${restBaseUrl}/visit-queue-entry`;
+  const response = await openmrsFetch(url, {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json',
+    },
+    body: JSON.stringify(createQueueEntryDto),
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Request failed with ${response.status}: ${errorText}`);
+  }
+
+  return response.json();
+}
+
+export async function getFacilityServiceQueues(locationUuid: string): Promise<ServiceQueue[] | undefined> {
+  const currentLocation = await getLocationByUuid(locationUuid);
+  if (!currentLocation) return;
+  const parentLocation = currentLocation.parentLocation;
+  //get child locations
+  if (!parentLocation) return;
+  const parentLocationDetail = await getLocationByUuid(parentLocation.uuid);
+  const childLocations = parentLocationDetail.childLocations ?? [];
+  const childLocationUuids =
+    childLocations.map((c) => {
+      return c.uuid;
+    }) ?? [];
+  let sqs: ServiceQueue[] = [];
+  if (childLocationUuids.length > 0) {
+    for (let i = 0; i < childLocationUuids.length; i++) {
+      const s = await fetchServiceQueuesByLocationUuid(childLocationUuids[i]);
+      sqs = [...sqs, ...s.results];
+    }
+  }
+  return sqs;
+}

package/src/resources/superset.resource.ts

@@ -0,0 +1,21 @@
+import { openmrsFetch } from '@openmrs/esm-framework';
+import { getEtlBaseUrl } from '../shared/utils/get-base-url';
+
+export async function fetchGuestToken(locationUuid: string, dashboardId: string): Promise<string> {
+  const etlBaseUrl = await getEtlBaseUrl();
+  const supersetTokenUrl = `${etlBaseUrl}/superset-token`;
+  const params = {
+    locationUuid: locationUuid,
+    dashboardId: dashboardId,
+  };
+  const queryString = new URLSearchParams(params).toString();
+  const response = await openmrsFetch(`${supersetTokenUrl}?${queryString}`);
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to fetch guest token: ${response.status} - ${errorText}`);
+  }
+
+  const data = await response.json();
+  return data.access_token;
+}

package/src/resources/visit.resource.ts

@@ -0,0 +1,38 @@
+import { openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import { type EndVisitDto, type CreateVisitDto } from '../registry/types';
+
+export async function createVisit(createVisitDto: CreateVisitDto) {
+  const url = `${restBaseUrl}/visit`;
+  const response = await openmrsFetch(url, {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json',
+    },
+    body: JSON.stringify(createVisitDto),
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Request failed with ${response.status}: ${errorText}`);
+  }
+
+  return response.json();
+}
+
+export async function endVisit(visitUuid: string, endVisitDto: EndVisitDto) {
+  const url = `${restBaseUrl}/visit/${visitUuid}`;
+  const response = await openmrsFetch(url, {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json',
+    },
+    body: JSON.stringify(endVisitDto),
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Request failed with ${response.status}: ${errorText}`);
+  }
+
+  return response.json();
+}

package/src/root.component.tsx

@@ -0,0 +1,48 @@
+import React from 'react';
+import styles from './root.scss';
+import { useLeftNav, WorkspaceContainer } from '@openmrs/esm-framework';
+import { BrowserRouter, Route, Routes } from 'react-router-dom';
+import RegistryComponent from './registry/registry.component';
+import LeftPanel from './left-panel/left-panel.component';
+import Triage from './triage/triage.component';
+import LaboratoryComponent from './laboratory/laboratory.component';
+import AppointmentsComponent from './appointments/appointments.component';
+import PharmacyComponent from './pharmacy/pharmacy.component';
+import Consultation from './service-queues/consultation/consultation.component';
+import Dashboard from './dashboard/dashboard.component';
+import DailyBookings from './bookings/daily/daily-bookings.component';
+import Mortuary from './mortuary/mortuary.component';
+import ServiceQueueAdminDashboard from './service-queues/admin/service-queue-admin-dashboard.component';
+import AdmissionsDashboard from './admissions/admissions-dashboard.component';
+
+const Root: React.FC = () => {
+  const spaBasePath = window.spaBase;
+  useLeftNav({
+    name: 'dha-workflow-slot',
+    basePath: spaBasePath,
+    mode: 'normal',
+  });
+  return (
+    <BrowserRouter basename={`${window.spaBase}/dha-workflow`}>
+      <LeftPanel />
+      <main className={styles.container}>
+        <Routes>
+          <Route path="dashboard" element={<Dashboard />} />
+          <Route path="registry" element={<RegistryComponent />} />
+          <Route path="consultation" element={<Consultation />} />
+          <Route path="triage" element={<Triage />} />
+          <Route path="laboratory" element={<LaboratoryComponent />} />
+          <Route path="pharmacy" element={<PharmacyComponent />} />
+          <Route path="appointments" element={<AppointmentsComponent />} />
+          <Route path="bookings/daily" element={<DailyBookings />} />
+          <Route path="mortuary" element={<Mortuary />} />
+          <Route path="service-queue-admin" element={<ServiceQueueAdminDashboard />} />
+          <Route path="admissions-dashboard" element={<AdmissionsDashboard />} />
+        </Routes>
+      </main>
+      <WorkspaceContainer contextKey="home" />
+    </BrowserRouter>
+  );
+};
+
+export default Root;