Hi

\"\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n#### **parseProject** - Extract information about the current project from import.meta.url\n\nThis is useful for including info for linking back to a val, ie in \"view source\" urls:\n\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\nHowever, it's *extremely importing* to note that `parseProject` and other Standard Library utilities ONLY RUN ON THE SERVER.\nIf you need access to this data on the client, run it in the server and pass it to the client by splicing it into the HTML page\nor by making an API request for it.\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use: `

`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise specified\n- **View Source:** Add a view source link by importing & using `import.meta.url.replace(\"ems.sh\", \"val.town)\"` (or passing this data to the client) and include `target=\"_top\"` attribute\n- **Error Debugging:** Add `` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; Avoid catches that merely log or return 500s. Let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and start the file with `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n \n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n \n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n \n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n \n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:** \n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n\n",[],[231],{"_104":239,"_95":240,"_153":241,"_155":-5,"_156":138,"_157":242,"_159":160,"_106":243,"_100":32,"_163":225,"_165":244,"_166":22,"_167":-5,"_168":245,"_98":246},"d80529ee-5ab3-11f0-82b0-f69ea79377d9","CACHING_SETUP.md","d8052a98-5ab3-11f0-82b0-f69ea79377d9",264,["D",1751838891827],"# Val Town HTTP Endpoints Caching System\n\n## Overview\n\nThis document describes the implementation of a caching system for Val Town HTTP endpoints using Blob Storage and automated cron jobs. The system provides fast access to endpoint data through a beautiful web interface while maintaining data freshness through scheduled updates.\n\n## Architecture\n\n### Data Flow\n```\nVal Town API → vals-all-files.tsx → cache-manager.ts → Blob Storage\n ↓\nWeb Interface ← index.tsx ← cache-manager.ts ← Blob Storage\n```\n\n### Storage Strategy\n- **Primary Storage**: Val Town Blob Storage (key-value pairs)\n- **Cache Keys**: \n - `vals_with_files_cache` - Main endpoint data\n - `vals_with_files_cache_metadata` - Update timestamps and performance metrics\n- **Data Format**: JSON with structured metadata\n\n## Components\n\n### Core Files\n\n#### `cache-manager.ts`\n**Purpose**: Blob storage interface and cache management\n**Key Functions**:\n- `setCachedVals(data, updateDurationMs)` - Store data with metadata\n- `getCachedVals()` - Retrieve cached endpoint data\n- `getCacheMetadata()` - Get update timestamps and metrics\n- `getCachedValsWithMetadata()` - Get both data and metadata together\n- `isCacheFresh(maxAgeHours)` - Check cache freshness (default: 24 hours)\n\n**Metadata Structure**:\n```typescript\ninterface CacheMetadata {\n lastUpdated: string; // ISO timestamp\n totalVals: number; // Count of vals processed\n updateDurationMs: number; // Time taken to fetch and process data\n}\n```\n\n#### `cache-updater.ts` (Cron Job)\n**Purpose**: Automated cache refresh\n**Trigger**: Cron schedule (set in Val Town UI)\n**Process**:\n1. Fetch fresh data from `fetchValsWithFiles()`\n2. Calculate update duration\n3. Store in cache with metadata\n4. Log success/failure\n\n**Recommended Schedule**: `0 * * * *` (hourly)\n\n#### `index.tsx`\n**Purpose**: Web interface and API endpoints\n**Routes**:\n- `/` - Main HTML interface\n- `/api/cached` - JSON cached data\n- `/api/live` - JSON live data (bypasses cache)\n- `/api/refresh` - Manual cache refresh\n- `/api/cache-info` - Cache metadata and status\n\n### Supporting Files\n\n#### `vals-all-files.tsx`\n**Purpose**: Data fetching logic\n**Function**: `fetchValsWithFiles()` - Combines val listing and file extraction\n**Returns**: Structured data with vals and their HTTP endpoints\n\n#### `vals.tsx` & `val-files.tsx`\n**Purpose**: Val Town API interfaces\n**Functions**: \n- `fetchVals()` - Get all user vals\n- `fetchValFiles(valId)` - Get files for specific val\n\n## Implementation Details\n\n### Cache Population Process\n1. **Fetch Vals**: Get all user vals from Val Town API\n2. **Extract Files**: For each val, get file list and filter for HTTP endpoints\n3. **Structure Data**: Organize into `ValWithFiles[]` format\n4. **Store**: Save to Blob Storage with performance metadata\n5. **Verify**: Confirm successful storage\n\n### Performance Characteristics\n- **Cache Hit Response**: ~200-500ms\n- **Live Data Response**: ~2-5s (depends on Val Town API)\n- **Cache Update Duration**: ~300-500ms\n- **Storage Efficiency**: JSON compression in Blob Storage\n\n### Error Handling\n- **Graceful Degradation**: Shows cached data even if stale\n- **Fallback Options**: Manual refresh and live data endpoints\n- **Error Logging**: Console logging for debugging cron job failures\n- **User Feedback**: Clear status indicators in web interface\n\n## Web Interface Features\n\n### Main Dashboard\n- **Summary Stats**: Total vals, endpoints, and update performance\n- **Freshness Indicator**: Green (fresh) / Yellow (stale) status dot\n- **Organized Display**: Vals grouped with their endpoints\n- **Direct Links**: Clickable endpoint URLs opening in new tabs\n\n### Visual Design\n- **Framework**: TailwindCSS via CDN\n- **Responsive**: Mobile-friendly grid layout\n- **Clean UI**: Card-based design with proper spacing\n- **Typography**: Clear hierarchy with code formatting for filenames\n\n### Interactive Elements\n- **Refresh Button**: Manual cache update\n- **Live Data Button**: Bypass cache for real-time data\n- **Cache Info Link**: View detailed metadata\n- **External Links**: Direct access to all endpoints\n\n## API Endpoints\n\n### `/api/cached`\n**Method**: GET\n**Response**: JSON cached data\n**Use Case**: Programmatic access to cached endpoints\n**Performance**: Fast (~200ms)\n\n### `/api/live`\n**Method**: GET \n**Response**: JSON live data from Val Town API\n**Use Case**: Real-time data when cache is stale\n**Performance**: Slow (~2-5s)\n\n### `/api/refresh`\n**Method**: GET\n**Response**: JSON success/failure status\n**Use Case**: Manual cache updates\n**Returns**: Update duration and val count\n\n### `/api/cache-info`\n**Method**: GET\n**Response**: JSON metadata\n**Use Case**: Cache status monitoring\n**Includes**: Last update time, freshness status, performance metrics\n\n## Configuration\n\n### Cron Job Setup\n1. Navigate to Val Town web interface\n2. Find `cache-updater.ts` in file list\n3. Set cron schedule (recommended: `0 * * * *` for hourly)\n4. Save configuration\n\n### Cache Freshness Settings\n- **Default**: 24 hours considered fresh\n- **Configurable**: Modify `maxAgeHours` parameter in `isCacheFresh()`\n- **Visual Indicator**: Green dot (fresh) vs Yellow dot (stale)\n\n### Storage Limits\n- **Blob Storage**: Generous limits for JSON data\n- **Key Strategy**: Separate data and metadata for efficient access\n- **Cleanup**: No automatic cleanup implemented (manual if needed)\n\n## Monitoring and Maintenance\n\n### Health Checks\n- **Cache Status**: Check `/api/cache-info` for last update time\n- **Data Integrity**: Verify endpoint counts match expectations\n- **Performance**: Monitor update duration trends\n\n### Troubleshooting\n- **Empty Cache**: Run `/api/refresh` to populate manually\n- **Stale Data**: Check cron job execution in Val Town logs\n- **API Errors**: Review console logs in cron job execution\n- **Performance Issues**: Monitor `updateDurationMs` in metadata\n\n### Maintenance Tasks\n- **Regular Monitoring**: Check cache freshness weekly\n- **Performance Review**: Monitor update duration trends\n- **Data Validation**: Spot-check endpoint accuracy monthly\n- **Cleanup**: Remove old cache keys if storage becomes an issue\n\n## Benefits Achieved\n\n### Performance Improvements\n- **Response Time**: 10x faster than live API calls\n- **Reliability**: Works during Val Town API slowdowns\n- **User Experience**: Instant loading of endpoint directory\n\n### Operational Benefits\n- **Automation**: No manual intervention required\n- **Scalability**: Handles growing number of vals efficiently\n- **Flexibility**: Multiple access methods (web, API, live)\n- **Monitoring**: Built-in performance and freshness tracking\n\n### Development Benefits\n- **Debugging**: Clear error handling and logging\n- **Extensibility**: Modular design for easy enhancements\n- **Documentation**: Self-documenting API endpoints\n- **Testing**: Manual refresh capability for development\n\n## Future Enhancements\n\n### Potential Improvements\n- **Cache Invalidation**: Smart invalidation based on val modifications\n- **Filtering**: Search and filter endpoints by name or val\n- **Analytics**: Track endpoint usage and popularity\n- **Notifications**: Alert on cache update failures\n- **Backup**: Secondary cache storage for redundancy\n\n### Scaling Considerations\n- **Pagination**: For users with many vals (100+)\n- **Compression**: Further optimize storage for large datasets\n- **CDN**: Consider CDN caching for global performance\n- **Rate Limiting**: Implement if API usage becomes intensive\n\n## Conclusion\n\nThe caching system successfully addresses the performance and reliability challenges of displaying Val Town HTTP endpoints. With automated updates, comprehensive monitoring, and multiple access methods, it provides a robust foundation for endpoint management and discovery.\n\nThe implementation demonstrates best practices for:\n- **Caching Strategy**: Appropriate use of Blob Storage\n- **Error Handling**: Graceful degradation and fallbacks \n- **User Experience**: Fast, informative interface\n- **Maintainability**: Clear code structure and documentation\n- **Monitoring**: Built-in performance and health metrics",[],[240],{"_104":248,"_95":249,"_153":250,"_155":-5,"_156":138,"_157":251,"_159":160,"_106":252,"_100":253,"_163":225,"_165":254,"_166":22,"_167":-5,"_168":255,"_98":256},"a16297ce-c27c-11f0-9110-42dde27851f2","README.md","c97e7dfa-3c34-11f0-b26f-9e149126039e",304,["D",1763250098770],26,"# cp-root - Val Town HTTP Endpoints Directory\n\nA caching system to efficiently display all your Val Town HTTP endpoints in a beautiful web interface.\n\n## ✅ Completed Features\n\n- [x] Fetch all vals from Val Town API\n- [x] Loop through vals and extract file information\n- [x] Filter files to find HTTP endpoints (any file with endpoint URL)\n- [x] **Caching system using Val Town Blob Storage**\n- [x] **Automated cache updates via cron job**\n- [x] **Beautiful web interface to browse endpoints**\n- [x] **Manual cache refresh capability**\n- [x] **Cache metadata tracking (last updated, performance metrics)**\n\n## 🏗️ Architecture\n\n### Core Data Pipeline\n- `vals.tsx` - Exports `fetchVals()` function to get list of all vals\n- `val-files.tsx` - Exports `fetchValFiles()` function to get files for a specific val \n- `vals-all-files.tsx` - Combines both functions to get all vals with their HTTP endpoints\n\n### Caching Layer\n- `cache-manager.ts` - Blob storage interface for caching vals data with metadata\n- `cache-updater.ts` - **Cron job** that automatically refreshes the cache\n- `simple-index.tsx` - **Main web interface** displaying cached endpoint data\n\n### Testing & Utilities\n- `test-cache.tsx` - Manual cache population for testing\n- `test-api.tsx` - API testing endpoints\n\n## 🚀 Usage\n\n### Main Interface\nVisit the main endpoint to see all your HTTP endpoints in a beautiful interface:\n- Shows total vals count, endpoint count, and last update time\n- Lists all vals with their HTTP endpoints\n- Direct links to each endpoint\n- Responsive design with Tailwind CSS\n\n### Cache Management\nThe cache automatically updates via cron job, but you can also:\n- **Manual refresh**: Use the test-cache endpoint to populate cache immediately\n- **Cache info**: Check cache metadata and freshness status\n- **Live data**: Bypass cache to get real-time data (slower)\n\n### API Endpoints\n- `/` - Main web interface (cached data)\n- `test-cache.tsx` - Manually refresh cache\n- `test-api.tsx/cache-info` - Get cache metadata\n- `test-api.tsx/cached` - Get cached data as JSON\n\n## 📊 Performance\n- **Cache hit**: ~200-500ms response time\n- **Live data**: ~2-5s response time (hits Val Town API)\n- **Cache update**: Runs automatically via cron, ~500ms update time\n- **Storage**: Uses Val Town Blob Storage (efficient key-value storage)\n\n## 🔧 Configuration\n\nThe cron job schedule can be configured in the Val Town web UI. The cache is considered \"fresh\" for 1 hour by default, but will display data regardless of age.\n\nCache keys:\n- `vals_with_files_cache` - Main data\n- `vals_with_files_cache_metadata` - Update timestamps and metrics",[],[249],{"_104":258,"_95":259,"_153":260,"_155":-5,"_156":138,"_157":261,"_159":160,"_106":262,"_100":32,"_163":263,"_165":264,"_166":22,"_167":-5,"_168":265,"_98":266},"455a2788-5aaf-11f0-bd2a-f69ea79377d9","cache-manager.ts","455a285a-5aaf-11f0-bd2a-f69ea79377d9",245,["D",1751836927772],"script","import { blob } from \"https://esm.town/v/std/blob\";\n\nconst CACHE_KEY = \"vals_with_files_cache\";\nconst CACHE_METADATA_KEY = \"vals_with_files_cache_metadata\";\n\nexport interface CacheMetadata {\n lastUpdated: string;\n totalVals: number;\n updateDurationMs: number;\n}\n\nexport interface CachedData {\n data: any; // The actual vals data\n metadata: CacheMetadata;\n}\n\n/**\n * Store vals data in cache with metadata\n */\nexport async function setCachedVals(data: any, updateDurationMs: number): Promise {\n const metadata: CacheMetadata = {\n lastUpdated: new Date().toISOString(),\n totalVals: data.totalVals || 0,\n updateDurationMs,\n };\n\n // Store data and metadata separately for easier access\n await Promise.all([\n blob.setJSON(CACHE_KEY, data),\n blob.setJSON(CACHE_METADATA_KEY, metadata),\n ]);\n}\n\n/**\n * Get cached vals data\n */\nexport async function getCachedVals(): Promise {\n try {\n return await blob.getJSON(CACHE_KEY);\n } catch (error) {\n console.error(\"Error reading cached vals:\", error);\n return null;\n }\n}\n\n/**\n * Get cache metadata (when last updated, etc.)\n */\nexport async function getCacheMetadata(): Promise {\n try {\n return await blob.getJSON(CACHE_METADATA_KEY);\n } catch (error) {\n console.error(\"Error reading cache metadata:\", error);\n return null;\n }\n}\n\n/**\n * Get both cached data and metadata together\n */\nexport async function getCachedValsWithMetadata(): Promise {\n try {\n const [data, metadata] = await Promise.all([\n getCachedVals(),\n getCacheMetadata(),\n ]);\n\n if (!data || !metadata) {\n return null;\n }\n\n return { data, metadata };\n } catch (error) {\n console.error(\"Error reading cached data with metadata:\", error);\n return null;\n }\n}\n\n/**\n * Check if cache exists and is relatively fresh (within specified hours)\n */\nexport async function isCacheFresh(maxAgeHours: number = 24): Promise {\n const metadata = await getCacheMetadata();\n if (!metadata) return false;\n\n const lastUpdated = new Date(metadata.lastUpdated);\n const now = new Date();\n const ageHours = (now.getTime() - lastUpdated.getTime()) / (1000 * 60 * 60);\n\n return ageHours < maxAgeHours;\n}",[],[259],{"_104":268,"_95":269,"_153":270,"_155":-5,"_156":138,"_157":271,"_159":160,"_106":272,"_100":273,"_163":274,"_165":275,"_166":22,"_167":-5,"_168":276,"_98":277},"8e4e2806-6750-11f0-8809-0224a6c84d84","cache-updater.ts","4b451a9a-5aaf-11f0-93ea-f69ea79377d9",275,["D",1753225613089],4,"interval","import { fetchValsWithFiles } from \"./vals-with-files.tsx\";\nimport { setCachedVals } from \"./cache-manager.ts\";\n\n// TODO:\n// [ ] install `vt` on mac\n// [ ] use rovo/gemini to explain & clean up this feature\n// [ ] or use Dia & web inline edit\n\n/**\n * Cron job to update the vals cache\n * This will run on a schedule to keep the cache fresh\n */\nexport default async function (): Promise {\n console.log(\"Starting cache update...\");\n const startTime = Date.now();\n\n try {\n // Fetch fresh data\n const valsData = await fetchValsWithFiles();\n \n // Calculate how long the update took\n const updateDurationMs = Date.now() - startTime;\n \n // Store in cache\n await setCachedVals(valsData, updateDurationMs);\n \n console.log(`Cache updated successfully in ${updateDurationMs}ms`);\n console.log(`Cached ${valsData.totalVals} vals with files`);\n \n } catch (error) {\n console.error(\"Failed to update cache:\", error);\n throw error; // Re-throw so the cron job shows as failed\n }\n}",[],[269],{"_104":279,"_95":280,"_153":281,"_155":-5,"_156":138,"_157":282,"_159":22,"_106":283,"_100":284,"_163":177,"_165":285,"_166":22,"_167":96,"_168":286,"_98":287},"fd024742-c582-11f0-b111-42dde27851f2","cp-root.tsx","16da92e8-4020-11f0-8f85-76b3cceeab13",328,["D",1763582682958],35,"import { Context, Hono } from \"https://esm.sh/hono@3.11.7\";\nimport { fetchValsWithFiles } from \"./fetch-vals-with-files.tsx\";\nimport { fetchVals } from \"./fetch-vals.tsx\";\n\nconst app = new Hono();\n\napp.onError((err: Error, _c: Context) => {\n throw err;\n});\n\n// Helper function to strip file extensions\nfunction stripExtension(filename: string): string {\n const lastDotIndex = filename.lastIndexOf(\".\");\n return lastDotIndex > 0 ? filename.substring(0, lastDotIndex) : filename;\n}\n\n// Helper function to make a request to an endpoint\nasync function fetchFromEndpoint(endpoint: string): Promise {\n try {\n const response = await fetch(endpoint);\n return response;\n } catch (error: any) {\n throw new Error(`Failed to fetch from endpoint: ${error?.message}`);\n }\n}\n\n// Dynamic routing handler\napp.get(\"*\", async (c: Context) => {\n let path = c.req.path;\n\n // Fix double slashes at the beginning\n path = path.replace(/^\\/+/, \"/\");\n\n // Normalize path - remove trailing slashes\n path = path.replace(/\\/+$/, \"\") || \"/\";\n\n // Handle remaining double slashes in the middle of the path\n if (path.includes(\"//\")) {\n return c.json({\n error: \"Not Found\",\n message: `Invalid path format`,\n }, 404);\n }\n\n try {\n const valsData = await fetchValsWithFiles();\n const allVals = await fetchVals(); // Get all vals including standalone ones\n\n // Parse the path\n const pathParts = path.split(\"/\").filter((part) => part.length > 0);\n const firstPart = pathParts[0];\n const remainingPath = pathParts.slice(1).join(\"/\");\n\n // Handle root path \"/\" - look for index val\n if (path === \"/\") {\n // Look for index.tsx file in cp-root val\n const cpRootVal = valsData.vals.find((val) => val.name === \"cp-root\");\n if (cpRootVal) {\n const indexFile = cpRootVal.files.find((file) =>\n stripExtension(file.filename).toLowerCase() === \"index\"\n );\n if (indexFile) {\n return await fetchFromEndpoint(indexFile.endpoint);\n }\n }\n }\n\n // Check cp-root val first (files have precedence)\n const cpRootVal = valsData.vals.find((val) => val.name === \"cp-root\");\n if (cpRootVal) {\n const targetFilename = remainingPath\n ? pathParts.join(\"/\") // Full path for nested routes\n : firstPart; // Just the first part for direct routes\n\n const matchingFile = cpRootVal.files.find((file) =>\n stripExtension(file.filename) === targetFilename\n );\n\n if (matchingFile) {\n return await fetchFromEndpoint(matchingFile.endpoint);\n }\n }\n\n // Check for val folder routes\n const targetVal = valsData.vals.find((val) => val.name === firstPart);\n if (targetVal) {\n // If no remaining path, look for index file in the val\n if (!remainingPath) {\n const indexFile = targetVal.files.find((file) =>\n stripExtension(file.filename).toLowerCase() === \"index\"\n );\n if (indexFile) {\n return await fetchFromEndpoint(indexFile.endpoint);\n }\n\n // No index file found\n return c.json({\n error: \"Not Found\",\n message: `No index file found in val '${firstPart}'`,\n }, 404);\n }\n\n // Look for specific file in the val\n const matchingFile = targetVal.files.find((file) =>\n stripExtension(file.filename) === remainingPath\n );\n\n if (matchingFile) {\n return await fetchFromEndpoint(matchingFile.endpoint);\n }\n\n // File not found in val\n return c.json({\n error: \"Not Found\",\n message: `File '${remainingPath}' not found in val '${firstPart}'`,\n }, 404);\n }\n\n // No matching val or file found\n return c.json({\n error: \"Not Found\",\n message: `No val or file found for path '${path}'`,\n }, 404);\n } catch (error: any) {\n console.error(\"Error in dynamic routing:\", error);\n return c.json({\n error: \"Internal Server Error\",\n message: \"Failed to process request\",\n }, 500);\n }\n});\n\nexport default app.fetch;",[],[280],{"_104":289,"_95":290,"_153":291,"_155":-5,"_156":138,"_157":292,"_159":160,"_106":293,"_100":32,"_163":225,"_165":294,"_166":22,"_167":-5,"_168":295,"_98":296},"fd0e6450-c582-11f0-b111-42dde27851f2","deno.json","fd0e6504-c582-11f0-b111-42dde27851f2",329,["D",1763582683042],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[],[290],{"_104":298,"_95":299,"_153":300,"_155":-5,"_156":138,"_157":301,"_159":160,"_106":302,"_100":303,"_163":177,"_165":304,"_166":22,"_167":305,"_168":306,"_98":307},"32d85384-c420-11f0-9d2c-42dde27851f2","fetch-val-files.tsx","59d8d7dc-5892-11f0-ada9-f69ea79377d9",320,["D",1763430301944],23,"export interface ValFile {\n name: string;\n id: string;\n path: string;\n version: number;\n updatedAt: string;\n type: \"http\" | \"cron\" | \"email\" | \"script\";\n links: {\n self: string;\n html: string;\n module: string;\n endpoint?: string;\n };\n}\n\ninterface ValFilesApiResponse {\n data: ValFile[];\n links: {\n self: string;\n next?: string;\n prev?: string;\n };\n}\n\n/**\n * Fetches val files from the Val Town API.\n *\n * @param {{ valId: string, path?: string }} options - The val identifier and optional path filter.\n * @returns {Promise} Resolves to an array of val files.\n * @throws If VALTOWN_API_TOKEN is missing or the API request fails.\n */\nexport async function fetchValFiles(options: {\n valId: string;\n path?: string;\n}): Promise {\n const { valId, path } = options;\n\n const apiToken = Deno.env.get(\"VALTOWN_API_TOKEN\");\n\n if (!apiToken) {\n throw new Error(\n \"VALTOWN_API_TOKEN environment variable is not set\",\n );\n }\n\n if (!valId) {\n throw new Error(\"Val ID is required\");\n }\n\n const apiUrl = new URL(`https://api.val.town/v2/vals/${valId}/files`);\n\n // Add path parameter if provided, otherwise list all files\n if (path !== undefined) {\n apiUrl.searchParams.set(\"path\", path);\n } else {\n apiUrl.searchParams.set(\"path\", \"\");\n }\n\n const response = await fetch(apiUrl.toString(), {\n headers: {\n \"Authorization\": `Bearer ${apiToken}`,\n \"Content-Type\": \"application/json\",\n },\n });\n\n if (!response.ok) {\n const errorText = await response.text();\n throw new Error(`API request failed: ${response.status} ${errorText}`);\n }\n\n const data: ValFilesApiResponse = await response.json();\n\n return data.data || [];\n}\n\nexport default async function (req: Request): Promise {\n try {\n // A default ID if none is given\n const cp_root_id = \"3a8b007a-3c19-11f0-857d-9e149126039e\";\n\n // Extract val ID from the URL path\n const url = new URL(req.url);\n const pathParts = url.pathname.split(\"/\").filter((part) => part.length > 0);\n // First segment after domain\n const valId = pathParts[0] ?? cp_root_id;\n\n if (!valId) {\n return Response.json({ error: \"Val ID is required\" }, { status: 400 });\n }\n\n // Get optional path parameter from query string\n const requestedPath = url.searchParams.get(\"path\");\n\n const files = await fetchValFiles({\n valId,\n path: requestedPath || undefined,\n });\n\n return new Response(\n JSON.stringify(files, null, 2),\n {\n headers: { \"Content-Type\": \"application/json\" },\n },\n );\n } catch (error) {\n console.error(\"Error fetching val files:\", error);\n return Response.json(\n { error: error.message },\n {\n status: 500,\n headers: { \"Content-Type\": \"application/json\" },\n },\n );\n }\n}","chad-val-files",[],[299],{"_104":309,"_95":310,"_153":311,"_155":-5,"_156":138,"_157":312,"_159":160,"_106":313,"_100":314,"_163":177,"_165":315,"_166":22,"_167":316,"_168":317,"_98":318},"2f845af6-c421-11f0-92f3-42dde27851f2","fetch-vals-with-files.tsx","9b9a719c-5894-11f0-bc7d-f69ea79377d9",323,["D",1763430725857],33,"import { fetchVals } from \"./fetch-vals.tsx\";\nimport { fetchValFiles } from \"./fetch-val-files.tsx\";\n\ninterface FileWithEndpoint {\n filename: string;\n endpoint: string;\n}\n\ninterface ValWithFiles {\n name: string;\n id: string;\n files: FileWithEndpoint[];\n}\n\ninterface ValsWithFilesResult {\n totalVals: number;\n vals: ValWithFiles[];\n}\n\n/**\n * Fetches all vals and their files with endpoints\n * @returns Promise containing the vals with their files that have endpoints\n */\nexport async function fetchValsWithFiles(): Promise {\n const vals = await fetchVals();\n const valsWithFiles: ValWithFiles[] = [];\n\n for (const val of vals) {\n if (!val.id) {\n continue;\n }\n\n try {\n const files = await fetchValFiles({ valId: val.id });\n\n // Filter files to only include those with endpoint values\n const filesWithEndpoints = files\n .filter((f) => f.links.endpoint && f.links.endpoint.trim() !== \"\")\n .map((f) => ({\n filename: f.name,\n endpoint: f.links.endpoint,\n }));\n\n valsWithFiles.push({\n name: val.name,\n id: val.id,\n files: filesWithEndpoints,\n });\n } catch (_fileError) {\n // Add val with empty files array to not lose the val entirely\n valsWithFiles.push({\n name: val.name,\n id: val.id,\n files: [],\n });\n }\n }\n\n return {\n totalVals: valsWithFiles.length,\n vals: valsWithFiles,\n };\n}\n\nexport default async function (_req: Request): Promise {\n try {\n const result = await fetchValsWithFiles();\n\n return new Response(\n JSON.stringify(result, null, 2),\n {\n headers: {\n \"Content-Type\": \"application/json\",\n },\n },\n );\n } catch (error) {\n console.error(\"Error in vals-all-files:\", error);\n return Response.json(\n { error: \"Internal server error\" },\n { status: 500 },\n );\n }\n}","chad-vals-all-files",[],[310],{"_104":320,"_95":321,"_153":322,"_155":-5,"_156":138,"_157":323,"_159":160,"_106":324,"_100":325,"_163":177,"_165":326,"_166":22,"_167":327,"_168":328,"_98":329},"570ed520-c420-11f0-9b8a-42dde27851f2","fetch-vals.tsx","f1e75a00-5890-11f0-a2b3-f69ea79377d9",321,["D",1763430362698],18,"export interface Val {\n id: string;\n name: string;\n code: string;\n type: \"http\" | \"cron\" | \"email\" | \"script\";\n privacy: \"public\" | \"private\" | \"unlisted\";\n runEndpoint?: string;\n author: {\n id: string;\n username: string;\n };\n createdAt: string;\n updatedAt: string;\n version: number;\n public: boolean;\n readme?: string;\n likeCount: number;\n runCount: number;\n}\n\ninterface ValsApiResponse {\n data: Val[];\n links: {\n next?: string;\n prev?: string;\n };\n}\n\nexport async function fetchVals(options: {\n offset?: number;\n limit?: number;\n} = {}): Promise {\n const { offset = 0, limit = 100 } = options;\n\n const apiToken = Deno.env.get(\"VALTOWN_API_TOKEN\");\n\n if (!apiToken) {\n throw new Error(\"VALTOWN_API_TOKEN environment variable is not set\");\n }\n\n const response = await fetch(\n `https://api.val.town/v2/me/vals?offset=${offset}&limit=${limit}`,\n {\n headers: {\n \"Authorization\": `Bearer ${apiToken}`,\n \"Content-Type\": \"application/json\",\n },\n },\n );\n\n if (!response.ok) {\n throw new Error(\n `API request failed: ${response.status} ${response.statusText}`,\n );\n }\n\n const data: ValsApiResponse = await response.json();\n\n return data.data || [];\n}\n\nexport default async function (_req: Request) {\n try {\n const vals = await fetchVals();\n\n return new Response(JSON.stringify(vals, null, 2), {\n headers: { \"Content-Type\": \"application/json\" },\n });\n } catch (error) {\n return new Response(\n JSON.stringify({ error: error.message }),\n {\n status: 500,\n headers: { \"Content-Type\": \"application/json\" },\n },\n );\n }\n}","chad-vals-list",[],[321],{"_104":331,"_95":99,"_153":332,"_155":-5,"_156":138,"_157":333,"_159":160,"_106":334,"_100":335,"_163":177,"_165":336,"_166":22,"_167":-5,"_168":337,"_98":338},"39c48cc8-c423-11f0-9904-42dde27851f2","31740ba8-6013-11f0-87c4-0224a6c84d84",326,["D",1763431602045],6,"import {\n getCachedVals,\n getCachedValsWithMetadata,\n isCacheFresh,\n} from \"./cache-manager.ts\";\nimport { fetchValsWithFiles } from \"./fetch-vals-with-files.tsx\";\nimport { setCachedVals } from \"./cache-manager.ts\";\n\nexport default async function (req: Request): Promise {\n const url = new URL(req.url);\n const path = url.pathname;\n\n // API Routes\n if (path === \"/api/cached\") {\n const data = await getCachedVals();\n if (!data) {\n return Response.json({ error: \"No cached data available\" }, {\n status: 404,\n });\n }\n return Response.json(data);\n }\n\n if (path === \"/api/live\") {\n try {\n const data = await fetchValsWithFiles();\n return Response.json(data);\n } catch (error) {\n return Response.json({\n error: \"Failed to fetch live data\",\n details: error.message,\n }, { status: 500 });\n }\n }\n\n if (path === \"/api/refresh\") {\n try {\n const startTime = Date.now();\n const data = await fetchValsWithFiles();\n const updateDurationMs = Date.now() - startTime;\n\n await setCachedVals(data, updateDurationMs);\n\n return Response.json({\n success: true,\n message: \"Cache refreshed successfully\",\n totalVals: data.totalVals,\n updateDurationMs,\n });\n } catch (error) {\n return Response.json({\n success: false,\n error: \"Failed to refresh cache\",\n details: error.message,\n }, { status: 500 });\n }\n }\n\n if (path === \"/api/cache-info\") {\n const cachedData = await getCachedValsWithMetadata();\n if (!cachedData) {\n return Response.json({ error: \"No cache data available\" }, {\n status: 404,\n });\n }\n\n const isFresh = await isCacheFresh(1);\n\n return Response.json({\n ...cachedData.metadata,\n isFresh,\n cacheExists: true,\n });\n }\n\n // Main HTML Interface\n if (path === \"/\") {\n try {\n const cachedData = await getCachedValsWithMetadata();\n\n if (!cachedData) {\n return new Response(\n `\n \n \n Val Town HTTP Endpoints\n \n \n \n

Val Town HTTP Endpoints

Cache is empty. The cache updater cron job needs to run first.

\n Manually refresh cache or \n view live data\n

\n \n \n `,\n {\n headers: { \"Content-Type\": \"text/html\" },\n },\n );\n }\n\n const { data, metadata } = cachedData;\n const lastUpdated = new Date(metadata.lastUpdated).toLocaleString();\n const isFresh = await isCacheFresh(1);\n const totalEndpoints = data.vals.reduce(\n (sum, val) => sum + val.files.length,\n 0,\n );\n\n return new Response(\n `\n \n \n Val Town HTTP Endpoints\n \n \n \n

Val Town HTTP Endpoints

\n \n Last updated: ${lastUpdated}\n

\n \n

${data.totalVals}

Total Vals

${totalEndpoints}

HTTP Endpoints

${metadata.updateDurationMs}ms

Last Update Time

\n\n

\n ${\n data.vals.map((val) => `\n

${val.name}

\n ${val.files.length} endpoint${\n val.files.length !== 1 ? \"s\" : \"\"\n }\n

\n \n ${\n val.files.length > 0\n ? `\n

\n ${\n val.files.map((file) => `\n

\n ${file.filename}\n

\n \n ${file.endpoint} ↗\n \n

\n `).join(\"\")\n }\n

\n `\n : `\n

No HTTP endpoints found

\n `\n }\n

\n `).join(\"\")\n }\n

\n\n

\n \n Refresh Cache\n \n \n View Live Data\n \n \n Cache Info\n \n

\n \n \n `,\n {\n headers: { \"Content-Type\": \"text/html\" },\n },\n );\n } catch (error) {\n console.error(\"Error serving index:\", error);\n return new Response(\n `\n \n \n

Error

Failed to load data: ${error.message}

\n \n \n `,\n {\n status: 500,\n headers: { \"Content-Type\": \"text/html\" },\n },\n );\n }\n }\n\n // 404 for other paths\n return Response.json({ error: \"Not Found\" }, { status: 404 });\n}",[],[99],{"_104":340,"_95":341,"_153":342,"_155":-5,"_156":138,"_157":343,"_159":160,"_106":344,"_100":345,"_163":177,"_165":346,"_166":22,"_167":-5,"_168":347,"_98":348},"4862f3ea-675e-11f0-b219-0224a6c84d84","index.tsx","3ea980bc-675e-11f0-85f5-0224a6c84d84",290,["D",1753231508738],3,"export default async function (req: Request): Promise {\n return Response.json({ ok: true })\n}",[],[341],"files",[150,170,181,191,202,209,220,229,238,247,257,267,278,288,297,308,319,330,339],"counts",{"_353":32,"_354":355,"_356":32,"_357":358},"pulls","branches",1,"forks","envVars",{"_359":355,"_360":32},"count","emptyCount","contents",[],{"_104":331,"_95":99,"_153":332,"_155":-5,"_156":138,"_157":333,"_159":160,"_106":364,"_100":335,"_163":177,"_165":336,"_166":22,"_167":-5,"_98":365},["D",1763431602045],[99],"upstreamProject","upstreamBranch","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.version.$version.code.$",{"_93":94,"_95":96,"_97":43,"_100":101,"_98":99,"_102":374,"_148":379,"_349":437,"_225":438,"_361":440,"_441":-5,"_442":-5,"_443":-5,"_444":-5,"_445":446},{"_104":105,"_95":96,"_106":375,"_108":-5,"_109":22,"_110":111,"_112":-5,"_113":-5,"_14":114,"_115":-5,"_116":22,"_117":-5,"_118":32,"_16":119,"_120":121,"_122":121,"_123":124,"_125":124,"_126":124,"_127":121,"_128":121,"_23":376,"_132":377,"_135":378,"_147":22},["D",1748473950250],{"_93":94,"_130":131},{"_93":94,"_134":131,"_14":114},{"_100":137,"_95":43,"_104":138,"_139":105,"_140":-5,"_141":-5,"_142":-5,"_143":-5,"_144":-5,"_145":96,"_146":94},[380,392,398,401,404,407,410,413,416,419,422,425,428,431,434],{"_104":151,"_95":152,"_153":154,"_155":-5,"_156":138,"_157":158,"_159":160,"_106":161,"_100":162,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":381,"_98":391},[382,385,388],{"_104":171,"_95":172,"_153":173,"_155":154,"_156":138,"_157":174,"_159":160,"_106":175,"_100":176,"_163":177,"_165":178,"_166":22,"_167":-5,"_168":383,"_98":384},[],[152,172],{"_104":182,"_95":183,"_153":184,"_155":154,"_156":138,"_157":185,"_159":160,"_106":186,"_100":187,"_163":177,"_165":188,"_166":22,"_167":-5,"_168":386,"_98":387},[],[152,183],{"_104":192,"_95":193,"_153":194,"_155":154,"_156":138,"_157":195,"_159":160,"_106":196,"_100":197,"_163":177,"_165":198,"_166":22,"_167":-5,"_168":389,"_98":390},[],[152,193],[152],{"_104":203,"_95":204,"_153":205,"_155":-5,"_156":138,"_157":206,"_159":160,"_106":207,"_100":162,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":393,"_98":397},[394],{"_104":210,"_95":211,"_153":212,"_155":205,"_156":138,"_157":213,"_159":160,"_106":214,"_100":215,"_163":177,"_165":216,"_166":22,"_167":-5,"_168":395,"_98":396},[],[204,211],[204],{"_104":221,"_95":222,"_153":223,"_155":-5,"_156":138,"_157":101,"_159":160,"_106":224,"_100":32,"_163":225,"_165":226,"_166":22,"_167":-5,"_168":399,"_98":400},[],[222],{"_104":230,"_95":231,"_153":232,"_155":-5,"_156":138,"_157":233,"_159":160,"_106":234,"_100":32,"_163":225,"_165":235,"_166":22,"_167":-5,"_168":402,"_98":403},[],[231],{"_104":239,"_95":240,"_153":241,"_155":-5,"_156":138,"_157":242,"_159":160,"_106":243,"_100":32,"_163":225,"_165":244,"_166":22,"_167":-5,"_168":405,"_98":406},[],[240],{"_104":248,"_95":249,"_153":250,"_155":-5,"_156":138,"_157":251,"_159":160,"_106":252,"_100":253,"_163":225,"_165":254,"_166":22,"_167":-5,"_168":408,"_98":409},[],[249],{"_104":258,"_95":259,"_153":260,"_155":-5,"_156":138,"_157":261,"_159":160,"_106":262,"_100":32,"_163":263,"_165":264,"_166":22,"_167":-5,"_168":411,"_98":412},[],[259],{"_104":268,"_95":269,"_153":270,"_155":-5,"_156":138,"_157":271,"_159":160,"_106":272,"_100":273,"_163":274,"_165":275,"_166":22,"_167":-5,"_168":414,"_98":415},[],[269],{"_104":279,"_95":280,"_153":281,"_155":-5,"_156":138,"_157":282,"_159":22,"_106":283,"_100":284,"_163":177,"_165":285,"_166":22,"_167":96,"_168":417,"_98":418},[],[280],{"_104":289,"_95":290,"_153":291,"_155":-5,"_156":138,"_157":292,"_159":160,"_106":293,"_100":32,"_163":225,"_165":294,"_166":22,"_167":-5,"_168":420,"_98":421},[],[290],{"_104":298,"_95":299,"_153":300,"_155":-5,"_156":138,"_157":301,"_159":160,"_106":302,"_100":303,"_163":177,"_165":304,"_166":22,"_167":305,"_168":423,"_98":424},[],[299],{"_104":309,"_95":310,"_153":311,"_155":-5,"_156":138,"_157":312,"_159":160,"_106":313,"_100":314,"_163":177,"_165":315,"_166":22,"_167":316,"_168":426,"_98":427},[],[310],{"_104":320,"_95":321,"_153":322,"_155":-5,"_156":138,"_157":323,"_159":160,"_106":324,"_100":325,"_163":177,"_165":326,"_166":22,"_167":327,"_168":429,"_98":430},[],[321],{"_104":331,"_95":99,"_153":332,"_155":-5,"_156":138,"_157":333,"_159":160,"_106":334,"_100":335,"_163":177,"_165":336,"_166":22,"_167":-5,"_168":432,"_98":433},[],[99],{"_104":340,"_95":341,"_153":342,"_155":-5,"_156":138,"_157":343,"_159":160,"_106":344,"_100":345,"_163":177,"_165":346,"_166":22,"_167":-5,"_168":435,"_98":436},[],[341],[380,382,385,388,392,394,398,401,404,407,410,413,416,419,422,425,428,431,434],{"_104":331,"_95":99,"_153":332,"_155":-5,"_156":138,"_157":333,"_159":160,"_106":364,"_100":335,"_163":177,"_165":336,"_166":22,"_167":-5,"_98":439},[99],[],"upstream","pull","ahead","behind","templates",[],"actionData","errors"]

chadparker

cp-root