[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_181":182,"_183":184},"routes/_app.x.$handle.$name",{"_97":96,"_32":44,"_105":87,"_27":106,"_13":14,"_107":-5,"_11":108,"_109":110,"_111":112,"_113":114,"_115":116,"_20":-5,"_117":-5,"_118":-5,"_119":25,"_120":121,"_122":25,"_123":-5,"_124":-5,"_125":126},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_42":43,"_32":44,"_37":45,"_46":-5,"_47":48,"_49":50,"_51":50,"_52":-5,"_53":-5,"_18":54,"_55":-5,"_56":48,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":68,"_69":-5,"_70":71,"_72":73,"_74":73,"_75":73,"_76":73,"_77":71,"_78":71,"_79":80,"_81":82,"_83":84,"_85":25},"version",22,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":36,"_37":38,"_39":14,"_40":41,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","main.ts","latestPath","fileId","e8308a06-6125-11f1-b17c-1607ee4eb77e","name","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\";\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 ? `?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(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(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(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}","createdAt",["D",1780933558136],"branchVersion","branchId","bd128274-25fe-11f0-b0b8-569c3dd06744","id","bd12469c-25fe-11f0-b0b8-569c3dd06744","blob",["D",1746043647248],"deletedAt","legacyEnvVars",true,"privacy","public","httpPrivacy","description","imageUrl","c9143560-63b6-444f-8f9f-e2647fabe09f","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",9,"orgId","c606f87f-4d7e-48c8-9c39-ef5ab94aec49","tursoName","bd12469c25fe11f0b0b8569c3dd06744","tursoHostname","bd12469c25fe11f0b0b8569c3dd06744-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789506649022],"pinned","userPerm","r","valPerm","rw","blobPerm","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_97":96,"_104":100},"org",{"_97":96,"_98":-5,"_99":100,"_18":-5,"_101":102,"_103":25},"branch",{"_13":86,"_32":87,"_42":41,"_88":43,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":44,"_95":96},"isOwned",30,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","std","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJVaVhpQ1BId3dscVpBbkdZVWlMNjJtcjkxWS5wbmcifQ","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_42":43,"_32":44,"_37":176,"_46":-5,"_47":48,"_49":50,"_51":50,"_52":-5,"_53":-5,"_18":54,"_55":-5,"_56":48,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":177,"_69":-5,"_70":71,"_72":73,"_74":73,"_75":73,"_76":73,"_77":71,"_78":71,"_79":178,"_81":179,"_83":180,"_85":25},"tree",[163,164,165],"files",[163,164,165],"counts",{"_153":150,"_154":148,"_155":60,"_156":157,"_158":159},"contents",[127,128,129],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_42":145,"_32":146,"_30":147,"_131":-5,"_40":41,"_39":148,"_132":25,"_37":149,"_13":150,"_33":20,"_35":151,"_24":25,"_135":-5,"_27":152},{"_42":137,"_32":138,"_30":139,"_131":-5,"_40":41,"_39":140,"_132":48,"_37":141,"_13":142,"_33":34,"_35":143,"_24":25,"_135":-5,"_27":144},{"_42":130,"_32":28,"_30":31,"_131":-5,"_40":41,"_39":14,"_132":48,"_37":133,"_13":134,"_33":34,"_35":36,"_24":25,"_135":-5,"_27":136},"bd55fd87-117e-48e5-9849-6f9971b89f0d","parentId","latest",["D",1780933558136],6,"label",[28],"68ba7956-6efb-4a3e-bf84-e309bf13476f","global.ts","bd149230-25fe-11f0-b0b8-569c3dd06744",18,["D",1780695501508],14,"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\";\n\n/**\n * Provides functions for interacting with your account's 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\nasync function list(prefix?: string): Promise<{ key: string; size: number; lastModified: string }[]> {\n let querystring = prefix ? `?prefix=${encodeURIComponent(prefix)}` : \"\";\n const res = await fetch(`${API_URL}/v1/blob${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(`${API_URL}/v1/blob/${encodeURIComponent(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(`${API_URL}/v1/blob/${encodeURIComponent(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(`${API_URL}/v1/blob/${encodeURIComponent(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 set(key, JSON.stringify(value));\n}",[138],"bd14ae8c-25fe-11f0-b0b8-569c3dd06744","README.md","bd14af04-25fe-11f0-b0b8-569c3dd06744",1,["D",1699914491595],0,"# Blob Storage - [Docs ↗](https://docs.val.town/std/blob)\n\nVal Town comes with blob storage built-in. It allows for storing any data, like text, JSON, or images. You can access it via [`std/blob`](https://www.val.town/v/std/blob).\n\nBlob storage is scoped globally to your account. If you set a blob in one val, you can retrieve it by the same key in another val. It's backed by Cloudflare R2.\n\n### Blob Admin Panels\n\n* [Blob Storage in Settings](https://www.val.town/settings/blob) – built-into Val Town - list, download, delete blobs\n* [Blob Admin](https://www.val.town/v/stevekrouse/blob_admin) – search, view, edit, upload blobs – built in a val – easy to customize in Val Town!\n\n### Usage\n\n##### Get JSON\n\n```ts title=\"Get JSON\"\nimport { blob } from \"https://esm.town/v/std/blob\";\n\nlet blobDemo = await blob.getJSON(\"myKey\");\nconsole.log(blobDemo); // returns `undefined` if not found\n```\n\n##### Set JSON\n\n```ts title=\"Set JSON\"\nimport { blob } from \"https://esm.town/v/std/blob\";\n\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\n```\n\n##### List keys\n\n```ts title=\"List Keys\"\nimport { blob } from \"https://esm.town/v/std/blob\";\n\nlet allKeys = await blob.list();\nconsole.log(allKeys);\n\nconst appKeys = await blob.list(\"app_\");\nconsole.log(appKeys); // all keys that begin with `app_`\n```\n\n##### Delete by key\n\n```ts title=\"Delete\"\nimport { blob } from \"https://esm.town/v/std/blob\";\n\nawait blob.delete(\"myKey\");\n```\n\n### Examples\n\n* [Counter](https://www.val.town/v/std/docsBlobCounterDemo)\n* [RSS Notifications](https://www.val.town/v/stevekrouse/rssNotifyExample) (saving the last run time)\n* Picture: [Save](https://www.val.town/v/andreterron/blobSavePictureExample) & [Read](https://www.val.town/v/andreterron/blobReadPictureExample)\n\n### Error Handling\n\n* `blob.get` can throw [`ValTownBlobNotFoundError`](https://val.town/v/std/ValTownBlobNotFoundError)\n* Any method can throw [`ValTownBlobError`](https://val.town/v/andreterron/ValTownBlobError) for unexpected errors.\n\n### Utilities\n\nOur Blob SDK also includes some utility functions to make working with blobs easier.\n\n##### Copy\n\n```ts title=\"Copy\"\nimport { blob } from \"https://esm.town/v/std/blob\";\n\nawait blob.copy(\"myKey\", \"myKeyCopy\");\n```\n\n##### Move\n\n```ts title=\"Move\"\nimport { blob } from \"https://esm.town/v/std/blob\";\n\nawait blob.move(\"myKey\", \"myKeyNew\");\n```\n\n### Lower-level API\n\nWe provide access to the lower-level getter and setters,\nwhich are useful if you are storing non-JSON or binary data,\nneed to stream in your response or request data, or do anything else lower-level.\n\n* `async get(key: string)`: Retrieves a blob for a given key.\n* `async set(key: string, value: string | BodyInit)`: Sets the blob value for a given key. See [BodyInit](https://deno.land/api@v1.38.1?s=BodyInit).\n\n### Limitations\n\n* Blob-stored data counts towards your total Val Town storage – 10mb on the free plan and 1gb on pro. Check our [pricing page](https://val.town/pricing) to learn more.\n* Keys for blobs can be up to 512 characters long.\n\n\n[📝 Edit docs](https://github.com/val-town/val-town-docs/edit/main/src/content/docs/std/blob.mdx)\n\nMigrated from folder: blob/blob",[146],"pulls","branches","forks","envVars",{"_160":150,"_162":150},"connections",{"_160":150,"_161":150},"count","unfilledCount","emptyCount",{"_42":145,"_32":146,"_30":147,"_131":-5,"_40":41,"_39":148,"_132":25,"_37":173,"_13":150,"_33":20,"_35":151,"_24":25,"_135":-5,"_167":174,"_27":175},{"_42":137,"_32":138,"_30":139,"_131":-5,"_40":41,"_39":140,"_132":48,"_37":170,"_13":142,"_33":34,"_35":143,"_24":25,"_135":-5,"_167":171,"_27":172},{"_42":130,"_32":28,"_30":31,"_131":-5,"_40":41,"_39":14,"_132":48,"_37":166,"_13":134,"_33":34,"_35":36,"_24":25,"_135":-5,"_167":168,"_27":169},["D",1780933558136],"children",[],[28],["D",1780695501508],[],[138],["D",1699914491595],[],[146],["D",1746043647248],["D",1789506649022],{"_97":96,"_104":100},{"_97":96,"_98":-5,"_99":100,"_18":-5,"_101":102,"_103":25},{"_13":86,"_32":87,"_42":41,"_88":43,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":44,"_95":96},"ctx",{"_79":-5,"_124":214,"_215":216,"_217":218,"_219":25,"_220":25,"_221":25,"_222":48,"_223":-5,"_224":-7,"_225":-7,"_226":150,"_227":25,"_228":25,"_229":-5,"_230":25,"_231":25,"_232":25,"_233":-5},"ENV",{"_185":186,"_187":188,"_189":87,"_190":191,"_192":193,"_194":195,"_196":197,"_198":199,"_200":201,"_202":203,"_204":205,"_206":207,"_208":209,"_210":211,"_212":213},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","5015b8df46402d8bba4f485ecc37aec202b0e06b","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 · v22