[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_201":202,"_203":204},"routes/_app.x.$handle.$name",{"_125":124,"_36":75,"_133":115,"_31":134,"_13":14,"_135":-5,"_11":136,"_137":138,"_139":140,"_141":142,"_143":144,"_24":-5,"_145":-5,"_146":-5,"_147":79,"_148":149,"_150":79,"_151":-5,"_152":-5,"_153":154},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_73":74,"_36":75,"_41":76,"_77":-5,"_78":79,"_80":81,"_82":81,"_83":-5,"_84":-5,"_18":85,"_86":-5,"_87":79,"_88":-5,"_89":-5,"_90":91,"_92":93,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":99,"_100":99,"_101":102,"_103":102,"_104":102,"_105":99,"_106":99,"_107":108,"_109":110,"_111":112,"_113":79},"version",282,"changes",[19,20,21,22,23],"aiChatInfo","userId",{"_24":67,"_26":68,"_28":29,"_30":29,"_31":69,"_33":69},{"_24":60,"_26":61,"_28":29,"_30":29,"_31":62,"_33":62},{"_24":53,"_26":54,"_28":29,"_30":29,"_31":55,"_33":55},{"_24":46,"_26":47,"_28":29,"_30":29,"_31":48,"_33":48},{"_24":25,"_26":27,"_28":29,"_30":29,"_31":32,"_33":32},"file",{"_34":35,"_36":37,"_38":24,"_39":40,"_41":42,"_43":14,"_44":45,"_28":29},"previous",{"_34":35,"_36":37,"_38":24,"_39":40},"deleted",true,"deletedHere","path","output/html4.html","latestPath","fileId","ead5be00-2fcc-11f1-a821-42dde27851f2","name","html4.html","fileType","content","\nProps Test

Content.

","createdAt",["D",1775269922157],"branchVersion","branchId","2d45cc28-2fa3-11f1-b40f-42dde27851f2",{"_34":49,"_36":50,"_38":24,"_39":51,"_41":52,"_43":14,"_44":45,"_28":29},{"_34":49,"_36":50,"_38":24,"_39":51},"output/html3.html","eacc3434-2fcc-11f1-a821-42dde27851f2","html3.html","\n

No Frontmatter

Just plain markdown.

",["D",1775269922157],{"_34":56,"_36":57,"_38":24,"_39":58,"_41":59,"_43":14,"_44":45,"_28":29},{"_34":56,"_36":57,"_38":24,"_39":58},"output/html2.html","eac3ea54-2fcc-11f1-95f5-42dde27851f2","html2.html","\nCustom Layout Test | My Blog

Custom Layout Test

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

Some content here.

",["D",1775269922157],{"_34":63,"_36":64,"_38":24,"_39":65,"_41":66,"_43":14,"_44":45,"_28":29},{"_34":63,"_36":64,"_38":24,"_39":65},"output/html1.html","eabce07e-2fcc-11f1-95f5-42dde27851f2","html1.html","\nMy First Post

Hello World

This is bold and this is italic.

Item 1
Item 2

",["D",1775269922157],{"_34":70,"_36":69,"_38":71,"_39":-5,"_41":72,"_43":14,"_44":45,"_28":29},{"_34":70,"_36":69,"_38":71,"_39":-5},"output","b559eb8c-1bc1-4ccf-961f-851db8cce272","directory",["D",1775269922157],"id","2d451030-2fa3-11f1-b40f-42dde27851f2","writeFile",["D",1775251331086],"deletedAt","legacyEnvVars",false,"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",{"_125":124,"_132":128},"org",{"_125":124,"_126":-5,"_127":128,"_18":85,"_129":130,"_131":79},"branch",{"_13":114,"_36":115,"_73":45,"_116":74,"_117":-5,"_118":-5,"_119":-5,"_120":-5,"_121":-5,"_122":75,"_123":124},"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",{"_73":74,"_36":75,"_41":197,"_77":-5,"_78":79,"_80":81,"_82":81,"_83":-5,"_84":-5,"_18":85,"_86":-5,"_87":79,"_88":-5,"_89":-5,"_90":91,"_92":93,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":99,"_100":99,"_101":102,"_103":102,"_104":102,"_105":99,"_106":99,"_107":198,"_109":199,"_111":200,"_113":79},"tree",[188,189],"files",[188,189],"counts",{"_177":178,"_179":91,"_180":178,"_181":182,"_183":184},"contents",[155,156],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_73":169,"_36":170,"_34":171,"_160":-5,"_44":45,"_43":172,"_162":29,"_41":173,"_13":174,"_38":24,"_39":175,"_28":79,"_167":-5,"_31":176},{"_73":157,"_36":158,"_34":159,"_160":-5,"_44":45,"_43":161,"_162":79,"_41":163,"_13":164,"_38":165,"_39":166,"_28":79,"_167":-5,"_31":168},"6bd1af9a-2fce-11f1-b2b1-42dde27851f2","index.ts","2d48f790-2fa3-11f1-b40f-42dde27851f2","parentId",281,"latest",["D",1775269904375],174,"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\nexport async function getId(url: string): Promise {\n const { name, username } = parseVal(url);\n console.log(`[getId] name: ${name}, username: ${username}`);\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(`[writeFile] id: ${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;","label",[158],"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```",[170],"pulls",0,"branches","forks","envVars",{"_185":91,"_187":178},"connections",{"_185":178,"_186":178},"count","unfilledCount","emptyCount",{"_73":169,"_36":170,"_34":171,"_160":-5,"_44":45,"_43":172,"_162":29,"_41":194,"_13":174,"_38":24,"_39":175,"_28":79,"_167":-5,"_191":195,"_31":196},{"_73":157,"_36":158,"_34":159,"_160":-5,"_44":45,"_43":161,"_162":79,"_41":190,"_13":164,"_38":165,"_39":166,"_28":79,"_167":-5,"_191":192,"_31":193},["D",1775269904375],"children",[],[158],["D",1775269199522],[],[170],["D",1775251331086],{"_125":124,"_132":128},{"_125":124,"_126":-5,"_127":128,"_18":85,"_129":130,"_131":79},{"_13":114,"_36":115,"_73":45,"_116":74,"_117":-5,"_118":-5,"_119":-5,"_120":-5,"_121":-5,"_122":75,"_123":124},"ctx",{"_107":-5,"_152":234,"_235":236,"_237":238,"_239":79,"_240":79,"_241":79,"_242":29,"_243":-5,"_244":-7,"_245":-7,"_246":178,"_247":79,"_248":79,"_249":-5,"_250":79,"_251":79,"_252":79,"_253":-5},"ENV",{"_205":206,"_207":208,"_209":115,"_210":211,"_212":213,"_214":215,"_216":217,"_218":219,"_220":221,"_222":223,"_224":225,"_226":227,"_228":229,"_230":231,"_232":233},"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 · v282