[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_392":393,"_394":395},"routes/_app.x.$handle.$name",{"_101":100,"_32":45,"_110":91,"_26":111,"_13":14,"_112":-5,"_11":113,"_114":115,"_116":117,"_118":119,"_120":121,"_20":-5,"_122":-5,"_123":-5,"_124":24,"_125":126,"_127":60,"_128":-5,"_129":-5,"_130":131},"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":24,"_49":50,"_51":50,"_52":53,"_54":55,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":72,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":84,"_85":86,"_87":88,"_89":24},"version",126,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":29},"file",{"_30":31,"_32":33,"_34":35,"_36":37,"_38":39,"_40":14,"_41":42,"_23":24},"previous","deleted",false,"deletedHere","path","frontend/pages/page-blob.tsx","latestPath","frontend/pages/features/page-blob.tsx","fileId","092bd26e-4c96-11f1-b531-ee650bb23af1","name","page-blob.tsx","fileType","script","content","/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// page-blob.tsx — Blob Storage: key namespacing, JSON helpers, list/delete.\n\nimport { Badge, CodeBlock, DemoBox, PageHeader, SectionTitle } from \"../ui/components.tsx\";\n\nconst WRAPPER_SNIPPET = {\n filename: \"backend/storage.ts\",\n code: `import { blob } from \"https://esm.town/v/std/blob\";\n\nconst PREFIX = \"template/\"; // namespace to avoid collisions with other vals\n\nexport async function saveJSON(key: string, value: unknown): Promise {\n await blob.setJSON(\\`\\${PREFIX}\\${key}\\`, value);\n}\n\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 { return null; }\n}\n\nexport async function listKeys(): Promise {\n const keys = await blob.list(PREFIX);\n return keys.map((k: { key: string }) => k.key.replace(PREFIX, \"\"));\n}`,\n};\n\nconst USAGE_SNIPPET = {\n filename: \"example usage\",\n code: `// Store config from a cron run\nawait saveJSON(\"last-sync\", { ts: new Date().toISOString(), count: 42 });\n\n// Read it back (typed)\nconst sync = await loadJSON<{ ts: string; count: number }>(\"last-sync\");\nconsole.log(sync?.ts);\n\n// Delete a key\nawait remove(\"last-sync\");`,\n};\n\nexport function BlobPage() {\n return (\n

\n \n\n Key rules\n

\n \n \n \n \n \n \n \n \n \n

Rule	Detail
	All vals share one blob namespace — always prefix keys
	`setJSON` / `getJSON` handle serialisation for you
	`set(key, ArrayBuffer)` for images, attachments, exports
	No queries — use Blob for whole-object storage, not row data
	Blob is not encrypted — use Val Town env vars for secrets

\n\n Storage wrapper\n \n\n Usage pattern\n \n\n Live demo\n \n

