tempest-react-sdk 0.34.0 → 0.36.0

package/dist/br/pix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pix.js","names":[],"sources":["../../src/br/pix.ts"],"sourcesContent":["import { validateCNPJ, validateCPF } from \"@/forms/br-validators\";\n\n/**\n * A Pix payload could not be built or read.\n *\n * Its own class so a caller can tell \"the operator typed a bad key\" apart from a\n * bug, and so an `ErrorBoundary` can render a form error instead of a crash.\n */\nexport class PixError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"PixError\";\n    }\n}\n\n/** The five key formats DICT accepts. */\nexport type PixKeyType = \"cpf\" | \"cnpj\" | \"email\" | \"phone\" | \"evp\";\n\n/** A key after normalisation, ready to go into the payload. */\nexport interface NormalizedPixKey {\n    type: PixKeyType;\n    /** The exact string written into the BR Code. */\n    value: string;\n}\n\n/** One TLV as it appeared in a payload, unknown tags included. */\nexport interface PixField {\n    /** Two-character tag, e.g. `\"59\"`. */\n    id: string;\n    /** Raw value, still encoded when the tag is itself a template. */\n    value: string;\n}\n\n/** A BR Code that carries the key — the one you print on a poster. */\nexport interface PixStaticInput {\n    kind?: \"static\";\n    /** CPF, CNPJ, e-mail, phone or EVP. Validated and normalised. */\n    key: string;\n    /** Payee name. Truncated by the spec at 25 characters — longer throws. */\n    merchantName: string;\n    /** Payee city. Truncated by the spec at 15 characters — longer throws. */\n    merchantCity: string;\n    /** Amount in BRL. Omit for a payer-chooses-the-value QR. */\n    amount?: number;\n    /** Reference the PSP echoes back, `[A-Za-z0-9]{1,25}`. Defaults to `\"***\"`. */\n    txid?: string;\n    /** Free text shown by some wallets. Goes into tag 26, sub-tag 02. */\n    description?: string;\n    /** CEP, digits only. Optional tag 61. */\n    postalCode?: string;\n    /** Single-use QR: sets tag 01 to `\"12\"` instead of `\"11\"`. */\n    oneTime?: boolean;\n}\n\n/** A BR Code that carries a URL the wallet fetches to learn the amount. */\nexport interface PixDynamicInput {\n    kind: \"dynamic\";\n    /**\n     * `payloadLocation` — the https URL the wallet GETs, **without** the scheme,\n     * exactly as BACEN specifies (`pix.example.com/qr/v2/abc`).\n     */\n    url: string;\n    merchantName: string;\n    merchantCity: string;\n    postalCode?: string;\n    /** Single-use QR. Defaults to `true`, which is what a dynamic QR normally is. */\n    oneTime?: boolean;\n}\n\n/** Everything `pixPayload` accepts. */\nexport type PixInput = PixStaticInput | PixDynamicInput;\n\n/** A payload taken apart again. */\nexport interface PixData {\n    /** `\"dynamic\"` when tag 26 carried a URL instead of a key. */\n    kind: \"static\" | \"dynamic\";\n    /** Present on a static payload. */\n    key?: string;\n    keyType?: PixKeyType;\n    /** Present on a dynamic payload. */\n    url?: string;\n    merchantName: string;\n    merchantCity: string;\n    /** Reais. `undefined` when the payer chooses the amount. */\n    amount?: number;\n    /** ISO 4217 numeric. `\"986\"` for BRL. */\n    currency: string;\n    countryCode: string;\n    merchantCategoryCode: string;\n    /** `\"***\"` on a reusable static QR that identifies no single transaction. */\n    txid?: string;\n    description?: string;\n    postalCode?: string;\n    /** Tag 01 read as `\"12\"`. */\n    oneTime: boolean;\n    /** The four hex characters that closed the payload. */\n    crc: string;\n    /** Whether those four characters match a recomputed CRC. */\n    crcValid: boolean;\n    /** Every top-level TLV, in payload order, unknown tags included. */\n    fields: PixField[];\n}\n\n/** Options for {@link parsePixPayload}. */\nexport interface ParsePixOptions {\n    /**\n     * Throw when the checksum does not match. Default `true`.\n     *\n     * Turn it off only to inspect a payload you already know is broken: a BR Code\n     * whose CRC fails has been corrupted in transit, and the account it now points\n     * at is not the account the payee published.\n     */\n    requireCrc?: boolean;\n}\n\n/**\n * Generator polynomial of CRC-16/CCITT-FALSE, `x^16 + x^12 + x^5 + 1`.\n *\n * Taken from the CRC catalogue entry `CRC-16/IBM-3740` (alias CCITT-FALSE):\n * `width=16 poly=0x1021 init=0xffff refin=false refout=false xorout=0x0000\n * check=0x29b1`. The BACEN \"Manual de Padrões para Iniciação do Pix\" names this\n * exact variant for tag 63.\n */\nconst CRC16_POLYNOMIAL = 0x1021;\n\n/** Register preset of CRC-16/CCITT-FALSE. Not zero — that is a different variant. */\nconst CRC16_INITIAL = 0xffff;\n\n/** Keeps the shift register 16 bits wide. */\nconst CRC16_MASK = 0xffff;\n\nconst TAG_PAYLOAD_FORMAT = \"00\";\nconst TAG_POINT_OF_INITIATION = \"01\";\nconst TAG_MERCHANT_ACCOUNT_INFO = \"26\";\nconst TAG_MERCHANT_CATEGORY_CODE = \"52\";\nconst TAG_TRANSACTION_CURRENCY = \"53\";\nconst TAG_TRANSACTION_AMOUNT = \"54\";\nconst TAG_COUNTRY_CODE = \"58\";\nconst TAG_MERCHANT_NAME = \"59\";\nconst TAG_MERCHANT_CITY = \"60\";\nconst TAG_POSTAL_CODE = \"61\";\nconst TAG_ADDITIONAL_DATA = \"62\";\nconst TAG_CRC = \"63\";\n\nconst MAI_TAG_GUI = \"00\";\nconst MAI_TAG_KEY = \"01\";\nconst MAI_TAG_DESCRIPTION = \"02\";\nconst MAI_TAG_URL = \"25\";\nconst ADDITIONAL_TAG_TXID = \"05\";\n\n/** Globally Unique Identifier that marks tag 26 as a Pix account. */\nconst PIX_GUI = \"br.gov.bcb.pix\";\n\nconst PAYLOAD_FORMAT_VERSION = \"01\";\nconst POINT_OF_INITIATION_REUSABLE = \"11\";\nconst POINT_OF_INITIATION_SINGLE_USE = \"12\";\nconst DEFAULT_MERCHANT_CATEGORY_CODE = \"0000\";\nconst CURRENCY_BRL = \"986\";\nconst COUNTRY_BR = \"BR\";\nconst TXID_UNSPECIFIED = \"***\";\n\nconst MAX_MERCHANT_NAME = 25;\nconst MAX_MERCHANT_CITY = 15;\nconst MAX_TXID = 25;\nconst MAX_TLV_VALUE = 99;\nconst MAX_EMAIL_KEY = 77;\n\n/**\n * CRC-16/CCITT-FALSE of a string, as four upper-case hex characters.\n *\n * Bitwise rather than table-driven: 200-odd characters at 8 shifts each is\n * nothing, and a 256-entry table is 2 KB of payload every consumer of the `/br`\n * entry would carry.\n *\n * The input is taken as UTF-8 bytes. A Pix payload is ASCII by construction —\n * {@link pixPayload} rejects anything else — but the function is exported and a\n * caller may hand it arbitrary text, and hashing UTF-16 code units would then\n * disagree with every other implementation.\n *\n * @param input - Bytes to run through the register.\n * @returns Four upper-case hex characters, zero-padded.\n *\n * @example\n * pixCrc16(\"123456789\"); // \"29B1\" — the catalogue check value\n */\nexport function pixCrc16(input: string): string {\n    const bytes = new TextEncoder().encode(input);\n    let crc = CRC16_INITIAL;\n    for (const byte of bytes) {\n        crc ^= byte << 8;\n        for (let bit = 0; bit < 8; bit += 1) {\n            crc =\n                (crc & 0x8000) !== 0\n                    ? ((crc << 1) ^ CRC16_POLYNOMIAL) & CRC16_MASK\n                    : (crc << 1) & CRC16_MASK;\n        }\n    }\n    return crc.toString(16).toUpperCase().padStart(4, \"0\");\n}\n\n/** Digits of a possibly masked value. */\nfunction digits(value: string): string {\n    return value.replace(/\\D/g, \"\");\n}\n\n/**\n * Drop diacritics and reject whatever is left outside printable ASCII.\n *\n * The BR Code character set has no room for accents, and a wallet that meets one\n * either fails to parse the QR or shows mojibake. Stripping them is lossy but\n * legible (\"São Paulo\" → \"Sao Paulo\"), which beats both alternatives; anything\n * that is not a diacritic — an emoji, a CJK character — is a mistake the caller\n * has to see, so it throws.\n */\nfunction toPayloadText(value: string, field: string): string {\n    const stripped = value.normalize(\"NFD\").replace(/\\p{Diacritic}/gu, \"\");\n    if (/[^\\x20-\\x7E]/.test(stripped)) {\n        throw new PixError(\n            `${field} has characters the BR Code cannot carry: ${JSON.stringify(value)}. ` +\n                \"Use unaccented ASCII.\",\n        );\n    }\n    return stripped;\n}\n\n/** One `ID + 2-digit length + value` triple. */\nfunction tlv(id: string, value: string): string {\n    if (value.length > MAX_TLV_VALUE) {\n        throw new PixError(\n            `Tag ${id} is ${value.length} characters; the EMV length field holds at most ${MAX_TLV_VALUE}.`,\n        );\n    }\n    return `${id}${String(value.length).padStart(2, \"0\")}${value}`;\n}\n\n/**\n * Classify a Pix key, or `null` when it matches no accepted format.\n *\n * !!! warning \"CPF and a national phone number are both eleven digits\"\n *     `\"11987654321\"` is a valid mobile number and could be a CPF. The check\n *     digits break the tie: an 11-digit string is a CPF when its DV validates and\n *     a phone otherwise. Pass phone keys as `+5511987654321` to remove the guess\n *     entirely.\n *\n * @param key - Raw key, masked or not.\n * @returns The key type, or `null`.\n */\nexport function pixKeyType(key: string): PixKeyType | null {\n    const trimmed = key.trim();\n    if (trimmed === \"\") return null;\n\n    if (trimmed.includes(\"@\")) {\n        return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]{2,}$/.test(trimmed) && trimmed.length <= MAX_EMAIL_KEY\n            ? \"email\"\n            : null;\n    }\n    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(trimmed)) {\n        return \"evp\";\n    }\n\n    const numbers = digits(trimmed);\n    if (numbers.length === 14) return validateCNPJ(numbers) ? \"cnpj\" : null;\n    if (numbers.length === 11 && validateCPF(numbers)) return \"cpf\";\n    if (trimmed.startsWith(\"+\")) {\n        return /^\\+55\\d{10,11}$/.test(`+${numbers}`) ? \"phone\" : null;\n    }\n    if (numbers.length === 10 || numbers.length === 11) return \"phone\";\n    if (numbers.length === 12 || numbers.length === 13) {\n        return numbers.startsWith(\"55\") ? \"phone\" : null;\n    }\n    return null;\n}\n\n/**\n * Validate a Pix key and return the exact string to write into the payload.\n *\n * Normalisation per type: CPF and CNPJ lose their mask, a phone becomes E.164\n * with the `+55` country code, an EVP is lower-cased, and an e-mail is\n * lower-cased because DICT stores it that way — a key that differs only in case\n * would otherwise fail to resolve.\n *\n * All validation lives in {@link pixKeyType}; past that gate the normalisation is\n * total, which is why the phone branch strips a country code purely on length\n * rather than re-checking the shape.\n *\n * @param key - Raw key, masked or not.\n * @returns The type and the normalised value.\n * @throws {PixError} When the key matches no accepted format, or when a document\n * key fails its check digits.\n *\n * @example\n * normalizePixKey(\"123.456.789-09\"); // { type: \"cpf\", value: \"12345678909\" }\n * normalizePixKey(\"(11) 98765-4321\"); // { type: \"phone\", value: \"+5511987654321\" }\n */\nexport function normalizePixKey(key: string): NormalizedPixKey {\n    const trimmed = key.trim();\n    const type = pixKeyType(trimmed);\n    if (type === null) {\n        throw new PixError(\n            `Not a Pix key: ${JSON.stringify(key)}. Expected a CPF, CNPJ, e-mail, ` +\n                \"phone (+5511987654321) or EVP (UUID).\",\n        );\n    }\n\n    if (type === \"email\") return { type, value: trimmed.toLowerCase() };\n    if (type === \"evp\") return { type, value: trimmed.toLowerCase() };\n    if (type === \"phone\") {\n        const numbers = digits(trimmed);\n        return { type, value: `+55${numbers.length > 11 ? numbers.slice(2) : numbers}` };\n    }\n    return { type, value: digits(trimmed) };\n}\n\n/** Format an amount the way tag 54 wants it: dot separator, two decimals. */\nfunction toAmountField(amount: number): string {\n    if (!Number.isFinite(amount)) {\n        throw new PixError(`Amount must be a finite number, got ${amount}.`);\n    }\n    if (amount <= 0) {\n        throw new PixError(\n            `Amount must be positive, got ${amount}. Omit \\`amount\\` for a QR whose value the payer types.`,\n        );\n    }\n    const field = amount.toFixed(2);\n    if (field.length > 13) {\n        throw new PixError(`Amount ${field} does not fit tag 54, which holds 13 characters.`);\n    }\n    return field;\n}\n\n/** Bound the two free-text identity fields the spec caps hard. */\nfunction toBoundedText(value: string, max: number, field: string): string {\n    const text = toPayloadText(value.trim(), field);\n    if (text === \"\") throw new PixError(`${field} is required.`);\n    if (text.length > max) {\n        throw new PixError(\n            `${field} is ${text.length} characters; the BR Code allows ${max}. Shorten it — ` +\n                \"truncating here would silently change what the payer sees.\",\n        );\n    }\n    return text;\n}\n\n/** Tag 62, which exists only to carry the txid. */\nfunction additionalDataField(txid: string | undefined): string {\n    const value = txid?.trim() ?? \"\";\n    if (value === \"\" || value === TXID_UNSPECIFIED) {\n        return tlv(TAG_ADDITIONAL_DATA, tlv(ADDITIONAL_TAG_TXID, TXID_UNSPECIFIED));\n    }\n    if (!new RegExp(`^[A-Za-z0-9]{1,${MAX_TXID}}$`).test(value)) {\n        throw new PixError(\n            `txid must be 1 to ${MAX_TXID} letters or digits, got ${JSON.stringify(txid)}.`,\n        );\n    }\n    return tlv(TAG_ADDITIONAL_DATA, tlv(ADDITIONAL_TAG_TXID, value));\n}\n\n/** Tag 26 for a static payload: GUI, key and the optional description. */\nfunction staticMerchantAccount(input: PixStaticInput): string {\n    const { value } = normalizePixKey(input.key);\n    let inner = tlv(MAI_TAG_GUI, PIX_GUI) + tlv(MAI_TAG_KEY, value);\n    const description = input.description?.trim();\n    if (description !== undefined && description !== \"\") {\n        inner += tlv(MAI_TAG_DESCRIPTION, toPayloadText(description, \"description\"));\n    }\n    if (inner.length > MAX_TLV_VALUE) {\n        throw new PixError(\n            `Tag 26 is ${inner.length} characters, over the ${MAX_TLV_VALUE} the length field allows. ` +\n                \"Shorten `description`.\",\n        );\n    }\n    return tlv(TAG_MERCHANT_ACCOUNT_INFO, inner);\n}\n\n/** Tag 26 for a dynamic payload: GUI plus the URL, and no key. */\nfunction dynamicMerchantAccount(input: PixDynamicInput): string {\n    const url = toPayloadText(input.url.trim(), \"url\").replace(/^https?:\\/\\//i, \"\");\n    if (url === \"\") throw new PixError(\"url is required for a dynamic BR Code.\");\n    const inner = tlv(MAI_TAG_GUI, PIX_GUI) + tlv(MAI_TAG_URL, url);\n    if (inner.length > MAX_TLV_VALUE) {\n        throw new PixError(\n            `Tag 26 is ${inner.length} characters, over the ${MAX_TLV_VALUE} the length field allows. ` +\n                \"Shorten the payload URL.\",\n        );\n    }\n    return tlv(TAG_MERCHANT_ACCOUNT_INFO, inner);\n}\n\n/**\n * Build a Pix \"Copia e Cola\" payload — the string behind a Pix QR code.\n *\n * The format is EMVCo MPM: a flat list of `ID + 2-digit length + value` triples,\n * closed by tag 63 holding a CRC-16/CCITT-FALSE over **everything before it,\n * including the literal `6304` header of tag 63 itself**. That last detail is the\n * one implementations get wrong; see {@link pixCrc16}.\n *\n * Two shapes come out of here:\n *\n * - **static** — tag 26 carries the key, so the QR is self-contained and can be\n *   printed. Amount optional; a txid of `\"***\"` means \"identifies no single\n *   transaction\", which is what a reusable poster QR wants.\n * - **dynamic** — tag 26 carries a URL instead, and the wallet fetches the amount\n *   and payee from the PSP. Use it when the value is per-order. Defaults to\n *   single-use (tag 01 = `12`).\n *\n * The distinction matters and is not cosmetic: a static QR settles against\n * whatever the payer typed, a dynamic one against what the PSP served, so a\n * charge that must reconcile to a cent needs the dynamic form.\n *\n * @param input - Static or dynamic payload description.\n * @returns The full payload, CRC included, ready to render as a QR or to copy.\n * @throws {PixError} On an unrecognised key, a field over its length cap, a\n * non-positive amount, or text that is not representable in the BR Code.\n *\n * @example\n * pixPayload({\n *   key: \"12345678909\",\n *   merchantName: \"Loja Tempest\",\n *   merchantCity: \"São Paulo\",\n *   amount: 25.5,\n *   txid: \"PEDIDO123\",\n * });\n */\nexport function pixPayload(input: PixInput): string {\n    const dynamic = input.kind === \"dynamic\";\n    const oneTime = input.oneTime ?? dynamic;\n\n    let payload = tlv(TAG_PAYLOAD_FORMAT, PAYLOAD_FORMAT_VERSION);\n    payload += tlv(\n        TAG_POINT_OF_INITIATION,\n        oneTime ? POINT_OF_INITIATION_SINGLE_USE : POINT_OF_INITIATION_REUSABLE,\n    );\n    payload += dynamic ? dynamicMerchantAccount(input) : staticMerchantAccount(input);\n    payload += tlv(TAG_MERCHANT_CATEGORY_CODE, DEFAULT_MERCHANT_CATEGORY_CODE);\n    payload += tlv(TAG_TRANSACTION_CURRENCY, CURRENCY_BRL);\n    if (!dynamic && input.amount !== undefined) {\n        payload += tlv(TAG_TRANSACTION_AMOUNT, toAmountField(input.amount));\n    }\n    payload += tlv(TAG_COUNTRY_CODE, COUNTRY_BR);\n    payload += tlv(\n        TAG_MERCHANT_NAME,\n        toBoundedText(input.merchantName, MAX_MERCHANT_NAME, \"merchantName\"),\n    );\n    payload += tlv(\n        TAG_MERCHANT_CITY,\n        toBoundedText(input.merchantCity, MAX_MERCHANT_CITY, \"merchantCity\"),\n    );\n    const postalCode = input.postalCode === undefined ? \"\" : digits(input.postalCode);\n    if (postalCode !== \"\") payload += tlv(TAG_POSTAL_CODE, postalCode);\n    payload += additionalDataField(dynamic ? TXID_UNSPECIFIED : input.txid);\n\n    const withCrcHeader = `${payload}${TAG_CRC}04`;\n    return `${withCrcHeader}${pixCrc16(withCrcHeader)}`;\n}\n\n/**\n * Split a flat run of TLVs. Stops cleanly at the first malformed triple.\n *\n * @throws {PixError} When a length prefix is not two digits or runs past the end.\n */\nfunction parseTlv(input: string, where: string): PixField[] {\n    const fields: PixField[] = [];\n    let cursor = 0;\n    while (cursor < input.length) {\n        const id = input.slice(cursor, cursor + 2);\n        const rawLength = input.slice(cursor + 2, cursor + 4);\n        if (!/^\\d{2}$/.test(id) || !/^\\d{2}$/.test(rawLength)) {\n            throw new PixError(\n                `Malformed TLV in ${where} at offset ${cursor}: expected a 2-digit tag and length.`,\n            );\n        }\n        const length = Number(rawLength);\n        const start = cursor + 4;\n        if (start + length > input.length) {\n            throw new PixError(\n                `Tag ${id} in ${where} declares ${length} characters but only ${input.length - start} remain.`,\n            );\n        }\n        fields.push({ id, value: input.slice(start, start + length) });\n        cursor = start + length;\n    }\n    return fields;\n}\n\n/** First value for a tag, or `undefined`. */\nfunction pick(fields: readonly PixField[], id: string): string | undefined {\n    return fields.find((field) => field.id === id)?.value;\n}\n\n/**\n * Read a Pix \"Copia e Cola\" payload back into its parts.\n *\n * Tolerant by design: tags the SDK does not know about are kept verbatim in\n * {@link PixData.fields} instead of raising, because PSPs do add their own\n * templates and a reader that rejects them is useless in production. What is\n * *not* tolerated is a broken frame — a length prefix that runs off the end, a\n * missing tag 63 — or a checksum mismatch, which means the string was corrupted\n * and no longer names the account the payee published.\n *\n * @param payload - The copia-e-cola string. Surrounding whitespace is ignored.\n * @param options - See {@link ParsePixOptions}.\n * @returns The decoded payload.\n * @throws {PixError} On a malformed frame, a missing CRC tag, a tag 26 that is\n * not a Pix account, or — unless `requireCrc` is `false` — a CRC mismatch.\n *\n * @example\n * const data = parsePixPayload(copied);\n * console.log(data.key, data.amount, data.txid);\n */\nexport function parsePixPayload(payload: string, options: ParsePixOptions = {}): PixData {\n    const { requireCrc = true } = options;\n    const text = payload.trim();\n    if (text.length < 8) throw new PixError(\"Payload is too short to be a BR Code.\");\n\n    const crcHeaderAt = text.length - 8;\n    if (text.slice(crcHeaderAt, crcHeaderAt + 4) !== `${TAG_CRC}04`) {\n        throw new PixError(\"Payload does not end in a `6304` CRC tag.\");\n    }\n    const crc = text.slice(-4).toUpperCase();\n    const expected = pixCrc16(text.slice(0, -4));\n    const crcValid = crc === expected;\n    if (!crcValid && requireCrc) {\n        throw new PixError(`CRC mismatch: payload says ${crc}, recomputed ${expected}.`);\n    }\n\n    const fields = parseTlv(text.slice(0, crcHeaderAt), \"payload\");\n    const merchantAccount = pick(fields, TAG_MERCHANT_ACCOUNT_INFO);\n    if (merchantAccount === undefined) {\n        throw new PixError(\"Payload has no tag 26 (merchant account information).\");\n    }\n    const account = parseTlv(merchantAccount, \"tag 26\");\n    const gui = pick(account, MAI_TAG_GUI);\n    if (gui?.toLowerCase() !== PIX_GUI) {\n        throw new PixError(\n            `Tag 26 is not a Pix account: expected GUI ${PIX_GUI}, got ${JSON.stringify(gui)}.`,\n        );\n    }\n\n    const url = pick(account, MAI_TAG_URL);\n    const key = pick(account, MAI_TAG_KEY);\n    const amountField = pick(fields, TAG_TRANSACTION_AMOUNT);\n    const txid = pick(\n        parseTlv(pick(fields, TAG_ADDITIONAL_DATA) ?? \"\", \"tag 62\"),\n        ADDITIONAL_TAG_TXID,\n    );\n\n    return {\n        kind: url !== undefined && key === undefined ? \"dynamic\" : \"static\",\n        ...(key === undefined ? {} : { key, keyType: pixKeyType(key) ?? undefined }),\n        ...(url === undefined ? {} : { url }),\n        merchantName: pick(fields, TAG_MERCHANT_NAME) ?? \"\",\n        merchantCity: pick(fields, TAG_MERCHANT_CITY) ?? \"\",\n        ...(amountField === undefined ? {} : { amount: Number(amountField) }),\n        currency: pick(fields, TAG_TRANSACTION_CURRENCY) ?? \"\",\n        countryCode: pick(fields, TAG_COUNTRY_CODE) ?? \"\",\n        merchantCategoryCode: pick(fields, TAG_MERCHANT_CATEGORY_CODE) ?? \"\",\n        ...(txid === undefined ? {} : { txid }),\n        ...(pick(account, MAI_TAG_DESCRIPTION) === undefined\n            ? {}\n            : { description: pick(account, MAI_TAG_DESCRIPTION) }),\n        ...(pick(fields, TAG_POSTAL_CODE) === undefined\n            ? {}\n            : { postalCode: pick(fields, TAG_POSTAL_CODE) }),\n        oneTime: pick(fields, TAG_POINT_OF_INITIATION) === POINT_OF_INITIATION_SINGLE_USE,\n        crc,\n        crcValid,\n        fields,\n    };\n}\n"],"mappings":"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"}

