Hi

\"\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use: `

`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise specified\n- **Error Debugging:** Add `` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; Avoid catches that merely log or return 500s. Let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and start the file with `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- Do NOT use Hono serveStatic middleware\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n import { readFile, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\n\n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n\n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n\n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n\n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:**\n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n\n6. **Hono Peculiarities:**\n - NEVER EVER write this line: `import { serveStatic } from 'https://esm.sh/hono@3.11.7/middleware';`\n - Instead use: `import { readFile, serveFile } from \"https://esm.town/v/std/utils/index.ts\";`\n - NEVER EVER write this line: `import { cors } from \"https://esm.sh/@hono/cors@0.0.6\";`. \n - Val Town automatically handles CORS.\n - If you need cookies, use: import { deleteCookie, getCookie, setCookie } from \"npm:hono/cookie\";",[],[159,177,184],[159,177],[159],{"_103":195,"_95":196,"_160":197,"_162":-5,"_163":141,"_164":198,"_166":117,"_105":199,"_100":146,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":200,"_98":211},"05b7e3ea-461e-11f0-b35f-76b3cceeab13","backend","063d1e96-3ccd-4d2b-af20-cafc20da3358",98,["D",1749575520724],[201],{"_103":202,"_95":203,"_160":115,"_162":197,"_163":141,"_164":204,"_166":117,"_105":205,"_100":206,"_168":207,"_170":208,"_171":22,"_172":96,"_173":209,"_98":210},"af2f6214-4663-11f0-ab46-76b3cceeab13","index.ts",249,["D",1749605440286],119,"http","import {\n readFile,\n serveFile,\n} from \"https://esm.town/v/std/utils@71-main/index.ts\";\nimport ValTown from \"jsr:@valtown/sdk\";\nimport { Hono } from \"npm:hono\";\nimport { formatOutput, getTreeAndContent } from \"../utils.ts\";\n\nconst app = new Hono();\nconst vt = new ValTown();\n\napp.get(\"/\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\napp.get(\"/public/**/*\", (c) =>\n serveFile(c.req.path.replace(\"/public\", \"/frontend\"), import.meta.url),\n);\n\napp.get(\"/shared/**/*\", (c) => serveFile(c.req.path, import.meta.url));\n\napp.get(\"/x/:username/:valname\", async (c) => {\n const username = c.req.param(\"username\");\n const valname = c.req.param(\"valname\");\n if (!username || !valname) {\n return c.json(\n {\n success: false,\n error: \"Missing required parameters: username or valname\",\n },\n 400,\n );\n }\n const val = await vt.alias.username.valName.retrieve(username, valname);\n if (!val || !val.id) {\n return c.json({ success: false, error: \"Val not found\" }, 404);\n }\n const { filesWithContent, tree } = await getTreeAndContent(val.id);\n const output = formatOutput({\n username,\n valname,\n tree,\n files: filesWithContent,\n });\n return c.text(output);\n});\n\napp.onError((err, _c) => {\n throw err;\n});\n\nexport default app.fetch;\n",[],[196,203],[196],{"_103":213,"_95":214,"_160":215,"_162":-5,"_163":141,"_164":146,"_166":117,"_105":216,"_100":32,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":217,"_98":319},"80e281d6-4616-11f0-8c3c-76b3cceeab13","frontend","0df21e65-3567-4bb3-9b8f-b2eab93b9402",["D",1749572291332],[218,256,274,282,292,301,310],{"_103":219,"_95":220,"_160":221,"_162":215,"_163":141,"_164":146,"_166":117,"_105":222,"_100":32,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":223,"_98":255},"80e27934-4616-11f0-8c3c-76b3cceeab13","components","1539c5a5-5570-4097-9a03-6cf3aabd0ff3",["D",1749572291332],[224,235,245],{"_103":225,"_95":226,"_160":227,"_162":221,"_163":141,"_164":228,"_166":117,"_105":229,"_100":230,"_168":231,"_170":232,"_171":22,"_172":-5,"_173":233,"_98":234},"35728f78-4663-11f0-b965-76b3cceeab13","App.tsx","e0cd25d4-ea39-4ebe-82e0-b23a4ea70241",242,["D",1749605236078],45,"script","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0\";\nimport { ValForm } from \"./ValForm.tsx\";\nimport { ValOutput } from \"./ValOutput.tsx\";\nimport { useValExport } from \"../hooks/useValExport.ts\";\n\nexport function App() {\n const [name, setName] = React.useState(\"val-to-text\");\n const [username, setUsername] = React.useState(\"nbbaier\");\n const {\n text,\n files,\n copyButtonText,\n setText,\n exportVal,\n copyToClipboard,\n downloadText,\n } = useValExport();\n\n const handleExport = () => exportVal(username, name);\n const handleDownload = () => downloadText(username, name);\n\n return (\n

\n \n {text && (\n \n )}\n

\n );\n}\n",[],[214,220,226],{"_103":236,"_95":237,"_160":238,"_162":221,"_163":141,"_164":239,"_166":117,"_105":240,"_100":241,"_168":231,"_170":242,"_171":22,"_172":-5,"_173":243,"_98":244},"f1886dbc-4b0f-11f0-ba94-76b3cceeab13","ValForm.tsx","e17a0faa-4661-11f0-9aa8-76b3cceeab13",264,["D",1750119229723],3,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport type { ChangeEvent } from \"https://esm.sh/react@18.2.0\";\nimport type { ValFormProps } from \"../types.ts\";\n\nexport function ValForm({\n username,\n valName,\n onUsernameChange,\n onValNameChange,\n onExport,\n}: ValFormProps) {\n return (\n

