@fireproof/core 0.19.99 → 0.19.101

package/index.d.cts

@@ -1,4 +1,4 @@
-import { Future, Logger, URI, Result, CoerceURI, ResolveOnce, ResolveSeq, CryptoRuntime, CTCryptoKey, EnvFactoryOpts, Env, runtimeFn } from '@adviser/cement';
+import { Future, Logger, URI, Result, ResolveOnce, ResolveSeq, CoerceURI, CryptoRuntime, CTCryptoKey, EnvFactoryOpts, Env, runtimeFn } from '@adviser/cement';
 export { Logger, Result } from '@adviser/cement';
 import { EventLink } from '@web3-storage/pail/clock/api';
 import { Operation } from '@web3-storage/pail/crdt/api';
@@ -8,7 +8,6 @@ import { BlockFetcher as BlockFetcher$1 } from '@web3-storage/pail/api';
 import { CarReader } from '@ipld/car';
 import { IDBPDatabase } from 'idb';
 import { EventBlock } from '@web3-storage/pail/clock';
-import { PathLike, MakeDirectoryOptions, Stats } from 'fs';
 import { ProllyNode as ProllyNode$1 } from 'prolly-trees/db-index';
 import { Block as Block$2 } from 'multiformats/block';
 
@@ -59,7 +58,6 @@ declare class NotFoundError extends Error {
     readonly code = "ENOENT";
 }
 declare function isNotFoundError(e: Error | Result<unknown> | unknown): e is NotFoundError;
