[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_188":189,"_190":191},"routes/_app.x.$handle.$name",{"_99":98,"_33":50,"_107":89,"_28":108,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_21":-5,"_119":-5,"_120":-5,"_121":27,"_122":123,"_124":27,"_125":-5,"_126":-5,"_127":128},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_48":49,"_33":50,"_38":51,"_52":-5,"_53":27,"_54":55,"_56":55,"_57":-5,"_58":-5,"_18":59,"_60":-5,"_61":27,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":-5,"_69":-5,"_70":-5,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":82,"_83":84,"_85":86,"_87":27},"version",263,"changes",[19,20],"aiChatInfo","userId",{"_21":43,"_23":-7,"_24":25,"_26":27,"_28":44,"_30":44},{"_21":22,"_23":-7,"_24":25,"_26":27,"_28":29,"_30":29},"file",{"_31":32,"_33":34,"_35":21,"_36":37,"_38":39,"_40":14,"_41":42,"_24":27},"previous","deleted",true,"deletedHere",false,"path","output/html1.html","latestPath","fileId","eabce07e-2fcc-11f1-95f5-42dde27851f2","name","html1.html","fileType","content","\nMy First Post

Hello World

This is bold and this is italic.

Item 1
Item 2

","createdAt",["D",1775269258318],"branchVersion","branchId","2d45cc28-2fa3-11f1-b40f-42dde27851f2",{"_31":45,"_33":44,"_35":46,"_36":-5,"_38":47,"_40":14,"_41":42,"_24":27},"output","b559eb8c-1bc1-4ccf-961f-851db8cce272","directory",["D",1775269258318],"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",{"_99":98,"_106":102},"org",{"_99":98,"_100":-5,"_101":102,"_18":59,"_103":104,"_105":27},"branch",{"_13":88,"_33":89,"_48":42,"_90":49,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":50,"_97":98},"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",{"_48":49,"_33":50,"_38":184,"_52":-5,"_53":27,"_54":55,"_56":55,"_57":-5,"_58":-5,"_18":59,"_60":-5,"_61":27,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":-5,"_69":-5,"_70":-5,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":185,"_83":186,"_85":187,"_87":27},"tree",[166,168,169],"files",[166,167,168,169],"counts",{"_156":154,"_157":65,"_158":154,"_159":160,"_161":162},"contents",[129,130,131],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_48":152,"_33":44,"_31":45,"_135":-5,"_41":42,"_40":14,"_137":27,"_38":153,"_13":154,"_35":46,"_36":-5,"_24":27,"_142":-5,"_28":155},{"_48":144,"_33":145,"_31":146,"_135":-5,"_41":42,"_40":147,"_137":25,"_38":148,"_13":149,"_35":21,"_36":150,"_24":27,"_142":-5,"_28":151},{"_48":132,"_33":133,"_31":134,"_135":-5,"_41":42,"_40":136,"_137":27,"_38":138,"_13":139,"_35":140,"_36":141,"_24":27,"_142":-5,"_28":143},"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",[133],"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```",[145],"eabd02f2-2fcc-11f1-95f5-42dde27851f2",["D",1775269258318],0,[44],"pulls","branches","forks","envVars",{"_163":65,"_165":154},"connections",{"_163":154,"_164":154},"count","unfilledCount","emptyCount",{"_48":152,"_33":44,"_31":45,"_135":-5,"_41":42,"_40":14,"_137":27,"_38":181,"_13":154,"_35":46,"_36":-5,"_24":27,"_142":-5,"_171":182,"_28":183},{"_48":177,"_33":34,"_31":32,"_135":45,"_41":42,"_40":14,"_137":27,"_38":178,"_13":154,"_35":21,"_36":37,"_24":27,"_142":-5,"_171":179,"_28":180},{"_48":144,"_33":145,"_31":146,"_135":-5,"_41":42,"_40":147,"_137":25,"_38":174,"_13":149,"_35":21,"_36":150,"_24":27,"_142":-5,"_171":175,"_28":176},{"_48":132,"_33":133,"_31":134,"_135":-5,"_41":42,"_40":136,"_137":27,"_38":170,"_13":139,"_35":140,"_36":141,"_24":27,"_142":-5,"_171":172,"_28":173},["D",1775269191488],"children",[],[133],["D",1775269199522],[],[145],"eabcdfca-2fcc-11f1-95f5-42dde27851f2",["D",1775269258318],[],[44,34],["D",1775269258318],[167],[44],["D",1775251331086],{"_99":98,"_106":102},{"_99":98,"_100":-5,"_101":102,"_18":59,"_103":104,"_105":27},{"_13":88,"_33":89,"_48":42,"_90":49,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":50,"_97":98},"ctx",{"_81":-5,"_126":221,"_222":223,"_224":225,"_226":27,"_227":27,"_228":27,"_229":25,"_230":-5,"_231":-7,"_232":-7,"_233":154,"_234":27,"_235":27,"_236":-5,"_237":27,"_238":27,"_239":27,"_240":-5},"ENV",{"_192":193,"_194":195,"_196":89,"_197":198,"_199":200,"_201":202,"_203":204,"_205":206,"_207":208,"_209":210,"_211":212,"_213":214,"_215":216,"_217":218,"_219":220},"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 · v263