cata-centavo 0.1.0

package/dist/core/balance.js

@@ -0,0 +1,68 @@
+function currenciesIn(accounts) {
+    return [...new Set(accounts.map((account) => account.currency))].sort();
+}
+function sumBalances(accounts) {
+    const totals = {
+        cashCents: 0,
+        creditUsedCents: 0,
+        investedCents: 0,
+        loanCents: 0,
+        hasInvestments: false,
+        hasLoans: false,
+    };
+    for (const account of accounts) {
+        switch (account.type) {
+            case "BANK":
+                totals.cashCents += account.amountCents;
+                break;
+            case "CREDIT":
+                totals.creditUsedCents += account.amountCents;
+                break;
+            case "INVESTMENT":
+                totals.investedCents += account.amountCents;
+                totals.hasInvestments = true;
+                break;
+            case "LOAN":
+                totals.loanCents += account.amountCents;
+                totals.hasLoans = true;
+                break;
+        }
+    }
+    return totals;
+}
+function createSummary(currency, accountsCounted, totals) {
+    let investedFields;
+    if (totals.hasInvestments) {
+        investedFields = { investedCents: totals.investedCents };
+    }
+    else {
+        investedFields = {};
+    }
+    let loanFields;
+    if (totals.hasLoans) {
+        loanFields = { loanCents: totals.loanCents };
+    }
+    else {
+        loanFields = {};
+    }
+    return {
+        cashCents: totals.cashCents,
+        creditUsedCents: totals.creditUsedCents,
+        currency,
+        accountsCounted,
+        ...investedFields,
+        ...loanFields,
+    };
+}
+export function summarize(accounts) {
+    const currencies = currenciesIn(accounts);
+    if (currencies.length !== 1) {
+        return { ok: false, currencies };
+    }
+    const currency = currencies[0];
+    if (currency === undefined) {
+        return { ok: false, currencies };
+    }
+    return { ok: true, summary: createSummary(currency, accounts.length, sumBalances(accounts)) };
+}
+//# sourceMappingURL=balance.js.map

package/dist/core/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../src/core/balance.ts"],"names":[],"mappings":"AAwBA,SAAS,YAAY,CAAC,QAA4B;IAChD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1E,CAAC;AAED,SAAS,WAAW,CAAC,QAA4B;IAC/C,MAAM,MAAM,GAAW;QACrB,SAAS,EAAE,CAAC;QACZ,eAAe,EAAE,CAAC;QAClB,aAAa,EAAE,CAAC;QAChB,SAAS,EAAE,CAAC;QACZ,cAAc,EAAE,KAAK;QACrB,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,MAAM;gBACT,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;gBACxC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,CAAC,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;gBAC9C,MAAM;YACR,KAAK,YAAY;gBACf,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;gBAC5C,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;gBAC7B,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;gBACxC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACvB,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,eAAuB,EAAE,MAAc;IAC9E,IAAI,cAAsE,CAAC;IAC3E,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,cAAc,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,cAAc,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,UAA8D,CAAC;IACnE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,UAAU,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,QAAQ;QACR,eAAe;QACf,GAAG,cAAc;QACjB,GAAG,UAAU;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAA4B;IACpD,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE1C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;AAChG,CAAC"}

package/dist/core/bill-rows.js