Val-to-Text

\n Turn any Val into a simple text digest of its codebase for feeding into\n any LLM. Use the form below, or replace{\" \"}\n www.val.town with{\" \"}\n val-to-text.val.run{\" \"}\n to get the output directly.\n

\n \n Username:\n \n ) =>\n onUsernameChange(e.target.value)}\n className=\"input-field\"\n />\n \n Val Name:\n \n ) =>\n onValNameChange(e.target.value)}\n className=\"input-field\"\n />\n \n

\n );\n}",[],[214,220,237],{"_103":246,"_95":247,"_160":248,"_162":221,"_163":141,"_164":249,"_166":117,"_105":250,"_100":251,"_168":231,"_170":252,"_171":22,"_172":-5,"_173":253,"_98":254},"e0a052b8-4663-11f0-80e6-76b3cceeab13","ValOutput.tsx","e170b388-4661-11f0-aee6-76b3cceeab13",251,["D",1749605523234],4,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport type { ChangeEvent } from \"https://esm.sh/react@18.2.0\";\nimport type { ValOutputProps } from \"../types.ts\";\n\nexport function ValOutput({\n text,\n files,\n copyButtonText,\n onTextChange,\n onCopyClick,\n onDownloadClick,\n}: ValOutputProps) {\n return (\n

\n {text.length} characters • {files} files\n

\n \n \n

\n ) =>\n onTextChange(e.target.value)\n }\n className=\"output-textarea\"\n />\n

