404: Blob Not Found

No blob exists with the key {key}.

← Back to all blobs

); };\nconst A = ({ href, label }: { href: string; label: string }) => {label};\nconst css = `pre{outline:1px solid #ccc;padding:5px;margin:15px;white-space:pre-wrap}.string{color:green}.number{color:darkorange}.boolean{color:blue}.null{color:magenta}.key{color:red}`;\nconst hl = (j: string) => j.replace(/&/g, \"&\").replace(//g, \">\").replace(/(\"(\\\\u[a-zA-Z0-9]{4}|\\\\[^u]|[^\\\\\"])*\"(\\s*:)?|\\b(true|false|null)\\b|-?\\d+(?:\\.\\d*)?(?:[eE][+\\-]?\\d+)?)/g, (m) => `${m}`);\n\napp.use(jsxRenderer(({ children }) => {val.name} Blob Admin

{children}

));\n\napp.get(\"/\", async (c) => c.render(

`{val.name}` Blob Admin

New Blob Upload Blob

{(await blob.list()).map((b) => { const k = enc(b.key); return ; })}

Name	Size (kb)	Last Modified	Edit	Delete	Download
{b.key}	{Math.round(b.size / 1000)}	{new Date(b.lastModified).toLocaleString(\"en-CA\",{timeZone:\"Canada/Eastern\",dateStyle:\"short\",timeStyle:\"short\"})}

));\n\napp.get(\"/create\", (c) => c.render(

KeyContent

<input type=\"submit\" value=\"Create\" /></form>));\napp.post(\"/create\", async (c) => {\n  const { key, content } = await c.req.parseBody() as { key: string; content: string };\n  const exists = await blob.get(key).then(() => true, () => false);\n  if (exists) throw new HTTPException(400, { message: `key ${key} already exists` });\n  await blob.set(key, content);\n  return c.redirect(\"/\");\n});\n\napp.get(\"/upload\", (c) => c.render(<form method=\"POST\" enctype=\"multipart/form-data\"><input name=\"file\" type=\"file\" /><input type=\"submit\" value=\"Upload\" /></form>));\napp.post(\"/upload\", async (c) => {\n  const { file } = await c.req.parseBody();\n  if (!(file instanceof File)) return c.text(\"Invalid file\", 400);\n  await blob.set(file.name, await file.arrayBuffer());\n  return c.redirect(\"/\");\n});\n\napp.get(\"/view/:key\", async (c) => {\n  const key = c.req.param(\"key\");\n  let text: string;\n  try { text = await (await blob.get(key)).text(); } catch (e) { if (e instanceof ValTownBlobNotFoundError) return notFound(c, key); throw e; }\n  let j: string, isJson = true;\n  try { j = JSON.stringify(JSON.parse(text), null, 2); } catch { isJson = false; }\n  return c.render(<div><style>{css}</style><h1>{key}</h1>{isJson ? <pre dangerouslySetInnerHTML={{ __html: hl(j!) }} /> : <pre>{text + \"\\n\"}</pre>}</div>);\n});\n\napp.get(\"/edit/:key\", async (c) => {\n  const key = c.req.param(\"key\");\n  let content: string;\n  try { content = await (await blob.get(key)).text(); } catch (e) { if (e instanceof ValTownBlobNotFoundError) return notFound(c, key); throw e; }\n  return c.render(<form method=\"POST\"><input name=\"new_key\" value={key} /><textarea name=\"content\">{content}

404: Blob Not Found

\n No blob exists with the key {blobKey}.\n

\n ← Back to all blobs\n

\n);\n\n/**\n * Builds a ready-to-serve Hono app for listing, creating, viewing, editing,\n * uploading to, downloading from, and deleting blobs.\n *\n * ⚠️ Security: this app has NO authentication of its own. Anyone who can\n * reach it can read and delete every blob in the store you pass in. Always\n * wrap the returned app's `fetch` in an auth layer before exporting it as a\n * val's default handler — see the README for the recommended pattern.\n */\nexport function createBlobAdmin(\n { blob, valName = \"Your Val's\" }: BlobAdminOptions,\n) {\n const app = new Hono();\n\n app.use(\n jsxRenderer(({ children }) => (\n \n \n {valName} Blob Admin\n \n \n \n

{children}

\n \n \n )),\n );\n\n // --- Home: table of every blob in the store ---\n app.get(\"/\", async (c) => {\n const blobs = await blob.list();\n\n return c.render(\n

