@photostructure/fs-metadata 0.1.1 → 0.1.3

package/binding.gyp

@@ -72,8 +72,21 @@
             ],
             "msvs_settings": {
               "VCCLCompilerTool": {
+                "AdditionalOptions": [
+                  "/Qspectre",
+                  "/guard:cf",
+                  "/ZH:SHA_256",
+                  "/sdl"
+                ],
                 "ExceptionHandling": 1,
                 "RuntimeTypeInfo": "true"
+              },
+              "VCLinkerTool": {
+                "AdditionalOptions": [
+                  "/guard:cf",
+                  "/DYNAMICBASE",
+                  "/CETCOMPAT"
+                ]
               }
             }
           }

package/dist/cjs/array.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @return a new array whose elements return true based on the given `predicate`
+ * function.
+ */
+export declare function asyncFilter<T>(arr: T[], predicate: (item: T) => boolean | Promise<boolean>): Promise<T[]>;
+/**
+ * Remove duplicate elements from an array.
+ *
+ * - Primitive values are compared using strict equality.
+ * - Objects and arrays are compared by reference.
+ *
+ * @return A new array with duplicate elements removed
+ */
+export declare function uniq<T>(arr: T[]): T[];
+/**
+ * Remove duplicate elements from an array based on a key function.
+ * @param keyFn A function that returns a key for each element. Elements that
+ * the key function returns nullish will be removed from the returned array.
+ * @return a new array omitting duplicate elements based on a key function.
+ */
+export declare function uniqBy<T, K>(arr: T[], keyFn: (item: T) => K | undefined): T[];
+/**
+ * @return an array of specified length, with each element created by calling
+ * the provided function.
+ */
+export declare function times<T>(length: number, fn: (index: number) => T): T[];
+/**
+ * @return a new array with elements that are not `null` or `undefined`.
+ */
+export declare function compact<T>(arr: (T | null | undefined)[] | undefined): T[];
+//# sourceMappingURL=array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../src/array.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,GAAG,EAAE,CAAC,EAAE,EACR,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GACjD,OAAO,CAAC,CAAC,EAAE,CAAC,CAGd;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAQ7E;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAEtE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,SAAS,GAAG,CAAC,EAAE,CAEzE"}

package/dist/cjs/array.js

