@avalanche-io/c4-node 1.0.10

package/dist/packages/core/src/memory-fs.js

@@ -0,0 +1,187 @@
+import { FileNotFoundError, FileExistsError, bytesToStream, streamToBytes } from './filesystem.js';
+/**
+ * In-memory filesystem tree implementing the FileSystem interface.
+ * Useful for tests and operations that don't need real I/O.
+ *
+ * Paths use forward slashes. Leading/trailing slashes are normalized.
+ */
+export class MemoryFS {
+    constructor() {
+        this.root = {
+            name: '',
+            isDirectory: true,
+            isSymlink: false,
+            mode: 0o755,
+            mtime: new Date(),
+            children: new Map(),
+        };
+    }
+    async *readDir(path) {
+        const node = this.resolve(normalizePath(path));
+        if (!node || !node.isDirectory) {
+            throw new FileNotFoundError(path);
+        }
+        const entries = [...node.children.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+        for (const [, child] of entries) {
+            yield {
+                name: child.name,
+                isDirectory: child.isDirectory,
+                isSymlink: child.isSymlink,
+            };
+        }
+    }
+    async stat(path) {
+        const node = this.resolve(normalizePath(path));
+        if (!node)
+            throw new FileNotFoundError(path);
+        return {
+            size: node.content?.length ?? 0,
+            mode: node.mode,
+            mtime: node.mtime,
+            isDirectory: node.isDirectory,
+            isSymlink: node.isSymlink,
+        };
+    }
+    async readFile(path) {
+        const node = this.resolve(normalizePath(path));
+        if (!node || node.isDirectory)
+            throw new FileNotFoundError(path);
+        return bytesToStream(new Uint8Array(node.content ?? new Uint8Array(0)));
+    }
+    async readFileBytes(path) {
+        const node = this.resolve(normalizePath(path));
+        if (!node || node.isDirectory)
+            throw new FileNotFoundError(path);
+        return new Uint8Array(node.content ?? new Uint8Array(0));
+    }
+    async writeFile(path, data) {
+        const normalized = normalizePath(path);
+        const parts = normalized.split('/');
+        const fileName = parts.pop();
+        const parentPath = parts.join('/');
+        const parent = this.resolve(parentPath);
+        if (!parent || !parent.isDirectory) {
+            throw new FileNotFoundError(parentPath);
+        }
+        const bytes = data instanceof Uint8Array ? new Uint8Array(data) : await streamToBytes(data);
+        const existing = parent.children.get(fileName);
+        if (existing && existing.isDirectory) {
+            throw new FileExistsError(path);
+        }
+        parent.children.set(fileName, {
+            name: fileName,
+            isDirectory: false,
+            isSymlink: false,
+            mode: existing?.mode ?? 0o644,
+            mtime: new Date(),
+            content: bytes,
+        });
+    }
+    async mkdir(path, options) {
+        const normalized = normalizePath(path);
+        if (normalized === '')
+            return; // root always exists
+        const parts = normalized.split('/');
+        let current = this.root;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            const existing = current.children.get(part);
+            if (existing) {
+                if (!existing.isDirectory) {
+                    throw new FileExistsError(parts.slice(0, i + 1).join('/'));
+                }
+                current = existing;
+            }
+            else if (options?.recursive || i === parts.length - 1) {
+                const newDir = {
+                    name: part,
+                    isDirectory: true,
+                    isSymlink: false,
+                    mode: 0o755,
+                    mtime: new Date(),
+                    children: new Map(),
+                };
+                current.children.set(part, newDir);
+                current = newDir;
+            }
+            else {
+                throw new FileNotFoundError(parts.slice(0, i).join('/'));
+            }
+        }
+    }
+    async remove(path, options) {
+        const normalized = normalizePath(path);
+        if (normalized === '')
+            throw new Error('cannot remove root');
+        const parts = normalized.split('/');
+        const name = parts.pop();
+        const parentPath = parts.join('/');
+        const parent = this.resolve(parentPath);
+        if (!parent || !parent.isDirectory)
+            throw new FileNotFoundError(path);
+        const target = parent.children.get(name);
+        if (!target)
+            throw new FileNotFoundError(path);
+        if (target.isDirectory && target.children.size > 0 && !options?.recursive) {
+            throw new Error(`directory not empty: ${path}`);
+        }
+        parent.children.delete(name);
+    }
+    async rename(oldPath, newPath) {
+        const oldNorm = normalizePath(oldPath);
+        const newNorm = normalizePath(newPath);
+        const oldParts = oldNorm.split('/');
+        const oldName = oldParts.pop();
+        const oldParent = this.resolve(oldParts.join('/'));
+        if (!oldParent?.isDirectory)
+            throw new FileNotFoundError(oldPath);
+        const node = oldParent.children.get(oldName);
+        if (!node)
+            throw new FileNotFoundError(oldPath);
+        const newParts = newNorm.split('/');
+        const newName = newParts.pop();
+        const newParent = this.resolve(newParts.join('/'));
+        if (!newParent?.isDirectory)
+            throw new FileNotFoundError(newPath);
+        oldParent.children.delete(oldName);
+        node.name = newName;
+        newParent.children.set(newName, node);
+    }
+    async setMeta(path, meta) {
+        const node = this.resolve(normalizePath(path));
+        if (!node)
+            throw new FileNotFoundError(path);
+        if (meta.mode !== undefined)
+            node.mode = meta.mode;
+        if (meta.mtime !== undefined)
+            node.mtime = meta.mtime;
+    }
+    /** Helper: write a string as a file (convenience for tests). */
+    async writeText(path, text) {
+        await this.writeFile(path, new TextEncoder().encode(text));
+    }
+    /** Helper: read a file as a string (convenience for tests). */
+    async readText(path) {
+        const bytes = await this.readFileBytes(path);
+        return new TextDecoder().decode(bytes);
+    }
+    resolve(path) {
+        if (path === '')
+            return this.root;
+        const parts = path.split('/');
+        let current = this.root;
+        for (const part of parts) {
+            if (!current.isDirectory || !current.children)
+                return null;
+            const child = current.children.get(part);
+            if (!child)
+                return null;
+            current = child;
+        }
+        return current;
+    }
+}
+function normalizePath(path) {
+    return path.replace(/^\/+|\/+$/g, '').replace(/\/+/g, '/');
+}
+//# sourceMappingURL=memory-fs.js.map

