@digihmis/esm-administration-app 1.0.0

package/dist/routes.json

@@ -0,0 +1 @@
+{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"fhir2":">=1.2","webservices.rest":"^2.24.0"},"extensions":[{"name":"system-info-management-dashboard-link","slot":"administration-dashboard-slot","component":"systemInfoLeftPanelLink","meta":{"name":"system-info-management","slot":"system-info-management-homepage-dashboard-slot","title":"System Info"}},{"name":"queue-management-dashboard-link","slot":"administration-dashboard-slot","component":"queueLeftPanelLink","meta":{"name":"queue-management","slot":"queue-management-homepage-dashboard-slot","title":"Queue Management"}},{"name":"location-management-dashboard-link","slot":"administration-dashboard-slot","component":"locationLeftPanelLink","meta":{"name":"location-management","slot":"location-management-homepage-dashboard-slot","title":"Location Management"}},{"name":"bed-management-dashboard-link","slot":"administration-dashboard-slot","component":"bedLeftPanelLink","meta":{"name":"bed-management","slot":"bed-management-homepage-dashboard-slot","title":"Bed Management"}},{"name":"form-builder-dashboard-link","slot":"administration-dashboard-slot","component":"formBuilderLeftPanelLink","meta":{"name":"form-builder","slot":"form-builder-homepage-dashboard-slot","title":"Form Builder"}},{"name":"billing-management-dashboard-link","slot":"administration-dashboard-slot","component":"billingLeftPanelLink","meta":{"name":"billing-management","slot":"billing-management-homepage-dashboard-slot","title":"Billing Management"}},{"name":"queue-management-dashboard-content","slot":"queue-management-homepage-dashboard-slot","component":"queueManagementDashboard"},{"name":"location-management-dashboard-content","slot":"location-management-homepage-dashboard-slot","component":"locationManagementDashboard"},{"name":"bed-management-dashboard-content","slot":"bed-management-homepage-dashboard-slot","component":"bedManagementDashboard"},{"name":"form-builder-dashboard-content","slot":"form-builder-homepage-dashboard-slot","component":"formBuilderDashboard"},{"name":"billing-management-dashboard-content","slot":"billing-management-homepage-dashboard-slot","component":"billingManagementDashboard"},{"name":"system-info-management-dashboard-content","slot":"system-info-management-homepage-dashboard-slot","component":"systemInfoDashboard"}],"workspaces":[{"name":"service-queues-service-form","title":"addNewQueueService","component":"addNewQueueServiceWorkspace","type":"service-queues"},{"name":"service-queues-room-workspace","title":"addNewQueueServiceRoom","component":"addNewQueueServiceRoomWorkspace","type":"service-queues"},{"name":"add-location-workspace","title":"addNewLocationWorkspace","component":"addNewLocationWorkspace","type":"location-management"},{"name":"search-location-workspace","title":"searchLocationWorkspace","component":"searchLocationWorkspace","type":"location-management"},{"name":"payment-mode-workspace","title":"paymentModeWorkspace","component":"paymentModeWorkspace","type":"billing-management"},{"name":"payment-point-workspace","title":"paymentPointWorkspace","component":"paymentPointWorkspace","type":"billing-management"},{"name":"billing-charge-service-workspace","title":"addServiceItem","component":"billableServiceForm","type":"billing-management"},{"name":"billing-charge-item-workspace","title":"addCommodityItem","component":"commodityForm","type":"billing-management"}],"modals":[{"name":"delete-payment-mode-modal","component":"deletePaymentModeModal"},{"name":"delete-payment-point-modal","component":"deletePaymentPointModal"},{"name":"delete-billable-service-modal","component":"deleteBillableService"}],"version":"1.0.0"}

package/increment-version.js

@@ -0,0 +1,17 @@
+const fs = require('fs');
+const path = require('path');
+
+// Read the package.json file
+const packageJsonPath = path.join(__dirname, 'package.json');
+const packageJson = require(packageJsonPath);
+
+// Increment the version
+const [major, minor, patch] = packageJson.version.split('.').map(Number);
+const newVersion = `${major}.${minor}.${patch + 1}`;
+
+// Update the package.json file with the new version
+packageJson.version = newVersion;
+fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+
+// eslint-disable-next-line no-console
+console.log(`Version incremented to ${newVersion}`);

package/jest.config.js

