@fireproof/core 0.20.0-dev-preview-39 → 0.20.0-dev-preview-41

package/index.d.cts

@@ -206,9 +206,9 @@ declare class TaskManager {
     private queue;
     private isProcessing;
     readonly logger: Logger;
-    readonly callback: (dbMeta: DbMeta) => Promise<void>;
-    constructor(sthis: SuperThis, callback: (dbMeta: DbMeta) => Promise<void>);
-    handleEvent(cid: CarClockLink, parents: CarClockHead, dbMeta: DbMeta): Promise<void>;
+    readonly callback: (dbMeta: DbMeta, store: ActiveStore) => Promise<void>;
+    constructor(sthis: SuperThis, callback: (dbMeta: DbMeta, store: ActiveStore) => Promise<void>);
+    handleEvent(cid: CarClockLink, parents: CarClockHead, dbMeta: DbMeta, store: ActiveStore): Promise<void>;
     private processQueue;
 }
 
@@ -517,7 +517,7 @@ interface StoreUrlsOpts {
 }
 interface StoreURIs {
     readonly meta: URI;
-    readonly data: URI;
+    readonly car: URI;
     readonly file: URI;
     readonly wal: URI;
 }
@@ -525,15 +525,16 @@ interface StoreURIRuntime {
     readonly data: StoreURIs;
     readonly idx: StoreURIs;
 }
