@hashtree/core 0.1.0

package/dist/store/dexie.js

@@ -0,0 +1,196 @@
+/**
+ * Dexie-based IndexedDB store for hashtree blobs
+ * More robust than raw IndexedDB - handles errors, upgrades, and stuck connections better
+ */
+import Dexie from 'dexie';
+import { toHex, fromHex } from '../types.js';
+class HashTreeDB extends Dexie {
+    blobs;
+    constructor(dbName) {
+        super(dbName);
+        // Version 1: Original schema without lastAccess
+        this.version(1).stores({
+            blobs: '&hashHex',
+        });
+        // Version 2: Add lastAccess field for LRU eviction
+        this.version(2).stores({
+            blobs: '&hashHex, lastAccess',
+        }).upgrade(tx => {
+            // Add lastAccess to existing entries
+            const now = Date.now();
+            return tx.table('blobs').toCollection().modify(blob => {
+                blob.lastAccess = now;
+            });
+        });
+    }
+}
+/**
+ * Dexie-based Store implementation
+ * Drop-in replacement for IndexedDBStore with better error handling
+ */
+export class DexieStore {
+    db;
+    constructor(dbName = 'hashtree') {
+        this.db = new HashTreeDB(dbName);
+    }
+    async put(hash, data) {
+        const hashHex = toHex(hash);
+        try {
+            // Store directly - IDB will clone the data internally
+            await this.db.blobs.put({ hashHex, data, lastAccess: Date.now() });
+            return true;
+        }
+        catch (e) {
+            console.error('[DexieStore] put error:', e);
+            return false;
+        }
+    }
+    async get(hash) {
+        if (!hash)
+            return null;
+        const hashHex = toHex(hash);
+        try {
+            const entry = await this.db.blobs.get(hashHex);
+            if (!entry)
+                return null;
+            // Update lastAccess timestamp for LRU tracking (fire-and-forget)
+            // We need to re-put the entry to avoid fake-indexeddb corruption issues with partial updates
+            this.db.blobs.put({ ...entry, lastAccess: Date.now() }).catch(() => { });
+            // Return directly - IDB returns a fresh copy already
+            // Only slice if the view doesn't match the buffer (rare edge case)
+            const data = entry.data;
+            if (data.byteOffset === 0 && data.byteLength === data.buffer.byteLength) {
+                return data;
+            }
+            // Rare: view is a subset of a larger buffer, need to copy
+            return new Uint8Array(data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength));
+        }
+        catch (e) {
+            console.error('[DexieStore] get error:', e);
+            return null;
+        }
+    }
+    async has(hash) {
+        const hashHex = toHex(hash);
+        try {
+            // Use count with where clause - doesn't load the blob data
+            const count = await this.db.blobs.where('hashHex').equals(hashHex).count();
+            return count > 0;
+        }
+        catch (e) {
+            console.error('[DexieStore] has error:', e);
+            return false;
+        }
+    }
+    async delete(hash) {
+        const hashHex = toHex(hash);
+        try {
+            const existed = await this.has(hash);
+            if (existed) {
+                await this.db.blobs.delete(hashHex);
+                return true;
+            }
+            return false;
+        }
+        catch (e) {
+            console.error('[DexieStore] delete error:', e);
+            return false;
+        }
+    }
+    /**
+     * Get all stored hashes
+     */
+    async keys() {
+        try {
+            // Only fetch the primary keys, not the blob data
+            const hashHexes = await this.db.blobs.toCollection().primaryKeys();
+            return hashHexes.map(hex => fromHex(hex));
+        }
+        catch (e) {
+            console.error('[DexieStore] keys error:', e);
+            return [];
+        }
+    }
+    /**
+     * Clear all data
+     */
+    async clear() {
+        try {
+            await this.db.blobs.clear();
+        }
+        catch (e) {
+            console.error('[DexieStore] clear error:', e);
+        }
+    }
+    /**
+     * Get count of stored items
+     */
+    async count() {
+        try {
+            return await this.db.blobs.count();
+        }
+        catch (e) {
+            console.error('[DexieStore] count error:', e);
+            return 0;
+        }
+    }
+    /**
+     * Get total bytes stored
+     * Uses cursor to avoid loading all blobs into memory at once
+     */
+    async totalBytes() {
+        try {
+            let total = 0;
+            await this.db.blobs.each(entry => {
+                total += entry.data.byteLength;
+            });
+            return total;
+        }
+        catch (e) {
+            console.error('[DexieStore] totalBytes error:', e);
+            return 0;
+        }
+    }
+    /**
+     * Evict least-recently-used entries until totalBytes is below maxBytes.
+     * Returns the number of entries deleted.
+     */
+    async evict(maxBytes) {
+        try {
+            const currentBytes = await this.totalBytes();
+            if (currentBytes <= maxBytes)
+                return 0;
+            // Get entries sorted by lastAccess (oldest first)
+            const entries = await this.db.blobs.orderBy('lastAccess').toArray();
+            let bytesRemoved = 0;
+            let entriesRemoved = 0;
+            const targetRemoval = currentBytes - maxBytes;
+            for (const entry of entries) {
+                if (bytesRemoved >= targetRemoval)
+                    break;
+                await this.db.blobs.delete(entry.hashHex);
+                bytesRemoved += entry.data.byteLength;
+                entriesRemoved++;
+            }
+            console.log(`[DexieStore] Evicted ${entriesRemoved} entries (${bytesRemoved} bytes)`);
+            return entriesRemoved;
+        }
+        catch (e) {
+            console.error('[DexieStore] evict error:', e);
+            return 0;
+        }
+    }
+    /**
+     * Close the database connection
+     */
+    close() {
+        this.db.close();
+    }
+    /**
+     * Delete the entire database
+     */
+    static async deleteDatabase(dbName = 'hashtree') {
+        await Dexie.delete(dbName);
+    }
+}
+//# sourceMappingURL=dexie.js.map

