${escapeHtml(title)}

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_240":241,"_242":243},"routes/_app.x.$handle.$name",{"_97":96,"_31":42,"_105":87,"_26":99,"_13":14,"_106":-5,"_11":107,"_108":109,"_110":111,"_112":113,"_114":115,"_20":-5,"_116":-5,"_117":-5,"_118":24,"_119":120,"_121":56,"_122":-5,"_123":-5,"_124":125},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_40":41,"_31":42,"_35":43,"_44":-5,"_45":24,"_46":47,"_48":47,"_49":50,"_51":-5,"_18":52,"_53":54,"_55":56,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":68,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":80,"_81":82,"_83":84,"_85":24},"version",27,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":27},"file",{"_29":30,"_31":27,"_32":20,"_33":34,"_35":36,"_37":14,"_38":39,"_23":24},"previous","deleted",false,"deletedHere","path","AGENTS.md","latestPath","fileId","edd6670c-5cdc-11f1-b91f-1607ee4eb77e","name","fileType","content","# AGENTS.md\n\nGuidance for coding agents working on this Val Town project.\n\n## Project Shape\n\nThis is a forkable personal Val Town app for importing settled Akahu transactions into YNAB.\n\nCore files:\n\n- `main.ts`: HTTP dashboard, setup flow, account mapping, transaction review actions.\n- `sync.ts`: scheduled interval that syncs settled Akahu transactions into SQLite only.\n- `lib/db.ts`: SQLite schema, migrations, persistence helpers.\n- `lib/akahu.ts`: Akahu API client.\n- `lib/ynab.ts`: YNAB API client.\n- `lib/jobs.ts`: catalog refresh, Akahu sync, YNAB import orchestration.\n- `README.md`: user setup and remix instructions.\n\n## Product Rules\n\n- This is a personal, remixable app. Do not turn it into a multi-tenant service without an explicit redesign.\n- Akahu Personal Apps are for one user's own Akahu account. Keep the per-user fork model.\n- Use YNAB Personal Access Tokens for v1. Do not add YNAB OAuth unless the project becomes multi-user.\n- Sync jobs may fetch from Akahu into SQLite, but they must not write to YNAB.\n- YNAB writes must remain manual from the web UI.\n- Import settled Akahu transactions only. Pending transactions are out of scope for v1.\n- Do not auto-categorize transactions in YNAB.\n- Do not auto-detect transfers in v1.\n\n## Secret Handling\n\n- Keep Akahu and YNAB tokens in Val Town environment variables.\n- Do not store access tokens in SQLite.\n- Do not render token values into HTML, logs, errors, or README examples.\n- The dashboard may link to Val Town env var setup pages when env vars are missing.\n- Required env vars:\n - `ADMIN_USERNAMES`\n - `OAUTH_STATE_ENCRYPTION_KEY`\n - `AKAHU_USER_TOKEN`\n - `AKAHU_APP_TOKEN`\n - `YNAB_ACCESS_TOKEN`\n\n## Data Rules\n\n- Use `std/sqlite/main.ts` for the val-scoped database. Do not switch to `global.ts`.\n- Keep migrations idempotent with `CREATE TABLE IF NOT EXISTS` and safe additive changes.\n- Use parameterized SQL for all user-derived values.\n- Use Akahu settled transaction `_id` as the local source identity.\n- Generate stable YNAB `import_id` values from Akahu IDs and keep them under YNAB's 36-character limit.\n- Imported YNAB transactions should be cleared, unapproved, uncategorized, and include Akahu provenance in `memo`.\n\n## UI Rules\n\n- Keep the UI utilitarian and setup-focused.\n- The dashboard should help users resolve setup blockers directly.\n- Preserve Val Town login plus `ADMIN_USERNAMES` authorization.\n- Avoid adding marketing/landing-page content; this is an operational tool.\n- Keep forms simple and predictable.\n\n## Verification\n\nAfter meaningful changes:\n\n- Run `sync.ts` with `run_file`; it should safely skip when Akahu credentials are absent.\n- Fetch `main.ts`; unauthenticated requests should redirect to login.\n- If touching SQLite or jobs, run a small temporary smoke script and delete it afterward.\n- If touching API payloads, check current official docs before changing assumptions.\n\n## Current External API Assumptions\n\n- Akahu base URL: `https://api.akahu.io/v1`.\n- Akahu auth uses `Authorization: Bearer ` and `X-Akahu-Id: `.\n- Settled transactions come from `GET /transactions` with `start`, `end`, and `cursor` query params.\n- YNAB base URL: `https://api.ynab.com/v1`.\n- Current YNAB endpoints use `/plans`, not the old `/budgets` wording.\n- Create transactions with `POST /plans/{plan_id}/transactions` and a `{ transactions: [...] }` body.\n\n## Change Discipline\n\n- Keep edits scoped to the requested behavior.\n- Prefer small targeted edits over rewriting whole files.\n- Do not remove security checks to make local testing easier.\n- Do not commit or expose secrets.\n","createdAt",["D",1780223937793],"branchVersion","branchId","7dc9747e-5cda-11f1-83e7-1607ee4eb77e","id","7dc870d8-5cda-11f1-83e7-1607ee4eb77e","ynab-import",["D",1780222890810],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Forkable Akahu to YNAB importer with a review UI.","imageUrl","f0a197ec-9517-4b2a-bdcf-4f13ead4af98","pinnedFileId","7dcfb0e6-5cda-11f1-83e7-1607ee4eb77e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019e7d77-ed4e-710f-944e-eecb6671720e","tursoName","7dc870d85cda11f183e71607ee4eb77e","tursoHostname","7dc870d85cda11f183e71607ee4eb77e-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789556471789],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_97":96,"_104":99},"org",{"_97":96,"_98":99,"_100":99,"_18":52,"_101":102,"_103":24},"branch",{"_13":86,"_31":87,"_40":39,"_88":41,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":42,"_95":96},"isOwned",31,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","jonpdw","handle","displayName","","avatar","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_40":41,"_31":42,"_35":235,"_44":-5,"_45":24,"_46":47,"_48":47,"_49":50,"_51":-5,"_18":52,"_53":54,"_55":56,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":236,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":237,"_81":238,"_83":239,"_85":24},"tree",[178,183,184,185,186],"files",[178,179,180,181,182,183,184,185,186],"counts",{"_167":60,"_168":169,"_170":60,"_171":172,"_173":174},"contents",[126,127,128,129,130],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_40":160,"_31":161,"_29":162,"_134":-5,"_38":39,"_37":163,"_136":56,"_35":164,"_13":60,"_32":165,"_33":-5,"_23":24,"_140":-5,"_26":166},{"_40":157,"_31":27,"_29":30,"_134":-5,"_38":39,"_37":14,"_136":56,"_35":158,"_13":60,"_32":20,"_33":34,"_23":24,"_140":-5,"_26":159},{"_40":149,"_31":150,"_29":151,"_134":-5,"_38":39,"_37":152,"_136":24,"_35":153,"_13":154,"_32":20,"_33":155,"_23":24,"_140":-5,"_26":156},{"_40":142,"_31":143,"_29":54,"_134":-5,"_38":39,"_37":144,"_136":24,"_35":145,"_13":135,"_32":146,"_33":147,"_23":24,"_140":-5,"_26":148},{"_40":131,"_31":132,"_29":133,"_134":-5,"_38":39,"_37":135,"_136":56,"_35":137,"_13":60,"_32":138,"_33":139,"_23":24,"_140":-5,"_26":141},"f19b4a9e-5cda-11f1-84ef-1607ee4eb77e","sync.ts","f19b4b66-5cda-11f1-84ef-1607ee4eb77e","parentId",7,"latest",["D",1780223085121],"interval","import { runAkahuSync } from \"./lib/jobs.ts\";\nimport { hasAkahuCredentials } from \"./lib/akahu.ts\";\n\nexport default async function (_interval: Interval) {\n if (!hasAkahuCredentials()) {\n console.log(\"Skipping scheduled sync: missing Akahu credentials.\");\n return { skipped: true, reason: \"missing_akahu_credentials\" };\n }\n\n const result = await runAkahuSync({ triggerName: \"interval\", overlapDays: 7 });\n console.log(`Synced ${result.fetched} settled Akahu transactions into the review queue.`);\n return result;\n}\n","label",[132],"bb8b1d06-5cdc-11f1-a1cf-1607ee4eb77e","main.ts",26,["D",1780223853407],"http","import { Hono } from \"npm:hono\";\nimport { getOAuthUserData, oauthMiddleware } from \"https://esm.town/v/std/oauth/middleware.ts\";\nimport {\n getCounts,\n getSettings,\n listAkahuAccounts,\n listMappings,\n listRecentSyncRuns,\n listTransactions,\n listYnabAccounts,\n listYnabPlans,\n markTransactionsIgnored,\n migrate,\n normalizeStatus,\n resetFailedTransactions,\n saveAccountMappings,\n setSetting,\n} from \"./lib/db.ts\";\nimport { hasAkahuCredentials } from \"./lib/akahu.ts\";\nimport { hasYnabCredentials } from \"./lib/ynab.ts\";\nimport { importReadyTransactions, refreshCatalog, runAkahuSync } from \"./lib/jobs.ts\";\n\nconst app = new Hono();\n\napp.get(\"/\", async (c) => {\n const auth = await requireAdmin(c);\n if (auth.response) return auth.response;\n await migrate();\n return c.html(await renderDashboard(c, auth.username));\n});\n\napp.post(\"/actions/refresh-catalog\", async (c) => postAction(c, async () => {\n const result = await refreshCatalog();\n return `Refreshed ${result.akahuAccounts} Akahu accounts, ${result.ynabPlans} YNAB plans, and ${result.ynabAccounts} YNAB accounts.`;\n}));\n\napp.post(\"/actions/select-plan\", async (c) => postAction(c, async () => {\n const form = await c.req.formData();\n const planId = String(form.get(\"plan_id\") ?? \"\");\n if (!planId) throw new Error(\"Choose a YNAB plan first.\");\n const plans = await listYnabPlans();\n const plan = plans.find((candidate: any) => candidate.id === planId);\n await setSetting(\"ynab_plan_id\", planId);\n await setSetting(\"ynab_plan_name\", plan?.name ?? planId);\n const result = await refreshCatalog();\n return `Selected ${plan?.name ?? \"YNAB plan\"} and loaded ${result.ynabAccounts} accounts.`;\n}));\n\napp.post(\"/actions/save-backfill\", async (c) => postAction(c, async () => {\n const form = await c.req.formData();\n const days = Math.max(1, Math.min(365, Number(form.get(\"backfill_days\") ?? 30) || 30));\n await setSetting(\"backfill_days\", String(days));\n return `Backfill window set to ${days} days.`;\n}));\n\napp.post(\"/actions/save-mappings\", async (c) => postAction(c, async () => {\n const form = await c.req.formData();\n const mappings = [];\n for (const [key, value] of form.entries()) {\n if (!key.startsWith(\"mapping:\")) continue;\n const akahuAccountId = key.slice(\"mapping:\".length);\n const selected = String(value ?? \"\");\n mappings.push({\n akahu_account_id: akahuAccountId,\n ynab_account_id: selected && selected !== \"ignore\" ? selected : null,\n ignored: selected === \"ignore\",\n });\n }\n await saveAccountMappings(mappings);\n return `Saved ${mappings.length} account mappings.`;\n}));\n\napp.post(\"/actions/sync-transactions\", async (c) => postAction(c, async () => {\n const form = await c.req.formData();\n const forceBackfill = form.get(\"force_backfill\") === \"1\";\n const settings = await getSettings();\n const result = await runAkahuSync({\n triggerName: forceBackfill ? \"manual_backfill\" : \"manual\",\n forceBackfill,\n backfillDays: Number(settings.backfill_days) || 30,\n overlapDays: 7,\n });\n return `Synced ${result.fetched} settled transactions from Akahu.`;\n}));\n\napp.post(\"/actions/import\", async (c) => postAction(c, async () => {\n const form = await c.req.formData();\n const ids = form.getAll(\"transaction_id\").map(String);\n const result = await importReadyTransactions(ids);\n return `Imported ${result.imported} transactions. ${result.failed} failed. ${result.duplicates} were already in YNAB.`;\n}));\n\napp.post(\"/actions/ignore\", async (c) => postAction(c, async () => {\n const form = await c.req.formData();\n const ids = form.getAll(\"transaction_id\").map(String);\n const count = await markTransactionsIgnored(ids);\n return `Ignored ${count} transactions.`;\n}));\n\napp.post(\"/actions/retry\", async (c) => postAction(c, async () => {\n const form = await c.req.formData();\n const ids = form.getAll(\"transaction_id\").map(String);\n const count = await resetFailedTransactions(ids);\n return `Moved ${count} failed transactions back to ready.`;\n}));\n\napp.onError((error, c) => {\n console.error(error);\n return c.html(renderShell({\n title: \"YNAB Importer\",\n body: `

