@catmint-fs/core 0.0.0-prealpha.0 → 0.0.0-prealpha.2

package/dist/index.d.ts

@@ -180,7 +180,17 @@ declare class Layer {
      * Enforce ENOSYS for operations that require symlink support.
      */
     private assertSymlinksSupported;
+    /**
+     * Resolve a virtual path to a real (adapter-level) path by prepending
+     * the layer root.  Virtual "/" maps to this.root, virtual "/foo" maps
+     * to this.root + "/foo", etc.
+     */
     private resolvePath;
+    /**
+     * Convert a real (adapter-level) path back to a virtual path by stripping
+     * the layer root prefix.  Used when returning paths to the caller.
+     */
+    private toVirtualPath;
     /**
      * Follow symlinks to resolve the final path. Used by operations that
      * follow symlinks (readFile, stat, writeFile, chmod, chown, exists).
@@ -211,11 +221,20 @@ declare class Layer {
     }>;
     getChanges(): ChangeEntry[];
     getChangeDetail(path: string): Promise<ChangeDetail | null>;
+    /**
+     * Convert a ChangeEntry's paths from real to virtual.
+     */
+    private changeEntryToVirtual;
+    /**
+     * Convert a ChangeDetail's paths from real to virtual.
+     */
+    private changeDetailToVirtual;
     apply(options?: ApplyOptions): Promise<ApplyResult>;
     private applyBestEffort;
     private applyTransaction;
     /**
      * Convert a flat ChangeDetail back to a ChangeEntry for error reporting.
+     * Paths are converted to virtual for user-facing output.
      */
     private detailToChangeEntry;
     /**

package/dist/index.js

@@ -454,9 +454,29 @@ var Layer = class {
       throw new FsError("ENOSYS", "operation not supported: symlinks are disabled");
     }
   }
+  /**
+   * Resolve a virtual path to a real (adapter-level) path by prepending
+   * the layer root.  Virtual "/" maps to this.root, virtual "/foo" maps
+   * to this.root + "/foo", etc.
+   */
   resolvePath(p) {
-    if (p.startsWith("/")) return p;
-    return this.root + (this.root.endsWith("/") ? "" : "/") + p;
+    const base = this.root.endsWith("/") ? this.root.slice(0, -1) : this.root;
+    const virtual = p.startsWith("/") ? p : "/" + p;
+    if (virtual === "/") return base || "/";
+    return base + virtual;
+  }
+  /**
+   * Convert a real (adapter-level) path back to a virtual path by stripping
+   * the layer root prefix.  Used when returning paths to the caller.
+   */
+  toVirtualPath(realPath) {
+    const base = this.root.endsWith("/") ? this.root.slice(0, -1) : this.root;
+    if (base === "" || base === "/") return realPath;
+    if (realPath === base) return "/";
+    if (realPath.startsWith(base + "/")) {
+      return realPath.substring(base.length);
+    }
+    return realPath;
   }
   /**
    * Follow symlinks to resolve the final path. Used by operations that
@@ -1090,7 +1110,7 @@ var Layer = class {
     if (!isDir) {
       throw new FsError("ENOTDIR", `not a directory: ${absPath}`);
     }
-    const entries = await this.readdir(absPath);
+    const entries = await this.readdir(path2);
     if (entries.length > 0) {
       throw new FsError("ENOTEMPTY", `directory not empty: ${absPath}`);
     }
@@ -1247,12 +1267,56 @@ var Layer = class {
   // --- Changes ---
   getChanges() {
     this.assertNotDisposed();
-    return this.ledger.getAll();
+    return this.ledger.getAll().map((entry) => this.changeEntryToVirtual(entry));
   }
   async getChangeDetail(path2) {
     this.assertNotDisposed();
     const absPath = this.resolvePath(path2);
-    return this.ledger.getDetail(absPath);
+    const detail = this.ledger.getDetail(absPath);
+    if (!detail) return null;
+    return this.changeDetailToVirtual(detail);
+  }
+  /**
+   * Convert a ChangeEntry's paths from real to virtual.
+   */
+  changeEntryToVirtual(entry) {
+    switch (entry.type) {
+      case "create":
+        return { ...entry, path: this.toVirtualPath(entry.path) };
+      case "update":
+        return { ...entry, path: this.toVirtualPath(entry.path) };
+      case "delete":
+        return { ...entry, path: this.toVirtualPath(entry.path) };
+      case "rename":
+        return { ...entry, from: this.toVirtualPath(entry.from), to: this.toVirtualPath(entry.to) };
+      case "chmod":
+        return { ...entry, path: this.toVirtualPath(entry.path) };
+      case "chown":
+        return { ...entry, path: this.toVirtualPath(entry.path) };
+      case "symlink":
+        return { ...entry, path: this.toVirtualPath(entry.path) };
+    }
+  }
+  /**
+   * Convert a ChangeDetail's paths from real to virtual.
+   */
+  changeDetailToVirtual(detail) {
+    switch (detail.type) {
+      case "create":
+        return { ...detail, path: this.toVirtualPath(detail.path) };
+      case "update":
+        return { ...detail, path: this.toVirtualPath(detail.path) };
+      case "delete":
+        return { ...detail, path: this.toVirtualPath(detail.path) };
+      case "rename":
+        return { ...detail, from: this.toVirtualPath(detail.from), to: this.toVirtualPath(detail.to) };
+      case "chmod":
+        return { ...detail, path: this.toVirtualPath(detail.path) };
+      case "chown":
+        return { ...detail, path: this.toVirtualPath(detail.path) };
+      case "symlink":
+        return { ...detail, path: this.toVirtualPath(detail.path) };
+    }
   }
   // --- Apply ---
   async apply(options) {
@@ -1399,23 +1463,24 @@ var Layer = class {
   }
   /**
    * Convert a flat ChangeDetail back to a ChangeEntry for error reporting.
+   * Paths are converted to virtual for user-facing output.
    */
   detailToChangeEntry(detail) {
     switch (detail.type) {
       case "create":
-        return { type: "create", entryType: detail.entryType, path: detail.path };
+        return { type: "create", entryType: detail.entryType, path: this.toVirtualPath(detail.path) };
       case "update":
-        return { type: "update", path: detail.path };
+        return { type: "update", path: this.toVirtualPath(detail.path) };
       case "delete":
-        return { type: "delete", entryType: detail.entryType, path: detail.path };
+        return { type: "delete", entryType: detail.entryType, path: this.toVirtualPath(detail.path) };
       case "rename":
-        return { type: "rename", from: detail.from, to: detail.to };
+        return { type: "rename", from: this.toVirtualPath(detail.from), to: this.toVirtualPath(detail.to) };
       case "chmod":
-        return { type: "chmod", path: detail.path, mode: detail.mode };
+        return { type: "chmod", path: this.toVirtualPath(detail.path), mode: detail.mode };
       case "chown":
-        return { type: "chown", path: detail.path, uid: detail.uid, gid: detail.gid };
+        return { type: "chown", path: this.toVirtualPath(detail.path), uid: detail.uid, gid: detail.gid };
       case "symlink":
-        return { type: "symlink", path: detail.path, target: detail.target };
+        return { type: "symlink", path: this.toVirtualPath(detail.path), target: detail.target };
     }
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catmint-fs/core",
-  "version": "0.0.0-prealpha.0",
+  "version": "0.0.0-prealpha.2",
   "description": "Virtual filesystem layer with copy-on-write semantics over a pluggable backing store",
   "type": "module",
   "main": "./dist/index.js",