feat(statements+analytics): normalise statement_type; fix analytics scoping

Groundwork for importing bank and loan statements alongside credit cards.

statement_type was whatever free text Gemini put in account_type ('Credit Card',
'credit card', 'credit_card', 'Business Card', 'ACCESS ADVANTAGE',
'multi-currency account'). The UI coped only by doing .includes("card"), which
breaks as soon as bank and loan statements arrive.

- Migration 0013 adds normalize_statement_type() + a BEFORE INSERT/UPDATE
  trigger and a CHECK constraint over credit_card|transaction|savings|loan|
  offset|investment|other. The trigger means the N8N workflow keeps working
  unchanged while it still sends free text. Raw value stays in account_type.
  Backfilled 99 existing rows.
- src/lib/statement-types.ts mirrors the vocabulary for the UI; statements page
  now filters by the real types and headlines balance vs amount due per type.

Analytics were scoped with INNER JOIN statements + s.owner_id, which silently
dropped all 180 manual/CSV transactions (statement_id IS NULL) from every
report. Switched all six routes to LEFT JOIN + COALESCE(t.owner_id, s.owner_id)
via shared fragments in src/lib/analytics-sql.ts, so the transfers/investment
exclusion that stops card-payment double counting stays consistent. Also
extended that exclusion to trip analytics, which had none.

Drive-by: /api/analytics/subscriptions was returning 500 on an unserialisable
BigInt from COUNT(*) + 1.

Verified against the live DB: monthly spend picks up the previously invisible
manual transactions (Apr 9,849.91 -> 14,286.70) and all four analytics
endpoints return 200.

src/app/api/analytics/fees/route.ts

@@ -1,6 +1,7 @@
 import { NextRequest, NextResponse } from "next/server";
 import { getCurrentUser } from "@/lib/auth";
 import { queryRaw } from "@/lib/db";