package/dist/packages/core/src/memory-fs.js.map

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

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

@@ -0,0 +1,21 @@
+import type { C4ID } from './id.js';
+import type { Store } from './store.js';
+/**
+ * In-memory content-addressed store backed by a Map.
+ * Useful for tests, small operations, and browser environments
+ * where persistence isn't needed.
+ */
+export declare class MemoryStore implements Store {
+    private data;
+    has(id: C4ID): Promise<boolean>;
+    get(id: C4ID): Promise<ReadableStream<Uint8Array>>;
+    put(data: ReadableStream<Uint8Array> | Uint8Array): Promise<C4ID>;
+    remove(id: C4ID): Promise<void>;
+    /** Number of objects in the store. */
+    get size(): number;
+    /** Total bytes stored. */
+    get totalBytes(): number;
+    /** Clear all stored content. */
+    clear(): void;
+}
+//# sourceMappingURL=memory-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../../../core/src/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAEnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAKvC;;;;GAIG;AACH,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,IAAI,CAAgC;IAEtC,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/B,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAOlD,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjE,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,sCAAsC;IACtC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,0BAA0B;IAC1B,IAAI,UAAU,IAAI,MAAM,CAIvB;IAED,gCAAgC;IAChC,KAAK,IAAI,IAAI;CAGd"}

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

