[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_203":204,"_205":206},"routes/_app.x.$handle.$name",{"_93":92,"_32":44,"_101":83,"_27":102,"_13":14,"_103":-5,"_11":104,"_105":106,"_107":108,"_109":110,"_111":112,"_20":-5,"_113":-5,"_114":-5,"_115":26,"_116":117,"_118":26,"_119":-5,"_120":-5,"_121":122},"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":26,"_48":49,"_50":49,"_51":-5,"_52":-5,"_18":53,"_54":-5,"_55":26,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":-5,"_65":-5,"_66":67,"_68":67,"_69":70,"_71":70,"_72":70,"_73":67,"_74":67,"_75":76,"_77":78,"_79":80,"_81":26},"version",265,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":26,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":20,"_35":36,"_37":38,"_39":14,"_40":41,"_23":26},"previous","deleted",true,"deletedHere",false,"path","output/html3.html","latestPath","fileId","eacc3434-2fcc-11f1-a821-42dde27851f2","name","html3.html","fileType","content","\n

No Frontmatter

Just plain markdown.

","createdAt",["D",1775269258415],"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",{"_93":92,"_100":96},"org",{"_93":92,"_94":-5,"_95":96,"_18":53,"_97":98,"_99":26},"branch",{"_13":82,"_32":83,"_42":41,"_84":43,"_85":-5,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":44,"_91":92},"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",{"_42":43,"_32":44,"_37":199,"_46":-5,"_47":26,"_48":49,"_50":49,"_51":-5,"_52":-5,"_18":53,"_54":-5,"_55":26,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":-5,"_65":-5,"_66":67,"_68":67,"_69":70,"_71":70,"_72":70,"_73":67,"_74":67,"_75":200,"_77":201,"_79":202,"_81":26},"tree",[164,168,169],"files",[164,165,166,167,168,169],"counts",{"_154":151,"_155":59,"_156":151,"_157":158,"_159":160},"contents",[123,124,125],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_42":146,"_32":147,"_30":148,"_129":-5,"_40":41,"_39":149,"_131":26,"_37":150,"_13":151,"_34":152,"_35":-5,"_23":26,"_136":-5,"_27":153},{"_42":138,"_32":139,"_30":140,"_129":-5,"_40":41,"_39":141,"_131":24,"_37":142,"_13":143,"_34":20,"_35":144,"_23":26,"_136":-5,"_27":145},{"_42":126,"_32":127,"_30":128,"_129":-5,"_40":41,"_39":130,"_131":26,"_37":132,"_13":133,"_34":134,"_35":135,"_23":26,"_136":-5,"_27":137},"c2e7ba06-2fcc-11f1-a005-42dde27851f2","index.ts","2d48f790-2fa3-11f1-b40f-42dde27851f2","parentId",260,"latest",["D",1775269191488],159,"script","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 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;","label",[127],"c7b18288-2fcc-11f1-a005-42dde27851f2","README.md","2e7f999e-2fb6-11f1-bd04-42dde27851f2",262,["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```",[139],"eabd02f2-2fcc-11f1-95f5-42dde27851f2","output","b559eb8c-1bc1-4ccf-961f-851db8cce272",263,["D",1775269258318],0,"directory",[147],"pulls","branches","forks","envVars",{"_161":59,"_163":151},"connections",{"_161":151,"_162":151},"count","unfilledCount","emptyCount",{"_42":146,"_32":147,"_30":148,"_129":-5,"_40":41,"_39":149,"_131":26,"_37":196,"_13":151,"_34":152,"_35":-5,"_23":26,"_136":-5,"_171":197,"_27":198},{"_42":189,"_32":190,"_30":191,"_129":148,"_40":41,"_39":149,"_131":26,"_37":192,"_13":151,"_34":20,"_35":193,"_23":26,"_136":-5,"_171":194,"_27":195},{"_42":181,"_32":182,"_30":183,"_129":148,"_40":41,"_39":184,"_131":26,"_37":185,"_13":151,"_34":20,"_35":186,"_23":26,"_136":-5,"_171":187,"_27":188},{"_42":177,"_32":33,"_30":31,"_129":148,"_40":41,"_39":14,"_131":26,"_37":178,"_13":151,"_34":20,"_35":36,"_23":26,"_136":-5,"_171":179,"_27":180},{"_42":138,"_32":139,"_30":140,"_129":-5,"_40":41,"_39":141,"_131":24,"_37":174,"_13":143,"_34":20,"_35":144,"_23":26,"_136":-5,"_171":175,"_27":176},{"_42":126,"_32":127,"_30":128,"_129":-5,"_40":41,"_39":130,"_131":26,"_37":170,"_13":133,"_34":134,"_35":135,"_23":26,"_136":-5,"_171":172,"_27":173},["D",1775269191488],"children",[],[127],["D",1775269199522],[],[139],"eacc3376-2fcc-11f1-a821-42dde27851f2",["D",1775269258415],[],[147,33],"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.

",[],[147,182],"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

",[],[147,190],["D",1775269258318],[165,166,167],[147],["D",1775251331086],{"_93":92,"_100":96},{"_93":92,"_94":-5,"_95":96,"_18":53,"_97":98,"_99":26},{"_13":82,"_32":83,"_42":41,"_84":43,"_85":-5,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":44,"_91":92},"ctx",{"_75":-5,"_120":236,"_237":238,"_239":240,"_241":26,"_242":26,"_243":26,"_244":24,"_245":-5,"_246":-7,"_247":-7,"_248":151,"_249":26,"_250":26,"_251":-5,"_252":26,"_253":26,"_254":26,"_255":-5},"ENV",{"_207":208,"_209":210,"_211":83,"_212":213,"_214":215,"_216":217,"_218":219,"_220":221,"_222":223,"_224":225,"_226":227,"_228":229,"_230":231,"_232":233,"_234":235},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","811aa22498c9b0b5a47e8d778de579cdb990f332","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 · v265