[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_490":491,"_492":493},"routes/_app.x.$handle.$name",{"_103":102,"_33":47,"_112":93,"_27":113,"_13":14,"_114":-5,"_11":115,"_116":117,"_118":119,"_120":121,"_122":123,"_20":-5,"_124":-5,"_125":-5,"_126":25,"_127":128,"_129":62,"_130":-5,"_131":-5,"_132":133},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_45":46,"_33":47,"_40":48,"_49":-5,"_50":25,"_51":52,"_53":52,"_54":55,"_56":57,"_18":58,"_59":60,"_61":62,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":-5,"_76":77,"_78":77,"_79":80,"_81":80,"_82":80,"_83":77,"_84":77,"_85":86,"_87":88,"_89":90,"_91":25},"version",262,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":30},"file",{"_31":32,"_33":34,"_35":36,"_37":39,"_40":41,"_42":14,"_43":44,"_24":25},"previous",{"_31":32,"_33":34,"_35":36,"_37":38},"deleted",false,"deletedHere","path","frontend/pages/page-cron.tsx","latestPath","frontend/pages/docs/page-schedule.tsx","fileId","09169642-4c96-11f1-9b18-ee650bb23af1","name","page-cron.tsx","fileType","interval","content","/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// page-cron.tsx — Cron Trigger: live run log + task architecture.\n\nimport { Badge, CodeBlock, PageHeader, SectionTitle } from \"../ui/components.tsx\";\n\nconst LINKS = [\n { href: \"https://docs.val.town/vals/cron/\", label: \"Cron docs\" },\n { href: \"https://www.val.town/pricing\", label: \"Pricing\" },\n { href: \"https://www.val.town/limits\", label: \"Limits\" },\n];\n\n// ── Snippets ──────────────────────────────────────────────────────────────────\n\nconst ENTRY_SNIPPET = {\n filename: \"cron.ts — entry point\",\n code: `export default async function (\n _interval: { lastRunAt: Date | undefined },\n): Promise {\n const now = new Date();\n await pulse(now);\n await daily(now);\n}`,\n};\n\nconst PULSE_SNIPPET = {\n filename: \"cron.ts — pulse()\",\n code: `// Runs on every cron tick. Writes a hello log to SQLite.\nasync function pulse(now: Date): Promise {\n console.log(\\`⚡ [\\${APP_NAME}] pulse \\${now.toISOString()}\\`);\n await logCronRun(\"pulse\", \\`hello at \\${now.toISOString()}\\`);\n}`,\n};\n\nconst DAILY_SNIPPET = {\n filename: \"cron.ts — daily()\",\n code: `// Runs once per day when UTC hour matches DAILY_HOUR_UTC (default: 2).\n// Stateless — no SQLite gating needed.\nasync function daily(now: Date): Promise {\n const targetHour = Number(env(\"DAILY_HOUR_UTC\", \"2\"));\n if (now.getUTCHours() !== targetHour) return;\n await pruneOldVisits(30);\n await logCronRun(\"daily\", \"pruned visits older than 30 days\");\n}`,\n};\n\nconst LOG_SNIPPET = {\n filename: \"backend/db.ts — logCronRun()\",\n code: `export async function logCronRun(task: string, note?: string): Promise {\n await migrate();\n await sqlite.execute({\n sql: \"INSERT INTO cron_runs (task, note) VALUES (?, ?)\",\n args: [task, note ?? null],\n });\n}`,\n};\n\n// ── Page ──────────────────────────────────────────────────────────────────────\n\n/** ⚠️ I am a poorly written function... Please refactor me ⚠️ */\nexport function CronPage() {\n return (\n

\n \n\n Live run log\n

\n Loading…\n

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

Task	Note	Time (UTC)

\n\n Key rules\n

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

Constraint	Detail
	Set a standard cron expression (e.g. `/15 * * *`) in Val Town UI
	Free: 15 min · Pro: 1 min
	All times evaluated in UTC — offset in code for local time
	Multiplex tasks inside `cron.ts`; use a UTC-hour window for daily tasks
	Tasks should tolerate being called twice — Val Town doesn't guarantee exactly-once

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

