formula-parser-payroll 2.1.0

package/dist/nestjs/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/nestjs/helpers.js.map

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

package/dist/nestjs/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/nestjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nestjs/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/nestjs/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/nestjs/index.js.map

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

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

@@ -0,0 +1,91 @@
+/**
+ * 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 {
+    /**
+     * 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;
+    }>;
+    /**
+     * 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;
+    /**
+     * Get employee data with relations
+     */
+    private getEmployeeData;
+    /**
+     * 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;
+}
+//# sourceMappingURL=payroll-formula.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payroll-formula.service.d.ts","sourceRoot":"","sources":["../../src/nestjs/payroll-formula.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,EACL,WAAW,EACX,iBAAiB,EAGjB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAYjB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,qBAAqB;IAEhC;;;;;;OAMG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IA0B3H;;;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;;;OAGG;YACW,sBAAsB;IAgKpC;;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;IAoB9B;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;YACW,qBAAqB;IAqBnC;;OAEG;YACW,eAAe;IAkC7B;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAavC;;OAEG;YACW,oBAAoB;IAyHlC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACH,OAAO,CAAC,2BAA2B;CAepC"}