hvp-shared 6.51.0 → 6.53.0

package/dist/constants/collaborator.constants.d.ts

@@ -14,7 +14,8 @@ export declare enum WebAppRole {
     manager = "Gerente",
     collaborator = "Colaborador",
     user = "User",
-    guest = "Invitado"
+    guest = "Invitado",
+    no_access = "Sin acceso"
 }
 /**
  * Educational Degree

package/dist/constants/collaborator.constants.js

@@ -19,6 +19,7 @@ var WebAppRole;
     WebAppRole["collaborator"] = "Colaborador";
     WebAppRole["user"] = "User";
     WebAppRole["guest"] = "Invitado";
+    WebAppRole["no_access"] = "Sin acceso";
 })(WebAppRole || (exports.WebAppRole = WebAppRole = {}));
 /**
  * Educational Degree

package/dist/constants/employment.enums.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Employment Enums — HR Model Restructuring (GH10)
+ *
+ * New enums for the restructured Employment model.
+ * All enums follow the new standard: snake_case values + LABELS objects.
+ *
+ * @see .claude/rules/enums.md for conventions
+ */
+/**
+ * Classifies the nature of the employment relationship.
+ *
+ * Each type has a defined set of defaults for compensation, IMSS,
+ * stamping mode, and schedule. See EMPLOYMENT_TYPE_DEFAULTS.
+ */
+export declare enum EmploymentType {
+    payroll = "payroll",
+    payroll_draft = "payroll_draft",
+    intern = "intern",
+    hourly_agreed = "hourly_agreed",
+    casual = "casual",
+    contractor = "contractor",
+    coverage_only = "coverage_only"
+}
+export declare const EMPLOYMENT_TYPE_LABELS: Record<EmploymentType, string>;
+/**
+ * How the collaborator is compensated.
+ */
+export declare enum CompensationType {
+    salary = "salary",
+    hourly = "hourly",
+    per_service = "per_service",
+    none = "none"
+}
+export declare const COMPENSATION_TYPE_LABELS: Record<CompensationType, string>;
+/**
+ * How the CFDI nómina is stamped for this employment.
+ *
+ * - ordinary: Full CFDI with real income (PAYROLL type)
+ * - nominal: CFDI with minimum wage for IMSS purposes (CASUAL, COVERAGE_ONLY)
+ * - none: No CFDI stamping (PAYROLL_DRAFT, INTERN, CONTRACTOR)
+ */
+export declare enum PayrollStampingMode {
+    ordinary = "ordinary",
+    nominal = "nominal",
+    none = "none"
+}
+export declare const PAYROLL_STAMPING_MODE_LABELS: Record<PayrollStampingMode, string>;
+/**
+ * What kind of schedule the employment follows.
+ *
+ * Also determines shift coverage: FIXED schedule = covers shifts.
+ */
+export declare enum ScheduleType {
+    fixed = "fixed",
+    flexible = "flexible",
+    on_demand = "on_demand",
+    none = "none"
+}
+export declare const SCHEDULE_TYPE_LABELS: Record<ScheduleType, string>;
+/**
+ * Source of attendance tracking for this employment.
+ *
+ * Replaces backend-only HRAttendanceSource enum.
+ */
+export declare enum AttendanceSource {
+    attendance_records = "attendance_records",
+    activity_register = "activity_register",
+    none = "none"
+}
+export declare const ATTENDANCE_SOURCE_LABELS: Record<AttendanceSource, string>;
+/**
+ * Default field values when creating a new Employment by type.
+ *
+ * These are pre-filled in the form and can be overridden by the user.
+ */
+export interface EmploymentTypeDefaults {
+    compensationType: CompensationType;
+    hasCommissions: boolean;
+    hasImss: boolean;
+    payrollStampingMode: PayrollStampingMode;
+    scheduleType: ScheduleType;
+    maxWeeklyHours: number;
+    attendanceSource: AttendanceSource;
+}
+export declare const EMPLOYMENT_TYPE_DEFAULTS: Record<EmploymentType, EmploymentTypeDefaults>;

