@photostructure/fs-metadata 0.1.2 → 0.1.4

package/dist/cjs/unc.cjs

@@ -0,0 +1,52 @@
+"use strict";
+// src/unc.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUNCPath = parseUNCPath;
+const string_js_1 = require("./string.cjs");
+/**
+ * Checks if a string is formatted as a valid UNC path.
+ * A valid UNC path starts with double backslashes or slashes,
+ * followed by a server/host name, and then a share name.
+ * The path must use consistent slashes (all forward or all backward).
+ *
+ * @param path - The string to check
+ * @returns boolean - True if the string is a valid UNC path, false otherwise
+ */
+function parseUNCPath(path) {
+    if (path == null || (0, string_js_1.isBlank)(path) || !(0, string_js_1.isString)(path)) {
+        return;
+    }
+    // Check for two forward slashes or two backslashes at start
+    if (!path.startsWith("\\\\") && !path.startsWith("//")) {
+        return;
+    }
+    // Determine slash type from the start of the path
+    const isForwardSlash = path.startsWith("//");
+    const slashChar = isForwardSlash ? "/" : "\\";
+    // Split path using the correct slash type
+    const parts = path.slice(2).split(slashChar);
+    // Check minimum required parts (server and share)
+    if (parts.length < 2) {
+        return;
+    }
+    // Validate server and share names exist and aren't empty
+    const [remoteHost, remoteShare] = parts;
+    if (remoteHost == null ||
+        (0, string_js_1.isBlank)(remoteHost) ||
+        remoteShare == null ||
+        (0, string_js_1.isBlank)(remoteShare)) {
+        return;
+    }
+    // Check for invalid characters in server and share names
+    const invalidChars = /[<>:"|?*]/;
+    if (invalidChars.test(remoteHost) || invalidChars.test(remoteShare)) {
+        return;
+    }
+    // Check for mixed slash usage
+    const wrongSlash = isForwardSlash ? "\\" : "/";
+    if (path.includes(wrongSlash)) {
+        return;
+    }
+    return { remoteHost, remoteShare, remote: true };
+}
+//# sourceMappingURL=unc.js.map

package/dist/cjs/unc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unc.js","sourceRoot":"","sources":["../../src/unc.ts"],"names":[],"mappings":";AAAA,aAAa;;AAcb,oCAgDC;AA3DD,2CAAgD;AAEhD;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAC1B,IAA+B;IAE/B,IAAI,IAAI,IAAI,IAAI,IAAI,IAAA,mBAAO,EAAC,IAAI,CAAC,IAAI,CAAC,IAAA,oBAAQ,EAAC,IAAI,CAAC,EAAE,CAAC;QACrD,OAAO;IACT,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO;IACT,CAAC;IAED,kDAAkD;IAClD,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAE9C,0CAA0C;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAE7C,kDAAkD;IAClD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,yDAAyD;IACzD,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC;IACxC,IACE,UAAU,IAAI,IAAI;QAClB,IAAA,mBAAO,EAAC,UAAU,CAAC;QACnB,WAAW,IAAI,IAAI;QACnB,IAAA,mBAAO,EAAC,WAAW,CAAC,EACpB,CAAC;QACD,OAAO;IACT,CAAC;IAED,yDAAyD;IACzD,MAAM,YAAY,GAAG,WAAW,CAAC;IACjC,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACpE,OAAO;IACT,CAAC;IAED,8BAA8B;IAC9B,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACnD,CAAC"}

package/dist/cjs/units.cjs

@@ -0,0 +1,35 @@
+"use strict";
+// src/units.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GiB = exports.MiB = exports.KiB = void 0;
+exports.fmtBytes = fmtBytes;
+/**
+ * KiB = 1024 bytes
+ * @see https://en.wikipedia.org/wiki/Kibibyte
+ */
+exports.KiB = 1024;
+/**
+ * MiB = 1024 KiB
+ * @see https://en.wikipedia.org/wiki/Mebibyte
+ */
+exports.MiB = 1024 * exports.KiB;
+/**
+ * GiB = 1024 MiB
+ * @see https://en.wikipedia.org/wiki/Gibibyte
+ */
+exports.GiB = 1024 * exports.MiB;
+function fmtBytes(bytes) {
+    if (bytes < exports.KiB) {
+        return `${bytes} B`;
+    }
+    else if (bytes < exports.MiB) {
+        return `${(bytes / exports.KiB).toFixed(2)} KiB`;
+    }
+    else if (bytes < exports.GiB) {
+        return `${(bytes / exports.MiB).toFixed(2)} MiB`;
+    }
+    else {
+        return `${(bytes / exports.GiB).toFixed(2)} GiB`;
+    }
+}
+//# sourceMappingURL=units.js.map

package/dist/cjs/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../../src/units.ts"],"names":[],"mappings":";AAAA,eAAe;;;AAoBf,4BAUC;AA5BD;;;GAGG;AACU,QAAA,GAAG,GAAG,IAAI,CAAC;AAExB;;;GAGG;AACU,QAAA,GAAG,GAAG,IAAI,GAAG,WAAG,CAAC;AAE9B;;;GAGG;AACU,QAAA,GAAG,GAAG,IAAI,GAAG,WAAG,CAAC;AAE9B,SAAgB,QAAQ,CAAC,KAAa;IACpC,IAAI,KAAK,GAAG,WAAG,EAAE,CAAC;QAChB,OAAO,GAAG,KAAK,IAAI,CAAC;IACtB,CAAC;SAAM,IAAI,KAAK,GAAG,WAAG,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,KAAK,GAAG,WAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC;SAAM,IAAI,KAAK,GAAG,WAAG,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,KAAK,GAAG,WAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,KAAK,GAAG,WAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/cjs/uuid.cjs

@@ -0,0 +1,25 @@
+"use strict";
+// src/uuid.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractUUID = extractUUID;
+const string_js_1 = require("./string.cjs");
+const uuidRegex = /[a-z0-9][a-z0-9-]{7,}/i;
+/**
+ * Some volume UUIDs are short, like, `ABCD1234`.
+ *
+ * Some volume UUIDs are in hexadecimal, but others and use G-Z. We will allow
+ * that.
+ *
+ * Some Windows syscalls wrap the UUID in a "\\\\?\\Volume{...}\\" prefix and
+ * suffix. This function will strip out that prefix and suffix.
+ *
+ * We will ignore any UUID-ish string that is not at least 8 characters long
+ * (and return `undefined` if no other, longer uuid-ish string is found).
+ *
+ * UUIDs cannot start with a hyphen, and can only contain a-z, 0-9, and hyphens
+ * (case-insensitive).
+ */
+function extractUUID(uuid) {
+    return (0, string_js_1.toS)(uuid).match(uuidRegex)?.[0];
+}
+//# sourceMappingURL=uuid.js.map

package/dist/cjs/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/uuid.ts"],"names":[],"mappings":";AAAA,cAAc;;AAqBd,kCAEC;AArBD,2CAAkC;AAElC,MAAM,SAAS,GAAG,wBAAwB,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,SAAgB,WAAW,CAAC,IAAwB;IAClD,OAAO,IAAA,eAAG,EAAC,IAAI,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/cjs/volume_health_status.cjs

@@ -0,0 +1,50 @@
+"use strict";
+// src/volume_health_status.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumeHealthStatuses = void 0;
+exports.directoryStatus = directoryStatus;
+const async_js_1 = require("./async.cjs");
+const debuglog_js_1 = require("./debuglog.cjs");
+const error_js_1 = require("./error.cjs");
+const fs_js_1 = require("./fs.cjs");
+const object_js_1 = require("./object.cjs");
+const string_enum_js_1 = require("./string_enum.cjs");
+/**
+ * Health statuses for volumes (mostly applicable to Windows).
+ *
+ * - `healthy`: Volume is "OK": accessible and functioning normally
+ * - `timeout`: Volume could not be accessed before the specified timeout. It
+ *   may be inaccessible or disconnected.
+ * - `inaccessible`: Volume exists but can't be accessed (permissions/locks)
+ * - `disconnected`: Network volume that's offline
+ * - `unknown`: Status can't be determined
+ */
+exports.VolumeHealthStatuses = (0, string_enum_js_1.stringEnum)("healthy", "timeout", "inaccessible", "disconnected", "unknown");
+/**
+ * Attempt to read a directory to determine if it's accessible, and if an error
+ * is thrown, convert to a health status.
+ * @returns the "health status" of the directory, based on the success of `readdir(dir)`.
+ * @throws never
+ */
+async function directoryStatus(dir, timeoutMs, canReaddirImpl = fs_js_1.canReaddir) {
+    try {
+        if (await canReaddirImpl(dir, timeoutMs)) {
+            return { status: exports.VolumeHealthStatuses.healthy };
+        }
+    }
+    catch (error) {
+        (0, debuglog_js_1.debug)("[directoryStatus] %s: %s", dir, error);
+        let status = exports.VolumeHealthStatuses.unknown;
+        if (error instanceof async_js_1.TimeoutError) {
+            status = exports.VolumeHealthStatuses.timeout;
+        }
+        else if ((0, object_js_1.isObject)(error) && error instanceof Error && "code" in error) {
+            if (error.code === "EPERM" || error.code === "EACCES") {
+                status = exports.VolumeHealthStatuses.inaccessible;
+            }
+        }
+        return { status, error: (0, error_js_1.toError)(error) };
+    }
+    return { status: exports.VolumeHealthStatuses.unknown };
+}
+//# sourceMappingURL=volume_health_status.js.map

package/dist/cjs/volume_health_status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volume_health_status.js","sourceRoot":"","sources":["../../src/volume_health_status.ts"],"names":[],"mappings":";AAAA,8BAA8B;;;AAmC9B,0CAsBC;AAvDD,yCAA0C;AAC1C,+CAAsC;AACtC,yCAAqC;AACrC,mCAAqC;AACrC,2CAAuC;AACvC,qDAA8D;AAE9D;;;;;;;;;GASG;AACU,QAAA,oBAAoB,GAAG,IAAA,2BAAU,EAC5C,SAAS,EACT,SAAS,EACT,cAAc,EACd,cAAc,EACd,SAAS,CACV,CAAC;AAIF;;;;;GAKG;AACI,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,SAAiB,EACjB,iBAAoC,kBAAU;IAE9C,IAAI,CAAC;QACH,IAAI,MAAM,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,MAAM,EAAE,4BAAoB,CAAC,OAAO,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,mBAAK,EAAC,0BAA0B,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,MAAM,GAAuB,4BAAoB,CAAC,OAAO,CAAC;QAC9D,IAAI,KAAK,YAAY,uBAAY,EAAE,CAAC;YAClC,MAAM,GAAG,4BAAoB,CAAC,OAAO,CAAC;QACxC,CAAC;aAAM,IAAI,IAAA,oBAAQ,EAAC,KAAK,CAAC,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YACxE,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtD,MAAM,GAAG,4BAAoB,CAAC,YAAY,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAA,kBAAO,EAAC,KAAK,CAAC,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,4BAAoB,CAAC,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/dist/cjs/volume_metadata.cjs

@@ -0,0 +1,169 @@
+"use strict";
+// src/volume_metadata.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._ = void 0;
+exports.getVolumeMetadata = getVolumeMetadata;
+exports.getAllVolumeMetadata = getAllVolumeMetadata;
+const async_js_1 = require("./async.cjs");
+const debuglog_js_1 = require("./debuglog.cjs");
+const error_js_1 = require("./error.cjs");
+const dev_disk_js_1 = require("./linux/dev_disk.cjs");
+const mount_points_js_1 = require("./linux/mount_points.cjs");
+const mtab_js_1 = require("./linux/mtab.cjs");
+const mount_point_js_1 = require("./mount_point.cjs");
+const object_js_1 = require("./object.cjs");
+const options_js_1 = require("./options.cjs");
+const path_js_1 = require("./path.cjs");
+const platform_js_1 = require("./platform.cjs");
+const remote_info_js_1 = require("./remote_info.cjs");
+const string_js_1 = require("./string.cjs");
+const system_volume_js_1 = require("./system_volume.cjs");
+const unc_js_1 = require("./unc.cjs");
+const uuid_js_1 = require("./uuid.cjs");
+const volume_health_status_js_1 = require("./volume_health_status.cjs");
+async function getVolumeMetadata(o, nativeFn) {
+    if ((0, string_js_1.isBlank)(o.mountPoint)) {
+        throw new TypeError("Invalid mountPoint: got " + JSON.stringify(o.mountPoint));
+    }
+    const p = _getVolumeMetadata(o, nativeFn);
+    // we rely on the native bindings on Windows to do proper timeouts
+    return platform_js_1.isWindows
+        ? p
+        : (0, async_js_1.withTimeout)({
+            desc: "getVolumeMetadata()",
+            timeoutMs: o.timeoutMs,
+            promise: p,
+        });
+}
+async function _getVolumeMetadata(o, nativeFn) {
+    o = (0, options_js_1.optionsWithDefaults)(o);
+    const norm = (0, path_js_1.normalizePath)(o.mountPoint);
+    if (norm == null) {
+        throw new Error("Invalid mountPoint: " + JSON.stringify(o.mountPoint));
+    }
+    o.mountPoint = norm;
+    (0, debuglog_js_1.debug)("[getVolumeMetadata] starting metadata collection for %s", o.mountPoint);
+    (0, debuglog_js_1.debug)("[getVolumeMetadata] options: %o", o);
+    const { status, error } = await (0, volume_health_status_js_1.directoryStatus)(o.mountPoint, o.timeoutMs);
+    if (status !== volume_health_status_js_1.VolumeHealthStatuses.healthy) {
+        (0, debuglog_js_1.debug)("[getVolumeMetadata] directoryStatus error: %s", error);
+        throw error ?? new Error("Volume not healthy: " + status);
+    }
+    (0, debuglog_js_1.debug)("[getVolumeMetadata] readdir status: %s", status);
+    let remote = false;
+    // Get filesystem info from mtab first on Linux
+    let mtabInfo;
+    let device;
+    if (platform_js_1.isLinux) {
+        (0, debuglog_js_1.debug)("[getVolumeMetadata] collecting Linux mtab info");
+        try {
+            const m = await (0, mount_points_js_1.getLinuxMtabMetadata)(o.mountPoint, o);
+            mtabInfo = (0, mtab_js_1.mountEntryToPartialVolumeMetadata)(m, o);
+            (0, debuglog_js_1.debug)("[getVolumeMetadata] mtab info: %o", mtabInfo);
+            if (mtabInfo.remote) {
+                remote = true;
+            }
+            if ((0, string_js_1.isNotBlank)(m.fs_spec)) {
+                device = m.fs_spec;
+            }
+        }
+        catch (err) {
+            (0, debuglog_js_1.debug)("[getVolumeMetadata] failed to get mtab info: " + err);
+            // this may be a GIO mount. Ignore the error and continue.
+        }
+    }
+    if ((0, string_js_1.isNotBlank)(device)) {
+        o.device = device;
+        (0, debuglog_js_1.debug)("[getVolumeMetadata] using device: %s", device);
+    }
+    (0, debuglog_js_1.debug)("[getVolumeMetadata] requesting native metadata");
+    const metadata = (await (await nativeFn()).getVolumeMetadata(o));
+    (0, debuglog_js_1.debug)("[getVolumeMetadata] native metadata: %o", metadata);
+    // Some OS implementations leave it up to us to extract remote info:
+    const remoteInfo = mtabInfo ??
+        (0, remote_info_js_1.extractRemoteInfo)(metadata.uri) ??
+        (0, remote_info_js_1.extractRemoteInfo)(metadata.mountFrom) ??
+        (platform_js_1.isWindows ? (0, unc_js_1.parseUNCPath)(o.mountPoint) : undefined);
+    (0, debuglog_js_1.debug)("[getVolumeMetadata] extracted remote info: %o", remoteInfo);
+    remote ||=
+        (0, remote_info_js_1.isRemoteFsType)(metadata.fstype) ||
+            (remoteInfo?.remote ?? metadata.remote ?? false);
+    (0, debuglog_js_1.debug)("[getVolumeMetadata] assembling: %o", {
+        status,
+        mtabInfo,
+        remoteInfo,
+        metadata,
+        mountPoint: o.mountPoint,
+        remote,
+    });
+    const result = (0, object_js_1.compactValues)({
+        status, // < let the implementation's status win by having this first
+        ...(0, object_js_1.compactValues)(remoteInfo),
+        ...(0, object_js_1.compactValues)(metadata),
+        ...(0, object_js_1.compactValues)(mtabInfo),
+        mountPoint: o.mountPoint,
+        remote,
+    });
+    // Backfill if blkid or gio failed us:
+    if (platform_js_1.isLinux && (0, string_js_1.isNotBlank)(device)) {
+        // Sometimes blkid doesn't have the UUID in cache. Try to get it from
+        // /dev/disk/by-uuid:
+        result.uuid ??= (await (0, dev_disk_js_1.getUuidFromDevDisk)(device)) ?? "";
+        result.label ??= (await (0, dev_disk_js_1.getLabelFromDevDisk)(device)) ?? "";
+    }
+    (0, system_volume_js_1.assignSystemVolume)(result, o);
+    // Fix microsoft's UUID format:
+    result.uuid = (0, uuid_js_1.extractUUID)(result.uuid) ?? result.uuid ?? "";
+    (0, debuglog_js_1.debug)("[getVolumeMetadata] final result for %s: %o", o.mountPoint, result);
+    return (0, object_js_1.compactValues)(result);
+}
+async function getAllVolumeMetadata(opts, nativeFn) {
+    const o = (0, options_js_1.optionsWithDefaults)(opts);
+    (0, debuglog_js_1.debug)("[getAllVolumeMetadata] starting with options: %o", o);
+    const arr = await (0, mount_point_js_1.getVolumeMountPoints)(o, nativeFn);
+    (0, debuglog_js_1.debug)("[getAllVolumeMetadata] found %d mount points", arr.length);
+    const unhealthyMountPoints = arr
+        .filter((ea) => ea.status != null && ea.status !== volume_health_status_js_1.VolumeHealthStatuses.healthy)
+        .map((ea) => ({
+        mountPoint: ea.mountPoint,
+        error: new error_js_1.WrappedError("volume not healthy: " + ea.status, {
+            name: "Skipped",
+        }),
+    }));
+    const includeSystemVolumes = opts?.includeSystemVolumes ?? options_js_1.IncludeSystemVolumesDefault;
+    const systemMountPoints = includeSystemVolumes
+        ? []
+        : arr
+            .filter((ea) => ea.isSystemVolume)
+            .map((ea) => ({
+            mountPoint: ea.mountPoint,
+            error: new error_js_1.WrappedError("system volume", { name: "Skipped" }),
+        }));
+    const healthy = arr.filter((ea) => ea.status == null || ea.status === volume_health_status_js_1.VolumeHealthStatuses.healthy);
+    (0, debuglog_js_1.debug)("[getAllVolumeMetadata] ", {
+        allMountPoints: arr.map((ea) => ea.mountPoint),
+        healthyMountPoints: healthy.map((ea) => ea.mountPoint),
+    });
+    (0, debuglog_js_1.debug)("[getAllVolumeMetadata] processing %d healthy volumes with max concurrency %d", healthy.length, o.maxConcurrency);
+    const results = await (0, async_js_1.mapConcurrent)({
+        maxConcurrency: o.maxConcurrency,
+        items: (opts?.includeSystemVolumes ?? options_js_1.IncludeSystemVolumesDefault)
+            ? healthy
+            : healthy.filter((ea) => !ea.isSystemVolume),
+        fn: async (mp) => getVolumeMetadata({ ...mp, ...o }, nativeFn).catch((error) => ({
+            mountPoint: mp.mountPoint,
+            error,
+        })),
+    });
+    (0, debuglog_js_1.debug)("[getAllVolumeMetadata] completed processing all volumes");
+    return arr.map((result) => (results.find((ea) => ea.mountPoint === result.mountPoint) ??
+        unhealthyMountPoints.find((ea) => ea.mountPoint === result.mountPoint) ??
+        systemMountPoints.find((ea) => ea.mountPoint === result.mountPoint) ?? {
+        ...result,
+        error: new error_js_1.WrappedError("Mount point metadata not retrieved", {
+            name: "NotApplicableError",
+        }),
+    }));
+}
+exports._ = undefined;
+//# sourceMappingURL=volume_metadata.js.map

package/dist/cjs/volume_metadata.js.map

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

package/dist/esm/array.js

@@ -0,0 +1,50 @@
+// src/array.ts
+/**
+ * @return a new array whose elements return true based on the given `predicate`
+ * function.
+ */
+export 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
+ */
+export 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.
+ */
+export 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.
+ */
+export function times(length, fn) {
+    return Array.from({ length }, (_, i) => fn(i));
+}
+/**
+ * @return a new array with elements that are not `null` or `undefined`.
+ */
+export function compact(arr) {
+    return arr == null ? [] : arr.filter((ea) => ea != null);
+}
+//# sourceMappingURL=array.js.map

package/dist/esm/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/array.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf;;;GAGG;AACH,MAAM,CAAC,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,MAAM,UAAU,IAAI,CAAI,GAAQ;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,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,MAAM,UAAU,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,MAAM,UAAU,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/esm/async.js

@@ -0,0 +1,109 @@
+import { availableParallelism } from "node:os";
+import { env } from "node:process";
+import { gt0, isNumber } from "./number.js";
+import { isBlank } from "./string.js";
+/**
+ * An error that is thrown when a promise does not resolve within the specified
+ * time.
+ */
+export 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);
+        }
+    }
+}
+/**
+ * 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 async function withTimeout(opts) {
+    const desc = isBlank(opts.desc) ? "thenOrTimeout()" : opts.desc;
+    if (!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 (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)
+ */
+export 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`.
+ */
+export async function mapConcurrent({ items, fn, maxConcurrency = availableParallelism(), }) {
+    // Validate maxConcurrency
+    if (!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/esm/async.js.map

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

package/dist/esm/cache.js

@@ -0,0 +1,25 @@
+/**
+ * Cache the result of a function for a given time-to-live (TTL).
+ */
+export 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/esm/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,UAAU,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/esm/debuglog.js

@@ -0,0 +1,30 @@
+import { debuglog, format } from "node:util";
+import { defer } from "./defer.js";
+// allow tests to reset the debug log context
+export const debugLogContext = defer(() => {
+    for (const ea of ["fs-metadata", "fs-meta"]) {
+        if (debuglog(ea).enabled) {
+            return ea;
+        }
+        if (debuglog(ea.toUpperCase()).enabled) {
+            return ea;
+        }
+    }
+    return "photostructure:fs-metadata";
+});
+export const isDebugEnabled = defer(() => {
+    return debuglog(debugLogContext()).enabled ?? false;
+});
+export function debug(msg, ...args) {
+    if (!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")}] ${debugLogContext()} `;
+    process.stderr.write(timestamp + format(msg, ...args) + "\n");
+}
+export function resetDebugLog() {
+    debugLogContext.reset();
+    isDebugEnabled.reset();
+}
+//# sourceMappingURL=debuglog.js.map

package/dist/esm/debuglog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debuglog.js","sourceRoot":"","sources":["../../src/debuglog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,6CAA6C;AAE7C,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,GAAG,EAAE;IACxC,KAAK,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,CAAC;QAC5C,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,QAAQ,CAAC,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;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,EAAE;IACvC,OAAO,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,GAAG,IAAe;IACnD,IAAI,CAAC,cAAc,EAAE;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,eAAe,EAAE,GAAG,CAAC;IAE/O,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,eAAe,CAAC,KAAK,EAAE,CAAC;IACxB,cAAc,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/esm/defer.js

@@ -0,0 +1,23 @@
+// src/defer.ts
+/**
+ * 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 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/esm/defer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.js","sourceRoot":"","sources":["../../src/defer.ts"],"names":[],"mappings":"AAAA,eAAe;AAMf;;;;;GAKG;AACH,MAAM,UAAU,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"}