hvp-shared 6.67.0 → 6.69.0

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

@@ -49,5 +49,12 @@ export declare const MONTH_WORK_DAYS: number;
 export declare const DAILY_WORK_HOURS = 8;
 /** Working days in a week (alias for clarity) */
 export declare const WEEK_WORK_DAYS = 6;
-/** Calculate hourly rate from monthly fixed income: income / 30 / 8 */
+/** Weeks per month (52 / 12 ≈ 4.333) — used for hourly rate calculation */
+export declare const WEEKS_PER_MONTH: number;
+/**
+ * Calculate hourly rate from monthly fixed income.
+ * Formula: income / (52/12) / 48
+ * Divides by work-weeks per month and max weekly hours (48).
+ * Hourly workers are NOT paid for rest days, so we use actual work hours, not calendar days.
+ */
 export declare function calculateHourlyRate(jobFixedIncome: number): number;

package/dist/constants/hris.constants.js

@@ -11,7 +11,7 @@
  * - 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;
+exports.WEEKS_PER_MONTH = 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;
 exports.calculateHourlyRate = calculateHourlyRate;
 // ── Mexican Labor Law (not configurable) ──
 /** Prima vacacional: 25% of vacation days' salary (Art. 80 LFT) */
@@ -61,9 +61,16 @@ exports.DAILY_WORK_HOURS = 8;
 /** Working days in a week (alias for clarity) */
 exports.WEEK_WORK_DAYS = 6;
 // ── Utility Functions ──
-/** Calculate hourly rate from monthly fixed income: income / 30 / 8 */
+/** Weeks per month (52 / 12 ≈ 4.333) — used for hourly rate calculation */
+exports.WEEKS_PER_MONTH = 52 / 12;
+/**
+ * Calculate hourly rate from monthly fixed income.
+ * Formula: income / (52/12) / 48
+ * Divides by work-weeks per month and max weekly hours (48).
+ * Hourly workers are NOT paid for rest days, so we use actual work hours, not calendar days.
+ */
 function calculateHourlyRate(jobFixedIncome) {
     if (!jobFixedIncome || jobFixedIncome <= 0)
         return 0;
-    return Math.round((jobFixedIncome / exports.MONTH_DAYS / exports.DAILY_WORK_HOURS) * 100) / 100;
+    return Math.round((jobFixedIncome / exports.WEEKS_PER_MONTH / exports.MAX_WORK_WEEK_LIMIT) * 100) / 100;
 }

package/dist/types/employment-sections.types.d.ts

@@ -57,17 +57,20 @@ export interface SalaryRates {
     effectiveHourly: number;
 }
 /**
- * Salary Data Overrides
+ * Employment Overrides
  *
- * When the user manually overrides a calculated value.
- * The calculated field always holds the formula result;
- * the override holds the user's intent.
+ * User-set overrides for specific calculated fields.
+ * Each field, when present, replaces the corresponding calculated value.
  * Effective value = override ?? calculated.
+ *
+ * Lives as a top-level field on the employment document.
+ * Not all fields apply to all employment types — see comments.
  */
-export interface SalaryDataOverrides {
+export interface EmploymentOverrides {
     guaranteedIncome?: number;
     adjustedJobIncome?: number;
-    totalFixedIncome?: number;
+    hourlyRate?: number;
+    commissionRateAdjustment?: number;
 }
 /**
  * Employment Salary Data
@@ -81,7 +84,6 @@ export interface EmploymentSalaryData {
     adjustedJobIncome: number;
     totalFixedIncome: number;
     rates: SalaryRates;
-    overrides?: SalaryDataOverrides;
 }
 /**
  * Employment Hourly Data
@@ -93,7 +95,6 @@ export interface EmploymentSalaryData {
 export interface EmploymentHourlyData {
     adjustedHourlyRate: number;
     averageDailyHoursWorked: number;
-    adjustedHourlyRateOverride?: number;
 }
 /**
  * Employment Benefits

package/package.json

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