formula-parser-payroll 2.1.0

package/README.md

@@ -0,0 +1,202 @@
+# payroll-formula-parser
+
+> A lightweight, high-performance payroll formula parser. Parse and evaluate payroll formulas with employee data variables.
+
+## 📦 Installation
+
+```bash
+npm install payroll-formula-parser
+```
+
+## 🚀 Quick Start
+
+### Basic Usage
+
+```typescript
+import { PayrollFormulaService } from 'payroll-formula-parser';
+
+const service = new PayrollFormulaService(n7);
+
+// Parse formula for a single employee
+const result = await service.parseByEmpId({
+  formula: 'SALARY * 0.1 + AL_001',
+  empId: 'EMP001',
+  auth: {
+    conn: mysqlConnection,      // Your database connection
+    connFin: mysqlConnection,    // Financial DB connection
+    userData: {
+      companyId: '1',
+      companyCode: 'COMP001',
+      taxCountry: 'ID'
+    }
+  }
+});
+
+console.log(result.hasil); // Formula result
+```
+
+### Processing Multiple Employees
+
+```typescript
+// Process multiple employees in parallel (with automatic chunking)
+const results = await service.parseByEmpId({
+  formula: 'SALARY * 0.1 + AL_001',
+  listEmpId: ['EMP001', 'EMP002', 'EMP003', ...], // Can handle thousands!
+  auth: authContext
+});
+
+// Results: { EMP001: 5000, EMP002: 6000, EMP003: 5500, ... }
+```
+
+### Formula Validation
+
+```typescript
+// Validate formula syntax before execution
+const validation = await service.formulaValidityCheck({
+  formula: 'IF(GRADE = "A", SALARY * 1.2, SALARY)',
+  auth: authContext
+});
+
+console.log(validation.result); // 'success' or error message
+```
+
+## 📚 Supported Formula Syntax
+
+### Variables
+
+- **Employee Data**: `SALARY`, `GRADE`, `POSITION`, `DEPARTMENT`, `COSTCENTER`, etc.
+- **Payroll Components**: `AL_001`, `DE_002`, `NE_003` (Allowances, Deductions, Net Earnings)
+- **Custom Fields**: `CUSTOMFIELD1` through `CUSTOMFIELD10`
+- **Dates**: `JOINDATE`, `STARTDATE`, `ENDDATE`, `BIRTHDATE`, etc.
+
+### Functions
+
+#### Logical Functions
+- `IF(condition, true_value, false_value)`
+- `AND(condition1, condition2, ...)`
+- `OR(condition1, condition2, ...)`
+- `NOT(condition)`
+
+#### Math Functions
+- `ROUND(number, decimals)`
+- `ROUNDUP(number, decimals)`
+- `ROUNDDOWN(number, decimals)`
+- `TRUNC(number)`
+- `MIN(value1, value2, ...)`
+- `MAX(value1, value2, ...)`
+- `MOD(number, divisor)`
+
+#### Date Functions
+- `TODAY()` - Current date
+- `DATETIME_NOW()` - Current datetime
+- `DATE(year, month, day)`
+- `YEAR(date)`, `MONTH(date)`, `DAY(date)`
+- `DATEDIFF(date1, date2, unit)`
+- `DATEADD(date, number, unit)`
+- `DAYSINMONTH(date)`
+- `DAYOFWEEK(date)`
+- `LENGTHOFSERVICE(startDate, endDate, unit)`
+
+#### String Functions
+- `CONCATENATE(str1, str2, ...)`
+- `CONCATENATESKIPNULL(str1, str2, ...)`
+- `FINDLIST(value, list, delimiter)`
+
+#### Other Functions
+- `ISNUMERIC(value)`
+- `ISDATE(value)`
+- `CHILDDEPENDENTS` - Count of child dependents
+
+### Example Formulas
+
+```typescript
+// Conditional bonus based on grade
+'IF(GRADE = "A", SALARY * 0.2, SALARY * 0.1)'
+
+// Complex calculation with multiple conditions
+'IF(AND(GRADE = "A", LENGTHOFSERVICE(JOINDATE, TODAY(), "Y") > 5), SALARY * 1.5, SALARY)'
+
+// Date-based calculation
+'IF(DATEDIFF(TODAY(), JOINDATE, "M") > 12, AL_001 * 1.1, AL_001)'
+
+// Rounding
+'ROUND(SALARY * 0.15, 2)'
+```
+
+## ⚡ Performance Optimizations
+
+### Automatic Chunking
+When processing large employee lists, the service automatically chunks them into batches of 50 to prevent memory overflow while maintaining parallel processing speed.
+
+```typescript
+// Processes 1000 employees in 20 chunks of 50 (parallel within each chunk)
+const results = await service.parseByEmpId({
+  formula: 'SALARY * 0.1',
+  listEmpId: [...1000employees], // Automatically chunked!
+  auth: authContext
+});
+```
+
+### Smart Component Detection
+Only fetches payroll components that are actually used in the formula:
+
+```typescript
+// Formula: 'AL_001 + AL_002'
+// ✅ Only fetches AL_001 and AL_002 from database
+// ❌ Doesn't fetch all 100+ components
+```
+
+### Chunked Decryption
+Decrypts employee component values in batches of 20 to balance speed and resource usage.
+
+### Caching
+- **Reserved words cache**: 5-minute TTL
+- **Component list cache**: 5-minute TTL
+- Clear cache manually: `service.clearCache()` or `service.clearCacheForCompany(companyId, taxCountry)`
+
+## 📖 API Reference
+
+### `PayrollFormulaService`
+
+#### `parseByEmpId(input: ParseByEmpIdInput)`
+
+Parse formula for one or multiple employees.
+
+**Parameters:**
+- `formula` (string): The formula to parse
+- `empId` (string, optional): Single employee ID
+- `listEmpId` (string[], optional): Multiple employee IDs
+- `auth` (AuthContext): Authentication and database context
+
+**Returns:**
+- Single employee: `FormulaParseResultLegacy` with `hasil` and `message`
+- Multiple employees: `Record<empId, result>`
+
+#### `formulaValidityCheck(input: { formula: string; auth: AuthContext })`
+
+Validate formula syntax.
+
+**Returns:**
+- `{ result: 'success' }` or throws error with details
+
+#### `clearCache()`
+
+Clear all caches.
+
+#### `clearCacheForCompany(companyId: string, taxCountry: string)`
+
+Clear cache for specific company.
+
+## 🏗️ Architecture
+
+```
+src/
+├── formula-engine.ts          # Core formula parser (hot-formula-parser wrapper)
+├── formula-parser.ts          # Variable processing logic
+├── types.ts                   # Type definitions
+└── database/
+    ├── payroll-formula.service.ts  # Main service with optimizations
+    ├── database-connector.ts       # Database interface
+    ├── helpers.ts                  # Utility functions
+    └── types.ts                    # Database-specific types
+```

