[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_296":297,"_298":299},"routes/_app.x.$handle.$name",{"_102":101,"_32":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,"_32":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",56,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":38,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","backend/shared.ts","latestPath","fileId","aada9642-48c5-11f1-b1d7-42b51c65c3df","name","shared.ts","fileType","script","content","// shared.ts — Constants, types, utils. No external dependencies.\n\n// ── Constants ─────────────────────────────────────────────────────────────────\n\nexport const APP_NAME = \"Val Town Template\";\n\n// ── Env ───────────────────────────────────────────────────────────────────────\n// Deno.env.set() is a no-op on Val Town — set vars in the UI sidebar only.\n\nexport function env(key: string, fallback = \"\"): string {\n return Deno.env.get(key) ?? fallback;\n}\n\n// ── HTML shell ────────────────────────────────────────────────────────────────\n return `\n\n\n \n \n ${APP_NAME}\n \n\n\n ${body}\n\n`;\n}\n\n// ── Duration ──────────────────────────────────────────────────────────────────\n// \"30s\" | \"5m\" | \"2h\" | \"1d\" → ms. \"DISABLED\" | invalid → null.\nexport function parseDuration(raw: string): number | null {\n const s = raw.trim();\n if (s.toUpperCase() === \"DISABLED\") return null;\n const m = /^(\\d+)(s|m|h|d)$/i.exec(s);\n if (!m) return null;\n const n = parseInt(m[1], 10);\n if (n <= 0) return null;\n const factors: Record = {\n s: 1_000,\n m: 60_000,\n h: 3_600_000,\n d: 86_400_000,\n };\n return n * factors[m[2].toLowerCase()];\n}\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\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","// shared.ts — Constants, types, utils. No external dependencies.\n\n// ── Constants ─────────────────────────────────────────────────────────────────\n\nexport const APP_NAME = \"Val Town Template\";\n\n// ── Env ───────────────────────────────────────────────────────────────────────\n// Deno.env.set() is a no-op on Val Town — set vars in the UI sidebar only.\n\nexport function env(key: string, fallback = \"\"): string {\n return Deno.env.get(key) ?? fallback;\n}\n\n// ── Duration ──────────────────────────────────────────────────────────────────\n// \"30s\" | \"5m\" | \"2h\" | \"1d\" → ms. \"DISABLED\" | invalid → null.\nexport function parseDuration(raw: string): number | null {\n const s = raw.trim();\n if (s.toUpperCase() === \"DISABLED\") return null;\n const m = /^(\\d+)(s|m|h|d)$/i.exec(s);\n if (!m) return null;\n const n = parseInt(m[1], 10);\n if (n <= 0) return null;\n const factors: Record = {\n s: 1_000,\n m: 60_000,\n h: 3_600_000,\n d: 86_400_000,\n };\n return n * factors[m[2].toLowerCase()];\n}\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n// Matches the platform's inbound Email trigger interface.\n\nexport interface Email {\n from: string;\n to: string[];\n cc?: string | string[];\n bcc?: string | string[];\n subject?: string;\n text?: string;\n html?: string;\n attachments: File[];\n headers: Record;\n}\n","createdAt",["D",1778270041498],"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,"_32":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,"_32":46,"_39":291,"_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":292,"_74":-5,"_75":76,"_77":76,"_78":79,"_80":79,"_81":79,"_82":76,"_83":76,"_84":293,"_86":294,"_88":295,"_90":25},"tree",[215,219,222,223,224,225,226,227],"files",[215,216,217,218,219,220,221,222,223,224,225,226,227],"counts",{"_205":196,"_206":65,"_207":65,"_208":209,"_210":211},"contents",[133,134,135,136,137,138,139,140],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":199,"_32":200,"_30":201,"_144":-5,"_42":43,"_41":202,"_146":61,"_39":203,"_13":196,"_34":197,"_36":-5,"_24":25,"_149":-5,"_27":204},{"_44":191,"_32":192,"_30":193,"_144":-5,"_42":43,"_41":194,"_146":61,"_39":195,"_13":196,"_34":197,"_36":-5,"_24":25,"_149":-5,"_27":198},{"_44":184,"_32":185,"_30":186,"_144":-5,"_42":43,"_41":187,"_146":25,"_39":188,"_13":172,"_34":20,"_36":189,"_24":25,"_149":-5,"_27":190},{"_44":175,"_32":176,"_30":177,"_144":-5,"_42":43,"_41":178,"_146":25,"_39":179,"_13":180,"_34":181,"_36":182,"_24":25,"_149":-5,"_27":183},{"_44":167,"_32":168,"_30":169,"_144":-5,"_42":43,"_41":170,"_146":25,"_39":171,"_13":172,"_34":20,"_36":173,"_24":25,"_149":-5,"_27":174},{"_44":159,"_32":160,"_30":161,"_144":-5,"_42":43,"_41":162,"_146":25,"_39":163,"_13":156,"_34":164,"_36":165,"_24":25,"_149":-5,"_27":166},{"_44":151,"_32":152,"_30":153,"_144":-5,"_42":43,"_41":154,"_146":25,"_39":155,"_13":156,"_34":35,"_36":157,"_24":25,"_149":-5,"_27":158},{"_44":141,"_32":142,"_30":143,"_144":-5,"_42":43,"_41":145,"_146":25,"_39":147,"_13":65,"_34":20,"_36":148,"_24":25,"_149":-5,"_27":150},"b77e2f4c-495d-11f1-84af-42b51c65c3df","val.yml","aa729402-48c5-11f1-87ca-42b51c65c3df","parentId",46,"latest",["D",1778080228424],"name: \"sample-val\"\npublic: true\n","label",[142],"7c33c93a-496f-11f1-8f5c-42b51c65c3df","index.http.ts","5ae332be-4895-11f1-a469-42b51c65c3df",50,["D",1778087859890],5,"// index.http.ts — HTTP handler. Serves frontend/ and JSON API.\n// Docs: https://docs.val.town/vals/http\n\nimport { serveFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { getVisitCount, recordVisit } from \"./backend/db.ts\";\nimport { APP_NAME } from \"./backend/shared.ts\";\n\nexport default async function handler(req: Request): Promise {\n const url = new URL(req.url);\n const { pathname } = url;\n\n // ── 1. Static Asset Routing (Frontend) ──────────────────────────────────\n if (pathname.startsWith(\"/frontend/\")) {\n return await serveFile(pathname, import.meta.url);\n }\n\n // ── 2. Landing Page (Serves HTML & records visit) ───────────────────────\n if (pathname === \"/\" || pathname === \"\") {\n try {\n await recordVisit(\"/\");\n } catch {\n // SQLite might not be available locally\n }\n return await serveFile(\"/frontend/index.html\", import.meta.url);\n }\n\n // ── 3. API Routes (Backend) ─────────────────────────────────────────────\n\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 || \"unknown\"}`,\n });\n }\n\n if (pathname === \"/api/visits\") {\n try {\n const { getRecentVisits, getVisitCount } = await import(\n \"./backend/db.ts\"\n );\n const visits = await getRecentVisits(20);\n const total = await getVisitCount();\n return Response.json({ total, visits });\n } catch {\n return Response.json({\n error: \"SQLite not available (running off-platform?)\",\n }, { status: 503 });\n }\n }\n\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 // ── 4. Fallback ─────────────────────────────────────────────────────────\n return Response.json(\n { error: \"Not found\", path: pathname },\n { status: 404 },\n );\n}\n",[152],"7c1c73f2-496f-11f1-b4b9-42b51c65c3df","email.ts","aa7742d6-48c5-11f1-831b-42b51c65c3df",47,["D",1778087859748],"email","// email.ts — Inbound handler + outbound helpers.\n// Setup: Val Town UI → + → EMAIL → this file. Address: .@valtown.email\n// Docs: https://docs.val.town/vals/email https://docs.val.town/reference/std/email\n\nimport { email as sendEmail } from \"https://esm.town/v/std/email\";\nimport type { InboundEmail } from \"./backend/shared.ts\";\nimport { APP_NAME } from \"./backend/shared.ts\";\n\n// ── Inbound ───────────────────────────────────────────────────────────────────\n\n// deno-lint-ignore require-await\nexport default async function emailHandler(\n inbound: InboundEmail,\n): Promise {\n console.log(`📧 [${APP_NAME}] From: ${inbound.from} Subject: ${inbound.subject ?? \"(none)\"}`);\n console.log(` Body: ${inbound.text?.slice(0, 200) ?? \"(empty)\"}...`);\n\n for (const file of inbound.attachments) {\n console.log(` 📎 ${file.name} (${file.type}, ${file.size}b)`);\n // await blob.set(`emails/${file.name}`, await file.arrayBuffer());\n }\n\n // await sendNotification(`Re: ${inbound.subject}`, \"Got your message!\");\n}\n\n// ── Outbound ──────────────────────────────────────────────────────────────────\n// Free plan: `to` is ignored, sends to yourself. Pro: send to anyone + cc/bcc.\n\nexport async function sendNotification(\n subject: string,\n body: string,\n options?: { to?: string; html?: string },\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}] Sent: \"${subject}\"`);\n}\n\n/** `attachment.content` must be base64-encoded (use `btoa()`). */\nexport async function sendWithAttachment(\n subject: string,\n body: string,\n attachment: { content: string; filename: string; type?: string },\n): Promise {\n await sendEmail({\n subject,\n text: body,\n attachments: [{\n content: attachment.content,\n filename: attachment.filename,\n type: attachment.type ?? \"application/octet-stream\",\n disposition: \"attachment\",\n }],\n });\n console.log(`📤 [${APP_NAME}] Sent with attachment: \"${attachment.filename}\"`);\n}\n",[160],"a8e0a8b4-4b17-11f1-9fc9-ee650bb23af1","deno.json","86adc21c-4951-11f1-b797-42b51c65c3df",55,["D",1778270041449],2,"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": false,\n \"types\": [\n \"https://www.val.town/types/valtown.d.ts\"\n ],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"rules\": {\n \"exclude\": [\n \"no-explicit-any\",\n \"no-external-import\"\n ]\n }\n },\n \"node_modules_dir\": false,\n \"unstable\": [\"temporal\", \"worker-options\", \"sloppy-imports\", \"node-globals\"]\n}\n",[168],"7c718c16-496f-11f1-b7b0-42b51c65c3df","cron.ts","aa651980-48c5-11f1-bfb8-42b51c65c3df",53,["D",1778087860306],3,"interval","// ─────────────────────────────────────────────────────────────────────────────\n// cron.ts — Two tasks, one trigger. Docs: https://docs.val.town/vals/cron\n// ─────────────────────────────────────────────────────────────────────────────\n//\n// Setup: Val Town UI → + → CRON → this file → \"every 5 minutes\"\n//\n// Env vars:\n// CRON_PULSE_INTERVAL \"5m\" | \"15m\" | \"1h\" | \"DISABLED\" (default: \"5m\")\n// CRON_MAINTENANCE_INTERVAL \"1h\" | \"6h\" | \"1d\" | \"DISABLED\" (default: \"1d\")\n\nimport { APP_NAME, env, parseDuration } from \"./backend/shared.ts\";\nimport { getMetaValue, setMetaValue } from \"./backend/db.ts\";\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\n// ── Gate: true if intervalMs elapsed; records now in SQLite.\nasync function shouldRun(\n metaKey: string,\n intervalMs: number,\n now: Date,\n): Promise {\n const lastStr = await getMetaValue(metaKey).catch(() => null);\n if (lastStr) {\n const elapsed = now.getTime() - new Date(lastStr).getTime();\n if (elapsed < intervalMs) return false;\n }\n await setMetaValue(metaKey, now.toISOString());\n return true;\n}\n\n// ── Entry point ───────────────────────────────────────────────────────────────\n\nexport default async function (interval: Interval): Promise {\n const now = new Date();\n await pulse(interval, now);\n await maintenance(interval, now);\n}\n\n// ── Pulse — polling, health-checks, work-queues\nasync function pulse(interval: Interval, now: Date): Promise {\n const raw = env(\"CRON_PULSE_INTERVAL\", \"5m\");\n if (raw.toUpperCase() === \"DISABLED\") return;\n const intervalMs = parseDuration(raw) ?? parseDuration(\"5m\")!;\n if (!await shouldRun(\"cron_pulse_last_run\", intervalMs, now)) return;\n\n console.log(`⚡ [${APP_NAME}] Pulse (${raw})`);\n // const res = await fetch(\"https://api.example.com/feed\");\n}\n\n// ── Maintenance — prune, archive, digest\nasync function maintenance(interval: Interval, now: Date): Promise {\n const raw = env(\"CRON_MAINTENANCE_INTERVAL\", \"1d\");\n if (raw.toUpperCase() === \"DISABLED\") return;\n const intervalMs = parseDuration(raw) ?? parseDuration(\"1d\")!;\n if (!await shouldRun(\"cron_maintenance_last_run\", intervalMs, now)) return;\n\n console.log(`🔧 [${APP_NAME}] Maintenance (${raw})`);\n\n try {\n await sqlite.execute(\n `DELETE FROM template_visits WHERE ts < datetime('now', '-30 days')`,\n );\n } catch { /* table may not exist yet */ }\n\n console.log(`✅ [${APP_NAME}] Maintenance done`);\n}\n",[176],"7c8e6160-496f-11f1-b9b1-42b51c65c3df","README.md","aabf7b64-48c5-11f1-9920-42b51c65c3df",54,["D",1778087860492],"# 🏔️ 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.http.ts` | HTTP | Web server — routes, JSON API, HTML pages |\n| `cron.ts` | Cron | Two tasks: pulse every 5 min + maintenance every 24h |\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()`, `env()`, `parseDuration()` |\n\n**Rule:** One concern per file. Every file except `shared.ts` is independently deletable.\n\n---\n\n## HTTP Routes (`index.http.ts`)\n\n> **Why `.http.ts`?** The `vt` CLI auto-detects any file with `http` in the\n> name as an HTTP trigger and registers it on Val Town automatically when pushed.\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\nOne trigger, two tasks — each with its own env-configurable interval.\n\n**Setup:** Editor → **+** → **CRON** → point at `cron.ts` → schedule: `every 5 minutes`\n\n| Task | Env var | Default | Purpose |\n|---|---|---|---|\n| Pulse | `CRON_PULSE_INTERVAL` | `\"5m\"` | Polling, health-checks, work-queues |\n| Maintenance | `CRON_MAINTENANCE_INTERVAL` | `\"1d\"` | Pruning, archiving, digests |\n\nBoth env vars accept the same duration format, and independently gate their work via a last-run timestamp stored in `template_meta` (SQLite):\n\n```\n\"30s\" → 30 seconds\n\"5m\" → 5 minutes\n\"2h\" → 2 hours\n\"1d\" → 1 day\n\"DISABLED\" → skip entirely (no UI changes needed)\n```\n\n- Min platform interval: **15 min** (free) / **1 min** (Pro) — always UTC\n- `parseDuration()` in `shared.ts` handles parsing\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\n\n**Inline URLs only** — never use `deno.json` import maps for Val Town deps.\nVal Town's runtime resolves raw URLs natively; import maps break at deploy time.\n\n```ts\n// ✅ Correct — inline URLs everywhere\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport { blob } from \"https://esm.town/v/std/blob\";\nimport { email } from \"https://esm.town/v/std/email\";\nimport { Hono } from \"npm:hono\";\nimport { z } from \"jsr:@std/zod\";\n\n// ✅ Relative imports within the val\nimport { APP_NAME } from \"./backend/shared.ts\";\n\n// ❌ Never — import maps in deno.json for external deps\n// import { sqlite } from \"@std/sqlite\";\n```\n\nAll Deno import styles work: `./relative.ts`, `npm:lodash`, `jsr:@std/zod`,\n`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",[185],"85f9d626-4951-11f1-a16a-42b51c65c3df","frontend","85f9d6f8-4951-11f1-a16a-42b51c65c3df",34,["D",1778074991402],0,"directory",[192],"86303568-4951-11f1-a193-42b51c65c3df","backend","8630361c-4951-11f1-a193-42b51c65c3df",35,["D",1778074991756],[200],"pulls","branches","forks","envVars",{"_212":65,"_214":196},"connections",{"_212":196,"_213":196},"count","unfilledCount","emptyCount",{"_44":199,"_32":200,"_30":201,"_144":-5,"_42":43,"_41":202,"_146":61,"_39":288,"_13":196,"_34":197,"_36":-5,"_24":25,"_149":-5,"_229":289,"_27":290},{"_44":279,"_32":280,"_30":281,"_144":201,"_42":43,"_41":282,"_146":25,"_39":283,"_13":284,"_34":35,"_36":285,"_24":25,"_149":-5,"_229":286,"_27":287},{"_44":274,"_32":33,"_30":31,"_144":201,"_42":43,"_41":14,"_146":25,"_39":275,"_13":276,"_34":35,"_36":38,"_24":25,"_149":-5,"_229":277,"_27":278},{"_44":266,"_32":267,"_30":268,"_144":201,"_42":43,"_41":269,"_146":25,"_39":270,"_13":156,"_34":35,"_36":271,"_24":25,"_149":-5,"_229":272,"_27":273},{"_44":191,"_32":192,"_30":193,"_144":-5,"_42":43,"_41":194,"_146":61,"_39":263,"_13":196,"_34":197,"_36":-5,"_24":25,"_149":-5,"_229":264,"_27":265},{"_44":255,"_32":256,"_30":257,"_144":193,"_42":43,"_41":258,"_146":25,"_39":259,"_13":196,"_34":20,"_36":260,"_24":25,"_149":-5,"_229":261,"_27":262},{"_44":247,"_32":248,"_30":249,"_144":193,"_42":43,"_41":250,"_146":25,"_39":251,"_13":196,"_34":35,"_36":252,"_24":25,"_149":-5,"_229":253,"_27":254},{"_44":184,"_32":185,"_30":186,"_144":-5,"_42":43,"_41":187,"_146":25,"_39":244,"_13":172,"_34":20,"_36":189,"_24":25,"_149":-5,"_229":245,"_27":246},{"_44":175,"_32":176,"_30":177,"_144":-5,"_42":43,"_41":178,"_146":25,"_39":241,"_13":180,"_34":181,"_36":182,"_24":25,"_149":-5,"_229":242,"_27":243},{"_44":167,"_32":168,"_30":169,"_144":-5,"_42":43,"_41":170,"_146":25,"_39":238,"_13":172,"_34":20,"_36":173,"_24":25,"_149":-5,"_229":239,"_27":240},{"_44":159,"_32":160,"_30":161,"_144":-5,"_42":43,"_41":162,"_146":25,"_39":235,"_13":156,"_34":164,"_36":165,"_24":25,"_149":-5,"_229":236,"_27":237},{"_44":151,"_32":152,"_30":153,"_144":-5,"_42":43,"_41":154,"_146":25,"_39":232,"_13":156,"_34":35,"_36":157,"_24":25,"_149":-5,"_229":233,"_27":234},{"_44":141,"_32":142,"_30":143,"_144":-5,"_42":43,"_41":145,"_146":25,"_39":228,"_13":65,"_34":20,"_36":148,"_24":25,"_149":-5,"_229":230,"_27":231},["D",1778080228424],"children",[],[142],["D",1778087859890],[],[152],["D",1778087859748],[],[160],["D",1778270041449],[],[168],["D",1778087860306],[],[176],["D",1778087860492],[],[185],"866c9120-4951-11f1-9e49-42b51c65c3df","main.js","866c91f2-4951-11f1-9e49-42b51c65c3df",36,["D",1778074992154],"// Fetch the visit count from our API on load\nasync function fetchVisits() {\n try {\n // Calling the API endpoint that was migrated to /api/visits\n // We will update the backend to return total count as well.\n const res = await fetch(\"/api/visits\");\n const data = await res.json();\n\n if (data.total !== undefined) {\n document.getElementById(\"visit-count\").textContent = data.total;\n }\n } catch (err) {\n console.error(\"Failed to fetch visits:\", err);\n document.getElementById(\"visit-count\").textContent = \"Error loading\";\n }\n}\n\nfetchVisits();\n",[],[192,248],"86797160-4951-11f1-bc82-42b51c65c3df","index.html","8679720a-4951-11f1-bc82-42b51c65c3df",38,["D",1778074992194],"\n\n\n \n \n uApps Starter Val\n \n\n\n

