@avalanche-io/c4-node 1.0.10

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

@@ -0,0 +1,45 @@
+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 async function treeId(ids) {
+    if (ids.length === 0)
+        return C4ID.nil();
+    // Sort by digest bytes
+    const sorted = ids.slice().sort((a, b) => a.compareTo(b));
+    // Deduplicate
+    const deduped = [sorted[0]];
+    for (let i = 1; i < sorted.length; i++) {
+        if (!sorted[i].equals(sorted[i - 1])) {
+            deduped.push(sorted[i]);
+        }
+    }
+    if (deduped.length === 1)
+        return deduped[0];
+    // Build Merkle tree bottom-up
+    let level = deduped;
+    while (level.length > 1) {
+        const next = [];
+        for (let i = 0; i < level.length; i += 2) {
+            if (i + 1 < level.length) {
+                next.push(await level[i].sum(level[i + 1]));
+            }
+            else {
+                next.push(level[i]);
+            }
+        }
+        level = next;
+    }
+    return level[0];
+}
+//# sourceMappingURL=tree.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../../../core/src/tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAW;IACtC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IAExC,uBAAuB;IACvB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1D,cAAc;IACd,MAAM,OAAO,GAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAE5C,8BAA8B;IAC9B,IAAI,KAAK,GAAG,OAAO,CAAC;IACpB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAW,EAAE,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,KAAK,GAAG,IAAI,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { FileSystem } from './filesystem.js';
+import type { Manifest } from './manifest.js';
+/** A file whose content does not match the manifest's expected C4 ID. */
+export interface CorruptEntry {
+    path: string;
+    expected: string;
+    actual: string;
+}
+/** Result of verifying a manifest against a real filesystem. */
+export interface VerifyReport {
+    ok: string[];
+    missing: string[];
+    corrupt: CorruptEntry[];
+    extra: string[];
+    get isOk(): boolean;
+}
+/** Options for the verify function. */
+export interface VerifyOptions {
+    progress?: (path: string, index: number, total: number) => void;
+}
+/**
+ * Compare a manifest against a real filesystem.
+ *
+ * Walks every file entry in the manifest and checks that the on-disk
+ * content produces the same C4 ID. Then walks the actual directory tree
+ * to find files present on disk but absent from the manifest.
+ */
+export declare function verify(manifest: Manifest, fs: FileSystem, rootPath: string, options?: VerifyOptions): Promise<VerifyReport>;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../../../core/src/verify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAK7C,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,IAAI,IAAI,OAAO,CAAA;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAChE;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,QAAQ,EAClB,EAAE,EAAE,UAAU,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAiEvB"}

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

@@ -0,0 +1,85 @@
+import { identifyContent } from './identify-content.js';
+import { isDir } from './entry.js';
+import { streamToBytes, joinPath, FileNotFoundError } from './filesystem.js';
+/**
+ * Compare a manifest against a real filesystem.
+ *
+ * Walks every file entry in the manifest and checks that the on-disk
+ * content produces the same C4 ID. Then walks the actual directory tree
+ * to find files present on disk but absent from the manifest.
+ */
+export async function verify(manifest, fs, rootPath, options) {
+    const ok = [];
+    const missing = [];
+    const corrupt = [];
+    // Collect expected file paths from the manifest.
+    const expectedFiles = []; // [relativePath, c4idString]
+    for (const [path, entry] of manifest) {
+        if (isDir(entry))
+            continue;
+        const idStr = entry.c4id && !entry.c4id.isNil() ? entry.c4id.toString() : '';
+        expectedFiles.push([path, idStr]);
+    }
+    const expectedSet = new Set();
+    const total = expectedFiles.length;
+    // Check each manifest entry against the filesystem.
+    for (let i = 0; i < expectedFiles.length; i++) {
+        const [relPath, expectedId] = expectedFiles[i];
+        expectedSet.add(relPath);
+        const fullPath = joinPath(rootPath, relPath);
+        options?.progress?.(relPath, i, total);
+        try {
+            await fs.stat(fullPath);
+        }
+        catch (err) {
+            if (err instanceof FileNotFoundError) {
+                missing.push(relPath);
+                continue;
+            }
+            throw err;
+        }
+        // No expected C4 ID — can only confirm existence, not integrity.
+        if (!expectedId) {
+            ok.push(relPath);
+            continue;
+        }
+        const stream = await fs.readFile(fullPath);
+        const bytes = await streamToBytes(stream);
+        const actualId = await identifyContent(bytes);
+        const actualStr = actualId.toString();
+        if (actualStr === expectedId) {
+            ok.push(relPath);
+        }
+        else {
+            corrupt.push({ path: relPath, expected: expectedId, actual: actualStr });
+        }
+    }
+    // Walk the real filesystem to find extra files.
+    const extra = [];
+    await walkDir(fs, rootPath, '', expectedSet, extra);
+    return {
+        ok,
+        missing,
+        corrupt,
+        extra,
+        get isOk() {
+            return missing.length === 0 && corrupt.length === 0 && extra.length === 0;
+        },
+    };
+}
+/** Recursively walk a directory, collecting paths not in the expected set. */
+async function walkDir(fs, rootPath, relDir, expected, extra) {
+    const absDir = relDir ? joinPath(rootPath, relDir) : rootPath;
+    for await (const entry of fs.readDir(absDir)) {
+        const relPath = relDir ? relDir + entry.name : entry.name;
+        if (entry.isDirectory) {
+            const dirRel = relPath.endsWith('/') ? relPath : relPath + '/';
+            await walkDir(fs, rootPath, dirRel, expected, extra);
+            continue;
+        }
+        if (!expected.has(relPath)) {
+            extra.push(relPath);
+        }
+    }
+}
+//# sourceMappingURL=verify.js.map

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

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

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