\n );\n}\n","createdAt",["D",1778434270685],"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",{"_101":100,"_109":105},"org",{"_101":100,"_102":103,"_104":105,"_18":56,"_106":107,"_108":24},"branch",{"_13":90,"_32":91,"_43":42,"_92":44,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":45,"_99":100},"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",{"_43":44,"_32":45,"_38":387,"_47":-5,"_48":24,"_49":50,"_51":50,"_52":53,"_54":55,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":388,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":389,"_85":390,"_87":391,"_89":24},"tree",[216,221,234,235,236,237,238,239],"files",[216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239],"counts",{"_206":197,"_207":64,"_208":64,"_209":210,"_211":212},"contents",[132,133,134,135,136,137,138,139],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_43":200,"_32":201,"_30":202,"_143":-5,"_41":42,"_40":203,"_145":60,"_38":204,"_13":197,"_34":198,"_36":-5,"_23":24,"_149":-5,"_26":205},{"_43":192,"_32":193,"_30":194,"_143":-5,"_41":42,"_40":195,"_145":60,"_38":196,"_13":197,"_34":198,"_36":-5,"_23":24,"_149":-5,"_26":199},{"_43":185,"_32":186,"_30":187,"_143":-5,"_41":42,"_40":188,"_145":24,"_38":189,"_13":155,"_34":20,"_36":190,"_23":24,"_149":-5,"_26":191},{"_43":177,"_32":178,"_30":179,"_143":-5,"_41":42,"_40":180,"_145":24,"_38":181,"_13":147,"_34":182,"_36":183,"_23":24,"_149":-5,"_26":184},{"_43":169,"_32":170,"_30":171,"_143":-5,"_41":42,"_40":172,"_145":24,"_38":173,"_13":174,"_34":20,"_36":175,"_23":24,"_149":-5,"_26":176},{"_43":160,"_32":161,"_30":162,"_143":-5,"_41":42,"_40":163,"_145":24,"_38":164,"_13":165,"_34":166,"_36":167,"_23":24,"_149":-5,"_26":168},{"_43":151,"_32":152,"_30":58,"_143":-5,"_41":42,"_40":153,"_145":24,"_38":154,"_13":155,"_34":156,"_36":157,"_23":24,"_149":158,"_26":159},{"_43":140,"_32":141,"_30":142,"_143":-5,"_41":42,"_40":144,"_145":24,"_38":146,"_13":147,"_34":20,"_36":148,"_23":24,"_149":-5,"_26":150},"d64d935e-4c8c-11f1-9922-ee650bb23af1","val.yml","aa729402-48c5-11f1-87ca-42b51c65c3df","parentId",121,"latest",["D",1778430319933],4,"name: \"sample-val\"\npublic: true\nfiles:\n index.http.ts: http\n cron.ts: interval\n email.ts: email\n# env vars this val reads. Set them in the Val Town UI sidebar — never in code.\n# required: val will not work without it | optional: has a safe default\nenv:\n CRON_PULSE_INTERVAL: optional # \"5m\" | \"1h\" | \"DISABLED\"\n CRON_MAINTENANCE_INTERVAL: optional # \"1d\" | \"DISABLED\"\n","label",[141],"0d9666c2-4b8b-11f1-b0cf-ee650bb23af1","index.http.ts",116,["D",1778319602351],6,"http","// index.http.ts — Single HTTP trigger for the Preact app and tiny JSON API.\n// Docs: https://docs.val.town/vals/http\n\nimport { getRecentVisits, getVisitCount, recordVisit } from \"./backend/db.ts\";\nimport { jsonError, jsonOk } from \"./backend/api-utils.ts\";\nimport { APP_NAME } from \"./backend/shared.ts\";\nimport { renderHomePage } from \"./frontend/app.tsx\";\n\n// -----------------------------------------------------------------------------\n// entry\n// -----------------------------------------------------------------------------\n\nexport default async function handler(req: Request): Promise {\n const url = new URL(req.url);\n if (req.method === \"GET\" && isRootPath(url.pathname)) {\n return await landingPage();\n }\n return await routeApi(req, url);\n}\n\nfunction isRootPath(pathname: string): boolean {\n return pathname === \"/\" || pathname === \"\";\n}\n\nasync function landingPage(): Promise {\n try {\n await recordVisit(\"/\");\n } catch {\n // SQLite is only available on Val Town; local previews still render.\n }\n\n const html = renderHomePage({\n appName: APP_NAME,\n renderedAt: new Date().toISOString(),\n });\n return new Response(html, {\n headers: { \"content-type\": \"text/html; charset=utf-8\" },\n });\n}\n\n// -----------------------------------------------------------------------------\n// api routes\n// -----------------------------------------------------------------------------\n\nasync function routeApi(req: Request, url: URL): Promise {\n const route = `${req.method} ${url.pathname}`;\n if (route === \"GET /api/health\") return healthCheck();\n if (route === \"GET /api/visits\") return await visits();\n return jsonError(`Not found: ${url.pathname}`, 404);\n}\n\nfunction healthCheck(): Response {\n return jsonOk({\n name: APP_NAME,\n timestamp: new Date().toISOString(),\n runtime: `Deno ${Deno.version?.deno || \"unknown\"}`,\n });\n}\n\nasync function visits(): Promise {\n try {\n const visits = await getRecentVisits(20);\n const total = await getVisitCount();\n return jsonOk({ total, visits });\n } catch {\n return jsonError(\"SQLite not available (running off-platform?)\", 503);\n }\n}\n","d-template",[152],"0cc9d012-4b8b-11f1-ae50-ee650bb23af1","email.ts","aa7742d6-48c5-11f1-831b-42b51c65c3df",108,["D",1778319601107],8,"email","// email.ts — Inbound handler + outbound helpers. UI: + → EMAIL.\n// Address shape: .@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// -----------------------------------------------------------------------------\n// inbound\n// -----------------------------------------------------------------------------\n\nexport default async function emailHandler(inbound: Email): Promise {\n console.log(\n `📧 [${APP_NAME}] From: ${inbound.from} Subject: ${\n inbound.subject ?? \"(none)\"\n }`,\n );\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// -----------------------------------------------------------------------------\n// outbound\n// -----------------------------------------------------------------------------\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(\n `📤 [${APP_NAME}] Sent with attachment: \"${attachment.filename}\"`,\n );\n}\n",[161],"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",[170],"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",[178],"0cd8509c-4b8b-11f1-89d0-ee650bb23af1","README.md","aabf7b64-48c5-11f1-9920-42b51c65c3df",109,["D",1778319601219],"# Val Town Template\n\nA compact Val Town starter with one HTTP surface: a Preact SSR documentation\napp.\n\nKeep this README short. The running webapp explains each module in detail via a\nselectable **Docs** section powered by `frontend/ui/data.ts`.\n\n---\n\n## What This Template Includes\n\n- `index.http.ts` — the only HTTP trigger.\n- Preact SSR + Oat CSS — no build step, no hydration bundle.\n- Tiny JSON API — `/api/health` and `/api/visits`.\n- SQLite — visit counter and cron metadata.\n- Cron — scheduled pulse and maintenance examples.\n- Email — inbound handler and outbound helpers.\n- Blob — small account-scoped storage wrapper.\n- `val.yml.files` — repo-side trigger metadata contract.\n\n---\n\n## Quick Start\n\n```bash\ncd /path/to/uApps\nvt create my-app\ncd vals/my-app\nvt push\nvt url\n```\n\nOpen the URL. The homepage is the module documentation.\n\nBefore changing remote state, use:\n\n```bash\nvt status\nvt push --dry-run\nvt types\n```\n\n---\n\n## HTTP Shape\n\nOnly one file should be an HTTP trigger:\n\n```txt\nindex.http.ts\n```\n\nRoutes:\n\n| Method | Path | Purpose |\n| ------ | ------------- | -------------------- |\n| GET | `/` | Preact docs app |\n| GET | `/api/health` | Runtime health check |\n| GET | `/api/visits` | SQLite visit count |\n\nDo not add email, OpenAI, admin, or write routes without auth. Val Town HTTP\nendpoints are public even when the val source is private.\n\n---\n\n## Preact Notes\n\nEvery `.tsx` file containing JSX needs the Val Town JSX pragma at the top:\n\n```tsx\n/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n```\n\nThe pragma selects the JSX runtime. It does not make a file an HTTP trigger.\nTrigger type is Val Town metadata; for new files, `vt` infers it from path words\nsuch as `http`, `cron`, and `email`.\n\nThe UI is intentionally declarative:\n\n```txt\nfrontend/ui/data.ts # docs/routes/stats data\nfrontend/ui/sections.tsx # maps data to sections\nfrontend/client.ts # theme, docs tabs, visit count\n```\n\n---\n\n## Trigger Metadata\n\n`val.yml` records the intended Val Town file types:\n\n```yaml\nfiles:\n index.http.ts: http\n cron.ts: interval\n email.ts: email\n```\n\nCheck remote metadata with:\n\n```bash\nvt types\n```\n\nExisting remote files keep sticky metadata. If Val Town shows\n`(script) index.http.ts`, the code may be valid but the file is not an HTTP\ntrigger.\n\n---\n\n## Customize\n\n- Rename the app: edit `APP_NAME` in `backend/shared.ts`.\n- Edit the homepage docs: update `frontend/ui/data.ts`.\n- Add a read-only API route: add a small branch in `index.http.ts`.\n- Add a SQLite table: extend `migrate()` in `backend/db.ts`.\n- Change visibility/org: edit `val.yml`.\n\nKeep files small. Delete modules you do not need.\n\n---\n\n## Key Files\n\n| File | Purpose |\n| ---------------------- | --------------------------------------------------- |\n| `index.http.ts` | Single HTTP trigger; renders Preact and JSON API |\n| `frontend/app.tsx` | HTML shell and Preact SSR entry |\n| `frontend/ui/data.ts` | Declarative webapp docs, stats, and route copy |\n| `frontend/ui/` | Preact sections, types, and styles |\n| `frontend/client.ts` | Inline theme/docs/visit-count enhancement |\n| `backend/db.ts` | SQLite schema and queries |\n| `backend/api-utils.ts` | JSON response helpers |\n| `backend/storage.ts` | Blob storage helpers |\n| `backend/shared.ts` | App constants, env helper, duration parser, types |\n| `cron.ts` | Cron trigger example |\n| `email.ts` | Email trigger and outbound helper examples |\n| `val.yml` | Val name, visibility, and expected trigger metadata |\n",[186],"85f9d626-4951-11f1-a16a-42b51c65c3df","frontend","85f9d6f8-4951-11f1-a16a-42b51c65c3df",34,["D",1778074991402],0,"directory",[193],"86303568-4951-11f1-a193-42b51c65c3df","backend","8630361c-4951-11f1-a193-42b51c65c3df",35,["D",1778074991756],[201],"pulls","branches","forks","envVars",{"_213":64,"_215":197},"connections",{"_213":197,"_214":197},"count","unfilledCount","emptyCount",{"_43":200,"_32":201,"_30":202,"_143":-5,"_41":42,"_40":203,"_145":60,"_38":384,"_13":197,"_34":198,"_36":-5,"_23":24,"_149":-5,"_241":385,"_26":386},{"_43":376,"_32":377,"_30":378,"_143":202,"_41":42,"_40":379,"_145":24,"_38":380,"_13":64,"_34":35,"_36":381,"_23":24,"_149":-5,"_241":382,"_26":383},{"_43":368,"_32":369,"_30":370,"_143":202,"_41":42,"_40":371,"_145":24,"_38":372,"_13":165,"_34":35,"_36":373,"_23":24,"_149":-5,"_241":374,"_26":375},{"_43":360,"_32":361,"_30":362,"_143":202,"_41":42,"_40":363,"_145":24,"_38":364,"_13":147,"_34":35,"_36":365,"_23":24,"_149":-5,"_241":366,"_26":367},{"_43":352,"_32":353,"_30":354,"_143":202,"_41":42,"_40":355,"_145":24,"_38":356,"_13":155,"_34":35,"_36":357,"_23":24,"_149":-5,"_241":358,"_26":359},{"_43":192,"_32":193,"_30":194,"_143":-5,"_41":42,"_40":195,"_145":60,"_38":349,"_13":197,"_34":198,"_36":-5,"_23":24,"_149":-5,"_241":350,"_26":351},{"_43":344,"_32":331,"_30":325,"_143":194,"_41":42,"_40":345,"_145":60,"_38":346,"_13":197,"_34":198,"_36":-5,"_23":24,"_149":-5,"_241":347,"_26":348},{"_43":340,"_32":33,"_30":31,"_143":325,"_41":42,"_40":14,"_145":24,"_38":341,"_13":197,"_34":35,"_36":37,"_23":24,"_149":-5,"_241":342,"_26":343},{"_43":332,"_32":333,"_30":334,"_143":325,"_41":42,"_40":335,"_145":24,"_38":336,"_13":197,"_34":182,"_36":337,"_23":24,"_149":-5,"_241":338,"_26":339},{"_43":322,"_32":323,"_30":324,"_143":325,"_41":42,"_40":326,"_145":24,"_38":327,"_13":197,"_34":166,"_36":328,"_23":24,"_149":-5,"_241":329,"_26":330},{"_43":317,"_32":284,"_30":278,"_143":194,"_41":42,"_40":318,"_145":24,"_38":319,"_13":197,"_34":198,"_36":-5,"_23":24,"_149":-5,"_241":320,"_26":321},{"_43":309,"_32":310,"_30":311,"_143":278,"_41":42,"_40":312,"_145":24,"_38":313,"_13":197,"_34":35,"_36":314,"_23":24,"_149":-5,"_241":315,"_26":316},{"_43":301,"_32":302,"_30":303,"_143":278,"_41":42,"_40":304,"_145":24,"_38":305,"_13":64,"_34":35,"_36":306,"_23":24,"_149":-5,"_241":307,"_26":308},{"_43":293,"_32":294,"_30":295,"_143":278,"_41":42,"_40":296,"_145":24,"_38":297,"_13":174,"_34":35,"_36":298,"_23":24,"_149":-5,"_241":299,"_26":300},{"_43":285,"_32":286,"_30":287,"_143":278,"_41":42,"_40":288,"_145":24,"_38":289,"_13":174,"_34":35,"_36":290,"_23":24,"_149":-5,"_241":291,"_26":292},{"_43":275,"_32":276,"_30":277,"_143":278,"_41":42,"_40":279,"_145":24,"_38":280,"_13":64,"_34":35,"_36":281,"_23":24,"_149":-5,"_241":282,"_26":283},{"_43":267,"_32":268,"_30":269,"_143":194,"_41":42,"_40":270,"_145":24,"_38":271,"_13":174,"_34":35,"_36":272,"_23":24,"_149":-5,"_241":273,"_26":274},{"_43":259,"_32":260,"_30":261,"_143":194,"_41":42,"_40":262,"_145":24,"_38":263,"_13":174,"_34":35,"_36":264,"_23":24,"_149":-5,"_241":265,"_26":266},{"_43":185,"_32":186,"_30":187,"_143":-5,"_41":42,"_40":188,"_145":24,"_38":256,"_13":155,"_34":20,"_36":190,"_23":24,"_149":-5,"_241":257,"_26":258},{"_43":177,"_32":178,"_30":179,"_143":-5,"_41":42,"_40":180,"_145":24,"_38":253,"_13":147,"_34":182,"_36":183,"_23":24,"_149":-5,"_241":254,"_26":255},{"_43":169,"_32":170,"_30":171,"_143":-5,"_41":42,"_40":172,"_145":24,"_38":250,"_13":174,"_34":20,"_36":175,"_23":24,"_149":-5,"_241":251,"_26":252},{"_43":160,"_32":161,"_30":162,"_143":-5,"_41":42,"_40":163,"_145":24,"_38":247,"_13":165,"_34":166,"_36":167,"_23":24,"_149":-5,"_241":248,"_26":249},{"_43":151,"_32":152,"_30":58,"_143":-5,"_41":42,"_40":153,"_145":24,"_38":244,"_13":155,"_34":156,"_36":157,"_23":24,"_149":158,"_241":245,"_26":246},{"_43":140,"_32":141,"_30":142,"_143":-5,"_41":42,"_40":144,"_145":24,"_38":240,"_13":147,"_34":20,"_36":148,"_23":24,"_149":-5,"_241":242,"_26":243},["D",1778430319933],"children",[],[141],["D",1778319602351],[],[152],["D",1778319601107],[],[161],["D",1778270041449],[],[170],["D",1778270041959],[],[178],["D",1778319601219],[],[186],"2ffecfcc-4c87-11f1-a14c-ee650bb23af1","client.ts","48ed4cf0-4b21-11f1-b54f-ee650bb23af1",120,["D",1778427893353],"// client.ts — Inline browser script for theme, docs tabs, and visit count.\n\nexport const clientJs = String.raw`\nconst themeSelect = document.getElementById(\"theme-select\");\nconst docTabs = Array.from(document.querySelectorAll(\"[data-doc-tab]\"));\nconst docPanels = Array.from(document.querySelectorAll(\"[data-doc-panel]\"));\nconst osDark = window.matchMedia(\"(prefers-color-scheme: dark)\");\n\n// theme -----------------------------------------------------------------------\n\nfunction applyTheme(theme) {\n if (theme === \"auto\") {\n // Remove override; CSS @media query handles it automatically.\n // Also listen for live OS changes while on \"auto\".\n document.documentElement.removeAttribute(\"data-theme\");\n osDark.addEventListener(\"change\", onOsChange);\n } else {\n osDark.removeEventListener(\"change\", onOsChange);\n document.documentElement.setAttribute(\"data-theme\", theme);\n }\n}\n\nfunction onOsChange() {\n // Only fires when saved preference is \"auto\" (listener is attached then).\n document.documentElement.removeAttribute(\"data-theme\");\n}\n\nfunction saveTheme(event) {\n const theme = event.target.value;\n localStorage.setItem(\"theme\", theme);\n applyTheme(theme);\n}\n\nfunction initTheme() {\n const saved = localStorage.getItem(\"theme\") || \"auto\";\n applyTheme(saved);\n if (themeSelect) themeSelect.value = saved;\n}\n\n// docs tabs -------------------------------------------------------------------\n\nfunction showDoc(key) {\n for (const tab of docTabs) {\n tab.setAttribute(\"aria-selected\", String(tab.dataset.docTab === key));\n }\n for (const panel of docPanels) {\n panel.hidden = panel.dataset.docPanel !== key;\n }\n}\n\n// visit count -----------------------------------------------------------------\n\nasync function fetchVisits() {\n const el = document.getElementById(\"visit-count\");\n if (!el) return;\n try {\n const res = await fetch(\"/api/visits\");\n const data = await res.json();\n el.textContent = res.ok ? String(data.total ?? \"—\") : \"—\";\n } catch {\n el.textContent = \"—\";\n }\n}\n\n// init ------------------------------------------------------------------------\n\nthemeSelect?.addEventListener(\"change\", saveTheme);\nfor (const tab of docTabs) {\n tab.addEventListener(\"click\", () => showDoc(tab.dataset.docTab));\n}\ninitTheme();\nfetchVisits();\n`;\n",[],[193,260],"2ff370e6-4c87-11f1-8d6a-ee650bb23af1","app.tsx","48f1fc50-4b21-11f1-aeb4-ee650bb23af1",119,["D",1778427893348],"/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// app.tsx — Server-rendered Preact documentation app for the template val.\n\nimport { render } from \"https://esm.sh/preact-render-to-string@6.6.7?deps=preact@10.29.1\";\nimport { clientJs } from \"./client.ts\";\nimport {\n Footer,\n Hero,\n ModuleDocs,\n RouteTable,\n StatusGrid,\n} from \"./ui/sections.tsx\";\nimport { css } from \"./ui/styles.ts\";\nimport type { HomePageProps } from \"./ui/types.ts\";\n\n// -----------------------------------------------------------------------------\n// public renderer\n// -----------------------------------------------------------------------------\n\nexport function renderHomePage(props: HomePageProps): string {\n return \"\" + render();\n}\n\n// -----------------------------------------------------------------------------\n// shell\n// -----------------------------------------------------------------------------\n\nfunction App(props: HomePageProps) {\n return (\n \n \n \n \n \n {props.appName}\n \n \n \n \n \n