package/dist/constants/employment.enums.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Employment Enums — HR Model Restructuring (GH10)
+ *
+ * New enums for the restructured Employment model.
+ * All enums follow the new standard: snake_case values + LABELS objects.
+ *
+ * @see .claude/rules/enums.md for conventions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMPLOYMENT_TYPE_DEFAULTS = exports.ATTENDANCE_SOURCE_LABELS = exports.AttendanceSource = exports.SCHEDULE_TYPE_LABELS = exports.ScheduleType = exports.PAYROLL_STAMPING_MODE_LABELS = exports.PayrollStampingMode = exports.COMPENSATION_TYPE_LABELS = exports.CompensationType = exports.EMPLOYMENT_TYPE_LABELS = exports.EmploymentType = void 0;
+// ─── Employment Type ─────────────────────────────────────────────────────────
+/**
+ * Classifies the nature of the employment relationship.
+ *
+ * Each type has a defined set of defaults for compensation, IMSS,
+ * stamping mode, and schedule. See EMPLOYMENT_TYPE_DEFAULTS.
+ */
+var EmploymentType;
+(function (EmploymentType) {
+    EmploymentType["payroll"] = "payroll";
+    EmploymentType["payroll_draft"] = "payroll_draft";
+    EmploymentType["intern"] = "intern";
+    EmploymentType["hourly_agreed"] = "hourly_agreed";
+    EmploymentType["casual"] = "casual";
+    EmploymentType["contractor"] = "contractor";
+    EmploymentType["coverage_only"] = "coverage_only";
+})(EmploymentType || (exports.EmploymentType = EmploymentType = {}));
+exports.EMPLOYMENT_TYPE_LABELS = {
+    [EmploymentType.payroll]: "Nómina",
+    [EmploymentType.payroll_draft]: "Nómina simplificada",
+    [EmploymentType.intern]: "Practicante",
+    [EmploymentType.hourly_agreed]: "Horas convenidas",
+    [EmploymentType.casual]: "Eventual",
+    [EmploymentType.contractor]: "Contratista",
+    [EmploymentType.coverage_only]: "Solo cobertura",
+};
+// ─── Compensation Type ───────────────────────────────────────────────────────
+/**
+ * How the collaborator is compensated.
+ */
+var CompensationType;
+(function (CompensationType) {
+    CompensationType["salary"] = "salary";
+    CompensationType["hourly"] = "hourly";
+    CompensationType["per_service"] = "per_service";
+    CompensationType["none"] = "none";
+})(CompensationType || (exports.CompensationType = CompensationType = {}));
+exports.COMPENSATION_TYPE_LABELS = {
+    [CompensationType.salary]: "Salario",
+    [CompensationType.hourly]: "Por hora",
+    [CompensationType.per_service]: "Por servicio",
+    [CompensationType.none]: "Sin compensación",
+};
+// ─── Payroll Stamping Mode ───────────────────────────────────────────────────
+/**
+ * How the CFDI nómina is stamped for this employment.
+ *
+ * - ordinary: Full CFDI with real income (PAYROLL type)
+ * - nominal: CFDI with minimum wage for IMSS purposes (CASUAL, COVERAGE_ONLY)
+ * - none: No CFDI stamping (PAYROLL_DRAFT, INTERN, CONTRACTOR)
+ */
+var PayrollStampingMode;
+(function (PayrollStampingMode) {
+    PayrollStampingMode["ordinary"] = "ordinary";
+    PayrollStampingMode["nominal"] = "nominal";
+    PayrollStampingMode["none"] = "none";
+})(PayrollStampingMode || (exports.PayrollStampingMode = PayrollStampingMode = {}));
+exports.PAYROLL_STAMPING_MODE_LABELS = {
+    [PayrollStampingMode.ordinary]: "Ordinario",
+    [PayrollStampingMode.nominal]: "Nominal",
+    [PayrollStampingMode.none]: "Sin timbrado",
+};
+// ─── Schedule Type ───────────────────────────────────────────────────────────
+/**
+ * What kind of schedule the employment follows.
+ *
+ * Also determines shift coverage: FIXED schedule = covers shifts.
+ */
+var ScheduleType;
+(function (ScheduleType) {
+    ScheduleType["fixed"] = "fixed";
+    ScheduleType["flexible"] = "flexible";
+    ScheduleType["on_demand"] = "on_demand";
+    ScheduleType["none"] = "none";
+})(ScheduleType || (exports.ScheduleType = ScheduleType = {}));
+exports.SCHEDULE_TYPE_LABELS = {
+    [ScheduleType.fixed]: "Fijo",
+    [ScheduleType.flexible]: "Flexible",
+    [ScheduleType.on_demand]: "Bajo demanda",
+    [ScheduleType.none]: "Sin horario",
+};
+// ─── Attendance Source ────────────────────────────────────────────────────────
+/**
+ * Source of attendance tracking for this employment.
+ *
+ * Replaces backend-only HRAttendanceSource enum.
+ */
+var AttendanceSource;
+(function (AttendanceSource) {
+    AttendanceSource["attendance_records"] = "attendance_records";
+    AttendanceSource["activity_register"] = "activity_register";
+    AttendanceSource["none"] = "none";
+})(AttendanceSource || (exports.AttendanceSource = AttendanceSource = {}));
+exports.ATTENDANCE_SOURCE_LABELS = {
+    [AttendanceSource.attendance_records]: "Registro de asistencia",
+    [AttendanceSource.activity_register]: "Registro de actividades",
+    [AttendanceSource.none]: "Sin registro",
+};
+exports.EMPLOYMENT_TYPE_DEFAULTS = {
+    [EmploymentType.payroll]: {
+        compensationType: CompensationType.salary,
+        hasCommissions: true,
+        hasImss: true,
+        payrollStampingMode: PayrollStampingMode.ordinary,
+        scheduleType: ScheduleType.fixed,
+        maxWeeklyHours: 48,
+        attendanceSource: AttendanceSource.attendance_records,
+    },
+    [EmploymentType.payroll_draft]: {
+        compensationType: CompensationType.salary,
+        hasCommissions: true,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.none,
+        scheduleType: ScheduleType.fixed,
+        maxWeeklyHours: 48,
+        attendanceSource: AttendanceSource.attendance_records,
+    },
+    [EmploymentType.intern]: {
+        compensationType: CompensationType.hourly,
+        hasCommissions: true,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.none,
+        scheduleType: ScheduleType.fixed,
+        maxWeeklyHours: 36,
+        attendanceSource: AttendanceSource.activity_register,
+    },
+    [EmploymentType.hourly_agreed]: {
+        compensationType: CompensationType.hourly,
+        hasCommissions: true,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.none,
+        scheduleType: ScheduleType.fixed,
+        maxWeeklyHours: 48,
+        attendanceSource: AttendanceSource.attendance_records,
+    },
+    [EmploymentType.casual]: {
+        compensationType: CompensationType.hourly,
+        hasCommissions: true,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.nominal,
+        scheduleType: ScheduleType.none,
+        maxWeeklyHours: 48,
+        attendanceSource: AttendanceSource.activity_register,
+    },
+    [EmploymentType.contractor]: {
+        compensationType: CompensationType.none,
+        hasCommissions: true,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.none,
+        scheduleType: ScheduleType.none,
+        maxWeeklyHours: 48,
+        attendanceSource: AttendanceSource.none,
+    },
+    [EmploymentType.coverage_only]: {
+        compensationType: CompensationType.none,
+        hasCommissions: false,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.nominal,
+        scheduleType: ScheduleType.none,
+        maxWeeklyHours: 48,
+        attendanceSource: AttendanceSource.none,
+    },
+};

