@hashtree/core 0.1.0

package/dist/store/opfs.js

@@ -0,0 +1,200 @@
+/**
+ * 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 { toHex, fromHex } from '../types.js';
+const DEFAULT_DIR_NAME = 'hashtree';
+export class OpfsStore {
+    dirName;
+    rootDir = null;
+    storeDir = null;
+    initPromise = null;
+    constructor(options = DEFAULT_DIR_NAME) {
+        if (typeof options === 'string') {
+            this.dirName = options;
+        }
+        else {
+            this.dirName = options.dirName ?? DEFAULT_DIR_NAME;
+        }
+    }
+    /**
+     * Get or create the store directory (with deduplication)
+     */
+    async getStoreDir() {
+        if (this.storeDir)
+            return this.storeDir;
+        // Deduplicate initialization
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = (async () => {
+            this.rootDir = await navigator.storage.getDirectory();
+            this.storeDir = await this.rootDir.getDirectoryHandle(this.dirName, { create: true });
+            return this.storeDir;
+        })();
+        return this.initPromise;
+    }
+    /**
+     * Get shard directory for a hash (first 2 hex chars)
+     */
+    async getShardDir(hashHex, create) {
+        const storeDir = await this.getStoreDir();
+        const shard = hashHex.slice(0, 2);
+        try {
+            return await storeDir.getDirectoryHandle(shard, { create });
+        }
+        catch {
+            return null;
+        }
+    }
+    async put(hash, data) {
+        const hashHex = toHex(hash);
+        try {
+            const shardDir = await this.getShardDir(hashHex, true);
+            if (!shardDir)
+                return false;
+            // Check if file already exists
+            try {
+                await shardDir.getFileHandle(`${hashHex}.bin`, { create: false });
+                return false; // Already exists
+            }
+            catch {
+                // File doesn't exist, continue to create
+            }
+            const handle = await shardDir.getFileHandle(`${hashHex}.bin`, { create: true });
+            const writable = await handle.createWritable();
+            await writable.write(data);
+            await writable.close();
+            return true;
+        }
+        catch (err) {
+            console.error(`OPFS write failed for ${hashHex}:`, err);
+            return false;
+        }
+    }
+    async get(hash) {
+        if (!hash)
+            return null;
+        const hashHex = toHex(hash);
+        const shardDir = await this.getShardDir(hashHex, false);
+        if (!shardDir)
+            return null;
+        try {
+            const handle = await shardDir.getFileHandle(`${hashHex}.bin`, { create: false });
+            const file = await handle.getFile();
+            const buffer = await file.arrayBuffer();
+            return new Uint8Array(buffer);
+        }
+        catch {
+            return null;
+        }
+    }
+    async has(hash) {
+        const hashHex = toHex(hash);
+        const shardDir = await this.getShardDir(hashHex, false);
+        if (!shardDir)
+            return false;
+        try {
+            await shardDir.getFileHandle(`${hashHex}.bin`, { create: false });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async delete(hash) {
+        const hashHex = toHex(hash);
+        const shardDir = await this.getShardDir(hashHex, false);
+        if (!shardDir)
+            return false;
+        try {
+            await shardDir.removeEntry(`${hashHex}.bin`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get all stored hashes
+     */
+    async keys() {
+        const storeDir = await this.getStoreDir();
+        const hashes = [];
+        // @ts-ignore - entries() exists on FileSystemDirectoryHandle
+        for await (const [, shardHandle] of storeDir.entries()) {
+            if (shardHandle.kind !== 'directory')
+                continue;
+            // @ts-ignore
+            for await (const [fileName] of shardHandle.entries()) {
+                if (fileName.endsWith('.bin')) {
+                    const hashHex = fileName.slice(0, -4);
+                    hashes.push(fromHex(hashHex));
+                }
+            }
+        }
+        return hashes;
+    }
+    /**
+     * Clear all data
+     */
+    async clear() {
+        const storeDir = await this.getStoreDir();
+        // @ts-ignore
+        for await (const [name, handle] of storeDir.entries()) {
+            if (handle.kind === 'directory') {
+                await storeDir.removeEntry(name, { recursive: true });
+            }
+        }
+    }
+    /**
+     * Get count of stored items
+     */
+    async count() {
+        const keys = await this.keys();
+        return keys.length;
+    }
+    /**
+     * Get total bytes stored
+     */
+    async totalBytes() {
+        const storeDir = await this.getStoreDir();
+        let total = 0;
+        // @ts-ignore
+        for await (const [, shardHandle] of storeDir.entries()) {
+            if (shardHandle.kind !== 'directory')
+                continue;
+            // @ts-ignore
+            for await (const [, fileHandle] of shardHandle.entries()) {
+                if (fileHandle.kind === 'file') {
+                    const file = await fileHandle.getFile();
+                    total += file.size;
+                }
+            }
+        }
+        return total;
+    }
+    /**
+     * Close - cleanup any resources
+     */
+    async close() {
+        this.rootDir = null;
+        this.storeDir = null;
+        this.initPromise = null;
+    }
+    /**
+     * Delete the entire store directory
+     */
+    static async deleteStore(dirName = DEFAULT_DIR_NAME) {
+        const root = await navigator.storage.getDirectory();
+        try {
+            await root.removeEntry(dirName, { recursive: true });
+        }
+        catch {
+            // Directory might not exist
+        }
+    }
+}
+//# sourceMappingURL=opfs.js.map

package/dist/store/opfs.js.map

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

package/dist/streaming.d.ts

@@ -0,0 +1,74 @@
+/**
+ * StreamWriter - supports incremental file appends
+ *
+ * Created via HashTree.createStream()
+ *
+ * All chunks are CHK encrypted by default (same as putFile).
+ * Use createStream({ unencrypted: true }) for unencrypted streaming.
+ */
+import { Store, Hash, CID } from './types.js';
+import { type EncryptionKey } from './crypto.js';
+import { type Chunker } from './builder.js';
+export type { Chunker } from './builder.js';
+export interface StreamWriterConfig {
+    store: Store;
+    chunkSize?: number;
+    chunker?: Chunker;
+    unencrypted?: boolean;
+}
+export declare class StreamWriter {
+    private store;
+    private chunker;
+    private unencrypted;
+    private buffer;
+    private bufferOffset;
+    private chunks;
+    private totalSize;
+    constructor(config: StreamWriterConfig);
+    /** @deprecated Use config object instead */
+    constructor(store: Store, chunkSize: number, maxLinks: number, unencrypted?: boolean);
+    /** Get current target chunk size */
+    private currentChunkSize;
+    /**
+     * Append data to the stream
+     */
+    append(data: Uint8Array): Promise<void>;
+    /**
+     * Flush current buffer as a chunk (encrypted or plaintext based on mode)
+     */
+    private flushChunk;
+    /**
+     * Get current root CID without finalizing
+     * Useful for checkpoints (e.g., live streaming)
+     * Returns CID with key for encrypted streams, CID without key for public streams
+     */
+    currentRoot(): Promise<CID | null>;
+    /**
+     * Finalize the stream and return root CID
+     * For encrypted streams: returns { hash, size, key }
+     * For public streams: returns { hash, size } (key is undefined)
+     */
+    finalize(): Promise<{
+        hash: Hash;
+        size: number;
+        key?: EncryptionKey;
+    }>;
+    /**
+     * Build flat tree from chunks
+     */
+    private buildTreeFromChunks;
+    /**
+     * Get stats
+     */
+    get stats(): {
+        chunks: number;
+        buffered: number;
+        totalSize: number;
+    };
+    /**
+     * Clear internal state to release memory
+     * Call after finalize() if you want to free memory immediately
+     */
+    clear(): void;
+}
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAiC,MAAM,YAAY,CAAC;AAG7E,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAU;IAG7B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,YAAY,CAAa;IAGjC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAa;gBAElB,MAAM,EAAE,kBAAkB;IACtC,4CAA4C;gBAChC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO;IAuBpF,oCAAoC;IACpC,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B7C;;OAEG;YACW,UAAU;IAuBxB;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IA2BxC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC;IAuB5E;;OAEG;YACW,mBAAmB;IA0BjC;;OAEG;IACH,IAAI,KAAK,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAMnE;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI;CAMd"}

package/dist/streaming.js

@@ -0,0 +1,199 @@
+/**
+ * StreamWriter - supports incremental file appends
+ *
+ * Created via HashTree.createStream()
+ *
+ * All chunks are CHK encrypted by default (same as putFile).
+ * Use createStream({ unencrypted: true }) for unencrypted streaming.
+ */
+import { LinkType, cid } from './types.js';
+import { encodeAndHash } from './codec.js';
+import { sha256 } from './hash.js';
+import { encryptChk } from './crypto.js';
+import { fixedChunker } from './builder.js';
+export class StreamWriter {
+    store;
+    chunker;
+    unencrypted;
+    // Current partial chunk being built
+    buffer;
+    bufferOffset = 0;
+    // Completed chunks (with encryption keys for tree building when encrypted)
+    chunks = [];
+    totalSize = 0;
+    constructor(storeOrConfig, chunkSize, _maxLinks, unencrypted) {
+        if ('store' in storeOrConfig && typeof storeOrConfig === 'object' && !('get' in storeOrConfig)) {
+            // New config-based constructor
+            const config = storeOrConfig;
+            this.store = config.store;
+            this.chunker = config.chunker ?? fixedChunker(config.chunkSize ?? 2 * 1024 * 1024);
+            this.unencrypted = config.unencrypted ?? false;
+        }
+        else {
+            // Legacy positional constructor (maxLinks ignored)
+            this.store = storeOrConfig;
+            this.chunker = fixedChunker(chunkSize);
+            this.unencrypted = unencrypted ?? false;
+        }
+        // Initialize buffer with first chunk size
+        this.buffer = new Uint8Array(this.chunker(0));
+    }
+    /** Get current target chunk size */
+    currentChunkSize() {
+        return this.chunker(this.chunks.length);
+    }
+    /**
+     * Append data to the stream
+     */
+    async append(data) {
+        let offset = 0;
+        while (offset < data.length) {
+            const targetSize = this.currentChunkSize();
+            // Resize buffer if needed for new chunk size
+            if (this.buffer.length !== targetSize) {
+                const newBuffer = new Uint8Array(targetSize);
+                if (this.bufferOffset > 0) {
+                    newBuffer.set(this.buffer.subarray(0, this.bufferOffset));
+                }
+                this.buffer = newBuffer;
+            }
+            const space = targetSize - this.bufferOffset;
+            const toWrite = Math.min(space, data.length - offset);
+            this.buffer.set(data.subarray(offset, offset + toWrite), this.bufferOffset);
+            this.bufferOffset += toWrite;
+            offset += toWrite;
+            // Flush full chunk
+            if (this.bufferOffset === targetSize) {
+                await this.flushChunk();
+            }
+        }
+        this.totalSize += data.length;
+    }
+    /**
+     * Flush current buffer as a chunk (encrypted or plaintext based on mode)
+     */
+    async flushChunk() {
+        if (this.bufferOffset === 0)
+            return;
+        const chunkSize = this.bufferOffset;
+        // slice() to create independent copy - allows buffer reuse after await
+        const chunk = this.buffer.slice(0, chunkSize);
+        if (this.unencrypted) {
+            // Public mode: store plaintext
+            const hash = await sha256(chunk);
+            await this.store.put(hash, chunk);
+            this.chunks.push({ hash, size: chunkSize, type: LinkType.Blob });
+        }
+        else {
+            // Encrypted mode: CHK encrypt the chunk
+            const { ciphertext, key } = await encryptChk(chunk);
+            const hash = await sha256(ciphertext);
+            await this.store.put(hash, ciphertext);
+            this.chunks.push({ hash, size: chunkSize, key, type: LinkType.Blob });
+        }
+        this.bufferOffset = 0;
+    }
+    /**
+     * Get current root CID without finalizing
+     * Useful for checkpoints (e.g., live streaming)
+     * Returns CID with key for encrypted streams, CID without key for public streams
+     */
+    async currentRoot() {
+        if (this.chunks.length === 0 && this.bufferOffset === 0) {
+            return null;
+        }
+        // Temporarily store buffer without modifying state
+        const tempChunks = [...this.chunks];
+        if (this.bufferOffset > 0) {
+            const chunk = this.buffer.slice(0, this.bufferOffset);
+            if (this.unencrypted) {
+                const hash = await sha256(chunk);
+                await this.store.put(hash, chunk);
+                tempChunks.push({ hash, size: chunk.length, type: LinkType.Blob });
+            }
+            else {
+                // Store PLAINTEXT size in link.size for correct range seeking
+                const plaintextSize = chunk.length;
+                const { ciphertext, key } = await encryptChk(chunk);
+                const hash = await sha256(ciphertext);
+                await this.store.put(hash, ciphertext);
+                tempChunks.push({ hash, size: plaintextSize, key, type: LinkType.Blob });
+            }
+        }
+        return this.buildTreeFromChunks(tempChunks, this.totalSize);
+    }
+    /**
+     * Finalize the stream and return root CID
+     * For encrypted streams: returns { hash, size, key }
+     * For public streams: returns { hash, size } (key is undefined)
+     */
+    async finalize() {
+        // Flush remaining buffer
+        await this.flushChunk();
+        if (this.chunks.length === 0) {
+            // Empty stream
+            if (this.unencrypted) {
+                const emptyData = new Uint8Array(0);
+                const hash = await sha256(emptyData);
+                await this.store.put(hash, emptyData);
+                return { hash, size: 0 };
+            }
+            else {
+                const { ciphertext, key } = await encryptChk(new Uint8Array(0));
+                const hash = await sha256(ciphertext);
+                await this.store.put(hash, ciphertext);
+                return { hash, size: 0, key };
+            }
+        }
+        const result = await this.buildTreeFromChunks(this.chunks, this.totalSize);
+        return { hash: result.hash, size: this.totalSize, key: result.key };
+    }
+    /**
+     * Build flat tree from chunks
+     */
+    async buildTreeFromChunks(chunks, _totalSize) {
+        // Single chunk - return its hash (and key if encrypted)
+        if (chunks.length === 1) {
+            return cid(chunks[0].hash, chunks[0].key);
+        }
+        // Create single flat node with all links
+        const node = {
+            type: LinkType.File,
+            links: chunks,
+        };
+        const { data, hash: nodeHash } = await encodeAndHash(node);
+        if (this.unencrypted) {
+            // Public mode: store plaintext tree node
+            await this.store.put(nodeHash, data);
+            return { hash: nodeHash };
+        }
+        else {
+            // Encrypted mode: CHK encrypt the tree node
+            const { ciphertext, key } = await encryptChk(data);
+            const hash = await sha256(ciphertext);
+            await this.store.put(hash, ciphertext);
+            return cid(hash, key);
+        }
+    }
+    /**
+     * Get stats
+     */
+    get stats() {
+        return {
+            chunks: this.chunks.length,
+            buffered: this.bufferOffset,
+            totalSize: this.totalSize,
+        };
+    }
+    /**
+     * Clear internal state to release memory
+     * Call after finalize() if you want to free memory immediately
+     */
+    clear() {
+        this.chunks = [];
+        this.buffer = new Uint8Array(0);
+        this.bufferOffset = 0;
+        this.totalSize = 0;
+    }
+}
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

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

package/dist/tree/create.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tree creation operations
+ */
+import { Store, Hash, Link, LinkType, CID } from '../types.js';
+export interface CreateConfig {
+    store: Store;
+    chunkSize: number;
+}
+export interface DirEntry {
+    name: string;
+    cid: CID;
+    size: number;
+    type: LinkType;
+    meta?: Record<string, unknown>;
+}
+/**
+ * Store a blob directly (small data)
+ */
+export declare function putBlob(store: Store, data: Uint8Array): Promise<Hash>;
+/**
+ * Store a file, chunking if necessary
+ */
+export declare function putFile(config: CreateConfig, data: Uint8Array): Promise<{
+    hash: Hash;
+    size: number;
+}>;
+/**
+ * Build a directory from entries
+ *
+ * Directories are encoded as MessagePack blobs. If the encoded blob exceeds
+ * chunkSize, it's chunked by bytes like files using putFile.
+ */
+export declare function putDirectory(config: CreateConfig, entries: DirEntry[]): Promise<Hash>;
+export declare function buildTree(config: CreateConfig, links: Link[], totalSize?: number): Promise<Hash>;
+//# sourceMappingURL=create.d.ts.map

package/dist/tree/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/tree/create.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAY,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAIzE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3E;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BvC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/tree/create.js

@@ -0,0 +1,90 @@
+/**
+ * Tree creation operations
+ */
+import { LinkType } from '../types.js';
+import { sha256 } from '../hash.js';
+import { encodeAndHash } from '../codec.js';
+/**
+ * Store a blob directly (small data)
+ */
+export async function putBlob(store, data) {
+    const hash = await sha256(data);
+    await store.put(hash, data);
+    return hash;
+}
+/**
+ * Store a file, chunking if necessary
+ */
+export async function putFile(config, data) {
+    const { store, chunkSize } = config;
+    const size = data.length;
+    if (data.length <= chunkSize) {
+        const hash = await putBlob(store, data);
+        return { hash, size };
+    }
+    // Process chunks sequentially to avoid memory spikes
+    // (For parallel processing of large files, use StreamWriter instead)
+    const links = [];
+    let offset = 0;
+    while (offset < data.length) {
+        const end = Math.min(offset + chunkSize, data.length);
+        // Use subarray to avoid copying
+        const chunk = data.subarray(offset, end);
+        const hash = await putBlob(store, chunk);
+        links.push({
+            hash,
+            size: chunk.length,
+            type: LinkType.Blob,
+        });
+        offset = end;
+    }
+    const rootHash = await buildTree(config, links, size);
+    return { hash: rootHash, size };
+}
+/**
+ * Build a directory from entries
+ *
+ * Directories are encoded as MessagePack blobs. If the encoded blob exceeds
+ * chunkSize, it's chunked by bytes like files using putFile.
+ */
+export async function putDirectory(config, entries) {
+    const { store, chunkSize } = config;
+    const sorted = [...entries].sort((a, b) => a.name.localeCompare(b.name));
+    const links = sorted.map(e => ({
+        hash: e.cid.hash,
+        key: e.cid.key,
+        name: e.name,
+        size: e.size,
+        type: e.type,
+        meta: e.meta,
+    }));
+    const node = {
+        type: LinkType.Dir,
+        links,
+    };
+    const { data, hash } = await encodeAndHash(node);
+    // Small directory - store directly
+    if (data.length <= chunkSize) {
+        await store.put(hash, data);
+        return hash;
+    }
+    // Large directory - reuse putFile for chunking
+    const { hash: rootHash } = await putFile(config, data);
+    return rootHash;
+}
+export async function buildTree(config, links, totalSize) {
+    const { store } = config;
+    // Single chunk that matches total size - return it directly
+    if (links.length === 1 && links[0].size === totalSize) {
+        return links[0].hash;
+    }
+    // Create single flat node with all links
+    const node = {
+        type: LinkType.File,
+        links,
+    };
+    const { data, hash } = await encodeAndHash(node);
+    await store.put(hash, data);
+    return hash;
+}
+//# sourceMappingURL=create.js.map

package/dist/tree/create.js.map

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

package/dist/tree/edit.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tree editing operations
+ */
+import { Hash, CID, LinkType } from '../types.js';
+import { type CreateConfig } from './create.js';
+export interface EditConfig extends CreateConfig {
+}
+/**
+ * Add or update an entry in a directory
+ * @returns New root hash
+ */
+export declare function setEntry(config: EditConfig, rootHash: Hash, path: string[], name: string, entryCid: CID, size: number, type?: LinkType, meta?: Record<string, unknown>): Promise<Hash>;
+/**
+ * Remove an entry from a directory
+ * @returns New root hash
+ */
+export declare function removeEntry(config: EditConfig, rootHash: Hash, path: string[], name: string): Promise<Hash>;
+/**
+ * Rename an entry in a directory
+ * @returns New root hash
+ */
+export declare function renameEntry(config: EditConfig, rootHash: Hash, path: string[], oldName: string, newName: string): Promise<Hash>;
+/**
+ * Move an entry to a different directory
+ * @returns New root hash
+ */
+export declare function moveEntry(config: EditConfig, rootHash: Hash, sourcePath: string[], name: string, targetPath: string[]): Promise<Hash>;
+//# sourceMappingURL=edit.d.ts.map

package/dist/tree/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/tree/edit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAS,IAAI,EAAE,GAAG,EAAO,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG7E,MAAM,WAAW,UAAW,SAAQ,YAAY;CAAG;AAEnD;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,IAAI,EACd,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,GAAG,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,QAAwB,EAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,IAAI,EACd,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,IAAI,EACd,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,IAAI,EACd,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}