[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_178":179,"_180":181},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_90":-7,"_91":43,"_29":-7,"_92":-5,"_15":93,"_94":95,"_96":97,"_98":99,"_100":101,"_102":-5,"_103":-5,"_104":-5,"_105":38,"_106":107,"_108":38,"_109":-5,"_110":-5,"_111":112},"routes/_app.x.$handle.$name.branches",{"_11":12,"_13":14,"_15":16,"_17":18},"handle","nbbaier","name","blob-branch","project",{"_20":28,"_13":14,"_22":36,"_35":-5,"_37":38,"_39":40,"_41":40,"_42":43,"_44":-5,"_45":46,"_47":-5,"_48":38,"_49":-5,"_50":-5,"_51":52,"_53":54,"_55":56,"_57":58,"_59":60,"_61":-5,"_62":63,"_64":63,"_65":66,"_67":66,"_68":66,"_69":63,"_70":63,"_71":72,"_73":74,"_75":76,"_77":38},"branches",[19],{"_20":21,"_22":23,"_24":25,"_13":26,"_27":28,"_29":30,"_31":-5,"_32":-5,"_33":34,"_35":-5},"id","1677ae55-7e70-4179-b0d8-d80988ae5d1a","createdAt",["D",1781281066805],"updatedAt",["D",1781292185249],"main","projectId","cc66b958-7b54-49d4-b263-e92efc07ebcd","version",92,"forkedBranchId","forkedBranchVersion","lockfileKey","1781288162246-esm.town_v_nbbaier_blob-branch@71-main","deletedAt",["D",1781281066791],"legacyEnvVars",false,"privacy","public","httpPrivacy","description","","imageUrl","userId","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",{"_11":12,"_89":85},"org",{"_11":12,"_83":-5,"_84":85,"_45":46,"_86":87,"_88":38},"branch",{"_29":30,"_13":26,"_20":21,"_27":28,"_31":-5,"_32":-5,"_78":-5,"_79":-5,"_80":-5,"_81":14,"_82":12},"isOwned","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","avatar","https://secure.gravatar.com/avatar/0129a541b7b3574e92c4afd06c5e32da&d=identicon","tier","pro","canRestrictVals","profileImageUrl","branchName","path","adoptOrgId",{"_20":28,"_13":14,"_22":173,"_35":-5,"_37":38,"_39":40,"_41":40,"_42":43,"_44":-5,"_45":46,"_47":-5,"_48":38,"_49":-5,"_50":-5,"_51":52,"_53":54,"_55":56,"_57":58,"_59":174,"_61":-5,"_62":63,"_64":63,"_65":66,"_67":66,"_68":66,"_69":63,"_70":63,"_71":175,"_73":176,"_75":177,"_77":38},"tree",[160,161,162],"files",[160,161,162],"counts",{"_150":52,"_17":151,"_152":52,"_153":154,"_155":156},"contents",[113,114,115],"file","upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_20":143,"_13":144,"_118":145,"_120":-5,"_121":21,"_122":30,"_124":125,"_22":146,"_29":147,"_128":102,"_130":148,"_132":38,"_133":-5,"_91":149},{"_20":135,"_13":136,"_118":137,"_120":-5,"_121":21,"_122":138,"_124":125,"_22":139,"_29":140,"_128":129,"_130":141,"_132":38,"_133":-5,"_91":142},{"_20":116,"_13":117,"_118":119,"_120":-5,"_121":21,"_122":123,"_124":125,"_22":126,"_29":127,"_128":129,"_130":131,"_132":38,"_133":-5,"_91":134},"2a3b0223-83ca-493b-83df-e6a2cf60299f","main.ts","fileId","3fe51f74-667a-11f1-bdcd-1607ee4eb77e","parentId","branchId","branchVersion",84,"latest",true,["D",1781288522116],46,"fileType","script","content","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(\n key: string,\n branch: string = getBranchName(),\n): 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 scoped to the current branch 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: listBranch,\n\n /**\n * Lists blobs scoped to the current branch AND blobs not scoped to any\n * branch, with an optional prefix filter. When the same caller-facing key\n * exists both on the current branch and unscoped, the current-branch blob\n * shadows the unscoped one (matching `get`/`set`/`delete`).\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 listAll: listAll,\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 listBranch(\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\n/** Blob metadata as returned by the list endpoint. */\nexport type BlobMeta = { key: string; size: number; lastModified: string };\n\n/**\n * Partitions a raw, unscoped blob listing into the view `listAll` exposes:\n * blobs scoped to `branch` (with the `__branch//` namespace stripped)\n * plus blobs not scoped to any branch, while excluding blobs that belong to\n * *other* branches. On a key collision the current branch shadows the unscoped\n * blob, so the result only contains keys `get` would actually resolve. An\n * optional `prefix` filters on the caller-facing (stripped) key.\n *\n * Pure and synchronous so it can be unit-tested without the network.\n *\n * @param {BlobMeta[]} blobs - Raw listing (keys as stored, namespaces intact).\n * @param {string} branch - The branch to treat as current.\n * @param {string} [prefix] - Optional caller-facing prefix filter.\n */\nexport function partitionAll(\n blobs: BlobMeta[],\n branch: string,\n prefix?: string,\n): BlobMeta[] {\n const namespace = `__branch/${branch}/`;\n const BRANCH_ROOT = \"__branch/\";\n const matchesPrefix = (key: string) => !prefix || key.startsWith(prefix);\n const result: BlobMeta[] = [];\n\n // First pass: collect blobs scoped to the current branch, stripping the\n // namespace so callers see their original key. Record those keys so they can\n // shadow same-named unscoped blobs below.\n const branchKeys = new Set();\n for (const b of blobs) {\n if (!b.key.startsWith(namespace)) continue;\n const key = b.key.slice(namespace.length);\n branchKeys.add(key);\n if (matchesPrefix(key)) result.push({ ...b, key });\n }\n\n // Second pass: add unscoped blobs (no `__branch/` prefix at all), but let a\n // current-branch blob of the same name win the collision. `get`/`set`/\n // `delete` all operate on the branch-scoped key, so the listing has to agree\n // with what those would actually resolve.\n for (const b of blobs) {\n if (b.key.startsWith(BRANCH_ROOT)) continue; // scoped to some branch\n if (branchKeys.has(b.key)) continue; // shadowed by the current branch\n if (matchesPrefix(b.key)) result.push(b);\n }\n\n return result;\n}\n\n/**\n * Lists blobs scoped to the current branch AND blobs not scoped to any branch.\n * May include a prefix filter. On a key collision (a key present both on the\n * current branch and unscoped), the current-branch blob shadows the unscoped\n * one, so the listing agrees with what `get` would resolve.\n *\n * @param {string} [prefix] - The prefix to filter the blobs by.\n * @returns {Promise} A promise that resolves with an array of blob metadata.\n */\nasync function listAll(prefix?: string): Promise {\n // The blob API only filters by a single raw-key prefix, but we need to merge\n // two disjoint key shapes: blobs scoped to the current branch\n // (`__branch//...`) and blobs not scoped to any branch. No single\n // prefix captures both, so list everything once and partition client-side.\n const blobs = await _list();\n return partitionAll(blobs, getBranchName(), prefix);\n}\n\nasync function _list(\n prefix?: string,\n): Promise<{ key: string; size: number; lastModified: string }[]> {\n const querystring = prefix ? `?prefix=${encodeURIComponent(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 return res.json();\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 // `Response.body` is nullable (e.g. an empty blob), so fall back to an empty\n // body to always pass a valid BodyInit.\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}","deleted","label",[117],"b87a0af3-678a-4215-b5c6-200c9f4b541a","main.test.ts","5cd52b5e-6686-11f1-95e2-1607ee4eb77e",81,["D",1781288344716],7,"import { assertEquals } from \"jsr:@std/assert\";\nimport {\n branchKey,\n branchPrefix,\n type BlobMeta,\n getBranchName,\n partitionAll,\n} 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(\n branchKey(\"users/42/avatar\", \"dev\"),\n \"__branch/dev/users/42/avatar\",\n );\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(\n branchKey(\"config\", \"main\") === branchKey(\"config\", \"dev\"),\n false,\n );\n});\n\n// ── Slash-namespaced keys (e.g. \"config/user\", \"config/global\") ─────────────\n\nDeno.test(\"slash-namespaced keys are preserved verbatim after the branch\", () => {\n assertEquals(branchKey(\"config/user\", \"dev\"), \"__branch/dev/config/user\");\n assertEquals(branchKey(\"config/global\", \"dev\"), \"__branch/dev/config/global\");\n});\n\nDeno.test(\"a key prefix filters only that namespace\", () => {\n // Listing \"config/\" on dev targets exactly the config/* keys for that branch.\n assertEquals(branchPrefix(\"config/\", \"dev\"), \"__branch/dev/config/\");\n assertEquals(\n branchKey(\"config/user\", \"dev\").startsWith(branchPrefix(\"config/\", \"dev\")),\n true,\n );\n assertEquals(\n branchKey(\"configuration\", \"dev\").startsWith(\n branchPrefix(\"config/\", \"dev\"),\n ),\n false,\n );\n});\n// ── partitionAll: the pure core of blob.listAll ────────────────────────────\n// listAll itself hits the network; partitionAll is the extracted, synchronous\n// filtering/shadowing step, so these cover the actual decision logic.\n\nconst meta = (key: string, size = key.length): BlobMeta => ({\n key,\n size,\n lastModified: \"2026-01-01T00:00:00.000Z\",\n});\n\n// Sorted keys, so assertions don't depend on result ordering (not part of the\n// contract — only membership and collision resolution are).\nconst keys = (blobs: BlobMeta[]) => blobs.map((b) => b.key).sort();\n\nDeno.test(\"partitionAll strips the current-branch namespace and keeps unscoped blobs\", () => {\n const out = partitionAll([meta(\"__branch/main/a\"), meta(\"b\")], \"main\");\n assertEquals(keys(out), [\"a\", \"b\"]);\n});\n\nDeno.test(\"partitionAll excludes blobs from other branches\", () => {\n const out = partitionAll(\n [meta(\"__branch/main/a\"), meta(\"__branch/dev/a\"), meta(\"legacy\")],\n \"main\",\n );\n assertEquals(keys(out), [\"a\", \"legacy\"]);\n});\n\nDeno.test(\"partitionAll: current branch shadows a same-named unscoped blob\", () => {\n // Distinct sizes let us prove which record survived the collision.\n const out = partitionAll(\n [meta(\"__branch/main/config\", 1), meta(\"config\", 99)],\n \"main\",\n );\n assertEquals(out.length, 1);\n assertEquals(out[0].key, \"config\");\n assertEquals(out[0].size, 1); // the branch-scoped blob won\n});\n\nDeno.test(\"partitionAll: shadowing holds regardless of input order\", () => {\n const out = partitionAll(\n [meta(\"config\", 99), meta(\"__branch/main/config\", 1)],\n \"main\",\n );\n assertEquals(out.length, 1);\n assertEquals(out[0].size, 1); // still the branch-scoped blob\n});\n\nDeno.test(\"partitionAll: an unscoped blob only collides within its own branch\", () => {\n // dev has \"a\", but the current branch (main) doesn't — so the unscoped \"a\"\n // is NOT shadowed and is returned as-is.\n const out = partitionAll([meta(\"__branch/dev/a\"), meta(\"a\", 7)], \"main\");\n assertEquals(keys(out), [\"a\"]);\n assertEquals(out[0].size, 7); // the unscoped record\n});\n\nDeno.test(\"partitionAll: prefix filters on the caller-facing key\", () => {\n const out = partitionAll(\n [\n meta(\"__branch/main/user/1\"), // branch, matches after strip\n meta(\"__branch/main/post/1\"), // branch, no match\n meta(\"user/2\"), // unscoped, matches\n meta(\"post/2\"), // unscoped, no match\n ],\n \"main\",\n \"user/\",\n );\n assertEquals(keys(out), [\"user/1\", \"user/2\"]);\n});\n\nDeno.test(\"partitionAll: a __branch/ prefix matches nothing (namespace is internal)\", () => {\n // Branch keys are stripped before filtering and other-branch keys are\n // excluded, so the reserved namespace is never caller-visible.\n const out = partitionAll(\n [meta(\"__branch/main/a\"), meta(\"__branch/dev/b\"), meta(\"c\")],\n \"main\",\n \"__branch/\",\n );\n assertEquals(out, []);\n});\n\nDeno.test(\"partitionAll: empty input yields empty output\", () => {\n assertEquals(partitionAll([], \"main\"), []);\n});\n\nDeno.test(\"partitionAll: only other-branch blobs yields empty output\", () => {\n assertEquals(\n partitionAll([meta(\"__branch/dev/a\"), meta(\"__branch/feat/b\")], \"main\"),\n [],\n );\n});\n",[136],"9ff57eb9-7c58-4d1b-a3bd-14a51c7d2818","README.md","c276b7ee-6685-11f1-94ec-1607ee4eb77e",["D",1781292185249],16,"# 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 for THIS branch, un-namespaced\nawait blob.listAll(); // this branch + unscoped (legacy) blobs\nawait blob.delete(\"config\");\n```\n\nThe API mirrors `std/blob` — `get`, `set`, `getJSON`, `setJSON`, `list`,\n`delete`, `copy`, and `move` — and adds `listAll`, which also surfaces blobs\nthat aren't namespaced to any branch (see below).\n\n- `list()` filters by the branch prefix and strips the namespace off returned\n keys, so callers always see their original key names.\n- `listAll()` additionally returns blobs that have no `__branch/` prefix at all\n (e.g. data written before adopting this client, or by a plain `std/blob`\n caller). Blobs belonging to _other_ branches are excluded. On a key collision,\n the current branch wins — `listAll` only ever shows the key `get` would\n actually resolve.\n- `copy`, `move`, `getJSON`, and `setJSON` bu``ild on the core functions, so\n they 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.listAll(prefix?)` | List current-branch blobs **plus** unscoped blobs. |\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## Key namespacing\n\n**Slash-namespaced keys** (e.g. `config/user`, `config/global`) work exactly as\nyou'd expect. Keys are opaque to the store, so they're stored verbatim after the\nbranch (`__branch//config/user`), and `blob.list(\"config/\")` filters to\njust that namespace. Branch names are always a single segment (no slashes), so\nthe `__branch//` boundary is unambiguous.\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 `list` (which\n is branch-scoped). Use `listAll()` to discover them, then migrate them under\n `__branch//` if a branch should own them. Note that `listAll` keeps\n surfacing unscoped blobs until they're migrated or deleted.\n- The reserved prefix is `__branch/`. Avoid storing your own keys there.",[144],"pulls",1,"forks","envVars",{"_157":52,"_159":52},"connections",{"_157":52,"_158":52},"count","unfilledCount","emptyCount",{"_20":143,"_13":144,"_118":145,"_120":-5,"_121":21,"_122":30,"_124":125,"_22":170,"_29":147,"_128":102,"_130":148,"_132":38,"_133":-5,"_164":171,"_91":172},{"_20":135,"_13":136,"_118":137,"_120":-5,"_121":21,"_122":138,"_124":125,"_22":167,"_29":140,"_128":129,"_130":141,"_132":38,"_133":-5,"_164":168,"_91":169},{"_20":116,"_13":117,"_118":119,"_120":-5,"_121":21,"_122":123,"_124":125,"_22":163,"_29":127,"_128":129,"_130":131,"_132":38,"_133":-5,"_164":165,"_91":166},["D",1781288522116],"children",[],[117],["D",1781288344716],[],[136],["D",1781292185249],[],[144],["D",1781281066791],["D",1789497655664],{"_11":12,"_89":85},{"_11":12,"_83":-5,"_84":85,"_45":46,"_86":87,"_88":38},{"_29":30,"_13":26,"_20":21,"_27":28,"_31":-5,"_32":-5,"_78":-5,"_79":-5,"_80":-5,"_81":14,"_82":12},"ctx",{"_71":-5,"_110":211,"_212":213,"_214":215,"_216":38,"_217":38,"_218":38,"_219":125,"_220":-5,"_221":-7,"_222":-7,"_223":52,"_224":38,"_225":38,"_226":-5,"_227":38,"_228":38,"_229":38,"_230":-5},"ENV",{"_182":183,"_184":185,"_186":26,"_187":188,"_189":190,"_191":192,"_193":194,"_195":196,"_197":198,"_199":200,"_201":202,"_203":204,"_205":206,"_207":208,"_209":210},"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"]

Branches1

Branches
1