@@ -0,0 +1,132 @@
+import { isSelfTransfer } from "./self-transfer.js";
+/** Sums posted rows in bill sign, where a purchase increases the amount due. */
+export function derivePostedCents(rows) {
+    let postedCents = 0;
+    for (const row of rows) {
+        if (isSelfTransfer(row)) {
+            continue;
+        }
+        postedCents -= row.amountCents;
+    }
+    return postedCents;
+}
+/**
+ * Derives future instalments from explicit rows and each open-cycle position.
+ * Only the larger total is subtracted from utilized credit.
+ */
+export function deriveBillCommitment(partition, utilizationCents) {
+    let materializedCents = 0;
+    for (const row of partition.futureRows) {
+        materializedCents -= row.amountCents;
+    }
+    const impliedCents = deriveImpliedCents(partition.openCycleRows, partition.wrappedInstalmentRowIds);
+    const futureCents = Math.max(materializedCents, impliedCents);
+    return {
+        materializedCents,
+        impliedCents,
+        futureCents,
+        committedCents: utilizationCents - futureCents,
+    };
+}
+/**
+ * Dedupes bulk-posted plans inside one open cycle.
+ *
+ * Raw `description | instalmentTotal` is safe only at this boundary. A wrapped
+ * counter needs rows from two cycles, while a counter embedded in the raw
+ * description gives each instalment a different key.
+ *
+ * The highest posted position contributes its unposted tail. Every other
+ * distinct position in the same cycle contributes once.
+ */
+function deriveImpliedCents(rows, wrappedInstalmentRowIds) {
+    const plans = new Map();
+    for (const row of rows) {
+        addToOpenCyclePlans(plans, wrappedInstalmentRowIds, row);
+    }
+    let impliedCents = 0;
+    for (const plan of plans.values()) {
+        const otherOpenCycleInstalments = plan.instalmentNumbers.size - 1;
+        const unpostedInstalments = plan.instalmentTotal - plan.highestInstalmentNumber;
+        impliedCents -= plan.amountCents * (otherOpenCycleInstalments + unpostedInstalments);
+    }
+    return impliedCents;
+}
+function addToOpenCyclePlans(plans, wrappedInstalmentRowIds, row) {
+    if (row.instalmentNumber === null || row.instalmentTotal === null) {
+        return;
+    }
+    if (wrappedInstalmentRowIds.has(row.id)) {
+        return;
+    }
+    const key = `${row.description}|${row.instalmentTotal}`;
+    const plan = plans.get(key);
+    if (plan === undefined) {
+        plans.set(key, {
+            amountCents: row.amountCents,
+            highestInstalmentNumber: row.instalmentNumber,
+            instalmentNumbers: new Set([row.instalmentNumber]),
+            instalmentTotal: row.instalmentTotal,
+        });
+        return;
+    }
+    plan.instalmentNumbers.add(row.instalmentNumber);
+    if (row.instalmentNumber > plan.highestInstalmentNumber) {
+        plan.amountCents = row.amountCents;
+        plan.highestInstalmentNumber = row.instalmentNumber;
+    }
+}
+/** Separates rows that affect the open cycle from rows assigned to later cycles. */
+export function partitionBillRows(rows, openCycle, openBillId) {
+    const openCycleRows = [];
+    const futureRows = [];
+    const completedInstalmentDates = new Map();
+    const wrappedInstalmentRowIds = new Set();
+    for (const row of rows) {
+        trackInstalmentHistory(row, completedInstalmentDates, wrappedInstalmentRowIds);
+        if (belongsToOpenBill(row, openBillId)) {
+            openCycleRows.push(row);
+            continue;
+        }
+        if (row.billId !== null) {
+            continue;
+        }
+        if (belongsToFutureCycle(row, openCycle)) {
+            futureRows.push(row);
+            continue;
+        }
+        openCycleRows.push(row);
+    }
+    return { openCycleRows, futureRows, wrappedInstalmentRowIds };
+}
+/**
+ * Marks a counter that restarted after the same raw description completed.
+ *
+ * This has a designed false positive: if two separate instalment purchases
+ * share a description and the first one completed, the second one's real
+ * remainder is zeroed. The feed has no plan identifier that can separate them.
+ */
+function trackInstalmentHistory(row, completedInstalmentDates, wrappedInstalmentRowIds) {
+    const completedDate = completedInstalmentDates.get(row.description);
+    if (completedDate !== undefined && completedDate < row.localDate) {
+        wrappedInstalmentRowIds.add(row.id);
+    }
+    if (!isCompletedInstalment(row)) {
+        return;
+    }
+    if (completedDate === undefined || row.localDate < completedDate) {
+        completedInstalmentDates.set(row.description, row.localDate);
+    }
+}
+function isCompletedInstalment(row) {
+    if (row.instalmentNumber === null || row.instalmentTotal === null) {
+        return false;
+    }
+    return row.instalmentNumber === row.instalmentTotal;
+}
+function belongsToOpenBill(row, openBillId) {
+    return openBillId !== null && row.billId === openBillId;
+}
+function belongsToFutureCycle(row, openCycle) {
+    return row.billForecastDate === "0001-01" || (row.billForecastDate !== null && row.billForecastDate > openCycle);
+}
+//# sourceMappingURL=bill-rows.js.map

