@pi-stef/finance-api 0.1.1

package/src/store/repo.ts

@@ -0,0 +1,68 @@
+import type Database from "better-sqlite3";
+
+export interface AccountRow { id: string; provider_id: string; kind: string; name: string; mask_last4?: string | null; currency?: string; }
+export interface HoldingRow { account_id: string; symbol: string; quantity: number; avg_cost?: number | null; asset_class: string; subclass?: string | null; as_of: number; }
+
+export function upsertAccount(db: Database.Database, a: AccountRow): void {
+  db.prepare(`INSERT INTO accounts (id,provider_id,kind,name,mask_last4,currency,stale_at,stale_reason)
+              VALUES (@id,@provider_id,@kind,@name,@mask_last4,@currency,NULL,NULL)
+              ON CONFLICT(id) DO UPDATE SET provider_id=@provider_id, kind=@kind, name=@name, mask_last4=@mask_last4, currency=@currency, stale_at=NULL, stale_reason=NULL`)
+    .run({ ...a, mask_last4: a.mask_last4 ?? null, currency: a.currency ?? "USD" });
+}
+
+export function markStale(db: Database.Database, id: string, staleAt: number, reason: string): void {
+  db.prepare("UPDATE accounts SET stale_at=?, stale_reason=? WHERE id=?").run(staleAt, reason, id);
+}
+
+export function upsertHolding(db: Database.Database, h: HoldingRow): void {
+  db.prepare(`INSERT INTO holdings (account_id,symbol,quantity,avg_cost,asset_class,subclass,as_of)
+              VALUES (@account_id,@symbol,@quantity,@avg_cost,@asset_class,@subclass,@as_of)
+              ON CONFLICT(account_id,symbol) DO UPDATE SET quantity=@quantity,avg_cost=@avg_cost,asset_class=@asset_class,subclass=@subclass,as_of=@as_of`)
+    .run({ ...h, avg_cost: h.avg_cost ?? null, subclass: h.subclass ?? null });
+}
+
+export function listHoldings(db: Database.Database, accountId: string): HoldingRow[] {
+  return db.prepare("SELECT * FROM holdings WHERE account_id=?").all(accountId) as HoldingRow[];
+}
+
+export function listAccounts(db: Database.Database): AccountRow[] {
+  return db.prepare("SELECT * FROM accounts").all() as AccountRow[];
+}
+
+export interface LotRow { id: string; holding_key: string; open_date: number; qty: number; cost_basis: number }
+
+export function upsertLot(db: Database.Database, lot: LotRow): void {
+  db.prepare(`INSERT INTO lots (id, holding_key, open_date, qty, cost_basis)
+              VALUES (@id, @holding_key, @open_date, @qty, @cost_basis)
+              ON CONFLICT(id) DO UPDATE SET qty=@qty, cost_basis=@cost_basis`)
+    .run(lot);
+}
+
+export interface SuggestionRow { id: string; created_at: number; market_session: string; kind: string; payload: string; status: string }
+
+export function insertSuggestion(db: Database.Database, s: SuggestionRow): void {
+  db.prepare(`INSERT INTO suggestion_records (id, created_at, market_session, kind, payload, status)
+              VALUES (@id, @created_at, @market_session, @kind, @payload, @status)`)
+    .run(s);
+}
+
+export function listPendingSuggestions(db: Database.Database): SuggestionRow[] {
+  return db.prepare("SELECT * FROM suggestion_records WHERE status='pending' ORDER BY created_at").all() as SuggestionRow[];
+}
+
+export function dismissSuggestion(db: Database.Database, id: string): void {
+  db.prepare("UPDATE suggestion_records SET status='dismissed' WHERE id=?").run(id);
+}
+
+export interface GoalRow { id: string; name: string; target_allocation: string; risk_limits: string; horizon_years?: number | null }
+
+export function upsertGoal(db: Database.Database, g: GoalRow): void {
+  db.prepare(`INSERT INTO goals (id, name, target_allocation, risk_limits, horizon_years)
+              VALUES (@id, @name, @target_allocation, @risk_limits, @horizon_years)
+              ON CONFLICT(id) DO UPDATE SET name=@name, target_allocation=@target_allocation, risk_limits=@risk_limits, horizon_years=@horizon_years`)
+    .run({ ...g, horizon_years: g.horizon_years ?? null });
+}
+
+export function listGoals(db: Database.Database): GoalRow[] {
+  return db.prepare("SELECT * FROM goals").all() as GoalRow[];
+}

