[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_211":212,"_213":214},"routes/_app.x.$handle.$name",{"_104":103,"_38":51,"_112":94,"_33":59,"_13":14,"_113":-5,"_11":114,"_115":116,"_117":118,"_119":120,"_121":122,"_26":-5,"_123":-5,"_124":-5,"_125":31,"_126":127,"_128":31,"_129":-5,"_130":-5,"_131":132},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":-5},"project",{"_49":50,"_38":51,"_44":52,"_53":-5,"_54":31,"_55":56,"_57":56,"_58":59,"_60":-5,"_19":61,"_62":-5,"_63":31,"_64":-5,"_65":-5,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":-5,"_77":78,"_79":78,"_80":81,"_82":81,"_83":81,"_84":78,"_85":78,"_86":87,"_88":89,"_90":91,"_92":31},"version",32,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","f94033cb-bb4e-496f-a035-f75ed08bb13a","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle",{"_26":27,"_28":29,"_30":31,"_32":31,"_33":34,"_35":34},"file",{"_36":37,"_38":34,"_39":40,"_41":43,"_44":45,"_46":14,"_47":48,"_30":31},"previous",{"_36":37,"_38":34,"_39":40,"_41":42},"deleted",false,"deletedHere","path","main.test.ts","latestPath","fileId","5cd52b5e-6686-11f1-95e2-1607ee4eb77e","name","fileType","script","content","import { assertEquals } from \"jsr:@std/assert\";\nimport { branchKey, branchPrefix, getBranchName } from \"./main.ts\";\n\n// A realistic Val Town entrypoint URL on the `dev` branch.\nconst DEV_ENTRYPOINT =\n \"https://esm.town/v/somebody/myval@42-dev/main.ts\";\n\nfunction withEntrypoint(url: string | undefined, fn: () => T): T {\n const prev = Deno.env.get(\"VALTOWN_ENTRYPOINT\");\n if (url === undefined) Deno.env.delete(\"VALTOWN_ENTRYPOINT\");\n else Deno.env.set(\"VALTOWN_ENTRYPOINT\", url);\n try {\n return fn();\n } finally {\n if (prev === undefined) Deno.env.delete(\"VALTOWN_ENTRYPOINT\");\n else Deno.env.set(\"VALTOWN_ENTRYPOINT\", prev);\n }\n}\n\nDeno.test(\"getBranchName parses the branch from an explicit URL\", () => {\n assertEquals(getBranchName(DEV_ENTRYPOINT), \"dev\");\n assertEquals(\n getBranchName(\"https://esm.town/v/a/b@1-main/main.ts\"),\n \"main\",\n );\n});\n\nDeno.test(\"getBranchName falls back to 'main' when entrypoint is missing\", () => {\n withEntrypoint(undefined, () => {\n assertEquals(getBranchName(), \"main\");\n });\n});\n\nDeno.test(\"getBranchName falls back to 'main' on an unparseable URL\", () => {\n assertEquals(getBranchName(\"not-a-valid-esm-town-url\"), \"main\");\n});\n\nDeno.test(\"branchKey prefixes the key with the current branch namespace\", () => {\n withEntrypoint(DEV_ENTRYPOINT, () => {\n assertEquals(branchKey(\"config\"), \"__branch/dev/config\");\n });\n});\n\nDeno.test(\"branchKey uses 'main' when no entrypoint is set\", () => {\n withEntrypoint(undefined, () => {\n assertEquals(branchKey(\"config\"), \"__branch/main/config\");\n });\n});\n\nDeno.test(\"branchKey handles nested/path-like keys\", () => {\n withEntrypoint(DEV_ENTRYPOINT, () => {\n assertEquals(branchKey(\"users/42/avatar\"), \"__branch/dev/users/42/avatar\");\n });\n});\n\nDeno.test(\"branchKey handles an empty key\", () => {\n withEntrypoint(DEV_ENTRYPOINT, () => {\n assertEquals(branchKey(\"\"), \"__branch/dev/\");\n });\n});\n\nDeno.test(\"branchPrefix with no argument is just the branch namespace\", () => {\n withEntrypoint(DEV_ENTRYPOINT, () => {\n assertEquals(branchPrefix(), \"__branch/dev/\");\n });\n});\n\nDeno.test(\"branchPrefix appends the provided prefix\", () => {\n withEntrypoint(DEV_ENTRYPOINT, () => {\n assertEquals(branchPrefix(\"users/\"), \"__branch/dev/users/\");\n });\n});\n\nDeno.test(\"branchPrefix treats undefined the same as an empty prefix\", () => {\n withEntrypoint(DEV_ENTRYPOINT, () => {\n assertEquals(branchPrefix(undefined), branchPrefix(\"\"));\n });\n});\n\nDeno.test(\"branchKey and branchPrefix agree for the same key\", () => {\n withEntrypoint(DEV_ENTRYPOINT, () => {\n // Listing by a key's exact name should match where that key is stored.\n assertEquals(branchPrefix(\"config\"), branchKey(\"config\"));\n });\n});\n\nDeno.test(\"different branches produce different namespaces\", () => {\n const onMain = withEntrypoint(\n \"https://esm.town/v/a/b@1-main/main.ts\",\n () => branchKey(\"config\"),\n );\n const onDev = withEntrypoint(DEV_ENTRYPOINT, () => branchKey(\"config\"));\n assertEquals(onMain, \"__branch/main/config\");\n assertEquals(onDev, \"__branch/dev/config\");\n // Same logical key, isolated storage.\n assertEquals(onMain === onDev, false);\n});\n","import { assertEquals } from \"jsr:@std/assert\";\nimport { branchKey, branchPrefix, getBranchName } from \"./main.ts\";\n\n// Realistic Val Town entrypoint URLs for two different branches.\nconst DEV = \"https://esm.town/v/somebody/myval@42-dev/main.ts\";\nconst MAIN = \"https://esm.town/v/a/b@1-main/main.ts\";\n\n// Note: `Deno.env.set` is a no-op in the Val Town runtime, so we can't simulate\n// \"the current branch\" by mutating VALTOWN_ENTRYPOINT. Instead, branchKey/\n// branchPrefix accept an explicit `branch` argument, which is what we assert on\n// here. The no-argument path (which reads the live entrypoint) is covered by the\n// \"defaults to the current branch\" cases.\n\nDeno.test(\"getBranchName parses the branch from an explicit URL\", () => {\n assertEquals(getBranchName(DEV), \"dev\");\n assertEquals(getBranchName(MAIN), \"main\");\n});\n\nDeno.test(\"getBranchName falls back to 'main' on an unparseable URL\", () => {\n assertEquals(getBranchName(\"not-a-valid-esm-town-url\"), \"main\");\n});\n\nDeno.test(\"branchKey prefixes the key with the branch namespace\", () => {\n assertEquals(branchKey(\"config\", \"dev\"), \"__branch/dev/config\");\n});\n\nDeno.test(\"branchKey handles nested/path-like keys\", () => {\n assertEquals(branchKey(\"users/42/avatar\", \"dev\"), \"__branch/dev/users/42/avatar\");\n});\n\nDeno.test(\"branchKey handles an empty key\", () => {\n assertEquals(branchKey(\"\", \"dev\"), \"__branch/dev/\");\n});\n\nDeno.test(\"branchKey defaults to the current branch\", () => {\n assertEquals(branchKey(\"config\"), `__branch/${getBranchName()}/config`);\n});\n\nDeno.test(\"branchPrefix with no prefix is just the branch namespace\", () => {\n assertEquals(branchPrefix(undefined, \"dev\"), \"__branch/dev/\");\n});\n\nDeno.test(\"branchPrefix appends the provided prefix\", () => {\n assertEquals(branchPrefix(\"users/\", \"dev\"), \"__branch/dev/users/\");\n});\n\nDeno.test(\"branchPrefix treats undefined the same as an empty prefix\", () => {\n assertEquals(branchPrefix(undefined, \"dev\"), branchPrefix(\"\", \"dev\"));\n});\n\nDeno.test(\"branchPrefix defaults to the current branch\", () => {\n assertEquals(branchPrefix(\"x/\"), `__branch/${getBranchName()}/x/`);\n});\n\nDeno.test(\"branchPrefix(key) matches branchKey(key) for exact lookups\", () => {\n // Listing by a key's exact name should match where that key is stored.\n assertEquals(branchPrefix(\"config\", \"dev\"), branchKey(\"config\", \"dev\"));\n});\n\nDeno.test(\"different branches produce different namespaces\", () => {\n assertEquals(branchKey(\"config\", \"main\"), \"__branch/main/config\");\n assertEquals(branchKey(\"config\", \"dev\"), \"__branch/dev/config\");\n // Same logical key, isolated storage.\n assertEquals(branchKey(\"config\", \"main\") === branchKey(\"config\", \"dev\"), false);\n});\n","createdAt",["D",1781286336275],"branchVersion","branchId","1677ae55-7e70-4179-b0d8-d80988ae5d1a","id","cc66b958-7b54-49d4-b263-e92efc07ebcd","blob-branch",["D",1781281066791],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","","imageUrl","5d1042a9-7b0b-499d-8a72-3a8ac7a4e185","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","5f80108f-7ca4-4327-b77b-089dbe4b5a82","tursoName","cc66b9587b5449d4b263e92efc07ebcd","tursoHostname","cc66b9587b5449d4b263e92efc07ebcd-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789497655664],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_104":103,"_111":107},"org",{"_104":103,"_105":-5,"_106":107,"_19":61,"_108":109,"_110":31},"branch",{"_13":93,"_38":94,"_49":48,"_95":50,"_96":-5,"_97":-5,"_98":-5,"_99":-5,"_100":-5,"_101":51,"_102":103},"isOwned",92,"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",{"_49":50,"_38":51,"_44":206,"_53":-5,"_54":31,"_55":56,"_57":56,"_58":59,"_60":-5,"_19":61,"_62":-5,"_63":31,"_64":-5,"_65":-5,"_66":67,"_68":69,"_70":71,"_72":73,"_74":207,"_76":-5,"_77":78,"_79":78,"_80":81,"_82":81,"_83":81,"_84":78,"_85":78,"_86":208,"_88":209,"_90":210,"_92":31},"tree",[185,186,187,188,189],"files",[185,186,187,188,189],"counts",{"_175":67,"_176":154,"_177":67,"_178":179,"_180":181},"contents",[133,134,135,136,137],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_49":168,"_38":169,"_36":170,"_141":-5,"_47":48,"_46":171,"_143":31,"_44":172,"_13":67,"_39":26,"_41":173,"_30":31,"_147":-5,"_33":174},{"_49":165,"_38":34,"_36":37,"_141":-5,"_47":48,"_46":14,"_143":31,"_44":166,"_13":154,"_39":40,"_41":43,"_30":31,"_147":-5,"_33":167},{"_49":157,"_38":158,"_36":159,"_141":-5,"_47":48,"_46":160,"_143":31,"_44":161,"_13":162,"_39":40,"_41":163,"_30":31,"_147":-5,"_33":164},{"_49":149,"_38":150,"_36":151,"_141":-5,"_47":48,"_46":152,"_143":31,"_44":153,"_13":154,"_39":40,"_41":155,"_30":31,"_147":-5,"_33":156},{"_49":138,"_38":139,"_36":140,"_141":-5,"_47":48,"_46":142,"_143":31,"_44":144,"_13":145,"_39":40,"_41":146,"_30":31,"_147":-5,"_33":148},"5d71b99b-9cc7-4347-8b14-030d76e9d49c","thing.ts","4abc75bc-6686-11f1-825a-1607ee4eb77e","parentId",27,"latest",["D",1781286258871],3,"import { blob } from \"https://esm.town/v/nbbaier/blob-branch/main.ts\";\n\nawait blob.setJSON(\"config\", { theme: \"dark\" });\nconst config = await blob.getJSON(\"config\"); // { theme: \"dark\" }\nconsole.log(config);","label",[139],"6b53dc40-c284-4241-b912-1811c03c31fd","run-tests.ts","656d2e4c-6686-11f1-a917-1607ee4eb77e",31,["D",1781286316740],1,"import { assertEquals } from \"jsr:@std/assert\";\nimport { branchKey, branchPrefix, getBranchName } from \"./main.ts\";\n\nconst DEV = \"https://esm.town/v/somebody/myval@42-dev/main.ts\";\nconst MAIN = \"https://esm.town/v/a/b@1-main/main.ts\";\n\nconst cases: [string, () => void][] = [\n [\"getBranchName parses branch from explicit URL\", () => {\n assertEquals(getBranchName(DEV), \"dev\");\n assertEquals(getBranchName(MAIN), \"main\");\n }],\n [\"getBranchName falls back to 'main' on a bad URL\", () =>\n assertEquals(getBranchName(\"not-a-valid-url\"), \"main\")],\n\n [\"branchKey adds the branch namespace\", () =>\n assertEquals(branchKey(\"config\", \"dev\"), \"__branch/dev/config\")],\n [\"branchKey handles nested/path-like keys\", () =>\n assertEquals(branchKey(\"users/42/avatar\", \"dev\"), \"__branch/dev/users/42/avatar\")],\n [\"branchKey handles an empty key\", () =>\n assertEquals(branchKey(\"\", \"dev\"), \"__branch/dev/\")],\n [\"branchKey defaults to the current branch\", () =>\n assertEquals(branchKey(\"config\"), `__branch/${getBranchName()}/config`)],\n\n [\"branchPrefix with no prefix is just the namespace\", () =>\n assertEquals(branchPrefix(undefined, \"dev\"), \"__branch/dev/\")],\n [\"branchPrefix appends the provided prefix\", () =>\n assertEquals(branchPrefix(\"users/\", \"dev\"), \"__branch/dev/users/\")],\n [\"branchPrefix treats undefined like an empty prefix\", () =>\n assertEquals(branchPrefix(undefined, \"dev\"), branchPrefix(\"\", \"dev\"))],\n [\"branchPrefix defaults to the current branch\", () =>\n assertEquals(branchPrefix(\"x/\"), `__branch/${getBranchName()}/x/`)],\n\n [\"branchPrefix(key) matches branchKey(key) for exact lookups\", () =>\n assertEquals(branchPrefix(\"config\", \"dev\"), branchKey(\"config\", \"dev\"))],\n [\"different branches produce different namespaces\", () => {\n assertEquals(branchKey(\"config\", \"main\"), \"__branch/main/config\");\n assertEquals(branchKey(\"config\", \"dev\"), \"__branch/dev/config\");\n }],\n];\n\nlet pass = 0;\nfor (const [name, fn] of cases) {\n try {\n fn();\n console.log(`✅ ${name}`);\n pass++;\n } catch (e) {\n console.log(`❌ ${name}: ${e instanceof Error ? e.message : e}`);\n }\n}\nconsole.log(`\\n${pass}/${cases.length} passed`);\nif (pass !== cases.length) throw new Error(\"some tests failed\");\n",[150],"67f39807-4c95-40b3-a56b-fb9178c4377f","main.ts","3fe51f74-667a-11f1-bdcd-1607ee4eb77e",30,["D",1781286302404],18,"import { API_URL } from \"https://esm.town/v/std/API_URL\";\nimport { ValTownBlobError } from \"https://esm.town/v/std/ValTownBlobError\";\nimport { ValTownBlobNotFoundError } from \"https://esm.town/v/std/ValTownBlobNotFoundError\";\nimport { parseVal } from \"https://esm.town/v/std/utils/index.ts\";\n\n/**\n * Gets the branch name of a val.\n *\n * @param {string} [val] - The val URL to parse. Defaults to the entrypoint of\n * the val where this function is called (`VALTOWN_ENTRYPOINT`), so calling it\n * with no arguments returns the current branch of the calling val.\n * @returns {string} The branch name.\n */\nexport function getBranchName(val?: string): string {\n const url = val ?? Deno.env.get(\"VALTOWN_ENTRYPOINT\");\n // If there's no entrypoint URL to parse (e.g. running outside the Val Town\n // runtime), fall back to \"main\" rather than throwing.\n if (!url) return \"main\";\n try {\n return parseVal(url).branch;\n } catch {\n return \"main\";\n }\n}\n\n/**\n * Prefixes a blob key with a branch name so that each branch of the calling val\n * gets its own isolated blob namespace.\n *\n * @param {string} key - The caller-facing blob key.\n * @param {string} [branch] - Branch to namespace under. Defaults to the current\n * branch (`getBranchName()`). Pass an explicit value mainly for testing.\n * @example branchKey(\"config\") // => \"__branch//config\"\n * @example branchKey(\"config\", \"dev\") // => \"__branch/dev/config\"\n */\nexport function branchKey(key: string, branch: string = getBranchName()): string {\n return `__branch/${branch}/${key}`;\n}\n\n/**\n * Prefixes a list filter with a branch namespace.\n *\n * @param {string} [prefix] - The caller-facing prefix to filter by.\n * @param {string} [branch] - Branch to namespace under. Defaults to the current\n * branch (`getBranchName()`). Pass an explicit value mainly for testing.\n * @example branchPrefix() // => \"__branch//\"\n * @example branchPrefix(\"user/\", \"dev\") // => \"__branch/dev/user/\"\n */\nexport function branchPrefix(\n prefix?: string,\n branch: string = getBranchName(),\n): string {\n return `__branch/${branch}/${prefix ?? \"\"}`;\n}\n\n/**\n * Provides functions for interacting with the project-scoped blob storage.\n * Blobs can store any data type (text, JSON, images, etc.) and allow\n * retrieval across different vals using the same key.\n * ([Docs ↗](https://docs.val.town/std/blob))\n */\nexport const blob = {\n /**\n * Gets the data of a blob with the given key.\n *\n * @param {string} key - The key of the blob to get.\n * @returns {Promise} A promise that resolves with the blob data as a Response object.\n * @throws {ValTownBlobNotFoundError} If the blob is not found.\n * @throws {ValTownBlobError} If an error occurs while getting the blob data.\n */\n get: get,\n\n /**\n * Sets the data of a blob with the given key.\n *\n * @param {string} key - The key of the blob to set.\n * @param {BodyInit} value - The data to set for the blob.\n * @throws {ValTownBlobError} If an error occurs while setting the blob data.\n */\n set: set,\n\n /**\n * Copies the data of a blob from one key to another.\n *\n * @param {string} previous - The key of the blob to copy from.\n * @param {string} next - The key of the blob to copy to.\n */\n copy: copy,\n\n /**\n * Moves the data of a blob from one key to another by copying and then deleting the original.\n *\n * @param {string} previous - The key of the blob to move from.\n * @param {string} next - The key of the blob to move to.\n */\n move: move,\n\n /**\n * Lists blobs with an optional prefix filter.\n *\n * @param {string} [prefix] - The prefix to filter the blobs by.\n * @returns {Promise<{ key: string; size: number; lastModified: string }[]>} A promise that resolves with an array of blob metadata.\n */\n list: list,\n\n /**\n * Deletes a blob with the given key.\n *\n * @param {string} key - The key of the blob to delete.\n * @throws {ValTownBlobError} If an error occurs while deleting the blob.\n */\n delete: delete_,\n\n /**\n * Gets the JSON data of a blob with the given key.\n *\n * @param {string} key - The key of the blob to get.\n * @returns {Promise} A promise that resolves with the JSON data of the blob, or undefined if the blob is not found.\n * @throws {ValTownBlobError} If an error occurs while getting the blob data.\n */\n getJSON: getJSON,\n\n /**\n * Sets the JSON data of a blob with the given key.\n *\n * @param {string} key - The key of the blob to set.\n * @param {any} value - The JSON data to set for the blob.\n * @throws {ValTownBlobError} If an error occurs while setting the blob data.\n */\n setJSON: setJSON,\n};\n\nconst BASE = `${API_URL}/v2/blob`;\n\nasync function list(\n prefix?: string,\n): Promise<{ key: string; size: number; lastModified: string }[]> {\n const querystring = `?prefix=${encodeURIComponent(branchPrefix(prefix))}`;\n const res = await fetch(`${BASE}${querystring}`, {\n headers: {\n Authorization: `Bearer ${Deno.env.get(\"valtown\")}`,\n },\n });\n if (!res.ok) {\n const body = await res.text();\n throw new ValTownBlobError(body ? body : \"Error listing blobs\");\n }\n const blobs = await res.json() as {\n key: string;\n size: number;\n lastModified: string;\n }[];\n // Strip the internal branch namespace so callers see their original keys.\n const namespace = `__branch/${getBranchName()}/`;\n return blobs.map((b) => ({\n ...b,\n key: b.key.startsWith(namespace) ? b.key.slice(namespace.length) : b.key,\n }));\n}\n\nasync function delete_(key: string) {\n const res = await fetch(`${BASE}/${encodeURIComponent(branchKey(key))}`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${Deno.env.get(\"valtown\")}`,\n },\n });\n if (!res.ok) {\n const body = await res.text();\n throw new ValTownBlobError(body ? body : \"Error deleting blob\");\n }\n}\n\nasync function get(key: string) {\n const res = await fetch(`${BASE}/${encodeURIComponent(branchKey(key))}`, {\n headers: {\n Authorization: `Bearer ${Deno.env.get(\"valtown\")}`,\n },\n });\n if (res.status === 404) {\n throw new ValTownBlobNotFoundError();\n }\n if (!res.ok) {\n const body = await res.text();\n throw new ValTownBlobError(body ? body : \"Error getting blob data\");\n }\n return res;\n}\n\nasync function set(key: string, value: BodyInit) {\n const res = await fetch(`${BASE}/${encodeURIComponent(branchKey(key))}`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${Deno.env.get(\"valtown\")}`,\n },\n body: value,\n });\n if (!res.ok) {\n const body = await res.text();\n throw new ValTownBlobError(body ? body : \"Error setting blob data\");\n }\n}\n\nasync function copy(previous: string, next: string) {\n const res = await get(previous);\n await set(next, res.body);\n}\n\nasync function move(previous: string, next: string) {\n await copy(previous, next);\n await delete_(previous);\n}\n\nasync function getJSON(key: string): Promise {\n try {\n const res = await get(key);\n return res.json();\n } catch (e) {\n if (e instanceof ValTownBlobNotFoundError) {\n return undefined;\n }\n throw e;\n }\n}\n\nasync function setJSON(key: string, value: any) {\n return await set(key, JSON.stringify(value));\n}",[158],"aa386a78-922a-48c5-858c-5ba9c586f595",["D",1781286336275],[34],"ad32f655-8933-4e7c-9132-c5b2fb0bfec5","README.md","c276b7ee-6685-11f1-94ec-1607ee4eb77e",22,["D",1781286010434],"# blob-branch\n\nA drop-in replacement for Val Town's project-scoped `std/blob` client that\n**automatically isolates blob storage per branch**. Every read and write is\ntransparently namespaced by the branch of the val that calls it, so `main` and\nyour feature branches never see each other's data — with no change to the public\nAPI.\n\n## Why\n\nWhen you fork a branch to experiment, you usually don't want it reading from or\nclobbering the blobs your `main` branch depends on. `blob-branch` solves this by\nprefixing every key with the current branch name behind the scenes.\n\n## Usage\n\n```ts\nimport { blob } from \"https://esm.town/v/nbbaier/blob-branch/main.ts\";\n\nawait blob.setJSON(\"config\", { theme: \"dark\" });\nconst config = await blob.getJSON(\"config\"); // { theme: \"dark\" }\n\nawait blob.list(); // keys are returned un-namespaced\nawait blob.delete(\"config\");\n```\n\nThe API mirrors `std/blob`: `get`, `set`, `getJSON`, `setJSON`, `list`,\n`delete`, `copy`, and `move`.\n\n## How it works\n\n```mermaid\nflowchart LR\n A[\"blob.set('config', …)\"] --> B[\"branchKey('config')\"]\n B --> C[\"getBranchName()\"]\n C --> D[\"parseVal()
(VALTOWN_ENTRYPOINT)\"]\n D --> E[\"branch = 'main'\"]\n E --> F[\"__branch/main/config\"]\n F --> G[\"/v2/blob API\"]\n```\n\n- `getBranchName(val?)` parses a val URL and returns its branch. With no\n argument it defaults to `VALTOWN_ENTRYPOINT` — the val currently executing —\n so it reports the branch of **whatever val calls a blob function**.\n- Keys are stored under `__branch//`.\n- `list()` filters by the branch prefix and strips the namespace off returned\n keys, so callers always see their original key names.\n- `copy`, `move`, `getJSON`, and `setJSON` build on the core functions, so they\n inherit branch-awareness automatically.\n\n### Example: same key, different data per branch\n\n| Branch | Call | Raw stored key |\n| ------- | --------------------------- | ----------------------------- |\n| `main` | `blob.set(\"config\", …)` | `__branch/main/config` |\n| `dev` | `blob.set(\"config\", …)` | `__branch/dev/config` |\n\nThe two writes never collide.\n\n## API\n\n| Function | Description |\n| ------------------------- | ----------------------------------------------------- |\n| `getBranchName(val?)` | Branch of the given val URL, or the current val. |\n| `blob.get(key)` | Get a blob as a `Response`. |\n| `blob.set(key, value)` | Store a blob (`BodyInit`). |\n| `blob.getJSON(key)` | Get and parse JSON, or `undefined` if not found. |\n| `blob.setJSON(key, val)` | Store a value as JSON. |\n| `blob.list(prefix?)` | List blob metadata for the current branch. |\n| `blob.delete(key)` | Delete a blob. |\n| `blob.copy(prev, next)` | Copy a blob to a new key. |\n| `blob.move(prev, next)` | Copy then delete the original. |\n\n## Caveats\n\n- **Existing data isn't migrated.** Blobs written before adopting this client\n live at their old un-prefixed keys and won't be visible through the branched\n API. Migrate them under `__branch//` if you need them.\n- The reserved prefix is `__branch/`. Avoid storing your own keys there.\n",[169],"pulls","branches","forks","envVars",{"_182":67,"_184":67},"connections",{"_182":67,"_183":67},"count","unfilledCount","emptyCount",{"_49":168,"_38":169,"_36":170,"_141":-5,"_47":48,"_46":171,"_143":31,"_44":203,"_13":67,"_39":26,"_41":173,"_30":31,"_147":-5,"_191":204,"_33":205},{"_49":165,"_38":34,"_36":37,"_141":-5,"_47":48,"_46":14,"_143":31,"_44":200,"_13":154,"_39":40,"_41":43,"_30":31,"_147":-5,"_191":201,"_33":202},{"_49":157,"_38":158,"_36":159,"_141":-5,"_47":48,"_46":160,"_143":31,"_44":197,"_13":162,"_39":40,"_41":163,"_30":31,"_147":-5,"_191":198,"_33":199},{"_49":149,"_38":150,"_36":151,"_141":-5,"_47":48,"_46":152,"_143":31,"_44":194,"_13":154,"_39":40,"_41":155,"_30":31,"_147":-5,"_191":195,"_33":196},{"_49":138,"_38":139,"_36":140,"_141":-5,"_47":48,"_46":142,"_143":31,"_44":190,"_13":145,"_39":40,"_41":146,"_30":31,"_147":-5,"_191":192,"_33":193},["D",1781286258871],"children",[],[139],["D",1781286316740],[],[150],["D",1781286302404],[],[158],["D",1781286336275],[],[34],["D",1781286010434],[],[169],["D",1781281066791],["D",1789497655664],{"_104":103,"_111":107},{"_104":103,"_105":-5,"_106":107,"_19":61,"_108":109,"_110":31},{"_13":93,"_38":94,"_49":48,"_95":50,"_96":-5,"_97":-5,"_98":-5,"_99":-5,"_100":-5,"_101":51,"_102":103},"ctx",{"_86":-5,"_130":244,"_245":246,"_247":248,"_249":31,"_250":31,"_251":31,"_252":253,"_254":-5,"_255":-7,"_256":-7,"_257":67,"_258":31,"_259":31,"_260":-5,"_261":31,"_262":31,"_263":31,"_264":-5},"ENV",{"_215":216,"_217":218,"_219":94,"_220":221,"_222":223,"_224":225,"_226":227,"_228":229,"_230":231,"_232":233,"_234":235,"_236":237,"_238":239,"_240":241,"_242":243},"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",true,"preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v32