hvp-shared 6.52.0 → 6.53.1

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,84 @@
+/**
+ * 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;
+    attendanceSource: AttendanceSource;
+}
+export declare const EMPLOYMENT_TYPE_DEFAULTS: Record<EmploymentType, EmploymentTypeDefaults>;

package/dist/constants/employment.enums.js

@@ -0,0 +1,167 @@
+"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,
+        attendanceSource: AttendanceSource.attendance_records,
+    },
+    [EmploymentType.payroll_draft]: {
+        compensationType: CompensationType.salary,
+        hasCommissions: true,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.none,
+        scheduleType: ScheduleType.fixed,
+        attendanceSource: AttendanceSource.attendance_records,
+    },
+    [EmploymentType.intern]: {
+        compensationType: CompensationType.hourly,
+        hasCommissions: true,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.none,
+        scheduleType: ScheduleType.fixed,
+        attendanceSource: AttendanceSource.activity_register,
+    },
+    [EmploymentType.hourly_agreed]: {
+        compensationType: CompensationType.hourly,
+        hasCommissions: true,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.none,
+        scheduleType: ScheduleType.fixed,
+        attendanceSource: AttendanceSource.attendance_records,
+    },
+    [EmploymentType.casual]: {
+        compensationType: CompensationType.hourly,
+        hasCommissions: true,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.nominal,
+        scheduleType: ScheduleType.none,
+        attendanceSource: AttendanceSource.activity_register,
+    },
+    [EmploymentType.contractor]: {
+        compensationType: CompensationType.none,
+        hasCommissions: true,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.none,
+        scheduleType: ScheduleType.none,
+        attendanceSource: AttendanceSource.none,
+    },
+    [EmploymentType.coverage_only]: {
+        compensationType: CompensationType.none,
+        hasCommissions: false,
+        hasImss: false,
+        payrollStampingMode: PayrollStampingMode.nominal,
+        scheduleType: ScheduleType.none,
+        attendanceSource: AttendanceSource.none,
+    },
+};

package/dist/constants/index.d.ts

@@ -14,6 +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,6 +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/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,93 @@
+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;
+    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;
+    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,85 @@
+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;
+    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,6 +3,7 @@
  * 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';

package/dist/contracts/index.js

@@ -19,6 +19,7 @@ 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);

package/package.json

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