readFile - Read files from Val Town vals
listFiles - List all files in a val
listFilesByPath - List files in a specific directory path
httpEndpoint - Get HTTP endpoint URL for a file
emailAddress - Get email address for email trigger files
getValId - Lookup a val's ID
fetchTranspiledJavaScript - Fetch and transpile TypeScript/JavaScript
parseVal - Extract metadata from Val Town URLs
serveFile - Serve files with proper content types
getContentType - Determine MIME types for files
staticHTTPServer - Create a static file server
testServer - Create a test runner with HTML/SVG output
isMain - Check if current file is the main entry point

\n\n---\n\n## File Operations\n\nUtilities for reading and managing files in Val Town Projects.\n\n### `readFile`\n\nReads the contents of a file from the current val.\n\n**Signature:**\n\n```ts\nreadFile(path: string, metaImportUrl?: string): Promise\n```\n\n**Parameters:**\n\n- `path` - The file path to read (with or without leading slash)\n- `metaImportUrl` - Optional. The import.meta.url to determine which val to read\n from. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n\n**Example:**\n\n```ts\nimport { readFile } from \"https://esm.town/v/std/utils/index.ts\";\n\n// Most common usage - reads from current val\nconst content = await readFile(\"/README.md\");\nconsole.log(content);\n\n// Explicit val specification\nconst content2 = await readFile(\"/README.md\", import.meta.url);\nconsole.log(content2);\n```\n\n### `listFiles`\n\nLists all files in the current val with their metadata.\n\n**Signature:**\n\n```ts\nlistFiles(metaImportUrl?: string): Promise\n```\n\n**Parameters:**\n\n- `metaImportUrl` - Optional. The import.meta.url to determine which val to list\n files from. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n\n**Example:**\n\n```ts\nimport { listFiles } from \"https://esm.town/v/std/utils/index.ts\";\n\n// Most common usage - lists files from current val\nconst files = await listFiles();\nfiles.forEach((file) => console.log(file.path));\n\n// Explicit val specification\nconst files2 = await listFiles(import.meta.url);\nfiles2.forEach((file) => console.log(file.path));\n```\n\n### `listFilesByPath`\n\nLists files in a specific directory path within the current val.\n\n**Signature:**\n\n```ts\nlistFilesByPath(path: string, metaImportUrl?: string): Promise\n```\n\n**Parameters:**\n\n- `path` - The directory path to list files from\n- `metaImportUrl` - Optional. The import.meta.url to determine which val to list\n files from. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n\n**Example:**\n\n```ts\nimport { listFilesByPath } from \"https://esm.town/v/std/utils/index.ts\";\n\n// List files in a specific directory\nconst frontendFiles = await listFilesByPath(\"frontend/\");\nfrontendFiles.forEach((file) => console.log(file.path));\n```\n\n### `httpEndpoint`\n\nGets the HTTP endpoint URL for a the currently running val or a specific file in\nthe val.\n\n**Signature:**\n\n```ts\nhttpEndpoint(path?: string, metaImportUrl?: string): Promise\n```\n\n**Parameters:**\n\n- `path` - Optional. The file path to get the endpoint for. Defaults to the\n currently running endpoint.\n- `metaImportUrl` - Optional. The import.meta.url to determine which val the\n file belongs to. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n\n**Example:**\n\n```ts\nimport { httpEndpoint } from \"https://esm.town/v/std/utils/index.ts\";\n\nconst endpoint = await httpEndpoint();\nconsole.log(endpoint); // Returns the full HTTP URL for the endpoint\n```\n\n### `emailAddress`\n\nGets the email address for a file with an email trigger in the val.\n\nNote: that function does not work for vanity email addresses. It only works for\nthe uuid version, because that info isn't in our API yet.\n\n**Signature:**\n\n```ts\nemailAddress(path: string, metaImportUrl?: string): Promise\n```\n\n**Parameters:**\n\n- `path` - The file path to get the email address for\n- `metaImportUrl` - Optional. The import.meta.url to determine which val the\n file belongs to. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n\n**Example:**\n\n```ts\nimport { emailAddress } from \"https://esm.town/v/std/utils/index.ts\";\n\n// Get the email address for a file with email trigger\nconst email = await emailAddress(\"/handlers/processEmail.ts\");\nconsole.log(email); // Returns: username-fileid@valtown.email\n```\n\n**Notes:**\n\n- The file must have an email trigger configured\n- Returns email in format: `{username}-{fileIdWithoutDashes}@valtown.email`\n- Throws an error if the file doesn't exist or doesn't have an email trigger\n\n### `getValId`\n\nGets the ID of a val\n\n**Signature:**\n\n```ts\ngetValId(metaImportUrl?: string): Promise\n```\n\n**Example:**\n\n```ts\nimport { getValId } from \"https://esm.town/v/std/utils/index.ts\";\n\n// Get the val id for the val this code is in\nconst id = await getValId();\nconsole.log(id); // Returns: \"bb8f592e-f528-11ef-b06d-569c3dd06744\"\n```\n\n### `fetchTranspiledJavaScript`\n\nFetches and transpiles TypeScript/JavaScript code from esm.town URLs.\n\n**Signature:**\n\n```ts\nfetchTranspiledJavaScript(url: string): Promise\n```\n\n**Example:**\n\n```ts\nimport { fetchTranspiledJavaScript } from \"https://esm.town/v/std/utils/index.ts\";\n\nconst code = await fetchTranspiledJavaScript(\n \"https://esm.town/v/std/utils@85-main/index.ts\",\n);\nconsole.log(code);\n```\n\n**Notes:**\n\n- Paths can be specified with or without leading slashes\n- TypeScript files are automatically transpiled to JavaScript\n- Most functions now have optional `metaImportUrl` parameters that default to\n `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`, making them easier to use in most cases\n\n---\n\n## Parse Import Meta\n\nExtract metadata about the currently running Val.\n\n### `parseVal`\n\nParses Val Town metadata from an import.meta.url.\n\n**Signature:**\n\n```ts\nparseVal(importMetaUrl: string): ValMetadata\n```\n\n**Example:**\n\n```ts\nimport { parseVal } from \"https://esm.town/v/std/utils/index.ts\";\n\nconst val = parseVal(import.meta.url);\nconsole.log(val);\n// Output: { owner: \"username\", name: \"valname\", ... }\n```\n\n**Prior Art:**\n\n- [@pomdtr/extractValInfo](https://www.val.town/v/pomdtr/extractValInfo)\n- [@easrng/whoami](https://www.val.town/v/easrng/whoami)\n\n## Serve File\n\nHTTP utilities for serving val files with proper content types.\n\n### `serveFile`\n\nServes a file from the val as an HTTP Response with the correct Content-Type\nheader.\n\n**Signature:**\n\n```ts\nserveFile(path: string, metaImportUrl?: string): Promise\n```\n\n**Parameters:**\n\n- `path` - The file path to serve\n- `metaImportUrl` - Optional. The import.meta.url to determine which val to\n serve from. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n\n**Example:**\n\n```ts\nimport { serveFile } from \"https://esm.town/v/std/utils/index.ts\";\n\n// In a Hono app - most common usage\napp.get(\"/assets/*\", async (c) => {\n return await serveFile(c.req.path);\n});\n\n// Explicit val specification\napp.get(\"/assets/*\", async (c) => {\n return await serveFile(c.req.path, import.meta.url);\n});\n```\n\n### `getContentType`\n\nDetermines the appropriate MIME type for a file based on its extension.\n\n**Signature:**\n\n```ts\ngetContentType(path: string): string\n```\n\n**Example:**\n\n```ts\nimport { getContentType } from \"https://esm.town/v/std/utils/index.ts\";\n\nconsole.log(getContentType(\"index.html\")); // \"text/html; charset=utf-8\"\nconsole.log(getContentType(\"script.ts\")); // \"text/javascript\"\nconsole.log(getContentType(\"data.json\")); // \"application/json; charset=utf-8\"\n```\n\n**Features:**\n\n- TypeScript/TSX/JSX files are served as `text/javascript`\n\n---\n\n## Static HTTP Server\n\nCreate a complete static file server with minimal configuration.\n\n### `staticHTTPServer`\n\nCreates a Hono-based HTTP server that serves static files from your val. The\nserver automatically serves `/index.html` for root requests and handles all\nother file paths.\n\n**Signature:**\n\n```ts\nstaticHTTPServer(importMetaURL?: string): (request: Request) => Promise\n```\n\n**Parameters:**\n\n- `importMetaURL` - Optional. The import.meta.url to determine which val to\n serve files from. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n\n**Example:**\n\n```ts\nimport { staticHTTPServer } from \"https://esm.town/v/std/utils/index.ts\";\n\n// Most common usage - serves files from current val\nexport default staticHTTPServer();\n\n// Explicit val specification\nexport default staticHTTPServer(import.meta.url);\n```\n\n**Features:**\n\n- Automatically serves `/index.html` for root path requests (`/`)\n- Handles all file paths with proper content types\n- Built on Hono for reliable HTTP handling\n- Includes error unwrapping for better debugging\n- Returns a fetch-compatible handler function\n\n**Use Cases:**\n\n- Single-page applications (SPAs)\n- Static websites\n- Documentation sites\n- Asset serving for web applications\n\n**Notes:**\n\n- The server will attempt to serve `/index.html` for root requests\n- All other paths are served as-is from the val's file system\n- Non-existent files will throw \"Failed to fetch file\" errors\n- The returned function is compatible with Val Town's HTTP trigger system\n\n---\n\n## Entry Point Detection\n\nUtility for determining if the current file is the main entry point.\n\n### `isMain`\n\nChecks if the current file is the main entry point of the val. This is a\nreplacement for `import.meta.main` which is not available in Val Town's\nenvironment.\n\n**Signature:**\n\n```ts\nisMain(importMetaURL: string): boolean\n```\n\n**Parameters:**\n\n- `importMetaURL` - The `import.meta.url` of the current file\n\n**Example:**\n\n```ts\nimport { isMain } from \"https://esm.town/v/std/utils/index.ts\";\n\nif (isMain(import.meta.url)) {\n console.log(\"This file is being run directly\");\n // Run main logic here\n} else {\n console.log(\"This file is being imported\");\n // Export functions/classes for use by other files\n}\n```\n\n**Use Cases:**\n\n- Conditional execution of code only when file is run directly\n- Separating library code from executable code in the same file\n- Testing and development workflows\n- Creating dual-purpose files that can be both imported and executed\n\n**Notes:**\n\n- This function compares the provided `import.meta.url` with the\n `VALTOWN_ENTRYPOINT` environment variable\n- In Val Town, the entry point is determined by which file is being executed\n directly (e.g., via HTTP trigger, cron, or manual execution)\n- This is equivalent to Python's `if __name__ == \"__main__\":` pattern or\n Node.js's `require.main === module`\n- Unlike Deno's `import.meta.main`, this works reliably in Val Town's serverless\n environment","deleted","label","children",[],[156],{"_104":175,"_95":176,"_157":177,"_159":-5,"_160":138,"_161":178,"_163":22,"_106":179,"_100":180,"_165":181,"_167":182,"_169":22,"_170":-5,"_171":183,"_98":184},"5b58ae42-b766-11f0-91ef-0224a6c84d84","_docs.tsx","a3fa3482-b765-11f0-a4ad-0224a6c84d84",11,["D",1762031069543],4,"http","import { Hono } from \"npm:hono\";\nimport { listFiles, readFile } from \"./file.ts\";\nimport ts from \"npm:typescript\";\n\nconst app = new Hono();\n\n// Helper functions from vt-docs\nfunction isExported(node: ts.Node): boolean {\n const mods = (node as any).modifiers as ts.NodeArray|undefined;\n return !!(mods && mods.some(m => m.kind === ts.SyntaxKind.ExportKeyword));\n}\n\nfunction getName(node: ts.Node): string {\n const anyNode = node as any;\n const hasDefault = anyNode.modifiers && anyNode.modifiers.some((m: ts.Modifier) => m.kind === ts.SyntaxKind.DefaultKeyword);\n return (anyNode.name && anyNode.name.escapedText) || (hasDefault ? 'default' : '(anonymous)');\n}\n\nfunction collectJsDoc(node: ts.Node) {\n const tags = ts.getJSDocTags(node) || [];\n const docNodes = (node as any).jsDoc as any[]|undefined;\n const descParts = docNodes ? docNodes.map((d: any) => d.comment).filter(Boolean) : [];\n const description = descParts.length ? descParts.join('\\n') : '';\n const byTag: Record = {};\n for (const t of tags) {\n const name = String((t as any).tagName && (t as any).tagName.escapedText || '');\n const text = (t as any).comment || (((t as any).text && (t as any).text.map ? (t as any).text.map((x: any) => x.text).join('') : '')) || '';\n if (!byTag[name]) byTag[name] = [];\n byTag[name].push(String(text));\n }\n return { description, byTag };\n}\n\nfunction signatureFor(node: ts.Node, checker: ts.TypeChecker): string | null {\n if (!('parameters' in (node as any))) return null;\n const fn = node as ts.FunctionDeclaration | ts.MethodDeclaration | any;\n const sig = checker.getSignatureFromDeclaration(fn as any);\n if (!sig) return null;\n const ret = checker.getReturnTypeOfSignature(sig);\n const retStr = checker.typeToString(ret);\n const params = (fn.parameters || []).map((p: ts.ParameterDeclaration) => {\n const t = checker.getTypeAtLocation(p);\n const tStr = checker.typeToString(t);\n const pn = ((p.name as any).escapedText) || checker.typeToString(checker.getTypeAtLocation(p.name));\n const opt = (p as any).questionToken ? '?' : '';\n return `${pn}${opt}: ${tStr}`;\n }).join(', ');\n const name = getName(node);\n return `function ${name}(${params}): ${retStr}`;\n}\n\nasync function extractDocs(filePath: string) {\n const sourceText = await readFile(filePath);\n \n const fileName = `/${filePath}`;\n const compilerOptions: ts.CompilerOptions = { target: ts.ScriptTarget.ES2022, module: ts.ModuleKind.ESNext };\n const host: ts.CompilerHost = {\n getSourceFile: (fn, lv) => ts.createSourceFile(fn, fn===fileName?sourceText:'', lv, true, ts.ScriptKind.TS),\n writeFile: () => {},\n getDefaultLibFileName: (o) => ts.getDefaultLibFilePath(o),\n useCaseSensitiveFileNames: () => true,\n getCanonicalFileName: (f) => f,\n getCurrentDirectory: () => '/',\n getNewLine: () => '\\n',\n fileExists: (fn) => fn===fileName,\n readFile: (fn) => fn===fileName ? sourceText : undefined,\n getDirectories: () => [],\n };\n \n const program = ts.createProgram([fileName], compilerOptions, host);\n const checker = program.getTypeChecker();\n const sf = program.getSourceFile(fileName)!;\n\n const items: any[] = [];\n sf.forEachChild(function walk(node) {\n if (isExported(node)) {\n const { line: startLine } = sf.getLineAndCharacterOfPosition(node.getStart(sf));\n const { line: endLine } = sf.getLineAndCharacterOfPosition(node.getEnd());\n const { description, byTag } = collectJsDoc(node);\n const name = getName(node);\n const signature = signatureFor(node, checker);\n items.push({\n name,\n filePath,\n start: startLine + 1,\n end: endLine + 1,\n description,\n tags: byTag,\n signature,\n });\n }\n ts.forEachChild(node, walk);\n });\n \n return items;\n}\n\nfunction escapeHtml(s: string) {\n const map: Record = { '&': '&', '<': '<', '>': '>', '\"': '"' };\n return s.replace(/[&<>\"]/g, (ch) => map[ch]);\n}\n\napp.get(\"/\", async (c) => {\n const docs = await extractDocs(\"file.ts\");\n \n // Filter to only documented functions (those with descriptions)\n const documentedFunctions = docs.filter(d => d.description);\n \n if (documentedFunctions.length === 0) {\n return c.html(\"

