@palladium-ethiopia/esm-admin-app 5.4.2-pre.100

package/src/types/index.ts

@@ -0,0 +1,385 @@
+import { fhirBaseUrl, Type } from '@openmrs/esm-framework';
+
+export interface ETLResponse {
+  script_name: string;
+  start_time: string;
+  stop_time: string;
+  status: string;
+}
+
+export interface DashboardConfig {
+  name: string;
+  slot: string;
+  title: string;
+}
+export interface FrontendModule {
+  name: string;
+  version?: string;
+}
+export interface SHAFacility {
+  operationalStatus: string;
+  approved: string;
+  kephLevel: string;
+  shaFacilityId: string;
+  shaFacilityExpiryDate: string;
+  registrationNumber: string;
+  mflCode: string;
+  shaFacilityLicenseNumber: string;
+  facilityRegistryCode: string;
+  source: string;
+}
+
+export interface DefaultFacility {
+  locationId: number;
+  uuid: string;
+  display: string;
+}
+
+export interface PractitionerResponse {
+  id: string;
+  link: Link[];
+  meta: Metadata;
+  entry: Entry[];
+}
+
+interface Metadata {
+  lastUpdated: string;
+}
+interface Link {
+  relation: string;
+  url: string;
+}
+interface Entry {
+  resource: {
+    id: string;
+    identifier: IdentifierType[];
+    active: boolean;
+    name: Name[];
+    telecom: ContactList[];
+    extension: Extension[];
+    gender: string;
+    qualification: Qualification[];
+  };
+}
+export interface Extension {
+  url: string;
+  valueCodeableConcept: ValueCodeableConcept;
+}
+
+export interface ValueCodeableConcept {
+  coding: Coding[];
+}
+
+export interface Coding {
+  system: string;
+  code: string;
+  display: string;
+}
+
+interface IdentifierType {
+  type: {
+    coding: {
+      code: string;
+      display: string;
+      system?: string;
+    }[];
+  };
+  value: string;
+  period?: {
+    start?: string;
+    end?: string;
+  };
+}
+
+interface ContactList {
+  system: string;
+  value?: string;
+}
+
+interface Name {
+  text: string;
+}
+
+interface Qualification {
+  extension: QualificationExtension[];
+  code: {
+    coding: {
+      system?: string;
+      code?: string;
+      display: string;
+    }[];
+  };
+  period: {
+    start: string;
+    end: string;
+  };
+}
+
+interface QualificationExtension {
+  url: string;
+  valueCoding?: {
+    system?: string;
+    code?: string;
+    display?: string;
+  };
+  valueString?: string;
+  valueCodeableConcept?: {
+    coding: {
+      system: string;
+      code: string;
+      display: string;
+    }[];
+  };
+}
+export interface Person {
+  uuid?: string;
+  display?: string;
+  gender: string;
+  names?: Array<PersonName>;
+  attributes?: Array<Attribute>;
+}
+
+export interface Role {
+  uuid: string;
+  description?: string;
+  display?: string;
+  name?: string;
+}
+
+export interface User {
+  uuid: string;
+  display: string;
+  username: string;
+  password?: string;
+  systemId: string;
+  userProperties: UserProperties;
+  person: Person;
+  privileges?: Array<string>;
+  roles: Array<Role>;
+  retired: boolean;
+  resourceVersion: string;
+}
+
+export interface PersonName {
+  givenName: string;
+  familyName: string;
+  middleName: string;
+}
+
+export interface Attribute {
+  attributeType?: string;
+  value?: string;
+}
+
+export interface UserProperties {
+  loginAttempts: string;
+  lastViewedPatientIds: string;
+}
+
+export interface UserRoleSchema {
+  name: string;
+  description: string;
+  category: string;
+}
+
+export interface Provider {
+  uuid?: string;
+  identifier?: string;
+  retired: boolean;
+  attributes?: Array<Attribute>;
+}
+
+export interface ProviderAttributes {
+  uuid?: string;
+  identifier?: string;
+  retired: boolean;
+  attributes?: Array<AttributeItems>;
+}
+
+export interface AttributeItems {
+  attributeType?: AttributeType;
+  value?: any;
+}
+
+export interface AttributeType {
+  uuid?: string;
+  description?: string;
+  display?: string;
+  name?: string;
+}
+
+export interface AttributeValue {
+  name?: string;
+  uuid?: string;
+}
+
+export interface ProviderLocation {
+  uuid: string;
+  name?: string;
+  description?: string;
+  retired: boolean;
+  attributes?: Array<AttributeItems>;
+}
+
+// Stock roles
+export interface OpenmrsData extends OpenmrsObject {}
+export interface OpenmrsObject {
+  uuid?: string;
+}
+export type BaseOpenmrsObject = OpenmrsObject;
+export interface BaseOpenmrsData extends BaseOpenmrsObject, OpenmrsData {}
+export interface StockOperationType extends BaseOpenmrsData {
+  uuid: string;
+  name: string;
+  description: string;
+  operationType: string;
+  hasSource: boolean;
+  hasDestination: boolean;
+  stockOperationTypeLocationScopes: Array<StockOperationTypeLocationScope>;
+}
+
+export interface StockOperationTypeLocationScope {
+  uuid: string;
+  locationTag: string;
+  isSource: string;
+  isDestination: string;
+}
+
+// Pagging
+export interface PageableResult<ResultType> {
+  results: ResultType[];
+  totalCount: number | null;
+}
+
+export interface PagingCriteria {
+  startIndex?: number | null;
+  limit?: number | null;
+}
+
+// stock location
+
+export interface FHIRResponse {
+  entry: Array<{ resource: fhir.Location }>;
+  total: number;
+  type: string;
+  resourceType: string;
+}
+
+export interface UserRoleScopeLocation extends BaseOpenmrsData {
+  locationUuid?: string;
+  locationName?: string;
+  enableDescendants?: boolean;
+}
+
+export interface UserRoleScopeOperationType extends BaseOpenmrsData {
+  operationTypeUuid?: string;
+  operationTypeName?: string;
+}
+
+export interface UserRoleScope extends BaseOpenmrsData {
+  userUuid?: string;
+  role?: string;
+  userName?: string;
+  userGivenName?: string;
+  userFamilyName?: string;
+  permanent: boolean;
+  activeFrom?: Date;
+  activeTo?: Date;
+  enabled: boolean;
+  locations?: Array<UserRoleScopeLocation>;
+  operationTypes?: Array<UserRoleScopeOperationType>;
+}
+
+export interface ProviderResponse {
+  uuid: string;
+  display: string;
+  person: PersonResponse;
+  identifier: string;
+  attributes: Array<{
+    uuid: string;
+    display: string;
+    attributeType: {
+      uuid: string;
+      display: string;
+    };
+    value: string;
+  }>;
+  retired: boolean;
+  voided: boolean;
+}
+interface PersonResponse {
+  uuid: string;
+  display: string;
+  names: {
+    givenName: string;
+    familyName: string;
+  };
+  gender: string;
+  birthdate: string;
+  attributes: Array<{
+    uuid: string;
+    display: string;
+  }>;
+}
+export interface UserResponse {
+  uuid: string;
+  display: string;
+  username: string;
+  systemId: string;
+  person: PersonResponse;
+  roles: Array<{
+    uuid: string;
+    display: string;
+    description: string;
+  }>;
+}
+
+export interface CustomHIEPractitionerResponse {
+  message: {
+    membership: {
+      id: string;
+      status: string;
+      salutation: 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;
+      is_withdrawn: number;
+      withdrawal_reason: string;
+      withdrawal_date: string;
+    };
+    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;
+      specialty: string;
+      subspecialty: string;
+      discipline_name: string;
+      educational_qualifications: string;
+    };
+    contacts: {
+      phone: string;
+      email: string;
+      postal_address: string;
+    };
+    identifiers: {
+      identification_type: string;
+      identification_number: string;
+      client_registry_id: string;
+      student_id: string;
+    };
+  };
+  fhirFormat: boolean;
+}