Something went wrong

${escapeHtml(error.message)}

Return to dashboard

`,\n }), 500);\n});\n\nasync function postAction(c: any, handler: () => Promise) {\n const auth = await requireAdmin(c);\n if (auth.response) return auth.response;\n assertSameOrigin(c);\n await migrate();\n try {\n const notice = await handler();\n return redirectWithNotice(c, notice, \"ok\");\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n return redirectWithNotice(c, message, \"error\");\n }\n}\n\nasync function requireAdmin(c: any): Promise<{ username: string; response?: Response }> {\n const session = await getOAuthUserData(c.req.raw);\n if (!session?.user) return { username: \"\", response: c.redirect(\"/auth/login\") };\n\n const username = session.user.username;\n const allowed = adminUsernames();\n if (!allowed.length || !allowed.includes(username)) {\n return {\n username,\n response: c.html(renderShell({\n title: \"YNAB Importer\",\n body: `

Access denied

Logged in as ${escapeHtml(username)}, but this Val only allows usernames listed in ADMIN_USERNAMES.

`,\n }), 403),\n };\n }\n\n return { username };\n}\n\nfunction assertSameOrigin(c: any) {\n const origin = c.req.header(\"origin\");\n if (origin && origin !== new URL(c.req.url).origin) {\n throw new Error(\"Cross-origin form submissions are not accepted.\");\n }\n}\n\nfunction redirectWithNotice(c: any, notice: string, type: \"ok\" | \"error\") {\n const params = new URLSearchParams({ notice, type });\n return c.redirect(`/?${params.toString()}`, 303);\n}\n\nasync function renderDashboard(c: any, username: string) {\n const url = new URL(c.req.url);\n const status = normalizeStatus(url.searchParams.get(\"status\"));\n const notice = url.searchParams.get(\"notice\");\n const noticeType = url.searchParams.get(\"type\") === \"error\" ? \"error\" : \"ok\";\n const settings = await getSettings();\n const counts = await getCounts();\n const plans = await listYnabPlans();\n const ynabAccounts = await listYnabAccounts();\n const akahuAccounts = await listAkahuAccounts();\n const mappings = await listMappings();\n const transactions = await listTransactions(status, 100);\n const syncRuns = await listRecentSyncRuns(5);\n\n const mappingByAkahu = new Map(mappings.map((mapping: any) => [mapping.akahu_account_id, mapping]));\n const transactionAccounts = akahuAccounts.filter((account: any) => Number(account.has_transactions));\n const mappedCount = transactionAccounts.filter((account: any) => {\n const mapping: any = mappingByAkahu.get(account.id);\n return mapping?.ignored || mapping?.ynab_account_id;\n }).length;\n\n const body = `\n ${notice ? `

${escapeHtml(notice)}

` : \"\"}\n \n\n ${renderSetup({ settings, plans, akahuAccounts, ynabAccounts, mappedCount, transactionAccounts })}\n ${renderActions(settings)}\n ${renderMappings({ akahuAccounts, ynabAccounts, mappingByAkahu })}\n ${renderTransactions({ transactions, counts, status })}\n ${renderSyncRuns(syncRuns)}\n `;\n\n return renderShell({ title: \"YNAB Importer\", body });\n}\n\nfunction renderSetup(data: any) {\n const env = {\n admin: adminUsernames().length > 0,\n akahuUserToken: Deno.env.has(\"AKAHU_USER_TOKEN\"),\n akahuAppToken: Deno.env.has(\"AKAHU_APP_TOKEN\"),\n ynabAccessToken: Deno.env.has(\"YNAB_ACCESS_TOKEN\"),\n akahu: hasAkahuCredentials(),\n ynab: hasYnabCredentials(),\n };\n const selectedPlanId = data.settings.ynab_plan_id ?? \"\";\n const selectedPlanName = data.settings.ynab_plan_name ?? \"\";\n const initialSyncDone = Boolean(data.settings.last_successful_akahu_sync_at);\n const checks = [\n [\"Admin allowlist\", env.admin],\n [\"Akahu tokens\", env.akahu],\n [\"YNAB token\", env.ynab],\n [\"YNAB plan selected\", Boolean(selectedPlanId)],\n [\"Accounts loaded\", data.akahuAccounts.length > 0 && data.ynabAccounts.length > 0],\n [\"Mappings complete\", data.transactionAccounts.length > 0 && data.mappedCount === data.transactionAccounts.length],\n [\"Initial sync run\", initialSyncDone],\n ];\n const missingEnvVars = [\n [\"AKAHU_USER_TOKEN\", \"Akahu user token\", env.akahuUserToken],\n [\"AKAHU_APP_TOKEN\", \"Akahu app token\", env.akahuAppToken],\n [\"YNAB_ACCESS_TOKEN\", \"YNAB token\", env.ynabAccessToken],\n ].filter(([, , present]) => !present);\n\n return `

Setup

${checks.filter(([, ok]) => ok).length}/${checks.length}

\n ${checks.map(([label, ok]) => `

${ok ? \"OK\" : \"Todo\"}${escapeHtml(label)}

`).join(\"\")}\n

\n \n \n \n

`;\n}\n\nfunction renderActions(settings: Record) {\n return `

\n \n \n

Last sync: ${settings.last_successful_akahu_sync_at ? escapeHtml(formatDateTime(settings.last_successful_akahu_sync_at)) : \"Never\"}

`;\n}\n\nfunction renderMappings(data: any) {\n if (!data.akahuAccounts.length) {\n return `

Account Mapping

Refresh accounts after adding credentials.

`;\n }\n\n return `

Account Mapping

${data.akahuAccounts.length} Akahu accounts

\n \n

`;\n}\n\nfunction renderTransactions(data: any) {\n const statusLinks = [\"ready\", \"needs_mapping\", \"failed\", \"imported\", \"ignored\", \"all\"];\n return `

Transactions

${data.transactions.length} shown

\n \n

\n \n \n \n

\n \n \n \n ${data.transactions.length ? data.transactions.map(renderTransactionRow).join(\"\") : ``}\n \n

	Date	Account	Payee	Amount	Status
No transactions in this view.

`;\n}\n\nfunction renderTransactionRow(tx: any) {\n const canSelect = tx.status !== \"imported\";\n const payee = tx.merchant_name || tx.description;\n return `\n ${canSelect ? `` : \"\"}\n ${escapeHtml(String(tx.date).slice(0, 10))}\n ${escapeHtml(tx.akahu_account_name ?? tx.akahu_account_id)}${escapeHtml(tx.ynab_account_name ?? \"No YNAB mapping\")}\n ${escapeHtml(payee)}${escapeHtml(tx.description)}${tx.error ? `${escapeHtml(tx.error)}` : \"\"}\n ${formatAmount(Number(tx.amount))}\n ${labelForStatus(tx.status)}\n `;\n}\n\nfunction renderSyncRuns(runs: any[]) {\n return `

Sync Runs

${runs.length}

\n ${runs.length ? `

${runs.map((run) => `

${escapeHtml(run.trigger_name)}${escapeHtml(formatDateTime(run.started_at))}${Number(run.ok) ? `${run.fetched_count} fetched` : escapeHtml(run.message ?? \"Failed\")}

`).join(\"\")}

` : `

No sync runs yet.

`}\n

`;\n}\n\nfunction renderShell({ title, body }: { title: string; body: string }) {\n return `\n\n\n \n \n ${escapeHtml(title)}\n \n\n\n

${body}

\n \n\n`;\n}\n\nfunction adminUsernames() {\n if (!Deno.env.has(\"ADMIN_USERNAMES\")) return [];\n return (Deno.env.get(\"ADMIN_USERNAMES\") ?? \"\")\n .split(\",\")\n .map((value) => value.trim())\n .filter(Boolean);\n}\n\nfunction valTownEnvUrl(key: string) {\n const ref = currentValRef();\n const encodedKey = encodeURIComponent(key);\n if (!ref) return `https://www.val.town/settings/environment-variables?key=${encodedKey}`;\n return `https://www.val.town/x/${encodeURIComponent(ref.handle)}/${encodeURIComponent(ref.valName)}/environment-variables?key=${encodedKey}`;\n}\n\nfunction currentValRef() {\n const match = import.meta.url.match(/\\/v\\/([^/]+)\\/([^/?#]+)/);\n if (!match) return null;\n return { handle: decodeURIComponent(match[1]), valName: decodeURIComponent(match[2]) };\n}\n\nfunction labelForStatus(status: string) {\n const labels: Record = {\n all: \"All\",\n needs_mapping: \"Needs mapping\",\n ready: \"Ready\",\n imported: \"Imported\",\n ignored: \"Ignored\",\n failed: \"Failed\",\n };\n return labels[status] ?? status;\n}\n\nfunction formatAmount(amount: number) {\n return new Intl.NumberFormat(\"en-NZ\", { style: \"currency\", currency: \"NZD\" }).format(amount);\n}\n\nfunction formatDateTime(value: string) {\n if (!value) return \"\";\n return new Intl.DateTimeFormat(\"en-NZ\", { dateStyle: \"medium\", timeStyle: \"short\" }).format(new Date(value));\n}\n\nfunction escapeHtml(value: unknown) {\n return String(value ?? \"\")\n .replaceAll(\"&\", \"&\")\n .replaceAll(\"<\", \"<\")\n .replaceAll(\">\", \">\")\n .replaceAll('\"', \""\")\n .replaceAll(\"'\", \"'\");\n}\n\nfunction escapeAttr(value: unknown) {\n return escapeHtml(value);\n}\n\nexport default oauthMiddleware(app.fetch);\n",[143],"3d557cec-5cdc-11f1-b468-1607ee4eb77e","README.md","3cd655da-5cdb-11f1-b305-1607ee4eb77e",19,["D",1780223641660],3,"# Akahu to YNAB Importer\n\nA forkable Val Town app that imports settled Akahu transactions into a local SQLite review queue, then lets you manually import selected transactions into YNAB.\n\n## What v1 does\n\n- Uses Akahu Personal App tokens, so each fork is for one person's own Akahu account.\n- Uses a YNAB Personal Access Token.\n- Stores state in the val-scoped Val Town SQLite database.\n- Protects the dashboard with Val Town login plus `ADMIN_USERNAMES`.\n- Syncs settled Akahu transactions only. Pending transactions are intentionally out of scope.\n- Lets scheduled syncs fetch from Akahu into SQLite only. YNAB writes happen only from the web UI.\n- Imports YNAB transactions as cleared, unapproved, uncategorized transactions with a stable `import_id`.\n\n## Required env vars\n\nSet these on your fork. For `OAUTH_STATE_ENCRYPTION_KEY`, use any long random string; it is not shared with Akahu or YNAB.\n\n- `ADMIN_USERNAMES`: comma-separated Val Town usernames allowed to open the dashboard.\n- `OAUTH_STATE_ENCRYPTION_KEY`: random secret used by Val Town OAuth session state.\n- `AKAHU_USER_TOKEN`: your Akahu User Access Token.\n- `AKAHU_APP_TOKEN`: your Akahu App ID Token.\n- `YNAB_ACCESS_TOKEN`: your YNAB Personal Access Token.\n\nFor this val:\n\n👉 Add ADMIN_USERNAMES here: https://www.val.town/x/jonpdw/ynab-import/environment-variables?key=ADMIN_USERNAMES\n\n👉 Add OAUTH_STATE_ENCRYPTION_KEY here: https://www.val.town/x/jonpdw/ynab-import/environment-variables?key=OAUTH_STATE_ENCRYPTION_KEY\n\n👉 Add AKAHU_USER_TOKEN here: https://www.val.town/x/jonpdw/ynab-import/environment-variables?key=AKAHU_USER_TOKEN\n\n👉 Add AKAHU_APP_TOKEN here: https://www.val.town/x/jonpdw/ynab-import/environment-variables?key=AKAHU_APP_TOKEN\n\n👉 Add YNAB_ACCESS_TOKEN here: https://www.val.town/x/jonpdw/ynab-import/environment-variables?key=YNAB_ACCESS_TOKEN\n\n## Getting credentials\n\nAkahu:\n\n1. Sign in at https://my.akahu.nz/.\n2. Go to Developers.\n3. Create or open your Personal App.\n4. Copy the User Access Token and App ID Token into Val Town env vars.\n\nYNAB:\n\n1. Sign in to https://app.ynab.com/.\n2. Go to Account Settings, then Developer Settings.\n3. Create a Personal Access Token.\n4. Copy it into `YNAB_ACCESS_TOKEN`.\n\n## First run\n\n1. Open the dashboard.\n2. Log in with Val Town.\n3. Click Refresh accounts.\n4. Select one YNAB plan.\n5. Map each Akahu account to a YNAB account or choose Ignore this account.\n6. Pick a backfill window. The default is 30 days.\n7. Run backfill.\n8. Review ready transactions and click Import selected.\n\n## Scheduled sync\n\nThe `sync.ts` interval runs daily at `0 18 * * *` UTC. It only fetches settled Akahu transactions into SQLite. It does not write to YNAB.\n\nAfter the first successful sync, future syncs use the last successful sync timestamp with a 7-day overlap so late changes can be seen again.\n\n## Forking notes\n\nWhen someone remixes or forks the val, they should set their own env vars and keep their own val-scoped SQLite database. Do not share personal access tokens with other users.\n\nAkahu Personal Apps are free but limited to your own Akahu account and do not support webhooks. YNAB Personal Access Tokens are intended for individual usage. A multi-user hosted version would need Akahu OAuth and YNAB OAuth instead.\n",[150],"edd66658-5cdc-11f1-b91f-1607ee4eb77e",["D",1780223937793],[27],"a6213a4c-5cda-11f1-85d8-1607ee4eb77e","lib","a6213ae2-5cda-11f1-85d8-1607ee4eb77e",2,["D",1780222958493],"directory",[161],"pulls","branches",1,"forks","envVars",{"_175":163,"_177":60},"connections",{"_175":60,"_176":60},"count","unfilledCount","emptyCount",{"_40":160,"_31":161,"_29":162,"_134":-5,"_38":39,"_37":163,"_136":56,"_35":232,"_13":60,"_32":165,"_33":-5,"_23":24,"_140":-5,"_188":233,"_26":234},{"_40":224,"_31":225,"_29":226,"_134":162,"_38":39,"_37":227,"_136":56,"_35":228,"_13":169,"_32":205,"_33":229,"_23":24,"_140":-5,"_188":230,"_26":231},{"_40":217,"_31":218,"_29":219,"_134":162,"_38":39,"_37":154,"_136":56,"_35":220,"_13":60,"_32":205,"_33":221,"_23":24,"_140":-5,"_188":222,"_26":223},{"_40":209,"_31":210,"_29":211,"_134":162,"_38":39,"_37":212,"_136":56,"_35":213,"_13":60,"_32":205,"_33":214,"_23":24,"_140":-5,"_188":215,"_26":216},{"_40":200,"_31":201,"_29":202,"_134":162,"_38":39,"_37":203,"_136":56,"_35":204,"_13":169,"_32":205,"_33":206,"_23":24,"_140":-5,"_188":207,"_26":208},{"_40":157,"_31":27,"_29":30,"_134":-5,"_38":39,"_37":14,"_136":56,"_35":197,"_13":60,"_32":20,"_33":34,"_23":24,"_140":-5,"_188":198,"_26":199},{"_40":149,"_31":150,"_29":151,"_134":-5,"_38":39,"_37":152,"_136":24,"_35":194,"_13":154,"_32":20,"_33":155,"_23":24,"_140":-5,"_188":195,"_26":196},{"_40":142,"_31":143,"_29":54,"_134":-5,"_38":39,"_37":144,"_136":24,"_35":191,"_13":135,"_32":146,"_33":147,"_23":24,"_140":-5,"_188":192,"_26":193},{"_40":131,"_31":132,"_29":133,"_134":-5,"_38":39,"_37":135,"_136":56,"_35":187,"_13":60,"_32":138,"_33":139,"_23":24,"_140":-5,"_188":189,"_26":190},["D",1780223085121],"children",[],[132],["D",1780223853407],[],[143],["D",1780223641660],[],[150],["D",1780223937793],[],[27],"3491840c-5cdc-11f1-891f-1607ee4eb77e","ynab.ts","d611a78c-5cda-11f1-b61e-1607ee4eb77e",15,["D",1780223626956],"script","const YNAB_BASE_URL = \"https://api.ynab.com/v1\";\n\nexport class YnabError extends Error {\n status: number;\n body: unknown;\n\n constructor(status: number, message: string, body: unknown) {\n super(message);\n this.name = \"YnabError\";\n this.status = status;\n this.body = body;\n }\n}\n\nexport function hasYnabCredentials() {\n return Deno.env.has(\"YNAB_ACCESS_TOKEN\");\n}\n\nfunction token() {\n const accessToken = Deno.env.get(\"YNAB_ACCESS_TOKEN\");\n if (!accessToken) throw new Error(\"Missing YNAB_ACCESS_TOKEN.\");\n return accessToken;\n}\n\nasync function ynabFetch(path: string, init: RequestInit = {}) {\n const response = await fetch(`${YNAB_BASE_URL}${path}`, {\n ...init,\n headers: {\n Authorization: `Bearer ${token()}`,\n Accept: \"application/json\",\n ...(init.body ? { \"Content-Type\": \"application/json\" } : {}),\n ...(init.headers ?? {}),\n },\n });\n\n const text = await response.text();\n let body: any = null;\n try {\n body = text ? JSON.parse(text) : null;\n } catch {\n body = text;\n }\n\n if (!response.ok) {\n const detail = body?.error?.detail ?? body?.error?.name ?? text ?? response.statusText;\n throw new YnabError(response.status, `YNAB ${response.status}: ${detail}`, body);\n }\n\n return body;\n}\n\nexport async function listPlans() {\n const body = await ynabFetch(\"/plans?include_accounts=true\");\n return body.data?.plans ?? [];\n}\n\nexport async function listPlanAccounts(planId: string) {\n const body = await ynabFetch(`/plans/${encodeURIComponent(planId)}/accounts`);\n return body.data?.accounts ?? [];\n}\n\nexport async function createTransactions(planId: string, transactions: any[]) {\n return await ynabFetch(`/plans/${encodeURIComponent(planId)}/transactions`, {\n method: \"POST\",\n body: JSON.stringify({ transactions }),\n });\n}\n",[],[161,201],"eee2408c-5cda-11f1-89fb-1607ee4eb77e","jobs.ts","eee2414a-5cda-11f1-89fb-1607ee4eb77e",6,["D",1780223080556],"import {\n getImportableTransactions,\n getSetting,\n markTransactionFailed,\n markTransactionImported,\n migrate,\n recordSyncRun,\n setSetting,\n upsertAkahuAccounts,\n upsertAkahuTransactions,\n upsertYnabAccounts,\n upsertYnabPlans,\n type NormalizedAkahuTransaction,\n} from \"./db.ts\";\nimport { hasAkahuCredentials, listAkahuAccounts, listSettledTransactions } from \"./akahu.ts\";\nimport { createTransactions, hasYnabCredentials, listPlanAccounts, listPlans, YnabError } from \"./ynab.ts\";\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\nexport type CatalogRefreshResult = {\n akahuAccounts: number;\n ynabPlans: number;\n ynabAccounts: number;\n selectedPlanId: string | null;\n};\n\nexport type SyncResult = {\n fetched: number;\n stored: number;\n startIso: string;\n endIso: string;\n};\n\nexport type ImportResult = {\n requested: number;\n imported: number;\n failed: number;\n duplicates: number;\n};\n\nexport async function refreshCatalog(): Promise {\n await migrate();\n let akahuAccounts = 0;\n let ynabPlans = 0;\n let ynabAccounts = 0;\n let selectedPlanId = await getSetting(\"ynab_plan_id\");\n\n if (hasAkahuCredentials()) {\n const accounts = await listAkahuAccounts();\n akahuAccounts = await upsertAkahuAccounts(accounts);\n }\n\n if (hasYnabCredentials()) {\n const plans = await listPlans();\n ynabPlans = await upsertYnabPlans(plans);\n\n if (!selectedPlanId && plans.length === 1) {\n selectedPlanId = plans[0].id;\n await setSetting(\"ynab_plan_id\", plans[0].id);\n await setSetting(\"ynab_plan_name\", plans[0].name ?? \"Unnamed plan\");\n }\n\n if (selectedPlanId) {\n const accounts = await listPlanAccounts(selectedPlanId);\n ynabAccounts = await upsertYnabAccounts(accounts);\n }\n }\n\n await setSetting(\"last_catalog_refresh_at\", new Date().toISOString());\n return { akahuAccounts, ynabPlans, ynabAccounts, selectedPlanId };\n}\n\nexport async function runAkahuSync(options: {\n triggerName: string;\n forceBackfill?: boolean;\n backfillDays?: number;\n overlapDays?: number;\n}): Promise {\n await migrate();\n const startedAt = new Date().toISOString();\n const endDate = new Date();\n const endIso = endDate.toISOString();\n const overlapDays = options.overlapDays ?? 7;\n const configuredBackfillDays = Number(await getSetting(\"backfill_days\")) || 30;\n const backfillDays = options.backfillDays ?? configuredBackfillDays;\n const lastSyncAt = await getSetting(\"last_successful_akahu_sync_at\");\n\n let startDate: Date;\n if (options.forceBackfill || !lastSyncAt) {\n startDate = new Date(endDate.getTime() - backfillDays * DAY_MS);\n } else {\n startDate = new Date(Date.parse(lastSyncAt) - overlapDays * DAY_MS);\n }\n const startIso = startDate.toISOString();\n\n try {\n const accounts = await listAkahuAccounts();\n await upsertAkahuAccounts(accounts);\n\n const rawTransactions = await listSettledTransactions(startIso, endIso);\n const normalized = await Promise.all(rawTransactions.map(normalizeAkahuTransaction));\n const stored = await upsertAkahuTransactions(normalized);\n\n await setSetting(\"last_successful_akahu_sync_at\", endIso);\n await recordSyncRun({\n trigger_name: options.triggerName,\n started_at: startedAt,\n finished_at: new Date().toISOString(),\n ok: true,\n message: null,\n fetched_count: rawTransactions.length,\n stored_count: stored,\n start_iso: startIso,\n end_iso: endIso,\n });\n\n return { fetched: rawTransactions.length, stored, startIso, endIso };\n } catch (error) {\n await recordSyncRun({\n trigger_name: options.triggerName,\n started_at: startedAt,\n finished_at: new Date().toISOString(),\n ok: false,\n message: error instanceof Error ? error.message : String(error),\n fetched_count: 0,\n stored_count: 0,\n start_iso: startIso,\n end_iso: endIso,\n });\n throw error;\n }\n}\n\nexport async function importReadyTransactions(ids: string[]): Promise {\n await migrate();\n const uniqueIds = [...new Set(ids)].filter(Boolean);\n const planId = await getSetting(\"ynab_plan_id\");\n if (!planId) throw new Error(\"Select a YNAB plan before importing.\");\n\n const rows = await getImportableTransactions(uniqueIds);\n const result: ImportResult = { requested: uniqueIds.length, imported: 0, failed: 0, duplicates: 0 };\n if (!rows.length) return result;\n\n if (rows.length === 1) {\n await importOne(planId, rows[0], result);\n return result;\n }\n\n try {\n const response = await createTransactions(planId, rows.map(toYnabTransaction));\n await applyYnabImportResponse(rows, response, result);\n } catch (error) {\n for (const row of rows) {\n await importOne(planId, row, result);\n }\n }\n\n return result;\n}\n\nasync function importOne(planId: string, row: any, result: ImportResult) {\n try {\n const response = await createTransactions(planId, [toYnabTransaction(row)]);\n await applyYnabImportResponse([row], response, result);\n } catch (error) {\n if (error instanceof YnabError && error.status === 409) {\n await markTransactionImported(row.akahu_id, null, \"Duplicate import_id already existed in YNAB.\");\n result.imported += 1;\n result.duplicates += 1;\n return;\n }\n const message = error instanceof Error ? error.message : String(error);\n await markTransactionFailed(row.akahu_id, message);\n result.failed += 1;\n }\n}\n\nasync function applyYnabImportResponse(rows: any[], response: any, result: ImportResult) {\n const saved = response?.data?.transactions ?? (response?.data?.transaction ? [response.data.transaction] : []);\n const duplicateImportIds = new Set(response?.data?.duplicate_import_ids ?? []);\n const savedByImportId = new Map();\n for (const transaction of saved) {\n if (transaction.import_id) savedByImportId.set(transaction.import_id, transaction);\n }\n\n for (const row of rows) {\n const savedTransaction = savedByImportId.get(row.import_id);\n if (savedTransaction) {\n await markTransactionImported(row.akahu_id, savedTransaction.id, null);\n result.imported += 1;\n } else if (duplicateImportIds.has(row.import_id)) {\n await markTransactionImported(row.akahu_id, null, \"Duplicate import_id already existed in YNAB.\");\n result.imported += 1;\n result.duplicates += 1;\n } else {\n await markTransactionFailed(row.akahu_id, \"YNAB did not return this transaction in the import response.\");\n result.failed += 1;\n }\n }\n}\n\nasync function normalizeAkahuTransaction(tx: any): Promise {\n return {\n akahu_id: tx._id,\n akahu_account_id: tx._account,\n date: tx.date,\n description: tx.description ?? \"\",\n amount: Number(tx.amount),\n type: tx.type ?? null,\n merchant_name: tx.merchant?.name ?? null,\n raw_json: JSON.stringify(tx),\n import_id: await ynabImportId(tx._id),\n };\n}\n\nasync function ynabImportId(akahuId: string) {\n const bytes = new TextEncoder().encode(akahuId);\n const digest = await crypto.subtle.digest(\"SHA-256\", bytes);\n const hex = [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, \"0\")).join(\"\");\n return `AKAHU:${hex.slice(0, 28)}`;\n}\n\nfunction toYnabTransaction(row: any) {\n return {\n account_id: row.mapped_ynab_account_id,\n date: String(row.date).slice(0, 10),\n amount: Math.round(Number(row.amount) * 1000),\n payee_name: cleanText(row.merchant_name || row.description || \"Unknown payee\", 200),\n memo: cleanText(`Akahu: ${row.akahu_id} | ${row.description ?? \"\"}`, 500),\n cleared: \"cleared\",\n approved: false,\n import_id: row.import_id,\n };\n}\n\nfunction cleanText(value: string, maxLength: number) {\n return value.replace(/\\s+/g, \" \").trim().slice(0, maxLength) || null;\n}\n",[],[161,210],"c8296132-5cda-11f1-b894-1607ee4eb77e","db.ts","c8296222-5cda-11f1-b894-1607ee4eb77e",["D",1780223015588],"import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nexport type TransactionStatus = \"needs_mapping\" | \"ready\" | \"imported\" | \"ignored\" | \"failed\";\n\nexport type NormalizedAkahuTransaction = {\n akahu_id: string;\n akahu_account_id: string;\n date: string;\n description: string;\n amount: number;\n type: string | null;\n merchant_name: string | null;\n raw_json: string;\n import_id: string;\n};\n\nexport type AccountMappingInput = {\n akahu_account_id: string;\n ynab_account_id: string | null;\n ignored: boolean;\n};\n\nconst STATUSES = new Set([\"needs_mapping\", \"ready\", \"imported\", \"ignored\", \"failed\"]);\n\nfunction nowIso() {\n return new Date().toISOString();\n}\n\nexport function normalizeStatus(value: string | null): TransactionStatus | \"all\" {\n if (value === \"all\") return \"all\";\n if (value && STATUSES.has(value)) return value as TransactionStatus;\n return \"ready\";\n}\n\nexport async function migrate() {\n await sqlite.batch([\n `CREATE TABLE IF NOT EXISTS settings (\n key TEXT PRIMARY KEY,\n value TEXT NOT NULL,\n updated_at TEXT NOT NULL\n )`,\n `CREATE TABLE IF NOT EXISTS ynab_plans (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n last_modified_on TEXT,\n raw_json TEXT NOT NULL,\n updated_at TEXT NOT NULL\n )`,\n `CREATE TABLE IF NOT EXISTS ynab_accounts (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n type TEXT,\n closed INTEGER NOT NULL DEFAULT 0,\n on_budget INTEGER NOT NULL DEFAULT 0,\n transfer_payee_id TEXT,\n raw_json TEXT NOT NULL,\n updated_at TEXT NOT NULL\n )`,\n `CREATE TABLE IF NOT EXISTS akahu_accounts (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n type TEXT,\n status TEXT,\n connection_id TEXT,\n connection_name TEXT,\n formatted_account TEXT,\n has_transactions INTEGER NOT NULL DEFAULT 0,\n attributes_json TEXT NOT NULL,\n raw_json TEXT NOT NULL,\n updated_at TEXT NOT NULL\n )`,\n `CREATE TABLE IF NOT EXISTS account_mappings (\n akahu_account_id TEXT PRIMARY KEY,\n ynab_account_id TEXT,\n ignored INTEGER NOT NULL DEFAULT 0,\n updated_at TEXT NOT NULL\n )`,\n `CREATE TABLE IF NOT EXISTS akahu_transactions (\n akahu_id TEXT PRIMARY KEY,\n akahu_account_id TEXT NOT NULL,\n date TEXT NOT NULL,\n description TEXT NOT NULL,\n amount REAL NOT NULL,\n type TEXT,\n merchant_name TEXT,\n import_id TEXT NOT NULL UNIQUE,\n status TEXT NOT NULL,\n ynab_account_id TEXT,\n ynab_transaction_id TEXT,\n error TEXT,\n raw_json TEXT NOT NULL,\n first_seen_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n imported_at TEXT\n )`,\n `CREATE TABLE IF NOT EXISTS sync_runs (\n id TEXT PRIMARY KEY,\n trigger_name TEXT NOT NULL,\n started_at TEXT NOT NULL,\n finished_at TEXT NOT NULL,\n ok INTEGER NOT NULL,\n message TEXT,\n fetched_count INTEGER NOT NULL DEFAULT 0,\n stored_count INTEGER NOT NULL DEFAULT 0,\n start_iso TEXT,\n end_iso TEXT\n )`,\n `CREATE INDEX IF NOT EXISTS idx_akahu_transactions_status ON akahu_transactions(status)`,\n `CREATE INDEX IF NOT EXISTS idx_akahu_transactions_date ON akahu_transactions(date)`,\n `CREATE INDEX IF NOT EXISTS idx_akahu_transactions_account ON akahu_transactions(akahu_account_id)`,\n `CREATE INDEX IF NOT EXISTS idx_sync_runs_started ON sync_runs(started_at)`\n ]);\n}\n\nexport async function getSettings(): Promise> {\n const result = await sqlite.execute(\"SELECT key, value FROM settings\");\n return Object.fromEntries((result.rows as any[]).map((row) => [row.key, row.value]));\n}\n\nexport async function getSetting(key: string): Promise {\n const result = await sqlite.execute({ sql: \"SELECT value FROM settings WHERE key = ?\", args: [key] });\n return ((result.rows as any[])[0]?.value as string | undefined) ?? null;\n}\n\nexport async function setSetting(key: string, value: string) {\n await sqlite.execute({\n sql: `INSERT INTO settings (key, value, updated_at)\n VALUES (?, ?, ?)\n ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at`,\n args: [key, value, nowIso()],\n });\n}\n\nexport async function upsertYnabPlans(plans: any[]) {\n if (!plans.length) return 0;\n const updatedAt = nowIso();\n await sqlite.batch(plans.map((plan) => ({\n sql: `INSERT INTO ynab_plans (id, name, last_modified_on, raw_json, updated_at)\n VALUES (?, ?, ?, ?, ?)\n ON CONFLICT(id) DO UPDATE SET\n name = excluded.name,\n last_modified_on = excluded.last_modified_on,\n raw_json = excluded.raw_json,\n updated_at = excluded.updated_at`,\n args: [plan.id, plan.name ?? \"Unnamed plan\", plan.last_modified_on ?? null, JSON.stringify(plan), updatedAt],\n })));\n return plans.length;\n}\n\nexport async function upsertYnabAccounts(accounts: any[]) {\n if (!accounts.length) return 0;\n const updatedAt = nowIso();\n await sqlite.batch(accounts.map((account) => ({\n sql: `INSERT INTO ynab_accounts (id, name, type, closed, on_budget, transfer_payee_id, raw_json, updated_at)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?)\n ON CONFLICT(id) DO UPDATE SET\n name = excluded.name,\n type = excluded.type,\n closed = excluded.closed,\n on_budget = excluded.on_budget,\n transfer_payee_id = excluded.transfer_payee_id,\n raw_json = excluded.raw_json,\n updated_at = excluded.updated_at`,\n args: [\n account.id,\n account.name ?? \"Unnamed account\",\n account.type ?? null,\n account.closed ? 1 : 0,\n account.on_budget ? 1 : 0,\n account.transfer_payee_id ?? null,\n JSON.stringify(account),\n updatedAt,\n ],\n })));\n return accounts.length;\n}\n\nexport async function upsertAkahuAccounts(accounts: any[]) {\n if (!accounts.length) return 0;\n const updatedAt = nowIso();\n await sqlite.batch(accounts.map((account) => {\n const attributes = Array.isArray(account.attributes) ? account.attributes : [];\n return {\n sql: `INSERT INTO akahu_accounts (\n id, name, type, status, connection_id, connection_name, formatted_account,\n has_transactions, attributes_json, raw_json, updated_at\n ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n ON CONFLICT(id) DO UPDATE SET\n name = excluded.name,\n type = excluded.type,\n status = excluded.status,\n connection_id = excluded.connection_id,\n connection_name = excluded.connection_name,\n formatted_account = excluded.formatted_account,\n has_transactions = excluded.has_transactions,\n attributes_json = excluded.attributes_json,\n raw_json = excluded.raw_json,\n updated_at = excluded.updated_at`,\n args: [\n account._id,\n account.name ?? \"Unnamed Akahu account\",\n account.type ?? null,\n account.status ?? null,\n account.connection?._id ?? account._connection ?? null,\n account.connection?.name ?? null,\n account.formatted_account ?? null,\n attributes.includes(\"TRANSACTIONS\") ? 1 : 0,\n JSON.stringify(attributes),\n JSON.stringify(account),\n updatedAt,\n ],\n };\n }));\n return accounts.length;\n}\n\nexport async function listYnabPlans() {\n const result = await sqlite.execute(\"SELECT * FROM ynab_plans ORDER BY name COLLATE NOCASE\");\n return result.rows as any[];\n}\n\nexport async function listYnabAccounts() {\n const result = await sqlite.execute(\n \"SELECT * FROM ynab_accounts WHERE closed = 0 ORDER BY on_budget DESC, name COLLATE NOCASE\",\n );\n return result.rows as any[];\n}\n\nexport async function listAkahuAccounts() {\n const result = await sqlite.execute(\n \"SELECT * FROM akahu_accounts ORDER BY has_transactions DESC, connection_name COLLATE NOCASE, name COLLATE NOCASE\",\n );\n return result.rows as any[];\n}\n\nexport async function listMappings() {\n const result = await sqlite.execute(\"SELECT * FROM account_mappings\");\n return result.rows as any[];\n}\n\nexport async function saveAccountMappings(mappings: AccountMappingInput[]) {\n const updatedAt = nowIso();\n const statements: any[] = [];\n for (const mapping of mappings) {\n if (mapping.ignored) {\n statements.push({\n sql: `INSERT INTO account_mappings (akahu_account_id, ynab_account_id, ignored, updated_at)\n VALUES (?, NULL, 1, ?)\n ON CONFLICT(akahu_account_id) DO UPDATE SET\n ynab_account_id = NULL, ignored = 1, updated_at = excluded.updated_at`,\n args: [mapping.akahu_account_id, updatedAt],\n });\n statements.push({\n sql: `UPDATE akahu_transactions\n SET status = 'ignored', ynab_account_id = NULL, error = NULL, updated_at = ?\n WHERE akahu_account_id = ? AND status != 'imported'`,\n args: [updatedAt, mapping.akahu_account_id],\n });\n } else if (mapping.ynab_account_id) {\n statements.push({\n sql: `INSERT INTO account_mappings (akahu_account_id, ynab_account_id, ignored, updated_at)\n VALUES (?, ?, 0, ?)\n ON CONFLICT(akahu_account_id) DO UPDATE SET\n ynab_account_id = excluded.ynab_account_id, ignored = 0, updated_at = excluded.updated_at`,\n args: [mapping.akahu_account_id, mapping.ynab_account_id, updatedAt],\n });\n statements.push({\n sql: `UPDATE akahu_transactions\n SET status = 'ready', ynab_account_id = ?, error = NULL, updated_at = ?\n WHERE akahu_account_id = ? AND status IN ('needs_mapping', 'ignored', 'failed')`,\n args: [mapping.ynab_account_id, updatedAt, mapping.akahu_account_id],\n });\n } else {\n statements.push({ sql: \"DELETE FROM account_mappings WHERE akahu_account_id = ?\", args: [mapping.akahu_account_id] });\n statements.push({\n sql: `UPDATE akahu_transactions\n SET status = 'needs_mapping', ynab_account_id = NULL, error = NULL, updated_at = ?\n WHERE akahu_account_id = ? AND status IN ('ready', 'ignored', 'failed')`,\n args: [updatedAt, mapping.akahu_account_id],\n });\n }\n }\n if (statements.length) await sqlite.batch(statements);\n}\n\nexport async function upsertAkahuTransactions(transactions: NormalizedAkahuTransaction[]) {\n if (!transactions.length) return 0;\n const mappings = await listMappings();\n const mappingByAccount = new Map(mappings.map((mapping: any) => [mapping.akahu_account_id, mapping]));\n const updatedAt = nowIso();\n await sqlite.batch(transactions.map((tx) => {\n const mapping: any = mappingByAccount.get(tx.akahu_account_id);\n const status = mapping?.ignored ? \"ignored\" : mapping?.ynab_account_id ? \"ready\" : \"needs_mapping\";\n const ynabAccountId = mapping?.ignored ? null : mapping?.ynab_account_id ?? null;\n return {\n sql: `INSERT INTO akahu_transactions (\n akahu_id, akahu_account_id, date, description, amount, type, merchant_name,\n import_id, status, ynab_account_id, raw_json, first_seen_at, updated_at\n ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n ON CONFLICT(akahu_id) DO UPDATE SET\n akahu_account_id = excluded.akahu_account_id,\n date = excluded.date,\n description = excluded.description,\n amount = excluded.amount,\n type = excluded.type,\n merchant_name = excluded.merchant_name,\n import_id = excluded.import_id,\n status = CASE\n WHEN akahu_transactions.status IN ('imported', 'ignored', 'failed') THEN akahu_transactions.status\n ELSE excluded.status\n END,\n ynab_account_id = CASE\n WHEN akahu_transactions.status = 'imported' THEN akahu_transactions.ynab_account_id\n ELSE excluded.ynab_account_id\n END,\n raw_json = excluded.raw_json,\n updated_at = excluded.updated_at`,\n args: [\n tx.akahu_id,\n tx.akahu_account_id,\n tx.date,\n tx.description,\n tx.amount,\n tx.type,\n tx.merchant_name,\n tx.import_id,\n status,\n ynabAccountId,\n tx.raw_json,\n updatedAt,\n updatedAt,\n ],\n };\n }));\n return transactions.length;\n}\n\nexport async function getCounts() {\n const result = await sqlite.execute(\"SELECT status, COUNT(*) AS count FROM akahu_transactions GROUP BY status\");\n const counts: Record = { needs_mapping: 0, ready: 0, imported: 0, ignored: 0, failed: 0 };\n for (const row of result.rows as any[]) counts[row.status] = Number(row.count);\n return counts;\n}\n\nexport async function listTransactions(status: TransactionStatus | \"all\", limit = 100) {\n const where = status === \"all\" ? \"\" : \"WHERE t.status = ?\";\n const args: any[] = status === \"all\" ? [limit] : [status, limit];\n const result = await sqlite.execute({\n sql: `SELECT\n t.*,\n aa.name AS akahu_account_name,\n aa.connection_name AS akahu_connection_name,\n ya.name AS ynab_account_name\n FROM akahu_transactions t\n LEFT JOIN akahu_accounts aa ON aa.id = t.akahu_account_id\n LEFT JOIN account_mappings m ON m.akahu_account_id = t.akahu_account_id\n LEFT JOIN ynab_accounts ya ON ya.id = COALESCE(t.ynab_account_id, m.ynab_account_id)\n ${where}\n ORDER BY t.date DESC, t.updated_at DESC\n LIMIT ?`,\n args,\n });\n return result.rows as any[];\n}\n\nexport async function getImportableTransactions(ids: string[]) {\n if (!ids.length) return [];\n const placeholders = ids.map(() => \"?\").join(\", \");\n const result = await sqlite.execute({\n sql: `SELECT\n t.*,\n COALESCE(t.ynab_account_id, m.ynab_account_id) AS mapped_ynab_account_id\n FROM akahu_transactions t\n JOIN account_mappings m ON m.akahu_account_id = t.akahu_account_id AND m.ignored = 0\n WHERE t.status = 'ready'\n AND m.ynab_account_id IS NOT NULL\n AND t.akahu_id IN (${placeholders})\n ORDER BY t.date ASC`,\n args: ids,\n });\n return result.rows as any[];\n}\n\nexport async function markTransactionsIgnored(ids: string[]) {\n if (!ids.length) return 0;\n const placeholders = ids.map(() => \"?\").join(\", \");\n await sqlite.execute({\n sql: `UPDATE akahu_transactions\n SET status = 'ignored', error = NULL, updated_at = ?\n WHERE akahu_id IN (${placeholders}) AND status != 'imported'`,\n args: [nowIso(), ...ids],\n });\n return ids.length;\n}\n\nexport async function resetFailedTransactions(ids: string[]) {\n if (!ids.length) return 0;\n const placeholders = ids.map(() => \"?\").join(\", \");\n await sqlite.execute({\n sql: `UPDATE akahu_transactions\n SET status = 'ready', error = NULL, updated_at = ?\n WHERE akahu_id IN (${placeholders}) AND status = 'failed'`,\n args: [nowIso(), ...ids],\n });\n return ids.length;\n}\n\nexport async function markTransactionImported(akahuId: string, ynabTransactionId: string | null, message: string | null = null) {\n const timestamp = nowIso();\n await sqlite.execute({\n sql: `UPDATE akahu_transactions\n SET status = 'imported', ynab_transaction_id = COALESCE(?, ynab_transaction_id), error = ?, imported_at = ?, updated_at = ?\n WHERE akahu_id = ?`,\n args: [ynabTransactionId, message, timestamp, timestamp, akahuId],\n });\n}\n\nexport async function markTransactionFailed(akahuId: string, error: string) {\n await sqlite.execute({\n sql: `UPDATE akahu_transactions SET status = 'failed', error = ?, updated_at = ? WHERE akahu_id = ?`,\n args: [error.slice(0, 1000), nowIso(), akahuId],\n });\n}\n\nexport async function recordSyncRun(run: {\n trigger_name: string;\n started_at: string;\n finished_at: string;\n ok: boolean;\n message: string | null;\n fetched_count: number;\n stored_count: number;\n start_iso: string | null;\n end_iso: string | null;\n}) {\n await sqlite.execute({\n sql: `INSERT INTO sync_runs (\n id, trigger_name, started_at, finished_at, ok, message, fetched_count, stored_count, start_iso, end_iso\n ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n args: [\n crypto.randomUUID(),\n run.trigger_name,\n run.started_at,\n run.finished_at,\n run.ok ? 1 : 0,\n run.message,\n run.fetched_count,\n run.stored_count,\n run.start_iso,\n run.end_iso,\n ],\n });\n}\n\nexport async function listRecentSyncRuns(limit = 5) {\n const result = await sqlite.execute({\n sql: \"SELECT * FROM sync_runs ORDER BY started_at DESC LIMIT ?\",\n args: [limit],\n });\n return result.rows as any[];\n}\n",[],[161,218],"345d80da-5cdc-11f1-81f3-1607ee4eb77e","akahu.ts","cf05209a-5cda-11f1-916e-1607ee4eb77e",14,["D",1780223626608],"const AKAHU_BASE_URL = \"https://api.akahu.io/v1\";\n\nexport class AkahuError extends Error {\n status: number;\n body: unknown;\n\n constructor(status: number, message: string, body: unknown) {\n super(message);\n this.name = \"AkahuError\";\n this.status = status;\n this.body = body;\n }\n}\n\nexport function hasAkahuCredentials() {\n return Deno.env.has(\"AKAHU_USER_TOKEN\") && Deno.env.has(\"AKAHU_APP_TOKEN\");\n}\n\nfunction credentials() {\n const userToken = Deno.env.get(\"AKAHU_USER_TOKEN\");\n const appToken = Deno.env.get(\"AKAHU_APP_TOKEN\");\n if (!userToken || !appToken) {\n throw new Error(\"Missing AKAHU_USER_TOKEN or AKAHU_APP_TOKEN.\");\n }\n return { userToken, appToken };\n}\n\nasync function akahuFetch(path: string, query: Record = {}) {\n const { userToken, appToken } = credentials();\n const url = new URL(`${AKAHU_BASE_URL}${path}`);\n for (const [key, value] of Object.entries(query)) {\n if (value) url.searchParams.set(key, value);\n }\n\n const response = await fetch(url, {\n headers: {\n Authorization: `Bearer ${userToken}`,\n \"X-Akahu-Id\": appToken,\n Accept: \"application/json\",\n },\n });\n\n const text = await response.text();\n let body: any = null;\n try {\n body = text ? JSON.parse(text) : null;\n } catch {\n body = text;\n }\n\n if (!response.ok || body?.success === false) {\n const detail = body?.message ?? body?.error_description ?? body?.error ?? text ?? response.statusText;\n throw new AkahuError(response.status, `Akahu ${response.status}: ${detail}`, body);\n }\n\n return body;\n}\n\nexport async function getAkahuMe() {\n return await akahuFetch(\"/me\");\n}\n\nexport async function listAkahuAccounts() {\n const body = await akahuFetch(\"/accounts\");\n return body.items ?? [];\n}\n\nexport async function listSettledTransactions(startIso: string, endIso: string) {\n const transactions: any[] = [];\n let cursor: string | null | undefined = undefined;\n\n do {\n const body = await akahuFetch(\"/transactions\", { start: startIso, end: endIso, cursor });\n transactions.push(...(body.items ?? []));\n cursor = body.cursor?.next ?? null;\n } while (cursor);\n\n return transactions;\n}\n",[],[161,225],["D",1780222958493],[179,180,181,182],[161],["D",1780222890810],["D",1789556471789],{"_97":96,"_104":99},{"_97":96,"_98":99,"_100":99,"_18":52,"_101":102,"_103":24},{"_13":86,"_31":87,"_40":39,"_88":41,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":42,"_95":96},"ctx",{"_79":-5,"_123":273,"_274":275,"_276":277,"_278":24,"_279":24,"_280":24,"_281":56,"_282":-5,"_283":-7,"_284":-7,"_285":60,"_286":24,"_287":24,"_288":-5,"_289":24,"_290":24,"_291":24,"_292":-5},"ENV",{"_244":245,"_246":247,"_248":87,"_249":250,"_251":252,"_253":254,"_255":256,"_257":258,"_259":260,"_261":262,"_263":264,"_265":266,"_267":268,"_269":270,"_271":272},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Something went wrong

Access denied

YNAB Importer

Setup

Connections

YNAB plan

Backfill

Account Mapping

Account Mapping

Transactions

Sync Runs

Diff · v27