README.md

Dominican Republic Utils

Language: English / Español

Dominican Republic Utils (dr-utils) is a zero-dependency TypeScript library for utilities relevant to the Dominican Republic: validation, formatting, parsing, masking, ITBIS tax calculations, currency formatting, and more.

Full documentation: https://maikuh.github.io/dr-utils/

Installation

npm i dr-utils
yarn add dr-utils
pnpm add dr-utils
bun add dr-utils

Quick example

import { validateCedula, parseCedula, formatDOP, applyItbis } from 'dr-utils'

validateCedula('402-2057991-2') // true

const { municipioCode, sequence, formatted } = parseCedula('40220579912')
// { municipioCode: '402', sequence: '2057991', formatted: '402-2057991-2' }

formatDOP(1234.5)   // 'RD$1,234.50'
applyItbis(100)     // 118

Migrating from v2

See the migration guide for breaking changes and new features in v3.

Contributing

See CONTRIBUTING

Copyright

See LICENSE