package/dist/constants/index.d.ts

@@ -14,4 +14,7 @@ export * from './job-category.constants';
 export * from './special-collaborators.constants';
 export * from './commissions.constants';
 export * from './hr.enums';
+export * from './employment.enums';
 export * from './qvet-cash-flow.enums';
+export * from './time-off.enums';
+export * from './time-off.constants';

package/dist/constants/index.js

@@ -30,4 +30,7 @@ __exportStar(require("./job-category.constants"), exports);
 __exportStar(require("./special-collaborators.constants"), exports);
 __exportStar(require("./commissions.constants"), exports);
 __exportStar(require("./hr.enums"), exports);
+__exportStar(require("./employment.enums"), exports);
 __exportStar(require("./qvet-cash-flow.enums"), exports);
+__exportStar(require("./time-off.enums"), exports);
+__exportStar(require("./time-off.constants"), exports);

package/dist/constants/time-off.constants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Time-Off Constants
+ *
+ * Mexican labor law vacation tables and related constants.
+ */
+import { TimeOffType } from './time-off.enums';
+/**
+ * Legal vacation days per anniversary year (Mexican Federal Labor Law, Art. 76).
+ *
+ * - `old`: Pre-2023 reform (Ley Federal del Trabajo original)
+ * - `new`: Post-2022 reform (effective Jan 1, 2023 — doubled minimums)
+ *
+ * Index = years of service (0 = year of hire, 1 = first anniversary, etc.)
+ * Values for ranges (e.g., years 5-9) are repeated for each year in range.
+ */
+export declare const LEGAL_VACATIONS: {
+    readonly old: readonly [0, 6, 8, 10, 12, 14, 14, 14, 14, 14, 16, 16, 16, 16, 16, 18, 18, 18, 18, 18, 20, 20, 20, 20, 20, 22, 22, 22, 22, 22, 24];
+    readonly new: readonly [0, 12, 14, 16, 18, 20, 22, 22, 22, 22, 22, 24, 24, 24, 24, 26, 26, 26, 26, 26, 28, 28, 28, 28, 28, 30, 30, 30, 30, 30, 30];
+};
+/**
+ * TimeOffTypes that consume vacation balance.
+ * Only these types count against a collaborator's vacation days.
+ */
+export declare const VACATION_CONSUMING_TYPES: readonly TimeOffType[];