package/dist/core/bill-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill-rows.js","sourceRoot":"","sources":["../../src/core/bill-rows.ts"],"names":[],"mappings":"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"}

package/dist/core/bill.js

@@ -0,0 +1,103 @@
+export const ClosingDateSource = {
+    openBill: "open-bill",
+    lastClosed: "last-closed",
+    local: "local",
+    dueDate: "due-date",
+};
+const MONTH_LENGTHS = {
+    1: 31,
+    2: 28,
+    3: 31,
+    4: 30,
+    5: 31,
+    6: 30,
+    7: 31,
+    8: 31,
+    9: 30,
+    10: 31,
+    11: 30,
+    12: 31,
+};
+export function identifyOpenCycle(bills, storedDay, balanceDueDate, today) {
+    const latestBill = newestBill(bills);
+    if (latestBill !== null) {
+        if (billIsOpen(latestBill, today)) {
+            return {
+                openCycle: cycleOf(latestBill.dueDate),
+                source: ClosingDateSource.openBill,
+            };
+        }
+        return {
+            openCycle: followingCycle(cycleOf(latestBill.dueDate)),
+            source: ClosingDateSource.lastClosed,
+        };
+    }
+    if (storedDay !== null) {
+        return {
+            openCycle: cycleFromStoredDay(storedDay, today),
+            source: ClosingDateSource.local,
+        };
+    }
+    if (balanceDueDate !== null) {
+        return {
+            openCycle: followingCycle(cycleOf(balanceDueDate)),
+            source: ClosingDateSource.dueDate,
+        };
+    }
+    return null;
+}
+function billIsOpen(bill, today) {
+    if (bill.closingDate !== null) {
+        return bill.closingDate >= today;
+    }
+    return bill.dueDate > today;
+}
+/** The bill the rest of the list is measured against: latest closing date, or due date when the connector omits it. */
+export function newestBill(bills) {
+    let newest = null;
+    for (const candidate of bills) {
+        if (newest === null || billDate(candidate) > billDate(newest)) {
+            newest = candidate;
+        }
+    }
+    return newest;
+}
+function billDate(bill) {
+    if (bill.closingDate !== null) {
+        return bill.closingDate;
+    }
+    return bill.dueDate;
+}
+function cycleFromStoredDay(storedDay, today) {
+    const currentCycle = cycleOf(today);
+    const year = Number(currentCycle.slice(0, 4));
+    const month = Number(currentCycle.slice(5, 7));
+    const closingDay = Math.min(storedDay, daysInMonth(year, month));
+    const closingDate = `${currentCycle}-${String(closingDay).padStart(2, "0")}`;
+    if (today >= closingDate) {
+        return followingCycle(currentCycle);
+    }
+    return currentCycle;
+}
+function cycleOf(date) {
+    return date.slice(0, 7);
+}
+function followingCycle(cycle) {
+    let year = Number(cycle.slice(0, 4));
+    let month = Number(cycle.slice(5, 7)) + 1;
+    if (month === 13) {
+        year += 1;
+        month = 1;
+    }
+    return `${String(year).padStart(4, "0")}-${String(month).padStart(2, "0")}`;
+}
+function daysInMonth(year, month) {
+    if (month === 2 && isLeapYear(year)) {
+        return 29;
+    }
+    return MONTH_LENGTHS[month] ?? 31;
+}
+function isLeapYear(year) {
+    return year % 400 === 0 || (year % 4 === 0 && year % 100 !== 0);
+}
+//# sourceMappingURL=bill.js.map