package/dist/br.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./br/locations.cjs"),t=require("./br/state-geo.cjs"),n=require("./br/geocode.cjs"),r=require("./br/MapMarkers.cjs"),i=require("./br/regions.cjs"),a=require("./br/BrazilMap.cjs"),o=require("./br/BrazilStateMap.cjs"),s=require("./br/BrazilStateCitySelect.cjs"),c=require("./br/MunicipalitySearch.cjs"),l=require("./br/scales.cjs"),u=require("./br/MapLegend.cjs");async function d(){return(await Promise.resolve().then(()=>require("./br/br-geo.cjs"))).BR_UF_GEOJSON}exports.BrazilMap=a.BrazilMap,exports.BrazilStateCitySelect=s.BrazilStateCitySelect,exports.BrazilStateMap=o.BrazilStateMap,exports.DIVERGING_RDBU=l.DIVERGING_RDBU,exports.MapLegend=u.MapLegend,exports.MapMarkers=r.MapMarkers,exports.MunicipalitySearch=c.MunicipalitySearch,exports.REGION_COLORS=i.REGION_COLORS,exports.SEQUENTIAL_BLUES=l.SEQUENTIAL_BLUES,exports.SEQUENTIAL_GREENS=l.SEQUENTIAL_GREENS,exports.SEQUENTIAL_VIRIDIS=l.SEQUENTIAL_VIRIDIS,exports.citiesByUf=e.citiesByUf,exports.cityChoices=e.cityChoices,exports.geocodeMunicipality=n.geocodeMunicipality,exports.getState=e.getState,exports.interpolatePalette=l.interpolatePalette,exports.isValidCity=e.isValidCity,exports.isValidUf=e.isValidUf,exports.listStates=e.listStates,exports.loadBrUfGeoJson=d,exports.loadStateMunicipalities=t.loadStateMunicipalities,exports.municipalityCentroid=n.municipalityCentroid,exports.nearestMunicipality=n.nearestMunicipality,exports.normalizeUf=e.normalizeUf,exports.quantizeScale=l.quantizeScale,exports.regionLegendItems=i.regionLegendItems,exports.reverseGeocode=n.reverseGeocode,exports.searchMunicipalities=n.searchMunicipalities,exports.sequentialScale=l.sequentialScale,exports.stateCentroid=n.stateCentroid,exports.statesByRegion=e.statesByRegion,exports.thresholdScale=l.thresholdScale,exports.ufChoices=e.ufChoices;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./br/locations.cjs"),t=require("./br/state-geo.cjs"),n=require("./br/geocode.cjs"),r=require("./br/MapMarkers.cjs"),i=require("./br/regions.cjs"),a=require("./br/BrazilMap.cjs"),o=require("./br/BrazilStateMap.cjs"),s=require("./br/BrazilStateCitySelect.cjs"),c=require("./br/MunicipalitySearch.cjs"),l=require("./br/scales.cjs"),u=require("./br/MapLegend.cjs"),d=require("./br/pix.cjs"),f=require("./br/PixQRCode.cjs"),p=require("./br/boleto.cjs"),m=require("./br/nfe.cjs"),h=require("./br/holidays.cjs");async function g(){return(await Promise.resolve().then(()=>require("./br/br-geo.cjs"))).BR_UF_GEOJSON}exports.BoletoError=p.BoletoError,exports.BrazilMap=a.BrazilMap,exports.BrazilStateCitySelect=s.BrazilStateCitySelect,exports.BrazilStateMap=o.BrazilStateMap,exports.ChaveNFeError=m.ChaveNFeError,exports.DIVERGING_RDBU=l.DIVERGING_RDBU,exports.MapLegend=u.MapLegend,exports.MapMarkers=r.MapMarkers,exports.MunicipalitySearch=c.MunicipalitySearch,exports.PixError=d.PixError,exports.PixQRCode=f.PixQRCode,exports.REGION_COLORS=i.REGION_COLORS,exports.SEQUENTIAL_BLUES=l.SEQUENTIAL_BLUES,exports.SEQUENTIAL_GREENS=l.SEQUENTIAL_GREENS,exports.SEQUENTIAL_VIRIDIS=l.SEQUENTIAL_VIRIDIS,exports.addBusinessDays=h.addBusinessDays,exports.boletoDueDate=p.boletoDueDate,exports.boletoKind=p.boletoKind,exports.chaveNFeCheckDigit=m.chaveNFeCheckDigit,exports.citiesByUf=e.citiesByUf,exports.cityChoices=e.cityChoices,exports.codigoBarrasToLinhaDigitavel=p.codigoBarrasToLinhaDigitavel,exports.easterSunday=h.easterSunday,exports.fatorVencimento=p.fatorVencimento,exports.formatChaveNFe=m.formatChaveNFe,exports.formatLinhaDigitavel=p.formatLinhaDigitavel,exports.geocodeMunicipality=n.geocodeMunicipality,exports.getState=e.getState,exports.holidaysFor=h.holidaysFor,exports.interpolatePalette=l.interpolatePalette,exports.isBusinessDay=h.isBusinessDay,exports.isHoliday=h.isHoliday,exports.isValidCity=e.isValidCity,exports.isValidUf=e.isValidUf,exports.linhaDigitavelToCodigoBarras=p.linhaDigitavelToCodigoBarras,exports.listStates=e.listStates,exports.loadBrUfGeoJson=g,exports.loadStateMunicipalities=t.loadStateMunicipalities,exports.mod10Dac=p.mod10Dac,exports.mod11DacArrecadacao=p.mod11DacArrecadacao,exports.mod11DacCobranca=p.mod11DacCobranca,exports.municipalityCentroid=n.municipalityCentroid,exports.nearestMunicipality=n.nearestMunicipality,exports.nextBusinessDay=h.nextBusinessDay,exports.normalizePixKey=d.normalizePixKey,exports.normalizeUf=e.normalizeUf,exports.parseChaveNFe=m.parseChaveNFe,exports.parseCodigoBarras=p.parseCodigoBarras,exports.parseLinhaDigitavel=p.parseLinhaDigitavel,exports.parsePixPayload=d.parsePixPayload,exports.pixCrc16=d.pixCrc16,exports.pixKeyType=d.pixKeyType,exports.pixPayload=d.pixPayload,exports.quantizeScale=l.quantizeScale,exports.regionLegendItems=i.regionLegendItems,exports.reverseGeocode=n.reverseGeocode,exports.searchMunicipalities=n.searchMunicipalities,exports.sequentialScale=l.sequentialScale,exports.stateCentroid=n.stateCentroid,exports.statesByRegion=e.statesByRegion,exports.thresholdScale=l.thresholdScale,exports.ufChoices=e.ufChoices,exports.validateBoleto=p.validateBoleto,exports.validateChaveNFe=m.validateChaveNFe;
 //# sourceMappingURL=br.cjs.map

