@classytic/payroll 2.0.0 → 2.3.0

package/dist/index.d.ts

@@ -1,21 +1,118 @@
-import payroll from './payroll.js';
-export { Payroll, PayrollBuilder, createPayrollInstance, getPayroll, resetPayroll } from './payroll.js';
-import { n as HRMConfig, D as DeepPartial, s as Department, t as EmploymentType, u as OrgRole, j as PayrollRecordDocument, v as HttpError, w as ErrorCode, x as PaymentFrequency, y as Allowance, z as Deduction, C as Compensation, F as CompensationBreakdownResult } from './types-BSYyX2KJ.js';
-export { A as AddAllowanceParams, c as AddDeductionParams, I as AllowanceType, Q as BankDetails, B as BulkPayrollResult, J as DeductionType, E as EmployeeDocument, G as EmployeeStatus, V as EmploymentHistoryEntry, m as ExportPayrollParams, N as HRMTransactionCategory, H as HireEmployeeParams, L as ListEmployeesParams, o as Logger, O as ObjectIdLike, q as OperationContext, Z as PayrollBreakdown, i as PayrollHistoryParams, P as PayrollInitConfig, r as PayrollInstance, Y as PayrollPeriod, X as PayrollStats, K as PayrollStatus, k as PayrollSummaryParams, l as PayrollSummaryResult, h as ProcessBulkPayrollParams, f as ProcessSalaryParams, g as ProcessSalaryResult, R as ReHireEmployeeParams, b as RemoveAllowanceParams, d as RemoveDeductionParams, S as SingleTenantConfig, T as TerminateEmployeeParams, M as TerminationReason, e as UpdateBankDetailsParams, U as UpdateEmploymentParams, a as UpdateSalaryParams, W as WorkSchedule } from './types-BSYyX2KJ.js';
-export { allowanceSchema, bankDetailsSchema, compensationSchema, deductionSchema, employmentFields, employmentHistorySchema, payrollStatsSchema, workScheduleSchema } from './schemas/index.js';
-import mongoose, { Model, Schema } from 'mongoose';
-import { AttendanceInput } from './core/index.js';
-export { Container, ContainerConfig, Err, ModelsContainer, Ok, Result, err, initializeContainer, isErr, isOk, map, mapErr, ok, unwrap, unwrapOr } from './core/index.js';
-export { E as EventBus, a as PayrollEventMap, P as PayrollPluginDefinition, d as PluginContext, b as PluginManager, c as createEventBus } from './plugin-D9mOr3_d.js';
-export { B as BatchPayrollFactory, C as CompensationService, a as EmployeeBuilder, E as EmployeeFactory, b as EmployeeService, P as PayrollFactory, c as PayrollService } from './index-CTjHlCzz.js';
-export { EmployeeQueryBuilder, PayrollQueryBuilder, QueryBuilder, addDays, addMonths, addYears, applyPercentage, calculateGross, calculateNet, calculateProRating, canReceiveSalary, compose, createValidator, diffInDays, diffInMonths, disableLogging, employee, enableLogging, endOfMonth, endOfYear, formatDateForDB, getCurrentPeriod, getLogger, getPayPeriod, getWorkingDaysInMonth, inRange, isActive, isDateInRange, isEmployed, isLoggingEnabled, isOnProbation, isTerminated, logger, max, min, oneOf, payroll, pipe, required, setLogger, startOfMonth, startOfYear, sum, sumAllowances, sumBy, sumDeductions, toObjectId } from './utils/index.js';
+export { Payroll, PayrollBuilder, createPayrollInstance } from './payroll.js';
+import { O as ObjectIdLike, aM as PayrollBreakdown, aF as LeaveType, aY as LeaveRequestStatus, aR as TaxType, aS as TaxStatus, z as HRMConfig, D as DeepPartial, I as Department, F as EmploymentType, aZ as OrgRole, aJ as LeaveInitConfig, a_ as HttpError, a$ as ErrorCode, aw as AttendanceInput, y as LeaveRequestDocument, v as TaxWithholdingDocument } from './types-BN3K_Uhr.js';
+export { bm as AccrueLeaveOptions, j as AddAllowanceParams, l as AddDeductionParams, N as Allowance, bf as AllowanceType, A as AnyDocument, aP as AnyModel, V as BankDetails, bp as BulkPayrollProgress, B as BulkPayrollResult, X as Compensation, aO as CompensationBreakdownResult, b2 as DataRetentionConfig, Q as Deduction, bg as DeductionType, E as EmployeeDocument, bv as EmployeeHiredEvent, b7 as EmployeeIdMode, h as EmployeeIdentityMode, bo as EmployeeOperationParams, aK as EmployeeStatus, aW as EmployeeValidationResult, b5 as EmploymentConfig, bd as EmploymentHistoryEntry, bx as EventPayload, bu as EventPayloadBase, u as ExportPayrollParams, b1 as FilterQuery, G as GetPendingTaxParams, bi as HRMTransactionCategory, H as HireEmployeeParams, aH as LeaveBalance, bl as LeaveHistoryFilters, aI as LeaveSummaryResult, L as ListEmployeesParams, C as Logger, M as MarkTaxPaidParams, b0 as Nullable, g as OperationContext, aT as PayPeriodInfo, K as PaymentFrequency, aN as PaymentMethod, b3 as PayrollConfig, bc as PayrollCorrection, bz as PayrollEmployee, bt as PayrollEvent, r as PayrollHistoryParams, b as PayrollInitConfig, a as PayrollInstance, aL as PayrollPeriod, bq as PayrollPlugin, P as PayrollRecordDocument, bb as PayrollStats, aX as PayrollStatus, s as PayrollSummaryParams, t as PayrollSummaryResult, br as PluginFunction, bs as PluginType, q as ProcessBulkPayrollParams, o as ProcessSalaryParams, p as ProcessSalaryResult, by as QueryOptions, R as ReHireEmployeeParams, k as RemoveAllowanceParams, m as RemoveDeductionParams, bj as RequestLeaveInput, bn as ResetAnnualLeaveOptions, bk as ReviewLeaveRequestInput, ba as RoleMappingConfig, bh as SalaryBand, b9 as SalaryBandRange, b4 as SalaryConfig, bw as SalaryProcessedEvent, S as SingleTenantConfig, b8 as TaxBracket, aV as TaxCalculationResult, bB as TaxSummaryByType, w as TaxSummaryParams, x as TaxSummaryResult, T as TerminateEmployeeParams, Y as TerminationReason, n as UpdateBankDetailsParams, U as UpdateEmploymentParams, i as UpdateSalaryParams, be as UserReference, b6 as ValidationConfig, W as WebhookConfig, f as WebhookDelivery, ag as WebhookManager, bA as WithPayroll, J as WorkSchedule, aG as WorkingDaysOptions } from './types-BN3K_Uhr.js';
+import { ITransaction, ITransactionCreateInput } from '@classytic/shared-types';
+export { I as IdempotencyManager, a as IdempotentResult, g as generatePayrollIdempotencyKey } from './idempotency-Cw2CWicb.js';
+export { allowanceSchema, applyEmployeeIndexes, applyLeaveRequestIndexes, applyPayrollRecordIndexes, applyTaxWithholdingIndexes, bankDetailsSchema, compensationSchema, createEmployeeSchema, createLeaveRequestSchema, createPayrollRecordSchema, createTaxWithholdingSchema, deductionSchema, employmentFields, employmentHistorySchema, leaveBalanceFields, leaveBalanceSchema, leaveRequestFields, leaveRequestIndexes, payrollStatsSchema, taxWithholdingFields, taxWithholdingIndexes, workScheduleSchema } from './schemas/index.js';
+import mongoose__default, { Schema, Model } from 'mongoose';
+export { C as CreateEmployeeParams, a as EmployeeBuilder, b as EmployeeData, E as EmployeeFactory, T as TerminationData, c as createEmployee } from './employee.factory-BlZqhiCk.js';
+export { C as ContainerLike, a as DEFAULT_CARRY_OVER, D as DEFAULT_LEAVE_ALLOCATIONS, z as EmployeeIdType, A as EmployeeQueryFilter, R as ResolveOrganizationIdParams, S as SecureEmployeeLookupOptions, l as accrueLeaveToBalance, k as calculateCarryOver, c as calculateLeaveDays, f as calculateUnpaidLeaveDeduction, s as detectEmployeeIdType, n as employeeExistsSecure, m as findEmployeeSecure, o as findEmployeesSecure, y as formatEmployeeId, d as getAvailableDays, g as getLeaveBalance, b as getLeaveBalances, e as getLeaveSummary, j as getUnpaidLeaveDays, h as hasLeaveBalance, i as initializeLeaveBalances, x as isObjectIdEmployeeId, w as isStringEmployeeId, u as normalizeEmployeeId, p as proRateAllocation, r as requireOrganizationId, q as resolveOrganizationId, t as tryResolveOrganizationId, v as validateOrganizationId } from './employee-identity-DXhgOgXE.js';
+export { AttendanceDeductionInput, AttendanceDeductionResult, ProRatingInput, ProRatingResult, ProcessedAllowance, ProcessedDeduction, SalaryCalculationInput, applyProRating, calculateAttendanceDeduction, calculateDailyRate, calculateHourlyRate, calculatePartialDayDeduction, calculateProRating, calculateSalaryBreakdown, calculateTotalAttendanceDeduction, shouldProRate } from './calculators/index.js';
+export { AttendancePolicy, AttendancePolicyBuilder, AttendancePolicyDocument, AttendancePolicyModel, AttendancePolicySchema, AttendancePolicySchemaDefinition, CalculateShiftComplianceInput, ClockRoundingPolicy, ClockRoundingPolicyBuilder, ClockRoundingPolicySchema, ClockRoundingPolicySchemaDefinition, DEFAULT_ATTENDANCE_POLICY, EarlyDeparturePenaltyResult, EarlyDeparturePolicy, EarlyDeparturePolicySchema, EarlyDeparturePolicySchemaDefinition, EarlyOccurrence, HEALTHCARE_POLICY, HOSPITALITY_POLICY, LateArrivalPolicy, LateArrivalPolicySchema, LateArrivalPolicySchemaDefinition, LateOccurrence, LatePenaltyResult, LatePolicyBuilder, MANUFACTURING_POLICY, MaxPenaltiesPerPeriod, MaxPenaltiesSchema, MaxPenaltiesSchemaDefinition, NightShiftDifferential, NightShiftDifferentialSchema, NightShiftDifferentialSchemaDefinition, OFFICE_POLICY, OvertimeBonusResult, OvertimeMode, OvertimeOccurrence, OvertimePolicy, OvertimePolicyBuilder, OvertimePolicySchema, OvertimePolicySchemaDefinition, PenaltyMode, PenaltyOverride, PenaltyTier, PenaltyTierSchema, PenaltyTierSchemaDefinition, RETAIL_POLICY, ResetPeriod, RoundingMode, ShiftComplianceData, ShiftComplianceResult, ShiftDifferentialResult, TieredPenaltyBuilder, WeekendPremium, WeekendPremiumSchema, WeekendPremiumSchemaDefinition, calculateDailyOvertime, calculateFlatPenalty, calculateLatePenalty, calculateMonthlyOvertime, calculateNightShiftDifferential, calculateOvertimeBonus, calculatePerMinutePenalty, calculatePercentagePenalty, calculateShiftCompliance, calculateTieredPenalty, calculateWeekendPremium, calculateWeeklyOvertime, createClockRoundingPolicyBuilder, createLatePolicyBuilder, createOvertimePolicyBuilder, createPolicyFromPreset } from './shift-compliance/index.js';
 
 /**
- * @classytic/payroll - Enums
+ * Transaction Interface
+ * @classytic/payroll
+ *
+ * Payroll uses the unified transaction interface from @classytic/shared-types
+ * so revenue and payroll share a single cashflow event model.
+ */
+
+/**
+ * Core transaction interface expected by payroll package
+ * Apps must provide a Transaction model with AT LEAST these fields
+ */
+type IPayrollTransaction = ITransaction;
+/**
+ * Transaction write input (what payroll package creates)
+ */
+type IPayrollTransactionCreateInput = ITransactionCreateInput;
+/**
+ * Type guard to check if object is a Transaction
+ */
+declare function isPayrollTransaction(obj: unknown): obj is IPayrollTransaction;
+
+/**
+ * @classytic/payroll - Transaction Factory
+ *
+ * Pure functions for building transaction objects aligned with @classytic/shared-types.
+ * Ensures consistency with revenue package for unified cashflow.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Input for creating a payroll transaction
+ */
+interface CreatePayrollTransactionInput {
+    organizationId: ObjectIdLike;
+    employee: {
+        _id: ObjectIdLike;
+        userId?: ObjectIdLike | {
+            _id: ObjectIdLike;
+            name?: string;
+        } | null;
+        employeeId: string;
+        email?: string;
+        compensation: {
+            currency: string;
+        };
+    };
+    payrollRecord: {
+        _id: ObjectIdLike;
+    };
+    breakdown: PayrollBreakdown;
+    period: {
+        month: number;
+        year: number;
+    };
+    paymentDate: Date;
+    paymentMethod?: string;
+    processedBy?: ObjectIdLike;
+    idempotencyKey?: string;
+    jurisdiction?: string;
+}
+/**
+ * Input for creating a tax payment transaction
+ */
+interface CreateTaxPaymentTransactionInput {
+    organizationId: ObjectIdLike;
+    totalAmount: number;
+    currency: string;
+    referenceNumber?: string;
+    notes?: string;
+    withholdingIds: ObjectIdLike[];
+}
+/**
+ * Create payroll transaction aligned with @classytic/shared-types
+ *
+ * This is the SINGLE SOURCE OF TRUTH for payroll transaction structure.
+ * Aligns with revenue package for unified cashflow.
  *
- * Type-safe enum definitions with const assertions
- * Single source of truth for all enum values
+ * @param input - Payroll transaction parameters
+ * @returns Transaction data ready for DB creation (ITransactionCreateInput)
+ *
+ * @pure This function has no side effects
  */
