hvp-shared 6.65.0 → 6.66.0

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

@@ -1,5 +1,6 @@
 import { EmploymentType, CompensationType, PayrollStampingMode, ScheduleType, AttendanceSource } from '../../constants/employment.enums';
 import { JobSnapshot } from '../../types/job-snapshot.types';
+import { EmploymentConfig, EmploymentSchedule, EmploymentSeniority, EmploymentSalaryData, EmploymentHourlyData, EmploymentBenefits, EmploymentImss, EmploymentCfdi } from '../../types/employment-sections.types';
 /**
  * Public Employment Response
  *
@@ -81,6 +82,14 @@ export interface AdminEmploymentResponse extends EmploymentViewResponse {
     physicalActivitySupport?: number;
     createdBy?: string;
     updatedBy?: string;
+    config?: EmploymentConfig;
+    schedule?: EmploymentSchedule;
+    seniority?: EmploymentSeniority;
+    salaryData?: EmploymentSalaryData;
+    hourlyData?: EmploymentHourlyData;
+    benefits?: EmploymentBenefits;
+    imss?: EmploymentImss;
+    cfdi?: EmploymentCfdi;
 }
 /**
  * Union type for all employment response types

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

@@ -0,0 +1,130 @@
+import { EmploymentType, CompensationType, PayrollStampingMode, ScheduleType, AttendanceSource } from '../constants/employment.enums';
+/**
+ * A fixed concept with a name and amount.
+ * Used for additional incomes and deductions.
+ */
+export interface FixedConcept {
+    concept: string;
+    amount: number;
+}
+/**
+ * Employment Config
+ *
+ * User-set classification fields. Changing any triggers recalculation.
+ * Present on ALL employment types.
+ */
+export interface EmploymentConfig {
+    employmentType: EmploymentType;
+    compensationType: CompensationType;
+    weeklyHours: number;
+    scheduleType: ScheduleType;
+    attendanceSource: AttendanceSource;
+    hasCommissions: boolean;
+    hasImss: boolean;
+    payrollStampingMode: PayrollStampingMode;
+    additionalIncomes: FixedConcept[];
+    deductions: FixedConcept[];
+}
+/**
+ * Employment Schedule
+ *
+ * Derived from config.weeklyHours. ONLY present when scheduleType = "fixed".
+ * Absent for flexible, on_demand, none.
+ */
+export interface EmploymentSchedule {
+    workWeekRatio: number;
+    dailyWorkingHours: number;
+}
+/**
+ * Employment Seniority
+ *
+ * Derived from collaborator start date. Always calculated, no overrides.
+ * Present for: payroll, payroll_draft, intern, hourly_agreed, casual.
+ * Absent for: contractor, coverage_only.
+ */
+export interface EmploymentSeniority {
+    bonusPercentage: number;
+    commissionBonusPercentage: number;
+}
+/**
+ * Salary Rates
+ *
+ * Daily and hourly rates derived from totalFixedIncome.
+ * Used for CFDI stamping (nominal) and deductions/bonuses (effective).
+ */
+export interface SalaryRates {
+    nominalDaily: number;
+    nominalHourly: number;
+    effectiveDaily: number;
+    effectiveHourly: number;
+}
+/**
+ * Salary Data Overrides
+ *
+ * When the user manually overrides a calculated value.
+ * The calculated field always holds the formula result;
+ * the override holds the user's intent.
+ * Effective value = override ?? calculated.
+ */
+export interface SalaryDataOverrides {
+    guaranteedIncome?: number;
+    adjustedJobIncome?: number;
+    totalFixedIncome?: number;
+}
+/**
+ * Employment Salary Data
+ *
+ * Full income chain + rates for salary-based employments.
+ * ONLY for: payroll, payroll_draft, intern.
+ * Mutually exclusive with hourlyData.
+ */
+export interface EmploymentSalaryData {
+    guaranteedIncome: number;
+    adjustedJobIncome: number;
+    totalFixedIncome: number;
+    rates: SalaryRates;
+    overrides?: SalaryDataOverrides;
+}
+/**
+ * Employment Hourly Data
+ *
+ * Pay rate + hours tracking for hourly-based employments.
+ * ONLY for: hourly_agreed, casual.
+ * Mutually exclusive with salaryData.
+ */
+export interface EmploymentHourlyData {
+    adjustedHourlyRate: number;
+    averageDailyHoursWorked: number;
+    adjustedHourlyRateOverride?: number;
+}
+/**
+ * Employment Benefits
+ *
+ * Monthly support amounts (user-entered).
+ * Present for: payroll, payroll_draft, intern, hourly_agreed, casual.
+ * Absent for: contractor, coverage_only.
+ */
+export interface EmploymentBenefits {
+    trainingSupport: number;
+    physicalActivitySupport: number;
+}
+/**
+ * Employment IMSS
+ *
+ * Social security contribution data.
+ * Only present when config.hasImss = true.
+ */
+export interface EmploymentImss {
+    contributionBaseSalary: number;
+    integratedDailySalary: number;
+}
+/**
+ * Employment CFDI
+ *
+ * Fiscal stamping configuration.
+ * Only present when config.payrollStampingMode !== "none".
+ */
+export interface EmploymentCfdi {
+    journeyType: string;
+    paymentFrequency: string;
+}

package/dist/types/employment-sections.types.js

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

package/dist/types/index.d.ts

@@ -15,3 +15,4 @@ export * from './cash-reconciliation.types';
 export * from './coverage.types';
 export * from './job-promotion-stats.types';
 export * from './job-snapshot.types';
+export * from './employment-sections.types';

package/dist/types/index.js

@@ -31,3 +31,4 @@ __exportStar(require("./cash-reconciliation.types"), exports);
 __exportStar(require("./coverage.types"), exports);
 __exportStar(require("./job-promotion-stats.types"), exports);
 __exportStar(require("./job-snapshot.types"), exports);
+__exportStar(require("./employment-sections.types"), exports);

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

@@ -16,4 +16,5 @@ export interface JobSnapshot {
     isCommissionAdjusted: boolean;
     commissionRateAdjustment: number;
     expressBranchCompensation: number;
+    hourlyRate?: number;
 }

package/package.json

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