[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_259":260,"_261":262},"routes/_app.x.$handle.$name",{"_102":101,"_33":46,"_111":92,"_27":112,"_13":14,"_113":-5,"_11":114,"_115":116,"_117":118,"_119":120,"_121":122,"_20":-5,"_123":-5,"_124":-5,"_125":25,"_126":127,"_128":25,"_129":-5,"_130":-5,"_131":132},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_44":45,"_33":46,"_39":47,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":56,"_18":57,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":76,"_77":76,"_78":79,"_80":79,"_81":79,"_82":76,"_83":76,"_84":85,"_86":87,"_88":89,"_90":25},"version",12,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":30},"file",{"_31":32,"_33":28,"_34":35,"_36":38,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_31":32,"_33":28,"_34":35,"_36":37},"deleted",false,"deletedHere","path","db.ts","latestPath","backend/db.ts","fileId","aad2cfa2-48c5-11f1-bfb8-42b51c65c3df","name","fileType","script","content","// ─────────────────────────────────────────────────────────────────────────────\n// db.ts — SQLite helpers\n// ─────────────────────────────────────────────────────────────────────────────\n//\n// Val Town gives every account a private SQLite database (powered by Turso).\n// It's shared across all your vals — so namespace your tables if needed.\n//\n// Key facts:\n// • Import from: https://esm.town/v/std/sqlite\n// • `.execute()` runs a single statement (returns { rows, columns })\n// • `.batch()` runs multiple statements in a transaction\n// • Storage: 10 MB free / 1 GB Pro — contact Val Town for more\n// • No filesystem access — SQLite and Blob are your persistence layers.\n//\n// Docs: https://docs.val.town/reference/std/sqlite/\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport { sqlite } from \"@std/sqlite\";\n\n// ── Schema Migration ─────────────────────────────────────────────────────────\n// Run on first import. `IF NOT EXISTS` makes this safe to re-run.\n\nawait sqlite.execute(`\n CREATE TABLE IF NOT EXISTS template_visits (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n path TEXT NOT NULL,\n ts TEXT NOT NULL DEFAULT (datetime('now'))\n )\n`);\n\n// ── Queries ──────────────────────────────────────────────────────────────────\n\n/** Record a page visit. */\nexport async function recordVisit(path: string): Promise {\n await sqlite.execute({\n sql: `INSERT INTO template_visits (path) VALUES (?)`,\n args: [path],\n });\n}\n\n/** Get total visit count. */\nexport async function getVisitCount(): Promise {\n const { rows } = await sqlite.execute(\n `SELECT COUNT(*) as count FROM template_visits`,\n );\n return Number(rows[0][0]);\n}\n\n/** Get the N most recent visits. */\nexport async function getRecentVisits(\n limit = 10,\n): Promise> {\n const { rows } = await sqlite.execute({\n sql: `SELECT id, path, ts FROM template_visits ORDER BY ts DESC LIMIT ?`,\n args: [limit],\n });\n return rows.map((r) => ({\n id: Number(r[0]),\n path: String(r[1]),\n ts: String(r[2]),\n }));\n}\n","// ─────────────────────────────────────────────────────────────────────────────\n// db.ts — SQLite helpers\n// ─────────────────────────────────────────────────────────────────────────────\n//\n// Val Town gives every account a private SQLite database (powered by Turso).\n// It's shared across all your vals — so namespace your tables if needed.\n//\n// Key facts:\n// • Import from: https://esm.town/v/std/sqlite\n// • `.execute()` runs a single statement (returns { rows, columns })\n// • `.batch()` runs multiple statements in a transaction\n// • Storage: 10 MB free / 1 GB Pro — contact Val Town for more\n// • No filesystem access — SQLite and Blob are your persistence layers.\n//\n// Docs: https://docs.val.town/reference/std/sqlite/\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport { sqlite } from \"@std/sqlite\";\n\n// ── Schema Migration ─────────────────────────────────────────────────────────\n// Lazily run on first DB call, not at import time. This prevents crashes\n// when running locally (off Val Town) where the SQLite API isn't available.\n\nlet migrated = false;\n\nasync function migrate(): Promise {\n if (migrated) return;\n migrated = true;\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS template_visits (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n path TEXT NOT NULL,\n ts TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n}\n\n// ── Queries ──────────────────────────────────────────────────────────────────\n\n/** Record a page visit. */\nexport async function recordVisit(path: string): Promise {\n await migrate();\n await sqlite.execute({\n sql: `INSERT INTO template_visits (path) VALUES (?)`,\n args: [path],\n });\n}\n\n/** Get total visit count. */\nexport async function getVisitCount(): Promise {\n await migrate();\n const { rows } = await sqlite.execute(\n `SELECT COUNT(*) as count FROM template_visits`,\n );\n return Number(rows[0][0]);\n}\n\n/** Get the N most recent visits. */\nexport async function getRecentVisits(\n limit = 10,\n): Promise> {\n await migrate();\n const { rows } = await sqlite.execute({\n sql: `SELECT id, path, ts FROM template_visits ORDER BY ts DESC LIMIT ?`,\n args: [limit],\n });\n return rows.map((r) => ({\n id: Number(r[0]),\n path: String(r[1]),\n ts: String(r[2]),\n }));\n}\n","createdAt",["D",1778053013706],"branchVersion","branchId","5a0a7ac8-4895-11f1-80ec-42b51c65c3df","id","5a09ae54-4895-11f1-80ec-42b51c65c3df","Quickstart-Full-Stack",["D",1777994172310],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","An elegant template for an elegant single-person full stack app.","imageUrl","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/3ed9401e-3850-4a69-dec2-1bdd924c0900/square512?exp=1789538399&sig=8ded5b974bfebef9817e2fbdffe4de4e1704e0d4cab9518c811db2594c0af107","173e7424-8658-428f-a3bc-ae4faeaabd1c","pinnedFileId","e1c705aa-4b18-11f1-b4ae-ee650bb23af1","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",1,"orgId","019df771-9af8-7238-99a4-541e39355038","tursoName","5a09ae54489511f180ec42b51c65c3df","tursoHostname","5a09ae54489511f180ec42b51c65c3df-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789511441255],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_102":101,"_110":106},"org",{"_102":101,"_103":104,"_105":106,"_18":57,"_107":108,"_109":25},"branch",{"_13":91,"_33":92,"_44":43,"_93":45,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":-5,"_99":46,"_100":101},"isOwned",384,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","pikachu","handle","displayName","Minion","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/22c8ba37-42c8-4af4-8daf-8cdd2f5f1800/square512?exp=1789538399&sig=21cdba23f818845c8391e88088eb5ea9255dbc43e05efe79e25bd70ab9ddb43a","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_44":45,"_33":46,"_39":254,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":56,"_18":57,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":255,"_74":-5,"_75":76,"_77":76,"_78":79,"_80":79,"_81":79,"_82":76,"_83":76,"_84":256,"_86":257,"_88":258,"_90":25},"tree",[217,218,219,220,221,222,223,224,225],"files",[217,218,219,220,221,222,223,224,225],"counts",{"_207":149,"_208":65,"_209":65,"_210":211,"_212":213},"contents",[133,134,135,136,137,138,139,140,141],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":200,"_33":201,"_31":202,"_145":-5,"_42":43,"_41":203,"_147":25,"_39":204,"_13":65,"_34":20,"_36":205,"_24":25,"_151":-5,"_27":206},{"_44":192,"_33":193,"_31":194,"_145":-5,"_42":43,"_41":195,"_147":25,"_39":196,"_13":149,"_34":197,"_36":198,"_24":25,"_151":-5,"_27":199},{"_44":189,"_33":28,"_31":32,"_145":-5,"_42":43,"_41":14,"_147":25,"_39":190,"_13":65,"_34":35,"_36":38,"_24":25,"_151":-5,"_27":191},{"_44":182,"_33":183,"_31":184,"_145":-5,"_42":43,"_41":185,"_147":25,"_39":186,"_13":149,"_34":20,"_36":187,"_24":25,"_151":-5,"_27":188},{"_44":174,"_33":175,"_31":176,"_145":-5,"_42":43,"_41":177,"_147":25,"_39":178,"_13":149,"_34":179,"_36":180,"_24":25,"_151":-5,"_27":181},{"_44":167,"_33":168,"_31":169,"_145":-5,"_42":43,"_41":170,"_147":25,"_39":171,"_13":65,"_34":35,"_36":172,"_24":25,"_151":-5,"_27":173},{"_44":160,"_33":161,"_31":162,"_145":-5,"_42":43,"_41":163,"_147":25,"_39":164,"_13":149,"_34":35,"_36":165,"_24":25,"_151":-5,"_27":166},{"_44":153,"_33":154,"_31":155,"_145":-5,"_42":43,"_41":156,"_147":25,"_39":157,"_13":149,"_34":35,"_36":158,"_24":25,"_151":-5,"_27":159},{"_44":142,"_33":143,"_31":144,"_145":-5,"_42":43,"_41":146,"_147":25,"_39":148,"_13":149,"_34":20,"_36":150,"_24":25,"_151":-5,"_27":152},"aa729362-48c5-11f1-87ca-42b51c65c3df","val.yml","aa729402-48c5-11f1-87ca-42b51c65c3df","parentId",5,"latest",["D",1778014923050],0,"name: \"_template\"\npublic: true\norg: \"uapps\"\n","label",[143],"aa15da50-48c5-11f1-8bd1-42b51c65c3df","storage.ts","aa15db36-48c5-11f1-8bd1-42b51c65c3df",2,["D",1778014922440],"// ─────────────────────────────────────────────────────────────────────────────\n// storage.ts — Blob storage helpers\n// ─────────────────────────────────────────────────────────────────────────────\n//\n// Val Town provides account-scoped blob storage for binary data — images,\n// JSON snapshots, config files, etc. Blobs are shared across all your vals\n// (just like SQLite), so use key prefixes to namespace.\n//\n// Key facts:\n// • Import from: https://esm.town/v/std/blob\n// • `.set(key, value)` — store a string or binary blob\n// • `.get(key)` — retrieve it (returns Response-like object)\n// • `.list(prefix?)` — list all keys (optionally filtered by prefix)\n// • `.delete(key)` — remove a blob\n// • No filesystem — blob storage is the alternative for file-like data.\n//\n// Docs: https://docs.val.town/reference/std/blob\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport { blob } from \"@std/blob\";\n\n/** Key prefix to avoid collisions with other vals. */\nconst PREFIX = \"template/\";\n\n// ── Read / Write ─────────────────────────────────────────────────────────────\n\n/** Store a JSON-serialisable value under a namespaced key. */\nexport async function saveJSON(key: string, value: unknown): Promise {\n await blob.set(`${PREFIX}${key}`, JSON.stringify(value));\n}\n\n/** Retrieve a previously stored JSON value, or null if missing. */\nexport async function loadJSON(key: string): Promise {\n try {\n const raw = await blob.get(`${PREFIX}${key}`);\n if (!raw) return null;\n return JSON.parse(await raw.text()) as T;\n } catch {\n return null;\n }\n}\n\n// ── List / Delete ────────────────────────────────────────────────────────────\n\n/** List all blob keys under our namespace. */\nexport async function listKeys(): Promise {\n const keys = await blob.list(PREFIX);\n // Strip the prefix so callers see clean names\n return keys.map((k: { key: string } | string) => (typeof k === \"string\" ? k : k.key).replace(PREFIX, \"\"));\n}\n\n/** Delete a namespaced blob. */\nexport async function remove(key: string): Promise {\n await blob.delete(`${PREFIX}${key}`);\n}\n",[154],"aada957a-48c5-11f1-b1d7-42b51c65c3df","shared.ts","aada9642-48c5-11f1-b1d7-42b51c65c3df",9,["D",1778014923052],"// ─────────────────────────────────────────────────────────────────────────────\n// shared.ts — Constants, types, and tiny utilities\n// ─────────────────────────────────────────────────────────────────────────────\n//\n// Keep this file dependency-free. It's imported by every other module.\n// ─────────────────────────────────────────────────────────────────────────────\n\n// ── Constants ────────────────────────────────────────────────────────────────\n\n/** Display name used in HTML titles, logs, and API responses. */\nexport const APP_NAME = \"Val Town Template\";\n\n// ── Environment Variables ────────────────────────────────────────────────────\n//\n// Secrets and API keys live in the Val Town UI sidebar (Environment Variables).\n// They are private — even on public vals, values are never exposed to viewers.\n//\n// const key = Deno.env.get(\"MY_API_KEY\"); // Deno-native\n// const key = process.env.MY_API_KEY; // Node-compat shim\n//\n// ⚠️ Deno.env.set() is a no-op on Val Town. You can only set env vars via\n// the UI or via Environment Groups (org accounts).\n//\n// Docs: https://docs.val.town/reference/environment-variables\n\n/** Read an env var with an optional fallback. */\nexport function env(key: string, fallback = \"\"): string {\n return Deno.env.get(key) ?? fallback;\n}\n\n// ── Importing Modules ────────────────────────────────────────────────────────\n//\n// Val Town runs on Deno. You can import from:\n//\n// Relative files: import { helper } from \"./utils.ts\";\n// npm: import lodash from \"npm:lodash\";\n// jsr: import { z } from \"jsr:@std/zod\";\n// https: import { Hono } from \"https://esm.sh/hono\";\n// Other vals: import { foo } from \"https://esm.town/v/username/valName\";\n//\n// Docs: https://docs.val.town/reference/import/\n\n// ── HTML Helper ──────────────────────────────────────────────────────────────\n\n/** Wrap body HTML in a minimal, styled document shell. */\nexport function html(body: string): string {\n return `\n\n\n \n \n ${APP_NAME}\n \n\n\n ${body}\n\n`;\n}\n\n// ── Types ────────────────────────────────────────────────────────────────────\n\n/** Val Town's inbound Email type. */\nexport interface InboundEmail {\n from: string;\n to: string[];\n cc: string | string[] | undefined;\n bcc: string | string[] | undefined;\n subject: string | undefined;\n text: string | undefined;\n html: string | undefined;\n attachments: File[];\n headers: Record;\n}\n\n/** Val Town's Cron Interval type. */\nexport interface CronInterval {\n lastRunAt: Date | undefined;\n}\n",[161],"ab13b4fe-48c5-11f1-a16f-42b51c65c3df","index.ts","5ae332be-4895-11f1-a469-42b51c65c3df",10,["D",1778014924063],"// ─────────────────────────────────────────────────────────────────────────────\n// Val Town — _template\n// ─────────────────────────────────────────────────────────────────────────────\n//\n// The canonical uApps starter val. A living, breathing reference for the\n// Val Town platform — copy it with `vt new ` and trim what you don't\n// need.\n//\n// Architecture (one concern per file):\n//\n// index.ts ← HTTP handler (this file — the default export)\n// cron.ts ← Cron / scheduled-task handler\n// email.ts ← Inbound email handler\n// db.ts ← SQLite helpers (schema + queries)\n// storage.ts ← Blob storage helpers\n// shared.ts ← Constants, types, and tiny utilities\n// README.md ← You are here — full platform walkthrough\n//\n// Docs: https://docs.val.town/\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport { getVisitCount, recordVisit } from \"./db.ts\";\nimport { APP_NAME, html } from \"./shared.ts\";\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// HTTP Trigger — Default Export\n// ═══════════════════════════════════════════════════════════════════════════════\n//\n// Every val can expose an HTTP endpoint. The default export receives a\n// standard `Request` and must return a standard `Response`.\n//\n// Your public URL looks like:\n// https://--.web.val.run\n//\n// You can also set a custom subdomain or even a custom domain (Pro).\n//\n// Compatible with frameworks like Hono, itty-router, etc. — but plain\n// `Request → Response` works perfectly for simple APIs.\n//\n// Docs: https://docs.val.town/vals/http/\n\nexport default async function handler(req: Request): Promise {\n const url = new URL(req.url);\n const { pathname } = url;\n\n // ── GET / — Landing page ────────────────────────────────────────────────\n // Returns a minimal HTML page with a visit counter (powered by SQLite).\n if (pathname === \"/\" || pathname === \"\") {\n await recordVisit(\"/\");\n const count = await getVisitCount();\n return new Response(\n html(`\n

