hvp-shared 6.57.0 → 6.59.0

package/dist/constants/index.d.ts

@@ -11,6 +11,7 @@ export * from './qvet-warehouses';
 export * from './qvet-inventory';
 export * from './background-job.constants';
 export * from './job-category.constants';
+export * from './job-compensation.constants';
 export * from './special-collaborators.constants';
 export * from './commissions.constants';
 export * from './hr.enums';

package/dist/constants/index.js

@@ -27,6 +27,7 @@ __exportStar(require("./qvet-warehouses"), exports);
 __exportStar(require("./qvet-inventory"), exports);
 __exportStar(require("./background-job.constants"), exports);
 __exportStar(require("./job-category.constants"), exports);
+__exportStar(require("./job-compensation.constants"), exports);
 __exportStar(require("./special-collaborators.constants"), exports);
 __exportStar(require("./commissions.constants"), exports);
 __exportStar(require("./hr.enums"), exports);

package/dist/constants/job-compensation.constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Rate applied to the excess of guaranteedJobIncome over minimumWageHVP
+ * to compute jobFixedIncome.
+ *
+ * Formula:
+ *   guaranteedJobIncome = minimumWageHVP * positionFactor
+ *   jobFixedIncome = minimumWageHVP + (guaranteedJobIncome - minimumWageHVP) * FIXED_INCOME_EXCESS_RATE
+ */
+export declare const FIXED_INCOME_EXCESS_RATE = 0.5;

package/dist/constants/job-compensation.constants.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIXED_INCOME_EXCESS_RATE = void 0;
+/**
+ * Rate applied to the excess of guaranteedJobIncome over minimumWageHVP
+ * to compute jobFixedIncome.
+ *
+ * Formula:
+ *   guaranteedJobIncome = minimumWageHVP * positionFactor
+ *   jobFixedIncome = minimumWageHVP + (guaranteedJobIncome - minimumWageHVP) * FIXED_INCOME_EXCESS_RATE
+ */
+exports.FIXED_INCOME_EXCESS_RATE = 0.5;

package/dist/contracts/employment/responses.d.ts

@@ -1,4 +1,5 @@
 import { EmploymentType, CompensationType, PayrollStampingMode, ScheduleType, AttendanceSource } from '../../constants/employment.enums';
+import { JobSnapshot } from '../../types/job-snapshot.types';
 /**
  * Public Employment Response
  *
@@ -36,6 +37,7 @@ export interface EmploymentViewResponse extends PublicEmploymentResponse {
     weeklyHours?: number;
     seniorityBonusPercentage?: number;
     commissionBonusPercentage?: number;
+    jobSnapshot?: JobSnapshot;
     createdAt?: string;
     updatedAt?: string;
 }

package/dist/contracts/job/requests.d.ts

@@ -16,7 +16,6 @@ export interface CreateJobRequest {
     positionFactor?: number;
     guaranteedJobIncome?: number;
     jobFixedIncome?: number;
-    fixedShareOfGuaranteedIncome?: number;
     isCommissionAdjusted?: boolean;
     commissionRateAdjustment?: number;
     expressBranchCompensation?: number;
@@ -41,7 +40,6 @@ export interface UpdateJobRequest {
     positionFactor?: number;
     guaranteedJobIncome?: number;
     jobFixedIncome?: number;
-    fixedShareOfGuaranteedIncome?: number;
     isCommissionAdjusted?: boolean;
     commissionRateAdjustment?: number;
     expressBranchCompensation?: number;

package/dist/contracts/job/responses.d.ts

@@ -21,7 +21,6 @@ export interface JobResponse {
     positionFactor: number;
     guaranteedJobIncome?: number;
     jobFixedIncome?: number;
-    fixedShareOfGuaranteedIncome: number;
     isCommissionAdjusted: boolean;
     commissionRateAdjustment: number;
     expressBranchCompensation: number;

package/dist/types/index.d.ts

@@ -14,3 +14,4 @@ export * from './payroll-v2.types';
 export * from './cash-reconciliation.types';
 export * from './coverage.types';
 export * from './job-promotion-stats.types';
+export * from './job-snapshot.types';

package/dist/types/index.js

@@ -30,3 +30,4 @@ __exportStar(require("./payroll-v2.types"), exports);
 __exportStar(require("./cash-reconciliation.types"), exports);
 __exportStar(require("./coverage.types"), exports);
 __exportStar(require("./job-promotion-stats.types"), exports);
+__exportStar(require("./job-snapshot.types"), exports);

package/dist/types/job-snapshot.types.d.ts

@@ -0,0 +1,19 @@
+import { JobCategory } from '../constants/job-category.constants';
+/**
+ * Job Snapshot
+ *
+ * A point-in-time copy of job fields stored on employment records.
+ * Avoids always fetching the job entity when displaying employment data.
+ *
+ * Updated when employment is created, recalculated, or when the job changes.
+ */
+export interface JobSnapshot {
+    title: string;
+    category?: JobCategory;
+    positionFactor: number;
+    guaranteedJobIncome: number;
+    jobFixedIncome: number;
+    isCommissionAdjusted: boolean;
+    commissionRateAdjustment: number;
+    expressBranchCompensation: number;
+}

package/dist/types/job-snapshot.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

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