hvp-shared 6.51.0 → 6.52.0

package/dist/constants/index.d.ts

@@ -15,3 +15,5 @@ export * from './special-collaborators.constants';
 export * from './commissions.constants';
 export * from './hr.enums';
 export * from './qvet-cash-flow.enums';
+export * from './time-off.enums';
+export * from './time-off.constants';

package/dist/constants/index.js

@@ -31,3 +31,5 @@ __exportStar(require("./special-collaborators.constants"), exports);
 __exportStar(require("./commissions.constants"), exports);
 __exportStar(require("./hr.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/index.d.ts

@@ -8,3 +8,4 @@ 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

@@ -24,3 +24,4 @@ __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.52.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",