package/dist/database/database-connector.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Database Connector Interface
+ *
+ * Generic database connector that can work with any database client
+ * (MySQL2, TypeORM, Knex, Sequelize, etc.)
+ */
+/**
+ * Generic database connection interface
+ * Any database client that implements this interface can be used
+ */
+export interface IDatabaseConnection {
+    /**
+     * Execute a raw SQL query with optional parameters
+     * @param sql SQL query string with placeholders (?)
+     * @param params Query parameters
+     * @returns Promise with query results
+     */
+    query<T = any>(sql: string, params?: any[]): Promise<T[]>;
+}
+/**
+ * Configuration for database connections
+ */
+export interface DatabaseConfig {
+    /** Main database connection (for employee/organization data) */
+    mainConnection: IDatabaseConnection;
+    /** Finance database connection (for payroll/component data) */
+    financeConnection: IDatabaseConnection;
+}
+/**
+ * Company and user context for queries
+ */
+export interface CompanyContext {
+    /** Company ID */
+    companyId: string | number;
+    /** Company Code */
+    companyCode: string;
+    /** Tax Country Code (ID, TH, MY, PH) */
+    taxCountry: 'ID' | 'TH' | 'MY' | 'PH';
+}
+/**
+ * Encryption configuration for decrypting component values
+ */
+export interface EncryptionConfig {
+    /** P Number for decryption function */
+    pNumber: string;
+    /** L Number for decryption function */
+    lNumber: string;
+}
+/**
+ * Complete context for formula parsing with database
+ */
+export interface FormulaContext {
+    /** Database connections */
+    database: DatabaseConfig;
+    /** Company and user context */
+    company: CompanyContext;
+    /** Encryption config (optional - needed only if components are encrypted) */
+    encryption?: EncryptionConfig;
+}
+//# sourceMappingURL=database-connector.d.ts.map