@@ -0,0 +1,57 @@
+import { identifyBytes } from './id.js';
+import { ContentNotFoundError } from './store.js';
+import { streamToBytes, bytesToStream } from './filesystem.js';
+import { tryCanonicalizeC4m } from './identify-content.js';
+/**
+ * In-memory content-addressed store backed by a Map.
+ * Useful for tests, small operations, and browser environments
+ * where persistence isn't needed.
+ */
+export class MemoryStore {
+    constructor() {
+        this.data = new Map();
+    }
+    async has(id) {
+        return this.data.has(id.toString());
+    }
+    async get(id) {
+        const key = id.toString();
+        const bytes = this.data.get(key);
+        if (!bytes)
+            throw new ContentNotFoundError(id);
+        return bytesToStream(new Uint8Array(bytes));
+    }
+    async put(data) {
+        let bytes = data instanceof Uint8Array ? data : await streamToBytes(data);
+        // If content parses as c4m, store the canonical form
+        const canonical = await tryCanonicalizeC4m(bytes);
+        if (canonical) {
+            bytes = canonical;
+        }
+        const id = await identifyBytes(bytes);
+        const key = id.toString();
+        if (!this.data.has(key)) {
+            this.data.set(key, new Uint8Array(bytes));
+        }
+        return id;
+    }
+    async remove(id) {
+        this.data.delete(id.toString());
+    }
+    /** Number of objects in the store. */
+    get size() {
+        return this.data.size;
+    }
+    /** Total bytes stored. */
+    get totalBytes() {
+        let total = 0;
+        for (const v of this.data.values())
+            total += v.length;
+        return total;
+    }
+    /** Clear all stored content. */
+    clear() {
+        this.data.clear();
+    }
+}
+//# sourceMappingURL=memory-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../../../../../core/src/memory-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,OAAO,WAAW;IAAxB;QACU,SAAI,GAAG,IAAI,GAAG,EAAsB,CAAA;IAkD9C,CAAC;IAhDC,KAAK,CAAC,GAAG,CAAC,EAAQ;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAQ;QAChB,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAA;QAC9C,OAAO,aAAa,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAA6C;QACrD,IAAI,KAAK,GAAG,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,IAAI,CAAC,CAAA;QAEzE,qDAAqD;QACrD,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAA;QACjD,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,GAAG,SAAS,CAAA;QACnB,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAA;QACrC,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;QACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;QAC3C,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAQ;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAA;IACjC,CAAC;IAED,sCAAsC;IACtC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;IACvB,CAAC;IAED,0BAA0B;IAC1B,IAAI,UAAU;QACZ,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,KAAK,IAAI,CAAC,CAAC,MAAM,CAAA;QACrD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,gCAAgC;IAChC,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IACnB,CAAC;CACF"}

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

@@ -0,0 +1,2 @@
+export declare function naturalLess(a: string, b: string): boolean;
+//# sourceMappingURL=naturalsort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"naturalsort.d.ts","sourceRoot":"","sources":["../../../../../core/src/naturalsort.ts"],"names":[],"mappings":"AAqEA,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAgCzD"}

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

