cata-centavo 0.1.0

package/dist/storage/db.js

@@ -0,0 +1,162 @@
+import { chmodSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { CACHE_MIGRATIONS, DATA_MIGRATIONS } from "./migrations.js";
+const MAIN = "main";
+/** `PRAGMA` and `ATTACH … AS` take no bound parameters, which is why this exists. */
+function quoteSchema(schema) {
+    if (!/^[a-z_][a-z0-9_]*$/u.test(schema)) {
+        throw new Error(`refusing to interpolate an unsafe schema name: ${schema}`);
+    }
+    return schema;
+}
+function escapeLiteral(str) {
+    return str.replaceAll("'", "''");
+}
+/** A `data.db` written by a newer release than the one now running. */
+export class SchemaTooNewError extends Error {
+    found;
+    supported;
+    constructor(path, found, supported) {
+        super(`${path} is at schema version ${found}, but this version of cata-centavo only understands ${supported}. ` +
+            "It was written by a newer release. Upgrade rather than downgrade — this file holds work that cannot be refetched.");
+        this.name = "SchemaTooNewError";
+        this.found = found;
+        this.supported = supported;
+    }
+}
+export function openDatabase(options) {
+    mkdirSync(dirname(options.path), { recursive: true });
+    const db = new DatabaseSync(options.path);
+    try {
+        restrictToOwner(options.path);
+        // WAL and a single writer, taken from the prior implementation's comment:
+        // "a single local writer avoids SQLITE_BUSY" (ADR §16.1). Set before the
+        // journal is created so the -wal and -shm siblings inherit the mode above.
+        db.exec("PRAGMA journal_mode = WAL");
+        db.exec("PRAGMA busy_timeout = 5000");
+        db.exec("PRAGMA foreign_keys = ON");
+        migrateSchema(db, options, MAIN);
+        if (options.path === ":memory:" && options.migrations === CACHE_MIGRATIONS) {
+            db.exec("ATTACH DATABASE ':memory:' AS userdata");
+            for (const m of DATA_MIGRATIONS) {
+                db.exec(m.up.replace(/CREATE TABLE /gi, "CREATE TABLE userdata."));
+            }
+        }
+    }
+    catch (error) {
+        db.close();
+        throw error;
+    }
+    return db;
+}
+/**
+ * The two files of ADR §10 on one connection.
+ *
+ * They share a connection because Phase 3's derivation resolves a category by
+ * reading both in one statement, and because the harvest writes the snapshot
+ * inside the walk's transaction. Two handles cannot see each other and cannot
+ * do either.
+ */
+export function openDatabases(paths) {
+    const dataDb = openDatabase({ path: paths.dataDb, migrations: DATA_MIGRATIONS, policy: "migrate" });
+    dataDb.close();
+    const db = openDatabase({ path: paths.cacheDb, migrations: CACHE_MIGRATIONS, policy: "rebuild" });
+    try {
+        db.exec(`ATTACH DATABASE '${escapeLiteral(paths.dataDb)}' AS userdata`);
+    }
+    catch (error) {
+        db.close();
+        throw error;
+    }
+    return { db, close: () => db.close() };
+}
+function migrateSchema(db, options, schema = MAIN) {
+    const target = targetVersion(options.migrations);
+    const current = readUserVersion(db, schema);
+    if (current === target) {
+        return;
+    }
+    if (options.policy === "rebuild") {
+        dropEverything(db, schema);
+        apply(db, options.migrations, 0, schema);
+        return;
+    }
+    if (current > target) {
+        throw new SchemaTooNewError(options.path, current, target);
+    }
+    apply(db, options.migrations, current, schema);
+}
+export function targetVersion(migrations) {
+    return migrations.reduce((highest, migration) => Math.max(highest, migration.to), 0);
+}
+/**
+ * One transaction per step, so a chain that dies halfway leaves the file at the
+ * last version that actually committed rather than at a version it never
+ * reached.
+ */
+function apply(db, migrations, from, schema = MAIN) {
+    for (const migration of migrations) {
+        if (migration.to <= from) {
+            continue;
+        }
+        db.exec("BEGIN");
+        try {
+            db.exec(migration.up);
+            stamp(db, schema, migration.to);
+            db.exec("COMMIT");
+        }
+        catch (error) {
+            db.exec("ROLLBACK");
+            throw error;
+        }
+    }
+}
+function dropEverything(db, schema = MAIN) {
+    const safeSchema = quoteSchema(schema);
+    const objects = db.prepare(`SELECT type, name FROM ${safeSchema}.sqlite_master WHERE name NOT LIKE 'sqlite_%'`).all();
+    db.exec("PRAGMA foreign_keys = OFF");
+    for (const object of objects) {
+        const type = String(object["type"]);
+        const name = String(object["name"]).replaceAll('"', '""');
+        if (type === "table") {
+            db.exec(`DROP TABLE IF EXISTS ${safeSchema}."${name}"`);
+        }
+        else if (type === "view") {
+            db.exec(`DROP VIEW IF EXISTS ${safeSchema}."${name}"`);
+        }
+    }
+    db.exec("PRAGMA foreign_keys = ON");
+    stamp(db, schema, 0);
+}
+/** The `PRAGMA user_version` a file currently carries. */
+export function schemaVersion(db, schema = MAIN) {
+    return readUserVersion(db, schema);
+}
+function readUserVersion(db, schema = MAIN) {
+    const value = db.prepare(`PRAGMA ${quoteSchema(schema)}.user_version`).get()?.["user_version"];
+    const version = Number(value);
+    if (Number.isInteger(version)) {
+        return version;
+    }
+    return 0;
+}
+/** `PRAGMA` takes no bound parameters, which is why the guard is here. */
+function stamp(db, schema, version) {
+    if (!Number.isInteger(version) || version < 0) {
+        throw new Error(`refusing to stamp a non-integer schema version: ${version}`);
+    }
+    db.exec(`PRAGMA ${quoteSchema(schema)}.user_version = ${version}`);
+}
+/**
+ * `cache.db` holds the full financial history in plaintext (ADR §9). The
+ * permission bits, not the directory, are what stop a second local account
+ * reading it.
+ */
+function restrictToOwner(path) {
+    if (path === ":memory:" || path === "") {
+        return;
+    }
+    chmodSync(path, 0o600);
+}
+//# sourceMappingURL=db.js.map

package/dist/storage/db.js.map

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

package/dist/storage/diagnostics.js

@@ -0,0 +1,57 @@
+import { schemaVersion } from "./db.js";
+/**
+ * What `doctor` reads off disk, without touching the network. `doctor` runs
+ * precisely when things are broken, so a diagnostic that throws on a fresh
+ * install would be worse than useless — every count here reads as zero, and
+ * every date as `null`, rather than raising.
+ */
+export function readLocalState(db) {
+    const paths = readAttachedPaths(db);
+    return {
+        cacheDb: paths.get("main") ?? "",
+        dataDb: paths.get("userdata") ?? "",
+        cacheVersion: schemaVersion(db),
+        dataVersion: schemaVersion(db, "userdata"),
+        accountsWalked: countAccountsWalked(db),
+        newestLocalDate: readNewestLocalDate(db),
+        perConnection: readPerConnection(db),
+        snapshotRows: countRows(db, "userdata.category_snapshot"),
+        counterpartyDocuments: countRows(db, "userdata.counterparty_categories"),
+        mccRows: countRows(db, "mcc_categories"),
+    };
+}
+function countRows(db, table) {
+    const row = db.prepare(`SELECT COUNT(*) AS n FROM ${table}`).get();
+    return Number(row?.["n"] ?? 0);
+}
+function countAccountsWalked(db) {
+    const row = db.prepare("SELECT COUNT(*) AS n FROM transaction_sync").get();
+    return Number(row?.["n"] ?? 0);
+}
+function readNewestLocalDate(db) {
+    const row = db.prepare("SELECT MAX(local_date) AS newest FROM transactions").get();
+    return stringOrNull(row?.["newest"]);
+}
+function readPerConnection(db) {
+    const rows = db
+        .prepare(`SELECT connection_id, COUNT(*) AS accounts, MIN(last_updated_at) AS oldest_walk
+       FROM transaction_sync
+       GROUP BY connection_id`)
+        .all();
+    return new Map(rows.map((row) => [
+        String(row["connection_id"]),
+        { accounts: Number(row["accounts"]), oldestWalk: stringOrNull(row["oldest_walk"]) },
+    ]));
+}
+/** The file paths of `main` (`cache.db`) and `userdata` (`data.db`), straight off the open connection. */
+function readAttachedPaths(db) {
+    const rows = db.prepare("PRAGMA database_list").all();
+    return new Map(rows.map((row) => [String(row["name"]), String(row["file"])]));
+}
+function stringOrNull(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    return String(value);
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/storage/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/storage/diagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAexC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAgB;IAC7C,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACpC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;QAChC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE;QACnC,YAAY,EAAE,aAAa,CAAC,EAAE,CAAC;QAC/B,WAAW,EAAE,aAAa,CAAC,EAAE,EAAE,UAAU,CAAC;QAC1C,cAAc,EAAE,mBAAmB,CAAC,EAAE,CAAC;QACvC,eAAe,EAAE,mBAAmB,CAAC,EAAE,CAAC;QACxC,aAAa,EAAE,iBAAiB,CAAC,EAAE,CAAC;QACpC,YAAY,EAAE,SAAS,CAAC,EAAE,EAAE,4BAA4B,CAAC;QACzD,qBAAqB,EAAE,SAAS,CAAC,EAAE,EAAE,kCAAkC,CAAC;QACxE,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,gBAAgB,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,EAAgB,EAAE,KAA2F;IAC9H,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IACnE,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,mBAAmB,CAAC,EAAgB;IAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,4CAA4C,CAAC,CAAC,GAAG,EAAE,CAAC;IAC3E,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,mBAAmB,CAAC,EAAgB;IAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAC,GAAG,EAAE,CAAC;IACnF,OAAO,YAAY,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAgB;IACzC,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;8BAEwB,CACzB;SACA,GAAG,EAA+B,CAAC;IAEtC,OAAO,IAAI,GAAG,CACZ,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC5B,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE;KACpF,CAAC,CACH,CAAC;AACJ,CAAC;AAED,0GAA0G;AAC1G,SAAS,iBAAiB,CAAC,EAAgB;IACzC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,GAAG,EAA+B,CAAC;IACnF,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/storage/harvest.js

@@ -0,0 +1,87 @@
+import { learnCounterparties } from "../core/counterparty.js";
+import { topCategoryOf } from "../core/taxonomy.js";
+import { DERIVED_CATEGORY, DERIVED_COLUMNS } from "./category-sql.js";
+const SNAPSHOT_UPSERT = `
+  INSERT INTO userdata.category_snapshot (transaction_id, category_id, top_category_id, harvested_at)
+  VALUES (?, ?, ?, ?)
+  ON CONFLICT(transaction_id) DO UPDATE SET
+    category_id = excluded.category_id,
+    top_category_id = excluded.top_category_id,
+    harvested_at = excluded.harvested_at
+`;
+const LEARNED_INSERT = `
+  INSERT INTO userdata.counterparty_categories (document, category, origin, samples, agreeing, created_at)
+  VALUES (?, ?, 'learned', ?, ?, ?)
+  ON CONFLICT(document) DO NOTHING
+`;
+/** Every labelled counterparty row we hold, read through the full derivation. */
+const LABELLED_ROWS = `SELECT t.document AS document, ${DERIVED_CATEGORY} AS category
+  FROM (SELECT t.*, ${DERIVED_COLUMNS} FROM transactions t WHERE t.document IS NOT NULL) t`;
+/**
+ * Copy the provider's enrichment into `data.db` while it still arrives.
+ *
+ * This runs inside the walk's open transaction, with every row already in hand.
+ * No user action, no separate command, no schedule — because the enrichment is
+ * expected to stop and the walk that discovers it has stopped is the same walk
+ * that would otherwise overwrite the history with NULL.
+ *
+ * SQLite's atomic commit across attached databases does not hold under WAL,
+ * which `openDatabase` enables, so a crash can commit `cache.db` and not
+ * `userdata`. That is survivable only because of the asymmetry in
+ * `snapshotCategories`: the worst case is one walk's new labels lost, and the
+ * next walk rewrites them.
+ */
+export function harvest(options) {
+    snapshotCategories(options);
+    relearnCounterparties(options);
+}
+/**
+ * The snapshot only ever gains.
+ *
+ * A row arriving with no category writes nothing, so a walk that lands after
+ * the plan drops to free cannot erase what an earlier walk remembered. That one
+ * asymmetry is what makes the history survive.
+ */
+function snapshotCategories(options) {
+    const upsert = options.db.prepare(SNAPSHOT_UPSERT);
+    const now = options.clock.now().toISOString();
+    for (const row of options.rows) {
+        if (row.categoryId !== null) {
+            upsert.run(row.id, row.categoryId, topCategoryFor(row, options.log), now);
+        }
+    }
+}
+/**
+ * Recomputed wholesale rather than incrementally.
+ *
+ * It is affordable at this size, and it means a manual correction, a re-sync
+ * and a cache rebuild all converge on the same map instead of accumulating
+ * drift. The `DELETE` touches only learned rows and `DO NOTHING` then declines
+ * to overwrite a manual row for a document that would also have been learned,
+ * so a human's answer always outlives the inference.
+ */
+function relearnCounterparties(options) {
+    const rows = options.db.prepare(LABELLED_ROWS).all();
+    const learned = learnCounterparties(rows);
+    options.db.exec("DELETE FROM userdata.counterparty_categories WHERE origin = 'learned'");
+    const insert = options.db.prepare(LEARNED_INSERT);
+    const now = options.clock.now().toISOString();
+    for (const item of learned) {
+        insert.run(item.document, item.category, item.samples, item.agreeing, now);
+    }
+}
+/**
+ * The roll-up, with the unknown leaf reported rather than thrown.
+ *
+ * The tree ships as code, so a category the provider adds tomorrow is absent by
+ * construction. Costing that row its group is right; costing the whole
+ * account's walk is not (design D3).
+ */
+export function topCategoryFor(row, log) {
+    const top = topCategoryOf(row.categoryId);
+    if (top === null && row.categoryId !== null) {
+        log.warn({ transactionId: row.id, categoryId: row.categoryId }, "Unknown category, left ungrouped");
+    }
+    return top;
+}
+//# sourceMappingURL=harvest.js.map

package/dist/storage/harvest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harvest.js","sourceRoot":"","sources":["../../src/storage/harvest.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEtE,MAAM,eAAe,GAAG;;;;;;;CAOvB,CAAC;AAEF,MAAM,cAAc,GAAG;;;;CAItB,CAAC;AAEF,iFAAiF;AACjF,MAAM,aAAa,GAAG,kCAAkC,gBAAgB;sBAClD,eAAe,sDAAsD,CAAC;AAS5F;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,OAAO,CAAC,OAAuB;IAC7C,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,OAAuB;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAE9C,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,UAAU,EAAE,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAAC,OAAuB;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,EAG/C,CAAC;IACJ,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAE1C,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IAEzF,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,GAAgB,EAAE,GAAW;IAC1D,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,EAAE,kCAAkC,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/storage/migrations.js

@@ -0,0 +1,125 @@
+import { MCC_CATEGORIES } from "../core/mcc.js";
+/**
+ * The MCC seed is generated from `src/core/mcc.ts` so the table has one source.
+ * Values are interpolated rather than bound because a migration's `up` is a
+ * script, not a statement — the inputs are a compile-time constant of integers
+ * and closed-list category ids, so there is no untrusted string here.
+ */
+function seedMccCategories() {
+    return MCC_CATEGORIES
+        .map((row) => `INSERT INTO mcc_categories (mcc, category, samples, agreeing) VALUES ('${row.mcc}', '${row.category}', ${row.samples}, ${row.agreeing});`)
+        .join("\n");
+}
+/**
+ * Droppable: any mismatch is resolved by refetching from Pluggy (§10).
+ *
+ * **Bump `to` when the description normalizer changes.** `description_norm` is
+ * written at insert and never recomputed, so appending an acquirer prefix to
+ * `core/description.ts` leaves every cached row carrying the old value. The
+ * rebuild policy is the re-derive pass, and this number is what triggers it.
+ *
+ * Under `rebuild`, `apply` replays every entry from 0 against a dropped file,
+ * so a future `{to: 2}` is an additional statement rather than an `ALTER` — a
+ * `CREATE TABLE transactions` in both entries would fail on the second.
+ */
+export const CACHE_MIGRATIONS = [
+    {
+        to: 1,
+        up: `
+      CREATE TABLE transactions (
+        id TEXT PRIMARY KEY,
+        account_id TEXT NOT NULL,
+        connection_id TEXT NOT NULL,
+        account_type TEXT NOT NULL,
+        account_subtype TEXT,
+        occurred_at TEXT NOT NULL,
+        local_date TEXT NOT NULL,
+        amount_cents INTEGER NOT NULL,
+        currency TEXT NOT NULL,
+        original_amount_cents INTEGER,
+        original_currency TEXT,
+        description TEXT NOT NULL,
+        description_norm TEXT NOT NULL,
+        category_id TEXT,
+        document TEXT,
+        counterparty_name TEXT,
+        payment_method TEXT,
+        mcc TEXT,
+        bill_id TEXT,
+        instalment_number INTEGER,
+        instalment_total INTEGER,
+        purchase_date TEXT
+      );
+      CREATE INDEX transactions_by_date ON transactions(local_date DESC, id DESC);
+      CREATE INDEX transactions_by_account ON transactions(account_id, local_date DESC);
+
+      CREATE TABLE transaction_sync (
+        account_id TEXT PRIMARY KEY,
+        connection_id TEXT NOT NULL,
+        last_updated_at TEXT
+      );
+    `,
+    },
+    {
+        to: 2,
+        up: `
+      ALTER TABLE transactions ADD COLUMN top_category_id TEXT;
+      CREATE INDEX transactions_by_document ON transactions(document);
+
+      CREATE TABLE mcc_categories (
+        mcc TEXT PRIMARY KEY,
+        category TEXT NOT NULL,
+        samples INTEGER NOT NULL,
+        agreeing INTEGER NOT NULL
+      );
+      ${seedMccCategories()}
+    `,
+    },
+    {
+        to: 3,
+        up: `
+      ALTER TABLE transactions ADD COLUMN bill_forecast_date TEXT;
+    `,
+    },
+];
+/** Never dropped: overrides, rules and closing days live here (§10). */
+export const DATA_MIGRATIONS = [
+    {
+        to: 1,
+        up: `
+      CREATE TABLE category_overrides (
+        transaction_id TEXT PRIMARY KEY,
+        category TEXT NOT NULL,
+        created_at TEXT NOT NULL
+      );
+
+      CREATE TABLE counterparty_categories (
+        document TEXT PRIMARY KEY,
+        category TEXT NOT NULL,
+        origin TEXT NOT NULL,
+        samples INTEGER,
+        agreeing INTEGER,
+        created_at TEXT NOT NULL
+      );
+
+      CREATE TABLE category_snapshot (
+        transaction_id TEXT PRIMARY KEY,
+        category_id TEXT NOT NULL,
+        top_category_id TEXT,
+        harvested_at TEXT NOT NULL
+      );
+    `,
+    },
+    {
+        to: 2,
+        up: `
+      CREATE TABLE card_closing_day (
+        account_id TEXT PRIMARY KEY,
+        day INTEGER NOT NULL,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+    `,
+    },
+];
+//# sourceMappingURL=migrations.js.map

package/dist/storage/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/storage/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOhD;;;;;GAKG;AACH,SAAS,iBAAiB;IACxB,OAAO,cAAc;SAClB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,0EAA0E,GAAG,CAAC,GAAG,OAAO,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,QAAQ,IAAI,CAAC;SACxJ,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD;QACE,EAAE,EAAE,CAAC;QACL,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCH;KACF;IACD;QACE,EAAE,EAAE,CAAC;QACL,EAAE,EAAE;;;;;;;;;;QAUA,iBAAiB,EAAE;KACtB;KACF;IACD;QACE,EAAE,EAAE,CAAC;QACL,EAAE,EAAE;;KAEH;KACF;CACF,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD;QACE,EAAE,EAAE,CAAC;QACL,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;;;KAsBH;KACF;IACD;QACE,EAAE,EAAE,CAAC;QACL,EAAE,EAAE;;;;;;;KAOH;KACF;CACF,CAAC"}

package/dist/storage/transaction-row.js

@@ -0,0 +1,74 @@
+import { resolveCategory } from "../core/category-source.js";
+import { topCategoryFor } from "./harvest.js";
+/**
+ * The codec between a SQLite row and our domain object.
+ *
+ * It lives apart from the store because it answers a different question: the
+ * store decides *which* rows, this decides what a row *is*. Both directions are
+ * here so the column list and the value list cannot drift apart.
+ */
+export function rowToTransaction(row) {
+    return {
+        id: String(row["id"]),
+        accountId: String(row["account_id"]),
+        connectionId: String(row["connection_id"]),
+        accountType: row["account_type"],
+        accountSubtype: nullableString(row["account_subtype"]),
+        occurredAt: String(row["occurred_at"]),
+        localDate: String(row["local_date"]),
+        amountCents: Number(row["amount_cents"]),
+        currency: String(row["currency"]),
+        originalAmountCents: nullableNumber(row["original_amount_cents"]),
+        originalCurrency: nullableString(row["original_currency"]),
+        description: String(row["description"]),
+        descriptionNorm: String(row["description_norm"]),
+        categoryId: nullableString(row["category_id"]),
+        document: nullableString(row["document"]),
+        counterpartyName: nullableString(row["counterparty_name"]),
+        paymentMethod: nullableString(row["payment_method"]),
+        mcc: nullableString(row["mcc"]),
+        billId: nullableString(row["bill_id"]),
+        billForecastDate: nullableString(row["bill_forecast_date"]),
+        instalmentNumber: nullableNumber(row["instalment_number"]),
+        instalmentTotal: nullableNumber(row["instalment_total"]),
+        purchaseDate: nullableString(row["purchase_date"]),
+    };
+}
+export function rowToDerived(row) {
+    return {
+        ...rowToTransaction(row),
+        categoryId: nullableString(row["c_leaf"]),
+        ...resolveCategory({
+            override: nullableString(row["c_override"]),
+            counterparty: nullableString(row["c_counterparty"]),
+            pluggy: nullableString(row["c_pluggy"]),
+            snapshot: nullableString(row["c_snapshot"]),
+            learned: nullableString(row["c_learned"]),
+            mcc: nullableString(row["c_mcc"]),
+        }),
+    };
+}
+export function transactionValues(row, log) {
+    return [
+        row.id, row.accountId, row.connectionId, row.accountType, row.accountSubtype,
+        row.occurredAt, row.localDate, row.amountCents, row.currency, row.originalAmountCents,
+        row.originalCurrency, row.description, row.descriptionNorm, row.categoryId, row.document,
+        row.counterpartyName, row.paymentMethod, row.mcc, row.billId, row.instalmentNumber,
+        row.billForecastDate, row.instalmentTotal, row.purchaseDate, topCategoryFor(row, log),
+    ];
+}
+function nullableString(value) {
+    // Stryker disable next-line ConditionalExpression,LogicalOperator,BlockStatement: SQLite columns are NULL or concrete values; undefined is defensive input handling.
+    if (value === null || value === undefined) {
+        return null;
+    }
+    return String(value);
+}
+function nullableNumber(value) {
+    // Stryker disable next-line ConditionalExpression,LogicalOperator,BlockStatement: SQLite columns are NULL or concrete values; undefined is defensive input handling.
+    if (value === null || value === undefined) {
+        return null;
+    }
+    return Number(value);
+}
+//# sourceMappingURL=transaction-row.js.map

package/dist/storage/transaction-row.js.map

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