Error Handling

All throwing functions in v3 raise a DrUtilsError instead of a plain Error. You can import it from dr-utils/errors and match on its .code field for structured handling.

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

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

DrUtilsError extends Error, so existing instanceof Error checks still work.

Error codes

Code	Thrown by
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 (non-finite value)
ITBIS_NEGATIVE	applyItbis, removeItbis, splitItbis
ITBIS_INVALID_AMOUNT	applyItbis, removeItbis, splitItbis (non-finite amount)
ITBIS_INVALID_RATE	applyItbis, removeItbis, splitItbis (negative or non-finite rate)
AMOUNT_TO_WORDS_OUT_OF_RANGE	amountToWords (negative, non-finite, or over 999,999,999.99)
PAYROLL_INVALID_AMOUNT	calculateTSS, calculateISR, calculateNetSalary (negative or non-finite amount)
PAYROLL_INVALID_OPTION	calculateTSS, calculateNetSalary (negative or non-finite minimumWage / srlRate)

Using safe parsers to avoid throws

If you prefer not to use try/catch, use the safe parser variants which return { ok: true, value } | { ok: false, error }.