@palladium-ethiopia/esm-billing-app 5.4.2-pre.30

package/src/helpers/currency.ts

@@ -0,0 +1,137 @@
+import { useConfig } from '@openmrs/esm-framework';
+import { BillingConfig } from '../config-schema';
+
+// Default locale to currency mapping (fallback)
+export const DEFAULT_LOCALE_CURRENCY_MAP: Record<string, string> = {
+  en: 'KES', // English - Kenyan Shilling
+  sw: 'KES', // Swahili - Kenyan Shilling
+  am: 'ETB', // Amharic - Ethiopian Birr
+  'en-KE': 'KES', // English Kenya
+  'sw-KE': 'KES', // Swahili Kenya
+  'am-ET': 'ETB', // Amharic Ethiopia
+};
+
+/**
+ * Gets the currency code for the current locale
+ * @returns The currency code (e.g., 'KES', 'ETB')
+ */
+export const getCurrencyForLocale = (): string => {
+  const currentLocale = localStorage.getItem('i18nextLng') ?? 'en';
+  return DEFAULT_LOCALE_CURRENCY_MAP[currentLocale] || 'KES';
+};
+
+/**
+ * Gets the currency code for the current locale with config support
+ * @param config - The billing configuration object
+ * @returns The currency code (e.g., 'KES', 'ETB')
+ */
+export const getCurrencyForLocaleWithConfig = (config?: BillingConfig): string => {
+  const currentLocale = localStorage.getItem('i18nextLng') ?? 'en';
+
+  // Use config mapping if available, otherwise fall back to default
+  const currencyMap = config?.localeCurrencyMapping || DEFAULT_LOCALE_CURRENCY_MAP;
+  return currencyMap[currentLocale] || 'KES';
+};
+
+/**
+ * Gets the current locale from localStorage
+ * @returns The current locale (e.g., 'en', 'sw', 'am')
+ */
+export const getCurrentLocale = (): string => {
+  return localStorage.getItem('i18nextLng') ?? 'en';
+};
+
+/**
+ * Formats a number as currency based on the current locale
+ * @param amount - The amount to format
+ * @param options - Additional Intl.NumberFormat options
+ * @returns Formatted currency string
+ */
+export const formatCurrency = (amount: number, options: Intl.NumberFormatOptions = {}): string => {
+  const currentLocale = getCurrentLocale();
+  const currency = getCurrencyForLocale();
+
+  const formatter = new Intl.NumberFormat(currentLocale, {
+    style: 'currency',
+    currency: currency,
+    minimumFractionDigits: 2,
+    ...options,
+  });
+
+  let formattedAmount = formatter.format(Math.abs(amount));
+
+  if (amount < 0) {
+    formattedAmount = `- ${formattedAmount}`;
+  }
+
+  return formattedAmount;
+};
+
+/**
+ * Formats a number as currency without negative sign handling
+ * @param amount - The amount to format
+ * @param options - Additional Intl.NumberFormat options
+ * @returns Formatted currency string
+ */
+export const formatCurrencySimple = (amount: number, options: Intl.NumberFormatOptions = {}): string => {
+  const currentLocale = getCurrentLocale();
+  const currency = getCurrencyForLocale();
+
+  const formatter = new Intl.NumberFormat(currentLocale, {
+    style: 'currency',
+    currency: currency,
+    ...options,
+  });
+
+  return formatter.format(amount);
+};
+
+/**
+ * Hook to get currency formatting with config support
+ * @returns Object with currency formatting functions
+ */
+export const useCurrencyFormatting = () => {
+  const config = useConfig<BillingConfig>();
+
+  const getCurrency = () => getCurrencyForLocaleWithConfig(config);
+  const getLocale = () => getCurrentLocale();
+
+  const format = (amount: number, options: Intl.NumberFormatOptions = {}) => {
+    const currentLocale = getLocale();
+    const currency = getCurrency();
+
+    const formatter = new Intl.NumberFormat(currentLocale, {
+      style: 'currency',
+      currency: currency,
+      minimumFractionDigits: 2,
+      ...options,
+    });
+
+    let formattedAmount = formatter.format(Math.abs(amount));
+
+    if (amount < 0) {
+      formattedAmount = `- ${formattedAmount}`;
+    }
+
+    return formattedAmount;
+  };
+
+  const formatSimple = (amount: number, options: Intl.NumberFormatOptions = {}) => {
+    const currentLocale = getLocale();
+    const currency = getCurrency();
+    const formatter = new Intl.NumberFormat(currentLocale, {
+      style: 'currency',
+      currency: currency,
+      ...options,
+    });
+
+    return formatter.format(amount);
+  };
+
+  return {
+    getCurrency,
+    getLocale,
+    format,
+    formatSimple,
+  };
+};