@@ -0,0 +1,26 @@
+/** @type {import('jest').Config} */
+module.exports = {
+  clearMocks: true,
+  transform: {
+    '^.+\\.[jt]sx?$': ['@swc/jest'],
+  },
+  transformIgnorePatterns: ['/node_modules/(?!@openmrs|.+\\.pnp\\.[^\\/]+$)'],
+  moduleNameMapper: {
+    '\\.(s?css)$': 'identity-obj-proxy',
+    '@openmrs/esm-framework': '@openmrs/esm-framework/mock',
+    'lodash-es': 'lodash',
+    '^dexie$': require.resolve('dexie'),
+  },
+  collectCoverageFrom: [
+    '**/src/**/*.tsx',
+    '!**/node_modules/**',
+    '!**/vendor/**',
+    '!**/src/**/*.test.*',
+    '!**/src/declarations.d.ts',
+  ],
+  setupFilesAfterEnv: ['<rootDir>/setupTests.ts'],
+  testEnvironment: 'jsdom',
+  testEnvironmentOptions: {
+    url: 'http://localhost/',
+  },
+};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@digihmis/esm-administration-app",
+  "version": "1.0.0",
+  "description": "Administration microfrontend for the OpenMRS SPA",
+  "browser": "dist/digihmis-esm-administration-app.js",
+  "main": "src/index.ts",
+  "source": true,
+  "license": "MPL-2.0",
+  "homepage": "https://github.com/its-kios09/DigiHMIS-apps#readme",
+  "scripts": {
+    "analyze": "rspack --mode=production --env analyze=true",
+    "build": "node version.js && rspack --mode=production && node increment-version.js",
+    "coverage": "yarn test --coverage",
+    "debug": "npm run serve",
+    "extract-translations": "i18next 'src/**/*.component.tsx' 'src/index.ts' --config ../../tools/i18next-parser.config.js",
+    "lint": "eslint src --ext ts,tsx",
+    "serve": "rspack serve --mode=development",
+    "start": "openmrs develop",
+    "test": "cross-env TZ=UTC jest --config jest.config.js --verbose false --passWithNoTests",
+    "test:watch": "cross-env TZ=UTC jest --watch --config jest.config.js",
+    "typescript": "tsc"
+  },
+  "browserslist": [
+    "extends browserslist-config-openmrs"
+  ],
+  "keywords": [
+    "openmrs"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/its-kios09/DigiHMIS-apps.git#readme"
+  },
+  "bugs": {
+    "url": "https://github.com/its-kios09/DigiHMIS-apps/issues"
+  },
+  "dependencies": {
+    "lodash-es": "^4.17.15",
+    "react-to-print": "2.14.13"
+  },
+  "peerDependencies": {
+    "@carbon/react": "1.x",
+    "@openmrs/esm-framework": "8.x",
+    "react": "^18.1.0",
+    "react-i18next": "16.x",
+    "react-router-dom": "6.x",
+    "swr": "2.x"
+  }
+}

package/release-version.js

@@ -0,0 +1,16 @@
+
+// IMPORTANT: THIS FILE IS AUTO GENERATED! DO NOT MANUALLY EDIT OR CHECKIN!
+/* tslint:disable */
+export const VERSION = {
+    "dirty": true,
+    "raw": "3342d5c-dirty",
+    "hash": "3342d5c",
+    "distance": null,
+    "tag": null,
+    "semver": null,
+    "suffix": "3342d5c-dirty",
+    "semverString": null,
+    "version": "1.0.0",
+    "buildDate": "2026-07-27T23:03:38.929Z"
+};
+/* tslint:enable */

package/rspack.config.js

@@ -0,0 +1 @@
+module.exports = require('../../tools/rs-pack-code-spliting');

package/src/bed-management/bed-management.component.tsx

@@ -0,0 +1,19 @@
+import React from 'react';
+import { ExtensionSlot, useConfig } from '@openmrs/esm-framework';
+import styles from './bed-management.scss';
+import { CustomPageHeader } from '../components/custom-page-header/custom-page-header.component';
+import { ConfigObject } from '../config-schema';
+import { useTranslation } from 'react-i18next';
+
+const BedManagementDashboard: React.FC = () => {
+  const { t } = useTranslation();
+  const { inpatientIcon } = useConfig<ConfigObject>();
+
+  return (
+    <div className={styles.dashboardContainer}>
+      <CustomPageHeader subTitle={t('configureBed', 'Configure wards')} iconSrc={inpatientIcon.src} />
+    </div>
+  );
+};
+
+export default BedManagementDashboard;

package/src/billing-management/billing-charge-items/billing-charge-items-modal/billing-charge-items.modal.tsx

