@vn-skills/core
v0.7.0
Published
Offline, dependency-free Vietnam business logic: VietQR, addresses (34 provinces), tax IDs, CCCD citizen IDs, phone numbers, public holidays and working days, money in words, number formatting, names, lunar calendar, e-invoice.
Maintainers
beiryuReadme
@vn-skills/core
Pure TypeScript helpers for Vietnam-specific business logic. No network, no file system; data is bundled.
import { buildVietQR, parseVietQR, findBank } from '@vn-skills/core'; // VietQR (NAPAS 247 / EMVCo)
import { parseAddress, convertAddress, PROVINCES } from '@vn-skills/core'; // 34 provinces (01/07/2025), old→new mapping
import { validateTaxId } from '@vn-skills/core'; // mã số thuế check digit
import { moneyToWords } from '@vn-skills/core'; // số tiền bằng chữ
import { solarToLunar, lunarToSolar, lunarInfo, holidays } from '@vn-skills/core'; // âm lịch
import { validateInvoice, computeTotals, MockProvider } from '@vn-skills/core'; // hóa đơn điện tửEvery function returns { ok: true, ... } or { ok: false, error: { code, message, hint } }.
Part of vn-skills — Agent Skills + CLI + MCP server. Data sources: data/SOURCES.md.