cashgrab 0.0.0

package/README.md

@@ -0,0 +1,73 @@
+# cashgrab
+
+`cashgrab` is a local CLI that scrapes banking websites via Chrome DevTools Protocol (CDP). It launches a dedicated Chrome instance, connects over remote debugging, and automates authenticated sessions to pull account data.
+
+Supported banks:
+
+- **Bankwest** -- account balances and transaction export (QIF)
+- **St.George** -- account balances and transaction export (CSV)
+
+The repo also includes shell scripts for cleaning exported transaction files before import.
+
+## Setup
+
+```bash
+npm install
+npm link
+```
+
+## Browser
+
+All scraping commands require Chrome running with remote debugging on port `9222`. Use `--profile` to copy your existing Chrome profile (cookies, logins) into the dedicated instance first.
+
+```bash
+cashgrab browser
+cashgrab browser --profile
+```
+
+The browser launches with its own profile directory (`~/.cache/browser-tools`). If Chrome is already running on `:9222`, the command exits immediately.
+
+## Bankwest
+
+Requires a logged-in Bankwest session.
+
+### Account Balances
+
+```bash
+cashgrab bankwest balances
+```
+
+### Transaction Export
+
+Exports transactions as a QIF file. The account name is a case-insensitive substring match against the Bankwest dropdown -- it must match exactly one account, otherwise available options are listed.
+
+```bash
+cashgrab bankwest transactions "offset joint" -r L30Days
+cashgrab bankwest transactions "home loan john" -r L90Days -o ~/Downloads
+cashgrab bankwest transactions "offset joint" --from 01/01/2026 --to 28/03/2026
+```
+
+## St.George
+
+Requires a logged-in St.George session.
+
+### Account Balances
+
+```bash
+cashgrab st-george balances
+```
+
+### Transaction Export
+
+Exports transactions as a CSV file. The account name is a case-insensitive substring match against the portfolio accounts.
+
+```bash
+cashgrab st-george transactions "000 111 222" -r L7Days
+cashgrab st-george transactions "residential loan s000 111 222 333" -r L30Days -o ~/Downloads
+cashgrab st-george transactions "complete freedom offset 000 111 222" --from 01/03/2026 --to 29/03/2026
+```
+
+## Cleaning
+
+- [St George](src/stg) -- CSV cleaning
+- [NAB](src/nab) -- QIF cleaning

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "cashgrab",
+  "version": "0.0.0",
+  "type": "module",
+  "bin": {
+    "cashgrab": "src/cli.js"
+  },
+  "files": [
+    "src/*.js",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tekumara/cashgrab.git"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "puppeteer-core": "^23.11.1"
+  }
+}

package/src/bankwest-balances.js

