@classytic/payroll 2.7.5 → 2.8.0

package/dist/utils/index.js

@@ -1,4 +1,5 @@
 import { Types } from 'mongoose';
+import { MongoServerError } from 'mongodb';
 
 // src/utils/logger.ts
 var createConsoleLogger = () => ({
@@ -166,10 +167,17 @@ function endOfDay(date) {
   result.setHours(23, 59, 59, 999);
   return result;
 }
+function toUTCDateString(date) {
+  const d = new Date(date);
+  d.setHours(0, 0, 0, 0);
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
 function diffInDays(start, end) {
-  return Math.ceil(
-    (new Date(end).getTime() - new Date(start).getTime()) / (1e3 * 60 * 60 * 24)
-  );
+  const s = new Date(start);
+  const e = new Date(end);
+  s.setHours(0, 0, 0, 0);
+  e.setHours(0, 0, 0, 0);
+  return Math.ceil((e.getTime() - s.getTime()) / (1e3 * 60 * 60 * 24));
 }
 function diffInMonths(start, end) {
   const startDate = new Date(start);
@@ -312,6 +320,7 @@ function getShortMonthName(month) {
   return months[month - 1] || "";
 }
 var date_default = {
+  toUTCDateString,
   addDays,
   addMonths,
   addYears,
@@ -473,13 +482,13 @@ function calculateTax(amount, brackets) {
   };
 }
 function calculateOvertime(hourlyRate, overtimeHours, multiplier = 1.5) {
-  return Math.round(hourlyRate * overtimeHours * multiplier);
+  return roundMoney(hourlyRate * overtimeHours * multiplier, 2);
 }
 function calculateHourlyRate(monthlySalary, hoursPerMonth = 176) {
-  return Math.round(monthlySalary / hoursPerMonth);
+  return roundMoney(monthlySalary / hoursPerMonth, 2);
 }
 function calculateDailyRate(monthlySalary, daysPerMonth = 22) {
-  return Math.round(monthlySalary / daysPerMonth);
+  return roundMoney(monthlySalary / daysPerMonth, 2);
 }
 var calculation_default = {
   sum,
@@ -510,7 +519,7 @@ var DEFAULT_WORK_SCHEDULE = {
 function countWorkingDays(startDate, endDate, options = {}) {
   const workDays = options.workingDays || DEFAULT_WORK_SCHEDULE.workingDays;
   const holidaySet = new Set(
-    (options.holidays || []).map((d) => new Date(d).toDateString())
+    (options.holidays || []).map((d) => toUTCDateString(d))
   );
   let totalDays = 0;
   let workingDays = 0;
@@ -522,7 +531,7 @@ function countWorkingDays(startDate, endDate, options = {}) {
   end.setHours(0, 0, 0, 0);
   while (current <= end) {
     totalDays++;
-    const isHoliday = holidaySet.has(current.toDateString());
+    const isHoliday = holidaySet.has(toUTCDateString(current));
     const isWorkDay = workDays.includes(current.getDay());
     if (isHoliday) {
       holidays++;
@@ -569,7 +578,7 @@ function calculateProRating(input) {
   };
 }
 function applyProRating(baseAmount, ratio) {
-  return Math.round(baseAmount * ratio);
+  return roundMoney(baseAmount * ratio, 2);
 }
 
 // src/enums.ts
@@ -1183,7 +1192,7 @@ function calculateLeaveDays(startDate, endDate, options = {}) {
     holidays = [],
     includeEndDate = true
   } = options;
-  const holidaySet = new Set(holidays.map((d) => new Date(d).toDateString()));
+  const holidaySet = new Set(holidays.map((d) => toUTCDateString(d)));
   let count = 0;
   const current = new Date(startDate);
   current.setHours(0, 0, 0, 0);
@@ -1194,7 +1203,7 @@ function calculateLeaveDays(startDate, endDate, options = {}) {
   }
   while (current <= end) {
     const isWorkDay = workingDays.includes(current.getDay());
-    const isHoliday = holidaySet.has(current.toDateString());
+    const isHoliday = holidaySet.has(toUTCDateString(current));
     if (isWorkDay && !isHoliday) {
       count++;
     }
@@ -1265,8 +1274,8 @@ function initializeLeaveBalances(hireDate, config = {}, year = (/* @__PURE__ */
   const fiscalYearEnd = new Date(year + 1, fiscalYearStartMonth - 1, 0);
   let prorationRatio = 1;
   if (proRateNewHires && hireDate > fiscalYearStart) {
-    const totalDays = diffInDays2(fiscalYearStart, fiscalYearEnd);
-    const remainingDays = diffInDays2(hireDate, fiscalYearEnd);
+    const totalDays = diffInDays(fiscalYearStart, fiscalYearEnd);
+    const remainingDays = diffInDays(hireDate, fiscalYearEnd);
     prorationRatio = Math.max(0, Math.min(1, remainingDays / totalDays));
   }
   const balances = [];
@@ -1290,14 +1299,14 @@ function proRateAllocation(fullAllocation, hireDate, fiscalYearStartMonth = 1, y
     return fullAllocation;
   }
   const fiscalYearEnd = new Date(year + 1, fiscalYearStartMonth - 1, 0);
-  const totalDays = diffInDays2(fiscalYearStart, fiscalYearEnd);
-  const remainingDays = Math.max(0, diffInDays2(hireDate, fiscalYearEnd));
+  const totalDays = diffInDays(fiscalYearStart, fiscalYearEnd);
+  const remainingDays = Math.max(0, diffInDays(hireDate, fiscalYearEnd));
   return Math.round(fullAllocation * remainingDays / totalDays);
 }
 function calculateUnpaidLeaveDeduction(baseSalary, unpaidDays, workingDaysInMonth) {
   if (unpaidDays <= 0 || workingDaysInMonth <= 0) return 0;
-  const dailyRate = baseSalary / workingDaysInMonth;
-  return Math.round(dailyRate * unpaidDays);
+  const dailyRate = roundMoney(baseSalary / workingDaysInMonth, 2);
+  return roundMoney(dailyRate * unpaidDays, 2);
 }
 function getUnpaidLeaveDays(leaveRequests, status = "approved") {
   return leaveRequests.filter((r) => r.type === "unpaid" && r.status === status).reduce((sum2, r) => sum2 + r.days, 0);
@@ -1336,13 +1345,6 @@ function accrueLeaveToBalance(balances, type, amount, year = (/* @__PURE__ */ ne
   }
   return balances;
 }
-function diffInDays2(start, end) {
-  const startDate = new Date(start);
-  const endDate = new Date(end);
-  startDate.setHours(0, 0, 0, 0);
-  endDate.setHours(0, 0, 0, 0);
-  return Math.ceil((endDate.getTime() - startDate.getTime()) / (1e3 * 60 * 60 * 24));
-}
 var leave_default = {
   DEFAULT_LEAVE_ALLOCATIONS,
   DEFAULT_CARRY_OVER,
@@ -1416,6 +1418,51 @@ var EmployeeNotFoundError = class extends PayrollError {
     );
   }
 };
+var DuplicatePayrollError = class extends PayrollError {
+  constructor(employeeId, month, year, payrollRunType, context) {
+    const runTypeInfo = payrollRunType ? ` (${payrollRunType})` : "";
+    super(
+      `Payroll already processed for employee ${employeeId} in ${month}/${year}${runTypeInfo}`,
+      "DUPLICATE_PAYROLL",
+      409,
+      { employeeId, month, year, payrollRunType, ...context }
+    );
+  }
+};
+function isPayrollError(error) {
+  return error instanceof PayrollError;
+}
+function extractErrorInfo(error) {
+  if (isPayrollError(error)) {
+    return {
+      code: error.code,
+      status: error.status,
+      message: error.message,
+      context: error.context
+    };
+  }
+  if (error instanceof Error) {
+    return {
+      code: "PAYROLL_ERROR",
+      status: 500,
+      message: error.message
+    };
+  }
+  return {
+    code: "PAYROLL_ERROR",
+    status: 500,
+    message: String(error)
+  };
+}
+function toPayrollError(error) {
+  if (isPayrollError(error)) {
+    return error;
+  }
+  if (error instanceof Error) {
+    return new PayrollError(error.message);
+  }
+  return new PayrollError(String(error));
+}
 
 // src/utils/employee-lookup.ts
 async function findEmployeeSecure(model, options) {
@@ -1623,7 +1670,120 @@ function formatEmployeeId(employeeId) {
   }
   return `employeeId=${employeeId}`;
 }
+function isMongoError(error) {
+  return error instanceof MongoServerError;
+}
+function isDuplicateKeyError(error) {
+  return isMongoError(error) && error.code === 11e3;
+}
+function parseDuplicateKeyError(error) {
+  const message = error.message || "";
+  const match = message.match(/dup key: \{ ([^:]+):/);
+  if (match && match[1]) {
+    return match[1].trim();
+  }
+  const errmsgMatch = message.match(/index: ([^_]+)_/);
+  if (errmsgMatch && errmsgMatch[1]) {
+    return errmsgMatch[1].trim();
+  }
+  return "unknown";
+}
+function isTransactionError(error) {
+  if (!isMongoError(error)) return false;
+  const message = (error.message || "").toLowerCase();
+  return message.includes("transaction") || message.includes("session") || message.includes("replica set") || error.code === 251 || // NoSuchTransaction
+  error.code === 225 || // TransactionTooOld
+  error.code === 244 || // TransactionAborted
+  error.code === 256 || // TransactionCommitted
+  error.code === 257;
+}
+function isTransactionUnsupportedError(error) {
+  if (!isMongoError(error)) return false;
+  const message = (error.message || "").toLowerCase();
+  return message.includes("transaction numbers are only allowed on a replica set member") || message.includes("transactions are only supported on replica sets") || message.includes("mongos") || error.code === 20;
+}
+function isConnectionError(error) {
+  if (!isMongoError(error)) return false;
+  return error.code === 11600 || // InterruptedAtShutdown
+  error.code === 11602 || // InterruptedDueToReplStateChange
+  error.code === 91 || // ShutdownInProgress
+  error.code === 89 || // NetworkTimeout
+  error.code === 6;
+}
+
+// src/utils/error-helpers.ts
+function handleTransactionError(error, operationName) {
+  const isUnsupported = isTransactionUnsupportedError(error);
+  const isTxError = isTransactionError(error);
+  const isConnError = isConnectionError(error);
+  const retryable = isTxError && !isUnsupported;
+  const wrappedError = toPayrollError(error);
+  wrappedError.context.operationName = operationName;
+  wrappedError.context.transactionError = true;
+  if (isUnsupported) {
+    wrappedError.context.reason = "transactions_unsupported";
+  } else if (isConnError) {
+    wrappedError.context.reason = "connection_error";
+  } else if (isTxError) {
+    wrappedError.context.reason = "transaction_conflict";
+  }
+  return {
+    isTransactionError: isTxError || isUnsupported,
+    isUnsupported,
+    retryable,
+    error: wrappedError,
+    originalError: error
+  };
+}
+function handleDuplicateKeyError(error, context) {
+  if (!isDuplicateKeyError(error)) {
+    return {
+      isDuplicate: false,
+      field: "",
+      error: toPayrollError(error)
+    };
+  }
+  const field = parseDuplicateKeyError(error);
+  const wrappedError = context?.employeeId && context?.month && context?.year ? new DuplicatePayrollError(context.employeeId, context.month, context.year, void 0, { duplicateField: field }) : toPayrollError(error);
+  return {
+    isDuplicate: true,
+    field,
+    error: wrappedError
+  };
+}
+function handlePayrollError(error, operationName) {
+  const info = extractErrorInfo(error);
+  const retryable = isConnectionError(error) || isTransactionError(error) && !isTransactionUnsupportedError(error);
+  const operational = error instanceof PayrollError ? error.isOperational() : false;
+  return {
+    code: info.code,
+    status: info.status,
+    message: info.message,
+    context: {
+      ...info.context,
+      operationName
+    },
+    operational,
+    retryable
+  };
+}
+function formatUserError(error) {
+  if (error instanceof PayrollError) {
+    return error.message;
+  }
+  if (isDuplicateKeyError(error)) {
+    const field = parseDuplicateKeyError(error);
+    return `A record with this ${field} already exists`;
+  }
+  if (isTransactionUnsupportedError(error)) {
+    return "Database does not support transactions. Please use a replica set.";
+  }
+  if (isConnectionError(error)) {
+    return "Database connection error. Please try again.";
+  }
+  return "An unexpected error occurred";
+}
 
-export { DEFAULT_CARRY_OVER, DEFAULT_LEAVE_ALLOCATIONS, EmployeeQueryBuilder, PayrollQueryBuilder, QueryBuilder, accrueLeaveToBalance, addDays, addMonths, addYears, applyPercentage, applyProRating, applyTaxBrackets, buildAggregationPipeline, buildEmployeeQuery, buildPayrollQuery, calculateAllowanceAmount, calculateAllowances, calculateCarryOver, calculateCompensationBreakdown, calculateDailyRate, calculateDeductionAmount, calculateDeductions, calculateGross, calculateHourlyRate, calculateLeaveDays, calculateNet, calculateOvertime, calculatePercentage, calculateProRating, calculateProbationEnd, calculateTax, calculateTotalCompensation, calculateUnpaidLeaveDeduction, calculateYearsOfService, calculation_default as calculationUtils, canReceiveSalary, canUpdateEmployment, composeValidators, createChildLogger, createQueryBuilder, createSilentLogger, createValidator, date_default as dateUtils, daysBetween, detectEmployeeIdType, diffInDays, diffInMonths, diffInYears, disableLogging, employee, employeeExistsSecure, enableLogging, endOfDay, endOfMonth, endOfYear, findEmployeeSecure, findEmployeesSecure, formatDateForDB, formatEmployeeId, formatPeriod, getAvailableDays, getCurrentPeriod, getDayName, getDayOfWeek, getDaysInMonth, getLeaveBalance, getLeaveBalances, getLeaveSummary, getLogger, getMonthName, getPayPeriod, getPayPeriodDateRange, getShortMonthName, getUnpaidLeaveDays, getWorkingDaysInMonth, groupStage, hasCompensation, hasCompletedProbation, hasLeaveBalance, hasRequiredFields, inRange, initializeLeaveBalances, isActive, isDateInRange, isEffectiveForPeriod, isEligibleForBonus, isEligibleForPayroll, isEmployed, isInProbation, isInRange, isLoggingEnabled, isObjectIdEmployeeId, isOnLeave, isOnProbation, isPositive, isStringEmployeeId, isSuspended, isTerminated, isValidBankDetails, isValidCompensation, isValidEmploymentType, isValidObjectId, isValidStatus, isWeekday, isWeekend, leave_default as leaveUtils, limitStage, logger, lookupStage, matchStage, max, maxValue, min, minValue, monthsBetween, normalizeEmployeeId, oneOf, parseDBDate, parsePeriod, payroll, percentageOf, proRateAllocation, projectStage, prorateAmount, query_builders_default as queryBuilders, requireOrganizationId, required, resetLogger, resolveOrganizationId, roundMoney, roundMoneyPositive, roundTo, safeToObjectId, setLogger, skipStage, sortStage, startOfDay, startOfMonth, startOfYear, subDays, subMonths, sum, sumAllowances, sumBy, sumDeductions, toObjectId, tryResolveOrganizationId, unwindStage, validateOrganizationId, validation_default as validationUtils };
+export { DEFAULT_CARRY_OVER, DEFAULT_LEAVE_ALLOCATIONS, EmployeeQueryBuilder, PayrollQueryBuilder, QueryBuilder, accrueLeaveToBalance, addDays, addMonths, addYears, applyPercentage, applyProRating, applyTaxBrackets, buildAggregationPipeline, buildEmployeeQuery, buildPayrollQuery, calculateAllowanceAmount, calculateAllowances, calculateCarryOver, calculateCompensationBreakdown, calculateDailyRate, calculateDeductionAmount, calculateDeductions, calculateGross, calculateHourlyRate, calculateLeaveDays, calculateNet, calculateOvertime, calculatePercentage, calculateProRating, calculateProbationEnd, calculateTax, calculateTotalCompensation, calculateUnpaidLeaveDeduction, calculateYearsOfService, calculation_default as calculationUtils, canReceiveSalary, canUpdateEmployment, composeValidators, createChildLogger, createQueryBuilder, createSilentLogger, createValidator, date_default as dateUtils, daysBetween, detectEmployeeIdType, diffInDays, diffInMonths, diffInYears, disableLogging, employee, employeeExistsSecure, enableLogging, endOfDay, endOfMonth, endOfYear, findEmployeeSecure, findEmployeesSecure, formatDateForDB, formatEmployeeId, formatPeriod, formatUserError, getAvailableDays, getCurrentPeriod, getDayName, getDayOfWeek, getDaysInMonth, getLeaveBalance, getLeaveBalances, getLeaveSummary, getLogger, getMonthName, getPayPeriod, getPayPeriodDateRange, getShortMonthName, getUnpaidLeaveDays, getWorkingDaysInMonth, groupStage, handleDuplicateKeyError, handlePayrollError, handleTransactionError, hasCompensation, hasCompletedProbation, hasLeaveBalance, hasRequiredFields, inRange, initializeLeaveBalances, isActive, isDateInRange, isEffectiveForPeriod, isEligibleForBonus, isEligibleForPayroll, isEmployed, isInProbation, isInRange, isLoggingEnabled, isObjectIdEmployeeId, isOnLeave, isOnProbation, isPositive, isStringEmployeeId, isSuspended, isTerminated, isValidBankDetails, isValidCompensation, isValidEmploymentType, isValidObjectId, isValidStatus, isWeekday, isWeekend, leave_default as leaveUtils, limitStage, logger, lookupStage, matchStage, max, maxValue, min, minValue, monthsBetween, normalizeEmployeeId, oneOf, parseDBDate, parsePeriod, payroll, percentageOf, proRateAllocation, projectStage, prorateAmount, query_builders_default as queryBuilders, requireOrganizationId, required, resetLogger, resolveOrganizationId, roundMoney, roundMoneyPositive, roundTo, safeToObjectId, setLogger, skipStage, sortStage, startOfDay, startOfMonth, startOfYear, subDays, subMonths, sum, sumAllowances, sumBy, sumDeductions, toObjectId, tryResolveOrganizationId, unwindStage, validateOrganizationId, validation_default as validationUtils };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map