\n \n \n \n \n

\n \n \n \n );\n}\n",[],[193,268],"0c7e0dee-4b8b-11f1-92c4-ee650bb23af1","types.ts","48ba57fa-4b21-11f1-b54f-ee650bb23af1","4888d3e2-4b21-11f1-81f8-ee650bb23af1",104,["D",1778319600684],"// types.ts — Shared Preact UI data contracts.\n\nexport interface HomePageProps {\n appName: string;\n renderedAt: string;\n}\n\nexport interface RouteItem {\n method: string;\n path: string;\n purpose: string;\n}\n\nexport interface StatItem {\n title: string;\n value: string;\n note: string;\n id?: string;\n}\n\nexport interface ModuleDoc {\n key: string;\n title: string;\n badge: string;\n summary: string;\n files: string[];\n points: string[];\n}\n",[],[193,284,276],"ui","2fec5acc-4c87-11f1-8b15-ee650bb23af1","styles.ts","48c5ebec-4b21-11f1-9ccf-ee650bb23af1",118,["D",1778427893338],"// styles.ts — Gruvbox-inspired theme. Zero external CSS dependencies.\n//\n// Palette: https://github.com/morhetz/gruvbox\n// Strategy: :root defines light vars; @media dark and [data-theme=\"dark\"] both\n// apply dark vars; [data-theme=\"light\"] restores light vars. Removing\n// data-theme entirely lets the OS preference win — true \"auto\" mode.\n\n// gruvbox-light ----------------------------------------------------------------\nconst LIGHT = `\n color-scheme: light dark;\n --gbg: #fbf1c7; --gbg1: #ebdbb2; --gbg2: #d5c4a1; --gbg3: #bdae93;\n --gfg: #3c3836; --gfg2: #504945; --gfg3: #665c54; --gfg4: #7c6f64;\n --gyel: #d79921; --gora: #d65d0e; --gred: #cc241d;\n --ggrn: #98971a; --gaqu: #689d6a; --gblu: #458588; --gpur: #b16286;\n --brand: #d65d0e;\n --bg: #fbf1c7; --fg: #3c3836; --muted: #7c6f64;\n --line: #bdae93; --soft: #ebdbb2; --card: #f2e5bc;\n`;\n// gruvbox-dark -----------------------------------------------------------------\nconst DARK = `\n color-scheme: dark;\n --gbg: #282828; --gbg1: #3c3836; --gbg2: #504945; --gbg3: #665c54;\n --gfg: #ebdbb2; --gfg2: #d5c4a1; --gfg3: #bdae93; --gfg4: #a89984;\n --gyel: #fabd2f; --gora: #fe8019; --gred: #fb4934;\n --ggrn: #b8bb26; --gaqu: #8ec07c; --gblu: #83a598; --gpur: #d3869b;\n --brand: #fabd2f;\n --bg: #282828; --fg: #ebdbb2; --muted: #a89984;\n --line: #504945; --soft: #3c3836; --card: #32302f;\n`;\n\nexport const css = `\n/* reset --------------------------------------------------------------------- */\n*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }\nhtml { -webkit-text-size-adjust: 100%; }\nbody { line-height: 1.6; }\nimg, video { max-width: 100%; }\nbutton, input, select, textarea { font: inherit; }\nh1, h2, h3 { line-height: 1.2; }\n\n:root { ${LIGHT} }\n@media (prefers-color-scheme: dark) { :root:not([data-theme=\"light\"]) { ${DARK} } }\n[data-theme=\"dark\"] { ${DARK} }\n[data-theme=\"light\"] { ${LIGHT} }\n\n* { transition: background-color 0.2s, border-color 0.2s, color 0.1s; }\nbody { background: var(--bg); color: var(--fg); font-family: \"JetBrains Mono\", \"Fira Mono\", ui-monospace, monospace; }\na { color: var(--gblu); }\na:hover { color: var(--gora); }\ncode, kbd, pre { font-family: inherit; }\n\n.page { max-width: 1120px; margin: 0 auto; padding: 40px 20px 72px; }\n\n/* hero ----------------------------------------------------------------------- */\n.hero { display: grid; gap: 18px; margin-bottom: 28px; }\n.hero h1 {\n font-size: clamp(2.2rem, 7vw, 5.4rem); letter-spacing: -0.04em; margin: 0;\n color: var(--brand); text-shadow: 0 2px 24px color-mix(in srgb, var(--brand), transparent 70%);\n}\n.hero p { max-width: 700px; color: var(--gfg3); }\n.eyebrow { color: var(--gfg4); font-size: 0.78rem; font-weight: 700; letter-spacing: 0.18em; margin: 0; text-transform: uppercase; }\n\n/* actions -------------------------------------------------------------------- */\n.actions { align-items: center; display: flex; flex-wrap: wrap; gap: 10px; }\n.theme-field { align-items: center; display: inline-flex; gap: 8px; margin: 0; }\n\n/* buttons -------------------------------------------------------------------- */\n[role=\"button\"], button, select {\n background: var(--soft); border: 1px solid var(--line);\n color: var(--fg); border-radius: 6px; padding: 8px 16px;\n font-family: inherit; font-size: 0.88rem; cursor: pointer;\n}\n[role=\"button\"]:hover, button:hover { background: var(--gbg1); border-color: var(--brand); color: var(--brand); }\n.secondary { background: transparent; border-color: var(--line); }\n\n/* grid & cards --------------------------------------------------------------- */\n.grid { display: grid; gap: 16px; }\n.four { grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); }\n.card {\n background: var(--card); border: 1px solid var(--line);\n border-radius: 10px; padding: 18px;\n box-shadow: 0 4px 24px color-mix(in srgb, #000, transparent 82%);\n}\n.spacious { margin-top: 20px; padding: 28px; }\n\n/* section header ------------------------------------------------------------- */\n.section-head { align-items: end; display: flex; gap: 16px; justify-content: space-between; margin-bottom: 18px; }\n.section-head h2 { margin: 0; }\n.section-head p { max-width: 520px; color: var(--gfg3); margin: 0; }\n\n/* stat cards ----------------------------------------------------------------- */\n.stat span { color: var(--gfg4); font-size: 0.8rem; letter-spacing: 0.1em; text-transform: uppercase; }\n.stat strong { display: block; font-size: 2rem; margin: 6px 0; color: var(--brand); }\n.stat p { color: var(--muted); font-size: 0.82rem; margin: 0; }\n\n/* docs layout ---------------------------------------------------------------- */\n.docs-layout { display: grid; gap: 18px; grid-template-columns: minmax(180px, 240px) 1fr; }\n.doc-tabs { display: grid; gap: 6px; align-content: start; }\n.doc-tab {\n background: transparent; border: 1px solid transparent;\n border-radius: 8px; cursor: pointer; padding: 10px 14px;\n text-align: left; font-family: inherit;\n transition: background 0.15s, border-color 0.15s;\n}\n.doc-tab:hover { background: var(--soft); border-color: var(--line); }\n.doc-tab[aria-selected=\"true\"] {\n background: var(--soft); border-color: var(--brand);\n box-shadow: inset 3px 0 0 var(--brand);\n}\n.doc-tab strong { display: block; color: var(--fg); font-size: 0.9rem; }\n.doc-tab span, .badge { color: var(--gfg4); display: block; font-size: 0.78rem; letter-spacing: 0.08em; text-transform: uppercase; margin-top: 2px; }\n.doc-panel { border: 1px solid var(--line); border-radius: 10px; padding: 24px; }\n.doc-panel h3 { margin-top: 8px; color: var(--brand); }\n.doc-panel p { color: var(--gfg3); }\n.doc-panel ul li { color: var(--gfg2); margin-bottom: 6px; }\n\n/* file pills ----------------------------------------------------------------- */\n.file-list { display: flex; flex-wrap: wrap; gap: 6px; margin: 14px 0; }\n.file-list code {\n background: var(--soft); border: 1px solid var(--line);\n border-radius: 4px; padding: 2px 8px; font-size: 0.82rem;\n color: var(--gaqu); white-space: nowrap;\n}\n\n/* table ---------------------------------------------------------------------- */\ntable { width: 100%; border-collapse: collapse; font-size: 0.9rem; }\nth { color: var(--gfg4); font-size: 0.78rem; letter-spacing: 0.1em; text-transform: uppercase; border-bottom: 2px solid var(--line); padding: 8px 12px; text-align: left; }\ntd { padding: 10px 12px; border-bottom: 1px solid var(--line); }\ntr:last-child td { border-bottom: none; }\ntd:first-child { color: var(--gora); font-weight: 700; }\ntable code { background: var(--soft); border: 1px solid var(--line); border-radius: 4px; padding: 1px 6px; color: var(--gaqu); }\n\n/* alert --------------------------------------------------------------------- */\n[role=\"alert\"] { border-radius: 8px; border-left: 4px solid var(--gyel); background: color-mix(in srgb, var(--gyel), transparent 88%); padding: 12px 16px; font-size: 0.88rem; }\n[role=\"alert\"] strong { color: var(--gyel); }\n\n/* footer -------------------------------------------------------------------- */\n.footer { color: var(--gfg4); margin-top: 32px; text-align: center; font-size: 0.85rem; }\n.footer code { color: var(--gaqu); }\n\n/* responsive ----------------------------------------------------------------- */\n@media (max-width: 720px) {\n .docs-layout, .section-head { display: block; }\n .doc-tabs { margin-bottom: 14px; }\n .section-head p { margin-top: 8px; }\n}\n`;\n",[],[193,284,286],"e3d2415c-4c7b-11f1-a226-ee650bb23af1","sections.tsx","490e4de2-4b21-11f1-874d-ee650bb23af1",117,["D",1778423041195],"/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// sections.tsx — Declarative documentation sections.\n\nimport { moduleDocs, routes, stats } from \"./data.ts\";\nimport type { HomePageProps, ModuleDoc, StatItem } from \"./types.ts\";\n\n// -----------------------------------------------------------------------------\n// top sections\n// -----------------------------------------------------------------------------\n\nexport function Hero(props: HomePageProps) {\n return (\n