@@ -0,0 +1,111 @@
+/**
+ * Bankwest Account Balances
+ *
+ * Connects to a running Chrome instance (CDP on localhost:9222),
+ * navigates to the Bankwest balances page,
+ * then prints all accounts and their balances.
+ *
+ * Prerequisites:
+ *   - Chrome running with --remote-debugging-port=9222
+ *   - Logged in to Bankwest Online Banking
+ */
+import puppeteer from "puppeteer-core";
+
+const BALANCES_URL =
+  "https://online.bankwest.com.au/CMWeb/AccountInformation/AI/Balances.aspx";
+const EXPECTED_URL_PATTERN = /online\.bankwest\.com\.au\/CMWeb\/AccountInformation\/AI\/Balances\.aspx/;
+const CHROME_DEBUG_URL = "http://localhost:9222";
+
+export async function bankwestBalances() {
+  const browser = await Promise.race([
+    puppeteer.connect({
+      browserURL: CHROME_DEBUG_URL,
+      defaultViewport: null,
+    }),
+    new Promise((_, reject) =>
+      setTimeout(() => reject(new Error("Connection timeout after 5s")), 5000)
+    ),
+  ]).catch((e) => {
+    console.error("✗ Could not connect to Chrome:", e.message);
+    console.error("  Make sure Chrome is running. Try: cashgrab browser");
+    process.exit(1);
+  });
+
+  const page = (await browser.pages()).at(-1) ?? await browser.newPage();
+
+  // Navigate to the balances page and let Bankwest redirect if the session is not logged in.
+  await page.goto(BALANCES_URL, { waitUntil: "domcontentloaded", timeout: 15000 });
+
+  const currentUrl = page.url();
+  if (!EXPECTED_URL_PATTERN.test(currentUrl)) {
+    console.error("✗ Not logged in. Expected Bankwest Account Balances page.");
+    console.error(`  Current URL: ${currentUrl}`);
+    console.error(`  Expected:    ${BALANCES_URL}`);
+    console.error("  Log in to Bankwest Online Banking first.");
+    await browser.disconnect();
+    process.exit(1);
+  }
+
+  // Extract Bankwest's page state from the balances view.
+  const data = await page.evaluate(() => {
+    if (typeof ContainerContext === "undefined" || !ContainerContext?.accountBalancesContext) {
+      throw new Error("ContainerContext not found - page may not have loaded correctly");
+    }
+    return {
+      customerName: ContainerContext.customerName,
+      asAt: ContainerContext.accountBalancesContext.AsAtDateTime,
+      balances: ContainerContext.accountBalancesContext.Balances,
+      netBalances: ContainerContext.accountBalancesContext.NetBalances,
+    };
+  });
+
+  await browser.disconnect();
+
+  const fmt = (n) =>
+    new Intl.NumberFormat("en-AU", { style: "currency", currency: "AUD" }).format(n);
+
+  const pad = (s, n) => String(s).padEnd(n);
+
+  console.log(`\nBankwest Account Balances - ${data.customerName}`);
+  console.log(`As at: ${data.asAt}\n`);
+
+  // Group accounts by Bankwest category before printing.
+  const groups = {};
+  for (const acct of data.balances) {
+    const cat = acct.AccountCategoryCode ?? "OTHER";
+    (groups[cat] ??= []).push(acct);
+  }
+
+  const categoryLabels = {
+    TRANSACCTS: "Transaction Accounts",
+    MORTGAGE: "Home Loans",
+    CREDITCARDS: "Credit Cards",
+    OTHER: "Other",
+  };
+
+  for (const [cat, accounts] of Object.entries(groups)) {
+    console.log(`${categoryLabels[cat] ?? cat}`);
+    console.log("─".repeat(72));
+    console.log(
+      `${pad("Nickname", 26)} ${pad("Account Number", 18)} ${pad("Current Balance", 18)} Available Balance`
+    );
+    console.log("─".repeat(72));
+
+    for (const account of accounts) {
+      const nickname = account.AccountNickName || account.AccountName;
+      console.log(
+        `${pad(nickname, 26)} ${pad(account.AccountNumber, 18)} ${pad(fmt(account.AccountCurrentBalance), 18)} ${fmt(account.AccountAvailableBalance)}`
+      );
+    }
+    console.log();
+  }
+
+  // Print the overall net balance summary shown by Bankwest.
+  console.log("─".repeat(72));
+  console.log("Summary");
+  console.log("─".repeat(72));
+  for (const net of data.netBalances) {
+    console.log(`${pad(net.title, 20)} ${fmt(net.value)}`);
+  }
+  console.log();
+}

package/src/bankwest-transactions.js

