hvp-shared 6.42.0 → 6.44.0

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

@@ -0,0 +1,25 @@
+/**
+ * HR Enums — shared across backend and frontend.
+ *
+ * These enums were previously duplicated in both repos.
+ * Single source of truth lives here in hvp-shared.
+ */
+export declare enum PayrollStatus {
+    Pending = "pending",
+    Approved = "approved",
+    Paid = "paid",
+    Billed = "billed"
+}
+export declare enum CfdiStatus {
+    Pending = "pending",
+    Ready = "ready",
+    Stamped = "stamped",
+    StampedExternal = "stamped_external",
+    Cancelled = "cancelled",
+    Error = "error"
+}
+export declare enum HRPaymentType {
+    HOURLY = "HOURLY",
+    SALARY = "SALARY",
+    INFORMAL = "INFORMAL"
+}

package/dist/constants/hr.enums.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * HR Enums — shared across backend and frontend.
+ *
+ * These enums were previously duplicated in both repos.
+ * Single source of truth lives here in hvp-shared.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HRPaymentType = exports.CfdiStatus = exports.PayrollStatus = void 0;
+var PayrollStatus;
+(function (PayrollStatus) {
+    PayrollStatus["Pending"] = "pending";
+    PayrollStatus["Approved"] = "approved";
+    PayrollStatus["Paid"] = "paid";
+    PayrollStatus["Billed"] = "billed";
+})(PayrollStatus || (exports.PayrollStatus = PayrollStatus = {}));
+var CfdiStatus;
+(function (CfdiStatus) {
+    CfdiStatus["Pending"] = "pending";
+    CfdiStatus["Ready"] = "ready";
+    CfdiStatus["Stamped"] = "stamped";
+    CfdiStatus["StampedExternal"] = "stamped_external";
+    CfdiStatus["Cancelled"] = "cancelled";
+    CfdiStatus["Error"] = "error";
+})(CfdiStatus || (exports.CfdiStatus = CfdiStatus = {}));
+var HRPaymentType;
+(function (HRPaymentType) {
+    HRPaymentType["HOURLY"] = "HOURLY";
+    HRPaymentType["SALARY"] = "SALARY";
+    HRPaymentType["INFORMAL"] = "INFORMAL";
+})(HRPaymentType || (exports.HRPaymentType = HRPaymentType = {}));

package/dist/constants/index.d.ts

@@ -14,3 +14,4 @@ export * from './background-job.constants';
 export * from './job-category.constants';
 export * from './special-collaborators.constants';
 export * from './commissions.constants';
+export * from './hr.enums';

package/dist/constants/index.js

@@ -30,3 +30,4 @@ __exportStar(require("./background-job.constants"), exports);
 __exportStar(require("./job-category.constants"), exports);
 __exportStar(require("./special-collaborators.constants"), exports);
 __exportStar(require("./commissions.constants"), exports);
+__exportStar(require("./hr.enums"), exports);

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

@@ -44,6 +44,7 @@ export interface CreateCollaboratorRequest {
     dailySalary?: number;
     accessCode?: string;
     password?: string;
+    qvetAliases?: string[];
 }
 /**
  * Update Collaborator Request
@@ -88,6 +89,7 @@ export interface UpdateCollaboratorRequest {
     dailySalary?: number;
     accessCode?: string;
     password?: string;
+    qvetAliases?: string[];
 }
 /**
  * Register Collaborator Request

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

@@ -71,6 +71,7 @@ export interface AdminCollaboratorResponse extends CollaboratorViewResponse {
     baseSalary?: number;
     dailySalary?: number;
     accessCode?: string;
+    qvetAliases: string[];
     createdBy?: string;
     updatedBy?: string;
 }

package/dist/index.d.ts

@@ -9,3 +9,4 @@ export * from './validation';
 export { debugLog } from './utils/debug-logger';
 export * from './utils/sync-field.helpers';
 export * from './utils/qvet-catalog.helpers';
+export * from './utils/qvet-staff.helpers';

package/dist/index.js

@@ -27,3 +27,4 @@ var debug_logger_1 = require("./utils/debug-logger");
 Object.defineProperty(exports, "debugLog", { enumerable: true, get: function () { return debug_logger_1.debugLog; } });
 __exportStar(require("./utils/sync-field.helpers"), exports);
 __exportStar(require("./utils/qvet-catalog.helpers"), exports);
+__exportStar(require("./utils/qvet-staff.helpers"), exports);

package/dist/types/payroll-v2.types.d.ts

@@ -4,12 +4,8 @@
  * Each item is self-describing: carries SAT codes, taxed/exempt split,
  * source key for internal reference, and an optional formula explaining
  * how the amount was calculated.
- *
- * NOTE: CfdiStatus and PayrollStatus enums are NOT imported here because
- * they live in repo-specific enum files (used in 19+ files each). Instead,
- * the `status` and `payrollStatus` fields use `string`, which is compatible
- * since TypeScript string enum values ARE strings.
  */