package/dist/constants/time-off.constants.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Time-Off Constants
+ *
+ * Mexican labor law vacation tables and related constants.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VACATION_CONSUMING_TYPES = exports.LEGAL_VACATIONS = void 0;
+const time_off_enums_1 = require("./time-off.enums");
+/**
+ * Legal vacation days per anniversary year (Mexican Federal Labor Law, Art. 76).
+ *
+ * - `old`: Pre-2023 reform (Ley Federal del Trabajo original)
+ * - `new`: Post-2022 reform (effective Jan 1, 2023 — doubled minimums)
+ *
+ * Index = years of service (0 = year of hire, 1 = first anniversary, etc.)
+ * Values for ranges (e.g., years 5-9) are repeated for each year in range.
+ */
+exports.LEGAL_VACATIONS = {
+    old: [
+        0, // 0 years
+        6, // 1
+        8, // 2
+        10, // 3
+        12, // 4
+        14, // 5
+        14, // 6
+        14, // 7
+        14, // 8
+        14, // 9
+        16, // 10
+        16, // 11
+        16, // 12
+        16, // 13
+        16, // 14
+        18, // 15
+        18, // 16
+        18, // 17
+        18, // 18
+        18, // 19
+        20, // 20
+        20, // 21
+        20, // 22
+        20, // 23
+        20, // 24
+        22, // 25
+        22, // 26
+        22, // 27
+        22, // 28
+        22, // 29
+        24, // 30
+    ],
+    new: [
+        0, // 0 years
+        12, // 1
+        14, // 2
+        16, // 3
+        18, // 4
+        20, // 5
+        22, // 6
+        22, // 7
+        22, // 8
+        22, // 9
+        22, // 10
+        24, // 11
+        24, // 12
+        24, // 13
+        24, // 14
+        26, // 15
+        26, // 16
+        26, // 17
+        26, // 18
+        26, // 19
+        28, // 20
+        28, // 21
+        28, // 22
+        28, // 23
+        28, // 24
+        30, // 25
+        30,
+        30,
+        30,
+        30,
+        30,
+    ],
+};
+/**
+ * TimeOffTypes that consume vacation balance.
+ * Only these types count against a collaborator's vacation days.
+ */
+exports.VACATION_CONSUMING_TYPES = [
+    time_off_enums_1.TimeOffType.Vacation,
+    time_off_enums_1.TimeOffType.PersonalLeave,
+];