Val Town starter · Preact SSR · one HTTP file

{props.appName}

\n A compact, inspectable template for Val Town vals. The README stays\n short; this page carries the module-by-module documentation.\n

\n \n

\n Public endpoint rule:{\" \"}\n every Val Town HTTP route is reachable by URL. Add auth before exposing\n private data, writes, or expensive calls.\n

\n );\n}\n\nexport function StatusGrid() {\n return (\n

\n {stats.map((item) => )}\n

\n );\n}\n\nfunction Stat(props: { item: StatItem }) {\n return (\n

\n {props.item.title}\n {props.item.value}\n

{props.item.note}

\n );\n}\n\n// -----------------------------------------------------------------------------\n// docs\n// -----------------------------------------------------------------------------\n\nexport function ModuleDocs() {\n return (\n

Docs

Pick a module

\n The content below is data-driven from{\" \"}\n frontend/ui/data.ts.\n

\n {moduleDocs.map((doc, index) => )}\n

\n {moduleDocs.map((doc, index) => (\n \n ))}\n

\n );\n}\n\nfunction DocTab(props: { doc: ModuleDoc; active: boolean }) {\n return (\n \n {props.doc.title}\n {props.doc.badge}\n \n );\n}\n\nfunction DocPanel(props: { doc: ModuleDoc; active: boolean }) {\n return (\n

\n );\n}\n\nfunction FileList(props: { files: string[] }) {\n return (\n

\n {props.files.map((file) => {file})}\n

\n );\n}\n\n// -----------------------------------------------------------------------------\n// reference\n// -----------------------------------------------------------------------------\n\nexport function RouteTable() {\n return (\n