package/dist/core/bill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill.js","sourceRoot":"","sources":["../../src/core/bill.ts"],"names":[],"mappings":"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"}

package/dist/core/category-source.js

@@ -0,0 +1,26 @@
+/**
+ * The derivation, in precedence order. This array is the single source of
+ * truth: `storage/category-sql.ts` generates the SQL `COALESCE` from it and
+ * `resolveCategory` walks it, so the order and the reported provenance cannot
+ * drift apart (design, "The derivation query").
+ */
+export const BRANCHES = ["override", "counterparty", "pluggy", "snapshot", "learned", "mcc"];
+/** A harvested Pluggy answer is still a Pluggy answer. */
+const REPORTED = {
+    override: "override",
+    counterparty: "counterparty",
+    pluggy: "pluggy",
+    snapshot: "pluggy",
+    learned: "learned",
+    mcc: "mcc",
+};
+export function resolveCategory(columns) {
+    for (const branch of BRANCHES) {
+        const value = columns[branch];
+        if (value !== null) {
+            return { category: value, categorySrc: REPORTED[branch] };
+        }
+    }
+    return { category: null, categorySrc: null };
+}
+//# sourceMappingURL=category-source.js.map

package/dist/core/category-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-source.js","sourceRoot":"","sources":["../../src/core/category-source.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAU,CAAC;AAOtG,0DAA0D;AAC1D,MAAM,QAAQ,GAA6C;IACzD,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,SAAS;IAClB,GAAG,EAAE,KAAK;CACX,CAAC;AASF,MAAM,UAAU,eAAe,CAAC,OAAuB;IACrD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,EAAE,QAAQ,EAAE,KAAmB,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC/C,CAAC"}

package/dist/core/category.js