🏔️ uApps Val Town Starter

\n \n

Analytics

This val has been visited ... times.

\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

\n\n

Learn More

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

\n\n \n\n\n",[],[192,256],["D",1778074991402],[220,221],[192],"7c22e0e8-496f-11f1-a313-42b51c65c3df","storage.ts","aa15db36-48c5-11f1-8bd1-42b51c65c3df",48,["D",1778087859791],"// storage.ts — Blob storage helpers (account-scoped; namespace keys with PREFIX)\n// Docs: https://docs.val.town/reference/std/blob\n\nimport { blob } from \"https://esm.town/v/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.setJSON(`${PREFIX}${key}`, 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 data = await blob.getJSON(`${PREFIX}${key}`);\n return data !== undefined ? (data as T) : null;\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) =>\n (typeof k === \"string\" ? k : k.key).replace(PREFIX, \"\")\n );\n}\n\n/** Delete a namespaced blob. */\nexport async function remove(key: string): Promise {\n await blob.delete(`${PREFIX}${key}`);\n}\n",[],[200,267],"a8e546d0-4b17-11f1-bccd-ee650bb23af1",["D",1778270041498],4,[],[200,33],"7c5f0faa-496f-11f1-8274-42b51c65c3df","db.ts","aad2cfa2-48c5-11f1-bfb8-42b51c65c3df",51,["D",1778087860187],7,"// db.ts — SQLite helpers (Turso-backed, shared across all vals — namespace tables)\n// Docs: https://docs.val.town/reference/std/sqlite/\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\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.batch([\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 `CREATE TABLE IF NOT EXISTS template_meta (\n key TEXT PRIMARY KEY,\n value TEXT NOT NULL\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// ── Meta Key-Value ────────────────────────────────────────────────────────────\n\n/** Read a value from the `template_meta` key-value store. Returns null if missing. */\nexport async function getMetaValue(key: string): Promise {\n await migrate();\n const { rows } = await sqlite.execute({\n sql: `SELECT value FROM template_meta WHERE key = ?`,\n args: [key],\n });\n return rows[0] ? String(rows[0][0]) : null;\n}\n\n/** Write (upsert) a value into the `template_meta` key-value store. */\nexport async function setMetaValue(key: string, value: string): Promise {\n await migrate();\n await sqlite.execute({\n sql: `INSERT OR REPLACE INTO template_meta (key, value) VALUES (?, ?)`,\n args: [key, value],\n });\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 as unknown as unknown[][]).map((r) => ({\n id: Number(r[0]),\n path: String(r[1]),\n ts: String(r[2]),\n }));\n}\n",[],[200,280],["D",1778074991756],[216,217,218],[200],["D",1777994172310],["D",1789511441255],{"_102":101,"_110":106},{"_102":101,"_103":104,"_105":106,"_18":57,"_107":108,"_109":25},{"_13":91,"_32":92,"_44":43,"_93":45,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":-5,"_99":46,"_100":101},"ctx",{"_84":-5,"_130":329,"_330":331,"_332":333,"_334":25,"_335":25,"_336":25,"_337":61,"_338":-5,"_339":-7,"_340":-7,"_341":196,"_342":25,"_343":25,"_344":-5,"_345":25,"_346":25,"_347":25,"_348":-5},"ENV",{"_300":301,"_302":303,"_304":92,"_305":306,"_307":308,"_309":310,"_311":312,"_313":314,"_315":316,"_317":318,"_319":320,"_321":322,"_323":324,"_325":326,"_327":328},"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 · v56