HTTP

Routes

\n Keep this list small. Add real auth before adding powerful routes.\n

\n \n \n \n \n \n \n \n \n \n {routes.map((r) => (\n \n \n \n \n \n ))}\n \n

Method	Path	Purpose
{r.method}	\n `{r.path}`\n	{r.purpose}

\n );\n}\n\nexport function Footer(props: { renderedAt: string }) {\n return (\n \n );\n}\n",[],[193,284,294],"0c834bc4-4b8b-11f1-89d0-ee650bb23af1","data.ts","48c092be-4b21-11f1-81f8-ee650bb23af1",105,["D",1778319600727],"// data.ts — Declarative page copy for the template docs.\n\nimport type { ModuleDoc, RouteItem, StatItem } from \"./types.ts\";\n\nexport const stats: StatItem[] = [\n {\n title: \"HTTP files\",\n value: \"1\",\n note: \"Only index.http.ts is public HTTP surface.\",\n },\n {\n title: \"Visits\",\n value: \"…\",\n note: \"Loaded from SQLite via /api/visits.\",\n id: \"visit-count\",\n },\n {\n title: \"Frontend\",\n value: \"Preact\",\n note: \"Server-rendered HTML with Oat CSS.\",\n },\n {\n title: \"Triggers\",\n value: \"3\",\n note: \"HTTP, Cron, and Email examples.\",\n },\n];\n\nexport const routes: RouteItem[] = [\n { method: \"GET\", path: \"/\", purpose: \"Preact docs UI\" },\n { method: \"GET\", path: \"/api/health\", purpose: \"Runtime health check\" },\n { method: \"GET\", path: \"/api/visits\", purpose: \"SQLite visit counter\" },\n];\n\nexport const moduleDocs: ModuleDoc[] = [\n {\n key: \"http\",\n title: \"HTTP trigger\",\n badge: \"public edge\",\n summary:\n \"index.http.ts is the only HTTP file. It renders Preact and exposes a tiny JSON API.\",\n files: [\"index.http.ts\", \"backend/api-utils.ts\"],\n points: [\n \"Val Town HTTP endpoints are public even when source is private.\",\n \"Root requests render frontend/app.tsx and record a SQLite visit.\",\n \"API routes stay boring: /api/health and /api/visits only.\",\n \"Add auth before adding write, private-data, or expensive routes.\",\n ],\n },\n {\n key: \"preact\",\n title: \"Preact UI\",\n badge: \"SSR\",\n summary:\n \"The webapp is the detailed documentation surface for this template.\",\n files: [\n \"frontend/app.tsx\",\n \"frontend/ui/sections.tsx\",\n \"frontend/ui/data.ts\",\n \"frontend/ui/styles.ts\",\n \"frontend/client.ts\",\n ],\n points: [\n \"Every .tsx file with JSX starts with @jsxImportSource.\",\n \"frontend/ui/data.ts owns copy; components map that data declaratively.\",\n \"Oat CSS supplies defaults; styles.ts adds one small theme layer.\",\n \"client.ts only enhances theme, docs selection, and visit count.\",\n ],\n },\n {\n key: \"sqlite\",\n title: \"SQLite\",\n badge: \"state\",\n summary: \"Per-val SQLite stores visit rows and cron metadata.\",\n files: [\"backend/db.ts\"],\n points: [\n \"Use https://esm.town/v/std/sqlite/main.ts for the val-scoped database.\",\n \"Migrations run lazily so local/off-platform rendering can still work.\",\n \"template_visits powers the visit counter.\",\n \"template_meta stores cron last-run timestamps.\",\n ],\n },\n {\n key: \"cron\",\n title: \"Cron trigger\",\n badge: \"scheduled\",\n summary:\n \"cron.ts demonstrates small scheduled tasks gated by env-configured intervals.\",\n files: [\"cron.ts\", \"backend/shared.ts\", \"backend/db.ts\"],\n points: [\n \"Val Town cron minimum interval is 15 minutes and runs in UTC.\",\n \"CRON_PULSE_INTERVAL defaults to 5m; set DISABLED to skip.\",\n \"CRON_MAINTENANCE_INTERVAL defaults to 1d and prunes old visits.\",\n \"shouldRun() records timestamps in SQLite before work begins.\",\n ],\n },\n {\n key: \"email\",\n title: \"Email trigger\",\n badge: \"inbound/outbound\",\n summary:\n \"email.ts handles inbound mail and exports simple outbound helpers.\",\n files: [\"email.ts\", \"backend/shared.ts\"],\n points: [\n \"Inbound address shape: .@valtown.email.\",\n \"Free plans send outbound mail to yourself; Pro can send to anyone.\",\n \"Attachments are File objects; save them to Blob if needed.\",\n \"Do not expose email-sending HTTP routes without auth.\",\n ],\n },\n {\n key: \"blob\",\n title: \"Blob storage\",\n badge: \"account scoped\",\n summary:\n \"backend/storage.ts wraps Val Town Blob for JSON, text, list, and delete.\",\n files: [\"backend/storage.ts\"],\n points: [\n \"Blob is shared across all vals in the account.\",\n \"Namespace keys to avoid collisions, e.g. template/config.json.\",\n \"Use Blob for uploads, cached config, and cross-val state.\",\n \"Keep secrets in Val Town environment variables, not Blob.\",\n ],\n },\n {\n key: \"metadata\",\n title: \"File metadata\",\n badge: \"vt gotcha\",\n summary:\n \"Val Town trigger type is metadata; filenames only help when creating new remote files.\",\n files: [\"val.yml\", \"deno.json\"],\n points: [\n \"New files containing http, cron, or email infer HTTP, interval, or email type.\",\n \"Existing remote files keep sticky metadata; verify with vt types.\",\n \"val.yml files: records the intended trigger contract for this repo.\",\n \"deno.json carries Val Town types and must not fake external import maps.\",\n ],\n },\n];\n",[],[193,284,302],"091c33b8-4c96-11f1-9f2d-ee650bb23af1","components.tsx","091c3480-4c96-11f1-9f2d-ee650bb23af1",124,["D",1778434270660],"/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// components.tsx — Shared Preact primitives used across all pages.\n\nimport type { CodeSnippet } from \"./types.ts\";\n\n// ── PageHeader ────────────────────────────────────────────────────────────────\n\ninterface PageHeaderProps {\n eyebrow: string;\n title: string;\n desc: string;\n}\n\nexport function PageHeader({ eyebrow, title, desc }: PageHeaderProps) {\n return (\n \n );\n}\n\n// ── Badge ─────────────────────────────────────────────────────────────────────\n\ninterface BadgeProps {\n label: string;\n color?: \"default\" | \"green\" | \"blue\" | \"purple\" | \"red\";\n}\n\nexport function Badge({ label, color = \"default\" }: BadgeProps) {\n const cls = color === \"default\" ? \"badge\" : `badge badge-${color}`;\n return {label};\n}\n\n// ── SectionTitle ──────────────────────────────────────────────────────────────\n\nexport function SectionTitle({ children }: { children: string }) {\n return

