Colección de validadores de datos comunes en Ecuador desarrollada en TypeScript.
npm install validator-ecColección de validadores de datos comunes en Ecuador desarrollada en TypeScript.
Actualmente, cuenta con validadores para cédulas de identidad ecuatorianas, números de RUC (Registro Único de Contribuyentes) y códigos postales.
- Compatibilidad con TypeScript y JavaScript (ES Modules y CommonJS).
- Fácil integración en cualquier proyecto frontend o backend.
- Extensible, permitiendo agregar más validadores en el futuro.
Puedes instalar validator-ec utilizando el gestor de paquetes que prefieras.
``bash`
bun add validator-ec
`bash`
yarn add validator-ec
`bash`
npm install validator-ec
| Validador | Descripción | Ejemplo |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| isCedula(cedula: string): boolean | Valida una cédula de identidad ecuatoriana. Devuelve true si la cédula es válida, de lo contrario false. | isCedula('1710034065') |isRUC(ruc: string): boolean
| | Valida un número de RUC (Registro Único de Contribuyentes). Devuelve true si el RUC es válido, de lo contrario false. | isRUC('1790016919001') |isLegalEntityRUC(ruc: string): boolean
| | Devuelve true si un RUC pertenece a una persona jurídica (tercer dígito igual a 9), de lo contrario false. | isLegalEntityRuc('0992345678001') |isZipCode(zipCode: string): boolean
| | Valida un código postal ecuatoriano. Devuelve true si el código postal es válido, de lo contrario false. | isZipCode('131401') |
`typescript
import { isCedula } from "validator-ec";
// Validar una cédula
const cedula = "1710034065";
const isValid = isCedula(cedula);
if (isValid) {
console.log("La cédula es válida");
} else {
console.log("La cédula no es válida");
}
`
`javascript
const { isCedula } = require("validator-ec");
// Validar una cédula
const cedula = "1710034065";
const isValid = isCedula(cedula);
if (isValid) {
console.log("La cédula es válida");
} else {
console.log("La cédula no es válida");
}
`
Todas las contribuciones son bienvenidas. Si deseas contribuir al proyecto, asegúrate de tener instalado Bun antes de seguir los siguientes pasos:
1. Crea un fork del proyecto.
2. Crea una nueva rama con el nombre de la funcionalidad que deseas agregar.
3. Instala las dependencias del proyecto con bun install.master
4. Realiza los cambios necesarios.
5. Agrega pruebas para la nueva funcionalidad.
6. Realiza un pull request a la rama .
Para ejecutar las pruebas del proyecto con Vitest, utiliza el siguiente comando:
`bash`
bun run test
Para construir el proyecto con tsup, utiliza el siguiente comando:
`bash``
bun run build
Este proyecto está liberado bajo la licencia Apache 2.0. Para más información, revisa el archivo LICENSE.