[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_213":214,"_215":216},"routes/_app.x.$handle.$name",{"_94":93,"_32":45,"_102":84,"_27":103,"_13":14,"_104":-5,"_11":105,"_106":107,"_108":109,"_110":111,"_112":113,"_20":-5,"_114":-5,"_115":-5,"_116":25,"_117":118,"_119":25,"_120":-5,"_121":-5,"_122":123},"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":-5,"_53":-5,"_18":54,"_55":-5,"_56":25,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":-5,"_64":-5,"_65":-5,"_66":-5,"_67":68,"_69":68,"_70":71,"_72":71,"_73":71,"_74":68,"_75":68,"_76":77,"_78":79,"_80":81,"_82":25},"version",270,"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","index.ts","latestPath","fileId","2d48f790-2fa3-11f1-b40f-42dde27851f2","name","fileType","script","content","import ValTown from \"npm:@valtown/sdk@latest\";\nimport { parseVal } from \"https://esm.town/v/std/utils/index.ts\";\n\ntype WriteFileParams = {\n valId?: string;\n token?: string;\n callerUrl: string;\n} & ValTown.Vals.Files.FileCreateParams.Variant1;\n\ntype WriteFileResponse =\n | {\n success: boolean;\n action: \"created\" | \"updated\";\n id: string;\n name: string;\n url: string;\n }\n | {\n success: false;\n error: string;\n };\n\nexport async function getId(url: string): Promise {\n const { name, username } = parseVal(url);\n const vt = new ValTown();\n const { id } = await vt.alias.username.valName.retrieve(name, { username });\n return id;\n}\n\nexport async function writeFile(\n params: WriteFileParams,\n): Promise {\n const { valId, token, callerUrl, ...fileParams } = params;\n const id = valId ? valId : await getId(callerUrl);\n const bearerToken = token ? token : Deno.env.get(\"VT_WRITE_TOKEN\");\n const vt = new ValTown({ bearerToken });\n\n try {\n const file = await vt.vals.files.create(id, fileParams);\n return {\n success: true,\n action: \"created\",\n id: file.id,\n name: file.name,\n url: file.links.html,\n };\n } catch (err) {\n if (err instanceof Error && err.message.startsWith(\"409\")) {\n const file = await vt.vals.files.update(id, {\n path: fileParams.path,\n content: fileParams.content,\n type: fileParams.type,\n });\n return {\n success: true,\n action: \"updated\",\n id: file.id,\n name: file.name,\n url: file.links.html,\n };\n } else if (err instanceof Error) {\n return { success: false, error: err.message };\n } else {\n return { success: false, error: \"Unknown error\" };\n }\n }\n}","import ValTown from \"npm:@valtown/sdk@latest\";\nimport { parseVal } from \"https://esm.town/v/std/utils/index.ts\";\n\ntype WriteFileParams = {\n valId?: string;\n token?: string;\n callerUrl: string;\n} & ValTown.Vals.Files.FileCreateParams.Variant1;\n\ntype WriteFileResponse =\n | {\n success: boolean;\n action: \"created\" | \"updated\";\n id: string;\n name: string;\n url: string;\n }\n | {\n success: false;\n error: string;\n };\n\nasync function getId(url: string): Promise {\n const { name, username } = parseVal(url);\n const vt = new ValTown();\n const { id } = await vt.alias.username.valName.retrieve(name, { username });\n return id;\n}\n\nexport async function writeFile(\n params: WriteFileParams,\n): Promise {\n const { valId, token, callerUrl, ...fileParams } = params;\n const id = valId ? valId : await getId(callerUrl);\n console.log(id);\n const bearerToken = token ? token : Deno.env.get(\"VT_WRITE_TOKEN\");\n const vt = new ValTown({ bearerToken });\n\n try {\n const file = await vt.vals.files.create(id, fileParams);\n return {\n success: true,\n action: \"created\",\n id: file.id,\n name: file.name,\n url: file.links.html,\n };\n } catch (err) {\n if (err instanceof Error && err.message.startsWith(\"409\")) {\n const file = await vt.vals.files.update(id, {\n path: fileParams.path,\n content: fileParams.content,\n type: fileParams.type,\n });\n return {\n success: true,\n action: \"updated\",\n id: file.id,\n name: file.name,\n url: file.links.html,\n };\n } else if (err instanceof Error) {\n return { success: false, error: err.message };\n } else {\n return { success: false, error: \"Unknown error\" };\n }\n }\n}\n\nexport default writeFile;","createdAt",["D",1775269544136],"branchVersion","branchId","2d45cc28-2fa3-11f1-b40f-42dde27851f2","id","2d451030-2fa3-11f1-b40f-42dde27851f2","writeFile",["D",1775251331086],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","imageUrl","5d1042a9-7b0b-499d-8a72-3a8ac7a4e185","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",1,"orgId","5f80108f-7ca4-4327-b77b-089dbe4b5a82","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_94":93,"_101":97},"org",{"_94":93,"_95":-5,"_96":97,"_18":54,"_98":99,"_100":25},"branch",{"_13":83,"_32":84,"_43":42,"_85":44,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":-5,"_91":45,"_92":93},"isOwned",287,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","nbbaier","handle","displayName","avatar","https://secure.gravatar.com/avatar/0129a541b7b3574e92c4afd06c5e32da&d=identicon","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":209,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":-5,"_53":-5,"_18":54,"_55":-5,"_56":25,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":-5,"_64":-5,"_65":-5,"_66":-5,"_67":68,"_69":68,"_70":71,"_72":71,"_73":71,"_74":68,"_75":68,"_76":210,"_78":211,"_80":212,"_82":25},"tree",[161,166,167],"files",[161,162,163,164,165,166,167],"counts",{"_151":148,"_152":60,"_153":148,"_154":155,"_156":157},"contents",[124,125,126],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_43":143,"_32":144,"_30":145,"_128":-5,"_41":42,"_40":146,"_129":25,"_38":147,"_13":148,"_33":149,"_35":-5,"_24":25,"_132":-5,"_27":150},{"_43":134,"_32":135,"_30":136,"_128":-5,"_41":42,"_40":137,"_129":138,"_38":139,"_13":140,"_33":20,"_35":141,"_24":25,"_132":-5,"_27":142},{"_43":127,"_32":28,"_30":31,"_128":-5,"_41":42,"_40":14,"_129":25,"_38":130,"_13":131,"_33":34,"_35":37,"_24":25,"_132":-5,"_27":133},"9519640c-2fcd-11f1-a462-42dde27851f2","parentId","latest",["D",1775269544136],163,"label",[28],"c7b18288-2fcc-11f1-a005-42dde27851f2","README.md","2e7f999e-2fb6-11f1-bd04-42dde27851f2",262,true,["D",1775269199522],8,"# writeFile\n\nA utility function for creating or updating files in a Val Town val via the\n[Val Town SDK](https://github.com/val-town/sdk). Handles the create-or-update\npattern automatically — if a file already exists (409 conflict), it falls back\nto updating it.\n\n## Usage\n\n```ts\nimport { writeFile } from \"https://esm.town/v/nbbaier/writeFile/index.ts\";\n\nconst result = await writeFile({\n path: \"hello.txt\",\n content: \"Hello, world!\",\n type: \"file\",\n callerUrl: import.meta.url, // writes to the val that calls this function\n});\n\nconsole.log(result);\n// { success: true, action: \"created\", id: \"...\", name: \"hello.txt\", url: \"...\" }\n```\n\n## Parameters\n\n`writeFile` accepts a single object with the following properties:\n\n| Parameter | Type | Required | Description |\n| ----------- | -------- | -------- | --------------------------------------------------------------------------------- |\n| `path` | `string` | ✅ | File path within the val (e.g. `\"src/utils.ts\"`) |\n| `content` | `string` | ✅ | The file content |\n| `type` | `string` | ✅ | File type (`\"file\"`, `\"http\"`, `\"script\"`, `\"interval\"`, `\"email\"`) |\n| `callerUrl` | `string` | ✅ | Pass `import.meta.url` to target the calling val. |\n| `valId` | `string` | ❌ | Target val ID. Takes precedence over `callerUrl` if both are provided. |\n| `token` | `string` | ❌ | Val Town API bearer token. Defaults to the `VT_WRITE_TOKEN` environment variable. |\n\n## Return Value\n\nOn success:\n\n```ts\n{\n success: true,\n action: \"created\" | \"updated\",\n id: string, // file ID\n name: string, // file name\n url: string, // link to the file on val.town\n}\n```\n\nOn error:\n\n```ts\n{\n success: false,\n error: string, // the error message (or \"unknown error\")\n}\n```\n\n## Authentication\n\nBy default, the function looks for a `VT_WRITE_TOKEN` environment variable. You\nneed a Val Town API token with write permissions. You can also pass a `token`\ndirectly:\n\n```ts\nawait writeFile({\n path: \"data.json\",\n content: JSON.stringify({ key: \"value\" }),\n type: \"file\",\n callerUrl: import.meta.url,\n token: \"your-api-token\",\n});\n```",[135],"eabd02f2-2fcc-11f1-95f5-42dde27851f2","output","b559eb8c-1bc1-4ccf-961f-851db8cce272",263,["D",1775269258318],0,"directory",[144],"pulls","branches","forks","envVars",{"_158":60,"_160":148},"connections",{"_158":148,"_159":148},"count","unfilledCount","emptyCount",{"_43":143,"_32":144,"_30":145,"_128":-5,"_41":42,"_40":146,"_129":25,"_38":206,"_13":148,"_33":149,"_35":-5,"_24":25,"_132":-5,"_169":207,"_27":208},{"_43":199,"_32":200,"_30":201,"_128":145,"_41":42,"_40":146,"_129":25,"_38":202,"_13":148,"_33":20,"_35":203,"_24":25,"_132":-5,"_169":204,"_27":205},{"_43":191,"_32":192,"_30":193,"_128":145,"_41":42,"_40":194,"_129":25,"_38":195,"_13":148,"_33":20,"_35":196,"_24":25,"_132":-5,"_169":197,"_27":198},{"_43":183,"_32":184,"_30":185,"_128":145,"_41":42,"_40":186,"_129":25,"_38":187,"_13":148,"_33":20,"_35":188,"_24":25,"_132":-5,"_169":189,"_27":190},{"_43":175,"_32":176,"_30":177,"_128":145,"_41":42,"_40":178,"_129":25,"_38":179,"_13":148,"_33":20,"_35":180,"_24":25,"_132":-5,"_169":181,"_27":182},{"_43":134,"_32":135,"_30":136,"_128":-5,"_41":42,"_40":137,"_129":138,"_38":172,"_13":140,"_33":20,"_35":141,"_24":25,"_132":-5,"_169":173,"_27":174},{"_43":127,"_32":28,"_30":31,"_128":-5,"_41":42,"_40":14,"_129":25,"_38":168,"_13":131,"_33":34,"_35":37,"_24":25,"_132":-5,"_169":170,"_27":171},["D",1775269544136],"children",[],[28],["D",1775269199522],[],[135],"ead5bd38-2fcc-11f1-a821-42dde27851f2","html4.html","ead5be00-2fcc-11f1-a821-42dde27851f2",266,["D",1775269258479],"\nProps Test

