[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_169":170,"_171":172},"routes/_app.x.$handle.$name",{"_97":96,"_32":44,"_105":87,"_26":36,"_13":14,"_106":-5,"_11":107,"_108":109,"_110":111,"_112":113,"_114":115,"_20":-5,"_116":-5,"_117":-5,"_118":24,"_119":120,"_121":122,"_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",{"_42":43,"_32":44,"_37":45,"_46":-5,"_47":24,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":-5,"_56":24,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":68,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":80,"_81":82,"_83":84,"_85":24},"version",4,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":29},"file",{"_30":31,"_32":27,"_33":34,"_35":36,"_37":38,"_39":14,"_40":41,"_23":24},"previous","deleted",false,"deletedHere","path","new-file-3014.ts","latestPath","valtown-api.ts","fileId","02ad359c-553b-11f1-9ec1-ee650bb23af1","name","fileType","script","content","","createdAt",["D",1779384736146],"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",{"_97":96,"_104":100},"org",{"_97":96,"_98":-5,"_99":100,"_18":54,"_101":102,"_103":24},"branch",{"_13":86,"_32":87,"_42":41,"_88":43,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":44,"_95":96},"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",{"_42":43,"_32":44,"_37":164,"_46":-5,"_47":24,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":-5,"_56":24,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":165,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":166,"_81":167,"_83":168,"_85":24},"tree",[155,156],"files",[155,156],"counts",{"_144":60,"_145":146,"_147":60,"_148":149,"_150":151},"contents",[127,128],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_42":135,"_32":136,"_30":137,"_130":-5,"_40":41,"_39":138,"_131":24,"_37":139,"_13":140,"_33":141,"_35":142,"_23":24,"_133":-5,"_26":143},{"_42":129,"_32":27,"_30":31,"_130":-5,"_40":41,"_39":14,"_131":24,"_37":132,"_13":60,"_33":34,"_35":36,"_23":24,"_133":-5,"_26":134},"02ad34d4-553b-11f1-9ec1-ee650bb23af1","parentId","latest",["D",1779384736146],"label",[27],"9d4d3fd0-553a-11f1-9174-ee650bb23af1","main.ts","8fc70724-553a-11f1-97ac-ee650bb23af1",3,["D",1779384566046],2,"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);",[136],"pulls","branches",1,"forks","envVars",{"_152":60,"_154":60},"connections",{"_152":60,"_153":60},"count","unfilledCount","emptyCount",{"_42":135,"_32":136,"_30":137,"_130":-5,"_40":41,"_39":138,"_131":24,"_37":161,"_13":140,"_33":141,"_35":142,"_23":24,"_133":-5,"_158":162,"_26":163},{"_42":129,"_32":27,"_30":31,"_130":-5,"_40":41,"_39":14,"_131":24,"_37":157,"_13":60,"_33":34,"_35":36,"_23":24,"_133":-5,"_158":159,"_26":160},["D",1779384736146],"children",[],[27],["D",1779384566046],[],[136],["D",1779384543359],["D",1789495880338],{"_97":96,"_104":100},{"_97":96,"_98":-5,"_99":100,"_18":54,"_101":102,"_103":24},{"_13":86,"_32":87,"_42":41,"_88":43,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":44,"_95":96},"ctx",{"_79":-5,"_124":202,"_203":204,"_205":206,"_207":24,"_208":24,"_209":24,"_210":122,"_211":-5,"_212":-7,"_213":-7,"_214":60,"_215":24,"_216":24,"_217":-5,"_218":24,"_219":24,"_220":24,"_221":-5},"ENV",{"_173":174,"_175":176,"_177":87,"_178":179,"_180":181,"_182":183,"_184":185,"_186":187,"_188":189,"_190":191,"_192":193,"_194":195,"_196":197,"_198":199,"_200":201},"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 · v4