@@ -0,0 +1,72 @@
+import type { FileSystem } from './filesystem.js';
+import type { Store } from './store.js';
+import { Manifest } from './manifest.js';
+import { type DiffResult } from './diff.js';
+import { type ReconcileResult, type ReconcilePlan } from './reconcile.js';
+/** Workspace status information. */
+export interface WorkspaceStatus {
+    path: string;
+    exists: boolean;
+    hasManifest: boolean;
+    manifestC4ID: string | null;
+    created: string | null;
+    lastCheckout: string | null;
+}
+export interface CheckoutOptions {
+    progress?: (op: string, path: string, index: number, total: number) => void;
+    dryRun?: boolean;
+}
+export interface SnapshotOptions {
+    storeContent?: boolean;
+    progress?: (path: string, filesProcessed: number) => void;
+    skipHidden?: boolean;
+}
+/**
+ * Declarative directory management backed by a content store.
+ *
+ * A workspace ties a directory (via FileSystem) to a Store, enabling
+ * checkout (materialize a manifest), snapshot (capture current state),
+ * reset (revert to last checkout), and diff.
+ *
+ * Generic over FileSystem and Store — works in browser, Node, or memory.
+ */
+export declare class Workspace {
+    readonly rootPath: string;
+    readonly fs: FileSystem;
+    readonly store: Store;
+    private state;
+    private currentManifest;
+    constructor(rootPath: string, fs: FileSystem, store: Store);
+    /**
+     * Load persisted workspace state from disk.
+     * Call this after construction to restore previous session state.
+     */
+    load(): Promise<void>;
+    /**
+     * Make the directory match a manifest.
+     * Only transfers content that differs from what's on disk.
+     */
+    checkout(manifest: Manifest, options?: CheckoutOptions): Promise<ReconcileResult | ReconcilePlan>;
+    /**
+     * Capture the current directory state as a manifest.
+     */
+    snapshot(options?: SnapshotOptions): Promise<Manifest>;
+    /**
+     * Restore the directory to the last checked-out manifest.
+     */
+    reset(options?: {
+        progress?: CheckoutOptions['progress'];
+    }): Promise<ReconcileResult>;
+    /**
+     * Compare current directory state against the checked-out manifest.
+     */
+    diffFromCurrent(options?: {
+        progress?: SnapshotOptions['progress'];
+    }): Promise<DiffResult>;
+    /** Get workspace status. */
+    status(): WorkspaceStatus;
+    /** The currently checked-out manifest, or null. */
+    get manifest(): Manifest | null;
+    private saveState;
+}
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../../core/src/workspace.ts"],"names":[],"mappings":"AACA,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;AAExC,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAEjD,OAAO,EAAe,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAYtF,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,KAAK,IAAI,CAAA;IACzD,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IAErB,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,eAAe,CAAwB;gBAEnC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK;IAM1D;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B;;;OAGG;IACG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,GAAG,aAAa,CAAC;IAsBvG;;OAEG;IACG,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IAU5D;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAU3F;;OAEG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAQhG,4BAA4B;IAC5B,MAAM,IAAI,eAAe;IAWzB,mDAAmD;IACnD,IAAI,QAAQ,IAAI,QAAQ,GAAG,IAAI,CAE9B;YAEa,SAAS;CAexB"}

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