Content.

",[],[144,176],"eacc3376-2fcc-11f1-a821-42dde27851f2","html3.html","eacc3434-2fcc-11f1-a821-42dde27851f2",265,["D",1775269258415],"\n

No Frontmatter

Just plain markdown.

",[],[144,184],"eac3e9a0-2fcc-11f1-95f5-42dde27851f2","html2.html","eac3ea54-2fcc-11f1-95f5-42dde27851f2",264,["D",1775269258363],"\nCustom Layout Test | My Blog

Custom Layout Test

Sat Apr 04 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Some content here.

",[],[144,192],"eabcdfca-2fcc-11f1-95f5-42dde27851f2","html1.html","eabce07e-2fcc-11f1-95f5-42dde27851f2",["D",1775269258318],"\nMy First Post

Hello World

This is bold and this is italic.

Item 1
Item 2

",[],[144,200],["D",1775269258318],[162,163,164,165],[144],["D",1775251331086],{"_94":93,"_101":97},{"_94":93,"_95":-5,"_96":97,"_18":54,"_98":99,"_100":25},{"_13":83,"_32":84,"_43":42,"_85":44,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":-5,"_91":45,"_92":93},"ctx",{"_76":-5,"_121":246,"_247":248,"_249":250,"_251":25,"_252":25,"_253":25,"_254":138,"_255":-5,"_256":-7,"_257":-7,"_258":148,"_259":25,"_260":25,"_261":-5,"_262":25,"_263":25,"_264":25,"_265":-5},"ENV",{"_217":218,"_219":220,"_221":84,"_222":223,"_224":225,"_226":227,"_228":229,"_230":231,"_232":233,"_234":235,"_236":237,"_238":239,"_240":241,"_242":243,"_244":245},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","fdb67791413f4386b4dbf18f354029a617f6160f","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 · v270