[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_311":312,"_313":314},"routes/_app.x.$handle.$name",{"_101":100,"_32":46,"_110":91,"_27":111,"_13":14,"_112":-5,"_11":113,"_114":115,"_116":117,"_118":119,"_120":121,"_20":-5,"_122":-5,"_123":-5,"_124":25,"_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",{"_44":45,"_32":46,"_39":47,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_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":25},"version",22,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":38,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","lib/admin/auth.ts","latestPath","fileId","6e1ecc30-5d3f-11f1-9656-1607ee4eb77e","name","auth.ts","fileType","script","content","/** Admin authorization helpers for browser OAuth and bearer-token API access. */\n\nimport { getOAuthUserData, oauthMiddleware } from \"https://esm.town/v/std/oauth/middleware.ts\";\n\nexport interface AdminSession {\n username: string;\n}\n\nexport class AuthError extends Error {\n constructor(message: string, readonly status: number) {\n super(message);\n this.name = \"AuthError\";\n }\n}\n\nexport function withValTownAuth(\n handler: (req: Request) => Response | Promise,\n): (req: Request) => Promise {\n return oauthMiddleware(handler) as (req: Request) => Promise;\n}\n\nexport async function requireAdminAccess(req: Request): Promise {\n if (hasAdminToken(req)) return;\n await requireAdminSession(req);\n}\n\nexport async function requireAdminSession(req: Request): Promise {\n const expected = requiredEnv(\"ADMIN_USERNAME\");\n const session = await resolveAdminSession(req);\n if (!session) throw new AuthError(\"Sign in with Val Town\", 401);\n if (norm(session.username) !== norm(expected)) {\n throw new AuthError(\"Admin access required\", 403);\n }\n return session;\n}\n\nexport async function resolveAdminSession(\n req: Request,\n): Promise {\n try {\n const session = await getOAuthUserData(req);\n const user: Record = isRecord(session?.user) ? session.user : {};\n const username = str(user.username) ?? str(user.handle);\n return username ? { username } : null;\n } catch {\n return null;\n }\n}\n\nfunction hasAdminToken(req: Request): boolean {\n const expected = requiredEnv(\"ADMIN_TOKEN\");\n const auth = req.headers.get(\"authorization\") ?? \"\";\n const bearer = auth.startsWith(\"Bearer \") ? auth.slice(\"Bearer \".length) : \"\";\n const headerToken = req.headers.get(\"x-admin-token\") ?? \"\";\n return bearer === expected || headerToken === expected;\n}\n\nfunction requiredEnv(key: string): string {\n const value = Deno.env.get(key);\n if (!value) throw new Error(`${key} is required`);\n return value;\n}\n\nfunction norm(value: string): string {\n return value.trim().toLowerCase();\n}\n\nfunction str(value: unknown): string | undefined {\n return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction isRecord(value: unknown): value is Record {\n return typeof value === \"object\" && value !== null;\n}\n","/** Admin authorization helpers for browser OAuth and bearer-token API access. */\n\nimport { getOAuthUserData, oauthMiddleware } from \"https://esm.town/v/std/oauth/middleware.ts\";\n\nexport interface AdminSession {\n username: string;\n}\n\nexport class AuthError extends Error {\n constructor(message: string, readonly status: number) {\n super(message);\n this.name = \"AuthError\";\n }\n}\n\nexport function withValTownAuth(\n handler: (req: Request) => Response | Promise,\n): (req: Request) => Promise {\n return oauthMiddleware(handler) as (req: Request) => Promise;\n}\n\nexport async function requireAdminAccess(req: Request): Promise {\n if (hasAdminToken(req)) return;\n await requireAdminSession(req);\n}\n\nexport async function requireAdminSession(req: Request): Promise {\n const expected = adminUsername();\n const session = await resolveAdminSession(req);\n if (!session) throw new AuthError(\"Sign in with Val Town\", 401);\n if (norm(session.username) !== norm(expected)) {\n throw new AuthError(\"Admin access required\", 403);\n }\n return session;\n}\n\nexport async function resolveAdminSession(\n req: Request,\n): Promise {\n try {\n const session = await getOAuthUserData(req);\n const user: Record = isRecord(session?.user) ? session.user : {};\n const username = str(user.username) ?? str(user.handle);\n return username ? { username } : null;\n } catch {\n return null;\n }\n}\n\nfunction hasAdminToken(req: Request): boolean {\n const expected = Deno.env.get(\"ADMIN_TOKEN\");\n if (!expected) return false;\n const auth = req.headers.get(\"authorization\") ?? \"\";\n const bearer = auth.startsWith(\"Bearer \") ? auth.slice(\"Bearer \".length) : \"\";\n const headerToken = req.headers.get(\"x-admin-token\") ?? \"\";\n return bearer === expected || headerToken === expected;\n}\n\nfunction adminUsername(): string {\n const value = Deno.env.get(\"ADMIN_USERNAME\");\n if (!value) {\n throw new AuthError(\"Set ADMIN_USERNAME in Val Town environment variables\", 403);\n }\n return value;\n}\n\nfunction norm(value: string): string {\n return value.trim().toLowerCase();\n}\n\nfunction str(value: unknown): string | undefined {\n return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction isRecord(value: unknown): value is Record {\n return typeof value === \"object\" && value !== null;\n}\n","createdAt",["D",1780266279988],"branchVersion","branchId","84bf5548-5d37-11f1-b50f-1607ee4eb77e","id","84bea404-5d37-11f1-b50f-1607ee4eb77e","reminders",["D",1780262845686],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","A personal app to remind of important events in life","imageUrl","173e7424-8658-428f-a3bc-ae4faeaabd1c","pinnedFileId","85a5e346-5d37-11f1-9b30-1607ee4eb77e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019df771-9af8-7238-99a4-541e39355038","tursoName","84bea4045d3711f1b50f1607ee4eb77e","tursoHostname","84bea4045d3711f1b50f1607ee4eb77e-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789508444194],"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":25},"branch",{"_13":90,"_32":91,"_44":43,"_92":45,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":46,"_99":100},"isOwned",33,"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=1789552799&sig=82a28363f343ba695ca10fe35a35700cdfcba35f6b0e43e177586a9bfd737dba","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_44":45,"_32":46,"_39":306,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":307,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":308,"_85":309,"_87":310,"_89":25},"tree",[196,207,208,209,210,211],"files",[196,197,198,199,200,201,202,203,204,205,206,207,208,209,210,211],"counts",{"_186":64,"_187":145,"_188":64,"_189":190,"_191":192},"contents",[132,133,134,135,136,137],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":180,"_32":181,"_30":182,"_141":-5,"_42":43,"_41":145,"_143":60,"_39":183,"_13":64,"_34":184,"_36":-5,"_24":25,"_147":-5,"_27":185},{"_44":173,"_32":174,"_30":175,"_141":-5,"_42":43,"_41":176,"_143":25,"_39":177,"_13":145,"_34":20,"_36":178,"_24":25,"_147":-5,"_27":179},{"_44":166,"_32":167,"_30":168,"_141":-5,"_42":43,"_41":169,"_143":60,"_39":170,"_13":64,"_34":20,"_36":171,"_24":25,"_147":-5,"_27":172},{"_44":157,"_32":158,"_30":58,"_141":-5,"_42":43,"_41":159,"_143":25,"_39":160,"_13":161,"_34":162,"_36":163,"_24":25,"_147":164,"_27":165},{"_44":149,"_32":150,"_30":151,"_141":-5,"_42":43,"_41":152,"_143":60,"_39":153,"_13":64,"_34":154,"_36":155,"_24":25,"_147":-5,"_27":156},{"_44":138,"_32":139,"_30":140,"_141":-5,"_42":43,"_41":142,"_143":25,"_39":144,"_13":145,"_34":20,"_36":146,"_24":25,"_147":-5,"_27":148},"6e4919fe-5d3f-11f1-bdd9-1607ee4eb77e","val.yml","85c55e9c-5d37-11f1-8c4a-1607ee4eb77e","parentId",18,"latest",["D",1780266243883],1,"name: \"reminders\"\npublic: true\nunlisted: false\norg: \"me\"\nfiles:\n reminder-api.http.ts: http\n reminder-check.cron.ts: interval\nenv:\n ADMIN_USERNAME: required # Val Town username allowed to see the admin UI\n ADMIN_TOKEN: required # bearer token for direct API access\n TELEGRAM_BOT_TOKEN: required # Telegram bot token\n TELEGRAM_CHAT_ID: required # destination chat/channel id\n LOOKAHEAD_DAYS: optional # default 8\n DRY_RUN: optional # true skips Telegram send and returns/logs message\n","label",[139],"85bfd332-5d37-11f1-a35f-1607ee4eb77e","reminder-check.cron.ts","85bfd418-5d37-11f1-a35f-1607ee4eb77e",3,["D",1780262847362],"interval","/** Daily cron entrypoint for look-ahead reminders and Telegram delivery. */\n\nimport { listPeople } from \"./lib/db.ts\";\nimport { upcomingReminderEvents } from \"./lib/dates.ts\";\nimport {\n formatReminderMessage,\n hasMeaningfulReminderMessage,\n} from \"./lib/messages.ts\";\nimport { sendTelegramMessage } from \"./lib/telegram.ts\";\nimport type { ReminderCheckResult } from \"./lib/types.ts\";\n\nexport default async function reminderCheck(\n req?: Request,\n): Promise {\n const result = await runReminderCheck({\n dryRun: isDryRun(req),\n lookaheadDays: lookaheadDaysFromEnv(),\n startDate: new Date(),\n });\n console.log(result.message);\n return result;\n}\n\nexport async function runReminderCheck(options: {\n dryRun: boolean;\n lookaheadDays: number;\n startDate: Date;\n}): Promise {\n const people = await listPeople();\n const events = upcomingReminderEvents(\n people,\n options.startDate,\n options.lookaheadDays,\n );\n const message = formatReminderMessage(events, options.lookaheadDays);\n const shouldSend = hasMeaningfulReminderMessage(events) && !options.dryRun;\n\n if (shouldSend) await sendTelegramMessage(message);\n return {\n lookaheadDays: options.lookaheadDays,\n dryRun: options.dryRun,\n events,\n message,\n sent: shouldSend,\n };\n}\n\nfunction lookaheadDaysFromEnv(): number {\n const raw = Number(Deno.env.get(\"LOOKAHEAD_DAYS\") ?? \"8\");\n if (!Number.isFinite(raw) || raw < 1) return 8;\n return Math.floor(raw);\n}\n\nfunction isDryRun(req?: Request): boolean {\n if (Deno.env.get(\"DRY_RUN\") === \"true\") return true;\n if (!req) return false;\n return new URL(req.url).searchParams.get(\"dryRun\") === \"1\";\n}\n",[150],"83ba13a6-5d3f-11f1-a999-1607ee4eb77e","reminder-api.http.ts",20,["D",1780266279938],2,"http","/** HTTP admin UI and CRUD API for the Val Town reminders SQLite people table. */\n\nimport { runAiCommand } from \"./lib/admin/ai.ts\";\nimport {\n AuthError,\n requireAdminAccess,\n requireAdminSession,\n withValTownAuth,\n} from \"./lib/admin/auth.ts\";\nimport { parsePeopleCsv } from \"./lib/admin/csv.ts\";\nimport {\n createPerson,\n deletePerson,\n getPerson,\n importPeople,\n listPeople,\n updatePerson,\n} from \"./lib/db.ts\";\nimport { renderAdminPage, renderLockedPage } from \"./lib/admin/ui.tsx\";\n\ntype RouteMatch = { id?: number };\n\nasync function handler(req: Request): Promise {\n try {\n return await routeRequest(req);\n } catch (err) {\n if (err instanceof AuthError) return jsonError(err.message, err.status);\n if (err instanceof Response) return err;\n const message = err instanceof Error ? err.message : String(err);\n return jsonError(message, 400);\n }\n}\n\nexport default withValTownAuth(handler);\n\nasync function routeRequest(req: Request): Promise {\n const url = new URL(req.url);\n\n if (req.method === \"GET\" && isAdminPage(url.pathname)) {\n return await adminPage(req);\n }\n if (req.method === \"POST\" && url.pathname === \"/people/import-csv\") {\n await requireAdminAccess(req);\n return await importCsvFromRequest(req);\n }\n if (req.method === \"POST\" && url.pathname === \"/ai\") {\n await requireAdminAccess(req);\n return await aiFromRequest(req);\n }\n\n const match = matchPeopleRoute(url.pathname);\n if (!match) return jsonError(\"not found\", 404);\n await requireAdminAccess(req);\n\n if (req.method === \"GET\" && match.id == null) {\n return jsonOk({ people: await listPeople() });\n }\n if (req.method === \"GET\" && match.id != null) {\n return await fetchPerson(match.id);\n }\n if (req.method === \"POST\" && match.id == null) {\n return await createFromRequest(req);\n }\n if (req.method === \"PUT\" && match.id != null) {\n return await updateFromRequest(req, match.id);\n }\n if (req.method === \"DELETE\" && match.id != null) {\n return await deleteFromRequest(match.id);\n }\n return jsonError(\"method not allowed\", 405);\n}\n\nfunction isAdminPage(pathname: string): boolean {\n return pathname === \"/\" || pathname === \"/admin\";\n}\n\nfunction matchPeopleRoute(pathname: string): RouteMatch | null {\n const parts = pathname.replace(/\\/+$/, \"\").split(\"/\").filter(Boolean);\n if (parts.length === 1 && parts[0] === \"people\") return {};\n if (parts.length === 2 && parts[0] === \"people\") {\n const id = Number(parts[1]);\n return Number.isInteger(id) && id > 0 ? { id } : null;\n }\n return null;\n}\n\nasync function adminPage(req: Request): Promise {\n try {\n const session = await requireAdminSession(req);\n const html = renderAdminPage(await listPeople(), session.username);\n return htmlResponse(html);\n } catch (err) {\n if (err instanceof AuthError) return htmlResponse(renderLockedPage(err.message), err.status);\n throw err;\n }\n}\n\nasync function fetchPerson(id: number): Promise {\n const person = await getPerson(id);\n return person ? jsonOk({ person }) : jsonError(\"person not found\", 404);\n}\n\nasync function createFromRequest(req: Request): Promise {\n const person = await createPerson(await req.json());\n return jsonOk({ person }, 201);\n}\n\nasync function updateFromRequest(req: Request, id: number): Promise {\n const person = await updatePerson(id, await req.json());\n return person ? jsonOk({ person }) : jsonError(\"person not found\", 404);\n}\n\nasync function deleteFromRequest(id: number): Promise {\n const deleted = await deletePerson(id);\n return deleted ? jsonOk({ deleted: true }) : jsonError(\"person not found\", 404);\n}\n\nasync function importCsvFromRequest(req: Request): Promise {\n const body = await req.json();\n const csv = typeof body.csv === \"string\" ? body.csv : \"\";\n if (!csv.trim()) throw new Error(\"csv is required\");\n\n const parsed = parsePeopleCsv(csv);\n const people = await importPeople(parsed.people);\n return jsonOk({ imported: people.length, skipped: parsed.skipped, people }, 201);\n}\n\nasync function aiFromRequest(req: Request): Promise {\n const body = await req.json();\n const query = typeof body.query === \"string\" ? body.query : \"\";\n const dryRun = body.dryRun === true;\n return jsonOk({ result: await runAiCommand({ query, dryRun }) });\n}\n\nfunction htmlResponse(html: string, status = 200): Response {\n return new Response(html, {\n status,\n headers: { \"content-type\": \"text/html; charset=utf-8\" },\n });\n}\n\nfunction jsonOk(data: Record, status = 200): Response {\n return Response.json({ ok: true, ...data }, { status });\n}\n\nfunction jsonError(message: string, status: number): Response {\n return Response.json({ ok: false, error: message }, { status });\n}\n","my-reminders",[158],"85cdbe66-5d37-11f1-940a-1607ee4eb77e","deno.json","85cdbf10-5d37-11f1-940a-1607ee4eb77e",5,["D",1780262847362],"{\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\": [\"https://www.val.town/types/valtown.d.ts\"],\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\": [\"no-external-import\", \"no-import-prefix\"]\n }\n },\n \"node_modules_dir\": false,\n \"unstable\": [\"temporal\", \"worker-options\", \"sloppy-imports\", \"node-globals\"]\n}\n",[167],"6e5ec92a-5d3f-11f1-9656-1607ee4eb77e","README.md","86341fbc-5d37-11f1-8021-1607ee4eb77e",19,["D",1780266244109],"# Reminders\n\nSQLite-backed birthday and anniversary reminders for Val Town.\n\nThis val is intentionally small: one HTTP admin UI/API, one daily cron checker, pure date/message\nhelpers, and inline Telegram delivery.\n\nThis repo owns the app-specific reminder port. The sibling uApps repo owns the shared `vtx` wrapper\nplus reusable Val Town templates/examples such as `$HOME/minion/uApps/vals/_template/` and\n`$HOME/minion/uApps/vals/null-css/`.\n\n## Files\n\n```text\nreminders/\n├── lib/\n│ ├── admin/\n│ │ ├── ai.ts # GPT command endpoint helpers\n│ │ ├── auth.ts # Val Town OAuth + bearer token admin auth\n│ │ ├── csv.ts # CSV schema import parser\n│ │ └── ui.tsx # Preact SSR + null-css admin UI\n│ ├── db.ts # SQLite schema + CRUD helpers\n│ ├── dates.ts # pure look-ahead date calculations\n│ ├── messages.ts # pure Telegram message formatting\n│ ├── telegram.ts # Bot API fetch helper\n│ └── types.ts # Person and reminder event types\n├── reminder-api.http.ts # HTTP admin UI, CRUD, CSV, and AI API\n├── reminder-check.cron.ts # daily reminder check\n├── deno.json # Deno/Val Town typecheck config\n├── val.yml # Val Town metadata\n└── README.md\n```\n\n## Environment\n\nSet these in the Val Town UI.\n\n| Variable | Required | Purpose |\n| ------------------ | -------- | --------------------------------------------- |\n| ADMIN_USERNAME | yes | Val Town username allowed to see the admin UI |\n| ADMIN_TOKEN | yes | Bearer token for direct API routes |\n| TELEGRAM_BOT_TOKEN | yes | Telegram BotFather token |\n| TELEGRAM_CHAT_ID | yes | Destination chat or channel id |\n| LOOKAHEAD_DAYS | no | Days to scan, default `8` |\n| DRY_RUN | no | `true` skips Telegram delivery |\n\nThe AI endpoint uses Val Town's `std/openai` integration and does not need an OpenAI API key.\n\n## Admin UI\n\nVisit `/` or `/admin` and sign in with Val Town. The UI renders only for `ADMIN_USERNAME`. Direct\nAPI clients can use `ADMIN_TOKEN`.\n\nThe page supports:\n\n- listing, creating, editing, and deleting people\n- CSV upload with columns `name`, `nickName`, `birthdate`, `anniversary`, `isAccurate`, `relation`,\n `email`\n- AI commands that can dry-run or apply `save-row`, `update-row`, and `send-telegram` actions\n\n## API\n\nAll JSON API routes require either the admin Val Town browser session,\n`Authorization: Bearer `, or `X-Admin-Token: `.\n\n```bash\n# list people\ncurl \"$VAL_URL/people\" \\\n -H \"authorization: Bearer $ADMIN_TOKEN\"\n\n# create person\ncurl -X POST \"$VAL_URL/people\" \\\n -H \"authorization: Bearer $ADMIN_TOKEN\" \\\n -H \"content-type: application/json\" \\\n -d '{\"name\":\"Ada Lovelace\",\"birthdate\":\"1815-12-10\",\"relation\":\"history\"}'\n\n# update person\ncurl -X PUT \"$VAL_URL/people/1\" \\\n -H \"authorization: Bearer $ADMIN_TOKEN\" \\\n -H \"content-type: application/json\" \\\n -d '{\"nickName\":\"Ada\",\"isAccurate\":true}'\n\n# delete person\ncurl -X DELETE \"$VAL_URL/people/1\" \\\n -H \"authorization: Bearer $ADMIN_TOKEN\"\n\n# import CSV\ncurl -X POST \"$VAL_URL/people/import-csv\" \\\n -H \"authorization: Bearer $ADMIN_TOKEN\" \\\n -H \"content-type: application/json\" \\\n -d '{\"csv\":\"name,nickName,birthdate,anniversary,isAccurate,relation,email\\nAda,,1815-12-10,,true,history,\"}'\n\n# AI command\ncurl -X POST \"$VAL_URL/ai\" \\\n -H \"authorization: Bearer $ADMIN_TOKEN\" \\\n -H \"content-type: application/json\" \\\n -d '{\"query\":\"Dry-run adding Ada Lovelace with birthday 1815-12-10\",\"dryRun\":true}'\n```\n\nPerson fields: `id`, `name`, `nickName`, `birthdate`, `anniversary`, `isAccurate`, `relation`,\n`email`.\n\nDates are stored as `YYYY-MM-DD`.\n\nLeap-day birthdays and anniversaries are reminded on Feb 28 in non-leap years.\n\n## Local Validation\n\nUse the uApps `vtx` wrapper. Local discovery and validation are safe. Source the toolbox shell first\nso the uApps plugin exposes `vtx`.\n\n```bash\n[[ -n \"$ZSH_VERSION\" && -z \"$TBX_SHELL_INSTALLED\" ]] && source \"$HOME/.zshrc\" 2>/dev/null || true\ncd \"$TOOLBOX/exp/vals/reminders\"\n\nvtx ls\nvtx map\nvtx check\nvtx env\n```\n\n## Cron Type Check\n\nThis checks the cron entrypoint without sending Telegram messages. A real dry run requires invoking\nthe linked Val Town val with `DRY_RUN=true` or `?dryRun=1`.\n\n```bash\ncd \"$TOOLBOX/exp/vals/reminders\"\nDRY_RUN=true LOOKAHEAD_DAYS=8 deno check --config deno.json reminder-check.cron.ts\n```\n\n## Remote Commands\n\nThese mutate Val Town remotely and require explicit approval for the turn:\n\n- `vtx new`\n- `vtx link`\n- `vtx push`\n- `vtx sync`\n- `vtx apply-types`\n- raw mutating `vt` commands\n",[174],"8584eb8c-5d37-11f1-9b30-1607ee4eb77e","lib","8584eca4-5d37-11f1-9b30-1607ee4eb77e",["D",1780262846974],"directory",[181],"pulls","branches","forks","envVars",{"_193":145,"_195":64},"connections",{"_193":64,"_194":64},"count","unfilledCount","emptyCount",{"_44":180,"_32":181,"_30":182,"_141":-5,"_42":43,"_41":145,"_143":60,"_39":303,"_13":64,"_34":184,"_36":-5,"_24":25,"_147":-5,"_213":304,"_27":305},{"_44":298,"_32":277,"_30":271,"_141":182,"_42":43,"_41":299,"_143":60,"_39":300,"_13":64,"_34":184,"_36":-5,"_24":25,"_147":-5,"_213":301,"_27":302},{"_44":290,"_32":291,"_30":292,"_141":271,"_42":43,"_41":293,"_143":25,"_39":294,"_13":64,"_34":35,"_36":295,"_24":25,"_147":-5,"_213":296,"_27":297},{"_44":286,"_32":33,"_30":31,"_141":271,"_42":43,"_41":14,"_143":60,"_39":287,"_13":145,"_34":35,"_36":38,"_24":25,"_147":-5,"_213":288,"_27":289},{"_44":278,"_32":279,"_30":280,"_141":271,"_42":43,"_41":281,"_143":60,"_39":282,"_13":64,"_34":35,"_36":283,"_24":25,"_147":-5,"_213":284,"_27":285},{"_44":268,"_32":269,"_30":270,"_141":271,"_42":43,"_41":272,"_143":25,"_39":273,"_13":145,"_34":35,"_36":274,"_24":25,"_147":-5,"_213":275,"_27":276},{"_44":260,"_32":261,"_30":262,"_141":182,"_42":43,"_41":263,"_143":25,"_39":264,"_13":64,"_34":35,"_36":265,"_24":25,"_147":-5,"_213":266,"_27":267},{"_44":252,"_32":253,"_30":254,"_141":182,"_42":43,"_41":255,"_143":25,"_39":256,"_13":64,"_34":35,"_36":257,"_24":25,"_147":-5,"_213":258,"_27":259},{"_44":244,"_32":245,"_30":246,"_141":182,"_42":43,"_41":247,"_143":25,"_39":248,"_13":64,"_34":35,"_36":249,"_24":25,"_147":-5,"_213":250,"_27":251},{"_44":236,"_32":237,"_30":238,"_141":182,"_42":43,"_41":239,"_143":60,"_39":240,"_13":64,"_34":35,"_36":241,"_24":25,"_147":-5,"_213":242,"_27":243},{"_44":228,"_32":229,"_30":230,"_141":182,"_42":43,"_41":231,"_143":25,"_39":232,"_13":64,"_34":35,"_36":233,"_24":25,"_147":-5,"_213":234,"_27":235},{"_44":173,"_32":174,"_30":175,"_141":-5,"_42":43,"_41":176,"_143":25,"_39":225,"_13":145,"_34":20,"_36":178,"_24":25,"_147":-5,"_213":226,"_27":227},{"_44":166,"_32":167,"_30":168,"_141":-5,"_42":43,"_41":169,"_143":60,"_39":222,"_13":64,"_34":20,"_36":171,"_24":25,"_147":-5,"_213":223,"_27":224},{"_44":157,"_32":158,"_30":58,"_141":-5,"_42":43,"_41":159,"_143":25,"_39":219,"_13":161,"_34":162,"_36":163,"_24":25,"_147":164,"_213":220,"_27":221},{"_44":149,"_32":150,"_30":151,"_141":-5,"_42":43,"_41":152,"_143":60,"_39":216,"_13":64,"_34":154,"_36":155,"_24":25,"_147":-5,"_213":217,"_27":218},{"_44":138,"_32":139,"_30":140,"_141":-5,"_42":43,"_41":142,"_143":25,"_39":212,"_13":145,"_34":20,"_36":146,"_24":25,"_147":-5,"_213":214,"_27":215},["D",1780266243883],"children",[],[139],["D",1780262847362],[],[150],["D",1780266279938],[],[158],["D",1780262847362],[],[167],["D",1780266244109],[],[174],"85e17fc8-5d37-11f1-80e4-1607ee4eb77e","types.ts","85e18090-5d37-11f1-80e4-1607ee4eb77e",7,["D",1780262847584],"/** Shared person and reminder event types for the Val Town reminders app. */\n\nexport interface Person {\n id: number;\n name: string;\n nickName: string;\n birthdate: string | null;\n anniversary: string | null;\n isAccurate: boolean;\n relation: string;\n email: string;\n}\n\nexport interface PersonInput {\n name: string;\n nickName?: string | null;\n birthdate?: string | null;\n anniversary?: string | null;\n isAccurate?: boolean | null;\n relation?: string | null;\n email?: string | null;\n}\n\nexport type PersonPatch = Partial;\n\nexport type ReminderKind = \"birthday\" | \"anniversary\";\n\nexport interface ReminderEvent {\n kind: ReminderKind;\n person: Person;\n date: string;\n mmdd: string;\n daysFromStart: number;\n isToday: boolean;\n years?: number;\n}\n\nexport interface ReminderCheckResult {\n lookaheadDays: number;\n dryRun: boolean;\n events: ReminderEvent[];\n message: string;\n sent: boolean;\n}\n",[],[181,229],"85f1eaa2-5d37-11f1-aa51-1607ee4eb77e","telegram.ts","85f1eb6a-5d37-11f1-aa51-1607ee4eb77e",9,["D",1780262847690],"/** Telegram Bot API delivery helper using only fetch and Val Town env vars. */\n\nexport interface TelegramConfig {\n token: string;\n chatId: string;\n}\n\nexport function telegramConfigFromEnv(): TelegramConfig {\n return {\n token: requiredEnv(\"TELEGRAM_BOT_TOKEN\"),\n chatId: requiredEnv(\"TELEGRAM_CHAT_ID\"),\n };\n}\n\nexport async function sendTelegramMessage(\n text: string,\n config = telegramConfigFromEnv(),\n): Promise {\n const res = await fetch(\n `https://api.telegram.org/bot${config.token}/sendMessage`,\n {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\" },\n body: JSON.stringify({\n chat_id: config.chatId,\n text,\n disable_web_page_preview: true,\n }),\n },\n );\n\n if (!res.ok) {\n const body = await res.text();\n throw new Error(`Telegram send failed (${res.status}): ${body}`);\n }\n}\n\nfunction requiredEnv(key: string): string {\n const value = Deno.env.get(key);\n if (!value) throw new Error(`${key} is required`);\n return value;\n}\n",[],[181,237],"85e9d4d4-5d37-11f1-ab82-1607ee4eb77e","messages.ts","85e9d57e-5d37-11f1-ab82-1607ee4eb77e",8,["D",1780262847559],"/** Plain-text reminder message formatting with no network dependencies. */\n\nimport type { ReminderEvent } from \"./types.ts\";\n\nexport function formatReminderMessage(\n events: ReminderEvent[],\n lookaheadDays: number,\n): string {\n if (events.length === 0) {\n return `No birthdays or anniversaries in the next ${lookaheadDays} days.`;\n }\n\n const rows = events.map(formatReminderEvent);\n return [\"Upcoming Reminders\", ...rows].join(\"\\n\");\n}\n\nexport function hasMeaningfulReminderMessage(events: ReminderEvent[]): boolean {\n return events.length > 0;\n}\n\nfunction formatReminderEvent(event: ReminderEvent): string {\n const icon = event.kind === \"birthday\" ? \"Birthday\" : \"Anniversary\";\n const name = event.person.nickName || event.person.name;\n const rel = event.person.relation ? ` (${event.person.relation})` : \"\";\n const today = event.isToday ? \" TODAY\" : \"\";\n const years = event.years && event.years > 0 ? `, ${event.years}y` : \"\";\n return `- [${\n formatDisplayDate(event.date)\n }] ${icon}: ${name}${rel}${today}${years}`;\n}\n\nfunction formatDisplayDate(isoDate: string): string {\n const date = new Date(`${isoDate}T12:00:00`);\n return new Intl.DateTimeFormat(\"en-US\", {\n month: \"short\",\n day: \"numeric\",\n }).format(date);\n}\n",[],[181,245],"85f85978-5d37-11f1-a234-1607ee4eb77e","db.ts","85f85a18-5d37-11f1-a234-1607ee4eb77e",10,["D",1780262847728],"/** SQLite schema and typed CRUD helpers for reminder people. */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport type { Person, PersonInput, PersonPatch } from \"./types.ts\";\n\nlet migrated = false;\n\nexport async function ensureSchema(): Promise {\n if (migrated) return;\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS people (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL,\n nick_name TEXT NOT NULL DEFAULT '',\n birthdate TEXT,\n anniversary TEXT,\n is_accurate INTEGER NOT NULL DEFAULT 0,\n relation TEXT NOT NULL DEFAULT '',\n email TEXT NOT NULL DEFAULT '',\n created_at TEXT NOT NULL DEFAULT (datetime('now')),\n updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n migrated = true;\n}\n\nexport async function listPeople(): Promise {\n await ensureSchema();\n const { rows } = await sqlite.execute(`\n SELECT id, name, nick_name, birthdate, anniversary, is_accurate, relation, email\n FROM people\n ORDER BY name COLLATE NOCASE\n `);\n return rows.map(rowToPerson);\n}\n\nexport async function getPerson(id: number): Promise {\n await ensureSchema();\n const { rows } = await sqlite.execute({\n sql: `\n SELECT id, name, nick_name, birthdate, anniversary, is_accurate, relation, email\n FROM people\n WHERE id = ?\n `,\n args: [id],\n });\n return rows.length ? rowToPerson(rows[0]) : null;\n}\n\nexport async function createPerson(input: PersonInput): Promise {\n await ensureSchema();\n const person = normalizePersonInput(input);\n const { lastInsertRowid } = await sqlite.execute({\n sql: `\n INSERT INTO people (name, nick_name, birthdate, anniversary, is_accurate, relation, email)\n VALUES (?, ?, ?, ?, ?, ?, ?)\n `,\n args: [\n person.name,\n person.nickName,\n person.birthdate,\n person.anniversary,\n person.isAccurate ? 1 : 0,\n person.relation,\n person.email,\n ],\n });\n return await mustGetPerson(Number(lastInsertRowid));\n}\n\nexport async function updatePerson(\n id: number,\n patch: PersonPatch,\n): Promise {\n await ensureSchema();\n const current = await getPerson(id);\n if (!current) return null;\n\n const next = normalizePersonInput({ ...current, ...patch });\n await sqlite.execute({\n sql: `\n UPDATE people\n SET name = ?,\n nick_name = ?,\n birthdate = ?,\n anniversary = ?,\n is_accurate = ?,\n relation = ?,\n email = ?,\n updated_at = datetime('now')\n WHERE id = ?\n `,\n args: [\n next.name,\n next.nickName,\n next.birthdate,\n next.anniversary,\n next.isAccurate ? 1 : 0,\n next.relation,\n next.email,\n id,\n ],\n });\n return await mustGetPerson(id);\n}\n\nexport async function deletePerson(id: number): Promise {\n await ensureSchema();\n const { rowsAffected } = await sqlite.execute({\n sql: `DELETE FROM people WHERE id = ?`,\n args: [id],\n });\n return rowsAffected > 0;\n}\n\nexport async function importPeople(people: PersonInput[]): Promise {\n const created: Person[] = [];\n for (const person of people) created.push(await createPerson(person));\n return created;\n}\n\nfunction normalizePersonInput(input: PersonInput): PersonInput {\n const name = text(input.name);\n if (!name) throw new Error(\"name is required\");\n\n return {\n name,\n nickName: text(input.nickName),\n birthdate: dateText(input.birthdate),\n anniversary: dateText(input.anniversary),\n isAccurate: input.isAccurate === true,\n relation: text(input.relation),\n email: text(input.email),\n };\n}\n\nasync function mustGetPerson(id: number): Promise {\n const person = await getPerson(id);\n if (!person) throw new Error(`person ${id} was not found after write`);\n return person;\n}\n\nfunction rowToPerson(row: ArrayLike): Person {\n return {\n id: Number(row[0]),\n name: String(row[1]),\n nickName: String(row[2] ?? \"\"),\n birthdate: nullableText(row[3]),\n anniversary: nullableText(row[4]),\n isAccurate: Number(row[5]) === 1,\n relation: String(row[6] ?? \"\"),\n email: String(row[7] ?? \"\"),\n };\n}\n\nfunction text(value: unknown): string {\n return typeof value === \"string\" ? value.trim() : \"\";\n}\n\nfunction nullableText(value: unknown): string | null {\n return typeof value === \"string\" && value.trim() ? value.trim() : null;\n}\n\nfunction dateText(value: unknown): string | null {\n const textValue = nullableText(value);\n if (!textValue) return null;\n const match = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(textValue);\n if (!match) {\n throw new Error(`invalid date '${textValue}', expected YYYY-MM-DD`);\n }\n const [, year, month, day] = match.map(Number);\n const date = new Date(year, month - 1, day, 12, 0, 0, 0);\n if (\n date.getFullYear() !== year || date.getMonth() !== month - 1 ||\n date.getDate() !== day\n ) {\n throw new Error(`invalid calendar date '${textValue}'`);\n }\n return textValue;\n}\n",[],[181,253],"85dae2b2-5d37-11f1-a234-1607ee4eb77e","dates.ts","85dae37a-5d37-11f1-a234-1607ee4eb77e",6,["D",1780262847376],"/** Pure reminder date calculations for birthday and anniversary look-ahead. */\n\nimport type { Person, ReminderEvent, ReminderKind } from \"./types.ts\";\n\nexport function upcomingReminderEvents(\n people: Person[],\n startDate: Date,\n lookaheadDays: number,\n): ReminderEvent[] {\n const days = normalizeLookaheadDays(lookaheadDays);\n const dateByMmdd = new Map(\n dateRange(startDate, days).map((date, idx) => [\n monthDayKey(date),\n { date, idx },\n ]),\n );\n\n return people\n .flatMap((person) => eventsForPerson(person, dateByMmdd, startDate))\n .sort((a, b) =>\n a.daysFromStart - b.daysFromStart || a.kind.localeCompare(b.kind)\n );\n}\n\nexport function normalizeLookaheadDays(value: number): number {\n if (!Number.isFinite(value)) return 8;\n if (value < 1) return 1;\n return Math.floor(value);\n}\n\nexport function dateRange(startDate: Date, numberOfDays: number): Date[] {\n const days = normalizeLookaheadDays(numberOfDays);\n return Array.from({ length: days }, (_, idx) => {\n const date = new Date(startDate);\n date.setHours(12, 0, 0, 0);\n date.setDate(startDate.getDate() + idx);\n return date;\n });\n}\n\nexport function monthDayKey(date: Date): string {\n return `${date.getMonth()}-${date.getDate()}`;\n}\n\nexport function parseLocalDate(value: string | null): Date | null {\n if (!value) return null;\n const match = /^(\\d{4})-(\\d{2})-(\\d{2})/.exec(value);\n if (!match) return null;\n const [, year, month, day] = match;\n return new Date(Number(year), Number(month) - 1, Number(day), 12, 0, 0, 0);\n}\n\nfunction eventsForPerson(\n person: Person,\n dateByMmdd: Map,\n startDate: Date,\n): ReminderEvent[] {\n const candidates: Array<[ReminderKind, string | null]> = [\n [\"birthday\", person.birthdate],\n [\"anniversary\", person.anniversary],\n ];\n\n return candidates.flatMap(([kind, rawDate]) => {\n const sourceDate = parseLocalDate(rawDate);\n if (!sourceDate) return [];\n const due = dueDateFor(sourceDate, dateByMmdd);\n if (!due) return [];\n\n return [{\n kind,\n person,\n date: isoLocalDate(due.date),\n mmdd: monthDayKey(sourceDate),\n daysFromStart: due.idx,\n isToday: due.idx === 0,\n years: elapsedYears(sourceDate, startDate, due.date),\n }];\n });\n}\n\nfunction dueDateFor(\n sourceDate: Date,\n dateByMmdd: Map,\n): { date: Date; idx: number } | undefined {\n const exact = dateByMmdd.get(monthDayKey(sourceDate));\n if (exact) return exact;\n if (!isLeapDay(sourceDate)) return undefined;\n\n const feb28 = dateByMmdd.get(monthDayKey(new Date(2000, 1, 28, 12)));\n if (!feb28 || isLeapYear(feb28.date.getFullYear())) return undefined;\n return feb28;\n}\n\nfunction elapsedYears(\n sourceDate: Date,\n startDate: Date,\n dueDate: Date,\n): number | undefined {\n const years = dueDate.getFullYear() - sourceDate.getFullYear();\n return years >= 0 && dueDate >= startOfDay(startDate) ? years : undefined;\n}\n\nfunction isoLocalDate(date: Date): string {\n const year = date.getFullYear();\n const month = String(date.getMonth() + 1).padStart(2, \"0\");\n const day = String(date.getDate()).padStart(2, \"0\");\n return `${year}-${month}-${day}`;\n}\n\nfunction startOfDay(date: Date): Date {\n const copy = new Date(date);\n copy.setHours(0, 0, 0, 0);\n return copy;\n}\n\nfunction isLeapDay(date: Date): boolean {\n return date.getMonth() === 1 && date.getDate() === 29;\n}\n\nfunction isLeapYear(year: number): boolean {\n return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);\n}\n",[],[181,261],"83c19716-5d3f-11f1-b415-1607ee4eb77e","ui.tsx","6e28e06c-5d3f-11f1-9633-1607ee4eb77e","6df70132-5d3f-11f1-9656-1607ee4eb77e",21,["D",1780266279950],"/** Preact SSR admin UI using null-css tokens and compact local behavior. */\n\n/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n\nimport { render } from \"https://esm.sh/preact-render-to-string@6.6.7?deps=preact@10.29.1\";\nimport { NULL_CSS } from \"https://esm.town/v/uapps/null-css/core/main.ts\";\nimport type { ComponentChildren } from \"https://esm.sh/preact@10.29.1\";\nimport type { Person } from \"../types.ts\";\n\nexport function renderLockedPage(\n message = \"Sign in with the configured Val Town admin account.\",\n): string {\n return doc(\n