package/dist/constants/time-off.enums.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Time-Off Request Enums
+ *
+ * Single source of truth for time-off request statuses and types.
+ * Used by both backend and frontend.
+ */
+export declare enum TimeOffStatus {
+    Pending = "Pending",
+    Approved = "Approved",
+    Rejected = "Rejected",
+    Canceled = "Canceled"
+}
+export declare enum TimeOffType {
+    Vacation = "Vacation",
+    PersonalLeave = "Asuntos propios",
+    SickLeaveIMSS = "Incapacidad por IMSS",
+    ShiftToBeCompensated = "Jornada a reponer",
+    JustifiedAbsenceByCompany = "Inasistencia justificada por la empresa",
+    AuthorizedUnjustifiedAbsence = "Falta injustificada autorizada",
+    EarlyLeavePermission = "Permiso de salida anticipada",
+    LatePermission = "Permiso de llegar tarde",
+    CompensationShift = "Reposici\u00F3n de jornada"
+}
+/** Spanish display labels for TimeOffType */
+export declare const TIME_OFF_TYPE_LABELS: Record<TimeOffType, string>;
+/** Spanish display labels for TimeOffStatus */
+export declare const TIME_OFF_STATUS_LABELS: Record<TimeOffStatus, string>;

package/dist/constants/time-off.enums.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Time-Off Request Enums
+ *
+ * Single source of truth for time-off request statuses and types.
+ * Used by both backend and frontend.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIME_OFF_STATUS_LABELS = exports.TIME_OFF_TYPE_LABELS = exports.TimeOffType = exports.TimeOffStatus = void 0;
+var TimeOffStatus;
+(function (TimeOffStatus) {
+    TimeOffStatus["Pending"] = "Pending";
+    TimeOffStatus["Approved"] = "Approved";
+    TimeOffStatus["Rejected"] = "Rejected";
+    TimeOffStatus["Canceled"] = "Canceled";
+})(TimeOffStatus || (exports.TimeOffStatus = TimeOffStatus = {}));
+var TimeOffType;
+(function (TimeOffType) {
+    TimeOffType["Vacation"] = "Vacation";
+    TimeOffType["PersonalLeave"] = "Asuntos propios";
+    TimeOffType["SickLeaveIMSS"] = "Incapacidad por IMSS";
+    TimeOffType["ShiftToBeCompensated"] = "Jornada a reponer";
+    TimeOffType["JustifiedAbsenceByCompany"] = "Inasistencia justificada por la empresa";
+    TimeOffType["AuthorizedUnjustifiedAbsence"] = "Falta injustificada autorizada";
+    TimeOffType["EarlyLeavePermission"] = "Permiso de salida anticipada";
+    TimeOffType["LatePermission"] = "Permiso de llegar tarde";
+    TimeOffType["CompensationShift"] = "Reposici\u00F3n de jornada";
+})(TimeOffType || (exports.TimeOffType = TimeOffType = {}));
+/** Spanish display labels for TimeOffType */
+exports.TIME_OFF_TYPE_LABELS = {
+    [TimeOffType.Vacation]: 'Vacaciones',
+    [TimeOffType.PersonalLeave]: 'Asuntos propios',
+    [TimeOffType.SickLeaveIMSS]: 'Incapacidad por IMSS',
+    [TimeOffType.ShiftToBeCompensated]: 'Jornada a reponer',
+    [TimeOffType.JustifiedAbsenceByCompany]: 'Inasistencia justificada por la empresa',
+    [TimeOffType.AuthorizedUnjustifiedAbsence]: 'Falta injustificada autorizada',
+    [TimeOffType.EarlyLeavePermission]: 'Permiso de salida anticipada',
+    [TimeOffType.LatePermission]: 'Permiso de llegar tarde',
+    [TimeOffType.CompensationShift]: 'Reposición de jornada',
+};
+/** Spanish display labels for TimeOffStatus */
+exports.TIME_OFF_STATUS_LABELS = {
+    [TimeOffStatus.Pending]: 'Pendiente',
+    [TimeOffStatus.Approved]: 'Aprobada',
+    [TimeOffStatus.Rejected]: 'Rechazada',
+    [TimeOffStatus.Canceled]: 'Cancelada',
+};

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

@@ -0,0 +1,6 @@
+/**
+ * Employment API Contracts
+ * Request and Response types for Employment endpoints
+ */
+export * from './responses';
+export * from './requests';

package/dist/contracts/employment/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Employment API Contracts
+ * Request and Response types for Employment endpoints
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./responses"), exports);
+__exportStar(require("./requests"), exports);

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

