@kenyaemr/esm-shr-app 5.4.2-pre.2364 → 5.4.2-pre.2368

package/dist/routes.json

@@ -1 +1 @@
-{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"kenyaemr":"^19.0.0"},"pages":[{"component":"shrRoot","route":"referrals"}],"extensions":[{"component":"shrAuthorizationForm","name":"shr-authorization-form"},{"name":"patient-chart-shr-summary-dashboard-link","component":"shrSummaryDashboardLink","slot":"patient-chart-dashboard-slot","meta":{"columns":1,"columnSpan":1,"slot":"patient-chart-shr-summary-dashboard-slot","path":"SHR Portal"},"featureFlag":"healthInformationExchange"},{"name":"SHR Portal","slot":"patient-chart-shr-summary-dashboard-slot","component":"patientSHRSummary","meta":{"columnSpan":4}},{"name":"referrals","slot":"referrals-slot","component":"shrRoot"},{"name":"referrals-link","slot":"homepage-dashboard-slot","component":"ReferralsDashboardLink","meta":{"name":"referrals","title":"referrals","slot":"referrals-slot"}},{"name":"referral-reasons-dialog","component":"referralReasonsDialogPopup"},{"name":"facility-referral-form","component":"facilityRefferalForm"},{"name":"referral-view-link","component":"referralLink","slot":"patient-chart-dashboard-slot","order":13,"meta":{"columns":1,"columnSpan":1,"slot":"patient-chart-referral-slot","path":"referral","layoutMode":"anchored"}},{"name":"referral-view","slot":"patient-chart-referral-slot","component":"referralWidget","order":0,"online":true,"offline":false}],"version":"5.4.2-pre.2364"}
+{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"kenyaemr":"^19.0.0"},"pages":[{"component":"shrRoot","route":"referrals"}],"extensions":[{"component":"shrAuthorizationForm","name":"shr-authorization-form"},{"name":"patient-chart-shr-summary-dashboard-link","component":"shrSummaryDashboardLink","slot":"patient-chart-dashboard-slot","meta":{"columns":1,"columnSpan":1,"slot":"patient-chart-shr-summary-dashboard-slot","path":"SHR Portal"},"featureFlag":"healthInformationExchange"},{"name":"SHR Portal","slot":"patient-chart-shr-summary-dashboard-slot","component":"patientSHRSummary","meta":{"columnSpan":4}},{"name":"referrals","slot":"referrals-slot","component":"shrRoot"},{"name":"referrals-link","slot":"homepage-dashboard-slot","component":"ReferralsDashboardLink","meta":{"name":"referrals","title":"referrals","slot":"referrals-slot"}},{"name":"referral-reasons-dialog","component":"referralReasonsDialogPopup"},{"name":"facility-referral-form","component":"facilityRefferalForm"},{"name":"referral-view-link","component":"referralLink","slot":"patient-chart-dashboard-slot","order":13,"meta":{"columns":1,"columnSpan":1,"slot":"patient-chart-referral-slot","path":"referral","layoutMode":"anchored"}},{"name":"referral-view","slot":"patient-chart-referral-slot","component":"referralWidget","order":0,"online":true,"offline":false}],"version":"5.4.2-pre.2368"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kenyaemr/esm-shr-app",
-  "version": "5.4.2-pre.2364",
+  "version": "5.4.2-pre.2368",
   "description": "Patient care panels microfrontend for the OpenMRS SPA",
   "browser": "dist/kenyaemr-esm-shr-app.js",
   "main": "src/index.ts",

package/src/config-schema.ts

@@ -16,10 +16,16 @@ export const configSchema = {
     _description: 'Social Health Authority Unique Identification Number',
     _default: '24aedd37-b5be-4e08-8311-3721b8d5100d',
   },
+  artDirectoryUrl: {
+    _type: Type.String,
+    _description: 'URL for the ART Directory',
+    _default: 'https://art.kenyahmis.org/api/patients',
+  },
 };
 
 export type ReferralConfigObject = {
   nationalPatientUniqueIdentifier: string;
   phoneNumberAttributeType: string;
   socialHealthAuthorityIdentifierType: string;
+  artDirectoryUrl: string;
 };

