hvp-shared 6.59.0 → 6.60.1

package/dist/constants/hris.constants.d.ts

@@ -0,0 +1,51 @@
+/**
+ * HRIS (Human Resources Information System) constants.
+ *
+ * These are currently hardcoded values. Some should eventually become
+ * configurable via CompanySettings (see GH issue for reorganization).
+ *
+ * Categories:
+ * - Mexican labor law (not configurable)
+ * - Company policy (should become configurable)
+ * - Derived/calculated (computed from other constants)
+ */
+/** Prima vacacional: 25% of vacation days' salary (Art. 80 LFT) */
+export declare const VACATION_BONUS_PERCENTAGE = 0.25;
+/** Sunday premium: 25% extra for working Sundays (Art. 71 LFT) */
+export declare const SUNDAY_BONUS_PERCENTAGE = 0.25;
+/** Holiday or rest day extra pay: 200% (double pay) (Art. 75 LFT) */
+export declare const HOLIDAY_OR_REST_EXTRA_PAY_PERCENTAGE = 2;
+/** Maximum legal work week in hours (Art. 61 LFT: 48 for daytime) */
+export declare const MAX_WORK_WEEK_LIMIT = 48;
+/** Maximum overtime threshold for double pay (48 + 9 = 57 hrs) */
+export declare const MAX_DOUBLE_PLAY_WORK_WEEK_LIMIT = 57;
+/** Working days per week (company policy: 6 days) */
+export declare const WORKING_DAYS_IN_A_WEEK = 6;
+/** Annual salary raise percentage per year of seniority */
+export declare const ANNUAL_RAISE_PERCENT = 0.02;
+/** Year-end bonus (aguinaldo) days (legal minimum: 15, Art. 87 LFT) */
+export declare const YEAR_END_BONUS_DAYS = 15;
+/** Percentage of commissions considered for year-end bonus calculation */
+export declare const COMMISSION_PERCENTAGE_FOR_YEAR_END_BONUS = 0.5;
+/** Commission seniority bonus: 5% increase per semester */
+export declare const COMMISSION_SENIORITY_BONUS_PER_SEMESTER = 0.05;
+export declare const CLOSING_LARGE_THRESHOLD = 10000;
+export declare const BONUS_LARGE_CLOSING = 100;
+export declare const BONUS_SMALL_CLOSING = 50;
+export declare const BONUS_PER_CLOSING = 60;
+export declare const DEDUCTION_INVALID_CLOSING = 40;
+export declare const DEDUCTION_INVALID_WITHDRAWAL = 20;
+export declare const EXCELLENCE_BONUS_MIN_CLOSINGS = 3;
+export declare const EXCELLENCE_BONUS_RATE = 0.25;
+/** Average working days per month (365/12/7 × 6) */
+export declare const AVERAGE_WORK_DAYS_PER_MONTH: number;
+/** Weeks in a month (365/12/7) */
+export declare const WEEKS_IN_MONTH = 4.34524;
+/** Calendar days in a month (used for nominal daily calculations) */
+export declare const MONTH_DAYS = 30;
+/** Working days in a month (6 × weeks) */
+export declare const MONTH_WORK_DAYS: number;
+/** Standard daily working hours (48/6) */
+export declare const DAILY_WORK_HOURS = 8;
+/** Working days in a week (alias for clarity) */
+export declare const WEEK_WORK_DAYS = 6;