\n );\n}\n","/** @jsxImportSource https://esm.sh/react@19.2.0 */\n// page-cron.tsx — Cron Trigger: live run log + task architecture.\n\nimport {\n Badge,\n Card,\n CodeBlock,\n Heading,\n Table,\n TableBody,\n TableCell,\n TableHeader,\n TableHeaderCell,\n TableRow,\n Text,\n VStack,\n} from \"../astryx/components.ts\";\nimport { PageLinks } from \"./kit.tsx\";\nimport type { CodeSnippet } from \"../types.ts\";\n\nconst LINKS = [\n { href: \"https://docs.val.town/vals/cron/\", label: \"Cron docs\" },\n { href: \"https://www.val.town/pricing\", label: \"Pricing\" },\n { href: \"https://www.val.town/limits\", label: \"Limits\" },\n];\n\nconst ENTRY_SNIPPET: CodeSnippet = {\n filename: \"cron.ts — entry point\",\n code: `export default async function (\n _interval: { lastRunAt: Date | undefined },\n): Promise {\n const now = new Date();\n await pulse(now);\n await daily(now);\n}`,\n};\n\nconst PULSE_SNIPPET: CodeSnippet = {\n filename: \"cron.ts — pulse()\",\n code: `// Runs on every cron tick. Writes a hello log to SQLite.\nasync function pulse(now: Date): Promise {\n console.log(\\`⚡ [\\${APP_NAME}] pulse \\${now.toISOString()}\\`);\n await logCronRun(\"pulse\", \\`hello at \\${now.toISOString()}\\`);\n}`,\n};\n\nconst DAILY_SNIPPET: CodeSnippet = {\n filename: \"cron.ts — daily()\",\n code: `// Runs once per day when UTC hour matches DAILY_HOUR_UTC (default: 2).\n// Stateless — no SQLite gating needed.\nasync function daily(now: Date): Promise {\n const targetHour = Number(env(\"DAILY_HOUR_UTC\", \"2\"));\n if (now.getUTCHours() !== targetHour) return;\n await pruneOldVisits(30);\n await logCronRun(\"daily\", \"pruned visits older than 30 days\");\n}`,\n};\n\nconst LOG_SNIPPET: CodeSnippet = {\n filename: \"backend/db.ts — logCronRun()\",\n code: `export async function logCronRun(task: string, note?: string): Promise {\n await migrate();\n await sqlite.execute({\n sql: \"INSERT INTO cron_runs (task, note) VALUES (?, ?)\",\n args: [task, note ?? null],\n });\n}`,\n};\n\nconst RULE_ROWS: {\n rule: string;\n variant: \"info\" | \"error\" | \"neutral\" | \"purple\" | \"success\";\n detail: string;\n}[] = [\n {\n rule: \"Schedule in UI\",\n variant: \"info\",\n detail: \"Set a standard cron expression (e.g. */15 * * * *) in Val Town UI\",\n },\n { rule: \"Min cadence\", variant: \"error\", detail: \"Free: 15 min · Pro: 1 min\" },\n {\n rule: \"Always UTC\",\n variant: \"neutral\",\n detail: \"All times evaluated in UTC — offset in code for local time\",\n },\n {\n rule: \"One trigger / App\",\n variant: \"purple\",\n detail: \"Multiplex tasks inside cron.ts; use a UTC-hour window for daily tasks\",\n },\n {\n rule: \"Idempotent\",\n variant: \"success\",\n detail: \"Tasks should tolerate being called twice — Val Town doesn't guarantee exactly-once\",\n },\n];\n\nexport function CronPage() {\n return (\n \n \n Cron Trigger\n \n One App gets one cron trigger. Its schedule is a standard cron expression set in the Val\n Town UI. Multiplex tasks inside cron.ts — each run logs itself to SQLite so you can\n inspect history here.\n \n \n \n\n \n Live run log\n \n \n Loading…\n \n \n \n Task\n Note\n Time (UTC)\n \n \n {null}\n

