cata-centavo 0.1.0

package/dist/core/diagnose.js

@@ -0,0 +1,32 @@
+import { consentState } from "./consent.js";
+/**
+ * The connection status and the consent behind it, for every configured id.
+ *
+ * The two requests per connection fire together and settle independently: a
+ * consent lookup that fails must not take the item status with it, and the
+ * reverse holds too. One bad id does not abort the rest, and output order
+ * follows `connectionIds` so the report lines up with what the user
+ * configured.
+ */
+export async function diagnose(bank, connectionIds, toFailure, clock) {
+    return Promise.all(connectionIds.map((id) => diagnoseOne(bank, id, toFailure, clock)));
+}
+async function diagnoseOne(bank, id, toFailure, clock) {
+    const [connectionResult, consentResult] = await Promise.allSettled([bank.getConnection(id), bank.getConsent(id)]);
+    const { connection, failure } = readConnection(connectionResult, toFailure);
+    const consent = readConsent(consentResult);
+    return { id, connection, failure, consent, state: consentState(consent, clock.now()) };
+}
+function readConnection(result, toFailure) {
+    if (result.status === "fulfilled") {
+        return { connection: result.value, failure: null };
+    }
+    return { connection: null, failure: toFailure(result.reason) };
+}
+function readConsent(result) {
+    if (result.status === "fulfilled") {
+        return result.value;
+    }
+    return null;
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/core/diagnose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.js","sourceRoot":"","sources":["../../src/core/diagnose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqB,MAAM,cAAc,CAAC;AAW/D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAU,EACV,aAAgC,EAChC,SAA0C,EAC1C,KAAY;IAEZ,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,IAAU,EACV,EAAU,EACV,SAA0C,EAC1C,KAAY;IAEZ,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAElH,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IAE3C,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,SAAS,cAAc,CACrB,MAAwC,EACxC,SAA0C;IAE1C,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,WAAW,CAAC,MAA4C;IAC/D,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/mcc.js

@@ -0,0 +1,124 @@
+import { CATEGORIES } from "./category.js";
+/**
+ * ISO 18245 merchant category code → category, for the codes that show up in
+ * real statements. ADR §12.4 step 3 asks for exactly this and says so: cover
+ * "the codes that actually show up in real statements. All 1000 are not needed
+ * up front." This table is the reason the mapping waited for data.
+ *
+ * The signal matters because the free tier is expected to stop returning
+ * `category` on transactions. When it does, `creditCardMetadata.payeeMCC` is
+ * the only categorization left on a card transaction (ADR §12.1's asymmetry).
+ *
+ * **Provenance, stated honestly.** Derived on 2026-07-26 from one wallet, three
+ * institutions, 1123 card transactions carrying both an MCC and a category.
+ * Each observed category was rolled up to its top-level ancestor and the most
+ * frequent ancestor won. That is 87 of the roughly 1000 ISO 18245 codes: it
+ * covers what one person spends on, not the code space.
+ *
+ * **The winner is a plurality, not always a majority.** 78 of the 87 rows are
+ * unanimous; the weakest is MCC 5968 at 12 of 25. Those rows are mapped by the
+ * same rule as the rest, deliberately — but `samples` and `agreeing` are there
+ * so nobody mistakes one for a 192-sample unanimous mapping.
+ *
+ * Seeded into `cache.db.mcc_categories` rather than consulted from JavaScript,
+ * because `getTransactions`' `categories` filter runs in SQL (ADR §12.2).
+ */
+export const MCC_CATEGORIES = [
+    { mcc: 780, category: CATEGORIES.transfers.id, samples: 2, agreeing: 2 },
+    { mcc: 1740, category: CATEGORIES.housing.id, samples: 1, agreeing: 1 },
+    { mcc: 2741, category: CATEGORIES.services.id, samples: 1, agreeing: 1 },
+    { mcc: 3247, category: CATEGORIES.travel.id, samples: 1, agreeing: 1 },
+    { mcc: 3300, category: CATEGORIES.travel.id, samples: 2, agreeing: 2 },
+    { mcc: 4111, category: CATEGORIES.transportation.id, samples: 1, agreeing: 1 },
+    { mcc: 4121, category: CATEGORIES.transportation.id, samples: 192, agreeing: 192 },
+    { mcc: 4131, category: CATEGORIES.transportation.id, samples: 17, agreeing: 17 },
+    { mcc: 4722, category: CATEGORIES.travel.id, samples: 36, agreeing: 32 },
+    { mcc: 4812, category: CATEGORIES.services.id, samples: 4, agreeing: 4 },
+    { mcc: 4814, category: CATEGORIES.services.id, samples: 11, agreeing: 11 },
+    { mcc: 4816, category: CATEGORIES.digitalServices.id, samples: 4, agreeing: 4 },
+    { mcc: 4899, category: CATEGORIES.digitalServices.id, samples: 12, agreeing: 12 },
+    { mcc: 5131, category: CATEGORIES.shopping.id, samples: 3, agreeing: 3 },
+    { mcc: 5139, category: CATEGORIES.shopping.id, samples: 3, agreeing: 3 },
+    { mcc: 5199, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+    { mcc: 5211, category: CATEGORIES.housing.id, samples: 1, agreeing: 1 },
+    { mcc: 5300, category: CATEGORIES.groceries.id, samples: 11, agreeing: 11 },
+    { mcc: 5309, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+    { mcc: 5310, category: CATEGORIES.shopping.id, samples: 10, agreeing: 10 },
+    { mcc: 5311, category: CATEGORIES.shopping.id, samples: 9, agreeing: 7 },
+    { mcc: 5331, category: CATEGORIES.shopping.id, samples: 2, agreeing: 2 },
+    { mcc: 5411, category: CATEGORIES.groceries.id, samples: 46, agreeing: 46 },
+    { mcc: 5422, category: CATEGORIES.groceries.id, samples: 44, agreeing: 44 },
+    { mcc: 5441, category: CATEGORIES.groceries.id, samples: 4, agreeing: 4 },
+    { mcc: 5451, category: CATEGORIES.groceries.id, samples: 1, agreeing: 1 },
+    { mcc: 5462, category: CATEGORIES.groceries.id, samples: 75, agreeing: 75 },
+    { mcc: 5499, category: CATEGORIES.foodAndDrinks.id, samples: 27, agreeing: 16 },
+    { mcc: 5541, category: CATEGORIES.transportation.id, samples: 1, agreeing: 1 },
+    { mcc: 5611, category: CATEGORIES.shopping.id, samples: 5, agreeing: 5 },
+    { mcc: 5651, category: CATEGORIES.shopping.id, samples: 16, agreeing: 16 },
+    { mcc: 5655, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+    { mcc: 5661, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+    { mcc: 5691, category: CATEGORIES.shopping.id, samples: 4, agreeing: 4 },
+    { mcc: 5697, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+    { mcc: 5698, category: CATEGORIES.shopping.id, samples: 2, agreeing: 2 },
+    { mcc: 5699, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+    { mcc: 5714, category: CATEGORIES.housing.id, samples: 1, agreeing: 1 },
+    { mcc: 5722, category: CATEGORIES.shopping.id, samples: 2, agreeing: 2 },
+    { mcc: 5732, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+    { mcc: 5734, category: CATEGORIES.shopping.id, samples: 35, agreeing: 28 },
+    { mcc: 5812, category: CATEGORIES.foodAndDrinks.id, samples: 105, agreeing: 94 },
+    { mcc: 5813, category: CATEGORIES.foodAndDrinks.id, samples: 20, agreeing: 20 },
+    { mcc: 5814, category: CATEGORIES.foodAndDrinks.id, samples: 90, agreeing: 84 },
+    { mcc: 5815, category: CATEGORIES.digitalServices.id, samples: 43, agreeing: 43 },
+    { mcc: 5818, category: CATEGORIES.digitalServices.id, samples: 1, agreeing: 1 },
+    { mcc: 5912, category: CATEGORIES.healthcare.id, samples: 55, agreeing: 55 },
+    { mcc: 5921, category: CATEGORIES.groceries.id, samples: 5, agreeing: 5 },
+    { mcc: 5942, category: CATEGORIES.shopping.id, samples: 24, agreeing: 24 },
+    { mcc: 5943, category: CATEGORIES.shopping.id, samples: 2, agreeing: 2 },
+    { mcc: 5944, category: CATEGORIES.shopping.id, samples: 2, agreeing: 2 },
+    { mcc: 5947, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+    { mcc: 5962, category: CATEGORIES.travel.id, samples: 7, agreeing: 7 },
+    { mcc: 5963, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+    { mcc: 5968, category: CATEGORIES.shopping.id, samples: 25, agreeing: 12 },
+    { mcc: 5977, category: CATEGORIES.shopping.id, samples: 4, agreeing: 3 },
+    { mcc: 5992, category: CATEGORIES.shopping.id, samples: 2, agreeing: 2 },
+    { mcc: 5999, category: CATEGORIES.shopping.id, samples: 3, agreeing: 3 },
+    { mcc: 6010, category: CATEGORIES.transfers.id, samples: 6, agreeing: 6 },
+    { mcc: 7011, category: CATEGORIES.travel.id, samples: 5, agreeing: 5 },
+    { mcc: 7216, category: CATEGORIES.services.id, samples: 36, agreeing: 36 },
+    { mcc: 7221, category: CATEGORIES.services.id, samples: 1, agreeing: 1 },
+    { mcc: 7230, category: CATEGORIES.services.id, samples: 2, agreeing: 2 },
+    { mcc: 7299, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+    { mcc: 7338, category: CATEGORIES.services.id, samples: 2, agreeing: 2 },
+    { mcc: 7349, category: CATEGORIES.services.id, samples: 1, agreeing: 1 },
+    { mcc: 7372, category: CATEGORIES.digitalServices.id, samples: 3, agreeing: 3 },
+    { mcc: 7379, category: CATEGORIES.services.id, samples: 9, agreeing: 9 },
+    { mcc: 7392, category: CATEGORIES.services.id, samples: 1, agreeing: 1 },
+    { mcc: 7395, category: CATEGORIES.services.id, samples: 1, agreeing: 1 },
+    { mcc: 7399, category: CATEGORIES.services.id, samples: 3, agreeing: 3 },
+    { mcc: 7622, category: CATEGORIES.services.id, samples: 1, agreeing: 1 },
+    { mcc: 7996, category: CATEGORIES.leisure.id, samples: 1, agreeing: 1 },
+    { mcc: 7997, category: CATEGORIES.services.id, samples: 6, agreeing: 6 },
+    { mcc: 7999, category: CATEGORIES.leisure.id, samples: 1, agreeing: 1 },
+    { mcc: 8011, category: CATEGORIES.healthcare.id, samples: 5, agreeing: 5 },
+    { mcc: 8021, category: CATEGORIES.healthcare.id, samples: 7, agreeing: 7 },
+    { mcc: 8043, category: CATEGORIES.healthcare.id, samples: 3, agreeing: 3 },
+    { mcc: 8220, category: CATEGORIES.services.id, samples: 14, agreeing: 14 },
+    { mcc: 8299, category: CATEGORIES.services.id, samples: 13, agreeing: 13 },
+    { mcc: 8398, category: CATEGORIES.donations.id, samples: 1, agreeing: 1 },
+    { mcc: 8661, category: CATEGORIES.donations.id, samples: 2, agreeing: 2 },
+    { mcc: 8699, category: CATEGORIES.services.id, samples: 1, agreeing: 1 },
+    { mcc: 8931, category: CATEGORIES.services.id, samples: 3, agreeing: 3 },
+    { mcc: 8999, category: CATEGORIES.services.id, samples: 6, agreeing: 4 },
+    { mcc: 9399, category: CATEGORIES.services.id, samples: 4, agreeing: 4 },
+    { mcc: 9994, category: CATEGORIES.shopping.id, samples: 1, agreeing: 1 },
+];
+const BY_MCC = new Map(MCC_CATEGORIES.map((entry) => [entry.mcc, entry]));
+/**
+ * The category an MCC defaults to, or `undefined` when we have never seen the
+ * code. There is no fallback category on purpose: an unknown MCC has no answer,
+ * and ADR §12.3's `COALESCE` chain is built to fall through to no category.
+ */
+export function categoryForMcc(mcc) {
+    return BY_MCC.get(mcc)?.category;
+}
+//# sourceMappingURL=mcc.js.map

package/dist/core/mcc.js.map

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

package/dist/core/refresh.js

@@ -0,0 +1,142 @@
+/**
+ * 2s doubling to a 30s ceiling over 40 attempts is a little over eighteen
+ * minutes of patience, chosen against the documented five-minute worst case for
+ * the login step alone.
+ */
+export const POLL = { firstDelayMs: 2_000, maxDelayMs: 30_000, attempts: 40 };
+export const PHASES = {
+    updating: "updating",
+    refreshed: "refreshed",
+    needsUser: "needs-user",
+    loginError: "login-error",
+    failed: "failed",
+};
+export async function refresh(deps, id) {
+    try {
+        const start = await deps.bank.refreshConnection(id);
+        if (start.kind === "too-soon") {
+            return { kind: "already-fresh", everyHours: start.everyHours, lastUpdatedAt: start.lastUpdatedAt };
+        }
+        if (start.kind === "not-refreshable") {
+            return { kind: "not-refreshable" };
+        }
+        return await poll(deps, id, start.connection);
+    }
+    catch (error) {
+        return { kind: "failed", reason: error instanceof Error ? error.message : String(error) };
+    }
+    finally {
+        deps.report({ kind: "settled", id });
+    }
+}
+async function poll(deps, id, first) {
+    let connection = first;
+    let stage = null;
+    /** Silent while the stage repeats, so a long sync reports a handful of times. */
+    const announce = (current) => {
+        if (phaseOf(current) !== PHASES.updating) {
+            return;
+        }
+        const label = stageLabel(current.executionStatus);
+        if (label !== stage) {
+            stage = label;
+            deps.report({ kind: "stage", id, label });
+        }
+    };
+    announce(connection);
+    let delay = POLL.firstDelayMs;
+    for (let attempt = 0; attempt < POLL.attempts; attempt += 1) {
+        const phase = phaseOf(connection);
+        if (phase !== PHASES.updating) {
+            return settled(phase, connection);
+        }
+        await deps.sleep(delay);
+        delay = Math.min(delay * 2, POLL.maxDelayMs);
+        connection = await deps.bank.getConnection(id);
+        announce(connection);
+    }
+    const phase = phaseOf(connection);
+    // Running out of patience is not a failure. The sync continues at Pluggy, and
+    // the next `init` will find it finished.
+    return phase === PHASES.updating ? { kind: "still-updating", connection } : settled(phase, connection);
+}
+function settled(phase, connection) {
+    switch (phase) {
+        case PHASES.refreshed:
+            return { kind: "refreshed", connection };
+        case PHASES.needsUser:
+            return { kind: "needs-user", connection };
+        case PHASES.loginError:
+            return { kind: "login-error", connection };
+        default:
+            return {
+                kind: "failed",
+                reason: `Pluggy ended the sync as ${connection.status} / ${connection.executionStatus ?? "no execution status"}`,
+            };
+    }
+}
+const SUCCEEDED = new Set(["SUCCESS", "PARTIAL_SUCCESS"]);
+/**
+ * Every status whose phase `status` alone decides. `UPDATED` is the one that
+ * needs a second look and so is missing here.
+ */
+const PHASE_BY_STATUS = {
+    UPDATING: PHASES.updating,
+    MERGING: PHASES.updating,
+    // Undocumented as a `status`, yet Pluggy's own rate-limit page shows an item
+    // carrying it. Treated as the success it describes.
+    PARTIAL_SUCCESS: PHASES.refreshed,
+    WAITING_USER_INPUT: PHASES.needsUser,
+    WAITING_USER_ACTION: PHASES.needsUser,
+    LOGIN_ERROR: PHASES.loginError,
+};
+export function phaseOf(connection) {
+    if (connection.status === "UPDATED") {
+        return updatedPhase(connection.executionStatus);
+    }
+    return PHASE_BY_STATUS[connection.status] ?? PHASES.failed;
+}
+/**
+ * `status` is authoritative here: a missing `executionStatus` on an item Pluggy
+ * calls UPDATED is not a reason to call the sync broken.
+ */
+function updatedPhase(executionStatus) {
+    return executionStatus === null || SUCCEEDED.has(executionStatus) ? PHASES.refreshed : PHASES.failed;
+}
+// Stryker disable StringLiteral: spinner text, not behaviour — asserting each label would pin wording no caller reads
+const STAGES = {
+    CREATED: "starting",
+    CREATING: "starting",
+    LOGIN_IN_PROGRESS: "logging in",
+    LOGIN_MFA_IN_PROGRESS: "sending the second factor",
+    WAITING_USER_INPUT: "waiting for your token",
+    WAITING_USER_ACTION: "waiting for you at the bank",
+    USER_AUTHORIZATION_PENDING: "waiting for the bank to authorize us",
+    ACCOUNTS_IN_PROGRESS: "reading accounts",
+    CREDITCARDS_IN_PROGRESS: "reading credit cards",
+    TRANSACTIONS_IN_PROGRESS: "reading transactions",
+    INVESTMENTS_IN_PROGRESS: "reading investments",
+    INVESTMENT_TRANSACTIONS_IN_PROGRESS: "reading investment transactions",
+    INVESTMENTS_TRANSACTIONS_IN_PROGRESS: "reading investment transactions",
+    LOANS_IN_PROGRESS: "reading loans",
+    IDENTITY_IN_PROGRESS: "reading identity",
+    PAYMENT_DATA_IN_PROGRESS: "reading payment data",
+    ACCOUNT_STATEMENTS_IN_PROGRESS: "reading statements",
+    BROKERAGE_NOTE_IN_PROGRESS: "reading brokerage notes",
+    MERGING: "merging what changed",
+    SUCCESS: "done",
+    PARTIAL_SUCCESS: "done, with warnings",
+};
+// Stryker restore StringLiteral
+/**
+ * What to put next to the spinner. An unrecognised stage is shown in the
+ * roughest possible English rather than dropped, because the two enums Pluggy
+ * publishes do not agree with each other and neither is closed.
+ */
+export function stageLabel(executionStatus) {
+    if (executionStatus === null) {
+        return "starting";
+    }
+    return STAGES[executionStatus] ?? executionStatus.toLowerCase().replaceAll("_", " ");
+}
+//# sourceMappingURL=refresh.js.map

package/dist/core/refresh.js.map

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

package/dist/core/self-transfer.js

@@ -0,0 +1,22 @@
+/**
+ * Moving money between your own accounts is not spending, and paying a card
+ * bill is not spending twice.
+ *
+ * These are leaves rather than groups because the distinction lives below the
+ * 22: `05100000` (credit card payment) is excluded while its parent `05000000`
+ * (Transfers) is ordinary spending. They are matched against the *durable*
+ * leaf — `DerivedTransaction.categoryId`, which falls back to the snapshot —
+ * so the exclusion outlives the enrichment.
+ */
+const SELF_TRANSFER_LEAVES = new Set([
+    "04000000", "04010000", "04020000", "04030000", "05100000",
+]);
+/** A manual correction to Same person transfer excludes the row too. */
+const SELF_TRANSFER_GROUP = "04000000";
+export function isSelfTransfer(row) {
+    if (row.category === SELF_TRANSFER_GROUP) {
+        return true;
+    }
+    return row.categoryId !== null && SELF_TRANSFER_LEAVES.has(row.categoryId);
+}
+//# sourceMappingURL=self-transfer.js.map

package/dist/core/self-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-transfer.js","sourceRoot":"","sources":["../../src/core/self-transfer.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IACxD,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;CAC3D,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAEvC,MAAM,UAAU,cAAc,CAAC,GAAuB;IACpD,IAAI,GAAG,CAAC,QAAQ,KAAK,mBAAmB,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC7E,CAAC"}

package/dist/core/taxonomy-tree.js

@@ -0,0 +1,148 @@
+/**
+ * Pluggy's category tree, as returned by `GET /categories` on 2026-07-26 and
+ * recorded in `docs/research/2026-07-26-phase-0-5-recon.md`.
+ *
+ * It ships as code rather than as a `cache.db` seed because `GET /categories`
+ * is exposed to the same plan change as the transaction enrichment, and a
+ * roll-up that stops working is an aggregate that stops working (design D3).
+ *
+ * Only `id` and `parentId` are here. The labels the user reads belong to the 22
+ * top-level categories and already live in `category.ts`.
+ *
+ * `02030001`, `02030002` and `02030003` carry `parentId: "02000000"` while
+ * their ids and their `parentDescription` both point at `02030000`. Pluggy
+ * contradicts itself there; `parentId` is what we build from.
+ */
+export const TAXONOMY = [
+    { id: "01000000", parentId: null },
+    { id: "01010000", parentId: "01000000" },
+    { id: "01020000", parentId: "01000000" },
+    { id: "01030000", parentId: "01000000" },
+    { id: "01040000", parentId: "01000000" },
+    { id: "01050000", parentId: "01000000" },
+    { id: "02000000", parentId: null },
+    { id: "02010000", parentId: "02000000" },
+    { id: "02020000", parentId: "02000000" },
+    { id: "02030000", parentId: "02000000" },
+    { id: "02030001", parentId: "02000000" },
+    { id: "02030002", parentId: "02000000" },
+    { id: "02030003", parentId: "02000000" },
+    { id: "02040000", parentId: "02000000" },
+    { id: "03000000", parentId: null },
+    { id: "03010000", parentId: "03000000" },
+    { id: "03020000", parentId: "03000000" },
+    { id: "03030000", parentId: "03000000" },
+    { id: "03040000", parentId: "03000000" },
+    { id: "03050000", parentId: "03000000" },
+    { id: "03060000", parentId: "03000000" },
+    { id: "03070000", parentId: "03000000" },
+    { id: "04000000", parentId: null },
+    { id: "04010000", parentId: "04000000" },
+    { id: "04020000", parentId: "04000000" },
+    { id: "04030000", parentId: "04000000" },
+    { id: "05000000", parentId: null },
+    { id: "05010000", parentId: "05000000" },
+    { id: "05020000", parentId: "05000000" },
+    { id: "05030000", parentId: "05000000" },
+    { id: "05040000", parentId: "05000000" },
+    { id: "05050000", parentId: "05000000" },
+    { id: "05060000", parentId: "05000000" },
+    { id: "05070000", parentId: "05000000" },
+    { id: "05080000", parentId: "05000000" },
+    { id: "05090000", parentId: "05000000" },
+    { id: "05090001", parentId: "05090000" },
+    { id: "05090002", parentId: "05090000" },
+    { id: "05090003", parentId: "05090000" },
+    { id: "05090004", parentId: "05090000" },
+    { id: "05090005", parentId: "05090000" },
+    { id: "05100000", parentId: "05000000" },
+    { id: "06000000", parentId: null },
+    { id: "06010000", parentId: "06000000" },
+    { id: "06020000", parentId: "06000000" },
+    { id: "07000000", parentId: null },
+    { id: "07010000", parentId: "07000000" },
+    { id: "07010001", parentId: "07010000" },
+    { id: "07010002", parentId: "07010000" },
+    { id: "07010003", parentId: "07010000" },
+    { id: "07020000", parentId: "07000000" },
+    { id: "07020001", parentId: "07020000" },
+    { id: "07020002", parentId: "07020000" },
+    { id: "07020003", parentId: "07020000" },
+    { id: "07020004", parentId: "07020000" },
+    { id: "07030000", parentId: "07000000" },
+    { id: "07030001", parentId: "07030000" },
+    { id: "07030002", parentId: "07030000" },
+    { id: "07030003", parentId: "07030000" },
+    { id: "07040000", parentId: "07000000" },
+    { id: "07040001", parentId: "07040000" },
+    { id: "07040002", parentId: "07040000" },
+    { id: "07040003", parentId: "07040000" },
+    { id: "08000000", parentId: null },
+    { id: "08010000", parentId: "08000000" },
+    { id: "08020000", parentId: "08000000" },
+    { id: "08030000", parentId: "08000000" },
+    { id: "08040000", parentId: "08000000" },
+    { id: "08050000", parentId: "08000000" },
+    { id: "08060000", parentId: "08000000" },
+    { id: "08070000", parentId: "08000000" },
+    { id: "08080000", parentId: "08000000" },
+    { id: "08090000", parentId: "08000000" },
+    { id: "09000000", parentId: null },
+    { id: "09010000", parentId: "09000000" },
+    { id: "09020000", parentId: "09000000" },
+    { id: "09030000", parentId: "09000000" },
+    { id: "10000000", parentId: null },
+    { id: "11000000", parentId: null },
+    { id: "11010000", parentId: "11000000" },
+    { id: "11020000", parentId: "11000000" },
+    { id: "12000000", parentId: null },
+    { id: "12010000", parentId: "12000000" },
+    { id: "12020000", parentId: "12000000" },
+    { id: "12030000", parentId: "12000000" },
+    { id: "12040000", parentId: "12000000" },
+    { id: "13000000", parentId: null },
+    { id: "14000000", parentId: null },
+    { id: "14010000", parentId: "14000000" },
+    { id: "14020000", parentId: "14000000" },
+    { id: "15000000", parentId: null },
+    { id: "15010000", parentId: "15000000" },
+    { id: "15020000", parentId: "15000000" },
+    { id: "15030000", parentId: "15000000" },
+    { id: "16000000", parentId: null },
+    { id: "16010000", parentId: "16000000" },
+    { id: "16020000", parentId: "16000000" },
+    { id: "16030000", parentId: "16000000" },
+    { id: "17000000", parentId: null },
+    { id: "17010000", parentId: "17000000" },
+    { id: "17020000", parentId: "17000000" },
+    { id: "17020001", parentId: "17020000" },
+    { id: "17020002", parentId: "17020000" },
+    { id: "17020003", parentId: "17020000" },
+    { id: "17030000", parentId: "17000000" },
+    { id: "17040000", parentId: "17000000" },
+    { id: "18000000", parentId: null },
+    { id: "18010000", parentId: "18000000" },
+    { id: "18020000", parentId: "18000000" },
+    { id: "18030000", parentId: "18000000" },
+    { id: "18040000", parentId: "18000000" },
+    { id: "19000000", parentId: null },
+    { id: "19010000", parentId: "19000000" },
+    { id: "19020000", parentId: "19000000" },
+    { id: "19030000", parentId: "19000000" },
+    { id: "19040000", parentId: "19000000" },
+    { id: "19050000", parentId: "19000000" },
+    { id: "19050001", parentId: "19050000" },
+    { id: "19050002", parentId: "19050000" },
+    { id: "19050003", parentId: "19050000" },
+    { id: "19050004", parentId: "19050000" },
+    { id: "19050005", parentId: "19050000" },
+    { id: "19050006", parentId: "19050000" },
+    { id: "20000000", parentId: null },
+    { id: "200100000", parentId: "20000000" },
+    { id: "200200000", parentId: "20000000" },
+    { id: "200300000", parentId: "20000000" },
+    { id: "200400000", parentId: "20000000" },
+    { id: "21000000", parentId: null },
+    { id: "99999999", parentId: null },
+];
+//# sourceMappingURL=taxonomy-tree.js.map

package/dist/core/taxonomy-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy-tree.js","sourceRoot":"","sources":["../../src/core/taxonomy-tree.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA6B;IAEhD,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACxC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE;IACzC,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE;IACzC,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE;IACzC,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE;IACzC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClC,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;CACnC,CAAC"}

package/dist/core/taxonomy.js

@@ -0,0 +1,70 @@
+import { isCategoryId } from "./category.js";
+import { TAXONOMY } from "./taxonomy-tree.js";
+function parentOf(id, parents) {
+    if (!parents.has(id)) {
+        throw new Error(`Category points to missing parent ${id}`);
+    }
+    const parentId = parents.get(id);
+    if (parentId === undefined) {
+        throw new Error(`Category points to missing parent ${id}`);
+    }
+    return parentId;
+}
+function rootOf(id, parents) {
+    const seen = new Set();
+    let current = id;
+    while (true) {
+        if (seen.has(current)) {
+            throw new Error(`Category tree contains a cycle at ${current}`);
+        }
+        seen.add(current);
+        const parentId = parentOf(current, parents);
+        if (parentId === undefined) {
+            throw new Error(`Category ${id} points to missing parent ${current}`);
+        }
+        if (parentId === null) {
+            if (!isCategoryId(current)) {
+                throw new Error(`Category tree root ${current} is not a top-level category`);
+            }
+            return current;
+        }
+        current = parentId;
+    }
+}
+/** Maps every category id to its top-level ancestor, transitively. */
+export function buildRollup(entries) {
+    const parents = new Map();
+    for (const entry of entries) {
+        if (parents.has(entry.id)) {
+            throw new Error(`Category tree contains duplicate id ${entry.id}`);
+        }
+        parents.set(entry.id, entry.parentId);
+    }
+    const rollup = new Map();
+    for (const entry of entries) {
+        rollup.set(entry.id, rootOf(entry.id, parents));
+    }
+    return rollup;
+}
+/**
+ * Built once at module load. `buildRollup` throws on a duplicate id, a missing
+ * parent, a cycle or a root that is not top-level — so a defect in the shipped
+ * constant fails the suite rather than a user's walk.
+ */
+const ROLLUP = buildRollup(TAXONOMY);
+/**
+ * The top-level ancestor of a Pluggy category id, or `null` when we do not know
+ * the id.
+ *
+ * Returning `null` rather than throwing is the whole point: the tree ships as
+ * code, so a category Pluggy adds tomorrow is absent by construction. An
+ * unknown leaf must cost that one row its group, not take a whole account's
+ * walk down with it (design D3).
+ */
+export function topCategoryOf(categoryId) {
+    if (categoryId === null) {
+        return null;
+    }
+    return ROLLUP.get(categoryId) ?? null;
+}
+//# sourceMappingURL=taxonomy.js.map

package/dist/core/taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.js","sourceRoot":"","sources":["../../src/core/taxonomy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmB,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAsB,MAAM,oBAAoB,CAAC;AAKlE,SAAS,QAAQ,CAAC,EAAU,EAAE,OAA2C;IACvE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,MAAM,CAAC,EAAU,EAAE,OAA2C;IACrE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAElB,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,6BAA6B,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,8BAA8B,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,GAAG,QAAQ,CAAC;IACrB,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,OAAiC;IAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEjD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,UAAyB;IACrD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC"}

package/dist/core/transaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transaction.js.map

package/dist/core/transaction.js.map

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