@entity-access/server-pages 1.1.620 → 1.1.623

package/dist/cache/BaseDiskCache.d.ts

@@ -0,0 +1,34 @@
+import TempFolder from "../core/TempFolder.js";
+import { LocalFile } from "../core/LocalFile.js";
+export interface IDiskCacheContainer {
+    cache: BaseDiskCache;
+}
+export default class BaseDiskCache {
+    protected readonly root: string;
+    protected readonly keepTTLSeconds: number;
+    protected readonly minSize: number;
+    protected readonly updateAccessTime: boolean;
+    protected readonly maxAge: number;
+    protected readonly minAge: number;
+    constructor({ root, keepTTLSeconds, minSize, updateAccessTime, maxAge, minAge }: {
+        root: string;
+        keepTTLSeconds?: number;
+        minSize?: number;
+        updateAccessTime?: boolean;
+        maxAge?: number;
+        minAge?: number;
+    });
+    newFolder(suffix?: string): TempFolder;
+    get(path: string): Promise<LocalFile>;
+    clear(): Promise<void>;
+    clearFolder(path: string): Promise<void>;
+    getOrCreateJsonAsync<T>(path: string, factory: () => Promise<T>): Promise<T>;
+    deleteAt(path: string): Promise<void>;
+    getOrCreateAsync(path: string, factory: (fx: LocalFile) => Promise<void>, ext?: string): Promise<LocalFile>;
+    createTempFileDeleteOnExit(pathFragments: string[], name: string, contentType: string): LocalFile;
+    protected deleteFile(path: string): Promise<void>;
+    protected isEmptyDir(path: any): Promise<boolean>;
+    protected clean(): Promise<void>;
+    private getFileStats;
+}
+//# sourceMappingURL=BaseDiskCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseDiskCache.d.ts","sourceRoot":"","sources":["../../src/cache/BaseDiskCache.ts"],"names":[],"mappings":"AAOA,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AASjD,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,CAAC,OAAO,OAAO,aAAa;IAE9B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAC1C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAC7C,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAE9B,EACI,IAAI,EACJ,cAAqB,EACrB,OAAiC,EACjC,gBAAuB,EACvB,MAAU,EACV,MAAU,EACb,EAAE;QACC,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB;IAaL,SAAS,CAAC,MAAM,SAAK;IAIf,GAAG,CAAC,IAAI,EAAE,MAAM;IAWhB,KAAK;IAgBL,WAAW,CAAC,IAAI,EAAE,MAAM;IAexB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;IASrE,QAAQ,CAAC,IAAI,EAAE,MAAM;IAKf,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,SAAS;IA8C5F,0BAA0B,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;cAWrE,UAAU,CAAC,IAAI,EAAE,MAAM;cA2BvB,UAAU,CAAC,IAAI,KAAA;cAcf,KAAK;YA6DP,YAAY;CAqD7B"}

package/dist/cache/BaseDiskCache.js