package/dist/store/dexie.js.map

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

package/dist/store/fallback.d.ts

@@ -0,0 +1,40 @@
+/**
+ * FallbackStore - Store with cascading fallback sources
+ *
+ * Tries stores in order until data is found.
+ * Caches successful remote fetches to primary store.
+ *
+ * Example: local (Dexie) -> WebRTC -> Blossom
+ */
+import type { Store, Hash } from '../types.js';
+/** Minimal interface for read-only fallback sources */
+export interface ReadableStore {
+    get(hash: Hash): Promise<Uint8Array | null>;
+}
+/** Minimal interface for writable stores (optional put for fire-and-forget writes) */
+export interface WritableStore extends ReadableStore {
+    put?(hash: Hash, data: Uint8Array): Promise<boolean>;
+}
+export interface FallbackStoreConfig {
+    /** Primary local store (reads/writes) */
+    primary: Store;
+    /** Fallback stores to try in order (read-only, writes are fire-and-forget) */
+    fallbacks: WritableStore[];
+    /** Timeout for fallback stores (ms) */
+    timeout?: number;
+}
+export declare class FallbackStore implements Store {
+    private primary;
+    private fallbacks;
+    private timeout;
+    constructor(config: FallbackStoreConfig);
+    put(hash: Hash, data: Uint8Array): Promise<boolean>;
+    get(hash: Hash): Promise<Uint8Array | null>;
+    has(hash: Hash): Promise<boolean>;
+    delete(hash: Hash): Promise<boolean>;
+    /** Add a fallback store dynamically */
+    addFallback(store: WritableStore): void;
+    /** Remove a fallback store */
+    removeFallback(store: WritableStore): void;
+}
+//# sourceMappingURL=fallback.d.ts.map

package/dist/store/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/store/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE/C,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC7C;AAED,sFAAsF;AACtF,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,OAAO,EAAE,KAAK,CAAC;IACf,8EAA8E;IAC9E,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAc,YAAW,KAAK;IACzC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,mBAAmB;IAMjC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBnD,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA4B3C,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C,uCAAuC;IACvC,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIvC,8BAA8B;IAC9B,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;CAI3C"}

package/dist/store/fallback.js

