toggle */\n.code-block--collapsible > .code-block-header{cursor:pointer;user-select:none;list-style:none}\n.code-block--collapsible > .code-block-header::before{content:\"▶\";font-size:.6rem;margin-right:6px;transition:transform .18s}\n.code-block--collapsible[open] > .code-block-header::before{transform:rotate(90deg)}\n.code-block--collapsible > .code-block-header::-webkit-details-marker{display:none}\n.code-block pre{\n padding:16px;overflow-x:auto;font-size:.83rem;line-height:1.7;\n color:var(--fg2);\n}\n.code-block pre .kw{color:var(--red)}\n.code-block pre .fn{color:var(--green)}\n.code-block pre .str{color:var(--yellow)}\n.code-block pre .cmt{color:var(--gray);font-style:italic}\n.code-block pre .type{color:var(--purple)}\n.code-block pre .num{color:var(--orange)}\n.copy-btn{\n background:none;border:1px solid var(--border);border-radius:4px;\n color:var(--muted);font-size:.72rem;padding:3px 8px;\n}\n.copy-btn:hover{border-color:var(--brand);color:var(--brand)}\n\n/* demo box ------------------------------------------------------------------ */\n.demo-box{\n border:1px solid var(--border);border-radius:8px;overflow:hidden;margin-top:16px;margin-bottom:4px;\n}\n.demo-box-header{\n display:flex;justify-content:space-between;align-items:center;\n padding:10px 14px;background:var(--bg2);border-bottom:1px solid var(--border);\n}\n.demo-box-title{font-size:.75rem;font-weight:700;color:var(--fg3);letter-spacing:.08em;text-transform:uppercase}\n.demo-box-body{padding:16px;min-height:60px}\n.demo-btn{\n background:var(--brand);color:var(--bg);border:none;border-radius:6px;\n padding:7px 16px;font-size:.83rem;font-weight:700;\n}\n.demo-btn:hover{filter:brightness(1.1)}\n.demo-btn:disabled{opacity:.5;cursor:not-allowed}\n.demo-output{\n margin-top:12px;background:var(--bg1);border:1px solid var(--border);\n border-radius:6px;padding:12px;font-size:.8rem;color:var(--aqua);\n min-height:36px;white-space:pre-wrap;word-break:break-all;\n}\n\n/* table --------------------------------------------------------------------- */\ntable{width:100%;border-collapse:collapse;font-size:.88rem;margin-top:16px;margin-bottom:4px}\nth{text-align:left;font-size:.72rem;letter-spacing:.1em;text-transform:uppercase;\n color:var(--muted);border-bottom:2px solid var(--border);padding:8px 12px}\ntd{padding:9px 12px;border-bottom:1px solid var(--border)}\ntr:last-child td{border-bottom:none}\ntd code{background:var(--bg2);border:1px solid var(--border);border-radius:4px;padding:1px 6px;color:var(--aqua)}\n\n/* alert --------------------------------------------------------------------- */\n.alert{\n border-radius:8px;border-left:3px solid var(--yellow);\n background:color-mix(in srgb,var(--yellow),transparent 90%);\n padding:12px 16px;font-size:.85rem;color:var(--fg2);margin-top:16px;margin-bottom:4px;\n}\n.alert strong{color:var(--yellow)}\n\n/* home grid ----------------------------------------------------------------- */\n.home-grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));margin-top:24px;margin-bottom:4px}\n.feature-card{\n background:var(--card);border:1px solid var(--border);border-radius:10px;\n padding:18px;cursor:pointer;\n transition:border-color .15s,box-shadow .15s;\n}\n.feature-card:hover{border-color:var(--brand);box-shadow:0 0 0 1px var(--brand)}\n.feature-card .fc-icon{font-size:1.5rem;margin-bottom:8px;display:block}\n.feature-card .fc-title{font-size:.95rem;font-weight:700;color:var(--fg)}\n.feature-card .fc-desc{font-size:.82rem;color:var(--muted);margin-top:4px}\n.feature-card .fc-badge{margin-top:10px}\n.render-stamp{margin-top:16px;font-size:.8rem;color:var(--muted)}\n\n/* theme showcase ------------------------------------------------------------ */\n.theme-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:12px;margin-top:16px}\n.theme-preview{\n border:2px solid var(--border);border-radius:8px;overflow:hidden;cursor:pointer;\n}\n.theme-preview.active{border-color:var(--brand)}\n.theme-preview-bar{height:6px}\n.theme-preview-body{padding:10px;font-size:.75rem}\n.theme-preview-name{font-weight:700}\n\n/* palette chips ------------------------------------------------------------- */\n.palette-row{display:flex;flex-wrap:wrap;gap:10px}\n.palette-row-second{margin-top:12px}\n.palette-note{margin-top:12px;font-size:.78rem;color:var(--muted)}\n.palette-chip{display:flex;flex-direction:column;align-items:center;gap:4px;min-width:48px}\n.palette-swatch{width:36px;height:36px;border-radius:6px;border:1px solid var(--border)}\n.palette-chip-label{font-size:.72rem;font-weight:700;color:var(--fg2)}\n.palette-chip-var{font-size:.65rem;color:var(--muted)}\n\n/* external links ------------------------------------------------------------ */\n.ext-link{color:var(--aqua);text-decoration:none;font-size:.85rem}\n.ext-link:hover{color:var(--brand);text-decoration:underline}\n.page-links{margin-top:20px;font-size:.83rem;color:var(--muted)}\n\n/* utility ------------------------------------------------------------------- */\n.hidden{display:none!important}\n.demo-btn--danger{background:var(--red)}\n.visit-count{font-size:.82rem;color:var(--muted)}\n/* flex rows for badge/button groups in showcase */\n.badge-row{display:flex;flex-wrap:wrap;gap:8px;margin-bottom:16px}\n.btn-row{display:flex;flex-wrap:wrap;gap:8px}\n\n/* form inputs --------------------------------------------------------------- */\n/* Shared styling for text inputs used in demo cards (blob write/read etc.) */\n.input-row{display:flex;gap:10px;flex-wrap:wrap;align-items:center;margin-bottom:10px}\n.field-input{\n flex:1;min-width:160px;padding:7px 10px;\n border-radius:6px;border:1px solid var(--border);\n background:var(--bg2);color:var(--fg);\n font:inherit;font-size:.85rem;\n}\n.field-input--wide{flex:2;min-width:200px}\n\n/* live log ------------------------------------------------------------------ */\n.log-table{width:100%;border-collapse:collapse;font-size:.82rem;margin-bottom:4px;font-family:inherit}\n.log-table th{text-align:left;font-size:.7rem;letter-spacing:.1em;text-transform:uppercase;\n color:var(--muted);border-bottom:2px solid var(--border);padding:7px 10px}\n.log-table td{padding:7px 10px;border-bottom:1px solid var(--border);vertical-align:top}\n.log-table tr:last-child td{border-bottom:none}\n.log-table .log-ts{color:var(--muted);font-size:.75rem;white-space:nowrap}\n.log-table .log-task{font-weight:700}\n.log-table .log-note{color:var(--fg3)}\n.log-empty{text-align:center;color:var(--muted);padding:24px 0;font-size:.85rem}\n\n/* mobile -------------------------------------------------------------------- */\n@media(max-width:720px){\n .sidebar{width:100%;height:auto;position:static;flex-direction:row;flex-wrap:wrap}\n .layout{flex-direction:column}\n .main{padding:20px 16px 48px}\n .theme-grid{grid-template-columns:repeat(2,1fr)}\n .nav{display:flex;flex-wrap:wrap;padding:6px}\n .nav-item{padding:7px 10px;border-left:none;border-bottom:2px solid transparent}\n .nav-item.active{border-bottom-color:var(--brand)}\n .sidebar-footer{width:100%;border-top:1px solid var(--border)}\n .sidebar-user{flex-wrap:wrap}\n}\n`;\n","createdAt",["D",1778824681490],"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=1789574399&sig=67f9b6600698dfc5b203d79273623337dc8781c1fa13c26b4da83a43b66dc826","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",{"_102":101,"_110":106},"org",{"_102":101,"_103":104,"_105":106,"_18":58,"_107":108,"_109":27},"branch",{"_13":91,"_33":92,"_45":44,"_93":46,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":-5,"_99":47,"_100":101},"isOwned",384,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","pikachu","handle","displayName","Minion","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/22c8ba37-42c8-4af4-8daf-8cdd2f5f1800/square512?exp=1789574399&sig=26b99949a2ca88c7e05246a2bdf6dd38bf543619a2fb4bc3ef1e317ca1f4008a","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_45":46,"_33":47,"_40":447,"_49":-5,"_50":27,"_51":52,"_53":52,"_54":55,"_56":57,"_18":58,"_59":60,"_61":25,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":448,"_74":-5,"_75":76,"_77":76,"_78":79,"_80":79,"_81":79,"_82":76,"_83":76,"_84":449,"_86":450,"_88":451,"_90":27},"tree",[217,224,241,242,243,244,245,246],"files",[217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246],"counts",{"_207":198,"_208":65,"_209":65,"_210":211,"_212":213},"contents",[133,134,135,136,137,138,139,140],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_45":201,"_33":202,"_31":203,"_144":-5,"_43":44,"_42":204,"_146":25,"_40":205,"_13":198,"_35":199,"_37":-5,"_24":27,"_150":-5,"_28":206},{"_45":193,"_33":194,"_31":195,"_144":-5,"_43":44,"_42":196,"_146":25,"_40":197,"_13":198,"_35":199,"_37":-5,"_24":27,"_150":-5,"_28":200},{"_45":186,"_33":187,"_31":188,"_144":-5,"_43":44,"_42":189,"_146":27,"_40":190,"_13":148,"_35":20,"_37":191,"_24":27,"_150":-5,"_28":192},{"_45":178,"_33":179,"_31":180,"_144":-5,"_43":44,"_42":181,"_146":27,"_40":182,"_13":166,"_35":183,"_37":184,"_24":27,"_150":-5,"_28":185},{"_45":170,"_33":171,"_31":172,"_144":-5,"_43":44,"_42":173,"_146":25,"_40":174,"_13":175,"_35":20,"_37":176,"_24":27,"_150":-5,"_28":177},{"_45":161,"_33":162,"_31":163,"_144":-5,"_43":44,"_42":164,"_146":27,"_40":165,"_13":166,"_35":167,"_37":168,"_24":27,"_150":-5,"_28":169},{"_45":152,"_33":153,"_31":60,"_144":-5,"_43":44,"_42":154,"_146":27,"_40":155,"_13":156,"_35":157,"_37":158,"_24":27,"_150":159,"_28":160},{"_45":141,"_33":142,"_31":143,"_144":-5,"_43":44,"_42":145,"_146":27,"_40":147,"_13":148,"_35":20,"_37":149,"_24":27,"_150":-5,"_28":151},"ea1ab588-4f02-11f1-8367-ee650bb23af1","val.yml","aa729402-48c5-11f1-87ca-42b51c65c3df","parentId",227,"latest",["D",1778700936112],7,"name: \"sample-val\"\npublic: true\n# Each file here is a service. Services share one isolated SQLite DB.\n# index.http.ts → HTTP service (SPA + API routes)\n# cron.ts → Cron service (scheduled tasks)\n# email.ts → Email service (inbound trigger + outbound helpers)\nfiles:\n index.http.ts: http\n cron.ts: interval\n email.ts: email\n# Env vars this App reads. Set them in the Val Town UI sidebar — never in code.\n# required: App will not work without it | optional: has a safe default\nenv:\n APP_NAME: optional # display/logging name (vtx new sets the code fallback)\n DAILY_HOUR_UTC: optional # 0-23 UTC hour for the daily cron task (default: \"2\")\n BLOB_DEMO_TOKEN: optional # protects public Blob demo read/write/list routes\n AUTH_ADMIN_USERS: optional # comma-separated Val Town usernames for admin routes\n","label",[142],"ea3f7d8c-4f02-11f1-8367-ee650bb23af1","index.http.ts",231,["D",1778700936360],13,"http","// index.http.ts — HTTP service: serves the Preact SPA and JSON APIs.\n// Docs: https://docs.val.town/vals/http\n\nimport {\n getCronRuns,\n getRecentVisits,\n getVisitCount,\n pruneOldVisits,\n recordVisit,\n} from \"./backend/db.ts\";\nimport { jsonError, jsonOk } from \"./backend/api-utils.ts\";\nimport {\n getAdminUc,\n getUc,\n isAuthError,\n type UserCtx,\n withValTownAuth,\n} from \"./backend/auth.ts\";\nimport { APP_NAME, env } from \"./backend/shared.ts\";\nimport { listKeys, loadJSON, saveJSON } from \"./backend/storage.ts\";\nimport { renderApp } from \"./frontend/app.tsx\";\n\n// Valid SPA page slugs — anything else falls back to \"home\".\n// Keep in sync with PAGES in frontend/client.ts.\nconst PAGES = new Set([\n \"home\",\n \"http\",\n \"sqlite\",\n \"cron\",\n \"email\",\n \"blob\",\n \"ui\",\n]);\n\n// -----------------------------------------------------------------------------\n// entry\n// -----------------------------------------------------------------------------\n\nasync function handler(req: Request): Promise {\n const url = new URL(req.url);\n if (url.pathname.startsWith(\"/api/\")) return await routeApi(req, url);\n return await serveSpa(req, url);\n}\n\nexport default withValTownAuth(handler);\n\n// Server reads theme from cookie and page from pathname — SSR is fully hydrated,\n// no client-side init script needed to avoid FOUC.\nasync function serveSpa(req: Request, url: URL): Promise {\n try {\n await recordVisit(url.pathname);\n } catch { /* off-platform */ }\n const theme = cookieTheme(req);\n const page = pathToPage(url.pathname);\n const html = renderApp({\n appName: APP_NAME,\n renderedAt: new Date().toISOString(),\n theme,\n page,\n });\n return new Response(html, {\n headers: { \"content-type\": \"text/html; charset=utf-8\" },\n });\n}\n\n/** Extract the `theme` cookie value, or empty string if absent. */\nfunction cookieTheme(req: Request): string {\n const cookie = req.headers.get(\"Cookie\") ?? \"\";\n const m = cookie.match(/(?:^|;\\s*)theme=([^;]+)/);\n return m ? safeDecodeURIComponent(m[1]) : \"\";\n}\n\nfunction safeDecodeURIComponent(value: string): string {\n try {\n return decodeURIComponent(value);\n } catch {\n return \"\";\n }\n}\n\n/** Map a URL pathname to a page slug. `/http` → `\"http\"`, `/` → `\"home\"`. */\nfunction pathToPage(pathname: string): string {\n const seg = pathname.slice(1); // strip leading /\n return PAGES.has(seg) ? seg : \"home\";\n}\n\n// -----------------------------------------------------------------------------\n// api routes\n// -----------------------------------------------------------------------------\n\ninterface RouteCtx {\n req: Request;\n url: URL;\n uc: UserCtx;\n}\n\ntype ApiHandler = (ctx: RouteCtx) => Response | Promise;\ntype UcResolver = (req: Request) => Promise;\n\ninterface ApiRoute {\n resolveUc: UcResolver;\n handle: ApiHandler;\n}\n\nconst API_ROUTES = new Map([\n [\"GET /api/health\", route(getUc, healthCheck)],\n [\"GET /api/me\", route((req) => getUc(req, true), me)],\n [\"GET /api/visits\", route(getUc, visits)],\n [\"POST /api/prune-visits\", route(getAdminUc, pruneVisits)],\n [\"GET /api/cron-runs\", route(getUc, cronRuns)],\n [\"GET /api/blob-keys\", route(getUc, blobKeys)],\n [\"POST /api/blob-write\", route(getUc, blobWrite)],\n [\"GET /api/blob-read\", route(getUc, blobRead)],\n]);\n\nasync function routeApi(req: Request, url: URL): Promise {\n const apiRoute = API_ROUTES.get(`${req.method} ${url.pathname}`);\n if (!apiRoute) return jsonError(`Not found: ${url.pathname}`, 404);\n\n try {\n const uc = await apiRoute.resolveUc(req);\n return await apiRoute.handle({ req, url, uc });\n } catch (error) {\n if (isAuthError(error)) return jsonError(error.message, error.status);\n throw error;\n }\n}\n\nfunction route(resolveUc: UcResolver, handle: ApiHandler): ApiRoute {\n return { resolveUc, handle };\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\nfunction me(ctx: RouteCtx): Response {\n return jsonOk({ user: ctx.uc.user, isAdmin: ctx.uc.isAdmin });\n}\n\nasync function visits(): Promise {\n try {\n const total = await getVisitCount();\n const recent = await getRecentVisits(20);\n return jsonOk({ total, recent });\n } catch {\n return jsonError(\"SQLite unavailable (off-platform?)\", 503);\n }\n}\n\nasync function pruneVisits(): Promise {\n try {\n await pruneOldVisits(30);\n return jsonOk({ pruned: \"visits older than 30 days\" });\n } catch {\n return jsonError(\"SQLite unavailable (off-platform?)\", 503);\n }\n}\n\nasync function cronRuns(): Promise {\n try {\n const runs = await getCronRuns(30);\n return jsonOk({ runs });\n } catch {\n return jsonError(\"SQLite unavailable (off-platform?)\", 503);\n }\n}\n\nasync function blobKeys(ctx: RouteCtx): Promise {\n const authError = blobAuthError(ctx.req);\n if (authError) return authError;\n try {\n const keys = await listKeys();\n return jsonOk({ keys });\n } catch {\n return jsonError(\"Blob unavailable (off-platform?)\", 503);\n }\n}\n\nfunction blobAuthError(req: Request): Response | null {\n const expected = env(\"BLOB_DEMO_TOKEN\");\n if (!expected) {\n return jsonError(\"Blob demo disabled: set BLOB_DEMO_TOKEN\", 403);\n }\n if (req.headers.get(\"x-demo-token\") !== expected) {\n return jsonError(\"Blob demo token required\", 401);\n }\n return null;\n}\n\nasync function blobWrite(ctx: RouteCtx): Promise {\n const authError = blobAuthError(ctx.req);\n if (authError) return authError;\n const req = ctx.req;\n try {\n const { key, value } = await req.json() as { key: string; value: unknown };\n if (!key) return jsonError(\"key required\");\n await saveJSON(key, value);\n return jsonOk({ key });\n } catch {\n return jsonError(\"Blob write failed\", 500);\n }\n}\n\nasync function blobRead(ctx: RouteCtx): Promise {\n const authError = blobAuthError(ctx.req);\n if (authError) return authError;\n const url = ctx.url;\n try {\n const key = url.searchParams.get(\"key\") ?? \"\";\n if (!key) return jsonError(\"key required\");\n const value = await loadJSON(key);\n return jsonOk({ key, value });\n } catch {\n return jsonError(\"Blob read failed\", 500);\n }\n}\n","d-template",[153],"a1efbd3e-4cb0-11f1-b51c-ee650bb23af1","email.ts","aa7742d6-48c5-11f1-831b-42b51c65c3df",183,["D",1778445693986],9,"email","// email.ts — Email service: inbound handler + outbound helpers.\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",[162],"e9ede3b4-4f02-11f1-8b31-ee650bb23af1","deno.json","86adc21c-4951-11f1-b797-42b51c65c3df",225,["D",1778700935796],3,"{\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 \"fmt\": {\n \"lineWidth\": 100\n },\n \"lint\": {\n \"rules\": {\n \"exclude\": [\n \"no-explicit-any\",\n \"no-external-import\",\n \"no-import-prefix\"\n ]\n }\n },\n \"node_modules_dir\": false,\n \"unstable\": [\"temporal\", \"worker-options\", \"sloppy-imports\", \"node-globals\"]\n}\n",[171],"ea1f8c34-4f02-11f1-ac5b-ee650bb23af1","cron.ts","aa651980-48c5-11f1-bfb8-42b51c65c3df",228,["D",1778700936143],"interval","// cron.ts — Cron service: pulse (every run) + daily (UTC-hour window).\n// Schedule is set in the Val Town UI via a cron expression. Free tier: ≥ 15 min.\n// Tasks are intentionally idempotent. Val Town fires each tick once; concurrent\n// cold-starts are rare but possible on Pro — design tasks to tolerate it.\n\nimport { APP_NAME, env } from \"./backend/shared.ts\";\nimport { logCronRun, pruneOldVisits } from \"./backend/db.ts\";\n\nexport default async function (\n interval: { lastRunAt: Date | undefined },\n): Promise {\n const now = new Date();\n await pulse(now);\n await daily(now, interval.lastRunAt);\n}\n\n// ── Pulse — runs on every cron tick ───────────────────────────────────────────\n// Good for health-checks, polling an external feed, draining a work queue.\n// Set the Val Town cron to your desired cadence (UI → val → Cron → expression).\n\nasync function pulse(now: Date): Promise {\n console.log(`⚡ [${APP_NAME}] pulse ${now.toISOString()}`);\n await logCronRun(\"pulse\", `hello at ${now.toISOString()}`);\n // TODO: replace with your high-frequency task\n // await fetch(\"https://api.example.com/feed\");\n}\n\n// ── Daily — runs once per day in a UTC-hour window ────────────────────────────\n// Uses Val Town's lastRunAt to run only on the first tick inside the target hour.\n// Env: DAILY_HOUR_UTC — which UTC hour to run (0-23, default \"2\").\n\nasync function daily(now: Date, lastRunAt: Date | undefined): Promise {\n const targetHour = Number(env(\"DAILY_HOUR_UTC\", \"2\"));\n if (!shouldRunDaily(now, lastRunAt, targetHour)) return;\n\n console.log(`🔧 [${APP_NAME}] daily ${now.toISOString()}`);\n await pruneOldVisits(30);\n await logCronRun(\"daily\", `pruned visits older than 30 days`);\n console.log(`✅ [${APP_NAME}] daily done`);\n}\n\nfunction shouldRunDaily(\n now: Date,\n lastRunAt: Date | undefined,\n targetHour: number,\n): boolean {\n if (now.getUTCHours() !== targetHour) return false;\n const target = new Date(Date.UTC(\n now.getUTCFullYear(),\n now.getUTCMonth(),\n now.getUTCDate(),\n targetHour,\n ));\n return !lastRunAt || lastRunAt < target;\n}\n",[179],"ea2afe7a-4f02-11f1-a378-ee650bb23af1","README.md","aabf7b64-48c5-11f1-9920-42b51c65c3df",229,["D",1778700936138],"# 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: `vtx new` sets the `APP_NAME` fallback; override with Val Town\n env if needed.\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",[187],"85f9d626-4951-11f1-a16a-42b51c65c3df","frontend","85f9d6f8-4951-11f1-a16a-42b51c65c3df",34,["D",1778074991402],0,"directory",[194],"86303568-4951-11f1-a193-42b51c65c3df","backend","8630361c-4951-11f1-a193-42b51c65c3df",35,["D",1778074991756],[202],"pulls","branches","forks","envVars",{"_214":65,"_216":198},"connections",{"_214":198,"_215":198},"count","unfilledCount","emptyCount",{"_45":201,"_33":202,"_31":203,"_144":-5,"_43":44,"_42":204,"_146":25,"_40":444,"_13":198,"_35":199,"_37":-5,"_24":27,"_150":-5,"_248":445,"_28":446},{"_45":436,"_33":437,"_31":438,"_144":203,"_43":44,"_42":439,"_146":27,"_40":440,"_13":65,"_35":36,"_37":441,"_24":27,"_150":-5,"_248":442,"_28":443},{"_45":428,"_33":429,"_31":430,"_144":203,"_43":44,"_42":431,"_146":27,"_40":432,"_13":198,"_35":36,"_37":433,"_24":27,"_150":-5,"_248":434,"_28":435},{"_45":419,"_33":420,"_31":421,"_144":203,"_43":44,"_42":422,"_146":27,"_40":423,"_13":424,"_35":36,"_37":425,"_24":27,"_150":-5,"_248":426,"_28":427},{"_45":411,"_33":412,"_31":413,"_144":203,"_43":44,"_42":414,"_146":27,"_40":415,"_13":198,"_35":36,"_37":416,"_24":27,"_150":-5,"_248":417,"_28":418},{"_45":403,"_33":404,"_31":405,"_144":203,"_43":44,"_42":406,"_146":27,"_40":407,"_13":148,"_35":36,"_37":408,"_24":27,"_150":-5,"_248":409,"_28":410},{"_45":395,"_33":396,"_31":397,"_144":203,"_43":44,"_42":398,"_146":27,"_40":399,"_13":166,"_35":36,"_37":400,"_24":27,"_150":-5,"_248":401,"_28":402},{"_45":193,"_33":194,"_31":195,"_144":-5,"_43":44,"_42":196,"_146":25,"_40":392,"_13":198,"_35":199,"_37":-5,"_24":27,"_150":-5,"_248":393,"_28":394},{"_45":387,"_33":337,"_31":331,"_144":195,"_43":44,"_42":388,"_146":25,"_40":389,"_13":198,"_35":199,"_37":-5,"_24":27,"_150":-5,"_248":390,"_28":391},{"_45":378,"_33":379,"_31":380,"_144":331,"_43":44,"_42":381,"_146":27,"_40":382,"_13":383,"_35":36,"_37":384,"_24":27,"_150":-5,"_248":385,"_28":386},{"_45":370,"_33":371,"_31":372,"_144":331,"_43":44,"_42":373,"_146":27,"_40":374,"_13":319,"_35":36,"_37":375,"_24":27,"_150":-5,"_248":376,"_28":377},{"_45":362,"_33":363,"_31":364,"_144":331,"_43":44,"_42":365,"_146":27,"_40":366,"_13":148,"_35":183,"_37":367,"_24":27,"_150":-5,"_248":368,"_28":369},{"_45":354,"_33":355,"_31":356,"_144":331,"_43":44,"_42":357,"_146":27,"_40":358,"_13":175,"_35":167,"_37":359,"_24":27,"_150":-5,"_248":360,"_28":361},{"_45":346,"_33":347,"_31":348,"_144":331,"_43":44,"_42":349,"_146":27,"_40":350,"_13":319,"_35":157,"_37":351,"_24":27,"_150":-5,"_248":352,"_28":353},{"_45":338,"_33":339,"_31":340,"_144":331,"_43":44,"_42":341,"_146":27,"_40":342,"_13":148,"_35":36,"_37":343,"_24":27,"_150":-5,"_248":344,"_28":345},{"_45":328,"_33":329,"_31":330,"_144":331,"_43":44,"_42":332,"_146":27,"_40":333,"_13":288,"_35":36,"_37":334,"_24":27,"_150":-5,"_248":335,"_28":336},{"_45":323,"_33":292,"_31":285,"_144":195,"_43":44,"_42":324,"_146":27,"_40":325,"_13":198,"_35":199,"_37":-5,"_24":27,"_150":-5,"_248":326,"_28":327},{"_45":314,"_33":315,"_31":316,"_144":285,"_43":44,"_42":317,"_146":27,"_40":318,"_13":319,"_35":36,"_37":320,"_24":27,"_150":-5,"_248":321,"_28":322},{"_45":306,"_33":307,"_31":308,"_144":285,"_43":44,"_42":309,"_146":27,"_40":310,"_13":198,"_35":36,"_37":311,"_24":27,"_150":-5,"_248":312,"_28":313},{"_45":301,"_33":34,"_31":32,"_144":285,"_43":44,"_42":14,"_146":27,"_40":302,"_13":303,"_35":36,"_37":39,"_24":27,"_150":-5,"_248":304,"_28":305},{"_45":293,"_33":294,"_31":295,"_144":285,"_43":44,"_42":296,"_146":27,"_40":297,"_13":198,"_35":36,"_37":298,"_24":27,"_150":-5,"_248":299,"_28":300},{"_45":282,"_33":283,"_31":284,"_144":285,"_43":44,"_42":286,"_146":27,"_40":287,"_13":288,"_35":36,"_37":289,"_24":27,"_150":-5,"_248":290,"_28":291},{"_45":274,"_33":275,"_31":276,"_144":195,"_43":44,"_42":277,"_146":27,"_40":278,"_13":166,"_35":36,"_37":279,"_24":27,"_150":-5,"_248":280,"_28":281},{"_45":266,"_33":267,"_31":268,"_144":195,"_43":44,"_42":269,"_146":27,"_40":270,"_13":166,"_35":36,"_37":271,"_24":27,"_150":-5,"_248":272,"_28":273},{"_45":186,"_33":187,"_31":188,"_144":-5,"_43":44,"_42":189,"_146":27,"_40":263,"_13":148,"_35":20,"_37":191,"_24":27,"_150":-5,"_248":264,"_28":265},{"_45":178,"_33":179,"_31":180,"_144":-5,"_43":44,"_42":181,"_146":27,"_40":260,"_13":166,"_35":183,"_37":184,"_24":27,"_150":-5,"_248":261,"_28":262},{"_45":170,"_33":171,"_31":172,"_144":-5,"_43":44,"_42":173,"_146":25,"_40":257,"_13":175,"_35":20,"_37":176,"_24":27,"_150":-5,"_248":258,"_28":259},{"_45":161,"_33":162,"_31":163,"_144":-5,"_43":44,"_42":164,"_146":27,"_40":254,"_13":166,"_35":167,"_37":168,"_24":27,"_150":-5,"_248":255,"_28":256},{"_45":152,"_33":153,"_31":60,"_144":-5,"_43":44,"_42":154,"_146":27,"_40":251,"_13":156,"_35":157,"_37":158,"_24":27,"_150":159,"_248":252,"_28":253},{"_45":141,"_33":142,"_31":143,"_144":-5,"_43":44,"_42":145,"_146":27,"_40":247,"_13":148,"_35":20,"_37":149,"_24":27,"_150":-5,"_248":249,"_28":250},["D",1778700936112],"children",[],[142],["D",1778700936360],[],[153],["D",1778445693986],[],[162],["D",1778700935796],[],[171],["D",1778700936143],[],[179],["D",1778700936138],[],[187],"e99b40e6-4f02-11f1-a378-ee650bb23af1","client.ts","48ed4cf0-4b21-11f1-b54f-ee650bb23af1",220,["D",1778700935281],"// client.ts — Path router, cookie-based theme switcher, per-page demo hydration.\n// Theme is set via a 1-year cookie (server reads it for zero-FOUC SSR).\n// Navigation uses history.pushState with real paths (/http, /sqlite, …).\n//\n// Note: clientJs is a raw JS string injected into

Diff · v236