@kenyaemr/esm-admin-app 5.4.4-pre.26 → 5.4.4-pre.265

package/src/components/facility-setup/facility-info.scss

@@ -2,86 +2,167 @@
 @use '@carbon/type';
 @use '@carbon/colors';
 
-.omrs-main-content {
-  background-color: colors.$white;
+.root {
+  padding: layout.$spacing-05;
 }
 
-.bottomBorder {
+.pageHeader {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
   margin-bottom: layout.$spacing-05;
+  margin-right: layout.$spacing-08;
+}
+
+.pageTitle {
+  @include type.type-style('heading-03');
+  color: colors.$gray-100;
+  margin: 0;
 }
 
-.btnLayer {
+.pageActions {
   display: flex;
-  padding-top: layout.$spacing-05;
-  padding-right: layout.$spacing-05;
-  padding-bottom: layout.$spacing-05;
-  margin-top: layout.$spacing-05;
-  flex-direction: row;
-  justify-content: flex-end;
-  background-color: white;
-  width: 100%;
+  align-items: center;
+  gap: layout.$spacing-03;
+  margin-left: auto;
+  margin-right: layout.$spacing-12;
+}
+.grid {
+  margin-top: 0;
+}
+
+.sectionCard {
+  padding: layout.$spacing-05 !important;
+  background: white !important;
+  border: 1px solid colors.$gray-20 !important;
+  border-radius: 8px !important;
+  margin-bottom: layout.$spacing-05;
+  box-shadow: none !important;
 }
 
-.tableLayer {
-  padding-left: layout.$spacing-05;
-  padding-right: layout.$spacing-05;
-  background: white;
-  padding-top: layout.$spacing-01;
+.sectionTitle {
+  @include type.type-style('label-01');
+  font-weight: 600;
+  color: colors.$gray-60;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  margin: 0 0 layout.$spacing-04;
+  padding-bottom: layout.$spacing-03;
+  border-bottom: 1px solid colors.$gray-20;
 }
 
-.loading {
+.sectionBody {
   display: flex;
-  padding-top: layout.$spacing-05;
-  padding-right: layout.$spacing-05;
-  padding-bottom: layout.$spacing-05;
-  margin-top: layout.$spacing-05;
-  flex-direction: row;
-  justify-content: flex-end;
-  background-color: white;
-  width: 100%;
+  flex-direction: column;
 }
 
-.facilityInfoContainer {
-  margin: layout.$spacing-05;
+/* ── Info rows ── */
+.infoRow {
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+  padding: layout.$spacing-02 0;
+  border-bottom: 1px solid colors.$gray-10;
+
+  &:last-child {
+    border-bottom: none;
+  }
 }
 
-.card {
-  padding: 1rem;
-  background-color: colors.$gray-10;
-  border: 1px solid #e0e0e0;
-  border-radius: 2px;
-  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+.infoLabel {
+  @include type.type-style('body-01');
+  color: colors.$gray-60;
+  flex-shrink: 0;
+  margin-right: layout.$spacing-05;
 }
 
-.cardTitle {
-  margin-bottom: 1rem;
-  font-size: 1.25rem;
-  font-weight: 600;
+.infoValue {
+  @include type.type-style('body-01');
+  font-weight: 500;
+  color: colors.$gray-100;
+  text-align: right;
+  word-break: break-word;
 }
 
-.cardDivider {
-  border: none;
-  border-top: 1px solid #e0e0e0;
-  margin: 0.5rem 0;
+.emptyValue {
+  color: colors.$gray-40;
+  font-weight: 400;
 }
-.cardContent {
-  font-size: 1rem;
-  line-height: 1.8;
+
+.contactValue {
+  display: flex;
+  align-items: center;
+  gap: layout.$spacing-02;
 }
 
-.cardContent p {
+.adminCard {
   display: flex;
-  justify-content: space-between;
-  margin-bottom: 0.5rem;
+  align-items: flex-start;
+  gap: layout.$spacing-04;
+  margin-top: layout.$spacing-04;
+  padding-top: layout.$spacing-04;
+  border-top: 1px solid colors.$gray-10;
 }
-.cardContent br {
+.adminName {
+  @include type.type-style('body-01');
+  font-weight: 500;
+  color: colors.$gray-100;
+  margin: 0 0 layout.$spacing-01;
+  text-transform: capitalize;
+}
+
+.adminDetail {
+  @include type.type-style('label-01');
+  color: colors.$gray-60;
+  margin: 0;
+}
+
+.serviceList {
   display: flex;
-  justify-content: space-between;
-  margin-bottom: 0.5rem;
+  flex-wrap: wrap;
+  gap: layout.$spacing-02;
+}
+
+.emptyState {
+  @include type.type-style('body-01');
+  color: colors.$gray-40;
+  font-style: italic;
+  margin: 0;
+}
+
+.pageMeta {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.lastSynced {
+  font-size: 0.875rem;
+  color: var(--cds-text-secondary, #525252);
+  display: flex;
+  align-items: end;
 }
 
-.cardContent strong {
-  min-width: 150px;
-  display: inline-block;
-  color: #393939;
+.bedGrid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+  gap: layout.$spacing-04;
+
+  .infoRow {
+    display: flex;
+    justify-content: flex-start;
+    gap: layout.$spacing-03;
+    padding: layout.$spacing-02 layout.$spacing-03;
+    background: colors.$gray-10;
+    border-radius: 4px;
+    border-bottom: none;
+  }
+
+  .infoLabel {
+    margin-right: 0;
+  }
+
+  .infoValue {
+    text-align: left;
+  }
 }

package/src/components/facility-setup/facility-setup.component.tsx

@@ -1,9 +1,9 @@
 import { Layer } from '@carbon/react';
 import React from 'react';
 import { useTranslation } from 'react-i18next';
-import FacilityInfo from './facility-info.component';
 import styles from './facility-setup.scss';
 import Header from './header/header.component';
+import FacilityRegistryView from './facility-info.component';
 
 const FacilitySetup: React.FC = () => {
   const { t } = useTranslation();
@@ -12,7 +12,7 @@ const FacilitySetup: React.FC = () => {
       <Header title={t('facilityDetails', 'Facility Details')} />
 
       <Layer className={styles.tableLayer}>
-        <FacilityInfo />
+        <FacilityRegistryView />
       </Layer>
     </div>
   );

package/src/components/facility-setup/header/header.component.tsx

@@ -1,7 +1,5 @@
 import React from 'react';
-import { useTranslation } from 'react-i18next';
-import { Development } from '@carbon/react/icons';
-import { useSession, PageHeader } from '@openmrs/esm-framework';
+import { PageHeader, PageHeaderContent, HomePictogram } from '@openmrs/esm-framework';
 import styles from './header.scss';
 
 interface HeaderProps {
@@ -9,14 +7,10 @@ interface HeaderProps {
 }
 
 const Header: React.FC<HeaderProps> = ({ title }) => {
-  const { t } = useTranslation();
-  const session = useSession();
-  const location = session?.sessionLocation?.display;
-
   return (
-    <div className={styles.header}>
-      <PageHeader title={title} illustration={<Development size={32} />} className={styles.header} />
-    </div>
+    <PageHeader className={styles.pageHeader}>
+      <PageHeaderContent title={title} illustration={<HomePictogram />} />
+    </PageHeader>
   );
 };
 

package/src/components/facility-setup/header/header.scss

@@ -2,18 +2,12 @@
 @use '@carbon/type';
 @use '@carbon/colors';
 
-.header {
+.pageHeader {
   @include type.type-style('body-compact-02');
   height: layout.$spacing-12;
   display: flex;
   justify-content: space-between;
   padding: layout.$spacing-05;
-  background: white;
-  border: 1px solid colors.$gray-20;
-}
-.svgContainer svg {
-  width: layout.$spacing-10;
-  height: layout.$spacing-10;
-  margin-right: layout.$spacing-06;
-  fill: var(--brand-03);
+  background: colors.$white-0;
+  border-bottom: 1px solid colors.$gray-20;
 }

package/src/components/facility-setup/shared/custom-info.component.tsx

@@ -0,0 +1,9 @@
+import React from 'react';
+import styles from '../facility-info.scss';
+
+export const InfoRow: React.FC<{ label: string; value?: React.ReactNode }> = ({ label, value }) => (
+  <div className={styles.infoRow}>
+    <span className={styles.infoLabel}>{label}</span>
+    <span className={styles.infoValue}>{value ?? <span className={styles.emptyValue}>—</span>}</span>
+  </div>
+);

package/src/components/facility-setup/shared/custom-section-card.component.tsx

@@ -0,0 +1,10 @@
+import React from 'react';
+import { Tile } from '@carbon/react';
+import styles from '../facility-info.scss';
+
+export const SectionCard: React.FC<{ title: string; children: React.ReactNode }> = ({ title, children }) => (
+  <Tile className={styles.sectionCard}>
+    <p className={styles.sectionTitle}>{title}</p>
+    <div className={styles.sectionBody}>{children}</div>
+  </Tile>
+);

package/src/components/facility-setup/shared/custom-status-tag.component.tsx

@@ -0,0 +1,22 @@
+import React from 'react';
+import { Tag } from '@carbon/react';
+import styles from '../facility-info.scss';
+
+export const StatusTag: React.FC<{ value?: string }> = ({ value }) => {
+  if (!value || value === '--' || value.trim() === '') {
+    return <span className={styles.emptyValue}>—</span>;
+  }
+  const upper = value.toUpperCase();
+  const type =
+    upper === 'ACTIVE' || upper === 'LICENSED'
+      ? 'green'
+      : upper === 'INACTIVE' || upper === 'SUSPENDED'
+      ? 'red'
+      : 'gray';
+  const label = `${value.charAt(0).toUpperCase()}${value.slice(1).toLowerCase()}`;
+  return (
+    <Tag type={type} size="sm">
+      {label}
+    </Tag>
+  );
+};

package/src/components/facility-setup/type/index.ts

@@ -0,0 +1,61 @@
+export type FacilityRegistryAddress = {
+  country?: string;
+  county_code?: string;
+  county?: string;
+  sub_county_code?: string;
+  sub_county?: string;
+  postal_address?: string;
+  physical_location?: string;
+  town?: string;
+  latitude?: number | null;
+  longitude?: number | null;
+};
+
+export type FacilityRegistryBedOccupancy = {
+  totalBeds?: number;
+  normalBeds?: number;
+  icuBeds?: number;
+  hduBeds?: number;
+  dialysisBeds?: number;
+  numberOfCots?: number;
+};
+
+export type FacilityRegistryRecord = {
+  fr_code: string;
+  fid_code?: string;
+  registration_number?: string;
+  official_name?: string;
+  keph_level?: string;
+  facility_type?: string;
+  facility_ownership?: string;
+  license_status?: string;
+  license_number?: string;
+  license_start_date?: string | null;
+  license_end_date?: string | null;
+  regulatory_body?: string;
+  sha_contract_status?: string;
+  sha_contract_start_date?: string | null;
+  sha_contract_end_date?: string | null;
+  is_hub?: boolean;
+  facility_phone_number?: string;
+  facility_email?: string;
+  facility_administrator_name?: string;
+  facility_administrator_email?: string;
+  facility_administrator_phone?: string;
+  facility_administrator_identifier?: string;
+  address?: FacilityRegistryAddress;
+  regulatory_operational_status?: string;
+  sha_operational_status?: string;
+  bed_occupancy?: FacilityRegistryBedOccupancy;
+  sha_contracted_services?: Array<{ name?: string } | string>;
+  last_synced_at?: string;
+  last_sync_status?: 'SUCCESS' | 'FAILURE';
+};
+
+export type FacilityRegistrySyncResult = {
+  success: boolean;
+  fr_code: string;
+  official_name: string;
+  last_synced_at: string;
+  last_sync_status: 'SUCCESS' | 'FAILURE';
+};

package/src/components/facility-setup/useFacilityRegistry.ts

@@ -0,0 +1,29 @@
+import useSWR from 'swr';
+import { openmrsFetch, restBaseUrl, type FetchResponse } from '@openmrs/esm-framework';
+import { FacilityRegistryRecord, FacilityRegistrySyncResult } from './type';
+import { facilityRegistryUrl } from './constant';
+
+export const useFacilityRegistry = () => {
+  const { data, error, isLoading, mutate } = useSWR<FetchResponse<FacilityRegistryRecord>>(
+    facilityRegistryUrl,
+    openmrsFetch,
+    {
+      revalidateOnFocus: false,
+    },
+  );
+
+  const notYetSynced = error?.response?.status === 404;
+
+  return {
+    facility: data?.data,
+    isLoading,
+    error: notYetSynced ? null : error,
+    notYetSynced,
+    mutate,
+  };
+};
+
+export const syncFacilityRegistry = async (): Promise<FacilityRegistrySyncResult> => {
+  const response = await openmrsFetch<FacilityRegistrySyncResult>(facilityRegistryUrl + '/sync', { method: 'POST' });
+  return response.data;
+};

package/src/components/hook/healthWorkerRegistry.ts

@@ -0,0 +1,78 @@
+import { FetchResponse, openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import useSWR from 'swr';
+import { HWR_API_NO_CREDENTIALS, PROVIDER_NOT_FOUND, RESOURCE_NOT_FOUND, UNKNOWN } from '../../constants';
+
+export interface ProfessionalRegistryResponse {
+  success: boolean;
+  regulator: string;
+  identification_type: string;
+  identification_number: string;
+  professional: {
+    membership: {
+      id: string;
+      full_name: string;
+      gender: string;
+      first_name: string;
+      middle_name: string;
+      last_name: string;
+      registration_id: string;
+      external_reference_id: string;
+      licensing_body: string;
+      specialty: string;
+      is_active: number;
+    };
+    licenses?: Array<{
+      id: string;
+      external_reference_id: string;
+      license_type: string;
+      license_start: string;
+      license_end: string;
+    }>;
+    professional_details?: {
+      professional_cadre?: string;
+      practice_type?: string;
+      educational_qualifications?: string;
+    };
+    contacts?: {
+      phone?: string;
+      email?: string;
+      postal_address?: string;
+    };
+    identifiers?: {
+      identification_type?: string;
+      identification_number?: string;
+    };
+  };
+}
+
+export const searchHealthCareWork = async (
+  identifierType: string,
+  identifierNumber: string,
+  regulator: string,
+): Promise<ProfessionalRegistryResponse> => {
+  const url = `${restBaseUrl}/virtualclaims/professional-registry?${new URLSearchParams({
+    identification_number: identifierNumber,
+    identification_type: identifierType,
+    regulator,
+  }).toString()}`;
+
+  try {
+    const response = await openmrsFetch<ProfessionalRegistryResponse>(url);
+    if (!response.data?.success || !response.data?.professional) {
+      throw new Error(PROVIDER_NOT_FOUND);
+    }
+    return response.data;
+  } catch (err: any) {
+    if (err?.message === PROVIDER_NOT_FOUND) {
+      throw err;
+    }
+    const status = err?.response?.status;
+    if (status === 401) {
+      throw new Error(HWR_API_NO_CREDENTIALS);
+    }
+    if (status === 404) {
+      throw new Error(RESOURCE_NOT_FOUND);
+    }
+    throw new Error(UNKNOWN);
+  }
+};

package/src/components/hook/useProfessionalRegistryEnums.ts

@@ -0,0 +1,59 @@
+import { FetchResponse, openmrsFetch, restBaseUrl, useSession } from '@openmrs/esm-framework';
+import useSWR from 'swr';
+
+export type EnumEntry = {
+  code: string;
+  label: string;
+};
+
+type RegulatorsResponse = {
+  count: number;
+  regulators: Array<EnumEntry>;
+};
+
+type IdentificationTypesResponse = {
+  count: number;
+  identification_types: Array<EnumEntry>;
+};
+
+const ONE_DAY_MS = 24 * 60 * 60 * 1000;
+
+export const useProfessionalRegistryRegulators = () => {
+  const { authenticated } = useSession();
+  const url = `${restBaseUrl}/virtualclaims/professional-registry/regulators`;
+
+  const { data, error, isLoading } = useSWR<FetchResponse<RegulatorsResponse>>(
+    authenticated ? url : null,
+    openmrsFetch,
+    {
+      revalidateOnFocus: false,
+      dedupingInterval: ONE_DAY_MS,
+    },
+  );
+
+  return {
+    regulators: data?.data?.regulators ?? [],
+    isLoading,
+    error,
+  };
+};
+
+export const useProfessionalRegistryIdentificationTypes = () => {
+  const { authenticated } = useSession();
+  const url = `${restBaseUrl}/virtualclaims/professional-registry/identification-types`;
+
+  const { data, error, isLoading } = useSWR<FetchResponse<IdentificationTypesResponse>>(
+    authenticated ? url : null,
+    openmrsFetch,
+    {
+      revalidateOnFocus: false,
+      dedupingInterval: ONE_DAY_MS,
+    },
+  );
+
+  return {
+    identificationTypes: data?.data?.identification_types ?? [],
+    isLoading,
+    error,
+  };
+};