Librería moderna para calcular la CURP (Clave Única de Registro de Población) mexicana con homoclave y dígito verificador, siguiendo el algoritmo oficial del Registro Nacional de Población.
- 🎯 Cálculo preciso de CURP con homoclave y dígito verificador
- 🛡️ Validación robusta de parámetros y datos de entrada
- 🔄 Múltiples formatos de fecha soportados
- 🌎 Todos los estados de México + nacidos en el extranjero
- 🚫 Detección de palabras obscenas según lista oficial
- 📝 Manejo de caracteres especiales (acentos, ñ, espacios)
- 🎭 Remoción automática de prefijos y sufijos especiales
- ✅ 39 tests con cobertura >90%
- 📦 Zero dependencies (excepto dayjs para fechas)
- 🌐 ESM + CommonJS compatible
npm install calcula-curp// ESM
import calculaCURP from 'calcula-curp';
// CommonJS
const calculaCURP = require('calcula-curp');const curp = calculaCURP(
'JUAN CARLOS', // Nombres
'PEREZ', // Apellido paterno
'GOMEZ', // Apellido materno
'15/01/1985', // Fecha de nacimiento
'H', // Sexo (H/M)
'JALISCO' // Lugar de nacimiento
);
console.log(curp); // PEGJ850115HJCRMN05// Formato DD/MM/YYYY
calculaCURP('MARIA', 'LOPEZ', 'MARTINEZ', '25/12/1990', 'M', 'MEXICO');
// LOMF901225MMCPRR04
// Formato YYYY-MM-DD
calculaCURP('PEDRO', 'GONZALEZ', 'RAMIREZ', '1990-05-15', 'H', 'NUEVO LEON');
// GORP900515HNLNZD06
// Formato MM/DD/YYYY
calculaCURP('ANA', 'GARCIA', 'TORRES', '12/25/1995', 'M', 'PUEBLA');
// GATA951225MPLLRN02// Con acentos
calculaCURP('JOSÉ MARÍA', 'GARCÍA', 'LÓPEZ', '10/05/1980', 'H', 'GUANAJUATO');
// GALJ800510HGTRRN03
// Con ñ
calculaCURP('ANA', 'NUÑEZ', 'PEÑA', '20/08/1992', 'M', 'PUEBLA');
// NUPA920820MPLLXN09// "MARIA" se remueve automáticamente
calculaCURP('MARIA GUADALUPE', 'HERNANDEZ', 'LOPEZ', '10/10/1990', 'M', 'JALISCO');
// HELG901010MJCRPD01
// "JOSE" se remueve automáticamente
calculaCURP('JOSE LUIS', 'MARTINEZ', 'GARCIA', '05/05/1985', 'H', 'CHIHUAHUA');
// MAGL850505HCHRRS08
// "DE LA" se maneja correctamente
calculaCURP('PEDRO', 'DE LA CRUZ', 'MARTINEZ', '20/12/1988', 'H', 'OAXACA');
// CUMP881220HOCRRR05Calcula la CURP completa de 18 caracteres.
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
nombres |
string |
Nombre(s) de la persona | "JUAN CARLOS" |
apellidoPaterno |
string |
Apellido paterno | "PEREZ" |
apellidoMaterno |
string |
Apellido materno | "GOMEZ" |
fechaNacimiento |
string |
Fecha en formato DD/MM/YYYY, YYYY-MM-DD o MM/DD/YYYY |
"15/01/1985" |
sexo |
string |
"H" (Hombre) o "M" (Mujer) |
"H" |
lugarNacimiento |
string |
Estado de nacimiento o "NACIDO EXTRANJERO" | "JALISCO" |
string: CURP de 18 caracteres en mayúsculas
Lanza Error si:
- Algún parámetro requerido está vacío
- El sexo no es 'H' o 'M'
- La fecha no tiene un formato válido
- Cualquier parámetro es inválido
Todos los 32 estados de México:
Aguascalientes, Baja California, Baja California Sur, Campeche, Chiapas,
Chihuahua, Coahuila, Colima, Ciudad de México, Durango, Guanajuato,
Guerrero, Hidalgo, Jalisco, México, Michoacán, Morelos, Nayarit,
Nuevo León, Oaxaca, Puebla, Querétaro, Quintana Roo, San Luis Potosí,
Sinaloa, Sonora, Tabasco, Tamaulipas, Tlaxcala, Veracruz, Yucatán, Zacatecas
Para personas nacidas en el extranjero, usa: "NACIDO EXTRANJERO" o cualquier país.
La CURP tiene 18 caracteres con la siguiente estructura:
P E G J 8 5 0 1 1 5 H J C R M N 0 5
└┬┘ └┘ └┘ └┘ └────┬────┘ └┘ └┬┘ └──┬──┘ └┘ └┘
│ │ │ │ │ │ │ │ │ └── Dígito verificador
│ │ │ │ │ │ │ │ └──── Homoclave
│ │ │ │ │ │ │ └────────── Consonantes internas
│ │ │ │ │ │ └──────────────── Estado de nacimiento
│ │ │ │ │ └──────────────────── Sexo (H/M)
│ │ │ │ └──────────────────────────── Fecha (AAMMDD)
│ │ │ └─────────────────────────────────── Primera letra del nombre
│ │ └────────────────────────────────────── Primera letra apellido materno
│ └───────────────────────────────────────── Primera vocal apellido paterno
└──────────────────────────────────────────── Primera letra apellido paterno
# Ejecutar tests
npm test
# Tests con cobertura
npm run test:coverage
# Tests en modo watch
npm run test:watchCobertura actual: >90% en todas las métricas
# Clonar repositorio
git clone https://github.com/GerardoLucero/calcula-curp.git
cd calcula-curp
# Instalar dependencias
npm install
# Ejecutar tests
npm test
# Lint
npm run lint
# Build
npm run build// Benito Juárez
calculaCURP('BENITO', 'JUAREZ', 'GARCIA', '21/03/1806', 'H', 'OAXACA');
// JUGB060321HOCRRN08
// Sor Juana Inés de la Cruz
calculaCURP('JUANA', 'RAMIREZ', 'ASBAJE', '12/11/1651', 'M', 'MEXICO');
// RAAJ511112MMCMSN04try {
calculaCURP('', 'PEREZ', 'GOMEZ', '15/01/1985', 'H', 'JALISCO');
} catch (error) {
console.error(error.message);
// Error al calcular CURP: El parámetro [nombres] es requerido y no puede estar vacío
}
try {
calculaCURP('JUAN', 'PEREZ', 'GOMEZ', 'fecha-invalida', 'H', 'JALISCO');
} catch (error) {
console.error(error.message);
// Error al calcular CURP: La fecha de nacimiento debe tener un formato válido
}Esta librería implementa el algoritmo oficial del Registro Nacional de Población, pero la CURP definitiva solo puede ser emitida por RENAPO. La homoclave final puede variar.
La homoclave (penúltimo caracter) es asignada automáticamente por RENAPO para evitar duplicados. Esta librería usa '0' como homoclave predeterminada.
Sí, la librería calcula CURPs para cualquier fecha de nacimiento, incluyendo fechas históricas.
¡Las contribuciones son bienvenidas! Por favor:
- Fork el proyecto
- Crea tu feature branch (
git checkout -b feature/AmazingFeature) - Commit tus cambios (
git commit -m 'Add some AmazingFeature') - Push al branch (
git push origin feature/AmazingFeature) - Abre un Pull Request
MIT © Gerardo Lucero
Si esta librería te resulta útil, considera hacer una donación:
- calcula-rfc - Calcula el RFC mexicano
- validador-fiscal-mx - Valida RFC y CURP
- generador-datos-mx - Genera datos de prueba mexicanos
Hecho con ❤️ en México 🇲🇽