@@ -0,0 +1,79 @@
+import React from 'react';
+import { ModalBody, ModalFooter, Button, InlineLoading, ModalHeader } from '@carbon/react';
+import { useTranslation } from 'react-i18next';
+import { showSnackbar, restBaseUrl } from '@openmrs/esm-framework';
+import { mutate } from 'swr';
+import { deleteBillableService } from './billing-charge-items.resource';
+import { type ChargeItems } from '../type';
+
+type DeleteBillableServiceModalProps = {
+  closeModal: () => void;
+  chargeableItem: ChargeItems;
+};
+
+const DeleteBillableServiceModal: React.FC<DeleteBillableServiceModalProps> = ({ closeModal, chargeableItem }) => {
+  const [isDeleting, setIsDeleting] = React.useState(false);
+  const { t } = useTranslation();
+
+  const handleMutation = () => {
+    const url = `${restBaseUrl}/cashier/billableService`;
+    mutate((key) => typeof key === 'string' && key.startsWith(url), undefined, { revalidate: true });
+  };
+
+  const handleDelete = () => {
+    setIsDeleting(true);
+    const chargeableItemUuid = chargeableItem?.uuid;
+    if (chargeableItemUuid) {
+      deleteBillableService(chargeableItemUuid)
+        .then(() => {
+          showSnackbar({
+            title: t('deleteChargeableItemSuccess', 'Chargeable item deleted successfully'),
+            subtitle: t('deleteChargeableItemSuccessMessage', 'The chargeable item has been deleted successfully.'),
+            kind: 'success',
+            isLowContrast: true,
+            timeoutInMs: 5000,
+          });
+          handleMutation();
+          closeModal();
+        })
+        .catch((error) => {
+          showSnackbar({
+            title: t('deleteChargeableItemError', 'Error deleting chargeable item'),
+            subtitle: t('deleteChargeableItemErrorMessage', 'An error occurred while deleting the chargeable item.'),
+            isLowContrast: true,
+            timeoutInMs: 5000,
+            kind: 'error',
+          });
+        })
+        .finally(() => {
+          setIsDeleting(false);
+        });
+    }
+  };
+  return (
+    <>
+      <ModalHeader closeModal={closeModal} title={t('deleteChargeableItems', 'Delete Chargeable Item')} />
+      <ModalBody>
+        <p>
+          {t('deleteChargeableItemMessage', 'Are you sure you want to delete the chargeable item {{name}}?', {
+            name: chargeableItem?.name,
+          })}
+        </p>
+      </ModalBody>
+      <ModalFooter>
+        <Button kind="secondary" onClick={closeModal}>
+          {t('cancel', 'Cancel')}
+        </Button>
+        <Button kind="danger" onClick={handleDelete} disabled={isDeleting}>
+          {isDeleting ? (
+            <InlineLoading description={t('deleting', 'Deleting') + '...'} />
+          ) : (
+            <span>{t('delete', 'Delete')}</span>
+          )}
+        </Button>
+      </ModalFooter>
+    </>
+  );
+};
+
+export default DeleteBillableServiceModal;

package/src/billing-management/billing-charge-items/billing-charge-items-modal/billing-charge-items.resource.ts

@@ -0,0 +1,11 @@
+import { openmrsFetch } from '@openmrs/esm-framework';
+
+export const deleteBillableService = (uuid: string) => {
+  const url = `/ws/rest/v1/cashier/billableService/${uuid}`;
+  return openmrsFetch(url, {
+    method: 'DELETE',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+  });
+};

package/src/billing-management/billing-charge-items/billing-charge-items-workspace/billing-charge-item.workspace.tsx