package/dist/database/database-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-connector.d.ts","sourceRoot":"","sources":["../../src/database/database-connector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,cAAc,EAAE,mBAAmB,CAAC;IAEpC,+DAA+D;IAC/D,iBAAiB,EAAE,mBAAmB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAE3B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,QAAQ,EAAE,cAAc,CAAC;IAEzB,+BAA+B;IAC/B,OAAO,EAAE,cAAc,CAAC;IAExB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B"}

package/dist/database/database-connector.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Database Connector Interface
+ *
+ * Generic database connector that can work with any database client
+ * (MySQL2, TypeORM, Knex, Sequelize, etc.)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=database-connector.js.map

package/dist/database/database-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-connector.js","sourceRoot":"","sources":["../../src/database/database-connector.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/database/helpers.d.ts

@@ -0,0 +1,44 @@
+/**
+ * NestJS Module Helpers for Payroll Formula Parser
+ *
+ * Helper functions for database operations and data processing.
+ */
+import { AuthContext, FormulaContext } from './types';
+/**
+ * Get currency code based on tax country
+ */
+export declare function getCurrencyCode(taxCountry: string): string;
+/**
+ * Decrypt a value using database function
+ */
+export declare function decryptValue(value: string, auth: AuthContext, empId: string): Promise<number>;
+/**
+ * Check if position-related data is needed
+ */
+export declare function needsPositionData(words: Set<string>): boolean;
+/**
+ * Check if cost center data is needed
+ */
+export declare function needsCostCenterData(words: Set<string>): boolean;
+/**
+ * Check if grade data is needed
+ */
+export declare function needsGradeData(words: Set<string>): boolean;
+/**
+ * Check if work location data is needed
+ */
+export declare function needsWorkLocationData(words: Set<string>): boolean;
+/**
+ * Check if custom field data is needed
+ */
+export declare function needsCustomFieldData(words: Set<string>): boolean;
+/**
+ * Format name for formula with proper case handling
+ */
+export declare function formatNameForFormula(name: string, formula: string): string;
+/**
+ * Convert legacy AuthContext to new FormulaContext
+ * This helps with backward compatibility
+ */
+export declare function convertAuthToFormulaContext(auth: AuthContext): FormulaContext;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/database/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/database/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAoB,cAAc,EAAE,MAAM,SAAS,CAAC;AAExE;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAK7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAE/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAKhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAc1E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAgB7E"}

