[{"_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",{"_96":95,"_32":43,"_104":86,"_27":105,"_13":14,"_106":-5,"_11":107,"_108":109,"_110":111,"_112":113,"_114":115,"_20":-5,"_116":-5,"_117":-5,"_118":25,"_119":120,"_121":25,"_122":-5,"_123":-5,"_124":125},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_41":42,"_32":43,"_36":44,"_45":-5,"_46":47,"_48":49,"_50":49,"_51":-5,"_52":-5,"_18":53,"_54":-5,"_55":47,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":-5,"_69":70,"_71":72,"_73":72,"_74":72,"_75":72,"_76":70,"_77":70,"_78":79,"_80":81,"_82":83,"_84":25},"version",28,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":20,"_34":35,"_36":37,"_38":14,"_39":40,"_24":25},"previous",{"_30":31,"_32":28,"_33":20,"_34":35},"deleted",false,"deletedHere","path","README.md","latestPath","fileId","bd14af04-25fe-11f0-b0b8-569c3dd06744","name","fileType","content","# 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\ntext, JSON, or images. You can access it via\n[`std/blob`](https://www.val.town/v/std/blob).\n\nBlob storage comes in two flavors: scoped & global.\n\n**Scoped** blob storage should be your default for now vals: it's scoped to the\nval, so more secure and flexible. Scoped storage is available behind the\n`https://esm.town/v/std/blob/main.ts` export and is backed by Amazon S3.\n\n**Global** blob storage was the norm before scoped blob storage was introduced:\nit's available to any val in your account. It's available at\n`https://esm.town/v/std/blob` and backed by Cloudflare R2.\n\n### Usage\n\nThe API for scoped blob storage and global storage is the same: to use these\nexamples with global val storage, import from `https://esm.town/v/std/blob`\ninstead.\n\n##### Get JSON\n\n```ts title=\"Get JSON\"\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\";\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/main.ts\";\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/main.ts\";\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/main.ts\";\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)\n (saving the last run time)\n- Picture: [Save](https://www.val.town/v/andreterron/blobSavePictureExample) &\n [Read](https://www.val.town/v/andreterron/blobReadPictureExample)\n\n### Error Handling\n\n- `blob.get` can throw\n [`ValTownBlobNotFoundError`](https://val.town/v/std/ValTownBlobNotFoundError)\n- Any method can throw\n [`ValTownBlobError`](https://val.town/v/andreterron/ValTownBlobError) for\n unexpected errors.\n\n### Utilities\n\nOur Blob SDK also includes some utility functions to make working with blobs\neasier.\n\n##### Copy\n\n```ts title=\"Copy\"\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\";\n\nawait blob.copy(\"myKey\", \"myKeyCopy\");\n```\n\n##### Move\n\n```ts title=\"Move\"\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\";\n\nawait blob.move(\"myKey\", \"myKeyNew\");\n```\n\n### Blob Admin Panels\n\n- **Global**\n - [Blob Storage in Settings](https://www.val.town/settings/blob) – built-into\n Val Town - list, download, delete blobs\n - [Blob Admin](https://www.val.town/v/stevekrouse/blob_admin) – search, view,\n edit, upload blobs – built in a val – easy to customize in Val Town!\n\n### Lower-level API\n\nWe provide access to the lower-level getter and setters, which are useful if you\nare storing non-JSON or binary data, need to stream in your response or request\ndata, 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\n 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\n plan and 1gb on pro. Check our [pricing page](https://val.town/pricing) to\n learn more.\n- Keys for blobs can be up to 512 characters long.\n\n[📝 Edit docs](https://github.com/val-town/val-town-docs/edit/main/src/content/docs/std/blob.mdx)","createdAt",["D",1780942774130],"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",{"_96":95,"_103":99},"org",{"_96":95,"_97":-5,"_98":99,"_18":-5,"_100":101,"_102":25},"branch",{"_13":85,"_32":86,"_41":40,"_87":42,"_88":-5,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":43,"_94":95},"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",{"_41":42,"_32":43,"_36":177,"_45":-5,"_46":47,"_48":49,"_50":49,"_51":-5,"_52":-5,"_18":53,"_54":-5,"_55":47,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":63,"_64":65,"_66":178,"_68":-5,"_69":70,"_71":72,"_73":72,"_74":72,"_75":72,"_76":70,"_77":70,"_78":179,"_80":180,"_82":181,"_84":25},"tree",[164,165,166],"files",[164,165,166],"counts",{"_152":153,"_154":155,"_156":59,"_157":158,"_159":160},"contents",[126,127,128],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_41":149,"_32":28,"_30":31,"_132":-5,"_39":40,"_38":14,"_134":25,"_36":150,"_13":136,"_33":20,"_34":35,"_24":25,"_139":-5,"_27":151},{"_41":141,"_32":142,"_30":143,"_132":-5,"_39":40,"_38":144,"_134":47,"_36":145,"_13":146,"_33":137,"_34":147,"_24":25,"_139":-5,"_27":148},{"_41":129,"_32":130,"_30":131,"_132":-5,"_39":40,"_38":133,"_134":47,"_36":135,"_13":136,"_33":137,"_34":138,"_24":25,"_139":-5,"_27":140},"bd55fd87-117e-48e5-9849-6f9971b89f0d","main.ts","e8308a06-6125-11f1-b17c-1607ee4eb77e","parentId",22,"latest",["D",1780933558136],6,"script","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}","label",[130],"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}",[142],"721cb02e-9d27-41de-81b7-c5d581e08627",["D",1780942774130],[28],"pulls",0,"branches",1,"forks","envVars",{"_161":153,"_163":153},"connections",{"_161":153,"_162":153},"count","unfilledCount","emptyCount",{"_41":149,"_32":28,"_30":31,"_132":-5,"_39":40,"_38":14,"_134":25,"_36":174,"_13":136,"_33":20,"_34":35,"_24":25,"_139":-5,"_168":175,"_27":176},{"_41":141,"_32":142,"_30":143,"_132":-5,"_39":40,"_38":144,"_134":47,"_36":171,"_13":146,"_33":137,"_34":147,"_24":25,"_139":-5,"_168":172,"_27":173},{"_41":129,"_32":130,"_30":131,"_132":-5,"_39":40,"_38":133,"_134":47,"_36":167,"_13":136,"_33":137,"_34":138,"_24":25,"_139":-5,"_168":169,"_27":170},["D",1780933558136],"children",[],[130],["D",1780695501508],[],[142],["D",1780942774130],[],[28],["D",1746043647248],["D",1789506649022],{"_96":95,"_103":99},{"_96":95,"_97":-5,"_98":99,"_18":-5,"_100":101,"_102":25},{"_13":85,"_32":86,"_41":40,"_87":42,"_88":-5,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":43,"_94":95},"ctx",{"_78":-5,"_123":215,"_216":217,"_218":219,"_220":25,"_221":25,"_222":25,"_223":47,"_224":-5,"_225":-7,"_226":-7,"_227":153,"_228":25,"_229":25,"_230":-5,"_231":25,"_232":25,"_233":25,"_234":-5},"ENV",{"_186":187,"_188":189,"_190":86,"_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 · v28