-interface StoreFactoryItem {
+interface UrlAndInterceptor {
     readonly url: URI;
     readonly gatewayInterceptor?: SerdeGatewayInterceptor;
+}
+interface StoreFactoryItem {
+    readonly byStore: GatewayUrls;
     readonly loader: Loadable;
 }
 interface StoreRuntime {
-    makeMetaStore(sfi: StoreFactoryItem): Promise<MetaStore>;
-    makeDataStore(sfi: StoreFactoryItem): Promise<DataStore>;
-    makeWALStore(sfi: StoreFactoryItem): Promise<WALStore>;
+    makeStores(sfi: StoreFactoryItem): Promise<DataAndMetaAndWalStore>;
     encodeFile(blob: BlobLike): Promise<{
         cid: AnyLink;
         blocks: AnyBlock[];
@@ -544,6 +545,19 @@ interface CommitOpts {
     readonly noLoader?: boolean;
     readonly compact?: boolean;
 }
+interface WriteableDataAndMetaStore {
+    file: DataStore;
+    car: DataStore;
+    meta: MetaStore;
+}
+type DataAndMetaStore = Readonly<WriteableDataAndMetaStore>;
+interface WriteableDataAndMetaAndWalStore extends WriteableDataAndMetaStore {
+    wal?: WALStore;
+}
+type DataAndMetaAndWalStore = Readonly<WriteableDataAndMetaAndWalStore>;
+type LocalDataAndMetaAndWalStore = Readonly<Omit<WriteableDataAndMetaAndWalStore, "wal">> & {
+    readonly wal: WALStore;
+};
 interface DbMeta {
     readonly cars: CarGroup;
 }
@@ -562,14 +576,13 @@ interface Connection {
 interface BaseStore {
     readonly storeType: StoreType;
     readonly realGateway: SerdeGateway;
+    readonly logger: Logger;
     url(): URI;
-    onStarted(fn: () => void): void;
-    onClosed(fn: () => void): void;
     keyedCrypto(): Promise<CryptoAction>;
     close(): Promise<Result<void>>;
     destroy(): Promise<Result<void>>;
     readonly ready?: () => Promise<void>;
-    start(): Promise<Result<URI>>;
+    start(dam: DataAndMetaStore): Promise<Result<URI>>;
 }
 interface DbMetaEvent {
     readonly eventCid: CarClockLink;
@@ -653,27 +666,69 @@ interface BlockstoreRuntime {
     readonly meta?: DbMeta;
     readonly threshold: number;
 }
+type LocalActiveStore = Omit<ActiveStore, "active"> & {
+    readonly active: LocalDataAndMetaAndWalStore;
+};
+interface AttachedStores {
+    local(): LocalActiveStore;
+    forRemotes(actionFn: (store: ActiveStore) => Promise<unknown>): Promise<void>;
+    remotes(): ActiveStore[];
+    activate(store: DataAndMetaStore): ActiveStore;
+    attach(attached: Attachable): Promise<Attached>;
+    detach(): Promise<void>;
+}
+interface DataAttachedStores {
+    local(): DataStore;
+    remotes(): DataStore[];
+}
+interface DataActiveStore {
+    readonly ref: ActiveStore;
+    readonly active: DataStore;
+    readonly attached: DataAttachedStores;
+}
+interface MetaAttachedStores {
+    local(): MetaStore;
+    remotes(): MetaStore[];
+}
+interface MetaActiveStore {
+    readonly ref: ActiveStore;
+    readonly active: MetaStore;
+    readonly attached: MetaAttachedStores;
+}
+interface WALAttachedStores {
+    local(): WALStore;
+    remotes(): WALStore[];
+}
+interface WALActiveStore {
+    readonly ref: ActiveStore;
+    readonly active: WALStore;
+    readonly attached: WALAttachedStores;
+}
+interface ActiveStore {
+    readonly active: DataAndMetaAndWalStore;
+    baseStores(): BaseStore[];
+    carStore(): DataActiveStore;
+    fileStore(): DataActiveStore;
+    metaStore(): MetaActiveStore;
+    walStore(): WALActiveStore;
+    readonly attached: AttachedStores;
+}
 interface Loadable {
     readonly sthis: SuperThis;
     readonly ebOpts: BlockstoreRuntime;
     carLog: CarLog;
-    remoteMetaStore?: MetaStore;
-    remoteFileStore?: DataStore;
-    remoteCarStore?: DataStore;
+    readonly attachedStores: AttachedStores;
+    attach(attached: Attachable): Promise<Attached>;
     readonly taskManager: TaskManager;
     ready(): Promise<void>;
     close(): Promise<void>;
     keyBag(): Promise<KeyBag>;
-    metaStore(): Promise<MetaStore>;
-    fileStore(): Promise<DataStore>;
-    WALStore(): Promise<WALStore>;
-    carStore(): Promise<DataStore>;
-    handleDbMetasFromStore(metas: DbMeta[]): Promise<void>;
+    handleDbMetasFromStore(metas: DbMeta[], store: ActiveStore): Promise<void>;
     commit<T = TransactionMeta>(t: CarTransaction, done: T, opts: CommitOpts): Promise<CarGroup>;
     destroy(): Promise<void>;
-    getBlock(cid: AnyLink): Promise<AnyBlock | Falsy>;
-    loadFileCar(cid: AnyLink): Promise<CarReader>;
-    loadCar(cid: AnyLink): Promise<CarReader>;
+    getBlock(cid: AnyLink, store: ActiveStore): Promise<AnyBlock | Falsy>;
+    loadFileCar(cid: AnyLink, store: ActiveStore): Promise<CarReader>;
+    loadCar(cid: AnyLink, store: ActiveStore): Promise<CarReader>;
     commitFiles(t: CarTransaction, done: TransactionMeta): Promise<CarGroup>;
     entries(cache?: boolean): AsyncIterableIterator<AnyBlock>;
 }
@@ -755,6 +810,20 @@ declare function registerStoreProtocol(item: SerdeOrGatewayFactoryItem): () => v
 declare function getGatewayFactoryItem(protocol: string): SerdeGatewayFactoryItem | undefined;
 declare function defaultGatewayFactoryItem(): SerdeGatewayFactoryItem;
 
+declare function createAttachedStores(urlOrGup: CoerceURI | GatewayUrlsParam, arOrLoadable: AttachedStores | Loadable, name?: string): Promise<Attached>;
+declare class AttachedRemotesImpl implements AttachedStores {
+    private readonly _remotes;
+    readonly loadable: Loadable;
+    _local?: Attached;
+    constructor(loadable: Loadable);
+    forRemotes(action: (store: ActiveStore) => Promise<unknown>): Promise<void>;
+    remotes(): ActiveStore[];
+    local(): LocalActiveStore;
+    activate(store: DataAndMetaStore | CoerceURI): ActiveStore;
+    detach(): Promise<void>;
+    attach(attached: Attachable): Promise<Attached>;
+}
+
 declare class Loader implements Loadable {
     readonly ebOpts: BlockstoreRuntime;
     readonly commitQueue: CommitQueue<CarGroup>;
@@ -765,20 +834,11 @@ declare class Loader implements Loadable {
     readonly sthis: SuperThis;
     readonly taskManager: TaskManager;
     carLog: CarLog;
-    remoteMetaStore?: MetaStore;
-    remoteCarStore?: DataStore;
-    remoteFileStore?: DataStore;
+    readonly attachedStores: AttachedStores;
+    attach(attached: Attachable): Promise<Attached>;
     private getBlockCache;
     private seenMeta;
     private writeLimit;
-    private readonly _carStore;
-    carStore(): Promise<DataStore>;
-    private readonly _fileStore;
-    fileStore(): Promise<DataStore>;
-    private readonly _WALStore;
-    WALStore(): Promise<WALStore>;
-    private readonly _metaStore;
-    metaStore(): Promise<MetaStore>;
     keyBag(): Promise<KeyBag>;
     private readonly onceReady;
     ready(): Promise<void>;
@@ -786,49 +846,36 @@ declare class Loader implements Loadable {
     destroy(): Promise<void>;
     readonly logger: Logger;
     constructor(sthis: SuperThis, ebOpts: BlockstoreOpts);
-    handleDbMetasFromStore(metas: DbMeta[]): Promise<void>;
-    mergeDbMetaIntoClock(meta: DbMeta): Promise<void>;
-    loadCarHeaderFromMeta<T>({ cars: cids }: DbMeta): Promise<CarHeader<T>>;
+    handleDbMetasFromStore(metas: DbMeta[], activeStore: ActiveStore): Promise<void>;
+    mergeDbMetaIntoClock(meta: DbMeta, activeStore: ActiveStore): Promise<void>;
+    loadCarHeaderFromMeta<T>(dbm: DbMeta, astore: ActiveStore): Promise<CarHeader<T>>;
     commitFiles(t: CarTransaction, done: TransactionMeta): Promise<CarGroup>;
-    loadFileCar(cid: AnyLink): Promise<CarReader$1>;
+    loadFileCar(cid: AnyLink, store: ActiveStore): Promise<CarReader$1>;
     commit<T = TransactionMeta>(t: CarTransaction, done: T, opts?: CommitOpts): Promise<CarGroup>;
     updateCarLog<T>(cids: CarGroup, fp: CarHeader<T>, compact: boolean): Promise<void>;
     cacheTransaction(t: CarTransaction): Promise<void>;
     cacheCarReader(carCidStr: string, reader: CarReader$1): Promise<void>;
-    removeCidsForCompact(cid: AnyLink): Promise<void>;
+    removeCidsForCompact(cid: AnyLink, store: ActiveStore): Promise<void>;
     entries(cache?: boolean): AsyncIterableIterator<AnyBlock>;
-    getBlock(cid: AnyLink): Promise<AnyBlock | Falsy>;
-    loadCar(cid: AnyLink): Promise<CarReader$1>;
-    makeDecoderAndCarReader(cid: AnyLink, local: DataStore, remote?: DataStore): Promise<CarReader$1>;
-    protected storesLoadCar(cid: AnyLink, local: DataStore, remote?: DataStore): Promise<CarReader$1>;
-    protected getMoreReaders(cids: AnyLink[]): Promise<void>;
+    getBlock(cid: AnyLink, store: ActiveStore): Promise<AnyBlock | Falsy>;
+    loadCar(cid: AnyLink, store: ActiveStore): Promise<CarReader$1>;
+    makeDecoderAndCarReader(cid: AnyLink, store: DataActiveStore): Promise<CarReader$1>;
+    protected storesLoadCar(cid: AnyLink, store: DataActiveStore): Promise<CarReader$1>;
+    protected getMoreReaders(cids: AnyLink[], store: ActiveStore): Promise<void>;
 }
 
 declare function parseCarFile<T>(reader: CarReader$1, logger: Logger): Promise<CarHeader<T>>;
 
-declare abstract class ConnectionBase implements Connection {
-    private loader?;
-    taskManager?: TaskManager;
-    readonly context: Context;
-    readonly url: URI;
-    readonly logger: Logger;
-    constructor(url: URI, logger: Logger);
-    private readonly _loaded;
-    private _metaIsLoading;
-    loaded(): Future<void>;
-    refresh(): Promise<void>;
-    connect(refl: RefLoadable | RefBlockstore): Promise<void>;
-    connectMeta(refl: RefLoadable | RefBlockstore): Promise<void>;
-    abstract onConnect(): Promise<void>;
-    connectStorage(refl: RefLoadable | RefBlockstore): Promise<void>;
-}
-
+type index$5_ActiveStore = ActiveStore;
 type index$5_AnyAnyBlock = AnyAnyBlock;
 type index$5_AnyAnyLink = AnyAnyLink;
 type index$5_AnyBlock = AnyBlock;
 type index$5_AnyDecodedBlock = AnyDecodedBlock;
 type index$5_AnyLink = AnyLink;
 type index$5_AnyLinkFn = AnyLinkFn;
+type index$5_AttachedRemotesImpl = AttachedRemotesImpl;
+declare const index$5_AttachedRemotesImpl: typeof AttachedRemotesImpl;
+type index$5_AttachedStores = AttachedStores;
 type index$5_BaseBlockstoreImpl = BaseBlockstoreImpl;
 declare const index$5_BaseBlockstoreImpl: typeof BaseBlockstoreImpl;
 type index$5_BaseStore = BaseStore;
@@ -856,9 +903,11 @@ type index$5_CompactFn = CompactFn;
 type index$5_CompactionFetcher = CompactionFetcher;
 declare const index$5_CompactionFetcher: typeof CompactionFetcher;
 type index$5_Connection = Connection;
-type index$5_ConnectionBase = ConnectionBase;
-declare const index$5_ConnectionBase: typeof ConnectionBase;
 type index$5_CryptoAction = CryptoAction;
+type index$5_DataActiveStore = DataActiveStore;
+type index$5_DataAndMetaAndWalStore = DataAndMetaAndWalStore;
+type index$5_DataAndMetaStore = DataAndMetaStore;
+type index$5_DataAttachedStores = DataAttachedStores;
 type index$5_DataSaveOpts = DataSaveOpts;
 type index$5_DataStore = DataStore;
 type index$5_DbMeta = DbMeta;
@@ -894,6 +943,10 @@ type index$5_LoadHandler = LoadHandler;
 type index$5_Loadable = Loadable;
 type index$5_Loader = Loader;
 declare const index$5_Loader: typeof Loader;
+type index$5_LocalActiveStore = LocalActiveStore;
+type index$5_LocalDataAndMetaAndWalStore = LocalDataAndMetaAndWalStore;
+type index$5_MetaActiveStore = MetaActiveStore;
+type index$5_MetaAttachedStores = MetaAttachedStores;
 type index$5_MetaStore = MetaStore;
 type index$5_PassThroughGateway = PassThroughGateway;
 declare const index$5_PassThroughGateway: typeof PassThroughGateway;
@@ -935,9 +988,15 @@ type index$5_StoreUrlsOpts = StoreUrlsOpts;
 type index$5_TransactionMeta = TransactionMeta;
 type index$5_TransactionWrapper<M extends TransactionMeta> = TransactionWrapper<M>;
 type index$5_UnsubscribeResult = UnsubscribeResult;
+type index$5_UrlAndInterceptor = UrlAndInterceptor;
 type index$5_VoidResult = VoidResult;
+type index$5_WALActiveStore = WALActiveStore;
+type index$5_WALAttachedStores = WALAttachedStores;
 type index$5_WALState = WALState;
 type index$5_WALStore = WALStore;
+type index$5_WriteableDataAndMetaAndWalStore = WriteableDataAndMetaAndWalStore;
+type index$5_WriteableDataAndMetaStore = WriteableDataAndMetaStore;
+declare const index$5_createAttachedStores: typeof createAttachedStores;
 declare const index$5_createDbMetaEvent: typeof createDbMetaEvent;
 declare const index$5_defaultGatewayFactoryItem: typeof defaultGatewayFactoryItem;
 declare const index$5_ensureStoreEnDeFile: typeof ensureStoreEnDeFile;
@@ -949,7 +1008,7 @@ declare const index$5_registerStoreProtocol: typeof registerStoreProtocol;
 declare const index$5_toCIDBlock: typeof toCIDBlock;
 declare const index$5_toStoreRuntime: typeof toStoreRuntime;
 declare namespace index$5 {
-  export { type index$5_AnyAnyBlock as AnyAnyBlock, type index$5_AnyAnyLink as AnyAnyLink, type index$5_AnyBlock as AnyBlock, type index$5_AnyDecodedBlock as AnyDecodedBlock, type index$5_AnyLink as AnyLink, type index$5_AnyLinkFn as AnyLinkFn, index$5_BaseBlockstoreImpl as BaseBlockstoreImpl, type index$5_BaseStore as BaseStore, type index$5_BlobLike as BlobLike, type index$5_BlockFetcher as BlockFetcher, type index$5_BlockstoreOpts as BlockstoreOpts, type index$5_BlockstoreParams as BlockstoreParams, type index$5_BlockstoreRuntime as BlockstoreRuntime, type index$5_BytesAndKeyWithIv as BytesAndKeyWithIv, type index$5_CIDBlock as CIDBlock, index$5_Car2FPMsg as Car2FPMsg, type index$5_CarClockHead as CarClockHead, type index$5_CarClockLink as CarClockLink, type index$5_CarGroup as CarGroup, type index$5_CarHeader as CarHeader, type index$5_CarLog as CarLog, type index$5_CarMakeable as CarMakeable, index$5_CarTransactionImpl as CarTransactionImpl, type index$5_CarTransactionOpts as CarTransactionOpts, type index$5_CodecOpts as CodecOpts, type index$5_CommitOpts as CommitOpts, type index$5_CompactFetcher as CompactFetcher, type index$5_CompactFn as CompactFn, index$5_CompactionFetcher as CompactionFetcher, type index$5_Connection as Connection, index$5_ConnectionBase as ConnectionBase, type index$5_CryptoAction as CryptoAction, type index$5_DataSaveOpts as DataSaveOpts, type index$5_DataStore as DataStore, type index$5_DbMeta as DbMeta, type index$5_DbMetaBinary as DbMetaBinary, type index$5_DbMetaEvent as DbMetaEvent, type index$5_DbMetaEventBlock as DbMetaEventBlock, index$5_DbMetaEventEqual as DbMetaEventEqual, index$5_DbMetaEventsEqual as DbMetaEventsEqual, type index$5_EncryptedBlock as EncryptedBlock, index$5_EncryptedBlockstore as EncryptedBlockstore, type index$5_FPEnvelope as FPEnvelope, type index$5_FPEnvelopeCar as FPEnvelopeCar, type index$5_FPEnvelopeFile as FPEnvelopeFile, type index$5_FPEnvelopeMeta as FPEnvelopeMeta, type index$5_FPEnvelopeType as FPEnvelopeType, index$5_FPEnvelopeTypes as FPEnvelopeTypes, type index$5_FPEnvelopeWAL as FPEnvelopeWAL, type index$5_FPWALCarsOps as FPWALCarsOps, index$5_File2FPMsg as File2FPMsg, type index$5_Gateway as Gateway, type index$5_GatewayOpts as GatewayOpts, type index$5_GetResult as GetResult, index$5_InterceptorGateway as InterceptorGateway, type index$5_IvAndKeyAndBytes as IvAndKeyAndBytes, type index$5_IvKeyIdData as IvKeyIdData, type index$5_KeyMaterial as KeyMaterial, type index$5_KeyUpsertResult as KeyUpsertResult, type index$5_KeyWithFingerPrint as KeyWithFingerPrint, type index$5_KeysByFingerprint as KeysByFingerprint, type index$5_LoadHandler as LoadHandler, type index$5_Loadable as Loadable, index$5_Loader as Loader, type index$5_MetaStore as MetaStore, index$5_PassThroughGateway as PassThroughGateway, type index$5_RefBlockstore as RefBlockstore, type index$5_RefLoadable as RefLoadable, type index$5_SerdeGateway as SerdeGateway, type index$5_SerdeGatewayBuildUrlOp as SerdeGatewayBuildUrlOp, type index$5_SerdeGatewayBuildUrlReturn as SerdeGatewayBuildUrlReturn, type index$5_SerdeGatewayCloseOp as SerdeGatewayCloseOp, type index$5_SerdeGatewayCloseReturn as SerdeGatewayCloseReturn, type index$5_SerdeGatewayCtx as SerdeGatewayCtx, type index$5_SerdeGatewayDeleteOp as SerdeGatewayDeleteOp, type index$5_SerdeGatewayDeleteReturn as SerdeGatewayDeleteReturn, type index$5_SerdeGatewayDestroyOp as SerdeGatewayDestroyOp, type index$5_SerdeGatewayDestroyReturn as SerdeGatewayDestroyReturn, type index$5_SerdeGatewayFactoryItem as SerdeGatewayFactoryItem, type index$5_SerdeGatewayGetOp as SerdeGatewayGetOp, type index$5_SerdeGatewayGetReturn as SerdeGatewayGetReturn, type index$5_SerdeGatewayInterceptor as SerdeGatewayInterceptor, type index$5_SerdeGatewayOpts as SerdeGatewayOpts, type index$5_SerdeGatewayPutOp as SerdeGatewayPutOp, type index$5_SerdeGatewayPutReturn as SerdeGatewayPutReturn, type index$5_SerdeGatewayReturn as SerdeGatewayReturn, type index$5_SerdeGatewayStartOp as SerdeGatewayStartOp, type index$5_SerdeGatewayStartReturn as SerdeGatewayStartReturn, type index$5_SerdeGatewaySubscribeOp as SerdeGatewaySubscribeOp, type index$5_SerdeGatewaySubscribeReturn as SerdeGatewaySubscribeReturn, type index$5_SerdeGetResult as SerdeGetResult, type index$5_SerdeOrGatewayFactoryItem as SerdeOrGatewayFactoryItem, type index$5_StoreEnDeFile as StoreEnDeFile, type index$5_StoreFactory as StoreFactory, type index$5_StoreFactoryItem as StoreFactoryItem, type index$5_StoreRuntime as StoreRuntime, type index$5_StoreRuntimeUrls as StoreRuntimeUrls, type index$5_StoreURIRuntime as StoreURIRuntime, type index$5_StoreURIs as StoreURIs, type index$5_StoreUrls as StoreUrls, type index$5_StoreUrlsOpts as StoreUrlsOpts, type index$5_TransactionMeta as TransactionMeta, type index$5_TransactionWrapper as TransactionWrapper, type index$5_UnsubscribeResult as UnsubscribeResult, type index$5_VoidResult as VoidResult, type index$5_WALState as WALState, type index$5_WALStore as WALStore, index$5_createDbMetaEvent as createDbMetaEvent, index$5_defaultGatewayFactoryItem as defaultGatewayFactoryItem, index$5_ensureStoreEnDeFile as ensureStoreEnDeFile, index$5_getDefaultURI as getDefaultURI, index$5_getGatewayFactoryItem as getGatewayFactoryItem, index$5_getStartedGateway as getStartedGateway, index$5_parseCarFile as parseCarFile, index$5_registerStoreProtocol as registerStoreProtocol, index$5_toCIDBlock as toCIDBlock, index$5_toStoreRuntime as toStoreRuntime };
+  export { type index$5_ActiveStore as ActiveStore, type index$5_AnyAnyBlock as AnyAnyBlock, type index$5_AnyAnyLink as AnyAnyLink, type index$5_AnyBlock as AnyBlock, type index$5_AnyDecodedBlock as AnyDecodedBlock, type index$5_AnyLink as AnyLink, type index$5_AnyLinkFn as AnyLinkFn, index$5_AttachedRemotesImpl as AttachedRemotesImpl, type index$5_AttachedStores as AttachedStores, index$5_BaseBlockstoreImpl as BaseBlockstoreImpl, type index$5_BaseStore as BaseStore, type index$5_BlobLike as BlobLike, type index$5_BlockFetcher as BlockFetcher, type index$5_BlockstoreOpts as BlockstoreOpts, type index$5_BlockstoreParams as BlockstoreParams, type index$5_BlockstoreRuntime as BlockstoreRuntime, type index$5_BytesAndKeyWithIv as BytesAndKeyWithIv, type index$5_CIDBlock as CIDBlock, index$5_Car2FPMsg as Car2FPMsg, type index$5_CarClockHead as CarClockHead, type index$5_CarClockLink as CarClockLink, type index$5_CarGroup as CarGroup, type index$5_CarHeader as CarHeader, type index$5_CarLog as CarLog, type index$5_CarMakeable as CarMakeable, index$5_CarTransactionImpl as CarTransactionImpl, type index$5_CarTransactionOpts as CarTransactionOpts, type index$5_CodecOpts as CodecOpts, type index$5_CommitOpts as CommitOpts, type index$5_CompactFetcher as CompactFetcher, type index$5_CompactFn as CompactFn, index$5_CompactionFetcher as CompactionFetcher, type index$5_Connection as Connection, type index$5_CryptoAction as CryptoAction, type index$5_DataActiveStore as DataActiveStore, type index$5_DataAndMetaAndWalStore as DataAndMetaAndWalStore, type index$5_DataAndMetaStore as DataAndMetaStore, type index$5_DataAttachedStores as DataAttachedStores, type index$5_DataSaveOpts as DataSaveOpts, type index$5_DataStore as DataStore, type index$5_DbMeta as DbMeta, type index$5_DbMetaBinary as DbMetaBinary, type index$5_DbMetaEvent as DbMetaEvent, type index$5_DbMetaEventBlock as DbMetaEventBlock, index$5_DbMetaEventEqual as DbMetaEventEqual, index$5_DbMetaEventsEqual as DbMetaEventsEqual, type index$5_EncryptedBlock as EncryptedBlock, index$5_EncryptedBlockstore as EncryptedBlockstore, type index$5_FPEnvelope as FPEnvelope, type index$5_FPEnvelopeCar as FPEnvelopeCar, type index$5_FPEnvelopeFile as FPEnvelopeFile, type index$5_FPEnvelopeMeta as FPEnvelopeMeta, type index$5_FPEnvelopeType as FPEnvelopeType, index$5_FPEnvelopeTypes as FPEnvelopeTypes, type index$5_FPEnvelopeWAL as FPEnvelopeWAL, type index$5_FPWALCarsOps as FPWALCarsOps, index$5_File2FPMsg as File2FPMsg, type index$5_Gateway as Gateway, type index$5_GatewayOpts as GatewayOpts, type index$5_GetResult as GetResult, index$5_InterceptorGateway as InterceptorGateway, type index$5_IvAndKeyAndBytes as IvAndKeyAndBytes, type index$5_IvKeyIdData as IvKeyIdData, type index$5_KeyMaterial as KeyMaterial, type index$5_KeyUpsertResult as KeyUpsertResult, type index$5_KeyWithFingerPrint as KeyWithFingerPrint, type index$5_KeysByFingerprint as KeysByFingerprint, type index$5_LoadHandler as LoadHandler, type index$5_Loadable as Loadable, index$5_Loader as Loader, type index$5_LocalActiveStore as LocalActiveStore, type index$5_LocalDataAndMetaAndWalStore as LocalDataAndMetaAndWalStore, type index$5_MetaActiveStore as MetaActiveStore, type index$5_MetaAttachedStores as MetaAttachedStores, type index$5_MetaStore as MetaStore, index$5_PassThroughGateway as PassThroughGateway, type index$5_RefBlockstore as RefBlockstore, type index$5_RefLoadable as RefLoadable, type index$5_SerdeGateway as SerdeGateway, type index$5_SerdeGatewayBuildUrlOp as SerdeGatewayBuildUrlOp, type index$5_SerdeGatewayBuildUrlReturn as SerdeGatewayBuildUrlReturn, type index$5_SerdeGatewayCloseOp as SerdeGatewayCloseOp, type index$5_SerdeGatewayCloseReturn as SerdeGatewayCloseReturn, type index$5_SerdeGatewayCtx as SerdeGatewayCtx, type index$5_SerdeGatewayDeleteOp as SerdeGatewayDeleteOp, type index$5_SerdeGatewayDeleteReturn as SerdeGatewayDeleteReturn, type index$5_SerdeGatewayDestroyOp as SerdeGatewayDestroyOp, type index$5_SerdeGatewayDestroyReturn as SerdeGatewayDestroyReturn, type index$5_SerdeGatewayFactoryItem as SerdeGatewayFactoryItem, type index$5_SerdeGatewayGetOp as SerdeGatewayGetOp, type index$5_SerdeGatewayGetReturn as SerdeGatewayGetReturn, type index$5_SerdeGatewayInterceptor as SerdeGatewayInterceptor, type index$5_SerdeGatewayOpts as SerdeGatewayOpts, type index$5_SerdeGatewayPutOp as SerdeGatewayPutOp, type index$5_SerdeGatewayPutReturn as SerdeGatewayPutReturn, type index$5_SerdeGatewayReturn as SerdeGatewayReturn, type index$5_SerdeGatewayStartOp as SerdeGatewayStartOp, type index$5_SerdeGatewayStartReturn as SerdeGatewayStartReturn, type index$5_SerdeGatewaySubscribeOp as SerdeGatewaySubscribeOp, type index$5_SerdeGatewaySubscribeReturn as SerdeGatewaySubscribeReturn, type index$5_SerdeGetResult as SerdeGetResult, type index$5_SerdeOrGatewayFactoryItem as SerdeOrGatewayFactoryItem, type index$5_StoreEnDeFile as StoreEnDeFile, type index$5_StoreFactory as StoreFactory, type index$5_StoreFactoryItem as StoreFactoryItem, type index$5_StoreRuntime as StoreRuntime, type index$5_StoreRuntimeUrls as StoreRuntimeUrls, type index$5_StoreURIRuntime as StoreURIRuntime, type index$5_StoreURIs as StoreURIs, type index$5_StoreUrls as StoreUrls, type index$5_StoreUrlsOpts as StoreUrlsOpts, type index$5_TransactionMeta as TransactionMeta, type index$5_TransactionWrapper as TransactionWrapper, type index$5_UnsubscribeResult as UnsubscribeResult, type index$5_UrlAndInterceptor as UrlAndInterceptor, type index$5_VoidResult as VoidResult, type index$5_WALActiveStore as WALActiveStore, type index$5_WALAttachedStores as WALAttachedStores, type index$5_WALState as WALState, type index$5_WALStore as WALStore, type index$5_WriteableDataAndMetaAndWalStore as WriteableDataAndMetaAndWalStore, type index$5_WriteableDataAndMetaStore as WriteableDataAndMetaStore, index$5_createAttachedStores as createAttachedStores, index$5_createDbMetaEvent as createDbMetaEvent, index$5_defaultGatewayFactoryItem as defaultGatewayFactoryItem, index$5_ensureStoreEnDeFile as ensureStoreEnDeFile, index$5_getDefaultURI as getDefaultURI, index$5_getGatewayFactoryItem as getGatewayFactoryItem, index$5_getStartedGateway as getStartedGateway, index$5_parseCarFile as parseCarFile, index$5_registerStoreProtocol as registerStoreProtocol, index$5_toCIDBlock as toCIDBlock, index$5_toStoreRuntime as toStoreRuntime };
 }
 
 interface WriteQueueParams {
@@ -1331,6 +1390,40 @@ interface ReadyCloseDestroy {
     destroy(): Promise<void>;
     ready(): Promise<void>;
 }
+interface CoerceURIandInterceptor {
+    readonly url: CoerceURI;
+    readonly gatewayInterceptor?: SerdeGatewayInterceptor;
+}
+interface GatewayUrlsParam {
+    readonly car: CoerceURIandInterceptor;
+    readonly file: CoerceURIandInterceptor;
+    readonly meta: CoerceURIandInterceptor;
+    readonly wal?: CoerceURIandInterceptor;
+}
+interface GatewayUrls {
+    readonly car: UrlAndInterceptor;
+    readonly file: UrlAndInterceptor;
+    readonly meta: UrlAndInterceptor;
+    readonly wal?: UrlAndInterceptor;
+}
+interface Attachable {
+    readonly name: string;
+    prepare(): Promise<GatewayUrlsParam>;
+}
+declare class DataAndMetaAndWalAndBaseStore implements DataAndMetaAndWalStore {
+    readonly wal?: WALStore | undefined;
+    readonly file: DataStore;
+    readonly car: DataStore;
+    readonly meta: MetaStore;
+    readonly baseStores: BaseStore[];
+    constructor(dam: DataAndMetaAndWalStore);
+}
+interface Attached {
+    readonly gatewayUrls: GatewayUrls;
+    readonly stores: DataAndMetaAndWalAndBaseStore;
+    detach(): Promise<void>;
+    status(): "attached" | "loading" | "loaded" | "error" | "detached" | "syncing" | "idle";
+}
 interface Database extends ReadyCloseDestroy, HasLogger, HasSuperThis {
     readonly ledger: Ledger;
     readonly logger: Logger;
@@ -1338,6 +1431,7 @@ interface Database extends ReadyCloseDestroy, HasLogger, HasSuperThis {
     readonly id: string;
     readonly name: string;
     onClosed(fn: () => void): void;
+    attach(a: Attachable): Promise<Attached>;
     get<T extends DocTypes>(id: string): Promise<DocWithId<T>>;
     put<T extends DocTypes>(doc: DocSet<T>): Promise<DocResponse>;
     bulk<T extends DocTypes>(docs: DocSet<T>[]): Promise<BulkResponse>;
@@ -1378,6 +1472,7 @@ interface Ledger extends HasCRDT {
     readonly name: string;
     readonly context: Context;
     onClosed(fn: () => void): () => void;
+    attach(a: Attachable): Promise<Attached>;
     close(): Promise<void>;
     destroy(): Promise<void>;
     ready(): Promise<void>;
@@ -1392,6 +1487,7 @@ declare class LedgerShell implements Ledger {
     readonly writeQueue: WriteQueue<DocUpdate<DocTypes>>;
     readonly name: string;
     constructor(ref: LedgerImpl);
+    attach(a: Attachable): Promise<Attached>;
     get opts(): LedgerOpts;
     get context(): Context;
     get id(): string;
@@ -1426,6 +1522,7 @@ declare class LedgerImpl implements Ledger {
     readonly sthis: SuperThis;
     readonly id: string;
     constructor(sthis: SuperThis, opts: LedgerOpts);
+    attach(a: Attachable): Promise<Attached>;
     subscribe<T extends DocTypes>(listener: ListenerFn<T>, updates?: boolean): () => void;
     private _notify;
     private _no_update_notify;
@@ -1444,6 +1541,7 @@ declare class DatabaseImpl implements Database {
     readonly sthis: SuperThis;
     readonly id: string;
     constructor(ledger: Ledger);
+    attach(a: Attachable): Promise<Attached>;
     get name(): string;
     get<T extends DocTypes>(id: string): Promise<DocWithId<T>>;
     put<T extends DocTypes>(doc: DocSet<T>): Promise<DocResponse>;
@@ -1688,5 +1786,5 @@ declare namespace index {
 
 declare const PACKAGE_VERSION: string;
 
-export { type AllDocsQueryOpts, type AllDocsResponse, type BaseBlockstore, type BulkResponse, type CRDT, type CRDTClock, type CRDTEntry, CRDTImpl, type CRDTMeta, type CarTransaction, type ChangesOptions, type ChangesResponse, type ChangesResponseRow, type ClockHead, type ClockLink, type ConfigOpts, type Database, DatabaseImpl, type DbMeta, type DocBase, type DocFileMeta, type DocFiles, type DocFragment, type DocLiteral, type DocObject, type DocRecord, type DocResponse, type DocSet, type DocTypes, type DocUpdate, type DocValue, type DocWithId, type FPStats, type Falsy, type FileTransactionMeta, type HasCRDT, type HasLogger, type HasSuperThis, type IdxMeta, type IdxMetaMap, Index, type IndexKey, type IndexKeyType, type IndexRow, type IndexRows, type IndexTransactionMeta, type IndexUpdate, type IndexUpdateString, type Joiner, type KeyLiteral, type Ledger, LedgerFactory, type LedgerOpts, LedgerShell, type ListenerFn, type MapFn, type MetaType, type NoUpdateListenerFn, NotFoundError, PACKAGE_VERSION, PARAM, type PARAMS, type PathOps, type PromiseToUInt8, type QueryOpts, type ReadyCloseDestroy, type RefLedger, type Store, type StoreType, type SuperThis, type SuperThisOpts, type SysFileSystem, type TextEndeCoder, type ToUInt8, UInt8ArrayEqual, type UnReg, type UnknownDoc, type UpdateListenerFn, type VoidFn, type WriteQueue, index$5 as blockstore, index$5 as bs, coerceIntoUint8, coercePromiseIntoUint8, defaultWriteQueueOpts, ensureLogger, ensureSuperLog, ensureSuperThis, exceptionWrapper, falsyToUndef, fireproof, getKey, getName, getStore, index$4 as index, inplaceFilter, isDatabase, isFalsy, isLedger, isNotFoundError, keyConfigOpts, makeName, onSuperThis, index as rt, index as runtime, throwFalsy, toSortedArray, toStoreURIRuntime };
+export { type AllDocsQueryOpts, type AllDocsResponse, type Attachable, type Attached, type BaseBlockstore, type BulkResponse, type CRDT, type CRDTClock, type CRDTEntry, CRDTImpl, type CRDTMeta, type CarTransaction, type ChangesOptions, type ChangesResponse, type ChangesResponseRow, type ClockHead, type ClockLink, type CoerceURIandInterceptor, type ConfigOpts, DataAndMetaAndWalAndBaseStore, type Database, DatabaseImpl, type DbMeta, type DocBase, type DocFileMeta, type DocFiles, type DocFragment, type DocLiteral, type DocObject, type DocRecord, type DocResponse, type DocSet, type DocTypes, type DocUpdate, type DocValue, type DocWithId, type FPStats, type Falsy, type FileTransactionMeta, type GatewayUrls, type GatewayUrlsParam, type HasCRDT, type HasLogger, type HasSuperThis, type IdxMeta, type IdxMetaMap, Index, type IndexKey, type IndexKeyType, type IndexRow, type IndexRows, type IndexTransactionMeta, type IndexUpdate, type IndexUpdateString, type Joiner, type KeyLiteral, type Ledger, LedgerFactory, type LedgerOpts, LedgerShell, type ListenerFn, type MapFn, type MetaType, type NoUpdateListenerFn, NotFoundError, PACKAGE_VERSION, PARAM, type PARAMS, type PathOps, type PromiseToUInt8, type QueryOpts, type ReadyCloseDestroy, type RefLedger, type Store, type StoreType, type SuperThis, type SuperThisOpts, type SysFileSystem, type TextEndeCoder, type ToUInt8, UInt8ArrayEqual, type UnReg, type UnknownDoc, type UpdateListenerFn, type VoidFn, type WriteQueue, index$5 as blockstore, index$5 as bs, coerceIntoUint8, coercePromiseIntoUint8, defaultWriteQueueOpts, ensureLogger, ensureSuperLog, ensureSuperThis, exceptionWrapper, falsyToUndef, fireproof, getKey, getName, getStore, index$4 as index, inplaceFilter, isDatabase, isFalsy, isLedger, isNotFoundError, keyConfigOpts, makeName, onSuperThis, index as rt, index as runtime, throwFalsy, toSortedArray, toStoreURIRuntime };
 declare module '@fireproof/core'