@@ -0,0 +1,72 @@
+/**
+ * The project's closed category list: Pluggy's 22 top-level categories, taken
+ * verbatim from `GET /categories` (ADR §12.4 step 2 — copy a taxonomy already
+ * validated in production rather than invent one). Every child category rolls
+ * up to its top-level ancestor; the full 130-entry tree and that roll-up
+ * belong with the `cache.db` seed, not here.
+ *
+ * A `const` object plus a derived union, not an `enum` (ADR §13): `enum` is not
+ * erasable syntax, and a string `enum` is nominal, so a category arriving as
+ * JSON could not be assigned without a cast — exactly where validation belongs.
+ *
+ * **Pluggy's id is the value, not the key.** Two reasons. Named keys make the
+ * MCC table in `mcc.ts` readable and typo-proof at compile time. And `"10000000"`
+ * is a canonical array index as a JavaScript property name, so as a key it would
+ * enumerate *before* `"01000000"` in every `Object.keys`; as a value the
+ * declaration order survives.
+ *
+ * **The ids are not uniform width.** All 22 top-level ids are 8 digits, but the
+ * taxonomy underneath them is not: Insurance's four children use 9, starting at
+ * `"200100000"` (Life insurance). Anything deriving a parent by slicing an id at
+ * a fixed offset works on 126 of the 130 entries and breaks on those four.
+ */
+export const CATEGORIES = {
+    income: { id: "01000000", en: "Income", pt: "Renda" },
+    loansAndFinancing: { id: "02000000", en: "Loans and financing", pt: "Empréstimos e financiamento" },
+    investments: { id: "03000000", en: "Investments", pt: "Investimentos" },
+    samePersonTransfer: { id: "04000000", en: "Same person transfer", pt: "Transferência mesma titularidade" },
+    transfers: { id: "05000000", en: "Transfers", pt: "Transferências" },
+    legalObligations: { id: "06000000", en: "Legal obligations", pt: "Obrigações legais" },
+    services: { id: "07000000", en: "Services", pt: "Serviços" },
+    shopping: { id: "08000000", en: "Shopping", pt: "Compras" },
+    digitalServices: { id: "09000000", en: "Digital services", pt: "Serviços digitais" },
+    groceries: { id: "10000000", en: "Groceries", pt: "Supermercado" },
+    foodAndDrinks: { id: "11000000", en: "Food and drinks", pt: "Alimentos e bebidas" },
+    travel: { id: "12000000", en: "Travel", pt: "Viagens" },
+    donations: { id: "13000000", en: "Donations", pt: "Doações" },
+    gambling: { id: "14000000", en: "Gambling", pt: "Apostas" },
+    taxes: { id: "15000000", en: "Taxes", pt: "Impostos" },
+    bankFees: { id: "16000000", en: "Bank fees", pt: "Taxas bancárias" },
+    housing: { id: "17000000", en: "Housing", pt: "Moradia" },
+    healthcare: { id: "18000000", en: "Healthcare", pt: "Saúde" },
+    transportation: { id: "19000000", en: "Transportation", pt: "Transporte" },
+    insurance: { id: "20000000", en: "Insurance", pt: "Seguros" },
+    leisure: { id: "21000000", en: "Leisure", pt: "Lazer" },
+    other: { id: "99999999", en: "Other", pt: "Outros" },
+};
+const BY_ID = new Map(Object.values(CATEGORIES).map((category) => [category.id, category]));
+/** Every valid category id, in Pluggy's own order. */
+export const CATEGORY_IDS = Object.values(CATEGORIES).map((category) => category.id);
+/**
+ * The guard a tool boundary validates with. An agent that invents
+ * `alimentacao` and `alimentação` in one database breaks every aggregate.
+ */
+export function isCategoryId(value) {
+    return BY_ID.has(value);
+}
+/**
+ * What a read tool's `categories` filter accepts: one of the 22, or `"none"`
+ * for the rows the derivation could not categorize.
+ *
+ * `"none"` exists because after the enrichment stops, "show me what has no
+ * category so I can fix it" is the workflow, and the aggregate's null group
+ * samples ten ids rather than listing them (design D6).
+ */
+export function isCategoryFilterValue(value) {
+    return value === "none" || isCategoryId(value);
+}
+/** The category behind an id, or `undefined` when the id is not one of ours. */
+export function categoryById(id) {
+    return BY_ID.get(id);
+}
+//# sourceMappingURL=category.js.map

package/dist/core/category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.js","sourceRoot":"","sources":["../../src/core/category.ts"],"names":[],"mappings":"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"}

package/dist/core/consent.js

@@ -0,0 +1,19 @@
+/**
+ * `revoked` outranks `expired` when both apply: revocation is an act and
+ * expiry is the clock running out, and the act is what the user has to answer
+ * for. `null` means the endpoint answered with no consent at all, which is
+ * `unknown` rather than `revoked` — we never report revocation from absence.
+ */
+export function consentState(consent, now) {
+    if (consent === null) {
+        return "unknown";
+    }
+    if (consent.revokedAt !== null) {
+        return "revoked";
+    }
+    if (consent.expiresAt !== null && consent.expiresAt.getTime() <= now.getTime()) {
+        return "expired";
+    }
+    return "active";
+}
+//# sourceMappingURL=consent.js.map

package/dist/core/consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../src/core/consent.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAuB,EAAE,GAAS;IAC7D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/core/contracts.js

