sliftutils 1.7.87 → 1.7.89

package/storage/remoteStorage/storageServerState.ts

@@ -1,58 +1,49 @@
 import path from "path";
 import fs from "fs";
-import { lazy } from "socket-function/src/caching";
-import { sort } from "socket-function/src/misc";
-import { runInfinitePoll } from "socket-function/src/batching";
-import { ArchivesDisk } from "../ArchivesDisk";
-import { BlobStore, RawDiskStore, IBucketStore, DEFAULT_FAST_WRITE_DELAY, WINDOW_END_FLUSH_MARGIN } from "./blobStore";
+import { BlobStore } from "./blobStore";
 import {
-    RemoteConfig, HostedConfig, SourceConfig, IArchives, ArchivesSource, ArchivesConfig, ArchivesSyncStatus,
-    ArchiveFileInfo, ChangesAfterConfig, DelConfig, FindConfig, GetConfig, GetInfoConfig, SetConfig, SyncActivity, FULL_ROUTE,
+    RemoteConfig, HostedConfig, SourceConfig, IArchives, ArchivesConfig, ArchivesSyncStatus, SyncActivity,
 } from "../IArchives";
-import { ROUTING_FILE, parseRoutingData, serializeRemoteConfig, parseHostedUrl, replaceHostedUrlPort, buildFileUrl, getConfigVersion, routeIntersection, normalizeSource } from "./remoteConfig";
-import { injectIntermediateSource, expireIntermediateSources, getIntermediateSources, nextIntermediateVersion, INTERMEDIATE_EXPIRE_GRACE } from "./intermediateSources";
-import { getTakeoverIntermediate } from "./deployTakeover";
-import { createApiArchives, listServerActiveBucketKeys } from "./createArchives";
+import { ROUTING_FILE, parseRoutingData, serializeRemoteConfig, normalizeSource } from "./remoteConfig";
+import { createStoreSource, applySourceConfig } from "./storeSources";
 import { broadcastRoutingChanged } from "./storageController";
 import { getStorageServerConfig, assertWritesAllowed } from "./serverConfig";
-import { getBucketFolder, readRoutingFile, readRoutingFromDisk, getRoutingFileResult, getDiskInfo, BucketDiskInfo } from "./bucketDisk";
-import { computeStorePlan, findSelfIndexes, StorePlan, StorePlanStore, SelfSummary } from "./storePlan";
-
-// The storage server's bucket lifecycle: the map of loaded buckets (each = its routing config + one BlobStore per route), keeping them current (routing reloads, window-boundary rebuilds, boundary scans), writing/propagating routing configs, deploy-switchover maintenance, and the server-level bucket listings. Store selection (sourceConfig -> store) lives here too, as findBucketStore.
+import { getBucketFolder, listAccountStoreFolders, listBucketStoreFolders, readRoutingFromDisk, getDiskInfo, BucketDiskInfo } from "./bucketDisk";
+import { scheduleBoundaryWork, reinjectIntermediates } from "./intermediateManagement";
+import { planSelfStores, isSelfSource, SelfSummary } from "./storePlan";
+
+/**
+ * What this server HAS, as opposed to what any of it does. Four things, and nothing else:
+ *
+ * - the stores, by folder (getStore) - made once, and self-configuring from there
+ * - which of them a request means (findBucketStore), which is only ever a name
+ * - what exists on disk, for listings and for the pages that report it
+ *
+ * It decides nothing about routes, windows or peers - a store reads its own config and works that
+ * out itself (BlobStore.applyRoutingConfig) - and it schedules nothing: switchovers and the handovers
+ * they cause live in intermediateManagement.
+ */
 
 export type LoadedStore = {
-    // JSON of the route (FULL_ROUTE when absent) - the ONE route this store serves
-    routeKey: string;
-    route?: [number, number];
+    // The name its entries gave it (see CommonConfig.name) - its identity here, its folder on disk, and how a request finds it
+    name: string;
     // The exact self entries this store serves (same route, different valid windows). Empty when we are not in the config but still serve our disk data.
     entries: HostedConfig[];
     folder: string;
-    store: IBucketStore;
+    store: BlobStore;
 };
 
-// A bucket loaded on this server: its routing config and its per-route stores. Pure data - the stores themselves do the work.
+// A bucket loaded on this server: the stores it has here, and what the newest of their configs says about us. Pure data - the stores themselves do the work, including configuring themselves.
 export type BucketState = {
     account: string;
     bucketName: string;
-    routing: RemoteConfig;
-    routingJSON: string;
+    // The newest routing config among its stores, or absent when none of them has one yet
+    routing?: RemoteConfig;
     selfEntries: HostedConfig[];
     self: SelfSummary | undefined;
     stores: LoadedStore[];
-    structureKey: string;
 };
 
-/** JSON with sorted object keys and undefined-valued keys dropped, so two configs that mean the same thing compare equal regardless of key order or which side serialized them. */
-function stableStringify(value: unknown): string {
-    if (!value || typeof value !== "object") return JSON.stringify(value);
-    if (Array.isArray(value)) {
-        return `[${value.map(x => stableStringify(x)).join(",")}]`;
-    }
-    let entries = Object.entries(value as Record<string, unknown>).filter(x => x[1] !== undefined);
-    sort(entries, x => x[0]);
-    return `{${entries.map(([key, child]) => `${JSON.stringify(key)}:${stableStringify(child)}`).join(",")}}`;
-}
-
 /** The loaded bucket, loading it (which instantiates its stores and starts their synchronization) if needed. A bucket that does not exist on this server throws - callers never see undefined buckets. */
 export async function requireBucket(account: string, bucketName: string): Promise<BucketState> {
     let bucket = await getLoadedBucket(account, bucketName);
@@ -62,23 +53,23 @@ export async function requireBucket(account: string, bucketName: string): Promis
     return bucket;
 }
 
