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

package/src/registry/registry.resource.ts

@@ -0,0 +1,62 @@
+import { openmrsFetch } from '@openmrs/esm-framework';
+import { getHieBaseUrl } from '../shared/utils/get-base-url';
+import {
+  type ClientRegistrySearchRequest,
+  type RequestCustomOtpDto,
+  type RequestCustomOtpResponse,
+  type ValidateCustomOtpResponse,
+  type ValidateHieCustomOtpDto,
+} from './types';
+
+export type ClientRegistrySearchResponse = any[];
+
+export async function postJson<T>(url: string, payload: unknown): Promise<T> {
+  const response = await openmrsFetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(payload),
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Request failed with ${response.status}: ${errorText}`);
+  }
+
+  return response.json() as Promise<T>;
+}
+
+export async function requestCustomOtp(payload: RequestCustomOtpDto): Promise<RequestCustomOtpResponse> {
+  const hieBaseUrl = await getHieBaseUrl();
+  const url = `${hieBaseUrl}/client/send-custom-otp`;
+  const formattedPayload = {
+    identificationNumber: payload.identificationNumber,
+    identificationType: payload.identificationType,
+    locationUuid: payload.locationUuid,
+    phoneNumber: payload.phoneNumber
+  };
+  return postJson<RequestCustomOtpResponse>(url, formattedPayload);
+}
+
+export async function validateCustomOtp(payload: ValidateHieCustomOtpDto): Promise<ValidateCustomOtpResponse> {
+  const hieBaseUrl = await getHieBaseUrl();
+  const url = `${hieBaseUrl}/client/validate-custom-otp`;
+  const formattedPayload = {
+    sessionId: payload.sessionId,
+    otp: payload.otp,
+    locationUuid: payload.locationUuid,
+  };
+  return postJson<ValidateCustomOtpResponse>(url, formattedPayload);
+}
+
+export async function fetchClientRegistryData(
+  payload: ClientRegistrySearchRequest,
+): Promise<ClientRegistrySearchResponse> {
+  const hieBaseUrl = await getHieBaseUrl();
+  const url = `${hieBaseUrl}/client/search`;
+  const formattedPayload = {
+    identificationNumber: payload.identificationNumber,
+    identificationType: payload.identificationType,
+    locationUuid: payload.locationUuid,
+  };
+  return postJson<ClientRegistrySearchResponse>(url, formattedPayload);
+}

package/src/registry/types/index.ts

@@ -0,0 +1,401 @@
+import { type Location, type Patient } from '@openmrs/esm-framework';
+
+export type IdentifierType = 'National ID' | 'Alien ID' | 'Passport' | 'Mandate Number' | 'Refugee ID' | 'Birth Certificate';
+
+export const IDENTIFIER_TYPES: IdentifierType[] = [
+  'National ID',
+  'Alien ID',
+  'Mandate Number',
+  '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;
+}
+
+export type ClientRegistrySearchRequest = {
+  identificationNumber: string | number;
+  identificationType: string;
+  locationUuid: string;
+};
+
+export interface RequestCustomOtpResponse {
+  message: string;
+  sessionId: string;
+  maskedPhone: string;
+}
+
+export interface ValidateHieCustomOtpDto {
+  sessionId: string;
+  otp: number | string;
+  locationUuid: string;
+}
+
+export interface ValidateCustomOtpResponse {
+  message: string;
+  isValid?: boolean;
+}
+
+export type RequestCustomOtpDto = {
+  identificationNumber: string | number;
+  identificationType: string;
+  locationUuid: string;
+  phoneNumber: string;
+};
+
+export interface RequestCustomOtpResponse {
+  message: string;
+  sessionId: string;
+  maskedPhone: string;
+}
+
+export interface ValidateHieCustomOtpDto {
+  sessionId: string;
+  otp: number | string;
+  locationUuid: string;
+}
+
+export enum HieIdentificationType {
+  NationalID = 'National ID',
+  SHANumber = 'SHA Number',
+  HouseholdNumber = 'Household Number',
+  RefugeeID = 'Refugee ID',
+  AlienID = 'Alien ID',
+  MandateNumber = 'Mandate Number',
+  Cr = 'id',
+  TemporaryDependantID = 'Temporary Dependant ID',
+  BirthCertificate = 'Birth Certificate',
+  BirthNotification = 'Birth Notification',
+}
+
+export interface HieIdentifications {
+  identification_number: string;
+  identification_type: HieIdentificationType;
+}
+
+export interface HieDependant {
+  date_added: string;
+  relationship: string;
+  total: number;
+  result: HieClient[];
+}
+
+export interface AlternateContact {
+  contact_type: string;
+  contact_id: string;
+  contact_name: string;
+  relationship: string;
+  remarks: string;
+}
+
+export interface HieClient {
+  resourceType: string;
+  id: string;
+  meta: {
+    versionId: string;
+    creationTime: string;
+    lastUpdated: string;
+    source: string;
+  };
+  originSystem: {
+    system: string;
+    record_id: string;
+  };
+  title: string;
+  first_name: string;
+  middle_name: string;
+  last_name: string;
+  gender: string;
+  date_of_birth: string;
+  place_of_birth: string;
+  person_with_disability: number;
+  citizenship: string;
+  kra_pin: string;
+  preferred_primary_care_network: string;
+  employment_type: string;
+  domestic_worker_type: string;
+  civil_status: string;
+  identification_type: HieIdentificationType;
+  identification_number: string;
+  other_identifications: HieIdentifications[];
+  dependants: HieDependant[];
+  is_alive: number;
+  deceased_datetime: string;
+  phone: string;
+  biometrics_verified: number;
+  biometrics_score: number;
+  email: string;
+  country: string;
+  county: string;
+  sub_county: string;
+  ward: string;
+  village_estate: string;
+  building_house_no: string;
+  latitude: string;
+  longitude: string;
+  province_state_country: string;
+  zip_code: string;
+  identification_residence: string;
+  employer_name: string;
+  employer_pin: string;
+  disability_category: string;
+  disability_subcategory: string;
+  disability_cause: string;
+  in_lawful_custody: string;
+  admission_remand_number: string;
+  document_uploads: any[];
+  alternative_contacts: AlternateContact[];
+  gross_income: number;
+  gross_income_currency: string;
+  postal_address: string;
+  estimated_contribution: number;
+  estimated_annual_contribution: number;
+  city: string;
+  id_serial: string;
+  learning_institution_code: string;
+  learning_institution_name: string;
+  grade_level: string;
+  admission_number: string;
+  expected_year_of_graduation: string;
+  unconfirmed_dependants: HieDependant[];
+  is_agent: number;
+  agent_id: string;
+}
+
+export type PatientSearchResponse = {
+  results: Patient[];
+  totalCount: number;
+};
+
+export type QueuePriority = {
+  uuid: string;
+  display: string;
+};
+export type QueueStatus = {
+  uuid: string;
+  display: string;
+};
+export type ServiceQueue = {
+  uuid: string;
+  display: string;
+  name: string;
+  description: string;
+  service: {
+    uuid: string;
+    display: string;
+  };
+  allowedPriorities: QueuePriority[];
+  allowedStatuses: QueueStatus[];
+  location: Location;
+};
+
+export type ServiceQueueApiResponse = {
+  results: ServiceQueue[];
+};
+
+export type QueueEntryDto = {
+  visit: {
+    uuid: string;
+  };
+  queueEntry: {
+    status: {
+      uuid: string;
+    };
+    priority: {
+      uuid: string;
+    };
+    queue: {
+      uuid: string;
+    };
+    patient: {
+      uuid: string;
+    };
+    startedAt: string;
+    sortWeight: number;
+  };
+};
+
+export type CreateVisitDto = {
+  visitType: string;
+  location: string;
+  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

@@ -0,0 +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-adapter.ts

@@ -0,0 +1,56 @@
+import { type HieIdentifications, type HieClient } 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',
+];
+
+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;
+}