@@ -0,0 +1,71 @@
+/**
+ * FallbackStore - Store with cascading fallback sources
+ *
+ * Tries stores in order until data is found.
+ * Caches successful remote fetches to primary store.
+ *
+ * Example: local (Dexie) -> WebRTC -> Blossom
+ */
+export class FallbackStore {
+    primary;
+    fallbacks;
+    timeout;
+    constructor(config) {
+        this.primary = config.primary;
+        this.fallbacks = config.fallbacks;
+        this.timeout = config.timeout ?? 5000;
+    }
+    async put(hash, data) {
+        // Write to primary
+        const success = await this.primary.put(hash, data);
+        // Fire-and-forget writes to fallback stores (if they support put)
+        for (const store of this.fallbacks) {
+            if (store.put) {
+                store.put(hash, data).catch(() => {
+                    // Silently ignore - fallbacks are best-effort
+                });
+            }
+        }
+        return success;
+    }
+    async get(hash) {
+        // Try primary first
+        let data = await this.primary.get(hash);
+        if (data)
+            return data;
+        // Try fallbacks with timeout
+        for (const store of this.fallbacks) {
+            try {
+                const fetchPromise = store.get(hash);
+                const timeoutPromise = new Promise(resolve => setTimeout(() => resolve(null), this.timeout));
+                data = await Promise.race([fetchPromise, timeoutPromise]);
+                if (data) {
+                    // Cache to primary
+                    await this.primary.put(hash, data);
+                    return data;
+                }
+            }
+            catch {
+                // Continue to next fallback
+            }
+        }
+        return null;
+    }
+    async has(hash) {
+        return this.primary.has(hash);
+    }
+    async delete(hash) {
+        return this.primary.delete(hash);
+    }
+    /** Add a fallback store dynamically */
+    addFallback(store) {
+        this.fallbacks.push(store);
+    }
+    /** Remove a fallback store */
+    removeFallback(store) {
+        const idx = this.fallbacks.indexOf(store);
+        if (idx >= 0)
+            this.fallbacks.splice(idx, 1);
+    }
+}
+//# sourceMappingURL=fallback.js.map

package/dist/store/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../src/store/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH,MAAM,OAAO,aAAa;IAChB,OAAO,CAAQ;IACf,SAAS,CAAkB;IAC3B,OAAO,CAAS;IAExB,YAAY,MAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAU,EAAE,IAAgB;QACpC,mBAAmB;QACnB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEnD,kEAAkE;QAClE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBACd,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBAC/B,8CAA8C;gBAChD,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAU;QAClB,oBAAoB;QACpB,IAAI,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QAEtB,6BAA6B;QAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACrC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,CACjD,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAC9C,CAAC;gBAEF,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;gBAE1D,IAAI,IAAI,EAAE,CAAC;oBACT,mBAAmB;oBACnB,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACnC,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAU;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAU;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,uCAAuC;IACvC,WAAW,CAAC,KAAoB;QAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,8BAA8B;IAC9B,cAAc,CAAC,KAAoB;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,GAAG,IAAI,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/store/index.d.ts

@@ -0,0 +1,6 @@
+export { MemoryStore } from './memory.js';
+export { OpfsStore, type OpfsStoreOptions } from './opfs.js';
+export { BlossomStore, type BlossomStoreConfig, type BlossomServer, type BlossomSigner, type BlossomAuthEvent } from './blossom.js';
+export { DexieStore } from './dexie.js';
+export { FallbackStore, type FallbackStoreConfig, type ReadableStore, type WritableStore } from './fallback.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpI,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/store/index.js

@@ -0,0 +1,6 @@
+export { MemoryStore } from './memory.js';
+export { OpfsStore } from './opfs.js';
+export { BlossomStore } from './blossom.js';
+export { DexieStore } from './dexie.js';
+export { FallbackStore } from './fallback.js';
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAyB,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,YAAY,EAA0F,MAAM,cAAc,CAAC;AACpI,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAoE,MAAM,eAAe,CAAC"}

package/dist/store/memory.d.ts