package/src/store/schema.ts

@@ -0,0 +1,40 @@
+export interface Migration { version: number; statement: string }
+
+// v1 — initial schema. Future schema changes ADD new {version, statement} entries
+// (e.g. ALTER TABLE ...) rather than editing these. The runner (migrations.ts)
+// applies only migrations with version > current recorded version.
+export const MIGRATIONS_V1: Migration[] = [
+  { version: 1, statement:
+    `CREATE TABLE IF NOT EXISTS accounts (
+       id TEXT PRIMARY KEY, provider_id TEXT NOT NULL, kind TEXT NOT NULL,
+       name TEXT NOT NULL, mask_last4 TEXT, currency TEXT NOT NULL DEFAULT 'USD',
+       stale_at INTEGER, stale_reason TEXT)` },
+  { version: 2, statement:
+    `CREATE TABLE IF NOT EXISTS holdings (
+       account_id TEXT NOT NULL, symbol TEXT NOT NULL, quantity REAL NOT NULL,
+       avg_cost REAL, asset_class TEXT NOT NULL, subclass TEXT, as_of INTEGER NOT NULL,
+       PRIMARY KEY (account_id, symbol))` },
+  { version: 3, statement:
+    `CREATE TABLE IF NOT EXISTS transactions (
+       id TEXT PRIMARY KEY, account_id TEXT NOT NULL, date INTEGER NOT NULL,
+       symbol TEXT, qty REAL, price REAL, type TEXT, fees REAL DEFAULT 0)` },
+  { version: 4, statement:
+    `CREATE TABLE IF NOT EXISTS prices (
+       symbol TEXT NOT NULL, date INTEGER NOT NULL, close REAL NOT NULL, source TEXT NOT NULL,
+       PRIMARY KEY (symbol, date))` },
+  { version: 5, statement:
+    `CREATE TABLE IF NOT EXISTS lots (
+       id TEXT PRIMARY KEY, holding_key TEXT NOT NULL, open_date INTEGER NOT NULL,
+       qty REAL NOT NULL, cost_basis REAL NOT NULL)` },
+  { version: 6, statement:
+    `CREATE TABLE IF NOT EXISTS goals (
+       id TEXT PRIMARY KEY, name TEXT NOT NULL, target_allocation TEXT NOT NULL,
+       risk_limits TEXT NOT NULL, horizon_years INTEGER)` },
+  { version: 7, statement:
+    `CREATE TABLE IF NOT EXISTS suggestion_records (
+       id TEXT PRIMARY KEY, created_at INTEGER NOT NULL, market_session TEXT NOT NULL,
+       kind TEXT NOT NULL, payload TEXT NOT NULL, status TEXT NOT NULL DEFAULT 'pending')` },
+  { version: 8, statement:
+    `CREATE TABLE IF NOT EXISTS market_sessions (
+       date TEXT PRIMARY KEY, session TEXT NOT NULL, snapshot TEXT NOT NULL)` },
+];

package/src/store/symbols.ts

@@ -0,0 +1,11 @@
+export const CRYPTO_PREFIX = "CRYPTO:";
+
+export function canonicalSymbol(rawSymbol: string, assetClass: string): string {
+  const s = rawSymbol.trim().toUpperCase();
+  if (assetClass === "crypto") return `${CRYPTO_PREFIX}${s}`;
+  return s; // equities/etfs/mutual funds: plain uppercased ticker; CUSIP→ticker mapping added in M4
+}
+
+export function isCrypto(symbol: string): boolean {
+  return symbol.startsWith(CRYPTO_PREFIX);
+}