[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_290":291,"_292":293},"routes/_app.x.$handle.$name",{"_99":98,"_32":44,"_108":89,"_27":109,"_13":14,"_110":-5,"_11":111,"_112":113,"_114":115,"_116":117,"_118":119,"_20":-5,"_120":-5,"_121":-5,"_122":26,"_123":124,"_125":26,"_126":-5,"_127":-5,"_128":129},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_42":43,"_32":44,"_37":45,"_46":-5,"_47":26,"_48":49,"_50":49,"_51":52,"_53":54,"_18":55,"_56":57,"_58":24,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":82,"_83":84,"_85":86,"_87":26},"version",38,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":26,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":20,"_35":36,"_37":38,"_39":14,"_40":41,"_23":26},"previous","deleted",true,"deletedHere",false,"path","frontend/index.html","latestPath","fileId","8679720a-4951-11f1-bc82-42b51c65c3df","name","index.html","fileType","content","\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","createdAt",["D",1778074992194],"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=1789549199&sig=4f04f60d95727a9894033a79d182f33a07c735c785db802252e7ee188e97a607","173e7424-8658-428f-a3bc-ae4faeaabd1c","pinnedFileId","e1c705aa-4b18-11f1-b4ae-ee650bb23af1","pinPreview","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",{"_99":98,"_107":103},"org",{"_99":98,"_100":101,"_102":103,"_18":55,"_104":105,"_106":26},"branch",{"_13":88,"_32":89,"_42":41,"_90":43,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":44,"_97":98},"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=1789549199&sig=9503fba6bcb20febc2a8328fccf68da2ad84e9012958b4d71ae2e174a03baa7f","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_42":43,"_32":44,"_37":285,"_46":-5,"_47":26,"_48":49,"_50":49,"_51":52,"_53":54,"_18":55,"_56":57,"_58":24,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68,"_69":286,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":287,"_83":288,"_85":289,"_87":26},"tree",[210,212,215,218,219,220,221,222],"files",[210,211,212,213,214,215,216,217,218,219,220,221,222],"counts",{"_200":145,"_201":62,"_202":62,"_203":204,"_205":206},"contents",[130,131,132,133,134,135,136,137],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_42":194,"_32":195,"_30":196,"_141":-5,"_40":41,"_39":197,"_143":24,"_37":198,"_13":145,"_34":186,"_35":-5,"_23":26,"_147":-5,"_27":199},{"_42":188,"_32":189,"_30":190,"_141":-5,"_40":41,"_39":191,"_143":24,"_37":192,"_13":145,"_34":186,"_35":-5,"_23":26,"_147":-5,"_27":193},{"_42":181,"_32":182,"_30":183,"_141":-5,"_40":41,"_39":184,"_143":26,"_37":185,"_13":145,"_34":186,"_35":-5,"_23":26,"_147":-5,"_27":187},{"_42":174,"_32":175,"_30":176,"_141":-5,"_40":41,"_39":177,"_143":26,"_37":178,"_13":62,"_34":20,"_35":179,"_23":26,"_147":-5,"_27":180},{"_42":166,"_32":167,"_30":168,"_141":-5,"_40":41,"_39":169,"_143":26,"_37":170,"_13":62,"_34":171,"_35":172,"_23":26,"_147":-5,"_27":173},{"_42":158,"_32":159,"_30":160,"_141":-5,"_40":41,"_39":161,"_143":26,"_37":162,"_13":154,"_34":163,"_35":164,"_23":26,"_147":-5,"_27":165},{"_42":149,"_32":150,"_30":151,"_141":-5,"_40":41,"_39":152,"_143":26,"_37":153,"_13":154,"_34":155,"_35":156,"_23":26,"_147":-5,"_27":157},{"_42":138,"_32":139,"_30":140,"_141":-5,"_40":41,"_39":142,"_143":26,"_37":144,"_13":145,"_34":20,"_35":146,"_23":26,"_147":-5,"_27":148},"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",[139],"dcf15016-494d-11f1-9a0b-42b51c65c3df","index.ts","5ae332be-4895-11f1-a469-42b51c65c3df",30,["D",1778073419313],3,"script","// ─────────────────────────────────────────────────────────────────────────────\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 \"./lib/db.ts\";\nimport { APP_NAME, html } from \"./lib/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 // DB calls are wrapped in try/catch so the page still renders when\n // running locally (off Val Town) where SQLite isn't available.\n if (pathname === \"/\" || pathname === \"\") {\n let count = 0;\n try {\n await recordVisit(\"/\");\n count = await getVisitCount();\n } catch {\n // SQLite not available (running locally)\n }\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 try {\n const { getRecentVisits } = await import(\"./lib/db.ts\");\n const visits = await getRecentVisits(20);\n return Response.json({ visits });\n } catch {\n return Response.json({ error: \"SQLite not available (running off-platform?)\" }, { status: 503 });\n }\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",[150],"dd153d32-494d-11f1-8f36-42b51c65c3df","email.ts","aa7742d6-48c5-11f1-831b-42b51c65c3df",33,["D",1778073418908],"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 \"https://esm.town/v/std/email\";\nimport type { InboundEmail } from \"./lib/shared.ts\";\nimport { APP_NAME } from \"./lib/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 */\n// deno-lint-ignore require-await\nexport default async function emailHandler(\n inbound: InboundEmail,\n): Promise {\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",[159],"dcafe662-494d-11f1-b9e7-42b51c65c3df","cron.ts","aa651980-48c5-11f1-bfb8-42b51c65c3df",26,["D",1778073418887],"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 \"./lib/shared.ts\";\nimport { APP_NAME } from \"./lib/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",[167],"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",[175],"dc75c87e-494d-11f1-b9e7-42b51c65c3df","lib","dc75c91e-494d-11f1-b9e7-42b51c65c3df",25,["D",1778073418511],"directory",[182],"85f9d626-4951-11f1-a16a-42b51c65c3df","frontend","85f9d6f8-4951-11f1-a16a-42b51c65c3df",34,["D",1778074991402],[189],"86303568-4951-11f1-a193-42b51c65c3df","backend","8630361c-4951-11f1-a193-42b51c65c3df",35,["D",1778074991756],[195],"pulls","branches","forks","envVars",{"_207":62,"_209":145},"connections",{"_207":145,"_208":145},"count","unfilledCount","emptyCount",{"_42":194,"_32":195,"_30":196,"_141":-5,"_40":41,"_39":197,"_143":24,"_37":282,"_13":145,"_34":186,"_35":-5,"_23":26,"_147":-5,"_224":283,"_27":284},{"_42":273,"_32":274,"_30":275,"_141":196,"_40":41,"_39":276,"_143":26,"_37":277,"_13":278,"_34":155,"_35":279,"_23":26,"_147":-5,"_224":280,"_27":281},{"_42":188,"_32":189,"_30":190,"_141":-5,"_40":41,"_39":191,"_143":24,"_37":270,"_13":145,"_34":186,"_35":-5,"_23":26,"_147":-5,"_224":271,"_27":272},{"_42":266,"_32":33,"_30":31,"_141":190,"_40":41,"_39":14,"_143":26,"_37":267,"_13":145,"_34":20,"_35":36,"_23":26,"_147":-5,"_224":268,"_27":269},{"_42":258,"_32":259,"_30":260,"_141":190,"_40":41,"_39":261,"_143":26,"_37":262,"_13":145,"_34":155,"_35":263,"_23":26,"_147":-5,"_224":264,"_27":265},{"_42":181,"_32":182,"_30":183,"_141":-5,"_40":41,"_39":184,"_143":26,"_37":255,"_13":145,"_34":186,"_35":-5,"_23":26,"_147":-5,"_224":256,"_27":257},{"_42":247,"_32":248,"_30":249,"_141":183,"_40":41,"_39":250,"_143":26,"_37":251,"_13":142,"_34":155,"_35":252,"_23":26,"_147":-5,"_224":253,"_27":254},{"_42":239,"_32":240,"_30":241,"_141":183,"_40":41,"_39":242,"_143":26,"_37":243,"_13":62,"_34":155,"_35":244,"_23":26,"_147":-5,"_224":245,"_27":246},{"_42":174,"_32":175,"_30":176,"_141":-5,"_40":41,"_39":177,"_143":26,"_37":236,"_13":62,"_34":20,"_35":179,"_23":26,"_147":-5,"_224":237,"_27":238},{"_42":166,"_32":167,"_30":168,"_141":-5,"_40":41,"_39":169,"_143":26,"_37":233,"_13":62,"_34":171,"_35":172,"_23":26,"_147":-5,"_224":234,"_27":235},{"_42":158,"_32":159,"_30":160,"_141":-5,"_40":41,"_39":161,"_143":26,"_37":230,"_13":154,"_34":163,"_35":164,"_23":26,"_147":-5,"_224":231,"_27":232},{"_42":149,"_32":150,"_30":151,"_141":-5,"_40":41,"_39":152,"_143":26,"_37":227,"_13":154,"_34":155,"_35":156,"_23":26,"_147":-5,"_224":228,"_27":229},{"_42":138,"_32":139,"_30":140,"_141":-5,"_40":41,"_39":142,"_143":26,"_37":223,"_13":145,"_34":20,"_35":146,"_23":26,"_147":-5,"_224":225,"_27":226},["D",1778014923050],"children",[],[139],["D",1778073419313],[],[150],["D",1778073418908],[],[159],["D",1778073418887],[],[167],["D",1778053013652],[],[175],"dcc7160c-494d-11f1-9cb0-42b51c65c3df","shared.ts","aada9642-48c5-11f1-b1d7-42b51c65c3df",28,["D",1778073418941],"// ─────────────────────────────────────────────────────────────────────────────\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",[],[182,240],"dce33756-494d-11f1-9738-42b51c65c3df","db.ts","aad2cfa2-48c5-11f1-bfb8-42b51c65c3df",29,["D",1778073418897],"// ─────────────────────────────────────────────────────────────────────────────\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 val-scoped DB: import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\"\n// • Import legacy global: import { sqlite } from \"https://esm.town/v/std/sqlite/global.ts\"\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 \"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.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 as unknown as unknown[][]).map((r) => ({\n id: Number(r[0]),\n path: String(r[1]),\n ts: String(r[2]),\n }));\n}\n",[],[182,248],["D",1778073418511],[216,217],[182],"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",[],[189,259],"86797160-4951-11f1-bc82-42b51c65c3df",["D",1778074992194],[],[189,33],["D",1778074991402],[213,214],[189],"86739092-4951-11f1-b6e3-42b51c65c3df","storage.ts","aa15db36-48c5-11f1-8bd1-42b51c65c3df",37,["D",1778074992189],4,"// ─────────────────────────────────────────────────────────────────────────────\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 \"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",[],[195,274],["D",1778074991756],[211],[195],["D",1777994172310],["D",1789511441255],{"_99":98,"_107":103},{"_99":98,"_100":101,"_102":103,"_18":55,"_104":105,"_106":26},{"_13":88,"_32":89,"_42":41,"_90":43,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":44,"_97":98},"ctx",{"_81":-5,"_127":323,"_324":325,"_326":327,"_328":26,"_329":26,"_330":26,"_331":24,"_332":-5,"_333":-7,"_334":-7,"_335":145,"_336":26,"_337":26,"_338":-5,"_339":26,"_340":26,"_341":26,"_342":-5},"ENV",{"_294":295,"_296":297,"_298":89,"_299":300,"_301":302,"_303":304,"_305":306,"_307":308,"_309":310,"_311":312,"_313":314,"_315":316,"_317":318,"_319":320,"_321":322},"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 · v38