tempest-react-sdk 0.77.0 → 0.79.0

package/dist/br/boleto.js.map

@@ -1 +1 @@
-{"version":3,"file":"boleto.js","names":[],"sources":["../../src/br/boleto.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — the FEBRABAN spec in one file: the 47-digit linha\n * digitável, the 44-digit barcode, the two layouts (bank slips and arrecadação),\n * modulo-10 and modulo-11 check digits, the base date the due date counts from, and\n * the value scaling. Every piece cross-checks another — the conversion between the\n * two forms is what proves the check digits — so splitting it hides the one property\n * the file exists to guarantee.\n */\n/**\n * A boleto string could not be read, or failed a check digit.\n *\n * Its own class so a scanner screen can tell \"this is not a boleto\" apart from a\n * bug, and so the message can be shown to the operator as-is.\n */\nexport class BoletoError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"BoletoError\";\n    }\n}\n\n/**\n * The two incompatible layouts that share the 44-digit barcode.\n *\n * `\"banco\"` is the cobrança boleto every bank issues; `\"arrecadacao\"` is the\n * concessionária/tributo slip, which starts with `8` and lays out its 44 digits\n * completely differently — same length, different meaning for every field.\n */\nexport type BoletoKind = \"banco\" | \"arrecadacao\";\n\n/** Which base date the fator de vencimento counts from. See {@link boletoDueDate}. */\nexport type BoletoEpoch = \"auto\" | \"legacy\" | \"current\";\n\n/** Options shared by every parser here. */\nexport interface BoletoOptions {\n    /** Fator de vencimento epoch. Default `\"auto\"`. */\n    epoch?: BoletoEpoch;\n    /** Date `\"auto\"` measures proximity against. Default `new Date()`. */\n    reference?: Date;\n}\n\n/** A cobrança boleto — the kind a bank issues against an invoice. */\nexport interface BoletoBanco {\n    kind: \"banco\";\n    /** 44 digits. */\n    codigoBarras: string;\n    /** 47 digits. */\n    linhaDigitavel: string;\n    /** 3-digit bank code in the clearing house, e.g. `\"341\"`. */\n    banco: string;\n    /** 1 digit. `\"9\"` is BRL; nothing else is in use. */\n    moeda: string;\n    /** `\"Real\"` for `\"9\"`, `null` for anything else. */\n    moedaLabel: string | null;\n    /** The general check digit, position 5 of the barcode. */\n    dv: string;\n    /** Raw 4-digit field. `0` means the boleto carries no due date. */\n    fatorVencimento: number;\n    /** Due date, or `null` when the fator is `0`. */\n    vencimento: Date | null;\n    /** Which epoch {@link vencimento} was resolved under. `null` when there is none. */\n    vencimentoEpoch: Exclude<BoletoEpoch, \"auto\"> | null;\n    /** Reais. `0` when the issuer left the amount for the payer to fill in. */\n    valor: number;\n    /** 25 digits the issuing bank defines. Not interpretable without its manual. */\n    campoLivre: string;\n}\n\n/** An arrecadação/convênio slip — utilities, taxes, traffic fines. */\nexport interface BoletoArrecadacao {\n    kind: \"arrecadacao\";\n    /** 44 digits, always starting with `8`. */\n    codigoBarras: string;\n    /** 48 digits, in four blocks of twelve. */\n    linhaDigitavel: string;\n    /** Position 2. See {@link segmentoLabel}. */\n    segmento: number;\n    /** Human label, or `null` for a value the layout does not define. */\n    segmentoLabel: string | null;\n    /** Position 3: `6`/`8` mean real money, `7`/`9` mean a reference quantity. */\n    identificacaoValor: number;\n    /** Which modulo position 3 selects for the general check digit. */\n    dvModulo: 10 | 11;\n    /** The general check digit, position 4. */\n    dv: string;\n    /** Reais, or `null` when position 3 says the field is a reference, not money. */\n    valor: number | null;\n    /** The raw 11-digit value field, useful when {@link valor} is `null`. */\n    valorRaw: string;\n    /**\n     * Positions 16-19 — the 4-digit code FEBRABAN assigns the company — or, on\n     * segmento 6, positions 16-23, which are the first eight CNPJ digits.\n     */\n    empresa: string;\n    /** `true` when {@link empresa} is a CNPJ prefix rather than a FEBRABAN code. */\n    empresaIsCnpj: boolean;\n    /** 25 digits, or 21 when the CNPJ took four of them. Issuer-defined. */\n    campoLivre: string;\n    /**\n     * Due date read from the first eight digits of the campo livre.\n     *\n     * The layout says a due date, **if present**, must sit there as `AAAAMMDD` —\n     * but the field is optional and nothing marks its presence, so a campo livre\n     * that merely looks like a date lands here too. Treat it as a hint for a UI,\n     * never as the date a payment settles against.\n     */\n    vencimentoCampoLivre: Date | null;\n}\n\n/** What the two parsers return. Narrow on `kind`. */\nexport type Boleto = BoletoBanco | BoletoArrecadacao;\n\n/** Base date of the fator de vencimento as FEBRABAN defined it in 1997. */\nconst LEGACY_EPOCH_UTC = Date.UTC(1997, 9, 7);\n\n/**\n * Base date the fator de vencimento restarted from.\n *\n * FEBRABAN communication FB-009/2023: the 4-digit field hit its ceiling of 9999\n * on 2025-02-21 (1997-10-07 + 9999 days), so from 2025-02-22 the counter restarts\n * at 1000 against a new base of 2022-05-29 (2022-05-29 + 1000 days = 2025-02-22).\n */\nconst CURRENT_EPOCH_UTC = Date.UTC(2022, 4, 29);\n\nconst MS_PER_DAY = 86_400_000;\n\n/** First fator FEBRABAN ever put in circulation, in either epoch. */\nconst FATOR_MIN = 1000;\n\n/** Last fator the 4-digit field can hold. */\nconst FATOR_MAX = 9999;\n\nconst MOD10_WEIGHTS = [2, 1] as const;\nconst MOD11_WEIGHT_FIRST = 2;\nconst MOD11_WEIGHT_LAST = 9;\n\nconst SEGMENTO_LABELS: Record<number, string> = {\n    1: \"Prefeituras\",\n    2: \"Saneamento\",\n    3: \"Energia elétrica e gás\",\n    4: \"Telecomunicações\",\n    5: \"Órgãos governamentais\",\n    6: \"Carnes e assemelhados ou empresas identificadas por CNPJ\",\n    7: \"Multas de trânsito\",\n    9: \"Uso exclusivo do banco\",\n};\n\n/** Segmento whose company identifier is a CNPJ prefix instead of a FEBRABAN code. */\nconst SEGMENTO_CNPJ = 6;\n\n/** Digits of a value that may carry the usual dots, spaces and dashes. */\nfunction digits(value: string): string {\n    return value.replace(/\\D/g, \"\");\n}\n\n/**\n * DAC módulo 10, FEBRABAN flavour.\n *\n * Multipliers cycle `2, 1, 2, 1, …` from right to left; the **digits** of each\n * product are summed individually (so `6 × 2 = 12` contributes `1 + 2`); the DAC\n * is `10 - (sum mod 10)`, and `0` when that remainder is `0`.\n *\n * Ported from \"Layout Padrão de Arrecadação/Recebimento com Utilização do Código\n * de Barras\", FEBRABAN version 07 (effective 2023-03-01), section 07 — whose own\n * worked example gives `01230067896 → 3`.\n *\n * @param value - Digits only.\n * @returns The check digit, 0-9.\n * @throws {BoletoError} When `value` is empty or holds a non-digit.\n */\nexport function mod10Dac(value: string): number {\n    if (!/^\\d+$/.test(value))\n        throw new BoletoError(`mod10Dac needs digits, got ${JSON.stringify(value)}.`);\n    let sum = 0;\n    for (let index = 0; index < value.length; index += 1) {\n        const fromRight = value.length - 1 - index;\n        const product = Number(value[index]) * MOD10_WEIGHTS[fromRight % MOD10_WEIGHTS.length]!;\n        sum += product > 9 ? product - 9 : product;\n    }\n    const remainder = sum % 10;\n    return remainder === 0 ? 0 : 10 - remainder;\n}\n\n/** Sum of `digit × weight` with weights cycling 2…9 from the right. */\nfunction mod11Sum(value: string): number {\n    const span = MOD11_WEIGHT_LAST - MOD11_WEIGHT_FIRST + 1;\n    let sum = 0;\n    for (let index = 0; index < value.length; index += 1) {\n        const fromRight = value.length - 1 - index;\n        sum += Number(value[index]) * (MOD11_WEIGHT_FIRST + (fromRight % span));\n    }\n    return sum;\n}\n\n/**\n * DAC módulo 11 for a **cobrança** barcode — position 5 of a bank boleto.\n *\n * Weights cycle `2…9` from right to left, the products are summed whole, and the\n * DAC is `11 - (sum mod 11)`. A remainder of `0`, `1` or `10` would put `11`, `10`\n * or `1` in a one-digit field, and FEBRABAN resolves all three to **`1`**.\n *\n * That last rule is where cobrança and arrecadação disagree — see\n * {@link mod11DacArrecadacao}, which resolves the same remainders to `0`. Using\n * one flavour on the other layout produces a check digit that is wrong exactly\n * 3 times in 11, which is why they are separate functions here.\n *\n * @param value - The 43 digits of the barcode with position 5 removed.\n * @returns The check digit, 1-9.\n * @throws {BoletoError} When `value` is empty or holds a non-digit.\n */\nexport function mod11DacCobranca(value: string): number {\n    if (!/^\\d+$/.test(value)) {\n        throw new BoletoError(`mod11DacCobranca needs digits, got ${JSON.stringify(value)}.`);\n    }\n    const remainder = mod11Sum(value) % 11;\n    return remainder === 0 || remainder === 1 || remainder === 10 ? 1 : 11 - remainder;\n}\n\n/**\n * DAC módulo 11 for an **arrecadação** barcode — position 4 of a `8…` slip.\n *\n * Same weights and same subtraction as {@link mod11DacCobranca}, but a remainder\n * of `0` or `1` resolves to **`0`**.\n *\n * Ported from the FEBRABAN version 07 layout, section 10, and pinned by that\n * document's own worked example: the 43-digit sequence\n * `8220000215048200974123220154098290108605940` sums to 705, `705 mod 11 = 1`,\n * and the barcode the spec prints carries `0` in position 4.\n *\n * @param value - The 43 digits of the barcode with position 4 removed.\n * @returns The check digit, 0 or 2-9.\n * @throws {BoletoError} When `value` is empty or holds a non-digit.\n */\nexport function mod11DacArrecadacao(value: string): number {\n    if (!/^\\d+$/.test(value)) {\n        throw new BoletoError(`mod11DacArrecadacao needs digits, got ${JSON.stringify(value)}.`);\n    }\n    const remainder = mod11Sum(value) % 11;\n    return remainder === 0 || remainder === 1 ? 0 : 11 - remainder;\n}\n\n/**\n * Which layout a string is in, without throwing.\n *\n * @param value - A barcode or typed line, masked or not.\n * @returns The layout, or `null` when the length is not 44, 47 or 48.\n */\nexport function boletoKind(value: string): BoletoKind | null {\n    const raw = digits(value);\n    if (raw.length === 47) return \"banco\";\n    if (raw.length === 48) return \"arrecadacao\";\n    if (raw.length === 44) return raw.startsWith(\"8\") ? \"arrecadacao\" : \"banco\";\n    return null;\n}\n\n/** Local midnight of the calendar day `days` after a UTC epoch. */\nfunction dayAfter(epochUtcMs: number, days: number): Date {\n    const utc = new Date(epochUtcMs + days * MS_PER_DAY);\n    return new Date(utc.getUTCFullYear(), utc.getUTCMonth(), utc.getUTCDate());\n}\n\n/**\n * Resolve a fator de vencimento to a calendar date.\n *\n * The field is four digits of days since a base date, and it has had **two** base\n * dates: 1997-10-07 until the counter saturated at 9999 on 2025-02-21, then\n * 2022-05-29 from 2025-02-22, when FEBRABAN restarted it at 1000.\n *\n * !!! danger \"The two epochs are genuinely ambiguous\"\n *     Every fator from 1000 to 9999 has a reading under each base — 1997-10-07\n *     gives a date in `2000-07-03 … 2025-02-21`, 2022-05-29 gives one in\n *     `2025-02-22 … 2049-10-14`. Nothing in the barcode says which. `\"auto\"`\n *     picks whichever lands nearer `reference`, which is right for the case that\n *     matters (a slip being paid now) and wrong for an archive sweep. Pass\n *     `\"legacy\"` or `\"current\"` when you know.\n *\n * @param fator - The raw 4-digit field as a number. `0` means \"no due date\".\n * @param options - Epoch selection. Default `\"auto\"` against `new Date()`.\n * @returns Local midnight of the due date, or `null` when `fator` is `0`.\n *\n * @example\n * boletoDueDate(1000, { epoch: \"legacy\" });  // 2000-07-03\n * boletoDueDate(1000, { epoch: \"current\" }); // 2025-02-22\n */\nexport function boletoDueDate(\n    fator: number,\n    options: BoletoOptions = {},\n): { date: Date; epoch: Exclude<BoletoEpoch, \"auto\"> } | null {\n    if (fator === 0) return null;\n    const { epoch = \"auto\", reference = new Date() } = options;\n\n    if (epoch === \"legacy\") return { date: dayAfter(LEGACY_EPOCH_UTC, fator), epoch: \"legacy\" };\n    if (epoch === \"current\") return { date: dayAfter(CURRENT_EPOCH_UTC, fator), epoch: \"current\" };\n\n    const legacy = dayAfter(LEGACY_EPOCH_UTC, fator);\n    if (fator < FATOR_MIN) return { date: legacy, epoch: \"legacy\" };\n    const current = dayAfter(CURRENT_EPOCH_UTC, fator);\n    const at = reference.getTime();\n    return Math.abs(current.getTime() - at) <= Math.abs(legacy.getTime() - at)\n        ? { date: current, epoch: \"current\" }\n        : { date: legacy, epoch: \"legacy\" };\n}\n\n/**\n * Invert {@link boletoDueDate}: the fator that encodes a due date.\n *\n * @param date - The due date. Only its local calendar day is used.\n * @param epoch - Base date to count from. Default `\"current\"`, the epoch in force\n * since 2025-02-22 and therefore the one a boleto issued today must use.\n * @returns The 4-digit fator.\n * @throws {BoletoError} When the date falls outside the 1000-9999 window of that\n * epoch, because no fator can represent it.\n *\n * @example\n * fatorVencimento(new Date(2025, 1, 22)); // 1000\n */\nexport function fatorVencimento(\n    date: Date,\n    epoch: Exclude<BoletoEpoch, \"auto\"> = \"current\",\n): number {\n    const base = epoch === \"legacy\" ? LEGACY_EPOCH_UTC : CURRENT_EPOCH_UTC;\n    const target = Date.UTC(date.getFullYear(), date.getMonth(), date.getDate());\n    const fator = Math.round((target - base) / MS_PER_DAY);\n    if (fator < FATOR_MIN || fator > FATOR_MAX) {\n        throw new BoletoError(\n            `${date.toISOString().slice(0, 10)} is fator ${fator} under the \"${epoch}\" epoch, ` +\n                `outside the ${FATOR_MIN}-${FATOR_MAX} the field holds.`,\n        );\n    }\n    return fator;\n}\n\n/**\n * `AAAAMMDD` at the head of an arrecadação campo livre, when it reads as a date.\n *\n * The caller only ever passes a slice of a validated barcode, so the head is\n * always eight digits; what is not guaranteed is that those digits are a date, and\n * `20260231` has to come back `null` rather than roll into March.\n */\nfunction campoLivreDate(campoLivre: string): Date | null {\n    const head = campoLivre.slice(0, 8);\n    const year = Number(head.slice(0, 4));\n    const month = Number(head.slice(4, 6));\n    const day = Number(head.slice(6, 8));\n    if (year < 1997 || year > 2099 || month < 1 || month > 12 || day < 1 || day > 31) return null;\n    const date = new Date(year, month - 1, day);\n    return date.getMonth() === month - 1 && date.getDate() === day ? date : null;\n}\n\n/** Assemble the 47-digit typed line from a validated 44-digit bank barcode. */\nfunction bancoLinha(barcode: string): string {\n    const campoLivre = barcode.slice(19);\n    const field1 = barcode.slice(0, 4) + campoLivre.slice(0, 5);\n    const field2 = campoLivre.slice(5, 15);\n    const field3 = campoLivre.slice(15, 25);\n    return (\n        field1 +\n        mod10Dac(field1) +\n        field2 +\n        mod10Dac(field2) +\n        field3 +\n        mod10Dac(field3) +\n        barcode.slice(4, 5) +\n        barcode.slice(5, 19)\n    );\n}\n\n/** Assemble the 48-digit typed line from a validated 44-digit arrecadação barcode. */\nfunction arrecadacaoLinha(barcode: string): string {\n    const dac = mod11Selector(barcode) === 11 ? mod11DacArrecadacao : mod10Dac;\n    let line = \"\";\n    for (let start = 0; start < 44; start += 11) {\n        const block = barcode.slice(start, start + 11);\n        line += block + dac(block);\n    }\n    return line;\n}\n\n/** Which modulo position 3 of an arrecadação barcode selects. */\nfunction mod11Selector(barcode: string): 10 | 11 {\n    return barcode[2] === \"8\" || barcode[2] === \"9\" ? 11 : 10;\n}\n\n/** Read a 44-digit bank barcode, whose general DV has already been checked. */\nfunction readBanco(barcode: string, options: BoletoOptions): BoletoBanco {\n    const fator = Number(barcode.slice(5, 9));\n    const due = boletoDueDate(fator, options);\n    const moeda = barcode.slice(3, 4);\n    return {\n        kind: \"banco\",\n        codigoBarras: barcode,\n        linhaDigitavel: bancoLinha(barcode),\n        banco: barcode.slice(0, 3),\n        moeda,\n        moedaLabel: moeda === \"9\" ? \"Real\" : null,\n        dv: barcode.slice(4, 5),\n        fatorVencimento: fator,\n        vencimento: due?.date ?? null,\n        vencimentoEpoch: due?.epoch ?? null,\n        valor: Number(barcode.slice(9, 19)) / 100,\n        campoLivre: barcode.slice(19),\n    };\n}\n\n/** Read a 44-digit arrecadação barcode, whose general DV has already been checked. */\nfunction readArrecadacao(barcode: string): BoletoArrecadacao {\n    const segmento = Number(barcode[1]);\n    const identificacaoValor = Number(barcode[2]);\n    const empresaIsCnpj = segmento === SEGMENTO_CNPJ;\n    const campoLivre = empresaIsCnpj ? barcode.slice(23) : barcode.slice(19);\n    const valorRaw = barcode.slice(4, 15);\n    const isMoney = identificacaoValor === 6 || identificacaoValor === 8;\n    return {\n        kind: \"arrecadacao\",\n        codigoBarras: barcode,\n        linhaDigitavel: arrecadacaoLinha(barcode),\n        segmento,\n        segmentoLabel: SEGMENTO_LABELS[segmento] ?? null,\n        identificacaoValor,\n        dvModulo: mod11Selector(barcode),\n        dv: barcode.slice(3, 4),\n        valor: isMoney ? Number(valorRaw) / 100 : null,\n        valorRaw,\n        empresa: empresaIsCnpj ? barcode.slice(15, 23) : barcode.slice(15, 19),\n        empresaIsCnpj,\n        campoLivre,\n        vencimentoCampoLivre: campoLivreDate(campoLivre),\n    };\n}\n\n/** Recompute and compare the general check digit of a 44-digit barcode. */\nfunction assertBarcodeDv(barcode: string): void {\n    if (barcode.startsWith(\"8\")) {\n        const body = barcode.slice(0, 3) + barcode.slice(4);\n        const dac = mod11Selector(barcode) === 11 ? mod11DacArrecadacao(body) : mod10Dac(body);\n        if (String(dac) !== barcode[3]) {\n            throw new BoletoError(\n                `Arrecadação check digit is ${barcode[3]}, recomputed ${dac} (módulo ${mod11Selector(barcode)}).`,\n            );\n        }\n        return;\n    }\n    const dac = mod11DacCobranca(barcode.slice(0, 4) + barcode.slice(5));\n    if (String(dac) !== barcode[4]) {\n        throw new BoletoError(`Barcode check digit is ${barcode[4]}, recomputed ${dac}.`);\n    }\n}\n\n/** Reject an arrecadação barcode whose position 3 is not one of 6, 7, 8, 9. */\nfunction assertIdentificacaoValor(barcode: string): void {\n    if (!\"6789\".includes(barcode[2]!)) {\n        throw new BoletoError(\n            `Position 3 of an arrecadação barcode must be 6, 7, 8 or 9 (identificação do valor), got ${barcode[2]}.`,\n        );\n    }\n}\n\n/**\n * Read a 44-digit barcode — either layout — into its fields.\n *\n * The first digit picks the layout: `8` is an arrecadação/convênio slip, anything\n * else is a cobrança boleto. They are **not** variants of one format; every field\n * moves. Narrow the result on `kind` before touching it.\n *\n * @param value - 44 digits. Spaces and punctuation are ignored.\n * @param options - Fator de vencimento epoch. See {@link boletoDueDate}.\n * @returns The parsed boleto, with the matching typed line filled in.\n * @throws {BoletoError} On a length other than 44, on a general check digit that\n * does not recompute, or on an arrecadação slip whose position 3 is out of spec.\n *\n * @example\n * const boleto = parseCodigoBarras(scanned);\n * if (boleto.kind === \"banco\") console.log(boleto.valor, boleto.vencimento);\n */\nexport function parseCodigoBarras(value: string, options: BoletoOptions = {}): Boleto {\n    const barcode = digits(value);\n    if (barcode.length !== 44) {\n        throw new BoletoError(\n            `A barcode has 44 digits, got ${barcode.length}. ` +\n                \"A 47- or 48-digit string is a typed line — use parseLinhaDigitavel.\",\n        );\n    }\n    if (barcode.startsWith(\"8\")) {\n        assertIdentificacaoValor(barcode);\n        assertBarcodeDv(barcode);\n        return readArrecadacao(barcode);\n    }\n    assertBarcodeDv(barcode);\n    return readBanco(barcode, options);\n}\n\n/**\n * Read a typed line — 47 digits for a bank boleto, 48 for an arrecadação slip.\n *\n * Both layouts interleave check digits with the data, so the function rebuilds the\n * 44-digit barcode as it goes and every DV is verified: the three (bank) or four\n * (arrecadação) block digits, plus the general one.\n *\n * @param value - 47 or 48 digits. The usual `.`, ` ` and `-` are ignored.\n * @param options - Fator de vencimento epoch. See {@link boletoDueDate}.\n * @returns The parsed boleto, with the barcode filled in.\n * @throws {BoletoError} On a length other than 47 or 48, or on any check digit\n * that does not recompute.\n *\n * @example\n * const boleto = parseLinhaDigitavel(\"34191.09008 64592.181109 00000.463074 1 84410000002000\");\n */\nexport function parseLinhaDigitavel(value: string, options: BoletoOptions = {}): Boleto {\n    const line = digits(value);\n    if (line.length === 47) return parseCodigoBarras(bancoBarcode(line), options);\n    if (line.length === 48) return parseCodigoBarras(arrecadacaoBarcode(line), options);\n    throw new BoletoError(\n        `A typed line has 47 digits (bank) or 48 (arrecadação), got ${line.length}. ` +\n            \"A 44-digit string is a barcode — use parseCodigoBarras.\",\n    );\n}\n\n/** Verify the three field DVs of a 47-digit line and rebuild the barcode. */\nfunction bancoBarcode(line: string): string {\n    const fields: [string, string][] = [\n        [line.slice(0, 9), line.slice(9, 10)],\n        [line.slice(10, 20), line.slice(20, 21)],\n        [line.slice(21, 31), line.slice(31, 32)],\n    ];\n    fields.forEach(([body, dv], index) => {\n        const dac = mod10Dac(body);\n        if (String(dac) !== dv) {\n            throw new BoletoError(\n                `Field ${index + 1} check digit is ${dv}, recomputed ${dac} (módulo 10).`,\n            );\n        }\n    });\n    return (\n        line.slice(0, 4) +\n        line.slice(32, 33) +\n        line.slice(33, 47) +\n        line.slice(4, 9) +\n        line.slice(10, 20) +\n        line.slice(21, 31)\n    );\n}\n\n/** Verify the four block DVs of a 48-digit line and rebuild the barcode. */\nfunction arrecadacaoBarcode(line: string): string {\n    const blocks = [0, 12, 24, 36].map((start) => ({\n        body: line.slice(start, start + 11),\n        dv: line.slice(start + 11, start + 12),\n    }));\n    const barcode = blocks.map((block) => block.body).join(\"\");\n    if (!barcode.startsWith(\"8\")) {\n        throw new BoletoError(\n            `A 48-digit typed line is an arrecadação slip and must start with 8, got ${barcode[0]}.`,\n        );\n    }\n    assertIdentificacaoValor(barcode);\n    const dac = mod11Selector(barcode) === 11 ? mod11DacArrecadacao : mod10Dac;\n    blocks.forEach((block, index) => {\n        const expected = dac(block.body);\n        if (String(expected) !== block.dv) {\n            throw new BoletoError(\n                `Block ${index + 1} check digit is ${block.dv}, recomputed ${expected} ` +\n                    `(módulo ${mod11Selector(barcode)}).`,\n            );\n        }\n    });\n    return barcode;\n}\n\n/**\n * Convert a typed line to its 44-digit barcode.\n *\n * @param value - 47 or 48 digits.\n * @returns The 44-digit barcode.\n * @throws {BoletoError} On a bad length or a check digit that does not recompute.\n */\nexport function linhaDigitavelToCodigoBarras(value: string): string {\n    return parseLinhaDigitavel(value).codigoBarras;\n}\n\n/**\n * Convert a 44-digit barcode to its typed line — 47 digits, or 48 for `8…`.\n *\n * @param value - 44 digits.\n * @returns The typed line, check digits included.\n * @throws {BoletoError} On a bad length or a general check digit that does not\n * recompute.\n */\nexport function codigoBarrasToLinhaDigitavel(value: string): string {\n    return parseCodigoBarras(value).linhaDigitavel;\n}\n\n/**\n * Whether a boleto string is internally consistent.\n *\n * Checks every digit the layout can check — the block DVs of a typed line and the\n * general DV in both representations. It says nothing about whether the boleto\n * exists, is registered, or is still payable: only a bank can answer that. What it\n * *does* catch is the common failure, a mistyped or truncated line.\n *\n * @param value - A barcode (44) or typed line (47/48), masked or not.\n * @returns `true` when everything recomputes.\n *\n * @example\n * if (!validateBoleto(input)) setError(\"Confira a linha digitável.\");\n */\nexport function validateBoleto(value: string): boolean {\n    try {\n        const raw = digits(value);\n        if (raw.length === 44) parseCodigoBarras(raw);\n        else parseLinhaDigitavel(raw);\n        return true;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * Group a typed line the way it is printed, so a human can read it back.\n *\n * 47 digits become `AAABC.CCCCD EEEEE.EEEEEF GGGGG.GGGGGH I JJJJKKKKKKKKKK`;\n * 48 digits become four blocks of twelve. Anything else is returned untouched —\n * this is a display helper, not a validator.\n *\n * @param value - A typed line, masked or not.\n * @returns The grouped string.\n *\n * @example\n * formatLinhaDigitavel(\"34191090086459218110900000463074184410000002000\");\n * // \"34191.09008 64592.181109 00000.463074 1 84410000002000\"\n */\nexport function formatLinhaDigitavel(value: string): string {\n    const line = digits(value);\n    if (line.length === 47) {\n        return [\n            `${line.slice(0, 5)}.${line.slice(5, 10)}`,\n            `${line.slice(10, 15)}.${line.slice(15, 21)}`,\n            `${line.slice(21, 26)}.${line.slice(26, 32)}`,\n            line.slice(32, 33),\n            line.slice(33),\n        ].join(\" \");\n    }\n    if (line.length === 48) {\n        return [0, 12, 24, 36].map((start) => line.slice(start, start + 12)).join(\" \");\n    }\n    return value;\n}\n"],"mappings":"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"}
+{"version":3,"file":"boleto.js","names":["BoletoError","message","LEGACY_EPOCH_UTC","CURRENT_EPOCH_UTC","MS_PER_DAY","FATOR_MIN","FATOR_MAX","MOD10_WEIGHTS","MOD11_WEIGHT_FIRST","SEGMENTO_LABELS","SEGMENTO_CNPJ","digits","value","mod10Dac","sum","index","fromRight","product","remainder","mod11Sum","mod11DacCobranca","mod11DacArrecadacao","boletoKind","raw","dayAfter","utc","epochUtcMs","days","boletoDueDate","fator","options","epoch","legacy","current","at","reference","fatorVencimento","base","target","date","campoLivreDate","head","campoLivre","year","month","day","bancoLinha","barcode","field1","field2","field3","arrecadacaoLinha","dac","mod11Selector","line","start","block","readBanco","due","moeda","readArrecadacao","segmento","identificacaoValor","empresaIsCnpj","valorRaw","isMoney","assertBarcodeDv","body","assertIdentificacaoValor","parseCodigoBarras","parseLinhaDigitavel","bancoBarcode","arrecadacaoBarcode","dv","blocks","expected","linhaDigitavelToCodigoBarras","codigoBarrasToLinhaDigitavel","validateBoleto","formatLinhaDigitavel"],"sources":["../../src/br/boleto.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — the FEBRABAN spec in one file: the 47-digit linha\n * digitável, the 44-digit barcode, the two layouts (bank slips and arrecadação),\n * modulo-10 and modulo-11 check digits, the base date the due date counts from, and\n * the value scaling. Every piece cross-checks another — the conversion between the\n * two forms is what proves the check digits — so splitting it hides the one property\n * the file exists to guarantee.\n */\n/**\n * A boleto string could not be read, or failed a check digit.\n *\n * Its own class so a scanner screen can tell \"this is not a boleto\" apart from a\n * bug, and so the message can be shown to the operator as-is.\n */\nexport class BoletoError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"BoletoError\";\n    }\n}\n\n/**\n * The two incompatible layouts that share the 44-digit barcode.\n *\n * `\"banco\"` is the cobrança boleto every bank issues; `\"arrecadacao\"` is the\n * concessionária/tributo slip, which starts with `8` and lays out its 44 digits\n * completely differently — same length, different meaning for every field.\n */\nexport type BoletoKind = \"banco\" | \"arrecadacao\";\n\n/** Which base date the fator de vencimento counts from. See {@link boletoDueDate}. */\nexport type BoletoEpoch = \"auto\" | \"legacy\" | \"current\";\n\n/** Options shared by every parser here. */\nexport interface BoletoOptions {\n    /** Fator de vencimento epoch. Default `\"auto\"`. */\n    epoch?: BoletoEpoch;\n    /** Date `\"auto\"` measures proximity against. Default `new Date()`. */\n    reference?: Date;\n}\n\n/** A cobrança boleto — the kind a bank issues against an invoice. */\nexport interface BoletoBanco {\n    kind: \"banco\";\n    /** 44 digits. */\n    codigoBarras: string;\n    /** 47 digits. */\n    linhaDigitavel: string;\n    /** 3-digit bank code in the clearing house, e.g. `\"341\"`. */\n    banco: string;\n    /** 1 digit. `\"9\"` is BRL; nothing else is in use. */\n    moeda: string;\n    /** `\"Real\"` for `\"9\"`, `null` for anything else. */\n    moedaLabel: string | null;\n    /** The general check digit, position 5 of the barcode. */\n    dv: string;\n    /** Raw 4-digit field. `0` means the boleto carries no due date. */\n    fatorVencimento: number;\n    /** Due date, or `null` when the fator is `0`. */\n    vencimento: Date | null;\n    /** Which epoch {@link vencimento} was resolved under. `null` when there is none. */\n    vencimentoEpoch: Exclude<BoletoEpoch, \"auto\"> | null;\n    /** Reais. `0` when the issuer left the amount for the payer to fill in. */\n    valor: number;\n    /** 25 digits the issuing bank defines. Not interpretable without its manual. */\n    campoLivre: string;\n}\n\n/** An arrecadação/convênio slip — utilities, taxes, traffic fines. */\nexport interface BoletoArrecadacao {\n    kind: \"arrecadacao\";\n    /** 44 digits, always starting with `8`. */\n    codigoBarras: string;\n    /** 48 digits, in four blocks of twelve. */\n    linhaDigitavel: string;\n    /** Position 2. See {@link segmentoLabel}. */\n    segmento: number;\n    /** Human label, or `null` for a value the layout does not define. */\n    segmentoLabel: string | null;\n    /** Position 3: `6`/`8` mean real money, `7`/`9` mean a reference quantity. */\n    identificacaoValor: number;\n    /** Which modulo position 3 selects for the general check digit. */\n    dvModulo: 10 | 11;\n    /** The general check digit, position 4. */\n    dv: string;\n    /** Reais, or `null` when position 3 says the field is a reference, not money. */\n    valor: number | null;\n    /** The raw 11-digit value field, useful when {@link valor} is `null`. */\n    valorRaw: string;\n    /**\n     * Positions 16-19 — the 4-digit code FEBRABAN assigns the company — or, on\n     * segmento 6, positions 16-23, which are the first eight CNPJ digits.\n     */\n    empresa: string;\n    /** `true` when {@link empresa} is a CNPJ prefix rather than a FEBRABAN code. */\n    empresaIsCnpj: boolean;\n    /** 25 digits, or 21 when the CNPJ took four of them. Issuer-defined. */\n    campoLivre: string;\n    /**\n     * Due date read from the first eight digits of the campo livre.\n     *\n     * The layout says a due date, **if present**, must sit there as `AAAAMMDD` —\n     * but the field is optional and nothing marks its presence, so a campo livre\n     * that merely looks like a date lands here too. Treat it as a hint for a UI,\n     * never as the date a payment settles against.\n     */\n    vencimentoCampoLivre: Date | null;\n}\n\n/** What the two parsers return. Narrow on `kind`. */\nexport type Boleto = BoletoBanco | BoletoArrecadacao;\n\n/** Base date of the fator de vencimento as FEBRABAN defined it in 1997. */\nconst LEGACY_EPOCH_UTC = Date.UTC(1997, 9, 7);\n\n/**\n * Base date the fator de vencimento restarted from.\n *\n * FEBRABAN communication FB-009/2023: the 4-digit field hit its ceiling of 9999\n * on 2025-02-21 (1997-10-07 + 9999 days), so from 2025-02-22 the counter restarts\n * at 1000 against a new base of 2022-05-29 (2022-05-29 + 1000 days = 2025-02-22).\n */\nconst CURRENT_EPOCH_UTC = Date.UTC(2022, 4, 29);\n\nconst MS_PER_DAY = 86_400_000;\n\n/** First fator FEBRABAN ever put in circulation, in either epoch. */\nconst FATOR_MIN = 1000;\n\n/** Last fator the 4-digit field can hold. */\nconst FATOR_MAX = 9999;\n\nconst MOD10_WEIGHTS = [2, 1] as const;\nconst MOD11_WEIGHT_FIRST = 2;\nconst MOD11_WEIGHT_LAST = 9;\n\nconst SEGMENTO_LABELS: Record<number, string> = {\n    1: \"Prefeituras\",\n    2: \"Saneamento\",\n    3: \"Energia elétrica e gás\",\n    4: \"Telecomunicações\",\n    5: \"Órgãos governamentais\",\n    6: \"Carnes e assemelhados ou empresas identificadas por CNPJ\",\n    7: \"Multas de trânsito\",\n    9: \"Uso exclusivo do banco\",\n};\n\n/** Segmento whose company identifier is a CNPJ prefix instead of a FEBRABAN code. */\nconst SEGMENTO_CNPJ = 6;\n\n/** Digits of a value that may carry the usual dots, spaces and dashes. */\nfunction digits(value: string): string {\n    return value.replace(/\\D/g, \"\");\n}\n\n/**\n * DAC módulo 10, FEBRABAN flavour.\n *\n * Multipliers cycle `2, 1, 2, 1, …` from right to left; the **digits** of each\n * product are summed individually (so `6 × 2 = 12` contributes `1 + 2`); the DAC\n * is `10 - (sum mod 10)`, and `0` when that remainder is `0`.\n *\n * Ported from \"Layout Padrão de Arrecadação/Recebimento com Utilização do Código\n * de Barras\", FEBRABAN version 07 (effective 2023-03-01), section 07 — whose own\n * worked example gives `01230067896 → 3`.\n *\n * @param value - Digits only.\n * @returns The check digit, 0-9.\n * @throws {BoletoError} When `value` is empty or holds a non-digit.\n */\nexport function mod10Dac(value: string): number {\n    if (!/^\\d+$/.test(value))\n        throw new BoletoError(`mod10Dac needs digits, got ${JSON.stringify(value)}.`);\n    let sum = 0;\n    for (let index = 0; index < value.length; index += 1) {\n        const fromRight = value.length - 1 - index;\n        const product = Number(value[index]) * MOD10_WEIGHTS[fromRight % MOD10_WEIGHTS.length]!;\n        sum += product > 9 ? product - 9 : product;\n    }\n    const remainder = sum % 10;\n    return remainder === 0 ? 0 : 10 - remainder;\n}\n\n/** Sum of `digit × weight` with weights cycling 2…9 from the right. */\nfunction mod11Sum(value: string): number {\n    const span = MOD11_WEIGHT_LAST - MOD11_WEIGHT_FIRST + 1;\n    let sum = 0;\n    for (let index = 0; index < value.length; index += 1) {\n        const fromRight = value.length - 1 - index;\n        sum += Number(value[index]) * (MOD11_WEIGHT_FIRST + (fromRight % span));\n    }\n    return sum;\n}\n\n/**\n * DAC módulo 11 for a **cobrança** barcode — position 5 of a bank boleto.\n *\n * Weights cycle `2…9` from right to left, the products are summed whole, and the\n * DAC is `11 - (sum mod 11)`. A remainder of `0`, `1` or `10` would put `11`, `10`\n * or `1` in a one-digit field, and FEBRABAN resolves all three to **`1`**.\n *\n * That last rule is where cobrança and arrecadação disagree — see\n * {@link mod11DacArrecadacao}, which resolves the same remainders to `0`. Using\n * one flavour on the other layout produces a check digit that is wrong exactly\n * 3 times in 11, which is why they are separate functions here.\n *\n * @param value - The 43 digits of the barcode with position 5 removed.\n * @returns The check digit, 1-9.\n * @throws {BoletoError} When `value` is empty or holds a non-digit.\n */\nexport function mod11DacCobranca(value: string): number {\n    if (!/^\\d+$/.test(value)) {\n        throw new BoletoError(`mod11DacCobranca needs digits, got ${JSON.stringify(value)}.`);\n    }\n    const remainder = mod11Sum(value) % 11;\n    return remainder === 0 || remainder === 1 || remainder === 10 ? 1 : 11 - remainder;\n}\n\n/**\n * DAC módulo 11 for an **arrecadação** barcode — position 4 of a `8…` slip.\n *\n * Same weights and same subtraction as {@link mod11DacCobranca}, but a remainder\n * of `0` or `1` resolves to **`0`**.\n *\n * Ported from the FEBRABAN version 07 layout, section 10, and pinned by that\n * document's own worked example: the 43-digit sequence\n * `8220000215048200974123220154098290108605940` sums to 705, `705 mod 11 = 1`,\n * and the barcode the spec prints carries `0` in position 4.\n *\n * @param value - The 43 digits of the barcode with position 4 removed.\n * @returns The check digit, 0 or 2-9.\n * @throws {BoletoError} When `value` is empty or holds a non-digit.\n */\nexport function mod11DacArrecadacao(value: string): number {\n    if (!/^\\d+$/.test(value)) {\n        throw new BoletoError(`mod11DacArrecadacao needs digits, got ${JSON.stringify(value)}.`);\n    }\n    const remainder = mod11Sum(value) % 11;\n    return remainder === 0 || remainder === 1 ? 0 : 11 - remainder;\n}\n\n/**\n * Which layout a string is in, without throwing.\n *\n * @param value - A barcode or typed line, masked or not.\n * @returns The layout, or `null` when the length is not 44, 47 or 48.\n */\nexport function boletoKind(value: string): BoletoKind | null {\n    const raw = digits(value);\n    if (raw.length === 47) return \"banco\";\n    if (raw.length === 48) return \"arrecadacao\";\n    if (raw.length === 44) return raw.startsWith(\"8\") ? \"arrecadacao\" : \"banco\";\n    return null;\n}\n\n/** Local midnight of the calendar day `days` after a UTC epoch. */\nfunction dayAfter(epochUtcMs: number, days: number): Date {\n    const utc = new Date(epochUtcMs + days * MS_PER_DAY);\n    return new Date(utc.getUTCFullYear(), utc.getUTCMonth(), utc.getUTCDate());\n}\n\n/**\n * Resolve a fator de vencimento to a calendar date.\n *\n * The field is four digits of days since a base date, and it has had **two** base\n * dates: 1997-10-07 until the counter saturated at 9999 on 2025-02-21, then\n * 2022-05-29 from 2025-02-22, when FEBRABAN restarted it at 1000.\n *\n * !!! danger \"The two epochs are genuinely ambiguous\"\n *     Every fator from 1000 to 9999 has a reading under each base — 1997-10-07\n *     gives a date in `2000-07-03 … 2025-02-21`, 2022-05-29 gives one in\n *     `2025-02-22 … 2049-10-14`. Nothing in the barcode says which. `\"auto\"`\n *     picks whichever lands nearer `reference`, which is right for the case that\n *     matters (a slip being paid now) and wrong for an archive sweep. Pass\n *     `\"legacy\"` or `\"current\"` when you know.\n *\n * @param fator - The raw 4-digit field as a number. `0` means \"no due date\".\n * @param options - Epoch selection. Default `\"auto\"` against `new Date()`.\n * @returns Local midnight of the due date, or `null` when `fator` is `0`.\n *\n * @example\n * boletoDueDate(1000, { epoch: \"legacy\" });  // 2000-07-03\n * boletoDueDate(1000, { epoch: \"current\" }); // 2025-02-22\n */\nexport function boletoDueDate(\n    fator: number,\n    options: BoletoOptions = {},\n): { date: Date; epoch: Exclude<BoletoEpoch, \"auto\"> } | null {\n    if (fator === 0) return null;\n    const { epoch = \"auto\", reference = new Date() } = options;\n\n    if (epoch === \"legacy\") return { date: dayAfter(LEGACY_EPOCH_UTC, fator), epoch: \"legacy\" };\n    if (epoch === \"current\") return { date: dayAfter(CURRENT_EPOCH_UTC, fator), epoch: \"current\" };\n\n    const legacy = dayAfter(LEGACY_EPOCH_UTC, fator);\n    if (fator < FATOR_MIN) return { date: legacy, epoch: \"legacy\" };\n    const current = dayAfter(CURRENT_EPOCH_UTC, fator);\n    const at = reference.getTime();\n    return Math.abs(current.getTime() - at) <= Math.abs(legacy.getTime() - at)\n        ? { date: current, epoch: \"current\" }\n        : { date: legacy, epoch: \"legacy\" };\n}\n\n/**\n * Invert {@link boletoDueDate}: the fator that encodes a due date.\n *\n * @param date - The due date. Only its local calendar day is used.\n * @param epoch - Base date to count from. Default `\"current\"`, the epoch in force\n * since 2025-02-22 and therefore the one a boleto issued today must use.\n * @returns The 4-digit fator.\n * @throws {BoletoError} When the date falls outside the 1000-9999 window of that\n * epoch, because no fator can represent it.\n *\n * @example\n * fatorVencimento(new Date(2025, 1, 22)); // 1000\n */\nexport function fatorVencimento(\n    date: Date,\n    epoch: Exclude<BoletoEpoch, \"auto\"> = \"current\",\n): number {\n    const base = epoch === \"legacy\" ? LEGACY_EPOCH_UTC : CURRENT_EPOCH_UTC;\n    const target = Date.UTC(date.getFullYear(), date.getMonth(), date.getDate());\n    const fator = Math.round((target - base) / MS_PER_DAY);\n    if (fator < FATOR_MIN || fator > FATOR_MAX) {\n        throw new BoletoError(\n            `${date.toISOString().slice(0, 10)} is fator ${fator} under the \"${epoch}\" epoch, ` +\n                `outside the ${FATOR_MIN}-${FATOR_MAX} the field holds.`,\n        );\n    }\n    return fator;\n}\n\n/**\n * `AAAAMMDD` at the head of an arrecadação campo livre, when it reads as a date.\n *\n * The caller only ever passes a slice of a validated barcode, so the head is\n * always eight digits; what is not guaranteed is that those digits are a date, and\n * `20260231` has to come back `null` rather than roll into March.\n */\nfunction campoLivreDate(campoLivre: string): Date | null {\n    const head = campoLivre.slice(0, 8);\n    const year = Number(head.slice(0, 4));\n    const month = Number(head.slice(4, 6));\n    const day = Number(head.slice(6, 8));\n    if (year < 1997 || year > 2099 || month < 1 || month > 12 || day < 1 || day > 31) return null;\n    const date = new Date(year, month - 1, day);\n    return date.getMonth() === month - 1 && date.getDate() === day ? date : null;\n}\n\n/** Assemble the 47-digit typed line from a validated 44-digit bank barcode. */\nfunction bancoLinha(barcode: string): string {\n    const campoLivre = barcode.slice(19);\n    const field1 = barcode.slice(0, 4) + campoLivre.slice(0, 5);\n    const field2 = campoLivre.slice(5, 15);\n    const field3 = campoLivre.slice(15, 25);\n    return (\n        field1 +\n        mod10Dac(field1) +\n        field2 +\n        mod10Dac(field2) +\n        field3 +\n        mod10Dac(field3) +\n        barcode.slice(4, 5) +\n        barcode.slice(5, 19)\n    );\n}\n\n/** Assemble the 48-digit typed line from a validated 44-digit arrecadação barcode. */\nfunction arrecadacaoLinha(barcode: string): string {\n    const dac = mod11Selector(barcode) === 11 ? mod11DacArrecadacao : mod10Dac;\n    let line = \"\";\n    for (let start = 0; start < 44; start += 11) {\n        const block = barcode.slice(start, start + 11);\n        line += block + dac(block);\n    }\n    return line;\n}\n\n/** Which modulo position 3 of an arrecadação barcode selects. */\nfunction mod11Selector(barcode: string): 10 | 11 {\n    return barcode[2] === \"8\" || barcode[2] === \"9\" ? 11 : 10;\n}\n\n/** Read a 44-digit bank barcode, whose general DV has already been checked. */\nfunction readBanco(barcode: string, options: BoletoOptions): BoletoBanco {\n    const fator = Number(barcode.slice(5, 9));\n    const due = boletoDueDate(fator, options);\n    const moeda = barcode.slice(3, 4);\n    return {\n        kind: \"banco\",\n        codigoBarras: barcode,\n        linhaDigitavel: bancoLinha(barcode),\n        banco: barcode.slice(0, 3),\n        moeda,\n        moedaLabel: moeda === \"9\" ? \"Real\" : null,\n        dv: barcode.slice(4, 5),\n        fatorVencimento: fator,\n        vencimento: due?.date ?? null,\n        vencimentoEpoch: due?.epoch ?? null,\n        valor: Number(barcode.slice(9, 19)) / 100,\n        campoLivre: barcode.slice(19),\n    };\n}\n\n/** Read a 44-digit arrecadação barcode, whose general DV has already been checked. */\nfunction readArrecadacao(barcode: string): BoletoArrecadacao {\n    const segmento = Number(barcode[1]);\n    const identificacaoValor = Number(barcode[2]);\n    const empresaIsCnpj = segmento === SEGMENTO_CNPJ;\n    const campoLivre = empresaIsCnpj ? barcode.slice(23) : barcode.slice(19);\n    const valorRaw = barcode.slice(4, 15);\n    const isMoney = identificacaoValor === 6 || identificacaoValor === 8;\n    return {\n        kind: \"arrecadacao\",\n        codigoBarras: barcode,\n        linhaDigitavel: arrecadacaoLinha(barcode),\n        segmento,\n        segmentoLabel: SEGMENTO_LABELS[segmento] ?? null,\n        identificacaoValor,\n        dvModulo: mod11Selector(barcode),\n        dv: barcode.slice(3, 4),\n        valor: isMoney ? Number(valorRaw) / 100 : null,\n        valorRaw,\n        empresa: empresaIsCnpj ? barcode.slice(15, 23) : barcode.slice(15, 19),\n        empresaIsCnpj,\n        campoLivre,\n        vencimentoCampoLivre: campoLivreDate(campoLivre),\n    };\n}\n\n/** Recompute and compare the general check digit of a 44-digit barcode. */\nfunction assertBarcodeDv(barcode: string): void {\n    if (barcode.startsWith(\"8\")) {\n        const body = barcode.slice(0, 3) + barcode.slice(4);\n        const dac = mod11Selector(barcode) === 11 ? mod11DacArrecadacao(body) : mod10Dac(body);\n        if (String(dac) !== barcode[3]) {\n            throw new BoletoError(\n                `Arrecadação check digit is ${barcode[3]}, recomputed ${dac} (módulo ${mod11Selector(barcode)}).`,\n            );\n        }\n        return;\n    }\n    const dac = mod11DacCobranca(barcode.slice(0, 4) + barcode.slice(5));\n    if (String(dac) !== barcode[4]) {\n        throw new BoletoError(`Barcode check digit is ${barcode[4]}, recomputed ${dac}.`);\n    }\n}\n\n/** Reject an arrecadação barcode whose position 3 is not one of 6, 7, 8, 9. */\nfunction assertIdentificacaoValor(barcode: string): void {\n    if (!\"6789\".includes(barcode[2]!)) {\n        throw new BoletoError(\n            `Position 3 of an arrecadação barcode must be 6, 7, 8 or 9 (identificação do valor), got ${barcode[2]}.`,\n        );\n    }\n}\n\n/**\n * Read a 44-digit barcode — either layout — into its fields.\n *\n * The first digit picks the layout: `8` is an arrecadação/convênio slip, anything\n * else is a cobrança boleto. They are **not** variants of one format; every field\n * moves. Narrow the result on `kind` before touching it.\n *\n * @param value - 44 digits. Spaces and punctuation are ignored.\n * @param options - Fator de vencimento epoch. See {@link boletoDueDate}.\n * @returns The parsed boleto, with the matching typed line filled in.\n * @throws {BoletoError} On a length other than 44, on a general check digit that\n * does not recompute, or on an arrecadação slip whose position 3 is out of spec.\n *\n * @example\n * const boleto = parseCodigoBarras(scanned);\n * if (boleto.kind === \"banco\") console.log(boleto.valor, boleto.vencimento);\n */\nexport function parseCodigoBarras(value: string, options: BoletoOptions = {}): Boleto {\n    const barcode = digits(value);\n    if (barcode.length !== 44) {\n        throw new BoletoError(\n            `A barcode has 44 digits, got ${barcode.length}. ` +\n                \"A 47- or 48-digit string is a typed line — use parseLinhaDigitavel.\",\n        );\n    }\n    if (barcode.startsWith(\"8\")) {\n        assertIdentificacaoValor(barcode);\n        assertBarcodeDv(barcode);\n        return readArrecadacao(barcode);\n    }\n    assertBarcodeDv(barcode);\n    return readBanco(barcode, options);\n}\n\n/**\n * Read a typed line — 47 digits for a bank boleto, 48 for an arrecadação slip.\n *\n * Both layouts interleave check digits with the data, so the function rebuilds the\n * 44-digit barcode as it goes and every DV is verified: the three (bank) or four\n * (arrecadação) block digits, plus the general one.\n *\n * @param value - 47 or 48 digits. The usual `.`, ` ` and `-` are ignored.\n * @param options - Fator de vencimento epoch. See {@link boletoDueDate}.\n * @returns The parsed boleto, with the barcode filled in.\n * @throws {BoletoError} On a length other than 47 or 48, or on any check digit\n * that does not recompute.\n *\n * @example\n * const boleto = parseLinhaDigitavel(\"34191.09008 64592.181109 00000.463074 1 84410000002000\");\n */\nexport function parseLinhaDigitavel(value: string, options: BoletoOptions = {}): Boleto {\n    const line = digits(value);\n    if (line.length === 47) return parseCodigoBarras(bancoBarcode(line), options);\n    if (line.length === 48) return parseCodigoBarras(arrecadacaoBarcode(line), options);\n    throw new BoletoError(\n        `A typed line has 47 digits (bank) or 48 (arrecadação), got ${line.length}. ` +\n            \"A 44-digit string is a barcode — use parseCodigoBarras.\",\n    );\n}\n\n/** Verify the three field DVs of a 47-digit line and rebuild the barcode. */\nfunction bancoBarcode(line: string): string {\n    const fields: [string, string][] = [\n        [line.slice(0, 9), line.slice(9, 10)],\n        [line.slice(10, 20), line.slice(20, 21)],\n        [line.slice(21, 31), line.slice(31, 32)],\n    ];\n    fields.forEach(([body, dv], index) => {\n        const dac = mod10Dac(body);\n        if (String(dac) !== dv) {\n            throw new BoletoError(\n                `Field ${index + 1} check digit is ${dv}, recomputed ${dac} (módulo 10).`,\n            );\n        }\n    });\n    return (\n        line.slice(0, 4) +\n        line.slice(32, 33) +\n        line.slice(33, 47) +\n        line.slice(4, 9) +\n        line.slice(10, 20) +\n        line.slice(21, 31)\n    );\n}\n\n/** Verify the four block DVs of a 48-digit line and rebuild the barcode. */\nfunction arrecadacaoBarcode(line: string): string {\n    const blocks = [0, 12, 24, 36].map((start) => ({\n        body: line.slice(start, start + 11),\n        dv: line.slice(start + 11, start + 12),\n    }));\n    const barcode = blocks.map((block) => block.body).join(\"\");\n    if (!barcode.startsWith(\"8\")) {\n        throw new BoletoError(\n            `A 48-digit typed line is an arrecadação slip and must start with 8, got ${barcode[0]}.`,\n        );\n    }\n    assertIdentificacaoValor(barcode);\n    const dac = mod11Selector(barcode) === 11 ? mod11DacArrecadacao : mod10Dac;\n    blocks.forEach((block, index) => {\n        const expected = dac(block.body);\n        if (String(expected) !== block.dv) {\n            throw new BoletoError(\n                `Block ${index + 1} check digit is ${block.dv}, recomputed ${expected} ` +\n                    `(módulo ${mod11Selector(barcode)}).`,\n            );\n        }\n    });\n    return barcode;\n}\n\n/**\n * Convert a typed line to its 44-digit barcode.\n *\n * @param value - 47 or 48 digits.\n * @returns The 44-digit barcode.\n * @throws {BoletoError} On a bad length or a check digit that does not recompute.\n */\nexport function linhaDigitavelToCodigoBarras(value: string): string {\n    return parseLinhaDigitavel(value).codigoBarras;\n}\n\n/**\n * Convert a 44-digit barcode to its typed line — 47 digits, or 48 for `8…`.\n *\n * @param value - 44 digits.\n * @returns The typed line, check digits included.\n * @throws {BoletoError} On a bad length or a general check digit that does not\n * recompute.\n */\nexport function codigoBarrasToLinhaDigitavel(value: string): string {\n    return parseCodigoBarras(value).linhaDigitavel;\n}\n\n/**\n * Whether a boleto string is internally consistent.\n *\n * Checks every digit the layout can check — the block DVs of a typed line and the\n * general DV in both representations. It says nothing about whether the boleto\n * exists, is registered, or is still payable: only a bank can answer that. What it\n * *does* catch is the common failure, a mistyped or truncated line.\n *\n * @param value - A barcode (44) or typed line (47/48), masked or not.\n * @returns `true` when everything recomputes.\n *\n * @example\n * if (!validateBoleto(input)) setError(\"Confira a linha digitável.\");\n */\nexport function validateBoleto(value: string): boolean {\n    try {\n        const raw = digits(value);\n        if (raw.length === 44) parseCodigoBarras(raw);\n        else parseLinhaDigitavel(raw);\n        return true;\n    } catch {\n        return false;\n    }\n}\n\n/**\n * Group a typed line the way it is printed, so a human can read it back.\n *\n * 47 digits become `AAABC.CCCCD EEEEE.EEEEEF GGGGG.GGGGGH I JJJJKKKKKKKKKK`;\n * 48 digits become four blocks of twelve. Anything else is returned untouched —\n * this is a display helper, not a validator.\n *\n * @param value - A typed line, masked or not.\n * @returns The grouped string.\n *\n * @example\n * formatLinhaDigitavel(\"34191090086459218110900000463074184410000002000\");\n * // \"34191.09008 64592.181109 00000.463074 1 84410000002000\"\n */\nexport function formatLinhaDigitavel(value: string): string {\n    const line = digits(value);\n    if (line.length === 47) {\n        return [\n            `${line.slice(0, 5)}.${line.slice(5, 10)}`,\n            `${line.slice(10, 15)}.${line.slice(15, 21)}`,\n            `${line.slice(21, 26)}.${line.slice(26, 32)}`,\n            line.slice(32, 33),\n            line.slice(33),\n        ].join(\" \");\n    }\n    if (line.length === 48) {\n        return [0, 12, 24, 36].map((start) => line.slice(start, start + 12)).join(\" \");\n    }\n    return value;\n}\n"],"mappings":"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"}

