hvp-shared 2.0.0 → 2.0.1

package/README.md

@@ -1,17 +1,17 @@
-# hvp2021-shared
+# hvp-shared
 
-Shared types, constants, and utilities for HVP2021 backend and frontend.
+Shared types, constants, and utilities for HVP backend and frontend.
 
 ## Installation
 
 ```bash
-npm install hvp2021-shared
+npm install hvp-shared
 ```
 
 ## Usage
 
 ```typescript
-import { ApiResponse, SimplePayroll, APP_NAME, UMA_2024_DAILY } from 'hvp2021-shared';
+import { ApiResponse, SimplePayroll, APP_NAME, UMA_2024_DAILY } from 'hvp-shared';
 
 const response: ApiResponse<SimplePayroll> = {
   ok: true,
@@ -22,7 +22,7 @@ const response: ApiResponse<SimplePayroll> = {
   }
 };
 
-console.log(APP_NAME); // 'HVP2021'
+console.log(APP_NAME); // 'HVP'
 ```
 
 ## Development

package/package.json

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

package/dist/validation/__tests__/address.validation.test.d.ts

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

package/dist/validation/__tests__/address.validation.test.js

@@ -1,143 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const address_validation_1 = require("../address.validation");
-describe('validateAddress', () => {
-    const validAddress = {
-        street: 'Calle 10',
-        exteriorNumber: '123',
-        interiorNumber: 'A',
-        neighborhood: 'Centro',
-        city: 'Mérida',
-        state: 'YUC',
-        postalCode: '97000',
-        country: 'México'
-    };
-    describe('valid addresses', () => {
-        it('should accept valid complete address', () => {
-            const result = (0, address_validation_1.validateAddress)(validAddress);
-            expect(result.isValid).toBe(true);
-            expect(result.error).toBeUndefined();
-        });
-        it('should accept address without interior number', () => {
-            const { interiorNumber, ...addressWithoutInterior } = validAddress;
-            const result = (0, address_validation_1.validateAddress)(addressWithoutInterior);
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept country "Mexico" without accent', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, country: 'Mexico' });
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept country in uppercase', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, country: 'MÉXICO' });
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept address with whitespace (trimmed)', () => {
-            const result = (0, address_validation_1.validateAddress)({
-                ...validAddress,
-                street: '  Calle 10  ',
-                city: '  Mérida  '
-            });
-            expect(result.isValid).toBe(true);
-        });
-    });
-    describe('required fields', () => {
-        it('should reject missing street', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, street: '' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Calle es requerida');
-        });
-        it('should reject missing exterior number', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, exteriorNumber: '' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Número exterior es requerido');
-        });
-        it('should reject missing neighborhood', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, neighborhood: '' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Colonia es requerida');
-        });
-        it('should reject missing city', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, city: '' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Ciudad es requerida');
-        });
-        it('should reject missing postal code', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, postalCode: '' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Código postal es requerido');
-        });
-        it('should reject missing state', () => {
-            const { state, ...addressWithoutState } = validAddress;
-            const result = (0, address_validation_1.validateAddress)(addressWithoutState);
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Estado es requerido');
-        });
-        it('should reject missing country', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, country: '' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('País es requerido');
-        });
-    });
-    describe('postal code validation', () => {
-        it('should reject postal code with less than 5 digits', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, postalCode: '9700' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('5 dígitos');
-        });
-        it('should reject postal code with more than 5 digits', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, postalCode: '970001' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('5 dígitos');
-        });
-        it('should reject postal code with letters', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, postalCode: '9700A' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('5 dígitos');
-        });
-    });
-    describe('state code validation', () => {
-        it('should accept all valid Mexican state codes', () => {
-            const validStates = [
-                'AGS', 'BC', 'BCS', 'CAMP', 'CHIS', 'CHIH', 'COAH', 'COL', 'CDMX',
-                'DGO', 'GTO', 'GRO', 'HGO', 'JAL', 'MEX', 'MICH', 'MOR', 'NAY',
-                'NL', 'OAX', 'PUE', 'QRO', 'QROO', 'SLP', 'SIN', 'SON', 'TAB',
-                'TAMPS', 'TLAX', 'VER', 'YUC', 'ZAC'
-            ];
-            validStates.forEach(state => {
-                const result = (0, address_validation_1.validateAddress)({ ...validAddress, state: state });
-                expect(result.isValid).toBe(true);
-            });
-        });
-        it('should reject invalid state code', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, state: 'INVALID' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Código de estado inválido');
-        });
-    });
-    describe('country validation', () => {
-        it('should reject non-Mexican country', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, country: 'USA' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('México');
-        });
-        it('should reject other countries', () => {
-            const result = (0, address_validation_1.validateAddress)({ ...validAddress, country: 'Canada' });
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('México');
-        });
-    });
-});
-describe('POSTAL_CODE_PATTERN', () => {
-    it('should match valid 5-digit postal code', () => {
-        expect(address_validation_1.POSTAL_CODE_PATTERN.test('97000')).toBe(true);
-    });
-    it('should match postal code starting with 0', () => {
-        expect(address_validation_1.POSTAL_CODE_PATTERN.test('01000')).toBe(true);
-    });
-    it('should not match 4-digit code', () => {
-        expect(address_validation_1.POSTAL_CODE_PATTERN.test('9700')).toBe(false);
-    });
-    it('should not match 6-digit code', () => {
-        expect(address_validation_1.POSTAL_CODE_PATTERN.test('970001')).toBe(false);
-    });
-});