{children}

;\n}\n\n// ── CodeBlock ─────────────────────────────────────────────────────────────────\n\nexport function CodeBlock({ filename, code }: CodeSnippet) {\n return (\n

\n {filename}\n \n

\n

\n );\n}\n\nfunction highlight(code: string): string {\n // Phase 1: escape HTML so < > & in code don't become tags.\n const escaped = code\n .replace(/&/g, \"&\")\n .replace(//g, \">\");\n\n // Phase 2: extract comments first so their content isn't re-tokenised.\n const withComments = escaped.replace(\n /(\\/\\/[^\\n]*)/g,\n '$1',\n );\n\n // Phase 3: tokenise everything outside of already-wrapped spans.\n return withComments\n .replace(\n /(?]*)([\"'`])(?:(?!\\1)[^\\\\]|\\\\.)*\\1(?![^<]*>)/g,\n (m) => `${m}`,\n )\n .replace(\n /(?]*)\\b(export|import|from|default|async|await|return|const|let|function|if|for|of|type|interface)\\b(?![^<]*>)/g,\n '$1',\n )\n .replace(\n /(?]*)\\b([A-Z][A-Za-z]{2,})\\b(?![^<]*>)/g,\n '$1',\n );\n}\n\n// ── DemoBox ───────────────────────────────────────────────────────────────────\n\ninterface DemoBoxProps {\n id: string;\n title: string;\n btnLabel: string;\n endpoint?: string;\n}\n\nexport function DemoBox({ id, title, btnLabel, endpoint }: DemoBoxProps) {\n return (\n

\n {title}\n \n

\n \n {btnLabel}\n \n

—

\n );\n}\n",[],[193,284,310],"4888d338-4b21-11f1-81f8-ee650bb23af1",82,["D",1778274174805],[227,228,229,230,231],[193,284],"09235bb6-4c96-11f1-987c-ee650bb23af1","page-email.tsx","09235c92-4c96-11f1-987c-ee650bb23af1","08e43bac-4c96-11f1-9b18-ee650bb23af1",125,["D",1778434270648],"/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// page-email.tsx — Email Trigger: inbound handler + outbound helpers.\n\nimport { Badge, CodeBlock, PageHeader, SectionTitle } from \"../ui/components.tsx\";\n\nconst INBOUND_SNIPPET = {\n filename: \"email.ts — inbound handler\",\n code: `import { type Email } from \"./backend/shared.ts\";\n\nexport default async function emailHandler(inbound: Email): Promise {\n console.log(\\`📧 From: \\${inbound.from} Subject: \\${inbound.subject}\\`);\n\n for (const file of inbound.attachments) {\n console.log(\\`📎 \\${file.name} (\\${file.size}b)\\`);\n // await blob.set(\\`emails/\\${file.name}\\`, await file.arrayBuffer());\n }\n}`,\n};\n\nconst OUTBOUND_SNIPPET = {\n filename: \"email.ts — sendNotification()\",\n code: `import { email as sendEmail } from \"https://esm.town/v/std/email\";\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}`,\n};\n\nconst TYPE_SNIPPET = {\n filename: \"backend/shared.ts — Email interface\",\n code: `export interface Email {\n from: string;\n to: string[];\n cc?: string | string[];\n subject?: string;\n text?: string;\n html?: string;\n attachments: File[];\n headers: Record;\n}`,\n};\n\nexport function EmailPage() {\n return (\n