@@ -0,0 +1,57 @@
+"use strict";
+// src/array.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asyncFilter = asyncFilter;
+exports.uniq = uniq;
+exports.uniqBy = uniqBy;
+exports.times = times;
+exports.compact = compact;
+/**
+ * @return a new array whose elements return true based on the given `predicate`
+ * function.
+ */
+async function asyncFilter(arr, predicate) {
+    const results = await Promise.all(arr.map(async (ea) => predicate(ea)));
+    return arr.filter((_item, index) => results[index]);
+}
+/**
+ * Remove duplicate elements from an array.
+ *
+ * - Primitive values are compared using strict equality.
+ * - Objects and arrays are compared by reference.
+ *
+ * @return A new array with duplicate elements removed
+ */
+function uniq(arr) {
+    return Array.from(new Set(arr));
+}
+/**
+ * Remove duplicate elements from an array based on a key function.
+ * @param keyFn A function that returns a key for each element. Elements that
+ * the key function returns nullish will be removed from the returned array.
+ * @return a new array omitting duplicate elements based on a key function.
+ */
+function uniqBy(arr, keyFn) {
+    const seen = new Set();
+    return arr.filter((item) => {
+        const key = keyFn(item);
+        if (key == null || seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/**
+ * @return an array of specified length, with each element created by calling
+ * the provided function.
+ */
+function times(length, fn) {
+    return Array.from({ length }, (_, i) => fn(i));
+}
+/**
+ * @return a new array with elements that are not `null` or `undefined`.
+ */
+function compact(arr) {
+    return arr == null ? [] : arr.filter((ea) => ea != null);
+}
+//# sourceMappingURL=array.js.map

package/dist/cjs/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/array.ts"],"names":[],"mappings":";AAAA,eAAe;;AAMf,kCAMC;AAUD,oBAEC;AAQD,wBAQC;AAMD,sBAEC;AAKD,0BAEC;AArDD;;;GAGG;AACI,KAAK,UAAU,WAAW,CAC/B,GAAQ,EACR,SAAkD;IAElD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,IAAI,CAAI,GAAQ;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,MAAM,CAAO,GAAQ,EAAE,KAAiC;IACtE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAK,CAAC;IAC1B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,KAAK,CAAI,MAAc,EAAE,EAAwB;IAC/D,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAI,GAAyC;IAClE,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAW,EAAE,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/dist/cjs/async.d.ts

@@ -0,0 +1,43 @@
+/**
+ * An error that is thrown when a promise does not resolve within the specified
+ * time.
+ */
+export declare class TimeoutError extends Error {
+    constructor(message: string, captureStackTrace?: boolean);
+}
+/**
+ * Rejects the promise with a TimeoutError if it does not resolve within the
+ * specified time.
+ *
+ * @param promise The promise to wrap.
+ * @param timeoutMs The timeout in milliseconds. Timeouts are disabled if this is 0.
+ * @returns A promise that resolves when the input promise resolves, or rejects
+ * with a TimeoutError if the input promise does not resolve within the
+ * specified time.
+ * @throws {TimeoutError} if the input promise does not resolve within the
+ * specified time.
+ * @throws {TypeError} if timeoutMs is not a number that is greater than 0.
+ */
+export declare function withTimeout<T>(opts: {
+    desc?: string;
+    promise: Promise<T>;
+    timeoutMs: number;
+}): Promise<T>;
+/**
+ * Delay for the specified number of milliseconds.
+ *
+ * @param ms The number of milliseconds to delay
+ * @param t Optional value to resolve with after delay
+ * @returns Promise that resolves with the provided value (or void if none provided)
+ */
+export declare function delay<T = void>(ms: number, t?: T): Promise<T>;
+/**
+ * Apply `fn` to every item in `items` with a maximum concurrency of
+ * `maxConcurrency`.
+ */
+export declare function mapConcurrent<I, O>({ items, fn, maxConcurrency, }: {
+    items: I[];
+    fn: (t: I) => Promise<O>;
+    maxConcurrency?: number;
+}): Promise<(O | Error)[]>;
+//# sourceMappingURL=async.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/async.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,iBAAiB,UAAO;CAQtD;AACD;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,CAAC,CAAC,CAyDb;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEnE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,EACxC,KAAK,EACL,EAAE,EACF,cAAuC,GACxC,EAAE;IACD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CA0BzB"}

package/dist/cjs/async.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutError = void 0;
+exports.withTimeout = withTimeout;
+exports.delay = delay;
+exports.mapConcurrent = mapConcurrent;
+const node_os_1 = require("node:os");
+const node_process_1 = require("node:process");
+const number_js_1 = require("./number.js");
+const string_js_1 = require("./string.js");
+/**
+ * An error that is thrown when a promise does not resolve within the specified
+ * time.
+ */
+class TimeoutError extends Error {
+    constructor(message, captureStackTrace = true) {
+        super(message);
+        this.name = "TimeoutError";
+        // Capture the stack trace up to the calling site
+        if (captureStackTrace && Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * Rejects the promise with a TimeoutError if it does not resolve within the
+ * specified time.
+ *
+ * @param promise The promise to wrap.
+ * @param timeoutMs The timeout in milliseconds. Timeouts are disabled if this is 0.
+ * @returns A promise that resolves when the input promise resolves, or rejects
+ * with a TimeoutError if the input promise does not resolve within the
+ * specified time.
+ * @throws {TimeoutError} if the input promise does not resolve within the
+ * specified time.
+ * @throws {TypeError} if timeoutMs is not a number that is greater than 0.
+ */
+async function withTimeout(opts) {
+    const desc = (0, string_js_1.isBlank)(opts.desc) ? "thenOrTimeout()" : opts.desc;
+    if (!(0, number_js_1.isNumber)(opts.timeoutMs)) {
+        throw new TypeError(desc +
+            ": Expected timeoutMs to be numeric, but got " +
+            JSON.stringify(opts.timeoutMs));
+    }
+    const timeoutMs = Math.floor(opts.timeoutMs);
+    if (timeoutMs < 0) {
+        throw new TypeError(desc + ": Expected timeoutMs to be > 0, but got " + timeoutMs);
+    }
+    if (timeoutMs === 0) {
+        return opts.promise;
+    }
+    // Create error here to captured the caller's stack trace. If we create it in
+    // the timeout callback, the stack trace will be truncated to this function.
+    const timeoutError = new TimeoutError(`${desc}: timeout after ${timeoutMs}ms`);
+    if (node_process_1.env["NODE_ENV"] === "test" && timeoutMs === 1) {
+        timeoutError.message += "(timeout test)";
+        opts.promise.catch(() => { }); // < avoid unhandled rejection warnings
+        throw timeoutError;
+    }
+    let timeoutId;
+    opts.promise
+        .catch(() => { }) // < avoid unhandled rejection warnings
+        .finally(() => {
+        if (timeoutId != null) {
+            clearTimeout(timeoutId);
+            timeoutId = undefined;
+        }
+    });
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            if (timeoutId != null) {
+                timeoutError.message += "(timeout callback)";
+                reject(timeoutError);
+            }
+            timeoutId = undefined;
+        }, timeoutMs);
+    });
+    return Promise.race([opts.promise, timeoutPromise]);
+}
+/**
+ * Delay for the specified number of milliseconds.
+ *
+ * @param ms The number of milliseconds to delay
+ * @param t Optional value to resolve with after delay
+ * @returns Promise that resolves with the provided value (or void if none provided)
+ */
+async function delay(ms, t) {
+    return new Promise((resolve) => setTimeout(() => resolve(t), ms));
+}
+/**
+ * Apply `fn` to every item in `items` with a maximum concurrency of
+ * `maxConcurrency`.
+ */
+async function mapConcurrent({ items, fn, maxConcurrency = (0, node_os_1.availableParallelism)(), }) {
+    // Validate maxConcurrency
+    if (!(0, number_js_1.gt0)(maxConcurrency)) {
+        throw new Error(`maxConcurrency must be a positive integer, got: ${maxConcurrency}`);
+    }
+    if (typeof fn !== "function") {
+        throw new TypeError(`fn must be a function, got: ${typeof fn}`);
+    }
+    const results = [];
+    const executing = new Set();
+    for (const [index, item] of items.entries()) {
+        // Create a wrapped promise that handles cleanup
+        while (executing.size >= maxConcurrency) {
+            await Promise.race(executing);
+        }
+        const p = (results[index] = fn(item).catch((error) => error));
+        executing.add(p);
+        p.finally(() => executing.delete(p));
+    }
+    return Promise.all(results);
+}
+//# sourceMappingURL=async.js.map

package/dist/cjs/async.js.map

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

package/dist/cjs/cache.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Cache the result of a function for a given time-to-live (TTL).
+ */
+export declare function ttlCache<Args extends unknown[], R>(fn: (...args: Args) => R, ttl: number): (...args: Args) => R;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAChD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,EACxB,GAAG,EAAE,MAAM,GACV,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CA0BtB"}

package/dist/cjs/cache.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ttlCache = ttlCache;
+/**
+ * Cache the result of a function for a given time-to-live (TTL).
+ */
+function ttlCache(fn, ttl) {
+    if (ttl <= 0)
+        return fn;
+    const cache = new Map();
+    return (...args) => {
+        const key = JSON.stringify(args);
+        const entry = cache.get(key);
+        if (entry) {
+            return entry.r;
+        }
+        const result = fn(...args);
+        const timeoutId = setTimeout(() => {
+            const currentEntry = cache.get(key);
+            if (currentEntry?.t === timeoutId) {
+                cache.delete(key);
+            }
+        }, ttl);
+        cache.set(key, { r: result, t: timeoutId });
+        return result;
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/cjs/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":";;AAQA,4BA6BC;AAhCD;;GAEG;AACH,SAAgB,QAAQ,CACtB,EAAwB,EACxB,GAAW;IAEX,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAExB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE/C,OAAO,CAAC,GAAG,IAAU,EAAK,EAAE;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAE3B,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,YAAY,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;gBAClC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,EAAE,GAAG,CAAC,CAAC;QAER,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAE5C,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/cjs/debuglog.d.ts

@@ -0,0 +1,9 @@
+export declare const debugLogContext: (() => string) & {
+    reset: () => void;
+};
+export declare const isDebugEnabled: (() => boolean) & {
+    reset: () => void;
+};
+export declare function debug(msg: string, ...args: unknown[]): void;
+export declare function resetDebugLog(): void;
+//# sourceMappingURL=debuglog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debuglog.d.ts","sourceRoot":"","sources":["../../src/debuglog.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe;;CAU1B,CAAC;AAEH,eAAO,MAAM,cAAc;;CAEzB,CAAC;AAEH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,QAQpD;AAED,wBAAgB,aAAa,SAG5B"}

package/dist/cjs/debuglog.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDebugEnabled = exports.debugLogContext = void 0;
+exports.debug = debug;
+exports.resetDebugLog = resetDebugLog;
+const node_util_1 = require("node:util");
+const defer_js_1 = require("./defer.js");
+// allow tests to reset the debug log context
+exports.debugLogContext = (0, defer_js_1.defer)(() => {
+    for (const ea of ["fs-metadata", "fs-meta"]) {
+        if ((0, node_util_1.debuglog)(ea).enabled) {
+            return ea;
+        }
+        if ((0, node_util_1.debuglog)(ea.toUpperCase()).enabled) {
+            return ea;
+        }
+    }
+    return "photostructure:fs-metadata";
+});
+exports.isDebugEnabled = (0, defer_js_1.defer)(() => {
+    return (0, node_util_1.debuglog)((0, exports.debugLogContext)()).enabled ?? false;
+});
+function debug(msg, ...args) {
+    if (!(0, exports.isDebugEnabled)())
+        return;
+    const now = new Date();
+    // Format: [HH:MM:SS.mmm] prefix: message
+    const timestamp = `[${now.getHours().toString().padStart(2, "0")}:${now.getMinutes().toString().padStart(2, "0")}:${now.getSeconds().toString().padStart(2, "0")}.${now.getMilliseconds().toString().padStart(3, "0")}] ${(0, exports.debugLogContext)()} `;
+    process.stderr.write(timestamp + (0, node_util_1.format)(msg, ...args) + "\n");
+}
+function resetDebugLog() {
+    exports.debugLogContext.reset();
+    exports.isDebugEnabled.reset();
+}
+//# sourceMappingURL=debuglog.js.map

package/dist/cjs/debuglog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debuglog.js","sourceRoot":"","sources":["../../src/debuglog.ts"],"names":[],"mappings":";;;AAqBA,sBAQC;AAED,sCAGC;AAlCD,yCAA6C;AAC7C,yCAAmC;AAEnC,6CAA6C;AAEhC,QAAA,eAAe,GAAG,IAAA,gBAAK,EAAC,GAAG,EAAE;IACxC,KAAK,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,CAAC;QAC5C,IAAI,IAAA,oBAAQ,EAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,IAAA,oBAAQ,EAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,4BAA4B,CAAC;AACtC,CAAC,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,IAAA,gBAAK,EAAC,GAAG,EAAE;IACvC,OAAO,IAAA,oBAAQ,EAAC,IAAA,uBAAe,GAAE,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,SAAgB,KAAK,CAAC,GAAW,EAAE,GAAG,IAAe;IACnD,IAAI,CAAC,IAAA,sBAAc,GAAE;QAAE,OAAO;IAC9B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,yCAAyC;IACzC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,IAAA,uBAAe,GAAE,GAAG,CAAC;IAE/O,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,IAAA,kBAAM,EAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,SAAgB,aAAa;IAC3B,uBAAe,CAAC,KAAK,EAAE,CAAC;IACxB,sBAAc,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/cjs/defer.d.ts

@@ -0,0 +1,12 @@
+type Defer<T> = (() => T) & {
+    reset: () => void;
+};
+/**
+ * Creates a deferred value that is computed once on first access and cached for
+ * subsequent accesses.
+ * @param thunk A function that takes no arguments and returns a value
+ * @returns A function that returns the computed value
+ */
+export declare function defer<T>(thunk: () => T): Defer<T>;
+export {};
+//# sourceMappingURL=defer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defer.d.ts","sourceRoot":"","sources":["../../src/defer.ts"],"names":[],"mappings":"AAEA,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAiBjD"}

package/dist/cjs/defer.js

@@ -0,0 +1,26 @@
+"use strict";
+// src/defer.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defer = defer;
+/**
+ * Creates a deferred value that is computed once on first access and cached for
+ * subsequent accesses.
+ * @param thunk A function that takes no arguments and returns a value
+ * @returns A function that returns the computed value
+ */
+function defer(thunk) {
+    let computed = false;
+    let value;
+    const fn = () => {
+        if (!computed) {
+            computed = true;
+            value = thunk();
+        }
+        return value;
+    };
+    fn.reset = () => {
+        computed = false;
+    };
+    return fn;
+}
+//# sourceMappingURL=defer.js.map

package/dist/cjs/defer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.js","sourceRoot":"","sources":["../../src/defer.ts"],"names":[],"mappings":";AAAA,eAAe;;AAYf,sBAiBC;AAvBD;;;;;GAKG;AACH,SAAgB,KAAK,CAAI,KAAc;IACrC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,KAAQ,CAAC;IAEb,MAAM,EAAE,GAAG,GAAG,EAAE;QACd,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,GAAG,KAAK,EAAE,CAAC;QAClB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,EAAE,CAAC,KAAK,GAAG,GAAG,EAAE;QACd,QAAQ,GAAG,KAAK,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/cjs/error.d.ts

@@ -0,0 +1,18 @@
+export declare class WrappedError extends Error {
+    errno?: number;
+    code?: string;
+    syscall?: string;
+    path?: string;
+    constructor(context: string, options?: {
+        name?: string;
+        cause?: unknown;
+        errno?: number;
+        code?: string;
+        syscall?: string;
+        path?: string;
+    });
+    get details(): Record<string, unknown>;
+    toString(): string;
+}
+export declare function toError(cause: unknown): Error;
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAkBA,qBAAa,YAAa,SAAQ,KAAK;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IAgCH,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC;IAEQ,QAAQ,IAAI,MAAM;CAM5B;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAE7C"}

package/dist/cjs/error.js

@@ -0,0 +1,63 @@
+"use strict";
+// src/error.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WrappedError = void 0;
+exports.toError = toError;
+const number_js_1 = require("./number.js");
+const object_js_1 = require("./object.js");
+const string_js_1 = require("./string.js");
+function toMessage(context, cause) {
+    const causeStr = cause instanceof Error
+        ? cause.message
+        : typeof cause === "string"
+            ? cause
+            : cause
+                ? JSON.stringify(cause)
+                : "";
+    return context + ((0, string_js_1.isBlank)(causeStr) ? "" : ": " + causeStr);
+}
+class WrappedError extends Error {
+    errno;
+    code;
+    syscall;
+    path;
+    constructor(context, options) {
+        super(toMessage(context, options?.cause));
+        const cause = (0, object_js_1.map)(options?.cause, toError);
+        const opts = { ...(0, object_js_1.compactValues)(cause), ...(0, object_js_1.compactValues)(options) };
+        if ((0, string_js_1.isNotBlank)(options?.name)) {
+            this.name = options.name;
+        }
+        if (cause != null) {
+            this.cause = cause;
+            if (cause instanceof Error) {
+                this.stack = `${this.stack}\nCaused by: ${cause.stack}`;
+            }
+        }
+        if ((0, number_js_1.isNumber)(opts.errno)) {
+            this.errno = opts.errno;
+        }
+        if ((0, string_js_1.isNotBlank)(opts.code)) {
+            this.code = opts.code;
+        }
+        if ((0, string_js_1.isNotBlank)(opts.syscall)) {
+            this.syscall = opts.syscall;
+        }
+        if ((0, string_js_1.isNotBlank)(options?.path)) {
+            this.path = options.path;
+        }
+    }
+    get details() {
+        return (0, object_js_1.compactValues)((0, object_js_1.omit)(this, "name", "message", "cause"));
+    }
+    toString() {
+        const details = this.details;
+        const detailsStr = Object.keys(details).length === 0 ? "" : " " + JSON.stringify(details);
+        return `${super.toString()}${detailsStr}`;
+    }
+}
+exports.WrappedError = WrappedError;
+function toError(cause) {
+    return cause instanceof Error ? cause : new Error(String(cause));
+}
+//# sourceMappingURL=error.js.map

package/dist/cjs/error.js.map

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

package/dist/cjs/exports.d.ts

@@ -0,0 +1,99 @@
+import type { HiddenMetadata, HideMethod, SetHiddenResult } from "./hidden.js";
+import type { GetVolumeMountPointOptions, MountPoint } from "./mount_point.js";
+import type { Options } from "./options.js";
+import { IncludeSystemVolumesDefault, LinuxMountTablePathsDefault, OptionsDefault, optionsWithDefaults, SystemFsTypesDefault, SystemPathPatternsDefault, TimeoutMsDefault } from "./options.js";
+import type { StringEnum, StringEnumKeys, StringEnumType } from "./string_enum.js";
+import type { SystemVolumeConfig } from "./system_volume.js";
+import type { VolumeHealthStatus } from "./volume_health_status.js";
+import { VolumeHealthStatuses } from "./volume_health_status.js";
+import type { VolumeMetadata } from "./volume_metadata.js";
+export type { GetVolumeMountPointOptions, HiddenMetadata, HideMethod, MountPoint, Options, SetHiddenResult, StringEnum, StringEnumKeys, StringEnumType, SystemVolumeConfig, VolumeHealthStatus, VolumeMetadata, };
+/**
+ * List all active local and remote mount points on the system.
+ *
+ * Only readable directories are included in the results.
+ *
+ * Note that on Windows, `timeoutMs` will be used **per system call** and not
+ * for the entire operation.
+ *
+ * @param opts Optional filesystem operation settings to override default values
+ */
+export declare function getVolumeMountPoints(opts?: Partial<GetVolumeMountPointOptions>): Promise<MountPoint[]>;
+/**
+ * Get metadata for the volume at the given mount point.
+ *
+ * @param mountPoint Must be a non-blank string
+ * @param opts Optional filesystem operation settings
+ */
+export declare function getVolumeMetadata(mountPoint: string, opts?: Partial<Pick<Options, "timeoutMs">>): Promise<VolumeMetadata>;
+/**
+ * Retrieves metadata for all mounted volumes with optional filtering and
+ * concurrency control.
+ *
+ * @param opts - Optional configuration object
+ * @param opts.includeSystemVolumes - If true, includes system volumes in the
+ * results. Defaults to true on Windows and false elsewhere.
+ * @param opts.maxConcurrency - Maximum number of concurrent operations.
+ * Defaults to the system's available parallelism: see
+ * {@link https://nodejs.org/api/os.html#osavailableparallelism | os.availableParallelism()}
+ * @param opts.timeoutMs - Maximum time to wait for
+ * {@link getVolumeMountPoints}, as well as **each** {@link getVolumeMetadata}
+ * to complete. Defaults to {@link TimeoutMsDefault}
+ * @returns Promise that resolves to an array of either VolumeMetadata objects
+ * or error objects containing the mount point and error
+ * @throws Never - errors are caught and returned as part of the result array
+ */
+export declare function getAllVolumeMetadata(opts?: Partial<Options> & {
+    includeSystemVolumes?: boolean;
+}): Promise<VolumeMetadata[]>;
+/**
+ * Check if a file or directory is hidden.
+ *
+ * Note that `path` may be _effectively_ hidden if any of the ancestor
+ * directories are hidden: use {@link isHiddenRecursive} to check for this.
+ *
+ * @param pathname Path to file or directory
+ * @returns Promise resolving to boolean indicating hidden state
+ */
+export declare function isHidden(pathname: string): Promise<boolean>;
+/**
+ * Check if a file or directory is hidden, or if any of its ancestor
+ * directories are hidden.
+ *
+ * @param pathname Path to file or directory
+ * @returns Promise resolving to boolean indicating hidden state
+ */
+export declare function isHiddenRecursive(pathname: string): Promise<boolean>;
+/**
+ * Get detailed metadata about the hidden state of a file or directory.
+ *
+ * @param pathname Path to file or directory
+ * @returns Promise resolving to metadata about the hidden state
+ */
+export declare function getHiddenMetadata(pathname: string): Promise<HiddenMetadata>;
+/**
+ * Set the hidden state of a file or directory
+ *
+ * @param pathname Path to file or directory
+ * @param hidden - Whether the item should be hidden (true) or visible (false)
+ * @param method Method to use for hiding the file or directory. The default
+ * is "auto", which is "dotPrefix" on Linux and macOS, and "systemFlag" on
+ * Windows. "all" will attempt to use all relevant methods for the current
+ * operating system.
+ * @returns Promise resolving the final name of the file or directory (as it
+ * will change on POSIX systems), and the action(s) taken.
+ * @throws {Error} If the file doesn't exist, permissions are insufficient, or
+ * the requested method is unsupported
+ */
+export declare function setHidden(pathname: string, hidden: boolean, method?: HideMethod): Promise<SetHiddenResult>;
+export type ExportedFunctions = {
+    getVolumeMountPoints: typeof getVolumeMountPoints;
+    getVolumeMetadata: typeof getVolumeMetadata;
+    getAllVolumeMetadata: typeof getAllVolumeMetadata;
+    isHidden: typeof isHidden;
+    isHiddenRecursive: typeof isHiddenRecursive;
+    getHiddenMetadata: typeof getHiddenMetadata;
+    setHidden: typeof setHidden;
+};
+export { IncludeSystemVolumesDefault, LinuxMountTablePathsDefault, OptionsDefault, optionsWithDefaults, SystemFsTypesDefault, SystemPathPatternsDefault, TimeoutMsDefault, VolumeHealthStatuses, };
+//# sourceMappingURL=exports.d.ts.map

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

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