[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_334":335,"_336":337},"routes/_app.x.$handle.$name",{"_100":99,"_32":45,"_109":90,"_27":110,"_13":14,"_111":-5,"_11":112,"_113":114,"_115":116,"_117":118,"_119":120,"_20":-5,"_121":-5,"_122":-5,"_123":26,"_124":125,"_126":24,"_127":-5,"_128":-5,"_129":130},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":26,"_49":50,"_51":50,"_52":53,"_54":55,"_18":56,"_57":58,"_59":24,"_60":-5,"_61":-5,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":83,"_84":85,"_86":87,"_88":26},"version",84,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":26,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":37,"_38":39,"_40":14,"_41":42,"_23":26},"previous","deleted",true,"deletedHere",false,"path","frontend/ui/data.ts","latestPath","fileId","48c092be-4b21-11f1-81f8-ee650bb23af1","name","data.ts","fileType","script","content","// data.ts — Static copy for the landing page.\n\nimport type { FeatureItem, RouteItem } from \"./types.ts\";\n\nexport const routes: RouteItem[] = [\n { method: \"GET\", path: \"/\", purpose: \"Preact SSR explainer UI\" },\n { method: \"GET\", path: \"/api/health\", purpose: \"Runtime health check\" },\n { method: \"GET\", path: \"/api/visits\", purpose: \"SQLite visit counter\" },\n { method: \"POST\", path: \"/api/echo\", purpose: \"JSON request smoke test\" },\n {\n method: \"POST\",\n path: \"/api/email-test\",\n purpose: \"Outbound email smoke test\",\n },\n {\n method: \"POST\",\n path: \"/api/email-test/inbound\",\n purpose: \"Inbound simulation\",\n },\n {\n method: \"POST\",\n path: \"/api/openai-test\",\n purpose: \"Val Town OpenAI proxy\",\n },\n];\n\nexport const features: FeatureItem[] = [\n {\n title: \"HTTP\",\n icon: \"🌐\",\n body: [\n \"index.http.ts routes API calls and renders this page.\",\n \"Root HTML is server-rendered by frontend/app.tsx.\",\n ],\n },\n {\n title: \"Frontend\",\n icon: \"🎨\",\n body: [\n \"Preact produces semantic HTML; Oat provides class-light styling.\",\n \"frontend/client.ts inlines form and theme enhancements.\",\n ],\n },\n {\n title: \"Storage\",\n icon: \"🗄️\",\n body: [\n \"SQLite tracks visits and cron timestamps.\",\n \"Blob helpers show namespaced account-scoped storage.\",\n ],\n },\n {\n title: \"Triggers\",\n icon: \"⚡\",\n body: [\n \"cron.ts runs interval work; email.ts handles inbound mail.\",\n \"New file types are inferred from path words: http, cron, email.\",\n ],\n },\n];\n","createdAt",["D",1778274175113],"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=1789570799&sig=b7eb00a7e6c6b06e7af87aab4b8e4ff74a912555cf5b6b3dc17eb0ffddcb9afd","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",{"_100":99,"_108":104},"org",{"_100":99,"_101":102,"_103":104,"_18":56,"_105":106,"_107":26},"branch",{"_13":89,"_32":90,"_43":42,"_91":44,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":45,"_98":99},"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=1789570799&sig=8d9ccf98a8cb1fff9e75a2e5ebf491759a9d59ae778396b8883ada54ff88ff15","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":329,"_47":-5,"_48":26,"_49":50,"_51":50,"_52":53,"_54":55,"_18":56,"_57":58,"_59":24,"_60":-5,"_61":-5,"_62":63,"_64":65,"_66":67,"_68":69,"_70":330,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":331,"_84":332,"_86":333,"_88":26},"tree",[224,228,234,235,236,237,238,239,240],"files",[224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240],"counts",{"_214":205,"_215":63,"_216":63,"_217":218,"_219":220},"contents",[131,132,133,134,135,136,137,138,139],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_43":208,"_32":209,"_30":210,"_143":-5,"_41":42,"_40":211,"_145":24,"_38":212,"_13":205,"_34":206,"_36":-5,"_23":26,"_148":-5,"_27":213},{"_43":200,"_32":201,"_30":202,"_143":-5,"_41":42,"_40":203,"_145":24,"_38":204,"_13":205,"_34":206,"_36":-5,"_23":26,"_148":-5,"_27":207},{"_43":192,"_32":193,"_30":194,"_143":-5,"_41":42,"_40":195,"_145":26,"_38":196,"_13":197,"_34":20,"_36":198,"_23":26,"_148":-5,"_27":199},{"_43":184,"_32":185,"_30":186,"_143":-5,"_41":42,"_40":187,"_145":26,"_38":188,"_13":162,"_34":189,"_36":190,"_23":26,"_148":-5,"_27":191},{"_43":176,"_32":177,"_30":178,"_143":-5,"_41":42,"_40":179,"_145":26,"_38":180,"_13":181,"_34":20,"_36":182,"_23":26,"_148":-5,"_27":183},{"_43":167,"_32":168,"_30":169,"_143":-5,"_41":42,"_40":170,"_145":26,"_38":171,"_13":172,"_34":173,"_36":174,"_23":26,"_148":-5,"_27":175},{"_43":158,"_32":159,"_30":58,"_143":-5,"_41":42,"_40":160,"_145":26,"_38":161,"_13":162,"_34":163,"_36":164,"_23":26,"_148":165,"_27":166},{"_43":150,"_32":151,"_30":152,"_143":-5,"_41":42,"_40":153,"_145":26,"_38":154,"_13":155,"_34":35,"_36":156,"_23":26,"_148":-5,"_27":157},{"_43":140,"_32":141,"_30":142,"_143":-5,"_41":42,"_40":144,"_145":26,"_38":146,"_13":63,"_34":20,"_36":147,"_23":26,"_148":-5,"_27":149},"b77e2f4c-495d-11f1-84af-42b51c65c3df","val.yml","aa729402-48c5-11f1-87ca-42b51c65c3df","parentId",46,"latest",["D",1778080228424],"name: \"sample-val\"\npublic: true\n","label",[141],"94169bf4-4b18-11f1-976a-ee650bb23af1","index.ts","5ae332be-4895-11f1-a469-42b51c65c3df",76,["D",1778270436076],7,"// 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 { getRecentVisits, 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 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",[151],"eff9b938-4b18-11f1-b94f-ee650bb23af1","index.http.ts",81,["D",1778270590244],4,"http","// 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 { getRecentVisits, 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 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}","d-template",[159],"a8f819e0-4b17-11f1-9c61-ee650bb23af1","email.ts","aa7742d6-48c5-11f1-831b-42b51c65c3df",58,["D",1778270041516],6,"email","// email.ts — Inbound handler + outbound helpers. UI: + → EMAIL → address: .@valtown.email\n\nimport { email as sendEmail } from \"https://esm.town/v/std/email\";\nimport { APP_NAME, type Email } from \"./backend/shared.ts\";\n\n// ── Inbound ───────────────────────────────────────────────────────────────────\n\nexport default async function emailHandler(inbound: Email): 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: sends to yourself only. 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",[168],"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",[177],"a92b239e-4b17-11f1-a377-ee650bb23af1","cron.ts","aa651980-48c5-11f1-bfb8-42b51c65c3df",60,["D",1778270041959],"interval","// cron.ts — Two tasks (pulse + maintenance), one trigger. UI: + → CRON → \"every 5 minutes\"\n// Env: CRON_PULSE_INTERVAL (\"5m\"/\"1h\"/\"DISABLED\"), CRON_MAINTENANCE_INTERVAL (\"1h\"/\"1d\"/\"DISABLED\")\n\nimport { APP_NAME, env, parseDuration } from \"./backend/shared.ts\";\nimport { getMetaValue, pruneOldVisits, setMetaValue } from \"./backend/db.ts\";\n\n// ── Gate: true if intervalMs has elapsed since last run; records now in SQLite ──\n\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 (\n _interval: { lastRunAt: Date | undefined },\n): Promise {\n const now = new Date();\n await pulse(now);\n await maintenance(now);\n}\n\n// ── Pulse — polling, health-checks, work-queues ───────────────────────────────\n\nasync function pulse(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 // TODO: add your polling/health-check logic here\n // const res = await fetch(\"https://api.example.com/feed\");\n}\n\n// ── Maintenance — prune, archive, digest ─────────────────────────────────────\n\nasync function maintenance(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 await pruneOldVisits(30);\n console.log(`✅ [${APP_NAME}] Maintenance done`);\n}\n",[185],"a948f0ea-4b17-11f1-b038-ee650bb23af1","README.md","aabf7b64-48c5-11f1-9920-42b51c65c3df",61,["D",1778270041957],3,"# Val Town Template\n\nStarter val with HTTP, Cron, Email, SQLite, and Blob. Fork it, delete what you\ndon't need.\n\n---\n\n## High-Level Architecture\n\n```mermaid\ngraph TB\n subgraph VAL[\"val: sample-val\"]\n direction TB\n SHARED[\"backend/shared.ts
constants · env() · parseDuration()\"]\n\n subgraph TRIGGERS[\"Triggers\"]\n HTTP[\"index.http.ts
🟦 HTTP\"]\n CRON[\"cron.ts
🟪 Cron\"]\n EMAIL[\"email.ts
🟧 Email\"]\n end\n\n subgraph STORAGE[\"Storage\"]\n DB[\"backend/db.ts
SQLite\"]\n BLOB[\"backend/storage.ts
Blob (R2)\"]\n end\n\n subgraph FRONTEND[\"Frontend\"]\n HTML[\"frontend/index.html\"]\n JS[\"frontend/main.js\"]\n end\n end\n\n SHARED --> HTTP\n SHARED --> CRON\n SHARED --> EMAIL\n\n HTTP -->|\"serveFile()\"| HTML\n HTTP -->|\"serveFile()\"| JS\n HTTP -->|\"recordVisit()\"| DB\n HTTP -->|\"queries\"| DB\n\n CRON -->|\"prune / meta\"| DB\n CRON -->|\"read/write\"| BLOB\n\n EMAIL -->|\"save attachments\"| BLOB\n\n USER[\"🌐 User / Browser\"] -->|\"GET /\"| HTTP\n USER -->|\"GET /api/*\"| HTTP\n SCHEDULER[\"⏰ Scheduler\"] -->|\"every 5m\"| CRON\n SENDER[\"📧 Email Sender\"] -->|\"inbound\"| EMAIL\n```\n\n---\n\n## Quick Start\n\n**1. Create a new val from this template**\n\n```bash\ncd /path/to/uApps\nvt new my-app\ncd vals/my-app\n```\n\n**2. Push it to Val Town**\n\n```bash\nvt push\n# or: vt watch (auto-push on save)\n```\n\n> **Important:** `vt push` auto-detects triggers from filenames (e.g.,\n> `index.http.ts` → HTTP, `cron.ts` → Cron, `email.ts` → Email). If triggers\n> don't appear on the Val Town platform after pushing, manually add them via the\n> `+` button in the val editor. Then point each trigger at its file.\n\n**3. Open it in your browser**\n\n```bash\nvt url # prints your live URL\n```\n\nVisit the URL → you should see the starter page with a visit counter.\n\n**4. Try the API**\n\n```\nGET /api/health → JSON health check\nGET /api/visits → visit history from SQLite\nPOST /api/echo → echoes your JSON body back\n```\n\n---\n\n## HTTP Trigger (`index.http.ts`)\n\n```mermaid\nsequenceDiagram\n actor User\n participant HTTP as index.http.ts\n participant Frontend as frontend/\n participant DB as backend/db.ts\n\n User->>HTTP: GET /\n HTTP->>DB: recordVisit(\"/\")\n HTTP->>Frontend: serveFile(\"/frontend/index.html\")\n Frontend-->>User: HTML + visit counter\n\n User->>HTTP: GET /api/visits\n HTTP->>DB: getRecentVisits(20)\n HTTP->>DB: getVisitCount()\n DB-->>HTTP: rows\n HTTP-->>User: { total, visits }\n\n User->>HTTP: POST /api/echo\n HTTP-->>User: { echo: body, receivedAt }\n```\n\nRoute dispatch via `if/else` path matching — no framework needed:\n\n| Route | Method | What it does |\n|-------|--------|-------------|\n| `/` | GET | Serves `frontend/index.html`, records visit |\n| `/frontend/*` | GET | Serves static files from `frontend/` |\n| `/api/health` | GET | JSON health check |\n| `/api/visits` | GET | Recent visits + total count from SQLite |\n| `/api/echo` | POST | Echoes request body back |\n| `*` | any | 404 JSON |\n\n---\n\n## Cron Trigger (`cron.ts`)\n\n```mermaid\nflowchart LR\n subgraph CRON[\"cron.ts — runs every 5 min\"]\n direction TB\n ENTRY[\"export default()\"] --> PULSE[\"pulse()\"]\n ENTRY --> MAINT[\"maintenance()\"]\n\n PULSE -->|\"shouldRun()\"| P_GATE{\"Interval elapsed?\"}\n P_GATE -->|\"yes\"| P_WORK[\"⚡ Pulse task
(polling / health-checks)\"]\n P_GATE -->|\"no\"| P_SKIP[\"skip\"]\n\n MAINT -->|\"shouldRun()\"| M_GATE{\"Interval elapsed?\"}\n M_GATE -->|\"yes\"| M_WORK[\"🔧 Maintenance
(prune old visits)\"]\n M_GATE -->|\"no\"| M_SKIP[\"skip\"]\n end\n\n P_WORK --> DB[(SQLite)]\n M_WORK --> DB\n```\n\nTwo independent tasks, one trigger. Each gates itself via `shouldRun()` which\nstores last-run timestamps in SQLite.\n\n| Task | Default interval | Env var to control |\n|------|-----------------|--------------------|\n| Pulse | Every 5 min | `CRON_PULSE_INTERVAL` (`\"5m\"`, `\"1h\"`, `\"DISABLED\"`) |\n| Maintenance | Every 1 day | `CRON_MAINTENANCE_INTERVAL` (`\"1d\"`, `\"6h\"`, `\"DISABLED\"`) |\n\n---\n\n## Email Trigger (`email.ts`)\n\n```mermaid\nflowchart TB\n INBOUND[\"📧 Inbound email
.@valtown.email\"] --> HANDLER[\"emailHandler()\"]\n HANDLER --> LOG[\"log subject + body\"]\n HANDLER --> ATTACH[\"process attachments\"]\n\n subgraph OUTBOUND[\"Outbound helpers\"]\n NOTIFY[\"sendNotification()\"]\n ATTACH_SEND[\"sendWithAttachment()\"]\n end\n\n HANDLER -.->|\"optional: reply\"| NOTIFY\n ATTACH --> BLOB[(\"Blob Store\")]\n```\n\nTwo parts in one file:\n\n**Inbound** — `export default async function emailHandler(inbound)` handles\nincoming mail. Logs subject/body, saves attachments to Blob.\n\n**Outbound** — exported helper functions for sending email programmatically:\n- `sendNotification(subject, body, opts?)` — plain text email\n- `sendWithAttachment(subject, body, attachment)` — with base64 attachment\n\n> **Free plan:** outbound sends to yourself only. **Pro:** send to anyone.\n\n---\n\n## SQLite (`backend/db.ts`)\n\n```mermaid\nerDiagram\n VISITS {\n int id PK\n text page\n timestamp created_at\n }\n META {\n text key PK\n text value\n }\n```\n\nTwo tables, auto-migrated on first use:\n\n| Table | Purpose |\n|-------|---------|\n| `visits` | Page visit log — each HTTP request to `/` inserts a row |\n| `meta` | Key-value store — cron uses it for `last_run` timestamps |\n\nKey functions:\n- `recordVisit(page)` — insert a visit\n- `getRecentVisits(limit)` — latest N visits\n- `getVisitCount()` — total rows in `visits`\n- `getMetaValue(key)` / `setMetaValue(key, value)` — KV read/write\n- `pruneOldVisits(days)` — delete visits older than N days\n\n**Gotcha:** SQLite is per-val. Use the `/main.ts` import path (val-scoped), not\n`/dummy.ts` (shared).\n\n---\n\n## Blob Storage (`backend/storage.ts`)\n\n```mermaid\nflowchart LR\n subgraph BLOB[\"Account-scoped Blob (Cloudflare R2)\"]\n direction TB\n SET[\"blob.set(key, value)\"]\n GET[\"blob.get(key)\"]\n LIST[\"blob.list()\"]\n DEL[\"blob.delete(key)\"]\n end\n\n APP[\"any val in account\"] --> SET\n APP --> GET\n APP --> LIST\n APP --> DEL\n```\n\nShared across **all vals** in your account. Good for cross-val state, config,\nfile uploads.\n\nKey functions:\n- `saveJSON(key, data)` / `getJSON(key)` — typed JSON storage\n- `saveText(key, text)` — plain text\n- `listBlobs()` — all keys\n- `deleteBlob(key)` — remove\n\n> **Warning:** Blob is account-scoped. Key collisions across vals are possible\n> — use namespaced keys like `emails/`, `config/`, etc.\n\n---\n\n## Shared (`backend/shared.ts`)\n\nLayer 0 — every other file depends on this. Zero dependencies itself.\n\n| Export | Purpose |\n|--------|---------|\n| `APP_NAME` | App name constant (change this to rename your app) |\n| `Email` type | Inbound email shape (`from`, `to`, `subject`, `text`, `html`, `attachments`) |\n| `env(key, fallback)` | Read env vars with a default fallback |\n| `parseDuration(raw)` | Parse `\"5m\"`, `\"1h\"`, `\"1d\"` → milliseconds |\n\n---\n\n## Layering\n\n```mermaid\ngraph BT\n subgraph \"Layer 2 — Triggers\"\n HTTP[\"index.http.ts\"]\n CRON[\"cron.ts\"]\n EMAIL[\"email.ts\"]\n end\n\n subgraph \"Layer 1 — Backend\"\n DB[\"backend/db.ts\"]\n BLOB[\"backend/storage.ts\"]\n end\n\n subgraph \"Layer 0 — Foundation\"\n SHARED[\"backend/shared.ts\"]\n end\n\n HTTP --> DB\n HTTP --> BLOB\n HTTP --> SHARED\n CRON --> DB\n CRON --> BLOB\n CRON --> SHARED\n EMAIL --> BLOB\n EMAIL --> SHARED\n DB --> SHARED\n```\n\nEvery file depends only on lower layers. You can delete any trigger or backend\nmodule without breaking the rest — except `shared.ts`, which everything depends\non.\n\n---\n\n## Customize\n\n**Rename the app** — change `APP_NAME` in `backend/shared.ts`.\n\n**Add a route** — add a new `if (pathname === \"/api/thing\")` block in\n`index.http.ts`.\n\n**Add a SQLite table** — add a `CREATE TABLE IF NOT EXISTS` call in\n`db.ts → migrate()`.\n\n**Change visibility** — edit `val.yml`:\n\n```yaml\nname: \"my-app\"\npublic: false # true | false\norg: \"uapps\" # your org, or omit for personal\n```\n\n**Sync** — `vt push` / `vt pull` / `vt status`\n\n---\n\n## Key Files\n\n| File | Purpose |\n|------|---------|\n| `index.http.ts` | HTTP handler — routes, JSON API, static frontend |\n| `cron.ts` | Two scheduled tasks (pulse + maintenance) |\n| `email.ts` | Inbound email handler + outbound send helpers |\n| `backend/db.ts` | SQLite schema, queries, migration |\n| `backend/storage.ts` | Blob storage read/write/list/delete |\n| `backend/shared.ts` | Constants, `env()`, `parseDuration()`, `Email` type |\n| `frontend/index.html` | Landing page |\n| `frontend/main.js` | Fetches visit count from `/api/visits` |\n| `val.yml` | Val name, visibility, org |\n",[193],"85f9d626-4951-11f1-a16a-42b51c65c3df","frontend","85f9d6f8-4951-11f1-a16a-42b51c65c3df",34,["D",1778074991402],0,"directory",[201],"86303568-4951-11f1-a193-42b51c65c3df","backend","8630361c-4951-11f1-a193-42b51c65c3df",35,["D",1778074991756],[209],"pulls","branches","forks","envVars",{"_221":63,"_223":205},"connections",{"_221":205,"_222":205},"count","unfilledCount","emptyCount",{"_43":208,"_32":209,"_30":210,"_143":-5,"_41":42,"_40":211,"_145":24,"_38":326,"_13":205,"_34":206,"_36":-5,"_23":26,"_148":-5,"_242":327,"_27":328},{"_43":317,"_32":318,"_30":319,"_143":210,"_41":42,"_40":320,"_145":26,"_38":321,"_13":322,"_34":35,"_36":323,"_23":26,"_148":-5,"_242":324,"_27":325},{"_43":309,"_32":310,"_30":311,"_143":210,"_41":42,"_40":312,"_145":26,"_38":313,"_13":162,"_34":35,"_36":314,"_23":26,"_148":-5,"_242":315,"_27":316},{"_43":301,"_32":302,"_30":303,"_143":210,"_41":42,"_40":304,"_145":26,"_38":305,"_13":172,"_34":35,"_36":306,"_23":26,"_148":-5,"_242":307,"_27":308},{"_43":200,"_32":201,"_30":202,"_143":-5,"_41":42,"_40":203,"_145":24,"_38":298,"_13":205,"_34":206,"_36":-5,"_23":26,"_148":-5,"_242":299,"_27":300},{"_43":293,"_32":288,"_30":282,"_143":202,"_41":42,"_40":294,"_145":26,"_38":295,"_13":205,"_34":206,"_36":-5,"_23":26,"_148":-5,"_242":296,"_27":297},{"_43":289,"_32":33,"_30":31,"_143":282,"_41":42,"_40":14,"_145":26,"_38":290,"_13":205,"_34":35,"_36":37,"_23":26,"_148":-5,"_242":291,"_27":292},{"_43":279,"_32":280,"_30":281,"_143":282,"_41":42,"_40":283,"_145":26,"_38":284,"_13":205,"_34":35,"_36":285,"_23":26,"_148":-5,"_242":286,"_27":287},{"_43":271,"_32":272,"_30":273,"_143":202,"_41":42,"_40":274,"_145":26,"_38":275,"_13":205,"_34":20,"_36":276,"_23":26,"_148":-5,"_242":277,"_27":278},{"_43":263,"_32":264,"_30":265,"_143":202,"_41":42,"_40":266,"_145":26,"_38":267,"_13":63,"_34":35,"_36":268,"_23":26,"_148":-5,"_242":269,"_27":270},{"_43":192,"_32":193,"_30":194,"_143":-5,"_41":42,"_40":195,"_145":26,"_38":260,"_13":197,"_34":20,"_36":198,"_23":26,"_148":-5,"_242":261,"_27":262},{"_43":184,"_32":185,"_30":186,"_143":-5,"_41":42,"_40":187,"_145":26,"_38":257,"_13":162,"_34":189,"_36":190,"_23":26,"_148":-5,"_242":258,"_27":259},{"_43":176,"_32":177,"_30":178,"_143":-5,"_41":42,"_40":179,"_145":26,"_38":254,"_13":181,"_34":20,"_36":182,"_23":26,"_148":-5,"_242":255,"_27":256},{"_43":167,"_32":168,"_30":169,"_143":-5,"_41":42,"_40":170,"_145":26,"_38":251,"_13":172,"_34":173,"_36":174,"_23":26,"_148":-5,"_242":252,"_27":253},{"_43":158,"_32":159,"_30":58,"_143":-5,"_41":42,"_40":160,"_145":26,"_38":248,"_13":162,"_34":163,"_36":164,"_23":26,"_148":165,"_242":249,"_27":250},{"_43":150,"_32":151,"_30":152,"_143":-5,"_41":42,"_40":153,"_145":26,"_38":245,"_13":155,"_34":35,"_36":156,"_23":26,"_148":-5,"_242":246,"_27":247},{"_43":140,"_32":141,"_30":142,"_143":-5,"_41":42,"_40":144,"_145":26,"_38":241,"_13":63,"_34":20,"_36":147,"_23":26,"_148":-5,"_242":243,"_27":244},["D",1778080228424],"children",[],[141],["D",1778270436076],[],[151],["D",1778270590244],[],[159],["D",1778270041516],[],[168],["D",1778270041449],[],[177],["D",1778270041959],[],[185],["D",1778270041957],[],[193],"a997587a-4b17-11f1-8616-ee650bb23af1","main.js","866c91f2-4951-11f1-9e49-42b51c65c3df",63,["D",1778270042020],"// Fetch visit stats from the API and update the page\nasync function fetchVisits() {\n try {\n const res = await fetch(\"/api/visits\");\n const data = await res.json();\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 = \"—\";\n }\n}\n\nfetchVisits();\n",[],[201,264],"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",[],[201,272],"48ba5714-4b21-11f1-b54f-ee650bb23af1","types.ts","48ba57fa-4b21-11f1-b54f-ee650bb23af1","4888d3e2-4b21-11f1-81f8-ee650bb23af1",83,["D",1778274175126],"// types.ts — Shared Preact UI data contracts.\n\nexport interface HomePageProps {\n appName: string;\n emailEnabled: boolean;\n openAiEnabled: boolean;\n hasTestSecret: boolean;\n openAiModel: string;\n renderedAt: string;\n}\n\nexport interface RouteItem {\n method: string;\n path: string;\n purpose: string;\n}\n\nexport interface FeatureItem {\n title: string;\n icon: string;\n body: string[];\n}\n",[],[201,288,280],"ui","48c09214-4b21-11f1-81f8-ee650bb23af1",["D",1778274175113],[],[201,288,33],"4888d338-4b21-11f1-81f8-ee650bb23af1",82,["D",1778274174805],[230,231],[201,288],["D",1778074991402],[229,232,233],[201],"a8f09454-4b17-11f1-b625-ee650bb23af1","storage.ts","aa15db36-48c5-11f1-8bd1-42b51c65c3df",57,["D",1778270041461],"// 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 }) => 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",[],[209,302],"a8e546d0-4b17-11f1-bccd-ee650bb23af1","shared.ts","aada9642-48c5-11f1-b1d7-42b51c65c3df",56,["D",1778270041498],"// 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",[],[209,310],"a919ef02-4b17-11f1-bff1-ee650bb23af1","db.ts","aad2cfa2-48c5-11f1-bfb8-42b51c65c3df",59,["D",1778270041839],8,"// 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\n/** Delete visits older than `days` days. Safe to call before migrate runs. */\nexport async function pruneOldVisits(days = 30): Promise {\n await migrate();\n await sqlite.execute({\n sql: `DELETE FROM template_visits WHERE ts < datetime('now', ?)`,\n args: [`-${days} days`],\n });\n}\n",[],[209,318],["D",1778074991756],[225,226,227],[209],["D",1777994172310],["D",1789511441255],{"_100":99,"_108":104},{"_100":99,"_101":102,"_103":104,"_18":56,"_105":106,"_107":26},{"_13":89,"_32":90,"_43":42,"_91":44,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":45,"_98":99},"ctx",{"_82":-5,"_128":367,"_368":369,"_370":371,"_372":26,"_373":26,"_374":26,"_375":24,"_376":-5,"_377":-7,"_378":-7,"_379":205,"_380":26,"_381":26,"_382":-5,"_383":26,"_384":26,"_385":26,"_386":-5},"ENV",{"_338":339,"_340":341,"_342":90,"_343":344,"_345":346,"_347":348,"_349":350,"_351":352,"_353":354,"_355":356,"_357":358,"_359":360,"_361":362,"_363":364,"_365":366},"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 · v84