@@ -0,0 +1,95 @@
+import { EmploymentType, CompensationType, PayrollStampingMode, ScheduleType, AttendanceSource } from '../../constants/employment.enums';
+/**
+ * Create Employment Request
+ *
+ * Data required to create a new employment record.
+ * Used by admin/manager roles.
+ *
+ * @example POST /api/employments
+ */
+export interface CreateEmploymentRequest {
+    collaboratorId: string;
+    jobId: string;
+    isActive: boolean;
+    employmentType: EmploymentType;
+    compensationType: CompensationType;
+    hasCommissions: boolean;
+    hasImss: boolean;
+    payrollStampingMode: PayrollStampingMode;
+    scheduleType: ScheduleType;
+    attendanceSource: AttendanceSource;
+    employmentStartDate: string;
+    employmentEndDate?: string;
+    weeklyHours?: number;
+    maxWeeklyHours?: number;
+    seniorityBonusPercentage?: number;
+    commissionBonusPercentage?: number;
+    additionalFixedIncomes?: Array<{
+        concept: string;
+        amount: number;
+    }>;
+    otherDeductions?: Array<{
+        concept: string;
+        amount: number;
+    }>;
+    contributionBaseSalary?: number;
+    journeyType?: string;
+    cfdiPaymentFrequency?: string;
+    trainingSupport?: number;
+    physicalActivitySupport?: number;
+}
+/**
+ * Update Employment Request
+ *
+ * Partial data to update an existing employment.
+ * All fields optional — only provided fields are updated.
+ * Computed fields (totalFixedIncome, etc.) are recalculated automatically.
+ *
+ * @example PATCH /api/employments/:id
+ */
+export interface UpdateEmploymentRequest {
+    jobId?: string;
+    isActive?: boolean;
+    employmentType?: EmploymentType;
+    compensationType?: CompensationType;
+    hasCommissions?: boolean;
+    hasImss?: boolean;
+    payrollStampingMode?: PayrollStampingMode;
+    scheduleType?: ScheduleType;
+    attendanceSource?: AttendanceSource;
+    employmentStartDate?: string;
+    employmentEndDate?: string;
+    weeklyHours?: number;
+    maxWeeklyHours?: number;
+    seniorityBonusPercentage?: number;
+    commissionBonusPercentage?: number;
+    additionalFixedIncomes?: Array<{
+        concept: string;
+        amount: number;
+    }>;
+    otherDeductions?: Array<{
+        concept: string;
+        amount: number;
+    }>;
+    contributionBaseSalary?: number;
+    journeyType?: string;
+    cfdiPaymentFrequency?: string;
+    trainingSupport?: number;
+    physicalActivitySupport?: number;
+}
+/**
+ * Employment Query Filters
+ *
+ * Query parameters for filtering the employments list.
+ *
+ * @example GET /api/employments?isActive=true&employmentType=payroll
+ */
+export interface EmploymentQueryFilters {
+    isActive?: boolean;
+    collaboratorId?: string;
+    jobId?: string;
+    employmentType?: EmploymentType;
+    compensationType?: CompensationType;
+    scheduleType?: ScheduleType;
+    hasImss?: boolean;
+}

package/dist/contracts/employment/requests.js

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

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

