@dbx-tools/fs 0.6.10

package/lib/src/local-path.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Local host path helpers for {@link LocalFileSystem}.
+ *
+ * Home / temp directory resolution lives in {@link ./os-path.ts}; this module
+ * owns `~` expansion and root resolution against that home.
+ *
+ * @module
+ */
+import { posixPath } from "@dbx-tools/shared-fs";
+import { type ResolveOsPathsOptions } from "./os-path.ts";
+export { APP_HOME, clearOsPathsCache, resolveLocalHome, resolveLocalTemp, resolveOsPaths, type OsPaths, type ResolveOsPathsOptions, } from "./os-path.ts";
+/** True when {@link input} is `~` or a path under `~/`. See {@link posixPath.isHomeRelativePath}. */
+export declare const isHomeRelativePath: typeof posixPath.isHomeRelativePath;
+/**
+ * Expand `~` / `~/...` against {@link home}, joining with the HOST separator.
+ * Non-home inputs are returned trimmed and unchanged.
+ */
+export declare function expandLocalHomePath(input: string, home?: string): string;
+/**
+ * Resolve a local filesystem root: expand `~` when needed, then `path.resolve`
+ * (so relative roots still land under `process.cwd()`).
+ */
+export declare function resolveLocalRoot(root: string, options?: ResolveOsPathsOptions): string;

package/lib/src/local-path.js

