@classytic/payroll 2.7.5 → 2.8.0

package/dist/{types-BVDjiVGS.d.ts → types-bZdAJueH.d.ts}

@@ -98,7 +98,8 @@ interface PayrollCompletedEventPayload {
 }
 interface PayrollExportedEventPayload {
     organizationId: ObjectId;
-    dateRange: {
+    exportId?: string;
+    dateRange?: {
         start: Date;
         end: Date;
     };
@@ -233,6 +234,34 @@ declare class EventBus {
      */
     eventNames(): PayrollEventType[];
 }
+/**
+ * Get or create the default event bus
+ */
+declare function getEventBus(): EventBus;
+/**
+ * Create a new event bus instance
+ */
+declare function createEventBus(): EventBus;
+/**
+ * Reset the default event bus (for testing)
+ */
+declare function resetEventBus(): void;
+/**
+ * Subscribe to employee hired events
+ */
+declare function onEmployeeHired(handler: PayrollEventHandler<'employee:hired'>): () => void;
+/**
+ * Subscribe to salary processed events
+ */
+declare function onSalaryProcessed(handler: PayrollEventHandler<'salary:processed'>): () => void;
+/**
+ * Subscribe to payroll completed events
+ */
+declare function onPayrollCompleted(handler: PayrollEventHandler<'payroll:completed'>): () => void;
+/**
+ * Subscribe to milestone achieved events
+ */
+declare function onMilestoneAchieved(handler: PayrollEventHandler<'milestone:achieved'>): () => void;
 
 /**
  * Webhook System
@@ -247,6 +276,19 @@ interface WebhookConfig {
     retries?: number;
     timeout?: number;
 }
+interface WebhookManagerOptions {
+    /**
+     * Maximum number of delivery log entries to retain (default: 1000).
+     * Oldest entries are pruned when the limit is exceeded.
+     */
+    maxLogSize?: number;
+    /**
+     * Whether to store full payloads in the delivery log (default: false).
+     * When false, only metadata (event, url, status, error, sentAt) is stored,
+     * preventing PII from accumulating in memory.
+     */
+    storePayloads?: boolean;
+}
 interface WebhookDelivery {
     id: string;
     event: PayrollEventType;
@@ -264,6 +306,9 @@ interface WebhookDelivery {
 declare class WebhookManager {
     private webhooks;
     private deliveryLog;
+    private readonly maxLogSize;
+    private readonly storePayloads;
+    constructor(options?: WebhookManagerOptions);
     /**
      * Register a webhook
      */
@@ -322,6 +367,11 @@ declare class WebhookManager {
      * ```
      */
     private generateSignature;
+    /**
+     * Prune delivery log to stay within maxLogSize.
+     * Removes oldest entries first.
+     */
+    private pruneLog;
     /**
      * Sleep for ms
      */
@@ -376,6 +426,33 @@ interface PayrollProcessingOptions {
     /** Skip attendance deduction */
     skipAttendance?: boolean;
 }
+/** Working days calculation result */
+interface WorkingDaysResult {
+    /** Total calendar days in period */
+    totalDays: number;
+    /** Working days (excluding weekends and holidays) */
+    workingDays: number;
+    /** Weekend days */
+    weekends: number;
+    /** Holiday count */
+    holidays: number;
+}
+/** Proration calculation result */
+interface ProrationResult {
+    /** Proration ratio (0-1) */
+    ratio: number;
+    /**
+     * Reason for proration:
+     * - 'full': Employee worked the entire period (ratio = 1)
+     * - 'new_hire': Employee was hired during the period
+     * - 'termination': Employee was terminated during the period
+     * - 'both': Both hired and terminated within the period
+     * - 'not_active': Employee was not active at all during the period (ratio = 0)
+     */
+    reason: 'full' | 'new_hire' | 'termination' | 'both' | 'not_active';
+    /** Whether salary should be prorated */
+    isProrated: boolean;
+}
 /** Attendance data (from YOUR attendance system) */
 interface AttendanceInput {
     /**
@@ -386,6 +463,44 @@ interface AttendanceInput {
     /** Actual days worked */
     actualDays: number;
 }
+declare const DEFAULT_WORK_SCHEDULE: WorkSchedule$1;
+/**
+ * Count working days in a date range
+ *
+ * @example
+ * const result = countWorkingDays(
+ *   new Date('2024-03-01'),
+ *   new Date('2024-03-31'),
+ *   { workingDays: [1,2,3,4,5], holidays: companyHolidays }
+ * );
+ */
+declare function countWorkingDays(startDate: Date, endDate: Date, options?: {
+    workingDays?: number[];
+    holidays?: Date[];
+}): WorkingDaysResult;
+/**
+ * Calculate proration ratio for partial months
+ *
+ * @example
+ * const proration = calculateProration(
+ *   employee.hireDate,
+ *   employee.terminationDate,
+ *   periodStart,
+ *   periodEnd
+ * );
+ */
+declare function calculateProration(hireDate: Date, terminationDate: Date | null | undefined, periodStart: Date, periodEnd: Date): ProrationResult;
+/**
+ * Get pay period dates for a given month
+ *
+ * @example
+ * const period = getPayPeriod(3, 2024); // March 2024
+ */
+declare function getPayPeriod(month: number, year: number, payDay?: number): {
+    startDate: Date;
+    endDate: Date;
+    payDate: Date;
+};
 
 /**
  * @classytic/payroll - Plugin System
@@ -435,6 +550,77 @@ interface PayrollPluginDefinition {
     init?: (context: PluginContext) => void | Promise<void>;
     destroy?: () => void | Promise<void>;
 }
+declare class PluginManager {
+    private context;
+    private plugins;
+    private hooks;
+    constructor(context: PluginContext);
+    /**
+     * Register a plugin
+     */
+    register(plugin: PayrollPluginDefinition): Promise<void>;
+    /**
+     * Unregister a plugin
+     */
+    unregister(name: string): Promise<void>;
+    /**
+     * Add a hook handler
+     */
+    private addHook;
+    /**
+     * Execute hooks for a given event
+     */
+    executeHooks<K extends keyof PluginHooks>(hookName: K, ...args: Parameters<NonNullable<PluginHooks[K]>>): Promise<void>;
+    /**
+     * Get registered plugin names
+     */
+    getPluginNames(): string[];
+    /**
+     * Check if plugin is registered
+     */
+    hasPlugin(name: string): boolean;
+}
+/**
+ * Define a plugin with type safety
+ */
+declare function definePlugin(definition: PayrollPluginDefinition): PayrollPluginDefinition;
+/**
+ * Logging plugin - logs all payroll events
+ */
+declare const loggingPlugin: PayrollPluginDefinition;
+/**
+ * Metrics plugin - collects payroll metrics
+ */
+declare const metricsPlugin: PayrollPluginDefinition;
+/**
+ * Notification plugin - sends notifications for events
+ */
+interface NotificationPluginOptions {
+    onHired?: (employee: {
+        id: unknown;
+        name?: string;
+    }) => void | Promise<void>;
+    onTerminated?: (employee: {
+        id: unknown;
+        name?: string;
+    }) => void | Promise<void>;
+    onSalaryProcessed?: (details: {
+        employee: {
+            id: unknown;
+            name?: string;
+        };
+        amount: number;
+    }) => void | Promise<void>;
+    onMilestone?: (details: {
+        employee: {
+            id: unknown;
+            name?: string;
+        };
+        milestone: string;
+    }) => void | Promise<void>;
+}
+declare function createNotificationPlugin(options: NotificationPluginOptions): PayrollPluginDefinition;
+declare const notificationPlugin: PayrollPluginDefinition;
 
 /** Query filter type */
 type FilterQuery<T> = {
@@ -549,7 +735,12 @@ interface ValidationConfig {
     /** Fallback modes if primary lookup fails */
     identityFallbacks: EmployeeIdentityMode[];
 }
-/** Tax bracket definition */
+/**
+ * Tax bracket definition.
+ *
+ * Tax brackets should be managed by your application and passed at calculation time.
+ * Use `effectiveFrom`/`effectiveTo` to version brackets when tax rates change.
+ */
 interface TaxBracket {
     /** Minimum income for bracket */
     min: number;
@@ -557,6 +748,128 @@ interface TaxBracket {
     max: number;
     /** Tax rate (0-1) */
     rate: number;
+    /** Start date from which this bracket applies (inclusive) */
+    effectiveFrom?: Date;
+    /** End date until which this bracket applies (inclusive, null = still active) */
+    effectiveTo?: Date | null;
+}
+/**
+ * Pre-tax deduction input for tax calculation
+ *
+ * Deductions that reduce taxable income before tax brackets are applied.
+ * Common examples: pension, provident fund, 401k, health savings.
+ */
+interface PreTaxDeductionInput {
+    /** Deduction type identifier */
+    type: string;
+    /** Deduction amount */
+    amount: number;
+}
+/**
+ * Tax credit/rebate input
+ *
+ * Credits that reduce tax liability after tax calculation.
+ * Different from deductions which reduce taxable income.
+ */
+interface TaxCreditInput {
+    /** Credit type identifier (e.g., 'investment', 'charitable', 'education') */
+    type: string;
+    /** Credit amount */
+    amount: number;
+    /** Maximum as percentage of tax liability (0-1). If set, credit is capped. */
+    maxPercent?: number;
+}
+/**
+ * Enhanced tax calculation options
+ *
+ * Provides jurisdiction-aware tax calculation with support for:
+ * - Standard deduction / tax-free threshold
+ * - Demographic-based thresholds (senior, disabled, etc.)
+ * - Pre-tax deductions (pension, 401k)
+ * - Tax credits/rebates
+ *
+ * @example
+ * ```typescript
+ * const taxOptions: TaxCalculationOptions = {
+ *   applyStandardDeduction: true,
+ *   taxpayerCategory: 'senior',
+ *   preTaxDeductions: [
+ *     { type: 'provident_fund', amount: 5000 },
+ *     { type: 'pension', amount: 3000 },
+ *   ],
+ *   taxCredits: [
+ *     { type: 'investment', amount: 2000, maxPercent: 0.15 },
+ *   ],
+ * };
+ * ```
+ */
+interface TaxCalculationOptions {
+    /**
+     * Apply standard deduction from jurisdiction config
+     *
+     * When true, subtracts TaxConfiguration.standardDeduction from
+     * taxable income before applying tax brackets.
+     *
+     * @default false
+     */
+    applyStandardDeduction?: boolean;
+    /**
+     * Taxpayer category for threshold lookup
+     *
+     * Used to look up the appropriate tax-free threshold from
+     * TaxConfiguration.thresholdsByCategory. If not found,
+     * falls back to standardDeduction.
+     *
+     * Common categories: 'standard', 'senior', 'disabled', 'veteran', 'female'
+     *
+     * @example 'senior' - for taxpayers 65+
+     */
+    taxpayerCategory?: string;
+    /**
+     * Override thresholds by category
+     *
+     * Allows runtime override of jurisdiction thresholds.
+     * Useful for custom/organization-specific rules.
+     *
+     * @example { senior: 500000, disabled: 550000 }
+     */
+    thresholdOverrides?: Record<string, number>;
+    /**
+     * Pre-tax deductions (reduce taxable income)
+     *
+     * These deductions are subtracted from gross income before
+     * tax brackets are applied. Common examples:
+     * - Pension/401k contributions
+     * - Health savings account (HSA)
+     * - Provident fund
+     *
+     * Note: Employee's compensation.deductions with reducesTaxableIncome=true
+     * are automatically included. Use this for additional one-time deductions.
+     */
+    preTaxDeductions?: PreTaxDeductionInput[];
+    /**
+     * Tax credits/rebates (reduce tax liability)
+     *
+     * Applied after tax calculation. Different from deductions:
+     * - Deduction: reduces taxable income
+     * - Credit: reduces calculated tax amount
+     *
+     * @example
+     * ```typescript
+     * taxCredits: [
+     *   { type: 'investment', amount: 15000, maxPercent: 0.15 }, // Max 15% of tax
+     *   { type: 'charitable', amount: 5000 }, // Full credit
+     * ]
+     * ```
+     */
+    taxCredits?: TaxCreditInput[];
+    /**
+     * Standard deduction amount (annual)
+     *
+     * Direct override for standard deduction. Takes precedence over
+     * jurisdiction config when provided.
+     */
+    standardDeductionOverride?: number;
 }
 /** Salary band range */
 interface SalaryBandRange {
@@ -657,6 +970,25 @@ interface Deduction {
     effectiveFrom?: Date;
     effectiveTo?: Date | null;
     description?: string;
+    /**
+     * Whether this deduction reduces taxable income (pre-tax deduction)
+     *
+     * When true, this deduction is subtracted from gross income before
+     * tax calculation. Common examples: pension contributions, 401k,
+     * provident fund, health savings account (HSA).
+     *
+     * @default false (post-tax deduction)
+     *
+     * @example
+     * ```typescript
+     * // Provident fund contribution reduces taxable income
+     * { type: 'provident_fund', amount: 5000, reducesTaxableIncome: true }
+     *
+     * // Loan repayment does NOT reduce taxable income
+     * { type: 'loan', amount: 2000, reducesTaxableIncome: false }
+     * ```
+     */
+    reducesTaxableIncome?: boolean;
 }
 /** Compensation structure */
 interface Compensation {
@@ -816,6 +1148,11 @@ interface PayrollRecordDocument extends Document {
      * Default: 'regular'
      */
     payrollRunType?: PayrollRunType;
+    /**
+     * Payment frequency at time of processing (v2.9.0+)
+     * Stored for proper idempotency key reconstruction in void/reverse operations
+     */
+    paymentFrequency?: PaymentFrequency;
     /**
      * Retroactive adjustment details (for back-pay or corrections)
      * Only populated when payrollRunType is 'retroactive'
@@ -859,6 +1196,14 @@ interface PayrollRecordDocument extends Document {
      * expireAt: undefined
      */
     expireAt?: Date | null;
+    addCorrection(previousAmount: number, newAmount: number, reason: string, correctedBy: ObjectId): void;
+    markAsPaid(transactionId: ObjectId, paidAt?: Date): void;
+    getBreakdownSummary(): {
+        gross: number;
+        net: number;
+        tax: number;
+        deductions: number;
+    };
     save(options?: {
         session?: ClientSession;
     }): Promise<this>;
@@ -1194,7 +1539,7 @@ interface ProcessSalaryParams extends EmployeeOperationParams {
     /**
      * Idempotency key (Stripe-style)
      * If provided, duplicate calls with same key return cached result
-     * Auto-generated if not provided: `payroll:{orgId}:{empId}:{year}-{month}`
+     * Auto-generated if not provided: `payroll:{orgId}:{empId}:{year}-{month}:{payrollRunType}`
      */
     idempotencyKey?: string;
     /**
@@ -1225,8 +1570,12 @@ interface BulkPayrollProgress {
 }
 /** Process bulk payroll parameters */
 interface ProcessBulkPayrollParams {
-    /** Organization ID */
-    organizationId: ObjectIdLike;
+    /**
+     * Organization ID (required in multi-tenant mode).
+     * Can also be provided via context.organizationId as fallback.
+     * In single-tenant mode with autoInject, this is optional.
+     */
+    organizationId?: ObjectIdLike;
     /** Month (1-12) */
     month: number;
     /** Year */
@@ -1285,6 +1634,19 @@ interface ProcessBulkPayrollParams {
      * - undefined/auto: Automatically use streaming for >10k employees
      */
     useStreaming?: boolean;
+    /**
+     * Maximum number of individual result entries to keep in successful/failed arrays.
+     * When exceeded, new results are counted but not stored in the arrays.
+     * Use `successCount`/`failCount` on the result for accurate totals regardless of this limit.
+     *
+     * - undefined/Infinity: Store all results (default, backward compatible)
+     * - 0: Summary only - no individual results, just counts
+     * - N: Store up to N results per array
+     *
+     * Recommended for streaming mode with large datasets to prevent OOM.
+     * @default Infinity
+     */
+    maxResultDetails?: number;
 }
 /** Payroll history parameters */
 interface PayrollHistoryParams {
@@ -1316,7 +1678,14 @@ interface PayrollSummaryParams {
     /** Year */
     year?: number;
 }
-/** Export payroll parameters */
+/**
+ * Export payroll parameters
+ *
+ * Used with the two-phase export flow (v2.8.0+):
+ * - `prepareExport(params)` - Gets records without marking, returns exportId
+ * - `confirmExport({ exportId })` - Marks records after downstream confirms
+ * - `cancelExport({ exportId })` - Cancels if downstream fails
+ */
 interface ExportPayrollParams {
     /** Organization ID */
     organizationId: ObjectIdLike;
@@ -1444,6 +1813,21 @@ interface BulkPayrollResult {
         error: string;
     }>;
     total: number;
+    /**
+     * Accurate count of successful operations, regardless of maxResultDetails.
+     * Always reflects the true number of successes even when `successful` array is capped.
+     */
+    successCount: number;
+    /**
+     * Accurate count of failed operations, regardless of maxResultDetails.
+     * Always reflects the true number of failures even when `failed` array is capped.
+     */
+    failCount: number;
+    /**
+     * Running total of all successful payment amounts, regardless of maxResultDetails.
+     * Always reflects the true sum even when `successful` array is capped.
+     */
+    totalAmount: number;
 }
 /** Payroll summary result */
 interface PayrollSummaryResult {
@@ -1508,7 +1892,40 @@ interface PayrollInstance<TEmployee extends EmployeeDocument = EmployeeDocument,
     processBulkPayroll(params: ProcessBulkPayrollParams): Promise<BulkPayrollResult>;
     payrollHistory(params: PayrollHistoryParams): Promise<TPayrollRecord[]>;
     payrollSummary(params: PayrollSummaryParams): Promise<PayrollSummaryResult>;
-    exportPayroll(params: ExportPayrollParams): Promise<TPayrollRecord[]>;
+    /**
+     * Prepare payroll data for export (Phase 1)
+     *
+     * Retrieves records but does NOT mark them as exported yet.
+     * Returns an exportId that must be used to confirm or cancel.
+     */
+    prepareExport(params: ExportPayrollParams): Promise<{
+        records: TPayrollRecord[];
+        exportId: string;
+        total: number;
+    }>;
+    /**
+     * Confirm export success (Phase 2a)
+     *
+     * Marks records as exported after downstream confirms receipt.
+     */
+    confirmExport(params: {
+        organizationId: ObjectIdLike;
+        exportId: string;
+    }): Promise<{
+        confirmed: number;
+    }>;
+    /**
+     * Cancel export (Phase 2b)
+     *
+     * Called when downstream fails. Records remain unmarked.
+     */
+    cancelExport(params: {
+        organizationId: ObjectIdLike;
+        exportId: string;
+        reason?: string;
+    }): Promise<{
+        cancelled: boolean;
+    }>;
     /**
      * Void a payroll record (before payment)
      *
@@ -1529,11 +1946,9 @@ interface PayrollInstance<TEmployee extends EmployeeDocument = EmployeeDocument,
      * Only works for voided payrolls (not reversed)
      */
     restorePayroll(params: RestorePayrollParams): Promise<RestorePayrollResult>;
-    /** Extended properties from plugins */
-    [key: string]: unknown;
 }
 /**
- * @deprecated Use `PayrollPluginDefinition` from `@classytic/payroll/core`.
+ * @deprecated Use `PayrollPluginDefinition` from `@classytic/payroll` or `@classytic/payroll/core`.
  * This legacy plugin shape is kept for compatibility with older code.
  */
 interface PayrollPlugin {
@@ -1596,7 +2011,7 @@ interface Logger {
     debug(message: string, meta?: Record<string, unknown>): void;
 }
 /** Error codes */
-type ErrorCode = 'PAYROLL_ERROR' | 'NOT_INITIALIZED' | 'EMPLOYEE_NOT_FOUND' | 'INVALID_EMPLOYEE' | 'DUPLICATE_PAYROLL' | 'VALIDATION_ERROR' | 'EMPLOYEE_TERMINATED' | 'ALREADY_PROCESSED' | 'NOT_ELIGIBLE' | 'SECURITY_ERROR';
+type ErrorCode = 'PAYROLL_ERROR' | 'NOT_INITIALIZED' | 'EMPLOYEE_NOT_FOUND' | 'INVALID_EMPLOYEE' | 'DUPLICATE_PAYROLL' | 'VOIDED_PAYROLL_REPROCESS' | 'VALIDATION_ERROR' | 'EMPLOYEE_TERMINATED' | 'ALREADY_PROCESSED' | 'NOT_ELIGIBLE' | 'SECURITY_ERROR' | 'EXPORT_NOT_FOUND' | 'EXPORT_ORG_MISMATCH';
 /** HTTP error with status code */
 interface HttpError extends Error {
     code: ErrorCode;
@@ -1853,4 +2268,4 @@ interface MarkTaxPaidParams {
     context?: OperationContext;
 }
 
-export { type ExportPayrollParams as $, type Allowance as A, type BankDetails as B, type Compensation as C, type Deduction as D, type EmployeeDocument as E, type EmployeeIdentityMode as F, type UpdateSalaryParams as G, type HireEmployeeParams as H, type AddAllowanceParams as I, type RemoveAllowanceParams as J, type AddDeductionParams as K, type LeaveType as L, type RemoveDeductionParams as M, type UpdateBankDetailsParams as N, type ObjectIdLike as O, type PayPeriodInfo as P, type ProcessSalaryParams as Q, type ReHireEmployeeParams as R, type ProcessSalaryResult as S, type TaxWithholdingDocument as T, type UpdateEmploymentParams as U, type ProcessBulkPayrollParams as V, type WorkingDaysOptions as W, type BulkPayrollResult as X, type PayrollHistoryParams as Y, type PayrollSummaryParams as Z, type PayrollSummaryResult as _, type LeaveBalance as a, WebhookManager as a$, type VoidPayrollParams as a0, type VoidPayrollResult as a1, type ReversePayrollParams as a2, type ReversePayrollResult as a3, type RestorePayrollParams as a4, type RestorePayrollResult as a5, type GetPendingTaxParams as a6, type TaxSummaryParams as a7, type TaxSummaryResult as a8, type MarkTaxPaidParams as a9, type GetEmployeeParams as aA, type HRMTransactionCategory as aB, type LeaveHistoryFilters as aC, type Nullable as aD, type PaymentMethod as aE, type PayrollConfig as aF, type PayrollCorrection as aG, type PayrollEmployee as aH, type PayrollEvent as aI, type PayrollPeriod as aJ, type PayrollPlugin as aK, type PayrollStats as aL, type PluginFunction as aM, type PluginType as aN, type QueryOptions as aO, type RequestLeaveInput as aP, type ResetAnnualLeaveOptions as aQ, type ReviewLeaveRequestInput as aR, type RoleMappingConfig as aS, type SalaryBand as aT, type SalaryBandRange as aU, type SalaryConfig as aV, type SalaryProcessedEvent as aW, type TaxBracket as aX, type TaxSummaryByType as aY, type UserReference as aZ, type ValidationConfig as a_, type DeepPartial as aa, type HRMConfig as ab, type SingleTenantConfig as ac, type PayrollBreakdown as ad, type ObjectId as ae, type OrgRole as af, type WorkSchedule as ag, type PaymentFrequency as ah, type TerminationReason as ai, type HttpError as aj, type ErrorCode as ak, type AttendanceInput as al, type AccrueLeaveOptions as am, type AllowanceType as an, type AnyModel as ao, type BulkPayrollProgress as ap, type DataRetentionConfig as aq, type DeductionType as ar, type EmployeeHiredEvent as as, type EmployeeIdMode as at, type EmployeeOperationParams as au, type EmploymentConfig as av, type EmploymentHistoryEntry as aw, type EventPayload as ax, type EventPayloadBase as ay, type FilterQuery as az, type LeaveSummaryResult as b, type WithPayroll as b0, type LeaveInitConfig as c, type OperationContext as d, type TaxType as e, type TaxStatus as f, type LeaveRequestDocument as g, type LeaveRequestStatus as h, type Logger as i, type CompensationBreakdownResult as j, type TaxCalculationResult as k, type EmployeeStatus as l, type EmployeeValidationResult as m, type EmploymentType as n, type Department as o, type PayrollStatus as p, type PayrollRecordDocument as q, type AnyDocument as r, type PayrollInstance as s, type PayrollInitConfig as t, type PayrollPluginDefinition as u, type PayrollEventMap as v, type WebhookConfig as w, type PayrollEventType as x, type WebhookDelivery as y, type TerminateEmployeeParams as z };
+export { type TaxBracket as $, type AnyDocument as A, countWorkingDays as B, type CompensationChangedEventPayload as C, DEFAULT_WORK_SCHEDULE as D, type EmployeeDocument as E, createEventBus as F, createNotificationPlugin as G, type HRMConfig as H, definePlugin as I, getEventBus as J, getPayPeriod as K, type LeaveRequestDocument as L, type MilestoneAchievedEventPayload as M, type NotificationPluginOptions as N, loggingPlugin as O, type PayrollRecordDocument as P, metricsPlugin as Q, notificationPlugin as R, type SingleTenantConfig as S, type TaxWithholdingDocument as T, onEmployeeHired as U, onMilestoneAchieved as V, type WebhookConfig as W, onPayrollCompleted as X, onSalaryProcessed as Y, resetEventBus as Z, type Compensation as _, type Logger as a, type AllowanceType as a$, type TaxCalculationOptions as a0, type PayrollBreakdown as a1, type ObjectIdLike as a2, type ObjectId as a3, type TaxType as a4, type TaxStatus as a5, type LeaveRequestStatus as a6, type LeaveType as a7, type PayPeriodInfo as a8, type Allowance as a9, type AddDeductionParams as aA, type RemoveDeductionParams as aB, type UpdateBankDetailsParams as aC, type ProcessSalaryParams as aD, type ProcessSalaryResult as aE, type ProcessBulkPayrollParams as aF, type BulkPayrollResult as aG, type PayrollHistoryParams as aH, type PayrollSummaryParams as aI, type PayrollSummaryResult as aJ, type VoidPayrollParams as aK, type VoidPayrollResult as aL, type ReversePayrollParams as aM, type ReversePayrollResult as aN, type RestorePayrollParams as aO, type RestorePayrollResult as aP, type GetPendingTaxParams as aQ, type TaxSummaryParams as aR, type TaxSummaryResult as aS, type MarkTaxPaidParams as aT, type ExportPayrollParams as aU, type DeepPartial as aV, type OrgRole as aW, type WorkSchedule as aX, type PaymentFrequency as aY, type TerminationReason as aZ, type AccrueLeaveOptions as a_, type CompensationBreakdownResult as aa, type Deduction as ab, type TaxCalculationResult as ac, type EmployeeStatus as ad, type EmployeeValidationResult as ae, type BankDetails as af, type EmploymentType as ag, type Department as ah, type PayrollStatus as ai, type HttpError as aj, type ErrorCode as ak, type LeaveBalance as al, type WorkingDaysOptions as am, type LeaveSummaryResult as an, type LeaveInitConfig as ao, type OperationContext as ap, type PayrollInstance as aq, type PayrollInitConfig as ar, type HireEmployeeParams as as, type UpdateEmploymentParams as at, type TerminateEmployeeParams as au, type ReHireEmployeeParams as av, type EmployeeIdentityMode as aw, type UpdateSalaryParams as ax, type AddAllowanceParams as ay, type RemoveAllowanceParams as az, type AttendanceInput as b, type AnyModel as b0, type BulkPayrollProgress as b1, type DataRetentionConfig as b2, type DeductionType as b3, type EmployeeHiredEvent as b4, type EmployeeIdMode as b5, type EmployeeOperationParams as b6, type EmploymentConfig as b7, type EmploymentHistoryEntry as b8, type EventPayload as b9, type TaxCreditInput as bA, type TaxSummaryByType as bB, type UserReference as bC, type ValidationConfig as bD, type WithPayroll as bE, type EventPayloadBase as ba, type FilterQuery as bb, type GetEmployeeParams as bc, type HRMTransactionCategory as bd, type LeaveHistoryFilters as be, type Nullable as bf, type PaymentMethod as bg, type PayrollConfig as bh, type PayrollCorrection as bi, type PayrollEmployee as bj, type PayrollEvent as bk, type PayrollPeriod as bl, type PayrollPlugin as bm, type PayrollStats as bn, type PluginFunction as bo, type PluginType as bp, type PreTaxDeductionInput as bq, type QueryOptions as br, type RequestLeaveInput as bs, type ResetAnnualLeaveOptions as bt, type ReviewLeaveRequestInput as bu, type RoleMappingConfig as bv, type SalaryBand as bw, type SalaryBandRange as bx, type SalaryConfig as by, type SalaryProcessedEvent as bz, type EmployeeHiredEventPayload as c, type EmployeeRehiredEventPayload as d, type EmployeeTerminatedEventPayload as e, EventBus as f, type PayrollCompletedEventPayload as g, type PayrollEventHandler as h, type PayrollEventMap as i, type PayrollEventType as j, type PayrollExportedEventPayload as k, type PayrollPluginDefinition as l, type PayrollProcessingOptions as m, type PluginContext as n, type PluginHooks as o, type PluginLogger as p, PluginManager as q, type ProrationResult as r, type SalaryFailedEventPayload as s, type SalaryProcessedEventPayload as t, type SalaryUpdatedEventPayload as u, type WebhookDelivery as v, WebhookManager as w, type WorkSchedule$1 as x, type WorkingDaysResult as y, calculateProration as z };

package/dist/utils/index.d.ts

@@ -1,7 +1,7 @@
-import { i as Logger, P as PayPeriodInfo, A as Allowance, C as Compensation, j as CompensationBreakdownResult, D as Deduction, k as TaxCalculationResult, l as EmployeeStatus, m as EmployeeValidationResult, B as BankDetails, n as EmploymentType, O as ObjectIdLike, o as Department, p as PayrollStatus } from '../types-BVDjiVGS.js';
-export { a as applyProRating, c as calculateProRating } from '../prorating.calculator-C7sdFiG2.js';
+import { a as Logger, a8 as PayPeriodInfo, a9 as Allowance, _ as Compensation, aa as CompensationBreakdownResult, ab as Deduction, ac as TaxCalculationResult, ad as EmployeeStatus, ae as EmployeeValidationResult, af as BankDetails, ag as EmploymentType, a2 as ObjectIdLike, ah as Department, ai as PayrollStatus } from '../types-bZdAJueH.js';
+export { b as applyProRating, c as calculateProRating } from '../prorating.calculator-C33fWBQf.js';
 import { Types } from 'mongoose';
-export { C as ContainerLike, D as DEFAULT_CARRY_OVER, a as DEFAULT_LEAVE_ALLOCATIONS, E as EmployeeIdMode, b as EmployeeIdType, c as EmployeeQueryFilter, R as ResolveOrganizationIdParams, S as SecureEmployeeLookupOptions, d as accrueLeaveToBalance, e as calculateCarryOver, f as calculateLeaveDays, g as calculateUnpaidLeaveDeduction, h as detectEmployeeIdType, i as employeeExistsSecure, j as findEmployeeSecure, k as findEmployeesSecure, l as formatEmployeeId, m as getAvailableDays, n as getLeaveBalance, o as getLeaveBalances, p as getLeaveSummary, q as getUnpaidLeaveDays, r as hasLeaveBalance, s as initializeLeaveBalances, t as isObjectIdEmployeeId, u as isStringEmployeeId, _ as leaveUtils, v as normalizeEmployeeId, w as proRateAllocation, x as requireOrganizationId, y as resolveOrganizationId, z as tryResolveOrganizationId, A as validateOrganizationId } from '../employee-identity-Cq2wo9-2.js';
+export { C as ContainerLike, D as DEFAULT_CARRY_OVER, a as DEFAULT_LEAVE_ALLOCATIONS, b as DuplicateKeyErrorResult, E as EmployeeIdMode, c as EmployeeIdType, d as EmployeeQueryFilter, P as PayrollErrorResult, R as ResolveOrganizationIdParams, S as SecureEmployeeLookupOptions, T as TransactionErrorResult, e as accrueLeaveToBalance, f as calculateCarryOver, g as calculateLeaveDays, h as calculateUnpaidLeaveDeduction, i as detectEmployeeIdType, j as employeeExistsSecure, k as findEmployeeSecure, l as findEmployeesSecure, m as formatEmployeeId, n as formatUserError, o as getAvailableDays, p as getLeaveBalance, q as getLeaveBalances, r as getLeaveSummary, s as getUnpaidLeaveDays, t as handleDuplicateKeyError, u as handlePayrollError, v as handleTransactionError, w as hasLeaveBalance, x as initializeLeaveBalances, y as isObjectIdEmployeeId, z as isStringEmployeeId, _ as leaveUtils, A as normalizeEmployeeId, B as proRateAllocation, F as requireOrganizationId, G as resolveOrganizationId, H as tryResolveOrganizationId, I as validateOrganizationId } from '../error-helpers-Bm6lMny2.js';
 
 /**
  * @classytic/payroll - Logger
@@ -100,7 +100,18 @@ declare function startOfDay(date: Date): Date;
  */
 declare function endOfDay(date: Date): Date;
 /**
- * Calculate difference in days between two dates
+ * Convert a date to a UTC-based date string for consistent comparison.
+ *
+ * Unlike `Date.toDateString()` which uses the local timezone, this produces
+ * a locale-independent string based on the date's year/month/day components.
+ * Use this for holiday set lookups to avoid timezone-dependent mismatches.
+ */
+declare function toUTCDateString(date: Date): string;
+/**
+ * Calculate difference in days between two dates.
+ *
+ * Normalizes both dates to midnight before computing to avoid
+ * inconsistencies from time-of-day differences or DST transitions.
  */
 declare function diffInDays(start: Date, end: Date): number;
 /**
@@ -130,7 +141,7 @@ declare function getDayOfWeek(date: Date): number;
  */
 declare function getDayName(date: Date): string;
 /**
- * Get pay period for a given month and year
+ * Get pay period for a given month and year (monthly periods)
  */
 declare function getPayPeriod(month: number, year: number): PayPeriodInfo;
 /**
@@ -226,6 +237,7 @@ declare function getMonthName(month: number): string;
  */
 declare function getShortMonthName(month: number): string;
 declare const _default$3: {
+    toUTCDateString: typeof toUTCDateString;
     addDays: typeof addDays;
     addMonths: typeof addMonths;
     addYears: typeof addYears;