@kenyaemr/esm-patient-registration-app 4.4.0 → 4.4.2

package/src/patient-registration/patient-registration-hooks.ts

@@ -1,16 +1,20 @@
 import { FetchResponse, getSynchronizationItems, openmrsFetch, useConfig, usePatient } from '@openmrs/esm-framework';
+import last from 'lodash-es/last';
 import camelCase from 'lodash-es/camelCase';
 import { Dispatch, useEffect, useMemo, useState } from 'react';
 import useSWR from 'swr';
 import { v4 } from 'uuid';
 import { RegistrationConfig } from '../config-schema';
 import { patientRegistration } from '../constants';
+import { useConceptAnswers, useGlobalProperties } from '../patient-verification/patient-verification-hook';
 import {
   FormValues,
   PatientRegistration,
   PatientUuidMapType,
   PersonAttributeResponse,
   PatientIdentifierResponse,
+  ObsResponse,
+  ConceptAnswers,
   Encounter,
 } from './patient-registration-types';
 import {
@@ -23,12 +27,13 @@ import {
 import { useInitialPatientRelationships } from './section/patient-relationships/relationships.resource';
 
 export function useInitialFormValues(patientUuid: string): [FormValues, Dispatch<FormValues>] {
+  const { martialStatus, education, occupation, educationLoad, loadingStatus } = useConcepts();
   const { isLoading: isLoadingPatientToEdit, patient: patientToEdit } = usePatient(patientUuid);
   const { data: attributes, isLoading: isLoadingAttributes } = useInitialPersonAttributes(patientUuid);
   const { data: identifiers, isLoading: isLoadingIdentifiers } = useInitialPatientIdentifiers(patientUuid);
   const { data: relationships, isLoading: isLoadingRelationships } = useInitialPatientRelationships(patientUuid);
-  const { data: encounters } = useInitialEncounters(patientUuid, patientToEdit);
-
+  const { data: obs, isLoading: isLoadingObs, obs: observations } = usePatientObs(patientUuid);
+  const { data: token, isLoading: isLoadingToken } = useGlobalProperties();
   const [initialFormValues, setInitialFormValues] = useState<FormValues>({
     patientUuid: v4(),
     givenName: '',
@@ -77,6 +82,14 @@ export function useInitialFormValues(patientUuid: string): [FormValues, Dispatch
     })();
   }, [isLoadingPatientToEdit, patientToEdit, patientUuid]);
 
+  // Setting authentication token
+
+  useEffect(() => {
+    if (!isLoadingToken && token) {
+      setInitialFormValues((initialFormValues) => ({ ...initialFormValues, token: String(token.access_token) }));
+    }
+  }, [isLoadingToken, token]);
+
   // Set initial patient relationships
   useEffect(() => {
     if (!isLoadingRelationships && relationships) {
@@ -114,15 +127,24 @@ export function useInitialFormValues(patientUuid: string): [FormValues, Dispatch
     }
   }, [attributes, setInitialFormValues, isLoadingAttributes]);
 
-  // Set Initial registration encounters
+  // Set initial patient obs
+
   useEffect(() => {
-    if (patientToEdit && encounters) {
+    if (!isLoadingObs) {
+      setInitialFormValues((initialFormValues) => ({ ...initialFormValues, obs: obs, observation: observations }));
+    }
+  }, [isLoadingObs]);
+
+  // Set Initial encounter
+
+  useEffect(() => {
+    if (!educationLoad || !loadingStatus) {
       setInitialFormValues((initialFormValues) => ({
         ...initialFormValues,
-        obs: encounters as Record<string, string>,
+        concepts: [...occupation, ...martialStatus, ...education],
       }));
     }
-  }, [encounters, patientToEdit]);
+  }, [educationLoad, loadingStatus]);
 
   return [initialFormValues, setInitialFormValues];
 }
@@ -264,3 +286,52 @@ function getPatientAttributeUuidMapForPatient(attributes: Array<PersonAttributeR
   });
   return attributeUuidMap;
 }