@@ -0,0 +1,30 @@
+/**
+ * Local host path helpers for {@link LocalFileSystem}.
+ *
+ * Home / temp directory resolution lives in {@link ./os-path.ts}; this module
+ * owns `~` expansion and root resolution against that home.
+ *
+ * @module
+ */
+import path from "node:path";
+import { posixPath } from "@dbx-tools/shared-fs";
+import { resolveLocalHome } from "./os-path.js";
+export { APP_HOME, clearOsPathsCache, resolveLocalHome, resolveLocalTemp, resolveOsPaths, } from "./os-path.js";
+/** True when {@link input} is `~` or a path under `~/`. See {@link posixPath.isHomeRelativePath}. */
+export const isHomeRelativePath = posixPath.isHomeRelativePath;
+/**
+ * Expand `~` / `~/...` against {@link home}, joining with the HOST separator.
+ * Non-home inputs are returned trimmed and unchanged.
+ */
+export function expandLocalHomePath(input, home = resolveLocalHome()) {
+    return posixPath.expandHome(input, home, path.join);
+}
+/**
+ * Resolve a local filesystem root: expand `~` when needed, then `path.resolve`
+ * (so relative roots still land under `process.cwd()`).
+ */
+export function resolveLocalRoot(root, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    return path.resolve(cwd, expandLocalHomePath(root, resolveLocalHome(options)));
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9jYWwtcGF0aC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sb2NhbC1wYXRoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7O0dBT0c7QUFFSCxPQUFPLElBQUksTUFBTSxXQUFXLENBQUM7QUFDN0IsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQ2pELE9BQU8sRUFBRSxnQkFBZ0IsRUFBOEIsTUFBTSxjQUFjLENBQUM7QUFFNUUsT0FBTyxFQUNMLFFBQVEsRUFDUixpQkFBaUIsRUFDakIsZ0JBQWdCLEVBQ2hCLGdCQUFnQixFQUNoQixjQUFjLEdBR2YsTUFBTSxjQUFjLENBQUM7QUFFdEIscUdBQXFHO0FBQ3JHLE1BQU0sQ0FBQyxNQUFNLGtCQUFrQixHQUFHLFNBQVMsQ0FBQyxrQkFBa0IsQ0FBQztBQUUvRDs7O0dBR0c7QUFDSCxNQUFNLFVBQVUsbUJBQW1CLENBQUMsS0FBYSxFQUFFLE9BQWUsZ0JBQWdCLEVBQUU7SUFDbEYsT0FBTyxTQUFTLENBQUMsVUFBVSxDQUFDLEtBQUssRUFBRSxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDO0FBQ3RELENBQUM7QUFFRDs7O0dBR0c7QUFDSCxNQUFNLFVBQVUsZ0JBQWdCLENBQUMsSUFBWSxFQUFFLFVBQWlDLEVBQUU7SUFDaEYsTUFBTSxHQUFHLEdBQUcsT0FBTyxDQUFDLEdBQUcsSUFBSSxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUM7SUFDekMsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLEdBQUcsRUFBRSxtQkFBbUIsQ0FBQyxJQUFJLEVBQUUsZ0JBQWdCLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDO0FBQ2pGLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIExvY2FsIGhvc3QgcGF0aCBoZWxwZXJzIGZvciB7QGxpbmsgTG9jYWxGaWxlU3lzdGVtfS5cbiAqXG4gKiBIb21lIC8gdGVtcCBkaXJlY3RvcnkgcmVzb2x1dGlvbiBsaXZlcyBpbiB7QGxpbmsgLi9vcy1wYXRoLnRzfTsgdGhpcyBtb2R1bGVcbiAqIG93bnMgYH5gIGV4cGFuc2lvbiBhbmQgcm9vdCByZXNvbHV0aW9uIGFnYWluc3QgdGhhdCBob21lLlxuICpcbiAqIEBtb2R1bGVcbiAqL1xuXG5pbXBvcnQgcGF0aCBmcm9tIFwibm9kZTpwYXRoXCI7XG5pbXBvcnQgeyBwb3NpeFBhdGggfSBmcm9tIFwiQGRieC10b29scy9zaGFyZWQtZnNcIjtcbmltcG9ydCB7IHJlc29sdmVMb2NhbEhvbWUsIHR5cGUgUmVzb2x2ZU9zUGF0aHNPcHRpb25zIH0gZnJvbSBcIi4vb3MtcGF0aC50c1wiO1xuXG5leHBvcnQge1xuICBBUFBfSE9NRSxcbiAgY2xlYXJPc1BhdGhzQ2FjaGUsXG4gIHJlc29sdmVMb2NhbEhvbWUsXG4gIHJlc29sdmVMb2NhbFRlbXAsXG4gIHJlc29sdmVPc1BhdGhzLFxuICB0eXBlIE9zUGF0aHMsXG4gIHR5cGUgUmVzb2x2ZU9zUGF0aHNPcHRpb25zLFxufSBmcm9tIFwiLi9vcy1wYXRoLnRzXCI7XG5cbi8qKiBUcnVlIHdoZW4ge0BsaW5rIGlucHV0fSBpcyBgfmAgb3IgYSBwYXRoIHVuZGVyIGB+L2AuIFNlZSB7QGxpbmsgcG9zaXhQYXRoLmlzSG9tZVJlbGF0aXZlUGF0aH0uICovXG5leHBvcnQgY29uc3QgaXNIb21lUmVsYXRpdmVQYXRoID0gcG9zaXhQYXRoLmlzSG9tZVJlbGF0aXZlUGF0aDtcblxuLyoqXG4gKiBFeHBhbmQgYH5gIC8gYH4vLi4uYCBhZ2FpbnN0IHtAbGluayBob21lfSwgam9pbmluZyB3aXRoIHRoZSBIT1NUIHNlcGFyYXRvci5cbiAqIE5vbi1ob21lIGlucHV0cyBhcmUgcmV0dXJuZWQgdHJpbW1lZCBhbmQgdW5jaGFuZ2VkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZXhwYW5kTG9jYWxIb21lUGF0aChpbnB1dDogc3RyaW5nLCBob21lOiBzdHJpbmcgPSByZXNvbHZlTG9jYWxIb21lKCkpOiBzdHJpbmcge1xuICByZXR1cm4gcG9zaXhQYXRoLmV4cGFuZEhvbWUoaW5wdXQsIGhvbWUsIHBhdGguam9pbik7XG59XG5cbi8qKlxuICogUmVzb2x2ZSBhIGxvY2FsIGZpbGVzeXN0ZW0gcm9vdDogZXhwYW5kIGB+YCB3aGVuIG5lZWRlZCwgdGhlbiBgcGF0aC5yZXNvbHZlYFxuICogKHNvIHJlbGF0aXZlIHJvb3RzIHN0aWxsIGxhbmQgdW5kZXIgYHByb2Nlc3MuY3dkKClgKS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlc29sdmVMb2NhbFJvb3Qocm9vdDogc3RyaW5nLCBvcHRpb25zOiBSZXNvbHZlT3NQYXRoc09wdGlvbnMgPSB7fSk6IHN0cmluZyB7XG4gIGNvbnN0IGN3ZCA9IG9wdGlvbnMuY3dkID8/IHByb2Nlc3MuY3dkKCk7XG4gIHJldHVybiBwYXRoLnJlc29sdmUoY3dkLCBleHBhbmRMb2NhbEhvbWVQYXRoKHJvb3QsIHJlc29sdmVMb2NhbEhvbWUob3B0aW9ucykpKTtcbn1cbiJdfQ==

package/lib/src/os-path.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Resolve durable local home and temp directories for Node hosts.
+ *
+ * Home order (mkdir + write/delete probe; failure skips):
+ * 1. `os.homedir()`
+ * 2. `HOME` / `USERPROFILE`
+ * 3. `/home/app` when {@link databricks.isAppEnv}
+ * 4. `./.home` under cwd
+ *
+ * Temp order (same ensure/probe/skip):
+ * 1. `os.tmpdir()`
+ * 2. `TMPDIR` / `TMP` / `TEMP`
+ * 3. `.tmp` under the resolved home
+ *
+ * Both paths are memoized per resolved cwd (same idea as
+ * `@dbx-tools/core` `project` command caching): cwd is part of the key because
+ * the `./.home` / `<home>/.tmp` fallbacks depend on it.
+ *
+ * @module
+ */
+/** Databricks Apps container home when {@link databricks.isAppEnv}. */
+export declare const APP_HOME = "/home/app";
+/** Resolved home + temp for one cwd. */
+export interface OsPaths {
+    readonly home: string;
+    readonly tmp: string;
+}
+/** Injectable knobs for {@link resolveOsPaths} (mostly tests). */
+export interface ResolveOsPathsOptions {
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    /** Defaults to `os.homedir`. */
+    homeDir?: () => string;
+    /** Defaults to `os.tmpdir`. */
+    tmpDir?: () => string;
+    /** App-env candidate; defaults to {@link APP_HOME}. */
+    appHome?: string;
+}
+/**
+ * Resolve home + temp for {@link cwd}, memoized when {@link cwd} is the process
+ * cwd (an explicit other cwd is computed fresh, matching core `project`
+ * caching).
+ */
+export declare function resolveOsPaths(options?: ResolveOsPathsOptions): OsPaths;
+/** {@link resolveOsPaths}.home */
+export declare function resolveLocalHome(options?: ResolveOsPathsOptions): string;
+/** {@link resolveOsPaths}.tmp */
+export declare function resolveLocalTemp(options?: ResolveOsPathsOptions): string;
+/** Drop memoized entries (tests). */
+export declare function clearOsPathsCache(): void;

package/lib/src/os-path.js

@@ -0,0 +1,143 @@
+/**
+ * Resolve durable local home and temp directories for Node hosts.
+ *
+ * Home order (mkdir + write/delete probe; failure skips):
+ * 1. `os.homedir()`
+ * 2. `HOME` / `USERPROFILE`
+ * 3. `/home/app` when {@link databricks.isAppEnv}
+ * 4. `./.home` under cwd
+ *
+ * Temp order (same ensure/probe/skip):
+ * 1. `os.tmpdir()`
+ * 2. `TMPDIR` / `TMP` / `TEMP`
+ * 3. `.tmp` under the resolved home
+ *
+ * Both paths are memoized per resolved cwd (same idea as
+ * `@dbx-tools/core` `project` command caching): cwd is part of the key because
+ * the `./.home` / `<home>/.tmp` fallbacks depend on it.
+ *
+ * @module
+ */
+import { mkdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import path from "node:path";
+import { databricks } from "@dbx-tools/appkit";
+/** Databricks Apps container home when {@link databricks.isAppEnv}. */
+export const APP_HOME = "/home/app";
+/** Memoized {@link OsPaths} keyed by resolved cwd. */
+const osPathsCache = new Map();
+/**
+ * Resolve home + temp for {@link cwd}, memoized when {@link cwd} is the process
+ * cwd (an explicit other cwd is computed fresh, matching core `project`
+ * caching).
+ */
+export function resolveOsPaths(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const cacheEnabled = cwd === path.resolve(process.cwd());
+    if (cacheEnabled) {
+        const hit = osPathsCache.get(cwd);
+        if (hit)
+            return hit;
+    }
+    const env = options.env ?? process.env;
+    const home = resolveHome(env, cwd, options);
+    const tmp = resolveTemp(env, home, options);
+    const resolved = { home, tmp };
+    if (cacheEnabled)
+        osPathsCache.set(cwd, resolved);
+    return resolved;
+}
+/** {@link resolveOsPaths}.home */
+export function resolveLocalHome(options = {}) {
+    return resolveOsPaths(options).home;
+}
+/** {@link resolveOsPaths}.tmp */
+export function resolveLocalTemp(options = {}) {
+    return resolveOsPaths(options).tmp;
+}
+/** Drop memoized entries (tests). */
+export function clearOsPathsCache() {
+    osPathsCache.clear();
+}
+function resolveHome(env, cwd, options) {
+    const tried = new Set();
+    const candidates = [
+        tryCall(options.homeDir ?? homedir),
+        env.HOME?.trim(),
+        env.USERPROFILE?.trim(),
+        databricks.isAppEnv(env) ? (options.appHome ?? APP_HOME) : undefined,
+    ];
+    for (const candidate of candidates) {
+        if (!candidate || tried.has(candidate))
+            continue;
+        tried.add(candidate);
+        if (isUsableDir(candidate))
+            return candidate;
+    }
+    const fallback = path.resolve(cwd, ".home");
+    if (!isUsableDir(fallback)) {
+        throw new Error(`Unable to create a writable home directory at ${fallback}`);
+    }
+    return fallback;
+}
+function resolveTemp(env, home, options) {
+    const tried = new Set();
+    // os.tmpdir first, then the standard override env vars (Node checks
+    // TMPDIR/TMP/TEMP on POSIX and TEMP/TMP on Windows inside tmpdir itself;
+    // listing them again lets a failed create/write fall through to the next).
+    const candidates = [
+        tryCall(options.tmpDir ?? tmpdir),
+        env.TMPDIR?.trim(),
+        env.TMP?.trim(),
+        env.TEMP?.trim(),
+    ];
+    for (const candidate of candidates) {
+        if (!candidate || tried.has(candidate))
+            continue;
+        tried.add(candidate);
+        if (isUsableDir(candidate))
+            return candidate;
+    }
+    const fallback = path.join(home, ".tmp");
+    if (!isUsableDir(fallback)) {
+        throw new Error(`Unable to create a writable temp directory at ${fallback}`);
+    }
+    return fallback;
+}
+function tryCall(fn) {
+    try {
+        return fn().trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * True when {@link dir} can be created (if missing) and a probe file can be
+ * written then deleted. Read-only or otherwise unusable dirs return false.
+ */
+function isUsableDir(dir) {
+    try {
+        mkdirSync(dir, { recursive: true });
+    }
+    catch {
+        return false;
+    }
+    const probe = path.join(dir, `.dbx-os-path-probe-${process.pid}-${process.hrtime.bigint()}`);
+    try {
+        writeFileSync(probe, "");
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        try {
+            unlinkSync(probe);
+        }
+        catch {
+            // Probe cleanup is best-effort; usability already decided by the write.
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3MtcGF0aC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9vcy1wYXRoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBbUJHO0FBRUgsT0FBTyxFQUFFLFNBQVMsRUFBRSxVQUFVLEVBQUUsYUFBYSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQy9ELE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQzFDLE9BQU8sSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUM3QixPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFFL0MsdUVBQXVFO0FBQ3ZFLE1BQU0sQ0FBQyxNQUFNLFFBQVEsR0FBRyxXQUFXLENBQUM7QUFvQnBDLHNEQUFzRDtBQUN0RCxNQUFNLFlBQVksR0FBRyxJQUFJLEdBQUcsRUFBbUIsQ0FBQztBQUVoRDs7OztHQUlHO0FBQ0gsTUFBTSxVQUFVLGNBQWMsQ0FBQyxVQUFpQyxFQUFFO0lBQ2hFLE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLEdBQUcsSUFBSSxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQztJQUN2RCxNQUFNLFlBQVksR0FBRyxHQUFHLEtBQUssSUFBSSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQztJQUN6RCxJQUFJLFlBQVksRUFBRSxDQUFDO1FBQ2pCLE1BQU0sR0FBRyxHQUFHLFlBQVksQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDbEMsSUFBSSxHQUFHO1lBQUUsT0FBTyxHQUFHLENBQUM7SUFDdEIsQ0FBQztJQUVELE1BQU0sR0FBRyxHQUFHLE9BQU8sQ0FBQyxHQUFHLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQztJQUN2QyxNQUFNLElBQUksR0FBRyxXQUFXLENBQUMsR0FBRyxFQUFFLEdBQUcsRUFBRSxPQUFPLENB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QUFDSCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBSZXNvbHZlIGR1cmFibGUgbG9jYWwgaG9tZSBhbmQgdGVtcCBkaXJlY3RvcmllcyBmb3IgTm9kZSBob3N0cy5cbiAqXG4gKiBIb21lIG9yZGVyIChta2RpciArIHdyaXRlL2RlbGV0ZSBwcm9iZTsgZmFpbHVyZSBza2lwcyk6XG4gKiAxLiBgb3MuaG9tZWRpcigpYFxuICogMi4gYEhPTUVgIC8gYFVTRVJQUk9GSUxFYFxuICogMy4gYC9ob21lL2FwcGAgd2hlbiB7QGxpbmsgZGF0YWJyaWNrcy5pc0FwcEVudn1cbiAqIDQuIGAuLy5ob21lYCB1bmRlciBjd2RcbiAqXG4gKiBUZW1wIG9yZGVyIChzYW1lIGVuc3VyZS9wcm9iZS9za2lwKTpcbiAqIDEuIGBvcy50bXBkaXIoKWBcbiAqIDIuIGBUTVBESVJgIC8gYFRNUGAgLyBgVEVNUGBcbiAqIDMuIGAudG1wYCB1bmRlciB0aGUgcmVzb2x2ZWQgaG9tZVxuICpcbiAqIEJvdGggcGF0aHMgYXJlIG1lbW9pemVkIHBlciByZXNvbHZlZCBjd2QgKHNhbWUgaWRlYSBhc1xuICogYEBkYngtdG9vbHMvY29yZWAgYHByb2plY3RgIGNvbW1hbmQgY2FjaGluZyk6IGN3ZCBpcyBwYXJ0IG9mIHRoZSBrZXkgYmVjYXVzZVxuICogdGhlIGAuLy5ob21lYCAvIGA8aG9tZT4vLnRtcGAgZmFsbGJhY2tzIGRlcGVuZCBvbiBpdC5cbiAqXG4gKiBAbW9kdWxlXG4gKi9cblxuaW1wb3J0IHsgbWtkaXJTeW5jLCB1bmxpbmtTeW5jLCB3cml0ZUZpbGVTeW5jIH0gZnJvbSBcIm5vZGU6ZnNcIjtcbmltcG9ydCB7IGhvbWVkaXIsIHRtcGRpciB9IGZyb20gXCJub2RlOm9zXCI7XG5pbXBvcnQgcGF0aCBmcm9tIFwibm9kZTpwYXRoXCI7XG5pbXBvcnQgeyBkYXRhYnJpY2tzIH0gZnJvbSBcIkBkYngtdG9vbHMvYXBwa2l0XCI7XG5cbi8qKiBEYXRhYnJpY2tzIEFwcHMgY29udGFpbmVyIGhvbWUgd2hlbiB7QGxpbmsgZGF0YWJyaWNrcy5pc0FwcEVudn0uICovXG5leHBvcnQgY29uc3QgQVBQX0hPTUUgPSBcIi9ob21lL2FwcFwiO1xuXG4vKiogUmVzb2x2ZWQgaG9tZSArIHRlbXAgZm9yIG9uZSBjd2QuICovXG5leHBvcnQgaW50ZXJmYWNlIE9zUGF0aHMge1xuICByZWFkb25seSBob21lOiBzdHJpbmc7XG4gIHJlYWRvbmx5IHRtcDogc3RyaW5nO1xufVxuXG4vKiogSW5qZWN0YWJsZSBrbm9icyBmb3Ige0BsaW5rIHJlc29sdmVPc1BhdGhzfSAobW9zdGx5IHRlc3RzKS4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVzb2x2ZU9zUGF0aHNPcHRpb25zIHtcbiAgZW52PzogTm9kZUpTLlByb2Nlc3NFbnY7XG4gIGN3ZD86IHN0cmluZztcbiAgLyoqIERlZmF1bHRzIHRvIGBvcy5ob21lZGlyYC4gKi9cbiAgaG9tZURpcj86ICgpID0+IHN0cmluZztcbiAgLyoqIERlZmF1bHRzIHRvIGBvcy50bXBkaXJgLiAqL1xuICB0bXBEaXI/OiAoKSA9PiBzdHJpbmc7XG4gIC8qKiBBcHAtZW52IGNhbmRpZGF0ZTsgZGVmYXVsdHMgdG8ge0BsaW5rIEFQUF9IT01FfS4gKi9cbiAgYXBwSG9tZT86IHN0cmluZztcbn1cblxuLyoqIE1lbW9pemVkIHtAbGluayBPc1BhdGhzfSBrZXllZCBieSByZXNvbHZlZCBjd2QuICovXG5jb25zdCBvc1BhdGhzQ2FjaGUgPSBuZXcgTWFwPHN0cmluZywgT3NQYXRocz4oKTtcblxuLyoqXG4gKiBSZXNvbHZlIGhvbWUgKyB0ZW1wIGZvciB7QGxpbmsgY3dkfSwgbWVtb2l6ZWQgd2hlbiB7QGxpbmsgY3dkfSBpcyB0aGUgcHJvY2Vzc1xuICogY3dkIChhbiBleHBsaWNpdCBvdGhlciBjd2QgaXMgY29tcHV0ZWQgZnJlc2gsIG1hdGNoaW5nIGNvcmUgYHByb2plY3RgXG4gKiBjYWNoaW5nKS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlc29sdmVPc1BhdGhzKG9wdGlvbnM6IFJlc29sdmVPc1BhdGhzT3B0aW9ucyA9IHt9KTogT3NQYXRocyB7XG4gIGNvbnN0IGN3ZCA9IHBhdGgucmVzb2x2ZShvcHRpb25zLmN3ZCA/PyBwcm9jZXNzLmN3ZCgpKTtcbiAgY29uc3QgY2FjaGVFbmFibGVkID0gY3dkID09PSBwYXRoLnJlc29sdmUocHJvY2Vzcy5jd2QoKSk7XG4gIGlmIChjYWNoZUVuYWJsZWQpIHtcbiAgICBjb25zdCBoaXQgPSBvc1BhdGhzQ2FjaGUuZ2V0KGN3ZCk7XG4gICAgaWYgKGhpdCkgcmV0dXJuIGhpdDtcbiAgfVxuXG4gIGNvbnN0IGVudiA9IG9wdGlvbnMuZW52ID8/IHByb2Nlc3MuZW52O1xuICBjb25zdCBob21lID0gcmVzb2x2ZUhvbWUoZW52LCBjd2QsIG9wdGlvbnMpO1xuICBjb25zdCB0bXAgPSByZXNvbHZlVGVtcChlbnYsIGhvbWUsIG9wdGlvbnMpO1xuICBjb25zdCByZXNvbHZlZDogT3NQYXRocyA9IHsgaG9tZSwgdG1wIH07XG5cbiAgaWYgKGNhY2hlRW5hYmxlZCkgb3NQYXRoc0NhY2hlLnNldChjd2QsIHJlc29sdmVkKTtcbiAgcmV0dXJuIHJlc29sdmVkO1xufVxuXG4vKioge0BsaW5rIHJlc29sdmVPc1BhdGhzfS5ob21lICovXG5leHBvcnQgZnVuY3Rpb24gcmVzb2x2ZUxvY2FsSG9tZShvcHRpb25zOiBSZXNvbHZlT3NQYXRoc09wdGlvbnMgPSB7fSk6IHN0cmluZyB7XG4gIHJldHVybiByZXNvbHZlT3NQYXRocyhvcHRpb25zKS5ob21lO1xufVxuXG4vKioge0BsaW5rIHJlc29sdmVPc1BhdGhzfS50bXAgKi9cbmV4cG9ydCBmdW5jdGlvbiByZXNvbHZlTG9jYWxUZW1wKG9wdGlvbnM6IFJlc29sdmVPc1BhdGhzT3B0aW9ucyA9IHt9KTogc3RyaW5nIHtcbiAgcmV0dXJuIHJlc29sdmVPc1BhdGhzKG9wdGlvbnMpLnRtcDtcbn1cblxuLyoqIERyb3AgbWVtb2l6ZWQgZW50cmllcyAodGVzdHMpLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNsZWFyT3NQYXRoc0NhY2hlKCk6IHZvaWQge1xuICBvc1BhdGhzQ2FjaGUuY2xlYXIoKTtcbn1cblxuZnVuY3Rpb24gcmVzb2x2ZUhvbWUoZW52OiBOb2RlSlMuUHJvY2Vzc0VudiwgY3dkOiBzdHJpbmcsIG9wdGlvbnM6IFJlc29sdmVPc1BhdGhzT3B0aW9ucyk6IHN0cmluZyB7XG4gIGNvbnN0IHRyaWVkID0gbmV3IFNldDxzdHJpbmc+KCk7XG4gIGNvbnN0IGNhbmRpZGF0ZXM6IEFycmF5PHN0cmluZyB8IHVuZGVmaW5lZD4gPSBbXG4gICAgdHJ5Q2FsbChvcHRpb25zLmhvbWVEaXIgPz8gaG9tZWRpciksXG4gICAgZW52LkhPTUU/LnRyaW0oKSxcbiAgICBlbnYuVVNFUlBST0ZJTEU/LnRyaW0oKSxcbiAgICBkYXRhYnJpY2tzLmlzQXBwRW52KGVudikgPyAob3B0aW9ucy5hcHBIb21lID8/IEFQUF9IT01FKSA6IHVuZGVmaW5lZCxcbiAgXTtcblxuICBmb3IgKGNvbnN0IGNhbmRpZGF0ZSBvZiBjYW5kaWRhdGVzKSB7XG4gICAgaWYgKCFjYW5kaWRhdGUgfHwgdHJpZWQuaGFzKGNhbmRpZGF0ZSkpIGNvbnRpbnVlO1xuICAgIHRyaWVkLmFkZChjYW5kaWRhdGUpO1xuICAgIGlmIChpc1VzYWJsZURpcihjYW5kaWRhdGUpKSByZXR1cm4gY2FuZGlkYXRlO1xuICB9XG5cbiAgY29uc3QgZmFsbGJhY2sgPSBwYXRoLnJlc29sdmUoY3dkLCBcIi5ob21lXCIpO1xuICBpZiAoIWlzVXNhYmxlRGlyKGZhbGxiYWNrKSkge1xuICAgIHRocm93IG5ldyBFcnJvcihgVW5hYmxlIHRvIGNyZWF0ZSBhIHdyaXRhYmxlIGhvbWUgZGlyZWN0b3J5IGF0ICR7ZmFsbGJhY2t9YCk7XG4gIH1cbiAgcmV0dXJuIGZhbGxiYWNrO1xufVxuXG5mdW5jdGlvbiByZXNvbHZlVGVtcChlbnY6IE5vZGVKUy5Qcm9jZXNzRW52LCBob21lOiBzdHJpbmcsIG9wdGlvbnM6IFJlc29sdmVPc1BhdGhzT3B0aW9ucyk6IHN0cmluZyB7XG4gIGNvbnN0IHRyaWVkID0gbmV3IFNldDxzdHJpbmc+KCk7XG4gIC8vIG9zLnRtcGRpciBmaXJzdCwgdGhlbiB0aGUgc3RhbmRhcmQgb3ZlcnJpZGUgZW52IHZhcnMgKE5vZGUgY2hlY2tzXG4gIC8vIFRNUERJUi9UTVAvVEVNUCBvbiBQT1NJWCBhbmQgVEVNUC9UTVAgb24gV2luZG93cyBpbnNpZGUgdG1wZGlyIGl0c2VsZjtcbiAgLy8gbGlzdGluZyB0aGVtIGFnYWluIGxldHMgYSBmYWlsZWQgY3JlYXRlL3dyaXRlIGZhbGwgdGhyb3VnaCB0byB0aGUgbmV4dCkuXG4gIGNvbnN0IGNhbmRpZGF0ZXM6IEFycmF5PHN0cmluZyB8IHVuZGVmaW5lZD4gPSBbXG4gICAgdHJ5Q2FsbChvcHRpb25zLnRtcERpciA/PyB0bXBkaXIpLFxuICAgIGVudi5UTVBESVI/LnRyaW0oKSxcbiAgICBlbnYuVE1QPy50cmltKCksXG4gICAgZW52LlRFTVA/LnRyaW0oKSxcbiAgXTtcblxuICBmb3IgKGNvbnN0IGNhbmRpZGF0ZSBvZiBjYW5kaWRhdGVzKSB7XG4gICAgaWYgKCFjYW5kaWRhdGUgfHwgdHJpZWQuaGFzKGNhbmRpZGF0ZSkpIGNvbnRpbnVlO1xuICAgIHRyaWVkLmFkZChjYW5kaWRhdGUpO1xuICAgIGlmIChpc1VzYWJsZURpcihjYW5kaWRhdGUpKSByZXR1cm4gY2FuZGlkYXRlO1xuICB9XG5cbiAgY29uc3QgZmFsbGJhY2sgPSBwYXRoLmpvaW4oaG9tZSwgXCIudG1wXCIpO1xuICBpZiAoIWlzVXNhYmxlRGlyKGZhbGxiYWNrKSkge1xuICAgIHRocm93IG5ldyBFcnJvcihgVW5hYmxlIHRvIGNyZWF0ZSBhIHdyaXRhYmxlIHRlbXAgZGlyZWN0b3J5IGF0ICR7ZmFsbGJhY2t9YCk7XG4gIH1cbiAgcmV0dXJuIGZhbGxiYWNrO1xufVxuXG5mdW5jdGlvbiB0cnlDYWxsKGZuOiAoKSA9PiBzdHJpbmcpOiBzdHJpbmcgfCB1bmRlZmluZWQge1xuICB0cnkge1xuICAgIHJldHVybiBmbigpLnRyaW0oKSB8fCB1bmRlZmluZWQ7XG4gIH0gY2F0Y2gge1xuICAgIHJldHVybiB1bmRlZmluZWQ7XG4gIH1cbn1cblxuLyoqXG4gKiBUcnVlIHdoZW4ge0BsaW5rIGRpcn0gY2FuIGJlIGNyZWF0ZWQgKGlmIG1pc3NpbmcpIGFuZCBhIHByb2JlIGZpbGUgY2FuIGJlXG4gKiB3cml0dGVuIHRoZW4gZGVsZXRlZC4gUmVhZC1vbmx5IG9yIG90aGVyd2lzZSB1bnVzYWJsZSBkaXJzIHJldHVybiBmYWxzZS5cbiAqL1xuZnVuY3Rpb24gaXNVc2FibGVEaXIoZGlyOiBzdHJpbmcpOiBib29sZWFuIHtcbiAgdHJ5IHtcbiAgICBta2RpclN5bmMoZGlyLCB7IHJlY3Vyc2l2ZTogdHJ1ZSB9KTtcbiAgfSBjYXRjaCB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG5cbiAgY29uc3QgcHJvYmUgPSBwYXRoLmpvaW4oZGlyLCBgLmRieC1vcy1wYXRoLXByb2JlLSR7cHJvY2Vzcy5waWR9LSR7cHJvY2Vzcy5ocnRpbWUuYmlnaW50KCl9YCk7XG4gIHRyeSB7XG4gICAgd3JpdGVGaWxlU3luYyhwcm9iZSwgXCJcIik7XG4gICAgcmV0dXJuIHRydWU7XG4gIH0gY2F0Y2gge1xuICAgIHJldHVybiBmYWxzZTtcbiAgfSBmaW5hbGx5IHtcbiAgICB0cnkge1xuICAgICAgdW5saW5rU3luYyhwcm9iZSk7XG4gICAgfSBjYXRjaCB7XG4gICAgICAvLyBQcm9iZSBjbGVhbnVwIGlzIGJlc3QtZWZmb3J0OyB1c2FiaWxpdHkgYWxyZWFkeSBkZWNpZGVkIGJ5IHRoZSB3cml0ZS5cbiAgICB9XG4gIH1cbn1cbiJdfQ==

package/lib/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/local-fs.ts","../src/local-path.ts","../src/os-path.ts","../index.ts"],"version":"5.9.3"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@dbx-tools/fs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reggie-db/dbx-tools.git",
+    "directory": "packages/node/fs"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "tsx": "^4.23.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@dbx-tools/appkit": "0.6.10",
+    "@dbx-tools/shared-core": "0.6.10",
+    "@dbx-tools/shared-fs": "0.6.10"
+  },
+  "main": "./lib/index.js",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.6.10",
+  "types": "./lib/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "lib"
+  ],
+  "dbxToolsConfig": {
+    "tags": [
+      "node"
+    ]
+  },
+  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"pnpm exec projen\".",
+  "scripts": {
+    "build": "projen build",
+    "compile": "projen compile",
+    "default": "projen default",
+    "package": "projen package",
+    "post-compile": "projen post-compile",
+    "pre-compile": "projen pre-compile",
+    "test": "projen test",
+    "watch": "projen watch",
+    "projen": "projen"
+  }
+}