ci-validation
Advanced tools
🇺🇾 Complete TypeScript/JavaScript library for validating Uruguayan CI (Cédula de Identidad) with official algorithm and government service integration
⚠️ IMPORTANTE PARA TODOS LOS URUGUAYOS ⚠️
Este proyecto fue desarrollado y hecho público debido a:
🔴 FALTA DE INCENTIVOS MONETARIOS para reportes de seguridad en entes públicos
🔴 AUSENCIA DE PROGRAMAS DE BUG BOUNTY gubernamentales
🔴 NULA RESPUESTA a reportes responsables de vulnerabilidades
🔴 FALTA DE ACCIONES CORRECTIVAS ante problemas de seguridad reportados🎯 OBJETIVO: Concientizar a los ciudadanos uruguayos sobre lo POCO CUIDADO que está el sistema informático de los entes públicos, donde la información personal de todos nosotros está expuesta sin protección adecuada.
📋 Este trabajo se hace público para:
- Generar presión social para que se solucionen estos problemas
- Mostrar la realidad del estado de la ciberseguridad pública
- Educar sobre la importancia de proteger datos personales
- Exigir transparencia y responsabilidad en la gestión de sistemas públicos
Lee el 📄 Reporte Completo de Vulnerabilidad para entender la gravedad del problema.
⚠️ CONTEXTO: Este proyecto fue desarrollado tras descubrir una vulnerabilidad de seguridad en servicios gubernamentales. Lee el Reporte de Vulnerabilidad para más información.
Una API RESTful construida con TypeScript y Express siguiendo los principios SOLID para validar cédulas de identidad uruguayas y consultar información a través del servicio oficial de la Lotería Nacional.
� ACTUALIZACIÓN CRÍTICA 02/08/2025: Todos los endpoints gubernamentales han sido inhabilitados. El endpoint del MEF ahora retorna error
{"message":"Lo sentimos, ocurrió un error al ejecutarse la operación.","status":1000}. Solo la validación algorítmica local permanece funcional. Ver reporte completo para detalles.
¡Esta funcionalidad también está disponible como paquete npm!
# Instalar el paquete
npm install ci-validation
# Uso básico
import { validateCIAndQuery } from 'ci-validation';
const result = await validateCIAndQuery('19119365');
console.log(result);
// Output (solo validación local - endpoints gubernamentales inhabilitados):
// {
// "success": true,
// "data": {
// "ci": "19119365",
// "isValid": true,
// "normalizedCi": "19119365",
// "info": "Validación local únicamente - Servicios gubernamentales no disponibles desde 02/08/2025"
// }
// }
🔗 Enlaces del paquete:
CiValidator: Solo se encarga de validar cédulasCiService: Solo maneja las consultas a la API externaCiController: Solo maneja las peticiones HTTP# Instalar la librería
npm install ci-validation
# Uso básico
import { validateCI, validateCIAndQuery } from 'ci-validation';
// Validación simple
console.log(validateCI('19119365')); // true
// Validación con consulta
const result = await validateCIAndQuery('19119365');
console.log(result);
# Instalar globalmente para usar desde línea de comandos
npm install -g ci-validation
# Usar el CLI
ci-validate 19119365
ci-validate 19119365 --query
# Clonar repositorio
git clone <url-del-repo>
cd ci-validation-api
# Instalar dependencias
npm install
# Modo desarrollo
npm run dev
# Construir para producción
npm run build
# Iniciar en producción
npm start
Verifica el estado de la API
Respuesta:
{
"status": "ok",
"timestamp": "2025-07-30T12:00:00.000Z"
}
Valida una cédula de identidad uruguaya
Request Body:
{
"ci": "19119365"
}
Respuesta exitosa:
{
"success": true,
"data": {
"ci": "19119365",
"isValid": true,
"info": "Información obtenida de la Lotería Nacional..."
}
}
Respuesta con error:
{
"success": false,
"error": "Cédula inválida: formato incorrecto"
}
Endpoint de demostración con una cédula de ejemplo
Página web interactiva para probar la API
La página de demostración incluye:
Características técnicas:
# Ejecutar tests
npm test
# Ejecutar linting
npm run lint
# Corregir problemas de linting
npm run lint:fix
El proyecto está optimizado para deployment serverless en Vercel:
/api//public/vercel.json maneja el routingapi/
├── index.ts # Endpoint raíz (GET /)
├── health.ts # Health check (GET /health)
├── validate.ts # Validación (POST /api/ci/validate)
└── demo.ts # Demo API (GET /api/ci/demo)
public/
└── index.html # Página demo (GET /demo)
https://ci-validation.vercel.app/https://ci-validation.vercel.app/healthhttps://ci-validation.vercel.app/api/ci/validatehttps://ci-validation.vercel.app/demoNODE_ENV: productionPORT: Puerto del servidor (automático en Vercel)src/
├── controllers/ # Controladores HTTP
│ └── CiController.ts
├── services/ # Servicios de negocio
│ └── CiService.ts
├── validators/ # Validadores
│ └── CiValidator.ts
├── interfaces/ # Definiciones de tipos
│ ├── ICiValidator.ts
│ ├── ICiService.ts
│ └── ApiResponse.ts
├── middleware/ # Middlewares personalizados
│ └── errorHandler.ts
├── routes/ # Definición de rutas
│ └── ciRoutes.ts
├── utils/ # Utilidades
│ └── dependencyContainer.ts
└── index.ts # Punto de entrada
La validación sigue el algoritmo oficial uruguayo:
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)Si tienes permisos de publicación:
# Verificar build
npm run build
# Dry run
npm run publish:dry
# Publicar
npm run publish:npm
# O incrementar versión y publicar
npm version patch # o minor/major
npm run publish:npm
Ver guía completa de publicación para más detalles.
Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.
FAQs
🇺🇾 Complete TypeScript/JavaScript library for validating Uruguayan CI (Cédula de Identidad) with official algorithm and government service integration
The npm package ci-validation receives a total of 25 weekly downloads. As such, ci-validation popularity was classified as not popular.
We found that ci-validation demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Socket researchers uncover how threat actors weaponize Discord across the npm, PyPI, and RubyGems ecosystems to exfiltrate sensitive data.
Security News
Socket now integrates with Bun 1.3’s Security Scanner API to block risky packages at install time and enforce your organization’s policies in local dev and CI.
Research
The Socket Threat Research Team is tracking weekly intrusions into the npm registry that follow a repeatable adversarial playbook used by North Korean state-sponsored actors.