@@ -0,0 +1,212 @@
+import React, { useEffect, useMemo } from 'react';
+import { useTranslation } from 'react-i18next';
+import { ButtonSet, Button, Stack, Toggle, InlineNotification, InlineLoading } from '@carbon/react';
+import { Add } from '@carbon/react/icons';
+import { useForm, FormProvider, useFieldArray, Controller } from 'react-hook-form';
+
+import { type DefaultWorkspaceProps, useLayoutType, ResponsiveWrapper, showSnackbar, restBaseUrl } from '@openmrs/esm-framework';
+import styles from './global/billing-charge-commodity.scss';
+import classNames from 'classnames';
+import { zodResolver } from '@hookform/resolvers/zod';
+import PriceField from './components/price.component';
+import { billableFormSchema, BillableFormSchema } from './schemas/form-schemas';
+import { handleMutation } from '../../billing-payment-modes/billing-payment-modes-workspace/billing-payment-modes.resource';
+import { formatBillableServicePayloadForSubmission, mapInputToPayloadSchema } from '../utils';
+import { createBillableService } from './billing-charge-items.resource';
+import StockItemSearch from './components/stock-search.component';
+
+type CommodityFormProps = DefaultWorkspaceProps & {
+  initialValues?: BillableFormSchema;
+};
+
+const CommodityForm: React.FC<CommodityFormProps> = ({
+  closeWorkspace,
+  closeWorkspaceWithSavedChanges,
+  promptBeforeClosing,
+  initialValues,
+}) => {
+  const { t } = useTranslation();
+  const isTablet = useLayoutType() === 'tablet';
+  const formMethods = useForm<BillableFormSchema>({
+    resolver: zodResolver(billableFormSchema),
+    defaultValues: initialValues
+      ? {
+          ...mapInputToPayloadSchema(initialValues),
+          serviceType: {
+            uuid: initialValues.serviceType?.uuid ?? '',
+            display: initialValues.serviceType?.display ?? '',
+          },
+        }
+      : { servicePrices: [], serviceStatus: 'ENABLED' },
+  });
+
+  const {
+    setValue,
+    control,
+    handleSubmit,
+    trigger,
+    formState: { errors, isDirty, isSubmitting },
+  } = formMethods;
+
+  const { fields, append, remove } = useFieldArray({
+    control,
+    name: 'servicePrices',
+  });
+
+  useEffect(() => {
+    if (initialValues) {
+      trigger();
+    }
+  }, [initialValues, trigger]);
+
+  const onSubmit = async (formValues: BillableFormSchema) => {
+    const payload = formatBillableServicePayloadForSubmission(formValues, initialValues?.['uuid']);
+    try {
+      const response = await createBillableService(payload, initialValues?.['uuid']);
+      if (response.ok) {
+        showSnackbar({
+          title: t('commodityBillableCreated', 'Commodity price created successfully'),
+          subtitle: t('commodityBillableCreatedSubtitle', 'The commodity price has been created successfully'),
+          kind: 'success',
+          isLowContrast: true,
+          timeoutInMs: 5000,
+        });
+        handleMutation(`${restBaseUrl}/cashier/billableService?v`);
+        closeWorkspaceWithSavedChanges();
+      }
+    } catch (e) {
+      const errorMessage =
+        e?.responseBody?.error?.message || e?.message || t('unknownError', 'An unknown error occurred');
+      showSnackbar({
+        title: t('commodityBillableCreationFailed', 'Commodity price creation failed'),
+        subtitle: t(
+          'commodityBillableCreationFailedSubtitle',
+          'The commodity price creation failed: {{errorMessage}}',
+          {
+            errorMessage: String(errorMessage).trim(),
+          },
+        ),
+        kind: 'error',
+        isLowContrast: true,
+        timeoutInMs: 5000,
+      });
+    }
+  };
+
+  useEffect(() => {
+    promptBeforeClosing(() => isDirty);
+  }, [isDirty, promptBeforeClosing]);
+
+  const renderServicePriceFields = useMemo(
+    () =>
+      fields.map((field, index) => (
+        <PriceField
+          key={field.id}
+          field={field}
+          index={index}
+          control={control}
+          removeServicePrice={remove}
+          errors={errors}
+        />
+      )),
+    [fields, control, remove, errors],
+  );
+
+  function flattenErrors(errors: Record<string, any>): string[] {
+    const messages: string[] = [];
+
+    Object.entries(errors).forEach(([key, value]) => {
+      if (Array.isArray(value)) {
+        value.forEach((item, index) => {
+          Object.entries(item as Record<string, { message: string }>).forEach(([subKey, subVal]) => {
+            messages.push(`${key}[${index}].${subKey}: ${subVal.message}`);
+          });
+        });
+      } else if (typeof value === 'object' && value?.message) {
+        messages.push(`${key}: ${value.message}`);
+      }
+    });
+
+    return messages;
+  }
+
+  const handleError = (err) => {
+    console.error(JSON.stringify(err, null, 2));
+    const errorMessage = flattenErrors(err).join('; ');
+    showSnackbar({
+      title: t('serviceCreationFailed', 'Service creation failed'),
+      subtitle: t('serviceCreationFailedSubtitle', 'The service creation failed: {{errorMessage}}', {
+        errorMessage,
+      }),
+      kind: 'error',
+      isLowContrast: true,
+      timeoutInMs: 5000,
+    });
+  };
+
+  return (
+    <FormProvider {...formMethods}>
+      <form onSubmit={handleSubmit(onSubmit, handleError)} className={styles.form}>
+        <div className={styles.formContainer}>
+          <Stack className={styles.formStackControl} gap={7}>
+            <StockItemSearch setValue={setValue} defaultStockItem={initialValues?.name} />
+            {errors.concept && (
+              <InlineNotification
+                kind="error"
+                lowContrast={true}
+                title={t('conceptMissing', 'Concept missing for {{name}}', { name: initialValues?.name })}
+                subtitle={t('conceptMissingSubtitle', 'Please delete the current item and re-create the charge item')}
+              />
+            )}
+            <ResponsiveWrapper>
+              <Controller
+                control={control}
+                name="serviceStatus"
+                render={({ field }) => (
+                  <Toggle
+                    labelText={t('status', 'Status')}
+                    labelA="Off"
+                    labelB="On"
+                    defaultToggled={field.value === 'ENABLED'}
+                    id="serviceStatus"
+                    onToggle={(value) => (value ? field.onChange('ENABLED') : field.onChange('DISABLED'))}
+                  />
+                )}
+              />
+            </ResponsiveWrapper>
+            {renderServicePriceFields}
+            <Button size="sm" kind="tertiary" renderIcon={Add} onClick={() => append({})}>
+              {t('addPaymentMethod', 'Add payment method')}
+            </Button>
+            {!!errors.servicePrices && (
+              <InlineNotification
+                aria-label="closes notification"
+                kind="error"
+                lowContrast={true}
+                statusIconDescription="notification"
+                title={t('paymentMethodRequired', 'Payment method required')}
+                subtitle={t('atLeastOnePriceRequired', 'At least one price is required')}
+              />
+            )}
+          </Stack>
+        </div>
+        <ButtonSet className={classNames({ [styles.tablet]: isTablet, [styles.desktop]: !isTablet })}>
+          <Button style={{ maxWidth: '50%' }} kind="secondary" onClick={() => closeWorkspace()}>
+            {t('cancel', 'Cancel')}
+          </Button>
+          <Button disabled={isSubmitting || !isDirty} style={{ maxWidth: '50%' }} kind="primary" type="submit">
+            {isSubmitting ? (
+              <span style={{ display: 'flex', justifyItems: 'center' }}>
+                {t('submitting', 'Submitting...')} <InlineLoading status="active" iconDescription="Loading" />
+              </span>
+            ) : (
+              t('saveAndClose', 'Save & close')
+            )}
+          </Button>
+        </ButtonSet>
+      </form>
+    </FormProvider>
+  );
+};
+
+export default CommodityForm;