+declare function createPayrollTransaction(input: CreatePayrollTransactionInput): ITransactionCreateInput;
+/**
+ * Create tax payment transaction aligned with @classytic/shared-types
+ *
+ * For government tax payments (withholding remittance).
+ *
+ * @param input - Tax payment parameters
+ * @returns Transaction data ready for DB creation (ITransactionCreateInput)
+ *
+ * @pure This function has no side effects
+ */
+declare function createTaxPaymentTransaction(input: CreateTaxPaymentTransactionInput): ITransactionCreateInput;
+/**
+ * Transaction Factory class (for builder pattern if needed)
+ */
+declare class TransactionFactory {
+    static createPayrollTransaction: typeof createPayrollTransaction;
+    static createTaxPaymentTransaction: typeof createTaxPaymentTransaction;
+}
 
 declare const EMPLOYMENT_TYPE: {
     readonly FULL_TIME: "full_time";
@@ -83,13 +180,47 @@ declare const TERMINATION_REASON: {
     readonly MUTUAL_AGREEMENT: "mutual_agreement";
     readonly OTHER: "other";
 };
-declare const HRM_TRANSACTION_CATEGORIES: {
-    readonly SALARY: "salary";
-    readonly BONUS: "bonus";
-    readonly COMMISSION: "commission";
-    readonly OVERTIME: "overtime";
-    readonly SEVERANCE: "severance";
+declare const LEAVE_TYPE: {
+    readonly ANNUAL: "annual";
+    readonly SICK: "sick";
+    readonly UNPAID: "unpaid";
+    readonly MATERNITY: "maternity";
+    readonly PATERNITY: "paternity";
+    readonly BEREAVEMENT: "bereavement";
+    readonly COMPENSATORY: "compensatory";
+    readonly OTHER: "other";
+};
+declare function isValidLeaveType(value: string): value is LeaveType;
+declare function isPaidLeaveType(type: LeaveType): boolean;
+declare const LEAVE_REQUEST_STATUS: {
+    readonly PENDING: "pending";
+    readonly APPROVED: "approved";
+    readonly REJECTED: "rejected";
+    readonly CANCELLED: "cancelled";
 };
+declare function isValidLeaveRequestStatus(value: string): value is LeaveRequestStatus;
+declare function isPendingLeaveStatus(status: LeaveRequestStatus): boolean;
+declare function isApprovedLeaveStatus(status: LeaveRequestStatus): boolean;
+declare const TAX_TYPE: {
+    readonly INCOME_TAX: "income_tax";
+    readonly SOCIAL_SECURITY: "social_security";
+    readonly HEALTH_INSURANCE: "health_insurance";
+    readonly PENSION: "pension";
+    readonly EMPLOYMENT_INSURANCE: "employment_insurance";
+    readonly LOCAL_TAX: "local_tax";
+    readonly OTHER: "other";
+};
+declare const TAX_TYPE_VALUES: ("other" | "income_tax" | "social_security" | "health_insurance" | "pension" | "employment_insurance" | "local_tax")[];
+declare function isValidTaxType(value: string): value is TaxType;
+declare const TAX_STATUS: {
+    readonly PENDING: "pending";
+    readonly SUBMITTED: "submitted";
+    readonly PAID: "paid";
+};
+declare const TAX_STATUS_VALUES: ("pending" | "paid" | "submitted")[];
+declare function isValidTaxStatus(value: string): value is TaxStatus;
+declare function isPendingTaxStatus(status: TaxStatus): boolean;
+declare function isPaidTaxStatus(status: TaxStatus): boolean;
 
 /**
  * @classytic/payroll - Configuration
@@ -99,10 +230,6 @@ declare const HRM_TRANSACTION_CATEGORIES: {
  */
 
 declare const HRM_CONFIG: HRMConfig;
-/**
- * Calculate tax based on annual income
- */
-declare function calculateTax(annualIncome: number, currency?: string): number;
 /**
  * Determine the appropriate organization role for an employee
  */
@@ -116,544 +243,6 @@ declare function determineOrgRole(employmentData: {
  */
 declare function mergeConfig(customConfig: Partial<HRMConfig> | DeepPartial<HRMConfig> | undefined): HRMConfig;
 
-/**
- * @classytic/payroll - PayrollRecord Model
- *
- * Mongoose schema for payroll records with TTL and auto-export
- */
-
-declare const payrollRecordSchema: mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
-    timestamps: true;
-}, {
-    organizationId: mongoose.Types.ObjectId;
-    userId: mongoose.Types.ObjectId;
-    employeeId: mongoose.Types.ObjectId;
-    period: {
-        month: number;
-        year: number;
-        startDate: NativeDate;
-        endDate: NativeDate;
-        payDate?: NativeDate | null | undefined;
-    };
-    status: "pending" | "processing" | "paid" | "failed" | "cancelled";
-    exported: boolean;
-    paymentMethod: "bank" | "cash" | "check" | "mobile" | "bkash" | "nagad" | "rocket";
-    breakdown: {
-        baseAmount: number;
-        allowances: mongoose.Types.DocumentArray<{
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }> & {
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }>;
-        deductions: mongoose.Types.DocumentArray<{
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }> & {
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }>;
-        grossSalary: number;
-        netSalary: number;
-        taxableAmount: number;
-        taxAmount: number;
-        attendanceDeduction: number;
-        proRatedAmount: number;
-        workingDays?: number | null | undefined;
-        actualDays?: number | null | undefined;
-    };
-    metadata: any;
-    corrections: mongoose.Types.DocumentArray<{
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    }> & {
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    }>;
-    notes?: string | null | undefined;
-    processedAt?: NativeDate | null | undefined;
-    processedBy?: mongoose.Types.ObjectId | null | undefined;
-    transactionId?: mongoose.Types.ObjectId | null | undefined;
-    exportedAt?: NativeDate | null | undefined;
-    paidAt?: NativeDate | null | undefined;
-} & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
-    organizationId: mongoose.Types.ObjectId;
-    userId: mongoose.Types.ObjectId;
-    employeeId: mongoose.Types.ObjectId;
-    period: {
-        month: number;
-        year: number;
-        startDate: NativeDate;
-        endDate: NativeDate;
-        payDate?: NativeDate | null | undefined;
-    };
-    status: "pending" | "processing" | "paid" | "failed" | "cancelled";
-    exported: boolean;
-    paymentMethod: "bank" | "cash" | "check" | "mobile" | "bkash" | "nagad" | "rocket";
-    breakdown: {
-        baseAmount: number;
-        allowances: mongoose.Types.DocumentArray<{
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }> & {
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }>;
-        deductions: mongoose.Types.DocumentArray<{
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }> & {
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }>;
-        grossSalary: number;
-        netSalary: number;
-        taxableAmount: number;
-        taxAmount: number;
-        attendanceDeduction: number;
-        proRatedAmount: number;
-        workingDays?: number | null | undefined;
-        actualDays?: number | null | undefined;
-    };
-    metadata: any;
-    corrections: mongoose.Types.DocumentArray<{
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    }> & {
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    }>;
-    notes?: string | null | undefined;
-    processedAt?: NativeDate | null | undefined;
-    processedBy?: mongoose.Types.ObjectId | null | undefined;
-    transactionId?: mongoose.Types.ObjectId | null | undefined;
-    exportedAt?: NativeDate | null | undefined;
-    paidAt?: NativeDate | null | undefined;
-} & mongoose.DefaultTimestampProps, {
-    id: string;
-}, mongoose.ResolveSchemaOptions<{
-    timestamps: true;
-}>> & Omit<{
-    organizationId: mongoose.Types.ObjectId;
-    userId: mongoose.Types.ObjectId;
-    employeeId: mongoose.Types.ObjectId;
-    period: {
-        month: number;
-        year: number;
-        startDate: NativeDate;
-        endDate: NativeDate;
-        payDate?: NativeDate | null | undefined;
-    };
-    status: "pending" | "processing" | "paid" | "failed" | "cancelled";
-    exported: boolean;
-    paymentMethod: "bank" | "cash" | "check" | "mobile" | "bkash" | "nagad" | "rocket";
-    breakdown: {
-        baseAmount: number;
-        allowances: mongoose.Types.DocumentArray<{
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }> & {
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }>;
-        deductions: mongoose.Types.DocumentArray<{
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }> & {
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }>;
-        grossSalary: number;
-        netSalary: number;
-        taxableAmount: number;
-        taxAmount: number;
-        attendanceDeduction: number;
-        proRatedAmount: number;
-        workingDays?: number | null | undefined;
-        actualDays?: number | null | undefined;
-    };
-    metadata: any;
-    corrections: mongoose.Types.DocumentArray<{
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    }> & {
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    }>;
-    notes?: string | null | undefined;
-    processedAt?: NativeDate | null | undefined;
-    processedBy?: mongoose.Types.ObjectId | null | undefined;
-    transactionId?: mongoose.Types.ObjectId | null | undefined;
-    exportedAt?: NativeDate | null | undefined;
-    paidAt?: NativeDate | null | undefined;
-} & mongoose.DefaultTimestampProps & {
-    _id: mongoose.Types.ObjectId;
-} & {
-    __v: number;
-}, "id"> & {
-    id: string;
-}, {
-    [path: string]: mongoose.SchemaDefinitionProperty<undefined, any, any>;
-} | {
-    [x: string]: mongoose.SchemaDefinitionProperty<any, any, mongoose.Document<unknown, {}, {
-        organizationId: mongoose.Types.ObjectId;
-        userId: mongoose.Types.ObjectId;
-        employeeId: mongoose.Types.ObjectId;
-        period: {
-            month: number;
-            year: number;
-            startDate: NativeDate;
-            endDate: NativeDate;
-            payDate?: NativeDate | null | undefined;
-        };
-        status: "pending" | "processing" | "paid" | "failed" | "cancelled";
-        exported: boolean;
-        paymentMethod: "bank" | "cash" | "check" | "mobile" | "bkash" | "nagad" | "rocket";
-        breakdown: {
-            baseAmount: number;
-            allowances: mongoose.Types.DocumentArray<{
-                type: string;
-                amount: number;
-                taxable: boolean;
-            }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-                type: string;
-                amount: number;
-                taxable: boolean;
-            }> & {
-                type: string;
-                amount: number;
-                taxable: boolean;
-            }>;
-            deductions: mongoose.Types.DocumentArray<{
-                type: string;
-                amount: number;
-                description?: string | null | undefined;
-            }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-                type: string;
-                amount: number;
-                description?: string | null | undefined;
-            }> & {
-                type: string;
-                amount: number;
-                description?: string | null | undefined;
-            }>;
-            grossSalary: number;
-            netSalary: number;
-            taxableAmount: number;
-            taxAmount: number;
-            attendanceDeduction: number;
-            proRatedAmount: number;
-            workingDays?: number | null | undefined;
-            actualDays?: number | null | undefined;
-        };
-        metadata: any;
-        corrections: mongoose.Types.DocumentArray<{
-            correctedAt: NativeDate;
-            reason?: string | null | undefined;
-            previousAmount?: number | null | undefined;
-            newAmount?: number | null | undefined;
-            correctedBy?: mongoose.Types.ObjectId | null | undefined;
-        }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-            correctedAt: NativeDate;
-            reason?: string | null | undefined;
-            previousAmount?: number | null | undefined;
-            newAmount?: number | null | undefined;
-            correctedBy?: mongoose.Types.ObjectId | null | undefined;
-        }> & {
-            correctedAt: NativeDate;
-            reason?: string | null | undefined;
-            previousAmount?: number | null | undefined;
-            newAmount?: number | null | undefined;
-            correctedBy?: mongoose.Types.ObjectId | null | undefined;
-        }>;
-        notes?: string | null | undefined;
-        processedAt?: NativeDate | null | undefined;
-        processedBy?: mongoose.Types.ObjectId | null | undefined;
-        transactionId?: mongoose.Types.ObjectId | null | undefined;
-        exportedAt?: NativeDate | null | undefined;
-        paidAt?: NativeDate | null | undefined;
-    } & mongoose.DefaultTimestampProps, {
-        id: string;
-    }, mongoose.ResolveSchemaOptions<{
-        timestamps: true;
-    }>> & Omit<{
-        organizationId: mongoose.Types.ObjectId;
-        userId: mongoose.Types.ObjectId;
-        employeeId: mongoose.Types.ObjectId;
-        period: {
-            month: number;
-            year: number;
-            startDate: NativeDate;
-            endDate: NativeDate;
-            payDate?: NativeDate | null | undefined;
-        };
-        status: "pending" | "processing" | "paid" | "failed" | "cancelled";
-        exported: boolean;
-        paymentMethod: "bank" | "cash" | "check" | "mobile" | "bkash" | "nagad" | "rocket";
-        breakdown: {
-            baseAmount: number;
-            allowances: mongoose.Types.DocumentArray<{
-                type: string;
-                amount: number;
-                taxable: boolean;
-            }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-                type: string;
-                amount: number;
-                taxable: boolean;
-            }> & {
-                type: string;
-                amount: number;
-                taxable: boolean;
-            }>;
-            deductions: mongoose.Types.DocumentArray<{
-                type: string;
-                amount: number;
-                description?: string | null | undefined;
-            }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-                type: string;
-                amount: number;
-                description?: string | null | undefined;
-            }> & {
-                type: string;
-                amount: number;
-                description?: string | null | undefined;
-            }>;
-            grossSalary: number;
-            netSalary: number;
-            taxableAmount: number;
-            taxAmount: number;
-            attendanceDeduction: number;
-            proRatedAmount: number;
-            workingDays?: number | null | undefined;
-            actualDays?: number | null | undefined;
-        };
-        metadata: any;
-        corrections: mongoose.Types.DocumentArray<{
-            correctedAt: NativeDate;
-            reason?: string | null | undefined;
-            previousAmount?: number | null | undefined;
-            newAmount?: number | null | undefined;
-            correctedBy?: mongoose.Types.ObjectId | null | undefined;
-        }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-            correctedAt: NativeDate;
-            reason?: string | null | undefined;
-            previousAmount?: number | null | undefined;
-            newAmount?: number | null | undefined;
-            correctedBy?: mongoose.Types.ObjectId | null | undefined;
-        }> & {
-            correctedAt: NativeDate;
-            reason?: string | null | undefined;
-            previousAmount?: number | null | undefined;
-            newAmount?: number | null | undefined;
-            correctedBy?: mongoose.Types.ObjectId | null | undefined;
-        }>;
-        notes?: string | null | undefined;
-        processedAt?: NativeDate | null | undefined;
-        processedBy?: mongoose.Types.ObjectId | null | undefined;
-        transactionId?: mongoose.Types.ObjectId | null | undefined;
-        exportedAt?: NativeDate | null | undefined;
-        paidAt?: NativeDate | null | undefined;
-    } & mongoose.DefaultTimestampProps & {
-        _id: mongoose.Types.ObjectId;
-    } & {
-        __v: number;
-    }, "id"> & {
-        id: string;
-    }> | undefined;
-}, {
-    organizationId: mongoose.Types.ObjectId;
-    userId: mongoose.Types.ObjectId;
-    employeeId: mongoose.Types.ObjectId;
-    period: {
-        month: number;
-        year: number;
-        startDate: NativeDate;
-        endDate: NativeDate;
-        payDate?: NativeDate | null | undefined;
-    };
-    status: "pending" | "processing" | "paid" | "failed" | "cancelled";
-    exported: boolean;
-    paymentMethod: "bank" | "cash" | "check" | "mobile" | "bkash" | "nagad" | "rocket";
-    breakdown: {
-        baseAmount: number;
-        allowances: mongoose.Types.DocumentArray<{
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }> & {
-            type: string;
-            amount: number;
-            taxable: boolean;
-        }>;
-        deductions: mongoose.Types.DocumentArray<{
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }, mongoose.Types.Subdocument<mongoose.mongo.BSON.ObjectId, unknown, {
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }> & {
-            type: string;
-            amount: number;
-            description?: string | null | undefined;
-        }>;
-        grossSalary: number;
-        netSalary: number;
-        taxableAmount: number;
-        taxAmount: number;
-        attendanceDeduction: number;
-        proRatedAmount: number;
-        workingDays?: number | null | undefined;
-        actualDays?: number | null | undefined;
-    };
-    metadata: any;
-    corrections: mongoose.Types.DocumentArray<{
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    } | {
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: string | null | undefined;
-        _id: string;
-    }, mongoose.Types.Subdocument<string | mongoose.mongo.BSON.ObjectId, unknown, {
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    } | {
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: string | null | undefined;
-        _id: string;
-    }> & ({
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: mongoose.Types.ObjectId | null | undefined;
-    } | {
-        correctedAt: NativeDate;
-        reason?: string | null | undefined;
-        previousAmount?: number | null | undefined;
-        newAmount?: number | null | undefined;
-        correctedBy?: string | null | undefined;
-        _id: string;
-    })>;
-    notes?: string | null | undefined;
-    processedAt?: NativeDate | null | undefined;
-    processedBy?: mongoose.Types.ObjectId | null | undefined;
-    transactionId?: mongoose.Types.ObjectId | null | undefined;
-    exportedAt?: NativeDate | null | undefined;
-    paidAt?: NativeDate | null | undefined;
-    createdAt: NativeDate;
-    updatedAt: NativeDate;
-} & {
-    _id: mongoose.Types.ObjectId;
-} & {
-    __v: number;
-}>;
-interface PayrollRecordModel extends Model<PayrollRecordDocument> {
-    findByPeriod(organizationId: mongoose.Types.ObjectId, month: number, year: number): ReturnType<Model<PayrollRecordDocument>['find']>;
-    findByEmployee(employeeId: mongoose.Types.ObjectId, limit?: number): ReturnType<Model<PayrollRecordDocument>['find']>;
-    getSummary(organizationId: mongoose.Types.ObjectId, month?: number, year?: number): Promise<{
-        totalGross: number;
-        totalNet: number;
-        count: number;
-        paidCount: number;
-    }>;
-    getExpiringSoon(organizationId: mongoose.Types.ObjectId, daysBeforeExpiry?: number): ReturnType<Model<PayrollRecordDocument>['find']>;
-}
-/**
- * Get or create PayrollRecord model
- */
-declare function getPayrollRecordModel(connection?: mongoose.Connection): PayrollRecordModel;
-
 /**
  * @classytic/payroll - Employee Plugin
  *
@@ -669,6 +258,14 @@ interface EmployeePluginOptions {
     statusField?: string;
     /** Enable auto salary calculation on save */
     autoCalculateSalary?: boolean;