package/dist/constants/hris.constants.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * HRIS (Human Resources Information System) constants.
+ *
+ * These are currently hardcoded values. Some should eventually become
+ * configurable via CompanySettings (see GH issue for reorganization).
+ *
+ * Categories:
+ * - Mexican labor law (not configurable)
+ * - Company policy (should become configurable)
+ * - Derived/calculated (computed from other constants)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEEK_WORK_DAYS = exports.DAILY_WORK_HOURS = exports.MONTH_WORK_DAYS = exports.MONTH_DAYS = exports.WEEKS_IN_MONTH = exports.AVERAGE_WORK_DAYS_PER_MONTH = exports.EXCELLENCE_BONUS_RATE = exports.EXCELLENCE_BONUS_MIN_CLOSINGS = exports.DEDUCTION_INVALID_WITHDRAWAL = exports.DEDUCTION_INVALID_CLOSING = exports.BONUS_PER_CLOSING = exports.BONUS_SMALL_CLOSING = exports.BONUS_LARGE_CLOSING = exports.CLOSING_LARGE_THRESHOLD = exports.COMMISSION_SENIORITY_BONUS_PER_SEMESTER = exports.COMMISSION_PERCENTAGE_FOR_YEAR_END_BONUS = exports.YEAR_END_BONUS_DAYS = exports.ANNUAL_RAISE_PERCENT = exports.WORKING_DAYS_IN_A_WEEK = exports.MAX_DOUBLE_PLAY_WORK_WEEK_LIMIT = exports.MAX_WORK_WEEK_LIMIT = exports.HOLIDAY_OR_REST_EXTRA_PAY_PERCENTAGE = exports.SUNDAY_BONUS_PERCENTAGE = exports.VACATION_BONUS_PERCENTAGE = void 0;
+// ── Mexican Labor Law (not configurable) ──
+/** Prima vacacional: 25% of vacation days' salary (Art. 80 LFT) */
+exports.VACATION_BONUS_PERCENTAGE = 0.25;
+/** Sunday premium: 25% extra for working Sundays (Art. 71 LFT) */
+exports.SUNDAY_BONUS_PERCENTAGE = 0.25;
+/** Holiday or rest day extra pay: 200% (double pay) (Art. 75 LFT) */
+exports.HOLIDAY_OR_REST_EXTRA_PAY_PERCENTAGE = 2;
+// LEGAL_VACATIONS is in time-off.constants.ts (already in shared)
+// ── Company Policy (TODO: move to CompanySettings — see GH#XX) ──
+/** Maximum legal work week in hours (Art. 61 LFT: 48 for daytime) */
+exports.MAX_WORK_WEEK_LIMIT = 48;
+/** Maximum overtime threshold for double pay (48 + 9 = 57 hrs) */
+exports.MAX_DOUBLE_PLAY_WORK_WEEK_LIMIT = 57;
+/** Working days per week (company policy: 6 days) */
+exports.WORKING_DAYS_IN_A_WEEK = 6;
+/** Annual salary raise percentage per year of seniority */
+exports.ANNUAL_RAISE_PERCENT = 0.02;
+/** Year-end bonus (aguinaldo) days (legal minimum: 15, Art. 87 LFT) */
+exports.YEAR_END_BONUS_DAYS = 15;
+/** Percentage of commissions considered for year-end bonus calculation */
+exports.COMMISSION_PERCENTAGE_FOR_YEAR_END_BONUS = 0.5;
+/** Commission seniority bonus: 5% increase per semester */
+exports.COMMISSION_SENIORITY_BONUS_PER_SEMESTER = 0.05;
+// ── Reception Bonus (Bono de recepción) ──
+// Legacy thresholds (kept for historical data)
+exports.CLOSING_LARGE_THRESHOLD = 10000;
+exports.BONUS_LARGE_CLOSING = 100;
+exports.BONUS_SMALL_CLOSING = 50;
+// Current policy
+exports.BONUS_PER_CLOSING = 60;
+exports.DEDUCTION_INVALID_CLOSING = 40;
+exports.DEDUCTION_INVALID_WITHDRAWAL = 20;
+exports.EXCELLENCE_BONUS_MIN_CLOSINGS = 3;
+exports.EXCELLENCE_BONUS_RATE = 0.25;
+// ── Derived / Calculated ──
+/** Average working days per month (365/12/7 × 6) */
+exports.AVERAGE_WORK_DAYS_PER_MONTH = (365 / 12 / 7) * exports.WORKING_DAYS_IN_A_WEEK;
+/** Weeks in a month (365/12/7) */
+exports.WEEKS_IN_MONTH = 4.34524;
+/** Calendar days in a month (used for nominal daily calculations) */
+exports.MONTH_DAYS = 30;
+/** Working days in a month (6 × weeks) */
+exports.MONTH_WORK_DAYS = 6 * exports.WEEKS_IN_MONTH;
+/** Standard daily working hours (48/6) */
+exports.DAILY_WORK_HOURS = 8;
+/** Working days in a week (alias for clarity) */
+exports.WEEK_WORK_DAYS = 6;

package/dist/constants/index.d.ts

@@ -19,3 +19,4 @@ export * from './employment.enums';
 export * from './qvet-cash-flow.enums';
 export * from './time-off.enums';
 export * from './time-off.constants';
+export * from './hris.constants';

package/dist/constants/index.js

@@ -35,3 +35,4 @@ __exportStar(require("./employment.enums"), exports);
 __exportStar(require("./qvet-cash-flow.enums"), exports);
 __exportStar(require("./time-off.enums"), exports);
 __exportStar(require("./time-off.constants"), exports);
+__exportStar(require("./hris.constants"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvp-shared",
-  "version": "6.59.0",
+  "version": "6.60.1",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",