No documented functions found

\");\n }\n \n // Generate HTML for each function\n const functionsHtml = documentedFunctions.map(doc => {\n const sourceUrl = `https://www.val.town/x/stevekrouse/utils/code/${doc.filePath}#L${doc.start}`;\n \n // Format parameters nicely\n const params = (doc.tags.param || []).length \n ? `

Parameters

${escapeHtml(p)}

` \n : '';\n \n // Format returns\n const returns = (doc.tags.returns || doc.tags.return || []).length\n ? `

Returns

${escapeHtml((doc.tags.returns || doc.tags.return || [])[0])}

`\n : '';\n \n // Format examples\n const examples = (doc.tags.example || []).length\n ? `

Example

${escapeHtml((doc.tags.example || []).join('\\n\\n'))}

`\n : '';\n \n return `\n

${escapeHtml(doc.name)}

\n \n ${doc.signature ? `

${escapeHtml(doc.signature)}

` : ''}\n \n

${escapeHtml(doc.description)}

\n \n ${params}\n ${returns}\n ${examples}\n \n \n View source: ${doc.filePath}:${doc.start}\n \n

\n `;\n }).join('\\n');\n \n return c.html(`\n \n \n \n \n Val Town Utils Documentation\n \n \n \n

Val Town Utils Documentation