package/dist/br/br-geo.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"br-geo.cjs","names":[],"sources":["../../src/br/br-geo.ts"],"sourcesContent":["import rawGeo from \"./data/br-uf-geo.json\";\nimport type { BrRegion, UF } from \"./locations\";\n\n/** A ring of `[longitude, latitude]` pairs. */\nexport type Ring = [number, number][];\n\n/** GeoJSON geometry for a federative unit — always a (multi)polygon. */\nexport interface BrUfGeometry {\n    type: \"Polygon\" | \"MultiPolygon\";\n    /** `Polygon` → `Ring[]`; `MultiPolygon` → `Ring[][]`. */\n    coordinates: Ring[] | Ring[][];\n}\n\n/** One federative unit feature. */\nexport interface BrUfFeature {\n    type: \"Feature\";\n    properties: {\n        uf: UF;\n        name: string;\n        region: BrRegion;\n        /** Representative point `[longitude, latitude]` (area-weighted centroid). */\n        centroid: [number, number];\n    };\n    geometry: BrUfGeometry;\n}\n\n/** The bundled, simplified GeoJSON of all 27 UF boundaries. */\nexport interface BrUfFeatureCollection {\n    type: \"FeatureCollection\";\n    features: BrUfFeature[];\n}\n\n/**\n * Simplified (Douglas-Peucker, ~2 km tolerance) public-domain GeoJSON of the 27\n * Brazilian federative-unit boundaries, derived from IBGE data. ~119 KB raw /\n * ~36 KB gzip — adequate for an interactive overview map, not for precise\n * geographic analysis. This module is loaded lazily by `BrazilMap`, so it lands\n * in its own chunk and never inflates a data-only import.\n */\nexport const BR_UF_GEOJSON = rawGeo as unknown as BrUfFeatureCollection;\n"],"mappings":"AAuCA,IAAa,gCAAgB,CAAA,CAAA"}
+{"version":3,"file":"br-geo.cjs","names":["rawGeo","BR_UF_GEOJSON"],"sources":["../../src/br/br-geo.ts"],"sourcesContent":["import rawGeo from \"./data/br-uf-geo.json\";\nimport type { BrRegion, UF } from \"./locations\";\n\n/** A ring of `[longitude, latitude]` pairs. */\nexport type Ring = [number, number][];\n\n/** GeoJSON geometry for a federative unit — always a (multi)polygon. */\nexport interface BrUfGeometry {\n    type: \"Polygon\" | \"MultiPolygon\";\n    /** `Polygon` → `Ring[]`; `MultiPolygon` → `Ring[][]`. */\n    coordinates: Ring[] | Ring[][];\n}\n\n/** One federative unit feature. */\nexport interface BrUfFeature {\n    type: \"Feature\";\n    properties: {\n        uf: UF;\n        name: string;\n        region: BrRegion;\n        /** Representative point `[longitude, latitude]` (area-weighted centroid). */\n        centroid: [number, number];\n    };\n    geometry: BrUfGeometry;\n}\n\n/** The bundled, simplified GeoJSON of all 27 UF boundaries. */\nexport interface BrUfFeatureCollection {\n    type: \"FeatureCollection\";\n    features: BrUfFeature[];\n}\n\n/**\n * Simplified (Douglas-Peucker, ~2 km tolerance) public-domain GeoJSON of the 27\n * Brazilian federative-unit boundaries, derived from IBGE data. ~119 KB raw /\n * ~36 KB gzip — adequate for an interactive overview map, not for precise\n * geographic analysis. This module is loaded lazily by `BrazilMap`, so it lands\n * in its own chunk and never inflates a data-only import.\n */\nexport const BR_UF_GEOJSON = rawGeo as unknown as BrUfFeatureCollection;\n"],"mappings":"AAuCA,IAAaC,E,8BAAgBD,CAAAA,CAAAA,Q"}

