@kikiutils/shared 15.1.1 → 17.0.0

package/README.md

@@ -26,7 +26,7 @@ A lightweight, modular TypeScript utility library for Node.js and browser projec
 - 🧩 Vue/web helpers — Vue Router redirects, timer ref cleanup, scroll preservation, and browser redirects.
 - 🗄️ Storage helpers — typed keyed-store facades for LRU cache and Redis-like storage.
 - 🛤️ Class utilities — immutable `Path` wrapper and chainable `PrecisionNumber` arithmetic.
-- 🧰 Shared types — reusable nullable, readonly, partial-record, binary-input, and filtered-key-path types.
+- 🧰 Shared types — reusable readonly, partial-record, binary-input, and filtered-key-path types.
 
 ## Requirements
 

package/dist/buffer.d.ts

@@ -1,6 +1,5 @@
 import { BinaryInput } from "./types/index.js";
 import { Buffer } from "node:buffer";
-
 //#region src/buffer.d.ts
 /**
  * Converts various binary data types to a Node.js Buffer.

package/dist/buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer.d.ts","names":[],"sources":["../src/buffer.ts"],"mappings":";;;;;;AAkCA;;;;;;;;;;;;;;;AAAiD;;;;;;;;;;;;;iBAA3B,QAAA,CAAS,KAAA,EAAO,WAAA,GAAW,OAAA,CAAA,MAAA,CAAA,eAAA"}
+{"version":3,"file":"buffer.d.ts","names":[],"sources":["../src/buffer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkCsB,SAAS,OAAO,cAAW,QAAA,OAAA"}

package/dist/classes/path.d.ts

@@ -3,7 +3,6 @@ import * as fsp from "node:fs/promises";
 import * as nodePath from "node:path";
 import { Abortable } from "node:events";
 import * as fs from "node:fs";
-
 //#region src/classes/path.d.ts
 type DropFirstParameters<T extends (...args: any) => any> = Parameters<T> extends [any, ...infer R] ? R : never;
 /**

package/dist/classes/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","names":[],"sources":["../../src/classes/path.ts"],"mappings":"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"}
+{"version":3,"file":"path.d.ts","names":[],"sources":["../../src/classes/path.ts"],"mappings":";;;;;;KAmBK,oBAAoB,cAAc,qBAAqB,WAAW,0BAA0B,KAAK;;;;KAK1F,WAAW,GAAG,WAAW;;;;;;;cAQxB;;;;;;;EAQG,eAAG,OAAO;GASrB,OAAO,aAAa;;;;MAmBjB,UAAM;;;;MAON;;;;SASG,OAAO,YAAY,SAAS,wBAAqB;;;;SAOjD,WAAW,OAAO,aAAU;;;;EASnC,SAAS;;;;EAOT,WAAO;;;;EAOP;;;;EAOA;;;;EAOA,aAAS;;;;EAOT,QAAQ,OAAO,aAAU;;;;EAOzB,SAAK,SAAA;;;;EAOL,SAAS,IAAI,WAAQ;;;;EAOrB,WAAO;EAIP;;;;EAOA;;;;;;EASA;;;;EASA,UAAU,MAAM,2BAA2B,IAAI,UAAO;;;;EAOtD,cAAc,MAAM,2BAA2B,IAAI,cAAW;;;;EAO9D,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;EAOpD,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;EAOpD,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;EAO1D,MACI,SAAS,GAAG;IACR;MAEL;EACH,MACI,WACK,GAAG;IACF;OAEF,GAAG,cAER;EACH,MAAM,UAAU,GAAG,uBAAuB,GAAG,cAAc;;;;EAQ3D,QAAQ,MAAM,2BAA2B,IAAI,QAAK,QAAA,GAAA,SAAA;;;;EAOlD,QACI,MAAM,UACN,UACI,kBACC,GAAG;IACF;IACA;cAGP;EACH,QACI,MAAM,UACN;IAGM;IACA;IACA;MAEP,QAAQ;EACX,QACI,MAAM,UACN,UACI,kBACC,GAAG;IACF;IACA;cAGP,QAAQ;EACX,QACI,MAAM,UACN,SAAS,GAAG;IACR;IACA;MAEL,QAAQ,GAAG;EACd,QACI,MAAM,UACN;IACI;IACA;IACA;MAEL,QAAQ,GAAG,OAAO;;;;EAQrB,SACI,WACK;IACC;IACA,OAAO,GAAG;cAGjB,QAAQ;EACX,SACI,UACK;IACC,UAAU;IACV,OAAO,GAAG;OAEZ,iBACL;EACH,SACI,WAEQ,YACA,GAAG;IACD,OAAO,GAAG;OAEd,wBAEP,QAAQ;;;;EAQX,OAAO,SAAS,WAAQ;;;;EAOxB,MAAM,MAAM,2BAA2B,IAAI,MAAG;;;;EAO9C,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;EAOpD,KACI,OAAO,GAAG;IACN;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;MAEL,QAAQ,GAAG;EACd,KAAK,OAAO,GAAG,cAAc,QAAQ,GAAG,cAAc,GAAG;;;;EAQzD,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;EAO1D,UAAM;;;;EAON,aAAa,MAAM,2BAA2B,IAAI,aAAU"}

package/dist/classes/path.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.js","names":["#value","#toStrings","#newInstance"],"sources":["../../src/classes/path.ts"],"sourcesContent":["import type { Buffer } from 'node:buffer';\nimport type { Abortable } from 'node:events';\nimport type * as fs from 'node:fs';\nimport * as fsp from 'node:fs/promises';\nimport {\n    basename,\n    dirname,\n    extname,\n    format,\n    isAbsolute,\n    join,\n    normalize,\n    parse,\n    relative,\n    resolve,\n    toNamespacedPath,\n} from 'node:path';\nimport type * as nodePath from 'node:path';\n\ntype DropFirstParameters<T extends (...args: any) => any> = Parameters<T> extends [any, ...infer R] ? R : never;\n\n/**\n * Values accepted by the `Path` constructor and path-composition methods.\n */\nexport type PathLike = fs.PathLike | Path;\n\n/**\n * Class representing a file system path with various utility methods for path operations.\n *\n * All methods in the `Path` class are immutable, returning new instances with modified values\n * and leaving the original instance unchanged.\n */\nexport class Path {\n    readonly #value: string;\n\n    /**\n     * Creates a normalized path value by joining the provided path segments.\n     *\n     * @param {PathLike[]} paths - Path segments accepted by Node.js `path.join` or another `Path` instance\n     */\n    constructor(...paths: PathLike[]) {\n        this.#value = join(...this.#toStrings(paths));\n    }\n\n    // Symbols\n    [Symbol.for('nodejs.util.inspect.custom')]() {\n        return this.#value;\n    }\n\n    [Symbol.toPrimitive](hint: string) {\n        if (hint === 'number') throw new TypeError('Cannot convert a Path to a number');\n        return this.#value;\n    }\n\n    // Private methods\n    #newInstance(...paths: PathLike[]) {\n        return new Path(...paths);\n    }\n\n    #toStrings(paths: PathLike[]) {\n        return paths.map((path) => path.toString());\n    }\n\n    // Public getters\n\n    /**\n     * @see {@link nodePath.dirname}\n     */\n    get parent() {\n        return this.dirname();\n    }\n\n    /**\n     * Returns the internal path string value.\n     */\n    get value() {\n        return this.#value;\n    }\n\n    // Public static methods\n\n    /**\n     * @see {@link nodePath.format}\n     */\n    static format(pathObject: nodePath.FormatInputPathObject) {\n        return new Path(format(pathObject));\n    }\n\n    /**\n     * @see {@link nodePath.resolve}\n     */\n    static resolve(...paths: PathLike[]) {\n        return new this(...paths).resolve();\n    }\n\n    // Public base methods\n\n    /**\n     * @see {@link nodePath.basename}\n     */\n    basename(suffix?: string) {\n        return basename(this.#value, suffix);\n    }\n\n    /**\n     * @see {@link nodePath.dirname}\n     */\n    dirname() {\n        return this.#newInstance(dirname(this.#value));\n    }\n\n    /**\n     * @see {@link nodePath.extname}\n     */\n    extname() {\n        return extname(this.#value);\n    }\n\n    /**\n     * @see {@link nodePath.isAbsolute}\n     */\n    isAbsolute() {\n        return isAbsolute(this.#value);\n    }\n\n    /**\n     * @see {@link nodePath.normalize}\n     */\n    normalize() {\n        return this.#newInstance(normalize(this.#value));\n    }\n\n    /**\n     * @see {@link nodePath.join}\n     */\n    join(...paths: PathLike[]) {\n        return this.#newInstance(this.#value, ...this.#toStrings(paths));\n    }\n\n    /**\n     * @see {@link nodePath.parse}\n     */\n    parse() {\n        return parse(this.#value);\n    }\n\n    /**\n     * @see {@link nodePath.relative}\n     */\n    relative(to: PathLike) {\n        return this.#newInstance(relative(this.#value, to.toString()));\n    }\n\n    /**\n     * @see {@link nodePath.resolve}\n     */\n    resolve() {\n        return this.#newInstance(resolve(this.#value));\n    }\n\n    toJSON() {\n        return this.#value;\n    }\n\n    /**\n     * @see {@link nodePath.toNamespacedPath}\n     */\n    toNamespacedPath() {\n        return toNamespacedPath(this.#value);\n    }\n\n    /**\n     * Converts the Path instance to a string.\n     * This method returns the internal path string value,\n     * making it useful for implicit and explicit string conversions.\n     */\n    toString() {\n        return this.#value;\n    }\n\n    // Some commonly used promise fs methods\n\n    /**\n     * @see {@link fsp.access}\n     */\n    access(...args: DropFirstParameters<typeof fsp.access>) {\n        return fsp.access(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.appendFile}\n     */\n    appendFile(...args: DropFirstParameters<typeof fsp.appendFile>) {\n        return fsp.appendFile(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.chmod}\n     */\n    chmod(...args: DropFirstParameters<typeof fsp.chmod>) {\n        return fsp.chmod(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.chown}\n     */\n    chown(...args: DropFirstParameters<typeof fsp.chown>) {\n        return fsp.chown(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.copyFile}\n     */\n    copyFile(...args: DropFirstParameters<typeof fsp.copyFile>) {\n        return fsp.copyFile(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.mkdir}\n     */\n    mkdir(\n        options: fs.MakeDirectoryOptions & {\n            recursive: true;\n        },\n    ): Promise<string>;\n    mkdir(\n        options?:\n          | (fs.MakeDirectoryOptions & {\n              recursive?: false;\n          })\n          | fs.Mode\n          | null,\n    ): Promise<void>;\n    mkdir(options?: fs.MakeDirectoryOptions | fs.Mode | null): Promise<string | undefined>;\n    mkdir(...args: any): any {\n        return fsp.mkdir(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.open}\n     */\n    open(...args: DropFirstParameters<typeof fsp.open>) {\n        return fsp.open(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.readdir}\n     */\n    readdir(\n        path: PathLike,\n        options?:\n          | BufferEncoding\n          | (fs.ObjectEncodingOptions & {\n              recursive?: boolean;\n              withFileTypes?: false;\n          })\n          | null,\n    ): Promise<string[]>;\n    readdir(\n        path: PathLike,\n        options:\n          | 'buffer'\n          | {\n              encoding: 'buffer';\n              recursive?: boolean;\n              withFileTypes?: false;\n          },\n    ): Promise<Buffer[]>;\n    readdir(\n        path: PathLike,\n        options?:\n          | BufferEncoding\n          | (fs.ObjectEncodingOptions & {\n              recursive?: boolean;\n              withFileTypes?: false;\n          })\n          | null,\n    ): Promise<Buffer[] | string[]>;\n    readdir(\n        path: PathLike,\n        options: fs.ObjectEncodingOptions & {\n            recursive?: boolean;\n            withFileTypes: true;\n        },\n    ): Promise<fs.Dirent[]>;\n    readdir(\n        path: PathLike,\n        options: {\n            encoding: 'buffer';\n            recursive?: boolean;\n            withFileTypes: true;\n        },\n    ): Promise<fs.Dirent<Buffer>[]>;\n    readdir(...args: any): any {\n        return fsp.readdir(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.readFile}\n     */\n    readFile(\n        options?:\n          | (Abortable & {\n              encoding?: null;\n              flag?: fs.OpenMode;\n          })\n          | null,\n    ): Promise<Buffer>;\n    readFile(\n        options:\n          | (Abortable & {\n              encoding: BufferEncoding;\n              flag?: fs.OpenMode;\n          })\n          | BufferEncoding,\n    ): Promise<string>;\n    readFile(\n        options?:\n            | (\n              & Abortable\n              & fs.ObjectEncodingOptions\n              & { flag?: fs.OpenMode }\n            )\n            | BufferEncoding\n            | null,\n    ): Promise<Buffer | string>;\n    readFile(...args: any): any {\n        return fsp.readFile(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.rename}\n     */\n    rename(newPath: PathLike) {\n        return fsp.rename(this.#value, newPath.toString());\n    }\n\n    /**\n     * @see {@link fsp.rm}\n     */\n    rm(...args: DropFirstParameters<typeof fsp.rm>) {\n        return fsp.rm(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.rmdir}\n     */\n    rmdir(...args: DropFirstParameters<typeof fsp.rmdir>) {\n        return fsp.rmdir(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.stat}\n     */\n    stat(\n        opts?: fs.StatOptions & {\n            bigint?: false;\n        },\n    ): Promise<fs.Stats>;\n    stat(\n        opts: fs.StatOptions & {\n            bigint: true;\n        },\n    ): Promise<fs.BigIntStats>;\n    stat(opts?: fs.StatOptions): Promise<fs.BigIntStats | fs.Stats>;\n    stat(...args: any): any {\n        return fsp.stat(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.truncate}\n     */\n    truncate(...args: DropFirstParameters<typeof fsp.truncate>) {\n        return fsp.truncate(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.unlink}\n     */\n    unlink() {\n        return fsp.unlink(this.#value);\n    }\n\n    /**\n     * @see {@link fsp.writeFile}\n     */\n    writeFile(...args: DropFirstParameters<typeof fsp.writeFile>) {\n        return fsp.writeFile(this.#value, ...args);\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"path.js","names":["#value","#toStrings","#newInstance"],"sources":["../../src/classes/path.ts"],"sourcesContent":["import type { Buffer } from 'node:buffer';\nimport type { Abortable } from 'node:events';\nimport type * as fs from 'node:fs';\nimport * as fsp from 'node:fs/promises';\nimport {\n    basename,\n    dirname,\n    extname,\n    format,\n    isAbsolute,\n    join,\n    normalize,\n    parse,\n    relative,\n    resolve,\n    toNamespacedPath,\n} from 'node:path';\nimport type * as nodePath from 'node:path';\n\ntype DropFirstParameters<T extends (...args: any) => any> = Parameters<T> extends [any, ...infer R] ? R : never;\n\n/**\n * Values accepted by the `Path` constructor and path-composition methods.\n */\nexport type PathLike = fs.PathLike | Path;\n\n/**\n * Class representing a file system path with various utility methods for path operations.\n *\n * All methods in the `Path` class are immutable, returning new instances with modified values\n * and leaving the original instance unchanged.\n */\nexport class Path {\n    readonly #value: string;\n\n    /**\n     * Creates a normalized path value by joining the provided path segments.\n     *\n     * @param {PathLike[]} paths - Path segments accepted by Node.js `path.join` or another `Path` instance\n     */\n    constructor(...paths: PathLike[]) {\n        this.#value = join(...this.#toStrings(paths));\n    }\n\n    // Symbols\n    [Symbol.for('nodejs.util.inspect.custom')]() {\n        return this.#value;\n    }\n\n    [Symbol.toPrimitive](hint: string) {\n        if (hint === 'number') throw new TypeError('Cannot convert a Path to a number');\n        return this.#value;\n    }\n\n    // Private methods\n    #newInstance(...paths: PathLike[]) {\n        return new Path(...paths);\n    }\n\n    #toStrings(paths: PathLike[]) {\n        return paths.map((path) => path.toString());\n    }\n\n    // Public getters\n\n    /**\n     * @see {@link nodePath.dirname}\n     */\n    get parent() {\n        return this.dirname();\n    }\n\n    /**\n     * Returns the internal path string value.\n     */\n    get value() {\n        return this.#value;\n    }\n\n    // Public static methods\n\n    /**\n     * @see {@link nodePath.format}\n     */\n    static format(pathObject: nodePath.FormatInputPathObject) {\n        return new Path(format(pathObject));\n    }\n\n    /**\n     * @see {@link nodePath.resolve}\n     */\n    static resolve(...paths: PathLike[]) {\n        return new this(...paths).resolve();\n    }\n\n    // Public base methods\n\n    /**\n     * @see {@link nodePath.basename}\n     */\n    basename(suffix?: string) {\n        return basename(this.#value, suffix);\n    }\n\n    /**\n     * @see {@link nodePath.dirname}\n     */\n    dirname() {\n        return this.#newInstance(dirname(this.#value));\n    }\n\n    /**\n     * @see {@link nodePath.extname}\n     */\n    extname() {\n        return extname(this.#value);\n    }\n\n    /**\n     * @see {@link nodePath.isAbsolute}\n     */\n    isAbsolute() {\n        return isAbsolute(this.#value);\n    }\n\n    /**\n     * @see {@link nodePath.normalize}\n     */\n    normalize() {\n        return this.#newInstance(normalize(this.#value));\n    }\n\n    /**\n     * @see {@link nodePath.join}\n     */\n    join(...paths: PathLike[]) {\n        return this.#newInstance(this.#value, ...this.#toStrings(paths));\n    }\n\n    /**\n     * @see {@link nodePath.parse}\n     */\n    parse() {\n        return parse(this.#value);\n    }\n\n    /**\n     * @see {@link nodePath.relative}\n     */\n    relative(to: PathLike) {\n        return this.#newInstance(relative(this.#value, to.toString()));\n    }\n\n    /**\n     * @see {@link nodePath.resolve}\n     */\n    resolve() {\n        return this.#newInstance(resolve(this.#value));\n    }\n\n    toJSON() {\n        return this.#value;\n    }\n\n    /**\n     * @see {@link nodePath.toNamespacedPath}\n     */\n    toNamespacedPath() {\n        return toNamespacedPath(this.#value);\n    }\n\n    /**\n     * Converts the Path instance to a string.\n     * This method returns the internal path string value,\n     * making it useful for implicit and explicit string conversions.\n     */\n    toString() {\n        return this.#value;\n    }\n\n    // Some commonly used promise fs methods\n\n    /**\n     * @see {@link fsp.access}\n     */\n    access(...args: DropFirstParameters<typeof fsp.access>) {\n        return fsp.access(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.appendFile}\n     */\n    appendFile(...args: DropFirstParameters<typeof fsp.appendFile>) {\n        return fsp.appendFile(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.chmod}\n     */\n    chmod(...args: DropFirstParameters<typeof fsp.chmod>) {\n        return fsp.chmod(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.chown}\n     */\n    chown(...args: DropFirstParameters<typeof fsp.chown>) {\n        return fsp.chown(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.copyFile}\n     */\n    copyFile(...args: DropFirstParameters<typeof fsp.copyFile>) {\n        return fsp.copyFile(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.mkdir}\n     */\n    mkdir(\n        options: fs.MakeDirectoryOptions & {\n            recursive: true;\n        },\n    ): Promise<string>;\n    mkdir(\n        options?:\n          | (fs.MakeDirectoryOptions & {\n              recursive?: false;\n          })\n          | fs.Mode\n          | null,\n    ): Promise<void>;\n    mkdir(options?: fs.MakeDirectoryOptions | fs.Mode | null): Promise<string | undefined>;\n    mkdir(...args: any): any {\n        return fsp.mkdir(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.open}\n     */\n    open(...args: DropFirstParameters<typeof fsp.open>) {\n        return fsp.open(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.readdir}\n     */\n    readdir(\n        path: PathLike,\n        options?:\n          | BufferEncoding\n          | (fs.ObjectEncodingOptions & {\n              recursive?: boolean;\n              withFileTypes?: false;\n          })\n          | null,\n    ): Promise<string[]>;\n    readdir(\n        path: PathLike,\n        options:\n          | 'buffer'\n          | {\n              encoding: 'buffer';\n              recursive?: boolean;\n              withFileTypes?: false;\n          },\n    ): Promise<Buffer[]>;\n    readdir(\n        path: PathLike,\n        options?:\n          | BufferEncoding\n          | (fs.ObjectEncodingOptions & {\n              recursive?: boolean;\n              withFileTypes?: false;\n          })\n          | null,\n    ): Promise<Buffer[] | string[]>;\n    readdir(\n        path: PathLike,\n        options: fs.ObjectEncodingOptions & {\n            recursive?: boolean;\n            withFileTypes: true;\n        },\n    ): Promise<fs.Dirent[]>;\n    readdir(\n        path: PathLike,\n        options: {\n            encoding: 'buffer';\n            recursive?: boolean;\n            withFileTypes: true;\n        },\n    ): Promise<fs.Dirent<Buffer>[]>;\n    readdir(...args: any): any {\n        return fsp.readdir(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.readFile}\n     */\n    readFile(\n        options?:\n          | (Abortable & {\n              encoding?: null;\n              flag?: fs.OpenMode;\n          })\n          | null,\n    ): Promise<Buffer>;\n    readFile(\n        options:\n          | (Abortable & {\n              encoding: BufferEncoding;\n              flag?: fs.OpenMode;\n          })\n          | BufferEncoding,\n    ): Promise<string>;\n    readFile(\n        options?:\n            | (\n              & Abortable\n              & fs.ObjectEncodingOptions\n              & { flag?: fs.OpenMode }\n            )\n            | BufferEncoding\n            | null,\n    ): Promise<Buffer | string>;\n    readFile(...args: any): any {\n        return fsp.readFile(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.rename}\n     */\n    rename(newPath: PathLike) {\n        return fsp.rename(this.#value, newPath.toString());\n    }\n\n    /**\n     * @see {@link fsp.rm}\n     */\n    rm(...args: DropFirstParameters<typeof fsp.rm>) {\n        return fsp.rm(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.rmdir}\n     */\n    rmdir(...args: DropFirstParameters<typeof fsp.rmdir>) {\n        return fsp.rmdir(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.stat}\n     */\n    stat(\n        opts?: fs.StatOptions & {\n            bigint?: false;\n        },\n    ): Promise<fs.Stats>;\n    stat(\n        opts: fs.StatOptions & {\n            bigint: true;\n        },\n    ): Promise<fs.BigIntStats>;\n    stat(opts?: fs.StatOptions): Promise<fs.BigIntStats | fs.Stats>;\n    stat(...args: any): any {\n        return fsp.stat(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.truncate}\n     */\n    truncate(...args: DropFirstParameters<typeof fsp.truncate>) {\n        return fsp.truncate(this.#value, ...args);\n    }\n\n    /**\n     * @see {@link fsp.unlink}\n     */\n    unlink() {\n        return fsp.unlink(this.#value);\n    }\n\n    /**\n     * @see {@link fsp.writeFile}\n     */\n    writeFile(...args: DropFirstParameters<typeof fsp.writeFile>) {\n        return fsp.writeFile(this.#value, ...args);\n    }\n}\n"],"mappings":"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"}

package/dist/classes/precision-number.d.ts

@@ -1,5 +1,4 @@
 import { Decimal } from "decimal.js";
-
 //#region src/classes/precision-number.d.ts
 /**
  * Values accepted by `PrecisionNumber` constructors and arithmetic methods.

package/dist/classes/precision-number.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"precision-number.d.ts","names":[],"sources":["../../src/classes/precision-number.ts"],"mappings":";;;;;AAKA;KAAY,oBAAA,GAAuB,OAAA,CAAQ,KAAA,GAAQ,eAAe;EAAK,QAAA;AAAA;;;;;;AAAQ;AAqB/E;;;;;;;;;;;;;cAAa,eAAA;EAAA;EAyLE;;;;;;;cA3KP,KAAA,GAAO,oBAAA,EACP,aAAA,WACA,QAAA,GAAU,OAAA,CAAQ,QAAA;EAgSP;;;;;EAAA,CA3Qd,MAAA,CAAO,WAAA,EAAa,IAAA;EAqSkB;;;EAAA,IAlRnC,aAAA,CAAA;EAsTY;;;EAAA,IA/SZ,QAAA,CAAA,GAAQ,OAAA,CAAA,QAAA;EAiUsB;;;EAAA,IA1T9B,KAAA,CAAA;EA+VW;;;;;;;;;EAAA,OAlVR,OAAA,CACH,KAAA,EAAO,oBAAA,EACP,aAAA,WACA,QAAA,GAAU,OAAA,CAAQ,QAAA;EAtEA;;;;;EAkFtB,aAAA,CAAA;EAnCI;;;;;;;EA+CJ,IAAA,CAAA;EAxBc;;;;;;;;;;EAuCd,KAAA,CAAM,GAAA,EAAK,oBAAA,EAAsB,GAAA,EAAK,oBAAA;EAWjC;;;EAAL,KAAA,CAAA,GAAK,eAAA;EAuBL;;;;;;;EAZA,SAAA,CAAU,KAAA,EAAO,oBAAA;EAsCN;;;;;;;EA1BX,MAAA,CAAO,KAAA,EAAO,oBAAA;EA2Ed;;;;;;;EAhEA,KAAA,CAAA;EA8EM;;;EAtEN,EAAA,CAAG,KAAA,EAAO,oBAAA;EA0FV;;;EAnFA,GAAA,CAAI,KAAA,EAAO,oBAAA;EAuGX;;;EAhGA,QAAA,CAAA;EAwGa;;;EAjGb,SAAA,CAAA;EAgHA;;;EAzGA,KAAA,CAAA;EAqHU;;;EA9GV,UAAA,CAAA;EAqHA;;;EA9GA,UAAA,CAAA;EAyHA;;;EAlHA,MAAA,CAAA;EAgIe;;;EAzHf,EAAA,CAAG,KAAA,EAAO,oBAAA;EAoIM;;;EA7HhB,GAAA,CAAI,KAAA,EAAO,oBAAA;EAwIF;;;EAjIT,KAAA,CAAM,KAAA,EAAO,oBAAA;EAwIqB;;;;;;;EA5HlC,MAAA,CAAO,KAAA,EAAO,oBAAA;EA0JN;;;EAlJR,MAAA,CAAA;EAyJA;;;EAjJA,IAAA,CAAK,KAAA,EAAO,oBAAA;EAiJuB;AAAA;;;;;;EArInC,GAAA,CAAI,KAAA,EAAO,oBAAA;;;;EAQX,KAAA,CAAM,KAAA,EAAO,oBAAA;;;;EAQb,eAAA,CAAA,GAAe,eAAA;;;;EAOf,MAAA,CAAA,GAAM,eAAA;;;;;;;;;EAYN,SAAA,CAAU,GAAA,EAAK,oBAAA,EAAsB,GAAA,EAAK,oBAAA,GAAoB,eAAA;;;;EAO9D,WAAA,CAAY,KAAA,EAAO,oBAAA,GAAoB,eAAA;;;;EAWvC,OAAA,CAAA,GAAO,eAAA;;;;EAOP,MAAA,CAAA;;;;EAOA,OAAA,CAAQ,KAAA,EAAO,oBAAA,GAAoB,eAAA;;;;EAWnC,QAAA,CAAS,KAAA,EAAO,oBAAA,GAAoB,eAAA;;;;EAWpC,SAAA,CAAA,GAAS,eAAA;;;;EAOT,MAAA,CAAO,KAAA,EAAO,oBAAA,GAAoB,eAAA;;;;EAOlC,KAAA,CAAM,KAAA,EAAO,oBAAA,GAAoB,eAAA;;;;;;EASjC,QAAA,CAAA;;;;EAOA,QAAA,CAAA;;;;EAOA,OAAA,CAAQ,aAAA,WAA6C,QAAA,GAAU,OAAA,CAAQ,QAAA;;;;EAOvE,OAAA,CAAQ,KAAA,EAAO,oBAAA,GAAoB,eAAA;AAAA"}
+{"version":3,"file":"precision-number.d.ts","names":[],"sources":["../../src/classes/precision-number.ts"],"mappings":";;;;;KAKY,uBAAuB,QAAQ,QAAQ;EAAoB;;;;;;;;;;;;;;;;;;;;;cAqB1D;;;;;;;;;EAcL,YAAA,QAAO,sBACP,wBACA,WAAU,QAAQ;;;;;;GAqBrB,OAAO,aAAa;;;;MAmBjB;;;;MAOA,YAAQ,QAAA;;;;MAOR;;;;;;;;;;SAaG,QACH,OAAO,sBACP,wBACA,WAAU,QAAQ;;;;;;EAYtB;;;;;;;;EAYA;;;;;;;;;;;EAeA,MAAM,KAAK,sBAAsB,KAAK;;;;EAWtC,SAAK;;;;;;;;EAWL,UAAU,OAAO;;;;;;;;EAYjB,OAAO,OAAO;;;;;;;;EAWd;;;;EAQA,GAAG,OAAO;;;;EAOV,IAAI,OAAO;;;;EAOX;;;;EAOA;;;;EAOA;;;;EAOA;;;;EAOA;;;;EAOA;;;;EAOA,GAAG,OAAO;;;;EAOV,IAAI,OAAO;;;;EAOX,MAAM,OAAO;;;;;;;;EAYb,OAAO,OAAO;;;;EAQd;;;;EAQA,KAAK,OAAO;;;;;;;;EAYZ,IAAI,OAAO;;;;EAQX,MAAM,OAAO;;;;EAQb,mBAAe;;;;EAOf,UAAM;;;;;;;;;EAYN,UAAU,KAAK,sBAAsB,KAAK,uBAAoB;;;;EAO9D,YAAY,OAAO,uBAAoB;;;;EAWvC,WAAO;;;;EAOP;;;;EAOA,QAAQ,OAAO,uBAAoB;;;;EAWnC,SAAS,OAAO,uBAAoB;;;;EAWpC,aAAS;;;;EAOT,OAAO,OAAO,uBAAoB;;;;EAOlC,MAAM,OAAO,uBAAoB;;;;;;EASjC;;;;EAOA;;;;EAOA,QAAQ,wBAA6C,WAAU,QAAQ;;;;EAOvE,QAAQ,OAAO,uBAAoB"}

package/dist/classes/precision-number.js.map

@@ -1 +1 @@
-{"version":3,"file":"precision-number.js","names":["#decimalPlaces","#rounding","#decimal","#decimalToFixedDecimal","#valueToString"],"sources":["../../src/classes/precision-number.ts"],"sourcesContent":["import { Decimal } from 'decimal.js';\n\n/**\n * Values accepted by `PrecisionNumber` constructors and arithmetic methods.\n */\nexport type PrecisionNumberValue = Decimal.Value | PrecisionNumber | { toString: () => string };\n\n/**\n * Chainable fixed-decimal wrapper around `decimal.js`.\n *\n * `PrecisionNumber` stores values as `Decimal`, rounds every mutating operation to\n * the configured decimal places, and exposes both mutable and immutable arithmetic\n * methods. Mutable methods (`plus`, `minus`, `times`, `dividedBy`, `modulo`,\n * `pow`, `clamp`, `ceil`, `floor`, `negate`, `absoluteValue`) update the current\n * instance and return `this`; immutable methods prefixed with `to` return a new\n * `PrecisionNumber` with the same precision settings.\n *\n * @example\n * ```typescript\n * import { PrecisionNumber } from '@kikiutils/shared/classes/precision-number';\n *\n * const value = new PrecisionNumber('1.239', 2).plus('2.111');\n * value.toString(); // '3.35'\n * value.toMinus('1').toString(); // '2.35' (original value remains '3.35')\n * ```\n */\nexport class PrecisionNumber {\n    // Private properties\n    readonly #decimalPlaces: number;\n    readonly #rounding: Decimal.Rounding;\n    #decimal: Decimal;\n\n    /**\n     * Creates a fixed-decimal number.\n     *\n     * @param {PrecisionNumberValue} [value] - Initial value (default: `'0'`)\n     * @param {number} [decimalPlaces] - Decimal places retained after operations (default: `2`)\n     * @param {Decimal.Rounding} [rounding] - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`)\n     */\n    constructor(\n        value: PrecisionNumberValue = '0',\n        decimalPlaces: number = 2,\n        rounding: Decimal.Rounding = Decimal.ROUND_DOWN,\n    ) {\n        this.#decimalPlaces = decimalPlaces;\n        this.#rounding = rounding;\n        this.#decimal = this.#decimalToFixedDecimal(new Decimal(value.toString().trim()));\n    }\n\n    // Symbols\n\n    /**\n     * Returns the formatted value when inspected by Node.js utilities.\n     */\n    [Symbol.for('nodejs.util.inspect.custom')]() {\n        return this.value;\n    }\n\n    /**\n     * Converts to a number for numeric coercion and to the fixed string otherwise.\n     *\n     * @param {string} hint - JavaScript primitive-conversion hint\n     */\n    [Symbol.toPrimitive](hint: string) {\n        if (hint === 'number') return this.#decimal.toNumber();\n        return this.value;\n    }\n\n    // Private methods\n    #decimalToFixedDecimal(decimal: Decimal) {\n        return decimal.toDecimalPlaces(this.#decimalPlaces, this.#rounding);\n    }\n\n    #valueToString(value: PrecisionNumberValue) {\n        return value.toString().trim();\n    }\n\n    // Public getters\n\n    /**\n     * Decimal places retained by mutating operations and default formatting.\n     */\n    get decimalPlaces() {\n        return this.#decimalPlaces;\n    }\n\n    /**\n     * Decimal.js rounding mode used by mutating operations and default formatting.\n     */\n    get rounding() {\n        return this.#rounding;\n    }\n\n    /**\n     * Fixed-decimal string using the instance precision and rounding mode.\n     */\n    get value() {\n        return this.#decimal.toFixed(this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Formats a value with decimal.js without creating a reusable instance.\n     *\n     * @param {PrecisionNumberValue} value - Value to format\n     * @param {number} [decimalPlaces] - Decimal places to output (default: `2`)\n     * @param {Decimal.Rounding} [rounding] - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`)\n     *\n     * @returns {string} Fixed-decimal string\n     */\n    static toFixed(\n        value: PrecisionNumberValue,\n        decimalPlaces: number = 2,\n        rounding: Decimal.Rounding = Decimal.ROUND_DOWN,\n    ) {\n        return new Decimal(value.toString().trim()).toFixed(decimalPlaces, rounding);\n    }\n\n    // Public methods\n\n    /**\n     * Replaces the current value with its absolute value.\n     *\n     * @returns {this} The current instance for chaining\n     */\n    absoluteValue() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.absoluteValue());\n        return this;\n    }\n\n    /**\n     * Rounds the current value up to the nearest integer in place.\n     *\n     * The stored value still uses this instance's configured decimal places for output.\n     *\n     * @returns {this} The current instance for chaining\n     */\n    ceil() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.ceil());\n        return this;\n    }\n\n    /**\n     * Restricts the current value to the inclusive range `[min, max]` in place.\n     *\n     * @param {PrecisionNumberValue} min - Lower bound\n     * @param {PrecisionNumberValue} max - Upper bound\n     *\n     * @returns {this} The current instance for chaining\n     *\n     * @throws {Error} If `min` is greater than `max`\n     */\n    clamp(min: PrecisionNumberValue, max: PrecisionNumberValue) {\n        const minDecimal = new Decimal(this.#valueToString(min));\n        const maxDecimal = new Decimal(this.#valueToString(max));\n        if (minDecimal.gt(maxDecimal)) throw new Error('Invalid clamp range: min cannot be greater than max');\n        this.#decimal = this.#decimalToFixedDecimal(Decimal.min(Decimal.max(this.#decimal, minDecimal), maxDecimal));\n        return this;\n    }\n\n    /**\n     * Returns a new instance with the same value, decimal places, and rounding mode.\n     */\n    clone() {\n        return new PrecisionNumber(this.#decimal, this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Divides the current value by another value in place.\n     *\n     * @param {PrecisionNumberValue} value - Divisor\n     *\n     * @returns {this} The current instance for chaining\n     */\n    dividedBy(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.dividedBy(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Checks whether the current value equals another value.\n     *\n     * @param {PrecisionNumberValue} value - Value to compare\n     *\n     * @returns {boolean} `true` when both numeric values are equal\n     */\n    equals(value: PrecisionNumberValue) {\n        return this.#decimal.equals(this.#valueToString(value));\n    }\n\n    /**\n     * Rounds the current value down to the nearest integer in place.\n     *\n     * The stored value still uses this instance's configured decimal places for output.\n     *\n     * @returns {this} The current instance for chaining\n     */\n    floor() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.floor());\n        return this;\n    }\n\n    /**\n     * Checks whether the current value is greater than another value.\n     */\n    gt(value: PrecisionNumberValue) {\n        return this.#decimal.gt(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is greater than or equal to another value.\n     */\n    gte(value: PrecisionNumberValue) {\n        return this.#decimal.gte(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is finite.\n     */\n    isFinite() {\n        return this.#decimal.isFinite();\n    }\n\n    /**\n     * Checks whether the current value is an integer.\n     */\n    isInteger() {\n        return this.#decimal.isInteger();\n    }\n\n    /**\n     * Checks whether the current value is `NaN`.\n     */\n    isNaN() {\n        return this.#decimal.isNaN();\n    }\n\n    /**\n     * Checks whether the current value is negative.\n     */\n    isNegative() {\n        return this.#decimal.isNegative();\n    }\n\n    /**\n     * Checks whether the current value is positive.\n     */\n    isPositive() {\n        return this.#decimal.isPositive();\n    }\n\n    /**\n     * Checks whether the current value is zero.\n     */\n    isZero() {\n        return this.#decimal.isZero();\n    }\n\n    /**\n     * Checks whether the current value is less than another value.\n     */\n    lt(value: PrecisionNumberValue) {\n        return this.#decimal.lt(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is less than or equal to another value.\n     */\n    lte(value: PrecisionNumberValue) {\n        return this.#decimal.lte(this.#valueToString(value));\n    }\n\n    /**\n     * Subtracts another value from the current value in place.\n     */\n    minus(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.minus(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Replaces the current value with the remainder after division by another value.\n     *\n     * @param {PrecisionNumberValue} value - Divisor used to compute the remainder\n     *\n     * @returns {this} The current instance for chaining\n     */\n    modulo(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.modulo(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Negates the current value in place.\n     */\n    negate() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.negated());\n        return this;\n    }\n\n    /**\n     * Adds another value to the current value in place.\n     */\n    plus(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.plus(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Raises the current value to an exponent in place.\n     *\n     * @param {PrecisionNumberValue} value - Exponent\n     *\n     * @returns {this} The current instance for chaining\n     */\n    pow(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.pow(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Multiplies the current value by another value in place.\n     */\n    times(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.times(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Returns a new instance with the absolute value.\n     */\n    toAbsoluteValue() {\n        return new PrecisionNumber(this.#decimal.absoluteValue(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance rounded up to the nearest integer.\n     */\n    toCeil() {\n        return new PrecisionNumber(this.#decimal.ceil(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance restricted to the inclusive range `[min, max]`.\n     *\n     * @param {PrecisionNumberValue} min - Lower bound\n     * @param {PrecisionNumberValue} max - Upper bound\n     *\n     * @throws {Error} If `min` is greater than `max`\n     */\n    toClamped(min: PrecisionNumberValue, max: PrecisionNumberValue) {\n        return this.clone().clamp(min, max);\n    }\n\n    /**\n     * Returns a new instance divided by another value.\n     */\n    toDividedBy(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.dividedBy(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance rounded down to the nearest integer.\n     */\n    toFloor() {\n        return new PrecisionNumber(this.#decimal.floor(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Serializes to the fixed-decimal string.\n     */\n    toJSON() {\n        return this.value;\n    }\n\n    /**\n     * Returns a new instance with another value subtracted.\n     */\n    toMinus(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.minus(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance with the remainder after division by another value.\n     */\n    toModulo(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.modulo(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance with the value negated.\n     */\n    toNegated() {\n        return new PrecisionNumber(this.#decimal.negated(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance with another value added.\n     */\n    toPlus(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.plus(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance raised to an exponent.\n     */\n    toPow(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.pow(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Converts the current value to a JavaScript number.\n     *\n     * Use `toString`/`value` when preserving decimal precision is more important than native-number ergonomics.\n     */\n    toNumber() {\n        return this.#decimal.toNumber();\n    }\n\n    /**\n     * Converts the current value to its fixed-decimal string.\n     */\n    toString() {\n        return this.value;\n    }\n\n    /**\n     * Formats the current value with custom precision and rounding for this call only.\n     */\n    toFixed(decimalPlaces: number = this.#decimalPlaces, rounding: Decimal.Rounding = this.#rounding) {\n        return this.#decimal.toFixed(decimalPlaces, rounding);\n    }\n\n    /**\n     * Returns a new instance multiplied by another value.\n     */\n    toTimes(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.times(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"precision-number.js","names":["#decimalPlaces","#rounding","#decimal","#decimalToFixedDecimal","#valueToString"],"sources":["../../src/classes/precision-number.ts"],"sourcesContent":["import { Decimal } from 'decimal.js';\n\n/**\n * Values accepted by `PrecisionNumber` constructors and arithmetic methods.\n */\nexport type PrecisionNumberValue = Decimal.Value | PrecisionNumber | { toString: () => string };\n\n/**\n * Chainable fixed-decimal wrapper around `decimal.js`.\n *\n * `PrecisionNumber` stores values as `Decimal`, rounds every mutating operation to\n * the configured decimal places, and exposes both mutable and immutable arithmetic\n * methods. Mutable methods (`plus`, `minus`, `times`, `dividedBy`, `modulo`,\n * `pow`, `clamp`, `ceil`, `floor`, `negate`, `absoluteValue`) update the current\n * instance and return `this`; immutable methods prefixed with `to` return a new\n * `PrecisionNumber` with the same precision settings.\n *\n * @example\n * ```typescript\n * import { PrecisionNumber } from '@kikiutils/shared/classes/precision-number';\n *\n * const value = new PrecisionNumber('1.239', 2).plus('2.111');\n * value.toString(); // '3.35'\n * value.toMinus('1').toString(); // '2.35' (original value remains '3.35')\n * ```\n */\nexport class PrecisionNumber {\n    // Private properties\n    readonly #decimalPlaces: number;\n    readonly #rounding: Decimal.Rounding;\n    #decimal: Decimal;\n\n    /**\n     * Creates a fixed-decimal number.\n     *\n     * @param {PrecisionNumberValue} [value] - Initial value (default: `'0'`)\n     * @param {number} [decimalPlaces] - Decimal places retained after operations (default: `2`)\n     * @param {Decimal.Rounding} [rounding] - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`)\n     */\n    constructor(\n        value: PrecisionNumberValue = '0',\n        decimalPlaces: number = 2,\n        rounding: Decimal.Rounding = Decimal.ROUND_DOWN,\n    ) {\n        this.#decimalPlaces = decimalPlaces;\n        this.#rounding = rounding;\n        this.#decimal = this.#decimalToFixedDecimal(new Decimal(value.toString().trim()));\n    }\n\n    // Symbols\n\n    /**\n     * Returns the formatted value when inspected by Node.js utilities.\n     */\n    [Symbol.for('nodejs.util.inspect.custom')]() {\n        return this.value;\n    }\n\n    /**\n     * Converts to a number for numeric coercion and to the fixed string otherwise.\n     *\n     * @param {string} hint - JavaScript primitive-conversion hint\n     */\n    [Symbol.toPrimitive](hint: string) {\n        if (hint === 'number') return this.#decimal.toNumber();\n        return this.value;\n    }\n\n    // Private methods\n    #decimalToFixedDecimal(decimal: Decimal) {\n        return decimal.toDecimalPlaces(this.#decimalPlaces, this.#rounding);\n    }\n\n    #valueToString(value: PrecisionNumberValue) {\n        return value.toString().trim();\n    }\n\n    // Public getters\n\n    /**\n     * Decimal places retained by mutating operations and default formatting.\n     */\n    get decimalPlaces() {\n        return this.#decimalPlaces;\n    }\n\n    /**\n     * Decimal.js rounding mode used by mutating operations and default formatting.\n     */\n    get rounding() {\n        return this.#rounding;\n    }\n\n    /**\n     * Fixed-decimal string using the instance precision and rounding mode.\n     */\n    get value() {\n        return this.#decimal.toFixed(this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Formats a value with decimal.js without creating a reusable instance.\n     *\n     * @param {PrecisionNumberValue} value - Value to format\n     * @param {number} [decimalPlaces] - Decimal places to output (default: `2`)\n     * @param {Decimal.Rounding} [rounding] - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`)\n     *\n     * @returns {string} Fixed-decimal string\n     */\n    static toFixed(\n        value: PrecisionNumberValue,\n        decimalPlaces: number = 2,\n        rounding: Decimal.Rounding = Decimal.ROUND_DOWN,\n    ) {\n        return new Decimal(value.toString().trim()).toFixed(decimalPlaces, rounding);\n    }\n\n    // Public methods\n\n    /**\n     * Replaces the current value with its absolute value.\n     *\n     * @returns {this} The current instance for chaining\n     */\n    absoluteValue() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.absoluteValue());\n        return this;\n    }\n\n    /**\n     * Rounds the current value up to the nearest integer in place.\n     *\n     * The stored value still uses this instance's configured decimal places for output.\n     *\n     * @returns {this} The current instance for chaining\n     */\n    ceil() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.ceil());\n        return this;\n    }\n\n    /**\n     * Restricts the current value to the inclusive range `[min, max]` in place.\n     *\n     * @param {PrecisionNumberValue} min - Lower bound\n     * @param {PrecisionNumberValue} max - Upper bound\n     *\n     * @returns {this} The current instance for chaining\n     *\n     * @throws {Error} If `min` is greater than `max`\n     */\n    clamp(min: PrecisionNumberValue, max: PrecisionNumberValue) {\n        const minDecimal = new Decimal(this.#valueToString(min));\n        const maxDecimal = new Decimal(this.#valueToString(max));\n        if (minDecimal.gt(maxDecimal)) throw new Error('Invalid clamp range: min cannot be greater than max');\n        this.#decimal = this.#decimalToFixedDecimal(Decimal.min(Decimal.max(this.#decimal, minDecimal), maxDecimal));\n        return this;\n    }\n\n    /**\n     * Returns a new instance with the same value, decimal places, and rounding mode.\n     */\n    clone() {\n        return new PrecisionNumber(this.#decimal, this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Divides the current value by another value in place.\n     *\n     * @param {PrecisionNumberValue} value - Divisor\n     *\n     * @returns {this} The current instance for chaining\n     */\n    dividedBy(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.dividedBy(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Checks whether the current value equals another value.\n     *\n     * @param {PrecisionNumberValue} value - Value to compare\n     *\n     * @returns {boolean} `true` when both numeric values are equal\n     */\n    equals(value: PrecisionNumberValue) {\n        return this.#decimal.equals(this.#valueToString(value));\n    }\n\n    /**\n     * Rounds the current value down to the nearest integer in place.\n     *\n     * The stored value still uses this instance's configured decimal places for output.\n     *\n     * @returns {this} The current instance for chaining\n     */\n    floor() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.floor());\n        return this;\n    }\n\n    /**\n     * Checks whether the current value is greater than another value.\n     */\n    gt(value: PrecisionNumberValue) {\n        return this.#decimal.gt(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is greater than or equal to another value.\n     */\n    gte(value: PrecisionNumberValue) {\n        return this.#decimal.gte(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is finite.\n     */\n    isFinite() {\n        return this.#decimal.isFinite();\n    }\n\n    /**\n     * Checks whether the current value is an integer.\n     */\n    isInteger() {\n        return this.#decimal.isInteger();\n    }\n\n    /**\n     * Checks whether the current value is `NaN`.\n     */\n    isNaN() {\n        return this.#decimal.isNaN();\n    }\n\n    /**\n     * Checks whether the current value is negative.\n     */\n    isNegative() {\n        return this.#decimal.isNegative();\n    }\n\n    /**\n     * Checks whether the current value is positive.\n     */\n    isPositive() {\n        return this.#decimal.isPositive();\n    }\n\n    /**\n     * Checks whether the current value is zero.\n     */\n    isZero() {\n        return this.#decimal.isZero();\n    }\n\n    /**\n     * Checks whether the current value is less than another value.\n     */\n    lt(value: PrecisionNumberValue) {\n        return this.#decimal.lt(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is less than or equal to another value.\n     */\n    lte(value: PrecisionNumberValue) {\n        return this.#decimal.lte(this.#valueToString(value));\n    }\n\n    /**\n     * Subtracts another value from the current value in place.\n     */\n    minus(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.minus(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Replaces the current value with the remainder after division by another value.\n     *\n     * @param {PrecisionNumberValue} value - Divisor used to compute the remainder\n     *\n     * @returns {this} The current instance for chaining\n     */\n    modulo(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.modulo(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Negates the current value in place.\n     */\n    negate() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.negated());\n        return this;\n    }\n\n    /**\n     * Adds another value to the current value in place.\n     */\n    plus(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.plus(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Raises the current value to an exponent in place.\n     *\n     * @param {PrecisionNumberValue} value - Exponent\n     *\n     * @returns {this} The current instance for chaining\n     */\n    pow(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.pow(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Multiplies the current value by another value in place.\n     */\n    times(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.times(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Returns a new instance with the absolute value.\n     */\n    toAbsoluteValue() {\n        return new PrecisionNumber(this.#decimal.absoluteValue(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance rounded up to the nearest integer.\n     */\n    toCeil() {\n        return new PrecisionNumber(this.#decimal.ceil(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance restricted to the inclusive range `[min, max]`.\n     *\n     * @param {PrecisionNumberValue} min - Lower bound\n     * @param {PrecisionNumberValue} max - Upper bound\n     *\n     * @throws {Error} If `min` is greater than `max`\n     */\n    toClamped(min: PrecisionNumberValue, max: PrecisionNumberValue) {\n        return this.clone().clamp(min, max);\n    }\n\n    /**\n     * Returns a new instance divided by another value.\n     */\n    toDividedBy(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.dividedBy(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance rounded down to the nearest integer.\n     */\n    toFloor() {\n        return new PrecisionNumber(this.#decimal.floor(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Serializes to the fixed-decimal string.\n     */\n    toJSON() {\n        return this.value;\n    }\n\n    /**\n     * Returns a new instance with another value subtracted.\n     */\n    toMinus(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.minus(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance with the remainder after division by another value.\n     */\n    toModulo(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.modulo(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance with the value negated.\n     */\n    toNegated() {\n        return new PrecisionNumber(this.#decimal.negated(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance with another value added.\n     */\n    toPlus(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.plus(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance raised to an exponent.\n     */\n    toPow(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.pow(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Converts the current value to a JavaScript number.\n     *\n     * Use `toString`/`value` when preserving decimal precision is more important than native-number ergonomics.\n     */\n    toNumber() {\n        return this.#decimal.toNumber();\n    }\n\n    /**\n     * Converts the current value to its fixed-decimal string.\n     */\n    toString() {\n        return this.value;\n    }\n\n    /**\n     * Formats the current value with custom precision and rounding for this call only.\n     */\n    toFixed(decimalPlaces: number = this.#decimalPlaces, rounding: Decimal.Rounding = this.#rounding) {\n        return this.#decimal.toFixed(decimalPlaces, rounding);\n    }\n\n    /**\n     * Returns a new instance multiplied by another value.\n     */\n    toTimes(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.times(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n}\n"],"mappings":"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"}

package/dist/classes/ssh-client.d.ts

@@ -1,9 +1,6 @@
-import { Nullable } from "../types/index.js";
 import { PathLike } from "./path.js";
-import * as _$node_ssh0 from "node-ssh";
 import { Config, NodeSSH, SSHExecCommandOptions, SSHGetPutDirectoryOptions, SSHPutFilesOptions } from "node-ssh";
 import { SFTPWrapper, TransferOptions } from "ssh2";
-
 //#region src/classes/ssh-client.d.ts
 declare const loggerLevelStringToConsolaLogLevelMap: {
   readonly debug: 4;
@@ -22,16 +19,16 @@ declare class SshClient {
   get nodeSsh(): NodeSSH;
   connect(): Promise<boolean>;
   disconnect(): boolean;
-  execCommand(command: string, options?: SSHExecCommandOptions): Promise<void | _$node_ssh0.SSHExecCommandResponse>;
-  execCommandWithIo(command: string, options?: SSHExecCommandOptions): Promise<void | _$node_ssh0.SSHExecCommandResponse>;
+  execCommand(command: string, options?: SSHExecCommandOptions): Promise<void | import("node-ssh").SSHExecCommandResponse>;
+  execCommandWithIo(command: string, options?: SSHExecCommandOptions): Promise<void | import("node-ssh").SSHExecCommandResponse>;
   getDir: (localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) => Promise<boolean>;
   getDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions): Promise<boolean>;
-  getFile(localFile: PathLike, remoteFile: PathLike, givenSftp?: Nullable<SFTPWrapper>, transferOptions?: Nullable<TransferOptions>): Promise<boolean>;
+  getFile(localFile: PathLike, remoteFile: PathLike, givenSftp?: null | SFTPWrapper, transferOptions?: null | TransferOptions): Promise<boolean>;
   isConnected(): boolean;
   mkdir(path: PathLike): Promise<boolean>;
   putDir: (localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) => Promise<boolean>;
   putDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions): Promise<boolean>;
-  putFile(localFile: PathLike, remoteFile: PathLike, givenSftp?: Nullable<SFTPWrapper>, transferOptions?: Nullable<TransferOptions>): Promise<boolean>;
+  putFile(localFile: PathLike, remoteFile: PathLike, givenSftp?: null | SFTPWrapper, transferOptions?: null | TransferOptions): Promise<boolean>;
   putFiles(files: {
     local: PathLike;
     remote: PathLike;

package/dist/classes/ssh-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssh-client.d.ts","names":[],"sources":["../../src/classes/ssh-client.ts"],"mappings":";;;;;;;cAkBM,qCAAA;EAAA;;;;;;;;;;cAYO,SAAA;EAAA;cAMG,IAAA,UAAc,QAAA,UAAkB,QAAA,UAAkB,IAAA,WAAmB,aAAA,GAAgB,MAAA;EAAA,IAc7F,OAAA,CAAA,GAAO,OAAA;EAIL,OAAA,CAAA,GAAO,OAAA;EAUb,UAAA,CAAA;EAUA,WAAA,CAAY,OAAA,UAAiB,OAAA,GAAU,qBAAA,GAAqB,OAAA,QAAA,WAAA,CAAA,sBAAA;EAI5D,iBAAA,CAAkB,OAAA,UAAiB,OAAA,GAAU,qBAAA,GAAqB,OAAA,QAAA,WAAA,CAAA,sBAAA;EAWlE,MAAA,GAAM,cAAA,EAE6B,QAAA,EAAQ,eAAA,EAAmB,QAAA,EAAQ,OAAA,GAAY,yBAAA,KAAyB,OAAA;EAArG,YAAA,CAAa,cAAA,EAAgB,QAAA,EAAU,eAAA,EAAiB,QAAA,EAAU,OAAA,GAAU,yBAAA,GAAyB,OAAA;EASrG,OAAA,CACF,SAAA,EAAW,QAAA,EACX,UAAA,EAAY,QAAA,EACZ,SAAA,GAAY,QAAA,CAAS,WAAA,GACrB,eAAA,GAAkB,QAAA,CAAS,eAAA,IAAgB,OAAA;EAW/C,WAAA,CAAA;EAIM,KAAA,CAAM,IAAA,EAAM,QAAA,GAAQ,OAAA;EAU1B,MAAA,GAAM,cAAA,EAE6B,QAAA,EAAQ,eAAA,EAAmB,QAAA,EAAQ,OAAA,GAAY,yBAAA,KAAyB,OAAA;EAArG,YAAA,CAAa,cAAA,EAAgB,QAAA,EAAU,eAAA,EAAiB,QAAA,EAAU,OAAA,GAAU,yBAAA,GAAyB,OAAA;EASrG,OAAA,CACF,SAAA,EAAW,QAAA,EACX,UAAA,EAAY,QAAA,EACZ,SAAA,GAAY,QAAA,CAAS,WAAA,GACrB,eAAA,GAAkB,QAAA,CAAS,eAAA,IAAgB,OAAA;EAWzC,QAAA,CAAS,KAAA;IAAS,KAAA,EAAO,QAAA;IAAU,MAAA,EAAQ,QAAA;EAAA,KAAc,OAAA,GAAU,kBAAA,GAAkB,OAAA;EAe3F,cAAA,CAAe,KAAA,eAAoB,qCAAA;AAAA"}
+{"version":3,"file":"ssh-client.d.ts","names":[],"sources":["../../src/classes/ssh-client.ts"],"mappings":";;;;cAgBM;;;;;;;;;;;cAYO;;EAMG,YAAA,cAAc,kBAAkB,kBAAkB,eAAmB,gBAAgB;MAc7F,WAAO;EAIL,WAAO;EAUb;EAUA,YAAY,iBAAiB,UAAU,wBAAqB,kCAAA;EAI5D,kBAAkB,iBAAiB,UAAU,wBAAqB,kCAAA;EAWlE,SAAM,gBAE6B,UAAQ,iBAAmB,UAAQ,UAAY,8BAAyB;EAArG,aAAa,gBAAgB,UAAU,iBAAiB,UAAU,UAAU,4BAAyB;EASrG,QACF,WAAW,UACX,YAAY,UACZ,mBAAmB,aACnB,yBAAyB,kBAAe;EAW5C;EAIM,MAAM,MAAM,WAAQ;EAU1B,SAAM,gBAE6B,UAAQ,iBAAmB,UAAQ,UAAY,8BAAyB;EAArG,aAAa,gBAAgB,UAAU,iBAAiB,UAAU,UAAU,4BAAyB;EASrG,QACF,WAAW,UACX,YAAY,UACZ,mBAAmB,aACnB,yBAAyB,kBAAe;EAWtC,SAAS;IAAS,OAAO;IAAU,QAAQ;OAAc,UAAU,qBAAkB;EAe3F,eAAe,oBAAoB"}

package/dist/classes/ssh-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"ssh-client.js","names":["#connectConfig","#logger","#nodeSsh"],"sources":["../../src/classes/ssh-client.ts"],"sourcesContent":["import { createConsola } from 'consola';\nimport type { ConsolaInstance } from 'consola';\nimport { NodeSSH } from 'node-ssh';\nimport type {\n    Config,\n    SSHExecCommandOptions,\n    SSHGetPutDirectoryOptions,\n    SSHPutFilesOptions,\n} from 'node-ssh';\nimport type {\n    SFTPWrapper,\n    TransferOptions,\n} from 'ssh2';\n\nimport type { Nullable } from '../types';\n\nimport type { PathLike } from './path';\n\nconst loggerLevelStringToConsolaLogLevelMap = {\n    debug: 4,\n    error: 0,\n    fatal: 0,\n    info: 3,\n    normal: 2,\n    silent: -999,\n    trace: 5,\n    verbose: 999,\n    warn: 1,\n} as const;\n\nexport class SshClient {\n    readonly #connectConfig: Config;\n    readonly #logger: ConsolaInstance;\n\n    #nodeSsh: NodeSSH;\n\n    constructor(host: string, username: string, password: string, port: number = 22, connectConfig?: Config) {\n        this.#connectConfig = {\n            ...connectConfig,\n            host,\n            password,\n            port,\n            username,\n        };\n\n        this.#logger = createConsola();\n        this.#nodeSsh = new NodeSSH();\n        if (process.env.NODE_ENV === 'production') this.setLoggerLevel('error');\n    }\n\n    get nodeSsh() {\n        return this.#nodeSsh;\n    }\n\n    async connect() {\n        try {\n            this.#nodeSsh = await this.#nodeSsh.connect(this.#connectConfig);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    disconnect() {\n        try {\n            this.#nodeSsh.dispose();\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    execCommand(command: string, options?: SSHExecCommandOptions) {\n        return this.#nodeSsh.execCommand(command, options).catch(() => {});\n    }\n\n    execCommandWithIo(command: string, options?: SSHExecCommandOptions) {\n        return this.execCommand(\n            command,\n            {\n                ...options,\n                onStderr: (data) => process.stderr.write(data.toString()),\n                onStdout: (data) => process.stdout.write(data.toString()),\n            },\n        );\n    }\n\n    getDir = this.getDirectory;\n\n    async getDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) {\n        try {\n            return await this.#nodeSsh.getDirectory(localDirectory.toString(), remoteDirectory.toString(), options);\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async getFile(\n        localFile: PathLike,\n        remoteFile: PathLike,\n        givenSftp?: Nullable<SFTPWrapper>,\n        transferOptions?: Nullable<TransferOptions>,\n    ) {\n        try {\n            await this.#nodeSsh.getFile(localFile.toString(), remoteFile.toString(), givenSftp, transferOptions);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    isConnected() {\n        return this.#nodeSsh.isConnected();\n    }\n\n    async mkdir(path: PathLike) {\n        try {\n            await this.#nodeSsh.mkdir(path.toString());\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    putDir = this.putDirectory;\n\n    async putDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) {\n        try {\n            return await this.#nodeSsh.putDirectory(localDirectory.toString(), remoteDirectory.toString(), options);\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async putFile(\n        localFile: PathLike,\n        remoteFile: PathLike,\n        givenSftp?: Nullable<SFTPWrapper>,\n        transferOptions?: Nullable<TransferOptions>,\n    ) {\n        try {\n            await this.#nodeSsh.putFile(localFile.toString(), remoteFile.toString(), givenSftp, transferOptions);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async putFiles(files: { local: PathLike; remote: PathLike }[], options?: SSHPutFilesOptions) {\n        try {\n            const convertedFiles = files.map(({ local, remote }) => ({\n                local: local.toString(),\n                remote: remote.toString(),\n            }));\n\n            await this.#nodeSsh.putFiles(convertedFiles, options);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    setLoggerLevel(level: keyof typeof loggerLevelStringToConsolaLogLevelMap) {\n        this.#logger.level = loggerLevelStringToConsolaLogLevelMap[level];\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ssh-client.js","names":["#connectConfig","#logger","#nodeSsh"],"sources":["../../src/classes/ssh-client.ts"],"sourcesContent":["import { createConsola } from 'consola';\nimport type { ConsolaInstance } from 'consola';\nimport { NodeSSH } from 'node-ssh';\nimport type {\n    Config,\n    SSHExecCommandOptions,\n    SSHGetPutDirectoryOptions,\n    SSHPutFilesOptions,\n} from 'node-ssh';\nimport type {\n    SFTPWrapper,\n    TransferOptions,\n} from 'ssh2';\n\nimport type { PathLike } from './path';\n\nconst loggerLevelStringToConsolaLogLevelMap = {\n    debug: 4,\n    error: 0,\n    fatal: 0,\n    info: 3,\n    normal: 2,\n    silent: -999,\n    trace: 5,\n    verbose: 999,\n    warn: 1,\n} as const;\n\nexport class SshClient {\n    readonly #connectConfig: Config;\n    readonly #logger: ConsolaInstance;\n\n    #nodeSsh: NodeSSH;\n\n    constructor(host: string, username: string, password: string, port: number = 22, connectConfig?: Config) {\n        this.#connectConfig = {\n            ...connectConfig,\n            host,\n            password,\n            port,\n            username,\n        };\n\n        this.#logger = createConsola();\n        this.#nodeSsh = new NodeSSH();\n        if (process.env.NODE_ENV === 'production') this.setLoggerLevel('error');\n    }\n\n    get nodeSsh() {\n        return this.#nodeSsh;\n    }\n\n    async connect() {\n        try {\n            this.#nodeSsh = await this.#nodeSsh.connect(this.#connectConfig);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    disconnect() {\n        try {\n            this.#nodeSsh.dispose();\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    execCommand(command: string, options?: SSHExecCommandOptions) {\n        return this.#nodeSsh.execCommand(command, options).catch(() => {});\n    }\n\n    execCommandWithIo(command: string, options?: SSHExecCommandOptions) {\n        return this.execCommand(\n            command,\n            {\n                ...options,\n                onStderr: (data) => process.stderr.write(data.toString()),\n                onStdout: (data) => process.stdout.write(data.toString()),\n            },\n        );\n    }\n\n    getDir = this.getDirectory;\n\n    async getDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) {\n        try {\n            return await this.#nodeSsh.getDirectory(localDirectory.toString(), remoteDirectory.toString(), options);\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async getFile(\n        localFile: PathLike,\n        remoteFile: PathLike,\n        givenSftp?: null | SFTPWrapper,\n        transferOptions?: null | TransferOptions,\n    ) {\n        try {\n            await this.#nodeSsh.getFile(localFile.toString(), remoteFile.toString(), givenSftp, transferOptions);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    isConnected() {\n        return this.#nodeSsh.isConnected();\n    }\n\n    async mkdir(path: PathLike) {\n        try {\n            await this.#nodeSsh.mkdir(path.toString());\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    putDir = this.putDirectory;\n\n    async putDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) {\n        try {\n            return await this.#nodeSsh.putDirectory(localDirectory.toString(), remoteDirectory.toString(), options);\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async putFile(\n        localFile: PathLike,\n        remoteFile: PathLike,\n        givenSftp?: null | SFTPWrapper,\n        transferOptions?: null | TransferOptions,\n    ) {\n        try {\n            await this.#nodeSsh.putFile(localFile.toString(), remoteFile.toString(), givenSftp, transferOptions);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async putFiles(files: { local: PathLike; remote: PathLike }[], options?: SSHPutFilesOptions) {\n        try {\n            const convertedFiles = files.map(({ local, remote }) => ({\n                local: local.toString(),\n                remote: remote.toString(),\n            }));\n\n            await this.#nodeSsh.putFiles(convertedFiles, options);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    setLoggerLevel(level: keyof typeof loggerLevelStringToConsolaLogLevelMap) {\n        this.#logger.level = loggerLevelStringToConsolaLogLevelMap[level];\n    }\n}\n"],"mappings":"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"}

package/dist/clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","names":[],"sources":["../src/clipboard.ts"],"mappings":";KAAK,UAAA;EACC,KAAA;EAAgB,EAAA;AAAA;EAChB,EAAA;AAAA;;;;AAAE;AA8BR;;;;;;;;;;;;;;;;AAAyG;AA8CzG;;;;;;;iBA9CsB,mBAAA,CAAoB,IAAA,EAAM,IAAA,EAAM,OAAA,GAAU,oBAAA,GAAuB,OAAA,CAAQ,UAAA;AA8CpB;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iBAArD,mBAAA,CAAoB,IAAA,WAAe,OAAO,CAAC,UAAA"}
+{"version":3,"file":"clipboard.d.ts","names":[],"sources":["../src/clipboard.ts"],"mappings":";KAAK;EACC;EAAgB;;EAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BgB,oBAAoB,MAAM,MAAM,UAAU,uBAAuB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8CzE,oBAAoB,eAAe,QAAQ"}

package/dist/consola.d.ts

@@ -1,5 +1,3 @@
-import * as _$consola from "consola";
-
 //#region src/consola.d.ts
 /**
  * A consola logger instance.
@@ -22,8 +20,8 @@ import * as _$consola from "consola";
  * logger.level = 3;
  * ```
  */
-declare const consolaLogger: _$consola.ConsolaInstance;
-declare const logger: _$consola.ConsolaInstance;
+declare const consolaLogger: import("consola").ConsolaInstance;
+declare const logger: import("consola").ConsolaInstance;
 //#endregion
 export { consolaLogger, logger };
 //# sourceMappingURL=consola.d.ts.map

package/dist/consola.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consola.d.ts","names":[],"sources":["../src/consola.ts"],"mappings":";;;;;;AAuBA;;;;AAA4C;AAC5C;;;;AAAmC;;;;;;;;;cADtB,aAAA,EAA+B,SAAA,CAAlB,eAAkB;AAAA,cAC/B,MAAA,EAAsB,SAAA,CAAhB,eAAgB"}
+{"version":3,"file":"consola.d.ts","names":[],"sources":["../src/consola.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;cAuBa,iCAAa;cACb,0BAAM"}

package/dist/crypto-hash.d.ts

@@ -1,11 +1,10 @@
-import { BinaryLike, BinaryToTextEncoding } from "node:crypto";
-
+import { BinaryLike } from "node:crypto";
 //#region src/crypto-hash.d.ts
 /**
  * Computes the MD5 hash of the given data.
  *
  * @param {BinaryLike} data - The input data to hash
- * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+ * @param {BufferEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
  *
  * @returns {string | Buffer} The hash digest in the specified encoding
  *
@@ -16,7 +15,7 @@ import { BinaryLike, BinaryToTextEncoding } from "node:crypto";
  * console.log(cryptoMd5('test')); // 098f6bcd4621d373cade4e832627b4f6
  * ```
  */
-declare function cryptoMd5(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+declare function cryptoMd5(data: BinaryLike, outputEncoding?: BufferEncoding): string;
 /**
  * Computes the MD5 hash of the given data and returns the raw buffer.
  *
@@ -36,7 +35,7 @@ declare function cryptoMd5ToBuffer(data: BinaryLike): NonSharedBuffer;
  * Computes the SHA-3 hash of the given data using the 224-bit digest.
  *
  * @param {BinaryLike} data - The input data to hash
- * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+ * @param {BufferEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
  *
  * @returns {string | Buffer} The hash digest in the specified encoding
  *
@@ -47,7 +46,7 @@ declare function cryptoMd5ToBuffer(data: BinaryLike): NonSharedBuffer;
  * console.log(cryptoSha3224('test')); // 3797bf0afbbfca4a7bbba7602a2b552746876517a7f9b7ce2db0ae7b
  * ```
  */
-declare function cryptoSha3224(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+declare function cryptoSha3224(data: BinaryLike, outputEncoding?: BufferEncoding): string;
 /**
  * Computes the SHA-3 hash of the given data using the 224-bit digest and returns the raw buffer.
  *
@@ -67,7 +66,7 @@ declare function cryptoSha3224ToBuffer(data: BinaryLike): NonSharedBuffer;
  * Computes the SHA-3 hash of the given data using the 256-bit digest.
  *
  * @param {BinaryLike} data - The input data to hash
- * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+ * @param {BufferEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
  *
  * @returns {string | Buffer} The hash digest in the specified encoding
  *
@@ -78,7 +77,7 @@ declare function cryptoSha3224ToBuffer(data: BinaryLike): NonSharedBuffer;
  * console.log(cryptoSha3256('test')); // 36f028580bb02cc8272a9a020f4200e346e276ae664e45ee80745574e2f5ab80
  * ```
  */
-declare function cryptoSha3256(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+declare function cryptoSha3256(data: BinaryLike, outputEncoding?: BufferEncoding): string;
 /**
  * Computes the SHA-3 hash of the given data using the 256-bit digest and returns the raw buffer.
  *
@@ -98,7 +97,7 @@ declare function cryptoSha3256ToBuffer(data: BinaryLike): NonSharedBuffer;
  * Computes the SHA-3 hash of the given data using the 384-bit digest.
  *
  * @param {BinaryLike} data - The input data to hash
- * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+ * @param {BufferEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
  *
  * @returns {string | Buffer} The hash digest in the specified encoding
  *
@@ -109,7 +108,7 @@ declare function cryptoSha3256ToBuffer(data: BinaryLike): NonSharedBuffer;
  * console.log(cryptoSha3384('test')); // e516dabb23b6e30026863543282780a3ae0dccf05551cf0295178d7f...
  * ```
  */
-declare function cryptoSha3384(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+declare function cryptoSha3384(data: BinaryLike, outputEncoding?: BufferEncoding): string;
 /**
  * Computes the SHA-3 hash of the given data using the 384-bit digest and returns the raw buffer.
  *
@@ -129,7 +128,7 @@ declare function cryptoSha3384ToBuffer(data: BinaryLike): NonSharedBuffer;
  * Computes the SHA-3 hash of the given data using the 512-bit digest.
  *
  * @param {BinaryLike} data - The input data to hash
- * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+ * @param {BufferEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
  *
  * @returns {string | Buffer} The hash digest in the specified encoding
  *
@@ -140,7 +139,7 @@ declare function cryptoSha3384ToBuffer(data: BinaryLike): NonSharedBuffer;
  * console.log(cryptoSha3512('test')); // 9ece086e9bac491fac5c1d1046ca11d737b92a2b2ebd93f005d7...
  * ```
  */
-declare function cryptoSha3512(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+declare function cryptoSha3512(data: BinaryLike, outputEncoding?: BufferEncoding): string;
 /**
  * Computes the SHA-3 hash of the given data using the 512-bit digest and returns the raw buffer.
  *

package/dist/crypto-hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-hash.d.ts","names":[],"sources":["../src/crypto-hash.ts"],"mappings":";;;;;AAqBA;;;;;;;;;AAAwF;AAkBxF;;;iBAlBgB,SAAA,CAAU,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAA4B;;;;;AAkBtC;AAmBlD;;;;;;;;;iBAnBgB,iBAAA,CAAkB,IAAA,EAAM,UAAA,GAAU,eAAA;AAqClD;;;;;;;;AAAsD;AAmBtD;;;;;;AAnBA,iBAlBgB,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAA4B;;;AAqCA;AAkB5F;;;;;;;;AAAsD;AAmBtD;;iBAxDgB,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA;;;;;;;AAwDsC;AAkB5F;;;;;;;;iBAvDgB,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAA4B;AA0E5F;;;;;;;;;AAA4F;AAkB5F;;;;AAlBA,iBAxDgB,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA;;;;AA0EA;;;;;;;;;;;;iBAvDtC,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAA4B;;;;;;;;;;;;;;;iBAkB5E,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA;;;;;;;;;;;;;;;;iBAmBtC,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAA4B;;;;;;;;;;;;;;;iBAkB5E,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA"}
+{"version":3,"file":"crypto-hash.d.ts","names":[],"sources":["../src/crypto-hash.ts"],"mappings":";;;;;;;;;;;;;;;;;iBAmBgB,UAAU,MAAM,YAAY,iBAAgB;;;;;;;;;;;;;;;iBAkB5C,kBAAkB,MAAM,aAAU;;;;;;;;;;;;;;;;iBAmBlC,cAAc,MAAM,YAAY,iBAAgB;;;;;;;;;;;;;;;iBAkBhD,sBAAsB,MAAM,aAAU;;;;;;;;;;;;;;;;iBAmBtC,cAAc,MAAM,YAAY,iBAAgB;;;;;;;;;;;;;;;iBAkBhD,sBAAsB,MAAM,aAAU;;;;;;;;;;;;;;;;iBAmBtC,cAAc,MAAM,YAAY,iBAAgB;;;;;;;;;;;;;;;iBAkBhD,sBAAsB,MAAM,aAAU;;;;;;;;;;;;;;;;iBAmBtC,cAAc,MAAM,YAAY,iBAAgB;;;;;;;;;;;;;;;iBAkBhD,sBAAsB,MAAM,aAAU"}

package/dist/crypto-hash.js

@@ -1,10 +1,11 @@
+import { Buffer } from "node:buffer";
 import { createHash } from "node:crypto";
 //#region src/crypto-hash.ts
 /**
 * Computes the MD5 hash of the given data.
 *
 * @param {BinaryLike} data - The input data to hash
-* @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+* @param {BufferEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
 *
 * @returns {string | Buffer} The hash digest in the specified encoding
 *
@@ -16,7 +17,7 @@ import { createHash } from "node:crypto";
 * ```
 */
 function cryptoMd5(data, outputEncoding = "hex") {
-	return createHash("md5").update(data).digest(outputEncoding);
+	return createHash("md5").update(normalizeHashData(data)).digest(outputEncoding);
 }
 /**
 * Computes the MD5 hash of the given data and returns the raw buffer.
@@ -33,13 +34,13 @@ function cryptoMd5(data, outputEncoding = "hex") {
 * ```
 */
 function cryptoMd5ToBuffer(data) {
-	return createHash("md5").update(data).digest();
+	return createHash("md5").update(normalizeHashData(data)).digest();
 }
 /**
 * Computes the SHA-3 hash of the given data using the 224-bit digest.
 *
 * @param {BinaryLike} data - The input data to hash
-* @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+* @param {BufferEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
 *
 * @returns {string | Buffer} The hash digest in the specified encoding
 *
@@ -51,7 +52,7 @@ function cryptoMd5ToBuffer(data) {
 * ```
 */
 function cryptoSha3224(data, outputEncoding = "hex") {
-	return createHash("sha3-224").update(data).digest(outputEncoding);
+	return createHash("sha3-224").update(normalizeHashData(data)).digest(outputEncoding);
 }
 /**
 * Computes the SHA-3 hash of the given data using the 224-bit digest and returns the raw buffer.
@@ -68,13 +69,13 @@ function cryptoSha3224(data, outputEncoding = "hex") {
 * ```
 */
 function cryptoSha3224ToBuffer(data) {
-	return createHash("sha3-224").update(data).digest();
+	return createHash("sha3-224").update(normalizeHashData(data)).digest();
 }
 /**
 * Computes the SHA-3 hash of the given data using the 256-bit digest.
 *
 * @param {BinaryLike} data - The input data to hash
-* @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+* @param {BufferEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
 *
 * @returns {string | Buffer} The hash digest in the specified encoding
 *
@@ -86,7 +87,7 @@ function cryptoSha3224ToBuffer(data) {
 * ```
 */
 function cryptoSha3256(data, outputEncoding = "hex") {
-	return createHash("sha3-256").update(data).digest(outputEncoding);
+	return createHash("sha3-256").update(normalizeHashData(data)).digest(outputEncoding);
 }
 /**
 * Computes the SHA-3 hash of the given data using the 256-bit digest and returns the raw buffer.
@@ -103,13 +104,13 @@ function cryptoSha3256(data, outputEncoding = "hex") {
 * ```
 */
 function cryptoSha3256ToBuffer(data) {
-	return createHash("sha3-256").update(data).digest();
+	return createHash("sha3-256").update(normalizeHashData(data)).digest();
 }
 /**
 * Computes the SHA-3 hash of the given data using the 384-bit digest.
 *
 * @param {BinaryLike} data - The input data to hash
-* @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+* @param {BufferEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
 *
 * @returns {string | Buffer} The hash digest in the specified encoding
 *
@@ -121,7 +122,7 @@ function cryptoSha3256ToBuffer(data) {
 * ```
 */
 function cryptoSha3384(data, outputEncoding = "hex") {
-	return createHash("sha3-384").update(data).digest(outputEncoding);
+	return createHash("sha3-384").update(normalizeHashData(data)).digest(outputEncoding);
 }
 /**
 * Computes the SHA-3 hash of the given data using the 384-bit digest and returns the raw buffer.
@@ -138,13 +139,13 @@ function cryptoSha3384(data, outputEncoding = "hex") {
 * ```
 */
 function cryptoSha3384ToBuffer(data) {
-	return createHash("sha3-384").update(data).digest();
+	return createHash("sha3-384").update(normalizeHashData(data)).digest();
 }
 /**
 * Computes the SHA-3 hash of the given data using the 512-bit digest.
 *
 * @param {BinaryLike} data - The input data to hash
-* @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+* @param {BufferEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
 *
 * @returns {string | Buffer} The hash digest in the specified encoding
 *
@@ -156,7 +157,7 @@ function cryptoSha3384ToBuffer(data) {
 * ```
 */
 function cryptoSha3512(data, outputEncoding = "hex") {
-	return createHash("sha3-512").update(data).digest(outputEncoding);
+	return createHash("sha3-512").update(normalizeHashData(data)).digest(outputEncoding);
 }
 /**
 * Computes the SHA-3 hash of the given data using the 512-bit digest and returns the raw buffer.
@@ -173,7 +174,10 @@ function cryptoSha3512(data, outputEncoding = "hex") {
 * ```
 */
 function cryptoSha3512ToBuffer(data) {
-	return createHash("sha3-512").update(data).digest();
+	return createHash("sha3-512").update(normalizeHashData(data)).digest();
+}
+function normalizeHashData(data) {
+	return typeof data === "string" || ArrayBuffer.isView(data) ? data : Buffer.from(data);
 }
 //#endregion
 export { cryptoMd5, cryptoMd5ToBuffer, cryptoSha3224, cryptoSha3224ToBuffer, cryptoSha3256, cryptoSha3256ToBuffer, cryptoSha3384, cryptoSha3384ToBuffer, cryptoSha3512, cryptoSha3512ToBuffer };