package/dist/database/helpers.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * NestJS Module Helpers for Payroll Formula Parser
+ *
+ * Helper functions for database operations and data processing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrencyCode = getCurrencyCode;
+exports.decryptValue = decryptValue;
+exports.needsPositionData = needsPositionData;
+exports.needsCostCenterData = needsCostCenterData;
+exports.needsGradeData = needsGradeData;
+exports.needsWorkLocationData = needsWorkLocationData;
+exports.needsCustomFieldData = needsCustomFieldData;
+exports.formatNameForFormula = formatNameForFormula;
+exports.convertAuthToFormulaContext = convertAuthToFormulaContext;
+/**
+ * Get currency code based on tax country
+ */
+function getCurrencyCode(taxCountry) {
+    switch (taxCountry) {
+        case 'TH': return 'THB';
+        case 'PH': return 'PHP';
+        case 'MY': return 'MYR';
+        default: return 'IDR';
+    }
+}
+/**
+ * Decrypt a value using database function
+ */
+async function decryptValue(value, auth, empId) {
+    try {
+        const q = `SELECT SF2356896('${value}',
+      '${auth.accessToken.confParse.PNUMBER}',
+      '${auth.accessToken.confParse.LNUMBER}',
+      '${empId}') AS result`;
+        const result = await auth.connFin.query(q);
+        if (result.length > 0) {
+            return result[0].result;
+        }
+        return 0;
+    }
+    catch (error) {
+        return 0;
+    }
+}
+/**
+ * Check if position-related data is needed
+ */
+function needsPositionData(words) {
+    return words.has('DEPTNAME') ||
+        words.has('POSITIONNAME') ||
+        words.has('POSITIONCODE') ||
+        words.has('DEPTCODE');
+}
+/**
+ * Check if cost center data is needed
+ */
+function needsCostCenterData(words) {
+    return words.has('COSTCENTER') || words.has('COSTCENTERCODE');
+}
+/**
+ * Check if grade data is needed
+ */
+function needsGradeData(words) {
+    return words.has('GRADE') || words.has('GRDCODE');
+}
+/**
+ * Check if work location data is needed
+ */
+function needsWorkLocationData(words) {
+    return words.has('WORKLOCATION') || words.has('WORKLOCATIONCODE');
+}
+/**
+ * Check if custom field data is needed
+ */
+function needsCustomFieldData(words) {
+    for (let i = 1; i <= 10; i++) {
+        if (words.has(`CUSTOMFIELD${i}`))
+            return true;
+    }
+    return false;
+}
+/**
+ * Format name for formula with proper case handling
+ */
+function formatNameForFormula(name, formula) {
+    if (!name)
+        return '""';
+    const upperName = name.replace(/ /g, '').toUpperCase();
+    const normalName = name;
+    const hasUpperInFormula = formula.includes(`"${upperName}"`) ||
+        formula.includes(`'${upperName}'`);
+    if (hasUpperInFormula) {
+        return `"${upperName}"`;
+    }
+    return `"${normalName}"`;
+}
+/**
+ * Convert legacy AuthContext to new FormulaContext
+ * This helps with backward compatibility
+ */
+function convertAuthToFormulaContext(auth) {
+    return {
+        database: {
+            mainConnection: auth.conn,
+            financeConnection: auth.connFin,
+        },
+        company: {
+            companyId: auth.userData.companyId,
+            companyCode: auth.userData.companyCode || auth.userData.currentCompanyCode || '',
+            taxCountry: (auth.userData.taxCountry || 'ID'),
+        },
+        encryption: auth.accessToken?.confParse ? {
+            pNumber: auth.accessToken.confParse.PNUMBER,
+            lNumber: auth.accessToken.confParse.LNUMBER,
+        } : undefined,
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/database/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/database/helpers.ts"],"names":[],"mappings":"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"}

package/dist/database/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * NestJS Module for Payroll Formula Parser
+ *
+ * This module provides database-integrated formula parsing.
+ * Works with any database client that implements the IDatabaseConnection interface.
+ */
+export * from './database-connector';
+export * from './types';
+export * from './helpers';
+export { PayrollFormulaService } from './payroll-formula.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/database/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * NestJS Module for Payroll Formula Parser
+ *
+ * This module provides database-integrated formula parsing.
+ * Works with any database client that implements the IDatabaseConnection interface.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PayrollFormulaService = void 0;
+__exportStar(require("./database-connector"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./helpers"), exports);
+var payroll_formula_service_1 = require("./payroll-formula.service");
+Object.defineProperty(exports, "PayrollFormulaService", { enumerable: true, get: function () { return payroll_formula_service_1.PayrollFormulaService; } });
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,uDAAqC;AACrC,0CAAwB;AACxB,4CAA0B;AAC1B,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA"}

package/dist/database/payroll-formula.service.d.ts

@@ -0,0 +1,118 @@
+/**
+ * NestJS Payroll Formula Parser Service
+ *
+ * This service provides database-integrated formula parsing.
+ * It fetches employee data and component values from the database
+ * and then uses the core formula parser.
+ */
+import { AuthContext, ParseByEmpIdInput, FormulaParseResultLegacy } from './types';
+/**
+ * Payroll Formula Parser Service
+ *
+ * Use this service when you need to parse formulas with just formula and empId.
+ * This service handles fetching employee data and component values from the database.
+ *
+ * @example
+ * ```typescript
+ * const service = new PayrollFormulaService();
+ * const result = await service.parseByEmpId({
+ *   formula: 'SALARY * 0.1 + AL_001',
+ *   empId: 'EMP001',
+ *   auth: authContext,
+ * });
+ * console.log(result.result);
+ * ```
+ */
+export declare class PayrollFormulaService {
+    private reservedWordsCache;
+    private componentListCache;
+    private readonly CACHE_TTL;
+    private readonly CHUNK_SIZE;
+    /**
+     * Parse formula by employee ID(s)
+     * This method fetches all required data from database and evaluates the formula
+     *
+     * When listEmpId is provided: returns Record<empId, hasil>
+     * When empId is provided: returns FormulaParseResultLegacy
+     */
+    parseByEmpId(input: ParseByEmpIdInput): Promise<FormulaParseResultLegacy | Record<string, number | string | boolean>>;
+    /**
+     * Check if a formula is valid
+     * This ports the logic from payroll-server's formulaValidtyCheck
+     */
+    formulaValidityCheck(input: {
+        formula: string;
+        auth: AuthContext;
+    }): Promise<{
+        result: string;
+    }>;
+    /**
+     * Clear all caches (useful for testing or when data is updated)
+     */
+    clearCache(): void;
+    /**
+     * Clear cache for specific company
+     */
+    clearCacheForCompany(companyId: string, taxCountry: string): void;
+    /**
+     * Parse formula for a single employee
+     * Internal method used by parseByEmpId
+     */
+    private parseForSingleEmployee;
+    /**
+     * Parse formula for multiple employees
+     */
+    parseForMultipleEmployees(formula: string, empIds: string[], auth: AuthContext): Promise<Record<string, FormulaParseResultLegacy>>;
+    /**
+     * Get list of component codes
+     */
+    private getComponentList;
+    /**
+     * Get all components for company
+     */
+    private getAllComponents;
+    /**
+     * Get employee component values
+     */
+    private getEmployeeComponents;
+    /**
+     * OPTIMIZATION: Batch get employee components for multiple employees
+     * This reduces database roundtrips when processing multiple employees
+     */
+    private getBatchEmployeeComponents;
+    /**
+     * Get employee data with relations
+     */
+    private getEmployeeData;
+    /**
+     * OPTIMIZATION: Batch get employee data for multiple employees
+     * This reduces database roundtrips significantly
+     */
+    private getBatchEmployeeData;
+    /**
+     * Get reserved words list for formula processing
+     */
+    private getReservedWords;
+    /**
+     * Extract required words from formula
+     */
+    private extractRequiredWordsFromFormula;
+    /**
+     * Batch load all required data for formula parsing
+     */
+    private batchLoadFormulaData;
+    /**
+     * Convert raw employee data to EmployeeData interface
+     */
+    private convertToEmployeeData;
+    /**
+     * Convert cache to OrganizationalData interface
+     */
+    private convertToOrganizationalData;
+    /**
+     * OPTIMIZATION: Utility to chunk array for batched processing
+     * This prevents memory overflow when processing thousands of items
+     */
+    private chunkArray;
+}
+//# sourceMappingURL=payroll-formula.service.d.ts.map

package/dist/database/payroll-formula.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payroll-formula.service.d.ts","sourceRoot":"","sources":["../../src/database/payroll-formula.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EACL,WAAW,EACX,iBAAiB,EAGjB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAWjB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,qBAAqB;IAEhC,OAAO,CAAC,kBAAkB,CAA2E;IACrG,OAAO,CAAC,kBAAkB,CAA2F;IACrH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IAEjC;;;;;;OAMG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IA0C3H;;;OAGG;IACG,oBAAoB,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA0KtG;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAMjE;;;OAGG;YACW,sBAAsB;IAyLpC;;OAEG;IACG,yBAAyB,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IAYpD;;OAEG;YACW,gBAAgB;IAiC9B;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;YACW,qBAAqB;IAqBnC;;;OAGG;YACW,0BAA0B;IAqCxC;;OAEG;YACW,eAAe;IAkC7B;;;OAGG;YACW,oBAAoB;IA4ClC;;OAEG;YACW,gBAAgB;IAuC9B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAavC;;OAEG;YACW,oBAAoB;IAyHlC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgBnC;;;OAGG;IACH,OAAO,CAAC,UAAU;CAOnB"}