+export function usePatientObs(patientUuid: string) {
+  const {
+    registrationObs: { encounterTypeUuid },
+  } = useConfig() as RegistrationConfig;
+  const url = `/ws/rest/v1/encounter?patient=${patientUuid}&encounterType=${encounterTypeUuid}&v=custom:(obs:(uuid,display,concept:(uuid,display),value:(uuid,display)))`;
+  const { data, isLoading, error } = useSWR<{ data: ObsResponse }>(patientUuid ? url : null, openmrsFetch);
+  let obsObject = {};
+  const patientObs = last(data?.data?.results)?.obs?.forEach((ob) => {
+    Object.assign(obsObject, { [ob.concept.uuid]: ob.value.uuid });
+  });
+  return { data: obsObject, isLoading, error, obs: data?.data };
+}
+
+function useConcepts() {
+  const { data: martialStatus, isLoading: loadingStatus } = useConceptAnswers('1054AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA');
+  const { data: education, isLoading: educationLoad } = useConceptAnswers('1712AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA');
+  const occupation: Array<ConceptAnswers> = [
+    {
+      uuid: '1538AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+      display: 'Farmer',
+    },
+    {
+      uuid: '1540AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+      display: 'Employee',
+    },
+    {
+      uuid: '1539AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+      display: 'Trader',
+    },
+    {
+      uuid: '159465AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+      display: 'Student',
+    },
+    {
+      uuid: '159466AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+      display: 'Driver',
+    },
+    {
+      uuid: '1107AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+      display: 'None',
+    },
+    {
+      uuid: '5622AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+      display: 'Other',
+    },
+  ];
+
+  return { martialStatus, education, occupation, loadingStatus, educationLoad };
+}

package/src/patient-registration/patient-registration-types.tsx

@@ -1,4 +1,4 @@
-import { Session } from '@openmrs/esm-framework';
+import { OpenmrsResource, Session } from '@openmrs/esm-framework';
 import { RegistrationConfig } from '../config-schema';
 import { SavePatientTransactionManager } from './form-manager';
 