package/src/hooks/usePatient.ts

@@ -1,4 +1,4 @@
-import { FetchResponse, openmrsFetch, Patient, restBaseUrl, useConfig } from '@openmrs/esm-framework';
+import { type FetchResponse, openmrsFetch, type Patient, restBaseUrl, useConfig } from '@openmrs/esm-framework';
 import useSWR from 'swr';
 import { ReferralConfigObject } from '../config-schema';
 

package/src/schema/index.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+
+export const facilityReferralSchema = z.object({
+  referralType: z.string().min(1, 'Referral type is required'),
+  patientUuid: z.string().min(1, 'Patient selection is required'),
+  selectedFacility: z
+    .object({
+      uuid: z.string(),
+      name: z.string(),
+      attributes: z.array(z.any()),
+    })
+    .nullable()
+    .refine((facility) => facility !== null, {
+      message: 'Destination facility is required',
+    }),
+  selectedReasons: z
+    .array(
+      z.object({
+        uuid: z.string(),
+        name: z.object({
+          name: z.string(),
+        }),
+      }),
+    )
+    .min(1, 'At least one referral reason is required'),
+  clinicalNotes: z.string().min(10, 'Clinical notes must be at least 10 characters long'),
+});
+
+export type FacilityReferralFormData = z.infer<typeof facilityReferralSchema>;
+export type ValidationErrors = Partial<Record<keyof FacilityReferralFormData, string>>;

package/src/types/index.ts

@@ -209,3 +209,115 @@ export interface PatientIdentifier {
     display: string;
   };
 }
+
+export interface Concept {
+  uuid: string;
+  name: {
+    name: string;
+  };
+  conceptClass: {
+    name: string;
+  };
+}
+
+export interface ReasonResponse {
+  results: Concept[];
+}
+export interface Facility {
+  uuid: string;
+  name: string;
+  attributes: [
+    {
+      value: string;
+    },
+  ];
+}
+
+export interface FacilityResponse {
+  results: Facility[];
+}
+
+export interface ReferralPayload {
+  MESSAGE_HEADER: {
+    SENDING_APPLICATION: string;
+    SENDING_FACILITY: string;
+    RECEIVING_APPLICATION: string;
+    RECEIVING_FACILITY: string;
+    MESSAGE_DATETIME: string;
+    SECURITY: null;
+    MESSAGE_TYPE: string;
+    PROCESSING_ID: string;
+  };
+  PATIENT_IDENTIFICATION: {
+    EXTERNAL_PATIENT_ID: {
+      ID: string | null;
+      IDENTIFIER_TYPE: string;
+      ASSIGNING_AUTHORITY: string;
+    };
+    INTERNAL_PATIENT_ID: Array<{
+      ID: string;
+      IDENTIFIER_TYPE: string;
+      ASSIGNING_AUTHORITY: string;
+    }>;
+    PATIENT_NAME: {
+      FIRST_NAME: string;
+      MIDDLE_NAME: string;
+      LAST_NAME: string;
+    };
+    MOTHER_NAME: {
+      FIRST_NAME: string | null;
+      MIDDLE_NAME: string | null;
+      LAST_NAME: string | null;
+    };
+    DATE_OF_BIRTH: string;
+    SEX: string;
+    PATIENT_ADDRESS: {
+      PHYSICAL_ADDRESS: {
+        VILLAGE: string;
+        WARD: string;
+        SUB_COUNTY: string;
+        COUNTY: string;
+        GPS_LOCATION: string | null;
+        NEAREST_LANDMARK: string | null;
+      };
+      POSTAL_ADDRESS: string | null;
+    };
+    PHONE_NUMBER: string;
+    MARITAL_STATUS: string | null;
+    DEATH_DATE: string | null;
+    DEATH_INDICATOR: string | null;
+    DATE_OF_BIRTH_PRECISION: string;
+  };
+  DISCONTINUATION_MESSAGE: {
+    DISCONTINUATION_REASON: string;
+    EFFECTIVE_DISCONTINUATION_DATE: string;
+    TARGET_PROGRAM: string;
+    SERVICE_REQUEST: {
+      TRANSFER_STATUS: string;
+      TRANSFER_INTENT: string;
+      TRANSFER_PRIORITY: string;
+      TRANSFER_OUT_DATE: string;
+      TO_ACCEPTANCE_DATE: string | null;
+      SENDING_FACILITY_MFLCODE: string;
+      RECEIVING_FACILITY_MFLCODE: string;
+      SUPPORTING_INFO: string | null;
+    };
+  };
+}
+
+interface ApiSuccessResponse {
+  status: 'success';
+  message: ReferralPayload;
+}
+
+export interface ReferralResponse {
+  success: boolean;
+  data: ApiSuccessResponse;
+  payload: ReferralPayload;
+}
+
+export interface ReferralError extends Error {
+  status?: number;
+  statusText?: string;
+  responseBody?: string;
+}