+    /** Create indexes on schema (default: false) */
+    createIndexes?: boolean;
+    /** Enable leave management methods (default: false) */
+    enableLeave?: boolean;
+    /** Leave configuration */
+    leaveConfig?: LeaveInitConfig;
+    /** Field name for leave balances (default: 'leaveBalances') */
+    leaveBalancesField?: string;
 }
 /**
  * Mongoose plugin that adds HRM functionality to Employee schema
@@ -692,10 +289,24 @@ declare function employeePlugin(schema: Schema, options?: EmployeePluginOptions)
 declare class PayrollError extends Error implements HttpError {
     readonly code: ErrorCode;
     readonly status: number;
-    readonly context?: Record<string, unknown>;
+    readonly context: Record<string, unknown>;
     readonly timestamp: Date;
-    constructor(message: string, code?: ErrorCode, status?: number, context?: Record<string, unknown>);
+    /**
+     * Create a PayrollError.
+     *
+     * Supports BOTH constructor styles for backwards compatibility:
+     * - new PayrollError(message, code?, status?, context?)
+     * - new PayrollError(code, status, message, context?)
+     */
+    constructor(messageOrCode: string | ErrorCode, codeOrStatus?: ErrorCode | number, statusOrMessage?: number | string, context?: Record<string, unknown>);
+    /**
+     * Convert error to JSON for API responses (ClockIn-compatible shape)
+     */
     toJSON(): Record<string, unknown>;
