@kikiutils/shared 15.0.3 → 15.1.0

package/dist/classes/precision-number.js

@@ -1,33 +1,51 @@
 import { Decimal } from "decimal.js";
 //#region src/classes/precision-number.ts
 /**
-* Class representing a precision number with configurable decimal places and rounding.
+* Chainable fixed-decimal wrapper around `decimal.js`.
 *
-* This class leverages the Decimal.js library to ensure accurate arithmetic operations
-* with floating point numbers. It provides methods for various arithmetic operations
-* (addition, subtraction, multiplication, division) as well as comparison and utility
-* methods to check the state of the number (e.g., if it is finite, an integer, zero, etc.).
+* `PrecisionNumber` stores values as `Decimal`, rounds every mutating operation to
+* the configured decimal places, and exposes both mutable and immutable arithmetic
+* methods. Mutable methods (`plus`, `minus`, `times`, `dividedBy`, `modulo`,
+* `pow`, `clamp`, `ceil`, `floor`, `negate`, `absoluteValue`) update the current
+* instance and return `this`; immutable methods prefixed with `to` return a new
+* `PrecisionNumber` with the same precision settings.
 *
-* The class also includes custom symbol methods to support Node.js inspection and primitive
-* type conversion.
+* @example
+* ```typescript
+* import { PrecisionNumber } from '@kikiutils/shared/classes/precision-number';
 *
-* The class supports in-place modification methods that alter the current instance's value,
-* such as `plus`, `minus`, `times`, `dividedBy`, and others. Additionally, methods prefixed
-* with `to` (e.g., `toPlus`, `toMinus`) return a new instance of `PrecisionNumber` with the
-* modified value, leaving the original instance unchanged.
+* const value = new PrecisionNumber('1.239', 2).plus('2.111');
+* value.toString(); // '3.35'
+* value.toMinus('1').toString(); // '2.35' (original value remains '3.35')
+* ```
 */
 var PrecisionNumber = class PrecisionNumber {
 	#decimalPlaces;
 	#rounding;
 	#decimal;
+	/**
+	* Creates a fixed-decimal number.
+	*
+	* @param {PrecisionNumberValue} [value] - Initial value (default: `'0'`)
+	* @param {number} [decimalPlaces] - Decimal places retained after operations (default: `2`)
+	* @param {Decimal.Rounding} [rounding] - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`)
+	*/
 	constructor(value = "0", decimalPlaces = 2, rounding = Decimal.ROUND_DOWN) {
 		this.#decimalPlaces = decimalPlaces;
 		this.#rounding = rounding;
 		this.#decimal = this.#decimalToFixedDecimal(new Decimal(value.toString().trim()));
 	}
+	/**
+	* Returns the formatted value when inspected by Node.js utilities.
+	*/
 	[Symbol.for("nodejs.util.inspect.custom")]() {
 		return this.value;
 	}
+	/**
+	* Converts to a number for numeric coercion and to the fixed string otherwise.
+	*
+	* @param {string} hint - JavaScript primitive-conversion hint
+	*/
 	[Symbol.toPrimitive](hint) {
 		if (hint === "number") return this.#decimal.toNumber();
 		return this.value;
@@ -35,95 +53,320 @@ var PrecisionNumber = class PrecisionNumber {
 	#decimalToFixedDecimal(decimal) {
 		return decimal.toDecimalPlaces(this.#decimalPlaces, this.#rounding);
 	}
+	#valueToString(value) {
+		return value.toString().trim();
+	}
+	/**
+	* Decimal places retained by mutating operations and default formatting.
+	*/
+	get decimalPlaces() {
+		return this.#decimalPlaces;
+	}
+	/**
+	* Decimal.js rounding mode used by mutating operations and default formatting.
+	*/
+	get rounding() {
+		return this.#rounding;
+	}
+	/**
+	* Fixed-decimal string using the instance precision and rounding mode.
+	*/
 	get value() {
 		return this.#decimal.toFixed(this.#decimalPlaces, this.#rounding);
 	}
+	/**
+	* Formats a value with decimal.js without creating a reusable instance.
+	*
+	* @param {PrecisionNumberValue} value - Value to format
+	* @param {number} [decimalPlaces] - Decimal places to output (default: `2`)
+	* @param {Decimal.Rounding} [rounding] - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`)
+	*
+	* @returns {string} Fixed-decimal string
+	*/
 	static toFixed(value, decimalPlaces = 2, rounding = Decimal.ROUND_DOWN) {
 		return new Decimal(value.toString().trim()).toFixed(decimalPlaces, rounding);
 	}
+	/**
+	* Replaces the current value with its absolute value.
+	*
+	* @returns {this} The current instance for chaining
+	*/
 	absoluteValue() {
 		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.absoluteValue());
 		return this;
 	}
+	/**
+	* Rounds the current value up to the nearest integer in place.
+	*
+	* The stored value still uses this instance's configured decimal places for output.
+	*
+	* @returns {this} The current instance for chaining
+	*/
+	ceil() {
+		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.ceil());
+		return this;
+	}
+	/**
+	* Restricts the current value to the inclusive range `[min, max]` in place.
+	*
+	* @param {PrecisionNumberValue} min - Lower bound
+	* @param {PrecisionNumberValue} max - Upper bound
+	*
+	* @returns {this} The current instance for chaining
+	*
+	* @throws {Error} If `min` is greater than `max`
+	*/
+	clamp(min, max) {
+		const minDecimal = new Decimal(this.#valueToString(min));
+		const maxDecimal = new Decimal(this.#valueToString(max));
+		if (minDecimal.gt(maxDecimal)) throw new Error("Invalid clamp range: min cannot be greater than max");
+		this.#decimal = this.#decimalToFixedDecimal(Decimal.min(Decimal.max(this.#decimal, minDecimal), maxDecimal));
+		return this;
+	}
+	/**
+	* Returns a new instance with the same value, decimal places, and rounding mode.
+	*/
+	clone() {
+		return new PrecisionNumber(this.#decimal, this.#decimalPlaces, this.#rounding);
+	}
+	/**
+	* Divides the current value by another value in place.
+	*
+	* @param {PrecisionNumberValue} value - Divisor
+	*
+	* @returns {this} The current instance for chaining
+	*/
 	dividedBy(value) {
-		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.dividedBy(value.toString().trim()));
+		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.dividedBy(this.#valueToString(value)));
 		return this;
 	}
+	/**
+	* Checks whether the current value equals another value.
+	*
+	* @param {PrecisionNumberValue} value - Value to compare
+	*
+	* @returns {boolean} `true` when both numeric values are equal
+	*/
 	equals(value) {
-		return this.#decimal.equals(value.toString().trim());
+		return this.#decimal.equals(this.#valueToString(value));
+	}
+	/**
+	* Rounds the current value down to the nearest integer in place.
+	*
+	* The stored value still uses this instance's configured decimal places for output.
+	*
+	* @returns {this} The current instance for chaining
+	*/
+	floor() {
+		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.floor());
+		return this;
 	}
+	/**
+	* Checks whether the current value is greater than another value.
+	*/
 	gt(value) {
-		return this.#decimal.gt(value.toString().trim());
+		return this.#decimal.gt(this.#valueToString(value));
 	}
+	/**
+	* Checks whether the current value is greater than or equal to another value.
+	*/
 	gte(value) {
-		return this.#decimal.gte(value.toString().trim());
+		return this.#decimal.gte(this.#valueToString(value));
 	}
+	/**
+	* Checks whether the current value is finite.
+	*/
 	isFinite() {
 		return this.#decimal.isFinite();
 	}
+	/**
+	* Checks whether the current value is an integer.
+	*/
 	isInteger() {
 		return this.#decimal.isInteger();
 	}
+	/**
+	* Checks whether the current value is `NaN`.
+	*/
 	isNaN() {
 		return this.#decimal.isNaN();
 	}
+	/**
+	* Checks whether the current value is negative.
+	*/
 	isNegative() {
 		return this.#decimal.isNegative();
 	}
+	/**
+	* Checks whether the current value is positive.
+	*/
 	isPositive() {
 		return this.#decimal.isPositive();
 	}
+	/**
+	* Checks whether the current value is zero.
+	*/
 	isZero() {
 		return this.#decimal.isZero();
 	}
+	/**
+	* Checks whether the current value is less than another value.
+	*/
 	lt(value) {
-		return this.#decimal.lt(value.toString().trim());
+		return this.#decimal.lt(this.#valueToString(value));
 	}
+	/**
+	* Checks whether the current value is less than or equal to another value.
+	*/
 	lte(value) {
-		return this.#decimal.lte(value.toString().trim());
+		return this.#decimal.lte(this.#valueToString(value));
 	}
+	/**
+	* Subtracts another value from the current value in place.
+	*/
 	minus(value) {
-		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.minus(value.toString().trim()));
+		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.minus(this.#valueToString(value)));
 		return this;
 	}
+	/**
+	* Replaces the current value with the remainder after division by another value.
+	*
+	* @param {PrecisionNumberValue} value - Divisor used to compute the remainder
+	*
+	* @returns {this} The current instance for chaining
+	*/
+	modulo(value) {
+		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.modulo(this.#valueToString(value)));
+		return this;
+	}
+	/**
+	* Negates the current value in place.
+	*/
 	negate() {
 		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.negated());
 		return this;
 	}
+	/**
+	* Adds another value to the current value in place.
+	*/
 	plus(value) {
-		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.plus(value.toString().trim()));
+		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.plus(this.#valueToString(value)));
+		return this;
+	}
+	/**
+	* Raises the current value to an exponent in place.
+	*
+	* @param {PrecisionNumberValue} value - Exponent
+	*
+	* @returns {this} The current instance for chaining
+	*/
+	pow(value) {
+		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.pow(this.#valueToString(value)));
 		return this;
 	}
+	/**
+	* Multiplies the current value by another value in place.
+	*/
 	times(value) {
-		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.times(value.toString().trim()));
+		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.times(this.#valueToString(value)));
 		return this;
 	}
+	/**
+	* Returns a new instance with the absolute value.
+	*/
 	toAbsoluteValue() {
 		return new PrecisionNumber(this.#decimal.absoluteValue(), this.#decimalPlaces, this.#rounding);
 	}
+	/**
+	* Returns a new instance rounded up to the nearest integer.
+	*/
+	toCeil() {
+		return new PrecisionNumber(this.#decimal.ceil(), this.#decimalPlaces, this.#rounding);
+	}
+	/**
+	* Returns a new instance restricted to the inclusive range `[min, max]`.
+	*
+	* @param {PrecisionNumberValue} min - Lower bound
+	* @param {PrecisionNumberValue} max - Upper bound
+	*
+	* @throws {Error} If `min` is greater than `max`
+	*/
+	toClamped(min, max) {
+		return this.clone().clamp(min, max);
+	}
+	/**
+	* Returns a new instance divided by another value.
+	*/
 	toDividedBy(value) {
-		return new PrecisionNumber(this.#decimal.dividedBy(value.toString().trim()), this.#decimalPlaces, this.#rounding);
+		return new PrecisionNumber(this.#decimal.dividedBy(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);
 	}
+	/**
+	* Returns a new instance rounded down to the nearest integer.
+	*/
+	toFloor() {
+		return new PrecisionNumber(this.#decimal.floor(), this.#decimalPlaces, this.#rounding);
+	}
+	/**
+	* Serializes to the fixed-decimal string.
+	*/
 	toJSON() {
 		return this.value;
 	}
+	/**
+	* Returns a new instance with another value subtracted.
+	*/
 	toMinus(value) {
-		return new PrecisionNumber(this.#decimal.minus(value.toString().trim()), this.#decimalPlaces, this.#rounding);
+		return new PrecisionNumber(this.#decimal.minus(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);
+	}
+	/**
+	* Returns a new instance with the remainder after division by another value.
+	*/
+	toModulo(value) {
+		return new PrecisionNumber(this.#decimal.modulo(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);
 	}
+	/**
+	* Returns a new instance with the value negated.
+	*/
 	toNegated() {
 		return new PrecisionNumber(this.#decimal.negated(), this.#decimalPlaces, this.#rounding);
 	}
+	/**
+	* Returns a new instance with another value added.
+	*/
 	toPlus(value) {
-		return new PrecisionNumber(this.#decimal.plus(value.toString().trim()), this.#decimalPlaces, this.#rounding);
-	}
+		return new PrecisionNumber(this.#decimal.plus(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);
+	}
+	/**
+	* Returns a new instance raised to an exponent.
+	*/
+	toPow(value) {
+		return new PrecisionNumber(this.#decimal.pow(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);
+	}
+	/**
+	* Converts the current value to a JavaScript number.
+	*
+	* Use `toString`/`value` when preserving decimal precision is more important than native-number ergonomics.
+	*/
+	toNumber() {
+		return this.#decimal.toNumber();
+	}
+	/**
+	* Converts the current value to its fixed-decimal string.
+	*/
 	toString() {
 		return this.value;
 	}
+	/**
+	* Formats the current value with custom precision and rounding for this call only.
+	*/
 	toFixed(decimalPlaces = this.#decimalPlaces, rounding = this.#rounding) {
 		return this.#decimal.toFixed(decimalPlaces, rounding);
 	}
+	/**
+	* Returns a new instance multiplied by another value.
+	*/
 	toTimes(value) {
-		return new PrecisionNumber(this.#decimal.times(value.toString().trim()), this.#decimalPlaces, this.#rounding);
+		return new PrecisionNumber(this.#decimal.times(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);
 	}
 };
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"precision-number.js","names":["#decimalPlaces","#rounding","#decimal","#decimalToFixedDecimal"],"sources":["../../src/classes/precision-number.ts"],"sourcesContent":["import { Decimal } from 'decimal.js';\n\nexport type PrecisionNumberValue = Decimal.Value | PrecisionNumber | { toString: () => string };\n\n/**\n * Class representing a precision number with configurable decimal places and rounding.\n *\n * This class leverages the Decimal.js library to ensure accurate arithmetic operations\n * with floating point numbers. It provides methods for various arithmetic operations\n * (addition, subtraction, multiplication, division) as well as comparison and utility\n * methods to check the state of the number (e.g., if it is finite, an integer, zero, etc.).\n *\n * The class also includes custom symbol methods to support Node.js inspection and primitive\n * type conversion.\n *\n * The class supports in-place modification methods that alter the current instance's value,\n * such as `plus`, `minus`, `times`, `dividedBy`, and others. Additionally, methods prefixed\n * with `to` (e.g., `toPlus`, `toMinus`) return a new instance of `PrecisionNumber` with the\n * modified value, leaving the original instance unchanged.\n */\nexport class PrecisionNumber {\n    // Private properties\n    readonly #decimalPlaces: number;\n    readonly #rounding: Decimal.Rounding;\n    #decimal: Decimal;\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    [Symbol.for('nodejs.util.inspect.custom')]() {\n        return this.value;\n    }\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    // Public getters\n    get value() {\n        return this.#decimal.toFixed(this.#decimalPlaces, this.#rounding);\n    }\n\n    // Static methods\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    absoluteValue() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.absoluteValue());\n        return this;\n    }\n\n    dividedBy(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.dividedBy(value.toString().trim()));\n        return this;\n    }\n\n    equals(value: PrecisionNumberValue) {\n        return this.#decimal.equals(value.toString().trim());\n    }\n\n    gt(value: PrecisionNumberValue) {\n        return this.#decimal.gt(value.toString().trim());\n    }\n\n    gte(value: PrecisionNumberValue) {\n        return this.#decimal.gte(value.toString().trim());\n    }\n\n    isFinite() {\n        return this.#decimal.isFinite();\n    }\n\n    isInteger() {\n        return this.#decimal.isInteger();\n    }\n\n    isNaN() {\n        return this.#decimal.isNaN();\n    }\n\n    isNegative() {\n        return this.#decimal.isNegative();\n    }\n\n    isPositive() {\n        return this.#decimal.isPositive();\n    }\n\n    isZero() {\n        return this.#decimal.isZero();\n    }\n\n    lt(value: PrecisionNumberValue) {\n        return this.#decimal.lt(value.toString().trim());\n    }\n\n    lte(value: PrecisionNumberValue) {\n        return this.#decimal.lte(value.toString().trim());\n    }\n\n    minus(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.minus(value.toString().trim()));\n        return this;\n    }\n\n    negate() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.negated());\n        return this;\n    }\n\n    plus(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.plus(value.toString().trim()));\n        return this;\n    }\n\n    times(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.times(value.toString().trim()));\n        return this;\n    }\n\n    toAbsoluteValue() {\n        return new PrecisionNumber(this.#decimal.absoluteValue(), this.#decimalPlaces, this.#rounding);\n    }\n\n    toDividedBy(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.dividedBy(value.toString().trim()),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    toJSON() {\n        return this.value;\n    }\n\n    toMinus(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.minus(value.toString().trim()), this.#decimalPlaces, this.#rounding);\n    }\n\n    toNegated() {\n        return new PrecisionNumber(this.#decimal.negated(), this.#decimalPlaces, this.#rounding);\n    }\n\n    toPlus(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.plus(value.toString().trim()), this.#decimalPlaces, this.#rounding);\n    }\n\n    toString() {\n        return this.value;\n    }\n\n    toFixed(decimalPlaces: number = this.#decimalPlaces, rounding: Decimal.Rounding = this.#rounding) {\n        return this.#decimal.toFixed(decimalPlaces, rounding);\n    }\n\n    toTimes(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.times(value.toString().trim()), this.#decimalPlaces, this.#rounding);\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoBA,IAAa,kBAAb,MAAa,gBAAgB;CAEzB;CACA;CACA;CAEA,YACI,QAA8B,KAC9B,gBAAwB,GACxB,WAA6B,QAAQ,YACvC;AACE,QAAA,gBAAsB;AACtB,QAAA,WAAiB;AACjB,QAAA,UAAgB,MAAA,sBAA4B,IAAI,QAAQ,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;;CAIrF,CAAC,OAAO,IAAI,6BAA6B,IAAI;AACzC,SAAO,KAAK;;CAGhB,CAAC,OAAO,aAAa,MAAc;AAC/B,MAAI,SAAS,SAAU,QAAO,MAAA,QAAc,UAAU;AACtD,SAAO,KAAK;;CAIhB,uBAAuB,SAAkB;AACrC,SAAO,QAAQ,gBAAgB,MAAA,eAAqB,MAAA,SAAe;;CAIvE,IAAI,QAAQ;AACR,SAAO,MAAA,QAAc,QAAQ,MAAA,eAAqB,MAAA,SAAe;;CAIrE,OAAO,QACH,OACA,gBAAwB,GACxB,WAA6B,QAAQ,YACvC;AACE,SAAO,IAAI,QAAQ,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,eAAe,SAAS;;CAIhF,gBAAgB;AACZ,QAAA,UAAgB,MAAA,sBAA4B,MAAA,QAAc,eAAe,CAAC;AAC1E,SAAO;;CAGX,UAAU,OAA6B;AACnC,QAAA,UAAgB,MAAA,sBAA4B,MAAA,QAAc,UAAU,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;AAC7F,SAAO;;CAGX,OAAO,OAA6B;AAChC,SAAO,MAAA,QAAc,OAAO,MAAM,UAAU,CAAC,MAAM,CAAC;;CAGxD,GAAG,OAA6B;AAC5B,SAAO,MAAA,QAAc,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC;;CAGpD,IAAI,OAA6B;AAC7B,SAAO,MAAA,QAAc,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC;;CAGrD,WAAW;AACP,SAAO,MAAA,QAAc,UAAU;;CAGnC,YAAY;AACR,SAAO,MAAA,QAAc,WAAW;;CAGpC,QAAQ;AACJ,SAAO,MAAA,QAAc,OAAO;;CAGhC,aAAa;AACT,SAAO,MAAA,QAAc,YAAY;;CAGrC,aAAa;AACT,SAAO,MAAA,QAAc,YAAY;;CAGrC,SAAS;AACL,SAAO,MAAA,QAAc,QAAQ;;CAGjC,GAAG,OAA6B;AAC5B,SAAO,MAAA,QAAc,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC;;CAGpD,IAAI,OAA6B;AAC7B,SAAO,MAAA,QAAc,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC;;CAGrD,MAAM,OAA6B;AAC/B,QAAA,UAAgB,MAAA,sBAA4B,MAAA,QAAc,MAAM,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;AACzF,SAAO;;CAGX,SAAS;AACL,QAAA,UAAgB,MAAA,sBAA4B,MAAA,QAAc,SAAS,CAAC;AACpE,SAAO;;CAGX,KAAK,OAA6B;AAC9B,QAAA,UAAgB,MAAA,sBAA4B,MAAA,QAAc,KAAK,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;AACxF,SAAO;;CAGX,MAAM,OAA6B;AAC/B,QAAA,UAAgB,MAAA,sBAA4B,MAAA,QAAc,MAAM,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;AACzF,SAAO;;CAGX,kBAAkB;AACd,SAAO,IAAI,gBAAgB,MAAA,QAAc,eAAe,EAAE,MAAA,eAAqB,MAAA,SAAe;;CAGlG,YAAY,OAA6B;AACrC,SAAO,IAAI,gBACP,MAAA,QAAc,UAAU,MAAM,UAAU,CAAC,MAAM,CAAC,EAChD,MAAA,eACA,MAAA,SACH;;CAGL,SAAS;AACL,SAAO,KAAK;;CAGhB,QAAQ,OAA6B;AACjC,SAAO,IAAI,gBAAgB,MAAA,QAAc,MAAM,MAAM,UAAU,CAAC,MAAM,CAAC,EAAE,MAAA,eAAqB,MAAA,SAAe;;CAGjH,YAAY;AACR,SAAO,IAAI,gBAAgB,MAAA,QAAc,SAAS,EAAE,MAAA,eAAqB,MAAA,SAAe;;CAG5F,OAAO,OAA6B;AAChC,SAAO,IAAI,gBAAgB,MAAA,QAAc,KAAK,MAAM,UAAU,CAAC,MAAM,CAAC,EAAE,MAAA,eAAqB,MAAA,SAAe;;CAGhH,WAAW;AACP,SAAO,KAAK;;CAGhB,QAAQ,gBAAwB,MAAA,eAAqB,WAA6B,MAAA,UAAgB;AAC9F,SAAO,MAAA,QAAc,QAAQ,eAAe,SAAS;;CAGzD,QAAQ,OAA6B;AACjC,SAAO,IAAI,gBAAgB,MAAA,QAAc,MAAM,MAAM,UAAU,CAAC,MAAM,CAAC,EAAE,MAAA,eAAqB,MAAA,SAAe"}
+{"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.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":";;;AAkBA,MAAM,wCAAwC;CAC1C,OAAO;CACP,OAAO;CACP,OAAO;CACP,MAAM;CACN,QAAQ;CACR,QAAQ;CACR,OAAO;CACP,SAAS;CACT,MAAM;CACT;AAED,IAAa,YAAb,MAAuB;CACnB;CACA;CAEA;CAEA,YAAY,MAAc,UAAkB,UAAkB,OAAe,IAAI,eAAwB;AACrG,QAAA,gBAAsB;GAClB,GAAG;GACH;GACA;GACA;GACA;GACH;AAED,QAAA,SAAe,eAAe;AAC9B,QAAA,UAAgB,IAAI,SAAS;AAC7B,MAAI,QAAQ,IAAI,aAAa,aAAc,MAAK,eAAe,QAAQ;;CAG3E,IAAI,UAAU;AACV,SAAO,MAAA;;CAGX,MAAM,UAAU;AACZ,MAAI;AACA,SAAA,UAAgB,MAAM,MAAA,QAAc,QAAQ,MAAA,cAAoB;AAChE,UAAO;WACF,OAAO;AACZ,SAAA,OAAa,MAAM,MAAM;AACzB,UAAO;;;CAIf,aAAa;AACT,MAAI;AACA,SAAA,QAAc,SAAS;AACvB,UAAO;WACF,OAAO;AACZ,SAAA,OAAa,MAAM,MAAM;AACzB,UAAO;;;CAIf,YAAY,SAAiB,SAAiC;AAC1D,SAAO,MAAA,QAAc,YAAY,SAAS,QAAQ,CAAC,YAAY,GAAG;;CAGtE,kBAAkB,SAAiB,SAAiC;AAChE,SAAO,KAAK,YACR,SACA;GACI,GAAG;GACH,WAAW,SAAS,QAAQ,OAAO,MAAM,KAAK,UAAU,CAAC;GACzD,WAAW,SAAS,QAAQ,OAAO,MAAM,KAAK,UAAU,CAAC;GAC5D,CACJ;;CAGL,SAAS,KAAK;CAEd,MAAM,aAAa,gBAA0B,iBAA2B,SAAqC;AACzG,MAAI;AACA,UAAO,MAAM,MAAA,QAAc,aAAa,eAAe,UAAU,EAAE,gBAAgB,UAAU,EAAE,QAAQ;WAClG,OAAO;AACZ,SAAA,OAAa,MAAM,MAAM;AACzB,UAAO;;;CAIf,MAAM,QACF,WACA,YACA,WACA,iBACF;AACE,MAAI;AACA,SAAM,MAAA,QAAc,QAAQ,UAAU,UAAU,EAAE,WAAW,UAAU,EAAE,WAAW,gBAAgB;AACpG,UAAO;WACF,OAAO;AACZ,SAAA,OAAa,MAAM,MAAM;AACzB,UAAO;;;CAIf,cAAc;AACV,SAAO,MAAA,QAAc,aAAa;;CAGtC,MAAM,MAAM,MAAgB;AACxB,MAAI;AACA,SAAM,MAAA,QAAc,MAAM,KAAK,UAAU,CAAC;AAC1C,UAAO;WACF,OAAO;AACZ,SAAA,OAAa,MAAM,MAAM;AACzB,UAAO;;;CAIf,SAAS,KAAK;CAEd,MAAM,aAAa,gBAA0B,iBAA2B,SAAqC;AACzG,MAAI;AACA,UAAO,MAAM,MAAA,QAAc,aAAa,eAAe,UAAU,EAAE,gBAAgB,UAAU,EAAE,QAAQ;WAClG,OAAO;AACZ,SAAA,OAAa,MAAM,MAAM;AACzB,UAAO;;;CAIf,MAAM,QACF,WACA,YACA,WACA,iBACF;AACE,MAAI;AACA,SAAM,MAAA,QAAc,QAAQ,UAAU,UAAU,EAAE,WAAW,UAAU,EAAE,WAAW,gBAAgB;AACpG,UAAO;WACF,OAAO;AACZ,SAAA,OAAa,MAAM,MAAM;AACzB,UAAO;;;CAIf,MAAM,SAAS,OAAgD,SAA8B;AACzF,MAAI;GACA,MAAM,iBAAiB,MAAM,KAAK,EAAE,OAAO,cAAc;IACrD,OAAO,MAAM,UAAU;IACvB,QAAQ,OAAO,UAAU;IAC5B,EAAE;AAEH,SAAM,MAAA,QAAc,SAAS,gBAAgB,QAAQ;AACrD,UAAO;WACF,OAAO;AACZ,SAAA,OAAa,MAAM,MAAM;AACzB,UAAO;;;CAIf,eAAe,OAA2D;AACtE,QAAA,OAAa,QAAQ,sCAAsC"}
+{"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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"}

package/dist/clipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.js","names":[],"sources":["../src/clipboard.ts"],"sourcesContent":["type CopyResult =\n  | { error: unknown; ok: false }\n  | { ok: true };\n\n/**\n * Attempts to copy a Blob (e.g. image, plain text, HTML) to the user's clipboard using the ClipboardItem API.\n *\n * ⚠️ Usage Notes:\n * - Must be called in a **secure context** (HTTPS or localhost).\n * - Must be called **in response to a user interaction** (e.g. click, input).\n * - Not supported in Safari and some older browsers.\n *\n * @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content)\n * @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor\n *\n * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:\n *   - `{ ok: true }` if the copy succeeded\n *   - `{ ok: false, error }` if the copy failed, with the error included\n *\n * @example\n * ```typescript\n * import { copyBlobToClipboard } from '@kikiutils/shared/clipboard';\n *\n * const blob = new Blob(['Hello world'], { type: 'text/plain' });\n * const result = await copyBlobToClipboard(blob);\n * if (result.ok) {\n *     console.log('Copied blob!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult> {\n    if (!navigator.clipboard?.write) {\n        return {\n            error: new Error('Clipboard.write is not supported in this browser'),\n            ok: false,\n        };\n    }\n\n    try {\n        const item = new ClipboardItem({ [blob.type]: blob }, options);\n        await navigator.clipboard.write([item]);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n\n/**\n * Attempts to copy the given text to the user's clipboard using the modern Clipboard API.\n *\n * ⚠️ Usage Notes:\n * - Must be called in a **secure context** (HTTPS or localhost).\n * - Must be called **in response to a user interaction** (e.g. click, input).\n * - Not supported in some older browsers (especially legacy Safari).\n *\n * @param {string} text - The string to be copied to the clipboard\n *\n * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:\n *   - `{ ok: true }` if the copy succeeded\n *   - `{ ok: false, error }` if the copy failed, with the error included\n *\n * @example\n * ```typescript\n * import { copyTextToClipboard } from '@kikiutils/shared/clipboard';\n *\n * const result = await copyTextToClipboard('Hello!');\n * if (result.ok) {\n *     console.log('Copied!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyTextToClipboard(text: string): Promise<CopyResult> {\n    try {\n        await navigator.clipboard.writeText(text);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,eAAsB,oBAAoB,MAAY,SAAqD;AACvG,KAAI,CAAC,UAAU,WAAW,MACtB,QAAO;EACH,uBAAO,IAAI,MAAM,mDAAmD;EACpE,IAAI;EACP;AAGL,KAAI;EACA,MAAM,OAAO,IAAI,cAAc,GAAG,KAAK,OAAO,MAAM,EAAE,QAAQ;AAC9D,QAAM,UAAU,UAAU,MAAM,CAAC,KAAK,CAAC;AACvC,SAAO,EAAE,IAAI,MAAM;UACd,OAAO;AACZ,SAAO;GACH;GACA,IAAI;GACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BT,eAAsB,oBAAoB,MAAmC;AACzE,KAAI;AACA,QAAM,UAAU,UAAU,UAAU,KAAK;AACzC,SAAO,EAAE,IAAI,MAAM;UACd,OAAO;AACZ,SAAO;GACH;GACA,IAAI;GACP"}
+{"version":3,"file":"clipboard.js","names":[],"sources":["../src/clipboard.ts"],"sourcesContent":["type CopyResult =\n  | { error: unknown; ok: false }\n  | { ok: true };\n\n/**\n * Attempts to copy a Blob (e.g. image, plain text, HTML) to the user's clipboard using the ClipboardItem API.\n *\n * ⚠️ Usage Notes:\n * - Must be called in a **secure context** (HTTPS or localhost).\n * - Must be called **in response to a user interaction** (e.g. click, input).\n * - Not supported in Safari and some older browsers.\n *\n * @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content)\n * @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor\n *\n * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:\n *   - `{ ok: true }` if the copy succeeded\n *   - `{ ok: false, error }` if the copy failed, with the error included\n *\n * @example\n * ```typescript\n * import { copyBlobToClipboard } from '@kikiutils/shared/clipboard';\n *\n * const blob = new Blob(['Hello world'], { type: 'text/plain' });\n * const result = await copyBlobToClipboard(blob);\n * if (result.ok) {\n *     console.log('Copied blob!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult> {\n    if (!navigator.clipboard?.write) {\n        return {\n            error: new Error('Clipboard.write is not supported in this browser'),\n            ok: false,\n        };\n    }\n\n    try {\n        const item = new ClipboardItem({ [blob.type]: blob }, options);\n        await navigator.clipboard.write([item]);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n\n/**\n * Attempts to copy the given text to the user's clipboard using the modern Clipboard API.\n *\n * ⚠️ Usage Notes:\n * - Must be called in a **secure context** (HTTPS or localhost).\n * - Must be called **in response to a user interaction** (e.g. click, input).\n * - Not supported in some older browsers (especially legacy Safari).\n *\n * @param {string} text - The string to be copied to the clipboard\n *\n * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:\n *   - `{ ok: true }` if the copy succeeded\n *   - `{ ok: false, error }` if the copy failed, with the error included\n *\n * @example\n * ```typescript\n * import { copyTextToClipboard } from '@kikiutils/shared/clipboard';\n *\n * const result = await copyTextToClipboard('Hello!');\n * if (result.ok) {\n *     console.log('Copied!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyTextToClipboard(text: string): Promise<CopyResult> {\n    try {\n        await navigator.clipboard.writeText(text);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,eAAsB,oBAAoB,MAAY,SAAqD;CACvG,IAAI,CAAC,UAAU,WAAW,OACtB,OAAO;EACH,uBAAO,IAAI,MAAM,mDAAmD;EACpE,IAAI;EACP;CAGL,IAAI;EACA,MAAM,OAAO,IAAI,cAAc,GAAG,KAAK,OAAO,MAAM,EAAE,QAAQ;EAC9D,MAAM,UAAU,UAAU,MAAM,CAAC,KAAK,CAAC;EACvC,OAAO,EAAE,IAAI,MAAM;UACd,OAAO;EACZ,OAAO;GACH;GACA,IAAI;GACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BT,eAAsB,oBAAoB,MAAmC;CACzE,IAAI;EACA,MAAM,UAAU,UAAU,UAAU,KAAK;EACzC,OAAO,EAAE,IAAI,MAAM;UACd,OAAO;EACZ,OAAO;GACH;GACA,IAAI;GACP"}

package/dist/consola.js.map

@@ -1 +1 @@
-{"version":3,"file":"consola.js","names":[],"sources":["../src/consola.ts"],"sourcesContent":["import { createConsola } from 'consola';\n\n/**\n * A consola logger instance.\n *\n * The logger's level is determined based on the `CONSOLA_LOGGER_LEVEL` and `NODE_ENV` environment variables.\n * If `CONSOLA_LOGGER_LEVEL` is set, it will be used; otherwise, if `NODE_ENV` is `production`,\n * the level will be set to `0`.\n *\n * To manually change the level, assign the desired level to `logger.level`.\n *\n * See available levels [here](https://github.com/unjs/consola?tab=readme-ov-file#log-level).\n *\n * @example\n * ```typescript\n * import { logger } from '@kikiutils/shared/consola';\n *\n * logger.info('test'); // ℹ test 3:56:30 AM\n *\n * // Manually change the level\n * logger.level = 3;\n * ```\n */\nexport const consolaLogger = createConsola();\nexport const logger = consolaLogger;\nif (process.env.CONSOLA_LOGGER_LEVEL !== undefined) consolaLogger.level = +process.env.CONSOLA_LOGGER_LEVEL;\nelse consolaLogger.level = process.env.NODE_ENV === 'production' ? 0 : consolaLogger.level;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,gBAAgB,eAAe;AAC5C,MAAa,SAAS;AACtB,IAAI,QAAQ,IAAI,yBAAyB,KAAA,EAAW,eAAc,QAAQ,CAAC,QAAQ,IAAI;IAClF,eAAc,QAAQ,QAAQ,IAAI,aAAa,eAAe,IAAI,cAAc"}
+{"version":3,"file":"consola.js","names":[],"sources":["../src/consola.ts"],"sourcesContent":["import { createConsola } from 'consola';\n\n/**\n * A consola logger instance.\n *\n * The logger's level is determined based on the `CONSOLA_LOGGER_LEVEL` and `NODE_ENV` environment variables.\n * If `CONSOLA_LOGGER_LEVEL` is set, it will be used; otherwise, if `NODE_ENV` is `production`,\n * the level will be set to `0`.\n *\n * To manually change the level, assign the desired level to `logger.level`.\n *\n * See available levels [here](https://github.com/unjs/consola?tab=readme-ov-file#log-level).\n *\n * @example\n * ```typescript\n * import { logger } from '@kikiutils/shared/consola';\n *\n * logger.info('test'); // ℹ test 3:56:30 AM\n *\n * // Manually change the level\n * logger.level = 3;\n * ```\n */\nexport const consolaLogger = createConsola();\nexport const logger = consolaLogger;\nif (process.env.CONSOLA_LOGGER_LEVEL !== undefined) consolaLogger.level = +process.env.CONSOLA_LOGGER_LEVEL;\nelse consolaLogger.level = process.env.NODE_ENV === 'production' ? 0 : consolaLogger.level;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,gBAAgB,eAAe;AAC5C,MAAa,SAAS;AACtB,IAAI,QAAQ,IAAI,yBAAyB,KAAA,GAAW,cAAc,QAAQ,CAAC,QAAQ,IAAI;KAClF,cAAc,QAAQ,QAAQ,IAAI,aAAa,eAAe,IAAI,cAAc"}

package/dist/crypto-hash.d.ts

@@ -13,7 +13,7 @@ import { BinaryLike, BinaryToTextEncoding } from "node:crypto";
  * ```typescript
  * import { cryptoMd5 } from '@kikiutils/shared/crypto-hash';
  *
- * console.log(cryptoMd5('test')); // 33ed9a05a10b21f0...
+ * console.log(cryptoMd5('test')); // 098f6bcd4621d373cade4e832627b4f6
  * ```
  */
 declare function cryptoMd5(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
@@ -44,7 +44,7 @@ declare function cryptoMd5ToBuffer(data: BinaryLike): NonSharedBuffer;
  * ```typescript
  * import { cryptoSha3224 } from '@kikiutils/shared/crypto-hash';
  *
- * console.log(cryptoSha3224('test')); // 0qW8FoqDcFmkpuqR9J3uT8YX...
+ * console.log(cryptoSha3224('test')); // 3797bf0afbbfca4a7bbba7602a2b552746876517a7f9b7ce2db0ae7b
  * ```
  */
 declare function cryptoSha3224(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
@@ -59,7 +59,7 @@ declare function cryptoSha3224(data: BinaryLike, outputEncoding?: BinaryToTextEn
  * ```typescript
  * import { cryptoSha3224ToBuffer } from '@kikiutils/shared/crypto-hash';
  *
- * console.log(cryptoSha3224ToBuffer('test')); // <Buffer 0q W8 Fo ...>
+ * console.log(cryptoSha3224ToBuffer('test')); // <Buffer 37 97 bf 0a ...>
  * ```
  */
 declare function cryptoSha3224ToBuffer(data: BinaryLike): NonSharedBuffer;
@@ -106,7 +106,7 @@ declare function cryptoSha3256ToBuffer(data: BinaryLike): NonSharedBuffer;
  * ```typescript
  * import { cryptoSha3384 } from '@kikiutils/shared/crypto-hash';
  *
- * console.log(cryptoSha3384('test')); // 1Q2wQAYaZ4o8vWX5bEB2n3Y...
+ * console.log(cryptoSha3384('test')); // e516dabb23b6e30026863543282780a3ae0dccf05551cf0295178d7f...
  * ```
  */
 declare function cryptoSha3384(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
@@ -121,7 +121,7 @@ declare function cryptoSha3384(data: BinaryLike, outputEncoding?: BinaryToTextEn
  * ```typescript
  * import { cryptoSha3384ToBuffer } from '@kikiutils/shared/crypto-hash';
  *
- * console.log(cryptoSha3384ToBuffer('test')); // <Buffer 1Q 2w QZ ...>
+ * console.log(cryptoSha3384ToBuffer('test')); // <Buffer e5 16 da bb ...>
  * ```
  */
 declare function cryptoSha3384ToBuffer(data: BinaryLike): NonSharedBuffer;
@@ -137,7 +137,7 @@ declare function cryptoSha3384ToBuffer(data: BinaryLike): NonSharedBuffer;
  * ```typescript
  * import { cryptoSha3512 } from '@kikiutils/shared/crypto-hash';
  *
- * console.log(cryptoSha3512('test')); // b_NQJ8FJBY9dIjm1q7...
+ * console.log(cryptoSha3512('test')); // 9ece086e9bac491fac5c1d1046ca11d737b92a2b2ebd93f005d7...
  * ```
  */
 declare function cryptoSha3512(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
@@ -152,7 +152,7 @@ declare function cryptoSha3512(data: BinaryLike, outputEncoding?: BinaryToTextEn
  * ```typescript
  * import { cryptoSha3512ToBuffer } from '@kikiutils/shared/crypto-hash';
  *
- * console.log(cryptoSha3512ToBuffer('test')); // <Buffer b_ NQ ...>
+ * console.log(cryptoSha3512ToBuffer('test')); // <Buffer 9e ce 08 6e ...>
  * ```
  */
 declare function cryptoSha3512ToBuffer(data: BinaryLike): NonSharedBuffer;

package/dist/crypto-hash.js

@@ -12,7 +12,7 @@ import { createHash } from "node:crypto";
 * ```typescript
 * import { cryptoMd5 } from '@kikiutils/shared/crypto-hash';
 *
-* console.log(cryptoMd5('test')); // 33ed9a05a10b21f0...
+* console.log(cryptoMd5('test')); // 098f6bcd4621d373cade4e832627b4f6
 * ```
 */
 function cryptoMd5(data, outputEncoding = "hex") {
@@ -47,7 +47,7 @@ function cryptoMd5ToBuffer(data) {
 * ```typescript
 * import { cryptoSha3224 } from '@kikiutils/shared/crypto-hash';
 *
-* console.log(cryptoSha3224('test')); // 0qW8FoqDcFmkpuqR9J3uT8YX...
+* console.log(cryptoSha3224('test')); // 3797bf0afbbfca4a7bbba7602a2b552746876517a7f9b7ce2db0ae7b
 * ```
 */
 function cryptoSha3224(data, outputEncoding = "hex") {
@@ -64,7 +64,7 @@ function cryptoSha3224(data, outputEncoding = "hex") {
 * ```typescript
 * import { cryptoSha3224ToBuffer } from '@kikiutils/shared/crypto-hash';
 *
-* console.log(cryptoSha3224ToBuffer('test')); // <Buffer 0q W8 Fo ...>
+* console.log(cryptoSha3224ToBuffer('test')); // <Buffer 37 97 bf 0a ...>
 * ```
 */
 function cryptoSha3224ToBuffer(data) {
@@ -117,7 +117,7 @@ function cryptoSha3256ToBuffer(data) {
 * ```typescript
 * import { cryptoSha3384 } from '@kikiutils/shared/crypto-hash';
 *
-* console.log(cryptoSha3384('test')); // 1Q2wQAYaZ4o8vWX5bEB2n3Y...
+* console.log(cryptoSha3384('test')); // e516dabb23b6e30026863543282780a3ae0dccf05551cf0295178d7f...
 * ```
 */
 function cryptoSha3384(data, outputEncoding = "hex") {
@@ -134,7 +134,7 @@ function cryptoSha3384(data, outputEncoding = "hex") {
 * ```typescript
 * import { cryptoSha3384ToBuffer } from '@kikiutils/shared/crypto-hash';
 *
-* console.log(cryptoSha3384ToBuffer('test')); // <Buffer 1Q 2w QZ ...>
+* console.log(cryptoSha3384ToBuffer('test')); // <Buffer e5 16 da bb ...>
 * ```
 */
 function cryptoSha3384ToBuffer(data) {
@@ -152,7 +152,7 @@ function cryptoSha3384ToBuffer(data) {
 * ```typescript
 * import { cryptoSha3512 } from '@kikiutils/shared/crypto-hash';
 *
-* console.log(cryptoSha3512('test')); // b_NQJ8FJBY9dIjm1q7...
+* console.log(cryptoSha3512('test')); // 9ece086e9bac491fac5c1d1046ca11d737b92a2b2ebd93f005d7...
 * ```
 */
 function cryptoSha3512(data, outputEncoding = "hex") {
@@ -169,7 +169,7 @@ function cryptoSha3512(data, outputEncoding = "hex") {
 * ```typescript
 * import { cryptoSha3512ToBuffer } from '@kikiutils/shared/crypto-hash';
 *
-* console.log(cryptoSha3512ToBuffer('test')); // <Buffer b_ NQ ...>
+* console.log(cryptoSha3512ToBuffer('test')); // <Buffer 9e ce 08 6e ...>
 * ```
 */
 function cryptoSha3512ToBuffer(data) {