@@ -0,0 +1,86 @@
+import { EmploymentType, CompensationType, PayrollStampingMode, ScheduleType, AttendanceSource } from '../../constants/employment.enums';
+/**
+ * Public Employment Response
+ *
+ * Minimal employment data for non-sensitive contexts.
+ * Used for: Scheduling views, shift coverage checks, team displays.
+ *
+ * @example GET /api/employments/:id (authenticated)
+ */
+export interface PublicEmploymentResponse {
+    id: string;
+    collaboratorId: string;
+    jobId: string;
+    isActive: boolean;
+    employmentType: EmploymentType;
+    scheduleType: ScheduleType;
+    employmentStartDate?: string;
+    employmentEndDate?: string;
+}
+/**
+ * Employment View Response
+ *
+ * Extended employment data for collaborators and managers.
+ * Includes work configuration but excludes payroll-sensitive computed values.
+ *
+ * Used for: Employment list, employment detail view, attendance config.
+ *
+ * @example GET /api/employments/:id (collaborator/manager)
+ */
+export interface EmploymentViewResponse extends PublicEmploymentResponse {
+    compensationType: CompensationType;
+    attendanceSource: AttendanceSource;
+    hasCommissions: boolean;
+    hasImss: boolean;
+    payrollStampingMode: PayrollStampingMode;
+    weeklyHours?: number;
+    maxWeeklyHours: number;
+    seniorityBonusPercentage?: number;
+    commissionBonusPercentage?: number;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/**
+ * Admin Employment Response
+ *
+ * Complete employment data including all computed payroll values.
+ * Only for admin/manager users performing payroll or HR operations.
+ *
+ * Used for: Payroll management, employment editing, income calculations, CFDI.
+ *
+ * @example GET /api/employments/:id (admin)
+ */
+export interface AdminEmploymentResponse extends EmploymentViewResponse {
+    dailyWorkingHours?: number;
+    workWeekRatio?: number;
+    employmentFixedIncomeByJob?: number;
+    totalFixedIncome?: number;
+    employmentGuaranteedIncome?: number;
+    nominalDailyFixedIncome?: number;
+    nominalHourlyFixedIncome?: number;
+    effectiveDailyFixedIncome?: number;
+    effectiveHourlyFixedIncome?: number;
+    employmentHourlyRate?: number;
+    integratedDailySalary?: number;
+    contributionBaseSalary?: number;
+    journeyType?: string;
+    cfdiPaymentFrequency?: string;
+    additionalFixedIncomes?: Array<{
+        concept: string;
+        amount: number;
+    }>;
+    otherDeductions?: Array<{
+        concept: string;
+        amount: number;
+    }>;
+    averageCommissionsPerScheduledHour?: number;
+    averageOrdinaryIncomePerScheduledHour?: number;
+    trainingSupport?: number;
+    physicalActivitySupport?: number;
+    createdBy?: string;
+    updatedBy?: string;
+}
+/**
+ * Union type for all employment response types
+ */
+export type EmploymentResponse = PublicEmploymentResponse | EmploymentViewResponse | AdminEmploymentResponse;

package/dist/contracts/employment/responses.js

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

package/dist/contracts/index.d.ts

@@ -3,8 +3,10 @@
  * Request and Response types for all API endpoints
  */
 export * from './collaborator';
+export * from './employment';
 export * from './catalog-item';
 export * from './order-planning';
 export * from './qvet';
 export * from './stock-calculation';
 export * from './cash-reconciliation';
+export * from './time-off-request';

package/dist/contracts/index.js

@@ -19,8 +19,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./collaborator"), exports);
+__exportStar(require("./employment"), exports);
 __exportStar(require("./catalog-item"), exports);
 __exportStar(require("./order-planning"), exports);
 __exportStar(require("./qvet"), exports);
 __exportStar(require("./stock-calculation"), exports);
 __exportStar(require("./cash-reconciliation"), exports);
+__exportStar(require("./time-off-request"), exports);

package/dist/contracts/time-off-request/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Time-Off Request API Contracts
+ * Request and Response types for Time-Off Request endpoints
+ */
+export * from './responses';
+export * from './requests';

package/dist/contracts/time-off-request/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Time-Off Request API Contracts
+ * Request and Response types for Time-Off Request endpoints
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./responses"), exports);
+__exportStar(require("./requests"), exports);

package/dist/contracts/time-off-request/requests.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Time-Off Request Request Types
+ *
+ * API request contracts for time-off request endpoints.
+ *
+ * @example POST /api/time-off-requests
+ * @example PATCH /api/time-off-requests/:id
+ */
+import { TimeOffStatus, TimeOffType } from '../../constants/time-off.enums';
+/**
+ * Create Time-Off Request
+ *
+ * Used for: Submitting a new time-off request.
+ *
+ * @example POST /api/time-off-requests
+ */
+export interface CreateTimeOffRequestRequest {
+    collaborator: string;
+    requestedDays: string[];
+    timeOffType: TimeOffType;
+    collaboratorNote?: string;
+    /** Optional: admin-created requests can set status directly */
+    status?: TimeOffStatus;
+    approvedAt?: string;
+    approvedBy?: string;
+}
+/**
+ * Update Time-Off Request
+ *
+ * Used for: Modifying an existing time-off request (approval, notes, etc.)
+ *
+ * @example PATCH /api/time-off-requests/:id
+ */
+export interface UpdateTimeOffRequestRequest {
+    status?: TimeOffStatus;
+    managerNote?: string;
+    requestedDays?: string[];
+    timeOffType?: TimeOffType;
+    collaboratorNote?: string;
+    approvedAt?: string;
+    approvedBy?: string;
+}

package/dist/contracts/time-off-request/requests.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Time-Off Request Request Types
+ *
+ * API request contracts for time-off request endpoints.
+ *
+ * @example POST /api/time-off-requests
+ * @example PATCH /api/time-off-requests/:id
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/time-off-request/responses.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Time-Off Request Response Types
+ *
+ * API response contracts for time-off request endpoints.
+ *
+ * @example GET /api/time-off-requests
+ * @example GET /api/time-off-requests/collaborators/time-off-overview/:id
+ */
+import { TimeOffStatus, TimeOffType } from '../../constants/time-off.enums';
+/**
+ * Annual vacation period breakdown.
+ *
+ * Each period represents one anniversary year, showing how many days
+ * were earned, taken, and the running accumulated balance.
+ *
+ * Used in: CollaboratorTimeOffOverviewResponse.vacationPeriods
+ */
+export interface VacationPeriodResponse {
+    /** Period start (anniversary date or hire date for first period) */
+    startDate: string;
+    /** Period end (next anniversary or current date for incomplete period) */
+    endDate: string;
+    /** Days earned by law at this anniversary (0 for current incomplete period) */
+    legalVacationDays: number;
+    /** Company-given extra days (2/year from 2025) */
+    extraVacationDays: number;
+    /** Pro-rated days for current incomplete period */
+    provisionalVacationDays: number;
+    /** legalVacationDays + extraVacationDays + provisionalVacationDays */
+    totalVacationDays: number;
+    /** Days taken (approved + pending) in this period */
+    vacationDaysTaken: number;
+    /** totalVacationDays - vacationDaysTaken */
+    periodBalance: number;
+    /** Running total balance across all periods up to this one */
+    accumulatedBalance: number;
+}
+/**
+ * Collaborator Time-Off Overview
+ *
+ * Complete vacation summary for a single collaborator, including
+ * annual period breakdown.
+ *
+ * Used for: User profile vacation info, admin vacation dashboard.
+ *
+ * @example GET /api/time-off-requests/collaborators/time-off-overview/:id
+ */
+export interface CollaboratorTimeOffOverviewResponse {
+    collaboratorId: string;
+    lastAnniversaryDate: string;
+    totalVacationDays: number;
+    legalVacationDays: number;
+    /** Count of approved vacation dates */
+    vacationDaysTaken: number;
+    /** Count of pending vacation dates */
+    vacationDaysRequested: number;
+    remainingVacationDays: number;
+    remainingLegalVacationDays: number;
+    remainingCurrentYearVacationDays: number;
+    /** Annual breakdown of vacation accrual and usage */
+    vacationPeriods: VacationPeriodResponse[];
+    dateTimeOffRequests: DateTimeOffRequestResponse[];
+}
+/**
+ * Individual date within a time-off request.
+ *
+ * Flattened view: one entry per date per request.
+ */
+export interface DateTimeOffRequestResponse {
+    date: string;
+    id: string;
+    timeOffType: TimeOffType;
+    status: TimeOffStatus;
+    collaborator: string;
+}
+/**
+ * Time-Off Request Item
+ *
+ * Single time-off request as returned by list/detail endpoints.
+ *
+ * @example GET /api/time-off-requests
+ * @example GET /api/time-off-requests/:id
+ */
+export interface TimeOffRequestItemResponse {
+    id: string;
+    collaborator: string;
+    requestedAt: string;
+    requestedDays: string[];
+    timeOffType: TimeOffType;
+    status: TimeOffStatus;
+    collaboratorNote?: string;
+    managerNote?: string;
+    approvedAt?: string;
+    approvedBy?: string;
+    createdAt: string;
+    createdBy?: string;
+    updatedAt: string;
+    updatedBy?: string;
+}

package/dist/contracts/time-off-request/responses.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Time-Off Request Response Types
+ *
+ * API response contracts for time-off request endpoints.
+ *
+ * @example GET /api/time-off-requests
+ * @example GET /api/time-off-requests/collaborators/time-off-overview/:id
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

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