package/src/billing-management/billing-charge-items/billing-charge-items-workspace/billing-charge-items.resource.ts

@@ -0,0 +1,51 @@
+import { openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import useSWR from 'swr';
+import { ServiceConcept, ServiceTypesResponse, StockItemResponse } from '../type';
+
+export const createBillableService = (payload: any, uuid?: string) => {
+  const url = `${restBaseUrl}/cashier/billableService/${uuid ? `${uuid}` : ''}`;
+  return openmrsFetch(url, {
+    method: 'POST',
+    body: payload,
+    headers: {
+      'Content-Type': 'application/json',
+    },
+  });
+};
+
+export function useConceptsSearch(conceptToLookup: string) {
+  const conditionsSearchUrl = `${restBaseUrl}/conceptsearch?q=${conceptToLookup}`;
+
+  const { data, error, isLoading } = useSWR<{ data: { results: Array<ServiceConcept> } }, Error>(
+    conceptToLookup ? conditionsSearchUrl : null,
+    openmrsFetch,
+  );
+
+  return {
+    searchResults: data?.data?.results ?? [],
+    error: error,
+    isSearching: isLoading,
+  };
+}
+
+// TODO: Move the uuid to a config file or constant file
+
+export function useServiceTypes() {
+  const serviceConceptUuid = `d7bd4cc0-90b1-4f22-90f2-ab7fde936727`;
+  const url = `/ws/rest/v1/concept/${serviceConceptUuid}?v=custom:(setMembers:(uuid,display,id))`;
+  const { data, error, isLoading } = useSWR<{ data: ServiceTypesResponse }>(url, openmrsFetch, {});
+  return { serviceTypes: data?.data.setMembers ?? [], error, isLoading };
+}
+
+export const useCommodityItem = (searchTerm: string = '') => {
+  const url = `${restBaseUrl}/stockmanagement/stockitem?v=default&limit=10&q=${searchTerm}`;
+  const { data, error, isLoading, isValidating, mutate } = useSWR<{ data: StockItemResponse }>(url, openmrsFetch);
+
+  return {
+    stockItems: data?.data?.results ?? [],
+    isLoading,
+    isValidating,
+    error,
+    mutate,
+  };
+};