package/dist/br.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"br.cjs","names":[],"sources":["../src/br/index.ts"],"sourcesContent":["// Brazilian locations data (states + cities) — mirrors the `utils/locations`\n// module of tempest-fastapi-sdk.\nexport {\n    listStates,\n    getState,\n    citiesByUf,\n    statesByRegion,\n    isValidUf,\n    normalizeUf,\n    isValidCity,\n    ufChoices,\n    cityChoices,\n} from \"./locations\";\nexport type { UF, BrRegion, BrazilState, Choice } from \"./locations\";\n\n// UF GeoJSON types (the geometry itself is lazy-loaded by BrazilMap).\nimport type { BrUfFeatureCollection } from \"./br-geo\";\nexport type { BrUfFeature, BrUfFeatureCollection, BrUfGeometry, Ring } from \"./br-geo\";\n\n/**\n * Lazily load the bundled simplified UF GeoJSON (~36 KB gzip). Kept out of the\n * synchronous barrel so a data-only import never pulls the geometry.\n */\nexport async function loadBrUfGeoJson(): Promise<BrUfFeatureCollection> {\n    const mod = await import(\"./br-geo\");\n    return mod.BR_UF_GEOJSON;\n}\n\n// Per-state municipality geometry (lazy, one chunk per UF).\nexport { loadStateMunicipalities } from \"./state-geo\";\nexport type { MunicipalityFeature, StateMunicipalities } from \"./state-geo\";\n\n// Offline geocoding (lazy centroid index).\nexport {\n    nearestMunicipality,\n    reverseGeocode,\n    geocodeMunicipality,\n    searchMunicipalities,\n    municipalityCentroid,\n    stateCentroid,\n} from \"./geocode\";\nexport type { MunicipalityCentroid, NearestMunicipality, ReverseGeocodeResult } from \"./geocode\";\n\n// Components\nexport { BrazilMap } from \"./BrazilMap\";\nexport type { BrazilMapProps, BrazilMapTooltipData } from \"./BrazilMap\";\nexport { BrazilStateMap } from \"./BrazilStateMap\";\nexport type {\n    BrazilStateMapProps,\n    BrazilStateMapTooltipData,\n    Municipality,\n} from \"./BrazilStateMap\";\nexport { BrazilStateCitySelect } from \"./BrazilStateCitySelect\";\nexport type { BrazilStateCitySelectProps, BrazilStateCitySelection } from \"./BrazilStateCitySelect\";\nexport { MunicipalitySearch } from \"./MunicipalitySearch\";\nexport type { MunicipalitySearchProps } from \"./MunicipalitySearch\";\nexport type { GeoMarker } from \"@/geo/types\";\nexport { MapMarkers } from \"./MapMarkers\";\nexport type { MapMarkersProps } from \"./MapMarkers\";\nexport { MapLegend } from \"./MapLegend\";\nexport type { MapLegendProps, LegendItem } from \"./MapLegend\";\n\n// Color scales + palettes for choropleths.\nexport {\n    interpolatePalette,\n    sequentialScale,\n    quantizeScale,\n    thresholdScale,\n    SEQUENTIAL_BLUES,\n    SEQUENTIAL_GREENS,\n    SEQUENTIAL_VIRIDIS,\n    DIVERGING_RDBU,\n} from \"./scales\";\nexport type { ColorScale } from \"./scales\";\nexport { REGION_COLORS, regionLegendItems } from \"./regions\";\n"],"mappings":"6bAuBA,eAAsB,GAAkD,CAEpE,OAAO,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QADW,iBAAA,CAAA,EAAA,CACP,aACf"}
+{"version":3,"file":"br.cjs","names":[],"sources":["../src/br/index.ts"],"sourcesContent":["// Brazilian locations data (states + cities) — mirrors the `utils/locations`\n// module of tempest-fastapi-sdk.\nexport {\n    listStates,\n    getState,\n    citiesByUf,\n    statesByRegion,\n    isValidUf,\n    normalizeUf,\n    isValidCity,\n    ufChoices,\n    cityChoices,\n} from \"./locations\";\nexport type { UF, BrRegion, BrazilState, Choice } from \"./locations\";\n\n// UF GeoJSON types (the geometry itself is lazy-loaded by BrazilMap).\nimport type { BrUfFeatureCollection } from \"./br-geo\";\nexport type { BrUfFeature, BrUfFeatureCollection, BrUfGeometry, Ring } from \"./br-geo\";\n\n/**\n * Lazily load the bundled simplified UF GeoJSON (~36 KB gzip). Kept out of the\n * synchronous barrel so a data-only import never pulls the geometry.\n */\nexport async function loadBrUfGeoJson(): Promise<BrUfFeatureCollection> {\n    const mod = await import(\"./br-geo\");\n    return mod.BR_UF_GEOJSON;\n}\n\n// Per-state municipality geometry (lazy, one chunk per UF).\nexport { loadStateMunicipalities } from \"./state-geo\";\nexport type { MunicipalityFeature, StateMunicipalities } from \"./state-geo\";\n\n// Offline geocoding (lazy centroid index).\nexport {\n    nearestMunicipality,\n    reverseGeocode,\n    geocodeMunicipality,\n    searchMunicipalities,\n    municipalityCentroid,\n    stateCentroid,\n} from \"./geocode\";\nexport type { MunicipalityCentroid, NearestMunicipality, ReverseGeocodeResult } from \"./geocode\";\n\n// Components\nexport { BrazilMap } from \"./BrazilMap\";\nexport type { BrazilMapProps, BrazilMapTooltipData } from \"./BrazilMap\";\nexport { BrazilStateMap } from \"./BrazilStateMap\";\nexport type {\n    BrazilStateMapProps,\n    BrazilStateMapTooltipData,\n    Municipality,\n} from \"./BrazilStateMap\";\nexport { BrazilStateCitySelect } from \"./BrazilStateCitySelect\";\nexport type { BrazilStateCitySelectProps, BrazilStateCitySelection } from \"./BrazilStateCitySelect\";\nexport { MunicipalitySearch } from \"./MunicipalitySearch\";\nexport type { MunicipalitySearchProps } from \"./MunicipalitySearch\";\nexport type { GeoMarker } from \"@/geo/types\";\nexport { MapMarkers } from \"./MapMarkers\";\nexport type { MapMarkersProps } from \"./MapMarkers\";\nexport { MapLegend } from \"./MapLegend\";\nexport type { MapLegendProps, LegendItem } from \"./MapLegend\";\n\n// Pix — BR Code (EMV MPM) payload + the QR that carries it.\nexport {\n    normalizePixKey,\n    parsePixPayload,\n    PixError,\n    pixCrc16,\n    pixKeyType,\n    pixPayload,\n} from \"./pix\";\nexport type {\n    NormalizedPixKey,\n    ParsePixOptions,\n    PixData,\n    PixDynamicInput,\n    PixField,\n    PixInput,\n    PixKeyType,\n    PixStaticInput,\n} from \"./pix\";\nexport { PixQRCode } from \"./PixQRCode\";\nexport type { PixQRCodeLabels, PixQRCodeProps } from \"./PixQRCode\";\n\n// Boleto — 47/48-digit typed line, 44-digit barcode, FEBRABAN check digits.\nexport {\n    boletoDueDate,\n    BoletoError,\n    boletoKind,\n    codigoBarrasToLinhaDigitavel,\n    fatorVencimento,\n    formatLinhaDigitavel,\n    linhaDigitavelToCodigoBarras,\n    mod10Dac,\n    mod11DacArrecadacao,\n    mod11DacCobranca,\n    parseCodigoBarras,\n    parseLinhaDigitavel,\n    validateBoleto,\n} from \"./boleto\";\nexport type {\n    Boleto,\n    BoletoArrecadacao,\n    BoletoBanco,\n    BoletoEpoch,\n    BoletoKind,\n    BoletoOptions,\n} from \"./boleto\";\n\n// NF-e / NFC-e / CT-e access key.\nexport {\n    chaveNFeCheckDigit,\n    ChaveNFeError,\n    formatChaveNFe,\n    parseChaveNFe,\n    validateChaveNFe,\n} from \"./nfe\";\nexport type { ChaveNFe } from \"./nfe\";\n\n// National holidays + business-day arithmetic.\nexport {\n    addBusinessDays,\n    easterSunday,\n    holidaysFor,\n    isBusinessDay,\n    isHoliday,\n    nextBusinessDay,\n} from \"./holidays\";\nexport type { BusinessDayOptions, DateInput, Holiday, HolidayKind } from \"./holidays\";\n\n// Color scales + palettes for choropleths.\nexport {\n    interpolatePalette,\n    sequentialScale,\n    quantizeScale,\n    thresholdScale,\n    SEQUENTIAL_BLUES,\n    SEQUENTIAL_GREENS,\n    SEQUENTIAL_VIRIDIS,\n    DIVERGING_RDBU,\n} from \"./scales\";\nexport type { ColorScale } from \"./scales\";\nexport { REGION_COLORS, regionLegendItems } from \"./regions\";\n"],"mappings":"6kBAuBA,eAAsB,GAAkD,CAEpE,OAAO,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QADW,iBAAA,CAAA,EAAA,CACP,aACf"}