@@ -0,0 +1,203 @@
+/**
+ * Bankwest Transaction Export
+ *
+ * Connects to a running Chrome instance (CDP on localhost:9222),
+ * navigates to Bankwest transaction search, runs a search for the
+ * specified account and date range, then exports as MS Money (.qif).
+ *
+ * Prerequisites:
+ *   - Chrome running with --remote-debugging-port=9222
+ *   - Logged in to Bankwest Online Banking
+ */
+
+import puppeteer from "puppeteer-core";
+import { mkdtemp, readdir, rename } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+const SEARCH_URL =
+  "https://online.bankwest.com.au/CMWeb/AccountInformation/TS/TransactionSearch.aspx";
+const SEARCH_URL_PATTERN =
+  /online\.bankwest\.com\.au\/CMWeb\/AccountInformation\/TS\/TransactionSearch\.aspx/;
+const CHROME_DEBUG_URL = "http://localhost:9222";
+
+// Normalize CLI-provided options and enforce valid date-range combinations.
+export function normalizeTransactionOptions({
+  accountQuery,
+  range = "L30Days",
+  from = null,
+  to = null,
+  outputDir = process.cwd(),
+} = {}) {
+  const opts = { accountQuery, range, from, to, outputDir: outputDir ?? process.cwd() };
+
+  if (!opts.accountQuery) {
+    console.error("✗ Account name is required");
+    process.exit(1);
+  }
+
+  if (opts.to === "today") {
+    const d = new Date();
+    opts.to = `${String(d.getDate()).padStart(2, "0")}/${String(d.getMonth() + 1).padStart(2, "0")}/${d.getFullYear()}`;
+  }
+
+  if ((opts.from && !opts.to) || (opts.to && !opts.from)) {
+    console.error("✗ Both --from and --to are required for custom date range");
+    process.exit(1);
+  }
+
+  if (opts.from && opts.range !== "L30Days") {
+    console.error("✗ Cannot use --range with --from/--to");
+    process.exit(1);
+  }
+
+  if (opts.from) opts.range = "CUSTOM";
+
+  return opts;
+}
+
+export async function bankwestTransactions(options) {
+  const opts = normalizeTransactionOptions(options);
+
+  const browser = await Promise.race([
+    puppeteer.connect({
+      browserURL: CHROME_DEBUG_URL,
+      defaultViewport: null,
+    }),
+    new Promise((_, reject) =>
+      setTimeout(() => reject(new Error("Connection timeout after 5s")), 5000)
+    ),
+  ]).catch((e) => {
+    console.error("✗ Could not connect to Chrome:", e.message);
+    console.error("  Make sure Chrome is running. Try: cashgrab browser");
+    process.exit(1);
+  });
+
+  const page = (await browser.pages()).at(-1);
+
+  if (!page) {
+    console.error("✗ No active tab found");
+    await browser.disconnect();
+    process.exit(1);
+  }
+
+  // Navigate to transaction search page
+  await page.goto(SEARCH_URL, { waitUntil: "domcontentloaded", timeout: 15000 });
+
+  const currentUrl = page.url();
+  if (!SEARCH_URL_PATTERN.test(currentUrl)) {
+    console.error("✗ Not logged in. Expected transaction search page.");
+    console.error(`  Current URL: ${currentUrl}`);
+    console.error("  Log in to Bankwest Online Banking first.");
+    await browser.disconnect();
+    process.exit(1);
+  }
+
+  // Match the requested account against the Bankwest dropdown contents.
+  const account = await page.evaluate((query) => {
+    const select = document.getElementById("_ctl0_ContentMain_ddlAccount");
+    const options = Array.from(select.options).filter((o) => o.value !== "[All]");
+    const q = query.toLowerCase();
+    const matches = options.filter((o) => o.text.toLowerCase().includes(q));
+
+    if (matches.length === 0) {
+      return {
+        error: `No account matching "${query}"`,
+        available: options.map((o) => o.text),
+      };
+    }
+    if (matches.length > 1) {
+      return {
+        error: `Ambiguous match for "${query}"`,
+        available: matches.map((o) => o.text),
+      };
+    }
+
+    return { value: matches[0].value, text: matches[0].text };
+  }, opts.accountQuery);
+
+  if (account.error) {
+    console.error(`✗ ${account.error}`);
+    console.error("  Available accounts:");
+    for (const availableAccount of account.available) {
+      console.error(`    ${availableAccount}`);
+    }
+    await browser.disconnect();
+    process.exit(1);
+  }
+
+  const accountName = account.text.replace(/ - .*/, "");
+  console.error(`Account: ${account.text}`);
+
+  // Fill the search form and select MS Money export format.
+  await page.evaluate(
+    ({ accountValue, range, from, to }) => {
+      document.getElementById("_ctl0_ContentMain_ddlAccount").value =
+        accountValue;
+      const rangeSelect = document.getElementById(
+        "_ctl0_ContentMain_ddlRangeOptions"
+      );
+      rangeSelect.value = range;
+
+      if (range === "CUSTOM") {
+        rangeSelect.dispatchEvent(new Event("change", { bubbles: true }));
+        document.getElementById(
+          "_ctl0_ContentMain_dpFromDate_txtDate"
+        ).value = from;
+        document.getElementById("_ctl0_ContentMain_dpToDate_txtDate").value =
+          to;
+      }
+
+      // QIF export is exposed as "MSMoney" in Bankwest's UI.
+      document.getElementById("_ctl0_ContentButtonsLeft_ddlExportType").value =
+        "MSMoney";
+    },
+    { accountValue: account.value, range: opts.range, from: opts.from, to: opts.to }
+  );
+
+  console.error(`Range:   ${opts.range}${opts.from ? ` (${opts.from} - ${opts.to})` : ""}`);
+
+  // ── Export ──────────────────────────────────────────────────────────────────
+  const downloadDir = await mkdtemp(join(tmpdir(), "bankwest-"));
+
+  const cdp = await page.createCDPSession();
+  await cdp.send("Page.setDownloadBehavior", {
+    behavior: "allow",
+    downloadPath: downloadDir,
+  });
+
+  // The export button triggers an ASP.NET postback that returns the download.
+  await cdp.send("Runtime.evaluate", {
+    expression:
+      'setTimeout(() => document.getElementById("_ctl0_ContentButtonsLeft_btnExport").click(), 50)',
+  });
+
+  // Poll for the downloaded QIF file to appear in the temp directory.
+  let downloadedFile = null;
+  for (let i = 0; i < 30; i++) {
+    await new Promise((r) => setTimeout(r, 500));
+    const files = await readdir(downloadDir);
+    const qif = files.find((f) => f.endsWith(".qif"));
+    if (qif) {
+      downloadedFile = join(downloadDir, qif);
+      break;
+    }
+  }
+
+  if (!downloadedFile) {
+    console.error("✗ Export timed out - no .qif file received");
+    await browser.disconnect();
+    process.exit(1);
+  }
+
+  // Rename the downloaded file to include the matched account label.
+  const baseName = downloadedFile.split("/").pop().replace(".qif", "");
+  const suffix = accountName.replace(/\s+/g, "_");
+  const outputFile = join(opts.outputDir, `${baseName}_${suffix}.qif`);
+
+  await rename(downloadedFile, outputFile);
+
+  console.error(`✓ Exported: ${outputFile.split("/").pop()}`);
+
+  await browser.disconnect();
+}