package/dist/validation/__tests__/email.validation.test.d.ts

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

package/dist/validation/__tests__/email.validation.test.js

@@ -1,102 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const email_validation_1 = require("../email.validation");
-describe('validateEmail', () => {
-    describe('valid emails', () => {
-        it('should accept valid email', () => {
-            const result = (0, email_validation_1.validateEmail)('test@example.com');
-            expect(result.isValid).toBe(true);
-            expect(result.error).toBeUndefined();
-        });
-        it('should accept email with subdomain', () => {
-            const result = (0, email_validation_1.validateEmail)('test@mail.example.com');
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept email with numbers', () => {
-            const result = (0, email_validation_1.validateEmail)('test123@example.com');
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept email with dots in local part', () => {
-            const result = (0, email_validation_1.validateEmail)('test.user@example.com');
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept email with plus sign', () => {
-            const result = (0, email_validation_1.validateEmail)('test+tag@example.com');
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept uppercase email (normalized)', () => {
-            const result = (0, email_validation_1.validateEmail)('TEST@EXAMPLE.COM');
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept email with whitespace (trimmed)', () => {
-            const result = (0, email_validation_1.validateEmail)('  test@example.com  ');
-            expect(result.isValid).toBe(true);
-        });
-    });
-    describe('invalid emails', () => {
-        it('should reject empty string', () => {
-            const result = (0, email_validation_1.validateEmail)('');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Email es requerido');
-        });
-        it('should reject null', () => {
-            const result = (0, email_validation_1.validateEmail)(null);
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Email es requerido');
-        });
-        it('should reject undefined', () => {
-            const result = (0, email_validation_1.validateEmail)(undefined);
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Email es requerido');
-        });
-        it('should reject whitespace only', () => {
-            const result = (0, email_validation_1.validateEmail)('   ');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Email es requerido');
-        });
-        it('should reject email without @', () => {
-            const result = (0, email_validation_1.validateEmail)('testexample.com');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Email inválido');
-        });
-        it('should reject email without domain', () => {
-            const result = (0, email_validation_1.validateEmail)('test@');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Email inválido');
-        });
-        it('should reject email without local part', () => {
-            const result = (0, email_validation_1.validateEmail)('@example.com');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Email inválido');
-        });
-        it('should reject email without TLD', () => {
-            const result = (0, email_validation_1.validateEmail)('test@example');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Email inválido');
-        });
-        it('should reject email with spaces', () => {
-            const result = (0, email_validation_1.validateEmail)('test @example.com');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('Email inválido');
-        });
-    });
-});
-describe('normalizeEmail', () => {
-    it('should convert to lowercase', () => {
-        expect((0, email_validation_1.normalizeEmail)('TEST@EXAMPLE.COM')).toBe('test@example.com');
-    });
-    it('should trim whitespace', () => {
-        expect((0, email_validation_1.normalizeEmail)('  test@example.com  ')).toBe('test@example.com');
-    });
-    it('should handle mixed case', () => {
-        expect((0, email_validation_1.normalizeEmail)('Test@Example.Com')).toBe('test@example.com');
-    });
-});
-describe('EMAIL_PATTERN', () => {
-    it('should match valid email', () => {
-        expect(email_validation_1.EMAIL_PATTERN.test('test@example.com')).toBe(true);
-    });
-    it('should not match invalid email', () => {
-        expect(email_validation_1.EMAIL_PATTERN.test('invalid')).toBe(false);
-    });
-});

