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};","label",[89],"9c5ff878-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"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}",[214],"9c5ff3fa-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"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: \"should 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);",[102],"9c5ff260-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"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}",[109],"9c5fee78-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"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: \"should 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(\"Failed to fetch file\");\n },\n },\n {\n name: \"should 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);",[115],"ecb615ee-7915-11f0-9a26-0224a6c84d84",["D",1755179552024],"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: string): 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}",[121],"ecb61116-7915-11f0-9a26-0224a6c84d84",["D",1755179552024],"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);",[127],"9c5fca38-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"export function isMain(importMetaURL: string): boolean {\n return importMetaURL === Deno.env.get(\"VALTOWN_ENTRYPOINT\");\n}",[307],"9c5fc344-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"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: \"should 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: \"should 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);",[262],"9c5fec66-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"export {\n fetchTranspiledJavaScript,\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\";",[132],"9c5fe716-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"import ValTown from \"npm:@valtown/sdk@1.9.0\";\nimport { HTTPException } from \"npm:hono/http-exception\";\nimport { parseVal } from \"./parseImportMeta.ts\";\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: 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.links?.endpoint) {\n throw new Error(`No HTTP endpoint available for file: ${path}`);\n }\n\n return file.links.endpoint;\n}\n\nexport function listFiles(\n metaImportUrl = Deno.env.get(\"VALTOWN_ENTRYPOINT\"),\n) {\n return listFilesByPath(\"\", metaImportUrl);\n}\n\nexport async function listFilesByPath(\n path: string,\n metaImportUrl = Deno.env.get(\"VALTOWN_ENTRYPOINT\"),\n) {\n const vt = new ValTown();\n\n const val = parseVal(metaImportUrl);\n const { id } = await vt.alias.username.valName.retrieve(\n val.username,\n val.name,\n );\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(id, {}));\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(id, 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}",[141],"9c5fe1bc-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"import { expect } from \"jsr:@std/expect\";\nimport { testServer } from \"./test.tsx\";\nimport { \n fetchTranspiledJavaScript, \n listFiles, \n readFile, \n listFilesByPath, \n httpEndpoint \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 const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\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 const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\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: \"should 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 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: \"should list files in val\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\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: \"should list files in specific directory\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\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: \"should work with default metaImportUrl\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\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: \"should get HTTP endpoint for file\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\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: \"should work with default metaImportUrl\",\n function: async () => {\n const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\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 },\n {\n name: \"readFile with default parameter Tests\",\n sourceFile: \"file.ts\", \n tests: [\n {\n name: \"should work without 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 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: \"should work without 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 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);",[150],"ecb60702-7915-11f0-9a26-0224a6c84d84","example.test.ts",["D",1755179552024],"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);",[458],"9c5fdfb4-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"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]);",[299],"9c5fd24e-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"# Val Town Utilities\n\nA comprehensive collection of utilities for building and testing applications in\nVal Town Projects.\n\n

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
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 specific file in the val.\n\n**Signature:**\n\n```ts\nhttpEndpoint(path: string, metaImportUrl?: string): Promise\n```\n\n**Parameters:**\n\n- `path` - The file path to get the endpoint 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 { httpEndpoint } from \"https://esm.town/v/std/utils/index.ts\";\n\n// Get the HTTP endpoint for a specific file\nconst endpoint = await httpEndpoint(\"/api/users.ts\");\nconsole.log(endpoint); // Returns the full HTTP URL for the endpoint\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 replacement for `import.meta.main` which is not available in Val Town's environment.\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 `VALTOWN_ENTRYPOINT` environment variable\n- In Val Town, the entry point is determined by which file is being executed directly (e.g., via HTTP trigger, cron, or manual execution)\n- This is equivalent to Python's `if __name__ == \"__main__\":` pattern or Node.js's `require.main === module`\n- Unlike Deno's `import.meta.main`, this works reliably in Val Town's serverless environment",[305],"pulls","branches","forks","envVars",{"_128":20,"_478":20},"connections",{"_128":20,"_477":20},"unfilledCount","emptyCount",{"_42":466,"_13":305,"_87":304,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":537,"_48":49,"_90":63,"_409":468,"_92":93,"_411":-5,"_495":538,"_357":539},{"_42":462,"_13":299,"_87":298,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":534,"_48":49,"_90":103,"_409":464,"_92":93,"_411":-5,"_495":535,"_357":536},{"_42":457,"_13":458,"_87":317,"_52":-5,"_44":45,"_406":49,"_407":24,"_46":531,"_48":20,"_90":103,"_409":460,"_92":93,"_411":-5,"_495":532,"_357":533},{"_42":453,"_13":150,"_87":149,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":528,"_48":167,"_90":103,"_409":455,"_92":93,"_411":-5,"_495":529,"_357":530},{"_42":449,"_13":141,"_87":140,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":525,"_48":167,"_90":91,"_409":451,"_92":93,"_411":-5,"_495":526,"_357":527},{"_42":445,"_13":132,"_87":131,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":522,"_48":49,"_90":91,"_409":447,"_92":93,"_411":-5,"_495":523,"_357":524},{"_42":441,"_13":262,"_87":261,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":519,"_48":20,"_90":103,"_409":443,"_92":93,"_411":-5,"_495":520,"_357":521},{"_42":437,"_13":307,"_87":306,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":516,"_48":20,"_90":91,"_409":439,"_92":93,"_411":-5,"_495":517,"_357":518},{"_42":433,"_13":127,"_87":126,"_52":-5,"_44":45,"_406":49,"_407":24,"_46":513,"_48":20,"_90":103,"_409":435,"_92":93,"_411":-5,"_495":514,"_357":515},{"_42":429,"_13":121,"_87":120,"_52":-5,"_44":45,"_406":49,"_407":24,"_46":510,"_48":20,"_90":91,"_409":431,"_92":93,"_411":-5,"_495":511,"_357":512},{"_42":425,"_13":115,"_87":114,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":507,"_48":49,"_90":103,"_409":427,"_92":93,"_411":-5,"_495":508,"_357":509},{"_42":421,"_13":109,"_87":108,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":504,"_48":49,"_90":91,"_409":423,"_92":93,"_411":-5,"_495":505,"_357":506},{"_42":417,"_13":102,"_87":101,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":501,"_48":153,"_90":103,"_409":419,"_92":93,"_411":-5,"_495":502,"_357":503},{"_42":413,"_13":214,"_87":213,"_52":-5,"_44":45,"_406":238,"_407":24,"_46":498,"_48":135,"_90":91,"_409":415,"_92":93,"_411":-5,"_495":499,"_357":500},{"_42":405,"_13":89,"_87":88,"_52":-5,"_44":45,"_406":49,"_407":24,"_46":494,"_48":20,"_90":91,"_409":410,"_92":93,"_411":-5,"_495":496,"_357":497},["D",1755179552024],"children",[],[89],["D",1755618792467],[],[214],["D",1755618792467],[],[102],["D",1755618792467],[],[109],["D",1755618792467],[],[115],["D",1755179552024],[],[121],["D",1755179552024],[],[127],["D",1755618792467],[],[307],["D",1755618792467],[],[262],["D",1755618792467],[],[132],["D",1755618792467],[],[141],["D",1755618792467],[],[150],["D",1755179552024],[],[458],["D",1755618792467],[],[299],["D",1755618792467],[],[305],["D",1755179552024],{"_11":12,"_356":96},{"_11":12,"_352":-5,"_95":96,"_25":94,"_353":354,"_355":93},{"_48":238,"_13":16,"_42":45,"_341":308,"_342":84,"_343":344,"_345":312,"_346":347,"_348":349,"_350":14,"_351":12},"ctx",{"_61":-5,"_378":577,"_578":579,"_580":581,"_582":93,"_583":93,"_584":93,"_585":24,"_586":-5,"_587":-7,"_588":-7,"_589":20,"_590":93,"_591":93,"_592":-5,"_593":93,"_594":93,"_595":93,"_596":-5},"ENV",{"_548":549,"_550":551,"_552":16,"_553":554,"_555":556,"_557":558,"_559":560,"_561":562,"_563":564,"_565":566,"_567":568,"_569":570,"_571":572,"_573":574,"_575":576},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","a3e067d4463eea85f6334f8e583e8516ae58c4f6","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"]

History