@digihmis/esm-billing-app 1.0.0

package/src/utils/index.ts

@@ -0,0 +1,270 @@
+import { useConfig } from '@openmrs/esm-framework';
+import { BillingConfig } from '../config-schema';
+
+export const DEFAULT_LOCALE_CURRENCY_MAP: Record<string, string> = {
+  en: 'KES', // English - Kenyan Shilling
+  sw: 'KES', // Swahili - Kenyan Shilling
+  am: 'ETB', // Amharic - Ethiopian Birr
+  ar: 'SAR', // Arabic - Saudi Riyal
+  es: 'EUR', // Spanish - Euro
+  fr: 'EUR', // French - Euro
+  he: 'ILS', // Hebrew - Israeli Shekel
+  km: 'KHR', // Khmer - Cambodian Riel
+  pt: 'EUR', // Portuguese - Euro
+  vi: 'VND', // Vietnamese - Vietnamese Dong
+  zh: 'CNY', // Chinese - Chinese Yuan
+  'en-KE': 'KES', // English Kenya
+  'sw-KE': 'KES', // Swahili Kenya
+  'am-ET': 'ETB', // Amharic Ethiopia
+};
+
+/**
+ * Custom currency symbols that override the default Intl display
+ * Use this to force "KES" instead of "KSH" in Swahili
+ */
+const CUSTOM_CURRENCY_SYMBOLS: Record<string, string> = {
+  KES: 'KES',
+  ETB: 'ETB',
+  // Add more custom symbols as needed
+};
+
+/**
+ * Gets the currency code for the current locale
+ * @returns The currency code (e.g., 'KES', 'ETB', 'USD')
+ */
+export const getCurrencyForLocale = (): string => {
+  const currentLocale = localStorage.getItem('i18nextLng') ?? 'en';
+
+  // Try exact match first
+  if (DEFAULT_LOCALE_CURRENCY_MAP[currentLocale]) {
+    return DEFAULT_LOCALE_CURRENCY_MAP[currentLocale];
+  }
+
+  // Try base language (e.g., 'en-US' → 'en')
+  const baseLanguage = currentLocale.split('-')[0];
+  if (DEFAULT_LOCALE_CURRENCY_MAP[baseLanguage]) {
+    return DEFAULT_LOCALE_CURRENCY_MAP[baseLanguage];
+  }
+
+  // Final fallback
+  return 'USD';
+};
+
+/**
+ * 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', 'USD')
+ */
+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;
+
+  // Try exact match first
+  if (currencyMap[currentLocale]) {
+    return currencyMap[currentLocale];
+  }
+
+  // Try base language (e.g., 'en-US' → 'en')
+  const baseLanguage = currentLocale.split('-')[0];
+  if (currencyMap[baseLanguage]) {
+    return currencyMap[baseLanguage];
+  }
+
+  // Final fallback
+  return 'USD';
+};
+
+/**
+ * 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 currency with custom symbol override to force "KES" instead of "KSH"
+ * @param amount - The amount to format
+ * @param currency - The currency code
+ * @param locale - The locale to use for formatting
+ * @returns Formatted currency string with custom symbol
+ */
+const formatWithCustomSymbol = (amount: number, currency: string, locale: string): string => {
+  const customSymbol = CUSTOM_CURRENCY_SYMBOLS[currency];
+
+  if (customSymbol) {
+    // Format without currency symbol, then add custom symbol
+    const formatter = new Intl.NumberFormat(locale, {
+      style: 'decimal',
+      minimumFractionDigits: 2,
+      maximumFractionDigits: 2,
+    });
+
+    const formattedNumber = formatter.format(Math.abs(amount));
+    const prefix = amount < 0 ? '- ' : '';
+
+    return `${prefix}${customSymbol} ${formattedNumber}`;
+  }
+
+  // Fallback to standard formatting
+  const formatter = new Intl.NumberFormat(locale, {
+    style: 'currency',
+    currency: currency,
+    minimumFractionDigits: 2,
+  });
+
+  return formatter.format(amount);
+};
+
+/**
+ * Formats a number as currency based on the current locale
+ * Forces "KES" display instead of "KSH" for Kenyan Shilling
+ * @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();
+
+  // Use custom formatting for currencies with custom symbols
+  if (CUSTOM_CURRENCY_SYMBOLS[currency]) {
+    return formatWithCustomSymbol(amount, currency, currentLocale);
+  }
+
+  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
+ * Forces "KES" display instead of "KSH" for Kenyan Shilling
+ * @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();
+
+  // Use custom formatting for currencies with custom symbols
+  if (CUSTOM_CURRENCY_SYMBOLS[currency]) {
+    const formatter = new Intl.NumberFormat(currentLocale, {
+      style: 'decimal',
+      minimumFractionDigits: 2,
+      maximumFractionDigits: 2,
+    });
+
+    const formattedNumber = formatter.format(amount);
+    return `${CUSTOM_CURRENCY_SYMBOLS[currency]} ${formattedNumber}`;
+  }
+
+  const formatter = new Intl.NumberFormat(currentLocale, {
+    style: 'currency',
+    currency: currency,
+    ...options,
+  });
+
+  return formatter.format(amount);
+};
+
+/**
+ * Hook to get currency formatting with config support
+ * Forces "KES" display instead of "KSH" for Kenyan Shilling
+ * @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();
+
+    // Use custom formatting for currencies with custom symbols
+    if (CUSTOM_CURRENCY_SYMBOLS[currency]) {
+      return formatWithCustomSymbol(amount, currency, currentLocale);
+    }
+
+    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();
+
+    // Use custom formatting for currencies with custom symbols
+    if (CUSTOM_CURRENCY_SYMBOLS[currency]) {
+      const formatter = new Intl.NumberFormat(currentLocale, {
+        style: 'decimal',
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
+      });
+
+      const formattedNumber = formatter.format(amount);
+      return `${CUSTOM_CURRENCY_SYMBOLS[currency]} ${formattedNumber}`;
+    }
+
+    const formatter = new Intl.NumberFormat(currentLocale, {
+      style: 'currency',
+      currency: currency,
+      ...options,
+    });
+
+    return formatter.format(amount);
+  };
+
+  return {
+    getCurrency,
+    getLocale,
+    format,
+    formatSimple,
+  };
+};
+
+/**
+ * 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;
+}

package/translations/am.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/translations/ar.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/translations/en.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/translations/es.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/translations/fr.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/translations/he.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/translations/km.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/translations/pt.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/translations/sw.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/translations/vi.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/translations/zh.json

@@ -0,0 +1,18 @@
+{
+  "cash": "Cash",
+  "enterPolicyNumber": "Enter policy number",
+  "exemptionCategory": "Exemption category",
+  "insurance": "Insurance",
+  "insuranceScheme": "Insurance scheme",
+  "isPatientExemptedLegend": "Will the patient pay for services?",
+  "loading": "Loading data...",
+  "loadingDescription": "Loading",
+  "nonPayingPatient": "No, non-paying patient (exempt)",
+  "patientCategory": "Payment Category",
+  "payingPatient": "Yes, paying patient",
+  "paymentMethodsTitle": "Payment method",
+  "policyNumber": "Policy number",
+  "selectExemptionCategory": "Select exemption category",
+  "selectInsuranceScheme": "Select insurance scheme",
+  "selectPaymentMethod": "Select payment method"
+}

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.json",
+  "include": ["src/**/*"],
+  "exclude": ["src/**/*.test.tsx"]
+}