@@ -0,0 +1,9 @@
+/**
+ * The interfaces core requires of whoever serves it. They live here, not beside
+ * their implementations, because a contract belongs to its consumer (ADR §6).
+ *
+ * Nothing in this file imports from `pluggy/`, `storage/` or `mcp/`, and that
+ * includes the Pluggy SDK's types: the vocabulary here is ours (§14.0).
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/core/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/core/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/core/counterparty.js

@@ -0,0 +1,69 @@
+import { isCategoryId } from "./category.js";
+/**
+ * A document we accept from a human. Both lengths are usable manually; only a
+ * CNPJ is ever learned from data (design D4).
+ */
+export function isDocument(value) {
+    return value.length === 11 || value.length === 14;
+}
+export function isCnpj(value) {
+    return value.length === 14;
+}
+/**
+ * A document's category, when its rows agree by a true majority.
+ *
+ * A plurality is not enough. `mcc.ts` maps by plurality and says so, but an MCC
+ * is a line of business shared by thousands of merchants, while a CNPJ is one
+ * merchant — a 12-of-25 CNPJ mapping is a coin flip applied retroactively to
+ * everything that merchant ever sold you.
+ */
+export function learnCounterparties(rows) {
+    const result = [];
+    for (const [document, counts] of tally(rows)) {
+        const winner = majorityOf(document, counts);
+        if (winner !== null) {
+            result.push(winner);
+        }
+    }
+    return result;
+}
+/** How many rows each CNPJ carries per category. Anything else is dropped here. */
+function tally(rows) {
+    const byDocument = new Map();
+    for (const row of rows) {
+        if (!isLearnable(row)) {
+            continue;
+        }
+        let counts = byDocument.get(row.document);
+        if (counts === undefined) {
+            counts = new Map();
+            byDocument.set(row.document, counts);
+        }
+        counts.set(row.category, (counts.get(row.category) ?? 0) + 1);
+    }
+    return byDocument;
+}
+/** Narrows to a row we are willing to learn from: a CNPJ carrying a known category. */
+// Stryker disable next-line ConditionalExpression: the null checks are defensive. The caller's SQL already filters `document IS NOT NULL`, and this function is public enough that a second caller should not have to know that.
+function isLearnable(row) {
+    return row.document !== null && isCnpj(row.document) && row.category !== null && isCategoryId(row.category);
+}
+/** The category holding a true majority of a document's rows, or nothing. */
+function majorityOf(document, counts) {
+    let samples = 0;
+    let agreeing = 0;
+    let category = null;
+    for (const [candidate, count] of counts) {
+        samples += count;
+        // Stryker disable next-line EqualityOperator: `>=` only changes which of two tied categories wins, and a tie can never clear the majority test below — both would be dropped either way.
+        if (count > agreeing) {
+            agreeing = count;
+            category = candidate;
+        }
+    }
+    if (category === null || agreeing * 2 <= samples) {
+        return null;
+    }
+    return { document, category, samples, agreeing };
+}
+//# sourceMappingURL=counterparty.js.map

package/dist/core/counterparty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counterparty.js","sourceRoot":"","sources":["../../src/core/counterparty.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC;AAC7B,CAAC;AAcD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA4B;IAC9D,MAAM,MAAM,GAA0B,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAID,mFAAmF;AACnF,SAAS,KAAK,CAAC,IAA4B;IACzC,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IAErD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QAED,IAAI,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACnB,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,uFAAuF;AACvF,iOAAiO;AACjO,SAAS,WAAW,CAAC,GAAgB;IACnC,OAAO,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC9G,CAAC;AAED,6EAA6E;AAC7E,SAAS,UAAU,CAAC,QAAgB,EAAE,MAAsB;IAC1D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,QAAQ,GAAsB,IAAI,CAAC;IAEvC,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACxC,OAAO,IAAI,KAAK,CAAC;QACjB,yLAAyL;QACzL,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;YACrB,QAAQ,GAAG,KAAK,CAAC;YACjB,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACnD,CAAC"}

package/dist/core/date.js

