Manejo de errores

Todas las funciones que lanzan excepciones en v3 generan un DrUtilsError en lugar de un Error genérico. Puedes importarlo desde dr-utils/errors y distinguir por su campo .code.

import { parseCedula } from 'dr-utils'
import { DrUtilsError } from 'dr-utils/errors'

try {
  parseCedula('invalido')
} catch (e) {
  if (e instanceof DrUtilsError) {
    console.error(e.code)    // 'INVALID_CEDULA'
    console.error(e.message) // '"invalido" is not a valid cedula.'
  }
}

DrUtilsError extiende Error, por lo que los checks instanceof Error existentes siguen funcionando.

Códigos de error

Código	Lanzado por
INVALID_CEDULA	parseCedula, formatCedula, maskCedula
INVALID_RNC	parseRNC, formatRNC, maskRNC
INVALID_NCF	parseNCF, formatNCF
INVALID_PHONE	parsePhoneNumber, formatPhoneNumber, maskPhoneNumber
INVALID_PLATE	parsePlate, formatPlate
FORMAT_CEDULA_FAILED	formatCedula
FORMAT_RNC_FAILED	formatRNC
FORMAT_NCF_FAILED	formatNCF
FORMAT_PHONE_FAILED	formatPhoneNumber
FORMAT_PLATE_FAILED	formatPlate
FORMAT_DOP_FAILED	formatDOP (valor no finito)
ITBIS_NEGATIVE	applyItbis, removeItbis, splitItbis
ITBIS_INVALID_AMOUNT	applyItbis, removeItbis, splitItbis (monto no finito)
ITBIS_INVALID_RATE	applyItbis, removeItbis, splitItbis (tasa negativa o no finita)
AMOUNT_TO_WORDS_OUT_OF_RANGE	amountToWords (negativo, no finito o mayor a 999,999,999.99)
PAYROLL_INVALID_AMOUNT	calculateTSS, calculateISR, calculateNetSalary (monto negativo o no finito)
PAYROLL_INVALID_OPTION	calculateTSS, calculateNetSalary (minimumWage / srlRate negativo o no finito)

Usar safe parsers para evitar excepciones

Si prefieres no usar try/catch, usa las variantes safe parser que retornan { ok: true, value } | { ok: false, error }.