@classytic/payroll 1.0.0 → 2.8.0

package/src/factories/payroll.factory.js

@@ -1,247 +0,0 @@
-/**
- * Payroll Factory - Beautiful Salary Calculation & Record Creation
- * Clean, testable, immutable payroll object creation
- */
-
-import {
-  calculateGross,
-  calculateNet,
-  createAllowanceCalculator,
-  createDeductionCalculator,
-} from '../utils/calculation.utils.js';
-
-import { getPayPeriod } from '../utils/date.utils.js';
-
-export class PayrollFactory {
-  static create({
-    employeeId,
-    organizationId,
-    baseAmount,
-    allowances = [],
-    deductions = [],
-    period = {},
-    metadata = {},
-  }) {
-    const calculatedAllowances = this.calculateAllowances(baseAmount, allowances);
-    const calculatedDeductions = this.calculateDeductions(baseAmount, deductions);
-
-    const gross = calculateGross(baseAmount, calculatedAllowances);
-    const net = calculateNet(gross, calculatedDeductions);
-
-    return {
-      employeeId,
-      organizationId,
-      period: this.createPeriod(period),
-      breakdown: {
-        baseAmount,
-        allowances: calculatedAllowances,
-        deductions: calculatedDeductions,
-        grossSalary: gross,
-        netSalary: net,
-      },
-      status: 'pending',
-      processedAt: null,
-      paidAt: null,
-      metadata: {
-        currency: metadata.currency || 'BDT',
-        paymentMethod: metadata.paymentMethod,
-        notes: metadata.notes,
-      },
-    };
-  }
-
-  static createPeriod({ month, year } = {}) {
-    const now = new Date();
-    return getPayPeriod(
-      month || now.getMonth() + 1,
-      year || now.getFullYear()
-    );
-  }
-
-  static calculateAllowances(baseAmount, allowances) {
-    return allowances.map((allowance) => {
-      const amount = allowance.isPercentage
-        ? (baseAmount * allowance.value) / 100
-        : allowance.value;
-
-      return {
-        type: allowance.type,
-        name: allowance.name || allowance.type,
-        amount,
-        isPercentage: allowance.isPercentage || false,
-        value: allowance.value,
-      };
-    });
-  }
-
-  static calculateDeductions(baseAmount, deductions) {
-    return deductions.map((deduction) => {
-      const amount = deduction.isPercentage
-        ? (baseAmount * deduction.value) / 100
-        : deduction.value;
-
-      return {
-        type: deduction.type,
-        name: deduction.name || deduction.type,
-        amount,
-        isPercentage: deduction.isPercentage || false,
-        value: deduction.value,
-      };
-    });
-  }
-
-  static createBonus({ type, amount, reason, approvedBy }) {
-    return {
-      type,
-      amount,
-      reason,
-      approvedBy,
-      approvedAt: new Date(),
-    };
-  }
-
-  static createDeduction({ type, amount, reason, appliedBy }) {
-    return {
-      type,
-      amount,
-      reason,
-      appliedBy,
-      appliedAt: new Date(),
-    };
-  }
-
-  static markAsPaid(payroll, { paidAt = new Date(), transactionId, paymentMethod } = {}) {
-    return {
-      ...payroll,
-      status: 'paid',
-      paidAt,
-      processedAt: payroll.processedAt || paidAt,
-      metadata: {
-        ...payroll.metadata,
-        transactionId,
-        paymentMethod: paymentMethod || payroll.metadata.paymentMethod,
-      },
-    };
-  }
-
-  static markAsProcessed(payroll, { processedAt = new Date() } = {}) {
-    return {
-      ...payroll,
-      status: 'processed',
-      processedAt,
-    };
-  }
-}
-
-export class PayrollBuilder {
-  constructor() {
-    this.data = {
-      allowances: [],
-      deductions: [],
-      period: {},
-      metadata: {},
-    };
-  }
-
-  forEmployee(employeeId) {
-    this.data.employeeId = employeeId;
-    return this;
-  }
-
-  inOrganization(organizationId) {
-    this.data.organizationId = organizationId;
-    return this;
-  }
-
-  withBaseAmount(amount) {
-    this.data.baseAmount = amount;
-    return this;
-  }
-
-  forPeriod(month, year) {
-    this.data.period = { month, year };
-    return this;
-  }
-
-  addAllowance(type, value, isPercentage = false, name = null) {
-    this.data.allowances.push({ type, value, isPercentage, name });
-    return this;
-  }
-
-  addDeduction(type, value, isPercentage = false, name = null) {
-    this.data.deductions.push({ type, value, isPercentage, name });
-    return this;
-  }
-
-  addBonus(amount, reason, approvedBy) {
-    this.data.allowances.push({
-      type: 'bonus',
-      value: amount,
-      isPercentage: false,
-      name: reason,
-    });
-    return this;
-  }
-
-  withCurrency(currency) {
-    this.data.metadata.currency = currency;
-    return this;
-  }
-
-  withPaymentMethod(method) {
-    this.data.metadata.paymentMethod = method;
-    return this;
-  }
-
-  withNotes(notes) {
-    this.data.metadata.notes = notes;
-    return this;
-  }
-
-  build() {
-    return PayrollFactory.create(this.data);
-  }
-}
-
-export const createPayroll = () => new PayrollBuilder();
-
-/**
- * Batch Payroll Factory - Process multiple employees
- */
-export class BatchPayrollFactory {
-  static createBatch(employees, { month, year, organizationId }) {
-    return employees.map((employee) =>
-      PayrollFactory.create({
-        employeeId: employee._id || employee.userId,
-        organizationId: organizationId || employee.organizationId,
-        baseAmount: employee.compensation.baseAmount,
-        allowances: employee.compensation.allowances || [],
-        deductions: employee.compensation.deductions || [],
-        period: { month, year },
-      })
-    );
-  }
-
-  static calculateTotalPayroll(payrolls) {
-    return payrolls.reduce(
-      (totals, payroll) => ({
-        count: totals.count + 1,
-        totalGross: totals.totalGross + payroll.breakdown.grossSalary,
-        totalNet: totals.totalNet + payroll.breakdown.netSalary,
-        totalAllowances:
-          totals.totalAllowances +
-          payroll.breakdown.allowances.reduce((sum, a) => sum + a.amount, 0),
-        totalDeductions:
-          totals.totalDeductions +
-          payroll.breakdown.deductions.reduce((sum, d) => sum + d.amount, 0),
-      }),
-      {
-        count: 0,
-        totalGross: 0,
-        totalNet: 0,
-        totalAllowances: 0,
-        totalDeductions: 0,
-      }
-    );
-  }
-}

