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\n/**\n * Creates a test runner that displays test results as an HTML page with badges and detailed output.\n *\n * @param testGroups - Array of test groups, where each group contains a name, array of test cases, and optional before/after hooks\n * @returns A fetch-compatible handler function that runs all tests and returns an HTML response\n *\n * @example\n * ```ts\n * import { testServer } from \"https://esm.town/v/stevekrouse/utils/index.ts\";\n *\n * const myTests = [{\n * name: \"Math tests\",\n * tests: [\n * { name: \"addition\", function: () => { if (1 + 1 !== 2) throw new Error(\"Math is broken\"); } },\n * { name: \"subtraction\", function: () => { if (5 - 3 !== 2) throw new Error(\"Wrong result\"); } }\n * ]\n * }];\n *\n * export default testServer(myTests);\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",[157],"26fc9506-b774-11f0-90ae-0224a6c84d84","static.tsx","019a4135-63aa-70ea-9ae3-4cc857caadb8",["D",1762036994647],3,"import { Hono } from \"npm:hono\";\nimport { HTTPException } from \"npm:hono/http-exception\";\nimport { serveFile } from \"./serve-file.ts\";\n\n/**\n * Creates a Hono-based HTTP server that serves static files from your val.\n * \n * The server automatically serves `/index.html` for root requests and handles all other file paths.\n *\n * @param importMetaURL - Optional. The import.meta.url to determine which val to serve files from. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n * @returns A fetch-compatible handler function that serves static files\n *\n * @example\n * ```ts\n * import { staticHTTPServer } from \"https://esm.town/v/stevekrouse/utils/index.ts\";\n *\n * // Most common usage - serves files from current val\n * export default staticHTTPServer();\n *\n * // Explicit val specification\n * export default staticHTTPServer(import.meta.url);\n * ```\n */\nexport function staticHTTPServer(\n importMetaURL: string = Deno.env.get(\"VALTOWN_ENTRYPOINT\") || \"\",\n): (request: Request, env?: any, executionCtx?: any) => Response | Promise {\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}\n",[169],"9c9481cc-b777-11f0-9657-0224a6c84d84","static.test.ts","019a4135-63aa-70ea-9ae3-489c611ce8ba",161,["D",1762038480431],5,"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: \" 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 \"File not found\" error\n expect(error.message).toContain(\"File not found\");\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 \"File not found\" error\n expect(error.message).toContain(\"File not found\");\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);",[176],"26fc9740-b774-11f0-90ae-0224a6c84d84","serve-file.ts","019a4135-63aa-70ea-9ae3-45d434f8df22",["D",1762036994647],4,"import { contentType } from \"npm:mime-types@2.1.35\";\nimport { readFileTranspiled } from \"./file.ts\";\n\n/**\n * Serves a file from the val as an HTTP Response with the correct Content-Type header.\n *\n * @param path - The file path to serve\n * @param metaImportUrl - Optional. The import.meta.url to determine which val to serve from. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n * @returns Promise that resolves to an HTTP Response with the file content and appropriate Content-Type header\n *\n * @example\n * ```ts\n * import { serveFile } from \"https://esm.town/v/stevekrouse/utils/index.ts\";\n *\n * // In a Hono app - most common usage\n * app.get(\"/assets/*\", async (c) => {\n * return await serveFile(c.req.path);\n * });\n *\n * // Explicit val specification\n * app.get(\"/assets/*\", async (c) => {\n * return await serveFile(c.req.path, import.meta.url);\n * });\n * ```\n */\nexport async function serveFile(\n path: string,\n metaImportUrl: string = Deno.env.get(\"VALTOWN_ENTRYPOINT\") || \"\",\n): Promise {\n const text = await readFileTranspiled(path, metaImportUrl);\n const content_type = getContentType(path);\n return new Response(text, {\n headers: {\n \"Content-Type\": content_type,\n },\n });\n}\n\n/**\n * Determines the appropriate MIME type for a file based on its extension.\n *\n * @param path - The file path to get the content type for\n * @returns The MIME type string (e.g., \"text/html\", \"application/json\")\n *\n * @example\n * ```ts\n * import { getContentType } from \"https://esm.town/v/stevekrouse/utils/index.ts\";\n *\n * console.log(getContentType(\"index.html\")); // \"text/html; charset=utf-8\"\n * console.log(getContentType(\"script.ts\")); // \"text/javascript\"\n * console.log(getContentType(\"data.json\")); // \"application/json; charset=utf-8\"\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}\n",[185],"49097d4e-b765-11f0-9715-0224a6c84d84","serve-file.test.ts","019a4135-63aa-70ea-9ae3-42fd6f42294c",1,["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);",[192],"26fc9b28-b774-11f0-90ae-0224a6c84d84","parseImportMeta.ts","019a4135-63aa-70ea-9ae3-3faf59a4e7b0",["D",1762036994647],"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\n/**\n * Parses Val Town metadata from an import.meta.url.\n *\n * @param url - Optional. The import.meta.url to parse. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n * @returns An object containing username, name, version, branch, path, and links to the val\n *\n * @example\n * ```ts\n * import { parseVal } from \"https://esm.town/v/stevekrouse/utils/index.ts\";\n *\n * const val = parseVal(import.meta.url);\n * console.log(val);\n * // Output: { username: \"username\", name: \"valname\", version: \"1\", branch: \"main\", path: \"\", links: {...} }\n * ```\n */\nexport function parseVal(url: string = 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}\n",[199],"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);",[205],"26fc9dee-b774-11f0-90ae-0224a6c84d84","is-main.ts","019a4135-63aa-70ea-9ae3-3698f5acee37",["D",1762036994647],"/**\n * Checks if the current file is the main entry point of the val.\n * \n * This is a replacement for `import.meta.main` which is not available in Val Town's environment.\n *\n * @param importMetaURL - The `import.meta.url` of the current file\n * @returns `true` if the file is the main entry point, `false` otherwise\n *\n * @example\n * ```ts\n * import { isMain } from \"https://esm.town/v/stevekrouse/utils/index.ts\";\n *\n * if (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 */\nexport function isMain(importMetaURL: string): boolean {\n return importMetaURL === Deno.env.get(\"VALTOWN_ENTRYPOINT\");\n}",[211],"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);",[217],"077bba9e-b770-11f0-8f90-0224a6c84d84","index.ts","019a4135-63aa-70ea-9ae3-2d34e9ecfe49",90,["D",1762035223807],"export {\n emailAddress,\n fetchTranspiledJavaScript,\n getValId,\n httpEndpoint,\n listFiles,\n listFilesByPath,\n readFile,\n readFileTranspiled,\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\";\n",[223],"58383410-b777-11f0-a115-0224a6c84d84","file.ts","019a4135-63aa-70ea-9ae3-29ed06d12226",156,["D",1762038365737],23,"import ValTown from \"npm:@valtown/sdk@1.9.0\";\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 raw, untranspiled contents of a file from the current val.\n *\n * Returns the original TypeScript/JavaScript source code with all type annotations intact.\n * Use `readFileTranspiled` if you need transpiled JavaScript for execution.\n *\n * Note: Val Town doesn't provide direct file system access. This function uses the Val Town API\n * to read your val files, enabling a more scalable serverless runtime.\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 raw file contents as a string, or undefined if the file doesn't exist\n *\n * @example\n * ```ts\n * import { readFile } from \"https://esm.town/v/std/utils/index.ts\";\n *\n * // Most common usage - reads raw TypeScript from current val\n * const content = await readFile(\"/utils/helper.ts\");\n * console.log(content); // Contains TypeScript with type annotations\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: string = Deno.env.get(\"VALTOWN_ENTRYPOINT\") || \"\",\n): Promise {\n const val = parseVal(metaImportUrl);\n const pathFragment = path.startsWith(\"/\") ? path.slice(1) : path;\n const esmURL = val.links.module.valPinned + pathFragment;\n let text: string;\n try {\n text = await fetchFile(esmURL, false);\n } catch (err: any) {\n if (err.message === \"File not found\") {\n throw err;\n }\n throw new Error(\"Failed to fetch file \" + esmURL);\n }\n return text;\n}\n\n/**\n * Reads the transpiled JavaScript contents of a file from the current val.\n *\n * Returns the transpiled JavaScript code ready for execution. Type annotations are stripped.\n * Use `readFile` if you need the original TypeScript source with type annotations.\n *\n * Note: Val Town doesn't provide direct file system access. This function uses esm.town\n * to fetch transpiled code.\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 transpiled JavaScript code as a string\n *\n * @example\n * ```ts\n * import { readFileTranspiled } from \"https://esm.town/v/std/utils/index.ts\";\n *\n * // Read transpiled JavaScript for serving or execution\n * const jsCode = await readFileTranspiled(\"/app.ts\");\n * console.log(jsCode); // Contains JavaScript without type annotations\n * ```\n */\nexport async function readFileTranspiled(\n path: string,\n metaImportUrl: string = Deno.env.get(\"VALTOWN_ENTRYPOINT\") || \"\",\n): Promise {\n const val = parseVal(metaImportUrl);\n const pathFragment = path.startsWith(\"/\") ? path.slice(1) : path;\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.message === \"File not found\") {\n throw err;\n }\n throw new Error(\"Failed to fetch file \" + esmURL);\n }\n return text;\n}\n\n/**\n * Gets the HTTP endpoint URL for the currently running val or a specific file in the val.\n *\n * @param path - Optional. The file path to get the endpoint for. Defaults to the currently running endpoint.\n * @param metaImportUrl - Optional. The import.meta.url to determine which val the file belongs to. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n * @returns Promise that resolves to the full HTTP URL for the endpoint\n *\n * @example\n * ```ts\n * import { httpEndpoint } from \"https://esm.town/v/std/utils/index.ts\";\n *\n * const endpoint = await httpEndpoint();\n * console.log(endpoint); // Returns the full HTTP URL for the endpoint\n * ```\n */\nexport async function httpEndpoint(\n path: string = \"\",\n metaImportUrl: string = Deno.env.get(\"VALTOWN_ENTRYPOINT\") || \"\",\n): Promise {\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\n/**\n * Gets the email address for a file with an email trigger in the val.\n *\n * Note: This function does not work for vanity email addresses. It only works for the UUID version.\n *\n * @param path - The file path to get the email address for\n * @param metaImportUrl - Optional. The import.meta.url to determine which val the file belongs to. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n * @returns Promise that resolves to the email address in format: `{username}-{fileIdWithoutDashes}@valtown.email`\n *\n * @example\n * ```ts\n * import { emailAddress } from \"https://esm.town/v/std/utils/index.ts\";\n *\n * // Get the email address for a file with email trigger\n * const email = await emailAddress(\"/handlers/processEmail.ts\");\n * console.log(email); // Returns: username-fileid@valtown.email\n * ```\n */\nexport async function emailAddress(\n path: string,\n metaImportUrl: string = Deno.env.get(\"VALTOWN_ENTRYPOINT\") || \"\",\n): Promise {\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 * Note: Val Town doesn't provide direct file system access. This function uses the Val Town API\n * to list your val files, enabling a more scalable serverless runtime.\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: string = Deno.env.get(\"VALTOWN_ENTRYPOINT\") || \"\",\n): Promise {\n return listFilesByPath(\"\", metaImportUrl);\n}\n\n/**\n * Gets the ID of a val.\n *\n * @param metaImportUrl - Optional. The import.meta.url to determine which val to get the ID for. Defaults to `Deno.env.get(\"VALTOWN_ENTRYPOINT\")`\n * @returns Promise that resolves to the val ID as a string\n *\n * @example\n * ```ts\n * import { getValId } from \"https://esm.town/v/std/utils/index.ts\";\n *\n * // Get the val id for the val this code is in\n * const id = await getValId();\n * console.log(id); // Returns: \"bb8f592e-f528-11ef-b06d-569c3dd06744\"\n * ```\n */\nexport async function getValId(\n metaImportUrl: string = Deno.env.get(\"VALTOWN_ENTRYPOINT\") || \"\",\n): Promise {\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: string = Deno.env.get(\"VALTOWN_ENTRYPOINT\") || \"\",\n): Promise {\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\n/**\n * Fetches and transpiles TypeScript/JavaScript code from esm.town URLs.\n *\n * @param url - The esm.town URL to fetch (e.g., \"https://esm.town/v/username/valname@version-branch/file.ts\")\n * @returns Promise that resolves to the transpiled JavaScript code as a string\n *\n * @example\n * ```ts\n * import { fetchTranspiledJavaScript } from \"https://esm.town/v/stevekrouse/utils/index.ts\";\n *\n * const code = await fetchTranspiledJavaScript(\n * \"https://esm.town/v/std/utils@85-main/index.ts\"\n * );\n * console.log(code);\n * ```\n */\nexport async function fetchTranspiledJavaScript(url: string): Promise {\n return await fetchFile(url, true);\n}\n\nasync function fetchFile(url: string, isTranspiled: boolean): Promise {\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\": isTranspiled ? \"\" : \"Deno\",\n \"Authorization\": \"Bearer \" + Deno.env.get(\"valtown\"),\n },\n });\n if (res.status === 404) {\n throw new Error(\"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],"3fa85e16-b777-11f0-ae22-0224a6c84d84","file.test.ts","019a4135-63aa-70ea-9ae3-262b1793810e",154,["D",1762038324532],"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 readFileTranspiled,\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: \"return undefined for non-existent file\",\n function: async () => {\n await expect(\n readFile(\"/non-existent-file.txt\", import.meta.url),\n )\n .rejects.toThrow();\n },\n },\n ],\n },\n {\n name: \"readFileTranspiled Tests\",\n sourceFile: \"file.ts\",\n tests: [\n {\n name: \"read transpiled JavaScript 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 transpiled JavaScript\n const content = await readFileTranspiled(\n \"/index.ts\",\n import.meta.url,\n );\n expect(typeof content).toBe(\"string\");\n expect(content.length).toBeGreaterThan(0);\n // Transpiled code should be JavaScript (not contain TypeScript type annotations in executable parts)\n expect(content).toContain(\"export\");\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 readFileTranspiled(\n \"/index.ts\",\n import.meta.url,\n );\n const contentWithoutSlash = await readFileTranspiled(\n \"index.ts\",\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 const hasToken = !!Deno.env.get(\"valtown\");\n if (!hasToken) {\n return; // Skip if no token\n }\n\n await expect(\n readFileTranspiled(\"/non-existent-file.txt\", import.meta.url),\n )\n .rejects.toThrow();\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 with default parameter\n const content = await readFileTranspiled(\"/index.ts\");\n expect(typeof content).toBe(\"string\");\n expect(content.length).toBeGreaterThan(0);\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);",[238],"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);",[245],"d13b7a7a-b777-11f0-a87f-0224a6c84d84","docs-todos.md","3ea09f26-b766-11f0-b0e0-0224a6c84d84",163,["D",1762038568763],43,"# Build Documentation Generator\n\nDo one task at a time. Start the task. Confirm it works in the browser. Mark it\ndone. Do the tasks in order.\n\n- [ ] Bug: when you click on a function in a narrow width screen, the sidebar\n overlays the content.\n- [ ] Bug: why is testServer not properly shown in the left sidebar and is\n listed as (anonymous) in the docs?\n- [ ] The parameters need to be named in the parameter section.\n- [ ] In the parameters section, any code (ie `backticks`) should be\n syntax-highlighted as \\ blocks.\n- [ ] Bug: Figure out how to get `text-sm` to affect \\ blocks with syntax\n highlighting. Right\n- [ ] The syntax highlighting looks a little weird with background color of\n white on certain elements.\n- [ ] Add a copy button on the example\n- [ ] Add precise type information for all inputs and outputs. Users should know\n exactly every field of every input and every output type. This should be\n easy given the typescript info we have on all inputs and ouputs. If any\n are underspecified, let me know.\n- [ ] Try my best to not break anyone, ensure tests all pass and behavior is the\n same as before.\n- [ ] Merge upstream\n\n---\n\n# Experimental unification of tests & examples into JSDoc strings\n\n- [ ] Let's redo all the tests as jsdoc string examples as inspired by Deno\n here:\n https://docs.deno.com/runtime/fundamentals/testing/#example-code-blocks\n - [ ] Create a syntax for example input and example output that we can parse\n as tests and also as examples for the docs\n - [ ] Audit all of our existing tests to see which of them can be easily\n migrated over and which need more work.\n - [ ] In _docs.tsx, parse and run all the tests\n - [ ] At the top of the the docs page, render a summary badge of all the test\n results\n - [ ] In each function, render a summary badge of its test results, if error,\n let me click to expand to see the error\n - [ ] In each function, list each of its 'tests' as an example usage, show the\n input and output\n - [ ] Only show the first 2 usages for each function, but have a show more\n button to see them all.\n - [ ] For each of the examples, link to the source for it in the codebase\n - [ ] For each example, show the test result status for it and any potential\n - [ ] Inject import line for that function in each example for easier copying\n something that holistically works error message\n - [ ] For all test result badges, experiment with showing the timestamp the\n test was run at to convey how live this system is (ie runs on every page\n load)\n - [ ] Delete the old test.tsx file. Delete all the old .test.ts files\n - [ ] Remove the test function from the docs",[251],"49096142-b765-11f0-9715-0224a6c84d84","_tests.ts","019a4135-63aa-70ea-9ae3-1ae6d69a22ea",["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]);",[259],"b752e4b0-b775-11f0-bd89-0224a6c84d84","_docs.tsx",145,["D",1762037666305],54,"/** @jsxImportSource https://esm.sh/hono/jsx */\nimport { Hono } from \"npm:hono\";\nimport { readFile } from \"./file.ts\";\nimport ts from \"npm:typescript\";\n\nconst app = new Hono();\n\n// Helper functions for TypeScript doc extraction\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 &&\n anyNode.modifiers.some((m: ts.Modifier) =>\n m.kind === ts.SyntaxKind.DefaultKeyword\n );\n return (anyNode.name && anyNode.name.escapedText) ||\n (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\n ? docNodes.map((d: any) => d.comment).filter(Boolean)\n : [];\n const description = descParts.length ? descParts.join(\"\\n\") : \"\";\n const byTag: Record = {};\n for (const t of tags) {\n const name = String(\n (t as any).tagName && (t as any).tagName.escapedText || \"\",\n );\n const text = (t as any).comment || ((t as any).text && (t as any).text.map\n ? (t as any).text.map((x: any) =>\n x.text\n ).join(\"\")\n : \"\") ||\n \"\";\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) ||\n 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 = {\n target: ts.ScriptTarget.ES2022,\n module: ts.ModuleKind.ESNext,\n };\n const host: ts.CompilerHost = {\n getSourceFile: (fn, lv) =>\n ts.createSourceFile(\n fn,\n fn === fileName ? sourceText : \"\",\n lv,\n true,\n ts.ScriptKind.TS,\n ),\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(\n node.getStart(sf),\n );\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\n// JSX Components\nfunction Sidebar({ categories, documentedFunctions }: any) {\n return (\n

Val Town Utils

\n {Object.entries(categories).map(([category, funcs]: [string, any]) => {\n const items = (funcs as string[]).filter((name) =>\n documentedFunctions.some((d: any) => d.name === name)\n );\n if (items.length === 0) return null;\n\n return (\n

\n {category}\n

\n \n {name}\n \n

\n );\n })}\n

\n );\n}\n\nfunction FunctionDoc({ doc }: any) {\n const sourceUrl =\n `https://www.val.town/x/stevekrouse/utils/code/${doc.filePath}#L${doc.start}-${doc.end}`;\n\n return (\n

\n \n {doc.name}\n \n

\n \n view source\n \n

\n\n {doc.signature && (\n

\n          {doc.signature}\n

\n )}\n\n

{doc.description}

\n\n {doc.tags.param && doc.tags.param.length > 0 && (\n

\n Parameters\n

\n )}\n\n {(doc.tags.returns || doc.tags.return) &&\n (doc.tags.returns || doc.tags.return).length > 0 && (\n

Returns

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

\n )}\n\n {doc.tags.example && doc.tags.example.length > 0 && (\n

Example

\n            {doc.tags.example.join('\\n\\n').replace(\"```ts\\n\", \"\").replace(\"```\", \"\")}\n

\n )}\n

\n );\n}\n\napp.get(\"/\", async (c) => {\n // Extract docs from all utility files\n const files = [\n \"file.ts\",\n \"serve-file.ts\",\n \"parseImportMeta.ts\",\n \"is-main.ts\",\n \"test.tsx\",\n \"static.tsx\",\n ];\n const allDocs = await Promise.all(files.map((file) => extractDocs(file)));\n const docs = allDocs.flat();\n\n // Filter to only documented functions\n const documentedFunctions = docs.filter((d) => d.description);\n\n // Group functions by category\n const categories = {\n \"File Operations\": [\n \"readFile\",\n \"listFiles\",\n \"listFilesByPath\",\n \"httpEndpoint\",\n \"emailAddress\",\n \"getValId\",\n \"fetchTranspiledJavaScript\",\n ],\n \"HTTP Utilities\": [\"serveFile\", \"getContentType\", \"staticHTTPServer\"],\n \"Val Metadata\": [\"parseVal\", \"isMain\"],\n \"Testing\": [\"testServer\"],\n };\n\n return c.render(\n \n \n \n Val Town Utils Documentation\n \n \n \n \n \n \n \n

\n \n

\n Val Town Utils Documentation\n

\n \n View val on Val Town\n \n

\n @std/utils is a collection of utilities Val Town, including\n reading files, serving static content, getting Val Town metadata,\n and more.\n

\n\n

\n\n {documentedFunctions.map((doc) => (\n \n ))}\n

\n \n ,\n );\n});\n\napp.onError((err) => Promise.reject(err));\n\nexport default app.fetch;",[265],"pulls","branches","forks","envVars",{"_278":60,"_280":60},"connections",{"_278":60,"_279":60},"count","unfilledCount","emptyCount",{"_41":264,"_32":265,"_30":55,"_159":-5,"_39":40,"_38":266,"_161":47,"_36":343,"_13":268,"_33":181,"_34":269,"_24":47,"_166":-5,"_298":344,"_27":345},{"_41":258,"_32":259,"_30":260,"_159":-5,"_39":40,"_38":194,"_161":25,"_36":340,"_13":60,"_33":181,"_34":262,"_24":47,"_166":-5,"_298":341,"_27":342},{"_41":250,"_32":251,"_30":252,"_159":-5,"_39":40,"_38":253,"_161":47,"_36":337,"_13":255,"_33":20,"_34":256,"_24":47,"_166":-5,"_298":338,"_27":339},{"_41":244,"_32":245,"_30":246,"_159":-5,"_39":40,"_38":194,"_161":25,"_36":334,"_13":60,"_33":181,"_34":248,"_24":47,"_166":-5,"_298":335,"_27":336},{"_41":237,"_32":238,"_30":239,"_159":-5,"_39":40,"_38":240,"_161":47,"_36":331,"_13":188,"_33":181,"_34":242,"_24":47,"_166":-5,"_298":332,"_27":333},{"_41":229,"_32":230,"_30":231,"_159":-5,"_39":40,"_38":232,"_161":47,"_36":328,"_13":234,"_33":164,"_34":235,"_24":47,"_166":-5,"_298":329,"_27":330},{"_41":222,"_32":223,"_30":224,"_159":-5,"_39":40,"_38":225,"_161":47,"_36":325,"_13":194,"_33":164,"_34":227,"_24":47,"_166":-5,"_298":326,"_27":327},{"_41":216,"_32":217,"_30":218,"_159":-5,"_39":40,"_38":194,"_161":25,"_36":322,"_13":60,"_33":181,"_34":220,"_24":47,"_166":-5,"_298":323,"_27":324},{"_41":210,"_32":211,"_30":212,"_159":-5,"_39":40,"_38":160,"_161":47,"_36":319,"_13":163,"_33":164,"_34":214,"_24":47,"_166":-5,"_298":320,"_27":321},{"_41":204,"_32":205,"_30":206,"_159":-5,"_39":40,"_38":194,"_161":25,"_36":316,"_13":60,"_33":181,"_34":208,"_24":47,"_166":-5,"_298":317,"_27":318},{"_41":198,"_32":199,"_30":200,"_159":-5,"_39":40,"_38":160,"_161":47,"_36":313,"_13":172,"_33":164,"_34":202,"_24":47,"_166":-5,"_298":314,"_27":315},{"_41":191,"_32":192,"_30":193,"_159":-5,"_39":40,"_38":194,"_161":47,"_36":310,"_13":60,"_33":181,"_34":196,"_24":47,"_166":-5,"_298":311,"_27":312},{"_41":184,"_32":185,"_30":186,"_159":-5,"_39":40,"_38":160,"_161":47,"_36":307,"_13":188,"_33":164,"_34":189,"_24":47,"_166":-5,"_298":308,"_27":309},{"_41":175,"_32":176,"_30":177,"_159":-5,"_39":40,"_38":178,"_161":47,"_36":304,"_13":180,"_33":181,"_34":182,"_24":47,"_166":-5,"_298":305,"_27":306},{"_41":168,"_32":169,"_30":170,"_159":-5,"_39":40,"_38":160,"_161":47,"_36":301,"_13":172,"_33":164,"_34":173,"_24":47,"_166":-5,"_298":302,"_27":303},{"_41":156,"_32":157,"_30":158,"_159":-5,"_39":40,"_38":160,"_161":47,"_36":297,"_13":163,"_33":164,"_34":165,"_24":47,"_166":-5,"_298":299,"_27":300},["D",1762036994647],"children",[],[157],["D",1762036994647],[],[169],["D",1762038480431],[],[176],["D",1762036994647],[],[185],["D",1762030609227],[],[192],["D",1762036994647],[],[199],["D",1762030609227],[],[205],["D",1762036994647],[],[211],["D",1762030609227],[],[217],["D",1762035223807],[],[223],["D",1762038365737],[],[230],["D",1762038324532],[],[238],["D",1762030609227],[],[245],["D",1762038568763],[],[251],["D",1762030609227],[],[259],["D",1762037666305],[],[265],["D",1762030609227],{"_98":97,"_105":101},{"_98":97,"_99":-5,"_100":101,"_18":53,"_102":103,"_104":47},{"_13":83,"_32":84,"_41":40,"_85":42,"_86":87,"_88":89,"_90":49,"_91":92,"_93":94,"_95":43,"_96":97},"ctx",{"_76":-5,"_127":383,"_384":385,"_386":387,"_388":47,"_389":47,"_390":47,"_391":25,"_392":-5,"_393":-7,"_394":-7,"_395":60,"_396":47,"_397":47,"_398":-5,"_399":47,"_400":47,"_401":47,"_402":-5},"ENV",{"_354":355,"_356":357,"_358":84,"_359":360,"_361":362,"_363":364,"_365":366,"_367":368,"_369":370,"_371":372,"_373":374,"_375":376,"_377":378,"_379":380,"_381":382},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","71c1b20804b3232a7e513be260cfffc1932a9e97","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"]

Diff · v164