📋 Assistance Requests

\n Persisted with SQLite + Blob backup\n

\n\n \n

\n\n \n\n\n","label",[18],"pulls","branches",1,"forks","envVars",{"_179":173,"_181":173},"connections",{"_179":26,"_180":26},"count","unfilledCount","emptyCount",{"_34":226,"_13":227,"_64":228,"_44":-5,"_36":37,"_163":126,"_164":157,"_38":229,"_40":26,"_66":21,"_167":230,"_67":24,"_169":-5,"_195":231,"_17":232},{"_34":162,"_13":18,"_64":65,"_44":-5,"_36":37,"_163":82,"_164":157,"_38":223,"_40":166,"_66":21,"_167":168,"_67":24,"_169":-5,"_195":224,"_17":225},{"_34":214,"_13":215,"_64":216,"_44":-5,"_36":37,"_163":217,"_164":157,"_38":218,"_40":201,"_66":219,"_167":220,"_67":24,"_169":-5,"_195":221,"_17":222},{"_34":206,"_13":207,"_64":208,"_44":-5,"_36":37,"_163":209,"_164":157,"_38":210,"_40":26,"_66":193,"_167":211,"_67":24,"_169":-5,"_195":212,"_17":213},{"_34":198,"_13":199,"_64":200,"_44":-5,"_36":37,"_163":201,"_164":157,"_38":202,"_40":26,"_66":193,"_167":203,"_67":24,"_169":-5,"_195":204,"_17":205},{"_34":188,"_13":189,"_64":190,"_44":-5,"_36":37,"_163":191,"_164":157,"_38":192,"_40":26,"_66":193,"_167":194,"_67":24,"_169":-5,"_195":196,"_17":197},"38c2b2e4-5791-11f1-b3e5-ee650bb23af1","validation.ts","38c2b3ac-5791-11f1-b3e5-ee650bb23af1",10,["D",1779641665830],"script","/**\n * Server-side validation for assistance requests.\n * All validation happens here before data reaches storage.\n */\n\n/** Validation constraints */\nexport const LIMITS = {\n /** Minimum message length after trimming */\n MIN_LENGTH: 3,\n /** Maximum message length */\n MAX_LENGTH: 1000,\n /** Valid status values */\n VALID_STATUSES: [\"pending\", \"in_progress\", \"resolved\"] as const,\n};\n\nexport interface ValidationResult {\n ok: boolean;\n error?: string;\n /** Sanitized value (trimmed, normalized whitespace) */\n sanitized?: string;\n}\n\n/** Validate and sanitize a request message */\nexport function validateMessage(raw: unknown): ValidationResult {\n // Must be a string\n if (typeof raw !== \"string\") {\n return { ok: false, error: \"Message must be a string.\" };\n }\n\n // Trim and collapse internal whitespace\n const sanitized = raw.trim().replace(/\\s+/g, \" \");\n\n // Reject empty / whitespace-only\n if (sanitized.length === 0) {\n return { ok: false, error: \"Message cannot be empty.\" };\n }\n\n // Minimum length\n if (sanitized.length < LIMITS.MIN_LENGTH) {\n return {\n ok: false,\n error: `Message must be at least ${LIMITS.MIN_LENGTH} characters.`,\n };\n }\n\n // Maximum length\n if (sanitized.length > LIMITS.MAX_LENGTH) {\n return {\n ok: false,\n error: `Message cannot exceed ${LIMITS.MAX_LENGTH} characters.`,\n };\n }\n\n return { ok: true, sanitized };\n}\n\n/** Validate a status value */\nexport function validateStatus(raw: unknown): ValidationResult {\n if (typeof raw !== \"string\") {\n return { ok: false, error: \"Status must be a string.\" };\n }\n if (!(LIMITS.VALID_STATUSES as readonly string[]).includes(raw)) {\n return {\n ok: false,\n error: `Status must be one of: ${LIMITS.VALID_STATUSES.join(\", \")}`,\n };\n }\n return { ok: true, sanitized: raw };\n}\n","children",[],[189],"021afeae-5791-11f1-b22c-ee650bb23af1","types.ts","021affbc-5791-11f1-b22c-ee650bb23af1",6,["D",1779641574229],"/** Possible statuses for an assistance request */\nexport type RequestStatus = \"pending\" | \"in_progress\" | \"resolved\";\n\n/**\n * Data structure for an assistance request.\n * Each request stores at minimum:\n * - id: unique auto-incrementing identifier\n * - message: the text content of the request\n * - status: current lifecycle state (pending → in_progress → resolved)\n * - createdAt: ISO-8601 timestamp of when the request was submitted\n */\nexport interface AssistanceRequest {\n id: number;\n message: string;\n status: RequestStatus;\n createdAt: string; // ISO-8601 UTC datetime string\n}\n",[],[199],"4335093e-5791-11f1-b2dd-ee650bb23af1","persistence.ts","43350a1a-5791-11f1-b2dd-ee650bb23af1",11,["D",1779641683450],"/**\n * Persistence layer for assistance requests.\n *\n * Uses TWO Val Town storage mechanisms:\n * 1. SQLite – primary relational store (fast queries, ordering, filtering)\n * 2. Blob – JSON snapshot backup (disaster recovery, export, portability)\n *\n * Every write (create / update) touches SQLite first, then syncs a full\n * snapshot to Blob storage so the two stay in lockstep.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport { blob } from \"https://esm.town/v/std/blob\";\nimport type { AssistanceRequest, RequestStatus } from \"./types.ts\";\n\nconst BLOB_KEY = \"assistance_requests_backup\";\n\n// ─── Database bootstrap ────────────────────────────────────────────\n\nexport async function initDatabase() {\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS requests (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n message TEXT NOT NULL,\n status TEXT NOT NULL DEFAULT 'pending',\n created_at TEXT DEFAULT (datetime('now'))\n )\n `);\n\n // Migration: add status column for older tables\n try {\n await sqlite.execute(\n \"ALTER TABLE requests ADD COLUMN status TEXT NOT NULL DEFAULT 'pending'\",\n );\n } catch {\n // Column already exists — ignore\n }\n}\n\n// ─── Row mapper ────────────────────────────────────────────────────\n\nfunction toAssistanceRequest(\n row: Record,\n): AssistanceRequest {\n return {\n id: row.id as number,\n message: row.message as string,\n status: (row.status as RequestStatus) ?? \"pending\",\n createdAt: row.created_at as string,\n };\n}\n\n// ─── Blob snapshot sync ────────────────────────────────────────────\n\n/** Write a full snapshot of all requests to Blob storage */\nasync function syncToBlob() {\n const all = await getAllRequests();\n await blob.setJSON(BLOB_KEY, {\n exportedAt: new Date().toISOString(),\n count: all.length,\n requests: all,\n });\n}\n\n/** Read the latest snapshot from Blob storage (for diagnostics / export) */\nexport async function getBlobSnapshot(): Promise<{\n exportedAt: string;\n count: number;\n requests: AssistanceRequest[];\n} | null> {\n try {\n return await blob.getJSON(BLOB_KEY);\n } catch {\n return null;\n }\n}\n\n// ─── CRUD operations ───────────────────────────────────────────────\n\n/** Get all requests, newest first */\nexport async function getAllRequests(): Promise {\n const result = await sqlite.execute(\n \"SELECT * FROM requests ORDER BY id DESC\",\n );\n return result.rows.map(toAssistanceRequest);\n}\n\n/** Create a new request. Returns the created record. */\nexport async function createRequest(\n message: string,\n): Promise {\n const res = await sqlite.execute({\n sql: \"INSERT INTO requests (message) VALUES (?) RETURNING *\",\n args: [message],\n });\n const created = toAssistanceRequest(res.rows[0]);\n\n // Sync snapshot to Blob after every write\n await syncToBlob();\n\n return created;\n}\n\n/** Update a request's status. Returns the updated record or null if not found. */\nexport async function updateRequestStatus(\n id: number,\n status: RequestStatus,\n): Promise {\n const res = await sqlite.execute({\n sql: \"UPDATE requests SET status = ? WHERE id = ? RETURNING *\",\n args: [status, id],\n });\n if (res.rows.length === 0) return null;\n\n const updated = toAssistanceRequest(res.rows[0]);\n\n // Sync snapshot to Blob after every write\n await syncToBlob();\n\n return updated;\n}\n\n/** Delete a request by id. Returns true if deleted. */\nexport async function deleteRequest(id: number): Promise {\n const res = await sqlite.execute({\n sql: \"DELETE FROM requests WHERE id = ? RETURNING id\",\n args: [id],\n });\n if (res.rows.length > 0) {\n await syncToBlob();\n return true;\n }\n return false;\n}\n",[],[207],"4b373d8c-5791-11f1-aa94-ee650bb23af1","main.ts","41e4af40-5790-11f1-aa1b-ee650bb23af1",12,["D",1779641696885],"http","import { Hono } from \"npm:hono@4\";\nimport { serveFile, parseVal } from \"https://esm.town/v/std/utils/index.ts\";\nimport type { RequestStatus } from \"./types.ts\";\nimport { validateMessage, validateStatus } from \"./validation.ts\";\nimport {\n initDatabase,\n getAllRequests,\n createRequest,\n updateRequestStatus,\n deleteRequest,\n getBlobSnapshot,\n} from \"./persistence.ts\";\n\nconst app = new Hono();\n\napp.onError((err) => Promise.reject(err));\n\n// Bootstrap database on startup\nawait initDatabase();\n\n// ─── Pages ─────────────────────────────────────────────────────────\n\napp.get(\"/\", async (c) => {\n return serveFile(\"./index.html\", import.meta.url);\n});\n\n// ─── API: List all requests ────────────────────────────────────────\n\napp.get(\"/api/requests\", async (c) => {\n const requests = await getAllRequests();\n return c.json(requests);\n});\n\n// ─── API: Create a request (with validation) ──────────────────────\n\napp.post(\"/api/requests\", async (c) => {\n let body: Record;\n try {\n body = await c.req.json();\n } catch {\n return c.json({ error: \"Invalid JSON body.\" }, 400);\n }\n\n const check = validateMessage(body.message);\n if (!check.ok) {\n return c.json({ error: check.error }, 400);\n }\n\n const created = await createRequest(check.sanitized!);\n return c.json(created, 201);\n});\n\n// ─── API: Update a request's status (with validation) ─────────────\n\napp.patch(\"/api/requests/:id\", async (c) => {\n const id = Number(c.req.param(\"id\"));\n if (Number.isNaN(id)) {\n return c.json({ error: \"Invalid request ID.\" }, 400);\n }\n\n let body: Record;\n try {\n body = await c.req.json();\n } catch {\n return c.json({ error: \"Invalid JSON body.\" }, 400);\n }\n\n const check = validateStatus(body.status);\n if (!check.ok) {\n return c.json({ error: check.error }, 400);\n }\n\n const updated = await updateRequestStatus(id, check.sanitized as RequestStatus);\n if (!updated) {\n return c.json({ error: \"Request not found.\" }, 404);\n }\n return c.json(updated);\n});\n\n// ─── API: Delete a request ────────────────────────────────────────\n\napp.delete(\"/api/requests/:id\", async (c) => {\n const id = Number(c.req.param(\"id\"));\n if (Number.isNaN(id)) {\n return c.json({ error: \"Invalid request ID.\" }, 400);\n }\n const deleted = await deleteRequest(id);\n if (!deleted) {\n return c.json({ error: \"Request not found.\" }, 404);\n }\n return c.json({ ok: true });\n});\n\n// ─── API: Blob snapshot (export / diagnostics) ────────────────────\n\napp.get(\"/api/backup\", async (c) => {\n const snapshot = await getBlobSnapshot();\n if (!snapshot) {\n return c.json({ message: \"No backup snapshot yet.\" }, 404);\n }\n return c.json(snapshot);\n});\n\n// ─── View source ──────────────────────────────────────────────────\n\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\nexport default app.fetch;\n",[],[215],["D",1779641732065],[],[18],"4f2a8cfe-5792-11f1-91c0-ee650bb23af1","README.md","4f2a8dbc-5792-11f1-91c0-ee650bb23af1",["D",1779642133014],"# my",[],[227],["D",1779641251670],["D",1789499469860],{"_11":12,"_139":70},{"_11":12,"_135":70,"_69":70,"_30":68,"_136":137,"_138":24},{"_40":126,"_13":16,"_34":37,"_127":90,"_128":-5,"_129":-5,"_130":-5,"_131":-5,"_132":-5,"_133":14,"_134":12},"ctx",{"_54":-5,"_159":271,"_272":273,"_274":275,"_276":24,"_277":24,"_278":24,"_279":157,"_280":-5,"_281":-7,"_282":-7,"_283":26,"_284":24,"_285":24,"_286":-5,"_287":24,"_288":24,"_289":24,"_290":-5},"ENV",{"_242":243,"_244":245,"_246":16,"_247":248,"_249":250,"_251":252,"_253":254,"_255":256,"_257":258,"_259":260,"_261":262,"_263":264,"_265":266,"_267":268,"_269":270},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

📋 Assistance Requests

\n Submitted Requests\n

History · index.html