@fireproof/core-types-base 0.23.1 → 0.23.2

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../jsr/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/indexer.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexer.js","sourceRoot":"","sources":["indexer.ts"],"names":[],"mappings":""}
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../jsr/indexer.ts"],"names":[],"mappings":""}

package/key-bag-if.js.map

@@ -1 +1 @@
-{"version":3,"file":"key-bag-if.js","sourceRoot":"","sources":["key-bag-if.ts"],"names":[],"mappings":""}
+{"version":3,"file":"key-bag-if.js","sourceRoot":"","sources":["../jsr/key-bag-if.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fireproof/core-types-base",
-  "version": "0.23.1",
+  "version": "0.23.2",
   "description": "Live ledger for the web.",
   "type": "module",
   "main": "./index.js",
@@ -32,8 +32,8 @@
   },
   "dependencies": {
     "@adviser/cement": "^0.4.23",
-    "@fireproof/core-types-blockstore": "0.23.1",
-    "@fireproof/vendor": "0.23.1",
+    "@fireproof/core-types-blockstore": "0.23.2",
+    "@fireproof/vendor": "0.23.2",
     "@web3-storage/pail": "^0.6.2",
     "multiformats": "^13.4.0",
     "prolly-trees": "^1.0.4"

package/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../jsr/types.ts"],"names":[],"mappings":"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"}

package/index.ts

@@ -1,3 +0,0 @@
-export * from "./indexer.js";
-export * from "./key-bag-if.js";
-export * from "./types.js";

package/indexer.ts

@@ -1,46 +0,0 @@
-/// <reference types="./prolly-trees.d.ts" />
-
-import { Logger } from "@adviser/cement";
-import {
-  BaseBlockstore,
-  ClockHead,
-  CRDT,
-  DocFragment,
-  DocTypes,
-  IdxMeta,
-  IndexKeyType,
-  IndexRows,
-  MapFn,
-  QueryOpts,
-} from "./types.js";
-import { AnyLink } from "@fireproof/core-types-blockstore";
-
-import { BaseNode } from "prolly-trees/base";
-
-export interface IndexTree<K extends IndexKeyType, R extends DocFragment> {
-  cid?: AnyLink;
-  root?: BaseNode<K, R>;
-  // root?: ProllyNode<K, R>;
-}
-
-export interface IndexIf<T extends DocTypes, K extends IndexKeyType = string, R extends DocFragment = T> {
-  readonly blockstore: BaseBlockstore;
-  readonly crdt: CRDT;
-  readonly name: string;
-  mapFn?: MapFn<T>;
-  readonly mapFnString: string;
-  indexHead?: ClockHead;
-
-  initError?: Error;
-
-  byKey: IndexTree<K, R>;
-  byId: IndexTree<K, R>;
-
-  ready(): Promise<void>;
-
-  readonly logger: Logger;
-
-  applyMapFn(name: string, mapFn?: MapFn<T>, meta?: IdxMeta): void;
-
-  query(opts: QueryOpts<K>): Promise<IndexRows<T, K, R>>;
-}

package/key-bag-if.ts

@@ -1,15 +0,0 @@
-import { Logger, URI, Result } from "@adviser/cement";
-import { KeysByFingerprint } from "@fireproof/core-types-blockstore";
-import { KeyBagRuntime } from "./types.js";
-
-export interface KeyBagIf {
-  readonly logger: Logger;
-  readonly rt: KeyBagRuntime;
-
-  subtleKey(materialStrOrUint8: string | Uint8Array): Promise<CryptoKey>;
-
-  ensureKeyFromUrl(url: URI, keyFactory: () => string): Promise<Result<URI>>;
-  // flush(): Promise<void>;
-
-  getNamedKey(name: string, failIfNotFound?: boolean, material?: string | Uint8Array): Promise<Result<KeysByFingerprint>>;
-}

package/prolly-trees.d.ts

@@ -1,91 +0,0 @@
-declare module "prolly-trees/base" {
-  declare type AnyLink = Link<unknown, number, number, Version>;
-  declare type KeyLiteral = string | number | boolean;
-  declare type IndexKeyType = KeyLiteral | KeyLiteral[];
-
-  declare type DocFragment = Uint8Array | string | number | boolean | null | AnyLink | DocFragment[] | object;
-
-  declare interface IndexRow<K extends IndexKeyType, T extends DocFragment> {
-    readonly id: string;
-    readonly key: IndexKey<K>;
-    readonly value: T;
-  }
-  // ProllyNode type based on the ProllyNode from 'prolly-trees/base'
-  declare interface BaseNode<K extends IndexKeyType, T extends DocFragment> {
-    getAllEntries(): PromiseLike<{ [x: string]: unknown; result: IndexRow<K, T>[] }>;
-    getMany<KI extends IndexKeyType>(removeIds: KI[]): Promise<{ /* [x: K]: unknown; */ result: IndexKey<K>[] }>;
-    range(a: string, b: string): Promise<{ result: ProllyIndexRow<K, T>[] }>;
-    get(key: string): Promise<{ result: ProllyIndexRow<K, T>[] }>;
-    bulk(bulk: (IndexUpdate<K> | IndexUpdateString)[]): PromiseLike<{
-      readonly root?: ProllyNode<K, T>;
-      readonly blocks: Block[];
-    }>;
-    readonly address: Promise<Link>;
-    readonly distance: number;
-    compare: (a: unknown, b: unknown) => number;
-    readonly cache: unknown;
-    readonly block: Promise<Block>;
-  }
-
-  declare interface StaticProllyOptions<T> {
-    readonly cache: unknown;
-    chunker: (entry: T, distance: number) => Promise<boolean>;
-    readonly codec: unknown;
-    readonly hasher: unknown;
-    compare: (a: T, b: T) => number;
-  }
-}
-
-declare module "prolly-trees/db-index" {
-  declare function create<K extends IndexKeyType, T extends DocFragment>(opts: CreateOpts): Promise<BaseNode<K, T>[]>;
-  declare function load(opts: LoadOpts): Promise<BaseNode>;
-}
-
-declare module "prolly-trees/utils" {
-  declare interface Entry {
-    identity(): number;
-  }
-  declare function bf<T>(factor: number): (entry: T, dist: number) => Promise<boolean>;
-  // declare function bf(factor: number): (entry: Entry) => Promise<boolean>;
-  declare function simpleCompare(a: number | string, b: number | string): number;
-}
-
-declare module "prolly-trees/cache" {
-  declare interface Address {
-    asCID: string;
-  }
-  declare interface Node {
-    address: Address;
-  }
-  declare interface Cache {
-    has(): boolean;
-    get(key: Address): Node | undefined;
-    set(node: Node): Promise<void>;
-  }
-  declare const nocache: Cache;
-  declare const global: Cache;
-}
-
-declare module "prolly-trees/cid-set" {
-  declare interface CreateOpts {
-    get: unknown;
-    cache: Cache;
-    chunker: unknown;
-    list: unknown;
-    codec: unknown;
-    hasher: unknown;
-    sorted: unknown;
-  }
-  declare function create(opts: CreateOpts): void;
-
-  declare interface LoadOpts {
-    cid: Address;
-    get: unknown;
-    cache: Cache;
-    chunker: unknown;
-    codec: unknown;
-    hasher: unknown;
-    // ...opts: unkown
-  }
-  declare function load(opts: LoadOpts): Promise<Node>;
-}

package/tsconfig.json

@@ -1,18 +0,0 @@
-{
-  "extends": [
-    "/home/runner/work/fireproof/fireproof/tsconfig.dist.json"
-  ],
-  "compilerOptions": {
-    "noEmit": false,
-    "outDir": "./"
-  },
-  "include": [
-    "**/*"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist",
-    ".git",
-    ".vscode"
-  ]
-}

package/types.ts

@@ -1,836 +0,0 @@
-import type { EventLink } from "@web3-storage/pail/clock/api";
-import type { Operation } from "@web3-storage/pail/crdt/api";
-import type { Block } from "multiformats";
-import { EnvFactoryOpts, Env, Logger, CryptoRuntime, Result, CoerceURI, AppContext, URI, CTCryptoKey } from "@adviser/cement";
-
-import type {
-  DbMeta,
-  AnyLink,
-  StoreUrlsOpts,
-  StoreEnDeFile,
-  Loadable,
-  TransactionWrapper,
-  BlockstoreRuntime,
-  StoreURIRuntime,
-  DataAndMetaAndWalStore,
-  UrlAndInterceptor,
-  MetaStore,
-  WALStore,
-  BaseStore,
-  FileStore,
-  CarStore,
-  FPBlock,
-  BlockFetcher,
-} from "@fireproof/core-types-blockstore";
-
-import type { IndexIf } from "./indexer.js";
-import { SerdeGatewayInterceptor } from "@fireproof/core-types-blockstore";
-
-export class NotFoundError extends Error {
-  readonly code = "ENOENT";
-}
-
-export type { DbMeta };
-
-export type Falsy = false | null | undefined;
-
-export function isFalsy(value: unknown): value is Falsy {
-  return value === false || value === null || value === undefined;
-}
-
-export const PARAM = {
-  SUFFIX: "suffix",
-  URL_GEN: "urlGen", // "urlGen" | "default"
-  STORE_KEY: "storekey",
-  STORE: "store",
-  KEY: "key",
-  INDEX: "index",
-  NAME: "name",
-  VERSION: "version",
-  RUNTIME: "runtime", // "node" | "deno" | "browser"
-  FRAG_SIZE: "fragSize",
-  IV_VERIFY: "ivVerify",
-  IV_HASH: "ivHash",
-  FRAG_FID: "fid",
-  FRAG_OFS: "ofs",
-  FRAG_LEN: "len",
-  FRAG_HEAD: "headerSize",
-  EXTRACTKEY: "extractKey",
-  SELF_REFLECT: "selfReflect", // if no subscribe in Gateway see your own META updates
-  CAR_PARALLEL: "parallel",
-  CAR_CACHE_SIZE: "carCacheSize",
-  CAR_COMPACT_CACHE_SIZE: "carCompactCacheSize",
-  CAR_META_CACHE_SIZE: "carMetaCacheSize",
-  GENESIS_CID: "baembeiarootfireproofgenesisblockaaaafireproofgenesisblocka",
-  LOCAL_NAME: "localName",
-  // FS = "fs",
-};
-export type PARAMS = (typeof PARAM)[keyof typeof PARAM];
-
-export function throwFalsy<T>(value: T | Falsy): T {
-  if (isFalsy(value)) {
-    throw new Error("value is Falsy");
-  }
-  return value;
-}
-
-export function falsyToUndef<T>(value: T | Falsy): T | undefined {
-  if (isFalsy(value)) {
-    return undefined;
-  }
-  return value;
-}
-
-export type StoreType = "car" | "file" | "wal" | "meta";
-export 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;
-}
-
-export interface SysFileSystem {
-  start(): Promise<SysFileSystem>;
-  mkdir(path: string, options?: { recursive: boolean }): Promise<string | undefined>;
-  readdir(path: string /*, options?: unknown*/): Promise<string[]>;
-  rm(path: string, options?: { recursive: boolean }): Promise<void>;
-  copyFile(source: string, destination: string): Promise<void>;
-  readfile(path: string /*, options?: { encoding: BufferEncoding; flag?: string }*/): Promise<Uint8Array>;
-  stat(path: string): Promise<FPStats>;
-  unlink(path: string): Promise<void>;
-  writefile(path: string, data: Uint8Array | string): Promise<void>;
-}
-
-export interface PathOps {
-  join(...args: string[]): string;
-  dirname(path: string): string;
-  basename(path: string): string;
-}
-
-export type ToUInt8 = Uint8Array | Result<Uint8Array>;
-export type PromiseToUInt8 = ToUInt8 | Promise<Uint8Array> | Promise<Result<Uint8Array>>;
-
-export interface TextEndeCoder {
-  encode(input: string): Uint8Array;
-  decode(input: ToUInt8): string;
-}
-export interface SuperThisOpts {
-  // readonly crypto?: CryptoRuntime;
-  readonly logger: Logger;
-  readonly pathOps: PathOps;
-  readonly crypto: CryptoRuntime;
-  readonly env: Partial<EnvFactoryOpts>;
-  readonly txt: TextEndeCoder;
-  readonly ctx: AppContext;
-}
-
-export interface SuperThis {
-  readonly logger: Logger;
-  readonly loggerCollector?: Logger;
-  readonly env: Env;
-  readonly pathOps: PathOps;
-  readonly ctx: AppContext;
-  readonly txt: TextEndeCoder;
-  timeOrderedNextId(time?: number): { str: string; toString: () => string };
-  nextId(bytes?: number): { str: string; bin: Uint8Array; toString: () => string };
-  start(): Promise<void>;
-  clone(override: Partial<SuperThisOpts>): SuperThis;
-}
-
-export interface IdleEventFromCommitQueue {
-  readonly event: "idleFromCommitQueue";
-}
-export interface IdleEventFromBlockstore {
-  readonly event: "idleFromBlockstore";
-  readonly blockstore: "data" | "index";
-  readonly ledger?: Ledger;
-}
-
-export interface BusyEventFromCommitQueue {
-  readonly event: "busyFromCommitQueue";
-  readonly queueLen: number;
-}
-
-export interface BusyEventFromBlockstore extends Omit<IdleEventFromBlockstore, "event"> {
-  readonly event: "busyFromBlockstore";
-  readonly queueLen: number;
-}
-
-export function EventIsIdleFromBlockstore(event: TraceEvent): event is IdleEventFromBlockstore {
-  return event.event === "idleFromBlockstore";
-}
-
-export function EventIsBusyFromBlockstore(event: TraceEvent): event is BusyEventFromBlockstore {
-  return event.event === "busyFromBlockstore";
-}
-
-export type TraceEvent = IdleEventFromCommitQueue | IdleEventFromBlockstore | BusyEventFromBlockstore | BusyEventFromCommitQueue;
-
-export interface ConfigOpts extends Partial<SuperThisOpts> {
-  readonly public?: boolean;
-  readonly meta?: DbMeta;
-  // readonly persistIndexes?: boolean;
-  readonly writeQueue?: Partial<WriteQueueParams>;
-  readonly gatewayInterceptor?: SerdeGatewayInterceptor;
-  readonly autoCompact?: number;
-  // could be registered with registerCompactStrategy(name: string, compactStrategy: CompactStrategy)
-  readonly compactStrategy?: string; // default "FULL" other "fireproof" , "no-op"
-  readonly storeUrls?: StoreUrlsOpts;
-  readonly storeEnDe?: StoreEnDeFile;
-  readonly threshold?: number;
-  readonly keyBag?: Partial<KeyBagOpts>;
-  readonly tracer?: TraceFn;
-}
-
-// export interface ToCloudOpts {
-//   readonly ledger: string;
-// }
-
-export type ClockLink = EventLink<Operation>;
-
-export type ClockHead = ClockLink[];
-
-export type DocFragment = Uint8Array | string | number | boolean | null | AnyLink | DocFragment[] | object;
-// | { [key: string]: DocFragment };
-
-export type DocLiteral = string | number | boolean | Uint8Array | unknown;
-
-export type DocObject = NonNullable<unknown>;
-export type DocTypes = DocObject;
-
-export type DocRecord<T extends DocObject> = T;
-
-export type UnknownDoc = DocRecord<never>;
-
-export type DocFiles = Record<string, DocFileMeta | File>;
-
-export interface DocBase {
-  readonly _id: string;
-  readonly _files?: DocFiles;
-  readonly _publicFiles?: DocFiles;
-  readonly _deleted?: boolean;
-}
-
-export type DocWithId<T extends DocTypes> = DocBase & T;
-
-export type DocSet<T extends DocTypes> = Partial<DocBase> & T;
-
-export interface DocFileMeta {
-  readonly type: string;
-  readonly size: number;
-  readonly cid: AnyLink;
-  readonly car?: AnyLink;
-  readonly lastModified?: number;
-  url?: string;
-  file?: () => Promise<File>;
-}
-
-export interface DocUpdate<T extends DocTypes> {
-  readonly id: string;
-  readonly value?: DocSet<T>;
-  readonly del?: boolean;
-  readonly clock?: ClockLink; // would be useful to give ClockLinks a type
-}
-
-// todo merge into above
-export interface DocValue<T extends DocTypes> {
-  readonly doc: DocWithId<T>;
-  readonly del: boolean;
-  readonly cid: AnyLink;
-}
-
-export type KeyLiteral = string | number | boolean;
-export type IndexKeyType = KeyLiteral | KeyLiteral[];
-export type IndexKey<K extends IndexKeyType> = [K, string];
-
-export interface IndexUpdate<K extends IndexKeyType> {
-  readonly key: IndexKey<K>;
-  readonly value?: DocFragment;
-  readonly del?: boolean;
-}
-
-export interface IndexUpdateString {
-  readonly key: string;
-  readonly value?: DocFragment;
-  readonly del?: boolean;
-}
-
-// export interface IndexRowObject<K extends IndexKeyType, T extends DocObject> {
-//   readonly id: string;
-//   readonly key: K;
-//   readonly value: T
-//   // readonly row: T // DocFragment;
-//   // readonly doc?: DocWithId<T>;
-//   // value?: T;
-//   // readonly del?: boolean;
-// }
-
-// export interface IndexRowLiteral<K extends IndexKeyType, T extends DocLiteral> {
-//   readonly id: string;
-//   readonly key: IndexKey<K>;
-//   readonly value: T
-// }
-
-// export type IndexRow<K extends IndexKeyType, T extends DocTypes> =
-//   T extends DocLiteral ? IndexRowLiteral<K, T> : IndexRowObject<K, T>
-
-export interface FPIndexRow<K extends IndexKeyType, T extends DocObject, R extends DocFragment> {
-  readonly id: string;
-  readonly key: K; // IndexKey<K>;
-  readonly value: R;
-  readonly doc?: DocWithId<T>;
-}
-
-export interface IndexRows<T extends DocObject, K extends IndexKeyType = string, R extends DocFragment = T> {
-  readonly rows: FPIndexRow<K, T, R>[];
-  readonly docs: DocWithId<T>[];
-}
-export interface CRDTMeta {
-  readonly head: ClockHead;
-}
-
-export interface IndexTransactionMeta {
-  readonly indexes: Record<string, IdxMeta>;
-}
-
-export interface FileTransactionMeta {
-  readonly files?: AnyLink[];
-}
-
-export type MetaType = CRDTMeta | IndexTransactionMeta | FileTransactionMeta;
-
-export interface IdxMeta {
-  readonly byId: AnyLink;
-  readonly byKey: AnyLink;
-  readonly map: string;
-  readonly name: string;
-  readonly head: ClockHead;
-}
-
-export interface IdxMetaMap {
-  readonly indexes?: Map<string, IdxMeta>;
-}
-
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export interface QueryOpts<K extends IndexKeyType> {
-  readonly descending?: boolean;
-  readonly limit?: number;
-  includeDocs?: boolean;
-  readonly range?: [IndexKeyType, IndexKeyType];
-  readonly key?: DocFragment;
-  readonly keys?: DocFragment[];
-  prefix?: IndexKeyType;
-}
-
-export interface AllDocsQueryOpts extends QueryOpts<string> {
-  readonly key: string;
-  readonly keys: string[];
-  readonly prefix: string;
-  /**
-   * Whether to include documents marked as deleted (_deleted: true).
-   * Default is false - deleted documents are excluded.
-   */
-  readonly includeDeleted: boolean;
-}
-
-export interface AllDocsResponse<T extends DocTypes> {
-  readonly rows: {
-    readonly key: string;
-    readonly value: DocWithId<T>;
-  }[];
-  readonly clock: ClockHead;
-  readonly name?: string;
-}
-
-type EmitFn = (k: IndexKeyType, v?: DocFragment) => void;
-export type MapFn<T extends DocTypes> = (doc: DocWithId<T>, emit: EmitFn) => DocFragment | unknown;
-
-export interface ChangesOptions {
-  readonly dirty?: boolean;
-  readonly limit?: number;
-}
-
-export interface ChangesResponseRow<T extends DocTypes> {
-  readonly key: string;
-  readonly value: DocWithId<T>;
-  readonly clock?: ClockLink;
-}
-
-export interface ChangesResponse<T extends DocTypes> {
-  readonly clock: ClockHead;
-  readonly rows: ChangesResponseRow<T>[];
-  readonly name?: string;
-}
-
-export interface DocResponse {
-  readonly id: string;
-  readonly clock: ClockHead;
-  readonly name?: string;
-}
-
-export interface BulkResponse {
-  readonly ids: string[];
-  readonly clock: ClockHead;
-  readonly name?: string;
-}
-
-export type UpdateListenerFn<T extends DocTypes> = (docs: DocWithId<T>[]) => Promise<void> | void;
-export type NoUpdateListenerFn = () => Promise<void> | void;
-export type ListenerFn<T extends DocTypes> = UpdateListenerFn<T> | NoUpdateListenerFn;
-
-export interface CRDTEntry {
-  readonly data: string;
-  readonly parents: string[];
-  readonly cid: string;
-}
-
-export type AsyncVoidFn = () => Promise<void>;
-export type VoidFn = () => void;
-export type UnReg = () => void;
-export interface CRDTClock {
-  readonly head: ClockHead;
-  onTock(fn: VoidFn): UnReg;
-  onTick(fn: (updates: DocUpdate<DocTypes>[]) => void): UnReg;
-  applyHead(newHead: ClockHead, prevHead: ClockHead, updates?: DocUpdate<DocTypes>[]): Promise<void>;
-  onZoom(fn: VoidFn): UnReg;
-  close(): Promise<void>;
-  ready(): Promise<void>;
-}
-
-export interface CarTransaction {
-  readonly parent: BaseBlockstore;
-  get(cid: AnyLink): Promise<FPBlock | Falsy>;
-
-  superGet(cid: AnyLink): Promise<FPBlock | Falsy>;
-
-  // needed for genesis block
-  unshift(fb: FPBlock): void;
-  putSync(fb: FPBlock): void;
-
-  put(fb: FPBlock): Promise<void>;
-
-  entries(): AsyncIterableIterator<FPBlock>;
-}
-
-export interface CarTransactionOpts {
-  readonly add: boolean;
-  readonly noLoader: boolean;
-}
-
-export interface BaseBlockstore {
-  readonly crdtParent?: CRDT;
-  readonly transactions: Set<CarTransaction>;
-  readonly sthis: SuperThis;
-  readonly loader: Loadable;
-  readonly ebOpts: BlockstoreRuntime;
-  ready(): Promise<void>;
-  close(): Promise<void>;
-  destroy(): Promise<void>;
-  compact(): Promise<void>;
-  readonly logger: Logger;
-
-  get(cid: AnyLink): Promise<FPBlock | Falsy>;
-  put(fp: FPBlock): Promise<void>;
-
-  transaction<M extends TransactionMeta>(
-    fn: (t: CarTransaction) => Promise<M>,
-    _opts?: CarTransactionOpts,
-  ): Promise<TransactionWrapper<M>>;
-
-  // get<T, C extends number, A extends number, V extends Version>(cid: AnyAnyLink): Promise<Block<T, C, A, V> | undefined>
-  // transaction<M extends TransactionMeta>(
-  //   fn: (t: CarTransaction) => Promise<M>,
-  //   _opts?: CarTransactionOpts,
-  // ): Promise<TransactionWrapper<M>>
-
-  openTransaction(opts: CarTransactionOpts /* = { add: true, noLoader: false }*/): CarTransaction;
-
-  commitTransaction<M extends TransactionMeta>(
-    t: CarTransaction,
-    done: M,
-    opts: CarTransactionOpts,
-  ): Promise<TransactionWrapper<M>>;
-  entries(): AsyncIterableIterator<FPBlock>;
-}
-
-export interface CRDT extends ReadyCloseDestroy, HasLogger, HasSuperThis, HasCRDT {
-  readonly ledgerParent?: Ledger;
-  readonly logger: Logger;
-  readonly sthis: SuperThis;
-  // self reference to fullfill HasCRDT
-  readonly crdt: CRDT;
-  readonly clock: CRDTClock;
-
-  readonly blockstore: BaseBlockstore;
-  readonly indexBlockstore?: BaseBlockstore;
-  readonly indexers: Map<string, IndexIf<DocTypes, IndexKeyType>>;
-
-  bulk<T extends DocTypes>(updates: DocUpdate<T>[]): Promise<CRDTMeta>;
-  ready(): Promise<void>;
-  close(): Promise<void>;
-  destroy(): Promise<void>;
-  allDocs<T extends DocTypes>(): Promise<{ result: DocUpdate<T>[]; head: ClockHead }>;
-  vis(): Promise<string>;
-  getBlock(cidString: string): Promise<Block>;
-  get(key: string): Promise<DocValue<DocTypes> | Falsy>;
-  // defaults by impl
-  changes<T extends DocTypes>(
-    since?: ClockHead,
-    opts?: ChangesOptions,
-  ): Promise<{
-    result: DocUpdate<T>[];
-    head: ClockHead;
-  }>;
-  compact(): Promise<void>;
-}
-
-export interface HasCRDT {
-  readonly crdt: CRDT;
-}
-
-export interface RefLedger {
-  readonly ledger: Ledger;
-}
-
-export interface HasLogger {
-  readonly logger: Logger;
-}
-
-export interface HasSuperThis {
-  readonly sthis: SuperThis;
-}
-
-export interface ReadyCloseDestroy {
-  close(): Promise<void>;
-  destroy(): Promise<void>;
-  ready(): Promise<void>;
-}
-
-export interface CoerceURIandInterceptor {
-  readonly url: CoerceURI;
-  readonly gatewayInterceptor?: SerdeGatewayInterceptor;
-}
-
-export interface AttachContext {
-  detach(): Promise<void>;
-  readonly ctx: AppContext;
-}
-
-/**
- * @description used by an attachable do define the urls of the attached gateways
- */
-export interface GatewayUrlsParam extends Partial<AttachContext> {
-  readonly car: CoerceURIandInterceptor;
-  readonly file: CoerceURIandInterceptor;
-  readonly meta: CoerceURIandInterceptor;
-  // if set this is a local Attachment
-  readonly wal?: CoerceURIandInterceptor;
-}
-
-export interface GatewayUrls {
-  readonly car: UrlAndInterceptor;
-  readonly file: UrlAndInterceptor;
-  readonly meta: UrlAndInterceptor;
-  readonly wal?: UrlAndInterceptor;
-}
-
-export interface Attachable {
-  readonly name: string;
-  /**
-   * @description prepare allows the Attable to register the gateways and
-   * then return the urls of the gateways
-   */
-  prepare(db?: Ledger): Promise<GatewayUrlsParam>;
-  /**
-   * @description configHash is called on every attach to avoid multiple
-   * calls to prepare with the same config.
-   */
-  configHash(): Promise<string>;
-}
-
-export class DataAndMetaAndWalAndBaseStore implements DataAndMetaAndWalStore {
-  readonly wal?: WALStore | undefined;
-  readonly file: FileStore;
-  readonly car: CarStore;
-  readonly meta: MetaStore;
-  readonly baseStores: BaseStore[];
-
-  constructor(dam: DataAndMetaAndWalStore) {
-    this.wal = dam.wal;
-    this.file = dam.file;
-    this.car = dam.car;
-    this.meta = dam.meta;
-    this.baseStores = [this.file, this.car, this.meta];
-    if (this.wal) {
-      this.baseStores.push(this.wal);
-    }
-  }
-}
-
-export interface Attached {
-  readonly keyed: string;
-
-  readonly gatewayUrls: GatewayUrls;
-
-  readonly stores: DataAndMetaAndWalAndBaseStore;
-
-  detach(): Promise<void>;
-  status(): "attached" | "loading" | "loaded" | "error" | "detached" | "syncing" | "idle";
-
-  ctx(): AppContext;
-}
-
-export interface Database extends ReadyCloseDestroy, HasLogger, HasSuperThis {
-  // readonly name: string;
-  readonly ledger: Ledger;
-  readonly logger: Logger;
-  readonly sthis: SuperThis;
-  // 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>;
-  del(id: string): Promise<DocResponse>;
-  remove(id: string): Promise<DocResponse>;
-  changes<T extends DocTypes>(since?: ClockHead, opts?: ChangesOptions): Promise<ChangesResponse<T>>;
-  allDocs<T extends DocTypes>(opts?: Partial<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<T extends DocTypes, K extends IndexKeyType = string, R extends DocFragment = T>(
-    field: string | MapFn<T>,
-    opts?: QueryOpts<K>,
-  ): Promise<IndexRows<T, K, R>>;
-  compact(): Promise<void>;
-}
-
-export interface WriteQueue<T extends DocUpdate<S>, S extends DocTypes = DocTypes> {
-  push(task: T): Promise<MetaType>;
-  bulk(tasks: T[]): Promise<MetaType>;
-  close(): Promise<void>;
-}
-
-export type TraceFn = (traceEvent: TraceEvent) => void;
-
-export interface Tracer {
-  readonly tracer: TraceFn;
-}
-
-export type TransactionMeta = unknown;
-export interface CompactStrategyContext extends BlockFetcher {
-  readonly transactions: Set<CarTransaction>;
-  readonly clock?: CRDTClock;
-  readonly lastTxMeta: TransactionMeta;
-  readonly loader: Loadable;
-  readonly logger: Logger;
-  readonly blockstore: BlockFetcher;
-  // loader: Loader | null = null
-  readonly loggedBlocks: CarTransaction;
-
-  get(cid: AnyLink): Promise<FPBlock | Falsy>;
-}
-
-export interface CompactStrategy {
-  readonly name: string;
-  compact(block: CompactStrategyContext): Promise<TransactionMeta>;
-}
-
-export interface LedgerOpts extends Tracer {
-  readonly name: string;
-  // readonly public?: boolean;
-  readonly meta?: DbMeta;
-  readonly gatewayInterceptor?: SerdeGatewayInterceptor;
-
-  // could be registered with registerCompactStrategy(name: string, compactStrategy: CompactStrategy)
-  readonly compactStrategy?: string; // default "FULL"
-
-  readonly ctx: AppContext;
-  readonly writeQueue: WriteQueueParams;
-  readonly storeUrls: StoreURIRuntime;
-  readonly storeEnDe: StoreEnDeFile;
-  readonly keyBag: KeyBagRuntime;
-}
-
-export type LedgerOptsOptionalTracer = Omit<LedgerOpts, "tracer"> & Partial<Tracer>;
-
-export interface Ledger extends HasCRDT {
-  readonly opts: LedgerOpts;
-  // readonly name: string;
-  readonly writeQueue: WriteQueue<DocUpdate<DocTypes>>;
-
-  readonly logger: Logger;
-  readonly sthis: SuperThis;
-  // readonly id: string;
-
-  readonly name: string;
-
-  readonly ctx: AppContext;
-
-  // a config and name hash to the same instance
-  refId(): Promise<string>;
-
-  onClosed(fn: () => void): () => void;
-
-  attach(a: Attachable): Promise<Attached>;
-
-  close(): Promise<void>;
-  destroy(): Promise<void>;
-  ready(): Promise<void>;
-
-  subscribe<T extends DocTypes>(listener: ListenerFn<T>, updates?: boolean): () => void;
-
-  // asDB(): Database;
-
-  // 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>;
-  // 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>;
-}
-
-export interface V1StorageKeyItem {
-  readonly name: string;
-  readonly key: string;
-}
-
-export interface V2StorageKeyItem {
-  readonly key: string; // material
-  readonly fingerPrint: string;
-  readonly default: boolean;
-}
-
-// Serialized Version
-export interface V2KeysItem {
-  readonly name: string;
-  readonly keys: Record<string, V2StorageKeyItem>;
-}
-
-export interface KeyMaterial {
-  readonly key: Uint8Array;
-  readonly keyStr: string;
-}
-
-export interface KeyWithFingerPrint {
-  readonly default: boolean;
-  readonly fingerPrint: string;
-  readonly key: CTCryptoKey;
-  extract(): Promise<KeyMaterial>;
-  asV2StorageKeyItem(): Promise<V2StorageKeyItem>;
-}
-
-export interface KeyUpsertResultModified {
-  readonly modified: true;
-  readonly kfp: KeyWithFingerPrint;
-}
-
-export function isKeyUpsertResultModified(r: KeyUpsertResult): r is KeyUpsertResultModified {
-  return r.modified;
-}
-
-export interface KeyUpsertResultNotModified {
-  readonly modified: false;
-}
-
-export type KeyUpsertResult = KeyUpsertResultModified | KeyUpsertResultNotModified;
-
-export interface KeysByFingerprint {
-  readonly id: string;
-  readonly name: string;
-  get(fingerPrint?: string | Uint8Array): Promise<KeyWithFingerPrint | undefined>;
-  upsert(key: string | Uint8Array, def?: boolean): Promise<Result<KeyUpsertResult>>;
-  asV2KeysItem(): Promise<V2KeysItem>;
-}
-
-export interface KeysItem {
-  readonly name: string;
-  readonly keys: Record<string, KeyWithFingerPrint>;
-}
-
-export interface KeyBagProvider {
-  get(id: string): Promise<V1StorageKeyItem | V2KeysItem | undefined>;
-  set(item: V2KeysItem): Promise<void>;
-  del(id: string): Promise<void>;
-}
-
-export interface KeyBagRuntime {
-  readonly url: URI;
-  readonly crypto: CryptoRuntime;
-  readonly logger: Logger;
-  readonly sthis: SuperThis;
-  readonly keyLength: number;
-  // readonly key?: FPCryptoKey;
-  getBagProvider(): Promise<KeyBagProvider>;
-  id(): string;
-}
-
-export interface KeyBagOpts {
-  // in future you can encrypt the keybag with ?masterkey=xxxxx
-  readonly url: CoerceURI;
-  // readonly key: string; // key to encrypt the keybag
-  readonly crypto: CryptoRuntime;
-  readonly keyLength: number; // default: 16
-  // readonly logger: Logger;
-  readonly keyRuntime: KeyBagRuntime;
-}
-
-export interface WriteQueueParams {
-  // default 32
-  // if chunkSize is 1 the result will be ordered in time
-  readonly chunkSize: number;
-}
-
-export function defaultWriteQueueOpts(opts: Partial<WriteQueueParams> = {}): WriteQueueParams {
-  return {
-    ...opts,
-    chunkSize: opts.chunkSize && opts.chunkSize > 0 ? opts.chunkSize : 32,
-  };
-}
-
-export type Readonly2Writeable<T> = {
-  -readonly [P in keyof T]: T[P];
-};
-
-export function isNotFoundError(e: Error | Result<unknown> | unknown): e is NotFoundError {
-  if (Result.Is(e)) {
-    if (e.isOk()) return false;
-    e = e.Err();
-  }
-  if ((e as NotFoundError).code === "ENOENT") return true;
-  return false;
-}