@@ -0,0 +1,88 @@
+// Natural sorting for c4m manifest entries.
+// segmentString splits a string into alternating text/numeric segments.
+// A segment is numeric if it consists of ASCII digits 0-9 (0x30-0x39) only.
+// Unicode digits are treated as text.
+function segmentString(s) {
+    if (s === "") {
+        return [];
+    }
+    const segments = [];
+    let current = "";
+    let isNumeric = false;
+    let first = true;
+    for (const ch of s) {
+        const isDigit = ch >= "0" && ch <= "9";
+        if (first) {
+            first = false;
+            isNumeric = isDigit;
+            current = ch;
+        }
+        else if (isDigit !== isNumeric) {
+            // Transition between text and numeric
+            const seg = {
+                text: current,
+                isNumeric,
+                numValue: isNumeric ? parseNumber(current) : 0,
+            };
+            segments.push(seg);
+            current = ch;
+            isNumeric = isDigit;
+        }
+        else {
+            current += ch;
+        }
+    }
+    // Add final segment
+    if (current.length > 0) {
+        segments.push({
+            text: current,
+            isNumeric,
+            numValue: isNumeric ? parseNumber(current) : 0,
+        });
+    }
+    return segments;
+}
+// parseNumber converts a numeric string to a number using manual parsing.
+function parseNumber(s) {
+    let result = 0;
+    for (const ch of s) {
+        result = result * 10 + (ch.charCodeAt(0) - 0x30);
+    }
+    return result;
+}
+// naturalLess compares two strings using natural sorting.
+// Natural sorting handles numeric sequences intelligently:
+// - "file2.txt" comes before "file10.txt"
+// - "render.1.exr" comes before "render.01.exr" (equal value, shorter first)
+export function naturalLess(a, b) {
+    const segsA = segmentString(a);
+    const segsB = segmentString(b);
+    const minLen = Math.min(segsA.length, segsB.length);
+    for (let i = 0; i < minLen; i++) {
+        const segA = segsA[i];
+        const segB = segsB[i];
+        if (segA.isNumeric && segB.isNumeric) {
+            // Both numeric: compare as integers
+            if (segA.numValue !== segB.numValue) {
+                return segA.numValue < segB.numValue;
+            }
+            // Equal values: shorter representation first
+            if (segA.text.length !== segB.text.length) {
+                return segA.text.length < segB.text.length;
+            }
+        }
+        else if (segA.isNumeric !== segB.isNumeric) {
+            // Mixed types: text sorts before numeric
+            return !segA.isNumeric;
+        }
+        else {
+            // Both text: UTF-8 codepoint comparison (standard JS string comparison)
+            if (segA.text !== segB.text) {
+                return segA.text < segB.text;
+            }
+        }
+    }
+    // All compared segments equal: shorter name (fewer segments) first
+    return segsA.length < segsB.length;
+}
+//# sourceMappingURL=naturalsort.js.map

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

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

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

@@ -0,0 +1,54 @@
+import type { C4ID } from './id.js';
+import { Manifest } from './manifest.js';
+import { type Entry } from './entry.js';
+export type ManifestEventType = 'add' | 'remove' | 'modify' | 'sort' | 'batch';
+export interface ManifestChangeEvent {
+    type: ManifestEventType;
+    path?: string;
+    entry?: Entry;
+    oldEntry?: Entry;
+    changes?: ManifestChangeEvent[];
+}
+export type ManifestChangeListener = (event: ManifestChangeEvent) => void;
+/**
+ * Observable wrapper around a Manifest. Fires events on mutations.
+ * The underlying manifest is accessible via .manifest for read operations.
+ */
+export declare class ObservableManifest {
+    readonly manifest: Manifest;
+    private listeners;
+    private batching;
+    private batchedChanges;
+    constructor(manifest: Manifest);
+    /** Subscribe to an event type. '*' receives all events. Returns an unsubscribe function. */
+    on(event: ManifestEventType | '*', listener: ManifestChangeListener): () => void;
+    /** Remove a listener. */
+    off(event: ManifestEventType | '*', listener: ManifestChangeListener): void;
+    /** Add an entry. Fires 'add'. */
+    addEntry(entry: Entry): void;
+    /** Remove an entry. Fires 'remove'. */
+    removeEntry(entry: Entry): void;
+    /** Update fields on an entry. Fires 'modify' with the old snapshot. */
+    updateEntry(entry: Entry, updates: Partial<Entry>): void;
+    /** Sort entries. Fires 'sort'. */
+    sortEntries(): void;
+    /** Accumulate changes during fn, then fire a single 'batch' event. */
+    batch(fn: () => void): void;
+    get entries(): readonly Entry[];
+    get(path: string): Entry | undefined;
+    has(path: string): boolean;
+    getByName(name: string): Entry | undefined;
+    entryPath(e: Entry): string;
+    children(e: Entry): Entry[];
+    parent(e: Entry): Entry | undefined;
+    root(): Entry[];
+    files(): Iterable<[string, Entry]>;
+    directories(): Iterable<[string, Entry]>;
+    filter(predicate: (path: string, entry: Entry) => boolean): Manifest;
+    duplicates(): Map<string, string[]>;
+    summary(): string;
+    hasNullValues(): boolean;
+    computeC4ID(): Promise<C4ID>;
+    private emit;
+}
+//# sourceMappingURL=observable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observable.d.ts","sourceRoot":"","sources":["../../../../../core/src/observable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,KAAK,EAAS,MAAM,YAAY,CAAA;AAE9C,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAE9E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAA;CAChC;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAA;AAEzE;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,OAAO,CAAC,SAAS,CAA2D;IAC5E,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAuB;gBAEjC,QAAQ,EAAE,QAAQ;IAO9B,4FAA4F;IAC5F,EAAE,CAAC,KAAK,EAAE,iBAAiB,GAAG,GAAG,EAAE,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAUhF,yBAAyB;IACzB,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,GAAG,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAO3E,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAM5B,uCAAuC;IACvC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAQ/B,uEAAuE;IACvE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI;IAaxD,kCAAkC;IAClC,WAAW,IAAI,IAAI;IAKnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAsB3B,IAAI,OAAO,IAAI,SAAS,KAAK,EAAE,CAE9B;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAI1C,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM;IAI3B,QAAQ,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE;IAI3B,MAAM,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS;IAInC,IAAI,IAAI,KAAK,EAAE;IAIf,KAAK,IAAI,QAAQ,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAIlC,WAAW,IAAI,QAAQ,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAIxC,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,GAAG,QAAQ;IAIpE,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAInC,OAAO,IAAI,MAAM;IAIjB,aAAa,IAAI,OAAO;IAIxB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,IAAI;CAgBb"}

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