package/src/utils/function.tsx

@@ -1,5 +1,6 @@
 import mergeWith from 'lodash/mergeWith';
 import isArray from 'lodash/isArray';
+import { formatDate, Patient } from '@openmrs/esm-framework';
 
 export function extractNameString(formattedString) {
   if (!formattedString) {
@@ -32,3 +33,187 @@ function customizer(objValue: Record<string, any>, srcValue: Record<string, any>
 export function deepMerge(obj1: Record<string, any>, obj2: Record<string, any>) {
   return mergeWith({}, obj1, obj2, customizer);
 }
+
+export const getPatientName = (patient: Patient) => {
+  let displayName = '';
+
+  if (patient?.person?.preferredName?.display) {
+    displayName = patient.person.preferredName.display;
+  } else if (patient?.person?.display || patient?.display) {
+    displayName = patient.person?.display || patient.display;
+  }
+
+  if (displayName) {
+    const nameParts = displayName.trim().split(/\s+/).filter(Boolean);
+
+    if (nameParts.length === 1) {
+      return {
+        FIRST_NAME: nameParts[0],
+        MIDDLE_NAME: '',
+        LAST_NAME: '',
+      };
+    }
+
+    if (nameParts.length === 2) {
+      return {
+        FIRST_NAME: nameParts[0],
+        MIDDLE_NAME: '',
+        LAST_NAME: nameParts[1],
+      };
+    }
+
+    return {
+      FIRST_NAME: nameParts[0],
+      MIDDLE_NAME: nameParts.slice(1, -1).join(' '),
+      LAST_NAME: nameParts[nameParts.length - 1],
+    };
+  }
+
+  return {
+    FIRST_NAME: '',
+    MIDDLE_NAME: '',
+    LAST_NAME: '',
+  };
+};
+
+export const getPatientGender = (patient: Patient) => {
+  const gender = patient?.person?.gender;
+  if (gender) {
+    const genderUpper = gender.toUpperCase();
+    if (genderUpper === 'MALE' || genderUpper === 'M') {
+      return 'M';
+    }
+    if (genderUpper === 'FEMALE' || genderUpper === 'F') {
+      return 'F';
+    }
+    return genderUpper.charAt(0);
+  }
+
+  return 'M';
+};
+export const getPatientAddress = (patient: Patient) => {
+  if (patient?.person?.preferredAddress?.display) {
+    const addressParts = patient.person.preferredAddress.display.split(',').map((part) => part.trim());
+    return {
+      VILLAGE: addressParts[0] || 'VILLAGE',
+      WARD: addressParts[1] || 'VILLAGE',
+      SUB_COUNTY: addressParts[2] || 'VILLAGE',
+      COUNTY: addressParts[3] || 'COUNTY',
+      GPS_LOCATION: null,
+      NEAREST_LANDMARK: null,
+    };
+  }
+
+  if (patient?.person?.attributes?.length) {
+    const addressAttrs = patient.person.attributes.filter(
+      (attr) =>
+        attr.attributeType?.display?.toLowerCase().includes('address') ||
+        attr.attributeType?.display?.toLowerCase().includes('location') ||
+        attr.attributeType?.display?.toLowerCase().includes('county') ||
+        attr.attributeType?.display?.toLowerCase().includes('village'),
+    );
+
+    if (addressAttrs.length > 0) {
+      return {
+        VILLAGE:
+          addressAttrs.find((a) => a.attributeType?.display?.toLowerCase().includes('village'))?.value || 'VILLAGE',
+        WARD: addressAttrs.find((a) => a.attributeType?.display?.toLowerCase().includes('ward'))?.value || 'VILLAGE',
+        SUB_COUNTY:
+          addressAttrs.find((a) => a.attributeType?.display?.toLowerCase().includes('sub'))?.value || 'VILLAGE',
+        COUNTY: addressAttrs.find((a) => a.attributeType?.display?.toLowerCase().includes('county'))?.value || 'COUNTY',
+        GPS_LOCATION: null,
+        NEAREST_LANDMARK: null,
+      };
+    }
+  }
+
+  return {
+    VILLAGE: 'VILLAGE',
+    WARD: 'VILLAGE',
+    SUB_COUNTY: 'VILLAGE',
+    COUNTY: 'COUNTY',
+    GPS_LOCATION: null,
+    NEAREST_LANDMARK: null,
+  };
+};
+
+export const getPatientIdentifiers = (patient: Patient) => {
+  const identifiers = [];
+
+  if (patient?.identifiers?.length) {
+    patient.identifiers.forEach((id) => {
+      if (id.identifier && id.identifierType?.name) {
+        const idTypeName = id.identifierType.name.toUpperCase();
+
+        if (
+          idTypeName.includes('CCC') ||
+          idTypeName.includes('COMPREHENSIVE') ||
+          idTypeName.includes('CARE') ||
+          idTypeName.includes('CLINIC')
+        ) {
+          identifiers.push({
+            ID: id.identifier,
+            IDENTIFIER_TYPE: 'CCC_NUMBER',
+            ASSIGNING_AUTHORITY: 'CCC',
+          });
+        } else if (idTypeName.includes('NATIONAL') || idTypeName.includes('ID')) {
+          identifiers.push({
+            ID: id.identifier,
+            IDENTIFIER_TYPE: 'NATIONAL_ID',
+            ASSIGNING_AUTHORITY: 'GOK',
+          });
+        } else if (idTypeName.includes('FACILITY') || idTypeName.includes('MRN')) {
+          identifiers.push({
+            ID: id.identifier,
+            IDENTIFIER_TYPE: 'FACILITY_ID',
+            ASSIGNING_AUTHORITY: 'FACILITY',
+          });
+        }
+      }
+    });
+  }
+
+  if (identifiers.length === 0) {
+    const defaultCccNumber = `1234567${String(Math.floor(Math.random() * 100)).padStart(2, '0')}${Math.floor(
+      Math.random() * 10,
+    )}`;
+    identifiers.push({
+      ID: defaultCccNumber,
+      IDENTIFIER_TYPE: 'CCC_NUMBER',
+      ASSIGNING_AUTHORITY: 'CCC',
+    });
+  }
+
+  return identifiers;
+};
+
+export const getPhoneNumber = (patient: Patient) => {
+  if (patient?.person?.attributes?.length) {
+    const phoneAttr = patient.person.attributes.find(
+      (attr) =>
+        attr.attributeType?.display?.toLowerCase().includes('phone') ||
+        attr.attributeType?.display?.toLowerCase().includes('contact') ||
+        attr.attributeType?.display?.toLowerCase().includes('telephone'),
+    );
+    return phoneAttr?.value || '';
+  }
+  return '';
+};
+
+export const formatBirthDate = (patient: Patient) => {
+  const birthDate = patient?.person?.birthdate;
+  if (birthDate) {
+    return formatDate(new Date(birthDate), { mode: 'standard' });
+  }
+  return '';
+};
+
+export const getPatientDeathInfo = (patient: Patient) => {
+  const dead = patient?.person?.dead;
+  const deathDate = patient?.person?.deathDate;
+
+  return {
+    DEATH_DATE: dead && deathDate ? formatDate(new Date(deathDate), { mode: 'standard' }) : null,
+    DEATH_INDICATOR: dead ? 'YES' : null,
+  };
+};

package/src/workspace/referral-workspace.resource.ts

@@ -1,45 +1,81 @@
-import { openmrsFetch } from '@openmrs/esm-framework';
+import { openmrsFetch, OpenmrsResource, restBaseUrl, useConfig } from '@openmrs/esm-framework';
 import useSWRImmutable from 'swr/immutable';
+import { FacilityResponse, ReasonResponse, ReferralError, ReferralPayload, ReferralResponse } from '../types';
+import { ReferralConfigObject } from '../config-schema';
 
-export interface Concept {
-  uuid: string;
-  name: {
-    name: string;
-  };
-  conceptClass: {
-    name: string;
-  };
-}
-
-export interface ReasonResponse {
-  results: Concept[];
-}
-export interface Facility {
-  uuid: string;
-  name: string;
-  attributes: [
-    {
-      value: string;
-    },
-  ];
-}
-
-export interface FacilityResponse {
-  results: Facility[];
-}
-
-export const useReason = (searchTerm: string) => {
-  const customRepresentation = 'custom:(uuid,name)';
+export const useReasons = (searchTerm: string) => {
+  const customRepresentation = 'custom:(uuid,name:(name))';
   const url = `/ws/rest/v1/concept?v=${customRepresentation}&q=${searchTerm}&limit=15`;
   const { data, error } = useSWRImmutable<{ data: ReasonResponse }>(searchTerm ? url : null, openmrsFetch);
 
   return { data: data?.data?.results, error };
 };
 
-export const useFacility = (searchTerm: string) => {
+export const useFacilities = (searchTerm: string) => {
   const customRepresentation = 'custom:(uuid,name,attributes:(value))';
   const url = `/ws/rest/v1/location?v=${customRepresentation}&q=${searchTerm}&limit=15`;
   const { data, error } = useSWRImmutable<{ data: FacilityResponse }>(searchTerm ? url : null, openmrsFetch);
 
   return { data: data?.data?.results, error };
 };
+
+export const useSendReferralToArtDirectory = () => {
+  const { artDirectoryUrl } = useConfig<ReferralConfigObject>();
+
+  const sendReferral = async (apiPayload: ReferralPayload): Promise<ReferralResponse> => {
+    try {
+      const response = await openmrsFetch(artDirectoryUrl, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          Accept: 'application/json',
+        },
+        body: JSON.stringify(apiPayload),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        const error: ReferralError = new Error(
+          `Failed to send referral: ${response.status} ${response.statusText}. ${errorText}`,
+        );
+        error.status = response.status;
+        error.statusText = response.statusText;
+        error.responseBody = errorText;
+        throw error;
+      }
+
+      return {
+        success: true,
+        data: await response.json(),
+        payload: apiPayload,
+      };
+    } catch (error) {
+      if (error instanceof Error && 'status' in error) {
+        throw error;
+      }
+
+      const networkError: ReferralError = new Error(
+        `Network error while sending referral: ${error instanceof Error ? error.message : 'Unknown error'}`,
+      );
+      throw networkError;
+    }
+  };
+
+  return { mutate: sendReferral };
+};
+
+export function useSystemSetting(key: string) {
+  const { data, isLoading } = useSWRImmutable<{ data: { results: Array<OpenmrsResource> } }>(
+    `${restBaseUrl}systemsetting?q=${key}&v=full`,
+    openmrsFetch,
+    {
+      revalidateOnFocus: false,
+      revalidateOnReconnect: false,
+    },
+  );
+
+  const mflCodeResource = data?.data?.results?.find((resource) => resource.property === 'facility.mflcode');
+  const mflCodeValue = mflCodeResource?.value;
+
+  return { mflCodeValue, isLoading };
+}