package/src/helpers/excelExport.ts

@@ -0,0 +1,31 @@
+import * as XLSX from 'xlsx';
+
+interface ExcelExportOptions {
+  fileName?: string;
+  sheetName?: string;
+  compression?: boolean;
+}
+
+/**
+ * Generic function to export any data to Excel
+ * @param data - Array of objects to export
+ * @param options - Export configuration options
+ */
+export async function exportToExcel<T>(data: Array<T>, options: ExcelExportOptions = {}): Promise<void> {
+  const { fileName = 'Export', sheetName = 'Sheet1', compression = true } = options;
+
+  try {
+    // Convert data to worksheet
+    const worksheet = XLSX.utils.json_to_sheet(data);
+
+    // Create workbook and append worksheet
+    const workbook = XLSX.utils.book_new();
+    XLSX.utils.book_append_sheet(workbook, worksheet, sheetName);
+
+    // Write file
+    XLSX.writeFile(workbook, `${fileName}.xlsx`, { compression });
+  } catch (error) {
+    console.error('Error exporting to Excel:', error);
+    throw new Error('Failed to export data to Excel');
+  }
+}

package/src/helpers/functions.ts

@@ -0,0 +1,83 @@
+import dayjs from 'dayjs';
+import { Payment, LineItem } from '../types';
+import { formatCurrency } from './currency';
+
+// amount already paid
+export function calculateTotalAmountTendered(payments: Array<Payment>) {
+  return Array.isArray(payments)
+    ? payments.reduce((totalAmount, item) => {
+        // Ensure that "amount" property is present and numeric
+        if (typeof item.amount === 'number' && item.voided !== true) {
+          return totalAmount + item.amount;
+        }
+        return totalAmount;
+      }, 0)
+    : 0;
+}
+
+// balance
+export function calculateTotalBalance(lineItems: Array<LineItem>, payments: Array<Payment>) {
+  return Math.min(this.calculateTotalAmount(lineItems) - this.calculateTotalAmountTendered(payments));
+}
+
+// total bill
+export function calculateTotalAmount(lineItems: Array<LineItem>) {
+  return Array.isArray(lineItems)
+    ? lineItems.reduce((totalAmount, item) => {
+        // Ensure that "price" and "quantity" properties are present and numeric
+        if (typeof item.price === 'number' && typeof item.quantity === 'number' && item.voided !== true) {
+          return totalAmount + item.price * item.quantity;
+        }
+        return totalAmount;
+      }, 0)
+    : 0;
+}
+
+export const convertToCurrency = (amountToConvert: number) => {
+  return formatCurrency(amountToConvert);
+};
+
+export const getGender = (gender: string, t) => {
+  switch (gender) {
+    case 'male':
+      return t('male', 'Male');
+    case 'female':
+      return t('female', 'Female');
+    case 'other':
+      return t('other', 'Other');
+    case 'unknown':
+      return t('unknown', 'Unknown');
+    default:
+      return gender;
+  }
+};
+
+/**
+ * Extracts and returns the substring after the first colon (:) in the input string.
+ * If there's no colon or the input is invalid, returns the original string.
+ * The input string is typically in the format "uuid:string".
+ *
+ * @param {string} input - The input string from which the substring is to be extracted.
+ * @returns {string} The substring found after the first colon, or the original string if no colon is present.
+ */
+export function extractString(input: string): string {
+  if (!input || typeof input !== 'string') {
+    return '';
+  }
+
+  const parts = input.split(':');
+  return parts.length > 1 ? parts[1] : input;
+}
+
+// cleans the provider display name
+export function extractNameString(formattedString: string) {
+  if (!formattedString) {
+    return '';
+  }
+  const parts = formattedString.split(' - ');
+  return parts.length > 1 ? parts[1] : '';
+}
+
+export function formatDate(date) {
+  return dayjs(date).format('YYYY-MM-DD');
+}

package/src/helpers/index.ts

@@ -0,0 +1 @@
+export * from './functions';

package/src/hooks/benefits.mock.ts

