@ampath/esm-dha-workflow-app 4.0.0-next.13 → 4.0.0-next.131

package/src/registry/types/index.ts

@@ -1,4 +1,4 @@
-import { Location, type Patient } from '@openmrs/esm-framework';
+import { type Location, type Patient } from '@openmrs/esm-framework';
 
 export type IdentifierType = 'National ID' | 'Alien ID' | 'Passport' | 'Mandate Number' | 'Refugee ID';
 
@@ -10,6 +10,18 @@ export const IDENTIFIER_TYPES: IdentifierType[] = [
   'Refugee ID',
 ];
 
+export enum OtpStatus {
+  Draft = 'DRAFT',
+  Sent = 'SENT',
+  Verified = 'VERIFIED',
+}
+
+export enum OtpOptions {
+  Skip = 'SKIP',
+  NoOverride = 'NO OVERRIDE',
+  Override = 'OVERRIDE',
+}
+
 export interface ValidateCustomOtpResponse {
   message: string;
   isValid?: boolean;
@@ -65,6 +77,8 @@ export enum HieIdentificationType {
   MandateNumber = 'Mandate Number',
   Cr = 'id',
   TemporaryDependantID = 'Temporary Dependant ID',
+  BirthCertificate = 'Birth Certificate',
+  BirthNotification = 'Birth Notification',
 }
 
 export interface HieIdentifications {
@@ -220,4 +234,168 @@ export type CreateVisitDto = {
   startDatetime: null | string;
   stopDatetime: null | string;
   patient: string;
+  attributes?: VisitAttribute[];
+};
+
+export type VisitAttribute = {
+  attributeType: string;
+  value: string;
+};
+
+export type EndVisitDto = {
+  stopDatetime: string;
+};
+
+export interface GlobalError {
+  code: string;
+  message: string;
+}
+
+export interface AmrsErrorResponse {
+  message: string;
+  error: {
+    error: {
+      message: string;
+      code: string;
+      globalErrors?: GlobalError[];
+      fieldErrors?: any;
+    };
+  };
+}
+
+export interface CreatePersonDto {
+  gender?: string;
+  birthdate?: string;
+  dead?: boolean;
+  deathDate?: string;
+  names?: {
+    givenName?: string;
+    middleName?: string;
+    familyName?: string;
+  }[];
+  addresses?: {
+    country?: string;
+    address1?: string;
+    address2?: string;
+    address4?: string;
+    address7?: string;
+    address10?: string;
+    countyDistrict?: string;
+    stateProvince?: string;
+    cityVillage?: string;
+    longitude?: string;
+    latitude?: string;
+  }[];
+  attributes?: {
+    value: string | number;
+    attributeType: string;
+  }[];
+}
+
+export type CreatePatientDto = {
+  person: CreatePersonDto;
+  identifiers?: any;
+};
+
+export type QueueEntryResult = {
+  name: string;
+  queue_entry_id: number;
+  priority_comment: string;
+  wait_time_in_min: number;
+  queue_entry_uuid: string;
+  service_uuid: string;
+  location_id: number;
+  location: string;
+  service: number;
+  queue_id: number;
+  queue_room: string;
+  priority: string;
+  patient_id: number;
+  visit_id: number;
+  patient_uuid: string;
+  family_name: string;
+  given_name: string;
+  middle_name: string;
+  status: string;
+  visit_uuid: string;
+  queue_coming_from: string;
+  bill_status: string;
+  bill_item_payment_status: string;
+  price_name: string;
+  cash_unpaid_client: string;
+  hide_in_queue: number;
+  identifiers: string;
+  phone_number: string;
+  age: number;
+};
+
+export enum PaymentDetail {
+  Paying = 'Paying',
+  NonPaying = 'Non-Paying',
+}
+
+export type EligibilityFilterDto = {
+  requestIdType: string;
+  requestIdNumber: string;
+  locationUuid: string;
+};
+
+export type HieClientEligibility = {
+  requestIdType: number;
+  requestIdNumber: string;
+  memberCrNumber: string;
+  fullName: string;
+  schemes: Scheme[];
+  statusDesc: string;
+};
+
+export type Scheme = {
+  schemeName: string;
+  memberType: 'BENEFICIARY' | string;
+  coverageType: 'SHIF' | string;
+  policy: Policy;
+  coverage: Coverage;
+  principalContributor: PrincipalContributor;
+};
+
+export type Policy = {
+  startDate: string;
+  endDate: string;
+  number: string;
 };
+
+export type Coverage = {
+  startDate: string;
+  endDate: string;
+  message: string;
+  reason: string;
+  possibleSolution: string | null;
+  status: string;
+};
+
+export type PrincipalContributor = {
+  idNumber: string;
+  name: string;
+  crNumber: string;
+  relationship: string;
+  employmentType: string;
+  employerDetails: EmployerDetails;
+};
+
+export type EmployerDetails = {
+  name: string;
+  jobGroup: string;
+};
+
+export enum RequestIdTypes {
+  BirthCertificate = 2,
+  CrId = 3,
+  NationalId = 4,
+  Refugee = 5,
+  TemporaryId = 6,
+  TempDependantId = 7,
+  MandateNo = 8,
+  Passport = 9,
+  BirthCertificate2 = 10,
+  HouseholdNumber = 11,
+}

package/src/registry/utils/error-handler.ts

@@ -1,4 +1,37 @@
+import { type AmrsErrorResponse } from '../types';
+
 export function generateErrorMessage(error: any): string[] {
   const errors: string[] = [];
   return errors;
 }
+
+export function getErrorMessages(error: AmrsErrorResponse) {
+  const errors = [];
+  if (error && error.error) {
+    if (error.error.error) {
+      const globalErrors = error.error.error.globalErrors || null;
+      if (globalErrors) {
+        for (const err of globalErrors) {
+          errors.push(err.message);
+        }
+      }
+    } else if (error.error) {
+      if (error.error['globalErrors']) {
+        const globalErrors = error.error['globalErrors'] || null;
+        if (globalErrors) {
+          for (const err of globalErrors) {
+            errors.push(err.message);
+          }
+        }
+      } else if (error.error['message']) {
+        errors.push(error.error['message']);
+      }
+    } else {
+      errors.push(
+        error.error.error.message ||
+          'An error occurred while creating the patient. Please try again or contact support',
+      );
+    }
+  }
+  return errors;
+}

package/src/registry/utils/format-dependant-display-data.ts

@@ -0,0 +1,8 @@
+import { type HieClient } from '../types';
+import { maskExceptFirstAndLast } from './mask-data';
+
+export function formatDependantDisplayData(dependant: HieClient, relationship: string): string {
+  const stringData = `${dependant.first_name} ${maskExceptFirstAndLast(dependant.middle_name)} (${dependant.gender}) (DOB: ${dependant.date_of_birth}) (${relationship}) (CR: ${dependant.id})`;
+
+  return stringData;
+}

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

@@ -19,3 +19,14 @@ export const maskExceptFirstAndLast = (value: string): string => {
   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/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,
+};