🏔️ ${APP_NAME}

\n This val has been visited ${count} time${\n count === 1 ? \"\" : \"s\"\n }.\n

Try the API

GET /api/health — JSON health check
GET /api/visits — Recent visits (SQLite)
POST /api/echo — Echo back your JSON body

Learn More

\n Read the Val Town docs or view\n this val's source to explore every platform feature.\n

\n `),\n { headers: { \"Content-Type\": \"text/html; charset=utf-8\" } },\n );\n }\n\n // ── GET /api/health — JSON health check ─────────────────────────────────\n if (pathname === \"/api/health\") {\n return Response.json({\n ok: true,\n name: APP_NAME,\n timestamp: new Date().toISOString(),\n runtime: `Deno ${Deno.version.deno}`,\n });\n }\n\n // ── GET /api/visits — Recent visits from SQLite ─────────────────────────\n if (pathname === \"/api/visits\") {\n const { getRecentVisits } = await import(\"./db.ts\");\n const visits = await getRecentVisits(20);\n return Response.json({ visits });\n }\n\n // ── POST /api/echo — Echo request body ──────────────────────────────────\n // Demonstrates reading JSON from a POST request.\n if (pathname === \"/api/echo\" && req.method === \"POST\") {\n try {\n const body = await req.json();\n return Response.json({\n echo: body,\n receivedAt: new Date().toISOString(),\n });\n } catch {\n return Response.json({ error: \"Invalid JSON body\" }, { status: 400 });\n }\n }\n\n // ── 404 — Fallback ──────────────────────────────────────────────────────\n return Response.json(\n { error: \"Not found\", path: pathname },\n { status: 404 },\n );\n}\n",[168],"aa774222-48c5-11f1-831b-42b51c65c3df","email.ts","aa7742d6-48c5-11f1-831b-42b51c65c3df",6,["D",1778014923064],"email","// ─────────────────────────────────────────────────────────────────────────────\n// email.ts — Email: receiving and sending\n// ─────────────────────────────────────────────────────────────────────────────\n//\n// Val Town has two email capabilities:\n//\n// 1. RECEIVE — Your val gets a unique email address. Incoming emails invoke\n// the handler you export (see `emailHandler` below).\n//\n// 2. SEND — Use the `@std/email` standard library to send outbound emails.\n// Free accounts can only send to themselves. Pro can send to anyone.\n//\n// Setup (inbound):\n// 1. Open this val in the Val Town editor\n// 2. Click the + button (top-right) → select EMAIL\n// 3. Point it at this file's `emailHandler` export\n// 4. Val Town assigns an address like: .@valtown.email\n// (you can also set a custom @valtown.email address)\n//\n// Key facts:\n// • Inbound email size limit: 30 MB (including attachments)\n// • Attachments are standard `File` objects (.text(), .arrayBuffer(), etc.)\n// • Outbound rate limit: 100 emails/min\n// • Free plan: can only send to yourself\n// • Pro plan: send to any address, add cc/bcc, attachments\n//\n// Docs:\n// Receive: https://docs.val.town/vals/email\n// Send: https://docs.val.town/reference/std/email\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport { email as sendEmail } from \"@std/email\";\nimport type { InboundEmail } from \"./shared.ts\";\nimport { APP_NAME } from \"./shared.ts\";\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// Inbound — Email Trigger Handler\n// ═══════════════════════════════════════════════════════════════════════════════\n\n/**\n * Handles incoming emails sent to this val's email address.\n *\n * Common use cases:\n * - Auto-forward emails to Slack / Discord\n * - Parse attachments and store them in Blob storage\n * - Log support emails to a SQLite table\n * - Reply with an auto-response\n */\nexport default function emailHandler(\n inbound: InboundEmail,\n): void {\n console.log(`📧 [${APP_NAME}] Email received`);\n console.log(` From: ${inbound.from}`);\n console.log(` To: ${inbound.to.join(\", \")}`);\n console.log(` Subject: ${inbound.subject ?? \"(no subject)\"}`);\n console.log(` Body: ${inbound.text?.slice(0, 200) ?? \"(empty)\"}...`);\n\n // ── Process attachments ─────────────────────────────────────────────────\n if (inbound.attachments.length > 0) {\n console.log(` 📎 ${inbound.attachments.length} attachment(s):`);\n for (const file of inbound.attachments) {\n console.log(` • ${file.name} (${file.type}, ${file.size} bytes)`);\n // Example: save to blob storage\n // import { blob } from \"@std/blob\";\n // await blob.set(`emails/${file.name}`, await file.arrayBuffer());\n }\n }\n\n // ── Example: auto-reply using sendNotification() below ──────────────────\n // await sendNotification(\n // `Re: ${inbound.subject ?? \"your email\"}`,\n // `Thanks for your message! We received it at ${new Date().toISOString()}.`,\n // );\n}\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// Outbound — Sending Emails\n// ═══════════════════════════════════════════════════════════════════════════════\n//\n// The `@std/email` module exposes a single function:\n//\n// await email({\n// to: \"user@example.com\", // optional (defaults to you)\n// subject: \"Hello\", // required\n// text: \"Plain text body\", // text or html required\n// html: \"

Rich body

\", // text or html required\n// from: { name: \"My Val\" }, // optional display name\n// cc: \"cc@example.com\", // optional (Pro only)\n// bcc: [\"a@x.com\", \"b@x.com\"], // optional (Pro only)\n// replyTo: \"reply@example.com\", // optional\n// attachments: [{ // optional\n// content: btoa(\"file contents\"), // base64-encoded\n// filename: \"report.txt\",\n// type: \"text/plain\",\n// disposition: \"attachment\",\n// }],\n// });\n//\n// On the free plan, the `to` field is ignored — emails always go to you.\n// On Pro, you can send to anyone.\n\n/**\n * Send a simple notification email (to yourself on free, anyone on Pro).\n *\n * This is a thin wrapper around `@std/email` — use it as a starting point\n * and customise the options as needed.\n */\nexport async function sendNotification(\n subject: string,\n body: string,\n options?: {\n to?: string;\n html?: string;\n },\n): Promise {\n await sendEmail({\n subject,\n text: body,\n ...(options?.to && { to: options.to }),\n ...(options?.html && { html: options.html }),\n });\n console.log(`📤 [${APP_NAME}] Email sent: \"${subject}\"`);\n}\n\n/**\n * Send an email with attachments.\n *\n * Attachments must be base64-encoded. Use `btoa()` for text content\n * or convert binary data with `btoa(String.fromCharCode(...bytes))`.\n */\nexport async function sendWithAttachment(\n subject: string,\n body: string,\n attachment: {\n content: string; // base64-encoded\n filename: string;\n type?: string; // MIME type, e.g. \"application/pdf\"\n },\n): Promise {\n await sendEmail({\n subject,\n text: body,\n attachments: [\n {\n content: attachment.content,\n filename: attachment.filename,\n type: attachment.type ?? \"application/octet-stream\",\n disposition: \"attachment\",\n },\n ],\n });\n console.log(\n `📤 [${APP_NAME}] Email sent with attachment: \"${attachment.filename}\"`,\n );\n}\n",[175],"aa1daea6-48c5-11f1-a16f-42b51c65c3df","deno.json","aa1daf50-48c5-11f1-a16f-42b51c65c3df",3,["D",1778014922441],"{\n \"imports\": {\n \"@std/sqlite\": \"https://esm.town/v/std/sqlite\",\n \"@std/blob\": \"https://esm.town/v/std/blob\",\n \"@std/email\": \"https://esm.town/v/std/email\"\n }\n}\n",[183],"5a4c4a00-491e-11f1-913b-42b51c65c3df",["D",1778053013706],[28],"aa65189a-48c5-11f1-bfb8-42b51c65c3df","cron.ts","aa651980-48c5-11f1-bfb8-42b51c65c3df",4,["D",1778014922943],"interval","// ─────────────────────────────────────────────────────────────────────────────\n// cron.ts — Scheduled / Cron task handler\n// ─────────────────────────────────────────────────────────────────────────────\n//\n// Cron triggers let you run code on a schedule — every few minutes, hourly,\n// daily, or via a full cron expression.\n//\n// Setup:\n// 1. Open this val in the Val Town editor\n// 2. Click the + button (top-right) → select CRON\n// 3. Point it at this file's exported function\n// 4. Set your schedule (e.g. \"every 1 hour\" or \"0 */2 1 * *\")\n//\n// Key facts:\n// • Minimum interval: 15 min (free) / 1 min (Pro)\n// • Cron expressions are always evaluated in UTC\n// • The handler receives an `Interval` with `lastRunAt`\n// • Return values are ignored — use console.log or side effects\n//\n// Docs: https://docs.val.town/vals/cron\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport type { CronInterval } from \"./shared.ts\";\nimport { APP_NAME } from \"./shared.ts\";\n\n/**\n * Example cron handler.\n *\n * Common use cases:\n * - Poll an API or RSS feed for new items\n * - Send a daily digest email\n * - Clean up stale data in SQLite\n * - Ping a health-check endpoint\n */\nexport default function cronHandler(interval: CronInterval): void {\n const lastRun = interval.lastRunAt?.toISOString() ?? \"never\";\n console.log(`⏰ [${APP_NAME}] Cron fired! Last run: ${lastRun}`);\n\n // ── Example: fetch an API ───────────────────────────────────────────────\n // const res = await fetch(\"https://api.example.com/data\");\n // const data = await res.json();\n // console.log(\"Fetched data:\", data);\n\n // ── Example: clean up old SQLite rows ───────────────────────────────────\n // import { sqlite } from \"@std/sqlite\";\n // await sqlite.execute(\n // `DELETE FROM template_visits WHERE ts < datetime('now', '-30 days')`\n // );\n}\n",[193],"5a3ac104-491e-11f1-9e87-42b51c65c3df","README.md","aabf7b64-48c5-11f1-9920-42b51c65c3df",11,["D",1778053013652],"# 🏔️ Val Town Template\n\nStarter val demonstrating every major Val Town feature. Fork it, trim what you don't need.\n\n```bash\nvt new my-app # clones this template → vals/my-app\ncd vals/my-app\nvt watch # live-push changes on save\n```\n\n---\n\n## Files\n\n| File | Trigger | Purpose |\n|---|---|---|\n| `index.ts` | HTTP | Web server — routes, JSON API, HTML pages |\n| `cron.ts` | Cron | Scheduled tasks (poll APIs, clean data, digests) |\n| `email.ts` | Email | Receive inbound email + send outbound |\n| `db.ts` | — | SQLite schema & query helpers |\n| `storage.ts` | — | Blob storage read/write/list/delete |\n| `shared.ts` | — | Constants, types, `html()` helper, `env()` wrapper |\n\n**Rule:** One concern per file. Every file except `shared.ts` is independently deletable.\n\n---\n\n## HTTP Routes (`index.ts`)\n\n| Route | Method | Description |\n|---|---|---|\n| `/` | GET | HTML landing page with visit counter |\n| `/api/health` | GET | JSON health check |\n| `/api/visits` | GET | Recent visits from SQLite |\n| `/api/echo` | POST | Echo back your JSON body |\n| `/*` | ANY | 404 JSON response |\n\nYour val is live at `https://--.web.val.run`. Supports any framework (Hono, itty-router) or plain `Request → Response`.\n\n

Route implementation pattern

\n\n```ts\nexport default async function handler(req: Request): Promise {\n const { pathname } = new URL(req.url);\n\n if (pathname === \"/api/hello\") {\n return Response.json({ message: \"Hello!\" });\n }\n\n return Response.json({ error: \"Not found\" }, { status: 404 });\n}\n```\n

\n\n---\n\n## Cron (`cron.ts`)\n\nRun code on a schedule. **Setup:** Editor → **+** → **CRON** → point at `cronHandler`.\n\n| Format | Example | Notes |\n|---|---|---|\n| Interval | `every 1 hour` | Human-readable |\n| Cron | `0 9 * * 1-5` | 9am UTC, Mon–Fri |\n\n- Min interval: **15 min** (free) / **1 min** (Pro)\n- Handler receives `{ lastRunAt }` — useful for incremental fetches\n- Always UTC. Return values ignored — use `console.log()` for debugging\n\n

Docs link

\n\nhttps://docs.val.town/vals/cron\n

\n\n---\n\n## Email (`email.ts`)\n\n### Receiving\n\nYour val gets an address: `.@valtown.email`\n\n**Setup:** Editor → **+** → **EMAIL** → point at `emailHandler`\n\nHandler receives an `InboundEmail` with `from`, `to`, `subject`, `text`, `html`, `attachments` (standard `File[]`), and `headers`.\n\n### Sending\n\n```ts\nimport { sendNotification, sendWithAttachment } from \"./email.ts\";\n\n// Simple text email (sends to yourself on free, anyone on Pro)\nawait sendNotification(\"Subject\", \"Body text\");\n\n// With attachment\nawait sendWithAttachment(\"Report\", \"See attached\", {\n content: btoa(\"CSV,data\"),\n filename: \"report.csv\",\n type: \"text/csv\",\n});\n```\n\n| Feature | Free | Pro |\n|---|---|---|\n| Send to self | ✅ | ✅ |\n| Send to others | ❌ | ✅ |\n| CC / BCC | ❌ | ✅ |\n| Rate limit | 100/min | 100/min |\n\n

Full email options (Pro)

\n\n```ts\nimport { email } from \"@std/email\";\n\nawait email({\n to: \"user@example.com\",\n subject: \"Hello\",\n text: \"Plain text body\",\n html: \"

Rich HTML body

\",\n cc: \"cc@example.com\",\n attachments: [{\n content: btoa(\"file contents\"),\n filename: \"doc.txt\",\n type: \"text/plain\",\n }],\n});\n```\n

\n\n---\n\n## SQLite (`db.ts`)\n\nEvery account gets a private SQLite database (Turso). Shared across all vals — **namespace your tables**.\n\n```ts\nimport { sqlite } from \"@std/sqlite\";\n\n// Simple query\nconst { rows } = await sqlite.execute(\"SELECT 1\");\n\n// Parameterized\nawait sqlite.execute({ sql: \"SELECT * FROM users WHERE age > ?\", args: [18] });\n\n// Batch (transaction)\nawait sqlite.batch([\n \"CREATE TABLE IF NOT EXISTS t (id INTEGER PRIMARY KEY)\",\n { sql: \"INSERT INTO t VALUES (?)\", args: [1] },\n]);\n```\n\n- Returns `{ rows: any[][], columns: string[] }` — rows are arrays, not objects\n- Use `CREATE TABLE IF NOT EXISTS` for migrations (safe to re-run)\n- Storage: **10 MB** (free) / **1 GB** (Pro)\n\n

Docs link

\n\nhttps://docs.val.town/reference/std/sqlite/\n

\n\n---\n\n## Blob Storage (`storage.ts`)\n\nFor binary data, JSON snapshots, config — anything that doesn't fit in SQLite.\n\n```ts\nimport { saveJSON, loadJSON, listKeys, remove } from \"./storage.ts\";\n\nawait saveJSON(\"config\", { theme: \"dark\" });\nconst cfg = await loadJSON<{ theme: string }>(\"config\");\n```\n\nRaw API: `blob.set(key, value)`, `blob.get(key)`, `blob.list(prefix?)`, `blob.delete(key)`.\n\nKeys are prefixed with `template/` — change the `PREFIX` constant when you rename your val.\n\n

Docs link

\n\nhttps://docs.val.town/reference/std/blob\n

\n\n---\n\n## Imports (`deno.json`)\n\nDependencies are mapped in `deno.json` for clean imports:\n\n```jsonc\n{\n \"imports\": {\n \"@std/sqlite\": \"https://esm.town/v/std/sqlite\",\n \"@std/blob\": \"https://esm.town/v/std/blob\",\n \"@std/email\": \"https://esm.town/v/std/email\"\n }\n}\n```\n\nAll Deno import styles work: `./relative.ts`, `npm:lodash`, `jsr:@std/zod`, `https://esm.sh/hono`, `https://esm.town/v/user/val`.\n\n---\n\n## Environment Variables\n\nSet in Val Town UI sidebar → **Environment Variables**. Private even on public vals.\n\n```ts\nconst key = Deno.env.get(\"MY_API_KEY\"); // Deno-native\nconst key = env(\"MY_API_KEY\", \"fallback\"); // from shared.ts\n```\n\n`Deno.env.set()` is a **no-op** on Val Town.\n\n---\n\n## `val.yml` Configuration\n\n```yaml\nname: \"_template\" # Val name on Val Town\npublic: true # true = public, false = private/unlisted\norg: \"uapps\" # Deploy under this org (optional)\n```\n\n---\n\n## Runtime & Limits\n\n| | Detail |\n|---|---|\n| Runtime | Deno (latest stable), TypeScript built-in |\n| Timeout | ~30s per request |\n| Filesystem | ❌ — use SQLite + Blob |\n| WebSockets | ❌ |\n| Web APIs | ✅ Request, Response, fetch, URL, Headers |\n\n| Resource | Free | Pro |\n|---|---|---|\n| Private vals | 5 | Unlimited |\n| SQLite | 10 MB | 1 GB |\n| Cron min interval | 15 min | 1 min |\n| Email | Self only | Anyone |\n\n---\n\n## CLI Workflow\n\n```bash\nvt status # Check sync state\nvt push # Deploy local → Val Town\nvt pull # Pull remote → local\nvt watch # Auto-push on file save\nvt checkout -b feat # Work on a branch\nvt log # View version history\n```\n",[201],"pulls","branches","forks","envVars",{"_214":65,"_216":149},"connections",{"_214":149,"_215":149},"count","unfilledCount","emptyCount",{"_44":200,"_33":201,"_31":202,"_145":-5,"_42":43,"_41":203,"_147":25,"_39":251,"_13":65,"_34":20,"_36":205,"_24":25,"_151":-5,"_227":252,"_27":253},{"_44":192,"_33":193,"_31":194,"_145":-5,"_42":43,"_41":195,"_147":25,"_39":248,"_13":149,"_34":197,"_36":198,"_24":25,"_151":-5,"_227":249,"_27":250},{"_44":189,"_33":28,"_31":32,"_145":-5,"_42":43,"_41":14,"_147":25,"_39":245,"_13":65,"_34":35,"_36":38,"_24":25,"_151":-5,"_227":246,"_27":247},{"_44":182,"_33":183,"_31":184,"_145":-5,"_42":43,"_41":185,"_147":25,"_39":242,"_13":149,"_34":20,"_36":187,"_24":25,"_151":-5,"_227":243,"_27":244},{"_44":174,"_33":175,"_31":176,"_145":-5,"_42":43,"_41":177,"_147":25,"_39":239,"_13":149,"_34":179,"_36":180,"_24":25,"_151":-5,"_227":240,"_27":241},{"_44":167,"_33":168,"_31":169,"_145":-5,"_42":43,"_41":170,"_147":25,"_39":236,"_13":65,"_34":35,"_36":172,"_24":25,"_151":-5,"_227":237,"_27":238},{"_44":160,"_33":161,"_31":162,"_145":-5,"_42":43,"_41":163,"_147":25,"_39":233,"_13":149,"_34":35,"_36":165,"_24":25,"_151":-5,"_227":234,"_27":235},{"_44":153,"_33":154,"_31":155,"_145":-5,"_42":43,"_41":156,"_147":25,"_39":230,"_13":149,"_34":35,"_36":158,"_24":25,"_151":-5,"_227":231,"_27":232},{"_44":142,"_33":143,"_31":144,"_145":-5,"_42":43,"_41":146,"_147":25,"_39":226,"_13":149,"_34":20,"_36":150,"_24":25,"_151":-5,"_227":228,"_27":229},["D",1778014923050],"children",[],[143],["D",1778014922440],[],[154],["D",1778014923052],[],[161],["D",1778014924063],[],[168],["D",1778014923064],[],[175],["D",1778014922441],[],[183],["D",1778053013706],[],[28],["D",1778014922943],[],[193],["D",1778053013652],[],[201],["D",1777994172310],["D",1789511441255],{"_102":101,"_110":106},{"_102":101,"_103":104,"_105":106,"_18":57,"_107":108,"_109":25},{"_13":91,"_33":92,"_44":43,"_93":45,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":-5,"_99":46,"_100":101},"ctx",{"_84":-5,"_130":292,"_293":294,"_295":296,"_297":25,"_298":25,"_299":25,"_300":61,"_301":-5,"_302":-7,"_303":-7,"_304":149,"_305":25,"_306":25,"_307":-5,"_308":25,"_309":25,"_310":25,"_311":-5},"ENV",{"_263":264,"_265":266,"_267":92,"_268":269,"_270":271,"_272":273,"_274":275,"_276":277,"_278":279,"_280":281,"_282":283,"_284":285,"_286":287,"_288":289,"_290":291},"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"]

Diff · v12