\n .@valtown.email. The same file can also send outbound mail using @std/email.\"\n />\n\n Key rules\n

\n \n \n \n \n \n \n \n \n

Rule	Detail
	`<user>.<val>@valtown.email`
	Free plan: send to yourself only. Pro: send to anyone + cc/bcc
	Arrive as `File` objects — save to Blob if persistence needed
	Never expose email-sending via HTTP routes without auth

\n\n Email type\n \n\n Inbound handler\n \n\n Outbound helper\n \n

\n );\n}\n",[],[193,331,323],"pages","09169566-4c96-11f1-9b18-ee650bb23af1","page-cron.tsx","09169642-4c96-11f1-9b18-ee650bb23af1",123,["D",1778434270639],"/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// page-cron.tsx — Cron Trigger: interval gates, shouldRun pattern.\n\nimport { Badge, CodeBlock, PageHeader, SectionTitle } from \"../ui/components.tsx\";\n\nconst ENTRY_SNIPPET = {\n filename: \"cron.ts\",\n code: `export default async function (\n _interval: { lastRunAt: Date | undefined },\n): Promise {\n const now = new Date();\n await pulse(now); // fast polling / health checks\n await maintenance(now); // slow cleanup / digests\n}`,\n};\n\nconst GATE_SNIPPET = {\n filename: \"cron.ts — shouldRun()\",\n code: `// Gate: returns true only if intervalMs has elapsed since last run.\n// Records the new timestamp in SQLite before starting work so parallel\n// cold-starts do not double-fire.\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\nconst PULSE_SNIPPET = {\n filename: \"cron.ts — pulse()\",\n code: `async 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(\\`⚡ Pulse (\\${raw})\\`);\n // TODO: poll an external API, drain a work queue, etc.\n}`,\n};\n\nexport function CronPage() {\n return (\n

