hvp-shared 6.43.0 → 6.44.0

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/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.43.0",
+  "version": "6.44.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",