package/dist/br/br-geo.js.map

@@ -1 +1 @@
-{"version":3,"file":"br-geo.js","names":[],"sources":["../../src/br/br-geo.ts"],"sourcesContent":["import rawGeo from \"./data/br-uf-geo.json\";\nimport type { BrRegion, UF } from \"./locations\";\n\n/** A ring of `[longitude, latitude]` pairs. */\nexport type Ring = [number, number][];\n\n/** GeoJSON geometry for a federative unit — always a (multi)polygon. */\nexport interface BrUfGeometry {\n    type: \"Polygon\" | \"MultiPolygon\";\n    /** `Polygon` → `Ring[]`; `MultiPolygon` → `Ring[][]`. */\n    coordinates: Ring[] | Ring[][];\n}\n\n/** One federative unit feature. */\nexport interface BrUfFeature {\n    type: \"Feature\";\n    properties: {\n        uf: UF;\n        name: string;\n        region: BrRegion;\n        /** Representative point `[longitude, latitude]` (area-weighted centroid). */\n        centroid: [number, number];\n    };\n    geometry: BrUfGeometry;\n}\n\n/** The bundled, simplified GeoJSON of all 27 UF boundaries. */\nexport interface BrUfFeatureCollection {\n    type: \"FeatureCollection\";\n    features: BrUfFeature[];\n}\n\n/**\n * Simplified (Douglas-Peucker, ~2 km tolerance) public-domain GeoJSON of the 27\n * Brazilian federative-unit boundaries, derived from IBGE data. ~119 KB raw /\n * ~36 KB gzip — adequate for an interactive overview map, not for precise\n * geographic analysis. This module is loaded lazily by `BrazilMap`, so it lands\n * in its own chunk and never inflates a data-only import.\n */\nexport const BR_UF_GEOJSON = rawGeo as unknown as BrUfFeatureCollection;\n"],"mappings":";;AAuCA,IAAa,IAAgB"}
+{"version":3,"file":"br-geo.js","names":["rawGeo","br_uf_geo_default","BR_UF_GEOJSON"],"sources":["../../src/br/br-geo.ts"],"sourcesContent":["import rawGeo from \"./data/br-uf-geo.json\";\nimport type { BrRegion, UF } from \"./locations\";\n\n/** A ring of `[longitude, latitude]` pairs. */\nexport type Ring = [number, number][];\n\n/** GeoJSON geometry for a federative unit — always a (multi)polygon. */\nexport interface BrUfGeometry {\n    type: \"Polygon\" | \"MultiPolygon\";\n    /** `Polygon` → `Ring[]`; `MultiPolygon` → `Ring[][]`. */\n    coordinates: Ring[] | Ring[][];\n}\n\n/** One federative unit feature. */\nexport interface BrUfFeature {\n    type: \"Feature\";\n    properties: {\n        uf: UF;\n        name: string;\n        region: BrRegion;\n        /** Representative point `[longitude, latitude]` (area-weighted centroid). */\n        centroid: [number, number];\n    };\n    geometry: BrUfGeometry;\n}\n\n/** The bundled, simplified GeoJSON of all 27 UF boundaries. */\nexport interface BrUfFeatureCollection {\n    type: \"FeatureCollection\";\n    features: BrUfFeature[];\n}\n\n/**\n * Simplified (Douglas-Peucker, ~2 km tolerance) public-domain GeoJSON of the 27\n * Brazilian federative-unit boundaries, derived from IBGE data. ~119 KB raw /\n * ~36 KB gzip — adequate for an interactive overview map, not for precise\n * geographic analysis. This module is loaded lazily by `BrazilMap`, so it lands\n * in its own chunk and never inflates a data-only import.\n */\nexport const BR_UF_GEOJSON = rawGeo as unknown as BrUfFeatureCollection;\n"],"mappings":";;AAuCA,IAAaE,IAAgBF"}