[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_174":175,"_176":177},"routes/_app.x.$handle.$name",{"_16":17,"_20":21,"_85":68,"_86":87,"_66":-7,"_88":-5,"_13":89,"_90":91,"_11":92,"_93":94,"_95":96,"_97":-5,"_98":-5,"_99":-5,"_100":65,"_101":102,"_103":65,"_104":-5,"_105":-5,"_106":107},"routes/_app.x.$handle.$name.search.$(branch)",{"_11":12,"_13":14,"_15":-5,"_16":17},"files",[],"project",{"_18":19,"_20":21,"_22":23,"_24":-5,"_25":26,"_27":28,"_29":28,"_30":-5,"_31":-5,"_32":33,"_34":-5,"_35":26,"_36":-5,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_48":-5,"_49":50,"_51":52,"_53":52,"_54":52,"_55":52,"_56":50,"_57":50,"_58":59,"_60":61,"_62":63,"_64":65},"query","handle","std","id","bd12469c-25fe-11f0-b0b8-569c3dd06744","name","blob","createdAt",["D",1746043647248],"deletedAt","legacyEnvVars",true,"privacy","public","httpPrivacy","description","imageUrl","userId","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",{"_16":17,"_84":80},"org",{"_16":17,"_78":-5,"_79":80,"_32":-5,"_81":82,"_83":65},"branch",{"_66":67,"_20":68,"_18":69,"_70":19,"_71":-5,"_72":-5,"_73":-5,"_74":-5,"_75":-5,"_76":21,"_77":17},"isOwned",false,"version",30,"main","bd128274-25fe-11f0-b0b8-569c3dd06744","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJVaVhpQ1BId3dscVpBbkdZVWlMNjJtcjkxWS5wbmcifQ","tier","pro","canRestrictVals","profileImageUrl","branchName","path","","adoptOrgId",{"_18":19,"_20":21,"_22":169,"_24":-5,"_25":26,"_27":28,"_29":28,"_30":-5,"_31":-5,"_32":33,"_34":-5,"_35":26,"_36":-5,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":45,"_46":170,"_48":-5,"_49":50,"_51":52,"_53":52,"_54":52,"_55":52,"_56":50,"_57":50,"_58":171,"_60":172,"_62":173,"_64":65},"tree",[156,157,158],[156,157,158],"counts",{"_144":145,"_146":147,"_148":39,"_149":150,"_151":152},"contents",[108,109,110],"file","upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_18":137,"_20":138,"_113":139,"_115":-5,"_116":69,"_117":67,"_119":26,"_22":140,"_66":141,"_122":97,"_124":142,"_126":65,"_127":-5,"_86":143},{"_18":129,"_20":130,"_113":131,"_115":-5,"_116":69,"_117":132,"_119":26,"_22":133,"_66":134,"_122":123,"_124":135,"_126":65,"_127":-5,"_86":136},{"_18":111,"_20":112,"_113":114,"_115":-5,"_116":69,"_117":118,"_119":26,"_22":120,"_66":121,"_122":123,"_124":125,"_126":65,"_127":-5,"_86":128},"bd55fd87-117e-48e5-9849-6f9971b89f0d","main.ts","fileId","e8308a06-6125-11f1-b17c-1607ee4eb77e","parentId","branchId","branchVersion",22,"latest",["D",1780933558136],6,"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}","deleted","label",[112],"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}",[130],"5f4dbf11-7bc4-43dc-8f80-c5e10d8d96aa","README.md","bd14af04-25fe-11f0-b0b8-569c3dd06744",["D",1781034766856],8,"# 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##### Set any content\n\n```ts title=\"Set JSON\"\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\";\n\nawait blob.set(\"myKey\", \"String, stream, etc\");\n```\n\n##### Get any content\n\n```ts title=\"Set JSON\"\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\";\n\n// Exposes a Response object with the same methods as a response from\n// fetch: .json(), .text(), etc.\nconst text = await blob.get(\"myKey\").then((response) => response.text());\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- **Scoped**\n - There's a Blob Storage option in the sidebar of vals you own, that allows\n you to list, create, delete, and download blobs.\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)",[138],"pulls",0,"branches",1,"forks","envVars",{"_153":145,"_155":145},"connections",{"_153":145,"_154":145},"count","unfilledCount","emptyCount",{"_18":137,"_20":138,"_113":139,"_115":-5,"_116":69,"_117":67,"_119":26,"_22":166,"_66":141,"_122":97,"_124":142,"_126":65,"_127":-5,"_160":167,"_86":168},{"_18":129,"_20":130,"_113":131,"_115":-5,"_116":69,"_117":132,"_119":26,"_22":163,"_66":134,"_122":123,"_124":135,"_126":65,"_127":-5,"_160":164,"_86":165},{"_18":111,"_20":112,"_113":114,"_115":-5,"_116":69,"_117":118,"_119":26,"_22":159,"_66":121,"_122":123,"_124":125,"_126":65,"_127":-5,"_160":161,"_86":162},["D",1780933558136],"children",[],[112],["D",1780695501508],[],[130],["D",1781034766856],[],[138],["D",1746043647248],["D",1789506649022],{"_16":17,"_84":80},{"_16":17,"_78":-5,"_79":80,"_32":-5,"_81":82,"_83":65},{"_66":67,"_20":68,"_18":69,"_70":19,"_71":-5,"_72":-5,"_73":-5,"_74":-5,"_75":-5,"_76":21,"_77":17},"ctx",{"_58":-5,"_105":207,"_208":209,"_210":211,"_212":65,"_213":65,"_214":65,"_215":26,"_216":-5,"_217":-7,"_218":-7,"_219":145,"_220":65,"_221":65,"_222":-5,"_223":65,"_224":65,"_225":65,"_226":-5},"ENV",{"_178":179,"_180":181,"_182":68,"_183":184,"_185":186,"_187":188,"_189":190,"_191":192,"_193":194,"_195":196,"_197":198,"_199":200,"_201":202,"_203":204,"_205":206},"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"]

Search