@photostructure/fs-metadata 0.1.2 → 0.1.3

package/dist/cjs/exports.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumeHealthStatuses = exports.TimeoutMsDefault = exports.SystemPathPatternsDefault = exports.SystemFsTypesDefault = exports.optionsWithDefaults = exports.OptionsDefault = exports.LinuxMountTablePathsDefault = exports.IncludeSystemVolumesDefault = void 0;
+const options_js_1 = require("./options.js");
+Object.defineProperty(exports, "IncludeSystemVolumesDefault", { enumerable: true, get: function () { return options_js_1.IncludeSystemVolumesDefault; } });
+Object.defineProperty(exports, "LinuxMountTablePathsDefault", { enumerable: true, get: function () { return options_js_1.LinuxMountTablePathsDefault; } });
+Object.defineProperty(exports, "OptionsDefault", { enumerable: true, get: function () { return options_js_1.OptionsDefault; } });
+Object.defineProperty(exports, "optionsWithDefaults", { enumerable: true, get: function () { return options_js_1.optionsWithDefaults; } });
+Object.defineProperty(exports, "SystemFsTypesDefault", { enumerable: true, get: function () { return options_js_1.SystemFsTypesDefault; } });
+Object.defineProperty(exports, "SystemPathPatternsDefault", { enumerable: true, get: function () { return options_js_1.SystemPathPatternsDefault; } });
+Object.defineProperty(exports, "TimeoutMsDefault", { enumerable: true, get: function () { return options_js_1.TimeoutMsDefault; } });
+const volume_health_status_js_1 = require("./volume_health_status.js");
+Object.defineProperty(exports, "VolumeHealthStatuses", { enumerable: true, get: function () { return volume_health_status_js_1.VolumeHealthStatuses; } });
+//# sourceMappingURL=exports.js.map

package/dist/cjs/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../src/exports.ts"],"names":[],"mappings":";;;AAGA,6CAQsB;AAqIpB,4GA5IA,wCAA2B,OA4IA;AAC3B,4GA5IA,wCAA2B,OA4IA;AAC3B,+FA5IA,2BAAc,OA4IA;AACd,oGA5IA,gCAAmB,OA4IA;AACnB,qGA5IA,iCAAoB,OA4IA;AACpB,0GA5IA,sCAAyB,OA4IA;AACzB,iGA5IA,6BAAgB,OA4IA;AAnIlB,uEAAiE;AAoI/D,qGApIO,8CAAoB,OAoIP"}

package/dist/cjs/fs.d.ts

@@ -0,0 +1,23 @@
+import { type PathLike, type StatOptions, Stats } from "node:fs";
+/**
+ * Wrapping node:fs/promises.stat() so we can mock it in tests.
+ */
+export declare function statAsync(path: PathLike, options?: StatOptions & {
+    bigint?: false;
+}): Promise<Stats>;
+export declare function canStatAsync(path: string): Promise<boolean>;
+/**
+ * @return true if `path` exists and is a directory
+ */
+export declare function isDirectory(path: string): Promise<boolean>;
+/**
+ * @return the first directory containing `file` or an empty string
+ */
+export declare function findAncestorDir(dir: string, file: string): Promise<string | undefined>;
+export declare function existsSync(path: string): boolean;
+/**
+ * @return `true` if `dir` exists and is a directory and at least one entry can be read.
+ * @throws {Error} if `dir` does not exist or is not a directory or cannot be read.
+ */
+export declare function canReaddir(dir: string, timeoutMs: number): Promise<true>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/cjs/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/fs.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,EAEN,MAAM,SAAS,CAAC;AAKjB;;GAEG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GACzC,OAAO,CAAC,KAAK,CAAC,CAEhB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMjE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMhE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/cjs/fs.js