Reminders

{message}

\n Sign in with Val Town\n

,\n );\n}\n\nexport function renderAdminPage(people: Person[], username: string): string {\n return doc(\n

\n \n\n

\n \n \n \n \n Schema: name, nickName, birthdate, anniversary, isAccurate, relation, email\n \n \n \n

\n\n

People

\n \n \n \n \n \n \n \n \n \n \n \n \n \n {people.map((person) => )}\n \n

Name	Birthday	Anniversary	Relation	Email	Accurate	Actions

\n\n

Log

Ready.

,\n );\n}\n\nfunction Panel(props: { title: string; children: ComponentChildren }) {\n return (\n

{props.title}

\n {props.children}\n

\n );\n}\n\nfunction PersonFields() {\n return (\n <>\n \n \n Name \n \n \n Nickname \n \n \n Birthday \n \n \n Anniversary \n \n \n Relation \n \n \n Email \n \n \n Dates accurate\n \n \n );\n}\n\nfunction PersonRow({ person }: { person: Person }) {\n return (\n \n \n {person.name}\n {person.nickName\n ? (\n <>\n
\n {person.nickName}\n \n )\n : null}\n \n {person.birthdate ?? \"\"}\n {person.anniversary ?? \"\"}\n {person.relation}\n {person.email}\n {person.isAccurate ? \"yes\" : \"no\"}\n \n \n \n \n \n );\n}\n\nfunction doc(children: ComponentChildren): string {\n return \"\" + render(\n \n \n \n \n Reminders Admin\n

Diff · v22