+import { OWNER_SCOPE, STATEMENTS_JOIN } from "@/lib/analytics-sql";
 
 export async function GET(req: NextRequest) {
   const user = await getCurrentUser(req);
@@ -45,12 +46,12 @@ export async function GET(req: NextRequest) {
         WHEN o.my_share_percent IS NOT NULL THEN COALESCE(t.amount_aud, t.amount) * o.my_share_percent / 100
         ELSE COALESCE(t.amount_aud, t.amount)
       END::numeric(12,2) AS my_amount,
-      s.bank_name
+      COALESCE(s.bank_name, 'Manual') AS bank_name
     FROM transactions t
     LEFT JOIN transaction_overrides o ON o.transaction_id = t.id
     LEFT JOIN transaction_splits ts ON ts.transaction_id = t.id AND ts.participant_id = $1
-    JOIN statements s ON s.id = t.statement_id
-    WHERE s.owner_id = $1
+    ${STATEMENTS_JOIN}
+    WHERE ${OWNER_SCOPE} = $1
       AND t.transaction_type IN ('fee', 'interest')
     ORDER BY t.transaction_date DESC`,
     [user.id]

src/app/api/analytics/merchants/[merchant]/route.ts

@@ -1,6 +1,7 @@
 import { NextRequest, NextResponse } from "next/server";
 import { getCurrentUser } from "@/lib/auth";
 import { queryRaw } from "@/lib/db";
+import { OWNER_SCOPE, STATEMENTS_JOIN } from "@/lib/analytics-sql";
 
 export async function GET(
   req: NextRequest,
@@ -38,13 +39,13 @@ export async function GET(
       END::numeric(10,2) as my_amount,
       t.transaction_type,
       COALESCE(o.category_override, t.category) as category,
-      s.bank_name,
+      COALESCE(s.bank_name, 'Manual') as bank_name,
       t.statement_id
     FROM transactions t
-    JOIN statements s ON s.id = t.statement_id
+    ${STATEMENTS_JOIN}
     LEFT JOIN transaction_overrides o ON o.transaction_id = t.id
     LEFT JOIN transaction_splits ts ON ts.transaction_id = t.id AND ts.participant_id = $1
-    WHERE s.owner_id = $1
+    WHERE ${OWNER_SCOPE} = $1
       AND t.transaction_type IN ('debit', 'fee', 'interest', 'refund', 'credit')
       AND COALESCE(o.merchant_normalized, t.merchant_normalized, t.merchant_name, t.description) = $2
     ORDER BY t.transaction_date DESC

src/app/api/analytics/merchants/route.ts

@@ -1,6 +1,7 @@
 import { NextRequest, NextResponse } from "next/server";
 import { getCurrentUser } from "@/lib/auth";
 import { queryRaw } from "@/lib/db";
+import { OWNER_SCOPE, STATEMENTS_JOIN, EXCLUDE_NON_SPEND } from "@/lib/analytics-sql";
 
 // Split-adjusted amount helper (positive for spend, negative for refunds)
 const MY_AMOUNT = `CASE WHEN ts.share_percent IS NOT NULL THEN COALESCE(t.amount_aud, t.amount) * ts.share_percent / 100 WHEN o.my_share_percent IS NOT NULL THEN COALESCE(t.amount_aud, t.amount) * o.my_share_percent / 100 ELSE COALESCE(t.amount_aud, t.amount) END`;
@@ -61,13 +62,13 @@ export async function GET(req: NextRequest) {
       MAX(t.transaction_date)::text as last_seen,
       COUNT(DISTINCT TO_CHAR(DATE_TRUNC('month', t.transaction_date::date), 'YYYY-MM'))::int as months_active
     FROM transactions t
-    JOIN statements s ON s.id = t.statement_id
+    ${STATEMENTS_JOIN}
     LEFT JOIN transaction_overrides o ON o.transaction_id = t.id
     LEFT JOIN transaction_splits ts ON ts.transaction_id = t.id AND ts.participant_id = $1
-    WHERE s.owner_id = $1
+    WHERE ${OWNER_SCOPE} = $1
       AND t.transaction_type IN ('debit', 'fee', 'interest', 'refund', 'credit')
       AND t.transaction_date >= $2
-      AND COALESCE(o.category_override, t.category) NOT IN ('transfers', 'investment')
+      AND ${EXCLUDE_NON_SPEND}
     GROUP BY 1
     HAVING SUM(${SPEND_EXPR}) > 0
     ORDER BY net_spend DESC
@@ -86,14 +87,14 @@ export async function GET(req: NextRequest) {
         TO_CHAR(DATE_TRUNC('month', t.transaction_date::date), 'YYYY-MM') as month,
         SUM(${SPEND_EXPR})::numeric(10,2) as total
       FROM transactions t
-      JOIN statements s ON s.id = t.statement_id
+      ${STATEMENTS_JOIN}
       LEFT JOIN transaction_overrides o ON o.transaction_id = t.id
       LEFT JOIN transaction_splits ts ON ts.transaction_id = t.id AND ts.participant_id = $1
-      WHERE s.owner_id = $1
+      WHERE ${OWNER_SCOPE} = $1
         AND t.transaction_type IN ('debit', 'fee', 'interest', 'refund', 'credit')
         AND t.transaction_date >= $2
         AND COALESCE(o.merchant_normalized, t.merchant_normalized, t.merchant_name, t.description) = ANY($3)
-        AND COALESCE(o.category_override, t.category) NOT IN ('transfers', 'investment')
+        AND ${EXCLUDE_NON_SPEND}
       GROUP BY 1, 2
       ORDER BY 1, 2
     `, [user.id, fromDate, topMerchants]);

src/app/api/analytics/monthly/route.ts

@@ -1,6 +1,12 @@
 import { NextRequest, NextResponse } from "next/server";
 import { getCurrentUser } from "@/lib/auth";
 import { queryRaw } from "@/lib/db";
+import {
+  OWNER_SCOPE,
+  STATEMENTS_JOIN,
+  EFFECTIVE_CATEGORY,
+  EXCLUDE_NON_SPEND,
+} from "@/lib/analytics-sql";
 
 export async function GET(req: NextRequest) {
   const user = await getCurrentUser(req);
@@ -25,7 +31,7 @@ export async function GET(req: NextRequest) {
   }>(
     `SELECT
       TO_CHAR(DATE_TRUNC('month', t.transaction_date::date), 'YYYY-MM') as month,
-      COALESCE(o.category_override, t.category) as category,
+      ${EFFECTIVE_CATEGORY} as category,
       SUM(
         CASE
           WHEN ts.share_percent IS NOT NULL THEN COALESCE(t.amount_aud, t.amount) * ts.share_percent / 100
@@ -37,10 +43,10 @@ export async function GET(req: NextRequest) {
     FROM transactions t
     LEFT JOIN transaction_overrides o ON o.transaction_id = t.id
     LEFT JOIN transaction_splits ts ON ts.transaction_id = t.id AND ts.participant_id = $1
-    JOIN statements s ON s.id = t.statement_id
-    WHERE s.owner_id = $1
+    ${STATEMENTS_JOIN}
+    WHERE ${OWNER_SCOPE} = $1
       AND t.transaction_type IN ('debit', 'fee', 'interest')
-      AND COALESCE(o.category_override, t.category) NOT IN ('transfers', 'investment')
+      AND ${EXCLUDE_NON_SPEND}
       AND t.transaction_date >= $2
       AND t.transaction_date < $3
     GROUP BY 1, 2
@@ -60,10 +66,10 @@ export async function GET(req: NextRequest) {
       COUNT(*)::int as transaction_count
     FROM transactions t
     LEFT JOIN transaction_overrides o ON o.transaction_id = t.id
-    JOIN statements s ON s.id = t.statement_id
-    WHERE s.owner_id = $1
+    ${STATEMENTS_JOIN}
+    WHERE ${OWNER_SCOPE} = $1
       AND t.transaction_type IN ('credit', 'payment')
-      AND COALESCE(o.category_override, t.category) = 'income'
+      AND ${EFFECTIVE_CATEGORY} = 'income'
       AND t.transaction_date >= $2
       AND t.transaction_date < $3
     GROUP BY 1
@@ -83,9 +89,9 @@ export async function GET(req: NextRequest) {
       COUNT(*)::int as transaction_count
     FROM transactions t
     LEFT JOIN transaction_overrides o ON o.transaction_id = t.id
-    JOIN statements s ON s.id = t.statement_id
-    WHERE s.owner_id = $1
-      AND COALESCE(o.category_override, t.category) = 'investment'
+    ${STATEMENTS_JOIN}
+    WHERE ${OWNER_SCOPE} = $1
+      AND ${EFFECTIVE_CATEGORY} = 'investment'
       AND t.transaction_date >= $2
       AND t.transaction_date < $3
     GROUP BY 1

src/app/api/analytics/subscriptions/route.ts

@@ -1,6 +1,7 @@
 import { NextRequest, NextResponse } from "next/server";
 import { getCurrentUser } from "@/lib/auth";
 import { queryRaw } from "@/lib/db";
+import { OWNER_SCOPE, STATEMENTS_JOIN, EXCLUDE_NON_SPEND, EFFECTIVE_CATEGORY } from "@/lib/analytics-sql";
 
 export async function GET(req: NextRequest) {
   const user = await getCurrentUser(req);
@@ -20,7 +21,7 @@ export async function GET(req: NextRequest) {
     `WITH merchant_txns AS (
       SELECT
         COALESCE(o.merchant_normalized, t.merchant_normalized, t.merchant_name) AS merchant,
-        COALESCE(o.category_override, t.category) AS category,
+        ${EFFECTIVE_CATEGORY} AS category,
         t.transaction_date,
         CASE
           WHEN ts.share_percent IS NOT NULL THEN COALESCE(t.amount_aud, t.amount) * ts.share_percent / 100
@@ -30,9 +31,10 @@ export async function GET(req: NextRequest) {
       FROM transactions t
       LEFT JOIN transaction_overrides o ON o.transaction_id = t.id
       LEFT JOIN transaction_splits ts ON ts.transaction_id = t.id AND ts.participant_id = $1
-      JOIN statements s ON s.id = t.statement_id
-      WHERE s.owner_id = $1
+      ${STATEMENTS_JOIN}
+      WHERE ${OWNER_SCOPE} = $1
         AND t.transaction_type IN ('debit', 'fee')
+        AND ${EXCLUDE_NON_SPEND}
         AND COALESCE(o.merchant_normalized, t.merchant_normalized, t.merchant_name) IS NOT NULL
     ),
     merchant_with_lag AS (
@@ -48,7 +50,7 @@ export async function GET(req: NextRequest) {
       SELECT
         merchant,
         MODE() WITHIN GROUP (ORDER BY category) AS category,
-        COUNT(*) + 1 AS occurrences,
+        (COUNT(*) + 1)::int AS occurrences,
         AVG(my_amount)::numeric(12,2) AS avg_amount,
         MIN(transaction_date) AS first_seen,
         MAX(transaction_date) AS last_seen,