@git.zone/cli 2.23.0 → 2.25.0

package/ts/mod_services/helpers.ts

@@ -90,6 +90,66 @@ export const formatBytes = (bytes: number): string => {
   return `${size.toFixed(2)} ${units[unitIndex]}`;
 };
 
+/**
+ * True when either path contains the other, or they are the same path.
+ *
+ * Used to decide whether a deletion candidate collides with a directory a
+ * running container has mounted. Containment in *either* direction counts: a
+ * parent mount protects its children, and a child mount protects its parent.
+ */
+export const pathsOverlap = (firstPathArg: string, secondPathArg: string): boolean => {
+  const firstPath = plugins.path.resolve(firstPathArg);
+  const secondPath = plugins.path.resolve(secondPathArg);
+  const contains = (containerPath: string, candidatePath: string): boolean => {
+    const relative = plugins.path.relative(containerPath, candidatePath);
+    if (relative === '') {
+      return true;
+    }
+    return !!relative && !relative.startsWith('..') && !plugins.path.isAbsolute(relative);
+  };
+  return contains(firstPath, secondPath) || contains(secondPath, firstPath);
+};
+
+/**
+ * Total size in bytes of a directory tree.
+ *
+ * Symlinks are counted by their own size and never followed, so a symlink
+ * inside a data directory can neither inflate the report nor walk out of it.
+ */
+export const getDirectorySize = async (
+  directoryPathArg: string,
+  maxDepthArg: number = 64,
+): Promise<number> => {
+  let total = 0;
+  const walk = async (currentPath: string, depth: number): Promise<void> => {
+    // Bind mounts inside a data directory are user-controlled and can form a
+    // cycle; a depth cap keeps this from recursing until it exhausts memory.
+    if (depth > maxDepthArg) {
+      return;
+    }
+    const entries = await plugins.fs
+      .readdir(currentPath, { withFileTypes: true })
+      .catch(() => []);
+    for (const entry of entries) {
+      const entryPath = plugins.path.join(currentPath, entry.name);
+      // isDirectory() here is lstat-based, so symlinks are counted by their own
+      // size and never followed.
+      if (entry.isDirectory()) {
+        await walk(entryPath, depth + 1);
+        continue;
+      }
+      try {
+        const stats = await plugins.fs.lstat(entryPath);
+        total += stats.size;
+      } catch {
+        // entry disappeared between readdir and lstat; ignore
+      }
+    }
+  };
+  await walk(plugins.path.resolve(directoryPathArg), 0);
+  return total;
+};
+
 /**
  * Get the local network IP address
  */