package/src/hrm.orchestrator.js

@@ -1,139 +0,0 @@
-import * as EmploymentManager from './core/employment.manager.js';
-import * as CompensationManager from './core/compensation.manager.js';
-import * as PayrollManager from './core/payroll.manager.js';
-import logger from './utils/logger.js';
-
-class HRMOrchestrator {
-  constructor() {
-    this._models = null;
-    this._initialized = false;
-  }
-
-  configure({ EmployeeModel, PayrollRecordModel, TransactionModel, AttendanceModel = null }) {
-    if (!EmployeeModel || !PayrollRecordModel || !TransactionModel) {
-      throw new Error('EmployeeModel, PayrollRecordModel, and TransactionModel are required');
-    }
-
-    this._models = { EmployeeModel, PayrollRecordModel, TransactionModel, AttendanceModel };
-    this._initialized = true;
-
-    logger.info('HRM Orchestrator configured', {
-      hasEmployeeModel: !!EmployeeModel,
-      hasPayrollRecordModel: !!PayrollRecordModel,
-      hasTransactionModel: !!TransactionModel,
-      hasAttendanceModel: !!AttendanceModel,
-    });
-  }
-
-  _ensureInitialized() {
-    if (!this._initialized) {
-      throw new Error(
-        'HRM Orchestrator not initialized. ' +
-        'Call initializeHRM({ EmployeeModel, PayrollRecordModel, TransactionModel }) in bootstrap.'
-      );
-    }
-  }
-
-  isInitialized() {
-    return this._initialized;
-  }
-
-  async hire(params) {
-    this._ensureInitialized();
-    return await EmploymentManager.hireEmployee({ ...this._models, ...params });
-  }
-
-  async updateEmployment(params) {
-    this._ensureInitialized();
-    return await EmploymentManager.updateEmployment({ ...this._models, ...params });
-  }
-
-  async terminate(params) {
-    this._ensureInitialized();
-    return await EmploymentManager.terminateEmployee({ ...this._models, ...params });
-  }
-
-  async reHire(params) {
-    this._ensureInitialized();
-    return await EmploymentManager.reHireEmployee({ ...this._models, ...params });
-  }
-
-  async listEmployees(params) {
-    this._ensureInitialized();
-    return await EmploymentManager.getEmployeeList({ ...this._models, ...params });
-  }
-
-  async getEmployee(params) {
-    this._ensureInitialized();
-    return await EmploymentManager.getEmployeeById({ ...this._models, ...params });
-  }
-
-  async updateSalary(params) {
-    this._ensureInitialized();
-    return await CompensationManager.updateSalary({ ...this._models, ...params });
-  }
-
-  async addAllowance(params) {
-    this._ensureInitialized();
-    return await CompensationManager.addAllowance({ ...this._models, ...params });
-  }
-
-  async removeAllowance(params) {
-    this._ensureInitialized();
-    return await CompensationManager.removeAllowance({ ...this._models, ...params });
-  }
-
-  async addDeduction(params) {
-    this._ensureInitialized();
-    return await CompensationManager.addDeduction({ ...this._models, ...params });
-  }
-
-  async removeDeduction(params) {
-    this._ensureInitialized();
-    return await CompensationManager.removeDeduction({ ...this._models, ...params });
-  }
-
-  async updateBankDetails(params) {
-    this._ensureInitialized();
-    return await CompensationManager.updateBankDetails({ ...this._models, ...params });
-  }
-
-  async processSalary(params) {
-    this._ensureInitialized();
-    return await PayrollManager.processSalary({ ...this._models, ...params });
-  }
-
-  async processBulkPayroll(params) {
-    this._ensureInitialized();
-    return await PayrollManager.processBulkPayroll({ ...this._models, ...params });
-  }
-
-  async payrollHistory(params) {
-    this._ensureInitialized();
-    return await PayrollManager.getPayrollHistory({ ...this._models, ...params });
-  }
-
-  async payrollSummary(params) {
-    this._ensureInitialized();
-    return await PayrollManager.getPayrollSummary({ ...this._models, ...params });
-  }
-
-  async exportPayroll(params) {
-    this._ensureInitialized();
-    return await PayrollManager.exportPayrollData({ ...this._models, ...params });
-  }
-
-  getEmployeeModel() {
-    this._ensureInitialized();
-    return this._models.EmployeeModel;
-  }
-
-  getPayrollRecordModel() {
-    this._ensureInitialized();
-    return this._models.PayrollRecordModel;
-  }
-}
-
-export const hrmOrchestrator = new HRMOrchestrator();
-export const hrm = hrmOrchestrator;
-export default hrm;

