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};","deleted","label",[142],"9c5ff878-7d14-11f0-883f-0224a6c84d84","static.tsx","0198a8da-8d65-7767-84b7-6254599bc3ae",["D",1755618792467],2,"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}",[159],"9c5ff3fa-7d14-11f0-883f-0224a6c84d84","static.test.ts","0198a8da-8d65-7767-84b7-5deaf8bd4c8a",["D",1755618792467],4,"http","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);",[166],"9c5ff260-7d14-11f0-883f-0224a6c84d84","serve-file.ts","0198a8da-8d65-7767-84b7-5b617f62e3be",["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}",[174],"9c5fee78-7d14-11f0-883f-0224a6c84d84","serve-file.test.ts","0198a8da-8d65-7767-84b7-546dce548390",["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);",[180],"ecb615ee-7915-11f0-9a26-0224a6c84d84","parseImportMeta.ts","0198a8da-8d65-7767-84b7-5248c2f02655",["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}",[186],"ecb61116-7915-11f0-9a26-0224a6c84d84","parseImportMeta.test.ts","0198a8da-8d65-7767-84b7-4e27d6f105db",["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);",[192],"9c5fca38-7d14-11f0-883f-0224a6c84d84","is-main.ts","9c5fcae2-7d14-11f0-883f-0224a6c84d84",["D",1755618792467],"export function isMain(importMetaURL: string): boolean {\n return importMetaURL === Deno.env.get(\"VALTOWN_ENTRYPOINT\");\n}",[198],"9c5fc344-7d14-11f0-883f-0224a6c84d84","is-main.test.ts","9c5fc4fc-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);",[204],"9c5fec66-7d14-11f0-883f-0224a6c84d84","index.ts","0198a8da-8d65-7767-84b7-48bbf3bea3c7",["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\";",[210],"9c5fe716-7d14-11f0-883f-0224a6c84d84","file.ts","0198a8da-8d65-7767-84b7-459745e4c11d",["D",1755618792467],6,"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}",[216],"9c5fe1bc-7d14-11f0-883f-0224a6c84d84","file.test.ts","0198a8da-8d65-7767-84b7-406731d06ce5",["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);",[223],"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);",[229],"9c5fdfb4-7d14-11f0-883f-0224a6c84d84","_tests.ts","0198a8da-8d65-7767-84b7-399d9134d6ad",["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]);",[234],"9c5fd24e-7d14-11f0-883f-0224a6c84d84","README.md","0198a8da-8d64-708d-a09a-1aa5770b884f",["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",[240],"pulls","forks","envVars",{"_251":55,"_253":55},"connections",{"_251":55,"_252":55},"count","unfilledCount","emptyCount",{"_20":239,"_13":240,"_143":241,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":312,"_29":148,"_151":105,"_153":243,"_155":40,"_156":-5,"_270":313,"_93":314},{"_20":233,"_13":234,"_143":235,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":309,"_29":148,"_151":170,"_153":237,"_155":40,"_156":-5,"_270":310,"_93":311},{"_20":228,"_13":229,"_143":49,"_145":-5,"_146":21,"_147":148,"_149":51,"_22":306,"_29":55,"_151":170,"_153":231,"_155":40,"_156":-5,"_270":307,"_93":308},{"_20":222,"_13":223,"_143":224,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":303,"_29":219,"_151":170,"_153":226,"_155":40,"_156":-5,"_270":304,"_93":305},{"_20":215,"_13":216,"_143":217,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":300,"_29":219,"_151":152,"_153":220,"_155":40,"_156":-5,"_270":301,"_93":302},{"_20":209,"_13":210,"_143":211,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":297,"_29":148,"_151":152,"_153":213,"_155":40,"_156":-5,"_270":298,"_93":299},{"_20":203,"_13":204,"_143":205,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":294,"_29":55,"_151":170,"_153":207,"_155":40,"_156":-5,"_270":295,"_93":296},{"_20":197,"_13":198,"_143":199,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":291,"_29":55,"_151":152,"_153":201,"_155":40,"_156":-5,"_270":292,"_93":293},{"_20":191,"_13":192,"_143":193,"_145":-5,"_146":21,"_147":148,"_149":51,"_22":288,"_29":55,"_151":170,"_153":195,"_155":40,"_156":-5,"_270":289,"_93":290},{"_20":185,"_13":186,"_143":187,"_145":-5,"_146":21,"_147":148,"_149":51,"_22":285,"_29":55,"_151":152,"_153":189,"_155":40,"_156":-5,"_270":286,"_93":287},{"_20":179,"_13":180,"_143":181,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":282,"_29":148,"_151":170,"_153":183,"_155":40,"_156":-5,"_270":283,"_93":284},{"_20":173,"_13":174,"_143":175,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":279,"_29":148,"_151":152,"_153":177,"_155":40,"_156":-5,"_270":280,"_93":281},{"_20":165,"_13":166,"_143":167,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":276,"_29":169,"_151":170,"_153":171,"_155":40,"_156":-5,"_270":277,"_93":278},{"_20":158,"_13":159,"_143":160,"_145":-5,"_146":21,"_147":30,"_149":51,"_22":273,"_29":162,"_151":152,"_153":163,"_155":40,"_156":-5,"_270":274,"_93":275},{"_20":141,"_13":142,"_143":144,"_145":-5,"_146":21,"_147":148,"_149":51,"_22":269,"_29":55,"_151":152,"_153":154,"_155":40,"_156":-5,"_270":271,"_93":272},["D",1755179552024],"children",[],[142],["D",1755618792467],[],[159],["D",1755618792467],[],[166],["D",1755618792467],[],[174],["D",1755618792467],[],[180],["D",1755179552024],[],[186],["D",1755179552024],[],[192],["D",1755618792467],[],[198],["D",1755618792467],[],[204],["D",1755618792467],[],[210],["D",1755618792467],[],[216],["D",1755618792467],[],[223],["D",1755179552024],[],[229],["D",1755618792467],[],[234],["D",1755618792467],[],[240],["D",1755179552024],{"_11":12,"_91":87},{"_11":12,"_85":-5,"_86":87,"_46":47,"_88":89,"_90":40},{"_29":30,"_13":26,"_20":21,"_27":28,"_31":32,"_33":34,"_78":42,"_79":80,"_81":82,"_83":14,"_84":12},"ctx",{"_71":-5,"_115":352,"_353":354,"_355":356,"_357":40,"_358":40,"_359":40,"_360":51,"_361":-5,"_362":-7,"_363":-7,"_364":55,"_365":40,"_366":40,"_367":-5,"_368":40,"_369":40,"_370":40,"_371":-5},"ENV",{"_323":324,"_325":326,"_327":26,"_328":329,"_330":331,"_332":333,"_334":335,"_336":337,"_338":339,"_340":341,"_342":343,"_344":345,"_346":347,"_348":349,"_350":351},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","899124c68db8496248a17ee95f074b807335ea7b","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"]

Branches1

Branches
1