[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_155":156,"_157":158},"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":25,"_123":-5,"_124":-5,"_125":126},"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",2,"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","main.ts","latestPath","fileId","8fc70724-553a-11f1-97ac-ee650bb23af1","name","fileType","script","content","","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);","createdAt",["D",1779384562214],"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":150,"_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":151,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":152,"_82":153,"_84":154,"_86":25},"tree",[145],"files",[145],"counts",{"_135":61,"_136":132,"_137":61,"_138":139,"_140":141},"contents",[127],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_43":128,"_32":28,"_30":31,"_129":-5,"_41":42,"_40":14,"_130":25,"_38":131,"_13":132,"_33":34,"_35":37,"_24":25,"_133":-5,"_27":134},"9b02d7bc-553a-11f1-ba80-ee650bb23af1","parentId","latest",["D",1779384562214],1,"label",[28],"pulls","branches","forks","envVars",{"_142":61,"_144":61},"connections",{"_142":61,"_143":61},"count","unfilledCount","emptyCount",{"_43":128,"_32":28,"_30":31,"_129":-5,"_41":42,"_40":14,"_130":25,"_38":146,"_13":132,"_33":34,"_35":37,"_24":25,"_133":-5,"_147":148,"_27":149},["D",1779384562214],"children",[],[28],["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,"_124":188,"_189":190,"_191":192,"_193":25,"_194":25,"_195":25,"_196":197,"_198":-5,"_199":-7,"_200":-7,"_201":61,"_202":25,"_203":25,"_204":-5,"_205":25,"_206":25,"_207":25,"_208":-5},"ENV",{"_159":160,"_161":162,"_163":88,"_164":165,"_166":167,"_168":169,"_170":171,"_172":173,"_174":175,"_176":177,"_178":179,"_180":181,"_182":183,"_184":185,"_186":187},"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",true,"preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v2