@@ -0,0 +1,325 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+/* eslint-disable no-console */
+import fsp, { opendir, rm, rmdir, stat, unlink } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join, parse } from "node:path";
+import { randomUUID } from "node:crypto";
+import EntityAccessError from "@entity-access/entity-access/dist/common/EntityAccessError.js";
+import ensureDir from "../core/FileApi.js";
+import TempFolder from "../core/TempFolder.js";
+import { LocalFile } from "../core/LocalFile.js";
+import { spawnPromise } from "./spawnPromise.js";
+import LockFile from "./LockFile.js";
+import sleep from "../sleep.js";
+import RunOnce from "../core/RunOnce.js";
+import { toKMBString } from "../core/NumberFormats.js";
+const doNothing = () => void 0;
+export default class BaseDiskCache {
+    constructor({ root, keepTTLSeconds = 3600, minSize = Number.MAX_SAFE_INTEGER, updateAccessTime = true, maxAge = 1, minAge = 1 }) {
+        this.root = root;
+        this.keepTTLSeconds = keepTTLSeconds;
+        this.minSize = minSize;
+        this.updateAccessTime = updateAccessTime;
+        this.maxAge = maxAge;
+        this.minAge = minAge;
+        ensureDir(root);
+        // eslint-disable-next-line no-console
+        setTimeout(() => this.clean().catch(console.error), 1000);
+    }
+    newFolder(suffix = "") {
+        return new TempFolder(suffix, this.root);
+    }
+    async get(path) {
+        path = join(this.root, path);
+        if (existsSync(path)) {
+            if (this.updateAccessTime) {
+                const now = new Date();
+                await fsp.utimes(path, now, now);
+            }
+            return new LocalFile(path, void 0, void 0, doNothing);
+        }
+    }
+    async clear() {
+        try {
+            const env_1 = { stack: [], error: void 0, hasError: false };
+            try {
+                const path = this.root;
+                const _lock = __addDisposableResource(env_1, await LockFile.lock(`df-clear:${path}`), false);
+                if (!existsSync(path)) {
+                    return;
+                }
+                const stalePath = `${path}.old.${Date.now()}`;
+                await spawnPromise("mv", [path, stalePath]);
+                ensureDir(this.root);
+                rm(stalePath, { recursive: true, force: true }).catch(console.error);
+            }
+            catch (e_1) {
+                env_1.error = e_1;
+                env_1.hasError = true;
+            }
+            finally {
+                __disposeResources(env_1);
+            }
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+    async clearFolder(path) {
+        try {
+            const env_2 = { stack: [], error: void 0, hasError: false };
+            try {
+                const _lock = __addDisposableResource(env_2, await LockFile.lock(`df-clear:${path}`), false);
+                path = join(this.root, path);
+                if (!existsSync(path)) {
+                    return;
+                }
+                const stalePath = `${path}.old.${Date.now()}`;
+                await spawnPromise("mv", [path, stalePath]);
+                rm(stalePath, { recursive: true, force: true }).catch(console.error);
+            }
+            catch (e_2) {
+                env_2.error = e_2;
+                env_2.hasError = true;
+            }
+            finally {
+                __disposeResources(env_2);
+            }
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+    async getOrCreateJsonAsync(path, factory) {
+        const localFile = await this.getOrCreateAsync(path, async (lf) => {
+            const data = (await factory()) ?? null;
+            await lf.writeAllText(JSON.stringify(data));
+        });
+        const text = await localFile.readAsText();
+        return JSON.parse(text);
+    }
+    deleteAt(path) {
+        path = join(this.root, path);
+        return unlink(path);
+    }
+    async getOrCreateAsync(path, factory, ext = ".dat") {
+        path = join(this.root, path);
+        const parsedPath = parse(path);
+        ensureDir(parsedPath.dir);
+        let error;
+        for (let index = 0; index < 5; index++) {
+            const env_3 = { stack: [], error: void 0, hasError: false };
+            try {
+                if (existsSync(path)) {
+                    if (this.updateAccessTime) {
+                        const now = new Date();
+                        await fsp.utimes(path, now, now);
+                    }
+                    return new LocalFile(path, void 0, void 0, doNothing);
+                }
+                const _lock = __addDisposableResource(env_3, await LockFile.lock(`df:${path}`), false);
+                if (existsSync(path)) {
+                    return new LocalFile(path, void 0, void 0, doNothing);
+                }
+                const tmpPath = join(this.root, randomUUID() + (parsedPath.ext || ext));
+                await factory(new LocalFile(tmpPath, void 0, void 0, doNothing));
+                try {
+                    ensureDir(parsedPath.dir);
+                    await fsp.rename(tmpPath, path);
+                }
+                catch (e) {
+                    if (existsSync(tmpPath)) {
+                        unlink(tmpPath).catch(doNothing);
+                    }
+                    error = e;
+                    await sleep(1000);
+                    continue;
+                }
+                return new LocalFile(path, void 0, void 0, doNothing);
+            }
+            catch (e_3) {
+                env_3.error = e_3;
+                env_3.hasError = true;
+            }
+            finally {
+                __disposeResources(env_3);
+            }
+        }
+        throw new EntityAccessError(`Failed to write file due to error ${error.stack ?? error}`);
+    }
+    createTempFileDeleteOnExit(pathFragments, name, contentType) {
+        const fileName = pathFragments.pop();
+        let folder = void 0;
+        if (pathFragments.length) {
+            folder = join(this.root, ...pathFragments);
+            ensureDir(folder);
+        }
+        const path = join(this.root, ...pathFragments, fileName);
+        return new LocalFile(path, name, contentType, () => unlink(path).then(() => folder ? rmdir(folder).catch(console.error) : void 0, console.error));
+    }
+    async deleteFile(path) {
+        if (!path.startsWith(this.root)) {
+            return;
+        }
+        if (existsSync(path)) {
+            await unlink(path);
+        }
+        for (;;) {
+            const parsed = parse(path);
+            if (parsed.dir === this.root) {
+                break;
+            }
+            path = parsed.dir;
+            try {
+                if (existsSync(path)) {
+                    // check if folder is empty...
+                    if (await this.isEmptyDir(path)) {
+                        await rmdir(path);
+                    }
+                }
+            }
+            catch (error) {
+                console.error(error);
+                return;
+            }
+        }
+    }
+    async isEmptyDir(path) {
+        try {
+            const directory = await opendir(path);
+            const entry = await directory.read();
+            await directory.close();
+            return entry === null; // It's empty if the first entry read is null
+        }
+        catch (error) {
+            // Catches errors like 'ENOENT' (directory doesn't exist)
+            // and treats the path as effectively "empty" for the purpose of the check.
+            // Adjust error handling as needed for your specific use case.
+            return true;
+        }
+    }
+    async clean() {
+        if (!await RunOnce.canRun(this.root)) {
+            setTimeout(() => this.clean().catch(console.error), 60000);
+            return;
+        }
+        const start = Date.now();
+        let total = 0;
+        const min = this.minAge;
+        let all = null;
+        let freeSize = 0;
+        let deleted = 0;
+        for (let i = this.maxAge; i >= min; i--) {
+            const s = await fsp.statfs(this.root);
+            freeSize = s.bavail * s.bsize;
+            if (freeSize >= this.minSize) {
+                break;
+            }
+            all ??= await this.getFileStats();
+            try {
+                const keep = Date.now() - this.keepTTLSeconds * 1000 * i;
+                const pending = [];
+                for (const file of all) {
+                    if (file.time < keep) {
+                        await this.deleteFile(file.path);
+                        deleted++;
+                        total += file.size;
+                        continue;
+                    }
+                    pending.push(file);
+                }
+                all = pending;
+                if (!all.length) {
+                    break;
+                }
+            }
+            catch (error) {
+                console.error(error);
+            }
+        }
+        if (total) {
+            console.log(`${this.root} (${deleted}/${all.length + deleted}) cleaned, ${toKMBString(total)} freed in ${Date.now() - start}ms.`);
+        }
+        else {
+            if (all?.length) {
+                if (this.minSize === Number.MAX_SAFE_INTEGER) {
+                    console.log(`Cleaning ${this.root} with entries (${all.length}) for ${Date.now() - start}ms.`);
+                }
+                else {
+                    console.log(`Cleaning ${this.root} with entries (${all.length}) for ${Date.now() - start}ms as ${toKMBString(freeSize)} < ${toKMBString(this.minSize)}.`);
+                }
+            }
+        }
+        setTimeout(() => this.clean().catch(console.error), 60000);
+    }
+    async getFileStats() {
+        const min = Date.now() - this.minAge * this.keepTTLSeconds * 1000;
+        const files = [];
+        const dir = await fsp.opendir(this.root, { recursive: true });
+        for await (const entry of dir) {
+            if (!entry.isFile()) {
+                continue;
+            }
+            const f = join(entry.parentPath, entry.name);
+            const s = await stat(f);
+            const time = s.ctimeMs;
+            if (time > min) {
+                continue;
+            }
+            files.push({ path: f, size: s.size, time });
+        }
+        return files;
+    }
+}
+//# sourceMappingURL=BaseDiskCache.js.map

package/dist/cache/BaseDiskCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseDiskCache.js","sourceRoot":"","sources":["../../src/cache/BaseDiskCache.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+BAA+B;AAC/B,OAAO,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,iBAAiB,MAAM,+DAA+D,CAAC;AAC9F,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,MAAM,aAAa,CAAC;AAChC,OAAO,OAAO,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAM/B,MAAM,CAAC,OAAO,OAAO,aAAa;IAQ9B,YACI,EACI,IAAI,EACJ,cAAc,GAAG,IAAI,EACrB,OAAO,GAAG,MAAM,CAAC,gBAAgB,EACjC,gBAAgB,GAAG,IAAI,EACvB,MAAM,GAAG,CAAC,EACV,MAAM,GAAG,CAAC,EAQb;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,sCAAsC;QACtC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,SAAS,CAAC,MAAM,GAAG,EAAE;QACjB,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY;QAClB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,IAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACvB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC;;;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACvB,MAAM,KAAK,kCAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,QAAA,CAAC;gBACtD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpB,OAAO;gBACX,CAAC;gBACD,MAAM,SAAS,GAAG,GAAG,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAC9C,MAAM,YAAY,CAAC,IAAI,EAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;gBAC3C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;;;;;;;;;SACvE;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY;QAC1B,IAAI,CAAC;;;gBACD,MAAM,KAAK,kCAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,QAAA,CAAC;gBACtD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpB,OAAO;gBACX,CAAC;gBACD,MAAM,SAAS,GAAG,GAAG,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAC9C,MAAM,YAAY,CAAC,IAAI,EAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;gBAC3C,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;;;;;;;;;SACvE;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAI,IAAY,EAAE,OAAyB;QACjE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YAC7D,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC;YACvC,MAAM,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IACjC,CAAC;IAED,QAAQ,CAAC,IAAY;QACjB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,OAAyC,EAAE,GAAG,GAAG,MAAM;QACxF,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE7B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAE1B,IAAI,KAAY,CAAC;QAEjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;;;gBACrC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnB,IAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;wBACvB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;wBACvB,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;oBACrC,CAAC;oBACD,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;gBAC1D,CAAC;gBAED,MAAM,KAAK,kCAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,QAAA,CAAC;gBAEhD,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnB,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;gBAC1D,CAAC;gBAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;gBAExE,MAAM,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;gBAEjE,IAAI,CAAC;oBACD,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC1B,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBAET,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;wBACtB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;oBACrC,CAAC;oBAED,KAAK,GAAG,CAAC,CAAC;oBACV,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;oBAClB,SAAS;gBACb,CAAC;gBACD,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;;;;;;;;;SACzD;QAED,MAAM,IAAI,iBAAiB,CAAC,qCAAqC,KAAK,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,0BAA0B,CAAC,aAAuB,EAAE,IAAY,EAAE,WAAmB;QACjF,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC;QACrC,IAAI,MAAM,GAAG,KAAK,CAAC,CAAC;QACpB,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAI,aAAa,CAAC,CAAC;YAC5C,SAAS,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAI,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC1D,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACvJ,CAAC;IAES,KAAK,CAAC,UAAU,CAAC,IAAY;QACnC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO;QACX,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,SAAQ,CAAC;YACL,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC3B,MAAM;YACV,CAAC;YACD,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;YAClB,IAAI,CAAC;gBACD,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnB,8BAA8B;oBAC9B,IAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC7B,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;oBACtB,CAAC;gBACL,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACrB,OAAO;YACX,CAAC;QACL,CAAC;IACL,CAAC;IAES,KAAK,CAAC,UAAU,CAAC,IAAI;QAC3B,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,6CAA6C;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,yDAAyD;YACzD,2EAA2E;YAC3E,8DAA8D;YAC9D,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAES,KAAK,CAAC,KAAK;QAEjB,IAAI,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;YAC3D,OAAO;QACX,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QAExB,IAAI,GAAG,GAAG,IAA+B,CAAC;QAC1C,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAI,IAAI,CAAC,GAAC,IAAI,CAAC,MAAM,EAAC,CAAC,IAAG,GAAG,EAAC,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,QAAQ,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;YAE9B,IAAI,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM;YACV,CAAC;YACD,GAAG,KAAK,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAClC,IAAI,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC;gBACzD,MAAM,OAAO,GAAG,EAAE,CAAC;gBACnB,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;oBACrB,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;wBACnB,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACjC,OAAO,EAAE,CAAC;wBACV,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC;wBACnB,SAAS;oBACb,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;gBACD,GAAG,GAAG,OAAO,CAAC;gBACd,IAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;oBACb,MAAM;gBACV,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACL,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACR,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,GAAG,OAAO,cAAc,WAAW,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,GAAG,EAAE,GAAC,KAAK,KAAK,CAAC,CAAC;QACpI,CAAC;aAAM,CAAC;YACJ,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC;gBACd,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,gBAAgB,EAAE,CAAC;oBAC3C,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,IAAI,kBAAkB,GAAG,CAAC,MAAM,SAAS,IAAI,CAAC,GAAG,EAAE,GAAC,KAAK,KAAK,CAAC,CAAC;gBACjG,CAAC;qBAAM,CAAC;oBACJ,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,IAAI,kBAAkB,GAAG,CAAC,MAAM,SAAS,IAAI,CAAC,GAAG,EAAE,GAAC,KAAK,SAAS,WAAW,CAAC,QAAQ,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC5J,CAAC;YACL,CAAC;QACL,CAAC;QAED,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAE/D,CAAC;IAEO,KAAK,CAAC,YAAY;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAClE,MAAM,KAAK,GAAG,EAAoD,CAAC;QACnE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAClB,SAAS;YACb,CAAC;YACD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC;YACvB,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;gBACb,SAAS;YACb,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;CAoCJ"}

package/dist/cache/LockFile.d.ts

@@ -0,0 +1,13 @@
+export default class LockFile implements Disposable {
+    private readonly lockFile;
+    static lock(someKey: string, timeout?: number, interval?: number, throwOnFail?: boolean): Promise<LockFile | {
+        locked: boolean;
+        timer: any;
+        [Symbol.dispose](): void;
+    }>;
+    timer: any;
+    locked: any;
+    constructor(lockFile: any);
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=LockFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LockFile.d.ts","sourceRoot":"","sources":["../../src/cache/LockFile.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,OAAO,OAAO,QAAS,YAAW,UAAU;IAyDnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;WAtDxB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,SAAY,EAAE,QAAQ,SAAO,EAAE,WAAW,UAAO;;;;;IAmD3F,KAAK,EAAE,GAAG,CAAC;IACJ,MAAM,EAAE,GAAG,CAAC;gBAEU,QAAQ,KAAA;IAgBrC,CAAC,MAAM,CAAC,OAAO,CAAC;CAUnB"}

package/dist/cache/LockFile.js

@@ -0,0 +1,81 @@
+/* eslint-disable no-console */
+import { join } from "node:path";
+import { existsSync, mkdirSync, unlinkSync, statSync, utimesSync, writeFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+import sleep from "../sleep.js";
+import TimeoutError from "../core/TimeoutError.js";
+const lockFolder = join("/tmp", "locks");
+if (!existsSync(lockFolder)) {
+    mkdirSync(lockFolder, { recursive: true });
+}
+const seconds = 1000;
+const minutes = 60 * seconds;
+const hours = 60 * minutes;
+export default class LockFile {
+    static async lock(someKey, timeout = 2 * hours, interval = 3000, throwOnFail = true) {
+        const sha256 = createHash("sha256");
+        const hash = sha256.update(someKey).digest("hex");
+        const lockFile = join(lockFolder, hash + ".lock");
+        let now = Date.now();
+        const till = now + timeout;
+        let lastError = null;
+        do {
+            try {
+                // check if it exists..
+                if (!existsSync(lockFile)) {
+                    // create and return..
+                    return new LockFile(lockFile);
+                }
+                const stat = statSync(lockFile);
+                const past = now - 15000;
+                if (stat.mtimeMs < past) {
+                    // it is dead...
+                    unlinkSync(lockFile);
+                }
+            }
+            catch (error) {
+                // do nothing
+                lastError = error;
+                // console.error(error);
+            }
+            await sleep(interval);
+            now = Date.now();
+        } while (now < till);
+        if (throwOnFail) {
+            lastError ??= new TimeoutError("lock timed out");
+            throw new Error(`Could not acquire lock ${lockFile}, Reason: ${lastError?.stack ?? lastError?.toString()}`);
+        }
+        return {
+            locked: false,
+            timer: void 0,
+            [Symbol.dispose]() {
+                // do nothing..
+            }
+        };
+    }
+    constructor(lockFile) {
+        this.lockFile = lockFile;
+        this.locked = true;
+        writeFileSync(lockFile, "locked", { flag: "wx", flush: true });
+        this.timer = setInterval(() => {
+            try {
+                const now = new Date();
+                utimesSync(lockFile, now, now);
+            }
+            catch {
+                // do nothing
+            }
+        }, 1000);
+    }
+    [Symbol.dispose]() {
+        try {
+            clearInterval(this.timer);
+            unlinkSync(this.lockFile);
+        }
+        catch (error) {
+            // ignore error...
+            console.error(error);
+        }
+    }
+}
+//# sourceMappingURL=LockFile.js.map

package/dist/cache/LockFile.js.map

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

package/dist/cache/spawnPromise.d.ts

@@ -0,0 +1,12 @@
+import { SpawnOptionsWithoutStdio } from "node:child_process";
+export declare const spawnPromise: (path: any, args?: string[], options?: SpawnOptionsWithoutStdio & {
+    logCommand?: boolean;
+    logData?: boolean;
+    logError?: boolean;
+    throwOnFail?: boolean;
+}) => Promise<{
+    readonly all: string;
+    pid: number;
+    status: number;
+}>;
+//# sourceMappingURL=spawnPromise.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spawnPromise.d.ts","sourceRoot":"","sources":["../../src/cache/spawnPromise.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAS,MAAM,oBAAoB,CAAC;AAIrE,eAAO,MAAM,YAAY,GAAI,SAAI,EAAE,OAAO,MAAM,EAAE,EAAE,UAAU,wBAAwB,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE;kBAChK,MAAM;SACZ,MAAM;YACH,MAAM;EA4DhB,CAAC"}

package/dist/cache/spawnPromise.js

@@ -0,0 +1,63 @@
+/* eslint-disable no-console */
+import { spawn } from "node:child_process";
+import { color } from "console-log-colors";
+export const spawnPromise = (path, args, options) => new Promise((resolve, reject) => {
+    const all = [];
+    const { logCommand = true, throwOnFail = false, logData = true, logError = true } = options ??= {};
+    options.timeout ??= 5 * 60 * 1000;
+    const cd = spawn(path, args, options);
+    const pid = cd.pid;
+    const clear = () => {
+        try {
+            cd.stderr.removeAllListeners();
+            cd.stdout.removeAllListeners();
+            cd.removeAllListeners();
+        }
+        catch {
+            // do nothing...
+        }
+    };
+    cd.stdout.on("data", (data) => {
+        data = data.toString("utf-8");
+        all.push(data);
+    });
+    cd.stderr.on("data", (data) => {
+        data = data.toString("utf-8");
+        all.push(color.red(data));
+    });
+    cd.on("error", (error) => {
+        const errorText = color.red(error.stack ?? error.toString());
+        all.push(error.stack ?? error.toString());
+        if (logData || logError) {
+            console.error(errorText);
+        }
+        reject(error);
+    });
+    cd.on("close", (status) => {
+        if (status > 0) {
+            if (logError) {
+                console.error(all);
+            }
+            if (throwOnFail) {
+                clear();
+                reject(new Error(all.join("\n")));
+                return;
+            }
+        }
+        if (logCommand) {
+            console.log(`Spawn: ${path} ${JSON.stringify(args, undefined, 2)}`);
+            if (logData) {
+                console.log(all.join("\n"));
+            }
+        }
+        clear();
+        resolve({
+            get all() {
+                return all.join("\n");
+            },
+            pid,
+            status
+        });
+    });
+});
+//# sourceMappingURL=spawnPromise.js.map

package/dist/cache/spawnPromise.js.map

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

package/dist/core/FileApi.d.ts

@@ -1,5 +1,6 @@
 export declare function ensureParentFolder(filePath: string): void;
 export default function ensureDir(folder: string): void;
+export declare const fileInfo: (filePath: string) => Promise<import("fs").Stats>;
 export declare const deleteIfExists: (path: any) => void;
 export declare const areFilesEqual: (file1: string, file2: string) => Promise<boolean>;
 //# sourceMappingURL=FileApi.d.ts.map

package/dist/core/FileApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileApi.d.ts","sourceRoot":"","sources":["../../src/core/FileApi.ts"],"names":[],"mappings":"AAKA,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,QAElD;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,MAAM,EAAE,MAAM,QAc/C;AAED,eAAO,MAAM,cAAc,GAAI,SAAI,SAAiD,CAAC;AAErF,eAAO,MAAM,aAAa,GAAU,OAAO,MAAM,EAAE,OAAO,MAAM,qBAyB/D,CAAC"}
+{"version":3,"file":"FileApi.d.ts","sourceRoot":"","sources":["../../src/core/FileApi.ts"],"names":[],"mappings":"AAMA,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,QAElD;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,MAAM,EAAE,MAAM,QAc/C;AAED,eAAO,MAAM,QAAQ,GAAU,UAAU,MAAM,gCAS9C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,SAAI,SAAiD,CAAC;AAErF,eAAO,MAAM,aAAa,GAAU,OAAO,MAAM,EAAE,OAAO,MAAM,qBAyB/D,CAAC"}

package/dist/core/FileApi.js

@@ -53,6 +53,7 @@ var __disposeResources = (this && this.__disposeResources) || (function (Suppres
 import { existsSync, unlinkSync, mkdirSync } from "fs";
 import { dirname } from "path";
 import { AsyncFileStream } from "./AsyncStream.js";
+import { stat } from "fs/promises";
 export function ensureParentFolder(filePath) {
     ensureDir(dirname(filePath));
 }
@@ -69,6 +70,17 @@ export default function ensureDir(folder) {
         }
     }
 }
+export const fileInfo = async (filePath) => {
+    try {
+        return await stat(filePath);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+};
 export const deleteIfExists = (path) => existsSync(path) ? unlinkSync(path) : void 0;
 export const areFilesEqual = async (file1, file2) => {
     const env_1 = { stack: [], error: void 0, hasError: false };

package/dist/core/FileApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileApi.js","sourceRoot":"","sources":["../../src/core/FileApi.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IAC/C,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,MAAc;IAE5C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,OAAO;QACX,CAAC;IACL,CAAC;AAEL,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,KAAa,EAAE,KAAa,EAAE,EAAE;;;QAEhE,MAAM,EAAE,kCAAG,IAAI,eAAe,CAAC,KAAK,CAAC,QAAA,CAAC;QACtC,MAAM,EAAE,kCAAG,IAAI,eAAe,CAAC,KAAK,CAAC,QAAA,CAAC;QAEtC,IAAG,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,SAAQ,CAAC;YACL,MAAM,CAAC,EAAE,EAAC,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1D,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC7B,OAAO,EAAE,CAAC,YAAY,KAAK,EAAE,CAAC,YAAY,CAAC;YAC/C,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACd,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACd,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;;;;;;;;;CAEJ,CAAC"}
+{"version":3,"file":"FileApi.js","sourceRoot":"","sources":["../../src/core/FileApi.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IAC/C,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,MAAc;IAE5C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,OAAO;QACX,CAAC;IACL,CAAC;AAEL,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAgB,EAAE,EAAE;IAC/C,IAAI,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,KAAa,EAAE,KAAa,EAAE,EAAE;;;QAEhE,MAAM,EAAE,kCAAG,IAAI,eAAe,CAAC,KAAK,CAAC,QAAA,CAAC;QACtC,MAAM,EAAE,kCAAG,IAAI,eAAe,CAAC,KAAK,CAAC,QAAA,CAAC;QAEtC,IAAG,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,SAAQ,CAAC;YACL,MAAM,CAAC,EAAE,EAAC,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1D,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC7B,OAAO,EAAE,CAAC,YAAY,KAAK,EAAE,CAAC,YAAY,CAAC;YAC/C,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACd,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACd,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;;;;;;;;;CAEJ,CAAC"}

package/dist/core/NumberFormats.d.ts

@@ -0,0 +1,15 @@
+export declare const toCompactFixed: (n: number, decimals: number) => string;
+export declare const toKMBString: (n: number, decimals?: number, def?: string) => string;
+export declare const toFileSize: (n: number, decimals?: number, def?: string) => string;
+export interface IFormat {
+    prefix: string;
+    suffix: string;
+    numberToText?: (n: number) => string;
+}
+export declare const formatNumber: (n: number, { prefix, suffix, def, numberToText }?: {
+    prefix?: string;
+    suffix?: string;
+    def?: string;
+    numberToText?: (n: number, decimals?: number, def?: string) => string;
+}) => string;
+//# sourceMappingURL=NumberFormats.d.ts.map

package/dist/core/NumberFormats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberFormats.d.ts","sourceRoot":"","sources":["../../src/core/NumberFormats.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,EAAE,UAAU,MAAM,WAOzD,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,EAAE,iBAAY,EAAG,YAAQ,WAc7D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,EAAE,iBAAY,EAAG,YAAQ,WAwB5D,CAAC;AAEF,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,EAAE;;;;uBAhDT,MAAM;CAoDD,WAMnC,CAAC"}