package/src/index.js

@@ -1,172 +0,0 @@
-export { initializeHRM, isInitialized } from './init.js';
-
-// Logger configuration (for custom logger injection)
-export { setLogger } from './utils/logger.js';
-
-export {
-  EMPLOYMENT_TYPE,
-  EMPLOYMENT_TYPE_VALUES,
-  EMPLOYEE_STATUS,
-  EMPLOYEE_STATUS_VALUES,
-  DEPARTMENT,
-  DEPARTMENT_VALUES,
-  PAYMENT_FREQUENCY,
-  PAYMENT_FREQUENCY_VALUES,
-  PAYMENT_METHOD,
-  PAYMENT_METHOD_VALUES,
-  ALLOWANCE_TYPE,
-  ALLOWANCE_TYPE_VALUES,
-  DEDUCTION_TYPE,
-  DEDUCTION_TYPE_VALUES,
-  PAYROLL_STATUS,
-  PAYROLL_STATUS_VALUES,
-  TERMINATION_REASON,
-  TERMINATION_REASON_VALUES,
-  HRM_TRANSACTION_CATEGORIES,
-  HRM_CATEGORY_VALUES,
-  isHRMManagedCategory,
-} from './enums.js';
-
-export {
-  HRM_CONFIG,
-  SALARY_BANDS,
-  TAX_BRACKETS,
-  ORG_ROLES,
-  ORG_ROLE_KEYS,
-  ROLE_MAPPING,
-  calculateTax,
-  getSalaryBand,
-  determineOrgRole,
-} from './config.js';
-
-export {
-  employmentFields,
-  allowanceSchema,
-  deductionSchema,
-  compensationSchema,
-  workScheduleSchema,
-  bankDetailsSchema,
-  employmentHistorySchema,
-  payrollStatsSchema,
-} from './schemas/employment.schema.js';
-
-export { employeePlugin } from './plugins/employee.plugin.js';
-
-export { default as PayrollRecord } from './models/payroll-record.model.js';
-
-export { hrm, hrmOrchestrator } from './hrm.orchestrator.js';
-
-import { hrm as hrmDefault } from './hrm.orchestrator.js';
-export default hrmDefault;
-
-// ============================================
-// Pure Utilities - Testable, Reusable Functions
-// ============================================
-
-export {
-  addDays,
-  addMonths,
-  diffInDays,
-  diffInMonths,
-  startOfMonth,
-  endOfMonth,
-  startOfYear,
-  endOfYear,
-  isWeekday,
-  isWeekend,
-  getPayPeriod,
-  getCurrentPeriod,
-  calculateProbationEnd,
-  formatDateForDB,
-  parseDBDate,
-} from './utils/date.utils.js';
-
-export {
-  sum,
-  sumBy,
-  sumAllowances,
-  sumDeductions,
-  calculateGross,
-  calculateNet,
-  applyPercentage,
-  calculatePercentage,
-  createAllowanceCalculator,
-  createDeductionCalculator,
-  calculateTotalCompensation,
-  pipe,
-  compose,
-} from './utils/calculation.utils.js';
-
-export {
-  isActive,
-  isOnLeave,
-  isSuspended,
-  isTerminated,
-  isEmployed,
-  canReceiveSalary,
-  hasCompensation,
-  required,
-  minValue,
-  maxValue,
-  isInRange,
-  isPositive,
-  isValidStatus,
-  isValidEmploymentType,
-  compose as composeValidators,
-} from './utils/validation.utils.js';
-
-// ============================================
-// Query Builders - Fluent API for MongoDB
-// ============================================
-
-export {
-  QueryBuilder,
-  EmployeeQueryBuilder,
-  PayrollQueryBuilder,
-  employee,
-  payroll,
-  toObjectId,
-} from './utils/query-builders.js';
-
-// ============================================
-// Factory Methods - Clean Object Creation
-// ============================================
-
-export {
-  EmployeeFactory,
-  EmployeeBuilder,
-  createEmployee,
-} from './factories/employee.factory.js';
-
-export {
-  PayrollFactory,
-  PayrollBuilder,
-  BatchPayrollFactory,
-  createPayroll,
-} from './factories/payroll.factory.js';
-
-export {
-  CompensationFactory,
-  CompensationBuilder,
-  CompensationPresets,
-  createCompensation,
-} from './factories/compensation.factory.js';
-
-// ============================================
-// Service Layer - Clean Abstractions with DI
-// ============================================
-
-export {
-  EmployeeService,
-  createEmployeeService,
-} from './services/employee.service.js';
-
-export {
-  PayrollService,
-  createPayrollService,
-} from './services/payroll.service.js';
-
-export {
-  CompensationService,
-  createCompensationService,
-} from './services/compensation.service.js';

package/src/init.js

@@ -1,41 +0,0 @@
-import { hrm } from './hrm.orchestrator.js';
-import logger, { setLogger } from './utils/logger.js';
-
-let initialized = false;
-
-export function initializeHRM({ EmployeeModel, PayrollRecordModel, TransactionModel, AttendanceModel = null, logger: customLogger }) {
-  // Allow users to inject their own logger
-  if (customLogger) {
-    setLogger(customLogger);
-  }
-
-  if (initialized) {
-    logger.warn('HRM already initialized, skipping');
-    return;
-  }
-
-  if (!EmployeeModel || !PayrollRecordModel || !TransactionModel) {
-    throw new Error(
-      'HRM initialization requires EmployeeModel, PayrollRecordModel, and TransactionModel'
-    );
-  }
-
-  hrm.configure({
-    EmployeeModel,
-    PayrollRecordModel,
-    TransactionModel,
-    AttendanceModel,
-  });
-
-  initialized = true;
-
-  logger.info('HRM library initialized', {
-    hasAttendanceIntegration: !!AttendanceModel,
-  });
-}
-
-export function isInitialized() {
-  return initialized;
-}
-
-export default initializeHRM;