@@ -0,0 +1,81 @@
+"use strict";
+// src/fs.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statAsync = statAsync;
+exports.canStatAsync = canStatAsync;
+exports.isDirectory = isDirectory;
+exports.findAncestorDir = findAncestorDir;
+exports.existsSync = existsSync;
+exports.canReaddir = canReaddir;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const async_js_1 = require("./async.js");
+/**
+ * Wrapping node:fs/promises.stat() so we can mock it in tests.
+ */
+async function statAsync(path, options) {
+    return (0, promises_1.stat)(path, options);
+}
+async function canStatAsync(path) {
+    try {
+        return null != (await statAsync(path));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * @return true if `path` exists and is a directory
+ */
+async function isDirectory(path) {
+    try {
+        return (await statAsync(path))?.isDirectory() === true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * @return the first directory containing `file` or an empty string
+ */
+async function findAncestorDir(dir, file) {
+    dir = (0, node_path_1.resolve)(dir);
+    try {
+        const s = await statAsync((0, node_path_1.join)(dir, file));
+        if (s.isFile())
+            return dir;
+    }
+    catch {
+        // fall through
+    }
+    const parent = (0, node_path_1.resolve)(dir, "..");
+    return parent === dir ? undefined : findAncestorDir(parent, file);
+}
+function existsSync(path) {
+    return (0, node_fs_1.statSync)(path, { throwIfNoEntry: false }) != null;
+}
+/**
+ * @return `true` if `dir` exists and is a directory and at least one entry can be read.
+ * @throws {Error} if `dir` does not exist or is not a directory or cannot be read.
+ */
+async function canReaddir(dir, timeoutMs) {
+    return (0, async_js_1.withTimeout)({
+        desc: "canReaddir()",
+        promise: _canReaddir(dir),
+        timeoutMs,
+    });
+}
+async function _canReaddir(dir) {
+    let d = undefined;
+    try {
+        d = await (0, promises_1.opendir)(dir);
+        await d.read();
+        return true;
+    }
+    finally {
+        if (d != null)
+            void d.close();
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/cjs/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/fs.ts"],"names":[],"mappings":";AAAA,YAAY;;AAgBZ,8BAKC;AAED,oCAMC;AAKD,kCAMC;AAKD,0CAaC;AAED,gCAEC;AAMD,gCASC;AA3ED,qCAMiB;AACjB,+CAAiD;AACjD,yCAA0C;AAC1C,yCAAyC;AAEzC;;GAEG;AACI,KAAK,UAAU,SAAS,CAC7B,IAAc,EACd,OAA0C;IAE1C,OAAO,IAAA,eAAI,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,IAAY;IAEZ,GAAG,GAAG,IAAA,mBAAO,EAAC,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,MAAM,EAAE;YAAE,OAAO,GAAG,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,IAAA,mBAAO,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,IAAA,kBAAQ,EAAC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,SAAiB;IAEjB,OAAO,IAAA,sBAAW,EAAC;QACjB,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC;QACzB,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,GAAW;IACpC,IAAI,CAAC,GAAoB,SAAS,CAAC;IACnC,IAAI,CAAC;QACH,CAAC,GAAG,MAAM,IAAA,kBAAO,EAAC,GAAG,CAAC,CAAC;QACvB,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,IAAI,IAAI;YAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/cjs/glob.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Compiles an array of glob patterns into a single regular expression.
+ *
+ * The function supports the following patterns:
+ * - `**` matches any number of directories.
+ * - `*` matches any number of characters except for `/`.
+ * - `?` matches exactly one character except for `/`.
+ * - `.` is escaped to match a literal period.
+ * - `/` at the end of the pattern matches either a slash or the end of the string.
+ * - Other regex special characters are escaped.
+ *
+ * @param patterns - An array of glob patterns to compile.
+ * @returns A `RegExp` object that matches any of the provided patterns.
+ */
+export declare function compileGlob(patterns: string[] | readonly string[] | undefined): RegExp;
+export declare const AlwaysMatchRE: RegExp;
+export declare const NeverMatchRE: RegExp;
+//# sourceMappingURL=glob.d.ts.map

package/dist/cjs/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/glob.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,GACjD,MAAM,CA+BR;AAuED,eAAO,MAAM,aAAa,QAAS,CAAC;AACpC,eAAO,MAAM,YAAY,QAAS,CAAC"}

package/dist/cjs/glob.js

@@ -0,0 +1,117 @@
+"use strict";
+// src/glob.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NeverMatchRE = exports.AlwaysMatchRE = void 0;
+exports.compileGlob = compileGlob;
+const platform_js_1 = require("./platform.js");
+const string_js_1 = require("./string.js");
+const cache = new Map();
+/**
+ * Compiles an array of glob patterns into a single regular expression.
+ *
+ * The function supports the following patterns:
+ * - `**` matches any number of directories.
+ * - `*` matches any number of characters except for `/`.
+ * - `?` matches exactly one character except for `/`.
+ * - `.` is escaped to match a literal period.
+ * - `/` at the end of the pattern matches either a slash or the end of the string.
+ * - Other regex special characters are escaped.
+ *
+ * @param patterns - An array of glob patterns to compile.
+ * @returns A `RegExp` object that matches any of the provided patterns.
+ */
+function compileGlob(patterns) {
+    if (patterns == null || patterns.length === 0) {
+        return exports.NeverMatchRE;
+    }
+    const patternsKey = JSON.stringify(patterns);
+    {
+        const prior = cache.get(patternsKey);
+        if (prior != null) {
+            return prior;
+        }
+    }
+    const sorted = patterns.slice().filter(string_js_1.isNotBlank).sort();
+    const sortedKey = JSON.stringify(sorted);
+    {
+        const prior = cache.get(sortedKey);
+        if (prior != null) {
+            cache.set(patternsKey, prior);
+            return prior;
+        }
+    }
+    const result = _compileGlob(sorted);
+    if (cache.size > 256) {
+        // avoid unbounded memory usage
+        cache.clear();
+    }
+    cache.set(patternsKey, result);
+    cache.set(sortedKey, result);
+    return result;
+}
+function _compileGlob(patterns) {
+    const regexPatterns = patterns.map((pattern) => {
+        let regex = "";
+        let i = 0;
+        while (i < pattern.length) {
+            // Handle '**' pattern
+            if (pattern[i] === "*" && pattern[i + 1] === "*") {
+                regex += ".*";
+                i += 2;
+                if (pattern[i] === "/") {
+                    i++; // Skip the slash after **
+                }
+                continue;
+            }
+            // Handle single '*' pattern
+            if (pattern[i] === "*") {
+                regex += "[^/]*";
+                i++;
+                continue;
+            }
+            // Handle '?' pattern
+            if (pattern[i] === "?") {
+                regex += "[^/]";
+                i++;
+                continue;
+            }
+            // Handle period
+            if (pattern[i] === ".") {
+                regex += "\\.";
+                i++;
+                continue;
+            }
+            // Handle end of directory pattern
+            if (pattern[i] === "/") {
+                if (i === pattern.length - 1) {
+                    regex += "(?:/|$)";
+                    i++;
+                    continue;
+                }
+                else if (platform_js_1.isWindows) {
+                    regex += "[\\/\\\\]";
+                    i++;
+                    continue;
+                }
+            }
+            // Escape other regex special characters
+            if (/[+^${}()|[\]\\]/.test(pattern[i])) {
+                regex += "\\" + pattern[i];
+                i++;
+                continue;
+            }
+            // Add other characters as-is
+            regex += pattern[i];
+            i++;
+        }
+        return regex;
+    });
+    const final = regexPatterns.filter((ea) => ea.length > 0);
+    return final.length === 0
+        ? // Empty pattern matches nothing
+            exports.NeverMatchRE // Case insensitive for Windows paths
+        : new RegExp(`^(?:${final.join("|")})$`, "i");
+}
+exports.AlwaysMatchRE = /(?:)/;
+exports.NeverMatchRE = /(?!)/;
+//# sourceMappingURL=glob.js.map

package/dist/cjs/glob.js.map

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

package/dist/cjs/hidden.d.ts

@@ -0,0 +1,67 @@
+import type { NativeBindingsFn } from "./types/native_bindings.js";
+/**
+ * Represents the detailed state of a file or directory's hidden attribute
+ */
+export interface HiddenMetadata {
+    /**
+     * Whether the item is considered hidden by any method
+     */
+    hidden: boolean;
+    /**
+     * Whether the item has a dot prefix (POSIX-style hidden). Windows doesn't
+     * care about dot prefixes.
+     */
+    dotPrefix: boolean;
+    /**
+     * Whether the item has system hidden flags set, like via `chflags` on macOS
+     * or on Windows via `GetFileAttributesW`
+     */
+    systemFlag: boolean;
+    /**
+     * Indicates which hiding methods are supported on the current platform
+     */
+    supported: {
+        /**
+         * Whether dot prefix hiding is supported on the current operating system
+         */
+        dotPrefix: boolean;
+        /**
+         * Whether system flag hiding is supported
+         */
+        systemFlag: boolean;
+    };
+}
+export declare const LocalSupport: {
+    /**
+     * Whether dot prefix hiding is supported on the current operating system
+     */
+    dotPrefix: boolean;
+    /**
+     * Whether system flag hiding is supported
+     */
+    systemFlag: boolean;
+};
+/**
+ * Checks if the file or directory is hidden through any available method
+ * @returns A boolean indicating if the item is hidden
+ * @throws {Error} If the file doesn't exist or permissions are insufficient
+ */
+export declare function isHidden(pathname: string, nativeFn: NativeBindingsFn): Promise<boolean>;
+export declare function isHiddenRecursive(path: string, nativeFn: NativeBindingsFn): Promise<boolean>;
+export declare function createHiddenPosixPath(pathname: string, hidden: boolean): string;
+/**
+ * Gets detailed information about the hidden state of the file or directory
+ * @returns An object containing detailed hidden state information
+ * @throws {Error} If the file doesn't exist or permissions are insufficient
+ */
+export declare function getHiddenMetadata(pathname: string, nativeFn: NativeBindingsFn): Promise<HiddenMetadata>;
+export type HideMethod = "dotPrefix" | "systemFlag" | "all" | "auto";
+export type SetHiddenResult = {
+    pathname: string;
+    actions: {
+        dotPrefix: boolean;
+        systemFlag: boolean;
+    };
+};
+export declare function setHidden(pathname: string, hide: boolean, method: HideMethod, nativeFn: NativeBindingsFn): Promise<SetHiddenResult>;
+//# sourceMappingURL=hidden.d.ts.map

package/dist/cjs/hidden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hidden.d.ts","sourceRoot":"","sources":["../../src/hidden.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE;QACT;;WAEG;QACH,SAAS,EAAE,OAAO,CAAC;QAEnB;;WAEG;QACH,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAyBD,eAAO,MAAM,YAAY;IAnCrB;;OAEG;eACQ,OAAO;IAElB;;OAEG;gBACS,OAAO;CA+BtB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CASlB;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,UAStE;AAyCD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,CAazB;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,KAAK,GAAG,MAAM,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QACP,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;CACH,CAAC;AAEF,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CAgD1B"}

package/dist/cjs/hidden.js

@@ -0,0 +1,163 @@
+"use strict";
+// src/hidden.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalSupport = void 0;
+exports.isHidden = isHidden;
+exports.isHiddenRecursive = isHiddenRecursive;
+exports.createHiddenPosixPath = createHiddenPosixPath;
+exports.getHiddenMetadata = getHiddenMetadata;
+exports.setHidden = setHidden;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const error_js_1 = require("./error.js");
+const fs_js_1 = require("./fs.js");
+const path_js_1 = require("./path.js");
+const platform_js_1 = require("./platform.js");
+const HiddenSupportByPlatform = {
+    win32: {
+        supported: {
+            dotPrefix: false,
+            systemFlag: true,
+        },
+    },
+    darwin: {
+        supported: {
+            dotPrefix: true,
+            systemFlag: true,
+        },
+    },
+    linux: {
+        supported: {
+            dotPrefix: true,
+            systemFlag: false,
+        },
+    },
+};
+exports.LocalSupport = HiddenSupportByPlatform[process.platform]
+    ?.supported ?? {
+    dotPrefix: false,
+    systemFlag: false,
+};
+/**
+ * Checks if the file or directory is hidden through any available method
+ * @returns A boolean indicating if the item is hidden
+ * @throws {Error} If the file doesn't exist or permissions are insufficient
+ */
+async function isHidden(pathname, nativeFn) {
+    const norm = (0, path_js_1.normalizePath)(pathname);
+    if (norm == null) {
+        throw new Error("Invalid pathname: " + JSON.stringify(pathname));
+    }
+    return ((exports.LocalSupport.dotPrefix && isPosixHidden(norm)) ||
+        (exports.LocalSupport.systemFlag && isSystemHidden(norm, nativeFn)));
+}
+async function isHiddenRecursive(path, nativeFn) {
+    let norm = (0, path_js_1.normalizePath)(path);
+    if (norm == null) {
+        throw new Error("Invalid path: " + JSON.stringify(path));
+    }
+    while (!(0, path_js_1.isRootDirectory)(norm)) {
+        if (await isHidden(norm, nativeFn)) {
+            return true;
+        }
+        norm = (0, node_path_1.dirname)(norm);
+    }
+    return false;
+}
+function createHiddenPosixPath(pathname, hidden) {
+    const norm = (0, path_js_1.normalizePath)(pathname);
+    if (norm == null) {
+        throw new Error("Invalid pathname: " + JSON.stringify(pathname));
+    }
+    const dir = (0, node_path_1.dirname)(norm);
+    const srcBase = (0, node_path_1.basename)(norm).replace(/^\./, "");
+    const dest = (0, node_path_1.join)(dir, (hidden ? "." : "") + srcBase);
+    return dest;
+}
+async function setHiddenPosix(pathname, hidden) {
+    if (exports.LocalSupport.dotPrefix) {
+        const dest = createHiddenPosixPath(pathname, hidden);
+        if (pathname !== dest)
+            await (0, promises_1.rename)(pathname, dest);
+        return dest;
+    }
+    throw new Error("Unsupported platform");
+}
+function isPosixHidden(pathname) {
+    if (!exports.LocalSupport.dotPrefix)
+        return false;
+    const b = (0, node_path_1.basename)(pathname);
+    return b.startsWith(".") && b !== "." && b !== "..";
+}
+async function isSystemHidden(pathname, nativeFn) {
+    if (!exports.LocalSupport.systemFlag) {
+        // not supported on this platform
+        return false;
+    }
+    if (platform_js_1.isWindows && (0, path_js_1.isRootDirectory)(pathname)) {
+        // windows `attr` thinks all drive letters don't exist.
+        return false;
+    }
+    // don't bother the native bindings if the file doesn't exist:
+    return ((await (0, fs_js_1.canStatAsync)(pathname)) &&
+        (await (await nativeFn()).isHidden(pathname)));
+}
+/**
+ * Gets detailed information about the hidden state of the file or directory
+ * @returns An object containing detailed hidden state information
+ * @throws {Error} If the file doesn't exist or permissions are insufficient
+ */
+async function getHiddenMetadata(pathname, nativeFn) {
+    const norm = (0, path_js_1.normalizePath)(pathname);
+    if (norm == null) {
+        throw new Error("Invalid pathname: " + JSON.stringify(pathname));
+    }
+    const dotPrefix = isPosixHidden(norm);
+    const systemFlag = await isSystemHidden(norm, nativeFn);
+    return {
+        hidden: dotPrefix || systemFlag,
+        dotPrefix,
+        systemFlag,
+        supported: exports.LocalSupport,
+    };
+}
+async function setHidden(pathname, hide, method, nativeFn) {
+    let norm = (0, path_js_1.normalizePath)(pathname);
+    if (norm == null) {
+        throw new Error("Invalid pathname: " + JSON.stringify(pathname));
+    }
+    if (method === "dotPrefix" && !exports.LocalSupport.dotPrefix) {
+        throw new Error("Dot prefix hiding is not supported on this platform");
+    }
+    if (method === "systemFlag" && !exports.LocalSupport.systemFlag) {
+        throw new Error("System flag hiding is not supported on this platform");
+    }
+    try {
+        await (0, fs_js_1.statAsync)(norm);
+    }
+    catch (cause) {
+        throw new error_js_1.WrappedError("setHidden()", { cause });
+    }
+    if (platform_js_1.isWindows && (0, path_js_1.isRootDirectory)(norm)) {
+        throw new Error("Cannot hide root directory on Windows");
+    }
+    const actions = {
+        dotPrefix: false,
+        systemFlag: false,
+    };
+    let acted = false;
+    if (exports.LocalSupport.dotPrefix && ["auto", "all", "dotPrefix"].includes(method)) {
+        if (isPosixHidden(norm) !== hide) {
+            norm = await setHiddenPosix(norm, hide);
+            actions.dotPrefix = true;
+        }
+        acted = true;
+    }
+    if (exports.LocalSupport.systemFlag &&
+        (["all", "systemFlag"].includes(method) || (!acted && method === "auto"))) {
+        await (await nativeFn()).setHidden(norm, hide);
+        actions.systemFlag = true;
+    }
+    return { pathname: norm, actions };
+}
+//# sourceMappingURL=hidden.js.map

package/dist/cjs/hidden.js.map

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

package/dist/cjs/index.cjs

@@ -0,0 +1,23 @@
+"use strict";
+// src/index.cts
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setHidden = exports.getHiddenMetadata = exports.isHiddenRecursive = exports.isHidden = exports.getAllVolumeMetadata = exports.getVolumeMetadata = exports.getVolumeMountPoints = void 0;
+const setup_js_1 = require("./setup.js");
+__exportStar(require("./exports.js"), exports);
+_a = (0, setup_js_1.setup)(__dirname), exports.getVolumeMountPoints = _a.getVolumeMountPoints, exports.getVolumeMetadata = _a.getVolumeMetadata, exports.getAllVolumeMetadata = _a.getAllVolumeMetadata, exports.isHidden = _a.isHidden, exports.isHiddenRecursive = _a.isHiddenRecursive, exports.getHiddenMetadata = _a.getHiddenMetadata, exports.setHidden = _a.setHidden;
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/index.cts"],"names":[],"mappings":";AAAA,gBAAgB;;;;;;;;;;;;;;;;;;AAEhB,yCAAmC;AAEnC,+CAA6B;AAEhB,KAQT,IAAA,gBAAK,EAAC,SAAS,CAAC,EAPlB,4BAAoB,4BACpB,yBAAiB,yBACjB,4BAAoB,4BACpB,gBAAQ,gBACR,yBAAiB,yBACjB,yBAAiB,yBACjB,iBAAS,gBACU"}

package/dist/cjs/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/index.cts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAE7B,eAAO,MACL,oBAAoB,sDACpB,iBAAiB,mDACjB,oBAAoB,sDACpB,QAAQ,0CACR,iBAAiB,mDACjB,iBAAiB,mDACjB,SAAS,yCACS,CAAC"}

package/dist/cjs/linux/dev_disk.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Gets the UUID from symlinks for a given device path asynchronously
+ * @param devicePath The device path to look up
+ * @returns Promise that resolves to the UUID if found, empty string otherwise
+ */
+export declare function getUuidFromDevDisk(devicePath: string): Promise<string | undefined>;
+/**
+ * Gets the label from symlinks for a given device path asynchronously
+ * @param devicePath The device path to look up
+ * @returns Promise that resolves to the label if found, empty string otherwise
+ */
+export declare function getLabelFromDevDisk(devicePath: string): Promise<string | undefined>;
+export declare function getBasenameLinkedTo(linkDir: string, linkPath: string): Promise<string | undefined>;
+//# sourceMappingURL=dev_disk.d.ts.map

package/dist/cjs/linux/dev_disk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev_disk.d.ts","sourceRoot":"","sources":["../../../src/linux/dev_disk.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,+BAY1D;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,+BAY3D;AAGD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B"}

package/dist/cjs/linux/dev_disk.js

@@ -0,0 +1,66 @@
+"use strict";
+// src/linux/dev_disk.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUuidFromDevDisk = getUuidFromDevDisk;
+exports.getLabelFromDevDisk = getLabelFromDevDisk;
+exports.getBasenameLinkedTo = getBasenameLinkedTo;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const debuglog_js_1 = require("../debuglog.js");
+const string_js_1 = require("../string.js");
+/**
+ * Gets the UUID from symlinks for a given device path asynchronously
+ * @param devicePath The device path to look up
+ * @returns Promise that resolves to the UUID if found, empty string otherwise
+ */
+async function getUuidFromDevDisk(devicePath) {
+    try {
+        const result = await getBasenameLinkedTo("/dev/disk/by-uuid", (0, node_path_1.resolve)(devicePath));
+        (0, debuglog_js_1.debug)("[getUuidFromDevDisk] result: %o", result);
+        return result;
+    }
+    catch (error) {
+        (0, debuglog_js_1.debug)("[getUuidFromDevDisk] failed: " + error);
+        return;
+    }
+}
+/**
+ * Gets the label from symlinks for a given device path asynchronously
+ * @param devicePath The device path to look up
+ * @returns Promise that resolves to the label if found, empty string otherwise
+ */
+async function getLabelFromDevDisk(devicePath) {
+    try {
+        const result = await getBasenameLinkedTo("/dev/disk/by-label", (0, node_path_1.resolve)(devicePath));
+        (0, debuglog_js_1.debug)("[getLabelFromDevDisk] result: %o", result);
+        return result;
+    }
+    catch (error) {
+        (0, debuglog_js_1.debug)("[getLabelFromDevDisk] failed: " + error);
+        return;
+    }
+}
+// only exposed for tests
+async function getBasenameLinkedTo(linkDir, linkPath) {
+    for await (const ea of readLinks(linkDir)) {
+        if (ea.linkTarget === linkPath) {
+            // Expect the symlink to be named like '1tb\x20\x28test\x29'
+            return (0, string_js_1.decodeEscapeSequences)(ea.dirent.name);
+        }
+    }
+    return;
+}
+async function* readLinks(directory) {
+    for (const dirent of await (0, promises_1.readdir)(directory, { withFileTypes: true })) {
+        if (dirent.isSymbolicLink()) {
+            try {
+                const linkTarget = (0, node_path_1.resolve)(directory, await (0, promises_1.readlink)((0, node_path_1.join)(directory, dirent.name)));
+                yield { dirent, linkTarget };
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+    }
+}
+//# sourceMappingURL=dev_disk.js.map

package/dist/cjs/linux/dev_disk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev_disk.js","sourceRoot":"","sources":["../../../src/linux/dev_disk.ts"],"names":[],"mappings":";AAAA,wBAAwB;;AAaxB,gDAYC;AAOD,kDAYC;AAGD,kDAWC;AAvDD,+CAAqD;AACrD,yCAA0C;AAC1C,gDAAuC;AACvC,4CAAqD;AAErD;;;;GAIG;AACI,KAAK,UAAU,kBAAkB,CAAC,UAAkB;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CACtC,mBAAmB,EACnB,IAAA,mBAAO,EAAC,UAAU,CAAC,CACpB,CAAC;QACF,IAAA,mBAAK,EAAC,iCAAiC,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,mBAAK,EAAC,+BAA+B,GAAG,KAAK,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;AACH,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CACtC,oBAAoB,EACpB,IAAA,mBAAO,EAAC,UAAU,CAAC,CACpB,CAAC;QACF,IAAA,mBAAK,EAAC,kCAAkC,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,mBAAK,EAAC,gCAAgC,GAAG,KAAK,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;AACH,CAAC;AAED,yBAAyB;AAClB,KAAK,UAAU,mBAAmB,CACvC,OAAe,EACf,QAAgB;IAEhB,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,IAAI,EAAE,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC/B,4DAA4D;YAC5D,OAAO,IAAA,iCAAqB,EAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO;AACT,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,SAAS,CACvB,SAAiB;IAEjB,KAAK,MAAM,MAAM,IAAI,MAAM,IAAA,kBAAO,EAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACvE,IAAI,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAA,mBAAO,EACxB,SAAS,EACT,MAAM,IAAA,mBAAQ,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAC7C,CAAC;gBACF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}