\n );\n}\n",[],[214,220,247],[214,220],{"_103":257,"_95":258,"_160":259,"_162":215,"_163":141,"_164":260,"_166":117,"_105":261,"_100":32,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":262,"_98":273},"f341ccaa-4661-11f0-a8ba-76b3cceeab13","hooks","f341cd90-4661-11f0-a8ba-76b3cceeab13",228,["D",1749604695536],[263],{"_103":264,"_95":265,"_160":266,"_162":259,"_163":141,"_164":267,"_166":117,"_105":268,"_100":269,"_168":231,"_170":270,"_171":22,"_172":-5,"_173":271,"_98":272},"cdff7af6-4665-11f0-b217-76b3cceeab13","useValExport.ts","f3594d3a-4661-11f0-98f9-76b3cceeab13",259,["D",1749606351010],9,"import { useState } from \"https://esm.sh/react@18.2.0\";\n\nexport function useValExport() {\n const [text, setText] = useState();\n const [files, setFiles] = useState(0);\n const [copyButtonText, setCopyButtonText] = useState(\"Copy\");\n\n const getFileCount = (text: string): number => {\n const matches = text.match(\n /\\n--------------------------\\n[^\\n]+\\n--------------------------/g,\n );\n return matches ? matches.length : 0;\n };\n\n const exportVal = async (username: string, valName: string) => {\n if (!username || !valName) {\n alert(\"Please enter a username and project name\");\n return;\n }\n\n try {\n const response = await fetch(`/x/${username}/${valName}`);\n const data = await response.text();\n setText(data);\n setFiles(getFileCount(data));\n } catch (error) {\n alert(\"Failed to export val. Please try again.\");\n console.error(\"Export error:\", error);\n }\n };\n\n const copyToClipboard = async () => {\n if (text) {\n try {\n await navigator.clipboard.writeText(text);\n setCopyButtonText(\"Copied!\");\n setTimeout(() => setCopyButtonText(\"Copy\"), 2000);\n } catch (error) {\n alert(\"Failed to copy to clipboard. Please try again.\");\n console.error(\"Copy error:\", error);\n }\n }\n };\n\n const downloadText = (username: string, valName: string) => {\n if (text) {\n try {\n const blob = new Blob([text], { type: \"text/plain\" });\n const url = URL.createObjectURL(blob);\n const a = document.createElement(\"a\");\n a.href = url;\n a.download = `${username}-${valName}.txt`;\n document.body.appendChild(a);\n a.click();\n document.body.removeChild(a);\n URL.revokeObjectURL(url);\n } catch (error) {\n alert(\"Failed to download file. Please try again.\");\n console.error(\"Download error:\", error);\n }\n }\n };\n\n return {\n text,\n files,\n copyButtonText,\n setText,\n exportVal,\n copyToClipboard,\n downloadText,\n };\n}\n",[],[214,258,265],[214,258],{"_103":275,"_95":276,"_160":277,"_162":215,"_163":141,"_164":146,"_166":117,"_105":278,"_100":32,"_168":188,"_170":279,"_171":22,"_172":-5,"_173":280,"_98":281},"80e27ae2-4616-11f0-8c3c-76b3cceeab13","favicon.svg","514d07a3-4746-4d51-9fde-fa61fe5bfe2e",["D",1749572291332],"",[],[214,276],{"_103":283,"_95":284,"_160":285,"_162":215,"_163":141,"_164":286,"_166":117,"_105":287,"_100":288,"_168":188,"_170":289,"_171":22,"_172":-5,"_173":290,"_98":291},"2c49327a-465f-11f0-b20d-76b3cceeab13","index.html","cc8d9644-1d49-4b90-a292-7ea99705bac4",221,["D",1749603502684],7,"\n\n \n \n \n Val-to-text\n \n \n \n \n \n