\n \n \n \n\n \n Key rules\n \n \n \n Constraint\n Detail\n \n \n \n {RULE_ROWS.map((r) => (\n \n \n \n \n {r.detail}\n \n ))}\n \n

\n \n\n \n \n \n \n \n );\n}\n","createdAt",["D",1788116689723],"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",{"_103":102,"_111":107},"org",{"_103":102,"_104":105,"_106":107,"_18":58,"_108":109,"_110":25},"branch",{"_13":92,"_33":93,"_45":44,"_94":46,"_95":-5,"_96":-5,"_97":-5,"_98":-5,"_99":-5,"_100":47,"_101":102},"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",{"_45":46,"_33":47,"_40":485,"_49":-5,"_50":25,"_51":52,"_53":52,"_54":55,"_56":57,"_18":58,"_59":60,"_61":62,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":72,"_73":486,"_75":-5,"_76":77,"_78":77,"_79":80,"_81":80,"_82":80,"_83":77,"_84":77,"_85":487,"_87":488,"_89":489,"_91":25},"tree",[217,224,245,246,247,248,249,250],"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,247,248,249,250],"counts",{"_207":198,"_208":66,"_209":66,"_210":211,"_212":213},"contents",[134,135,136,137,138,139,140,141],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_45":201,"_33":202,"_31":203,"_145":-5,"_43":44,"_42":204,"_147":62,"_40":205,"_13":198,"_35":199,"_37":-5,"_24":25,"_151":-5,"_27":206},{"_45":193,"_33":194,"_31":195,"_145":-5,"_43":44,"_42":196,"_147":62,"_40":197,"_13":198,"_35":199,"_37":-5,"_24":25,"_151":-5,"_27":200},{"_45":186,"_33":187,"_31":188,"_145":-5,"_43":44,"_42":189,"_147":25,"_40":190,"_13":149,"_35":20,"_37":191,"_24":25,"_151":-5,"_27":192},{"_45":179,"_33":180,"_31":181,"_145":-5,"_43":44,"_42":182,"_147":25,"_40":183,"_13":167,"_35":36,"_37":184,"_24":25,"_151":-5,"_27":185},{"_45":171,"_33":172,"_31":173,"_145":-5,"_43":44,"_42":174,"_147":62,"_40":175,"_13":176,"_35":20,"_37":177,"_24":25,"_151":-5,"_27":178},{"_45":162,"_33":163,"_31":164,"_145":-5,"_43":44,"_42":165,"_147":25,"_40":166,"_13":167,"_35":168,"_37":169,"_24":25,"_151":-5,"_27":170},{"_45":153,"_33":154,"_31":60,"_145":-5,"_43":44,"_42":155,"_147":25,"_40":156,"_13":157,"_35":158,"_37":159,"_24":25,"_151":160,"_27":161},{"_45":142,"_33":143,"_31":144,"_145":-5,"_43":44,"_42":146,"_147":25,"_40":148,"_13":149,"_35":20,"_37":150,"_24":25,"_151":-5,"_27":152},"08486638-5023-11f1-a5af-ee650bb23af1","val.yml","aa729402-48c5-11f1-87ca-42b51c65c3df","parentId",238,"latest",["D",1778824681802],8,"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_SUPER_ADMINS: optional # comma-separated Val Town usernames — these users are super-admins\n","label",[143],"0860ec3a-5023-11f1-a5af-ee650bb23af1","index.http.ts",241,["D",1778824681889],14,"http","// index.http.ts — HTTP entry point: SPA serving + API route table.\n// Handlers live in backend/handlers.ts; this file is pure wiring.\n// Docs: https://docs.val.town/vals/http\n\nimport { recordVisit } from \"./backend/db.ts\";\nimport {\n type ApiRoute,\n jsonError,\n route,\n} from \"./backend/api-utils.ts\";\nimport {\n getAdminUc,\n getSuperAdminUc,\n getUc,\n getUcWithTracking,\n isAuthError,\n type UserCtx,\n withValTownAuth,\n} from \"./backend/auth.ts\";\nimport {\n adminListUsers,\n adminSetAdmin,\n blobKeys,\n blobRead,\n blobWrite,\n cronRuns,\n healthCheck,\n me,\n pruneVisits,\n visits,\n} from \"./backend/handlers.ts\";\nimport { APP_NAME } from \"./backend/shared.ts\";\nimport { renderApp } from \"./frontend/app.tsx\";\nimport type { UserInfo } from \"./frontend/ui/types.ts\";\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([\"home\", \"http\", \"sqlite\", \"cron\", \"email\", \"blob\", \"ui\"]);\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// -----------------------------------------------------------------------------\n// SPA\n// -----------------------------------------------------------------------------\n\nasync function serveSpa(req: Request, url: URL): Promise {\n try { await recordVisit(url.pathname); } catch { /* off-platform */ }\n\n const uc = await getUcWithTracking(req);\n const html = renderApp({\n appName: APP_NAME,\n renderedAt: new Date().toISOString(),\n theme: cookieTheme(req),\n page: pathToPage(url.pathname),\n user: ucToUserInfo(uc),\n });\n return new Response(html, {\n headers: { \"content-type\": \"text/html; charset=utf-8\" },\n });\n}\n\n/** Map backend UserCtx → frontend UserInfo (layer boundary). */\nfunction ucToUserInfo(uc: UserCtx): UserInfo | null {\n if (!uc.user) return null;\n return {\n username: uc.user.username,\n avatarUrl: uc.user.avatarUrl,\n isAdmin: uc.isAdmin,\n isSuperAdmin: uc.isSuperAdmin,\n };\n}\n\nfunction cookieTheme(req: Request): string {\n const cookie = req.headers.get(\"Cookie\") ?? \"\";\n const m = cookie.match(/(?:^|;\\s*)theme=([^;]+)/);\n if (!m) return \"\";\n try { return decodeURIComponent(m[1]); } catch { return \"\"; }\n}\n\nfunction pathToPage(pathname: string): string {\n const seg = pathname.slice(1);\n return PAGES.has(seg) ? seg : \"home\";\n}\n\n// -----------------------------------------------------------------------------\n// API routing\n// -----------------------------------------------------------------------------\n\nconst API_ROUTES = new Map([\n [\"GET /api/health\", route(getUc, healthCheck)],\n [\"GET /api/me\", route(getUcWithTracking, 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 [\"GET /api/admin/users\", route(getSuperAdminUc, adminListUsers)],\n [\"POST /api/admin/set-admin\", route(getSuperAdminUc, adminSetAdmin)],\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","d-template",[154],"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",[163],"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",[172],"ea1f8c34-4f02-11f1-ac5b-ee650bb23af1","cron.ts","aa651980-48c5-11f1-bfb8-42b51c65c3df",228,["D",1778700936143],"// 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",[180],"58175df1-9bfa-4a64-a414-f5b71a992b1a","README.md","aabf7b64-48c5-11f1-9920-42b51c65c3df",252,["D",1788104438281],"# Val Town Reference Template\n\n`_template` is the executable reference and scaffold source for uApps vals. It demonstrates one HTTP\napplication with auth, APIs, SQLite, Blob, Cron, Email, SSR pages, and small browser controllers.\n\nThe current UI uses Preact and custom Gruvbox components. Its approved next design pass is the\nincremental migration in [`_specs/astryx-template.md`](../../_specs/astryx-template.md).\n\n`_template` is excluded from main-branch deployment because its directory starts with `_`.\n\n---\n\n## Create a Val\n\nFrom any directory after sourcing the uApps shell plugin:\n\n```bash\nvtx new my-app\ncd vals/my-app\nvtx status\nvtx push --dry-run\nvtx push\nvtx url\n```\n\n`vtx new` copies the template, replaces the application name and account-scoped Blob prefix, writes\nthe new `val.yml` name, and links the new remote val. Existing destinations are refused.\n\n## Application Shape\n\nThe HTTP entry wraps the app in Val Town OAuth, routes `/api/*` through typed auth boundaries, and\nrenders the selected SSR page for every other path.\n\nPages:\n\n- `/` — application and platform overview.\n- `/http` — HTTP routes and live request demos.\n- `/sqlite` — visit log and admin controls.\n- `/cron` — scheduled task history.\n- `/email` — inbound and outbound email examples.\n- `/blob` — token-protected Blob read/write/list demo.\n- `/ui` — current theme and component reference.\n\nAPI routes:\n\n| Method | Path | Access |\n| ------ | ---------------------- | ---------------------- |\n| `GET` | `/api/health` | Public |\n| `GET` | `/api/me` | Public session context |\n| `GET` | `/api/visits` | Public |\n| `POST` | `/api/prune-visits` | Admin |\n| `GET` | `/api/cron-runs` | Public |\n| `GET` | `/api/blob-keys` | Demo token |\n| `POST` | `/api/blob-write` | Demo token |\n| `GET` | `/api/blob-read` | Demo token |\n| `GET` | `/api/admin/users` | Super-admin |\n| `POST` | `/api/admin/set-admin` | Super-admin |\n\n## Runtime Configuration\n\nSet these in the created val's Val Town environment UI, never in Git or GitHub Actions:\n\n| Variable | Kind | Purpose |\n| ------------------- | -------- | ---------------------------------- |\n| `APP_NAME` | Optional | Display name override |\n| `DAILY_HOUR_UTC` | Optional | Daily task hour, `0`–`23` UTC |\n| `BLOB_DEMO_TOKEN` | Optional | Enables public Blob demo routes |\n| `AUTH_SUPER_ADMINS` | Optional | Comma-separated Val Town usernames |\n\nThe repository-level `VAL_TOWN_API_KEY` secret is only for CI deployment. See the root\n[`README.md`](../../README.md#cicd).\n\n## Trigger Contract\n\n`val.yml.files` declares the intended remote types:\n\n```yaml\nfiles:\n index.http.ts: http\n cron.ts: interval\n email.ts: email\n```\n\nRun `vtx types` after linking. Use `vtx apply-types` only when deliberately repairing remote trigger\nmetadata.\n\n## Architecture\n\n- `index.http.ts` — HTTP composition root and route table.\n- `backend/auth.ts` — OAuth context and role enforcement.\n- `backend/handlers.ts` — focused API handlers.\n- `backend/db.ts` — retryable migration, visits, Cron runs, and users.\n- `backend/storage.ts` — val-namespaced account Blob access.\n- `frontend/app.tsx` — Preact SSR composition root.\n- `frontend/pages/` — platform capability pages.\n- `frontend/ui/` — current components, sidebar, styles, themes, and types.\n- `frontend/client.ts` — non-hydrated theme, routing, and demo controllers.\n\nEvery TSX module containing JSX keeps its pinned `@jsxImportSource` pragma until the Astryx React\nmigration replaces Preact.\n\n## Key Files\n\n| Path | Purpose |\n| --------------------------------- | -------------------------------------------- |\n| `index.http.ts` | HTTP and API composition root |\n| `backend/auth.ts` | Val Town OAuth and roles |\n| `backend/db.ts` | Val-scoped SQLite repositories |\n| `backend/storage.ts` | Account-scoped Blob adapter |\n| `frontend/app.tsx` | Current Preact SSR root |\n| `frontend/pages/` | Interactive reference pages |\n| `frontend/client.ts` | Browser controllers |\n| `cron.ts` | Scheduled tasks |\n| `email.ts` | Email trigger and helpers |\n| `val.yml` | Identity, triggers, and environment contract |\n| `../../_specs/astryx-template.md` | Approved Astryx migration plan |\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":66,"_216":198},"connections",{"_214":198,"_215":198},"count","unfilledCount","emptyCount",{"_45":201,"_33":202,"_31":203,"_145":-5,"_43":44,"_42":204,"_147":62,"_40":482,"_13":198,"_35":199,"_37":-5,"_24":25,"_151":-5,"_252":483,"_27":484},{"_45":473,"_33":474,"_31":475,"_145":203,"_43":44,"_42":476,"_147":25,"_40":477,"_13":478,"_35":276,"_37":479,"_24":25,"_151":-5,"_252":480,"_27":481},{"_45":465,"_33":466,"_31":467,"_145":203,"_43":44,"_42":468,"_147":25,"_40":469,"_13":66,"_35":276,"_37":470,"_24":25,"_151":-5,"_252":471,"_27":472},{"_45":456,"_33":457,"_31":458,"_145":203,"_43":44,"_42":459,"_147":25,"_40":460,"_13":461,"_35":276,"_37":462,"_24":25,"_151":-5,"_252":463,"_27":464},{"_45":448,"_33":449,"_31":450,"_145":203,"_43":44,"_42":451,"_147":25,"_40":452,"_13":198,"_35":276,"_37":453,"_24":25,"_151":-5,"_252":454,"_27":455},{"_45":440,"_33":441,"_31":442,"_145":203,"_43":44,"_42":443,"_147":25,"_40":444,"_13":329,"_35":276,"_37":445,"_24":25,"_151":-5,"_252":446,"_27":447},{"_45":432,"_33":433,"_31":434,"_145":203,"_43":44,"_42":435,"_147":25,"_40":436,"_13":275,"_35":276,"_37":437,"_24":25,"_151":-5,"_252":438,"_27":439},{"_45":193,"_33":194,"_31":195,"_145":-5,"_43":44,"_42":196,"_147":62,"_40":429,"_13":198,"_35":199,"_37":-5,"_24":25,"_151":-5,"_252":430,"_27":431},{"_45":424,"_33":407,"_31":401,"_145":195,"_43":44,"_42":425,"_147":62,"_40":426,"_13":198,"_35":199,"_37":-5,"_24":25,"_151":-5,"_252":427,"_27":428},{"_45":416,"_33":417,"_31":418,"_145":401,"_43":44,"_42":419,"_147":25,"_40":420,"_13":198,"_35":276,"_37":421,"_24":25,"_151":-5,"_252":422,"_27":423},{"_45":408,"_33":409,"_31":410,"_145":401,"_43":44,"_42":411,"_147":25,"_40":412,"_13":198,"_35":276,"_37":413,"_24":25,"_151":-5,"_252":414,"_27":415},{"_45":398,"_33":399,"_31":400,"_145":401,"_43":44,"_42":402,"_147":62,"_40":403,"_13":198,"_35":276,"_37":404,"_24":25,"_151":-5,"_252":405,"_27":406},{"_45":393,"_33":348,"_31":341,"_145":195,"_43":44,"_42":394,"_147":62,"_40":395,"_13":198,"_35":199,"_37":-5,"_24":25,"_151":-5,"_252":396,"_27":397},{"_45":385,"_33":386,"_31":387,"_145":341,"_43":44,"_42":388,"_147":25,"_40":389,"_13":294,"_35":276,"_37":390,"_24":25,"_151":-5,"_252":391,"_27":392},{"_45":377,"_33":378,"_31":379,"_145":341,"_43":44,"_42":380,"_147":25,"_40":381,"_13":329,"_35":276,"_37":382,"_24":25,"_151":-5,"_252":383,"_27":384},{"_45":373,"_33":34,"_31":32,"_145":341,"_43":44,"_42":14,"_147":25,"_40":374,"_13":167,"_35":36,"_37":39,"_24":25,"_151":-5,"_252":375,"_27":376},{"_45":365,"_33":366,"_31":367,"_145":341,"_43":44,"_42":368,"_147":25,"_40":369,"_13":294,"_35":168,"_37":370,"_24":25,"_151":-5,"_252":371,"_27":372},{"_45":357,"_33":358,"_31":359,"_145":341,"_43":44,"_42":360,"_147":25,"_40":361,"_13":329,"_35":158,"_37":362,"_24":25,"_151":-5,"_252":363,"_27":364},{"_45":349,"_33":350,"_31":351,"_145":341,"_43":44,"_42":352,"_147":25,"_40":353,"_13":149,"_35":276,"_37":354,"_24":25,"_151":-5,"_252":355,"_27":356},{"_45":338,"_33":339,"_31":340,"_145":341,"_43":44,"_42":342,"_147":25,"_40":343,"_13":344,"_35":276,"_37":345,"_24":25,"_151":-5,"_252":346,"_27":347},{"_45":333,"_33":298,"_31":291,"_145":195,"_43":44,"_42":334,"_147":25,"_40":335,"_13":198,"_35":199,"_37":-5,"_24":25,"_151":-5,"_252":336,"_27":337},{"_45":324,"_33":325,"_31":326,"_145":291,"_43":44,"_42":327,"_147":25,"_40":328,"_13":329,"_35":276,"_37":330,"_24":25,"_151":-5,"_252":331,"_27":332},{"_45":316,"_33":317,"_31":318,"_145":291,"_43":44,"_42":319,"_147":25,"_40":320,"_13":66,"_35":276,"_37":321,"_24":25,"_151":-5,"_252":322,"_27":323},{"_45":307,"_33":308,"_31":309,"_145":291,"_43":44,"_42":310,"_147":25,"_40":311,"_13":312,"_35":276,"_37":313,"_24":25,"_151":-5,"_252":314,"_27":315},{"_45":299,"_33":300,"_31":301,"_145":291,"_43":44,"_42":302,"_147":25,"_40":303,"_13":198,"_35":276,"_37":304,"_24":25,"_151":-5,"_252":305,"_27":306},{"_45":288,"_33":289,"_31":290,"_145":291,"_43":44,"_42":292,"_147":25,"_40":293,"_13":294,"_35":276,"_37":295,"_24":25,"_151":-5,"_252":296,"_27":297},{"_45":280,"_33":281,"_31":282,"_145":195,"_43":44,"_42":283,"_147":25,"_40":284,"_13":275,"_35":276,"_37":285,"_24":25,"_151":-5,"_252":286,"_27":287},{"_45":270,"_33":271,"_31":272,"_145":195,"_43":44,"_42":273,"_147":25,"_40":274,"_13":275,"_35":276,"_37":277,"_24":25,"_151":-5,"_252":278,"_27":279},{"_45":186,"_33":187,"_31":188,"_145":-5,"_43":44,"_42":189,"_147":25,"_40":267,"_13":149,"_35":20,"_37":191,"_24":25,"_151":-5,"_252":268,"_27":269},{"_45":179,"_33":180,"_31":181,"_145":-5,"_43":44,"_42":182,"_147":25,"_40":264,"_13":167,"_35":36,"_37":184,"_24":25,"_151":-5,"_252":265,"_27":266},{"_45":171,"_33":172,"_31":173,"_145":-5,"_43":44,"_42":174,"_147":62,"_40":261,"_13":176,"_35":20,"_37":177,"_24":25,"_151":-5,"_252":262,"_27":263},{"_45":162,"_33":163,"_31":164,"_145":-5,"_43":44,"_42":165,"_147":25,"_40":258,"_13":167,"_35":168,"_37":169,"_24":25,"_151":-5,"_252":259,"_27":260},{"_45":153,"_33":154,"_31":60,"_145":-5,"_43":44,"_42":155,"_147":25,"_40":255,"_13":157,"_35":158,"_37":159,"_24":25,"_151":160,"_252":256,"_27":257},{"_45":142,"_33":143,"_31":144,"_145":-5,"_43":44,"_42":146,"_147":25,"_40":251,"_13":149,"_35":20,"_37":150,"_24":25,"_151":-5,"_252":253,"_27":254},["D",1778824681802],"children",[],[143],["D",1778824681889],[],[154],["D",1778445693986],[],[163],["D",1778700935796],[],[172],["D",1778700936143],[],[180],["D",1788104438281],[],[187],"4f2fa568-b5c5-4d6b-9aa8-6d99344c1ec0","client.ts","48ed4cf0-4b21-11f1-b54f-ee650bb23af1",260,["D",1788116689438],10,"script","// client.ts — Small per-page demo wiring. No router, no theme JS: navigation\n// is real page loads and the theme switch is a plain HTML form\n// (see astryx/shell.tsx) — both work with JavaScript disabled.\n//\n// Note: clientJs is a raw JS string injected into

Diff · v262