@zthun/crumbtrail-fs 2.0.0 → 2.0.2

package/dist/index.js

@@ -1,103 +1,507 @@
-import { omitBy, isUndefined } from "lodash-es";
-import { glob } from "glob";
-import { access } from "node:fs/promises";
-import { isAbsolute, resolve, dirname } from "node:path";
-import { cwd } from "node:process";
-var ZFileSystemNodeType = /* @__PURE__ */ ((ZFileSystemNodeType2) => {
-  ZFileSystemNodeType2["File"] = "file";
-  ZFileSystemNodeType2["Folder"] = "folder";
-  return ZFileSystemNodeType2;
-})(ZFileSystemNodeType || {});
-class ZFileSystemNodeBuilder {
-  constructor() {
-    this.file = this.type.bind(
-      this,
-      "file"
-      /* File */
-    );
-    this.folder = this.type.bind(
-      this,
-      "folder"
-      /* Folder */
-    );
-    this._node = {
-      path: "/",
-      type: "folder"
-      /* Folder */
-    };
-  }
-  created(at) {
-    this._node.created = at instanceof Date ? at.toJSON() : at;
-    return this;
-  }
-  updated(at) {
-    this._node.updated = at instanceof Date ? at.toJSON() : at;
-    return this;
-  }
-  size(bytes) {
-    this._node.size = typeof bytes == "number" ? BigInt(bytes) : bytes;
-    return this;
-  }
-  path(path) {
-    this._node.path = path;
-    return this;
-  }
-  type(type) {
-    this._node.type = type;
-    return this;
-  }
-  build() {
-    const clone = structuredClone(this._node);
-    return omitBy(clone, isUndefined);
-  }
-}
-class ZFileSystemService {
-  async info(path) {
-    const [file] = await this.search(path);
-    return file;
-  }
-  async search(pattern, options) {
-    const paths = await glob(pattern, {
-      ...options,
-      stat: true,
-      withFileTypes: true
-    });
-    return paths.map((path) => {
-      let info = new ZFileSystemNodeBuilder().path(path.fullpath()).created(path.birthtime).updated(path.atime).size(path.size);
-      info = path.isFile() ? info.file() : info.folder().size(void 0);
-      return info.build();
-    });
-  }
-  async walk(search, options) {
-    const start = (options == null ? void 0 : options.start) || cwd();
-    const stop = (options == null ? void 0 : options.stop) || "/";
-    const mode = options == null ? void 0 : options.mode;
-    const _test = async (path) => {
-      try {
-        await access(path, mode);
-        return true;
-      } catch {
-        return false;
-      }
+import { omitBy, isUndefined } from 'lodash-es';
+import { glob } from 'glob';
+import { access } from 'node:fs/promises';
+import { dirname, resolve, isAbsolute } from 'node:path';
+import { cwd } from 'node:process';
+
+function _class_call_check$1(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _defineProperties$1(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class$1(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties$1(Constructor.prototype, protoProps);
+    return Constructor;
+}
+function _define_property$1(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+/**
+ * Represents a type of a file system node.
+ */ var ZFileSystemNodeType = /*#__PURE__*/ function(ZFileSystemNodeType) {
+    ZFileSystemNodeType["File"] = "file";
+    ZFileSystemNodeType["Folder"] = "folder";
+    return ZFileSystemNodeType;
+}({});
+/**
+ * Represents a builder for a file system node.
+ */ var ZFileSystemNodeBuilder = /*#__PURE__*/ function() {
+    function ZFileSystemNodeBuilder() {
+        _class_call_check$1(this, ZFileSystemNodeBuilder);
+        _define_property$1(this, "_node", void 0);
+        _define_property$1(this, "file", this.type.bind(this, "file"));
+        _define_property$1(this, "folder", this.type.bind(this, "folder"));
+        this._node = {
+            path: "/",
+            type: "folder"
+        };
+    }
+    _create_class$1(ZFileSystemNodeBuilder, [
+        {
+            key: "created",
+            value: function created(at) {
+                this._node.created = _instanceof(at, Date) ? at.toJSON() : at;
+                return this;
+            }
+        },
+        {
+            key: "updated",
+            value: function updated(at) {
+                this._node.updated = _instanceof(at, Date) ? at.toJSON() : at;
+                return this;
+            }
+        },
+        {
+            key: "size",
+            value: function size(bytes) {
+                this._node.size = typeof bytes == "number" ? BigInt(bytes) : bytes;
+                return this;
+            }
+        },
+        {
+            key: "path",
+            value: function path(path) {
+                this._node.path = path;
+                return this;
+            }
+        },
+        {
+            key: "type",
+            value: function type(type) {
+                this._node.type = type;
+                return this;
+            }
+        },
+        {
+            key: "build",
+            value: function build() {
+                var clone = structuredClone(this._node);
+                return omitBy(clone, isUndefined);
+            }
+        }
+    ]);
+    return ZFileSystemNodeBuilder;
+}();
+
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
     };
-    if (isAbsolute(search)) {
-      return await _test(search) ? search : null;
-    }
-    let dir = start;
-    do {
-      const path = resolve(dir, search);
-      const exists = await _test(path);
-      if (exists) {
-        return path;
-      }
-      dir = dir === stop ? "" : dirname(dir);
-    } while (dir.length);
-    return null;
-  }
-}
-export {
-  ZFileSystemNodeBuilder,
-  ZFileSystemNodeType,
-  ZFileSystemService
-};
+}
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _defineProperties(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    return Constructor;
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+/**
+ * Represents a node implementation of a file system service.
+ */ var ZFileSystemService = /*#__PURE__*/ function() {
+    function ZFileSystemService() {
+        _class_call_check(this, ZFileSystemService);
+    }
+    _create_class(ZFileSystemService, [
+        {
+            key: "info",
+            value: function info(path) {
+                return _async_to_generator(function() {
+                    var _ref, file;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    this.search(path)
+                                ];
+                            case 1:
+                                _ref = _sliced_to_array.apply(void 0, [
+                                    _state.sent(),
+                                    1
+                                ]), file = _ref[0];
+                                return [
+                                    2,
+                                    file
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "search",
+            value: function search(pattern, options) {
+                return _async_to_generator(function() {
+                    var paths;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    glob(pattern, _object_spread_props(_object_spread({}, options), {
+                                        stat: true,
+                                        withFileTypes: true
+                                    }))
+                                ];
+                            case 1:
+                                paths = _state.sent();
+                                return [
+                                    2,
+                                    paths.map(function(path) {
+                                        var info = new ZFileSystemNodeBuilder().path(path.fullpath()).created(path.birthtime).updated(path.atime).size(path.size);
+                                        // Note that for folders, node will return the size of the underlying OS metadata,
+                                        // hence, why we 0 out the size on a folder here.
+                                        info = path.isFile() ? info.file() : info.folder().size(undefined);
+                                        return info.build();
+                                    })
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            key: "walk",
+            value: function walk(search, options) {
+                return _async_to_generator(function() {
+                    var start, stop, mode, _test, dir, path, exists;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                start = (options === null || options === void 0 ? void 0 : options.start) || cwd();
+                                stop = (options === null || options === void 0 ? void 0 : options.stop) || "/";
+                                mode = options === null || options === void 0 ? void 0 : options.mode;
+                                _test = function(path) {
+                                    return _async_to_generator(function() {
+                                        return _ts_generator(this, function(_state) {
+                                            switch(_state.label){
+                                                case 0:
+                                                    _state.trys.push([
+                                                        0,
+                                                        2,
+                                                        ,
+                                                        3
+                                                    ]);
+                                                    return [
+                                                        4,
+                                                        access(path, mode)
+                                                    ];
+                                                case 1:
+                                                    _state.sent();
+                                                    return [
+                                                        2,
+                                                        true
+                                                    ];
+                                                case 2:
+                                                    _state.sent();
+                                                    return [
+                                                        2,
+                                                        false
+                                                    ];
+                                                case 3:
+                                                    return [
+                                                        2
+                                                    ];
+                                            }
+                                        });
+                                    })();
+                                };
+                                if (!isAbsolute(search)) return [
+                                    3,
+                                    2
+                                ];
+                                return [
+                                    4,
+                                    _test(search)
+                                ];
+                            case 1:
+                                return [
+                                    2,
+                                    _state.sent() ? search : null
+                                ];
+                            case 2:
+                                dir = start;
+                                _state.label = 3;
+                            case 3:
+                                path = resolve(dir, search);
+                                return [
+                                    4,
+                                    _test(path)
+                                ];
+                            case 4:
+                                exists = _state.sent();
+                                if (exists) {
+                                    return [
+                                        2,
+                                        path
+                                    ];
+                                }
+                                dir = dir === stop ? "" : dirname(dir);
+                                _state.label = 5;
+                            case 5:
+                                if (dir.length) return [
+                                    3,
+                                    3
+                                ];
+                                _state.label = 6;
+                            case 6:
+                                return [
+                                    2,
+                                    null
+                                ];
+                        }
+                    });
+                })();
+            }
+        }
+    ]);
+    return ZFileSystemService;
+}();
+
+export { ZFileSystemNodeBuilder, ZFileSystemNodeType, ZFileSystemService };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/file-system/file-system-node.mts","../src/file-system/file-system-service.mts"],"sourcesContent":["import { isUndefined, omitBy } from \"lodash-es\";\n\n/**\n * Represents a type of a file system node.\n */\nexport enum ZFileSystemNodeType {\n  File = \"file\",\n  Folder = \"folder\",\n}\n\nexport interface IZFileSystemNode {\n  /**\n   * The absolute path of the node.\n   */\n  path: string;\n\n  /**\n   * The type of the node (file or folder).\n   */\n  type: ZFileSystemNodeType;\n\n  /**\n   * The creation date of the node.\n   */\n  created?: string;\n\n  /**\n   * The modification date of the node.\n   */\n  updated?: string;\n\n  /**\n   * The size of the node in bytes.\n   */\n  size?: bigint;\n}\n\n/**\n * Represents a builder for a file system node.\n */\nexport class ZFileSystemNodeBuilder {\n  private _node: IZFileSystemNode;\n\n  public constructor() {\n    this._node = {\n      path: \"/\",\n      type: ZFileSystemNodeType.Folder,\n    };\n  }\n\n  public created(at?: Date | string | undefined) {\n    this._node.created = at instanceof Date ? at.toJSON() : at;\n    return this;\n  }\n\n  public updated(at?: Date | string | undefined) {\n    this._node.updated = at instanceof Date ? at.toJSON() : at;\n    return this;\n  }\n\n  public size(bytes: bigint | number | undefined) {\n    this._node.size = typeof bytes == \"number\" ? BigInt(bytes) : bytes;\n    return this;\n  }\n\n  public path(path: string) {\n    this._node.path = path;\n    return this;\n  }\n\n  public type(type: ZFileSystemNodeType) {\n    this._node.type = type;\n    return this;\n  }\n\n  public file = this.type.bind(this, ZFileSystemNodeType.File);\n  public folder = this.type.bind(this, ZFileSystemNodeType.Folder);\n\n  public build() {\n    const clone = structuredClone(this._node);\n    return omitBy<IZFileSystemNode>(clone, isUndefined) as IZFileSystemNode;\n  }\n}\n","import { glob } from \"glob\";\nimport { access } from \"node:fs/promises\";\nimport { dirname, isAbsolute, resolve } from \"node:path\";\nimport { cwd } from \"node:process\";\nimport {\n  IZFileSystemNode,\n  ZFileSystemNodeBuilder,\n} from \"./file-system-node.mjs\";\n\n/**\n * Represents options for searches.\n */\nexport interface IZFileSystemSearchOptions {\n  /**\n   * The directory to search in.\n   *\n   * If this is not set, then the cwd of the application is used.\n   */\n  cwd?: string;\n}\n\n/**\n * Represents options for directory walking.\n */\nexport interface IZFileSystemWalkOptions {\n  /**\n   * The starting directory.\n   *\n   * The default is the current working directory\n   *\n   * @see process.cwd for more information.\n   */\n  start?: string;\n\n  /**\n   * The directory to stop at.\n   *\n   * The default is the root of the file system.\n   */\n  stop?: string;\n\n  /**\n   * The type of mode that the path must support in order\n   * to be approved.\n   *\n   * The default is undefined and left up to the node api.\n   */\n  mode?: number;\n}\n\n/**\n * Represents a service to enumerate the file system.\n */\nexport interface IZFileSystemService {\n  /**\n   * Gets information about a node.\n   *\n   * @param path -\n   *        The path to get information for.\n   *\n   * @returns\n   *        Information about the node.\n   */\n  info(path: string): Promise<IZFileSystemNode>;\n\n  /**\n   * Reads all nodes that match a pattern.\n   *\n   * @param pattern -\n   *        The pattern string to match against.\n   * @param options -\n   *        The options for the search.\n   *\n   * @returns\n   *        A list of path strings that match the given patterns.\n   */\n  search(\n    pattern: string,\n    options?: IZFileSystemSearchOptions,\n  ): Promise<IZFileSystemNode[]>;\n\n  /**\n   * Walks up a directory tree to search for existence of a given path.\n   *\n   * @param search -\n   *        The path to search for.  This is the candidate folder path that\n   *        may or may not exist somewhere from the start directory all the\n   *        way up the directory tree.\n   * @param options -\n   *        The given options for the search.\n   *\n   * @returns\n   *        The fully qualified path to the first path that matches the search\n   *        starting at the options start or the current working directory if not\n   *        specified.  Returns null if no such directory exists.\n   *\n   * @example\n   *\n   * ```ts\n   * import { resolve } from 'path'\n   *\n   * // Find any folder named .vscode from the current working directory all the way\n   * // up the directory tree.  Returns null if no vscode directory can be found.\n   * const service = new ZFileSystemService();\n   * const vscode = service.walk('.vscode');\n   *\n   * // Walk the directory tree from the current script and find the .config folder.\n   * const config = service.walk('.config', { start: __dirname });\n   *\n   * // Walk the directory tree from the current script and stop when we reach\n   * // at most 2 directories up.\n   * const start = __dirname;\n   * const stop = resolve(__dirname, '../..');\n   * const file = service.walk('path/to/file.json', { start, stop });\n   * ```\n   */\n  walk(\n    search: string,\n    options?: IZFileSystemWalkOptions,\n  ): Promise<string | null>;\n}\n\n/**\n * Represents a node implementation of a file system service.\n */\nexport class ZFileSystemService implements IZFileSystemService {\n  public async info(path: string): Promise<IZFileSystemNode> {\n    const [file] = await this.search(path);\n    return file;\n  }\n\n  public async search(\n    pattern: string | string[],\n    options?: IZFileSystemSearchOptions,\n  ): Promise<IZFileSystemNode[]> {\n    const paths = await glob(pattern, {\n      ...options,\n      stat: true,\n      withFileTypes: true,\n    });\n\n    return paths.map((path) => {\n      let info = new ZFileSystemNodeBuilder()\n        .path(path.fullpath())\n        .created(path.birthtime)\n        .updated(path.atime)\n        .size(path.size);\n\n      // Note that for folders, node will return the size of the underlying OS metadata,\n      // hence, why we 0 out the size on a folder here.\n      info = path.isFile() ? info.file() : info.folder().size(undefined);\n\n      return info.build();\n    });\n  }\n\n  public async walk(search: string, options?: IZFileSystemWalkOptions) {\n    const start = options?.start || cwd();\n    const stop = options?.stop || \"/\";\n    const mode = options?.mode;\n\n    const _test = async (path: string) => {\n      try {\n        await access(path, mode);\n        return true;\n      } catch {\n        return false;\n      }\n    };\n\n    if (isAbsolute(search)) {\n      return (await _test(search)) ? search : null;\n    }\n\n    let dir = start;\n    do {\n      const path = resolve(dir, search);\n      const exists = await _test(path);\n\n      if (exists) {\n        return path;\n      }\n\n      dir = dir === stop ? \"\" : dirname(dir);\n    } while (dir.length);\n\n    return null;\n  }\n}\n"],"names":["ZFileSystemNodeType"],"mappings":";;;;;AAKY,IAAA,wCAAAA,yBAAL;AACLA,uBAAA,MAAO,IAAA;AACPA,uBAAA,QAAS,IAAA;AAFCA,SAAAA;AAAA,GAAA,uBAAA,CAAA,CAAA;AAmCL,MAAM,uBAAuB;AAAA,EAG3B,cAAc;AAgCrB,SAAO,OAAO,KAAK,KAAK;AAAA,MAAK;AAAA,MAAM;AAAA;AAAA,IAAwB;AAC3D,SAAO,SAAS,KAAK,KAAK;AAAA,MAAK;AAAA,MAAM;AAAA;AAAA,IAA0B;AAhC7D,SAAK,QAAQ;AAAA,MACX,MAAM;AAAA,MACN,MAAM;AAAA;AAAA,IACR;AAAA,EAAA;AAAA,EAGK,QAAQ,IAAgC;AAC7C,SAAK,MAAM,UAAU,cAAc,OAAO,GAAG,WAAW;AACjD,WAAA;AAAA,EAAA;AAAA,EAGF,QAAQ,IAAgC;AAC7C,SAAK,MAAM,UAAU,cAAc,OAAO,GAAG,WAAW;AACjD,WAAA;AAAA,EAAA;AAAA,EAGF,KAAK,OAAoC;AAC9C,SAAK,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,KAAK,IAAI;AACtD,WAAA;AAAA,EAAA;AAAA,EAGF,KAAK,MAAc;AACxB,SAAK,MAAM,OAAO;AACX,WAAA;AAAA,EAAA;AAAA,EAGF,KAAK,MAA2B;AACrC,SAAK,MAAM,OAAO;AACX,WAAA;AAAA,EAAA;AAAA,EAMF,QAAQ;AACP,UAAA,QAAQ,gBAAgB,KAAK,KAAK;AACjC,WAAA,OAAyB,OAAO,WAAW;AAAA,EAAA;AAEtD;AC2CO,MAAM,mBAAkD;AAAA,EAC7D,MAAa,KAAK,MAAyC;AACzD,UAAM,CAAC,IAAI,IAAI,MAAM,KAAK,OAAO,IAAI;AAC9B,WAAA;AAAA,EAAA;AAAA,EAGT,MAAa,OACX,SACA,SAC6B;AACvB,UAAA,QAAQ,MAAM,KAAK,SAAS;AAAA,MAChC,GAAG;AAAA,MACH,MAAM;AAAA,MACN,eAAe;AAAA,IAAA,CAChB;AAEM,WAAA,MAAM,IAAI,CAAC,SAAS;AACzB,UAAI,OAAO,IAAI,yBACZ,KAAK,KAAK,SAAU,CAAA,EACpB,QAAQ,KAAK,SAAS,EACtB,QAAQ,KAAK,KAAK,EAClB,KAAK,KAAK,IAAI;AAIV,aAAA,KAAK,OAAO,IAAI,KAAK,SAAS,KAAK,OAAA,EAAS,KAAK,MAAS;AAEjE,aAAO,KAAK,MAAM;AAAA,IAAA,CACnB;AAAA,EAAA;AAAA,EAGH,MAAa,KAAK,QAAgB,SAAmC;AAC7D,UAAA,SAAQ,mCAAS,UAAS,IAAI;AAC9B,UAAA,QAAO,mCAAS,SAAQ;AAC9B,UAAM,OAAO,mCAAS;AAEhB,UAAA,QAAQ,OAAO,SAAiB;AAChC,UAAA;AACI,cAAA,OAAO,MAAM,IAAI;AAChB,eAAA;AAAA,MAAA,QACD;AACC,eAAA;AAAA,MAAA;AAAA,IAEX;AAEI,QAAA,WAAW,MAAM,GAAG;AACtB,aAAQ,MAAM,MAAM,MAAM,IAAK,SAAS;AAAA,IAAA;AAG1C,QAAI,MAAM;AACP,OAAA;AACK,YAAA,OAAO,QAAQ,KAAK,MAAM;AAC1B,YAAA,SAAS,MAAM,MAAM,IAAI;AAE/B,UAAI,QAAQ;AACH,eAAA;AAAA,MAAA;AAGT,YAAM,QAAQ,OAAO,KAAK,QAAQ,GAAG;AAAA,aAC9B,IAAI;AAEN,WAAA;AAAA,EAAA;AAEX;"}
+{"version":3,"file":"index.js","sources":["../src/file-system/file-system-node.mts","../src/file-system/file-system-service.mts"],"sourcesContent":["import { isUndefined, omitBy } from \"lodash-es\";\n\n/**\n * Represents a type of a file system node.\n */\nexport enum ZFileSystemNodeType {\n  File = \"file\",\n  Folder = \"folder\",\n}\n\nexport interface IZFileSystemNode {\n  /**\n   * The absolute path of the node.\n   */\n  path: string;\n\n  /**\n   * The type of the node (file or folder).\n   */\n  type: ZFileSystemNodeType;\n\n  /**\n   * The creation date of the node.\n   */\n  created?: string;\n\n  /**\n   * The modification date of the node.\n   */\n  updated?: string;\n\n  /**\n   * The size of the node in bytes.\n   */\n  size?: bigint;\n}\n\n/**\n * Represents a builder for a file system node.\n */\nexport class ZFileSystemNodeBuilder {\n  private _node: IZFileSystemNode;\n\n  public constructor() {\n    this._node = {\n      path: \"/\",\n      type: ZFileSystemNodeType.Folder,\n    };\n  }\n\n  public created(at?: Date | string | undefined) {\n    this._node.created = at instanceof Date ? at.toJSON() : at;\n    return this;\n  }\n\n  public updated(at?: Date | string | undefined) {\n    this._node.updated = at instanceof Date ? at.toJSON() : at;\n    return this;\n  }\n\n  public size(bytes: bigint | number | undefined) {\n    this._node.size = typeof bytes == \"number\" ? BigInt(bytes) : bytes;\n    return this;\n  }\n\n  public path(path: string) {\n    this._node.path = path;\n    return this;\n  }\n\n  public type(type: ZFileSystemNodeType) {\n    this._node.type = type;\n    return this;\n  }\n\n  public file = this.type.bind(this, ZFileSystemNodeType.File);\n  public folder = this.type.bind(this, ZFileSystemNodeType.Folder);\n\n  public build() {\n    const clone = structuredClone(this._node);\n    return omitBy<IZFileSystemNode>(clone, isUndefined) as IZFileSystemNode;\n  }\n}\n","import { glob } from \"glob\";\nimport { access } from \"node:fs/promises\";\nimport { dirname, isAbsolute, resolve } from \"node:path\";\nimport { cwd } from \"node:process\";\nimport type { IZFileSystemNode } from \"./file-system-node.mjs\";\nimport { ZFileSystemNodeBuilder } from \"./file-system-node.mjs\";\n\n/**\n * Represents options for searches.\n */\nexport interface IZFileSystemSearchOptions {\n  /**\n   * The directory to search in.\n   *\n   * If this is not set, then the cwd of the application is used.\n   */\n  cwd?: string;\n}\n\n/**\n * Represents options for directory walking.\n */\nexport interface IZFileSystemWalkOptions {\n  /**\n   * The starting directory.\n   *\n   * The default is the current working directory\n   *\n   * @see process.cwd for more information.\n   */\n  start?: string;\n\n  /**\n   * The directory to stop at.\n   *\n   * The default is the root of the file system.\n   */\n  stop?: string;\n\n  /**\n   * The type of mode that the path must support in order\n   * to be approved.\n   *\n   * The default is undefined and left up to the node api.\n   */\n  mode?: number;\n}\n\n/**\n * Represents a service to enumerate the file system.\n */\nexport interface IZFileSystemService {\n  /**\n   * Gets information about a node.\n   *\n   * @param path -\n   *        The path to get information for.\n   *\n   * @returns\n   *        Information about the node.\n   */\n  info(path: string): Promise<IZFileSystemNode>;\n\n  /**\n   * Reads all nodes that match a pattern.\n   *\n   * @param pattern -\n   *        The pattern string to match against.\n   * @param options -\n   *        The options for the search.\n   *\n   * @returns\n   *        A list of path strings that match the given patterns.\n   */\n  search(\n    pattern: string,\n    options?: IZFileSystemSearchOptions,\n  ): Promise<IZFileSystemNode[]>;\n\n  /**\n   * Walks up a directory tree to search for existence of a given path.\n   *\n   * @param search -\n   *        The path to search for.  This is the candidate folder path that\n   *        may or may not exist somewhere from the start directory all the\n   *        way up the directory tree.\n   * @param options -\n   *        The given options for the search.\n   *\n   * @returns\n   *        The fully qualified path to the first path that matches the search\n   *        starting at the options start or the current working directory if not\n   *        specified.  Returns null if no such directory exists.\n   *\n   * @example\n   *\n   * ```ts\n   * import { resolve } from 'path'\n   *\n   * // Find any folder named .vscode from the current working directory all the way\n   * // up the directory tree.  Returns null if no vscode directory can be found.\n   * const service = new ZFileSystemService();\n   * const vscode = service.walk('.vscode');\n   *\n   * // Walk the directory tree from the current script and find the .config folder.\n   * const config = service.walk('.config', { start: __dirname });\n   *\n   * // Walk the directory tree from the current script and stop when we reach\n   * // at most 2 directories up.\n   * const start = __dirname;\n   * const stop = resolve(__dirname, '../..');\n   * const file = service.walk('path/to/file.json', { start, stop });\n   * ```\n   */\n  walk(\n    search: string,\n    options?: IZFileSystemWalkOptions,\n  ): Promise<string | null>;\n}\n\n/**\n * Represents a node implementation of a file system service.\n */\nexport class ZFileSystemService implements IZFileSystemService {\n  public async info(path: string): Promise<IZFileSystemNode> {\n    const [file] = await this.search(path);\n    return file;\n  }\n\n  public async search(\n    pattern: string | string[],\n    options?: IZFileSystemSearchOptions,\n  ): Promise<IZFileSystemNode[]> {\n    const paths = await glob(pattern, {\n      ...options,\n      stat: true,\n      withFileTypes: true,\n    });\n\n    return paths.map((path) => {\n      let info = new ZFileSystemNodeBuilder()\n        .path(path.fullpath())\n        .created(path.birthtime)\n        .updated(path.atime)\n        .size(path.size);\n\n      // Note that for folders, node will return the size of the underlying OS metadata,\n      // hence, why we 0 out the size on a folder here.\n      info = path.isFile() ? info.file() : info.folder().size(undefined);\n\n      return info.build();\n    });\n  }\n\n  public async walk(search: string, options?: IZFileSystemWalkOptions) {\n    const start = options?.start || cwd();\n    const stop = options?.stop || \"/\";\n    const mode = options?.mode;\n\n    const _test = async (path: string) => {\n      try {\n        await access(path, mode);\n        return true;\n      } catch {\n        return false;\n      }\n    };\n\n    if (isAbsolute(search)) {\n      return (await _test(search)) ? search : null;\n    }\n\n    let dir = start;\n    do {\n      const path = resolve(dir, search);\n      const exists = await _test(path);\n\n      if (exists) {\n        return path;\n      }\n\n      dir = dir === stop ? \"\" : dirname(dir);\n    } while (dir.length);\n\n    return null;\n  }\n}\n"],"names":["ZFileSystemNodeType","ZFileSystemNodeBuilder","_define_property","_node","file","type","bind","folder","path","created","at","Date","toJSON","updated","size","bytes","BigInt","build","clone","structuredClone","omitBy","isUndefined","ZFileSystemService","info","search","pattern","options","paths","glob","stat","withFileTypes","map","fullpath","birthtime","atime","isFile","undefined","walk","start","stop","mode","_test","dir","exists","cwd","access","isAbsolute","resolve","dirname","length"],"mappings":"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"}