[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_182":183,"_184":185},"routes/_app.x.$handle.$name",{"_98":97,"_32":45,"_106":88,"_27":107,"_13":14,"_108":-5,"_11":109,"_110":111,"_112":113,"_114":115,"_116":117,"_20":-5,"_118":-5,"_119":-5,"_120":25,"_121":122,"_123":25,"_124":-5,"_125":-5,"_126":127},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":49,"_50":51,"_52":51,"_53":-5,"_54":-5,"_18":55,"_56":-5,"_57":49,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":72,"_73":74,"_75":74,"_76":74,"_77":74,"_78":72,"_79":72,"_80":81,"_82":83,"_84":85,"_86":25},"version",18,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_34":35,"_36":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","global.ts","latestPath","fileId","bd149230-25fe-11f0-b0b8-569c3dd06744","name","main.tsx","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 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}","createdAt",["D",1780695501508],"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",{"_98":97,"_105":101},"org",{"_98":97,"_99":-5,"_100":101,"_18":-5,"_102":103,"_104":25},"branch",{"_13":87,"_32":88,"_43":42,"_89":44,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":45,"_96":97},"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",{"_43":44,"_32":45,"_38":177,"_47":-5,"_48":49,"_50":51,"_52":51,"_53":-5,"_54":-5,"_18":55,"_56":-5,"_57":49,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":178,"_70":-5,"_71":72,"_73":74,"_75":74,"_76":74,"_77":74,"_78":72,"_79":72,"_80":179,"_82":180,"_84":181,"_86":25},"tree",[164,165,166],"files",[164,165,166],"counts",{"_154":151,"_155":149,"_156":61,"_157":158,"_159":160},"contents",[128,129,130],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_43":146,"_32":147,"_30":148,"_134":-5,"_41":42,"_40":149,"_136":25,"_38":150,"_13":151,"_34":20,"_36":152,"_24":25,"_140":-5,"_27":153},{"_43":142,"_32":28,"_30":31,"_134":-5,"_41":42,"_40":14,"_136":49,"_38":143,"_13":144,"_34":35,"_36":37,"_24":25,"_140":-5,"_27":145},{"_43":131,"_32":132,"_30":133,"_134":-5,"_41":42,"_40":135,"_136":25,"_38":137,"_13":138,"_34":35,"_36":139,"_24":25,"_140":-5,"_27":141},"7e0c2f38-5910-4d47-a7d5-d47080d4e5cb","main.ts","e8308a06-6125-11f1-b17c-1607ee4eb77e","parentId",17,"latest",["D",1780695114671],2,"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(\n prefix?: string,\n): Promise<{ key: string; size: number; lastModified: string }[]> {\n let querystring = prefix ? `?prefix=${encodeURIComponent(prefix)}` : \"\";\n const res = await fetch(`${API_URL}/v2/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}/v2/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}/v2/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}/v2/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}","label",[132],"68ba7956-6efb-4a3e-bf84-e309bf13476f",["D",1780695501508],14,[28],"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",[147],"pulls","branches","forks","envVars",{"_161":151,"_163":151},"connections",{"_161":151,"_162":151},"count","unfilledCount","emptyCount",{"_43":146,"_32":147,"_30":148,"_134":-5,"_41":42,"_40":149,"_136":25,"_38":174,"_13":151,"_34":20,"_36":152,"_24":25,"_140":-5,"_168":175,"_27":176},{"_43":142,"_32":28,"_30":31,"_134":-5,"_41":42,"_40":14,"_136":49,"_38":171,"_13":144,"_34":35,"_36":37,"_24":25,"_140":-5,"_168":172,"_27":173},{"_43":131,"_32":132,"_30":133,"_134":-5,"_41":42,"_40":135,"_136":25,"_38":167,"_13":138,"_34":35,"_36":139,"_24":25,"_140":-5,"_168":169,"_27":170},["D",1780695114671],"children",[],[132],["D",1780695501508],[],[28],["D",1699914491595],[],[147],["D",1746043647248],["D",1789506649022],{"_98":97,"_105":101},{"_98":97,"_99":-5,"_100":101,"_18":-5,"_102":103,"_104":25},{"_13":87,"_32":88,"_43":42,"_89":44,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":45,"_96":97},"ctx",{"_80":-5,"_125":215,"_216":217,"_218":219,"_220":25,"_221":25,"_222":25,"_223":49,"_224":-5,"_225":-7,"_226":-7,"_227":151,"_228":25,"_229":25,"_230":-5,"_231":25,"_232":25,"_233":25,"_234":-5},"ENV",{"_186":187,"_188":189,"_190":88,"_191":192,"_193":194,"_195":196,"_197":198,"_199":200,"_201":202,"_203":204,"_205":206,"_207":208,"_209":210,"_211":212,"_213":214},"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 · v18