\n \n\n Key rules\n

\n \n \n \n \n \n \n \n \n

Constraint	Detail
	15 minutes — set in Val Town UI
	No timezone support — offset manually if needed
	One interval trigger per val — multiplex tasks inside it
	Gate tasks with `shouldRun()` so re-runs are safe

\n\n Entry point\n \n\n Interval gate pattern\n \n\n Pulse task\n \n\n

\n Env vars:{\" \"}\n Set CRON_PULSE_INTERVAL and CRON_MAINTENANCE_INTERVAL in the Val Town UI.\n Accepts 5m, 1h, 1d, or DISABLED.\n

\n );\n}\n",[],[193,331,333],"092bd1ba-4c96-11f1-b531-ee650bb23af1",["D",1778434270685],[],[193,331,33],"08e43ad0-4c96-11f1-9b18-ee650bb23af1",122,["D",1778434270310],[223,224,225],[193,331],["D",1778074991402],[222,226,232,233],[193],"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",[],[201,353],"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",[],[201,361],"a919ef02-4b17-11f1-bff1-ee650bb23af1","db.ts","aad2cfa2-48c5-11f1-bfb8-42b51c65c3df",59,["D",1778270041839],"// 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",[],[201,369],"0cde3714-4b8b-11f1-93fc-ee650bb23af1","api-utils.ts","491d0f08-4b21-11f1-8ab3-ee650bb23af1",110,["D",1778319601191],"// api-utils.ts — Tiny JSON response helpers for the HTTP trigger.\n\nexport type JsonObject = Record;\n\nexport function jsonError(message: string, status = 400): Response {\n return Response.json({ ok: false, error: message }, { status });\n}\n\nexport function jsonOk(data: JsonObject = {}): Response {\n return Response.json({ ok: true, ...data });\n}\n",[],[201,377],["D",1778074991756],[217,218,219,220],[201],["D",1777994172310],["D",1789511441255],{"_101":100,"_109":105},{"_101":100,"_102":103,"_104":105,"_18":56,"_106":107,"_108":24},{"_13":90,"_32":91,"_43":42,"_92":44,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":45,"_99":100},"ctx",{"_83":-5,"_129":425,"_426":427,"_428":429,"_430":24,"_431":24,"_432":24,"_433":60,"_434":-5,"_435":-7,"_436":-7,"_437":197,"_438":24,"_439":24,"_440":-5,"_441":24,"_442":24,"_443":24,"_444":-5},"ENV",{"_396":397,"_398":399,"_400":91,"_401":402,"_403":404,"_405":406,"_407":408,"_409":410,"_411":412,"_413":414,"_415":416,"_417":418,"_419":420,"_421":422,"_423":424},"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 · v126