-declare function dataDir(sthis: SuperThis, name?: string, base?: CoerceURI): URI;
 declare function UInt8ArrayEqual(a: Uint8Array, b: Uint8Array): boolean;
 
 interface KeyBagCtx {
@@ -134,6 +132,7 @@ interface KeyBagProviderFactoryItem {
     readonly factory: KeyBackProviderFactory;
 }
 declare function registerKeyBagProviderFactory(item: KeyBagProviderFactoryItem): void;
+declare function defaultKeyBagOpts(sthis: SuperThis, kbo?: Partial<KeyBagOpts>): KeyBagRuntime;
 declare function getKeyBag(sthis: SuperThis, kbo?: Partial<KeyBagOpts>): Promise<KeyBag>;
 
 type keyBag_KeyBackProviderFactory = KeyBackProviderFactory;
@@ -149,10 +148,11 @@ type keyBag_KeyBagProviderIndexDB = KeyBagProviderIndexDB;
 declare const keyBag_KeyBagProviderIndexDB: typeof KeyBagProviderIndexDB;
 type keyBag_KeyBagRuntime = KeyBagRuntime;
 type keyBag_KeyItem = KeyItem;
+declare const keyBag_defaultKeyBagOpts: typeof defaultKeyBagOpts;
 declare const keyBag_getKeyBag: typeof getKeyBag;
 declare const keyBag_registerKeyBagProviderFactory: typeof registerKeyBagProviderFactory;
 declare namespace keyBag {
-  export { type keyBag_KeyBackProviderFactory as KeyBackProviderFactory, keyBag_KeyBag as KeyBag, type keyBag_KeyBagFile as KeyBagFile, type keyBag_KeyBagOpts as KeyBagOpts, type keyBag_KeyBagProvider as KeyBagProvider, type keyBag_KeyBagProviderFactoryItem as KeyBagProviderFactoryItem, keyBag_KeyBagProviderFile as KeyBagProviderFile, keyBag_KeyBagProviderIndexDB as KeyBagProviderIndexDB, type keyBag_KeyBagRuntime as KeyBagRuntime, type keyBag_KeyItem as KeyItem, keyBag_getKeyBag as getKeyBag, keyBag_registerKeyBagProviderFactory as registerKeyBagProviderFactory };
+  export { type keyBag_KeyBackProviderFactory as KeyBackProviderFactory, keyBag_KeyBag as KeyBag, type keyBag_KeyBagFile as KeyBagFile, type keyBag_KeyBagOpts as KeyBagOpts, type keyBag_KeyBagProvider as KeyBagProvider, type keyBag_KeyBagProviderFactoryItem as KeyBagProviderFactoryItem, keyBag_KeyBagProviderFile as KeyBagProviderFile, keyBag_KeyBagProviderIndexDB as KeyBagProviderIndexDB, type keyBag_KeyBagRuntime as KeyBagRuntime, type keyBag_KeyItem as KeyItem, keyBag_defaultKeyBagOpts as defaultKeyBagOpts, keyBag_getKeyBag as getKeyBag, keyBag_registerKeyBagProviderFactory as registerKeyBagProviderFactory };
 }
 
 declare class TaskManager {
@@ -167,7 +167,6 @@ declare class TaskManager {
 }
 
 declare class Loader implements Loadable {
-    readonly name: string;
     readonly ebOpts: BlockstoreRuntime;
     readonly commitQueue: CommitQueue<CarGroup>;
     readonly isCompacting = false;
@@ -175,7 +174,7 @@ declare class Loader implements Loadable {
     readonly seenCompacted: Set<string>;
     readonly processedCars: Set<string>;
     readonly sthis: SuperThis;
-    readonly taskManager?: TaskManager;
+    readonly taskManager: TaskManager;
     carLog: CarLog;
     remoteMetaStore?: MetaStore;
     remoteCarStore?: DataStore;
@@ -183,17 +182,21 @@ declare class Loader implements Loadable {
     private getBlockCache;
     private seenMeta;
     private writeLimit;
-    keyBag(): Promise<KeyBag>;
+    readonly _carStore: ResolveOnce<DataStore, void>;
     carStore(): Promise<DataStore>;
+    readonly _fileStore: ResolveOnce<DataStore, void>;
     fileStore(): Promise<DataStore>;
+    readonly _WALStore: ResolveOnce<WALStore, void>;
     WALStore(): Promise<WALStore>;
+    readonly _metaStore: ResolveOnce<MetaStore, void>;
     metaStore(): Promise<MetaStore>;
+    keyBag(): Promise<KeyBag>;
     readonly onceReady: ResolveOnce<void>;
     ready(): Promise<void>;
     close(): Promise<void>;
     destroy(): Promise<void>;
     readonly logger: Logger;
-    constructor(name: string, ebOpts: BlockstoreOpts, sthis: SuperThis);
+    constructor(sthis: SuperThis, ebOpts: BlockstoreOpts);
     handleDbMetasFromStore(metas: DbMeta[]): Promise<void>;
     mergeDbMetaIntoClock(meta: DbMeta): Promise<void>;
     loadCarHeaderFromMeta<T>({ cars: cids }: DbMeta): Promise<CarHeader<T>>;
@@ -228,20 +231,21 @@ declare class BaseBlockstore implements BlockFetcher {
     readonly ebOpts: BlockstoreRuntime;
     readonly sthis: SuperThis;
     readonly loader?: Loader;
-    readonly name?: string;
     ready(): Promise<void>;
     close(): Promise<void>;
     destroy(): Promise<void>;
+    compact(): Promise<void>;
     readonly logger: Logger;
-    constructor(ebOpts?: BlockstoreOpts);
+    constructor(ebOpts: BlockstoreOpts);
     get<T, C extends number, A extends number, V extends Version>(cid: AnyAnyLink): Promise<Block$1<T, C, A, V> | undefined>;
     put(cid: AnyAnyLink, block: Uint8Array): Promise<void>;
     lastTxMeta?: unknown;
     transaction<M extends TransactionMeta>(fn: (t: CarTransaction) => Promise<M>, _opts?: CarTransactionOpts): Promise<TransactionWrapper<M>>;
+    openTransaction(opts?: CarTransactionOpts): CarTransaction;
+    commitTransaction<M extends TransactionMeta>(t: CarTransaction, done: M, opts: CarTransactionOpts): Promise<TransactionWrapper<M>>;
     entries(): AsyncIterableIterator<AnyBlock>;
 }
 declare class EncryptedBlockstore extends BaseBlockstore {
-    readonly name: string;
     readonly loader: Loader;
     ready(): Promise<void>;
     close(): Promise<void>;
@@ -265,6 +269,26 @@ declare class CompactionFetcher implements BlockFetcher {
     get<T, C extends number, A extends number, V extends Version>(cid: AnyLink): Promise<Block$1<T, C, A, V> | undefined>;
 }
 
+interface GatewayOpts {
+    readonly gateway: Gateway;
+}
+type GetResult = Result<Uint8Array, NotFoundError | Error>;
+type VoidResult = Result<void>;
+interface TestGateway {
+    get(url: URI, key: string): Promise<Uint8Array>;
+}
+type UnsubscribeResult = Result<() => void>;
+interface Gateway {
+    buildUrl(baseUrl: URI, key: string): Promise<Result<URI>>;
+    start(baseUrl: URI): Promise<Result<URI>>;
+    close(baseUrl: URI): Promise<VoidResult>;
+    destroy(baseUrl: URI): Promise<VoidResult>;
+    put(url: URI, body: Uint8Array): Promise<VoidResult>;
+    get(url: URI): Promise<GetResult>;
+    delete(url: URI): Promise<VoidResult>;
+    subscribe?(url: URI, callback: (meta: Uint8Array) => void): Promise<UnsubscribeResult>;
+}
+
 type AnyLink = Link<unknown, number, number, Version>;
 type CarGroup = AnyLink[];
 type CarLog = CarGroup[];
@@ -362,20 +386,42 @@ interface StoreFactory {
     }>;
     decodeFile?: (blocks: unknown, cid: AnyLink, meta: DocFileMeta) => Promise<File>;
 }
-interface StoreOpts extends StoreFactory {
-    readonly isIndex?: string;
-    readonly stores?: {
-        readonly base?: CoerceURI;
-        readonly meta?: CoerceURI;
-        readonly data?: CoerceURI;
-        readonly index?: CoerceURI;
-        readonly wal?: CoerceURI;
-    };
+interface StoreUrls {
+    readonly meta: CoerceURI;
+    readonly data: CoerceURI;
+    readonly wal: CoerceURI;
+}
+interface StoreEnDeFile {
+    readonly encodeFile: (blob: BlobLike) => Promise<{
+        cid: AnyLink;
+        blocks: AnyBlock[];
+    }>;
+    readonly decodeFile: (blocks: unknown, cid: AnyLink, meta: DocFileMeta) => Promise<File>;
+}
+interface StoreUrlsOpts {
+    readonly base?: CoerceURI;
+    readonly data?: Partial<StoreUrls>;
+    readonly idx?: Partial<StoreUrls>;
+}
+interface StoreURIs {
+    readonly meta: URI;
+    readonly data: URI;
+    readonly file: URI;
+    readonly wal: URI;
+}
+interface StoreURIRuntime {
+    readonly data: StoreURIs;
+    readonly idx: StoreURIs;
+}
+interface StoreFactoryItem {
+    readonly sthis: SuperThis;
+    readonly url: URI;
+    readonly keybag: KeyBag;
 }
 interface StoreRuntime {
-    makeMetaStore(loader: Loadable): Promise<MetaStore>;
-    makeDataStore(loader: Loadable): Promise<DataStore>;
-    makeWALStore(loader: Loadable): Promise<WALStore>;
+    makeMetaStore(sfi: StoreFactoryItem): Promise<MetaStore>;
+    makeDataStore(sfi: StoreFactoryItem): Promise<DataStore>;
+    makeWALStore(sfi: StoreFactoryItem): Promise<WALStore>;
     encodeFile(blob: BlobLike): Promise<{
         cid: AnyLink;
         blocks: AnyBlock[];
@@ -403,6 +449,7 @@ interface Connection {
 }
 interface BaseStore {
     readonly storeType: StoreType;
+    readonly realGateway: Gateway;
     url(): URI;
     readonly name: string;
     onStarted(fn: () => void): void;
@@ -413,14 +460,16 @@ interface BaseStore {
     readonly ready?: () => Promise<void>;
     start(): Promise<Result<URI>>;
 }
+interface DbMetaEvent {
+    readonly eventCid: CarClockLink;
+    readonly parents: string[];
+    readonly dbMeta: DbMeta;
+}
 interface MetaStore extends BaseStore {
     readonly storeType: "meta";
     load(branch?: string): Promise<DbMeta[] | Falsy>;
     save(meta: DbMeta, branch?: string): Promise<Result<void>>;
-    handleByteHeads(byteHeads: Uint8Array, branch?: string): Promise<{
-        eventCid: CarClockLink;
-        dbMeta: DbMeta;
-    }[]>;
+    handleByteHeads(byteHeads: Uint8Array, branch?: string): Promise<DbMetaEvent[]>;
 }
 interface DataSaveOpts {
     readonly public: boolean;
@@ -454,46 +503,53 @@ type CompactFetcher = BlockFetcher & {
     readonly loggedBlocks: CarTransaction;
 };
 type CompactFn = (blocks: CompactFetcher) => Promise<TransactionMeta>;
+interface StoreRuntimeUrls {
+    readonly meta: URI;
+    readonly data: URI;
+    readonly wal: URI;
+}
 type BlockstoreOpts = Partial<{
     readonly logger: Logger;
     readonly applyMeta: (meta: TransactionMeta, snap?: boolean) => Promise<void>;
     readonly compact: CompactFn;
     readonly autoCompact: number;
     readonly crypto: CryptoRuntime;
-    readonly store: StoreOpts;
-    readonly keyBag: KeyBagOpts;
     readonly public: boolean;
     readonly meta: DbMeta;
-    readonly name: string;
     readonly threshold: number;
-}>;
+    readonly storeEnDeFile: Partial<StoreEnDeFile>;
+}> & {
+    readonly keyBag: KeyBagRuntime;
+    readonly storeUrls: StoreURIs;
+    readonly storeRuntime: StoreRuntime;
+};
 interface BlockstoreRuntime {
     readonly logger: Logger;
     readonly applyMeta: (meta: TransactionMeta, snap?: boolean) => Promise<void>;
     readonly compact: CompactFn;
     readonly autoCompact: number;
     readonly crypto: CryptoRuntime;
-    readonly store: StoreOpts;
     readonly storeRuntime: StoreRuntime;
-    readonly keyBag: Partial<KeyBagOpts>;
+    readonly keyBag: KeyBagRuntime;
+    readonly storeUrls: StoreURIs;
     readonly meta?: DbMeta;
-    readonly name?: string;
     readonly threshold: number;
 }
 interface Loadable {
-    readonly name: string;
     readonly sthis: SuperThis;
     readonly ebOpts: BlockstoreRuntime;
-    remoteCarStore?: DataStore;
-    carStore(): Promise<DataStore>;
     carLog: CarLog;
     remoteMetaStore?: MetaStore;
     remoteFileStore?: DataStore;
-    taskManager?: TaskManager;
+    remoteCarStore?: DataStore;
+    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>;
 }
 type DbMetaEventBlock = EventBlock<{
@@ -502,44 +558,17 @@ type DbMetaEventBlock = EventBlock<{
 type CarClockLink = Link<DbMetaEventBlock, number, number, Version>;
 type CarClockHead = CarClockLink[];
 
-interface GatewayOpts {
-    readonly gateway: Gateway;
-}
-type GetResult = Result<Uint8Array, NotFoundError | Error>;
-type VoidResult = Result<void>;
-interface TestGateway {
-    get(url: URI, key: string): Promise<Uint8Array>;
-}
-type UnsubscribeResult = Result<() => void>;
-interface Gateway {
-    buildUrl(baseUrl: URI, key: string): Promise<Result<URI>>;
-    start(baseUrl: URI): Promise<Result<URI>>;
-    close(baseUrl: URI): Promise<VoidResult>;
-    destroy(baseUrl: URI): Promise<VoidResult>;
-    put(url: URI, body: Uint8Array): Promise<VoidResult>;
-    get(url: URI): Promise<GetResult>;
-    delete(url: URI): Promise<VoidResult>;
-    subscribe?(url: URI, callback: (meta: Uint8Array) => void): Promise<UnsubscribeResult>;
-}
-
-interface GatewayFactoryItem {
-    readonly protocol: string;
-    readonly overrideBaseURL?: string;
-    readonly overrideRegistration?: boolean;
-    readonly gateway: (sthis: SuperThis) => Promise<Gateway>;
-    readonly test: (sthis: SuperThis) => Promise<TestGateway>;
-}
-interface GatewayReady {
+interface GatewayInstances {
     readonly gateway: Gateway;
     readonly test: TestGateway;
 }
-declare function getGatewayFromURL(url: URI, sthis: SuperThis): Promise<GatewayReady | undefined>;
-declare function registerStoreProtocol(item: GatewayFactoryItem): () => void;
+interface GatewayReady extends GatewayInstances {
+    readonly url: URI;
+}
+declare function getStartedGateway(sthis: SuperThis, url: URI): Promise<Result<GatewayReady>>;
 declare function testStoreFactory(url: URI, sthis: SuperThis): Promise<TestGateway>;
-declare function ensureStart<T>(store: T & {
-    start: () => Promise<Result<URI>>;
-}, logger: Logger): Promise<T>;
-declare function toStoreRuntime(opts: StoreOpts, sthis: SuperThis): StoreRuntime;
+declare function ensureStoreEnDeFile(ende?: Partial<StoreEnDeFile>): StoreEnDeFile;
+declare function toStoreRuntime(sthis: SuperThis, endeOpts?: Partial<StoreEnDeFile>): StoreRuntime;
 
 declare class FragmentGateway implements Gateway {
     readonly sthis: SuperThis;
@@ -559,13 +588,20 @@ declare class FragmentGateway implements Gateway {
     delete(url: URI): Promise<VoidResult>;
 }
 
-interface Connectable {
-    readonly blockstore: {
-        readonly loader?: Loader;
-        readonly ebOpts: BlockstoreRuntime;
-    };
-    readonly name?: string;
+interface GatewayFactoryItem {
+    readonly protocol: string;
+    readonly isDefault?: boolean;
+    readonly defaultURI: (sthis: SuperThis) => URI;
+    readonly gateway: (sthis: SuperThis) => Promise<Gateway>;
+    readonly test: (sthis: SuperThis) => Promise<TestGateway>;
 }
+declare function getDefaultURI(sthis: SuperThis, protocol?: string): URI;
+declare function registerStoreProtocol(item: GatewayFactoryItem): () => void;
+declare function getGatewayFactoryItem(protocol: string): GatewayFactoryItem | undefined;
+declare function fileGatewayFactoryItem(): GatewayFactoryItem;
+
+declare function parseCarFile<T>(reader: CarReader, logger: Logger): Promise<CarHeader<T>>;
+
 declare abstract class ConnectionBase implements Connection {
     loader?: Loadable;
     taskManager?: TaskManager;
@@ -586,8 +622,6 @@ declare abstract class ConnectionBase implements Connection {
     }): Promise<void>;
 }
 
-declare function parseCarFile<T>(reader: CarReader, logger: Logger): Promise<CarHeader<T>>;
-
 declare function setCryptoKeyFromGatewayMetaPayload(uri: URI, sthis: SuperThis, data: Uint8Array): Promise<Result<DbMeta | undefined>>;
 declare function addCryptoKeyToGatewayMetaPayload(uri: URI, sthis: SuperThis, body: Uint8Array): Promise<Result<Uint8Array>>;
 
@@ -620,13 +654,13 @@ type index$3_CompactFetcher = CompactFetcher;
 type index$3_CompactFn = CompactFn;
 type index$3_CompactionFetcher = CompactionFetcher;
 declare const index$3_CompactionFetcher: typeof CompactionFetcher;
-type index$3_Connectable = Connectable;
 type index$3_Connection = Connection;
 type index$3_ConnectionBase = ConnectionBase;
 declare const index$3_ConnectionBase: typeof ConnectionBase;
 type index$3_DataSaveOpts = DataSaveOpts;
 type index$3_DataStore = DataStore;
 type index$3_DbMeta = DbMeta;
+type index$3_DbMetaEvent = DbMetaEvent;
 type index$3_DbMetaEventBlock = DbMetaEventBlock;
 type index$3_EncryptedBlock = EncryptedBlock;
 type index$3_EncryptedBlockstore = EncryptedBlockstore;
@@ -648,9 +682,15 @@ type index$3_Loadable = Loadable;
 type index$3_Loader = Loader;
 declare const index$3_Loader: typeof Loader;
 type index$3_MetaStore = MetaStore;
+type index$3_StoreEnDeFile = StoreEnDeFile;
 type index$3_StoreFactory = StoreFactory;
-type index$3_StoreOpts = StoreOpts;
+type index$3_StoreFactoryItem = StoreFactoryItem;
 type index$3_StoreRuntime = StoreRuntime;
+type index$3_StoreRuntimeUrls = StoreRuntimeUrls;
+type index$3_StoreURIRuntime = StoreURIRuntime;
+type index$3_StoreURIs = StoreURIs;
+type index$3_StoreUrls = StoreUrls;
+type index$3_StoreUrlsOpts = StoreUrlsOpts;
 type index$3_TestGateway = TestGateway;
 type index$3_TransactionMeta = TransactionMeta;
 type index$3_TransactionWrapper<M extends TransactionMeta> = TransactionWrapper<M>;
@@ -659,8 +699,11 @@ type index$3_VoidResult = VoidResult;
 type index$3_WALState = WALState;
 type index$3_WALStore = WALStore;
 declare const index$3_addCryptoKeyToGatewayMetaPayload: typeof addCryptoKeyToGatewayMetaPayload;
-declare const index$3_ensureStart: typeof ensureStart;
-declare const index$3_getGatewayFromURL: typeof getGatewayFromURL;
+declare const index$3_ensureStoreEnDeFile: typeof ensureStoreEnDeFile;
+declare const index$3_fileGatewayFactoryItem: typeof fileGatewayFactoryItem;
+declare const index$3_getDefaultURI: typeof getDefaultURI;
+declare const index$3_getGatewayFactoryItem: typeof getGatewayFactoryItem;
+declare const index$3_getStartedGateway: typeof getStartedGateway;
 declare const index$3_parseCarFile: typeof parseCarFile;
 declare const index$3_registerStoreProtocol: typeof registerStoreProtocol;
 declare const index$3_setCryptoKeyFromGatewayMetaPayload: typeof setCryptoKeyFromGatewayMetaPayload;
@@ -668,35 +711,66 @@ declare const index$3_testStoreFactory: typeof testStoreFactory;
 declare const index$3_toCIDBlock: typeof toCIDBlock;
 declare const index$3_toStoreRuntime: typeof toStoreRuntime;
 declare namespace index$3 {
-  export { type index$3_AnyAnyBlock as AnyAnyBlock, type index$3_AnyAnyLink as AnyAnyLink, type index$3_AnyBlock as AnyBlock, type index$3_AnyDecodedBlock as AnyDecodedBlock, type index$3_AnyLink as AnyLink, type index$3_AnyLinkFn as AnyLinkFn, index$3_BaseBlockstore as BaseBlockstore, type index$3_BaseStore as BaseStore, type index$3_BlobLike as BlobLike, type index$3_BlockFetcher as BlockFetcher, type index$3_BlockstoreOpts as BlockstoreOpts, type index$3_BlockstoreRuntime as BlockstoreRuntime, type index$3_BytesWithIv as BytesWithIv, type index$3_CIDBlock as CIDBlock, type index$3_CarClockHead as CarClockHead, type index$3_CarClockLink as CarClockLink, type index$3_CarGroup as CarGroup, type index$3_CarHeader as CarHeader, type index$3_CarLog as CarLog, type index$3_CarMakeable as CarMakeable, index$3_CarTransaction as CarTransaction, type index$3_CodecOpts as CodecOpts, type index$3_CommitOpts as CommitOpts, type index$3_CompactFetcher as CompactFetcher, type index$3_CompactFn as CompactFn, index$3_CompactionFetcher as CompactionFetcher, type index$3_Connectable as Connectable, type index$3_Connection as Connection, index$3_ConnectionBase as ConnectionBase, type index$3_DataSaveOpts as DataSaveOpts, type index$3_DataStore as DataStore, type index$3_DbMeta as DbMeta, type index$3_DbMetaEventBlock as DbMetaEventBlock, type index$3_EncryptedBlock as EncryptedBlock, index$3_EncryptedBlockstore as EncryptedBlockstore, index$3_FragmentGateway as FragmentGateway, type index$3_Gateway as Gateway, type index$3_GatewayFactoryItem as GatewayFactoryItem, type index$3_GatewayOpts as GatewayOpts, type index$3_GetResult as GetResult, type index$3_IvAndBytes as IvAndBytes, type index$3_IvKeyIdData as IvKeyIdData, type index$3_KeyMaterial as KeyMaterial, type index$3_KeyWithFingerExtract as KeyWithFingerExtract, type index$3_KeyWithFingerPrint as KeyWithFingerPrint, type index$3_KeyedCrypto as KeyedCrypto, type index$3_LoadHandler as LoadHandler, type index$3_Loadable as Loadable, index$3_Loader as Loader, type index$3_MetaStore as MetaStore, type index$3_StoreFactory as StoreFactory, type index$3_StoreOpts as StoreOpts, type index$3_StoreRuntime as StoreRuntime, type index$3_TestGateway as TestGateway, type index$3_TransactionMeta as TransactionMeta, type index$3_TransactionWrapper as TransactionWrapper, type index$3_UnsubscribeResult as UnsubscribeResult, type index$3_VoidResult as VoidResult, type index$3_WALState as WALState, type index$3_WALStore as WALStore, index$3_addCryptoKeyToGatewayMetaPayload as addCryptoKeyToGatewayMetaPayload, index$3_ensureStart as ensureStart, index$3_getGatewayFromURL as getGatewayFromURL, index$3_parseCarFile as parseCarFile, index$3_registerStoreProtocol as registerStoreProtocol, index$3_setCryptoKeyFromGatewayMetaPayload as setCryptoKeyFromGatewayMetaPayload, index$3_testStoreFactory as testStoreFactory, index$3_toCIDBlock as toCIDBlock, index$3_toStoreRuntime as toStoreRuntime };
+  export { type index$3_AnyAnyBlock as AnyAnyBlock, type index$3_AnyAnyLink as AnyAnyLink, type index$3_AnyBlock as AnyBlock, type index$3_AnyDecodedBlock as AnyDecodedBlock, type index$3_AnyLink as AnyLink, type index$3_AnyLinkFn as AnyLinkFn, index$3_BaseBlockstore as BaseBlockstore, type index$3_BaseStore as BaseStore, type index$3_BlobLike as BlobLike, type index$3_BlockFetcher as BlockFetcher, type index$3_BlockstoreOpts as BlockstoreOpts, type index$3_BlockstoreRuntime as BlockstoreRuntime, type index$3_BytesWithIv as BytesWithIv, type index$3_CIDBlock as CIDBlock, type index$3_CarClockHead as CarClockHead, type index$3_CarClockLink as CarClockLink, type index$3_CarGroup as CarGroup, type index$3_CarHeader as CarHeader, type index$3_CarLog as CarLog, type index$3_CarMakeable as CarMakeable, index$3_CarTransaction as CarTransaction, type index$3_CodecOpts as CodecOpts, type index$3_CommitOpts as CommitOpts, type index$3_CompactFetcher as CompactFetcher, type index$3_CompactFn as CompactFn, index$3_CompactionFetcher as CompactionFetcher, type index$3_Connection as Connection, index$3_ConnectionBase as ConnectionBase, type index$3_DataSaveOpts as DataSaveOpts, type index$3_DataStore as DataStore, type index$3_DbMeta as DbMeta, type index$3_DbMetaEvent as DbMetaEvent, type index$3_DbMetaEventBlock as DbMetaEventBlock, type index$3_EncryptedBlock as EncryptedBlock, index$3_EncryptedBlockstore as EncryptedBlockstore, index$3_FragmentGateway as FragmentGateway, type index$3_Gateway as Gateway, type index$3_GatewayFactoryItem as GatewayFactoryItem, type index$3_GatewayOpts as GatewayOpts, type index$3_GetResult as GetResult, type index$3_IvAndBytes as IvAndBytes, type index$3_IvKeyIdData as IvKeyIdData, type index$3_KeyMaterial as KeyMaterial, type index$3_KeyWithFingerExtract as KeyWithFingerExtract, type index$3_KeyWithFingerPrint as KeyWithFingerPrint, type index$3_KeyedCrypto as KeyedCrypto, type index$3_LoadHandler as LoadHandler, type index$3_Loadable as Loadable, index$3_Loader as Loader, type index$3_MetaStore as MetaStore, type index$3_StoreEnDeFile as StoreEnDeFile, type index$3_StoreFactory as StoreFactory, type index$3_StoreFactoryItem as StoreFactoryItem, type index$3_StoreRuntime as StoreRuntime, type index$3_StoreRuntimeUrls as StoreRuntimeUrls, type index$3_StoreURIRuntime as StoreURIRuntime, type index$3_StoreURIs as StoreURIs, type index$3_StoreUrls as StoreUrls, type index$3_StoreUrlsOpts as StoreUrlsOpts, type index$3_TestGateway as TestGateway, type index$3_TransactionMeta as TransactionMeta, type index$3_TransactionWrapper as TransactionWrapper, type index$3_UnsubscribeResult as UnsubscribeResult, type index$3_VoidResult as VoidResult, type index$3_WALState as WALState, type index$3_WALStore as WALStore, index$3_addCryptoKeyToGatewayMetaPayload as addCryptoKeyToGatewayMetaPayload, index$3_ensureStoreEnDeFile as ensureStoreEnDeFile, index$3_fileGatewayFactoryItem as fileGatewayFactoryItem, index$3_getDefaultURI as getDefaultURI, index$3_getGatewayFactoryItem as getGatewayFactoryItem, index$3_getStartedGateway as getStartedGateway, index$3_parseCarFile as parseCarFile, index$3_registerStoreProtocol as registerStoreProtocol, index$3_setCryptoKeyFromGatewayMetaPayload as setCryptoKeyFromGatewayMetaPayload, index$3_testStoreFactory as testStoreFactory, index$3_toCIDBlock as toCIDBlock, index$3_toStoreRuntime as toStoreRuntime };
 }
 
 type Falsy = false | null | undefined;
 declare function isFalsy(value: unknown): value is Falsy;
+declare enum PARAM {
+    SUFFIX = "suffix",
+    URL_GEN = "urlGen",
+    STORE_KEY = "storekey",
+    STORE = "store",
+    KEY = "key",
+    INDEX = "index",
+    NAME = "name",
+    VERSION = "version",
+    FRAG_SIZE = "fragSize",
+    IV_VERIFY = "ivVerify",
+    IV_HASH = "ivHash",
+    FRAG_FID = "fid",
+    FRAG_OFS = "ofs",
+    FRAG_LEN = "len",
+    FRAG_HEAD = "headerSize"
+}
 declare function throwFalsy<T>(value: T | Falsy): T;
 declare function falsyToUndef<T>(value: T | Falsy): T | undefined;
 type StoreType = "data" | "wal" | "meta";
+interface FPStats {
+    isFile(): boolean;
+    isDirectory(): boolean;
+    isBlockDevice(): boolean;
+    isCharacterDevice(): boolean;
+    isSymbolicLink(): boolean;
+    isFIFO(): boolean;
+    isSocket(): boolean;
+    uid: number | Falsy;
+    gid: number | Falsy;
+    size: number | Falsy;
+    atime: Date | Falsy;
+    mtime: Date | Falsy;
+    ctime: Date | Falsy;
+    birthtime: Date | Falsy;
+}
 interface SysFileSystem {
     start(): Promise<SysFileSystem>;
-    mkdir(path: PathLike, options?: {
+    mkdir(path: string, options?: {
         recursive: boolean;
     }): Promise<string | undefined>;
-    readdir(path: PathLike, options?: unknown): Promise<string[]>;
-    rm(path: PathLike, options?: MakeDirectoryOptions & {
+    readdir(path: string): Promise<string[]>;
+    rm(path: string, options?: {
         recursive: boolean;
     }): Promise<void>;
-    copyFile(source: PathLike, destination: PathLike): Promise<void>;
-    readfile(path: PathLike, options?: {
-        encoding: BufferEncoding;
-        flag?: string;
-    }): Promise<Uint8Array>;
-    stat(path: PathLike): Promise<Stats>;
-    unlink(path: PathLike): Promise<void>;
-    writefile(path: PathLike, data: Uint8Array | string): Promise<void>;
+    copyFile(source: string, destination: string): Promise<void>;
+    readfile(path: string): Promise<Uint8Array>;
+    stat(path: string): Promise<FPStats>;
+    unlink(path: string): Promise<void>;
+    writefile(path: string, data: Uint8Array | string): Promise<void>;
 }
 interface PathOps {
     join(...args: string[]): string;
     dirname(path: string): string;
+    basename(path: string): string;
 }
 interface TextEndeCoder {
     encode(input: string): Uint8Array;
@@ -716,12 +790,14 @@ interface SuperThis {
     readonly pathOps: PathOps;
     readonly ctx: Record<string, unknown>;
     readonly txt: TextEndeCoder;
-    nextId(bytes?: number): {
+    timeOrderedNextId(time?: number): {
         str: string;
-        bin: Uint8Array;
+        toString: () => string;
     };
-    timeOrderedNextId(time?: number): {
+    nextId(bytes?: number): {
         str: string;
+        bin: Uint8Array;
+        toString: () => string;
     };
     start(): Promise<void>;
     clone(override: Partial<SuperThisOpts>): SuperThis;
@@ -729,10 +805,11 @@ interface SuperThis {
 interface ConfigOpts extends Partial<SuperThisOpts> {
     readonly public?: boolean;
     readonly meta?: DbMeta;
-    readonly persistIndexes?: boolean;
     readonly autoCompact?: number;
-    readonly store?: StoreOpts;
+    readonly storeUrls?: StoreUrlsOpts;
+    readonly storeEnDe?: StoreEnDeFile;
     readonly threshold?: number;
+    readonly keyBag?: Partial<KeyBagOpts>;
 }
 type ClockLink = EventLink<Operation>;
 type ClockHead = ClockLink[];
@@ -902,13 +979,11 @@ interface ProllyNode<K extends IndexKeyType, T extends DocFragment> extends Prol
     readonly block: Promise<Block$1>;
 }
 
-declare function index$2<K extends IndexKeyType = string, T extends DocTypes = NonNullable<unknown>, R extends DocFragment = T>(sthis: SuperThis, { _crdt }: {
-    _crdt: CRDT<T> | CRDT<NonNullable<unknown>>;
-}, name: string, mapFn?: MapFn<T>, meta?: IdxMeta): Index<K, T, R>;
+declare function index$2<K extends IndexKeyType = string, T extends DocTypes = NonNullable<unknown>, R extends DocFragment = T>(refDb: HasCRDT<T>, name: string, mapFn?: MapFn<T>, meta?: IdxMeta): Index<K, T, R>;
 declare class Index<K extends IndexKeyType, T extends DocTypes, R extends DocFragment = T> {
     readonly blockstore: BaseBlockstore;
     readonly crdt: CRDT<T>;
-    name: string;
+    readonly name: string;
     mapFn?: MapFn<T>;
     mapFnString: string;
     byKey: IndexTree<K, R>;
@@ -917,8 +992,6 @@ declare class Index<K extends IndexKeyType, T extends DocTypes, R extends DocFra
     includeDocsDefault: boolean;
     initError?: Error;
     ready(): Promise<void>;
-    close(): Promise<void>;
-    destroy(): Promise<void>;
     readonly logger: Logger;
     constructor(sthis: SuperThis, crdt: CRDT<T> | CRDT<NonNullable<unknown>>, name: string, mapFn?: MapFn<T>, meta?: IdxMeta);
     applyMapFn(name: string, mapFn?: MapFn<T>, meta?: IdxMeta): void;
@@ -948,6 +1021,7 @@ declare class CRDTClock<T extends DocTypes> {
     readonly emptyWatchers: Set<() => void>;
     readonly blockstore: BaseBlockstore;
     readonly applyHeadQueue: ApplyHeadQueue<T>;
+    transaction?: CarTransaction;
     readonly _ready: ResolveOnce<void>;
     ready(): Promise<void>;
     close(): Promise<void>;
@@ -963,16 +1037,18 @@ declare class CRDTClock<T extends DocTypes> {
     int_applyHead(newHead: ClockHead, prevHead: ClockHead, localUpdates: boolean): Promise<void>;
 }
 
+interface HasCRDT<T extends DocTypes> {
+    readonly crdt: CRDT<T> | CRDT<NonNullable<unknown>>;
+}
 declare class CRDT<T extends DocTypes> {
-    readonly name?: string;
-    readonly opts: ConfigOpts;
+    readonly opts: DatabaseOpts;
     readonly blockstore: BaseBlockstore;
     readonly indexBlockstore: BaseBlockstore;
     readonly indexers: Map<string, Index<IndexKeyType, NonNullable<unknown>>>;
     readonly clock: CRDTClock<T>;
     readonly logger: Logger;
     readonly sthis: SuperThis;
-    constructor(sthis: SuperThis, name?: string, opts?: ConfigOpts);
+    constructor(sthis: SuperThis, opts: DatabaseOpts);
     bulk(updates: DocUpdate<T>[]): Promise<CRDTMeta>;
     readonly onceReady: ResolveOnce<void>;
     ready(): Promise<void>;
@@ -992,23 +1068,90 @@ declare class CRDT<T extends DocTypes> {
     compact(): Promise<void>;
 }
 
-declare class Database<DT extends DocTypes = NonNullable<unknown>> implements Connectable {
-    static databases: Map<string, Database>;
+declare function keyConfigOpts(sthis: SuperThis, name?: string, opts?: ConfigOpts): string;
+interface DatabaseOpts {
     readonly name?: string;
-    readonly opts: ConfigOpts;
+    readonly meta?: DbMeta;
+    readonly storeUrls: StoreURIRuntime;
+    readonly storeEnDe: StoreEnDeFile;
+    readonly keyBag: KeyBagRuntime;
+}
+interface Database<DT extends DocTypes = NonNullable<unknown>> extends HasCRDT<DT> {
+    readonly logger: Logger;
+    readonly sthis: SuperThis;
+    readonly id: string;
+    name(): string;
+    onClosed(fn: () => void): void;
+    close(): Promise<void>;
+    destroy(): Promise<void>;
+    ready(): Promise<void>;
+    get<T extends DocTypes>(id: string): Promise<DocWithId<T>>;
+    put<T extends DocTypes>(doc: DocSet<T>): Promise<DocResponse>;
+    del(id: string): Promise<DocResponse>;
+    changes<T extends DocTypes>(since?: ClockHead, opts?: ChangesOptions): Promise<ChangesResponse<T>>;
+    allDocs<T extends DocTypes>(opts?: AllDocsQueryOpts): Promise<AllDocsResponse<T>>;
+    allDocuments<T extends DocTypes>(): Promise<{
+        rows: {
+            key: string;
+            value: DocWithId<T>;
+        }[];
+        clock: ClockHead;
+    }>;
+    subscribe<T extends DocTypes>(listener: ListenerFn<T>, updates?: boolean): () => void;
+    query<K extends IndexKeyType, T extends DocTypes, R extends DocFragment = T>(field: string | MapFn<T>, opts?: QueryOpts<K>): Promise<IndexRows<K, T, R>>;
+    compact(): Promise<void>;
+}
+declare function isDatabase<T extends DocTypes = NonNullable<unknown>>(db: unknown): db is Database<T>;
+declare function DatabaseFactory<T extends DocTypes = NonNullable<unknown>>(name: string | undefined, opts?: ConfigOpts): Database<T>;
+declare class DatabaseShell<DT extends DocTypes = NonNullable<unknown>> implements Database<DT> {
+    readonly ref: DatabaseImpl<DT>;
+    constructor(ref: DatabaseImpl<DT>);
+    get id(): string;
+    get logger(): Logger;
+    get sthis(): SuperThis;
+    get crdt(): CRDT<DT>;
+    name(): string;
+    onClosed(fn: () => void): void;
+    close(): Promise<void>;
+    destroy(): Promise<void>;
+    ready(): Promise<void>;
+    get<T extends DocTypes>(id: string): Promise<DocWithId<T>>;
+    put<T extends DocTypes>(doc: DocSet<T>): Promise<DocResponse>;
+    del(id: string): Promise<DocResponse>;
+    changes<T extends DocTypes>(since?: ClockHead, opts?: ChangesOptions): Promise<ChangesResponse<T>>;
+    allDocs<T extends DocTypes>(opts?: AllDocsQueryOpts): Promise<AllDocsResponse<T>>;
+    allDocuments<T extends DocTypes>(): Promise<{
+        rows: {
+            key: string;
+            value: DocWithId<T>;
+        }[];
+        clock: ClockHead;
+    }>;
+    subscribe<T extends DocTypes>(listener: ListenerFn<T>, updates?: boolean): () => void;
+    query<K extends IndexKeyType, T extends DocTypes, R extends DocFragment = T>(field: string | MapFn<T>, opts?: QueryOpts<K>): Promise<IndexRows<K, T, R>>;
+    compact(): Promise<void>;
+}
+declare class DatabaseImpl<DT extends DocTypes = NonNullable<unknown>> implements Database<DT> {
+    readonly opts: DatabaseOpts;
     _listening: boolean;
     readonly _listeners: Set<ListenerFn<DT>>;
     readonly _noupdate_listeners: Set<ListenerFn<DT>>;
-    readonly _crdt: CRDT<DT>;
+    readonly crdt: CRDT<DT>;
     readonly _writeQueue: WriteQueue<DT>;
-    readonly blockstore: BaseBlockstore;
+    readonly shells: Set<DatabaseShell<DT>>;
+    addShell(shell: DatabaseShell<DT>): void;
+    readonly _onClosedFns: Set<() => void>;
+    onClosed(fn: () => void): void;
     close(): Promise<void>;
+    shellClose(db: DatabaseShell<DT>): Promise<void>;
     destroy(): Promise<void>;
     readonly _ready: ResolveOnce<void>;
     ready(): Promise<void>;
     readonly logger: Logger;
     readonly sthis: SuperThis;
-    constructor(name?: string, opts?: ConfigOpts);
+    readonly id: string;
+    constructor(sthis: SuperThis, opts: DatabaseOpts);
+    name(): string;
     get<T extends DocTypes>(id: string): Promise<DocWithId<T>>;
     put<T extends DocTypes>(doc: DocSet<T>): Promise<DocResponse>;
     del(id: string): Promise<DocResponse>;
@@ -1027,6 +1170,7 @@ declare class Database<DT extends DocTypes = NonNullable<unknown>> implements Co
     _notify(updates: DocUpdate<NonNullable<unknown>>[]): Promise<void>;
     _no_update_notify(): Promise<void>;
 }
+declare function toStoreURIRuntime(sthis: SuperThis, name?: string, sopts?: StoreUrlsOpts): StoreURIRuntime;
 declare function fireproof(name: string, opts?: ConfigOpts): Database;
 
 declare function getFileSystem(url: URI): Promise<SysFileSystem>;
@@ -1130,5 +1274,5 @@ declare namespace index {
 
 declare const PACKAGE_VERSION: string;
 
-export { type AllDocsQueryOpts, type AllDocsResponse, CRDT, type CRDTEntry, type CRDTMeta, type ChangesOptions, type ChangesResponse, type ChangesResponseRow, type ClockHead, type ClockLink, type ConfigOpts, type Connectable, Database, 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 Falsy, type FileTransactionMeta, type IdxMeta, type IdxMetaMap, Index, type IndexKey, type IndexKeyType, type IndexRow, type IndexRows, type IndexTransactionMeta, type IndexUpdate, type IndexUpdateString, type Joiner, type KeyLiteral, type ListenerFn, type MapFn, type MetaType, type NoUpdateListenerFn, NotFoundError, PACKAGE_VERSION, type PathOps, type QueryOpts, type Store, type StoreType, type SuperThis, type SuperThisOpts, type SysFileSystem, type TextEndeCoder, UInt8ArrayEqual, type UnknownDoc, type UpdateListenerFn, index$3 as blockstore, index$3 as bs, dataDir, ensureLogger, ensureSuperLog, ensureSuperThis, exceptionWrapper, falsyToUndef, fireproof, getKey, getName, getStore, index$2 as index, isFalsy, isNotFoundError, index as rt, index as runtime, throwFalsy };
+export { type AllDocsQueryOpts, type AllDocsResponse, CRDT, type CRDTEntry, type CRDTMeta, type ChangesOptions, type ChangesResponse, type ChangesResponseRow, type ClockHead, type ClockLink, type ConfigOpts, type Database, DatabaseFactory, type DatabaseOpts, DatabaseShell, 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 IdxMeta, type IdxMetaMap, Index, type IndexKey, type IndexKeyType, type IndexRow, type IndexRows, type IndexTransactionMeta, type IndexUpdate, type IndexUpdateString, type Joiner, type KeyLiteral, type ListenerFn, type MapFn, type MetaType, type NoUpdateListenerFn, NotFoundError, PACKAGE_VERSION, PARAM, type PathOps, type QueryOpts, type Store, type StoreType, type SuperThis, type SuperThisOpts, type SysFileSystem, type TextEndeCoder, UInt8ArrayEqual, type UnknownDoc, type UpdateListenerFn, index$3 as blockstore, index$3 as bs, ensureLogger, ensureSuperLog, ensureSuperThis, exceptionWrapper, falsyToUndef, fireproof, getKey, getName, getStore, index$2 as index, isDatabase, isFalsy, isNotFoundError, keyConfigOpts, index as rt, index as runtime, throwFalsy, toStoreURIRuntime };
 declare module '@fireproof/core'