`{valName}` Blob Admin

\n\n

\n New Blob\n Upload Blob\n

\n\n \n \n \n \n \n \n \n \n \n \n \n \n {blobs.map((b) => {\n const key = encodeURIComponent(b.key);\n return (\n \n \n \n \n \n \n \n \n );\n })}\n \n

Name	Size (kb)	Last Modified	Edit	Delete	Download
\n {b.key}\n	{Math.round(b.size / 1000)}	\n {new Date(b.lastModified).toLocaleString(\"en-CA\", {\n timeZone: \"Canada/Eastern\",\n dateStyle: \"short\",\n timeStyle: \"short\"\n })}\n

,\n );\n });\n\n // --- Create a blob from a text field ---\n app.get(\"/create\", (c) =>\n c.render(\n

\n Key\n \n Content\n

\n        <input type=\"submit\" value=\"Create\" />\n      </form>,\n    ));\n\n  app.post(\"/create\", async (c) => {\n    const { key, content } = await c.req.parseBody() as {\n      key: string;\n      content: string;\n    };\n\n    const alreadyExists = await blob.get(key).then(() => true, () => false);\n    if (alreadyExists) {\n      throw new HTTPException(400, { message: `key ${key} already exists` });\n    }\n\n    await blob.set(key, content);\n    return c.redirect(\"/\");\n  });\n\n  // --- Upload a file directly as a blob (key = file name) ---\n  app.get(\"/upload\", (c) =>\n    c.render(\n      <form method=\"POST\" enctype=\"multipart/form-data\">\n        <input name=\"file\" type=\"file\" />\n        <input type=\"submit\" value=\"Upload\" />\n      </form>,\n    ));\n\n  app.post(\"/upload\", async (c) => {\n    const { file } = await c.req.parseBody();\n    if (!(file instanceof File)) {\n      return c.text(\"Invalid file\", 400);\n    }\n\n    await blob.set(file.name, await file.arrayBuffer());\n    return c.redirect(\"/\");\n  });\n\n  // --- View a blob's content, pretty-printed and highlighted if it's JSON ---\n  app.get(\"/view/:key\", async (c) => {\n    const key = c.req.param(\"key\");\n\n    let text: string;\n    try {\n      text = await (await blob.get(key)).text();\n    } catch (e) {\n      if (e instanceof ValTownBlobNotFoundError) {\n        c.status(404);\n        return c.render(<NotFoundPage blobKey={key} />);\n      }\n      throw e;\n    }\n\n    let prettyJson: string | undefined;\n    try {\n      prettyJson = JSON.stringify(JSON.parse(text), null, 2);\n    } catch {\n      // Not valid JSON — fall back to plain text rendering below.\n    }\n\n    return c.render(\n      <div>\n        <style>{viewerCss}</style>\n        <h1>{key}</h1>\n        {prettyJson\n          ? (\n            <pre\n              dangerouslySetInnerHTML={{ __html: syntaxHighlight(prettyJson) }}\n            />\n          )\n          : <pre>{text + \"\\n\"}</pre>}\n      </div>,\n    );\n  });\n\n  // --- Edit a blob's content, or rename its key ---\n  app.get(\"/edit/:key\", async (c) => {\n    const key = c.req.param(\"key\");\n\n    let content: string;\n    try {\n      content = await (await blob.get(key)).text();\n    } catch (e) {\n      if (e instanceof ValTownBlobNotFoundError) {\n        c.status(404);\n        return c.render(<NotFoundPage blobKey={key} />);\n      }\n      throw e;\n    }\n\n    return c.render(\n      <form method=\"POST\">\n        <input name=\"new_key\" value={key} />\n        <textarea name=\"content\">{content}

\n \n