package/dist/validation/__tests__/phone.validation.test.d.ts

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

package/dist/validation/__tests__/phone.validation.test.js

@@ -1,75 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const phone_validation_1 = require("../phone.validation");
-describe('validatePhone', () => {
-    describe('valid phones', () => {
-        it('should accept valid 10-digit phone', () => {
-            const result = (0, phone_validation_1.validatePhone)('9991234567');
-            expect(result.isValid).toBe(true);
-            expect(result.error).toBeUndefined();
-        });
-        it('should accept phone with whitespace (trimmed)', () => {
-            const result = (0, phone_validation_1.validatePhone)('  9991234567  ');
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept undefined (phone is optional)', () => {
-            const result = (0, phone_validation_1.validatePhone)(undefined);
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept null (phone is optional)', () => {
-            const result = (0, phone_validation_1.validatePhone)(null);
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept empty string (phone is optional)', () => {
-            const result = (0, phone_validation_1.validatePhone)('');
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept whitespace only (phone is optional)', () => {
-            const result = (0, phone_validation_1.validatePhone)('   ');
-            expect(result.isValid).toBe(true);
-        });
-    });
-    describe('invalid phones', () => {
-        it('should reject phone with less than 10 digits', () => {
-            const result = (0, phone_validation_1.validatePhone)('999123456');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('10 dígitos');
-        });
-        it('should reject phone with more than 10 digits', () => {
-            const result = (0, phone_validation_1.validatePhone)('99912345678');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('10 dígitos');
-        });
-        it('should reject phone with letters', () => {
-            const result = (0, phone_validation_1.validatePhone)('999123456a');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('10 dígitos');
-        });
-        it('should reject phone with special characters', () => {
-            const result = (0, phone_validation_1.validatePhone)('999-123-4567');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('10 dígitos');
-        });
-        it('should reject phone with spaces inside', () => {
-            const result = (0, phone_validation_1.validatePhone)('999 123 4567');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('10 dígitos');
-        });
-        it('should reject phone with parentheses', () => {
-            const result = (0, phone_validation_1.validatePhone)('(999)1234567');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('10 dígitos');
-        });
-    });
-});
-describe('PHONE_PATTERN', () => {
-    it('should match valid 10-digit phone', () => {
-        expect(phone_validation_1.PHONE_PATTERN.test('9991234567')).toBe(true);
-    });
-    it('should not match invalid phone', () => {
-        expect(phone_validation_1.PHONE_PATTERN.test('999-123-4567')).toBe(false);
-    });
-    it('should not match phone with less than 10 digits', () => {
-        expect(phone_validation_1.PHONE_PATTERN.test('999123456')).toBe(false);
-    });
-});

package/dist/validation/__tests__/rfc.validation.test.d.ts

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

