[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_170":171,"_172":173},"routes/_app.x.$handle.$name",{"_98":97,"_32":45,"_106":88,"_27":36,"_13":14,"_107":-5,"_11":108,"_109":110,"_111":112,"_113":114,"_115":116,"_20":-5,"_117":-5,"_118":-5,"_119":25,"_120":121,"_122":123,"_124":-5,"_125":-5,"_126":127},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":-5,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":81,"_82":83,"_84":85,"_86":25},"version",6,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","valtown-api.ts","latestPath","fileId","02ad359c-553b-11f1-9ec1-ee650bb23af1","name","fileType","script","content","","import { Context, Hono } from \"npm:hono\";\n\nconst app = new Hono();\n\n// --- API DATA STRUCTURES ---\n\ninterface User {\n id: string;\n username: string;\n profileImageUrl: string | null;\n bio: string | null;\n}\n\ninterface Agent {\n id: string;\n name: string;\n author: User;\n privacy: \"public\" | \"unlisted\" | \"private\";\n}\n\ninterface AgentFile {\n agentId: string;\n name: string;\n path: string;\n content: string;\n type: \"file\" | \"http\" | \"script\";\n version: number;\n createdAt: string;\n updatedAt: string;\n}\n\ninterface Result {\n ok: boolean;\n data: T | string;\n}\n\n// --- HELPERS ---\n\nconst validateBody = (\n body: any,\n requiredFields: string[],\n): { valid: boolean; message: string } => {\n for (const field of requiredFields) {\n if (!body || !body[field]) {\n return { valid: false, message: `Missing required field: '${field}'` };\n }\n }\n return { valid: true, message: \"OK\" };\n};\n\nconst callValTownApi = async (\n url: string,\n method: string,\n bodyData: object | null = null,\n): Promise> => {\n const options: RequestInit = {\n method: method,\n headers: {\n \"Authorization\": \"Bearer \" + Deno.env.get(\"APITOKEN\"),\n \"Content-Type\": \"application/json\",\n },\n };\n\n if (bodyData) {\n options.body = JSON.stringify(bodyData);\n }\n\n try {\n const resp = await fetch(url, options);\n const text = await resp.text();\n\n if (!resp.ok) {\n return { ok: false, data: `API Error ${resp.status}: ${text}` };\n }\n\n try {\n const data = JSON.parse(text);\n return { ok: true, data: data };\n } catch {\n return { ok: true, data: text };\n }\n } catch (e: any) {\n return { ok: false, data: `Internal error: ${e.message}` };\n }\n};\n\n// --- CRUD Operations for Val Resources ---\n\nconst createAgent = async (\n config: {\n name: string;\n description?: string;\n privacy?: Agent[\"privacy\"];\n code?: string;\n },\n): Promise> => {\n const createConfig = {\n ...config,\n privacy: config.privacy || \"public\",\n };\n\n const result = await callValTownApi(\n \"https://api.val.town/v2/vals\",\n \"POST\",\n createConfig,\n );\n return (result.ok\n ? { ok: true, data: result.data as Agent }\n : result as Result);\n};\n\nconst updateAgent = async (\n agentId: string,\n config: {\n name?: string;\n description?: string;\n privacy?: Agent[\"privacy\"];\n code?: string;\n },\n): Promise> => {\n const result = await callValTownApi(\n `https://api.val.town/v2/vals/${agentId}`,\n \"PUT\",\n config,\n );\n return result.ok ? { ok: true, data: result.data as Agent } : result;\n};\n\nconst deleteAgent = async (agentId: string): Promise> => {\n const result = await callValTownApi(\n `https://api.val.town/v2/vals/${agentId}`,\n \"DELETE\",\n );\n return result.ok ? { ok: true, data: \"Agent deleted successfully\" } : result;\n};\n\n/**\n * Adds an environment variable to a specific Val.\n */\nconst addEnvironmentVariable = async (\n agentId: string,\n key: string,\n value: string,\n): Promise> => {\n const url = `https://api.val.town/v2/vals/${agentId}/environment_variables`;\n const body = { key, value };\n return await callValTownApi(url, \"POST\", body);\n};\n\n// --- CRUD Operations for Val File Resources ---\nconst createOrUpdateFile = async (\n agentId: string,\n path: string,\n fileName: string,\n fileType: string,\n content: string,\n method: \"POST\" | \"PUT\",\n): Promise> => {\n const fullPath: string = path + fileName;\n // We do NOT split the path here anymore. The 'name' field in the body represents the path.\n const requestBody = {\n type: fileType,\n name: fileName, // e.g. \"src/data.json\"\n content: content,\n };\n\n // We send the request to the base /files endpoint. The 'name' in the body dictates the path.\n const url = `https://api.val.town/v2/vals/${agentId}/files?path=${fullPath}`;\n\n const result = await callValTownApi(url, method, requestBody);\n return result.ok ? { ok: true, data: result.data as AgentFile } : result;\n};\n\nconst deleteFile = async (\n agentId: string,\n path: string,\n fileName: string,\n): Promise> => {\n const fullPath = path + fileName;\n // Ensure the path parameter handles slashes correctly if required by API,\n // though usually query params handle strings as-is (encoded by browser/fetch).\n const result = await callValTownApi(\n `https://api.val.town/v2/vals/${agentId}/files?path=${fullPath}`,\n \"DELETE\",\n );\n return result.ok ? { ok: true, data: \"File deleted successfully\" } : result;\n};\n\n// --- ORCHESTRATION FUNCTIONS ---\n\n// --- MIDDLEWARE ---\n\napp.use(\"*\", async (c, next) => {\n c.header(\"Access-Control-Allow-Origin\", \"https://agentfactory.val.run\");\n c.header(\"Access-Control-Allow-Methods\", \"GET, POST, PUT, DELETE, OPTIONS\");\n c.header(\"Access-Control-Allow-Headers\", \"Content-Type, Authorization\");\n\n if (c.req.method === \"OPTIONS\") return c.text(\"OK\", 200);\n await next();\n});\n\n// --- ROUTES ---\n\napp.post(\"/agent\", async (c) => {\n try {\n const body = await c.req.json();\n const validation = validateBody(body, [\"name\"]);\n\n if (!validation.valid) {\n return c.json({ ok: false, data: validation.message }, 400);\n }\n\n const res = await createAgent(body);\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({ ok: false, data: e.message }, 500);\n }\n});\n\napp.put(\"/agent/:agentId\", async (c) => {\n try {\n const agentId = c.req.param(\"agentId\");\n const body = await c.req.json();\n\n if (Object.keys(body).length === 0) {\n return c.json({ ok: false, data: \"No update parameters provided.\" }, 400);\n }\n\n const res = await updateAgent(agentId, body);\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({\n ok: false,\n data: `Error in update agent: data: ${e.message}\\n${e.stack}`,\n }, 500);\n }\n});\n\napp.delete(\"/agent/:agentId\", async (c) => {\n try {\n const agentId = c.req.param(\"agentId\");\n const res = await deleteAgent(agentId);\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({ ok: false, data: e.message }, 500);\n }\n});\n\napp.post(\"/agent/:agentId/files\", async (c) => {\n try {\n const agentId = c.req.param(\"agentId\");\n const path = c.req.query(\"path\");\n const body = await c.req.json();\n\n const validation = validateBody(body, [\"content\", \"type\", \"name\"]);\n if (!validation.valid) {\n return c.json({ ok: false, data: validation.message }, 400);\n }\n\n // filename here might contain slashes if encoded correctly in URL, or passed differently.\n // However, createOrUpdateFile now treats the second argument as the full path.\n const res = await createOrUpdateFile(\n agentId,\n path,\n body.name,\n body.type,\n body.content,\n \"POST\",\n );\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({ ok: false, data: e.message }, 500);\n }\n});\n\napp.put(\"/agent/:agentId/files\", async (c) => {\n try {\n const agentId = c.req.param(\"agentId\");\n const path = c.req.query(\"path\");\n const body = await c.req.json();\n\n const validation = validateBody(body, [\"content\", \"type\"]);\n if (!validation.valid) {\n return c.json({ ok: false, data: validation.message }, 400);\n }\n\n const res = await createOrUpdateFile(\n agentId,\n path,\n body.filename,\n body.type,\n body.content,\n \"PUT\",\n );\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({ ok: false, data: e.message }, 500);\n }\n});\n\napp.delete(\"/agent/:agentId/files\", async (c) => {\n try {\n const agentId = c.req.param(\"agentId\");\n const path = c.req.query(\"path\");\n const filename = c.req.query(\"filename\");\n const res = await deleteFile(agentId, path, filename);\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({ ok: false, data: e.message }, 500);\n }\n});\n\napp.get(\"/\", (c) => {\n return c.json({\n \"info\": {\n \"title\": \"AgentFactory API\",\n \"version\": \"1.0.0\",\n \"description\":\n \"Orchestration API for managing Agents (Vals) and their associated Files.\",\n },\n \"models\": [\n {\n \"name\": \"User\",\n \"description\": \"Represents the author of an Agent.\",\n \"fields\": [\n {\n \"name\": \"id\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"username\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"profileImageUrl\",\n \"type\": \"string | null\",\n \"required\": false,\n },\n {\n \"name\": \"bio\",\n \"type\": \"string | null\",\n \"required\": false,\n },\n ],\n },\n {\n \"name\": \"Agent\",\n \"description\": \"The core resource representing a Val.\",\n \"fields\": [\n {\n \"name\": \"id\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"name\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"author\",\n \"type\": \"User\",\n \"required\": true,\n },\n {\n \"name\": \"privacy\",\n \"type\": \"'public' | 'unlisted' | 'private'\",\n \"required\": true,\n },\n ],\n },\n {\n \"name\": \"AgentFile\",\n \"description\": \"A file belonging to an Agent.\",\n \"fields\": [\n {\n \"name\": \"agentId\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"name\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"content\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"type\",\n \"type\": \"'file' | 'http' | 'script'\",\n \"required\": true,\n },\n {\n \"name\": \"version\",\n \"type\": \"number\",\n \"required\": true,\n },\n {\n \"name\": \"createdAt\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"updatedAt\",\n \"type\": \"string\",\n \"required\": true,\n },\n ],\n },\n {\n \"name\": \"Result\",\n \"description\": \"Standard API response wrapper.\",\n \"fields\": [\n {\n \"name\": \"ok\",\n \"type\": \"boolean\",\n \"required\": true,\n },\n {\n \"name\": \"data\",\n \"type\": \"T | string\",\n \"required\": true,\n \"description\": \"Payload or error message\",\n },\n ],\n },\n ],\n \"endpoints\": [\n {\n \"method\": \"GET\",\n \"path\": \"/\",\n \"summary\": \"System Diagnostics\",\n \"description\":\n \"Runs a full workflow test: creates an agent, adds files, updates them, and cleans up.\",\n \"parameters\": [],\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result<{ ok: boolean, debugInfo: string[] }>\",\n \"description\": \"Test sequence successful\",\n },\n {\n \"status\": 400,\n \"type\": \"Result<{ ok: boolean, debugInfo: string[] }>\",\n \"description\": \"Test sequence failed\",\n },\n ],\n },\n {\n \"method\": \"POST\",\n \"path\": \"/agent\",\n \"summary\": \"Create Agent\",\n \"description\": \"Creates a new Agent (Val) resource.\",\n \"parameters\": [],\n \"body\": {\n \"fields\": [\n {\n \"name\": \"name\",\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"Unique name for the agent\",\n },\n {\n \"name\": \"description\",\n \"type\": \"string\",\n \"required\": false,\n },\n {\n \"name\": \"privacy\",\n \"type\": \"'public' | 'unlisted' | 'private'\",\n \"required\": false,\n \"default\": \"'public'\",\n },\n {\n \"name\": \"code\",\n \"type\": \"string\",\n \"required\": false,\n \"description\": \"Initial source code\",\n },\n ],\n },\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n },\n {\n \"status\": 400,\n \"type\": \"Result\",\n \"description\": \"Validation error\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n \"description\": \"Internal server error\",\n },\n ],\n },\n {\n \"method\": \"PUT\",\n \"path\": \"/agent/:agentId\",\n \"summary\": \"Update Agent\",\n \"description\":\n \"Updates an existing Agent's metadata or privacy settings.\",\n \"parameters\": [\n {\n \"name\": \"agentId\",\n \"in\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n ],\n \"body\": {\n \"fields\": [\n {\n \"name\": \"name\",\n \"type\": \"string\",\n \"required\": false,\n },\n {\n \"name\": \"description\",\n \"type\": \"string\",\n \"required\": false,\n },\n {\n \"name\": \"privacy\",\n \"type\": \"'public' | 'unlisted' | 'private'\",\n \"required\": false,\n },\n {\n \"name\": \"code\",\n \"type\": \"string\",\n \"required\": false,\n },\n ],\n },\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n },\n {\n \"status\": 400,\n \"type\": \"Result\",\n \"description\": \"No parameters provided\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n },\n ],\n },\n {\n \"method\": \"DELETE\",\n \"path\": \"/agent/:agentId\",\n \"summary\": \"Delete Agent\",\n \"description\": \"Permanently removes an Agent resource.\",\n \"parameters\": [\n {\n \"name\": \"agentId\",\n \"in\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n ],\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n \"description\": \"Success message\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n },\n ],\n },\n {\n \"method\": \"POST\",\n \"path\": \"/agent/:agentId/files\",\n \"summary\": \"Create File\",\n \"description\": \"Adds a new file to the specified Agent.\",\n \"parameters\": [\n {\n \"name\": \"agentId\",\n \"in\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"path\",\n \"in\": \"query\",\n \"type\": \"string\",\n \"required\": false,\n \"description\": \"Base directory path\",\n },\n ],\n \"body\": {\n \"fields\": [\n {\n \"name\": \"name\",\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"Filename (appended to path)\",\n },\n {\n \"name\": \"type\",\n \"type\": \"'file' | 'http' | 'script'\",\n \"required\": true,\n },\n {\n \"name\": \"content\",\n \"type\": \"string\",\n \"required\": true,\n },\n ],\n },\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n },\n {\n \"status\": 400,\n \"type\": \"Result\",\n \"description\": \"Validation error\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n },\n ],\n },\n {\n \"method\": \"PUT\",\n \"path\": \"/agent/:agentId/files\",\n \"summary\": \"Update File\",\n \"description\": \"Updates content of an existing file.\",\n \"parameters\": [\n {\n \"name\": \"agentId\",\n \"in\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"path\",\n \"in\": \"query\",\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"Full filename/path to update\",\n },\n ],\n \"body\": {\n \"fields\": [\n {\n \"name\": \"type\",\n \"type\": \"'file' | 'http' | 'script'\",\n \"required\": true,\n },\n {\n \"name\": \"content\",\n \"type\": \"string\",\n \"required\": true,\n },\n ],\n },\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n },\n {\n \"status\": 400,\n \"type\": \"Result\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n },\n ],\n },\n {\n \"method\": \"DELETE\",\n \"path\": \"/agent/:agentId/files\",\n \"summary\": \"Delete File\",\n \"description\": \"Removes a file from the Agent.\",\n \"parameters\": [\n {\n \"name\": \"agentId\",\n \"in\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"path\",\n \"in\": \"query\",\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"path part of file to delete\",\n },\n {\n \"name\": \"filename\",\n \"in\": \"query\",\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"filename of file path to delete\",\n },\n ],\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n \"description\": \"Success message\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n },\n ],\n },\n ],\n });\n});\n\n// Test Route for full workflow\napp.get(\"/test\", async (c) => {\n const testAgentName = \"test_\" + new Date().getTime().toString();\n const testFilename = \"main.ts\"; // Basic name\n const testPath = \"src/\";\n\n const initialContent = \"export function run() { return 'Test content'; }\";\n\n let debug: string[] = [];\n let agentRes: Result;\n let fileRes: Result | null = null;\n\n try {\n // 1. Create Val\n agentRes = await createAgent({ name: testAgentName, code: initialContent });\n debug.push(`Create Agent response: ${JSON.stringify(agentRes)}`);\n\n if (agentRes.ok) {\n const agentId = (agentRes.data as Agent).id;\n\n // --- ADD ENVIRONMENT VARIABLE ---\n const currentApiToken = Deno.env.get(\"APITOKEN\");\n if (currentApiToken) {\n const envVarResult = await addEnvironmentVariable(\n agentId,\n \"APITOKEN\",\n currentApiToken,\n );\n debug.push(`Add Env Var response: ${JSON.stringify(envVarResult)}`);\n } else {\n debug.push(\n \"SKIPPING Env Var: No APITOKEN found in current environment\",\n );\n }\n // --------------------------------\n\n // 2. Create File within Val (USING FULL PATH)\n fileRes = await createOrUpdateFile(\n agentId,\n testPath,\n testFilename,\n \"http\",\n initialContent,\n \"POST\",\n );\n debug.push(`Create HTTP File response: ${JSON.stringify(fileRes)}`);\n\n // 3. Update File\n let updateResult;\n if (fileRes.ok === true) {\n const updatedContent =\n \"export function run() { return 'Updated content'; }\";\n updateResult = await createOrUpdateFile(\n agentId,\n testPath,\n testFilename,\n \"http\",\n updatedContent,\n \"PUT\",\n );\n if (updateResult.ok === true) {\n debug.push(`Update File response: ${JSON.stringify(updateResult)}`);\n } else {\n const msg = `ERROR IN UPDATE FILE RESPONSE ${\n JSON.stringify(updateResult)\n }`;\n debug.push(msg);\n }\n } else {\n const msg = `ERROR IN CREATE FILE RESPONSE ${\n JSON.stringify(updateResult)\n }`;\n debug.push(msg);\n throw new Error(msg);\n }\n }\n } catch (e: any) {\n debug.push(`Caught error during test: ${e.message}`);\n } finally {\n // 4. Cleanup\n if (agentRes && agentRes.ok === true) {\n const agentId = (agentRes.data as Agent).id;\n try {\n const delFileRes = await deleteFile(agentId, testPath, testFilename);\n if (delFileRes.ok === true) {\n debug.push(\n `Delete File cleanup response: ${JSON.stringify(delFileRes)}`,\n );\n } else {\n debug.push(`DELETE FILE FAILED: ${JSON.stringify(delFileRes)}`);\n }\n } catch (err) {\n debug.push(`ERROR IN CLEANUP: ${err.message}\\n${err.stack}`);\n }\n try {\n const delAgentRes = await deleteAgent(agentId);\n if (delAgentRes.ok === true) {\n debug.push(\n `Delete agent cleanup response: ${JSON.stringify(delAgentRes)}`,\n );\n } else {\n debug.push(`DELETE AGENT FAILED: ${JSON.stringify(delAgentRes)}`);\n }\n } catch (err) {\n debug.push(`ERROR IN CLEANUP: ${err.message}\\n${err.stack}`);\n }\n }\n }\n\n const overallSuccess = agentRes?.ok === true && fileRes?.ok === true;\n return c.json(\n { ok: overallSuccess, debugInfo: debug },\n overallSuccess ? 200 : 400,\n );\n});\n\nexport default app.fetch;","createdAt",["D",1779384762807],"branchVersion","branchId","8fc40db2-553a-11f1-97ac-ee650bb23af1","id","8fc34bde-553a-11f1-97ac-ee650bb23af1","deployer",["D",1779384543359],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Valtown deployer API","imageUrl","2c6d46b0-54dd-11f0-a86c-6fbc2b29331a","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","850db142-aa5e-4914-bceb-1e2e085ae4c5","tursoName","8fc34bde553a11f197acee650bb23af1","tursoHostname","8fc34bde553a11f197acee650bb23af1-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789495880338],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_98":97,"_105":101},"org",{"_98":97,"_99":-5,"_100":101,"_18":55,"_102":103,"_104":25},"branch",{"_13":87,"_32":88,"_43":42,"_89":44,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":45,"_96":97},"isOwned",15,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","ziggyware","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yekJHRDE5SGVoUHUzUENQaXY2MTRkT3h0cncifQ","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_43":44,"_32":45,"_38":165,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":-5,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":166,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":167,"_82":168,"_84":169,"_86":25},"tree",[156,157],"files",[156,157],"counts",{"_145":61,"_146":147,"_148":61,"_149":150,"_151":152},"contents",[128,129],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_43":137,"_32":138,"_30":139,"_131":-5,"_41":42,"_40":140,"_132":25,"_38":141,"_13":134,"_33":142,"_35":143,"_24":25,"_135":-5,"_27":144},{"_43":130,"_32":28,"_30":31,"_131":-5,"_41":42,"_40":14,"_132":25,"_38":133,"_13":134,"_33":34,"_35":37,"_24":25,"_135":-5,"_27":136},"129468b8-553b-11f1-8498-ee650bb23af1","parentId","latest",["D",1779384762807],2,"label",[28],"9d4d3fd0-553a-11f1-9174-ee650bb23af1","main.ts","8fc70724-553a-11f1-97ac-ee650bb23af1",3,["D",1779384566046],"http","import valTownAccessor, {\n PaginationControl,\n ValTownAccessor,\n ValTownAccessorConfig,\n} from \"./valtown_accessor.ts\"; // adjust path as needed\n\n// ============================================================\n// TYPES\n// ============================================================\n\nexport type Privacy = \"public\" | \"unlisted\" | \"private\";\nexport type FileType = \"file\" | \"http\" | \"interval\" | \"email\" | \"script\";\n\nexport interface Val {\n id: string;\n name: string;\n privacy: Privacy;\n description?: string;\n createdAt: string;\n httpUrl: string;\n}\n\nexport interface ValFile {\n path: string;\n name: string;\n type: FileType;\n version: number;\n lastModified?: string;\n}\n\nexport interface EnvVar {\n key: string;\n description: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface HttpResponse {\n status: number;\n ok: boolean;\n text: string;\n json: unknown;\n}\n\nexport interface CreateValOptions {\n privacy?: Privacy;\n description?: string;\n code?: string;\n}\n\nexport interface CreateFileOptions {\n content?: string;\n type?: FileType;\n branchId?: string;\n}\n\nexport interface UpdateFileOptions {\n content: string;\n type?: FileType;\n branchId?: string;\n parentPath?: string;\n}\n\nexport interface ListFilesOptions extends PaginationControl {\n path?: string;\n recursive?: boolean;\n}\n\nexport interface CallOptions {\n method?: \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n body?: unknown;\n headers?: Record;\n}\n\n// ============================================================\n// RESULT / ERROR TYPES (never throw — always return)\n// ============================================================\n\nexport type Result =\n | { ok: true; data: T }\n | { ok: false; error: Error };\n\nfunction ok(data: T): Result {\n return { ok: true, data };\n}\n\nfunction fail(e: unknown): Result {\n return { ok: false, error: e instanceof Error ? e : new Error(String(e)) };\n}\n\nasync function wrap(fn: () => Promise): Promise> {\n try {\n return ok(await fn());\n } catch (e) {\n return fail(e);\n }\n}\n\n// ============================================================\n// FILE BUILDER (fluent chain for a single file inside a Val)\n// ============================================================\n\nexport class FileBuilder {\n constructor(\n private readonly accessor: ValTownAccessor,\n private readonly valId: string,\n private readonly path: string,\n ) {}\n\n /** Read the raw text content of this file. */\n async read(): Promise> {\n return wrap(() =>\n this.accessor.getFileContentText(this.valId, { path: this.path })\n );\n }\n\n /** Read the raw Response object (useful for binary / streaming). */\n async readResponse(): Promise> {\n return wrap(() =>\n this.accessor.getFileContentResponse(this.valId, { path: this.path })\n );\n }\n\n /** Overwrite the file with new content. */\n async write(\n content: string,\n opts: UpdateFileOptions = { content },\n ): Promise> {\n const name = this.path.split(\"/\").at(-1) ?? this.path;\n return wrap(async () => {\n const r = await this.accessor.updateFile(this.valId, {\n path: this.path,\n content: opts.content ?? content,\n type: opts.type ?? \"file\",\n name,\n branchId: opts.branchId,\n parent_path: opts.parentPath,\n });\n return r as ValFile;\n });\n }\n\n /** Delete this file. Pass `recursive: true` to remove a directory. */\n async delete(recursive = false): Promise> {\n return wrap(() =>\n this.accessor.deleteFile(this.valId, { path: this.path, recursive })\n );\n }\n\n /** Convenience: parse the file as JSON. */\n async readJson(): Promise> {\n const res = await this.read();\n if (!res.ok) return res;\n try {\n return ok(JSON.parse(res.data) as T);\n } catch (e) {\n return fail(e);\n }\n }\n\n /** Convenience: write an object as pretty-printed JSON. */\n async writeJson(value: unknown, indent = 2): Promise> {\n return this.write(JSON.stringify(value, null, indent));\n }\n}\n\n// ============================================================\n// VAL BUILDER (fluent chain for a single Val)\n// ============================================================\n\nexport class ValBuilder {\n constructor(\n private readonly accessor: ValTownAccessor,\n private readonly id: string,\n ) {}\n\n // ---- files ------------------------------------------------\n\n /** Target a specific file by path. Returns a FileBuilder. */\n file(path: string): FileBuilder {\n return new FileBuilder(this.accessor, this.id, path);\n }\n\n /**\n * Create a new file in this Val.\n * Returns a FileBuilder for the new file.\n */\n async createFile(\n path: string,\n opts: CreateFileOptions = {},\n ): Promise> {\n return wrap(async () => {\n await this.accessor.createFile(this.id, {\n path,\n content: opts.content,\n type: opts.type ?? \"file\",\n branchId: opts.branchId,\n });\n return this.file(path);\n });\n }\n\n /** List all files in this Val. */\n async listFiles(opts: ListFilesOptions = {}): Promise> {\n return wrap(() =>\n this.accessor.listFiles(this.id, opts) as Promise\n );\n }\n\n // ---- env vars ---------------------------------------------\n\n /** Add or set an environment variable. */\n async setEnv(key: string, value: string): Promise> {\n return wrap(async () => {\n try {\n return await this.accessor.createEnvVar(this.id, {\n key,\n value,\n }) as EnvVar;\n } catch {\n // Fall back to update if it already exists\n return await this.accessor.updateEnvVar(this.id, key, value) as EnvVar;\n }\n });\n }\n\n /** List all environment variables (keys only — values are secret). */\n async listEnvs(): Promise> {\n return wrap(() => this.accessor.listEnvVars(this.id) as Promise);\n }\n\n /** Remove an environment variable by key. */\n async deleteEnv(key: string): Promise> {\n return wrap(() => this.accessor.deleteEnvVar(this.id, key));\n }\n\n // ---- HTTP calls -------------------------------------------\n\n /** Call this Val's HTTP endpoint. */\n async call(\n url: string,\n opts: CallOptions = {},\n ): Promise> {\n return wrap(() => this.accessor.callValHttp(url, opts));\n }\n\n // ---- lifecycle --------------------------------------------\n\n /** Permanently delete this Val. */\n async delete(): Promise> {\n return wrap(() => this.accessor.deleteVal(this.id));\n }\n}\n\n// ============================================================\n// MAIN API CLASS\n// ============================================================\n\nexport class ValTownAPI {\n private readonly accessor: ValTownAccessor;\n\n constructor(accessorOrConfig?: ValTownAccessor | ValTownAccessorConfig) {\n if (accessorOrConfig instanceof ValTownAccessor) {\n this.accessor = accessorOrConfig;\n } else {\n this.accessor = new ValTownAccessor(accessorOrConfig);\n }\n }\n\n // ---- identity ---------------------------------------------\n\n /** Return the authenticated user's username. */\n async username(): Promise> {\n return wrap(() => this.accessor.getUsername());\n }\n\n // ---- val discovery ----------------------------------------\n\n /**\n * Look up a Val by exact name.\n * Returns a ValBuilder + metadata on success.\n */\n async find(name: string): Promise> {\n return wrap(async () => {\n const v = await this.accessor.getValByName(name);\n if (!v) throw new Error(`Val not found: \"${name}\"`);\n return { ...v, privacy: v.privacy as Privacy, builder: this.val(v.id) };\n });\n }\n\n /**\n * Look up a Val by ID.\n * Returns a ValBuilder + metadata on success.\n */\n async findById(id: string): Promise> {\n return wrap(async () => {\n const v = await this.accessor.getValById(id);\n if (!v) throw new Error(`Val not found with id: \"${id}\"`);\n return { ...v, privacy: v.privacy as Privacy, builder: this.val(v.id) };\n });\n }\n\n /** List all Vals owned by the authenticated user. */\n async list(ctrl?: PaginationControl): Promise> {\n return wrap(async () => {\n const vals = await this.accessor.listVals(ctrl);\n return vals.map((v) => ({ ...v, privacy: v.privacy as Privacy }));\n });\n }\n\n // ---- val creation -----------------------------------------\n\n /**\n * Create a new Val and return a ValBuilder for it.\n *\n * @example\n * const { data: builder } = await api.create(\"my-val\", { privacy: \"unlisted\" });\n */\n async create(\n name: string,\n opts: CreateValOptions = {},\n ): Promise> {\n return wrap(async () => {\n const v = await this.accessor.createVal({\n name,\n privacy: opts.privacy ?? \"private\",\n description: opts.description,\n code: opts.code,\n });\n return { ...v, privacy: v.privacy as Privacy, builder: this.val(v.id) };\n });\n }\n\n /**\n * Find an existing Val or create it if it doesn't exist.\n * Useful for idempotent setup scripts.\n */\n async findOrCreate(\n name: string,\n defaults: CreateValOptions = {},\n ): Promise> {\n return wrap(async () => {\n const existing = await this.accessor.getValByName(name);\n if (existing) {\n return {\n ...existing,\n privacy: existing.privacy as Privacy,\n builder: this.val(existing.id),\n created: false,\n };\n }\n const created = await this.accessor.createVal({\n name,\n privacy: defaults.privacy ?? \"private\",\n description: defaults.description,\n code: defaults.code,\n });\n return {\n ...created,\n privacy: created.privacy as Privacy,\n builder: this.val(created.id),\n created: true,\n };\n });\n }\n\n // ---- direct builder access --------------------------------\n\n /**\n * Get a ValBuilder directly by ID — no network round-trip.\n * Use when you already know the Val ID.\n */\n val(id: string): ValBuilder {\n return new ValBuilder(this.accessor, id);\n }\n\n // ---- HTTP shorthand ---------------------------------------\n\n /** GET a Val's HTTP endpoint at `url`. */\n async get(\n url: string,\n headers?: Record,\n ): Promise> {\n return wrap(() =>\n this.accessor.callValHttp(url, { method: \"GET\", headers })\n );\n }\n\n /** POST JSON to a Val's HTTP endpoint. */\n async post(\n url: string,\n body: unknown,\n headers?: Record,\n ): Promise> {\n return wrap(() =>\n this.accessor.callValHttp(url, { method: \"POST\", body, headers })\n );\n }\n\n /** PUT JSON to a Val's HTTP endpoint. */\n async put(\n url: string,\n body: unknown,\n headers?: Record,\n ): Promise> {\n return wrap(() =>\n this.accessor.callValHttp(url, { method: \"PUT\", body, headers })\n );\n }\n\n /** DELETE a resource at a Val's HTTP endpoint. */\n async delete(\n url: string,\n headers?: Record,\n ): Promise> {\n return wrap(() =>\n this.accessor.callValHttp(url, { method: \"DELETE\", headers })\n );\n }\n\n // ---- utilities --------------------------------------------\n\n /** Sanitize a string into a valid Val name. */\n sanitizeName(name: string): string {\n return this.accessor.sanitizeName(name);\n }\n\n /** Sleep for `ms` milliseconds. */\n sleep(ms: number): Promise {\n return this.accessor.sleep(ms);\n }\n\n /**\n * Run a full integration smoke-test.\n * Creates a throwaway Val, exercises every major operation, then deletes it.\n */\n async smokeTest(\n namePrefix = \"api-smoke-test\",\n ): Promise>> {\n return wrap(() => this.accessor.fullDemo(namePrefix));\n }\n}\n\n// ============================================================\n// FACTORY / DEFAULT EXPORT\n// ============================================================\n\n/**\n * Create a new ValTownAPI instance.\n *\n * @example\n * import { createAPI } from \"./valtown_api.ts\";\n * const api = createAPI();\n */\nexport function createAPI(config?: ValTownAccessorConfig): ValTownAPI {\n return new ValTownAPI(config);\n}\n\n/**\n * Wrap an existing ValTownAccessor in the fluent API.\n *\n * @example\n * import { wrapAccessor } from \"./valtown_api.ts\";\n * const api = wrapAccessor(myExistingAccessor);\n */\nexport function wrapAccessor(accessor: ValTownAccessor): ValTownAPI {\n return new ValTownAPI(accessor);\n}\n\n/** Pre-built default instance — ready to use immediately. */\nexport const api = new ValTownAPI(valTownAccessor);\nexport default api;\n\n// ============================================================\n// USAGE EXAMPLES (run with: deno run -A valtown_api.ts)\n// ============================================================\n\n// ---- 1. Create a val, write a file, read it back ----\n//\n// const result = await api.create(\"hello-world\", {\n// privacy: \"unlisted\",\n// description: \"My first val via the fluent API\",\n// });\n//\n// if (!result.ok) throw result.error;\n//\n// const { builder } = result.data;\n//\n// await builder.createFile(\"notes.md\", { content: \"# Hello\\nWorld!\" });\n//\n// const read = await builder.file(\"notes.md\").read();\n// console.log(read.ok ? read.data : read.error);\n//\n// await builder.delete();\n\n// ---- 2. Find-or-create (idempotent setup) ----\n//\n// const r = await api.findOrCreate(\"my-config\", { privacy: \"private\" });\n// if (r.ok) {\n// console.log(r.data.created ? \"Created fresh\" : \"Found existing\");\n// await r.data.builder.setEnv(\"MY_SECRET\", \"abc123\");\n// }\n\n// ---- 3. Call a deployed HTTP val ----\n//\n// const resp = await api.post(\"https://username-myval.val.run\", { msg: \"hi\" });\n// if (resp.ok && resp.data.ok) console.log(resp.data.json);\n\n// ---- 4. Enumerate all vals and their file counts ----\n//\n// const vals = await api.list();\n// if (vals.ok) {\n// for (const v of vals.data) {\n// const files = await api.val(v.id).listFiles();\n// console.log(v.name, files.ok ? files.data.length : \"error\");\n// }\n// }\n\n// ---- 5. Smoke-test everything ----\n//\n// const test = await api.smokeTest();\n// console.log(test.ok ? test.data : test.error.message);",[138],"pulls","branches",1,"forks","envVars",{"_153":61,"_155":61},"connections",{"_153":61,"_154":61},"count","unfilledCount","emptyCount",{"_43":137,"_32":138,"_30":139,"_131":-5,"_41":42,"_40":140,"_132":25,"_38":162,"_13":134,"_33":142,"_35":143,"_24":25,"_135":-5,"_159":163,"_27":164},{"_43":130,"_32":28,"_30":31,"_131":-5,"_41":42,"_40":14,"_132":25,"_38":158,"_13":134,"_33":34,"_35":37,"_24":25,"_135":-5,"_159":160,"_27":161},["D",1779384762807],"children",[],[28],["D",1779384566046],[],[138],["D",1779384543359],["D",1789495880338],{"_98":97,"_105":101},{"_98":97,"_99":-5,"_100":101,"_18":55,"_102":103,"_104":25},{"_13":87,"_32":88,"_43":42,"_89":44,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":45,"_96":97},"ctx",{"_80":-5,"_125":203,"_204":205,"_206":207,"_208":25,"_209":25,"_210":25,"_211":123,"_212":-5,"_213":-7,"_214":-7,"_215":61,"_216":25,"_217":25,"_218":-5,"_219":25,"_220":25,"_221":25,"_222":-5},"ENV",{"_174":175,"_176":177,"_178":88,"_179":180,"_181":182,"_183":184,"_185":186,"_187":188,"_189":190,"_191":192,"_193":194,"_195":196,"_197":198,"_199":200,"_201":202},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","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 · v6