1.2.0 • Published 10 months ago

validator-ec v1.2.0

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
10 months ago

validator-ec

Colecció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.

Características

  • 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.

Instalación

Puedes instalar validator-ec utilizando el gestor de paquetes que prefieras.

Bun

bun add validator-ec

Yarn

yarn add validator-ec

NPM

npm install validator-ec

Validadores

ValidadorDescripciónEjemplo
isCedula(cedula: string): booleanValida una cédula de identidad ecuatoriana. Devuelve true si la cédula es válida, de lo contrario false.isCedula('1710034065')
isRUC(ruc: string): booleanValida un número de RUC (Registro Único de Contribuyentes). Devuelve true si el RUC es válido, de lo contrario false.isRUC('1790016919001')
isZipCode(zipCode: string): booleanValida un código postal ecuatoriano. Devuelve true si el código postal es válido, de lo contrario false.isZipCode('131401')

Uso

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 (CommonJS)

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");
}

Contribuir

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.
  4. Realiza los cambios necesarios.
  5. Agrega pruebas para la nueva funcionalidad.
  6. Realiza un pull request a la rama master.

Pruebas

Para ejecutar las pruebas del proyecto con Vitest, utiliza el siguiente comando:

bun run test

Construir el proyecto

Para construir el proyecto con tsup, utiliza el siguiente comando:

bun run build

Autores

Licencia

Este proyecto está liberado bajo la licencia Apache 2.0. Para más información, revisa el archivo LICENSE.

1.2.0

10 months ago

1.1.0

10 months ago

1.0.3

10 months ago

1.0.2

10 months ago

1.0.1

10 months ago

1.0.0

10 months ago