\n \n \n \n\n",[],[214,284],{"_103":293,"_95":294,"_160":295,"_162":215,"_163":141,"_164":296,"_166":117,"_105":297,"_100":146,"_168":231,"_170":298,"_171":22,"_172":-5,"_173":299,"_98":300},"47e25f94-4640-11f0-b96e-76b3cceeab13","index.tsx","d6d7b5a1-1e8b-4e0b-9e03-ae06d88bde45",203,["D",1749590234625],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { App } from \"./components/App.tsx\";\n\nconst root = document.getElementById(\"root\");\nif (!root) {\n throw new Error(\"No root element found\");\n}\n\ncreateRoot(root).render();\n",[],[214,294],{"_103":302,"_95":303,"_160":304,"_162":215,"_163":141,"_164":140,"_166":117,"_105":305,"_100":306,"_168":188,"_170":307,"_171":22,"_172":-5,"_173":308,"_98":309},"4e206390-4b10-11f0-b230-76b3cceeab13","style.css","af6a2afe-4b6e-420f-acd5-2d94101b5314",["D",1750119385069],13,"body {\n font-family:\n -apple-system,\n BlinkMacSystemFont,\n \"Segoe UI\",\n Roboto,\n Oxygen,\n Ubuntu,\n Cantarell,\n \"Open Sans\",\n \"Helvetica Neue\",\n sans-serif;\n max-width: 600px;\n margin: 0 auto;\n padding-left: 20px;\n padding-right: 20px;\n padding-bottom: 5px;\n padding-top: 5px;\n}\n\n.app-container {\n display: flex;\n flex-direction: column;\n}\n\n.message-board {\n display: flex;\n flex-direction: column;\n}\n\n.input-label {\n margin-top: 15px;\n margin-bottom: 5px;\n font-weight: bold;\n font-size: 0.95rem;\n}\n\n.input-field {\n border: 1px solid black;\n padding: 10px;\n font-size: 0.95rem;\n border-radius: 4px;\n}\n\n.button {\n border: 1px solid black;\n padding: 10px;\n text-align: center;\n cursor: pointer;\n border-radius: 4px;\n}\n\n.button-primary {\n margin-top: 10px;\n border: 1px solid black;\n padding: 10px;\n text-align: center;\n cursor: pointer;\n border-radius: 4px;\n}\n\n.button-group {\n display: flex;\n gap: 10px;\n}\n\n.button-group button {\n text-decoration: none;\n color: black;\n display: block;\n border: 1px solid black;\n padding: 10px;\n text-align: center;\n cursor: pointer;\n flex: 1;\n border-radius: 4px;\n}\n\n.output-container {\n display: flex;\n flex-direction: column;\n padding-top: 20px;\n}\n\n.output-textarea {\n display: block;\n border: 1px solid black;\n padding: 10px;\n margin: 20px 0;\n min-height: 500px;\n border-radius: 4px;\n}\n\n.code-inline {\n background: black;\n color: white;\n padding: 3px 6px;\n border-radius: 4px;\n}",[],[214,303],{"_103":311,"_95":312,"_160":313,"_162":215,"_163":141,"_164":314,"_166":117,"_105":315,"_100":121,"_168":231,"_170":316,"_171":22,"_172":-5,"_173":317,"_98":318},"35788086-4663-11f0-b65b-76b3cceeab13","types.ts","e16ddb18-4661-11f0-aade-76b3cceeab13",243,["D",1749605236080],"export interface ValFormProps {\n username: string;\n valName: string;\n onUsernameChange: (username: string) => void;\n onValNameChange: (valName: string) => void;\n onExport: () => void;\n}\n\nexport interface ValOutputProps {\n text: string;\n files: number;\n copyButtonText: string;\n onTextChange: (text: string) => void;\n onCopyClick: () => void;\n onDownloadClick: () => void;\n}\n",[],[214,312],[214],{"_103":321,"_95":322,"_160":323,"_162":-5,"_163":141,"_164":324,"_166":117,"_105":325,"_100":146,"_168":188,"_170":326,"_171":22,"_172":-5,"_173":327,"_98":328},"25ea0280-463f-11f0-8da5-76b3cceeab13",".vtignore","17d07ea4-463f-11f0-b9da-76b3cceeab13",202,["D",1749589748098],".git\n.vscode\n.DS_Store\nnode_modules\nvendor",[],[322],{"_103":330,"_95":331,"_160":332,"_162":-5,"_163":141,"_164":333,"_166":117,"_105":334,"_100":241,"_168":188,"_170":335,"_171":22,"_172":-5,"_173":336,"_98":337},"83ef98ba-461a-11f0-abf2-76b3cceeab13","README.md","89c9c4d5-1921-4711-b7a9-33add7d1751c",69,["D",1749574014497],"# Prompt-friendly Val codebase\n\nTurn any Val into a simple text digest of its codebase. This is useful for\nfeeding a codebase into any LLM.",[],[331],{"_103":339,"_95":99,"_160":340,"_162":-5,"_163":141,"_164":341,"_166":117,"_105":342,"_100":32,"_168":188,"_170":343,"_171":22,"_172":-5,"_173":344,"_98":345},"17c4b7f4-463f-11f0-bf19-76b3cceeab13","17c4b8bc-463f-11f0-bf19-76b3cceeab13",196,["D",1749589724408],"{\n \"$schema\": \"https://biomejs.dev/schemas/1.9.4/schema.json\",\n \"vcs\": {\n \"enabled\": false,\n \"clientKind\": \"git\",\n \"useIgnoreFile\": false\n },\n \"files\": {\n \"ignoreUnknown\": false,\n \"ignore\": []\n },\n \"formatter\": {\n \"enabled\": true,\n \"indentStyle\": \"space\"\n },\n \"organizeImports\": {\n \"enabled\": true\n },\n \"linter\": {\n \"enabled\": true,\n \"rules\": {\n \"recommended\": true\n }\n },\n \"javascript\": {\n \"formatter\": {\n \"quoteStyle\": \"double\"\n }\n }\n}",[],[99],{"_103":347,"_95":348,"_160":349,"_162":-5,"_163":141,"_164":350,"_166":117,"_105":351,"_100":32,"_168":188,"_170":352,"_171":22,"_172":-5,"_173":353,"_98":354},"17c83398-463f-11f0-977d-76b3cceeab13","deno.json","17c8342e-463f-11f0-977d-76b3cceeab13",197,["D",1749589724425],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"nodeModulesDir\": \"auto\",\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 \"lint\": {\n \"files\": {\n \"include\": [\"deno:/https/esm.town/**/*\"]\n },\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n },\n \"imports\": {\n \"@biomejs/biome\": \"npm:@biomejs/biome@^1.9.4\",\n \"@valtown/sdk\": \"jsr:@valtown/sdk@^1.3.0\",\n \"hono\": \"npm:hono@^4.7.11\"\n }\n}\n",[],[348],{"_103":356,"_95":357,"_160":358,"_162":-5,"_163":141,"_164":359,"_166":117,"_105":360,"_100":361,"_168":231,"_170":362,"_171":22,"_172":-5,"_173":363,"_98":364},"135c512a-466e-11f0-bf6b-76b3cceeab13","utils.ts","74625556-462c-11f0-8416-76b3cceeab13",263,["D",1749609903355],12,"import {\n createFileTree,\n type FileTree,\n renderTree,\n} from \"https://esm.town/v/nbbaier/createFileTree@96-main/main.ts\";\nimport ValTown from \"jsr:@valtown/sdk\";\n\nconst vt = new ValTown();\n\ntype File = ValTown.Vals.Files.FileRetrieveResponse;\n\nexport function formatOutput({\n username,\n valname,\n tree,\n files,\n}: {\n username: string;\n valname: string;\n tree: FileTree;\n files: { name: string; content: string }[];\n}): string {\n return `Val: ${valname} by @${username}\n\n# Directory Structure\n\n${valname}/\\n${renderTree(tree)}\n\n# Files\n\n${files\n .map(\n (file) =>\n `--------------------------\n${file.name}\n--------------------------\n${file.content}\n`,\n )\n .join(\"\\n\\n\")}\n`;\n}\n\nexport async function getTreeAndContent(id: string): Promise<{\n filesWithContent: { name: string; content: string }[];\n tree: FileTree;\n}> {\n const files: File[] = [];\n\n for await (const fileRetrieveResponse of vt.vals.files.retrieve(id, {\n limit: 1,\n offset: 0,\n path: \"\",\n recursive: true,\n })) {\n files.push(fileRetrieveResponse);\n }\n\n const filesWithContent = await getFilesWithContent(files, id);\n const tree = createFileTree(\n files.map((f) => ({\n path: `./${new URL(f.links.module).pathname\n .split(\"/\")\n .slice(4)\n .join(\"/\")}`,\n type: f.type === \"directory\" ? \"directory\" : \"file\",\n })),\n );\n\n return { filesWithContent, tree };\n}\n\nexport async function getFilesWithContent(\n files: File[],\n valId: string,\n): Promise<{ name: string; content: string }[]> {\n const nonDirectoryFiles = files.filter((file) => file.type !== \"directory\");\n\n const failedFiles: { path: string; error: string }[] = [];\n\n const filePromises = nonDirectoryFiles.map(async (file) => {\n try {\n const response = await vt.vals.files.getContent(valId, {\n path: file.path,\n });\n\n if (!response) {\n throw new Error(`Could not get content for file: ${file.path}`);\n }\n\n return {\n name: file.path as string,\n content: (await response.text()) as string,\n };\n } catch (error) {\n if (error instanceof Error) {\n failedFiles.push({\n path: file.path,\n error: error.message,\n });\n }\n }\n });\n\n const results = await Promise.all(filePromises);\n if (failedFiles.length > 0) {\n const failedFilesList = failedFiles\n .map((f) => `'${f.path}': ${f.error}`)\n .join(\", \");\n throw new Error(`Failed to fetch content for files: ${failedFilesList}`);\n }\n\n return results.filter((x) => !!x);\n}\n",[],[357],"files",[157,175,182,194,201,212,218,224,235,245,256,263,274,282,292,301,310,320,329,338,346,355],"counts",{"_369":32,"_370":121,"_371":146,"_372":32},"pulls","branches","forks","envVars","contents",[],{"_103":339,"_163":141,"_160":340,"_95":99,"_170":343,"_168":188,"_100":32,"_162":-5,"_105":376,"_164":341,"_172":-5,"_98":377},["D",1749589724408],[99],"upstreamProject",{"_103":149,"_95":380,"_111":-5,"_112":-5,"_109":110,"_23":381},"project_to_text",{"_93":382,"_133":383},"dcm31","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJ3SGtIMlhlMGwwT0JoSXZJckVVTXJuajN1YyJ9","upstreamBranch",{"_103":144,"_105":386,"_387":388,"_95":43,"_142":149,"_100":146,"_143":389,"_145":390,"_391":392,"_107":-5,"_154":22,"_109":110,"_153":382,"_16":151,"_152":380},["D",1742416827748],"updatedAt",["D",1742416827748],"2d55e37e-0439-11f0-896b-569c3dd06744",97,"lockfileKey","1744490284319-esm.town_v_dcm31_project_to_text@1-main","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.code.$",{"_93":94,"_95":96,"_97":43,"_100":-7,"_98":99,"_101":399,"_155":404,"_365":471,"_188":472,"_373":475,"_476":477,"_480":22,"_481":-5,"_482":483,"_484":32,"_485":486},{"_103":104,"_95":96,"_105":400,"_107":-5,"_108":22,"_109":110,"_111":-5,"_112":-5,"_14":113,"_114":115,"_116":117,"_118":119,"_120":121,"_16":122,"_123":124,"_125":124,"_126":127,"_128":127,"_129":127,"_130":124,"_131":124,"_23":401,"_135":402,"_138":403,"_154":22},["D",1749572291332],{"_93":94,"_133":134},{"_93":94,"_137":134},{"_100":140,"_95":43,"_103":141,"_142":104,"_143":144,"_145":146,"_147":110,"_148":149,"_150":151,"_152":96,"_153":94},[405,414,420,456,459,462,465,468],{"_103":158,"_95":159,"_160":161,"_162":-5,"_163":141,"_164":165,"_166":117,"_105":167,"_100":32,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":406,"_98":413},[407],{"_103":176,"_95":177,"_160":178,"_162":161,"_163":141,"_164":179,"_166":117,"_105":180,"_100":32,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":408,"_98":412},[409],{"_103":183,"_95":184,"_160":185,"_162":178,"_163":141,"_164":186,"_166":117,"_105":187,"_100":32,"_168":188,"_170":189,"_171":22,"_172":-5,"_173":410,"_98":411},[],[159,177,184],[159,177],[159],{"_103":195,"_95":196,"_160":197,"_162":-5,"_163":141,"_164":198,"_166":117,"_105":199,"_100":146,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":415,"_98":419},[416],{"_103":202,"_95":203,"_160":115,"_162":197,"_163":141,"_164":204,"_166":117,"_105":205,"_100":206,"_168":207,"_170":208,"_171":22,"_172":96,"_173":417,"_98":418},[],[196,203],[196],{"_103":213,"_95":214,"_160":215,"_162":-5,"_163":141,"_164":146,"_166":117,"_105":216,"_100":32,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":421,"_98":455},[422,434,440,443,446,449,452],{"_103":219,"_95":220,"_160":221,"_162":215,"_163":141,"_164":146,"_166":117,"_105":222,"_100":32,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":423,"_98":433},[424,427,430],{"_103":225,"_95":226,"_160":227,"_162":221,"_163":141,"_164":228,"_166":117,"_105":229,"_100":230,"_168":231,"_170":232,"_171":22,"_172":-5,"_173":425,"_98":426},[],[214,220,226],{"_103":236,"_95":237,"_160":238,"_162":221,"_163":141,"_164":239,"_166":117,"_105":240,"_100":241,"_168":231,"_170":242,"_171":22,"_172":-5,"_173":428,"_98":429},[],[214,220,237],{"_103":246,"_95":247,"_160":248,"_162":221,"_163":141,"_164":249,"_166":117,"_105":250,"_100":251,"_168":231,"_170":252,"_171":22,"_172":-5,"_173":431,"_98":432},[],[214,220,247],[214,220],{"_103":257,"_95":258,"_160":259,"_162":215,"_163":141,"_164":260,"_166":117,"_105":261,"_100":32,"_168":169,"_170":-5,"_171":22,"_172":-5,"_173":435,"_98":439},[436],{"_103":264,"_95":265,"_160":266,"_162":259,"_163":141,"_164":267,"_166":117,"_105":268,"_100":269,"_168":231,"_170":270,"_171":22,"_172":-5,"_173":437,"_98":438},[],[214,258,265],[214,258],{"_103":275,"_95":276,"_160":277,"_162":215,"_163":141,"_164":146,"_166":117,"_105":278,"_100":32,"_168":188,"_170":279,"_171":22,"_172":-5,"_173":441,"_98":442},[],[214,276],{"_103":283,"_95":284,"_160":285,"_162":215,"_163":141,"_164":286,"_166":117,"_105":287,"_100":288,"_168":188,"_170":289,"_171":22,"_172":-5,"_173":444,"_98":445},[],[214,284],{"_103":293,"_95":294,"_160":295,"_162":215,"_163":141,"_164":296,"_166":117,"_105":297,"_100":146,"_168":231,"_170":298,"_171":22,"_172":-5,"_173":447,"_98":448},[],[214,294],{"_103":302,"_95":303,"_160":304,"_162":215,"_163":141,"_164":140,"_166":117,"_105":305,"_100":306,"_168":188,"_170":307,"_171":22,"_172":-5,"_173":450,"_98":451},[],[214,303],{"_103":311,"_95":312,"_160":313,"_162":215,"_163":141,"_164":314,"_166":117,"_105":315,"_100":121,"_168":231,"_170":316,"_171":22,"_172":-5,"_173":453,"_98":454},[],[214,312],[214],{"_103":321,"_95":322,"_160":323,"_162":-5,"_163":141,"_164":324,"_166":117,"_105":325,"_100":146,"_168":188,"_170":326,"_171":22,"_172":-5,"_173":457,"_98":458},[],[322],{"_103":330,"_95":331,"_160":332,"_162":-5,"_163":141,"_164":333,"_166":117,"_105":334,"_100":241,"_168":188,"_170":335,"_171":22,"_172":-5,"_173":460,"_98":461},[],[331],{"_103":339,"_95":99,"_160":340,"_162":-5,"_163":141,"_164":341,"_166":117,"_105":342,"_100":32,"_168":188,"_170":343,"_171":22,"_172":-5,"_173":463,"_98":464},[],[99],{"_103":347,"_95":348,"_160":349,"_162":-5,"_163":141,"_164":350,"_166":117,"_105":351,"_100":32,"_168":188,"_170":352,"_171":22,"_172":-5,"_173":466,"_98":467},[],[348],{"_103":356,"_95":357,"_160":358,"_162":-5,"_163":141,"_164":359,"_166":117,"_105":360,"_100":361,"_168":231,"_170":362,"_171":22,"_172":-5,"_173":469,"_98":470},[],[357],[405,407,409,414,416,420,422,424,427,430,434,436,440,443,446,449,452,456,459,462,465,468],{"_103":339,"_95":99,"_160":340,"_162":-5,"_163":141,"_164":341,"_166":117,"_105":473,"_100":32,"_168":188,"_170":343,"_171":22,"_172":-5,"_98":474},["D",1749589724408],[99],[],"upstream",{"_103":144,"_105":478,"_387":479,"_95":43,"_142":149,"_100":146,"_143":389,"_145":390,"_391":392,"_107":-5,"_154":22,"_109":110,"_153":382,"_16":151,"_152":380},["D",1742416827748],["D",1742416827748],"showCompareCallout","pull","ahead",269,"behind","templates",[],"actionData","errors"]