@qodalis/cli-files 2.0.0-beta.12 → 2.0.0-beta.14

package/umd/index.global.js

@@ -628,14 +628,14 @@ var files = (() => {
   var require_sort = __commonJS({
     "../../node_modules/.pnpm/semver@7.7.4/node_modules/semver/functions/sort.js"(exports$1, module2) {
       var compareBuild = require_compare_build();
-      var sort = (list, loose) => list.sort((a, b) => compareBuild(a, b, loose));
+      var sort = (list2, loose) => list2.sort((a, b) => compareBuild(a, b, loose));
       module2.exports = sort;
     }
   });
   var require_rsort = __commonJS({
     "../../node_modules/.pnpm/semver@7.7.4/node_modules/semver/functions/rsort.js"(exports$1, module2) {
       var compareBuild = require_compare_build();
-      var rsort = (list, loose) => list.sort((a, b) => compareBuild(b, a, loose));
+      var rsort = (list2, loose) => list2.sort((a, b) => compareBuild(b, a, loose));
       module2.exports = rsort;
     }
   });
@@ -1834,6 +1834,21 @@ var files = (() => {
     return CliForegroundColor2;
   })(CliForegroundColor || {});
   var ICliCompletionProvider_TOKEN = "cli-completion-provider";
+  function resolveHeaders(provider) {
+    if (!provider) return {};
+    return typeof provider === "function" ? provider() : provider;
+  }
+  var CliAccessDeniedError = class _CliAccessDeniedError extends Error {
+    constructor(message = "permission denied") {
+      super(message);
+      this.code = "EACCES";
+      this.name = "CliAccessDeniedError";
+      Object.setPrototypeOf(this, _CliAccessDeniedError.prototype);
+    }
+  };
+  function isCliAccessDeniedError(error) {
+    return error instanceof CliAccessDeniedError || !!error && typeof error === "object" && error.name === "CliAccessDeniedError";
+  }
   var DefaultLibraryAuthor = {
     name: "Nicolae Lupei",
     email: "nicolae.lupei@qodalis.com"
@@ -1860,9 +1875,12 @@ var files = (() => {
      * Returns the negotiated API version and the base path for all subsequent calls,
      * or null if the server is unreachable or incompatible.
      */
-    static async discover(baseUrl) {
+    static async discover(baseUrl, headers) {
       try {
-        const response = await fetch(`${baseUrl}${VERSIONS_ENDPOINT}`);
+        const resolved = resolveHeaders(headers);
+        const response = await fetch(`${baseUrl}${VERSIONS_ENDPOINT}`, {
+          headers: Object.keys(resolved).length > 0 ? resolved : void 0
+        });
         if (!response.ok) return null;
         const info = await response.json();
         const version = this.negotiate(info);
@@ -2694,7 +2712,7 @@ var files = (() => {
   };
 
   // src/lib/version.ts
-  var LIBRARY_VERSION = "2.0.0-beta.12";
+  var LIBRARY_VERSION = "2.0.0-beta.14";
   var API_VERSION2 = 2;
 
   // src/lib/interfaces/i-file-system-service.ts
@@ -2707,6 +2725,7 @@ var files = (() => {
   var CWD_KEY = "cwd";
   var HOME_KEY = "home";
   var DEFAULT_HOME = "/";
+  var ANONYMOUS_OWNERSHIP = { uid: "nobody", gid: "nogroup" };
   function createSeedFileSystem() {
     const now = Date.now();
     return {
@@ -2754,6 +2773,88 @@ var files = (() => {
       this.homePath = DEFAULT_HOME;
       this.currentUid = null;
       this.currentGroups = [];
+      this.systemDepth = 0;
+    }
+    // --- Access control ---
+    setAccessPolicy(policy) {
+      this.accessPolicy = policy;
+    }
+    runAsSystem(fn) {
+      this.systemDepth++;
+      try {
+        return fn();
+      } finally {
+        this.systemDepth--;
+      }
+    }
+    reassignOwner(fromUid, toUid) {
+      const from = fromUid.toLowerCase();
+      if (!from || !toUid) return 0;
+      let changed = 0;
+      const visit = (node) => {
+        if (node.ownership && node.ownership.uid.toLowerCase() === from) {
+          node.ownership = { ...node.ownership, uid: toUid };
+          changed++;
+        }
+        node.children?.forEach(visit);
+      };
+      visit(this.root);
+      return changed;
+    }
+    canTraverse(path) {
+      try {
+        this.assertTraverse(this.resolvePath(path), "stat", path);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    get enforcing() {
+      return !!this.accessPolicy && this.systemDepth === 0;
+    }
+    deny(op, path, reason = "Permission denied") {
+      throw new CliAccessDeniedError(`${op}: ${path}: ${reason}`);
+    }
+    /** `x` on every existing directory on the way to `resolved` (excluding the target). */
+    assertTraverse(resolved, op, display) {
+      if (!this.enforcing) return;
+      const parts = resolved.split("/").filter(Boolean);
+      let current = this.root;
+      for (let i = 0; i < parts.length; i++) {
+        if (!current || current.type !== "directory") return;
+        if (!this.accessPolicy.canAccess(current, "execute")) this.deny(op, display);
+        current = current.children?.find((c) => c.name === parts[i]);
+      }
+    }
+    assertAccess(node, action, op, display) {
+      if (this.enforcing && !this.accessPolicy.canAccess(node, action)) this.deny(op, display);
+    }
+    /** Recursive delete: every directory inside must allow removing its entries (`w` + `x`, readable). */
+    assertRemovableTree(dir, dirPath, display) {
+      if (!this.enforcing) return;
+      this.assertAccess(dir, "read", "rm", display);
+      this.assertAccess(dir, "execute", "rm", display);
+      if ((dir.children?.length ?? 0) > 0) this.assertAccess(dir, "write", "rm", display);
+      for (const child of dir.children ?? []) {
+        if (child.type === "directory") this.assertRemovableTree(child, `${dirPath}/${child.name}`, display);
+      }
+    }
+    /** Copying reads everything it copies: `r` on every file, `r` + `x` on every directory. */
+    assertReadableTree(node, display) {
+      if (!this.enforcing) return;
+      this.assertAccess(node, "read", "cp", display);
+      if (node.type !== "directory") return;
+      this.assertAccess(node, "execute", "cp", display);
+      for (const child of node.children ?? []) {
+        this.assertReadableTree(child, `${display.replace(/\/+$/, "")}/${child.name}`);
+      }
+    }
+    /** Creating/removing entries needs `w` and `x` on the containing directory. */
+    assertModifyDir(dir, dirPath, op, display) {
+      if (!this.enforcing) return;
+      this.assertTraverse(dirPath, op, display);
+      this.assertAccess(dir, "execute", op, display);
+      this.assertAccess(dir, "write", op, display);
     }
     // --- User context ---
     setCurrentUser(uid, groups) {
@@ -2761,7 +2862,9 @@ var files = (() => {
       this.currentGroups = groups;
     }
     getDefaultOwnership() {
-      if (!this.currentUid) return void 0;
+      if (!this.currentUid) {
+        return this.accessPolicy ? { ...ANONYMOUS_OWNERSHIP } : void 0;
+      }
       return {
         uid: this.currentUid,
         gid: this.currentGroups[0] || "users"
@@ -2780,6 +2883,8 @@ var files = (() => {
       if (node.type !== "directory") {
         throw new Error(`cd: ${path}: Not a directory`);
       }
+      this.assertTraverse(resolved, "cd", path);
+      this.assertAccess(node, "execute", "cd", path);
       this.cwd = resolved;
     }
     getHomePath() {
@@ -2836,6 +2941,8 @@ var files = (() => {
       if (node.type !== "directory") {
         throw new Error(`ls: ${path}: Not a directory`);
       }
+      this.assertTraverse(this.resolvePath(path), "ls", path);
+      this.assertAccess(node, "read", "ls", path);
       return node.children || [];
     }
     readFile(path) {
@@ -2846,6 +2953,8 @@ var files = (() => {
       if (node.type === "directory") {
         throw new Error(`cat: ${path}: Is a directory`);
       }
+      this.assertTraverse(this.resolvePath(path), "cat", path);
+      this.assertAccess(node, "read", "cat", path);
       return node.content ?? "";
     }
     exists(path) {
@@ -2870,6 +2979,10 @@ var files = (() => {
           }
           let child = current.children.find((c) => c.name === part);
           if (!child) {
+            if (this.enforcing) {
+              this.assertAccess(current, "execute", "mkdir", path);
+              this.assertAccess(current, "write", "mkdir", path);
+            }
             const now = Date.now();
             child = {
               name: part,
@@ -2885,6 +2998,8 @@ var files = (() => {
             current.modifiedAt = now;
           } else if (child.type !== "directory") {
             throw new Error(`mkdir: ${part}: Not a directory`);
+          } else {
+            this.assertAccess(child, "execute", "mkdir", path);
           }
           current = child;
         }
@@ -2903,6 +3018,7 @@ var files = (() => {
         if (parent.children?.find((c) => c.name === dirName)) {
           throw new Error(`mkdir: ${path}: File exists`);
         }
+        this.assertModifyDir(parent, parentPath, "mkdir", path);
         const now = Date.now();
         if (!parent.children) {
           parent.children = [];
@@ -2937,6 +3053,12 @@ var files = (() => {
       }
       const existing = parent.children?.find((c) => c.name === fileName);
       const now = Date.now();
+      if (existing) {
+        this.assertTraverse(resolved, "touch", path);
+        this.assertAccess(existing, "write", "touch", path);
+      } else {
+        this.assertModifyDir(parent, parentPath, "touch", path);
+      }
       if (existing) {
         existing.modifiedAt = now;
       } else {
@@ -2963,6 +3085,8 @@ var files = (() => {
         if (node.type === "directory") {
           throw new Error(`write: ${path}: Is a directory`);
         }
+        this.assertTraverse(resolved, "write", path);
+        this.assertAccess(node, "write", "write", path);
         const now = Date.now();
         node.content = append ? (node.content ?? "") + content : content;
         node.size = new Blob([node.content]).size;
@@ -2991,6 +3115,8 @@ var files = (() => {
       if (target.type === "directory" && !recursive) {
         throw new Error(`rm: ${path}: Is a directory`);
       }
+      this.assertModifyDir(parent, parentPath, "rm", path);
+      if (target.type === "directory") this.assertRemovableTree(target, resolved, path);
       parent.children.splice(index, 1);
       parent.modifiedAt = Date.now();
     }
@@ -3005,10 +3131,13 @@ var files = (() => {
           `cp: -r not specified; omitting directory '${src}'`
         );
       }
+      this.assertTraverse(srcResolved, "cp", src);
+      this.assertReadableTree(srcNode, src);
       const destResolved = this.resolvePath(dest);
       const destNode = this.getNode(destResolved);
       if (destNode && destNode.type === "directory") {
-        const clone = this.cloneNode(srcNode);
+        this.assertModifyDir(destNode, destResolved, "cp", dest);
+        const clone = this.ownedByCurrentUser(this.cloneNode(srcNode));
         if (!destNode.children) {
           destNode.children = [];
         }
@@ -3028,7 +3157,8 @@ var files = (() => {
         if (!parent || parent.type !== "directory") {
           throw new Error(`cp: ${parentPath}: No such file or directory`);
         }
-        const clone = this.cloneNode(srcNode);
+        this.assertModifyDir(parent, parentPath, "cp", dest);
+        const clone = this.ownedByCurrentUser(this.cloneNode(srcNode));
         clone.name = newName;
         if (!parent.children) {
           parent.children = [];
@@ -3060,10 +3190,12 @@ var files = (() => {
       if (!srcParent || !srcParent.children) {
         throw new Error(`mv: ${src}: No such file or directory`);
       }
+      this.assertModifyDir(srcParent, srcParentPath, "mv", src);
       const srcIndex = srcParent.children.findIndex(
         (c) => c.name === srcNode.name
       );
       if (destNode && destNode.type === "directory") {
+        this.assertModifyDir(destNode, destResolved, "mv", dest);
         if (!destNode.children) {
           destNode.children = [];
         }
@@ -3086,6 +3218,7 @@ var files = (() => {
             `mv: ${destParentPath}: No such file or directory`
           );
         }
+        this.assertModifyDir(destParent, destParentPath, "mv", dest);
         srcParent.children.splice(srcIndex, 1);
         srcNode.name = newName;
         if (!destParent.children) {
@@ -3109,6 +3242,9 @@ var files = (() => {
       if (!node) {
         throw new Error(`chmod: ${path}: No such file or directory`);
       }
+      if (this.enforcing && !this.accessPolicy.canChangeOwnership(node)) {
+        this.deny("chmod", path, "Operation not permitted");
+      }
       node.permissions = permissions;
     }
     chown(path, ownership) {
@@ -3117,6 +3253,9 @@ var files = (() => {
       if (!node) {
         throw new Error(`chown: ${path}: No such file or directory`);
       }
+      if (this.enforcing && !this.accessPolicy.canChangeOwnership(node, ownership)) {
+        this.deny("chown", path, "Operation not permitted");
+      }
       node.ownership = ownership;
     }
     // --- Persistence ---
@@ -3158,6 +3297,18 @@ var files = (() => {
       }
     }
     // --- Private helpers ---
+    /** A copy belongs to whoever made it (like `cp` without `-p`) */
+    ownedByCurrentUser(node) {
+      const owner = this.getDefaultOwnership();
+      if (owner) {
+        const apply = (n) => {
+          n.ownership = { ...owner };
+          n.children?.forEach(apply);
+        };
+        apply(node);
+      }
+      return node;
+    }
     cloneNode(node) {
       const now = Date.now();
       const clone = {
@@ -3309,7 +3460,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const targetPath = command.value || fs.getCurrentDirectory();
@@ -3382,7 +3533,7 @@ var files = (() => {
       this.metadata = { icon: "\u{1F4C1}", module: "file management" };
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const target = command.value || "~";
@@ -3405,7 +3556,7 @@ var files = (() => {
       this.metadata = { icon: "\u{1F4C2}", module: "file management" };
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       context.writer.writeln(fs.getCurrentDirectory());
@@ -3433,7 +3584,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const path = command.value;
@@ -3463,7 +3614,7 @@ var files = (() => {
       this.metadata = { icon: "\u{1F5D1}", module: "file management" };
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const path = command.value;
@@ -3509,7 +3660,7 @@ var files = (() => {
       this.metadata = { icon: "\u{1F4C4}", module: "file management" };
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const path = command.value;
@@ -3538,7 +3689,7 @@ var files = (() => {
       this.metadata = { icon: "\u{1F4D6}", module: "file management" };
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const path = command.value;
@@ -3579,7 +3730,7 @@ var files = (() => {
         }
         return;
       }
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       let text;
@@ -3653,7 +3804,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const path = command.value;
@@ -3704,7 +3855,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const recursive = command.args["recursive"] || command.args["r"] || command.args["R"];
@@ -3742,7 +3893,7 @@ var files = (() => {
       this.metadata = { icon: "\u{1F4E6}", module: "file management" };
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const parts = this.parseArgs(command);
@@ -3766,6 +3917,16 @@ var files = (() => {
     }
   };
 
+  // src/lib/utils/readable-children.ts
+  function readableChildren(fs, path) {
+    try {
+      return fs.listDirectory(path);
+    } catch (e) {
+      if (isCliAccessDeniedError(e)) return null;
+      throw e;
+    }
+  }
+
   // src/lib/processors/cli-tree-command-processor.ts
   var CliTreeCommandProcessor = class {
     constructor() {
@@ -3786,7 +3947,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const targetPath = command.value || fs.getCurrentDirectory();
@@ -3813,7 +3974,8 @@ var files = (() => {
           )
         );
         const counts = { dirs: 0, files: 0 };
-        this.printTree(node, "", true, 0, maxDepth, context, counts);
+        this.fs = fs;
+        this.printTree(node, "", true, 0, maxDepth, context, counts, resolvedPath);
         context.writer.writeln();
         context.writer.writeln(
           `${counts.dirs} directories, ${counts.files} files`
@@ -3822,11 +3984,15 @@ var files = (() => {
         context.writer.writeError(e.message);
       }
     }
-    printTree(node, prefix, isRoot, depth, maxDepth, context, counts) {
-      if (!node.children || depth >= maxDepth) {
+    printTree(node, prefix, isRoot, depth, maxDepth, context, counts, path = "/") {
+      if (depth >= maxDepth) {
+        return;
+      }
+      const visible = this.fs ? readableChildren(this.fs, path) : node.children;
+      if (!visible) {
         return;
       }
-      const children = [...node.children].sort((a, b) => {
+      const children = [...visible].sort((a, b) => {
         if (a.type !== b.type) {
           return a.type === "directory" ? -1 : 1;
         }
@@ -3851,7 +4017,8 @@ var files = (() => {
             depth + 1,
             maxDepth,
             context,
-            counts
+            counts,
+            path === "/" ? `/${child.name}` : `${path}/${child.name}`
           );
         } else {
           counts.files++;
@@ -3881,7 +4048,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const count = parseInt(
@@ -3948,7 +4115,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const count = parseInt(
@@ -4029,7 +4196,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const showLines = command.args["lines"] || command.args["l"] || false;
@@ -4125,7 +4292,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const searchPath = this.parseSearchPath(command) || fs.getCurrentDirectory();
@@ -4149,6 +4316,7 @@ var files = (() => {
         const resolvedBase = fs.resolvePath(searchPath);
         const nameRegex = namePattern ? this.globToRegex(namePattern) : null;
         const results = [];
+        this.fs = fs;
         this.walk(
           node,
           resolvedBase,
@@ -4176,8 +4344,9 @@ var files = (() => {
       return new RegExp(`^${regexStr}$`, "i");
     }
     walk(node, currentPath, depth, maxDepth, nameRegex, typeFilter, results) {
-      if (!node.children) return;
-      for (const child of node.children) {
+      const children = this.fs ? readableChildren(this.fs, currentPath) : node.children;
+      if (!children) return;
+      for (const child of children) {
         const childPath = currentPath === "/" ? `/${child.name}` : `${currentPath}/${child.name}`;
         let matches = true;
         if (nameRegex && !nameRegex.test(child.name)) {
@@ -4262,7 +4431,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       const ignoreCase = command.args["ignore-case"] || command.args["i"] || false;
@@ -4410,8 +4579,9 @@ var files = (() => {
       };
     }
     collectFiles(fs, basePath, node, result) {
-      if (!node.children) return;
-      for (const child of node.children) {
+      const children = readableChildren(fs, basePath);
+      if (!children) return;
+      for (const child of children) {
         const childPath = basePath === "/" ? `/${child.name}` : `${basePath}/${child.name}`;
         if (child.type === "file") {
           result.push(childPath);
@@ -4443,7 +4613,7 @@ var files = (() => {
       ];
     }
     async processCommand(command, context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       let filePath = (command.value || "").trim();
@@ -4571,7 +4741,6 @@ var files = (() => {
   }
 
   // src/cli-entrypoint.ts
-  var fsService = new IndexedDbFileSystemService();
   var module = {
     apiVersion: API_VERSION2,
     name: "@qodalis/cli-files",
@@ -4598,16 +4767,17 @@ var files = (() => {
     services: [
       {
         provide: IFileSystemService_TOKEN,
-        useValue: fsService
+        useClass: IndexedDbFileSystemService
       },
       {
         provide: ICliCompletionProvider_TOKEN,
-        useValue: new FilePathCompletionProvider(fsService),
+        useClass: FilePathCompletionProvider,
+        deps: [IFileSystemService_TOKEN],
         multi: true
       }
     ],
     async onInit(context) {
-      const fs = context.services.get(
+      const fs = context.services.getRequired(
         IFileSystemService_TOKEN
       );
       await fs.initialize();