+    /**
+     * Check if error is operational (expected) vs programmer error
+     */
+    isOperational(): boolean;
 }
 /**
  * Not initialized error
@@ -709,6 +320,12 @@ declare class NotInitializedError extends PayrollError {
 declare class EmployeeNotFoundError extends PayrollError {
     constructor(employeeId?: string, context?: Record<string, unknown>);
 }
+/**
+ * Invalid employee error
+ */
+declare class InvalidEmployeeError extends PayrollError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
 /**
  * Duplicate payroll error
  */
@@ -728,127 +345,45 @@ declare class ValidationError extends PayrollError {
 declare class EmployeeTerminatedError extends PayrollError {
     constructor(employeeId?: string, context?: Record<string, unknown>);
 }
+/**
+ * Already processed error
+ */
+declare class AlreadyProcessedError extends PayrollError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
 /**
  * Not eligible error
  */
 declare class NotEligibleError extends PayrollError {
     constructor(message: string, context?: Record<string, unknown>);
 }
-
 /**
- * @classytic/payroll - Compensation Factory
- *
- * Clean compensation structure creation
- * Presets for common compensation packages
+ * Create error from code
  */
-
-interface CreateCompensationParams {
-    baseAmount: number;
-    frequency?: PaymentFrequency;
-    currency?: string;
-    allowances?: Array<{
-        type: Allowance['type'];
-        value: number;
-        isPercentage?: boolean;
-        name?: string;
-        taxable?: boolean;
-    }>;
-    deductions?: Array<{
-        type: Deduction['type'];
-        value: number;
-        isPercentage?: boolean;
-        name?: string;
-        auto?: boolean;
-    }>;
-    effectiveFrom?: Date;
-}
-declare class CompensationFactory {
-    /**
-     * Create compensation object
-     */
-    static create(params: CreateCompensationParams): Compensation;
-    /**
-     * Create allowance
-     */
-    static createAllowance(params: {
-        type: Allowance['type'];
-        value: number;
-        isPercentage?: boolean;
-        name?: string;
-        taxable?: boolean;
-    }, baseAmount?: number): Allowance;
-    /**
-     * Create deduction
-     */
-    static createDeduction(params: {
-        type: Deduction['type'];
-        value: number;
-        isPercentage?: boolean;
-        name?: string;
-        auto?: boolean;
-    }, baseAmount?: number): Deduction;
-    /**
-     * Update base amount (immutable)
-     */
-    static updateBaseAmount(compensation: Compensation, newAmount: number, effectiveFrom?: Date): Compensation;
-    /**
-     * Add allowance (immutable)
-     */
-    static addAllowance(compensation: Compensation, allowance: Parameters<typeof this.createAllowance>[0]): Compensation;
-    /**
-     * Remove allowance (immutable)
-     */
-    static removeAllowance(compensation: Compensation, allowanceType: Allowance['type']): Compensation;
-    /**
-     * Add deduction (immutable)
-     */
-    static addDeduction(compensation: Compensation, deduction: Parameters<typeof this.createDeduction>[0]): Compensation;
-    /**
-     * Remove deduction (immutable)
-     */
-    static removeDeduction(compensation: Compensation, deductionType: Deduction['type']): Compensation;
-    /**
-     * Calculate compensation breakdown
-     */
-    static calculateBreakdown(compensation: Compensation): CompensationBreakdownResult;
-    /**
-     * Apply salary increment (immutable)
-     */
-    static applyIncrement(compensation: Compensation, params: {
-        percentage?: number;
-        amount?: number;
-        effectiveFrom?: Date;
-    }): Compensation;
-}
-declare class CompensationBuilder {
-    private data;
-    /**
-     * Set base amount
-     */
-    withBase(amount: number, frequency?: PaymentFrequency, currency?: string): this;
-    /**
-     * Add allowance
-     */
-    addAllowance(type: Allowance['type'], value: number, isPercentage?: boolean, name?: string): this;
-    /**
-     * Add deduction
-     */
-    addDeduction(type: Deduction['type'], value: number, isPercentage?: boolean, name?: string): this;
-    /**
-     * Set effective date
-     */
-    effectiveFrom(date: Date): this;
-    /**
-     * Build compensation
-     */
-    build(): Compensation;
-}
+declare function createError(code: ErrorCode, message: string, context?: Record<string, unknown>): PayrollError;
+/**
+ * Check if error is PayrollError
+ */
+declare function isPayrollError(error: unknown): error is PayrollError;
+/**
+ * Extract error info for logging
+ */
+declare function extractErrorInfo(error: unknown): {
+    code: string;
+    status: number;
+    message: string;
+    context?: Record<string, unknown>;
+};
+/**
+ * Convert unknown error to PayrollError
+ */
+declare function toPayrollError(error: unknown): PayrollError;
 
 /**
  * @classytic/payroll - Attendance Integration
  *
  * Native integration with @classytic/clockin.
- * ClockIn is a peer dependency - attendance is core to payroll.
+ * ClockIn is an optional peer dependency for attendance-based deductions.
  */
 
 /**
@@ -869,9 +404,9 @@ declare class CompensationBuilder {
  * await payroll.processSalary({ employeeId, month: 3, year: 2024, attendance });
  * ```
  */
-declare function getAttendance(AttendanceModel: Model<any>, params: {
-    organizationId: any;
-    employeeId: any;
+declare function getAttendance(AttendanceModel: Model<unknown>, params: {
+    organizationId: ObjectIdLike;
+    employeeId: ObjectIdLike;
     month: number;
     year: number;
     expectedDays: number;
@@ -895,9 +430,9 @@ declare function getAttendance(AttendanceModel: Model<any>, params: {
  * const emp1Attendance = attendanceMap.get(emp1._id.toString());
  * ```
  */
-declare function batchGetAttendance(AttendanceModel: Model<any>, params: {
-    organizationId: any;
-    employeeIds: any[];
+declare function batchGetAttendance(AttendanceModel: Model<unknown>, params: {
+    organizationId: ObjectIdLike;
+    employeeIds: ObjectIdLike[];
     month: number;
     year: number;
     expectedDays: number;
@@ -956,12 +491,412 @@ declare function getHolidays(HolidayModel: Model<any>, params: {
 }): Promise<Date[]>;
 
 /**
- * @classytic/payroll
+ * @classytic/payroll - LeaveRequest Model
+ *
+ * Mongoose schema for leave requests with TTL support
+ */
+
+declare const leaveRequestSchema: mongoose__default.Schema<any, mongoose__default.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
+    timestamps: true;
+}, {
+    employeeId: mongoose__default.Types.ObjectId;
+    status: "pending" | "cancelled" | "approved" | "rejected";
+    type: "other" | "annual" | "sick" | "unpaid" | "maternity" | "paternity" | "bereavement" | "compensatory";
+    metadata: any;
+    startDate: NativeDate;
+    endDate: NativeDate;
+    days: number;
+    halfDay: boolean;
+    attachments: string[];
+    reason?: string | null | undefined;
+    userId?: mongoose__default.Types.ObjectId | null | undefined;
+    organizationId?: mongoose__default.Types.ObjectId | null | undefined;
+    reviewedBy?: mongoose__default.Types.ObjectId | null | undefined;
+    reviewedAt?: NativeDate | null | undefined;
+    reviewNotes?: string | null | undefined;
+} & mongoose__default.DefaultTimestampProps, mongoose__default.Document<unknown, {}, {
+    employeeId: mongoose__default.Types.ObjectId;
+    status: "pending" | "cancelled" | "approved" | "rejected";
+    type: "other" | "annual" | "sick" | "unpaid" | "maternity" | "paternity" | "bereavement" | "compensatory";
+    metadata: any;
+    startDate: NativeDate;
+    endDate: NativeDate;
+    days: number;
+    halfDay: boolean;
+    attachments: string[];
+    reason?: string | null | undefined;
+    userId?: mongoose__default.Types.ObjectId | null | undefined;
+    organizationId?: mongoose__default.Types.ObjectId | null | undefined;
+    reviewedBy?: mongoose__default.Types.ObjectId | null | undefined;
+    reviewedAt?: NativeDate | null | undefined;
+    reviewNotes?: string | null | undefined;
+} & mongoose__default.DefaultTimestampProps, {
+    id: string;
+}, mongoose__default.ResolveSchemaOptions<{
+    timestamps: true;
+}>> & Omit<{
+    employeeId: mongoose__default.Types.ObjectId;
+    status: "pending" | "cancelled" | "approved" | "rejected";
+    type: "other" | "annual" | "sick" | "unpaid" | "maternity" | "paternity" | "bereavement" | "compensatory";
+    metadata: any;
+    startDate: NativeDate;
+    endDate: NativeDate;
+    days: number;
+    halfDay: boolean;
+    attachments: string[];
+    reason?: string | null | undefined;
+    userId?: mongoose__default.Types.ObjectId | null | undefined;
+    organizationId?: mongoose__default.Types.ObjectId | null | undefined;
+    reviewedBy?: mongoose__default.Types.ObjectId | null | undefined;
+    reviewedAt?: NativeDate | null | undefined;
+    reviewNotes?: string | null | undefined;
+} & mongoose__default.DefaultTimestampProps & {
+    _id: mongoose__default.Types.ObjectId;
+} & {
+    __v: number;
+}, "id"> & {
+    id: string;
+}, {
+    [path: string]: mongoose__default.SchemaDefinitionProperty<undefined, any, any>;
+} | {
+    [x: string]: mongoose__default.SchemaDefinitionProperty<any, any, mongoose__default.Document<unknown, {}, {
+        employeeId: mongoose__default.Types.ObjectId;
+        status: "pending" | "cancelled" | "approved" | "rejected";
+        type: "other" | "annual" | "sick" | "unpaid" | "maternity" | "paternity" | "bereavement" | "compensatory";
+        metadata: any;
+        startDate: NativeDate;
+        endDate: NativeDate;
+        days: number;
+        halfDay: boolean;
+        attachments: string[];
+        reason?: string | null | undefined;
+        userId?: mongoose__default.Types.ObjectId | null | undefined;
+        organizationId?: mongoose__default.Types.ObjectId | null | undefined;
+        reviewedBy?: mongoose__default.Types.ObjectId | null | undefined;
+        reviewedAt?: NativeDate | null | undefined;
+        reviewNotes?: string | null | undefined;
+    } & mongoose__default.DefaultTimestampProps, {
+        id: string;
+    }, mongoose__default.ResolveSchemaOptions<{
+        timestamps: true;
+    }>> & Omit<{
+        employeeId: mongoose__default.Types.ObjectId;
+        status: "pending" | "cancelled" | "approved" | "rejected";
+        type: "other" | "annual" | "sick" | "unpaid" | "maternity" | "paternity" | "bereavement" | "compensatory";
+        metadata: any;
+        startDate: NativeDate;
+        endDate: NativeDate;
+        days: number;
+        halfDay: boolean;
+        attachments: string[];
+        reason?: string | null | undefined;
+        userId?: mongoose__default.Types.ObjectId | null | undefined;
+        organizationId?: mongoose__default.Types.ObjectId | null | undefined;
+        reviewedBy?: mongoose__default.Types.ObjectId | null | undefined;
+        reviewedAt?: NativeDate | null | undefined;
+        reviewNotes?: string | null | undefined;
+    } & mongoose__default.DefaultTimestampProps & {
+        _id: mongoose__default.Types.ObjectId;
+    } & {
+        __v: number;
+    }, "id"> & {
+        id: string;
+    }> | undefined;
+}, {
+    employeeId: mongoose__default.Types.ObjectId;
+    status: "pending" | "cancelled" | "approved" | "rejected";
+    type: "other" | "annual" | "sick" | "unpaid" | "maternity" | "paternity" | "bereavement" | "compensatory";
+    metadata: any;
+    startDate: NativeDate;
+    endDate: NativeDate;
+    days: number;
+    halfDay: boolean;
+    attachments: string[];
+    reason?: string | null | undefined;
+    userId?: mongoose__default.Types.ObjectId | null | undefined;
+    organizationId?: mongoose__default.Types.ObjectId | null | undefined;
+    reviewedBy?: mongoose__default.Types.ObjectId | null | undefined;
+    reviewedAt?: NativeDate | null | undefined;
+    reviewNotes?: string | null | undefined;
+    createdAt: NativeDate;
+    updatedAt: NativeDate;
+} & {
+    _id: mongoose__default.Types.ObjectId;
+} & {
+    __v: number;
+}>;
+interface LeaveRequestModel extends Model<LeaveRequestDocument> {
+    findByEmployee(employeeId: mongoose__default.Types.ObjectId, options?: {
+        status?: LeaveRequestStatus;
+        year?: number;
+        limit?: number;
+    }): ReturnType<Model<LeaveRequestDocument>['find']>;
+    findPendingByOrganization(organizationId?: mongoose__default.Types.ObjectId): ReturnType<Model<LeaveRequestDocument>['find']>;
+    findByPeriod(organizationId: mongoose__default.Types.ObjectId | undefined, startDate: Date, endDate: Date, options?: {
+        status?: LeaveRequestStatus;
+        type?: LeaveType;
+    }): ReturnType<Model<LeaveRequestDocument>['find']>;
+    getLeaveStats(employeeId: mongoose__default.Types.ObjectId, year: number): Promise<Array<{
+        _id: LeaveType;
+        totalDays: number;
+        count: number;
+    }>>;
+    getOrganizationSummary(organizationId: mongoose__default.Types.ObjectId | undefined, year: number): Promise<Array<{
+        _id: {
+            status: LeaveRequestStatus;
+            type: LeaveType;
+        };
+        totalDays: number;
+        count: number;
+    }>>;
+    findOverlapping(employeeId: mongoose__default.Types.ObjectId, startDate: Date, endDate: Date, excludeRequestId?: mongoose__default.Types.ObjectId): ReturnType<Model<LeaveRequestDocument>['find']>;
+    hasOverlap(employeeId: mongoose__default.Types.ObjectId, startDate: Date, endDate: Date, excludeRequestId?: mongoose__default.Types.ObjectId): Promise<boolean>;
+}
+/**
+ * Get or create LeaveRequest model
  *
- * Enterprise-grade HRM and Payroll Management for MongoDB/Mongoose
- * Clean, pluggable, multi-tenant architecture
+ * @example
+ * const LeaveRequest = getLeaveRequestModel();
  *
- * @packageDocumentation
+ * // With custom connection
+ * const LeaveRequest = getLeaveRequestModel(customConnection);
+ */
+declare function getLeaveRequestModel(connection?: mongoose__default.Connection): LeaveRequestModel;
+
+/**
+ * @classytic/payroll - TaxWithholding Model
+ *
+ * Mongoose schema for tax withholding tracking with aggregation support
+ */
+
+declare const taxWithholdingSchema: mongoose__default.Schema<any, mongoose__default.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
+    timestamps: true;
+}, {
+    employeeId: mongoose__default.Types.ObjectId;
+    amount: number;
+    status: "pending" | "paid" | "submitted";
+    organizationId: mongoose__default.Types.ObjectId;
+    currency: string;
+    payrollRecordId: mongoose__default.Types.ObjectId;
+    metadata: any;
+    transactionId: mongoose__default.Types.ObjectId;
+    taxableAmount: number;
+    taxType: "other" | "income_tax" | "social_security" | "health_insurance" | "pension" | "employment_insurance" | "local_tax";
+    taxRate: number;
+    period?: {
+        month: number;
+        year: number;
+        startDate: NativeDate;
+        endDate: NativeDate;
+        payDate: NativeDate;
+    } | null | undefined;
+    userId?: mongoose__default.Types.ObjectId | null | undefined;
+    referenceNumber?: string | null | undefined;
+    notes?: string | null | undefined;
+    paidAt?: NativeDate | null | undefined;
+    submittedAt?: NativeDate | null | undefined;
+    governmentTransactionId?: mongoose__default.Types.ObjectId | null | undefined;
+} & mongoose__default.DefaultTimestampProps, mongoose__default.Document<unknown, {}, {
+    employeeId: mongoose__default.Types.ObjectId;
+    amount: number;
+    status: "pending" | "paid" | "submitted";
+    organizationId: mongoose__default.Types.ObjectId;
+    currency: string;
+    payrollRecordId: mongoose__default.Types.ObjectId;
+    metadata: any;
+    transactionId: mongoose__default.Types.ObjectId;
+    taxableAmount: number;
+    taxType: "other" | "income_tax" | "social_security" | "health_insurance" | "pension" | "employment_insurance" | "local_tax";
+    taxRate: number;
+    period?: {
+        month: number;
+        year: number;
+        startDate: NativeDate;
+        endDate: NativeDate;
+        payDate: NativeDate;
+    } | null | undefined;
+    userId?: mongoose__default.Types.ObjectId | null | undefined;
+    referenceNumber?: string | null | undefined;
+    notes?: string | null | undefined;
+    paidAt?: NativeDate | null | undefined;
+    submittedAt?: NativeDate | null | undefined;
+    governmentTransactionId?: mongoose__default.Types.ObjectId | null | undefined;
+} & mongoose__default.DefaultTimestampProps, {
+    id: string;
+}, mongoose__default.ResolveSchemaOptions<{
+    timestamps: true;
+}>> & Omit<{
+    employeeId: mongoose__default.Types.ObjectId;
+    amount: number;
+    status: "pending" | "paid" | "submitted";
+    organizationId: mongoose__default.Types.ObjectId;
+    currency: string;
+    payrollRecordId: mongoose__default.Types.ObjectId;
+    metadata: any;
+    transactionId: mongoose__default.Types.ObjectId;
+    taxableAmount: number;
+    taxType: "other" | "income_tax" | "social_security" | "health_insurance" | "pension" | "employment_insurance" | "local_tax";
+    taxRate: number;
+    period?: {
+        month: number;
+        year: number;
+        startDate: NativeDate;
+        endDate: NativeDate;
+        payDate: NativeDate;
+    } | null | undefined;
+    userId?: mongoose__default.Types.ObjectId | null | undefined;
+    referenceNumber?: string | null | undefined;
+    notes?: string | null | undefined;
+    paidAt?: NativeDate | null | undefined;
+    submittedAt?: NativeDate | null | undefined;
+    governmentTransactionId?: mongoose__default.Types.ObjectId | null | undefined;
+} & mongoose__default.DefaultTimestampProps & {
+    _id: mongoose__default.Types.ObjectId;
+} & {
+    __v: number;
+}, "id"> & {
+    id: string;
+}, {
+    [path: string]: mongoose__default.SchemaDefinitionProperty<undefined, any, any>;
+} | {
+    [x: string]: mongoose__default.SchemaDefinitionProperty<any, any, mongoose__default.Document<unknown, {}, {
+        employeeId: mongoose__default.Types.ObjectId;
+        amount: number;
+        status: "pending" | "paid" | "submitted";
+        organizationId: mongoose__default.Types.ObjectId;
+        currency: string;
+        payrollRecordId: mongoose__default.Types.ObjectId;
+        metadata: any;
+        transactionId: mongoose__default.Types.ObjectId;
+        taxableAmount: number;
+        taxType: "other" | "income_tax" | "social_security" | "health_insurance" | "pension" | "employment_insurance" | "local_tax";
+        taxRate: number;
+        period?: {
+            month: number;
+            year: number;
+            startDate: NativeDate;
+            endDate: NativeDate;
+            payDate: NativeDate;
+        } | null | undefined;
+        userId?: mongoose__default.Types.ObjectId | null | undefined;
+        referenceNumber?: string | null | undefined;
+        notes?: string | null | undefined;
+        paidAt?: NativeDate | null | undefined;
+        submittedAt?: NativeDate | null | undefined;
+        governmentTransactionId?: mongoose__default.Types.ObjectId | null | undefined;
+    } & mongoose__default.DefaultTimestampProps, {
+        id: string;
+    }, mongoose__default.ResolveSchemaOptions<{
+        timestamps: true;
+    }>> & Omit<{
+        employeeId: mongoose__default.Types.ObjectId;
+        amount: number;
+        status: "pending" | "paid" | "submitted";
+        organizationId: mongoose__default.Types.ObjectId;
+        currency: string;
+        payrollRecordId: mongoose__default.Types.ObjectId;
+        metadata: any;
+        transactionId: mongoose__default.Types.ObjectId;
+        taxableAmount: number;
+        taxType: "other" | "income_tax" | "social_security" | "health_insurance" | "pension" | "employment_insurance" | "local_tax";
+        taxRate: number;
+        period?: {
+            month: number;
+            year: number;
+            startDate: NativeDate;
+            endDate: NativeDate;
+            payDate: NativeDate;
+        } | null | undefined;
+        userId?: mongoose__default.Types.ObjectId | null | undefined;
+        referenceNumber?: string | null | undefined;
+        notes?: string | null | undefined;
+        paidAt?: NativeDate | null | undefined;
+        submittedAt?: NativeDate | null | undefined;
+        governmentTransactionId?: mongoose__default.Types.ObjectId | null | undefined;
+    } & mongoose__default.DefaultTimestampProps & {
+        _id: mongoose__default.Types.ObjectId;
+    } & {
+        __v: number;
+    }, "id"> & {
+        id: string;
+    }> | undefined;
+}, {
+    employeeId: mongoose__default.Types.ObjectId;
+    amount: number;
+    status: "pending" | "paid" | "submitted";
+    organizationId: mongoose__default.Types.ObjectId;
+    currency: string;
+    payrollRecordId: mongoose__default.Types.ObjectId;
+    metadata: any;
+    transactionId: mongoose__default.Types.ObjectId;
+    taxableAmount: number;
+    taxType: "other" | "income_tax" | "social_security" | "health_insurance" | "pension" | "employment_insurance" | "local_tax";
+    taxRate: number;
+    period?: {
+        month: number;
+        year: number;
+        startDate: NativeDate;
+        endDate: NativeDate;
+        payDate: NativeDate;
+    } | null | undefined;
+    userId?: mongoose__default.Types.ObjectId | null | undefined;
+    referenceNumber?: string | null | undefined;
+    notes?: string | null | undefined;
+    paidAt?: NativeDate | null | undefined;
+    submittedAt?: NativeDate | null | undefined;
+    governmentTransactionId?: mongoose__default.Types.ObjectId | null | undefined;
+    createdAt: NativeDate;
+    updatedAt: NativeDate;
+} & {
+    _id: mongoose__default.Types.ObjectId;
+} & {
+    __v: number;
+}>;
+interface TaxWithholdingModel extends Model<TaxWithholdingDocument> {
+    findByPeriod(organizationId: mongoose__default.Types.ObjectId, month: number, year: number): ReturnType<Model<TaxWithholdingDocument>['find']>;
+    findByEmployee(employeeId: mongoose__default.Types.ObjectId, options?: {
+        year?: number;
+        taxType?: TaxType;
+        status?: TaxStatus;
+        limit?: number;
+    }): ReturnType<Model<TaxWithholdingDocument>['find']>;
+    findPending(organizationId: mongoose__default.Types.ObjectId, options?: {
+        fromMonth?: number;
+        fromYear?: number;
+        toMonth?: number;
+        toYear?: number;
+        taxType?: TaxType;
+    }): ReturnType<Model<TaxWithholdingDocument>['find']>;
+    getSummaryByType(organizationId: mongoose__default.Types.ObjectId, fromPeriod: {
+        month: number;
+        year: number;
+    }, toPeriod: {
+        month: number;
+        year: number;
+    }): Promise<Array<{
+        taxType: TaxType;
+        totalAmount: number;
+        count: number;
+        withholdingIds: mongoose__default.Types.ObjectId[];
+    }>>;
+    getByPayrollRecord(payrollRecordId: mongoose__default.Types.ObjectId): ReturnType<Model<TaxWithholdingDocument>['find']>;
+    getTotalByOrganization(organizationId: mongoose__default.Types.ObjectId, options?: {
+        status?: TaxStatus;
+        year?: number;
+    }): Promise<{
+        totalAmount: number;
+        count: number;
+    }>;
+}
+/**
+ * Get or create TaxWithholding model
+ *
+ * @example
+ * const TaxWithholding = getTaxWithholdingModel();
+ *
+ * // With custom connection
+ * const TaxWithholding = getTaxWithholdingModel(customConnection);
  */
+declare function getTaxWithholdingModel(connection?: mongoose__default.Connection): TaxWithholdingModel;
 
-export { ALLOWANCE_TYPE, Allowance, Compensation, CompensationBuilder, CompensationFactory, DEDUCTION_TYPE, DEPARTMENT, Deduction, DeepPartial, Department, DuplicatePayrollError, EMPLOYEE_STATUS, EMPLOYMENT_TYPE, EmployeeNotFoundError, type EmployeePluginOptions, EmployeeTerminatedError, EmploymentType, HRMConfig, HRM_CONFIG, HRM_TRANSACTION_CATEGORIES, type Holiday, NotEligibleError, NotInitializedError, PAYMENT_FREQUENCY, PAYROLL_STATUS, PaymentFrequency, PayrollError, PayrollRecordDocument, type PayrollRecordModel, TERMINATION_REASON, ValidationError, batchGetAttendance, calculateTax, createHolidaySchema, payroll as default, determineOrgRole, employeePlugin, getAttendance, getHolidays, getPayrollRecordModel, mergeConfig, payroll as payrollInstance, payrollRecordSchema };
+export { ALLOWANCE_TYPE, AlreadyProcessedError, type CreatePayrollTransactionInput, type CreateTaxPaymentTransactionInput, DEDUCTION_TYPE, DEPARTMENT, DeepPartial, Department, DuplicatePayrollError, EMPLOYEE_STATUS, EMPLOYMENT_TYPE, EmployeeNotFoundError, type EmployeePluginOptions, EmployeeTerminatedError, EmploymentType, ErrorCode, HRMConfig, HRM_CONFIG, type Holiday, HttpError, type IPayrollTransaction, type IPayrollTransactionCreateInput, InvalidEmployeeError, LEAVE_REQUEST_STATUS, LEAVE_TYPE, LeaveInitConfig, LeaveRequestDocument, type LeaveRequestModel, LeaveRequestStatus, LeaveType, NotEligibleError, NotInitializedError, ObjectIdLike, OrgRole, PAYMENT_FREQUENCY, PAYROLL_STATUS, PayrollBreakdown, PayrollError, TAX_STATUS, TAX_STATUS_VALUES, TAX_TYPE, TAX_TYPE_VALUES, TERMINATION_REASON, TaxStatus, TaxType, TaxWithholdingDocument, type TaxWithholdingModel, TransactionFactory, ValidationError, batchGetAttendance, createError, createHolidaySchema, createPayrollTransaction, createTaxPaymentTransaction, determineOrgRole, employeePlugin, extractErrorInfo, getAttendance, getHolidays, getLeaveRequestModel, getTaxWithholdingModel, isApprovedLeaveStatus, isPaidLeaveType, isPaidTaxStatus, isPayrollError, isPayrollTransaction, isPendingLeaveStatus, isPendingTaxStatus, isValidLeaveRequestStatus, isValidLeaveType, isValidTaxStatus, isValidTaxType, leaveRequestSchema, mergeConfig, taxWithholdingSchema, toPayrollError };