${documentedFunctions.length} documented function(s)

\n ${functionsHtml}\n \n \n `);\n});\n\nexport default app.fetch;\n",[],[176],{"_104":186,"_95":187,"_157":188,"_159":-5,"_160":138,"_161":162,"_163":189,"_106":190,"_100":32,"_165":181,"_167":191,"_169":22,"_170":-5,"_171":192,"_98":193},"49096142-b765-11f0-9715-0224a6c84d84","_tests.ts","019a4135-63aa-70ea-9ae3-1ae6d69a22ea",true,["D",1762030609227],"import { testServer } from \"./index.ts\";\n\n// Import all test definitions\nimport { parseValTests } from \"./parseImportMeta.test.ts\";\nimport { fileTests } from \"./file.test.ts\";\nimport { serveFileTests } from \"./serve-file.test.ts\";\nimport { staticTests } from \"./static.test.ts\";\nimport { isMainTests } from \"./is-main.test.ts\";\n\n// Combine all tests into a single test server\nexport default testServer([\n ...parseValTests,\n ...fileTests,\n ...serveFileTests,\n ...staticTests,\n ...isMainTests,\n]);",[],[187],{"_104":195,"_95":196,"_157":197,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":198,"_100":32,"_165":199,"_167":200,"_169":22,"_170":-5,"_171":201,"_98":202},"490964c6-b765-11f0-9715-0224a6c84d84","debug_test.ts","019a4135-63aa-70ea-9ae3-1eebf612a7fb",["D",1762030609227],"script","import { expect } from \"jsr:@std/expect\";\nimport { testServer } from \"./test.tsx\";\nimport { \n fetchTranspiledJavaScript, \n listFiles, \n readFile, \n listFilesByPath, \n httpEndpoint,\n emailAddress \n} from \"./file.ts\";\n\n// Let's test each function individually to see which one fails\nexport const debugTests = [\n {\n name: \"Debug Test - readFile non-existent\",\n sourceFile: \"file.ts\",\n tests: [\n {\n name: \" throw error for non-existent file\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n try {\n await readFile(\"/non-existent-file.txt\", import.meta.url);\n throw new Error(\"Expected error but got success\");\n } catch (error) {\n // Check what type of error we actually get\n console.log(\"Error message:\", error.message);\n console.log(\"Error type:\", error.constructor.name);\n \n // The test expects \"File not found\" but let's see what we actually get\n if (error.message.includes(\"Failed to fetch file\") || error.message.includes(\"File not found\")) {\n return; // Test passes\n } else {\n throw new Error(`Unexpected error message: ${error.message}`);\n }\n }\n },\n },\n ],\n },\n];\n\nexport default testServer(debugTests, import.meta.url);",[],[196],{"_104":204,"_95":99,"_157":205,"_159":-5,"_160":138,"_161":206,"_163":22,"_106":207,"_100":208,"_165":166,"_167":209,"_169":22,"_170":-5,"_171":210,"_98":211},"72c62b4a-b766-11f0-b1bd-0224a6c84d84","3ea09f26-b766-11f0-b0e0-0224a6c84d84",12,["D",1762031108844],3,"- [ ] Add target=\"top\" to all links to \"val.town\"\n- [ ] Consider linking to all test for each function near its documentation",[],[99],{"_104":213,"_95":214,"_157":215,"_159":-5,"_160":138,"_161":162,"_163":189,"_106":216,"_100":32,"_165":181,"_167":217,"_169":22,"_170":-5,"_171":218,"_98":219},"4909661a-b765-11f0-9715-0224a6c84d84","example.test.ts","019a4135-63aa-70ea-9ae3-2068a574af4a",["D",1762030609227],"import { expect } from \"jsr:@std/expect\";\nimport { testServer } from \"./test.tsx\";\n\nexport default testServer([\n {\n name: \"Test Group 1\",\n sourceFile: \"test.tsx\",\n tests: [\n {\n name: \"no-op\",\n function: () => {\n return true;\n },\n },\n {\n name: \"passing test\",\n function: () => {\n expect(1).toBe(1);\n },\n },\n {\n name: \"passing test 2\",\n function: () => {\n expect(1).toBe(1);\n },\n },\n ],\n },\n {\n name: \"This is an example of a failing test.\",\n sourceFile: \"test.tsx\",\n tests: [\n {\n name: \"Failing test\",\n function: () => {\n expect(1).toBe(2);\n },\n },\n ],\n },\n], import.meta.url);",[],[214],{"_104":221,"_95":222,"_157":223,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":224,"_100":32,"_165":181,"_167":225,"_169":22,"_170":-5,"_171":226,"_98":227},"490967a0-b765-11f0-9715-0224a6c84d84","file.test.ts","019a4135-63aa-70ea-9ae3-262b1793810e",["D",1762030609227],"import { expect } from \"jsr:@std/expect\";\nimport { testServer } from \"./test.tsx\";\nimport {\n emailAddress,\n fetchTranspiledJavaScript,\n httpEndpoint,\n listFiles,\n listFilesByPath,\n readFile,\n} from \"./file.ts\";\n\nexport const fileTests = [\n {\n name: \"fetchTranspiledJavaScript Tests\",\n sourceFile: \"file.ts\",\n tests: [\n {\n name: \"reject non-esm.town URLs\",\n function: async () => {\n await expect(fetchTranspiledJavaScript(\"https://example.com/test.js\"))\n .rejects.toThrow(\"Can only fetch from https://esm.town\");\n },\n },\n {\n name: \"valid esm.town URL format\",\n function: async () => {\n // This test will only pass if we have a valid valtown token\n // We'll make it conditional on the environment\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n // Skip this test if no token available\n return;\n }\n\n // Test with a known public val\n const url = \"https://esm.town/v/std/utils@85-main/index.ts\";\n const result = await fetchTranspiledJavaScript(url);\n expect(typeof result).toBe(\"string\");\n expect(result.length).toBeGreaterThan(0);\n },\n },\n ],\n },\n {\n name: \"readFile Tests\",\n sourceFile: \"file.ts\",\n tests: [\n {\n name: \"read existing file from val\",\n function: async () => {\n // Test reading this very test file\n const content = await readFile(\"/file.test.ts\", import.meta.url);\n expect(typeof content).toBe(\"string\");\n expect(content).toContain(\"readFile Tests\");\n },\n },\n {\n name: \"paths with and without leading slash\",\n function: async () => {\n // Both should work the same way\n const contentWithSlash = await readFile(\n \"/README.md\",\n import.meta.url,\n );\n const contentWithoutSlash = await readFile(\n \"README.md\",\n import.meta.url,\n );\n expect(contentWithSlash).toBe(contentWithoutSlash);\n },\n },\n {\n name: \" throw error for non-existent file\",\n function: async () => {\n await expect(readFile(\"/non-existent-file.txt\", import.meta.url))\n .rejects.toThrow(\"File not found\");\n },\n },\n ],\n },\n {\n name: \"listFiles Tests\",\n sourceFile: \"file.ts\",\n tests: [\n {\n name: \" list files in val\",\n function: async () => {\n const files = await listFiles(import.meta.url);\n expect(Array.isArray(files)).toBe(true);\n expect(files.length).toBeGreaterThan(0);\n\n // Should contain some expected files\n const filePaths = files.map((f) => f.path);\n expect(filePaths).toContain(\"README.md\");\n expect(filePaths).toContain(\"index.ts\");\n },\n },\n ],\n },\n {\n name: \"listFilesByPath Tests\",\n sourceFile: \"file.ts\",\n tests: [\n {\n name: \" list files in specific directory\",\n function: async () => {\n // Test listing files in root directory (empty path)\n const rootFiles = await listFilesByPath(\"\", import.meta.url);\n expect(Array.isArray(rootFiles)).toBe(true);\n expect(rootFiles.length).toBeGreaterThan(0);\n\n // Should contain some expected files\n const filePaths = rootFiles.map((f) => f.path);\n expect(filePaths).toContain(\"README.md\");\n expect(filePaths).toContain(\"index.ts\");\n },\n },\n {\n name: \" work with default metaImportUrl\",\n function: async () => {\n // Test with default parameter (should use VALTOWN_ENTRYPOINT)\n const files = await listFilesByPath(\"\");\n expect(Array.isArray(files)).toBe(true);\n },\n },\n ],\n },\n {\n name: \"httpEndpoint Tests\",\n sourceFile: \"file.ts\",\n tests: [\n {\n name: \" get HTTP endpoint for file\",\n function: async () => {\n // Test getting endpoint for a test file\n const endpoint = await httpEndpoint(\"/file.test.ts\", import.meta.url);\n expect(typeof endpoint).toBe(\"string\");\n expect(endpoint).toContain(\"https://\");\n expect(endpoint).toContain(\".web.val.run\");\n },\n },\n {\n name: \" work with default metaImportUrl\",\n function: async () => {\n // Test with default parameter\n const endpoint = await httpEndpoint(\"/file.test.ts\");\n expect(typeof endpoint).toBe(\"string\");\n expect(endpoint).toContain(\"https://\");\n },\n },\n {\n name: \" work with no parameters\",\n function: async () => {\n // Test with no params\n const endpoint = await httpEndpoint();\n expect(typeof endpoint).toBe(\"string\");\n expect(endpoint).toContain(\"https://\");\n },\n },\n ],\n },\n {\n name: \"emailAddress Tests\",\n sourceFile: \"file.ts\",\n tests: [\n {\n name: \" get email address for email trigger file\",\n function: async () => {\n // This test would need a file with email trigger to work properly\n // For now, we'll test the error case for a non-email file\n try {\n await emailAddress(\"/file.test.ts\", import.meta.url);\n // If we get here, the file unexpectedly has an email trigger\n expect(false).toBe(true); // Force failure\n } catch (error) {\n expect(error.message).toContain(\"File does not have email trigger\");\n }\n },\n },\n {\n name: \" throw error for non-existent file\",\n function: async () => {\n await expect(emailAddress(\"/non-existent-file.ts\", import.meta.url))\n .rejects.toThrow(\"File not found\");\n },\n },\n {\n name: \" work with default metaImportUrl\",\n function: async () => {\n // Test with default parameter (should use VALTOWN_ENTRYPOINT)\n try {\n await emailAddress(\"/file.test.ts\");\n expect(false).toBe(true); // Force failure if no error\n } catch (error) {\n expect(error.message).toContain(\"File does not have email trigger\");\n }\n },\n },\n ],\n },\n {\n name: \"readFile with default parameter Tests\",\n sourceFile: \"file.ts\",\n tests: [\n {\n name: \" work without metaImportUrl\",\n function: async () => {\n // Test reading file with default parameter\n const content = await readFile(\"/README.md\");\n expect(typeof content).toBe(\"string\");\n expect(content).toContain(\"Val Town Utilities\");\n },\n },\n ],\n },\n {\n name: \"listFiles with default parameter Tests\",\n sourceFile: \"file.ts\",\n tests: [\n {\n name: \" work without metaImportUrl\",\n function: async () => {\n // Test listing files with default parameter\n const files = await listFiles();\n expect(Array.isArray(files)).toBe(true);\n expect(files.length).toBeGreaterThan(0);\n\n // Should contain some expected files\n const filePaths = files.map((f) => f.path);\n expect(filePaths).toContain(\"README.md\");\n expect(filePaths).toContain(\"index.ts\");\n },\n },\n ],\n },\n];\n\nexport default testServer(fileTests, import.meta.url);",[],[222],{"_104":229,"_95":230,"_157":231,"_159":-5,"_160":138,"_161":101,"_163":22,"_106":232,"_100":208,"_165":199,"_167":233,"_169":22,"_170":-5,"_171":234,"_98":235},"75819540-b766-11f0-82eb-0224a6c84d84","file.ts","019a4135-63aa-70ea-9ae3-29ed06d12226",["D",1762031113420],"import ValTown from \"npm:@valtown/sdk@1.9.0\";\nimport { HTTPException } from \"npm:hono/http-exception\";\nimport { parseVal } from \"./parseImportMeta.ts\";\nimport { API_URL } from \"https://esm.town/v/std/API_URL\";\n\nconst vt = new ValTown({\n baseURL: API_URL,\n});\n\n/**\n * Reads the contents of a file from the current val.\n *\n * @param path - The file path to read (with or without leading slash)\n * @param metaImportUrl - Optional. The import.meta.url to determine which val to read from. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n * @returns Promise that resolves to the file contents as a string\n *\n * @example\n * ```ts\n * import { readFile } from \"https://esm.town/v/std/utils/index.ts\";\n *\n * // Most common usage - reads from current val\n * const content = await readFile(\"/README.md\");\n * console.log(content);\n *\n * // Explicit val specification\n * const content2 = await readFile(\"/README.md\", import.meta.url);\n * console.log(content2);\n * ```\n */\nexport async function readFile(\n path: string,\n metaImportUrl = Deno.env.get(\"VALTOWN_ENTRYPOINT\"),\n) {\n const val = parseVal(metaImportUrl);\n const pathFragment = path.startsWith(\"/\") ? path.slice(1) : path; // remove the leading slash\n const esmURL = val.links.module.valPinned + pathFragment;\n let text: string;\n try {\n text = await fetchTranspiledJavaScript(esmURL);\n } catch (err: any) {\n if (err instanceof HTTPException) {\n throw err;\n }\n throw new Error(\"Failed to fetch file \" + esmURL);\n }\n return text;\n}\n\nexport async function httpEndpoint(\n path = \"\",\n metaImportUrl = Deno.env.get(\"VALTOWN_ENTRYPOINT\"),\n) {\n const normalizedPath = path.startsWith(\"/\") ? path.slice(1) : path;\n\n const files = await listFilesByPath(normalizedPath, metaImportUrl);\n const file = path === \"\"\n ? files.find((f) => f.path === parseVal().path) ??\n files.find((f) => f.links?.endpoint)\n : files.find((f) => f.path === normalizedPath);\n\n if (!file) {\n throw new Error(`File not found: ${path}`);\n }\n\n if (!file.links?.endpoint) {\n throw new Error(`No HTTP endpoint available for file: ${path}`);\n }\n\n return file.links.endpoint;\n}\n\nexport async function emailAddress(\n path: string,\n metaImportUrl = Deno.env.get(\"VALTOWN_ENTRYPOINT\"),\n) {\n const normalizedPath = path.startsWith(\"/\") ? path.slice(1) : path;\n\n const files = await listFilesByPath(normalizedPath, metaImportUrl);\n const file = files.find((f) => f.path === normalizedPath);\n\n if (!file) {\n throw new Error(`File not found: ${path}`);\n }\n\n if (file.type !== \"email\") {\n throw new Error(`File does not have email trigger: ${path}`);\n }\n\n const username = parseVal(metaImportUrl).username;\n return `${username}-${file.id.replaceAll(\"-\", \"\")}@valtown.email`;\n}\n\n/**\n * Lists all files in the current val with their metadata.\n *\n * @param metaImportUrl - Optional. The import.meta.url to determine which val to list files from. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n * @returns Promise that resolves to an array of File objects with metadata\n *\n * @example\n * ```ts\n * import { listFiles } from \"https://esm.town/v/std/utils/index.ts\";\n *\n * // Most common usage - lists files from current val\n * const files = await listFiles();\n * files.forEach((file) => console.log(file.path));\n *\n * // Explicit val specification\n * const files2 = await listFiles(import.meta.url);\n * files2.forEach((file) => console.log(file.path));\n * ```\n */\nexport function listFiles(\n metaImportUrl = Deno.env.get(\"VALTOWN_ENTRYPOINT\"),\n) {\n return listFilesByPath(\"\", metaImportUrl);\n}\n\nexport async function getValId(\n metaImportUrl = Deno.env.get(\"VALTOWN_ENTRYPOINT\"),\n) {\n const val = parseVal(metaImportUrl);\n const { id } = await vt.alias.username.valName.retrieve(\n val.username,\n val.name,\n );\n return id;\n}\n\n/**\n * Lists files in a specific directory path within the current val.\n *\n * @param path - The directory path to list files from\n * @param metaImportUrl - Optional. The import.meta.url to determine which val to list files from. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n * @returns Promise that resolves to an array of File objects in the specified directory\n *\n * @example\n * ```ts\n * import { listFilesByPath } from \"https://esm.town/v/std/utils/index.ts\";\n *\n * // List files in a specific directory\n * const frontendFiles = await listFilesByPath(\"frontend/\");\n * frontendFiles.forEach((file) => console.log(file.path));\n * ```\n */\nexport async function listFilesByPath(\n path: string,\n metaImportUrl = Deno.env.get(\"VALTOWN_ENTRYPOINT\"),\n) {\n const val = parseVal(metaImportUrl);\n const valId = await getValId(metaImportUrl);\n\n const params: {\n path: string;\n recursive: boolean;\n branch_id?: string;\n } = {\n path,\n recursive: true,\n };\n\n if (val.branch !== \"main\") {\n const branches = await Array.fromAsync(vt.vals.branches.list(valId, {}));\n const branch = branches.find((b) => b.name === val.branch);\n if (!branch) {\n throw new Error(\"Failed to find branch \" + val.branch);\n }\n params.branch_id = branch.id; // set like this because of a stainless bug\n }\n\n const files = await Array.fromAsync(vt.vals.files.retrieve(valId, params));\n return files;\n}\n\nexport async function fetchTranspiledJavaScript(url: string) {\n if (!url.startsWith(\"https://esm.town\")) {\n throw Error(\"Can only fetch from https://esm.town\");\n }\n const res = await fetch(url, {\n headers: {\n // Always transpile TS to JS\n // Learn more: https://www.val.town/v/stevekrouse/esmTownTranspileDemo\n \"User-Agent\": \"\",\n \"Authorization\": \"Bearer \" + Deno.env.get(\"valtown\"),\n },\n });\n if (res.status === 404) {\n throw new HTTPException(res.status, { message: \"File not found\" });\n }\n if (!res.ok) {\n throw new Error(\"Failed to fetch \" + url + res.status);\n }\n return await res.text();\n}",[],[230],{"_104":237,"_95":238,"_157":239,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":240,"_100":32,"_165":199,"_167":241,"_169":22,"_170":-5,"_171":242,"_98":243},"49097448-b765-11f0-9715-0224a6c84d84","index.ts","019a4135-63aa-70ea-9ae3-2d34e9ecfe49",["D",1762030609227],"export {\n emailAddress,\n fetchTranspiledJavaScript,\n getValId,\n httpEndpoint,\n listFiles,\n listFilesByPath,\n readFile,\n} from \"./file.ts\";\nexport { parseVal } from \"./parseImportMeta.ts\";\nexport { getContentType, serveFile } from \"./serve-file.ts\";\nexport { testServer } from \"./test.tsx\";\nexport { staticHTTPServer } from \"./static.tsx\";\nexport { isMain } from \"./is-main.ts\";\n\n// for backwards compatibility\nexport { parseProject } from \"https://esm.town/v/std/utils@105-main/parseImportMeta/project.ts\";",[],[238],{"_104":245,"_95":246,"_157":247,"_159":-5,"_160":138,"_161":162,"_163":189,"_106":248,"_100":32,"_165":181,"_167":249,"_169":22,"_170":-5,"_171":250,"_98":251},"49097588-b765-11f0-9715-0224a6c84d84","is-main.test.ts","019a4135-63aa-70ea-9ae3-33a4275c3c3e",["D",1762030609227],"import { expect } from \"jsr:@std/expect\";\nimport { testServer } from \"./test.tsx\";\nimport { isMain } from \"./is-main.ts\";\n\nexport const isMainTests = [\n {\n name: \"isMain Tests\",\n sourceFile: \"isMain.ts\",\n tests: [\n {\n name: \" return true when current file is the entry point\",\n function: () => {\n // Test with the actual current file - this should return true\n // since this test file is being executed directly\n const result = isMain(Deno.env.get(\"VALTOWN_ENTRYPOINT\"));\n expect(result).toBe(true);\n },\n },\n {\n name: \" return false for different URL\",\n function: () => {\n // Test with a different URL that's definitely not the entry point\n const differentURL = \"https://esm.town/v/user/test@1-main/helper.ts\";\n const result = isMain(differentURL);\n expect(result).toBe(false);\n },\n },\n ],\n },\n];\n\nexport default testServer(isMainTests);",[],[246],{"_104":253,"_95":254,"_157":255,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":256,"_100":32,"_165":199,"_167":257,"_169":22,"_170":-5,"_171":258,"_98":259},"490976dc-b765-11f0-9715-0224a6c84d84","is-main.ts","019a4135-63aa-70ea-9ae3-3698f5acee37",["D",1762030609227],"export function isMain(importMetaURL: string): boolean {\n return importMetaURL === Deno.env.get(\"VALTOWN_ENTRYPOINT\");\n}",[],[254],{"_104":261,"_95":262,"_157":263,"_159":-5,"_160":138,"_161":162,"_163":189,"_106":264,"_100":32,"_165":181,"_167":265,"_169":22,"_170":-5,"_171":266,"_98":267},"490977e0-b765-11f0-9715-0224a6c84d84","parseImportMeta.test.ts","019a4135-63aa-70ea-9ae3-38efcff65be5",["D",1762030609227],"import { expect } from \"jsr:@std/expect\";\nimport { testServer } from \"./test.tsx\";\nimport { parseVal } from \"./parseImportMeta.ts\";\n\nexport const parseValTests = [\n {\n name: \"parseVal Tests\",\n sourceFile: \"parseImportMeta.ts\",\n tests: [\n {\n name: \"val on main branch\",\n function: () => {\n const input = \"https://esm.town/v/maxm/queue@11-main/runMigrations\";\n const expected = {\n username: \"maxm\",\n name: \"queue\",\n version: \"11\",\n branch: \"main\",\n path: \"runMigrations\",\n links: {\n self: {\n latest: \"https://www.val.town/x/maxm/queue/code/runMigrations\",\n pinned:\n \"https://www.val.town/x/maxm/queue/branch/main/version/11/code/runMigrations\",\n val: \"https://www.val.town/x/maxm/queue\",\n },\n module: {\n latest: \"https://esm.town/v/maxm/queue/runMigrations\",\n pinned: \"https://esm.town/v/maxm/queue@11-main/runMigrations\",\n val: \"https://esm.town/v/maxm/queue/\",\n valPinned: \"https://esm.town/v/maxm/queue@11-main/\",\n },\n },\n };\n expect(parseVal(input)).toEqual(expected);\n },\n },\n {\n name: \"val with p prefix instead of v\",\n function: () => {\n const input = \"https://esm.town/p/stevekrouse/status2@1-main/notify\";\n const expected = {\n username: \"stevekrouse\",\n name: \"status2\",\n version: \"1\",\n branch: \"main\",\n path: \"notify\",\n links: {\n self: {\n latest:\n \"https://www.val.town/x/stevekrouse/status2/code/notify\",\n pinned:\n \"https://www.val.town/x/stevekrouse/status2/branch/main/version/1/code/notify\",\n val: \"https://www.val.town/x/stevekrouse/status2\",\n },\n module: {\n latest: \"https://esm.town/p/stevekrouse/status2/notify\",\n pinned: \"https://esm.town/p/stevekrouse/status2@1-main/notify\",\n val: \"https://esm.town/p/stevekrouse/status2/\",\n valPinned: \"https://esm.town/p/stevekrouse/status2@1-main/\",\n },\n },\n };\n expect(parseVal(input)).toEqual(expected);\n },\n },\n {\n name: \"val on feature branch\",\n function: () => {\n const input =\n \"https://esm.town/v/user/val@1-feature-branch-name/path/asdf/asfd/asdf/asfd\";\n const expected = {\n username: \"user\",\n name: \"val\",\n version: \"1\",\n branch: \"feature-branch-name\",\n path: \"path/asdf/asfd/asdf/asfd\",\n links: {\n self: {\n latest:\n \"https://www.val.town/x/user/val/branch/feature-branch-name/code/path/asdf/asfd/asdf/asfd\",\n pinned:\n \"https://www.val.town/x/user/val/branch/feature-branch-name/version/1/code/path/asdf/asfd/asdf/asfd\",\n val: \"https://www.val.town/x/user/val\",\n },\n module: {\n latest:\n \"https://esm.town/v/user/val/branch/feature-branch-name/path/asdf/asfd/asdf/asfd\",\n pinned:\n \"https://esm.town/v/user/val@1-feature-branch-name/path/asdf/asfd/asdf/asfd\",\n val: \"https://esm.town/v/user/val/\",\n valPinned: \"https://esm.town/v/user/val@1-feature-branch-name/\",\n },\n },\n };\n expect(parseVal(input)).toEqual(expected);\n },\n },\n {\n name: \"complex branch & file name\",\n function: () => {\n const input =\n \"https://esm.town/v/dev/app@22-complex-branch-with-dashes/val.foo.bar\";\n const expected = {\n username: \"dev\",\n name: \"app\",\n version: \"22\",\n branch: \"complex-branch-with-dashes\",\n path: \"val.foo.bar\",\n links: {\n self: {\n latest:\n \"https://www.val.town/x/dev/app/branch/complex-branch-with-dashes/code/val.foo.bar\",\n pinned:\n \"https://www.val.town/x/dev/app/branch/complex-branch-with-dashes/version/22/code/val.foo.bar\",\n val: \"https://www.val.town/x/dev/app\",\n },\n module: {\n latest:\n \"https://esm.town/v/dev/app/branch/complex-branch-with-dashes/val.foo.bar\",\n pinned:\n \"https://esm.town/v/dev/app@22-complex-branch-with-dashes/val.foo.bar\",\n val: \"https://esm.town/v/dev/app/\",\n valPinned:\n \"https://esm.town/v/dev/app@22-complex-branch-with-dashes/\",\n },\n },\n };\n expect(parseVal(input)).toEqual(expected);\n },\n },\n ],\n },\n];\n\nexport default testServer(parseValTests, import.meta.url);",[],[262],{"_104":269,"_95":270,"_157":271,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":272,"_100":32,"_165":199,"_167":273,"_169":22,"_170":-5,"_171":274,"_98":275},"49097b8c-b765-11f0-9715-0224a6c84d84","parseImportMeta.ts","019a4135-63aa-70ea-9ae3-3faf59a4e7b0",["D",1762030609227],"interface Val {\n username: string;\n name: string;\n version: string;\n branch: string;\n path: string;\n links: {\n self: {\n latest: string;\n pinned: string;\n val: string;\n };\n module: {\n latest: string;\n pinned: string;\n val: string;\n valPinned: string;\n };\n };\n}\n\nexport function parseVal(url = Deno.env.get(\"VALTOWN_ENTRYPOINT\")): Val {\n // Updated pattern to capture the prefix (v or p) and handle URL format variations\n const pattern =\n /^https:\\/\\/esm\\.town\\/(v|p)\\/([^/]+)\\/([^@]+)@(\\d+)-(.+?)(\\/.*)?$/;\n const match = url.match(pattern);\n\n if (!match) {\n throw new Error(`Invalid ESM Town URL format: ${url}`);\n }\n\n let [, prefix, username, name, version, branch, path = \"\"] = match;\n // Remove leading slash if present\n path = path && path.startsWith(\"/\") ? path.substring(1) : path;\n\n const branchPath = branch === \"main\" ? \"\" : `/branch/${branch}`;\n\n const valURL = `https://www.val.town/x/${username}/${name}`;\n\n return {\n username,\n name,\n version,\n branch,\n path,\n links: {\n self: {\n latest: `${valURL}${branchPath}/code/${path}`,\n pinned: `${valURL}/branch/${branch}/version/${version}/code/${path}`,\n val: valURL,\n },\n module: {\n latest:\n `https://esm.town/${prefix}/${username}/${name}${branchPath}/${path}`,\n pinned:\n `https://esm.town/${prefix}/${username}/${name}@${version}-${branch}/${path}`,\n val: `https://esm.town/${prefix}/${username}/${name}/`,\n valPinned:\n `https://esm.town/${prefix}/${username}/${name}@${version}-${branch}/`,\n },\n },\n };\n}",[],[270],{"_104":277,"_95":278,"_157":279,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":280,"_100":32,"_165":181,"_167":281,"_169":22,"_170":-5,"_171":282,"_98":283},"49097d4e-b765-11f0-9715-0224a6c84d84","serve-file.test.ts","019a4135-63aa-70ea-9ae3-42fd6f42294c",["D",1762030609227],"import { expect } from \"jsr:@std/expect\";\nimport { testServer } from \"./test.tsx\";\nimport { getContentType, serveFile } from \"./serve-file.ts\";\n\nexport const serveFileTests = [\n {\n name: \"getContentType Tests\",\n sourceFile: \"serve-file.ts\",\n tests: [\n {\n name: \"text/javascript for TypeScript files\",\n function: () => {\n expect(getContentType(\"test.ts\")).toBe(\"text/javascript\");\n expect(getContentType(\"component.tsx\")).toBe(\"text/javascript\");\n expect(getContentType(\"module.jsx\")).toBe(\"text/javascript\");\n },\n },\n {\n name: \"common file extensions\",\n function: () => {\n expect(getContentType(\"index.html\")).toBe(\"text/html; charset=utf-8\");\n expect(getContentType(\"styles.css\")).toBe(\"text/css; charset=utf-8\");\n expect(getContentType(\"script.js\")).toBe(\n \"application/javascript; charset=utf-8\",\n );\n expect(getContentType(\"data.json\")).toBe(\n \"application/json; charset=utf-8\",\n );\n expect(getContentType(\"image.png\")).toBe(\"image/png\");\n expect(getContentType(\"document.pdf\")).toBe(\"application/pdf\");\n },\n },\n {\n name: \"octet-stream for unknown extensions\",\n function: () => {\n expect(getContentType(\"file.unknown\")).toBe(\n \"application/octet-stream\",\n );\n expect(getContentType(\"noextension\")).toBe(\n \"application/octet-stream\",\n );\n },\n },\n {\n name: \" handle files with multiple dots\",\n function: () => {\n expect(getContentType(\"file.min.js\")).toBe(\n \"application/javascript; charset=utf-8\",\n );\n expect(getContentType(\"component.test.ts\")).toBe(\"text/javascript\");\n expect(getContentType(\"data.backup.json\")).toBe(\n \"application/json; charset=utf-8\",\n );\n },\n },\n ],\n },\n {\n name: \"serveFile Tests\",\n sourceFile: \"serve-file.ts\",\n tests: [\n {\n name: \"correct content type\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\n const response = await serveFile(\"/README.md\", import.meta.url);\n expect(response).toBeInstanceOf(Response);\n expect(response.headers.get(\"Content-Type\")).toBe(\n \"text/markdown; charset=utf-8\",\n );\n\n const content = await response.text();\n expect(typeof content).toBe(\"string\");\n expect(content.length).toBeGreaterThan(0);\n },\n },\n {\n name: \"serve TypeScript files as JavaScript\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\n const response = await serveFile(\"/index.ts\", import.meta.url);\n expect(response.headers.get(\"Content-Type\")).toBe(\"text/javascript\");\n\n const content = await response.text();\n expect(content).toContain(\"export\");\n },\n },\n {\n name: \"errors gracefully\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\n // This should throw an error which will be caught by the test framework\n await expect(serveFile(\"/non-existent-file.txt\", import.meta.url))\n .rejects.toThrow(\"File not found\");\n },\n },\n {\n name: \" work with default metaImportUrl parameter\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\n // Test serving file with default parameter\n const response = await serveFile(\"/README.md\");\n expect(response).toBeInstanceOf(Response);\n expect(response.headers.get(\"Content-Type\")).toBe(\n \"text/markdown; charset=utf-8\",\n );\n\n const content = await response.text();\n expect(typeof content).toBe(\"string\");\n expect(content.length).toBeGreaterThan(0);\n },\n },\n ],\n },\n];\n\nexport default testServer(serveFileTests, import.meta.url);",[],[278],{"_104":285,"_95":286,"_157":287,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":288,"_100":32,"_165":199,"_167":289,"_169":22,"_170":-5,"_171":290,"_98":291},"49098028-b765-11f0-9715-0224a6c84d84","serve-file.ts","019a4135-63aa-70ea-9ae3-45d434f8df22",["D",1762030609227],"import { contentType } from \"npm:mime-types@2.1.35\";\nimport { readFile } from \"./file.ts\";\n\nexport async function serveFile(\n path: string, \n metaImportUrl = Deno.env.get(\"VALTOWN_ENTRYPOINT\")\n): Promise {\n const text = await readFile(path, metaImportUrl);\n const content_type = getContentType(path);\n return new Response(text, {\n headers: {\n \"Content-Type\": content_type,\n },\n });\n}\n\nexport function getContentType(path: string): string {\n if (path.endsWith(\".ts\") || path.endsWith(\".jsx\") || path.endsWith(\".tsx\")) {\n return \"text/javascript\";\n }\n const ext = path.split(\".\").pop();\n return contentType(ext) || \"application/octet-stream\";\n}",[],[286],{"_104":293,"_95":294,"_157":295,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":296,"_100":32,"_165":181,"_167":297,"_169":22,"_170":-5,"_171":298,"_98":299},"4909814a-b765-11f0-9715-0224a6c84d84","static.test.ts","019a4135-63aa-70ea-9ae3-489c611ce8ba",["D",1762030609227],"import { expect } from \"jsr:@std/expect\";\nimport { testServer } from \"./test.tsx\";\nimport { staticHTTPServer } from \"./static.tsx\";\n\nexport const staticTests = [\n {\n name: \"staticHTTPServer Tests\",\n sourceFile: \"static.tsx\",\n tests: [\n {\n name: \" return a function\",\n function: () => {\n const server = staticHTTPServer(import.meta.url);\n expect(typeof server).toBe(\"function\");\n },\n },\n {\n name: \"root path request\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\n const server = staticHTTPServer(import.meta.url);\n const request = new Request(\"https://example.com/\");\n\n try {\n const response = await server(request);\n expect(response).toBeInstanceOf(Response);\n // The response should attempt to serve /index.html\n // This might fail if index.html doesn't exist, but that's expected behavior\n } catch (error) {\n // If index.html doesn't exist, it should throw a \"Failed to fetch file\" error\n expect(error.message).toContain(\"Failed to fetch file\");\n }\n },\n },\n {\n name: \"root path request - implicit import.meta.url\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\n const server = staticHTTPServer();\n const request = new Request(\"https://example.com/\");\n\n try {\n const response = await server(request);\n expect(response).toBeInstanceOf(Response);\n // The response should attempt to serve /index.html\n // This might fail if index.html doesn't exist, but that's expected behavior\n } catch (error) {\n // If index.html doesn't exist, it should throw a \"Failed to fetch file\" error\n expect(error.message).toContain(\"Failed to fetch file\");\n }\n },\n },\n {\n name: \"file path requests\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\n const server = staticHTTPServer(import.meta.url);\n const request = new Request(\"https://example.com/README.md\");\n\n const response = await server(request);\n expect(response).toBeInstanceOf(Response);\n expect(response.headers.get(\"Content-Type\")).toBe(\n \"text/markdown; charset=utf-8\",\n );\n\n const content = await response.text();\n expect(typeof content).toBe(\"string\");\n expect(content.length).toBeGreaterThan(0);\n },\n },\n {\n name: \"nested path requests\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\n const server = staticHTTPServer(import.meta.url);\n const request = new Request(\"https://example.com/test.tsx\");\n\n const response = await server(request);\n expect(response).toBeInstanceOf(Response);\n expect(response.headers.get(\"Content-Type\")).toBe(\"text/javascript\");\n\n const content = await response.text();\n expect(content).toContain(\"testServer\");\n },\n },\n {\n name: \"non-existent file requests\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\n const server = staticHTTPServer(import.meta.url);\n const request = new Request(\n \"https://example.com/non-existent-file.txt\",\n );\n\n const resp = await server(request);\n expect(resp.status).toBe(404);\n expect(await resp.text()).toEqual(\"File not found\");\n },\n },\n ],\n },\n];\n\nexport default testServer(staticTests, import.meta.url);",[],[294],{"_104":301,"_95":302,"_157":303,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":304,"_100":32,"_165":199,"_167":305,"_169":22,"_170":-5,"_171":306,"_98":307},"490985b4-b765-11f0-9715-0224a6c84d84","static.tsx","019a4135-63aa-70ea-9ae3-4cc857caadb8",["D",1762030609227],"import { Hono } from \"npm:hono\";\nimport { HTTPException } from \"npm:hono/http-exception\";\nimport { serveFile } from \"./serve-file.ts\";\n\nexport function staticHTTPServer(\n importMetaURL = Deno.env.get(\"VALTOWN_ENTRYPOINT\"),\n) {\n const app = new Hono();\n app.get(\"/\", () => serveFile(\"/index.html\", importMetaURL));\n app.get(\"/**/*\", (c) => serveFile(c.req.path, importMetaURL));\n\n // Unwrap Hono errors to see original error details\n app.onError((err) => {\n if (err instanceof HTTPException) {\n // Get the custom response\n return err.getResponse();\n }\n return Promise.reject(err);\n });\n\n return app.fetch;\n}",[],[302],{"_104":309,"_95":310,"_157":311,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":312,"_100":32,"_165":199,"_167":313,"_169":22,"_170":-5,"_171":314,"_98":315},"49098cb2-b765-11f0-9715-0224a6c84d84","test.tsx","019a4135-63aa-70ea-9ae3-533abaa7c716",["D",1762030609227],"/** @jsxImportSource https://esm.sh/preact */\nimport { makeBadge } from \"npm:badge-maker\";\nimport { render } from \"npm:preact-render-to-string\";\nimport prettyMilliseconds from \"npm:pretty-ms\";\n\ninterface TestGroup {\n name: string;\n tests: TestCase[];\n before?: () => void;\n after?: () => void;\n}\n\ninterface TestCase {\n name: string;\n // deno-lint-ignore ban-types\n function: Function;\n}\n\ninterface TestOutput {\n message?: string;\n pass: boolean;\n duration: number;\n}\n\nasync function runTest(test: TestCase): Promise {\n let pass, message;\n const start = performance.now();\n try {\n await test.function();\n pass = true;\n } catch (e: any) {\n message = e.message;\n pass = false;\n }\n return {\n message,\n pass,\n duration: performance.now() - start,\n };\n}\n\nfunction renderBadge(\n { label, passedCount, testCount }: {\n label?: string;\n passedCount: number;\n testCount: number;\n },\n) {\n return makeBadge({\n label: label ?? \"Tests\",\n message: `${passedCount}/${testCount} passed`,\n color: passedCount === testCount ? \"brightgreen\" : \"red\",\n });\n}\n\nfunction Badge(\n { label, passedCount, testCount }: {\n label?: string;\n passedCount: number;\n testCount: number;\n },\n) {\n const svgMarkup = renderBadge({ label, passedCount, testCount });\n const srcDoc = `${svgMarkup}`;\n return (\n \n );\n}\n\nfunction renderTestResults(\n testGroups: TestGroup[],\n outputs: { [groupName: string]: TestOutput[] },\n) {\n const totalPassed =\n Object.values(outputs).flat().filter((output: TestOutput) => output.pass)\n .length;\n const totalTests = testGroups.reduce(\n (sum, group) => sum + group.tests.length,\n 0,\n );\n return render(\n \n \n Tests\n \n \n \n

Tests

\n \n \n ({prettyMilliseconds(\n Object.values(outputs).flat().reduce(\n (sum, output) => sum + output.duration,\n 0,\n ),\n )})\n \n

\n {testGroups.map((group: TestGroup) => {\n return (\n

\n output.pass).length}\n testCount={group.tests.length}\n />\n \n ({prettyMilliseconds(\n outputs[group.name].reduce(\n (sum, output) => sum + output.duration,\n 0,\n ),\n )})\n \n

\n\n {outputs[group.name].map((\n output: TestOutput,\n index: number,\n ) => (\n

\n \n {output.message && (\n {output.message}\n )}\n \n ({prettyMilliseconds(output.duration)})\n \n

\n \n {`${output.pass ? \"✓\" : \"✗\"} ${output.duration.toFixed(3)}ms`}\n \n

\n ))}\n

\n );\n })}\n

\n \n \n ,\n );\n}\n\nexport const testServer = (testGroups: TestGroup[]) => async (req: Request) => {\n const url = new URL(req.url);\n const outputs: { [groupName: string]: TestOutput[] } = {};\n\n for (const group of testGroups) {\n group.before?.();\n outputs[group.name] = await Promise.all(group.tests.map(runTest));\n group.after?.();\n }\n\n if (url.pathname === \"/badge.svg\") {\n const totalPassed =\n Object.values(outputs).flat().filter((output: TestOutput) => output.pass)\n .length;\n const totalTests = testGroups.reduce(\n (sum, group) => sum + group.tests.length,\n 0,\n );\n\n return new Response(\n renderBadge({\n label: \"Tests\",\n passedCount: totalPassed,\n testCount: totalTests,\n }),\n {\n headers: {\n \"content-type\": \"image/svg+xml;charset=UTF-8\",\n },\n },\n );\n }\n return new Response(renderTestResults(testGroups, outputs), {\n headers: {\n \"content-type\": \"text/html;charset=UTF-8\",\n },\n });\n};",[],[310],"files",[154,174,185,194,203,212,220,228,236,244,252,260,268,276,284,292,300,308],"counts",{"_320":32,"_321":162,"_322":32,"_323":324},"pulls","branches","forks","envVars",{"_325":32,"_326":32},"count","emptyCount","contents",[],{"_104":204,"_95":99,"_157":205,"_159":-5,"_160":138,"_161":206,"_163":22,"_106":330,"_100":208,"_165":166,"_167":209,"_169":22,"_170":-5,"_98":331},["D",1762031108844],[99],"upstreamProject",{"_104":146,"_95":96,"_112":334,"_113":-5,"_110":111,"_23":335},"Val Town Utilities",{"_93":336,"_130":337},"std","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJVaVhpQ1BId3dscVpBbkdZVWlMNjJtcjkxWS5wbmcifQ","upstreamBranch",{"_104":141,"_106":340,"_341":342,"_95":43,"_139":146,"_100":343,"_140":-5,"_142":-5,"_344":345,"_108":-5,"_151":22,"_110":111,"_150":336,"_16":148,"_149":96},["D",1740674076598],"updatedAt",["D",1762172146286],240,"lockfileKey","1762172146630-esm.town_v_std_utils@240-main","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.version.$version.code.$",{"_93":94,"_95":96,"_97":43,"_100":101,"_98":99,"_102":352,"_152":357,"_316":412,"_166":413,"_327":415,"_416":417,"_420":-5,"_421":32,"_422":423,"_424":425},{"_104":105,"_95":96,"_106":353,"_108":-5,"_109":22,"_110":111,"_112":-5,"_113":-5,"_14":114,"_115":-5,"_116":22,"_117":-5,"_118":32,"_16":119,"_120":121,"_122":121,"_123":124,"_125":124,"_126":124,"_127":121,"_128":121,"_23":354,"_132":355,"_135":356,"_151":22},["D",1762030609227],{"_93":94,"_130":131},{"_93":94,"_134":131},{"_100":137,"_95":43,"_104":138,"_139":105,"_140":141,"_142":143,"_144":111,"_145":146,"_147":148,"_149":96,"_150":94},[358,361,364,367,370,373,376,379,382,385,388,391,394,397,400,403,406,409],{"_104":155,"_95":156,"_157":158,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":164,"_100":32,"_165":166,"_167":168,"_169":22,"_170":-5,"_171":359,"_98":360},[],[156],{"_104":175,"_95":176,"_157":177,"_159":-5,"_160":138,"_161":178,"_163":22,"_106":179,"_100":180,"_165":181,"_167":182,"_169":22,"_170":-5,"_171":362,"_98":363},[],[176],{"_104":186,"_95":187,"_157":188,"_159":-5,"_160":138,"_161":162,"_163":189,"_106":190,"_100":32,"_165":181,"_167":191,"_169":22,"_170":-5,"_171":365,"_98":366},[],[187],{"_104":195,"_95":196,"_157":197,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":198,"_100":32,"_165":199,"_167":200,"_169":22,"_170":-5,"_171":368,"_98":369},[],[196],{"_104":204,"_95":99,"_157":205,"_159":-5,"_160":138,"_161":206,"_163":22,"_106":207,"_100":208,"_165":166,"_167":209,"_169":22,"_170":-5,"_171":371,"_98":372},[],[99],{"_104":213,"_95":214,"_157":215,"_159":-5,"_160":138,"_161":162,"_163":189,"_106":216,"_100":32,"_165":181,"_167":217,"_169":22,"_170":-5,"_171":374,"_98":375},[],[214],{"_104":221,"_95":222,"_157":223,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":224,"_100":32,"_165":181,"_167":225,"_169":22,"_170":-5,"_171":377,"_98":378},[],[222],{"_104":229,"_95":230,"_157":231,"_159":-5,"_160":138,"_161":101,"_163":22,"_106":232,"_100":208,"_165":199,"_167":233,"_169":22,"_170":-5,"_171":380,"_98":381},[],[230],{"_104":237,"_95":238,"_157":239,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":240,"_100":32,"_165":199,"_167":241,"_169":22,"_170":-5,"_171":383,"_98":384},[],[238],{"_104":245,"_95":246,"_157":247,"_159":-5,"_160":138,"_161":162,"_163":189,"_106":248,"_100":32,"_165":181,"_167":249,"_169":22,"_170":-5,"_171":386,"_98":387},[],[246],{"_104":253,"_95":254,"_157":255,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":256,"_100":32,"_165":199,"_167":257,"_169":22,"_170":-5,"_171":389,"_98":390},[],[254],{"_104":261,"_95":262,"_157":263,"_159":-5,"_160":138,"_161":162,"_163":189,"_106":264,"_100":32,"_165":181,"_167":265,"_169":22,"_170":-5,"_171":392,"_98":393},[],[262],{"_104":269,"_95":270,"_157":271,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":272,"_100":32,"_165":199,"_167":273,"_169":22,"_170":-5,"_171":395,"_98":396},[],[270],{"_104":277,"_95":278,"_157":279,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":280,"_100":32,"_165":181,"_167":281,"_169":22,"_170":-5,"_171":398,"_98":399},[],[278],{"_104":285,"_95":286,"_157":287,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":288,"_100":32,"_165":199,"_167":289,"_169":22,"_170":-5,"_171":401,"_98":402},[],[286],{"_104":293,"_95":294,"_157":295,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":296,"_100":32,"_165":181,"_167":297,"_169":22,"_170":-5,"_171":404,"_98":405},[],[294],{"_104":301,"_95":302,"_157":303,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":304,"_100":32,"_165":199,"_167":305,"_169":22,"_170":-5,"_171":407,"_98":408},[],[302],{"_104":309,"_95":310,"_157":311,"_159":-5,"_160":138,"_161":162,"_163":22,"_106":312,"_100":32,"_165":199,"_167":313,"_169":22,"_170":-5,"_171":410,"_98":411},[],[310],[358,361,364,367,370,373,376,379,382,385,388,391,394,397,400,403,406,409],{"_104":204,"_95":99,"_157":205,"_159":-5,"_160":138,"_161":206,"_163":22,"_106":330,"_100":208,"_165":166,"_167":209,"_169":22,"_170":-5,"_98":414},[99],[],"upstream",{"_104":141,"_106":418,"_341":419,"_95":43,"_139":146,"_100":343,"_140":-5,"_142":-5,"_344":345,"_108":-5,"_151":22,"_110":111,"_150":336,"_16":148,"_149":96},["D",1740674076598],["D",1762172146286],"pull","ahead","behind",31,"templates",[],"actionData","errors"]