package/src/browser-start.js

@@ -0,0 +1,83 @@
+import { spawn, execSync } from "node:child_process";
+import puppeteer from "puppeteer-core";
+
+const SCRAPING_DIR = `${process.env.HOME}/.cache/browser-tools`;
+const CHROME_DEBUG_URL = "http://localhost:9222";
+const CHROME_EXECUTABLE =
+	"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome";
+
+export async function startBrowser({ profile = false } = {}) {
+	// Check if already running on :9222
+	try {
+		const browser = await puppeteer.connect({
+			browserURL: CHROME_DEBUG_URL,
+			defaultViewport: null,
+		});
+		await browser.disconnect();
+		console.log("✓ Chrome already running on :9222");
+		return;
+	} catch {}
+
+	// Setup profile directory
+	execSync(`mkdir -p "${SCRAPING_DIR}"`, { stdio: "ignore" });
+
+	// Remove SingletonLock to allow new instance
+	try {
+		execSync(
+			`rm -f "${SCRAPING_DIR}/SingletonLock" "${SCRAPING_DIR}/SingletonSocket" "${SCRAPING_DIR}/SingletonCookie"`,
+			{ stdio: "ignore" },
+		);
+	} catch {}
+
+	if (profile) {
+		console.log("Syncing profile...");
+		execSync(
+			`rsync -a --delete \
+				--exclude='SingletonLock' \
+				--exclude='SingletonSocket' \
+				--exclude='SingletonCookie' \
+				--exclude='*/Sessions/*' \
+				--exclude='*/Current Session' \
+				--exclude='*/Current Tabs' \
+				--exclude='*/Last Session' \
+				--exclude='*/Last Tabs' \
+				"${process.env.HOME}/Library/Application Support/Google/Chrome/" "${SCRAPING_DIR}/"`,
+			{ stdio: "pipe" },
+		);
+	}
+
+	// Start Chrome with flags to force new instance
+	spawn(
+		CHROME_EXECUTABLE,
+		[
+			"--remote-debugging-port=9222",
+			`--user-data-dir=${SCRAPING_DIR}`,
+			"--no-first-run",
+			"--no-default-browser-check",
+		],
+		{ detached: true, stdio: "ignore" },
+	).unref();
+
+	// Wait for Chrome to be ready
+	let connected = false;
+	for (let i = 0; i < 30; i++) {
+		try {
+			const browser = await puppeteer.connect({
+				browserURL: CHROME_DEBUG_URL,
+				defaultViewport: null,
+			});
+			await browser.disconnect();
+			connected = true;
+			break;
+		} catch {
+			await new Promise((r) => setTimeout(r, 500));
+		}
+	}
+
+	if (!connected) {
+		console.error("✗ Failed to connect to Chrome");
+		process.exit(1);
+	}
+
+	console.log(`✓ Chrome started on :9222${profile ? " with your profile" : ""}`);
+}

