[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_177":178,"_179":180},"routes/_app.x.$handle.$name",{"_105":104,"_39":52,"_113":95,"_33":114,"_13":14,"_115":-5,"_11":116,"_117":118,"_119":120,"_121":122,"_123":124,"_26":-5,"_125":-5,"_126":-5,"_127":31,"_128":129,"_130":31,"_131":-5,"_132":-5,"_133":134},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":-5},"project",{"_50":51,"_39":52,"_45":53,"_54":-5,"_55":31,"_56":57,"_58":57,"_59":60,"_61":-5,"_19":62,"_63":-5,"_64":31,"_65":-5,"_66":-5,"_67":68,"_69":70,"_71":72,"_73":74,"_75":76,"_77":-5,"_78":79,"_80":79,"_81":82,"_83":82,"_84":82,"_85":79,"_86":79,"_87":88,"_89":90,"_91":92,"_93":31},"version",40,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","d3206bd0-1184-4986-9cec-55bca7851aa9","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle",{"_26":27,"_28":29,"_30":31,"_32":31,"_33":34,"_35":36},"file",{"_37":38,"_39":34,"_40":41,"_42":44,"_45":46,"_47":14,"_48":49,"_30":31},"previous",{"_37":38,"_39":34,"_40":41,"_42":43},"deleted",false,"deletedHere","path","migrate.ts","latestPath","main.ts","fileId","2cc54c0e-6673-11f1-9da2-1607ee4eb77e","name","fileType","script","content","import { blob as globalBlob } from \"https://esm.town/v/std/blob/global.ts\";\nimport { blob as scopedBlob } from \"https://esm.town/v/std/blob/main.ts\";\nimport { ValTownBlobNotFoundError } from \"https://esm.town/v/std/ValTownBlobNotFoundError\";\n\n/** Per-key outcome of a migration run. */\nexport type BlobMigrationStatus =\n | \"migrated\"\n | \"skipped-exists\"\n | \"skipped-missing\"\n | \"dry-run\"\n | \"error\";\n\n/**\n * Per-key outcome of a blob migration.\n * @property key - The blob key being migrated.\n * @property status - The outcome status.\n * @property sourceDeleted - Whether the source blob was deleted from global storage (deleteSource).\n * @property error - Error message, present only when status === \"error\".\n */\nexport interface BlobMigrationResult {\n key: string;\n status: BlobMigrationStatus;\n sourceDeleted?: boolean;\n error?: string;\n}\n\n// export type MigrateKeysConfig = { keys: string[] } & MigrateOptions;\n// export type MigratePrefixConfig = { prefix: string[] } & MigrateOptions;\n\nexport interface MigrateOptions {\n /**\n * When false (default) `targets` is treated as an explicit list of keys. When\n * true, each entry in `targets` is treated as a prefix and expanded (via a\n * prefix `list`) into the matching global keys before migration.\n */\n prefix?: boolean;\n /**\n * When false (default) nothing is written or deleted — the run only reports\n * what *would* happen. Set to true to actually perform the migration.\n */\n commit?: boolean;\n /**\n * When false (default) keys that already exist in scoped storage are left\n * untouched. Set to true to overwrite them with the global copy.\n */\n overwrite?: boolean;\n /**\n * When true, the source blob is deleted from global storage after a\n * successful copy (i.e. a move). Off by default — the safe default copies.\n * Ignored unless `commit` is true.\n */\n deleteSource?: boolean;\n /** Optional callback invoked after each key is processed (for progress/logging). */\n onProgress?: (result: BlobMigrationResult) => void;\n}\n\nexport interface MigrateSummary {\n results: BlobMigrationResult[];\n counts: Record;\n /** True when no writes/deletes were performed (commit was false). */\n dryRun: boolean;\n}\n\n/** Returns true if a key already exists in scoped storage. */\nasync function existsInScoped(key: string): Promise {\n // list(prefix) is a prefix match, so confirm with an exact key compare.\n const entries = await scopedBlob.list(key);\n return entries.some((e) => e.key === key);\n}\n\n/**\n * Migrate blobs from global storage to scoped storage.\n *\n * `targets` is interpreted as an explicit list of keys by default. When\n * `prefix` is true, each entry in `targets` is treated as a prefix and expanded\n * (via a prefix `list`) into the matching global keys before migration.\n *\n * Streams each blob's raw body, so it is safe for binary, text, and JSON data\n * alike. Keys are preserved exactly. Defaults are conservative: dry-run, no\n * overwrite, and copy (not move).\n */\nexport async function migrateBlobs(\n targets: string[],\n options: MigrateOptions = {},\n): Promise {\n const {\n prefix = false,\n commit = false,\n overwrite = false,\n deleteSource = false,\n onProgress,\n } = options;\n\n // Resolve the keys to migrate. When `prefix` is set, expand each prefix into\n // the matching global keys; otherwise treat `targets` as keys directly.\n let keys: string[];\n if (prefix) {\n const expanded: string[] = [];\n for (const p of targets) {\n const matches = (await globalBlob.list(p)).map((e) => e.key);\n expanded.push(...matches);\n }\n keys = expanded;\n } else {\n keys = targets;\n }\n\n const results: BlobMigrationResult[] = [];\n // De-duplicate while preserving order.\n const uniqueKeys = [...new Set(keys)];\n\n for (const key of uniqueKeys) {\n const result = await migrateOne(key, { commit, overwrite, deleteSource });\n results.push(result);\n onProgress?.(result);\n }\n\n const counts = {\n \"migrated\": 0,\n \"skipped-exists\": 0,\n \"skipped-missing\": 0,\n \"dry-run\": 0,\n \"error\": 0,\n } as Record;\n for (const r of results) counts[r.status]++;\n\n return { results, counts, dryRun: !commit };\n}\n\nasync function migrateOne(\n key: string,\n opts: Required>,\n): Promise {\n try {\n // 1. Skip if it already exists in scoped storage (unless overwriting).\n if (!opts.overwrite && (await existsInScoped(key))) {\n return { key, status: \"skipped-exists\" };\n }\n\n // 2. Read from global storage. get() throws if the key is missing.\n let source: Response;\n try {\n source = await globalBlob.get(key);\n } catch (e) {\n if (e instanceof ValTownBlobNotFoundError) {\n return { key, status: \"skipped-missing\" };\n }\n throw e;\n }\n\n // 3. Dry-run: report what would happen without writing.\n if (!opts.commit) {\n // Drain the body so the connection isn't left hanging.\n await source.body?.cancel();\n return { key, status: \"dry-run\" };\n }\n\n // 4. Write the raw body to scoped storage (binary-safe).\n await scopedBlob.set(key, source.body ?? \"\");\n\n // 5. Optionally delete the source (move semantics).\n let sourceDeleted = false;\n if (opts.deleteSource) {\n await globalBlob.delete(key);\n sourceDeleted = true;\n }\n\n return { key, status: \"migrated\", sourceDeleted };\n } catch (e) {\n return {\n key,\n status: \"error\",\n error: e instanceof Error ? e.message : String(e),\n };\n }\n}","import { blob as globalBlob } from \"https://esm.town/v/std/blob/global.ts\";\nimport { blob as scopedBlob } from \"https://esm.town/v/std/blob/main.ts\";\nimport { ValTownBlobNotFoundError } from \"https://esm.town/v/std/ValTownBlobNotFoundError\";\n\n/** Per-key outcome of a migration run. */\nexport type BlobMigrationStatus =\n | \"migrated\"\n | \"skipped-exists\"\n | \"skipped-missing\"\n | \"dry-run\"\n | \"error\";\n\n/**\n * Per-key outcome of a blob migration.\n * @property key - The blob key being migrated.\n * @property status - The outcome status.\n * @property sourceDeleted - Whether the source blob was deleted from global storage (deleteSource).\n * @property error - Error message, present only when status === \"error\".\n */\nexport interface BlobMigrationResult {\n key: string;\n status: BlobMigrationStatus;\n sourceDeleted?: boolean;\n error?: string;\n}\n\n// export type MigrateKeysConfig = { keys: string[] } & MigrateOptions;\n// export type MigratePrefixConfig = { prefix: string[] } & MigrateOptions;\n\n/**\n * Options for migrating blobs from global to scoped storage.\n * @property prefix - When true, targets are treated as prefixes; default false (explicit keys).\n * @property commit - When true, actually perform the migration; default false (dry-run).\n * @property overwrite - When true, overwrite keys already in scoped storage; default false.\n * @property deleteSource - When true, delete from global after successful copy (move); default false (copy).\n * @property onProgress - Optional callback invoked after each key is processed.\n */\nexport interface MigrateOptions {\n prefix?: boolean;\n commit?: boolean;\n overwrite?: boolean;\n deleteSource?: boolean;\n onProgress?: (result: BlobMigrationResult) => void;\n}\n\nexport interface MigrateSummary {\n results: BlobMigrationResult[];\n counts: Record;\n /** True when no writes/deletes were performed (commit was false). */\n dryRun: boolean;\n}\n\n/** Returns true if a key already exists in scoped storage. */\nasync function existsInScoped(key: string): Promise {\n // list(prefix) is a prefix match, so confirm with an exact key compare.\n const entries = await scopedBlob.list(key);\n return entries.some((e) => e.key === key);\n}\n\n/**\n * Migrate blobs from global storage to scoped storage.\n *\n * `targets` is interpreted as an explicit list of keys by default. When\n * `prefix` is true, each entry in `targets` is treated as a prefix and expanded\n * (via a prefix `list`) into the matching global keys before migration.\n *\n * Streams each blob's raw body, so it is safe for binary, text, and JSON data\n * alike. Keys are preserved exactly. Defaults are conservative: dry-run, no\n * overwrite, and copy (not move).\n */\nexport async function migrateBlobs(\n targets: string[],\n options: MigrateOptions = {},\n): Promise {\n const {\n prefix = false,\n commit = false,\n overwrite = false,\n deleteSource = false,\n onProgress,\n } = options;\n\n // Resolve the keys to migrate. When `prefix` is set, expand each prefix into\n // the matching global keys; otherwise treat `targets` as keys directly.\n let keys: string[];\n if (prefix) {\n const expanded: string[] = [];\n for (const p of targets) {\n const matches = (await globalBlob.list(p)).map((e) => e.key);\n expanded.push(...matches);\n }\n keys = expanded;\n } else {\n keys = targets;\n }\n\n const results: BlobMigrationResult[] = [];\n // De-duplicate while preserving order.\n const uniqueKeys = [...new Set(keys)];\n\n for (const key of uniqueKeys) {\n const result = await migrateOne(key, { commit, overwrite, deleteSource });\n results.push(result);\n onProgress?.(result);\n }\n\n const counts = {\n \"migrated\": 0,\n \"skipped-exists\": 0,\n \"skipped-missing\": 0,\n \"dry-run\": 0,\n \"error\": 0,\n } as Record;\n for (const r of results) counts[r.status]++;\n\n return { results, counts, dryRun: !commit };\n}\n\nasync function migrateOne(\n key: string,\n opts: Required>,\n): Promise {\n try {\n // 1. Skip if it already exists in scoped storage (unless overwriting).\n if (!opts.overwrite && (await existsInScoped(key))) {\n return { key, status: \"skipped-exists\" };\n }\n\n // 2. Read from global storage. get() throws if the key is missing.\n let source: Response;\n try {\n source = await globalBlob.get(key);\n } catch (e) {\n if (e instanceof ValTownBlobNotFoundError) {\n return { key, status: \"skipped-missing\" };\n }\n throw e;\n }\n\n // 3. Dry-run: report what would happen without writing.\n if (!opts.commit) {\n // Drain the body so the connection isn't left hanging.\n await source.body?.cancel();\n return { key, status: \"dry-run\" };\n }\n\n // 4. Write the raw body to scoped storage (binary-safe).\n await scopedBlob.set(key, source.body ?? \"\");\n\n // 5. Optionally delete the source (move semantics).\n let sourceDeleted = false;\n if (opts.deleteSource) {\n await globalBlob.delete(key);\n sourceDeleted = true;\n }\n\n return { key, status: \"migrated\", sourceDeleted };\n } catch (e) {\n return {\n key,\n status: \"error\",\n error: e instanceof Error ? e.message : String(e),\n };\n }\n}","createdAt",["D",1781279585954],"branchVersion","branchId","95e9756a-e4dc-4c32-ad4e-e6d718ef2b59","id","f8539a2a-bfcb-41d1-8d5a-2028c5f630a3","migrate-blob",["D",1781278028334],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Library to migrate selected blobs from global to scoped storage","imageUrl","5d1042a9-7b0b-499d-8a72-3a8ac7a4e185","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","5f80108f-7ca4-4327-b77b-089dbe4b5a82","tursoName","f8539a2abfcb41d18d5a2028c5f630a3","tursoHostname","f8539a2abfcb41d18d5a2028c5f630a3-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789494036282],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_105":104,"_112":108},"org",{"_105":104,"_106":-5,"_107":108,"_19":62,"_109":110,"_111":31},"branch",{"_13":94,"_39":95,"_50":49,"_96":51,"_97":-5,"_98":-5,"_99":-5,"_100":-5,"_101":-5,"_102":52,"_103":104},"isOwned",63,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","nbbaier","handle","displayName","avatar","https://secure.gravatar.com/avatar/0129a541b7b3574e92c4afd06c5e32da&d=identicon","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_50":51,"_39":52,"_45":172,"_54":-5,"_55":31,"_56":57,"_58":57,"_59":60,"_61":-5,"_19":62,"_63":-5,"_64":31,"_65":-5,"_66":-5,"_67":68,"_69":70,"_71":72,"_73":74,"_75":173,"_77":-5,"_78":79,"_80":79,"_81":82,"_83":82,"_84":82,"_85":79,"_86":79,"_87":174,"_89":175,"_91":176,"_93":31},"tree",[163,164],"files",[163,164],"counts",{"_152":68,"_153":154,"_155":68,"_156":157,"_158":159},"contents",[135,136],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_50":144,"_39":145,"_37":146,"_138":-5,"_48":49,"_47":147,"_139":31,"_45":148,"_13":149,"_40":26,"_42":150,"_30":31,"_142":-5,"_33":151},{"_50":137,"_39":34,"_37":38,"_138":-5,"_48":49,"_47":14,"_139":31,"_45":140,"_13":141,"_40":41,"_42":44,"_30":31,"_142":-5,"_33":143},"597ac243-4d76-4e2d-a4ed-395305b95051","parentId","latest",["D",1781279585954],17,"label",[34],"2f743d59-c16f-481f-957b-6cb74e660926","README.md","64d9b1b6-6673-11f1-9df3-1607ee4eb77e",14,["D",1781278510681],2,"# migrate-blob\n\nA small library to migrate a **specific list of blobs** from\n[global blob storage](https://esm.town/v/std/blob/global.ts) (account-wide,\nCloudflare R2) to [scoped blob storage](https://esm.town/v/std/blob/main.ts)\n(per-val, S3).\n\nMigration **streams the raw body** of each blob, so it is safe for binary,\ntext, and JSON alike, and **preserves keys exactly**. Defaults are\nconservative: dry-run, no overwrite, and copy (not move).\n\n## Files\n\n| File | Purpose |\n| ------------ | ------------------------------------------------------------------ |\n| `migrate.ts` | The importable library — `migrateBlobs(keys, options)`. |\n| `keys.ts` | `getKeysToMigrate()` — define *which* blobs to migrate here. |\n| `run.ts` | Runnable entrypoint that wires the two together (dry-run default). |\n\n## Quick start\n\n1. Edit `keys.ts` to return the keys you want to migrate (explicit list,\n prefix match, or filter — examples are in the file).\n2. Run `run.ts`. It performs a **dry run** by default and prints a report.\n3. When the report looks right, set `COMMIT = true` in `run.ts` and run again.\n\n## Library usage\n\n```ts\nimport { migrateBlobs } from \"https://esm.town/v/nbbaier/migrate-blob/migrate.ts\";\n\nconst summary = await migrateBlobs([\"my-config\", \"images/logo.png\"], {\n commit: true, // default false (dry run)\n});\n\nconsole.log(summary.counts);\n// { migrated, \"skipped-exists\", \"skipped-missing\", \"dry-run\", error }\n```\n\n### `migrateBlobs(keys, options)`\n\n| Option | Default | Behavior |\n| -------------- | ------- | ------------------------------------------------------------------------ |\n| `commit` | `false` | When `false`, nothing is written — only reports what *would* happen. |\n| `overwrite` | `false` | When `false`, keys already in scoped storage are skipped (idempotent). |\n| `deleteSource` | `false` | When `true`, deletes from global after a successful copy (i.e. a *move*). Ignored unless `commit`. |\n| `onProgress` | — | Callback `(result) => void` invoked after each key. |\n\nReturns a `MigrateSummary`: `{ results, counts, dryRun }`, where each result is\n`{ key, status, sourceDeleted?, error? }`.\n\n### Statuses\n\n- `migrated` — copied from global to scoped.\n- `skipped-exists` — already present in scoped storage (re-run safe).\n- `skipped-missing` — not found in global storage.\n- `dry-run` — would have migrated, but `commit` was `false`.\n- `error` — see the `error` field.\n\n## How it works\n\n```mermaid\nflowchart LR\n A[\"getKeysToMigrate()\"] --> B[\"migrateBlobs(keys)\"]\n B --> C{\"exists in scoped?\"}\n C -- yes, no overwrite --> S[\"skipped-exists\"]\n C -- no --> D{\"exists in global?\"}\n D -- no --> M[\"skipped-missing\"]\n D -- yes --> E{\"commit?\"}\n E -- no --> R[\"dry-run\"]\n E -- yes --> F[\"stream global → scoped\"]\n F --> G{\"deleteSource?\"}\n G -- yes --> H[\"delete from global\"]\n G -- no --> I[\"migrated (copy)\"]\n H --> I\n```\n\n## Notes\n\n- Global and scoped blobs are stored separately; you can't reach one through\n the other's interface — hence this migration.\n- Keys can be up to 512 chars. Total storage counts toward your plan limit\n (1 GB on Pro); during a copy (not move) the data exists in *both* stores.\n",[145],"pulls","branches",1,"forks","envVars",{"_160":68,"_162":68},"connections",{"_160":68,"_161":68},"count","unfilledCount","emptyCount",{"_50":144,"_39":145,"_37":146,"_138":-5,"_48":49,"_47":147,"_139":31,"_45":169,"_13":149,"_40":26,"_42":150,"_30":31,"_142":-5,"_166":170,"_33":171},{"_50":137,"_39":34,"_37":38,"_138":-5,"_48":49,"_47":14,"_139":31,"_45":165,"_13":141,"_40":41,"_42":44,"_30":31,"_142":-5,"_166":167,"_33":168},["D",1781279585954],"children",[],[34],["D",1781278510681],[],[145],["D",1781278028334],["D",1789494036282],{"_105":104,"_112":108},{"_105":104,"_106":-5,"_107":108,"_19":62,"_109":110,"_111":31},{"_13":94,"_39":95,"_50":49,"_96":51,"_97":-5,"_98":-5,"_99":-5,"_100":-5,"_101":-5,"_102":52,"_103":104},"ctx",{"_87":-5,"_132":210,"_211":212,"_213":214,"_215":31,"_216":31,"_217":31,"_218":219,"_220":-5,"_221":-7,"_222":-7,"_223":68,"_224":31,"_225":31,"_226":-5,"_227":31,"_228":31,"_229":31,"_230":-5},"ENV",{"_181":182,"_183":184,"_185":95,"_186":187,"_188":189,"_190":191,"_192":193,"_194":195,"_196":197,"_198":199,"_200":201,"_202":203,"_204":205,"_206":207,"_208":209},"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",true,"preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v40