@apptimate/core-lib 1.7.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apptimate/core-lib",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "publishConfig": {

package/src/client.ts

@@ -8,3 +8,6 @@ export * from './common/interfaces/ICommon';
 export * from './constants/storageKeys';
 export * from './constants/menus';
 export * from './constants/iconRegistry';
+export * from './constants/currencies';
+export * from './utils/currencyService';
+

package/src/constants/currencies.ts

@@ -0,0 +1,163 @@
+export interface ICurrencyDetails {
+  name: string;
+  code: string;
+  symbol: string;
+}
+
+export const CURRENCIES: Record<string, ICurrencyDetails> = {
+  AED: { name: 'United Arab Emirates Dirham', code: 'AED', symbol: 'د.إ' },
+  AFN: { name: 'Afghan Afghani', code: 'AFN', symbol: '؋' },
+  ALL: { name: 'Albanian Lek', code: 'ALL', symbol: 'L' },
+  AMD: { name: 'Armenian Dram', code: 'AMD', symbol: '֏' },
+  ANG: { name: 'Netherlands Antillean Guilder', code: 'ANG', symbol: 'ƒ' },
+  AOA: { name: 'Angolan Kwanza', code: 'AOA', symbol: 'Kz' },
+  ARS: { name: 'Argentine Peso', code: 'ARS', symbol: '$' },
+  AUD: { name: 'Australian Dollar', code: 'AUD', symbol: '$' },
+  AWG: { name: 'Aruban Florin', code: 'AWG', symbol: 'ƒ' },
+  AZN: { name: 'Azerbaijani Manat', code: 'AZN', symbol: '₼' },
+  BAM: { name: 'Bosnia-Herzegovina Convertible Mark', code: 'BAM', symbol: 'KM' },
+  BBD: { name: 'Barbadian Dollar', code: 'BBD', symbol: '$' },
+  BDT: { name: 'Bangladeshi Taka', code: 'BDT', symbol: '৳' },
+  BGN: { name: 'Bulgarian Lev', code: 'BGN', symbol: 'лв' },
+  BHD: { name: 'Bahraini Dinar', code: 'BHD', symbol: '.د.ب' },
+  BIF: { name: 'Burundian Franc', code: 'BIF', symbol: 'FBu' },
+  BMD: { name: 'Bermudan Dollar', code: 'BMD', symbol: '$' },
+  BND: { name: 'Brunei Dollar', code: 'BND', symbol: '$' },
+  BOB: { name: 'Bolivian Boliviano', code: 'BOB', symbol: '$b' },
+  BRL: { name: 'Brazilian Real', code: 'BRL', symbol: 'R$' },
+  BSD: { name: 'Bahamian Dollar', code: 'BSD', symbol: '$' },
+  BTN: { name: 'Bhutanese Ngultrum', code: 'BTN', symbol: 'Nu.' },
+  BWP: { name: 'Botswanan Pula', code: 'BWP', symbol: 'P' },
+  BYN: { name: 'Belarusian Ruble', code: 'BYN', symbol: 'Br' },
+  BZD: { name: 'Belize Dollar', code: 'BZD', symbol: 'BZ$' },
+  CAD: { name: 'Canadian Dollar', code: 'CAD', symbol: '$' },
+  CDF: { name: 'Congolese Franc', code: 'CDF', symbol: 'FC' },
+  CHF: { name: 'Swiss Franc', code: 'CHF', symbol: 'CHF' },
+  CLP: { name: 'Chilean Peso', code: 'CLP', symbol: '$' },
+  CNY: { name: 'Chinese Yuan', code: 'CNY', symbol: '¥' },
+  COP: { name: 'Colombian Peso', code: 'COP', symbol: '$' },
+  CRC: { name: 'Costa Rican Colón', code: 'CRC', symbol: '₡' },
+  CUP: { name: 'Cuban Peso', code: 'CUP', symbol: '₱' },
+  CVE: { name: 'Cape Verdean Escudo', code: 'CVE', symbol: '$' },
+  CZK: { name: 'Czech Koruna', code: 'CZK', symbol: 'Kč' },
+  DJF: { name: 'Djiboutian Franc', code: 'DJF', symbol: 'Fdj' },
+  DKK: { name: 'Danish Krone', code: 'DKK', symbol: 'kr' },
+  DOP: { name: 'Dominican Peso', code: 'DOP', symbol: 'RD$' },
+  DZD: { name: 'Algerian Dinar', code: 'DZD', symbol: 'د.ج' },
+  EGP: { name: 'Egyptian Pound', code: 'EGP', symbol: '£' },
+  ERN: { name: 'Eritrean Nakfa', code: 'ERN', symbol: 'Nfk' },
+  ETB: { name: 'Ethiopian Birr', code: 'ETB', symbol: 'Br' },
+  EUR: { name: 'Euro', code: 'EUR', symbol: '€' },
+  FJD: { name: 'Fijian Dollar', code: 'FJD', symbol: '$' },
+  FKP: { name: 'Falkland Islands Pound', code: 'FKP', symbol: '£' },
+  GBP: { name: 'British Pound', code: 'GBP', symbol: '£' },
+  GEL: { name: 'Georgian Lari', code: 'GEL', symbol: '₾' },
+  GHS: { name: 'Ghanaian Cedi', code: 'GHS', symbol: 'GH₵' },
+  GIP: { name: 'Gibraltar Pound', code: 'GIP', symbol: '£' },
+  GMD: { name: 'Gambian Dalasi', code: 'GMD', symbol: 'D' },
+  GNF: { name: 'Guinean Franc', code: 'GNF', symbol: 'FG' },
+  GTQ: { name: 'Guatemalan Quetzal', code: 'GTQ', symbol: 'Q' },
+  GYD: { name: 'Guyanaese Dollar', code: 'GYD', symbol: '$' },
+  HKD: { name: 'Hong Kong Dollar', code: 'HKD', symbol: '$' },
+  HNL: { name: 'Honduran Lempira', code: 'HNL', symbol: 'L' },
+  HRK: { name: 'Croatian Kuna', code: 'HRK', symbol: 'kn' },
+  HTG: { name: 'Haitian Gourde', code: 'HTG', symbol: 'G' },
+  HUF: { name: 'Hungarian Forint', code: 'HUF', symbol: 'Ft' },
+  IDR: { name: 'Indonesian Rupiah', code: 'IDR', symbol: 'Rp' },
+  ILS: { name: 'Israeli New Shekel', code: 'ILS', symbol: '₪' },
+  INR: { name: 'Indian Rupee', code: 'INR', symbol: '₹' },
+  IQD: { name: 'Iraqi Dinar', code: 'IQD', symbol: 'ع.د' },
+  IRR: { name: 'Iranian Rial', code: 'IRR', symbol: '﷼' },
+  ISK: { name: 'Icelandic Króna', code: 'ISK', symbol: 'kr' },
+  JMD: { name: 'Jamaican Dollar', code: 'JMD', symbol: 'J$' },
+  JOD: { name: 'Jordanian Dinar', code: 'JOD', symbol: 'د.ا' },
+  JPY: { name: 'Japanese Yen', code: 'JPY', symbol: '¥' },
+  KES: { name: 'Kenyan Shilling', code: 'KES', symbol: 'KSh' },
+  KGS: { name: 'Kyrgystani Som', code: 'KGS', symbol: 'лв' },
+  KHR: { name: 'Cambodian Riel', code: 'KHR', symbol: '៛' },
+  KMF: { name: 'Comorian Franc', code: 'KMF', symbol: 'CF' },
+  KPW: { name: 'North Korean Won', code: 'KPW', symbol: '₩' },
+  KRW: { name: 'South Korean Won', code: 'KRW', symbol: '₩' },
+  KWD: { name: 'Kuwaiti Dinar', code: 'KWD', symbol: 'د.ك' },
+  KYD: { name: 'Cayman Islands Dollar', code: 'KYD', symbol: '$' },
+  KZT: { name: 'Kazakhstani Tenge', code: 'KZT', symbol: '₸' },
+  LAK: { name: 'Laotian Kip', code: 'LAK', symbol: '₭' },
+  LBP: { name: 'Lebanese Pound', code: 'LBP', symbol: '£' },
+  LKR: { name: 'Sri Lankan Rupee', code: 'LKR', symbol: 'Rs' },
+  LRD: { name: 'Liberian Dollar', code: 'LRD', symbol: '$' },
+  LSL: { name: 'Lesotho Loti', code: 'LSL', symbol: 'L' },
+  LYD: { name: 'Libyan Dinar', code: 'LYD', symbol: 'ل.د' },
+  MAD: { name: 'Moroccan Dirham', code: 'MAD', symbol: 'د.م.' },
+  MDL: { name: 'Moldovan Leu', code: 'MDL', symbol: 'L' },
+  MGA: { name: 'Malagasy Ariary', code: 'MGA', symbol: 'Ar' },
+  MKD: { name: 'Macedonian Denar', code: 'MKD', symbol: 'ден' },
+  MMK: { name: 'Myanmar Kyat', code: 'MMK', symbol: 'K' },
+  MNT: { name: 'Mongolian Tugrik', code: 'MNT', symbol: '₮' },
+  MOP: { name: 'Macanese Pataca', code: 'MOP', symbol: 'MOP$' },
+  MRU: { name: 'Mauritanian Ouguiya', code: 'MRU', symbol: 'UM' },
+  MUR: { name: 'Mauritian Rupee', code: 'MUR', symbol: '₨' },
+  MVR: { name: 'Maldivian Rufiyaa', code: 'MVR', symbol: 'Rf' },
+  MWK: { name: 'Malawian Kwacha', code: 'MWK', symbol: 'MK' },
+  MXN: { name: 'Mexican Peso', code: 'MXN', symbol: '$' },
+  MYR: { name: 'Malaysian Ringgit', code: 'MYR', symbol: 'RM' },
+  MZN: { name: 'Mozambican Metical', code: 'MZN', symbol: 'MT' },
+  NAD: { name: 'Namibian Dollar', code: 'NAD', symbol: '$' },
+  NGN: { name: 'Nigerian Naira', code: 'NGN', symbol: '₦' },
+  NIO: { name: 'Nicaraguan Córdoba', code: 'NIO', symbol: 'C$' },
+  NOK: { name: 'Norwegian Krone', code: 'NOK', symbol: 'kr' },
+  NPR: { name: 'Nepalese Rupee', code: 'NPR', symbol: '₨' },
+  NZD: { name: 'New Zealand Dollar', code: 'NZD', symbol: '$' },
+  OMR: { name: 'Omani Rial', code: 'OMR', symbol: 'ر.ع.' },
+  PAB: { name: 'Panamanian Balboa', code: 'PAB', symbol: 'B/.' },
+  PEN: { name: 'Peruvian Sol', code: 'PEN', symbol: 'S/.' },
+  PGK: { name: 'Papua New Guinean Kina', code: 'PGK', symbol: 'K' },
+  PHP: { name: 'Philippine Peso', code: 'PHP', symbol: '₱' },
+  PKR: { name: 'Pakistani Rupee', code: 'PKR', symbol: '₨' },
+  PLN: { name: 'Polish Zloty', code: 'PLN', symbol: 'zł' },
+  PYG: { name: 'Paraguayan Guarani', code: 'PYG', symbol: 'Gs' },
+  QAR: { name: 'Qatari Rial', code: 'QAR', symbol: 'ر.ق' },
+  RON: { name: 'Romanian Leu', code: 'RON', symbol: 'lei' },
+  RSD: { name: 'Serbian Dinar', code: 'RSD', symbol: 'Дин.' },
+  RUB: { name: 'Russian Ruble', code: 'RUB', symbol: '₽' },
+  RWF: { name: 'Rwandan Franc', code: 'RWF', symbol: 'FRw' },
+  SAR: { name: 'Saudi Riyal', code: 'SAR', symbol: 'ر.س' },
+  SBD: { name: 'Solomon Islands Dollar', code: 'SBD', symbol: '$' },
+  SCR: { name: 'Seychellois Rupee', code: 'SCR', symbol: '₨' },
+  SDG: { name: 'Sudanese Pound', code: 'SDG', symbol: 'ج.س.' },
+  SEK: { name: 'Swedish Krona', code: 'SEK', symbol: 'kr' },
+  SGD: { name: 'Singapore Dollar', code: 'SGD', symbol: 'S$' },
+  SHP: { name: 'Saint Helena Pound', code: 'SHP', symbol: '£' },
+  SLL: { name: 'Sierra Leonean Leone', code: 'SLL', symbol: 'Le' },
+  SOS: { name: 'Somali Shilling', code: 'SOS', symbol: 'S' },
+  SRD: { name: 'Surinamese Dollar', code: 'SRD', symbol: '$' },
+  SSP: { name: 'South Sudanese Pound', code: 'SSP', symbol: '£' },
+  STN: { name: 'São Tomé & Príncipe Dobra', code: 'STN', symbol: 'Db' },
+  SYP: { name: 'Syrian Pound', code: 'SYP', symbol: '£' },
+  SZL: { name: 'Swazi Lilangeni', code: 'SZL', symbol: 'L' },
+  THB: { name: 'Thai Baht', code: 'THB', symbol: '฿' },
+  TJS: { name: 'Tajikistani Somoni', code: 'TJS', symbol: 'SM' },
+  TMT: { name: 'Turkmenistani Manat', code: 'TMT', symbol: 'T' },
+  TND: { name: 'Tunisian Dinar', code: 'TND', symbol: 'د.ت' },
+  TOP: { name: 'Tongan Paʻanga', code: 'TOP', symbol: 'T$' },
+  TRY: { name: 'Turkish Lira', code: 'TRY', symbol: '₺' },
+  TTD: { name: 'Trinidad & Tobago Dollar', code: 'TTD', symbol: 'TT$' },
+  TWD: { name: 'New Taiwan Dollar', code: 'TWD', symbol: 'NT$' },
+  TZS: { name: 'Tanzanian Shilling', code: 'TZS', symbol: 'TSh' },
+  UAH: { name: 'Ukrainian Hryvnia', code: 'UAH', symbol: '₴' },
+  UGX: { name: 'Ugandan Shilling', code: 'UGX', symbol: 'USh' },
+  USD: { name: 'US Dollar', code: 'USD', symbol: '$' },
+  UYU: { name: 'Uruguayan Peso', code: 'UYU', symbol: '$U' },
+  UZS: { name: 'Uzbekistani Som', code: 'UZS', symbol: 'лв' },
+  VES: { name: 'Venezuelan Bolívar', code: 'VES', symbol: 'Bs.S.' },
+  VND: { name: 'Vietnamese Dong', code: 'VND', symbol: '₫' },
+  VUV: { name: 'Vanuatu Vatu', code: 'VUV', symbol: 'VT' },
+  WST: { name: 'Samoan Tala', code: 'WST', symbol: 'WS$' },
+  XAF: { name: 'CFA Franc BEAC', code: 'XAF', symbol: 'FCFA' },
+  XCD: { name: 'East Caribbean Dollar', code: 'XCD', symbol: '$' },
+  XOF: { name: 'CFA Franc BCEAO', code: 'XOF', symbol: 'CFA' },
+  XPF: { name: 'CFP Franc', code: 'XPF', symbol: '₣' },
+  YER: { name: 'Yemeni Rial', code: 'YER', symbol: '﷼' },
+  ZAR: { name: 'South African Rand', code: 'ZAR', symbol: 'R' },
+  ZMW: { name: 'Zambian Kwacha', code: 'ZMW', symbol: 'ZK' },
+  ZWL: { name: 'Zimbabwean Dollar', code: 'ZWL', symbol: '$' }
+};

