{APP_NAME}

Call a function

\n Sends a live POST with your API key, straight to this endpoint. The information fns take\n their documented ~3s/~20s — the button stays disabled until the response lands.\n

\n\n \n {FN_SPECS.map((f) => (\n \n ))}\n \n\n \n \n\n

\n \n Body (JSON)\n

\n\n

\n \n

\n\n \n\n

Response

Response will appear here.

\n );\n}\n\n/** Inline client script: wires the picker + body to a live URL/token/curl\n * preview, and the Send button to a live fetch against this same origin. */\nexport function debugScript(apiKey: string): string {\n const samples = Object.fromEntries(FN_SPECS.map((f) => [f.path, f.sample]));\n const data = JSON.stringify({ key: apiKey, samples }).replace(/).\n// Admin UI → / (tabs), POST /settings, POST /api-key/regenerate — Val Town\n// OAuth, gated to the ADMIN_USERS allow-list (see backend/auth.ts).\n// This file is pure wiring; logic lives in backend/ and frontend/.\n\nimport { Hono } from \"npm:hono@^4\";\nimport type { Context, Next } from \"npm:hono@^4\";\nimport { isHttpError } from \"./backend/api.ts\";\nimport { authenticateApi, getAdminUc, withValTownAuth } from \"./backend/auth.ts\";\nimport { getInformationSlow } from \"./backend/fns/get-information-slow.ts\";\nimport { getInformation } from \"./backend/fns/get-information.ts\";\nimport { getUserDetails } from \"./backend/fns/get-user-details.ts\";\nimport { webhookHandler } from \"./backend/fns/webhook.ts\";\nimport { buildAdminView } from \"./backend/pages/admin.ts\";\nimport { regenerateApiKey, saveSettingsForm } from \"./backend/settings-store.ts\";\nimport { html, jsonError } from \"./backend/shared.ts\";\nimport { renderAdmin } from \"./frontend/admin.tsx\";\nimport { renderDenied, renderLogin } from \"./frontend/auth.tsx\";\nimport type { AdminUser } from \"./frontend/layout.tsx\";\n\nconst app = new Hono<{ Variables: { adminUser: AdminUser } }>();\n\n// ------------------------------------------------------------------------------\n// fn routes — POST-only, each gated by the global API key\n// ------------------------------------------------------------------------------\n\nasync function apiKeyGate(c: Context, next: Next): Promise {\n await authenticateApi(c.req.raw);\n await next();\n}\n\napp.post(\"/get-user-details\", apiKeyGate, async (c) => await getUserDetails(c.req.raw));\napp.post(\"/get-information\", apiKeyGate, async (c) => await getInformation(c.req.raw));\napp.post(\"/get-information-slow\", apiKeyGate, async (c) => await getInformationSlow(c.req.raw));\napp.post(\"/webhook\", apiKeyGate, async (c) => await webhookHandler(c.req.raw));\n\n// ------------------------------------------------------------------------------\n// admin UI — Val Town OAuth, then the tabbed page + its two action routes\n// ------------------------------------------------------------------------------\n\nasync function adminGate(c: Context<{ Variables: { adminUser: AdminUser } }>, next: Next) {\n const uc = await getAdminUc(c.req.raw);\n if (!uc.isAuthed) return html(renderLogin(), 401);\n if (!uc.isAdmin) return html(renderDenied(uc.username ?? \"\"), 403);\n c.set(\"adminUser\", { username: uc.username ?? \"\", avatarUrl: uc.avatarUrl });\n await next();\n}\n\napp.get(\"/\", adminGate, async (c) => {\n const saved = c.req.query(\"saved\") === \"1\";\n const view = await buildAdminView(new URL(c.req.url), saved);\n return html(renderAdmin(view, c.get(\"adminUser\")));\n});\n\napp.post(\"/settings\", adminGate, async (c) => {\n await saveSettingsForm(c.req.raw);\n return c.redirect(\"/?saved=1#data\", 303);\n});\n\napp.post(\"/api-key/regenerate\", adminGate, async (c) => {\n await regenerateApiKey();\n return c.redirect(\"/?saved=1#data\", 303);\n});\n\n// ------------------------------------------------------------------------------\n// error handling\n// ------------------------------------------------------------------------------\n\napp.onError((err) => {\n if (isHttpError(err)) return jsonError(err.message, err.status);\n console.error(\"[uFns] unhandled error:\", err instanceof Error ? err.message : err);\n return jsonError(\"Internal server error\", 500);\n});\napp.notFound((c) => jsonError(`Not found: ${c.req.path}`, 404));\n\nexport default withValTownAuth((req) => app.fetch(req));\n","micro-fns",[],[246],"e70eafe0-39e0-45c4-8d7e-4abf2fd344df","deno.json","ec82e4ac-6128-11f1-9fb3-1607ee4eb77e",8,["D",1780696381966],"{\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\": [\"dom\", \"dom.iterable\", \"dom.asynciterable\", \"deno.ns\", \"deno.unstable\"]\n },\n \"fmt\": {\n \"lineWidth\": 100\n },\n \"lint\": {\n \"rules\": {\n \"exclude\": [\"no-explicit-any\", \"no-external-import\", \"no-import-prefix\"]\n }\n },\n \"node_modules_dir\": false,\n \"unstable\": [\"temporal\", \"worker-options\", \"sloppy-imports\", \"node-globals\"]\n}\n",[],[255],"612c8dcf-a5cf-490b-8aad-f4f05d872659","cron.ts","eccd21ac-6128-11f1-ac3a-1607ee4eb77e",16,["D",1780696382454],"interval","// cron.ts — Scheduled cleanup: prune logs older than RETENTION_DAYS.\n\nimport { RETENTION_DAYS } from \"./backend/config.ts\";\nimport { deleteOldData } from \"./backend/db.ts\";\n\nexport default async function cleanup() {\n const result = await deleteOldData(RETENTION_DAYS);\n console.log(\n `Cleanup done: deleted ${result.requests} request(s), ${result.webhooks} webhook(s) older than ${RETENTION_DAYS}d`,\n );\n}\n",[],[263],"bf4228e0-d3ee-45c8-9c79-df13780b2579","README.md","eca9edfe-6128-11f1-90f7-1607ee4eb77e",111,["D",1785875509829],7,"# uFns\n\nSmall integration functions for ToughTongue AI — mock user details, weather + headlines lookups,\nwebhook capture, and a single tabbed admin UI (Data / Debug / Activity / Info).\n\nPair with **uAgents** for heavier per-customer agent APIs behind header secrets.\n\n| Val | Role |\n| ----------- | ---------------------------------------------------------------- |\n| **uFns** | Lightweight integration fns (`/get-user-details`, `/webhook`, …) |\n| **uAgents** | Customer-scoped agent fns at `/fns//` |\n\nDeployed to the `ttai` org on Val Town (`vt create … --org-name ttai`).\n\n## Auth\n\nTwo independent surfaces:\n\n- **Fn calls** — one **global API key**, sent as `Authorization: Bearer ` (or\n `X-API-Key: `) on every request. The key is auto-minted on first use, viewable and rotatable\n on the **Data** tab. There is no per-customer scoping (that's what uAgents is for) — one key,\n checked in constant time, guards every fn.\n- **Admin UI** (`/`) — **Val Town sign-in**, gated to an allow-list, same pattern as uAgents. Set\n the `ADMIN_USERS` env var (Val Town sidebar) to a comma-separated list of Val Town usernames\n (case-insensitive). Sign-in uses\n [`std/oauth`](https://docs.val.town/guides/auth/#sign-in-with-val-town); see `backend/auth.ts`.\n\n## Admin UI\n\nA single page at `/` with five hash-routed tabs (`/#data`, `/#debug`, `/#integration`, `/#activity`,\n`/#info`):\n\n| Tab | What |\n| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **Data** | Mock user fields (returned by `/get-user-details`) + the global API key |\n| **Debug** | Pick a fn, edit its JSON body, and fire a live call from the browser — see the resolved URL, `Authorization` header, and an equivalent `curl` update live |\n| **Integration** | Pick a fn and get its endpoint URL, auth header, description, and parameters JSON Schema — ready to paste into a ToughTongue AI tool/function definition |\n| **Activity** | Fn catalog + a live request/webhook log |\n| **Info** | Role, auth model, quick start, pairing with uAgents |\n\n## Fn endpoints\n\nAll POST-only, all require the API key:\n\n| Path | Purpose |\n| ----------------------- | --------------------------------------------------------------------------------------- |\n| `/get-user-details` | Returns the mock user from SQLite |\n| `/get-information` | Weather + headlines, padded to ~3s |\n| `/get-information-slow` | Weather + headlines, padded to ~20s |\n| `/webhook` | Captures a POST body for the Activity log — a regular fn like the rest, not a catch-all |\n\n`/get-information*` accept an optional JSON body `{\"location\": \"Tokyo\"}`; without one they fall back\nto the mock user's `location` (Data tab, default `Paris`).\n\nReady-to-run `curl` examples with the real deployed base URL filled in live on the **Activity** tab\n(empty-state) and the **Info** tab (quick start) — no guessing your val's hostname.\n\n### Weather + headlines API options\n\nBoth fns call **free, keyless** public APIs — no signup, no rate-limit surprises for a dev tool:\n\n- **Weather — [Open-Meteo](https://open-meteo.com)** (chosen). Free forecast + geocoding APIs, no\n API key, no rate limit for reasonable use. Alternatives considered: [wttr.in](https://wttr.in)\n (free, keyless, but plain-text/ANSI-first — JSON is an afterthought) and\n [OpenWeatherMap](https://openweathermap.org/api) (richer data, but requires a free-tier API key —\n adds a required env var for a mock endpoint).\n- **Headlines — [Hacker News (Firebase) API](https://github.com/HackerNews/API)** (chosen). Free,\n keyless, and consistently fast (`topstories.json` + a parallel `item/.json` fetch per story —\n measured ~0.3s per call). Headlines skew tech/HN, not general news. Alternatives considered:\n [GDELT DOC 2.0](https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/) (free, keyless, broader\n real-world news coverage via full-text search — but measured ~13s per query from this repo's dev\n network, too slow/unpredictable for a 6–20s budget); **NewsAPI.org** / **GNews** / **currentsapi**\n (broader coverage and categories, but all require a free-tier API key).\n\n## File layout\n\n```\nbackend/\n api.ts HttpError, readJson/readText, dispatch (named api.ts, not\n http.ts — Val Town infers a val's type from its filename;\n only index.http.ts should be an HTTP val)\n auth.ts OAuth admin gate + global API key check\n config.ts mock-user fields, FN_SPECS (fn catalog + Debug samples)\n db.ts SQLite: settings, request log, webhook log\n settings-store.ts mock-user settings + the global API key\n information.ts weather + headlines fetch/pad logic\n fns/ one file per fn handler\n pages/ view-model assembly for SSR (admin.ts, activity.ts)\nfrontend/\n layout.tsx Shell, Tab, Panel, Picker, ReadOnlyField, UserBadge\n admin.tsx composes Data/Debug/Activity/Info into the tabbed page\n data.tsx, debug.tsx, activity.tsx, info.tsx one tab each\n auth.tsx signed-out / access-denied pages\n styles/ modular CSS layers (Next.js-style)\n tokens.ts design tokens + semantic M3 aliases (palette is runtime-generated)\n base.ts document layout + typography scale\n components.ts cards, tabs, key row, fields/buttons/tables, debug box\n index.ts composes layers → GLOBAL_CSS\n```\n\n## Push\n\nFrom this directory:\n\n```bash\nvt create uFns . --org-name ttai --upload-if-exists --no-editor-files\nvt push # ship changes\n```\n\n`val.yml` is not read by `vt` yet — it documents the val contract for a future repo wrapper over\nvt-cli.\n\n## Add a function\n\n1. Write a thin handler in `backend/fns/.ts` — throw `HttpError` for client errors; body\n parsing via `readJson` / `readText` from `backend/api.ts`.\n2. Register it in `ROUTES` inside `index.http.ts`, wrapped in `withAuth(...)` so it requires the\n global API key (dispatch wraps error handling).\n3. Add it to `FN_SPECS` in `backend/config.ts` (path, note, sample body) so it shows up in the\n Activity table and the Debug tab's picker.\n4. `vt push`.\n",[],[272],"62fccb20-2409-47d1-b439-93272bd0e887",".env.sample","e81e6098-9018-11f1-ba51-1607ee4eb77e",36,["D",1785857207264],"# Val Town env vars for uFns (set in the Val Town sidebar — Deno.env.set() is a no-op).\n\n# Comma-separated Val Town usernames allowed into the admin UI (/, /settings, /info).\n# Case-insensitive; unset or empty = nobody gets in (signed-in visitors see \"Access denied\").\nADMIN_USERS=\n",[],[281],"4a4fc7c0-88a2-4fc8-907e-a84d47f5d374","utils.ts","ec609fd2-6128-11f1-ac3a-1607ee4eb77e",["D",1780696381742],"// utils.ts — Formatting helpers for SSR pages.\n\nexport function formatJson(raw: string): string {\n try {\n return JSON.stringify(JSON.parse(raw), null, 2);\n } catch {\n return raw;\n }\n}\n\nexport function truncate(s: string, max: number): string {\n const flat = s.replace(/\\s+/g, \" \").trim();\n return flat.length > max ? flat.slice(0, max) + \"…\" : flat;\n}\n\nexport function isoUtc(ts: string): string {\n return ts.replace(\" \", \"T\") + \"Z\";\n}\n\nexport function methodChip(method: string): string {\n if (method === \"GET\") return \"blue\";\n if (method === \"POST\") return \"green\";\n if (method === \"PUT\" || method === \"PATCH\") return \"orange\";\n if (method === \"DELETE\") return \"red\";\n return \"grey\";\n}\n",[],[185,289],"bccdb792-426f-4081-9aad-a6b7deda33b3","types.ts","ec7b6a4c-6128-11f1-b845-1607ee4eb77e",71,["D",1785861997486],2,"// types.ts — View models passed from backend handlers into SSR pages.\n\nimport type { RequestLogEntry, WebhookLogEntry } from \"../backend/db.ts\";\n\nexport interface UserDetails {\n user_name: string;\n user_email: string;\n dynamic_vars: Record;\n}\n\nexport interface ActivityView {\n requests: RequestLogEntry[];\n webhooks: WebhookLogEntry[];\n reqTotal: number;\n whTotal: number;\n tab: \"requests\" | \"webhooks\";\n page: number;\n totalPages: number;\n}\n\n/** The single admin page: mock user + API key (Data tab) and the Activity log. */\nexport interface AdminView {\n saved: boolean;\n values: Record;\n apiKey: string;\n activity: ActivityView;\n baseUrl: string;\n}\n",[],[185,296],"3e9ce01d-ce1d-47f9-afd5-23fa685528b8","layout.tsx","ec667934-6128-11f1-b2c9-1607ee4eb77e",106,["D",1785871009139],5,"/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// layout.tsx — Shared beer.css shell: top app bar, hash-based tabs, panels.\n\nimport type { ComponentChildren } from \"https://esm.sh/preact@10.29.1\";\nimport { APP_NAME } from \"../backend/shared.ts\";\nimport { GLOBAL_CSS } from \"./styles/index.ts\";\n\nconst BEER_CSS = \"https://cdn.jsdelivr.net/npm/beercss@4.0.21/dist/cdn/beer.min.css\";\nconst BEER_JS = \"https://cdn.jsdelivr.net/npm/beercss@4.0.21/dist/cdn/beer.min.js\";\nconst MDC_JS =\n \"https://cdn.jsdelivr.net/npm/material-dynamic-colors@1.1.2/dist/cdn/material-dynamic-colors.min.js\";\nconst ICONS =\n \"https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@24,400,0,0\";\n\n/** Brand seed — beer.css generates the full M3 palette from this at runtime.\n * Distinct from uAgents' blue (#2E6BE6) so the two admin UIs read apart. */\nconst BRAND_SEED = \"#7C4DFF\";\n\nexport interface AdminUser {\n username: string;\n avatarUrl?: string;\n}\n\ninterface ShellProps {\n children: ComponentChildren;\n user?: AdminUser;\n}\n\n/** Full HTML document with beer.css and a minimal top app bar. Pass `user` on\n * authenticated admin pages to show the signed-in badge + sign-out button. */\nexport function Shell({ children, user }: ShellProps) {\n return (\n \n \n \n \n {APP_NAME}\n \n \n \n \n

History · debug.tsx