@@ -0,0 +1,391 @@
+export const category = [
+  {
+    id: 1,
+    code: 'SHA-01',
+    categoryName: 'Ambulance and Emergency Services',
+  },
+  {
+    id: 2,
+    code: 'SHA-02',
+    categoryName: 'Assistive Devices',
+  },
+  {
+    id: 3,
+    code: 'SHA-03',
+    categoryName: 'Critical Care Services',
+  },
+  {
+    id: 4,
+    code: 'SHA-04',
+    categoryName: 'End of Life services',
+  },
+  {
+    id: 5,
+    code: 'SHA-05',
+    categoryName: 'Optical Health Services',
+  },
+  {
+    id: 6,
+    code: 'SHA-06',
+    categoryName: 'Hematology and Oncology Services',
+  },
+  {
+    id: 7,
+    code: 'SHA-07',
+    categoryName: 'Inpatient Services',
+  },
+  {
+    id: 8,
+    code: 'SHA-08',
+    categoryName: 'Maternity and Child Health Services',
+  },
+  {
+    id: 9,
+    code: 'SHA-09',
+    categoryName: 'Medical Imaging & Other Investigations ',
+  },
+  {
+    id: 10,
+    code: 'SHA-10',
+    categoryName: 'Mental Wellness Services',
+  },
+  {
+    id: 11,
+    code: 'SHA-11',
+    categoryName: 'Oral Health Services',
+  },
+  {
+    id: 12,
+    code: 'SHA-12',
+    categoryName: 'Outpatient Services',
+  },
+  {
+    id: 13,
+    code: 'SHA-13',
+    categoryName: 'Palliative Care services',
+  },
+  {
+    id: 14,
+    code: 'SHA-14',
+    categoryName: 'Pharmacy Services',
+  },
+  {
+    id: 15,
+    code: 'SHA-15',
+    categoryName: 'Rehabilation Services',
+  },
+  {
+    id: 16,
+    code: 'SHA-16',
+    categoryName: 'Renal Care Services',
+  },
+  {
+    id: 17,
+    code: 'SHA-17',
+    categoryName: 'Screening',
+  },
+  {
+    id: 18,
+    code: 'SHA-18',
+    categoryName: 'Essential Diagnostic Laboratory listing for NCDs',
+  },
+  {
+    id: 19,
+    code: 'SHA-19',
+    categoryName: 'Surgical Services',
+  },
+  {
+    id: 20,
+    code: 'SHA-20',
+    categoryName: 'Overseas treatment',
+  },
+];
+
+export const interventions = [
+  {
+    interventionCode: 'SHA-01-001',
+    shaCategory: 'Ambulance & Emergency services',
+    accessCode: 'outpatient',
+    subCategoryBenefitsPackage: 'Evacuations',
+    interventionName: 'Ambulance services (Intra-metro within 25KM radius )',
+    needsPreAuth: 'NO',
+    categoryHealthFacility: 'Outsourced',
+    providerPaymentMechanism: 'FFS',
+    gender: '',
+    limitIndividualHousehold: 'None',
+    interventionQuantityYear: 'LIMITLESS',
+    tariffs: '',
+    limitIndividual: '',
+    minAge: '',
+    maxAge: '',
+    limitsIndividualHousehold: '',
+    phc: '0%',
+    shif: '0%',
+    eccif: '0%',
+    automateManual: 'N/A',
+  },
+  {
+    interventionCode: 'SHA-01-002',
+    shaCategory: 'Ambulance & Emergency services',
+    accessCode: '',
+    subCategoryBenefitsPackage: 'Evacuations',
+    interventionName: 'Ambulance services (Extra-metro,beyond 25KM )',
+    needsPreAuth: 'NO',
+    categoryHealthFacility: 'Outsourced',
+    providerPaymentMechanism: 'FFS',
+    gender: '',
+    limitIndividualHousehold: 'None',
+    interventionQuantityYear: 'LIMITLESS',
+    tariffs: '',
+    limitIndividual: '',
+    minAge: '',
+    maxAge: '',
+    limitsIndividualHousehold: '',
+    phc: '0%',
+    shif: '0%',
+    eccif: '0%',
+    automateManual: 'N/A',
+  },
+  {
+    interventionCode: 'SHA-01-003',
+    shaCategory: 'Ambulance & Emergency services',
+    accessCode: 'inpatient',
+    subCategoryBenefitsPackage: 'Emergency Room Services',
+    interventionName: 'Emergency room services',
+    needsPreAuth: 'YES',
+    categoryHealthFacility: 'In-network',
+    providerPaymentMechanism: 'Capitation',
+    gender: '',
+    limitIndividualHousehold: 'Individual',
+    interventionQuantityYear: '1',
+    tariffs: '10000',
+    limitIndividual: '10000',
+    minAge: '18',
+    maxAge: '65',
+    limitsIndividualHousehold: '10000',
+    phc: '20%',
+    shif: '80%',
+    eccif: '0%',
+    automateManual: 'AUTOMATE',
+  },
+  {
+    interventionCode: 'SHA-16-005',
+    shaCategory: 'Renal Care Package',
+    accessCode: '',
+    subCategoryBenefitsPackage: 'Renal Care package',
+    interventionName: 'Insertion of Continuous Ambulatory Peritoneal Dialysis (CAPD) catheter',
+    needsPreAuth: 'YES',
+    categoryHealthFacility: '',
+    providerPaymentMechanism: '',
+    gender: '',
+    limitIndividualHousehold: '',
+    interventionQuantityYear: '',
+    tariffs: '33600',
+    limitIndividual: '',
+    minAge: '',
+    maxAge: '',
+    limitsIndividualHousehold: 'Individual',
+    phc: '0%',
+    shif: '100%',
+    eccif: '0%',
+    automateManual: 'AUTOMATE',
+  },
+  {
+    interventionCode: 'SHA-02-003',
+    shaCategory: 'Assistive Devices',
+    accessCode: 'outpatient',
+    subCategoryBenefitsPackage: 'Prosthetics',
+    interventionName: 'Prosthetic limbs',
+    needsPreAuth: 'YES',
+    categoryHealthFacility: 'In-network',
+    providerPaymentMechanism: 'Capitation',
+    gender: '',
+    limitIndividualHousehold: 'Individual',
+    interventionQuantityYear: '1',
+    tariffs: '5000',
+    limitIndividual: '5000',
+    minAge: '18',
+    maxAge: '65',
+    limitsIndividualHousehold: '5000',
+    phc: '20%',
+    shif: '80%',
+    eccif: '0%',
+    automateManual: 'AUTOMATE',
+  },
+  {
+    interventionCode: 'SHA-02-004',
+    shaCategory: 'Assistive Devices',
+    accessCode: 'inpatient',
+    subCategoryBenefitsPackage: 'Orthotics',
+    interventionName: 'Orthotic devices',
+    needsPreAuth: 'YES',
+    categoryHealthFacility: 'In-network',
+    providerPaymentMechanism: 'Capitation',
+    gender: '',
+    limitIndividualHousehold: 'Individual',
+    interventionQuantityYear: '1',
+    tariffs: '3000',
+    limitIndividual: '3000',
+    minAge: '18',
+    maxAge: '65',
+    limitsIndividualHousehold: '3000',
+    phc: '20%',
+    shif: '80%',
+    eccif: '0%',
+    automateManual: 'AUTOMATE',
+  },
+  {
+    interventionCode: 'SHA-02-005',
+    shaCategory: 'Assistive Devices',
+    accessCode: 'outpatient',
+    subCategoryBenefitsPackage: 'Wheelchairs',
+    interventionName: 'Wheelchairs',
+    needsPreAuth: 'NO',
+    categoryHealthFacility: 'Outsourced',
+    providerPaymentMechanism: 'FFS',
+    gender: '',
+    limitIndividualHousehold: 'None',
+    interventionQuantityYear: 'LIMITLESS',
+    tariffs: '',
+    limitIndividual: '',
+    minAge: '',
+    maxAge: '',
+    limitsIndividualHousehold: '',
+    phc: '0%',
+    shif: '0%',
+    eccif: '0%',
+    automateManual: 'N/A',
+  },
+  {
+    interventionCode: 'SHA-03-004',
+    shaCategory: 'Critical Care Services',
+    accessCode: 'inpatient',
+    subCategoryBenefitsPackage: 'ICU Care',
+    interventionName: 'ICU care for critical patients',
+    needsPreAuth: 'YES',
+    categoryHealthFacility: 'In-network',
+    providerPaymentMechanism: 'Capitation',
+    gender: '',
+    limitIndividualHousehold: 'Individual',
+    interventionQuantityYear: '1',
+    tariffs: '10000',
+    limitIndividual: '10000',
+    minAge: '18',
+    maxAge: '65',
+    limitsIndividualHousehold: '10000',
+    phc: '20%',
+    shif: '80%',
+    eccif: '0%',
+    automateManual: 'AUTOMATE',
+  },
+  {
+    interventionCode: 'SHA-03-005',
+    shaCategory: 'Critical Care Services',
+    accessCode: 'inpatient',
+    subCategoryBenefitsPackage: 'CCU Care',
+    interventionName: 'CCU care for critical patients',
+    needsPreAuth: 'YES',
+    categoryHealthFacility: 'In-network',
+    providerPaymentMechanism: 'Capitation',
+    gender: '',
+    limitIndividualHousehold: 'Individual',
+    interventionQuantityYear: '1',
+    tariffs: '8000',
+    limitIndividual: '8000',
+    minAge: '18',
+    maxAge: '65',
+    limitsIndividualHousehold: '8000',
+    phc: '20%',
+    shif: '80%',
+    eccif: '0%',
+    automateManual: 'AUTOMATE',
+  },
+  {
+    interventionCode: 'SHA-03-006',
+    shaCategory: 'Critical Care Services',
+    accessCode: 'outpatient',
+    subCategoryBenefitsPackage: 'Emergency Response',
+    interventionName: 'Emergency response services',
+    needsPreAuth: 'NO',
+    categoryHealthFacility: 'Outsourced',
+    providerPaymentMechanism: 'FFS',
+    gender: '',
+    limitIndividualHousehold: 'None',
+    interventionQuantityYear: 'LIMITLESS',
+    tariffs: '',
+    limitIndividual: '',
+    minAge: '',
+    maxAge: '',
+    limitsIndividualHousehold: '',
+    phc: '0%',
+    shif: '0%',
+    eccif: '0%',
+    automateManual: 'N/A',
+  },
+  {
+    interventionCode: 'SHA-04-005',
+    shaCategory: 'End of Life services',
+    accessCode: 'outpatient',
+    subCategoryBenefitsPackage: 'Palliative Care',
+    interventionName: 'Palliative care services',
+    needsPreAuth: 'NO',
+    categoryHealthFacility: 'Outsourced',
+    providerPaymentMechanism: 'FFS',
+    gender: '',
+    limitIndividualHousehold: 'None',
+    interventionQuantityYear: 'LIMITLESS',
+    tariffs: '',
+    limitIndividual: '',
+    minAge: '',
+    maxAge: '',
+    limitsIndividualHousehold: '',
+    phc: '0%',
+    shif: '0%',
+    eccif: '0%',
+    automateManual: 'N/A',
+  },
+  {
+    interventionCode: 'SHA-04-006',
+    shaCategory: 'End of Life services',
+    accessCode: 'inpatient',
+    subCategoryBenefitsPackage: 'Hospice Care',
+    interventionName: 'Hospice care services',
+    needsPreAuth: 'YES',
+    categoryHealthFacility: 'In-network',
+    providerPaymentMechanism: 'Capitation',
+    gender: '',
+    limitIndividualHousehold: 'Individual',
+    interventionQuantityYear: '1',
+    tariffs: '6000',
+    limitIndividual: '6000',
+    minAge: '18',
+    maxAge: '65',
+    limitsIndividualHousehold: '6000',
+    phc: '20%',
+    shif: '80%',
+    eccif: '0%',
+    automateManual: 'AUTOMATE',
+  },
+  {
+    interventionCode: 'SHA-04-007',
+    shaCategory: 'End of Life services',
+    accessCode: 'outpatient',
+    subCategoryBenefitsPackage: 'Bereavement Support',
+    interventionName: 'Bereavement support services',
+    needsPreAuth: 'NO',
+    categoryHealthFacility: 'Outsourced',
+    providerPaymentMechanism: 'FFS',
+    gender: '',
+    limitIndividualHousehold: 'None',
+    interventionQuantityYear: 'LIMITLESS',
+    tariffs: '',
+    limitIndividual: '',
+    minAge: '',
+    maxAge: '',
+    limitsIndividualHousehold: '',
+    phc: '0%',
+    shif: '0%',
+    eccif: '0%',
+    automateManual: 'N/A',
+  },
+];

package/src/hooks/getMflCode.tsx

@@ -0,0 +1,19 @@
+import { OpenmrsResource, openmrsFetch } from '@openmrs/esm-framework';
+import useSWRImmutable from 'swr/immutable';
+
+export function useSystemSetting(key: string) {
+  const { data, isLoading } = useSWRImmutable<{ data: { results: Array<OpenmrsResource> } }>(
+    `/ws/rest/v1/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 };
+}