package/dist/validation/__tests__/rfc.validation.test.js

@@ -1,97 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const rfc_validation_1 = require("../rfc.validation");
-describe('validateRFC', () => {
-    describe('valid RFCs', () => {
-        it('should accept valid RFC persona moral (12 chars)', () => {
-            const result = (0, rfc_validation_1.validateRFC)('HVP850101AB1');
-            expect(result.isValid).toBe(true);
-            expect(result.error).toBeUndefined();
-        });
-        it('should accept valid RFC persona física (13 chars)', () => {
-            const result = (0, rfc_validation_1.validateRFC)('GARC850101AB1');
-            expect(result.isValid).toBe(true);
-            expect(result.error).toBeUndefined();
-        });
-        it('should accept RFC with Ñ', () => {
-            const result = (0, rfc_validation_1.validateRFC)('MÑO850101AB1');
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept RFC with &', () => {
-            const result = (0, rfc_validation_1.validateRFC)('M&O850101AB1');
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept lowercase RFC (normalized)', () => {
-            const result = (0, rfc_validation_1.validateRFC)('hvp850101ab1');
-            expect(result.isValid).toBe(true);
-        });
-        it('should accept RFC with whitespace (trimmed)', () => {
-            const result = (0, rfc_validation_1.validateRFC)('  HVP850101AB1  ');
-            expect(result.isValid).toBe(true);
-        });
-    });
-    describe('invalid RFCs', () => {
-        it('should reject empty string', () => {
-            const result = (0, rfc_validation_1.validateRFC)('');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('RFC es requerido');
-        });
-        it('should reject null', () => {
-            const result = (0, rfc_validation_1.validateRFC)(null);
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('RFC es requerido');
-        });
-        it('should reject undefined', () => {
-            const result = (0, rfc_validation_1.validateRFC)(undefined);
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('RFC es requerido');
-        });
-        it('should reject whitespace only', () => {
-            const result = (0, rfc_validation_1.validateRFC)('   ');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toBe('RFC es requerido');
-        });
-        it('should reject RFC too short', () => {
-            const result = (0, rfc_validation_1.validateRFC)('HVP850101');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('RFC inválido');
-        });
-        it('should reject RFC too long', () => {
-            const result = (0, rfc_validation_1.validateRFC)('GARC850101AB1X');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('RFC inválido');
-        });
-        it('should reject RFC with invalid characters', () => {
-            const result = (0, rfc_validation_1.validateRFC)('HVP-850101AB1');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('RFC inválido');
-        });
-        it('should reject RFC with wrong format', () => {
-            const result = (0, rfc_validation_1.validateRFC)('123456789012');
-            expect(result.isValid).toBe(false);
-            expect(result.error).toContain('RFC inválido');
-        });
-    });
-});
-describe('normalizeRFC', () => {
-    it('should convert to uppercase', () => {
-        expect((0, rfc_validation_1.normalizeRFC)('hvp850101ab1')).toBe('HVP850101AB1');
-    });
-    it('should trim whitespace', () => {
-        expect((0, rfc_validation_1.normalizeRFC)('  HVP850101AB1  ')).toBe('HVP850101AB1');
-    });
-    it('should handle mixed case', () => {
-        expect((0, rfc_validation_1.normalizeRFC)('HvP850101Ab1')).toBe('HVP850101AB1');
-    });
-});
-describe('RFC_PATTERN', () => {
-    it('should match valid RFC persona moral', () => {
-        expect(rfc_validation_1.RFC_PATTERN.test('HVP850101AB1')).toBe(true);
-    });
-    it('should match valid RFC persona física', () => {
-        expect(rfc_validation_1.RFC_PATTERN.test('GARC850101AB1')).toBe(true);
-    });
-    it('should not match invalid RFC', () => {
-        expect(rfc_validation_1.RFC_PATTERN.test('INVALID')).toBe(false);
-    });
-});