@@ -0,0 +1,150 @@
+/**
+ * Observable wrapper around a Manifest. Fires events on mutations.
+ * The underlying manifest is accessible via .manifest for read operations.
+ */
+export class ObservableManifest {
+    constructor(manifest) {
+        this.manifest = manifest;
+        this.listeners = new Map();
+        this.batching = false;
+        this.batchedChanges = [];
+    }
+    /** Subscribe to an event type. '*' receives all events. Returns an unsubscribe function. */
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return () => this.off(event, listener);
+    }
+    /** Remove a listener. */
+    off(event, listener) {
+        const set = this.listeners.get(event);
+        if (!set)
+            return;
+        set.delete(listener);
+        if (set.size === 0)
+            this.listeners.delete(event);
+    }
+    /** Add an entry. Fires 'add'. */
+    addEntry(entry) {
+        this.manifest.addEntry(entry);
+        const path = this.manifest.entryPath(entry);
+        this.emit({ type: 'add', path, entry });
+    }
+    /** Remove an entry. Fires 'remove'. */
+    removeEntry(entry) {
+        const path = this.manifest.entryPath(entry);
+        const idx = this.manifest.entries.indexOf(entry);
+        if (idx === -1)
+            return;
+        this.manifest.removeEntry(entry);
+        this.emit({ type: 'remove', path, entry });
+    }
+    /** Update fields on an entry. Fires 'modify' with the old snapshot. */
+    updateEntry(entry, updates) {
+        const idx = this.manifest.entries.indexOf(entry);
+        if (idx === -1)
+            return;
+        const oldEntry = { ...entry };
+        const path = this.manifest.entryPath(entry);
+        Object.assign(entry, updates);
+        // Invalidate the manifest's tree index since entry data changed.
+        // The simplest way: remove and re-add at the same position.
+        this.manifest.entries.splice(idx, 1, entry);
+        this.manifest.invalidateIndex();
+        this.emit({ type: 'modify', path, entry, oldEntry });
+    }
+    /** Sort entries. Fires 'sort'. */
+    sortEntries() {
+        this.manifest.sortEntries();
+        this.emit({ type: 'sort' });
+    }
+    /** Accumulate changes during fn, then fire a single 'batch' event. */
+    batch(fn) {
+        if (this.batching) {
+            // Already inside a batch, just run; inner events still accumulate.
+            fn();
+            return;
+        }
+        this.batching = true;
+        this.batchedChanges = [];
+        try {
+            fn();
+        }
+        finally {
+            this.batching = false;
+            const changes = this.batchedChanges;
+            this.batchedChanges = [];
+            if (changes.length > 0) {
+                this.emit({ type: 'batch', changes });
+            }
+        }
+    }
+    // ---- Read delegates ----
+    get entries() {
+        return this.manifest.entries;
+    }
+    get(path) {
+        return this.manifest.get(path);
+    }
+    has(path) {
+        return this.manifest.has(path);
+    }
+    getByName(name) {
+        return this.manifest.getByName(name);
+    }
+    entryPath(e) {
+        return this.manifest.entryPath(e);
+    }
+    children(e) {
+        return this.manifest.children(e);
+    }
+    parent(e) {
+        return this.manifest.parent(e);
+    }
+    root() {
+        return this.manifest.root();
+    }
+    files() {
+        return this.manifest.files();
+    }
+    directories() {
+        return this.manifest.directories();
+    }
+    filter(predicate) {
+        return this.manifest.filter(predicate);
+    }
+    duplicates() {
+        return this.manifest.duplicates();
+    }
+    summary() {
+        return this.manifest.summary();
+    }
+    hasNullValues() {
+        return this.manifest.hasNullValues();
+    }
+    computeC4ID() {
+        return this.manifest.computeC4ID();
+    }
+    // ---- Private ----
+    emit(event) {
+        if (this.batching && event.type !== 'batch') {
+            this.batchedChanges.push(event);
+            return;
+        }
+        const typed = this.listeners.get(event.type);
+        if (typed) {
+            for (const listener of typed)
+                listener(event);
+        }
+        const wildcard = this.listeners.get('*');
+        if (wildcard) {
+            for (const listener of wildcard)
+                listener(event);
+        }
+    }
+}
+//# sourceMappingURL=observable.js.map

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

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

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