-/** The stable identity of a source config for matching: everything EXCEPT the valid window, and with an intermediate resolved back to the source it was split out of. The window drifts (a switchover splits one window in two around an intermediate, then rejoins it), so a caller and this server routinely disagree on it - matching on it would wrongly reject the request. An intermediate is a transient alt-port view of another source, so it must resolve to THAT source (config.intermediate holds its url + the intermediate flag is dropped), or a request naming the intermediate would fail to match once the intermediate has rejoined and its entry is gone. The route stays in the identity (it selects the store/folder). */
-function sourceMatchKey(config: SourceConfig): string {
-    let url = config.intermediate || config.url;
-    return stableStringify({ ...config, url, intermediate: undefined, validWindow: undefined });
-}
-
-/** The store serving a request: the config entry the CLIENT selected, matched against the bucket's own entries by identity EXCLUDING the valid window (see sourceMatchKey). The selection never validates - the store's own window/route checks throw if the caller is stale - so honoring a window mismatch here is exactly right. Throws when nothing matches, listing what is available. */
+/** The store serving a request: the one the client's selected entry NAMES. Nothing else is compared - not the window, not the route, not the flags - because the name is what says which storage this is, and everything else is policy the store itself applies to the request. A client a config version behind on some flag therefore still reaches the right store, which is the whole point of naming it. */
 export async function findBucketStore(account: string, bucketName: string, sourceConfig: SourceConfig | undefined): Promise<LoadedStore> {
     let bucket = await requireBucket(account, bucketName);
     if (!sourceConfig) {
-        throw new Error(`No remote source configuration was provided for bucket ${account}/${bucketName}: every request must say which configured source it selected. Available: ${JSON.stringify(bucket.selfEntries)}`);
+        throw new Error(`No remote source configuration was provided for bucket ${account}/${bucketName}: every request must say which configured source it selected. This server has: ${JSON.stringify(bucket.stores.map(x => x.name))}`);
     }
-    let wanted = sourceMatchKey(sourceConfig);
-    for (let s of bucket.stores) {
-        if (s.entries.some(e => sourceMatchKey(e) === wanted)) return s;
+    let store = bucket.stores.find(x => x.name === sourceConfig.name);
+    if (store) return store;
+    // The loaded bucket is a snapshot of the disk from when it loaded; a store created since (a new name in a rewritten routing config) is on the disk but not in the snapshot, so a miss re-reads the disk once before it is believed
+    let previousNames = bucket.stores.map(x => x.name);
+    let reloaded = await reloadBucket(account, bucketName);
+    store = reloaded?.stores.find(x => x.name === sourceConfig.name);
+    if (store) {
+        console.log(`Reloaded bucket ${account}/${bucketName} to find store ${JSON.stringify(sourceConfig.name)}: its stores changed from ${JSON.stringify(previousNames)} to ${JSON.stringify(reloaded?.stores.map(x => x.name))}`);
+        return store;
     }
-    throw new Error(`No source on this server matches the requested remote configuration for bucket ${account}/${bucketName}. Requested: ${JSON.stringify(sourceConfig)}. Available: ${JSON.stringify(bucket.selfEntries)}`);
+    throw new Error(`This server has no store named ${JSON.stringify(sourceConfig.name)} for bucket ${account}/${bucketName} (it has: ${JSON.stringify((reloaded || bucket).stores.map(x => x.name))}). Requested: ${JSON.stringify(sourceConfig)}`);
 }
 
 /** Internal (store-to-store) reads skip store selection entirely: the caller is another store whose index says this MACHINE holds the bytes - the persisted holder identity is just a URL, which cannot name a store. Whichever store's folder has the newest copy answers. */
@@ -100,8 +91,7 @@ export function getBucketConfig(bucket: BucketState): ArchivesConfig {
     let syncing: SyncActivity[] = [];
     let readerDiskLimit: number | undefined;
     for (let s of bucket.stores) {
-        let progress = s.store.getSyncProgress?.();
-        if (!progress) continue;
+        let progress = s.store.getSyncProgress();
         index.fileCount += progress.index.fileCount;
         index.byteCount += progress.index.byteCount;
         indexSources.push(...progress.sources);
@@ -109,8 +99,8 @@ export function getBucketConfig(bucket: BucketState): ArchivesConfig {
         readerDiskLimit = readerDiskLimit || progress.readerDiskLimit;
     }
     return {
-        // Native change-feed support = the stores keep an index (rawDisk buckets emulate getChangesAfter2 with a full listing) - clients use this to pick their scan cadence
-        supportsChangesAfter: bucket.stores.some(s => s.store instanceof BlobStore),
+        // Every store is index-backed, so the change feed is always native
+        supportsChangesAfter: true,
         remoteConfig: bucket.routing,
         index,
         indexSources,
@@ -120,17 +110,7 @@ export function getBucketConfig(bucket: BucketState): ArchivesConfig {
 }
 
 export async function bucketSyncStatus(bucket: BucketState): Promise<ArchivesSyncStatus> {
-    let supported = bucket.stores.filter(s => s.store.getSyncStatus);
-    if (!supported.length) {
-        throw new Error(`Bucket ${bucket.account}/${bucket.bucketName} does not support getSyncStatus (rawDisk buckets have no synchronization)`);
-    }
-    let statuses = await Promise.all(supported.map(async s => {
-        let getSyncStatus = s.store.getSyncStatus;
-        if (!getSyncStatus) {
-            throw new Error(`getSyncStatus disappeared from a store for ${bucket.account}/${bucket.bucketName}`);
-        }
-        return await getSyncStatus.call(s.store);
-    }));
+    let statuses = await Promise.all(bucket.stores.map(s => s.store.getSyncStatus()));
     return {
         allScansComplete: statuses.every(x => x.allScansComplete),
         indexSize: statuses.reduce((sum, x) => sum + x.indexSize, 0),
@@ -138,16 +118,8 @@ export async function bucketSyncStatus(bucket: BucketState): Promise<ArchivesSyn
     };
 }
 
-export async function bucketIndexTotals(bucket: BucketState): Promise<{ fileCount: number; byteCount: number; sources: { debugName: string; fileCount: number; byteCount: number }[] } | undefined> {
-    let supported = bucket.stores.filter(s => s.store.computeIndexTotals);
-    if (!supported.length) return undefined;
-    let totals = await Promise.all(supported.map(async s => {
-        let computeIndexTotals = s.store.computeIndexTotals;
-        if (!computeIndexTotals) {
-            throw new Error(`computeIndexTotals disappeared from a store for ${bucket.account}/${bucket.bucketName}`);
-        }
-        return await computeIndexTotals.call(s.store);
-    }));
+export async function bucketIndexTotals(bucket: BucketState): Promise<{ fileCount: number; byteCount: number; sources: { debugName: string; fileCount: number; byteCount: number }[] }> {
+    let totals = await Promise.all(bucket.stores.map(s => s.store.computeIndexTotals()));
     return {
         fileCount: totals.reduce((sum, x) => sum + x.fileCount, 0),
         byteCount: totals.reduce((sum, x) => sum + x.byteCount, 0),
@@ -156,175 +128,12 @@ export async function bucketIndexTotals(bucket: BucketState): Promise<{ fileCoun
 }
 
 const buckets = new Map<string, Promise<BucketState | undefined>>();
+// The resolved ones, for the code that walks buckets rather than asking for one (see getBucketStates)
+const loadedBuckets = new Map<string, BucketState>();
 
-const MAX_REBUILD_TIMER_DELAY = 2 ** 31 - 1;
-const REBUILD_BOUNDARY_BUFFER = 1000;
-
-function scheduleWindowBoundaryRebuild(loaded: BucketState): void {
-    let now = Date.now();
-    let boundaries = loaded.selfEntries.flatMap(x => x.validWindow).filter(t => t > now);
-    if (!boundaries.length) return;
-    let nextBoundary = Math.min(...boundaries);
-    let key = `${loaded.account}/${loaded.bucketName}`;
-    let timer = setTimeout(() => {
-        void (async () => {
-            let current = await buckets.get(key);
-            if (current !== loaded) return;
-            if (Date.now() < nextBoundary) {
-                scheduleWindowBoundaryRebuild(loaded);
-                return;
-            }
-            await scheduleRoutingReload(loaded.account, loaded.bucketName, { force: true, reason: "a valid window boundary passed" });
-        })();
-    }, Math.min(nextBoundary - now + REBUILD_BOUNDARY_BUFFER, MAX_REBUILD_TIMER_DELAY));
-    (timer as { unref?: () => void }).unref?.();
-}
-
-const BOUNDARY_SCAN_OFFSETS = [-30 * 1000, 2 * 1000, 30 * 1000];
-const BOUNDARY_SCAN_LOOKBACK = DEFAULT_FAST_WRITE_DELAY + WINDOW_END_FLUSH_MARGIN;
-const STARTUP_BOUNDARY_SCAN_DELAY = 30 * 1000;
-
-const scheduledBoundaryScans = new Set<string>();
-const boundaryScansRunning = new Set<string>();
-
-function scheduleBoundaryScans(loaded: BucketState): void {
-    let key = `${loaded.account}/${loaded.bucketName}`;
-    let now = Date.now();
-    let starts = new Set<number>();
-    for (let self of loaded.selfEntries) {
-        let start = self.validWindow[0];
-        if (start > now && start < Number.MAX_SAFE_INTEGER) {
-            starts.add(start);
-        }
-    }
-    for (let self of loaded.selfEntries) {
-        let [start, end] = self.validWindow;
-        if (!(start <= now && now < end) || start <= 0) continue;
-        if (now - start > BOUNDARY_SCAN_LOOKBACK) continue;
-        let scheduleKey = `${key}|${start}|startup`;
-        if (scheduledBoundaryScans.has(scheduleKey)) continue;
-        scheduledBoundaryScans.add(scheduleKey);
-        let timer = setTimeout(() => {
-            void runBoundaryScan(key, start, STARTUP_BOUNDARY_SCAN_DELAY, "startup+30s").catch((e: Error) => console.error(`Boundary scan for bucket ${key} failed: ${e.stack ?? e}`));
-        }, STARTUP_BOUNDARY_SCAN_DELAY);
-        (timer as { unref?: () => void }).unref?.();
-    }
-    for (let start of starts) {
-        for (let offset of BOUNDARY_SCAN_OFFSETS) {
-            let at = start + offset;
-            if (at <= now) continue;
-            let scheduleKey = `${key}|${start}|${offset}`;
-            if (scheduledBoundaryScans.has(scheduleKey)) continue;
-            scheduledBoundaryScans.add(scheduleKey);
-            let arm = () => {
-                let timer = setTimeout(() => {
-                    if (Date.now() < at) {
-                        arm();
-                        return;
-                    }
-                    void runBoundaryScan(key, start, offset).catch((e: Error) => console.error(`Boundary scan for bucket ${key} failed: ${e.stack ?? e}`));
-                }, Math.min(at - Date.now(), MAX_REBUILD_TIMER_DELAY));
-                (timer as { unref?: () => void }).unref?.();
-            };
-            arm();
-        }
-    }
-}
-
-async function runBoundaryScan(bucketKey: string, windowStart: number, offset: number, offsetLabel?: string): Promise<void> {
-    let label = `bucket ${bucketKey}, window starting ${new Date(windowStart).toISOString()}, offset ${offsetLabel || `${offset / 1000}s`}`;
-    if (boundaryScansRunning.has(bucketKey)) {
-        console.log(`Skipping boundary scan (${label}): the previous boundary scan is still running`);
-        return;
-    }
-    boundaryScansRunning.add(bucketKey);
-    try {
-        let loaded = await buckets.get(bucketKey);
-        if (!loaded) return;
-        let effective = loaded.routing;
-        let selfIndexes = findSelfIndexes(effective, loaded.account, loaded.bucketName);
-        let selfIndexSet = new Set(selfIndexes);
-        let selves = selfIndexes.map(i => effective.sources[i] as HostedConfig).filter(x => x.validWindow[0] === windowStart);
-        if (!selves.length) return;
-        let prevTime = windowStart - 1;
-        // Everything is per-store: each self entry's route has its own store, and that store's disk/remote boundary pulls only concern its own route slice
-        let needDiskScan = new Set<LoadedStore>();
-        let remoteOwners = new Map<LoadedStore, Map<number, [number, number]>>();
-        for (let self of selves) {
-            let selfRoute = self.route || FULL_ROUTE;
-            let selfStore = loaded.stores.find(x => x.routeKey === JSON.stringify(selfRoute));
-            if (!selfStore || !(selfStore.store instanceof BlobStore)) continue;
-            let idx = effective.sources.indexOf(self);
-            let shadowed = false;
-            for (let j = 0; j < idx; j++) {
-                let other = effective.sources[j];
-                if (typeof other === "string") continue;
-                let [ws, we] = other.validWindow;
-                if (!(ws <= windowStart && windowStart < we)) continue;
-                let r = other.route || FULL_ROUTE;
-                if (r[0] <= selfRoute[0] && selfRoute[1] <= r[1]) {
-                    shadowed = true;
-                    break;
-                }
-            }
-            if (shadowed) continue;
-            let uncovered: [number, number][] = [[selfRoute[0], selfRoute[1]]];
-            for (let j = 0; j < effective.sources.length && uncovered.length; j++) {
-                let other = effective.sources[j];
-                if (typeof other === "string") continue;
-                let [ws, we] = other.validWindow;
-                if (!(ws <= prevTime && prevTime < we)) continue;
-                let r = other.route || FULL_ROUTE;
-                let remaining: [number, number][] = [];
-                let claimed: [number, number] | undefined;
-                for (let u of uncovered) {
-                    let inter = routeIntersection(u, r);
-                    if (!inter) {
-                        remaining.push(u);
-                        continue;
-                    }
-                    claimed = claimed && [Math.min(claimed[0], inter[0]), Math.max(claimed[1], inter[1])] as [number, number] || inter;
-                    if (u[0] < inter[0]) remaining.push([u[0], inter[0]]);
-                    if (inter[1] < u[1]) remaining.push([inter[1], u[1]]);
-                }
-                uncovered = remaining;
-                if (!claimed) continue;
-                if (selfIndexSet.has(j)) {
-                    needDiskScan.add(selfStore);
-                } else {
-                    let owners = remoteOwners.get(selfStore);
-                    if (!owners) {
-                        owners = new Map();
-                        remoteOwners.set(selfStore, owners);
-                    }
-                    let existing = owners.get(j);
-                    owners.set(j, existing && [Math.min(existing[0], claimed[0]), Math.max(existing[1], claimed[1])] as [number, number] || claimed);
-                }
-            }
-        }
-        if (!needDiskScan.size && !remoteOwners.size) return;
-        console.log(`Boundary scan (${label}): diskScans=${needDiskScan.size}, stores with remote previous-window owners: ${remoteOwners.size}`);
-        for (let selfStore of needDiskScan) {
-            if (selfStore.store instanceof BlobStore) {
-                await selfStore.store.rescanBase();
-            }
-        }
-        let since = windowStart - BOUNDARY_SCAN_LOOKBACK;
-        for (let [selfStore, owners] of remoteOwners) {
-            if (!(selfStore.store instanceof BlobStore)) continue;
-            for (let [sourceIndex, route] of owners) {
-                let ownerSource = effective.sources[sourceIndex];
-                if (typeof ownerSource === "string") continue;
-                try {
-                    await selfStore.store.boundaryScanRemote(createApiArchives(ownerSource), { since, route });
-                } catch (e) {
-                    console.error(`Boundary scan (${label}) of previous-window owner (source index ${sourceIndex}) failed: ${(e as Error).stack ?? e}`);
-                }
-            }
-        }
-    } finally {
-        boundaryScansRunning.delete(bucketKey);
-    }
+/** The bucket states currently in memory - what the switchover machinery walks. Only what is loaded: loading a bucket starts its synchronization, and a bucket nothing has touched has no in-flight writes to hand over anyway. */
+export function getBucketStates(): BucketState[] {
+    return [...loadedBuckets.values()];
 }
 
 const resolvedSourceArchives = new Map<string, IArchives>();
@@ -332,205 +141,117 @@ const resolvedSourceArchives = new Map<string, IArchives>();
 export function resolveSourceArchives(url: string): IArchives {
     let existing = resolvedSourceArchives.get(url);
     if (existing) return existing;
-    let archives: IArchives;
+    let sourceConfig: SourceConfig | undefined;
     if (url.startsWith("https://")) {
         // The config is fabricated from the bare URL and can never exact-match a server's entries - which is fine, because holder reads are internal reads, and internal reads never select a store (see readBucketInternal)
-        archives = createApiArchives(normalizeSource(url));
-    } else {
-        archives = new ArchivesDisk(url);
+        sourceConfig = normalizeSource(url);
     }
+    let archives = createStoreSource({ sourceConfig, folder: url });
     resolvedSourceArchives.set(url, archives);
     return archives;
 }
 
-function sourceIdentity(sourceConfig: SourceConfig | undefined): string {
-    if (!sourceConfig) return "disk";
-    return JSON.stringify({ ...sourceConfig, validWindow: undefined, route: undefined });
+/** What an index entry records as the holder of its bytes (see ArchivesSource.url), so it must name the endpoint FOREVER. An intermediate is a switchover's temporary alternate port onto another source, and that port is gone for good once its window passes - so it is recorded as the source it was split out of, which holds the same bucket and outlives it. */
+function sourcePersistentUrl(sourceConfig: SourceConfig | undefined, folder: string): string {
+    if (!sourceConfig) return folder;
+    return sourceConfig.intermediate || sourceConfig.url;
 }
 
-function buildStore(account: string, bucketName: string, planStore: StorePlanStore): IBucketStore {
-    let folder = getBucketFolder(account, bucketName, planStore.route);
-    if (planStore.rawDisk) {
-        return new RawDiskStore(new ArchivesDisk(folder));
-    }
-    let sources: ArchivesSource[] = planStore.sourceSpecs.map(spec => ({
-        source: spec.sourceConfig && createApiArchives(spec.sourceConfig) || new ArchivesDisk(folder),
-        url: spec.sourceConfig?.url || folder,
-        validWindows: spec.validWindows,
-        route: spec.route,
-        noFullSync: spec.noFullSync,
-        intermediate: spec.sourceConfig?.intermediate,
-        sourceConfig: spec.sourceConfig,
-        identity: sourceIdentity(spec.sourceConfig),
-    }));
-    return new BlobStore(folder, sources, {
-        readerDiskLimit: planStore.readerDiskLimit,
+/** The fast-write policy this store writes under: its own configuration decides it (fast/writeDelay are OUR settings, not the peer's), and each source then holds writes for as long as sourceWriteDelay says. */
+/**
+ * Every store this process runs, by folder - which IS the store's identity: account, name, bucket.
+ * A store is made once, configures itself from the routing config it holds, and stays; nothing here
+ * decides what it is, only that it exists.
+ */
+const stores = new Map<string, BlobStore>();
+
+export function getStore(account: string, bucketName: string, name: string): BlobStore {
+    let folder = getBucketFolder(name, account, bucketName);
+    let existing = stores.get(folder);
+    if (existing) return existing;
+    let store = new BlobStore(folder, name, {
+        // Which entries in ITS routing config are this server's copy of it
+        isSelf: source => isSelfSource(source, account, bucketName),
+        createSource: config => createStoreSource({ sourceConfig: config.sourceConfig, folder, writeDelay: config.writeDelay }),
+        applySource: (source, sourceConfig, writeDelay) => applySourceConfig(source, sourceConfig, writeDelay),
         onWriteCounted: (kind, bytes) => countBucketWrite(`${account}/${bucketName}`, kind, bytes),
         resolveSourceUrl: resolveSourceArchives,
-        entries: planStore.entries,
     });
-}
-
-function buildBucket(account: string, bucketName: string, routing: RemoteConfig, plan?: StorePlan): BucketState {
-    if (!plan) {
-        plan = computeStorePlan(account, bucketName, routing);
-    }
-    let { selfEntries, self } = plan;
-    if (!self) {
-        console.log(`This server is not in the routing config for bucket ${account}/${bucketName}: no longer synchronizing, valid window treated as [0, 0] (fast writes flush immediately), disk data kept and served`);
-    }
-    let stores: LoadedStore[] = plan.stores.map(planStore => ({
-        routeKey: planStore.routeKey,
-        route: planStore.route,
-        entries: planStore.entries,
-        folder: getBucketFolder(account, bucketName, planStore.route),
-        store: buildStore(account, bucketName, planStore),
+    stores.set(folder, store);
+    // Lazy init would leave a store nothing has touched sitting inert - no index loaded, no config applied, nothing synchronizing - while its folder is full of files
+    void store.init().catch((e: Error) => console.error(`Initializing store ${JSON.stringify(name)} of bucket ${account}/${bucketName} failed: ${e.stack ?? e}`));
+    return store;
+}
+
+/** The bucket as this server has it: the stores whose folders exist, plus whatever the newest of their configs says about us. Names come from the DISK, not from the config - a store we hold keeps being served whether or not the current config still mentions it. */
+function buildBucket(account: string, bucketName: string, names: string[], routing: RemoteConfig | undefined): BucketState {
+    let plan = routing && planSelfStores(account, bucketName, routing) || undefined;
+    let entriesByName = new Map<string, HostedConfig[]>();
+    for (let selfStore of plan?.stores || []) {
+        entriesByName.set(selfStore.name, selfStore.entries);
+    }
+    // Each store reads its own copy of the config and decides what it is - see BlobStore.applyRoutingConfig. Nothing here configures anything.
+    let stores: LoadedStore[] = names.map(name => ({
+        name,
+        entries: entriesByName.get(name) || [],
+        folder: getBucketFolder(name, account, bucketName),
+        store: getStore(account, bucketName, name),
     }));
-    let loaded: BucketState = { account, bucketName, routing, routingJSON: JSON.stringify(routing), selfEntries, self, stores, structureKey: plan.structureKey };
-    scheduleWindowBoundaryRebuild(loaded);
-    scheduleBoundaryScans(loaded);
-    // A loaded bucket must actually be running: each store's init loads its index and starts its source synchronization, and it is lazy, so without this a bucket nothing has read from or written to sits inert - reporting no data and no syncing while its disk is full of files.
-    for (let s of stores) {
-        if (s.store instanceof BlobStore) {
-            let store = s.store;
-            void store.init().catch((e: Error) => console.error(`Initializing the store for bucket ${account}/${bucketName} (route ${s.routeKey}) failed: ${e.stack ?? e}`));
-        }
-    }
+    let loaded: BucketState = { account, bucketName, routing, selfEntries: plan?.selfEntries || [], self: plan?.self, stores };
+    loadedBuckets.set(`${account}/${bucketName}`, loaded);
+    scheduleBoundaryWork(loaded);
     return loaded;
 }
 
+// A bucket exists here when it has at least one store folder - the disk IS the record. Its config is the newest copy among those stores; with none at all it has no config yet, which is a perfectly good state for a store nobody has configured.
 async function loadBucket(account: string, bucketName: string): Promise<BucketState | undefined> {
+    let folders = await listBucketStoreFolders(account, bucketName);
+    if (!folders.length) return undefined;
     let routing = await readRoutingFromDisk(account, bucketName);
-    if (!routing) return undefined;
-    return buildBucket(account, bucketName, routing);
+    return buildBucket(account, bucketName, folders.map(x => x.name), routing);
 }
 
 export function getLoadedBucket(account: string, bucketName: string): Promise<BucketState | undefined> {
     let key = `${account}/${bucketName}`;
-    let loaded = buckets.get(key);
-    if (!loaded) {
-        loaded = loadBucket(account, bucketName);
-        buckets.set(key, loaded);
-        void loaded.then(bucket => {
-            if (!bucket && buckets.get(key) === loaded) {
-                buckets.delete(key);
-            }
-        }, () => {
-            if (buckets.get(key) === loaded) {
-                buckets.delete(key);
-            }
-        });
-    }
-    return loaded;
-}
-
-const routingReloads = new Map<string, Promise<void>>();
-function scheduleRoutingReload(account: string, bucketName: string, config?: { force?: boolean; reason?: string }): Promise<void> {
-    let key = `${account}/${bucketName}`;
-    let next = (routingReloads.get(key) || Promise.resolve())
-        .then(() => checkRoutingChanged(account, bucketName, config))
-        .catch(e => console.error(`Reloading routing config for bucket ${key} failed:`, e));
-    routingReloads.set(key, next);
-    return next;
+    return buckets.get(key) || reloadBucket(account, bucketName);
 }
 
-async function checkRoutingChanged(account: string, bucketName: string, config?: { force?: boolean; reason?: string }): Promise<void> {
+/** Re-reads the bucket off the disk, replacing the cached snapshot: what a routing-config write calls, because that write can CREATE a store (a new name gets a new folder) and the snapshot would keep answering with the stores it saw at load time. Existing stores are reused (getStore caches by folder), so this only picks up folder changes - it never restarts a store. */
+export async function reloadBucket(account: string, bucketName: string): Promise<BucketState | undefined> {
     let key = `${account}/${bucketName}`;
-    let loaded = await buckets.get(key);
-    if (!loaded) return;
-    let routing = await readRoutingFromDisk(account, bucketName);
-    if (!routing) return;
-    if (!config?.force && JSON.stringify(routing) === loaded.routingJSON) return;
-    let reason = config?.force && (config.reason || "forced") || "routing config changed";
-    let plan = computeStorePlan(account, bucketName, routing);
-    if (plan.structureKey === loaded.structureKey) {
-        console.log(`Applying the routing config to the running stores for bucket ${key} (${reason})`);
-        for (let planStore of plan.stores) {
-            let live = loaded.stores.find(x => x.routeKey === planStore.routeKey);
-            // structureKey equality means the store set (routes, rawDisk, limits) is unchanged, so every plan store has its live twin
-            if (!live || !(live.store instanceof BlobStore)) continue;
-            let storeFolder = live.folder;
-            live.store.updateSources(planStore.sourceSpecs.map(spec => {
-                const sourceConfig = spec.sourceConfig;
-                if (!sourceConfig) {
-                    return { identity: sourceIdentity(undefined), url: storeFolder, validWindows: spec.validWindows, create: (): IArchives => new ArchivesDisk(storeFolder) };
-                }
-                return {
-                    identity: sourceIdentity(sourceConfig),
-                    url: sourceConfig.url,
-                    validWindows: spec.validWindows,
-                    route: spec.route,
-                    noFullSync: spec.noFullSync,
-                    intermediate: sourceConfig.intermediate,
-                    sourceConfig,
-                    create: () => createApiArchives(sourceConfig),
-                };
-            }), planStore.entries);
-            live.entries = planStore.entries;
+    let loaded = loadBucket(account, bucketName);
+    buckets.set(key, loaded);
+    void loaded.then(bucket => {
+        if (!bucket && buckets.get(key) === loaded) {
+            buckets.delete(key);
         }
-        loaded.routing = routing;
-        loaded.routingJSON = JSON.stringify(routing);
-        loaded.selfEntries = plan.selfEntries;
-        loaded.self = plan.self;
-        scheduleWindowBoundaryRebuild(loaded);
-        scheduleBoundaryScans(loaded);
-        broadcastRoutingChanged();
-        return;
-    }
-    console.log(`Rebuilding the stores for bucket ${key} (${reason}): structure changed from ${loaded.structureKey} to ${plan.structureKey}`);
-    for (let s of loaded.stores) {
-        if (s.store instanceof BlobStore) {
-            await s.store.dispose();
+    }, () => {
+        if (buckets.get(key) === loaded) {
+            buckets.delete(key);
         }
-    }
-    buckets.set(key, Promise.resolve(buildBucket(account, bucketName, routing, plan)));
-    broadcastRoutingChanged();
-}
-
-const routingWrites = new Map<string, Promise<void>>();
-
-/** The routing-config write path - the ONE write that cannot go through a store (it is what CREATES the bucket and its stores). Serialized per bucket: concurrent config writes would race the version check. */
-export async function queueRoutingConfigWrite(account: string, bucketName: string, data: Buffer, config?: { lastModified?: number }): Promise<void> {
+    });
+    return await loaded;
+}
+
+/**
+ * Writing the routing config is a write like any other: it goes into a store, and the store applies
+ * it to itself and lets its peers pull it. The only thing that happens here is picking WHICH store,
+ * because the writer names a source and a source names a store.
+ *
+ * In-flight switchover windows are re-injected first (see intermediateManagement): an operator's
+ * config knows nothing about a switchover that is happening right now, and writing it as-is would
+ * cancel it mid-flight.
+ */
+export async function writeRoutingConfig(account: string, bucketName: string, name: string, data: Buffer, config?: { lastModified?: number }): Promise<void> {
     assertWritesAllowed();
-    let key = `${account}/${bucketName}`;
-    let run = (routingWrites.get(key) || Promise.resolve()).then(() => writeRoutingConfig(account, bucketName, data, config));
-    routingWrites.set(key, run.then(() => { }, () => { }));
-    return await run;
-}
-
-async function writeRoutingConfig(account: string, bucketName: string, data: Buffer, config?: { lastModified?: number }): Promise<void> {
-    let key = `${account}/${bucketName}`;
+    let store = getStore(account, bucketName, name);
     let incoming = parseRoutingData(data);
-    let loaded = await getLoadedBucket(account, bucketName);
-    if (!loaded) {
-        await resolveSourceArchives(getBucketFolder(account, bucketName)).set(ROUTING_FILE, data, { lastModified: config?.lastModified });
-        buckets.set(key, Promise.resolve(buildBucket(account, bucketName, incoming)));
-        broadcastRoutingChanged();
-        console.log(`Created bucket ${key}`);
-        return;
-    }
-    if (JSON.stringify(incoming) !== loaded.routingJSON && getConfigVersion(incoming) <= getConfigVersion(loaded.routing)) {
-        let message = `Cannot update routing config for bucket ${key}: the new config differs from the current one but its version (${getConfigVersion(incoming)}) is not greater than the current version (${getConfigVersion(loaded.routing)}). Increment the version to update it. Current: ${loaded.routingJSON}. Attempted: ${JSON.stringify(incoming)}`;
-        console.error(message);
-        throw new Error(message);
-    }
-    let stored = incoming;
-    let reinjected = 0;
-    for (let intermediate of getIntermediateSources(expireIntermediateSources(loaded.routing, Date.now()))) {
-        stored = injectIntermediateSource(stored, {
-            splitUrl: intermediate.intermediate || intermediate.url,
-            intermediateUrl: intermediate.url,
-            start: intermediate.validWindow[0],
-            end: intermediate.validWindow[1],
-        });
-        reinjected++;
-    }
-    if (JSON.stringify(stored) !== JSON.stringify(incoming)) {
-        console.log(`Re-injected ${reinjected} in-flight switchover windows into the incoming routing config for bucket ${key} (version ${getConfigVersion(incoming)})`);
-    }
-    // Written straight into the plain bucket folder: the routing file defines the per-route stores, so it never flows through them
-    await resolveSourceArchives(getBucketFolder(account, bucketName)).set(ROUTING_FILE, Buffer.from(serializeRemoteConfig(stored)), { lastModified: config?.lastModified });
-    await scheduleRoutingReload(account, bucketName);
+    let current = (await getLoadedBucket(account, bucketName))?.routing;
+    let stored = reinjectIntermediates(current, incoming);
+    await store.set({ path: ROUTING_FILE, data: Buffer.from(serializeRemoteConfig(stored)), lastModified: config?.lastModified });
+    // The write may have CREATED the store (a new name gets a new folder), and the loaded bucket is a snapshot of the disk - so it is re-read, or every data write naming the new store is rejected until a restart
+    await reloadBucket(account, bucketName);
+    broadcastRoutingChanged();
 }
 
 /** Which buckets this process currently has loaded - what a deploy successor asks its predecessor for, so it activates exactly the buckets that are actually in use. */
@@ -541,141 +262,6 @@ export function getActiveBucketKeys(): { account: string; bucketName: string }[]
     });
 }
 
-export async function rebuildAllLoadedBuckets(): Promise<void> {
-    for (let key of [...buckets.keys()]) {
-        let slash = key.indexOf("/");
-        await scheduleRoutingReload(key.slice(0, slash), key.slice(slash + 1), { force: true, reason: "all loaded buckets were asked to rebuild" });
-    }
-}
-
-const OWN_CONFIG_WRITE_THROTTLE = 30 * 1000;
-const INTERMEDIATE_MAINTAIN_INTERVAL = 60 * 1000;
-// Per bucket, not global: a switchover has to write every bucket's windows at once, and a shared throttle would let only one bucket through per interval
-const lastOwnConfigWrite = new Map<string, number>();
-
-async function writeOwnRoutingConfig(loaded: BucketState, updated: RemoteConfig, reason: string): Promise<void> {
-    let key = `${loaded.account}/${loaded.bucketName}`;
-    let sinceLast = Date.now() - (lastOwnConfigWrite.get(key) || 0);
-    if (sinceLast < OWN_CONFIG_WRITE_THROTTLE) {
-        console.log(`Not writing our own routing config update for bucket ${key} (${reason}): the last one was ${sinceLast}ms ago, under the ${OWN_CONFIG_WRITE_THROTTLE}ms throttle. Retrying on the next maintenance pass. Wanted: ${JSON.stringify(updated)}`);
-        return;
-    }
-    lastOwnConfigWrite.set(key, Date.now());
-    let version = nextIntermediateVersion(getConfigVersion(loaded.routing));
-    let next: RemoteConfig = { ...updated, version };
-    console.log(`Writing ${ROUTING_FILE} for bucket ${key} (${reason}), version ${getConfigVersion(loaded.routing)} -> ${version}: ${JSON.stringify(next)}`);
-    let data = Buffer.from(serializeRemoteConfig(next));
-    await queueRoutingConfigWrite(loaded.account, loaded.bucketName, data);
-    await propagateRoutingConfig(loaded, next, data);
-}
-
-async function propagateRoutingConfig(loaded: BucketState, next: RemoteConfig, data: Buffer): Promise<void> {
-    let targets = new Map<string, SourceConfig>();
-    for (let source of [...loaded.routing.sources, ...next.sources]) {
-        if (typeof source === "string" || source.intermediate) continue;
-        if (source.type === "remote") {
-            let parsed = parseHostedUrl(source.url);
-            if (parsed.account !== loaded.account || parsed.bucketName !== loaded.bucketName) continue;
-        }
-        if (targets.has(source.url)) continue;
-        targets.set(source.url, source);
-    }
-    for (let [url, source] of targets) {
-        try {
-            await createApiArchives(source).set(ROUTING_FILE, data);
-            console.log(`Wrote ${ROUTING_FILE} for bucket ${loaded.account}/${loaded.bucketName} to ${url}`);
-        } catch (e) {
-            console.error(`Propagating our routing config update to ${url} failed: ${(e as Error).stack ?? e}`);
-        }
-    }
-}
-
-async function maintainIntermediates(): Promise<void> {
-    let { domain, port } = getStorageServerConfig();
-    let takeover = getTakeoverIntermediate();
-    let written: string[] = [];
-    let alreadyCorrect: string[] = [];
-    let notOurs: string[] = [];
-    // ONLY buckets already in memory. A switchover must never load a bucket: loading starts its synchronization, and buckets nothing has touched (legacy ones especially) have no writes to hand off in the first place. One that does get used mid-switchover loads on that access, and the next pass gives it its window.
-    let keys = [...buckets.keys()];
-    for (let key of keys) {
-        let loadedPromise = buckets.get(key);
-        if (!loadedPromise) continue;
-        let loaded = await loadedPromise.catch(() => undefined);
-        if (!loaded) continue;
-        let expired = expireIntermediateSources(loaded.routing, Date.now());
-        if (JSON.stringify(expired) !== JSON.stringify(loaded.routing)) {
-            await writeOwnRoutingConfig(loaded, expired, `switchover windows expired more than ${INTERMEDIATE_EXPIRE_GRACE / 1000}s ago`);
-            written.push(key);
-            continue;
-        }
-        if (!takeover) continue;
-        let mainUrl = loaded.routing.sources.find(x => {
-            if (typeof x === "string" || x.type !== "remote" || x.intermediate) return false;
-            let parsed = parseHostedUrl(x.url);
-            return parsed.address === domain && parsed.port === port;
-        }) as HostedConfig | undefined;
-        if (!mainUrl) {
-            notOurs.push(key);
-            continue;
-        }
-        let injected = injectIntermediateSource(loaded.routing, {
-            splitUrl: mainUrl.url,
-            intermediateUrl: replaceHostedUrlPort(mainUrl.url, takeover.altPort),
-            start: takeover.start,
-            end: takeover.end,
-        });
-        if (JSON.stringify(injected) === JSON.stringify(loaded.routing)) {
-            alreadyCorrect.push(key);
-            continue;
-        }
-        await writeOwnRoutingConfig(loaded, injected, `we are a deploy successor: writes route to our alternate port ${takeover.altPort} from ${new Date(takeover.start).toISOString()} until our predecessor is killed at ${new Date(takeover.end).toISOString()}`);
-        written.push(key);
-    }
-    if (!takeover) return;
-    if (!keys.length) {
-        console.log(`No active buckets, so no config files to write the intermediate into (a bucket is only active once something uses it)`);
-        return;
-    }
-    if (!written.length) {
-        console.log(`Wrote no config files: of ${keys.length} active buckets, ${alreadyCorrect.length} already contain the intermediate and ${notOurs.length} are not hosted by us`);
-    }
-}
-
-/** Our predecessor still holds the main port and has been serving all along, so it - not us - knows which buckets are in use. We activate exactly those, which is what makes their config files get the intermediate; nothing else on disk is touched. */
-async function activatePredecessorBuckets(): Promise<void> {
-    let { domain, port } = getStorageServerConfig();
-    let url = `https://${domain}:${port}`;
-    let keys: { account: string; bucketName: string }[];
-    try {
-        keys = await listServerActiveBucketKeys({ url });
-    } catch (e) {
-        console.error(`Could not ask our predecessor on ${url} which buckets are active, so only buckets used on this process get the intermediate: ${(e as Error).stack ?? e}`);
-        return;
-    }
-    if (!keys.length) {
-        console.log(`Our predecessor on ${url} has no active buckets, so there are no config files to write the intermediate into`);
-        return;
-    }
-    console.log(`Our predecessor on ${url} has ${keys.length} active buckets, activating them here so their config files get the intermediate: ${keys.map(x => `${x.account}/${x.bucketName}`).join(", ")}`);
-    for (let { account, bucketName } of keys) {
-        try {
-            await getLoadedBucket(account, bucketName);
-        } catch (e) {
-            console.error(`Activating bucket ${account}/${bucketName} (active on our predecessor) failed: ${(e as Error).stack ?? e}`);
-        }
-    }
-}
-
-/** Started by deployTakeover once we are actually a deploy successor listening on an alternate port. Until then there are no switchover windows to write or expire, so nothing polls. */
-export const startIntermediateMaintenance = lazy(() => {
-    void (async () => {
-        await activatePredecessorBuckets();
-        await maintainIntermediates();
-    })().catch((e: Error) => console.error(`Writing the intermediate into the config files failed: ${e.stack ?? e}`));
-    runInfinitePoll(INTERMEDIATE_MAINTAIN_INTERVAL, maintainIntermediates);
-});
-
 export type ServerBucketInfo = {
     bucketName: string;
     active: boolean;
@@ -691,8 +277,8 @@ export type ServerBucketInfo = {
 
 export type ActiveBucketInfo = {
     folder: string;
-    /** The routing config the bucket is RUNNING on, straight from memory - including switchover windows written since it loaded */
-    routing: RemoteConfig;
+    /** The routing config the bucket is RUNNING on, straight from memory - including switchover windows written since it loaded. Absent when none of its stores has one yet. */
+    routing?: RemoteConfig;
     /** Our own entries in that config, and their summarized current role (routes union + flags) */
     selfEntries: HostedConfig[];
     self?: SelfSummary;
@@ -701,7 +287,8 @@ export type ActiveBucketInfo = {
 
 function toActiveBucketInfo(loaded: BucketState): ActiveBucketInfo {
     return {
-        folder: getBucketFolder(loaded.account, loaded.bucketName),
+        // One of its stores' folders - a bucket no longer has a folder of its own, it has one per store
+        folder: loaded.stores[0]?.folder || "",
         routing: loaded.routing,
         selfEntries: loaded.selfEntries,
         self: loaded.self,
@@ -739,13 +326,11 @@ export async function activateBucket(account: string, bucketName: string): Promi
         return `Bucket ${key} failed to load on this server: ${String((e as Error).stack ?? e).slice(0, 500)}`;
     }
     if (!loaded) {
-        return `Bucket ${key} does not exist on this server (no routing file in ${getBucketFolder(account, bucketName)})`;
+        return `Bucket ${key} does not exist on this server (it has no store folders under ${getBucketFolder("<name>", account, bucketName)})`;
     }
     // Wait for the indexes to load, so the totals we return are the real ones rather than zeroes from stores that have not read their index yet. The source scans keep running in the background.
     for (let s of loaded.stores) {
-        if (s.store instanceof BlobStore) {
-            await s.store.init();
-        }
+        await s.store.init();
     }
     if (!wasLoaded) {
         console.log(`Activated bucket ${key} on request: it is now loaded and synchronizing`);
@@ -764,19 +349,18 @@ export async function listAccountBuckets(account: string): Promise<ServerBucketI
             timings.set(name, (timings.get(name) || 0) + (Date.now() - began));
         }
     }
-    let accountFolder = path.join(getStorageServerConfig().folder, "buckets2", account);
-    let names: string[];
-    try {
-        names = await timed("readdir", () => fs.promises.readdir(accountFolder));
-    } catch {
-        return [];
+    // The disk is the record: a bucket exists here when it has at least one store folder, and several names for one bucket are still one bucket
+    let folders = await timed("readdir", () => listAccountStoreFolders(account));
+    let byBucket = new Map<string, string>();
+    for (let store of folders) {
+        if (byBucket.has(store.bucketName)) continue;
+        byBucket.set(store.bucketName, store.folder);
     }
-    // Per-route folders (bucketName-route-<start>-<end>) belong to the same bucket as the plain folder - collapse them so one bucket lists once
-    names = [...new Set(names.map(x => x.replace(/-route-[\d.]+-[\d.]+$/, "")))];
+    let names = [...byBucket.keys()];
     try {
         return await Promise.all(names.map(async bucketName => {
             let key = `${account}/${bucketName}`;
-            let folder = getBucketFolder(account, bucketName);
+            let folder = byBucket.get(bucketName) || "";
             let base: ServerBucketInfo = { bucketName, active: false, folder };
             base.disk = await timed("statfs", () => getDiskInfo(folder)).catch((e: Error) => {
                 base.diskError = String(e.stack ?? e).slice(0, 500);
@@ -795,11 +379,10 @@ export async function listAccountBuckets(account: string): Promise<ServerBucketI
                 }
             }
             try {
-                const data = await timed("readRoutingFile", () => readRoutingFile(folder));
-                if (!data) {
-                    return { ...base, error: `No routing file (${ROUTING_FILE})` };
+                const parsed = await timed("readRoutingFile", () => readRoutingFromDisk(account, bucketName));
+                if (!parsed) {
+                    return { ...base, error: `No routing file (${ROUTING_FILE}) in any of its stores` };
                 }
-                let parsed = await timed("parseRouting", async () => parseRoutingData(data));
                 return { ...base, config: { remoteConfig: parsed } };
             } catch (e) {
                 return { ...base, error: String((e as Error).stack ?? e).slice(0, 500) };
@@ -858,101 +441,3 @@ export function clearAccountWriteStats(account: string): number {
     console.log(`Cleared the write statistics of ${cleared} buckets in account ${account}`);
     return cleared;
 }
-
-const LARGE_FILE_PART_SIZE = 8 * 1024 * 1024;
-
-// Wraps a locally hosted bucket in the IArchives interface, so code written against IArchives (the chain, sync sources, holder reads) talks to it directly instead of becoming a network client to ourselves.
-class BucketIArchivesWrapper implements IArchives {
-    constructor(private account: string, private bucketName: string, private sourceConfig: SourceConfig) { }
-
-    private findStore(): Promise<LoadedStore> {
-        return findBucketStore(this.account, this.bucketName, this.sourceConfig);
-    }
-
-    public getDebugName() {
-        return `localBucket account ${this.account} bucket ${this.bucketName} route ${JSON.stringify(this.sourceConfig.route || FULL_ROUTE)}`;
-    }
-    public async get(fileName: string, config?: GetConfig): Promise<Buffer | undefined> {
-        let result = await this.get2(fileName, config);
-        return result && result.data || undefined;
-    }
-    public async get2(fileName: string, config?: GetConfig): Promise<{ data: Buffer; writeTime: number; size: number } | undefined> {
-        if (fileName === ROUTING_FILE) {
-            return await getRoutingFileResult(this.account, this.bucketName);
-        }
-        if (config?.internal) {
-            return await readBucketInternal(this.account, this.bucketName, { path: fileName, range: config.range, includeTombstones: config.includeTombstones });
-        }
-        return await (await this.findStore()).store.get2({ path: fileName, ...config });
-    }
-    public async set(fileName: string, data: Buffer, config?: SetConfig): Promise<string> {
-        assertWritesAllowed();
-        if (fileName === ROUTING_FILE) {
-            await queueRoutingConfigWrite(this.account, this.bucketName, data, config);
-            return fileName;
-        }
-        await (await this.findStore()).store.set({ ...config, path: fileName, data });
-        return fileName;
-    }
-    public async del(fileName: string, config?: DelConfig): Promise<void> {
-        assertWritesAllowed();
-        await (await this.findStore()).store.del({ path: fileName, ...config });
-    }
-    public async setLargeFile(config: { path: string; lastModified?: number; getNextData(): Promise<Buffer | undefined> }): Promise<void> {
-        assertWritesAllowed();
-        let store = (await this.findStore()).store;
-        let id = await store.startLargeUpload({ path: config.path, lastModified: config.lastModified });
-        try {
-            while (true) {
-                let data = await config.getNextData();
-                if (!data) break;
-                for (let offset = 0; offset < data.length; offset += LARGE_FILE_PART_SIZE) {
-                    await store.appendLargeUpload({ id, data: data.subarray(offset, offset + LARGE_FILE_PART_SIZE) });
-                }
-            }
-            await store.finishLargeUpload({ id, path: config.path, lastModified: config.lastModified });
-        } catch (e) {
-            await store.cancelLargeUpload({ id });
-            throw e;
-        }
-    }
-    public async getInfo(fileName: string, config?: GetInfoConfig): Promise<{ writeTime: number; size: number } | undefined> {
-        if (fileName === ROUTING_FILE) {
-            let result = await getRoutingFileResult(this.account, this.bucketName);
-            return result && { writeTime: result.writeTime, size: result.size } || undefined;
-        }
-        return await (await this.findStore()).store.getInfo({ path: fileName, ...config });
-    }
-    public async findInfo(prefix: string, config?: FindConfig): Promise<ArchiveFileInfo[]> {
-        return await (await this.findStore()).store.findInfo({ prefix, ...config });
-    }
-    public async find(prefix: string, config?: FindConfig): Promise<string[]> {
-        return (await this.findInfo(prefix, config)).map(x => x.path);
-    }
-    public async getURL(filePath: string): Promise<string> {
-        let { domain, port } = getStorageServerConfig();
-        return buildFileUrl(`https://${domain}:${port}/file/${encodeURIComponent(this.account)}/${encodeURIComponent(this.bucketName)}`, filePath);
-    }
-    public async getConfig(): Promise<ArchivesConfig> {
-        return getBucketConfig(await requireBucket(this.account, this.bucketName));
-    }
-    public async hasWriteAccess(): Promise<boolean> {
-        return true;
-    }
-    public async getChangesAfter2(config: ChangesAfterConfig): Promise<ArchiveFileInfo[]> {
-        return await (await this.findStore()).store.getChangesAfter2(config);
-    }
-    public async getSyncStatus(): Promise<ArchivesSyncStatus> {
-        return await bucketSyncStatus(await requireBucket(this.account, this.bucketName));
-    }
-}
-
-const localArchives = new Map<string, IArchives>();
-export function getLocalArchives(account: string, bucketName: string, sourceConfig: SourceConfig): IArchives {
-    let key = `${account}/${bucketName}|${stableStringify(sourceConfig)}`;
-    let existing = localArchives.get(key);
-    if (existing) return existing;
-    let archives = new BucketIArchivesWrapper(account, bucketName, sourceConfig);
-    localArchives.set(key, archives);
-    return archives;
-}