package/src/user-management.resources.ts

@@ -0,0 +1,232 @@
+import { fhirBaseUrl, openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import useSWR, { mutate } from 'swr';
+import {
+  AttributeType,
+  FHIRResponse,
+  PageableResult,
+  Provider,
+  ProviderAttributes,
+  ProviderLocation,
+  ProviderResponse,
+  Role,
+  StockOperationType,
+  User,
+  UserRoleScope,
+} from './types';
+import uniqBy from 'lodash-es/uniqBy';
+import { useMemo } from 'react';
+
+export const useUser = () => {
+  const url = `${restBaseUrl}/user?v=custom:(uuid,username,display,systemId,retired,person:(uuid,display,gender,names:(givenName,familyName,middleName),attributes:(uuid,display)),roles:(uuid,description,display,name))`;
+  const { data, isLoading, error, mutate } = useSWR<{ data: { results: Array<User> } }>(url, openmrsFetch, {
+    errorRetryCount: 2,
+  });
+  return {
+    users: data?.data?.results,
+    isLoading,
+    mutate,
+    error,
+  };
+};
+
+export const postUser = async (user: Partial<User>, url: string) => {
+  const response = await openmrsFetch(url, {
+    method: 'POST',
+    body: JSON.stringify(user),
+    headers: {
+      'Content-Type': 'application/json',
+    },
+  });
+  return response.json();
+};
+
+export const createProvider = async (
+  uuid: string,
+  identifier: string,
+  attributes: Partial<Provider>,
+  providerUrl?: string,
+) => {
+  const providerBody = {
+    person: uuid,
+    identifier: identifier,
+    ...attributes,
+    retired: false,
+  };
+
+  return await openmrsFetch(providerUrl, {
+    method: 'POST',
+    body: JSON.stringify(providerBody),
+    headers: {
+      'Content-Type': 'application/json',
+    },
+  });
+};
+
+export const createUser = async (user: Partial<User>, uuid?: string) => {
+  const userUrl = uuid ? `${restBaseUrl}/user/${uuid}` : `${restBaseUrl}/user`;
+
+  return await postUser(user, userUrl);
+};
+
+export const createOrUpdateUserRoleScope = async (
+  userRoleScopeUrl?: string,
+  userRoleScopePayload?: Partial<UserRoleScope>,
+  userUuid?: string,
+) => {
+  const userRoleScopeBody = {
+    userUuid: userUuid,
+    ...userRoleScopePayload,
+  };
+
+  return await openmrsFetch(userRoleScopeUrl, {
+    method: 'POST',
+    body: JSON.stringify(userRoleScopeBody),
+    headers: {
+      'Content-Type': 'application/json',
+    },
+  });
+};
+
+export const handleMutation = (url: string) => {
+  mutate((key) => typeof key === 'string' && key.startsWith(url), undefined, { revalidate: true });
+};
+
+export const useRoles = () => {
+  const url = `${restBaseUrl}/role?v=custom:(uuid,description,display,name)`;
+  const { data, isLoading, error, mutate } = useSWR<{ data: { results: Array<Role> } }>(url, openmrsFetch, {
+    errorRetryCount: 2,
+  });
+  return {
+    roles: data?.data?.results,
+    isLoading,
+    mutate,
+    error,
+  };
+};
+
+export const usePersonAttribute = () => {
+  const url = `${restBaseUrl}/personattributetype?v=custom:(name,uuid)`;
+  const { data, isLoading, error } = useSWR<{ data: { results: Array<AttributeType> } }>(url, openmrsFetch, {
+    errorRetryCount: 2,
+  });
+  return {
+    attributeTypes: data?.data?.results,
+    isLoading,
+    error,
+  };
+};
+
+export const useProvider = (searchQuery: string) => {
+  const url = `${restBaseUrl}/provider?q=${searchQuery}&v=custom:(uuid,identifier,retired,attributes:(uuid,display,value:(name),attributeType:(uuid,name)))`;
+  const { data, isLoading, error } = useSWR<{ data: { results: Array<ProviderResponse> } }>(url, openmrsFetch, {
+    errorRetryCount: 2,
+  });
+  return {
+    provider: data?.data?.results,
+    loadingProvider: isLoading,
+    providerError: error,
+  };
+};
+
+export interface ProviderWithAttributes {
+  uuid: string;
+  identifier?: string;
+  attributes?: Array<{
+    uuid?: string;
+    display?: string;
+    value?: string | { name?: string };
+    attributeType?: { uuid: string; name?: string };
+  }>;
+}
+
+export const useProviderAttributeType = () => {
+  const url = `${restBaseUrl}/providerattributetype?v=custom:(uuid,name,display)`;
+  const { data, isLoading, error } = useSWR<{ data: { results: Array<AttributeType> } }>(url, openmrsFetch, {
+    errorRetryCount: 2,
+  });
+  return {
+    providerAttributeType: data?.data?.results,
+    isLoading,
+    error,
+  };
+};
+
+export const useLocation = () => {
+  const url = `${restBaseUrl}/location?v=custom:(uuid,name,description,retired,attributes:(value))`;
+  const { data, isLoading, error } = useSWR<{ data: { results: Array<ProviderLocation> } }>(url, openmrsFetch, {
+    errorRetryCount: 2,
+  });
+  return {
+    location: data?.data?.results,
+    loadingLocation: isLoading,
+    locationError: error,
+  };
+};
+
+export function useStockOperationTypes() {
+  const apiUrl = `${restBaseUrl}/stockmanagement/stockoperationtype?v=default`;
+  const { data, isLoading, error } = useSWR<
+    {
+      data: PageableResult<StockOperationType>;
+    },
+    Error
+  >(apiUrl, openmrsFetch);
+  return {
+    stockOperations: data?.data.results,
+    loadingStock: isLoading,
+    error,
+  };
+}
+
+export function useStockTagLocations() {
+  const apiUrl = `${fhirBaseUrl}/Location?_summary=data&_tag=main store,main pharmacy,dispensary,sub store `;
+  const { data, error, isLoading } = useSWR<{ data: FHIRResponse }>(apiUrl, openmrsFetch);
+  const stockLocations = useMemo(
+    () => data?.data?.entry?.map((response) => response.resource) ?? [],
+    [data?.data?.entry],
+  );
+  return {
+    stockLocations: uniqBy(stockLocations, 'id') ?? [],
+    isLoading,
+    error,
+  };
+}
+
+export const useUserRoleScopes = () => {
+  const apiUrl = `${restBaseUrl}/stockmanagement/userrolescope?v=full`;
+  const { data, error, isLoading, isValidating } = useSWR<{ data: PageableResult<UserRoleScope> }, Error>(
+    apiUrl,
+    openmrsFetch,
+  );
+  return {
+    items: data?.data,
+    loadingRoleScope: isLoading,
+    userRoleScopeError: error,
+    isValidating,
+  };
+};
+
+export function deleteUserRoleScopes(roleScopeIds: string[]) {
+  let encodedRoleScopeIds = roleScopeIds.reduce((queryString, currentId, index) => {
+    if (index === 0) {
+      return queryString;
+    }
+    queryString += (queryString.length > 0 ? ',' : '') + encodeURIComponent(currentId);
+    return queryString;
+  }, '');
+
+  if (encodedRoleScopeIds.length > 0) {
+    encodedRoleScopeIds = '?ids=' + encodedRoleScopeIds;
+  }
+
+  const apiUrl = `${restBaseUrl}/stockmanagement/userrolescope/${roleScopeIds[0]}${encodedRoleScopeIds}`;
+  const abortController = new AbortController();
+
+  return openmrsFetch(apiUrl, {
+    method: 'DELETE',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    signal: abortController.signal,
+  });
+}

package/src/utils/utils.ts

@@ -0,0 +1,20 @@
+import dayjs from 'dayjs';
+
+/**
+ * Formats a given date string into "DD-MMM-YYYY, hh:mm A" format.
+ *
+ * @param {string | Date | undefined} date - The date to format.
+ * @returns {string} - The formatted date or '--' if the date is invalid or missing.
+ */
+export const formatDateTime = (date) => {
+  if (!date) {
+    return '--';
+  }
+
+  const parsedDate = dayjs(date);
+  if (!parsedDate.isValid()) {
+    return '--';
+  }
+
+  return parsedDate.format('DD-MMM-YYYY, hh:mm A');
+};