@@ -185,6 +185,9 @@ export interface FormValues {
   address: {
     [addressField: string]: string;
   };
+  observation?: ObsResponse;
+  concepts?: Array<ConceptAnswers>;
+  token?: string;
 }
 
 export interface PatientUuidMapType {
@@ -263,3 +266,6 @@ export interface ConceptAnswers {
   display: string;
   uuid: string;
 }
+export interface ObsResponse {
+  results: Array<{ obs: Array<{ uuid: string; display: string; value: OpenmrsResource; concept: OpenmrsResource }> }>;
+}

package/src/patient-registration/patient-registration.component.tsx

@@ -1,6 +1,6 @@
 import React, { useState, useEffect, useContext, useMemo, useRef } from 'react';
 import { Button, Link } from '@carbon/react';
-import { XAxis } from '@carbon/react/icons';
+import { XAxis, ShareKnowledge } from '@carbon/react/icons';
 import { Router, useLocation, useParams } from 'react-router-dom';
 import { useTranslation } from 'react-i18next';
 import { Formik, Form, FormikHelpers } from 'formik';
@@ -17,12 +17,19 @@ import {
   parseAddressTemplateXml,
   scrollIntoView,
 } from './patient-registration-utils';
-import { useInitialAddressFieldValues, useInitialFormValues, usePatientUuidMap } from './patient-registration-hooks';
+import {
+  useInitialAddressFieldValues,
+  useInitialFormValues,
+  usePatientObs,
+  usePatientUuidMap,
+} from './patient-registration-hooks';
 import { ResourcesContext } from '../offline.resources';
 import { builtInSections, RegistrationConfig, SectionDefinition } from '../config-schema';
 import { SectionWrapper } from './section/section-wrapper.component';
 import BeforeSavePrompt from './before-save-prompt';
 import styles from './patient-registration.scss';
+import PatientVerification from '../patient-verification/patient-verification.component';
+import { handleSavePatientToClientRegistry } from '../patient-verification/patient-verification-hook';
 
 let exportedInitialFormValuesForTesting = {} as FormValues;
 
@@ -50,6 +57,9 @@ export const PatientRegistration: React.FC<PatientRegistrationProps> = ({ savePa
   const { data: photo } = usePatientPhoto(patientToEdit?.id);
   const savePatientTransactionManager = useRef(new SavePatientTransactionManager());
   const fieldDefinition = config?.fieldDefinitions?.filter((def) => def.type === 'address');
+  const [enableClientRegistry, setEnableClientRegistry] = useState(
+    inEditMode ? initialFormValues.identifiers['nationalUniquePatientIdentifier']?.identifierValue : false,
+  );
 
   useEffect(() => {
     exportedInitialFormValuesForTesting = initialFormValues;
@@ -175,6 +185,18 @@ export const PatientRegistration: React.FC<PatientRegistrationProps> = ({ savePa
                     </Link>
                   </div>
                 ))}
+                <Button
+                  renderIcon={ShareKnowledge}
+                  disabled={!currentSession || !identifierTypes}
+                  onClick={() => {
+                    setEnableClientRegistry(true);
+                    props.isValid
+                      ? handleSavePatientToClientRegistry(props.values, props.setValues, inEditMode)
+                      : props.validateForm().then((errors) => displayErrors(errors));
+                  }}
+                  className={styles.submitButton}>
+                  {t('postToRegistry', 'Post to registry')}
+                </Button>
                 <Button
                   className={styles.submitButton}
                   type="submit"
@@ -182,7 +204,7 @@ export const PatientRegistration: React.FC<PatientRegistrationProps> = ({ savePa
                   // Current session and identifiers are required for patient registration.
                   // If currentSession or identifierTypes are not available, then the
                   // user should be blocked to register the patient.
-                  disabled={!currentSession || !identifierTypes}>
+                  disabled={!enableClientRegistry}>
                   {inEditMode ? t('updatePatient', 'Update Patient') : t('registerPatient', 'Register Patient')}
                 </Button>
                 <Button className={styles.cancelButton} kind="tertiary" onClick={cancelRegistration}>
@@ -204,6 +226,7 @@ export const PatientRegistration: React.FC<PatientRegistrationProps> = ({ savePa
                   isOffline,
                   initialFormValues: props.initialValues,
                 }}>
+                <PatientVerification props={props} />
                 {sections.map((section, index) => (
                   <SectionWrapper
                     key={`registration-section-${section.id}`}

package/src/patient-verification/assets/counties.json

@@ -0,0 +1,236 @@
+[
+    {
+        "name": "Mombasa",
+        "code": 1,
+        "capital": "Mombasa City"
+    },
+    {
+        "name": "Kwale",
+        "code": 2,
+        "capital": "Kwale"
+    },
+    {
+        "name": "Kilifi",
+        "code": 3,
+        "capital": "Kilifi"
+    },
+    {
+        "name": "Tana River",
+        "code": 4,
+        "capital": "Hola"
+    },
+    {
+        "name": "Lamu",
+        "code": 5,
+        "capital": "Lamu"
+    },
+    {
+        "name": "Taita taveta",
+        "code": 6,
+        "capital": "Voi"
+    },
+    {
+        "name": "Garissa",
+        "code": 7,
+        "capital": "Garissa"
+    },
+    {
+        "name": "Wajir",
+        "code": 8,
+        "capital": "Wajir"
+    },
+    {
+        "name": "Mandera",
+        "code": 9,
+        "capital": "Mandera"
+    },
+    {
+        "name": "Marsabit",
+        "code": 10,
+        "capital": "Marsabit"
+    },
+    {
+        "name": "Isiolo",
+        "code": 11,
+        "capital": "Isiolo"
+    },
+    {
+        "name": "Meru",
+        "code": 12,
+        "capital": "Meru"
+    },
+    {
+        "name": "Tharaka nithi",
+        "code": 13,
+        "capital": "Chuka"
+    },
+    {
+        "name": "Embu",
+        "code": 14,
+        "capital": "Embu"
+    },
+    {
+        "name": "Kitui",
+        "code": 15,
+        "capital": "Kitui"
+    },
+    {
+        "name": "Machakos",
+        "code": 16,
+        "capital": "Machakos"
+    },
+    {
+        "name": "Makueni",
+        "code": 17,
+        "capital": "Wote"
+    },
+    {
+        "name": "Nyandarua",
+        "code": 18,
+        "capital": "Ol Kalou"
+    },
+    {
+        "name": "Nyeri",
+        "code": 19,
+        "capital": "Nyeri"
+    },
+    {
+        "name": "Kirinyaga",
+        "code": 20,
+        "capital": "Kerugoya/Kutus"
+    },
+    {
+        "name": "Murang'a",
+        "code": 21,
+        "capital": "Murang'a"
+    },
+    {
+        "name": "Kiambu",
+        "code": 22,
+        "capital": "Kiambu"
+    },
+    {
+        "name": "Turkana",
+        "code": 23,
+        "capital": "Lodwar"
+    },
+    {
+        "name": "West pokot",
+        "code": 24,
+        "capital": "Kapenguria"
+    },
+    {
+        "name": "Samburu",
+        "code": 25,
+        "capital": "Maralal"
+    },
+    {
+        "name": "Trans nzoia",
+        "code": 26,
+        "capital": "Kitale"
+    },
+    {
+        "name": "Uasin gishu",
+        "code": 27,
+        "capital": "Eldoret"
+    },
+    {
+        "name": "Elgeyo marakwet",
+        "code": 28,
+        "capital": "Iten"
+    },
+    {
+        "name": "Nandi",
+        "code": 29,
+        "capital": "Kapsabet"
+    },
+    {
+        "name": "Baringo",
+        "code": 30,
+        "capital": "Kabarnet"
+    },
+    {
+        "name": "Laikipia",
+        "code": 31,
+        "capital": "Rumuruti"
+    },
+    {
+        "name": "Nakuru",
+        "code": 32,
+        "capital": "Nakuru"
+    },
+    {
+        "name": "Narok",
+        "code": 33,
+        "capital": "Narok"
+    },
+    {
+        "name": "Kajiado",
+        "code": 34
+    },
+    {
+        "name": "Kericho",
+        "code": 35,
+        "capital": "Kericho"
+    },
+    {
+        "name": "Bomet",
+        "code": 36,
+        "capital": "Bomet"
+    },
+    {
+        "name": "Kakamega",
+        "code": 37,
+        "capital": "Kakamega"
+    },
+    {
+        "name": "Vihiga",
+        "code": 38,
+        "capital": "Vihiga"
+    },
+    {
+        "name": "Bungoma",
+        "code": 39,
+        "capital": "Bungoma"
+    },
+    {
+        "name": "Busia",
+        "code": 40,
+        "capital": "Busia"
+    },
+    {
+        "name": "Siaya",
+        "code": 41,
+        "capital": "Siaya"
+    },
+    {
+        "name": "Kisumu",
+        "code": 42,
+        "capital": "Kisumu"
+    },
+    {
+        "name": "Homa bay",
+        "code": 43,
+        "capital": "Homa Bay"
+    },
+    {
+        "name": "Migori",
+        "code": 44,
+        "capital": "Migori"
+    },
+    {
+        "name": "Kisii",
+        "code": 45,
+        "capital": "Kisii"
+    },
+    {
+        "name": "Nyamira",
+        "code": 46,
+        "capital": "Nyamira"
+    },
+    {
+        "name": "Nairobi",
+        "code": 47,
+        "capital": "Nairobi City"
+    }
+]

package/src/patient-verification/assets/verification-assets.ts

@@ -0,0 +1,11 @@
+export const countries = [
+  { name: 'Kenya', initials: 'KE' },
+  { name: 'Uganda', initials: 'UG' },
+  { name: 'Tanzania', initials: 'TZ' },
+];
+
+export const verificationIdentifierTypes = [
+  { name: 'National ID', value: 'national-id' },
+  { name: 'Passport', value: 'passport' },
+  { name: 'Birth certificate number', value: 'birth-certificate-number' },
+];

package/src/patient-verification/patient-verification-hook.tsx

@@ -0,0 +1,156 @@
+import { FetchResponse, openmrsFetch, showNotification, showToast } from '@openmrs/esm-framework';
+import { ConceptAnswers, ConceptResponse, FormValues } from '../patient-registration/patient-registration-types';
+import { generateNUPIPayload, handleClientRegistryResponse } from './patient-verification-utils';
+import useSWR from 'swr';
+import useSWRImmutable from 'swr/immutable';
+
+export function searchClientRegistry(identifierType: string, searchTerm: string, token: string) {
+  const url = `https://afyakenyaapi.health.go.ke/partners/registry/search/KE/${identifierType}/${searchTerm}`;
+  return fetch(url, { headers: { Authorization: `Bearer ${token}` } }).then((r) => r.json());
+}
+
+export function savePatientToClientRegistry(formValues: FormValues) {
+  const createdRegistryPatient = generateNUPIPayload(formValues);
+  return fetch(`https://afyakenyaapi.health.go.ke/partners/registry`, {
+    headers: { Authorization: `Bearer ${formValues.token}`, 'Content-Type': 'application/json' },
+    method: 'POST',
+    body: JSON.stringify(createdRegistryPatient),
+  });
+}
+
+export async function handleSavePatientToClientRegistry(
+  formValues: FormValues,
+  setValues: (values: FormValues, shouldValidate?: boolean) => void,
+  inEditMode: boolean,
+) {
+  const mode = inEditMode ? 'edit' : 'new';
+  switch (mode) {
+    case 'edit': {
+      try {
+        const searchResponse = await searchClientRegistry(
+          'national-id',
+          formValues.identifiers['nationalId'].identifierValue,
+          formValues.token,
+        );
+
+        // if client does not exists post client to registry
+        if (searchResponse?.clientExists === false) {
+          postToRegistry(formValues, setValues);
+        }
+      } catch (error) {
+        showToast({
+          title: 'Client registry error',
+          description: `${error}`,
+          millis: 10000,
+          kind: 'error',
+          critical: true,
+        });
+      }
+      return;
+    }
+    case 'new': {
+      postToRegistry(formValues, setValues);
+    }
+  }
+}
+
+export function useConceptAnswers(conceptUuid: string): { data: Array<ConceptAnswers>; isLoading: boolean } {
+  const { data, error, isLoading } = useSWR<FetchResponse<ConceptResponse>, Error>(
+    `/ws/rest/v1/concept/${conceptUuid}`,
+    openmrsFetch,
+  );
+  if (error) {
+    showToast({
+      title: error.name,
+      description: error.message,
+      kind: 'error',
+    });
+  }
+  return { data: data?.data?.answers ?? [], isLoading };
+}
+
+const urlencoded = new URLSearchParams();
+urlencoded.append('client_id', 'palladium.partner.client');
+urlencoded.append('client_secret', '28f95b2a');
+urlencoded.append('grant_type', 'client_credentials');
+urlencoded.append('scope', 'DHP.Gateway DHP.Partners');
+
+const swrFetcher = async (url) => {
+  const res = await fetch(url, {
+    method: 'POST',
+    body: urlencoded,
+    redirect: 'follow',
+  });
+
+  // If the status code is not in the range 200-299,
+  // we still try to parse and throw it.
+  if (!res.ok) {
+    const error = new Error('An error occurred while fetching the data.') as any;
+    // Attach extra info to the error object.
+    error.info = await res.json();
+    error.status = res.status;
+    throw error;
+  }
+
+  return res.json();
+};
+
+export function useGlobalProperties() {
+  const { data, isLoading, error } = useSWRImmutable(
+    `https://afyakenyaidentityapi.health.go.ke/connect/token`,
+    swrFetcher,
+    { refreshInterval: 864000 },
+  );
+  return { data: data, isLoading, error };
+}
+
+async function postToRegistry(
+  formValues: FormValues,
+  setValues: (values: FormValues, shouldValidate?: boolean) => void,
+) {
+  try {
+    const clientRegistryResponse = await savePatientToClientRegistry(formValues);
+    if (clientRegistryResponse.ok) {
+      const savedValues = await clientRegistryResponse.json();
+      const nupiIdentifier = {
+        ['nationalUniquePatientIdentifier']: {
+          identifierTypeUuid: 'f85081e2-b4be-4e48-b3a4-7994b69bb101',
+          identifierName: 'National Unique patient identifier',
+          identifierValue: savedValues['clientNumber'],
+          initialValue: savedValues['clientNumber'],
+          identifierUuid: undefined,
+          selectedSource: { uuid: '', name: '' },
+          preferred: false,
+          required: false,
+        },
+      };
+      setValues({ ...formValues, identifiers: { ...formValues.identifiers, ...nupiIdentifier } });
+      showToast({
+        title: 'Posted patient to client registry successfully',
+        description: `The patient has been saved to client registry`,
+        kind: 'success',
+      });
+    } else {
+      const responseError = await clientRegistryResponse.json();
+      const errorMessage = Object.values(responseError.errors ?? {})
+        .map((error: any) => error.join())
+        .toString();
+      setValues({
+        ...formValues,
+        attributes: {
+          ...formValues.attributes,
+          ['869f623a-f78e-4ace-9202-0bed481822f5']: 'Failed validation',
+          ['752a0331-5293-4aa5-bf46-4d51aaf2cdc5']: 'Failed',
+        },
+      });
+      showNotification({
+        title: responseError.title,
+        description: errorMessage,
+        kind: 'warning',
+        millis: 150000,
+      });
+    }
+  } catch (error) {
+    showNotification({ kind: 'error', title: 'NUPI Post failed', description: JSON.stringify(error) });
+  }
+}