+import { CfdiStatus, PayrollStatus } from '../constants/hr.enums';
 export declare enum PayrollItemCategory {
     BASE_SALARY = "BASE_SALARY",
     ADDITIONAL_FIXED = "ADDITIONAL_FIXED",
@@ -88,8 +84,7 @@ export interface PayrollEmployeeSnapshot {
     readonly positionRisk?: string;
 }
 export interface PayrollV2Cfdi {
-    /** CfdiStatus value — typed as string to avoid coupling to repo-specific enums */
-    readonly status: string;
+    readonly status: CfdiStatus;
     readonly uuid?: string;
     readonly facturamaId?: string;
     readonly stampedAt?: Date | string;
@@ -128,8 +123,7 @@ export interface PayrollV2 {
     readonly jobId?: string;
     readonly periodStartDate?: string;
     readonly periodEndDate?: string;
-    /** PayrollStatus value — typed as string to avoid coupling to repo-specific enums */
-    readonly payrollStatus?: string;
+    readonly payrollStatus?: PayrollStatus;
     readonly daysPaid?: number;
     readonly perceptions: PayrollItem[];
     readonly deductions: PayrollItem[];

package/dist/types/payroll-v2.types.js

@@ -5,11 +5,6 @@
  * Each item is self-describing: carries SAT codes, taxed/exempt split,
  * source key for internal reference, and an optional formula explaining
  * how the amount was calculated.
- *
- * NOTE: CfdiStatus and PayrollStatus enums are NOT imported here because
- * they live in repo-specific enum files (used in 19+ files each). Instead,
- * the `status` and `payrollStatus` fields use `string`, which is compatible
- * since TypeScript string enum values ARE strings.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PayrollItemCategory = void 0;

package/dist/utils/qvet-staff.helpers.d.ts

@@ -0,0 +1,20 @@
+/**
+ * QVET Staff Helpers
+ *
+ * Utility functions for normalizing QVET staff names for alias matching.
+ *
+ * QVET exports strip accents inconsistently (e.g., AVENDAÑO → AVENDANO or AVENDAO).
+ * This normalizer strips all diacritics so lookups work regardless of source encoding.
+ */
+/**
+ * Normalize a QVET staff name for alias matching.
+ *
+ * - Uppercase
+ * - Strip diacritics (NFD decompose + remove combining marks): ñ→N, é→E, etc.
+ * - Collapse multiple whitespace to single space
+ * - Trim leading/trailing whitespace
+ *
+ * @param name - Raw name from QVET export or user input
+ * @returns Normalized name, or empty string for null/undefined/empty
+ */
+export declare function normalizeQvetName(name: string | null | undefined): string;

package/dist/utils/qvet-staff.helpers.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * QVET Staff Helpers
+ *
+ * Utility functions for normalizing QVET staff names for alias matching.
+ *
+ * QVET exports strip accents inconsistently (e.g., AVENDAÑO → AVENDANO or AVENDAO).
+ * This normalizer strips all diacritics so lookups work regardless of source encoding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeQvetName = normalizeQvetName;
+/**
+ * Normalize a QVET staff name for alias matching.
+ *
+ * - Uppercase
+ * - Strip diacritics (NFD decompose + remove combining marks): ñ→N, é→E, etc.
+ * - Collapse multiple whitespace to single space
+ * - Trim leading/trailing whitespace
+ *
+ * @param name - Raw name from QVET export or user input
+ * @returns Normalized name, or empty string for null/undefined/empty
+ */
+function normalizeQvetName(name) {
+    if (!name)
+        return '';
+    return name
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .toUpperCase()
+        .replace(/\s+/g, ' ')
+        .trim();
+}

package/dist/utils/qvet-staff.helpers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/qvet-staff.helpers.test.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const qvet_staff_helpers_1 = require("./qvet-staff.helpers");
+describe('normalizeQvetName', () => {
+    describe('diacritic stripping', () => {
+        it('should strip ñ → N', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('AVENDAÑO')).toBe('AVENDANO');
+        });
+        it('should strip accented vowels', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('FÉLIX VELÁZQUEZ')).toBe('FELIX VELAZQUEZ');
+        });
+        it('should strip ü', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('GÜERO')).toBe('GUERO');
+        });
+        it('should handle mixed accented and non-accented chars', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('María de Lourdes Avendaño Talarico'))
+                .toBe('MARIA DE LOURDES AVENDANO TALARICO');
+        });
+    });
+    describe('uppercase', () => {
+        it('should convert lowercase to uppercase', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('felix velazquez')).toBe('FELIX VELAZQUEZ');
+        });
+        it('should convert mixed case to uppercase', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('Sara Delgado Inurreta')).toBe('SARA DELGADO INURRETA');
+        });
+    });
+    describe('whitespace handling', () => {
+        it('should collapse double spaces', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('RAFAEL  A GARCIA')).toBe('RAFAEL A GARCIA');
+        });
+        it('should collapse multiple spaces', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('RAFAEL   A.   GARCIA   LOPEZ')).toBe('RAFAEL A. GARCIA LOPEZ');
+        });
+        it('should trim leading whitespace', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('  FELIX')).toBe('FELIX');
+        });
+        it('should trim trailing whitespace', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('FELIX  ')).toBe('FELIX');
+        });
+        it('should handle tabs and newlines', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('FELIX\tVELAZQUEZ\n')).toBe('FELIX VELAZQUEZ');
+        });
+    });
+    describe('null/empty handling', () => {
+        it('should return empty string for null', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)(null)).toBe('');
+        });
+        it('should return empty string for undefined', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)(undefined)).toBe('');
+        });
+        it('should return empty string for empty string', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('')).toBe('');
+        });
+        it('should return empty string for whitespace-only string', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('   ')).toBe('');
+        });
+    });
+    describe('NFC pre-composed input', () => {
+        it('should handle NFC-composed ñ', () => {
+            // NFC: ñ as single codepoint U+00F1
+            const nfc = 'PI\u00F1A';
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)(nfc)).toBe('PINA');
+        });
+        it('should handle NFD-decomposed ñ', () => {
+            // NFD: n + combining tilde U+0303
+            const nfd = 'PIN\u0303A';
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)(nfd)).toBe('PINA');
+        });
+        it('should produce same result for NFC and NFD input', () => {
+            const nfc = 'COLMENARES PI\u00F1A';
+            const nfd = 'COLMENARES PIN\u0303A';
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)(nfc)).toBe((0, qvet_staff_helpers_1.normalizeQvetName)(nfd));
+        });
+    });
+    describe('real-world QVET names', () => {
+        it('should normalize QVET-stripped names', () => {
+            // QVET already stripped some diacritics but left others
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('KARLA NUEZ BARRERA')).toBe('KARLA NUEZ BARRERA');
+        });
+        it('should normalize names with original accents', () => {
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('Karla Sofía Núñez Barrera')).toBe('KARLA SOFIA NUNEZ BARRERA');
+        });
+        it('should handle Leonardo Méndez case (partial stripping)', () => {
+            // QVET exported as "Leonardo Guillermo Mndez Porres" (stripped é completely)
+            expect((0, qvet_staff_helpers_1.normalizeQvetName)('Leonardo Guillermo Mndez Porres'))
+                .toBe('LEONARDO GUILLERMO MNDEZ PORRES');
+        });
+    });
+});

package/package.json

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