sheetlink 0.1.15 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sheetlink",
-  "version": "0.1.15",
+  "version": "0.2.0",
   "description": "CLI for SheetLink — sync your bank transactions to any destination",
   "type": "module",
   "bin": {

package/src/adapters/csv.js

@@ -4,11 +4,52 @@
  * Writes a flat snapshot of transactions to a CSV file.
  * Each run OVERWRITES the file — no append, no dedup.
  * Users who want history should use Postgres or SQLite.
+ *
+ * Full schema matches the Google Sheets extension and Excel add-in (35 transaction columns).
+ * Use --slim to write the legacy 14-column subset instead.
  */
 
 import fs from 'fs';
 
-const HEADERS = [
+const HEADERS_FULL = [
+  'transaction_id',
+  'account_id',
+  'persistent_account_id',
+  'account_name',
+  'account_mask',
+  'date',
+  'authorized_date',
+  'datetime',
+  'authorized_datetime',
+  'description_raw',
+  'merchant_name',
+  'merchant_entity_id',
+  'amount',
+  'iso_currency_code',
+  'unofficial_currency_code',
+  'pending',
+  'pending_transaction_id',
+  'check_number',
+  'category_primary',
+  'category_detailed',
+  'payment_channel',
+  'transaction_type',
+  'transaction_code',
+  'location_address',
+  'location_city',
+  'location_region',
+  'location_postal_code',
+  'location_country',
+  'location_lat',
+  'location_lon',
+  'website',
+  'logo_url',
+  'source_institution',
+  'category',
+  'synced_at',
+];
+
+const HEADERS_SLIM = [
   'date',
   'name',
   'amount',
@@ -16,12 +57,12 @@ const HEADERS = [
   'account_id',
   'account_name',
   'account_mask',
-  'institution_name',
+  'source_institution',
   'pending',
   'payment_channel',
   'merchant_name',
-  'primary_category',
-  'detailed_category',
+  'category_primary',
+  'category_detailed',
   'transaction_id',
 ];
 
@@ -34,12 +75,64 @@ function escape(val) {
   return s;
 }
 
-function formatRow(txn) {
-  return HEADERS.map(h => escape(txn[h])).join(',');
+function flattenTransaction(tx) {
+  const loc = tx.location || {};
+  const pfc = tx.personal_finance_category || {};
+  const category = Array.isArray(tx.plaid_category) ? tx.plaid_category.join(', ') : (tx.category || null);
+  return {
+    transaction_id: tx.transaction_id,
+    account_id: tx.account_id,
+    persistent_account_id: tx.persistent_account_id || null,
+    account_name: tx.account_name,
+    account_mask: tx.account_mask,
+    date: tx.date,
+    authorized_date: tx.authorized_date || null,
+    datetime: tx.datetime || null,
+    authorized_datetime: tx.authorized_datetime || null,
+    description_raw: tx.description_raw || tx.name,
+    merchant_name: tx.merchant_name || null,
+    merchant_entity_id: tx.merchant_entity_id || null,
+    amount: tx.amount,
+    iso_currency_code: tx.iso_currency_code || null,
+    unofficial_currency_code: tx.unofficial_currency_code || null,
+    pending: tx.pending,
+    pending_transaction_id: tx.pending_transaction_id || null,
+    check_number: tx.check_number || null,
+    category_primary: pfc.primary || tx.category_primary || null,
+    category_detailed: pfc.detailed || tx.category_detailed || null,
+    payment_channel: tx.payment_channel || null,
+    transaction_type: tx.transaction_type || null,
+    transaction_code: tx.transaction_code || null,
+    location_address: loc.address || null,
+    location_city: loc.city || null,
+    location_region: loc.region || null,
+    location_postal_code: loc.postal_code || null,
+    location_country: loc.country || null,
+    location_lat: loc.lat ?? null,
+    location_lon: loc.lon ?? null,
+    website: tx.website || null,
+    logo_url: tx.logo_url || null,
+    source_institution: tx.source_institution || tx.institution_name || null,
+    category,
+    synced_at: new Date().toISOString(),
+  };
 }
 
-export function writeCsv(transactions, filePath = './sheetlink-transactions.csv') {
-  const lines = [HEADERS.join(','), ...transactions.map(formatRow)];
-  fs.writeFileSync(filePath, lines.join('\n') + '\n', 'utf8');
+export function writeCsv(transactions, filePath = './sheetlink-transactions.csv', { slim = false } = {}) {
+  const headers = slim ? HEADERS_SLIM : HEADERS_FULL;
+  const rows = transactions.map(tx => {
+    const flat = slim
+      ? {
+          ...tx,
+          name: tx.description_raw || tx.name,
+          source_institution: tx.source_institution || tx.institution_name || null,
+          category: Array.isArray(tx.plaid_category) ? tx.plaid_category.join(', ') : (tx.category || null),
+          category_primary: (tx.personal_finance_category?.primary) || tx.category_primary || null,
+          category_detailed: (tx.personal_finance_category?.detailed) || tx.category_detailed || null,
+        }
+      : flattenTransaction(tx);
+    return headers.map(h => escape(flat[h])).join(',');
+  });
+  fs.writeFileSync(filePath, [headers.join(','), ...rows].join('\n') + '\n', 'utf8');
   console.log(`Wrote ${transactions.length} transactions to ${filePath}`);
 }

package/src/adapters/postgres.js

@@ -3,44 +3,116 @@
  *
  * Creates sheetlink_transactions and sheetlink_accounts tables if they don't exist.
  * Upserts on primary key — safe to run repeatedly with no duplicates.
+ *
+ * Full schema matches the Google Sheets extension and Excel add-in (35 transaction columns).
+ * Use --slim to write the legacy 14-column subset instead.
  */
 
-const CREATE_TRANSACTIONS = `
+// Full schema — matches TRANSACTIONS_HEADERS_FULL in extension + Excel
+const CREATE_TRANSACTIONS_FULL = `
+CREATE TABLE IF NOT EXISTS sheetlink_transactions (
+  transaction_id           TEXT PRIMARY KEY,
+  account_id               TEXT,
+  persistent_account_id    TEXT,
+  account_name             TEXT,
+  account_mask             TEXT,
+  date                     DATE NOT NULL,
+  authorized_date          DATE,
+  datetime                 TEXT,
+  authorized_datetime      TEXT,
+  description_raw          TEXT,
+  merchant_name            TEXT,
+  merchant_entity_id       TEXT,
+  amount                   DECIMAL(10,2),
+  iso_currency_code        TEXT,
+  unofficial_currency_code TEXT,
+  pending                  BOOLEAN,
+  pending_transaction_id   TEXT,
+  check_number             TEXT,
+  category_primary         TEXT,
+  category_detailed        TEXT,
+  payment_channel          TEXT,
+  transaction_type         TEXT,
+  transaction_code         TEXT,
+  location_address         TEXT,
+  location_city            TEXT,
+  location_region          TEXT,
+  location_postal_code     TEXT,
+  location_country         TEXT,
+  location_lat             DECIMAL(10,7),
+  location_lon             DECIMAL(10,7),
+  website                  TEXT,
+  logo_url                 TEXT,
+  source_institution       TEXT,
+  category                 TEXT,
+  synced_at                TIMESTAMP DEFAULT NOW()
+)`;
+
+// Slim schema — legacy 14-column subset for --slim flag
+const CREATE_TRANSACTIONS_SLIM = `
 CREATE TABLE IF NOT EXISTS sheetlink_transactions (
-  transaction_id TEXT PRIMARY KEY,
-  date DATE NOT NULL,
-  name TEXT,
-  amount DECIMAL(10,2),
-  category TEXT,
-  account_id TEXT,
-  account_name TEXT,
-  account_mask TEXT,
-  institution_name TEXT,
-  pending BOOLEAN,
-  payment_channel TEXT,
-  merchant_name TEXT,
-  primary_category TEXT,
-  detailed_category TEXT,
-  synced_at TIMESTAMP DEFAULT NOW()
+  transaction_id    TEXT PRIMARY KEY,
+  date              DATE NOT NULL,
+  name              TEXT,
+  amount            DECIMAL(10,2),
+  category          TEXT,
+  account_id        TEXT,
+  account_name      TEXT,
+  account_mask      TEXT,
+  source_institution TEXT,
+  pending           BOOLEAN,
+  payment_channel   TEXT,
+  merchant_name     TEXT,
+  category_primary  TEXT,
+  category_detailed TEXT,
+  synced_at         TIMESTAMP DEFAULT NOW()
 )`;
 
 const CREATE_ACCOUNTS = `
 CREATE TABLE IF NOT EXISTS sheetlink_accounts (
-  account_id TEXT PRIMARY KEY,
-  name TEXT,
-  mask TEXT,
-  type TEXT,
-  subtype TEXT,
-  balance_current DECIMAL(10,2),
-  balance_available DECIMAL(10,2),
-  institution_name TEXT,
-  last_synced_at TIMESTAMP DEFAULT NOW()
+  account_id            TEXT PRIMARY KEY,
+  persistent_account_id TEXT,
+  name                  TEXT,
+  official_name         TEXT,
+  mask                  TEXT,
+  type                  TEXT,
+  subtype               TEXT,
+  current_balance       DECIMAL(10,2),
+  available_balance     DECIMAL(10,2),
+  iso_currency_code     TEXT,
+  institution           TEXT,
+  last_synced_at        TIMESTAMP DEFAULT NOW()
 )`;
 
-const UPSERT_TRANSACTION = `
+const UPSERT_TRANSACTION_FULL = `
+INSERT INTO sheetlink_transactions
+  (transaction_id, account_id, persistent_account_id, account_name, account_mask,
+   date, authorized_date, datetime, authorized_datetime,
+   description_raw, merchant_name, merchant_entity_id,
+   amount, iso_currency_code, unofficial_currency_code,
+   pending, pending_transaction_id, check_number,
+   category_primary, category_detailed, payment_channel,
+   transaction_type, transaction_code,
+   location_address, location_city, location_region, location_postal_code, location_country,
+   location_lat, location_lon,
+   website, logo_url, source_institution, category, synced_at)
+VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12,$13,$14,$15,$16,$17,$18,$19,$20,$21,$22,$23,$24,$25,$26,$27,$28,$29,$30,$31,$32,$33,$34,NOW())
+ON CONFLICT (transaction_id) DO UPDATE SET
+  date = EXCLUDED.date,
+  authorized_date = EXCLUDED.authorized_date,
+  description_raw = EXCLUDED.description_raw,
+  amount = EXCLUDED.amount,
+  pending = EXCLUDED.pending,
+  pending_transaction_id = EXCLUDED.pending_transaction_id,
+  category_primary = EXCLUDED.category_primary,
+  category_detailed = EXCLUDED.category_detailed,
+  category = EXCLUDED.category,
+  synced_at = NOW()`;
+
+const UPSERT_TRANSACTION_SLIM = `
 INSERT INTO sheetlink_transactions
   (transaction_id, date, name, amount, category, account_id, account_name, account_mask,
-   institution_name, pending, payment_channel, merchant_name, primary_category, detailed_category, synced_at)
+   source_institution, pending, payment_channel, merchant_name, category_primary, category_detailed, synced_at)
 VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12,$13,$14,NOW())
 ON CONFLICT (transaction_id) DO UPDATE SET
   date = EXCLUDED.date,
@@ -52,16 +124,16 @@ ON CONFLICT (transaction_id) DO UPDATE SET
 
 const UPSERT_ACCOUNT = `
 INSERT INTO sheetlink_accounts
-  (account_id, name, mask, type, subtype, balance_current, balance_available, institution_name, last_synced_at)
-VALUES ($1,$2,$3,$4,$5,$6,$7,$8,NOW())
+  (account_id, persistent_account_id, name, official_name, mask, type, subtype,
+   current_balance, available_balance, iso_currency_code, institution, last_synced_at)
+VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,NOW())
 ON CONFLICT (account_id) DO UPDATE SET
   name = EXCLUDED.name,
-  balance_current = EXCLUDED.balance_current,
-  balance_available = EXCLUDED.balance_available,
+  current_balance = EXCLUDED.current_balance,
+  available_balance = EXCLUDED.available_balance,
   last_synced_at = NOW()`;
 
-export async function writePostgres(transactions, accounts, connectionString) {
-  // Dynamic import so users without pg installed don't hit an error on other commands
+export async function writePostgres(transactions, accounts, connectionString, { slim = false } = {}) {
   const { default: pg } = await import('pg').then(m => ({ default: m.default || m }));
   const { Client } = pg;
 
@@ -69,24 +141,76 @@ export async function writePostgres(transactions, accounts, connectionString) {
   await client.connect();
 
   try {
-    await client.query(CREATE_TRANSACTIONS);
+    await client.query(slim ? CREATE_TRANSACTIONS_SLIM : CREATE_TRANSACTIONS_FULL);
     await client.query(CREATE_ACCOUNTS);
 
     for (const tx of transactions) {
-      await client.query(UPSERT_TRANSACTION, [
-        tx.transaction_id, tx.date, tx.name, tx.amount, tx.category,
-        tx.account_id, tx.account_name, tx.account_mask,
-        tx.institution_name || tx.source_institution,
-        tx.pending, tx.payment_channel, tx.merchant_name,
-        tx.primary_category, tx.detailed_category,
-      ]);
+      const loc = tx.location || {};
+      const pfc = tx.personal_finance_category || {};
+      const category = Array.isArray(tx.plaid_category) ? tx.plaid_category.join(', ') : (tx.category || null);
+      const source_institution = tx.source_institution || tx.institution_name || null;
+
+      if (slim) {
+        await client.query(UPSERT_TRANSACTION_SLIM, [
+          tx.transaction_id, tx.date, tx.description_raw || tx.name, tx.amount,
+          category, tx.account_id, tx.account_name, tx.account_mask,
+          source_institution,
+          tx.pending, tx.payment_channel, tx.merchant_name,
+          pfc.primary || tx.category_primary || null,
+          pfc.detailed || tx.category_detailed || null,
+        ]);
+      } else {
+        await client.query(UPSERT_TRANSACTION_FULL, [
+          tx.transaction_id,
+          tx.account_id,
+          tx.persistent_account_id || null,
+          tx.account_name,
+          tx.account_mask,
+          tx.date,
+          tx.authorized_date || null,
+          tx.datetime || null,
+          tx.authorized_datetime || null,
+          tx.description_raw || tx.name,
+          tx.merchant_name || null,
+          tx.merchant_entity_id || null,
+          tx.amount,
+          tx.iso_currency_code || null,
+          tx.unofficial_currency_code || null,
+          tx.pending,
+          tx.pending_transaction_id || null,
+          tx.check_number || null,
+          pfc.primary || tx.category_primary || null,
+          pfc.detailed || tx.category_detailed || null,
+          tx.payment_channel || null,
+          tx.transaction_type || null,
+          tx.transaction_code || null,
+          loc.address || null,
+          loc.city || null,
+          loc.region || null,
+          loc.postal_code || null,
+          loc.country || null,
+          loc.lat ?? null,
+          loc.lon ?? null,
+          tx.website || null,
+          tx.logo_url || null,
+          source_institution,
+          category,
+        ]);
+      }
     }
 
     for (const acc of accounts) {
       await client.query(UPSERT_ACCOUNT, [
-        acc.account_id, acc.name, acc.mask, acc.type, acc.subtype,
-        acc.balances?.current ?? null,
-        acc.balances?.available ?? null,
+        acc.account_id,
+        acc.persistent_account_id || null,
+        acc.name,
+        acc.official_name || null,
+        acc.mask,
+        acc.type,
+        acc.subtype,
+        acc.balances?.current ?? acc.current_balance ?? null,
+        acc.balances?.available ?? acc.available_balance ?? null,
+        acc.iso_currency_code || null,
         acc.institution || acc.institution_name || null,
       ]);
     }

package/src/adapters/sqlite.js

@@ -2,44 +2,109 @@
  * sqlite.js - SQLite upsert adapter (MAX tier only)
  *
  * Same schema as Postgres. Upserts on primary key — safe to run repeatedly.
+ *
+ * Full schema matches the Google Sheets extension and Excel add-in (35 transaction columns).
+ * Use --slim to write the legacy 14-column subset instead.
  */
 
-const CREATE_TRANSACTIONS = `
+const CREATE_TRANSACTIONS_FULL = `
 CREATE TABLE IF NOT EXISTS sheetlink_transactions (
-  transaction_id TEXT PRIMARY KEY,
-  date TEXT NOT NULL,
-  name TEXT,
-  amount REAL,
-  category TEXT,
-  account_id TEXT,
-  account_name TEXT,
-  account_mask TEXT,
-  institution_name TEXT,
-  pending INTEGER,
-  payment_channel TEXT,
-  merchant_name TEXT,
-  primary_category TEXT,
-  detailed_category TEXT,
-  synced_at TEXT DEFAULT (datetime('now'))
+  transaction_id           TEXT PRIMARY KEY,
+  account_id               TEXT,
+  persistent_account_id    TEXT,
+  account_name             TEXT,
+  account_mask             TEXT,
+  date                     TEXT NOT NULL,
+  authorized_date          TEXT,
+  datetime                 TEXT,
+  authorized_datetime      TEXT,
+  description_raw          TEXT,
+  merchant_name            TEXT,
+  merchant_entity_id       TEXT,
+  amount                   REAL,
+  iso_currency_code        TEXT,
+  unofficial_currency_code TEXT,
+  pending                  INTEGER,
+  pending_transaction_id   TEXT,
+  check_number             TEXT,
+  category_primary         TEXT,
+  category_detailed        TEXT,
+  payment_channel          TEXT,
+  transaction_type         TEXT,
+  transaction_code         TEXT,
+  location_address         TEXT,
+  location_city            TEXT,
+  location_region          TEXT,
+  location_postal_code     TEXT,
+  location_country         TEXT,
+  location_lat             REAL,
+  location_lon             REAL,
+  website                  TEXT,
+  logo_url                 TEXT,
+  source_institution       TEXT,
+  category                 TEXT,
+  synced_at                TEXT DEFAULT (datetime('now'))
+)`;
+
+const CREATE_TRANSACTIONS_SLIM = `
+CREATE TABLE IF NOT EXISTS sheetlink_transactions (
+  transaction_id    TEXT PRIMARY KEY,
+  date              TEXT NOT NULL,
+  name              TEXT,
+  amount            REAL,
+  category          TEXT,
+  account_id        TEXT,
+  account_name      TEXT,
+  account_mask      TEXT,
+  source_institution TEXT,
+  pending           INTEGER,
+  payment_channel   TEXT,
+  merchant_name     TEXT,
+  category_primary  TEXT,
+  category_detailed TEXT,
+  synced_at         TEXT DEFAULT (datetime('now'))
 )`;
 
 const CREATE_ACCOUNTS = `
 CREATE TABLE IF NOT EXISTS sheetlink_accounts (
-  account_id TEXT PRIMARY KEY,
-  name TEXT,
-  mask TEXT,
-  type TEXT,
-  subtype TEXT,
-  balance_current REAL,
-  balance_available REAL,
-  institution_name TEXT,
-  last_synced_at TEXT DEFAULT (datetime('now'))
+  account_id            TEXT PRIMARY KEY,
+  persistent_account_id TEXT,
+  name                  TEXT,
+  official_name         TEXT,
+  mask                  TEXT,
+  type                  TEXT,
+  subtype               TEXT,
+  current_balance       REAL,
+  available_balance     REAL,
+  iso_currency_code     TEXT,
+  institution           TEXT,
+  last_synced_at        TEXT DEFAULT (datetime('now'))
 )`;
 
-const UPSERT_TRANSACTION = `
+const UPSERT_TRANSACTION_FULL = `
+INSERT INTO sheetlink_transactions
+  (transaction_id, account_id, persistent_account_id, account_name, account_mask,
+   date, authorized_date, datetime, authorized_datetime,
+   description_raw, merchant_name, merchant_entity_id,
+   amount, iso_currency_code, unofficial_currency_code,
+   pending, pending_transaction_id, check_number,
+   category_primary, category_detailed, payment_channel,
+   transaction_type, transaction_code,
+   location_address, location_city, location_region, location_postal_code, location_country,
+   location_lat, location_lon,
+   website, logo_url, source_institution, category, synced_at)
+VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,datetime('now'))
+ON CONFLICT(transaction_id) DO UPDATE SET
+  date=excluded.date, authorized_date=excluded.authorized_date,
+  description_raw=excluded.description_raw, amount=excluded.amount, pending=excluded.pending,
+  pending_transaction_id=excluded.pending_transaction_id,
+  category_primary=excluded.category_primary, category_detailed=excluded.category_detailed,
+  category=excluded.category, synced_at=datetime('now')`;
+
+const UPSERT_TRANSACTION_SLIM = `
 INSERT INTO sheetlink_transactions
   (transaction_id, date, name, amount, category, account_id, account_name, account_mask,
-   institution_name, pending, payment_channel, merchant_name, primary_category, detailed_category, synced_at)
+   source_institution, pending, payment_channel, merchant_name, category_primary, category_detailed, synced_at)
 VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,datetime('now'))
 ON CONFLICT(transaction_id) DO UPDATE SET
   date=excluded.date, name=excluded.name, amount=excluded.amount,
@@ -47,41 +112,93 @@ ON CONFLICT(transaction_id) DO UPDATE SET
 
 const UPSERT_ACCOUNT = `
 INSERT INTO sheetlink_accounts
-  (account_id, name, mask, type, subtype, balance_current, balance_available, institution_name, last_synced_at)
-VALUES (?,?,?,?,?,?,?,?,datetime('now'))
+  (account_id, persistent_account_id, name, official_name, mask, type, subtype,
+   current_balance, available_balance, iso_currency_code, institution, last_synced_at)
+VALUES (?,?,?,?,?,?,?,?,?,?,?,datetime('now'))
 ON CONFLICT(account_id) DO UPDATE SET
-  name=excluded.name, balance_current=excluded.balance_current,
-  balance_available=excluded.balance_available, last_synced_at=datetime('now')`;
+  name=excluded.name, current_balance=excluded.current_balance,
+  available_balance=excluded.available_balance, last_synced_at=datetime('now')`;
 
-export async function writeSQLite(transactions, accounts, dbPath) {
-  // Dynamic import so users without better-sqlite3 don't hit an error on other commands
+export async function writeSQLite(transactions, accounts, dbPath, { slim = false } = {}) {
   const Database = (await import('better-sqlite3')).default;
 
   const db = new Database(dbPath);
-  db.exec(CREATE_TRANSACTIONS);
+  db.exec(slim ? CREATE_TRANSACTIONS_SLIM : CREATE_TRANSACTIONS_FULL);
   db.exec(CREATE_ACCOUNTS);
 
-  const insertTx = db.prepare(UPSERT_TRANSACTION);
+  const insertTx = db.prepare(slim ? UPSERT_TRANSACTION_SLIM : UPSERT_TRANSACTION_FULL);
   const insertAcc = db.prepare(UPSERT_ACCOUNT);
 
   const txBatch = db.transaction((txns) => {
     for (const tx of txns) {
-      insertTx.run(
-        tx.transaction_id, tx.date, tx.name, tx.amount, tx.category,
-        tx.account_id, tx.account_name, tx.account_mask,
-        tx.institution_name || tx.source_institution,
-        tx.pending ? 1 : 0, tx.payment_channel, tx.merchant_name,
-        tx.primary_category, tx.detailed_category,
-      );
+      const loc = tx.location || {};
+      const pfc = tx.personal_finance_category || {};
+      const category = Array.isArray(tx.plaid_category) ? tx.plaid_category.join(', ') : (tx.category || null);
+      const source_institution = tx.source_institution || tx.institution_name || null;
+
+      if (slim) {
+        insertTx.run(
+          tx.transaction_id, tx.date, tx.description_raw || tx.name, tx.amount,
+          category, tx.account_id, tx.account_name, tx.account_mask,
+          source_institution,
+          tx.pending ? 1 : 0, tx.payment_channel, tx.merchant_name,
+          pfc.primary || tx.category_primary || null,
+          pfc.detailed || tx.category_detailed || null,
+        );
+      } else {
+        insertTx.run(
+          tx.transaction_id,
+          tx.account_id,
+          tx.persistent_account_id || null,
+          tx.account_name,
+          tx.account_mask,
+          tx.date,
+          tx.authorized_date || null,
+          tx.datetime || null,
+          tx.authorized_datetime || null,
+          tx.description_raw || tx.name,
+          tx.merchant_name || null,
+          tx.merchant_entity_id || null,
+          tx.amount,
+          tx.iso_currency_code || null,
+          tx.unofficial_currency_code || null,
+          tx.pending ? 1 : 0,
+          tx.pending_transaction_id || null,
+          tx.check_number || null,
+          pfc.primary || tx.category_primary || null,
+          pfc.detailed || tx.category_detailed || null,
+          tx.payment_channel || null,
+          tx.transaction_type || null,
+          tx.transaction_code || null,
+          loc.address || null,
+          loc.city || null,
+          loc.region || null,
+          loc.postal_code || null,
+          loc.country || null,
+          loc.lat ?? null,
+          loc.lon ?? null,
+          tx.website || null,
+          tx.logo_url || null,
+          source_institution,
+          category,
+        );
+      }
     }
   });
 
   const accBatch = db.transaction((accs) => {
     for (const acc of accs) {
       insertAcc.run(
-        acc.account_id, acc.name, acc.mask, acc.type, acc.subtype,
-        acc.balances?.current ?? null,
-        acc.balances?.available ?? null,
+        acc.account_id,
+        acc.persistent_account_id || null,
+        acc.name,
+        acc.official_name || null,
+        acc.mask,
+        acc.type,
+        acc.subtype,
+        acc.balances?.current ?? acc.current_balance ?? null,
+        acc.balances?.available ?? acc.available_balance ?? null,
+        acc.iso_currency_code || null,
         acc.institution || acc.institution_name || null,
       );
     }

package/src/commands/sync.js

@@ -8,6 +8,9 @@
  *   csv [--file path]         - Snapshot CSV, overwrites each run (PRO+)
  *   postgres://...            - Upsert to Postgres (MAX only)
  *   sqlite:///path/to/db      - Upsert to SQLite (MAX only)
+ *
+ * Flags:
+ *   --slim                    - Write legacy 14-column schema instead of full 34-column schema
  */
 
 import { listItems, syncItem } from '../api.js';
@@ -17,9 +20,30 @@ import { writeCsv } from '../adapters/csv.js';
 import { writePostgres } from '../adapters/postgres.js';
 import { writeSQLite } from '../adapters/sqlite.js';
 
+/**
+ * Enrich transactions with account_name and account_mask from the accounts array.
+ * The API returns accounts and transactions separately; transactions only carry account_id.
+ */
+function enrichTransactions(transactions, accounts) {
+  const accountMap = {};
+  for (const acc of accounts) {
+    accountMap[acc.account_id] = acc;
+  }
+  return transactions.map(tx => {
+    const acc = accountMap[tx.account_id];
+    return {
+      ...tx,
+      account_name: acc?.name ?? tx.account_name ?? null,
+      account_mask: acc?.mask ?? tx.account_mask ?? null,
+      persistent_account_id: acc?.persistent_account_id ?? tx.persistent_account_id ?? null,
+    };
+  });
+}
+
 export async function cmdSync(options) {
   const output = options.output || getDefaultOutput();
   const itemId = options.item || null;
+  const slim = !!options.slim;
 
   // Collect items to sync
   let itemIds;
@@ -52,11 +76,12 @@ export async function cmdSync(options) {
     }, 80);
     try {
       const result = await syncItem(id);
-      allTransactions.push(...(result.transactions || []));
+      const enriched = enrichTransactions(result.transactions || [], result.accounts || []);
+      allTransactions.push(...enriched);
       allAccounts.push(...(result.accounts || []));
-      results.push({ item_id: id, ...result });
+      results.push({ item_id: id, ...result, transactions: enriched });
       clearInterval(spinner);
-      process.stderr.write(`\r✓ Synced ${id} — ${result.transactions?.length ?? 0} transactions\n`);
+      process.stderr.write(`\r✓ Synced ${id} — ${enriched.length} transactions\n`);
     } catch (e) {
       clearInterval(spinner);
       if (e.code === 'ITEM_LOGIN_REQUIRED') {
@@ -82,19 +107,18 @@ export async function cmdSync(options) {
   }
 
   if (output === 'csv') {
-    writeCsv(allTransactions, options.file);
+    writeCsv(allTransactions, options.file, { slim });
     return;
   }
 
   if (output.startsWith('postgres://') || output.startsWith('postgresql://')) {
-    await writePostgres(allTransactions, allAccounts, output);
+    await writePostgres(allTransactions, allAccounts, output, { slim });
     return;
   }
 
   if (output.startsWith('sqlite://')) {
-    // sqlite:///absolute/path → /absolute/path, sqlite://relative/path → relative/path
     const dbPath = output.replace(/^sqlite:\/\//, '') || './sheetlink.db';
-    writeSQLite(allTransactions, allAccounts, dbPath);
+    writeSQLite(allTransactions, allAccounts, dbPath, { slim });
     return;
   }
 

package/src/index.js

@@ -42,6 +42,7 @@ program
   .option('--output <dest>', 'Output destination: json (default), csv, postgres://..., sqlite:///path')
   .option('--file <path>', 'File path for CSV output (default: ./sheetlink-transactions.csv)')
   .option('--item <item_id>', 'Sync a specific item only (default: all connected banks)')
+  .option('--slim', 'Write 14-column schema instead of full 34-column schema')
   .addHelpText('after', `
 Examples:
   sheetlink sync                                         JSON to stdout (pipeable)
@@ -50,6 +51,7 @@ Examples:
   sheetlink sync --output csv --file ~/finances.csv      CSV to custom path
   sheetlink sync --output postgres://localhost/mydb      Upsert to Postgres (MAX only)
   sheetlink sync --output sqlite:///~/finance.db         Upsert to SQLite (MAX only)
+  sheetlink sync --output postgres://localhost/mydb --slim  Legacy 14-column schema
   sheetlink sync --item VBX93wmRY4Iy...                  Sync one bank only
   `)
   .action(cmdSync);