mindoodb 0.0.2 → 0.0.4

package/dist/browser/appendonlystores/IndexedDBContentAddressedStore.d.ts

@@ -0,0 +1,65 @@
+/**
+ * IndexedDB-backed ContentAddressedStore for browser environments.
+ *
+ * Provides persistent, indexed storage using the IndexedDB API. All indexing
+ * is delegated to IDB itself (no in-memory maps), keeping memory usage low
+ * even for stores with hundreds of thousands of entries.
+ *
+ * Schema (IDB version 1):
+ *   - `entries`     : metadata per entry id, indexed by docId, contentHash,
+ *                     (entryType, createdAt), and (createdAt, id)
+ *   - `content`     : encrypted payload per contentHash with reference counting
+ *   - `bloom_cache` : single cached bloom filter summary, incrementally updated
+ *                     on inserts and fully rebuilt on purge or size threshold
+ *
+ * @module IndexedDBContentAddressedStore
+ */
+import type { ContentAddressedStore, DocumentMaterializationBatchPlan, DocumentMaterializationPlan, MaterializationPlanOptions, StoreIndexBuildStatus, AwaitIndexReadyOptions, StoreScanCursor, StoreScanFilters, StoreScanResult, StoreIdBloomSummary, OpenStoreOptions } from "../../core/appendonlystores/types";
+import type { StoreEntry, StoreEntryMetadata, StoreEntryType } from "../../core/types";
+import { Logger } from "../../core/logging";
+/**
+ * An IndexedDB-backed ContentAddressedStore.
+ *
+ * Each instance maps to a single IndexedDB database named
+ * `mindoodb_<prefix>_<storeId>` where `prefix` comes from `options.basePath`
+ * and defaults to `"default"`.
+ *
+ * Entries are stored in an `entries` object store with IDB indexes that
+ * replace the in-memory Map indexes used by the InMemory and OnDisk stores.
+ * Encrypted payloads are deduplicated via a `content` object store keyed
+ * by `contentHash` with a `refCount` field.
+ *
+ * A single `bloom_cache` record avoids recomputing the bloom filter on every
+ * `getIdBloomSummary()` call.
+ */
+export declare class IndexedDBContentAddressedStore implements ContentAddressedStore {
+    private readonly storeId;
+    private readonly idbName;
+    private readonly logger;
+    private db;
+    private openPromise;
+    constructor(storeId: string, logger?: Logger, options?: OpenStoreOptions);
+    /** Lazily open the IDB database, creating object stores on first access. */
+    private ensureOpen;
+    getId(): string;
+    getCacheIdentity(): string;
+    putEntries(entries: StoreEntry[]): Promise<void>;
+    getEntries(ids: string[]): Promise<StoreEntry[]>;
+    hasEntries(ids: string[]): Promise<string[]>;
+    findNewEntries(knownIds: string[]): Promise<StoreEntryMetadata[]>;
+    findNewEntriesForDoc(knownIds: string[], docId: string): Promise<StoreEntryMetadata[]>;
+    findEntries(type: StoreEntryType, creationDateFrom: number | null, creationDateUntil: number | null): Promise<StoreEntryMetadata[]>;
+    getAllIds(): Promise<string[]>;
+    scanEntriesSince(cursor: StoreScanCursor | null, limit?: number, filters?: StoreScanFilters): Promise<StoreScanResult>;
+    getIdBloomSummary(): Promise<StoreIdBloomSummary>;
+    planDocumentMaterialization(docId: string, options?: MaterializationPlanOptions): Promise<DocumentMaterializationPlan>;
+    planDocumentMaterializationBatch(docIds: string[], options?: MaterializationPlanOptions): Promise<DocumentMaterializationBatchPlan>;
+    resolveDependencies(startId: string, options?: Record<string, unknown>): Promise<string[]>;
+    purgeDocHistory(docId: string): Promise<void>;
+    clearAllLocalData(): Promise<void>;
+    awaitIndexReady(_options?: AwaitIndexReadyOptions): Promise<StoreIndexBuildStatus>;
+    getIndexBuildStatus(): StoreIndexBuildStatus;
+    private matchesScanFilters;
+    private readEntriesForDoc;
+}
+//# sourceMappingURL=IndexedDBContentAddressedStore.d.ts.map

package/dist/browser/appendonlystores/IndexedDBContentAddressedStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBContentAddressedStore.d.ts","sourceRoot":"","sources":["../../../src/browser/appendonlystores/IndexedDBContentAddressedStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,gCAAgC,EAChC,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAoC,MAAM,oBAAoB,CAAC;AAyN9E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,8BAA+B,YAAW,qBAAqB;IAC1E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,WAAW,CAAqC;gBAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAkBxE,4EAA4E;IAC5E,OAAO,CAAC,UAAU;IA4ElB,KAAK,IAAI,MAAM;IAIf,gBAAgB,IAAI,MAAM;IAIpB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgGhD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAuChD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqB5C,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA6BjE,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA8B1B,WAAW,CACf,IAAI,EAAE,cAAc,EACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAC/B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAoC1B,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB9B,gBAAgB,CACpB,MAAM,EAAE,eAAe,GAAG,IAAI,EAC9B,KAAK,GAAE,MAAgC,EACvC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC;IA4DrB,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAiCjD,2BAA2B,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,2BAA2B,CAAC;IAKjC,gCAAgC,CACpC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,gCAAgC,CAAC;IAiBtC,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC;IAuDd,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoE7C,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBlC,eAAe,CACnB,QAAQ,CAAC,EAAE,sBAAsB,GAChC,OAAO,CAAC,qBAAqB,CAAC;IAQjC,mBAAmB,IAAI,qBAAqB;IAY5C,OAAO,CAAC,kBAAkB;YA+BZ,iBAAiB;CAuBhC"}