,\n );\n });\n\n app.post(\"/edit/:key\", async (c) => {\n const key = c.req.param(\"key\");\n const { content, new_key } = await c.req.parseBody() as {\n content: string;\n new_key: string;\n };\n\n await blob.set(key, content);\n if (new_key !== key) {\n await blob.move(key, new_key);\n }\n return c.redirect(\"/\");\n });\n\n // --- Delete a blob (with a confirmation step) ---\n app.get(\"/delete/:key\", async (c) => {\n const key = c.req.param(\"key\");\n\n try {\n await blob.get(key);\n } catch (e) {\n if (e instanceof ValTownBlobNotFoundError) {\n c.status(404);\n return c.render();\n }\n throw e;\n }\n\n return c.render(\n ,\n );\n });\n\n app.post(\"/delete/:key\", async (c) => {\n await blob.delete(c.req.param(\"key\"));\n return c.redirect(\"/\");\n });\n\n // --- Download a blob's raw content ---\n app.get(\"/download/:key\", (c) => blob.get(c.req.param(\"key\")));\n\n return app;\n}",[177],"354763c9-9a69-410a-9109-0f303e0c6ba6","README.md","79d75cea-8003-11f1-8c88-1607ee4eb77e",50,["D",1784235885039],"# Val-Scoped Blob Admin\n\nA little admin UI for browsing, creating, viewing, editing, uploading to,\ndownloading from, and deleting [Val Town blobs](https://docs.val.town/std/blob) —\nright from your browser.\n\nThis is a fork of Steve Krouse's\n[Global Blob Admin](https://www.val.town/x/stevekrouse/blob_admin_app), updated to:\n\n- add **JSON syntax highlighting** when viewing a blob (numbers, strings, keys,\n booleans, and `null` are colored)\n- work against **val-scoped** blob storage (`std/blob/main.ts`) instead of only\n account-global blobs, so you can run one of these per-project and it only\n ever sees that project's blobs\n\n## How it's organized\n\n| File | What it does |\n| ------------------- | -------------------------------------------------------------------------------------------------- |\n| `helper.ts` | Shared types (`BlobStore`, `BlobAdminOptions`) + the JSON syntax highlighter. Plain TS, no Val Town–specific code. |\n| `blob-admin.tsx` | `createBlobAdmin()` — builds the Hono app (all the routes/pages). This is the reusable part. |\n| `main.tsx` | Standalone demo: wires `createBlobAdmin()` to this val's own blobs, behind password auth. This is what's deployed at this val's URL. |\n| `example.tsx` | The exact snippet you'd copy into your own val (see below). |\n| `minimal.tsx` | A single-file, compact version of the same app for quick reference/remixing without the multi-file split. |\n\nThe refactor's whole point is that `blob-admin.tsx` doesn't know anything\nabout *this* val — you give it a blob client and it gives you back a Hono app.\n`main.tsx` is just one particular way of using it.\n\n## Using this in your own val\n\nYou don't need to copy the full app. Import `createBlobAdmin` and pass it\n**your own val's blob import** — that's the whole integration:\n\n```tsx\n/** @jsxImportSource https://esm.sh/hono@4.0.8/jsx **/\nimport { passwordAuth } from \"https://esm.town/v/pomdtr/password_auth/main.tsx\";\nimport { verifyToken } from \"https://esm.town/v/pomdtr/verifyToken\";\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\"; // your val's own blobs\nimport { createBlobAdmin } from \"https://esm.town/v/gwoods22/val_scoped_blob_admin/blob-admin.tsx\";\n\nconst app = createBlobAdmin({ blob, valName: \"My App's\" });\n\n// createBlobAdmin has no auth of its own — always wrap it before exporting.\nexport default passwordAuth(app.fetch, { verifyPassword: verifyToken });\n```\n\nThat's it — no copy-pasting the routes, the JSX, or the syntax highlighter.\nSee `example.tsx` in this val for the same snippet, ready to remix.\n\n### Why you pass in your own `blob`\n\n`createBlobAdmin()` takes a `blob` client as a required option instead of\nimporting one itself. Two reasons, both about security:\n\n1. **Scoping.** Val Town's `std/blob/main.ts` import is scoped to *the val\n it's imported into* — when your val imports it, it can only ever reach\n your val's blobs. If this library imported its own `blob` client instead,\n every val using it would be sharing (and could accidentally clobber) the\n same storage.\n2. **No hidden network access.** The library never reaches out on its own —\n it only ever touches whatever store object you hand it. You can audit\n exactly what it does to your data by reading `blob-admin.tsx`.\n\nIf you'd rather manage blobs globally across your whole account, swap the\nimport for `https://esm.town/v/std/blob/global.ts` — same shape, so nothing\nelse changes.\n\n### Add your own auth\n\n`createBlobAdmin()` deliberately ships with **no authentication**. This admin\npanel can read, overwrite, and delete every blob in whatever store you give\nit, so an unauthenticated deployment means anyone with the URL has full\nread/write/delete access to that data.\n\nThe example above uses Val Town's built-in `passwordAuth` + `verifyToken`\npattern (same as this val's own `main.tsx`), which is a nice fit for personal\nprojects: the \"password\" you sign in with is your own Val Town API token, so\nonly you can get in. You're of course free to swap in any other auth\nmiddleware that wraps a `fetch` handler.\n\n## Local development\n\nEverything here is plain Hono + JSX, no build step. Edit `blob-admin.tsx`\nto change routes or markup, `helper.ts` for shared types/utilities, and\n`main.tsx` to change how the standalone deployment of this val is configured.\n`minimal.tsx` is a self-contained, single-file version kept around for anyone\nwho'd rather grab one compact file than wire up the multi-file split.\n",[185],"pulls","branches","forks","envVars",{"_198":81,"_200":81},"connections",{"_198":81,"_199":81},"count","unfilledCount","emptyCount",{"_27":184,"_13":185,"_56":186,"_37":-5,"_29":30,"_145":187,"_147":77,"_31":223,"_33":34,"_59":47,"_151":189,"_61":24,"_153":-5,"_208":224,"_115":225},{"_27":176,"_13":177,"_56":178,"_37":-5,"_29":30,"_145":179,"_147":77,"_31":220,"_33":181,"_59":60,"_151":182,"_61":24,"_153":-5,"_208":221,"_115":222},{"_27":170,"_13":171,"_56":75,"_37":-5,"_29":30,"_145":101,"_147":77,"_31":217,"_33":173,"_59":150,"_151":174,"_61":24,"_153":-5,"_208":218,"_115":219},{"_27":163,"_13":164,"_56":165,"_37":-5,"_29":30,"_145":166,"_147":77,"_31":214,"_33":149,"_59":60,"_151":168,"_61":24,"_153":-5,"_208":215,"_115":216},{"_27":155,"_13":156,"_56":157,"_37":-5,"_29":30,"_145":158,"_147":77,"_31":211,"_33":160,"_59":150,"_151":161,"_61":24,"_153":-5,"_208":212,"_115":213},{"_27":143,"_13":144,"_56":57,"_37":-5,"_29":30,"_145":146,"_147":77,"_31":207,"_33":149,"_59":150,"_151":152,"_61":24,"_153":-5,"_208":209,"_115":210},["D",1784304238158],"children",[],[144],["D",1784218604924],[],[156],["D",1784218626069],[],[164],["D",1784562847006],[],[171],["D",1784304229450],[],[177],["D",1784235885039],[],[185],["D",1784053743735],{"_11":12,"_114":64},{"_11":12,"_110":-5,"_63":64,"_25":62,"_111":112,"_113":24},{"_33":101,"_13":16,"_27":30,"_102":65,"_103":-5,"_104":-5,"_105":-5,"_106":-5,"_107":-5,"_108":14,"_109":12},"ctx",{"_45":-5,"_134":263,"_264":265,"_266":267,"_268":24,"_269":24,"_270":24,"_271":77,"_272":-5,"_273":-7,"_274":-7,"_275":81,"_276":24,"_277":24,"_278":-5,"_279":24,"_280":24,"_281":24,"_282":-5},"ENV",{"_234":235,"_236":237,"_238":16,"_239":240,"_241":242,"_243":244,"_245":246,"_247":248,"_249":250,"_251":252,"_253":254,"_255":256,"_257":258,"_259":260,"_261":262},"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"]

History