hvp-shared 2.0.0

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

@@ -0,0 +1,27 @@
+export interface ValidationResult {
+    isValid: boolean;
+    error?: string;
+}
+/**
+ * Validates RFC (Mexican Tax ID) format
+ *
+ * Valid formats:
+ * - Persona Moral: 3 letters + 6 digits + 3 alphanumeric (e.g., HVP850101AB1)
+ * - Persona Física: 4 letters + 6 digits + 3 alphanumeric (e.g., GARC850101AB1)
+ *
+ * @param value - RFC to validate
+ * @returns ValidationResult with isValid flag and optional error message
+ */
+export declare function validateRFC(value: string | null | undefined): ValidationResult;
+/**
+ * Normalizes RFC to uppercase and trimmed
+ *
+ * @param value - RFC to normalize
+ * @returns Normalized RFC
+ */
+export declare function normalizeRFC(value: string): string;
+/**
+ * Regex pattern for RFC validation
+ * Can be used directly in form libraries that accept regex
+ */
+export declare const RFC_PATTERN: RegExp;

package/dist/validation/rfc.validation.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RFC_PATTERN = void 0;
+exports.validateRFC = validateRFC;
+exports.normalizeRFC = normalizeRFC;
+/**
+ * Validates RFC (Mexican Tax ID) format
+ *
+ * Valid formats:
+ * - Persona Moral: 3 letters + 6 digits + 3 alphanumeric (e.g., HVP850101AB1)
+ * - Persona Física: 4 letters + 6 digits + 3 alphanumeric (e.g., GARC850101AB1)
+ *
+ * @param value - RFC to validate
+ * @returns ValidationResult with isValid flag and optional error message
+ */
+function validateRFC(value) {
+    if (!value || !value.trim()) {
+        return { isValid: false, error: 'RFC es requerido' };
+    }
+    const normalized = value.toUpperCase().trim();
+    // Mexican RFC format: 3-4 letters + 6 digits + 3 alphanumeric
+    const rfcPattern = /^[A-ZÑ&]{3,4}\d{6}[A-Z0-9]{3}$/;
+    if (!rfcPattern.test(normalized)) {
+        return { isValid: false, error: 'RFC inválido. Formato esperado: XXXX000000XXX' };
+    }
+    return { isValid: true };
+}
+/**
+ * Normalizes RFC to uppercase and trimmed
+ *
+ * @param value - RFC to normalize
+ * @returns Normalized RFC
+ */
+function normalizeRFC(value) {
+    return value.toUpperCase().trim();
+}
+/**
+ * Regex pattern for RFC validation
+ * Can be used directly in form libraries that accept regex
+ */
+exports.RFC_PATTERN = /^[A-ZÑ&]{3,4}\d{6}[A-Z0-9]{3}$/;

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "hvp-shared",
+  "version": "2.0.0",
+  "description": "Shared types and utilities for HVP backend and frontend",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "hvp",
+    "shared",
+    "types"
+  ],
+  "author": "Javier Garcia",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.0.0"
+  }
+}