package/src/constants/menus.ts

@@ -70,8 +70,10 @@ export const MENU_ITEM_REGISTRY: RegistryItem[] = [
   { key: 'core__feature_registry', label: 'Feature Registry', path: '/system/features', module: 'Core', defaultGroup: 'System Auditing' },
   { key: 'core__menu_config', label: 'Menu Configuration', path: '/menu-config', module: 'Core', defaultGroup: 'System' },
   { key: 'core__printables', label: 'Printable Templates', path: '/system/printables', module: 'Core', defaultGroup: 'System' },
+  { key: 'core__template_groups', label: 'Template Groups', path: '/system/template-groups', module: 'Core', defaultGroup: 'System' },
   { key: 'core__warehouses', label: 'Warehouses', path: '/warehouses', module: 'Core', defaultGroup: 'Resources' },
   { key: 'core__terminals', label: 'Terminals', path: '/terminals', module: 'Core', defaultGroup: 'Resources' },
+  { key: 'core__currencies', label: 'Currencies', path: '/currencies', module: 'Core', defaultGroup: 'Settings' },
 
   // ── Inventory Module ──
   { key: 'inventory__items', label: 'Items', path: '/inventory/items', module: 'Inventory', defaultGroup: 'Catalog' },
@@ -143,6 +145,21 @@ export const MENU_ITEM_REGISTRY: RegistryItem[] = [
   { key: 'jewelry__settings', label: 'Settings', path: '/jewelry/settings', module: 'Jewelry', defaultGroup: 'Configuration' },
   { key: 'jewelry__reports', label: 'Reports & Dashboards', path: '/reports/jewelry', module: 'Jewelry', defaultGroup: 'Analytics' },
 
+  // ── HR Module ──
+  { key: 'hr__employees', label: 'Employees', path: '/hr/employees', module: 'HR', defaultGroup: 'Core' },
+  { key: 'hr__directory', label: 'Directory', path: '/hr/directory', module: 'HR', defaultGroup: 'Core' },
+  { key: 'hr__org_chart', label: 'Org Chart', path: '/hr/org-chart', module: 'HR', defaultGroup: 'Core' },
+
+  { key: 'hr__attendance', label: 'Attendance', path: '/hr/attendance', module: 'HR', defaultGroup: 'Time' },
+  { key: 'hr__regularisation', label: 'Regularisation', path: '/hr/regularisation', module: 'HR', defaultGroup: 'Time' },
+  { key: 'hr__shift_templates', label: 'Shift Templates', path: '/hr/shift-templates', module: 'HR', defaultGroup: 'Time' },
+  { key: 'hr__rosters', label: 'Roster Builder', path: '/hr/rosters', module: 'HR', defaultGroup: 'Time' },
+  { key: 'hr__shift_exchanges', label: 'Shift Exchanges', path: '/hr/shift-exchanges', module: 'HR', defaultGroup: 'Time' },
+  { key: 'hr__shift_allowances', label: 'Shift Allowances', path: '/hr/shift-allowances', module: 'HR', defaultGroup: 'Time' },
+  { key: 'hr__leave_types', label: 'Leave Types', path: '/hr/leave-types', module: 'HR', defaultGroup: 'Time' },
+  { key: 'hr__holidays', label: 'Holidays', path: '/hr/holidays', module: 'HR', defaultGroup: 'Time' },
+  { key: 'hr__leave', label: 'Leave Management', path: '/hr/leave', module: 'HR', defaultGroup: 'Time' },
+  { key: 'hr__designations', label: 'Designations', path: '/hr/designations', module: 'HR', defaultGroup: 'Admin' },
   // ── Money Exchange Module ──
   { key: 'money_exchange__dashboard', label: 'Dashboard', path: '/money-exchange', module: 'Money Exchange', defaultGroup: 'Overview' },
   { key: 'money_exchange__rates', label: 'Rates Management', path: '/money-exchange/rates', module: 'Money Exchange', defaultGroup: 'Overview' },
@@ -155,6 +172,7 @@ export const MENU_ITEM_REGISTRY: RegistryItem[] = [
   { key: 'money_exchange__remittance_corridors', label: 'Corridors', path: '/money-exchange/corridors', module: 'Money Exchange', defaultGroup: 'Remittances' },
   { key: 'money_exchange__remittances', label: 'Transactions', path: '/money-exchange/remittances', module: 'Money Exchange', defaultGroup: 'Remittances' },
   { key: 'money_exchange__remittance_settlements', label: 'Settlements', path: '/money-exchange/settlements', module: 'Money Exchange', defaultGroup: 'Remittances' },
+  { key: 'money_exchange__denominations', label: 'Denomination', path: '/money-exchange/denominations', module: 'Money Exchange', defaultGroup: 'Config' },
 ];
 
 /**
@@ -238,7 +256,7 @@ export const MENU_PRESETS: MenuPreset[] = [
           'core__warehouses', 'core__terminals',
           'core__activity_logs', 'core__api_requests', 'core__feature_access_logs',
           'core__issue_logs', 'core__feature_registry', 'core__menu_config',
-          'core__printables',
+          'core__printables', 'core__template_groups', 'core__currencies',
         ],
       },
       {
@@ -300,6 +318,14 @@ export const MENU_PRESETS: MenuPreset[] = [
           'jewelry__settings',
         ],
       },
+      {
+        id: 'hr',
+        label: 'HR',
+        iconName: 'Users',
+        secondaryItems: [
+          'hr__employees', 'hr__directory', 'hr__org_chart', 'hr__attendance', 'hr__regularisation', 'hr__shifts', 'hr__shift_templates', 'hr__rosters', 'hr__shift_exchanges', 'hr__shift_allowances', 'hr__leave_types', 'hr__holidays', 'hr__leave', 'hr__designations'
+        ]
+      },
       {
         id: 'money_exchange',
         label: 'Money Exchange',
@@ -316,6 +342,7 @@ export const MENU_PRESETS: MenuPreset[] = [
           'money_exchange__remittance_corridors',
           'money_exchange__remittances',
           'money_exchange__remittance_settlements',
+          'money_exchange__denominations',
         ],
       },
     ],
@@ -348,6 +375,7 @@ export const APP_MENUS: MainMenuItem[] = [
         items: [
           { id: "menu_config", label: "Menu Configuration", path: "/menu-config" },
           { id: "printables", label: "Printable Templates", path: "/system/printables" },
+          { id: "template_groups", label: "Template Groups", path: "/system/template-groups" },
         ],
       },
       {
@@ -369,6 +397,13 @@ export const APP_MENUS: MainMenuItem[] = [
           { id: "feature_registry", label: "Feature Registry", path: "/system/features" },
         ],
       },
+      {
+        id: "core_settings",
+        label: "Settings",
+        items: [
+          { id: "currencies", label: "Currencies", path: "/currencies" },
+        ],
+      },
     ],
   },
   {
@@ -691,6 +726,13 @@ export const APP_MENUS: MainMenuItem[] = [
           { id: "money_exchange_remittance_settlements", label: "Settlements", path: "/money-exchange/settlements" },
         ],
       },
+      {
+        id: "money_exchange_config",
+        label: "Config",
+        items: [
+          { id: "money_exchange_denominations", label: "Denomination", path: "/money-exchange/denominations" },
+        ],
+      },
     ],
   },
 ];

package/src/utils/currencyService.ts

@@ -0,0 +1,50 @@
+import { CURRENCIES, type ICurrencyDetails } from '../constants/currencies';
+import { sendRequest } from './httpClient';
+
+/**
+ * Retrieve the active/used currency based on the backend configuration.
+ */
+export async function getUsedCurrency(): Promise<ICurrencyDetails | null> {
+    try {
+        const response = await sendRequest<any>({
+            url: `${process.env.NEXT_PUBLIC_API_URL}/api/core/config/used_currency`,
+            method: 'GET',
+        });
+
+        if (response.ok && response.responseData.is_success && response.responseData.result) {
+            const currency = response.responseData.result;
+            
+            // Return from database core_currencies row directly
+            if (currency && typeof currency === 'object' && currency.code) {
+                return {
+                    name: currency.name || currency.code,
+                    code: currency.code,
+                    symbol: currency.symbol || currency.code,
+                };
+            }
+            
+            return getCurrency(currency as string);
+        }
+    } catch (error) {
+        console.error('Failed to fetch used currency:', error);
+    }
+    
+    return null;
+}
+
+
+/**
+ * Retrieve metadata details (name, code, symbol) for a currency by its ISO code.
+ */
+export function getCurrency(code: string): ICurrencyDetails | null {
+    if (!code) return null;
+    return CURRENCIES[code.toUpperCase()] || null;
+}
+
+/**
+ * Retrieve the symbol for a currency by its ISO code. Falls back to returning the code if not found.
+ */
+export function getCurrencySymbol(code: string): string {
+    if (!code) return '';
+    return CURRENCIES[code.toUpperCase()]?.symbol || code;
+}