Uso Básico

📌 Introducción

nicaraguan-id-utils es una librería simple pero poderosa que te permite validar, formatear y extraer datos de una cédula de identidad de Nicaragua.

1. Instala la librería si aún no lo has hecho:

   npm install nicaraguan-id-utils

2. Importa las funciones necesarias en tu proyecto:

   src/ejemplo.ts

   import {
     isValid,
     parse,
     getLocation,
     getAge,
     getValidationError,
   } from "nicaraguan-id-utils";

3. Valida una cédula nicaragüense:

   src/ejemplo.ts

   const id = "001-030505-1234A";
   console.log(isValid(id)); // true

4. Analiza la cédula para obtener detalles útiles:

   src/ejemplo.ts

   const data = parse(id);
   console.log(data?.birthDate); // Fecha de nacimiento
   console.log(data?.isAdult); // true o false
   console.log(getAge(data!.birthDate)); // Edad exacta

5. Extrae el lugar de nacimiento:

   src/ejemplo.ts

   const location = getLocation(id);
   console.log(location); // { department: 'Managua', municipality: 'Managua' }

6. Verifica errores si la cédula es inválida:

   src/ejemplo.ts

   console.log(getValidationError("999-999999-0000Z"));
   // → "Código de circunscripción desconocido" o similar