@@ -0,0 +1,29 @@
+/**
+ * In-memory content-addressed store
+ * Useful for testing and temporary data
+ */
+import { Store, Hash } from '../types.js';
+export declare class MemoryStore implements Store {
+    private data;
+    put(hash: Hash, data: Uint8Array): Promise<boolean>;
+    get(hash: Hash): Promise<Uint8Array | null>;
+    has(hash: Hash): Promise<boolean>;
+    delete(hash: Hash): Promise<boolean>;
+    /**
+     * Get number of stored items
+     */
+    get size(): number;
+    /**
+     * Get total bytes stored
+     */
+    get totalBytes(): number;
+    /**
+     * Clear all data
+     */
+    clear(): void;
+    /**
+     * List all hashes
+     */
+    keys(): Hash[];
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/store/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/store/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAS,MAAM,aAAa,CAAC;AAEjD,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,IAAI,CAAiC;IAEvC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAUnD,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQ3C,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAMvB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,EAAE;CASf"}

package/dist/store/memory.js

@@ -0,0 +1,66 @@
+/**
+ * In-memory content-addressed store
+ * Useful for testing and temporary data
+ */
+import { toHex } from '../types.js';
+export class MemoryStore {
+    data = new Map();
+    async put(hash, data) {
+        const key = toHex(hash);
+        if (this.data.has(key)) {
+            return false;
+        }
+        // Store a copy to prevent external mutation
+        this.data.set(key, new Uint8Array(data));
+        return true;
+    }
+    async get(hash) {
+        const key = toHex(hash);
+        const data = this.data.get(key);
+        if (!data)
+            return null;
+        // Return a copy to prevent external mutation
+        return new Uint8Array(data);
+    }
+    async has(hash) {
+        return this.data.has(toHex(hash));
+    }
+    async delete(hash) {
+        return this.data.delete(toHex(hash));
+    }
+    /**
+     * Get number of stored items
+     */
+    get size() {
+        return this.data.size;
+    }
+    /**
+     * Get total bytes stored
+     */
+    get totalBytes() {
+        let total = 0;
+        for (const data of this.data.values()) {
+            total += data.length;
+        }
+        return total;
+    }
+    /**
+     * Clear all data
+     */
+    clear() {
+        this.data.clear();
+    }
+    /**
+     * List all hashes
+     */
+    keys() {
+        return Array.from(this.data.keys()).map(hex => {
+            const bytes = new Uint8Array(hex.length / 2);
+            for (let i = 0; i < bytes.length; i++) {
+                bytes[i] = parseInt(hex.substr(i * 2, 2), 16);
+            }
+            return bytes;
+        });
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/store/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/store/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAe,KAAK,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,OAAO,WAAW;IACd,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE7C,KAAK,CAAC,GAAG,CAAC,IAAU,EAAE,IAAgB;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,4CAA4C;QAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAU;QAClB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,6CAA6C;QAC7C,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAU;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAC5C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/store/opfs.d.ts

@@ -0,0 +1,56 @@
+/**
+ * OPFS (Origin Private File System) content-addressed store
+ * Persistent browser storage using the File System Access API
+ *
+ * Files are stored as: <dirName>/<first2chars>/<hash>.bin
+ * This provides sharding to avoid too many files in one directory.
+ */
+import { Store, Hash } from '../types.js';
+export interface OpfsStoreOptions {
+    /** Directory name in OPFS root (default: 'hashtree') */
+    dirName?: string;
+}
+export declare class OpfsStore implements Store {
+    private dirName;
+    private rootDir;
+    private storeDir;
+    private initPromise;
+    constructor(options?: OpfsStoreOptions | string);
+    /**
+     * Get or create the store directory (with deduplication)
+     */
+    private getStoreDir;
+    /**
+     * Get shard directory for a hash (first 2 hex chars)
+     */
+    private getShardDir;
+    put(hash: Hash, data: Uint8Array): Promise<boolean>;
+    get(hash: Hash): Promise<Uint8Array | null>;
+    has(hash: Hash): Promise<boolean>;
+    delete(hash: Hash): Promise<boolean>;
+    /**
+     * Get all stored hashes
+     */
+    keys(): Promise<Hash[]>;
+    /**
+     * Clear all data
+     */
+    clear(): Promise<void>;
+    /**
+     * Get count of stored items
+     */
+    count(): Promise<number>;
+    /**
+     * Get total bytes stored
+     */
+    totalBytes(): Promise<number>;
+    /**
+     * Close - cleanup any resources
+     */
+    close(): Promise<void>;
+    /**
+     * Delete the entire store directory
+     */
+    static deleteStore(dirName?: string): Promise<void>;
+}
+//# sourceMappingURL=opfs.d.ts.map

package/dist/store/opfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opfs.d.ts","sourceRoot":"","sources":["../../src/store/opfs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAkB,MAAM,aAAa,CAAC;AAI1D,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAU,YAAW,KAAK;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,WAAW,CAAmD;gBAE1D,OAAO,GAAE,gBAAgB,GAAG,MAAyB;IAQjE;;OAEG;YACW,WAAW;IAezB;;OAEG;YACW,WAAW;IAWnB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BnD,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAiB3C,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAajC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAa1C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAoB7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAoBnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;WACU,WAAW,CAAC,OAAO,GAAE,MAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ5E"}