@@ -0,0 +1,135 @@
+import { streamToBytes, joinPath } from './filesystem.js';
+import { Manifest } from './manifest.js';
+import { diff } from './diff.js';
+import { scan } from './scanner.js';
+import { plan, apply } from './reconcile.js';
+const STATE_FILE = '.c4-workspace.json';
+const MANIFEST_FILE = '.c4-workspace-manifest.c4m';
+/**
+ * Declarative directory management backed by a content store.
+ *
+ * A workspace ties a directory (via FileSystem) to a Store, enabling
+ * checkout (materialize a manifest), snapshot (capture current state),
+ * reset (revert to last checkout), and diff.
+ *
+ * Generic over FileSystem and Store — works in browser, Node, or memory.
+ */
+export class Workspace {
+    constructor(rootPath, fs, store) {
+        this.state = null;
+        this.currentManifest = null;
+        this.rootPath = rootPath;
+        this.fs = fs;
+        this.store = store;
+    }
+    /**
+     * Load persisted workspace state from disk.
+     * Call this after construction to restore previous session state.
+     */
+    async load() {
+        try {
+            const stateStream = await this.fs.readFile(joinPath(this.rootPath, STATE_FILE));
+            const stateBytes = await streamToBytes(stateStream);
+            const stateText = new TextDecoder().decode(stateBytes);
+            this.state = JSON.parse(stateText);
+        }
+        catch {
+            this.state = null;
+        }
+        try {
+            const manifestStream = await this.fs.readFile(joinPath(this.rootPath, MANIFEST_FILE));
+            const manifestBytes = await streamToBytes(manifestStream);
+            const manifestText = new TextDecoder().decode(manifestBytes);
+            this.currentManifest = await Manifest.parse(manifestText);
+        }
+        catch {
+            this.currentManifest = null;
+        }
+    }
+    /**
+     * Make the directory match a manifest.
+     * Only transfers content that differs from what's on disk.
+     */
+    async checkout(manifest, options) {
+        const p = await plan(manifest, this.fs, this.rootPath, this.store);
+        if (options?.dryRun)
+            return p;
+        const result = await apply(p, this.fs, this.rootPath, this.store, {
+            progress: options?.progress,
+        });
+        // Persist state
+        this.currentManifest = manifest;
+        const c4id = await manifest.computeC4ID();
+        this.state = {
+            manifestC4ID: c4id.toString(),
+            created: this.state?.created ?? new Date().toISOString(),
+            lastCheckout: new Date().toISOString(),
+        };
+        await this.saveState();
+        return result;
+    }
+    /**
+     * Capture the current directory state as a manifest.
+     */
+    async snapshot(options) {
+        const scanOpts = {
+            store: options?.storeContent ? this.store : undefined,
+            progress: options?.progress,
+            skipHidden: options?.skipHidden ?? true,
+            computeIds: true,
+        };
+        return scan(this.fs, this.rootPath, scanOpts);
+    }
+    /**
+     * Restore the directory to the last checked-out manifest.
+     */
+    async reset(options) {
+        if (!this.currentManifest) {
+            throw new Error('no manifest checked out — cannot reset');
+        }
+        const p = await plan(this.currentManifest, this.fs, this.rootPath, this.store);
+        return apply(p, this.fs, this.rootPath, this.store, {
+            progress: options?.progress,
+        });
+    }
+    /**
+     * Compare current directory state against the checked-out manifest.
+     */
+    async diffFromCurrent(options) {
+        if (!this.currentManifest) {
+            throw new Error('no manifest checked out — cannot diff');
+        }
+        const current = await this.snapshot({ progress: options?.progress });
+        return diff(this.currentManifest, current);
+    }
+    /** Get workspace status. */
+    status() {
+        return {
+            path: this.rootPath,
+            exists: this.state !== null,
+            hasManifest: this.currentManifest !== null,
+            manifestC4ID: this.state?.manifestC4ID ?? null,
+            created: this.state?.created ?? null,
+            lastCheckout: this.state?.lastCheckout ?? null,
+        };
+    }
+    /** The currently checked-out manifest, or null. */
+    get manifest() {
+        return this.currentManifest;
+    }
+    async saveState() {
+        if (!this.state)
+            return;
+        // Save state JSON
+        const stateJson = JSON.stringify(this.state, null, 2);
+        const stateBytes = new TextEncoder().encode(stateJson);
+        await this.fs.writeFile(joinPath(this.rootPath, STATE_FILE), stateBytes);
+        // Save manifest c4m
+        if (this.currentManifest) {
+            const c4mText = this.currentManifest.encode();
+            const c4mBytes = new TextEncoder().encode(c4mText);
+            await this.fs.writeFile(joinPath(this.rootPath, MANIFEST_FILE), c4mBytes);
+        }
+    }
+}
+//# sourceMappingURL=workspace.js.map

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

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

