@avalanche-io/c4-node 1.0.10

package/dist/packages/core/src/safename.js

@@ -0,0 +1,354 @@
+// Universal Filename Encoding for c4m names.
+const CURRENCY_SIGN = "\u00A4"; // ¤
+const BRAILLE_BASE = 0x2800;
+// isPrintable returns true if the codepoint is a printable character.
+// Matches Go's unicode.IsPrint: graphic characters plus ASCII space.
+// Excludes all C0/C1 control characters and other non-graphic codepoints.
+function isPrintable(cp) {
+    // C0 controls (0x00-0x1F) except we never reach here for those handled by tier2
+    if (cp <= 0x1f)
+        return false;
+    // DEL
+    if (cp === 0x7f)
+        return false;
+    // C1 controls (0x80-0x9F)
+    if (cp >= 0x80 && cp <= 0x9f)
+        return false;
+    // Unicode category-based non-printable ranges
+    // Surrogates (shouldn't appear as codepoints but guard anyway)
+    if (cp >= 0xd800 && cp <= 0xdfff)
+        return false;
+    // Non-characters
+    if (cp >= 0xfdd0 && cp <= 0xfdef)
+        return false;
+    if ((cp & 0xfffe) === 0xfffe && cp <= 0x10ffff)
+        return false;
+    return true;
+}
+// tier2Escape returns the escape character for a Tier 2 codepoint, or empty string.
+function tier2Escape(cp) {
+    switch (cp) {
+        case 0x00: return "0";
+        case 0x09: return "t";
+        case 0x0a: return "n";
+        case 0x0d: return "r";
+        case 0x5c: return "\\"; // backslash
+    }
+    return "";
+}
+// tier2Unescape returns the byte value for a Tier 2 escape character.
+function tier2Unescape(ch) {
+    switch (ch) {
+        case "0": return { value: 0x00, ok: true };
+        case "t": return { value: 0x09, ok: true };
+        case "n": return { value: 0x0a, ok: true };
+        case "r": return { value: 0x0d, ok: true };
+        case "\\": return { value: 0x5c, ok: true };
+    }
+    return { value: 0, ok: false };
+}
+// safeName encodes a raw filename using Universal Filename Encoding.
+// Three tiers:
+//   Tier 1: printable UTF-8 passes through, except ¤ and backslash
+//   Tier 2: backslash escapes for \0, \t, \n, \r, \\
+//   Tier 3: non-printable bytes encoded as braille between ¤ delimiters
+export function safeName(raw) {
+    const encoder = new TextEncoder();
+    const bytes = encoder.encode(raw);
+    // Fast path: check if encoding is needed.
+    let safe = true;
+    let i = 0;
+    while (i < bytes.length) {
+        const decoded = decodeUtf8(bytes, i);
+        if (decoded.error) {
+            safe = false;
+            break;
+        }
+        if (decoded.cp === 0xa4 || decoded.cp === 0x5c || !isPrintable(decoded.cp)) {
+            safe = false;
+            break;
+        }
+        i += decoded.size;
+    }
+    if (safe) {
+        return raw;
+    }
+    let result = "";
+    let pending = []; // Tier 3 byte accumulator
+    function flushPending() {
+        if (pending.length === 0)
+            return;
+        result += CURRENCY_SIGN;
+        for (const b of pending) {
+            result += String.fromCodePoint(BRAILLE_BASE + b);
+        }
+        result += CURRENCY_SIGN;
+        pending = [];
+    }
+    i = 0;
+    while (i < bytes.length) {
+        const decoded = decodeUtf8(bytes, i);
+        // Tier 1: printable UTF-8, not ¤, not backslash
+        if (!decoded.error && isPrintable(decoded.cp) && decoded.cp !== 0xa4 && decoded.cp !== 0x5c) {
+            flushPending();
+            result += String.fromCodePoint(decoded.cp);
+            i += decoded.size;
+            continue;
+        }
+        // Tier 2: backslash escapes for specific characters
+        if (!decoded.error) {
+            const esc = tier2Escape(decoded.cp);
+            if (esc !== "") {
+                flushPending();
+                result += "\\" + esc;
+                i += decoded.size;
+                continue;
+            }
+        }
+        // Tier 3: accumulate bytes for braille range encoding
+        if (decoded.error) {
+            pending.push(bytes[i]);
+            i++;
+        }
+        else {
+            for (let j = 0; j < decoded.size; j++) {
+                pending.push(bytes[i + j]);
+            }
+            i += decoded.size;
+        }
+    }
+    flushPending();
+    return result;
+}
+// unsafeName reverses safeName: decodes Tier 2 backslash escapes and
+// Tier 3 braille patterns back to raw bytes.
+export function unsafeName(encoded) {
+    if (!encoded.includes(CURRENCY_SIGN) && !encoded.includes("\\")) {
+        return encoded;
+    }
+    const decoder = new TextDecoder();
+    const outputBytes = [];
+    const encoder = new TextEncoder();
+    const pushStr = (s) => {
+        const bytes = encoder.encode(s);
+        for (let k = 0; k < bytes.length; k++) {
+            outputBytes.push(bytes[k]);
+        }
+    };
+    let i = 0;
+    outer: while (i < encoded.length) {
+        const cp = encoded.codePointAt(i);
+        const charLen = cp > 0xffff ? 2 : 1;
+        // Tier 2: backslash escape
+        if (cp === 0x5c) { // backslash
+            if (i + charLen < encoded.length) {
+                const next = encoded[i + charLen];
+                const unesc = tier2Unescape(next);
+                if (unesc.ok) {
+                    outputBytes.push(unesc.value);
+                    i += charLen + 1;
+                    continue;
+                }
+            }
+            // Lone backslash or unknown escape: pass through
+            outputBytes.push(0x5c);
+            i += charLen;
+            continue;
+        }
+        // Tier 3: ¤...¤ braille range
+        // Matches Go behavior: braille-decoded bytes are written inline.
+        if (cp === 0xa4) { // ¤
+            let j = i + charLen;
+            let decoded = false;
+            while (j < encoded.length) {
+                const brCp = encoded.codePointAt(j);
+                const brLen = brCp > 0xffff ? 2 : 1;
+                if (brCp === 0xa4) { // closing ¤
+                    if (decoded) {
+                        i = j + brLen;
+                    }
+                    else {
+                        pushStr(CURRENCY_SIGN);
+                        i += charLen;
+                    }
+                    continue outer;
+                }
+                if (brCp >= 0x2800 && brCp <= 0x28ff) {
+                    outputBytes.push(brCp - 0x2800);
+                    decoded = true;
+                    j += brLen;
+                    continue;
+                }
+                break;
+            }
+            // No closing ¤ found (or non-braille interrupted): emit ¤ as literal.
+            // Any braille-decoded bytes already written are kept (matches Go).
+            pushStr(CURRENCY_SIGN);
+            i += charLen;
+            continue;
+        }
+        // Tier 1: passthrough
+        pushStr(String.fromCodePoint(cp));
+        i += charLen;
+    }
+    return decoder.decode(new Uint8Array(outputBytes));
+}
+// decodeUtf8 decodes a single UTF-8 codepoint from a byte array at offset.
+function decodeUtf8(bytes, offset) {
+    if (offset >= bytes.length) {
+        return { cp: 0xfffd, size: 1, error: true };
+    }
+    const b0 = bytes[offset];
+    // Single byte (ASCII)
+    if (b0 < 0x80) {
+        return { cp: b0, size: 1, error: false };
+    }
+    // Two bytes
+    if ((b0 & 0xe0) === 0xc0) {
+        if (offset + 1 >= bytes.length)
+            return { cp: 0xfffd, size: 1, error: true };
+        const b1 = bytes[offset + 1];
+        if ((b1 & 0xc0) !== 0x80)
+            return { cp: 0xfffd, size: 1, error: true };
+        const cp = ((b0 & 0x1f) << 6) | (b1 & 0x3f);
+        if (cp < 0x80)
+            return { cp: 0xfffd, size: 1, error: true }; // overlong
+        return { cp, size: 2, error: false };
+    }
+    // Three bytes
+    if ((b0 & 0xf0) === 0xe0) {
+        if (offset + 2 >= bytes.length)
+            return { cp: 0xfffd, size: 1, error: true };
+        const b1 = bytes[offset + 1];
+        const b2 = bytes[offset + 2];
+        if ((b1 & 0xc0) !== 0x80 || (b2 & 0xc0) !== 0x80)
+            return { cp: 0xfffd, size: 1, error: true };
+        const cp = ((b0 & 0x0f) << 12) | ((b1 & 0x3f) << 6) | (b2 & 0x3f);
+        if (cp < 0x800)
+            return { cp: 0xfffd, size: 1, error: true }; // overlong
+        return { cp, size: 3, error: false };
+    }
+    // Four bytes
+    if ((b0 & 0xf8) === 0xf0) {
+        if (offset + 3 >= bytes.length)
+            return { cp: 0xfffd, size: 1, error: true };
+        const b1 = bytes[offset + 1];
+        const b2 = bytes[offset + 2];
+        const b3 = bytes[offset + 3];
+        if ((b1 & 0xc0) !== 0x80 || (b2 & 0xc0) !== 0x80 || (b3 & 0xc0) !== 0x80) {
+            return { cp: 0xfffd, size: 1, error: true };
+        }
+        const cp = ((b0 & 0x07) << 18) | ((b1 & 0x3f) << 12) | ((b2 & 0x3f) << 6) | (b3 & 0x3f);
+        if (cp < 0x10000 || cp > 0x10ffff)
+            return { cp: 0xfffd, size: 1, error: true };
+        return { cp, size: 4, error: false };
+    }
+    // Invalid leading byte
+    return { cp: 0xfffd, size: 1, error: true };
+}
+// escapeC4MName backslash-escapes c4m field-boundary characters:
+// space, double-quote, and (for non-sequence names) brackets.
+export function escapeC4MName(s, isSequence) {
+    let needsEscape = false;
+    for (const ch of s) {
+        if (ch === " " || ch === '"') {
+            needsEscape = true;
+            break;
+        }
+        if (!isSequence && (ch === "[" || ch === "]")) {
+            needsEscape = true;
+            break;
+        }
+    }
+    if (!needsEscape) {
+        return s;
+    }
+    let result = "";
+    for (const ch of s) {
+        switch (ch) {
+            case " ":
+                result += "\\ ";
+                break;
+            case '"':
+                result += '\\"';
+                break;
+            case "[":
+                if (!isSequence) {
+                    result += "\\[";
+                }
+                else {
+                    result += ch;
+                }
+                break;
+            case "]":
+                if (!isSequence) {
+                    result += "\\]";
+                }
+                else {
+                    result += ch;
+                }
+                break;
+            default:
+                result += ch;
+                break;
+        }
+    }
+    return result;
+}
+// unescapeC4MName reverses escapeC4MName: removes backslash escapes
+// for spaces, double-quotes, and brackets.
+export function unescapeC4MName(s) {
+    if (!s.includes("\\")) {
+        return s;
+    }
+    let result = "";
+    let i = 0;
+    while (i < s.length) {
+        if (s[i] === "\\" && i + 1 < s.length) {
+            const next = s[i + 1];
+            if (next === " " || next === '"' || next === "[" || next === "]" || next === "\\") {
+                result += next;
+                i += 2;
+                continue;
+            }
+        }
+        result += s[i];
+        i++;
+    }
+    return result;
+}
+// formatName applies safeName encoding and then c4m field-boundary escaping.
+// For directory names (ending in /): escape the base, keep trailing /.
+// For files: escape the full name.
+export function formatName(name, isSequence) {
+    const safe = safeName(name);
+    if (safe.endsWith("/")) {
+        const base = safe.slice(0, -1);
+        return escapeC4MName(base, isSequence) + "/";
+    }
+    return escapeC4MName(safe, isSequence);
+}
+// formatTarget applies safeName encoding and escapes only spaces and
+// double-quotes (no bracket escaping).
+export function formatTarget(target) {
+    const safe = safeName(target);
+    if (!safe.includes(" ") && !safe.includes('"')) {
+        return safe;
+    }
+    let result = "";
+    for (const ch of safe) {
+        switch (ch) {
+            case " ":
+                result += "\\ ";
+                break;
+            case '"':
+                result += '\\"';
+                break;
+            default:
+                result += ch;
+                break;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=safename.js.map

package/dist/packages/core/src/safename.js.map

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

package/dist/packages/core/src/scanner.d.ts

@@ -0,0 +1,25 @@
+import type { FileSystem } from './filesystem.js';
+import type { Store } from './store.js';
+import { Manifest } from './manifest.js';
+/** Options for the scan function. */
+export interface ScanOptions {
+    /** Store content during scan for a single-pass ingest. */
+    store?: Store;
+    /** Compute C4 IDs for file content. Default true. */
+    computeIds?: boolean;
+    /** Follow symbolic links. Default false. */
+    followSymlinks?: boolean;
+    /** Skip hidden directories (names starting with '.'). Default true. */
+    skipHidden?: boolean;
+    /** Progress callback invoked for each file processed. */
+    progress?: (path: string, filesProcessed: number) => void;
+}
+/**
+ * Scan a filesystem directory into a Manifest.
+ *
+ * Walks the directory tree rooted at rootPath, reads each file,
+ * computes its C4 ID, and builds a sorted Manifest with proper
+ * directory metadata propagated bottom-up.
+ */
+export declare function scan(fs: FileSystem, rootPath: string, options?: ScanOptions): Promise<Manifest>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/packages/core/src/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../../../core/src/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAKxC,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,qDAAqD;IACrD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,KAAK,IAAI,CAAA;CAC1D;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CACxB,EAAE,EAAE,UAAU,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,QAAQ,CAAC,CAuBnB"}

package/dist/packages/core/src/scanner.js

@@ -0,0 +1,97 @@
+import { Manifest } from './manifest.js';
+import { createEntry } from './entry.js';
+import { identifyContent } from './identify-content.js';
+import { streamToBytes, joinPath } from './filesystem.js';
+/**
+ * Scan a filesystem directory into a Manifest.
+ *
+ * Walks the directory tree rooted at rootPath, reads each file,
+ * computes its C4 ID, and builds a sorted Manifest with proper
+ * directory metadata propagated bottom-up.
+ */
+export async function scan(fs, rootPath, options) {
+    const computeIds = options?.computeIds ?? true;
+    const skipHidden = options?.skipHidden ?? true;
+    const followSymlinks = options?.followSymlinks ?? false;
+    const manifest = Manifest.create();
+    await walkDir(fs, rootPath, '', 0, manifest, {
+        computeIds,
+        skipHidden,
+        followSymlinks,
+        store: options?.store,
+        progress: options?.progress,
+        counter: { value: 0 },
+    });
+    // Propagate directory sizes and timestamps bottom-up.
+    manifest.canonicalize();
+    // Sort entries (files before dirs, natural sort).
+    manifest.sortEntries();
+    return manifest;
+}
+/** Recursively walk a directory, adding entries to the manifest. */
+async function walkDir(fs, rootPath, relDir, depth, manifest, state) {
+    const absDir = relDir ? joinPath(rootPath, relDir) : rootPath;
+    // Collect dir entries so we can process files first, then recurse.
+    const files = [];
+    const dirs = [];
+    for await (const dirEntry of fs.readDir(absDir)) {
+        if (state.skipHidden && dirEntry.name.startsWith('.'))
+            continue;
+        if (dirEntry.isSymlink && !state.followSymlinks)
+            continue;
+        const relPath = relDir ? relDir + dirEntry.name : dirEntry.name;
+        if (dirEntry.isDirectory) {
+            dirs.push({ name: dirEntry.name, relPath });
+        }
+        else {
+            files.push({ name: dirEntry.name, relPath });
+        }
+    }
+    // Process files.
+    for (const file of files) {
+        const fullPath = joinPath(rootPath, file.relPath);
+        const stat = await fs.stat(fullPath);
+        const modeType = stat.isSymlink ? 'l' : '-';
+        const mode = stat.mode & 0o7777;
+        let c4id = null;
+        if (state.computeIds) {
+            const stream = await fs.readFile(fullPath);
+            const bytes = await streamToBytes(stream);
+            c4id = await identifyContent(bytes);
+            if (state.store) {
+                await state.store.put(bytes);
+            }
+        }
+        const entry = createEntry({
+            mode,
+            modeType,
+            timestamp: stat.mtime,
+            size: stat.size,
+            name: file.name,
+            c4id,
+            depth,
+        });
+        manifest.addEntry(entry);
+        state.counter.value++;
+        state.progress?.(file.relPath, state.counter.value);
+    }
+    // Recurse into subdirectories.
+    for (const dir of dirs) {
+        const fullPath = joinPath(rootPath, dir.relPath);
+        const stat = await fs.stat(fullPath);
+        const mode = stat.mode & 0o7777;
+        const dirName = dir.name.endsWith('/') ? dir.name : dir.name + '/';
+        // Directory entry — size and timestamp will be propagated later.
+        const entry = createEntry({
+            mode,
+            modeType: 'd',
+            timestamp: new Date(0),
+            size: -1,
+            name: dirName,
+            depth,
+        });
+        manifest.addEntry(entry);
+        await walkDir(fs, rootPath, dir.relPath + '/', depth + 1, manifest, state);
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/dist/packages/core/src/scanner.js.map

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

package/dist/packages/core/src/store.d.ts

@@ -0,0 +1,39 @@
+import type { C4ID } from './id.js';
+/**
+ * Content-addressed blob storage. Any object is retrievable by its C4 ID.
+ *
+ * Implementations:
+ * - MemoryStore (core) — in-memory, for tests and small operations
+ * - IndexedDBStore (core/browser) — persistent browser storage
+ * - TreeStore (c4-node) — filesystem trie, compatible with Go/Python stores
+ */
+export interface Store {
+    /** Check if content exists for the given ID. */
+    has(id: C4ID): Promise<boolean>;
+    /** Retrieve content as a ReadableStream. Throws if not found. */
+    get(id: C4ID): Promise<ReadableStream<Uint8Array>>;
+    /** Store content, returning its C4 ID. Idempotent: same content = same ID, no duplicate. */
+    put(data: ReadableStream<Uint8Array> | Uint8Array): Promise<C4ID>;
+    /** Remove content by ID. Optional — not all stores support deletion. */
+    remove?(id: C4ID): Promise<void>;
+}
+/** Error thrown when content is not found in a store. */
+export declare class ContentNotFoundError extends Error {
+    readonly c4id: string;
+    constructor(id: C4ID);
+}
+/**
+ * A store that reads from multiple backends and writes to one.
+ * Reads try each store in order; the first hit wins.
+ * Writes go to the primary store only.
+ */
+export declare class CompositeStore implements Store {
+    private readonly primary;
+    private readonly secondaries;
+    constructor(primary: Store, ...secondaries: Store[]);
+    has(id: C4ID): Promise<boolean>;
+    get(id: C4ID): Promise<ReadableStream<Uint8Array>>;
+    put(data: ReadableStream<Uint8Array> | Uint8Array): Promise<C4ID>;
+    remove(id: C4ID): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/packages/core/src/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../core/src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAEnC;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK;IACpB,gDAAgD;IAChD,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE/B,iEAAiE;IACjE,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAA;IAElD,4FAA4F;IAC5F,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjE,wEAAwE;IACxE,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjC;AAED,yDAAyD;AACzD,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBACT,EAAE,EAAE,IAAI;CAKrB;AAED;;;;GAIG;AACH,qBAAa,cAAe,YAAW,KAAK;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAO;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,KAAK,EAAE;IAK7C,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ/B,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAgBlD,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAGtC"}

package/dist/packages/core/src/store.js

@@ -0,0 +1,53 @@
+/** Error thrown when content is not found in a store. */
+export class ContentNotFoundError extends Error {
+    constructor(id) {
+        super(`content not found: ${id}`);
+        this.name = 'ContentNotFoundError';
+        this.c4id = id.toString();
+    }
+}
+/**
+ * A store that reads from multiple backends and writes to one.
+ * Reads try each store in order; the first hit wins.
+ * Writes go to the primary store only.
+ */
+export class CompositeStore {
+    constructor(primary, ...secondaries) {
+        this.primary = primary;
+        this.secondaries = secondaries;
+    }
+    async has(id) {
+        if (await this.primary.has(id))
+            return true;
+        for (const s of this.secondaries) {
+            if (await s.has(id))
+                return true;
+        }
+        return false;
+    }
+    async get(id) {
+        // Try primary first
+        try {
+            if (await this.primary.has(id))
+                return this.primary.get(id);
+        }
+        catch { /* fall through */ }
+        // Try secondaries
+        for (const s of this.secondaries) {
+            try {
+                if (await s.has(id))
+                    return s.get(id);
+            }
+            catch { /* fall through */ }
+        }
+        throw new ContentNotFoundError(id);
+    }
+    async put(data) {
+        return this.primary.put(data);
+    }
+    async remove(id) {
+        if (this.primary.remove)
+            await this.primary.remove(id);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/packages/core/src/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../../../core/src/store.ts"],"names":[],"mappings":"AAwBA,yDAAyD;AACzD,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAE7C,YAAY,EAAQ;QAClB,KAAK,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAA;QACjC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;QAClC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;IAC3B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAIzB,YAAY,OAAc,EAAE,GAAG,WAAoB;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAQ;QAChB,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAA;QAC3C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAA;QAClC,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAQ;QAChB,oBAAoB;QACpB,IAAI,CAAC;YACH,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC7D,CAAC;QAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAE9B,kBAAkB;QAClB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACvC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAA6C;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAQ;QACnB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACxD,CAAC;CACF"}

package/dist/packages/core/src/tree.d.ts

@@ -0,0 +1,16 @@
+import { C4ID } from "./id.js";
+/**
+ * Compute the tree (Merkle) ID for a set of C4IDs.
+ *
+ * Algorithm:
+ *   1. Sort IDs by digest bytes (big-endian).
+ *   2. Deduplicate adjacent equal IDs.
+ *   3. Build a Merkle tree bottom-up:
+ *      - Pair adjacent IDs and sum each pair (order-independent via C4ID.sum).
+ *      - An odd trailing ID promotes unchanged to the next level.
+ *      - Repeat until a single root remains.
+ *   4. Empty input returns the nil ID.
+ *   5. Single element returns itself.
+ */
+export declare function treeId(ids: C4ID[]): Promise<C4ID>;
+//# sourceMappingURL=tree.d.ts.map

package/dist/packages/core/src/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../../../core/src/tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B;;;;;;;;;;;;GAYG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BvD"}