@@ -0,0 +1,25 @@
+const SAO_PAULO = new Intl.DateTimeFormat("en-CA", {
+    timeZone: "America/Sao_Paulo",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+});
+/**
+ * The calendar day an instant belongs to, in Brazil.
+ *
+ * Stored transaction dates use this same timezone so range filters and the
+ * injected clock compare values in one calendar rather than mixing UTC with
+ * Brazilian local time.
+ */
+export function localDayOf(instant) {
+    const date = new Date(instant);
+    if (Number.isNaN(date.getTime())) {
+        throw new RangeError(`Invalid date: ${instant}`);
+    }
+    return SAO_PAULO.format(date);
+}
+/** Today, in the same units every stored `localDate` is in. */
+export function todayIn(clock) {
+    return localDayOf(clock.now().toISOString());
+}
+//# sourceMappingURL=date.js.map

package/dist/core/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/core/date.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;IACjD,QAAQ,EAAE,mBAAmB;IAC7B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,SAAS;CACf,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,UAAU,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,OAAO,CAAC,KAAY;IAClC,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/core/description.js

@@ -0,0 +1,58 @@
+/**
+ * Payment acquirers that stamp themselves onto the merchant name.
+ *
+ * This list is data and is expected to grow as real cases appear. Adding one
+ * is one line here, one case in the table test, and a cache migration bump.
+ */
+const ACQUIRER_PREFIXES = ["PAG*", "PG *", "PG*", "CIELO*", "REDE*", "STONE*", "MP *", "PAGSEGURO*"];
+/** Corporate suffixes that carry no information about who was paid. */
+const LEGAL_SUFFIXES = ["LTDA", "ME", "EIRELI", "SA", "S/A", "EPP"];
+const TRAILING_INSTALMENT = /\s+\d{1,2}\/\d{1,2}$/u;
+const TRAILING_SEQUENCE = /\s+\d{5,}$/u;
+function stripAcquirerPrefix(value) {
+    for (const prefix of ACQUIRER_PREFIXES) {
+        if (value.startsWith(prefix)) {
+            return value.slice(prefix.length).trim();
+        }
+    }
+    return value;
+}
+function stripTrailingMarker(value) {
+    let result = value;
+    if (TRAILING_INSTALMENT.test(result)) {
+        result = result.replace(TRAILING_INSTALMENT, "").trim();
+    }
+    if (TRAILING_SEQUENCE.test(result)) {
+        result = result.replace(TRAILING_SEQUENCE, "").trim();
+    }
+    return result;
+}
+function stripLegalSuffixes(value) {
+    let result = value;
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const suffix of LEGAL_SUFFIXES) {
+            if (result === suffix) {
+                result = "";
+                changed = true;
+                break;
+            }
+            if (result.endsWith(` ${suffix}`)) {
+                result = result.slice(0, -suffix.length - 1).trim();
+                changed = true;
+                break;
+            }
+        }
+    }
+    return result;
+}
+/** Normalize merchant descriptions into a stable grouping key. */
+export function normalizeDescription(input) {
+    const withoutAccents = input.normalize("NFD").replace(/[\u0300-\u036f]/gu, "");
+    const uppercased = withoutAccents.toUpperCase().replace(/\s+/gu, " ").trim();
+    const withoutPrefix = stripAcquirerPrefix(uppercased);
+    const withoutMarker = stripTrailingMarker(withoutPrefix);
+    return stripLegalSuffixes(withoutMarker).replace(/\s+/gu, " ").trim();
+}
+//# sourceMappingURL=description.js.map

package/dist/core/description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"description.js","sourceRoot":"","sources":["../../src/core/description.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,iBAAiB,GAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAExH,uEAAuE;AACvE,MAAM,cAAc,GAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAEvF,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AACpD,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAExC,SAAS,mBAAmB,CAAC,KAAa;IACxC,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,OAAO,OAAO,EAAE,CAAC;QACf,OAAO,GAAG,KAAK,CAAC;QAEhB,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;YACpC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,MAAM,GAAG,EAAE,CAAC;gBACZ,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM;YACR,CAAC;YAED,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,CAAC;gBAClC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACpD,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7E,MAAM,aAAa,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAEzD,OAAO,kBAAkB,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACxE,CAAC"}