@@ -0,0 +1,38 @@
+import type { FileSystem } from './filesystem.js';
+import type { Store } from './store.js';
+import { Manifest } from './manifest.js';
+/** Result of a pool (bundle) operation. */
+export interface PoolResult {
+    copied: number;
+    skipped: number;
+    missing: number;
+    manifestPath: string;
+}
+/** Result of an ingest (absorb) operation. */
+export interface IngestResult {
+    copied: number;
+    skipped: number;
+    manifests: string[];
+}
+export interface PoolOptions {
+    progress?: (c4id: string, index: number, total: number) => void;
+    manifestName?: string;
+}
+/**
+ * Bundle a manifest with its referenced content for portable transfer.
+ *
+ * Creates:
+ *   outputDir/
+ *     <name>.c4m        — the manifest
+ *     objects/           — content store (flat, keyed by C4 ID string)
+ */
+export declare function pool(manifest: Manifest, outputDir: string, fs: FileSystem, store: Store, options?: PoolOptions): Promise<PoolResult>;
+/**
+ * Absorb a pool bundle into a local store.
+ * Reads objects from bundleDir/objects/ and puts them in the store.
+ * Returns paths to any .c4m files found in the bundle.
+ */
+export declare function ingest(bundleDir: string, fs: FileSystem, store: Store, options?: {
+    progress?: (path: string, index: number, total: number) => void;
+}): Promise<IngestResult>;
+//# sourceMappingURL=pool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../../../core/src/pool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,wBAAsB,IAAI,CACxB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,UAAU,EACd,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAwDrB;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,UAAU,EACd,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAC5E,OAAO,CAAC,YAAY,CAAC,CA+CvB"}