package/src/cli.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import { startBrowser } from "./browser-start.js";
+import { bankwestBalances } from "./bankwest-balances.js";
+import {
+	bankwestTransactions,
+	normalizeTransactionOptions,
+} from "./bankwest-transactions.js";
+import { stGeorgeBalances } from "./stgeorge-balances.js";
+import {
+	normalizeStGeorgeTransactionOptions,
+	stGeorgeTransactions,
+} from "./stgeorge-transactions.js";
+
+const program = new Command();
+
+program
+	.name("cashgrab")
+	.description("Browser automation helpers for cashgrab")
+	.showHelpAfterError("(add --help for usage details)");
+
+program
+	.command("browser")
+	.description("Start Chrome with remote debugging on :9222")
+	.option("--profile", "Copy your default Chrome profile (cookies, logins)")
+	.action(async (options) => {
+		await startBrowser({ profile: options.profile });
+	});
+
+const bankwest = program
+	.command("bankwest")
+	.description("Bankwest scraping commands");
+
+bankwest
+	.command("balances")
+	.description("Print balances from the active Bankwest balances tab")
+	.action(async () => {
+		await bankwestBalances();
+	});
+
+bankwest
+	.command("transactions")
+	.description("Export transactions as a QIF file")
+	.argument(
+		"<accountName...>",
+		"Case-insensitive substring match against the Bankwest account dropdown",
+	)
+	.option(
+		"-r, --range <preset>",
+		"Date range preset: L7Days, L14Days, L30Days, L60Days, L90Days, LMONTH, SLMONTH, TLMONTH",
+		"L30Days",
+	)
+	.option("--from <date>", "Custom start date (DD/MM/YYYY), requires --to")
+	.option(
+		"--to <date>",
+		'Custom end date (DD/MM/YYYY or "today"), requires --from',
+	)
+	.option("-o, --output <dir>", "Output directory for the exported file")
+	.action(async (accountName, options) => {
+		await bankwestTransactions(
+			normalizeTransactionOptions({
+				accountQuery: accountName.join(" "),
+				range: options.range,
+				from: options.from,
+				to: options.to,
+				outputDir: options.output,
+			}),
+		);
+	});
+
+const stGeorge = program
+	.command("st-george")
+	.alias("stgeorge")
+	.description("St.George scraping commands");
+
+stGeorge
+	.command("balances")
+	.description("Print balances from the St.George account portfolio page")
+	.action(async () => {
+		await stGeorgeBalances();
+	});
+
+stGeorge
+	.command("transactions")
+	.description("Export transactions as a CSV file")
+	.argument(
+		"<accountName...>",
+		"Case-insensitive substring match against the St.George portfolio accounts",
+	)
+	.option(
+		"-r, --range <preset>",
+		"Date range preset: L7Days, L30Days",
+		"L30Days",
+	)
+	.option("--from <date>", "Custom start date (DD/MM/YYYY), requires --to")
+	.option(
+		"--to <date>",
+		'Custom end date (DD/MM/YYYY or "today"), requires --from',
+	)
+	.option("-o, --output <dir>", "Output directory for the exported file")
+	.action(async (accountName, options) => {
+		await stGeorgeTransactions(
+			normalizeStGeorgeTransactionOptions({
+				accountQuery: accountName.join(" "),
+				range: options.range,
+				from: options.from,
+				to: options.to,
+				outputDir: options.output,
+			}),
+		);
+	});
+
+await program.parseAsync(process.argv);

package/src/stgeorge-balances.js