package/dist/packages/node/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from '../../core/src/index.js';
+export { NodeFS } from './node-fs.js';
+export { TreeStore, openStore } from './tree-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/node/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,yBAAyB,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/packages/node/src/index.js

@@ -0,0 +1,6 @@
+// @avalanche-io/c4-node — Node.js extensions for C4
+// Re-exports core plus Node-specific implementations
+export * from '../../core/src/index.js';
+export { NodeFS } from './node-fs.js';
+export { TreeStore, openStore } from './tree-store.js';
+//# sourceMappingURL=index.js.map

package/dist/packages/node/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,qDAAqD;AAErD,cAAc,yBAAyB,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/packages/node/src/node-fs.d.ts

@@ -0,0 +1,24 @@
+import type { FileSystem, DirEntry, FileStat } from '../../core/src/filesystem.js';
+/**
+ * FileSystem implementation backed by Node.js fs module.
+ * Wraps node:fs/promises to provide the standard FileSystem interface.
+ */
+export declare class NodeFS implements FileSystem {
+    readDir(path: string): AsyncIterable<DirEntry>;
+    stat(path: string): Promise<FileStat>;
+    readFile(path: string): Promise<ReadableStream<Uint8Array>>;
+    readFileBytes(path: string): Promise<Uint8Array>;
+    writeFile(path: string, data: ReadableStream<Uint8Array> | Uint8Array): Promise<void>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    remove(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    setMeta(path: string, meta: {
+        mode?: number;
+        mtime?: Date;
+    }): Promise<void>;
+}
+//# sourceMappingURL=node-fs.d.ts.map

package/dist/packages/node/src/node-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-fs.d.ts","sourceRoot":"","sources":["../../../../src/node-fs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAGlF;;;GAGG;AACH,qBAAa,MAAO,YAAW,UAAU;IAChC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC;IAW/C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgBrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAU3D,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAUhD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAStE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAIlF"}

package/dist/packages/node/src/node-fs.js

@@ -0,0 +1,84 @@
+import { readdir, stat, readFile, writeFile, mkdir, rm, rename, chmod, utimes } from 'node:fs/promises';
+import { FileNotFoundError, bytesToStream, streamToBytes } from '../../core/src/filesystem.js';
+/**
+ * FileSystem implementation backed by Node.js fs module.
+ * Wraps node:fs/promises to provide the standard FileSystem interface.
+ */
+export class NodeFS {
+    async *readDir(path) {
+        const entries = await readdir(path, { withFileTypes: true });
+        for (const entry of entries) {
+            yield {
+                name: entry.name,
+                isDirectory: entry.isDirectory(),
+                isSymlink: entry.isSymbolicLink(),
+            };
+        }
+    }
+    async stat(path) {
+        try {
+            const s = await stat(path);
+            return {
+                size: s.size,
+                mode: s.mode & 0o7777,
+                mtime: s.mtime,
+                isDirectory: s.isDirectory(),
+                isSymlink: s.isSymbolicLink(),
+            };
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                throw new FileNotFoundError(path);
+            throw err;
+        }
+    }
+    async readFile(path) {
+        try {
+            const data = await readFile(path);
+            return bytesToStream(new Uint8Array(data));
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                throw new FileNotFoundError(path);
+            throw err;
+        }
+    }
+    async readFileBytes(path) {
+        try {
+            const data = await readFile(path);
+            return new Uint8Array(data);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                throw new FileNotFoundError(path);
+            throw err;
+        }
+    }
+    async writeFile(path, data) {
+        const bytes = data instanceof Uint8Array ? data : await streamToBytes(data);
+        await writeFile(path, bytes);
+    }
+    async mkdir(path, options) {
+        await mkdir(path, { recursive: options?.recursive });
+    }
+    async remove(path, options) {
+        try {
+            await rm(path, { recursive: options?.recursive, force: true });
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                throw new FileNotFoundError(path);
+            throw err;
+        }
+    }
+    async rename(oldPath, newPath) {
+        await rename(oldPath, newPath);
+    }
+    async setMeta(path, meta) {
+        if (meta.mode !== undefined)
+            await chmod(path, meta.mode);
+        if (meta.mtime !== undefined)
+            await utimes(path, meta.mtime, meta.mtime);
+    }
+}
+//# sourceMappingURL=node-fs.js.map

package/dist/packages/node/src/node-fs.js.map

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

package/dist/packages/node/src/tree-store.d.ts

@@ -0,0 +1,22 @@
+import type { C4ID } from '../../core/src/id.js';
+import type { Store } from '../../core/src/store.js';
+/**
+ * Filesystem content store compatible with Go's store.TreeStore
+ * and Python's FSStore.
+ *
+ * Layout: store/c4/REMAINING_88_CHARS
+ * All C4 IDs start with "c4", so top level has a single "c4" directory.
+ */
+export declare class TreeStore implements Store {
+    readonly path: string;
+    constructor(path: string);
+    has(id: C4ID): Promise<boolean>;
+    get(id: C4ID): Promise<ReadableStream<Uint8Array>>;
+    put(data: ReadableStream<Uint8Array> | Uint8Array): Promise<C4ID>;
+    remove(id: C4ID): Promise<void>;
+    private idToPath;
+    private idToDir;
+}
+/** Open the default content store (C4_STORE env or ~/.c4/store). */
+export declare function openStore(path?: string): Promise<TreeStore>;
+//# sourceMappingURL=tree-store.d.ts.map

package/dist/packages/node/src/tree-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-store.d.ts","sourceRoot":"","sources":["../../../../src/tree-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAGhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAGpD;;;;;;GAMG;AACH,qBAAa,SAAU,YAAW,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM;IAIlB,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/B,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IASlD,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,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,OAAO;CAIhB;AAED,oEAAoE;AACpE,wBAAsB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAQjE"}

package/dist/packages/node/src/tree-store.js

@@ -0,0 +1,77 @@
+import { readFile, writeFile, mkdir, rm, stat, rename as fsRename } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { identifyBytes } from '../../core/src/id.js';
+import { bytesToStream, streamToBytes } from '../../core/src/filesystem.js';
+import { ContentNotFoundError } from '../../core/src/store.js';
+/**
+ * Filesystem content store compatible with Go's store.TreeStore
+ * and Python's FSStore.
+ *
+ * Layout: store/c4/REMAINING_88_CHARS
+ * All C4 IDs start with "c4", so top level has a single "c4" directory.
+ */
+export class TreeStore {
+    constructor(path) {
+        this.path = path;
+    }
+    async has(id) {
+        try {
+            await stat(this.idToPath(id));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async get(id) {
+        try {
+            const data = await readFile(this.idToPath(id));
+            return bytesToStream(new Uint8Array(data));
+        }
+        catch {
+            throw new ContentNotFoundError(id);
+        }
+    }
+    async put(data) {
+        const bytes = data instanceof Uint8Array ? data : await streamToBytes(data);
+        const id = await identifyBytes(bytes);
+        if (await this.has(id))
+            return id;
+        const dir = this.idToDir(id);
+        await mkdir(dir, { recursive: true });
+        const tmpName = `.ingest.${randomBytes(8).toString('hex')}`;
+        const tmpPath = join(dir, tmpName);
+        const finalPath = this.idToPath(id);
+        await writeFile(tmpPath, bytes);
+        await fsRename(tmpPath, finalPath);
+        return id;
+    }
+    async remove(id) {
+        try {
+            await rm(this.idToPath(id));
+        }
+        catch { /* ignore */ }
+    }
+    idToPath(id) {
+        const s = id.toString();
+        return join(this.path, s.substring(0, 2), s.substring(2));
+    }
+    idToDir(id) {
+        const s = id.toString();
+        return join(this.path, s.substring(0, 2));
+    }
+}
+/** Open the default content store (C4_STORE env or ~/.c4/store). */
+export async function openStore(path) {
+    if (path)
+        return new TreeStore(path);
+    const envStore = process.env.C4_STORE;
+    if (envStore)
+        return new TreeStore(envStore);
+    const home = process.env.HOME ?? process.env.USERPROFILE ?? '';
+    const defaultPath = join(home, '.c4', 'store');
+    await mkdir(defaultPath, { recursive: true });
+    return new TreeStore(defaultPath);
+}
+//# sourceMappingURL=tree-store.js.map

package/dist/packages/node/src/tree-store.js.map

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