Validadores

Todos los validadores retornan boolean. Aceptan tanto entradas sin formato como con guiones.

validateCedula

Valida una cédula dominicana usando el algoritmo de Luhn (mod-10).

Argumentos

Parámetro	Tipo	Descripción
cedula	string	Cédula sin formato o con guiones (ej. '40220579912' o '402-2057991-2')

Retorna boolean — true si es válida, false en caso contrario.

Ejemplo

import { validateCedula } from 'dr-utils'

validateCedula('40220579912')    // true
validateCedula('402-2057991-2') // true (acepta guiones)
validateCedula('402 2057991 2') // true (acepta espacios)
validateCedula('12345678901')   // false

validateRNC

Valida un RNC (Registro Nacional del Contribuyente) dominicano con el dígito verificador módulo 11 de la DGII. Las entradas de 11 dígitos se validan como cédulas (Luhn). Se aceptan guiones y espacios como separadores; cualquier otro carácter que no sea dígito hace que el RNC sea inválido.

Argumentos

Parámetro	Tipo	Descripción
rnc	string	RNC sin formato o con guiones (ej. '130500292' o '130-50029-2')

Retorna boolean — true si es válido, false en caso contrario.

Ejemplo

import { validateRNC } from 'dr-utils'

validateRNC('130500292')    // true
validateRNC('130-50029-2') // true (acepta guiones)
validateRNC('130 50029 2') // true (acepta espacios)
validateRNC('130500292x')  // false (rechaza otros caracteres)

validateNCF

Valida un NCF (Número de Comprobante Fiscal) dominicano. Soporta tanto el formato físico (11 caracteres, tipos 01–04 y 11–17) como el electrónico e-CF (13 caracteres, tipos 31–34, 41 y 43–47).

Argumentos

Parámetro	Tipo	Descripción
ncf	string	Cadena NCF a validar

Retorna boolean — true si es válido, false en caso contrario.

Ejemplo

import { validateNCF } from 'dr-utils'

validateNCF('B0183920391')   // true (físico, 11 caracteres)
validateNCF('E319123402392') // true (electrónico e-CF, 13 caracteres)

validatePhoneNumber

Valida un número de teléfono dominicano. Acepta varios formatos incluyendo local, formateado y con código de país. Rechaza números no dominicanos.

Argumentos

Parámetro	Tipo	Descripción
number	string	Número de teléfono en cualquier formato dominicano común

Retorna boolean — true si es válido, false en caso contrario.

Ejemplo

import { validatePhoneNumber } from 'dr-utils'

validatePhoneNumber('8092201111')        // true
validatePhoneNumber('(829) 555-3000')    // true
validatePhoneNumber('18492001234')       // true (con código de país)
validatePhoneNumber('+1 (781) 575 4238') // false (no es número dominicano)

validatePlate

Valida una placa de vehículo dominicana contra la lista oficial de categorías de la DGII.

Argumentos

Parámetro	Tipo	Descripción
plate	string	Cadena de placa (sin distinción entre mayúsculas y minúsculas)

Retorna boolean — true si es válida, false en caso contrario.

Ejemplo

import { validatePlate } from 'dr-utils'

validatePlate('A123456') // true (privado)
validatePlate('EL12345') // true (eléctrico)
validatePlate('ZZ12345') // false (categoría desconocida)

Categorías de placas

Una letra: A (Automóvil), B (Interurbano público), C (Turístico), D (Autobús público urbano), F (Remolque), G (Jeep), H (Ambulancia), I (Autobús privado), J (Montacargas), K (Motocicleta), L (Carga), M (Carro fúnebre), P (Autobús turístico), R (Interurbano público), S (Volteo), T (Automóvil público urbano), U (Máquinas pesadas), X (Exhibición), Z (Exonerada)

Dos letras: OE (Ejército Nacional), OF (Fuerza Aérea), OM (Marina de Guerra), OP (Policía Nacional), EA/ED/EG/EI/EL/EM (Exonerada estatal — norma No. 14-2011 DGII), VC (Consular), WD (Diplomática), OI (Organismo internacional), EX/YX/NZ (Exonerada), DD (Dealer)