@@ -0,0 +1,139 @@
+/**
+ * St.George Account Balances
+ *
+ * Connects to a running Chrome instance (CDP on localhost:9222),
+ * navigates to the St.George account portfolio page,
+ * then prints all visible accounts and their balances.
+ *
+ * Prerequisites:
+ *   - Chrome running with --remote-debugging-port=9222
+ *   - Logged in to St.George Internet Banking
+ */
+import puppeteer from "puppeteer-core";
+
+const BALANCES_URL =
+  "https://ibanking.stgeorge.com.au/ibank/viewAccountPortfolio.html";
+const CHROME_DEBUG_URL = "http://localhost:9222";
+
+function parseCurrency(value) {
+  if (typeof value !== "string") return null;
+  const normalized = value.replace(/[^0-9.-]/g, "");
+  if (!normalized || normalized === "-" || normalized === ".") return null;
+
+  const parsed = Number(normalized);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+
+function formatCurrency(value) {
+  if (typeof value !== "number" || Number.isNaN(value)) return "-";
+
+  return new Intl.NumberFormat("en-AU", {
+    style: "currency",
+    currency: "AUD",
+  }).format(value);
+}
+
+export async function stGeorgeBalances() {
+  const browser = await Promise.race([
+    puppeteer.connect({
+      browserURL: CHROME_DEBUG_URL,
+      defaultViewport: null,
+    }),
+    new Promise((_, reject) =>
+      setTimeout(() => reject(new Error("Connection timeout after 5s")), 5000)
+    ),
+  ]).catch((error) => {
+    console.error("✗ Could not connect to Chrome:", error.message);
+    console.error("  Make sure Chrome is running. Try: cashgrab browser");
+    process.exit(1);
+  });
+
+  const page = (await browser.pages()).at(-1) ?? (await browser.newPage());
+
+  await page.goto(BALANCES_URL, {
+    waitUntil: "domcontentloaded",
+    timeout: 15000,
+  });
+
+  await page
+    .waitForFunction(() => document.readyState === "complete", {
+      timeout: 5000,
+    })
+    .catch(() => {});
+
+  const data = await page.evaluate(() => {
+    const normalizeText = (value) => value?.replace(/\s+/g, " ").trim() ?? "";
+
+    const accounts = Array.from(
+      document.querySelectorAll("#acctSummaryList > li")
+    ).map((item) => {
+      const currentBalanceText =
+        item.querySelector("dl.balance-details dd")?.textContent ?? "";
+
+      return {
+        name: normalizeText(
+          item.querySelector("h2 a")?.textContent ?? item.dataset.acctalias ?? ""
+        ),
+        bsb: normalizeText(
+          item.querySelector("dt.bsb-number + dd")?.textContent ?? ""
+        ),
+        accountNumber: normalizeText(
+          item.querySelector("dt.account-number + dd")?.textContent ?? ""
+        ),
+        currentBalance:
+          typeof item.dataset.currbal === "string"
+            ? item.dataset.currbal
+            : normalizeText(currentBalanceText),
+        currentBalanceText: normalizeText(currentBalanceText),
+        availableBalance: normalizeText(
+          item.querySelector("dt.available-balance + dd")?.textContent ?? ""
+        ),
+      };
+    });
+
+    return {
+      currentUrl: location.href,
+      bodyText: normalizeText(document.body.innerText).slice(0, 500),
+      accounts,
+    };
+  });
+
+  await browser.disconnect();
+
+  if (data.accounts.length === 0) {
+    console.error(
+      "✗ Not logged in. Expected St.George account cards on the portfolio page."
+    );
+    console.error(`  Current URL: ${data.currentUrl}`);
+    console.error(`  Expected:    ${BALANCES_URL}`);
+    if (data.bodyText) {
+      console.error(`  Page says:    ${data.bodyText}`);
+    }
+    console.error("  Log in to St.George Internet Banking first.");
+    process.exit(1);
+  }
+
+  const accounts = data.accounts.map((account) => ({
+    ...account,
+    currentBalanceValue:
+      parseCurrency(account.currentBalance) ??
+      parseCurrency(account.currentBalanceText),
+    availableBalanceValue: parseCurrency(account.availableBalance),
+  }));
+
+  const pad = (value, width) => String(value ?? "-").padEnd(width);
+
+  console.log("\nSt.George Account Balances\n");
+  console.log(
+    `${pad("Nickname", 28)} ${pad("BSB", 10)} ${pad("Account Number", 18)} ${pad("Current Balance", 18)} Available Balance`
+  );
+  console.log("─".repeat(94));
+
+  for (const account of accounts) {
+    console.log(
+      `${pad(account.name || "-", 28)} ${pad(account.bsb || "-", 10)} ${pad(account.accountNumber || "-", 18)} ${pad(formatCurrency(account.currentBalanceValue), 18)} ${formatCurrency(account.availableBalanceValue)}`
+    );
+  }
+
+  console.log();
+}

package/src/stgeorge-transactions.js

@@ -0,0 +1,321 @@
+/**
+ * St.George Transaction Export
+ *
+ * Connects to a running Chrome instance (CDP on localhost:9222),
+ * navigates from the St.George account portfolio page to the matched
+ * account details page, then exports transactions as CSV.
+ *
+ * Prerequisites:
+ *   - Chrome running with --remote-debugging-port=9222
+ *   - Logged in to St.George Internet Banking
+ */
+
+import puppeteer from "puppeteer-core";
+import { mkdtemp, readdir, rename } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+const PORTFOLIO_URL =
+  "https://ibanking.stgeorge.com.au/ibank/viewAccountPortfolio.html";
+const CHROME_DEBUG_URL = "http://localhost:9222";
+
+const RANGE_TO_SELECTED_OPTION = {
+  L7Days: 0,
+  L30Days: 1,
+  CUSTOM: 2,
+};
+
+function slugify(value) {
+  return String(value)
+    .trim()
+    .replace(/\s+/g, "_")
+    .replace(/[^A-Za-z0-9_.-]/g, "");
+}
+
+function formatToday() {
+  const today = new Date();
+  return `${String(today.getDate()).padStart(2, "0")}/${String(
+    today.getMonth() + 1
+  ).padStart(2, "0")}/${today.getFullYear()}`;
+}
+
+export function normalizeStGeorgeTransactionOptions({
+  accountQuery,
+  range = "L30Days",
+  from = null,
+  to = null,
+  outputDir = process.cwd(),
+} = {}) {
+  const opts = {
+    accountQuery,
+    range,
+    from,
+    to,
+    outputDir: outputDir ?? process.cwd(),
+  };
+
+  if (!opts.accountQuery) {
+    console.error("✗ Account name is required");
+    process.exit(1);
+  }
+
+  if (opts.to === "today") {
+    opts.to = formatToday();
+  }
+
+  if ((opts.from && !opts.to) || (opts.to && !opts.from)) {
+    console.error("✗ Both --from and --to are required for custom date range");
+    process.exit(1);
+  }
+
+  if (opts.from && opts.range !== "L30Days") {
+    console.error("✗ Cannot use --range with --from/--to");
+    process.exit(1);
+  }
+
+  if (opts.from) {
+    opts.range = "CUSTOM";
+  }
+
+  if (!["L7Days", "L30Days", "CUSTOM"].includes(opts.range)) {
+    console.error(`✗ Unsupported St.George range "${opts.range}"`);
+    console.error("  Supported ranges: L7Days, L30Days, or --from/--to");
+    process.exit(1);
+  }
+
+  return opts;
+}
+
+export async function stGeorgeTransactions(options) {
+  const opts = normalizeStGeorgeTransactionOptions(options);
+
+  const browser = await Promise.race([
+    puppeteer.connect({
+      browserURL: CHROME_DEBUG_URL,
+      defaultViewport: null,
+    }),
+    new Promise((_, reject) =>
+      setTimeout(() => reject(new Error("Connection timeout after 5s")), 5000)
+    ),
+  ]).catch((error) => {
+    console.error("✗ Could not connect to Chrome:", error.message);
+    console.error("  Make sure Chrome is running. Try: cashgrab browser");
+    process.exit(1);
+  });
+
+  const page = (await browser.pages()).at(-1) ?? (await browser.newPage());
+
+  await page.goto(PORTFOLIO_URL, {
+    waitUntil: "domcontentloaded",
+    timeout: 15000,
+  });
+
+  await page
+    .waitForFunction(() => document.readyState === "complete", {
+      timeout: 5000,
+    })
+    .catch(() => {});
+
+  const account = await page.evaluate((query) => {
+    const normalizeText = (value) => value?.replace(/\s+/g, " ").trim() ?? "";
+    const items = Array.from(document.querySelectorAll("#acctSummaryList > li"));
+    const q = query.toLowerCase();
+
+    const accounts = items.map((item) => {
+      const name = normalizeText(
+        item.querySelector("h2 a")?.textContent ?? item.dataset.acctalias ?? ""
+      );
+      const bsb = normalizeText(
+        item.querySelector("dt.bsb-number + dd")?.textContent ?? ""
+      );
+      const accountNumber = normalizeText(
+        item.querySelector("dt.account-number + dd")?.textContent ?? ""
+      );
+      const href = item.querySelector("h2 a")?.getAttribute("href") ?? "";
+      const label = [name, accountNumber].filter(Boolean).join(" ");
+      const matchText = [name, accountNumber, bsb].join(" ").toLowerCase();
+      const indexMatch = href.match(/accountDetails\.action\?index=(\d+)/);
+
+      return {
+        index: indexMatch?.[1] ?? null,
+        name,
+        bsb,
+        accountNumber,
+        href,
+        label,
+        matchText,
+      };
+    });
+
+    if (accounts.length === 0) {
+      return {
+        error: "Not logged in. Expected St.George account cards on the portfolio page.",
+        currentUrl: location.href,
+        available: [],
+      };
+    }
+
+    const matches = accounts.filter((account) => account.matchText.includes(q));
+
+    if (matches.length === 0) {
+      return {
+        error: `No account matching "${query}"`,
+        currentUrl: location.href,
+        available: accounts.map((account) => account.label),
+      };
+    }
+
+    if (matches.length > 1) {
+      return {
+        error: `Ambiguous match for "${query}"`,
+        currentUrl: location.href,
+        available: matches.map((account) => account.label),
+      };
+    }
+
+    return {
+      currentUrl: location.href,
+      account: matches[0],
+    };
+  }, opts.accountQuery);
+
+  if (account.error) {
+    console.error(`✗ ${account.error}`);
+    if (account.currentUrl) {
+      console.error(`  Current URL: ${account.currentUrl}`);
+    }
+    if (account.available.length > 0) {
+      console.error("  Available accounts:");
+      for (const availableAccount of account.available) {
+        console.error(`    ${availableAccount}`);
+      }
+    }
+    await browser.disconnect();
+    process.exit(1);
+  }
+
+  if (!account.account?.index) {
+    console.error("✗ Could not determine St.George account index");
+    await browser.disconnect();
+    process.exit(1);
+  }
+
+  const accountUrl = new URL(
+    `accountDetails.action?index=${account.account.index}`,
+    PORTFOLIO_URL
+  ).toString();
+
+  await page.goto(accountUrl, {
+    waitUntil: "domcontentloaded",
+    timeout: 15000,
+  });
+
+  await page
+    .waitForFunction(() => document.readyState === "complete", {
+      timeout: 5000,
+    })
+    .catch(() => {});
+
+  const accountDetails = await page.evaluate((expectedIndex) => {
+    const info = document.querySelector("div.account-info");
+    return {
+      currentUrl: location.href,
+      pageIndex: info?.id ?? null,
+      visibleAccount: info?.innerText?.replace(/\s+/g, " ").trim() ?? "",
+      hasExportControl: !!document.getElementById("transHistExport"),
+      bodyText: document.body.innerText.replace(/\s+/g, " ").trim().slice(0, 500),
+      expectedIndex,
+    };
+  }, account.account.index);
+
+  if (
+    !accountDetails.hasExportControl ||
+    accountDetails.pageIndex !== String(accountDetails.expectedIndex)
+  ) {
+    console.error("✗ Could not load the St.George account details export page.");
+    console.error(`  Current URL: ${accountDetails.currentUrl}`);
+    if (accountDetails.bodyText) {
+      console.error(`  Page says:    ${accountDetails.bodyText}`);
+    }
+    await browser.disconnect();
+    process.exit(1);
+  }
+
+  const selectedOption = RANGE_TO_SELECTED_OPTION[opts.range];
+  const downloadUrl = await page.evaluate(
+    ({ index, selectedOption, from, to }) => {
+      const params = new URLSearchParams({
+        newPage: "1",
+        index: String(index),
+        exportFileFormat: "CSV",
+        exportDateFormat: "dd/MM/yyyy",
+        selectedOption: String(selectedOption),
+        dateFrom: from ?? "",
+        dateTo: to ?? "",
+        selectedAmountFrom: "",
+        selectedAmountTo: "",
+        selectedDrCrOption: "0",
+        includeCategories: "true",
+        includeSubCategories: "true",
+      });
+
+      return new URL(`exportTransactions.action?${params.toString()}`, location.href).toString();
+    },
+    {
+      index: account.account.index,
+      selectedOption,
+      from: opts.from,
+      to: opts.to,
+    }
+  );
+
+  console.error(`Account: ${account.account.label}`);
+  console.error(
+    `Range:   ${opts.range}${opts.from ? ` (${opts.from} - ${opts.to})` : ""}`
+  );
+
+  const downloadDir = await mkdtemp(join(tmpdir(), "stgeorge-"));
+
+  const cdp = await page.createCDPSession();
+  await cdp.send("Page.setDownloadBehavior", {
+    behavior: "allow",
+    downloadPath: downloadDir,
+  });
+
+  await cdp.send("Runtime.evaluate", {
+    expression: `setTimeout(() => { window.location.href = ${JSON.stringify(
+      downloadUrl
+    )}; }, 50)`,
+  });
+
+  let downloadedFile = null;
+  for (let i = 0; i < 40; i++) {
+    await new Promise((resolve) => setTimeout(resolve, 500));
+    const files = await readdir(downloadDir);
+    const csv = files.find(
+      (file) => file.endsWith(".csv") && !file.endsWith(".crdownload")
+    );
+    if (csv) {
+      downloadedFile = join(downloadDir, csv);
+      break;
+    }
+  }
+
+  if (!downloadedFile) {
+    console.error("✗ Export timed out - no .csv file received");
+    await browser.disconnect();
+    process.exit(1);
+  }
+
+  const baseName = downloadedFile.split("/").pop().replace(/\.csv$/i, "");
+  const suffix = `${slugify(account.account.name)}_${slugify(
+    account.account.accountNumber
+  )}`;
+  const outputFile = join(opts.outputDir, `${baseName}_${suffix}.csv`);
+
+  await rename(downloadedFile, outputFile);
+
+  console.error(`✓ Exported: ${outputFile.split("/").pop()}`);
+
+  await browser.disconnect();
+}