npm - @kikiutils/shared - Versions diffs - 20.1.0 → 20.1.2 - Mend

@kikiutils/shared 20.1.0 → 20.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (41) hide show

package/dist/classes/path.d.ts.map +1 -1
package/dist/classes/path.js +30 -30
package/dist/classes/path.js.map +1 -1
package/dist/classes/precision-number.js.map +1 -1
package/dist/enum.d.ts +4 -3
package/dist/enum.d.ts.map +1 -1
package/dist/enum.js +3 -2
package/dist/enum.js.map +1 -1
package/dist/env.js.map +1 -1
package/dist/event-awaiter.d.ts.map +1 -1
package/dist/event-awaiter.js +6 -6
package/dist/event-awaiter.js.map +1 -1
package/dist/general.d.ts +3 -2
package/dist/general.d.ts.map +1 -1
package/dist/general.js.map +1 -1
package/dist/logger/_internals/logger.d.ts.map +1 -1
package/dist/logger/_internals/logger.js +3 -2
package/dist/logger/_internals/logger.js.map +1 -1
package/dist/logger/node/_internals/file-writer.js +7 -7
package/dist/logger/node/_internals/file-writer.js.map +1 -1
package/dist/logger/node/index.js +8 -8
package/dist/logger/node/index.js.map +1 -1
package/dist/storages/redis/keyed-store.d.ts.map +1 -1
package/dist/storages/redis/keyed-store.js +10 -10
package/dist/storages/redis/keyed-store.js.map +1 -1
package/dist/storages/redis/msgpack.js +2 -2
package/dist/storages/redis/msgpack.js.map +1 -1
package/dist/time.d.ts.map +1 -1
package/dist/time.js +4 -4
package/dist/time.js.map +1 -1
package/package.json +46 -26
package/src/classes/path.ts +30 -30
package/src/enum.ts +11 -5
package/src/event-awaiter.ts +6 -6
package/src/general.ts +5 -3
package/src/logger/_internals/logger.ts +7 -2
package/src/logger/node/_internals/file-writer.ts +7 -7
package/src/logger/node/index.ts +9 -9
package/src/storages/redis/keyed-store.ts +10 -10
package/src/storages/redis/msgpack.ts +2 -2
package/src/time.ts +4 -4

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

	@@ -1 +1 @@
1	- {"version":3,"file":"path.d.ts","names":[],"sources":["../../src/classes/path.ts"],"mappings":";;;;;KAMK,oBAAoB,cAAc,qBAAqB,WAAW,0BAA0B,KAAK;;;;YAK1F,WAAW,GAAG,WAAW;;;;;;;;;;qBAWxB;;;;;;;EAWG,eAAG,OAAO;;;;;;MAoBlB,UAAM;;;;MAON;;;;;;;;;;SAeG,OAAO,YAAY,SAAS,wBAAqB;;;;;;;;;;;;;;SAiBjD,WAAW,OAAO,aAAU;GASlC,OAAO,aAAa;;;;;;;;EAYrB,SAAS;;;;;;;;EAWT,WAAO;;;;;;;;EAWP;;;;;;;;EAWA;;;;;;;;EAWA,aAAS;;;;;;;;;;EAaT,QAAQ,OAAO,aAAU;;;;;;;;EAWzB,SAAK,SAAA;;;;;;;;;;EAaL,SAAS,IAAI,WAAQ;;;;;;;;;;;EAcrB,WAAO;EAIP;;;;;;;;;EAYA;;;;EAOA;;;;;;;;;~~EAYA~~,UAAU,MAAM,2BAA2B,IAAI,UAAO;;;;;;;;;EAYtD,cAAc,MAAM,2BAA2B,IAAI,cAAW;;;;;;;;;EAY9D,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;EAYpD,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;EAYpD,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;;;;;;;~~EAa1D~~,MAAM,SAAS,GAAG;IAAyB;MAAoB;EAC/D,MACI,WACK,GAAG;IAAyB;OAC7B,GAAG,cAER;EACH,MAAM,UAAU,GAAG,uBAAuB,GAAG,cAAc;;;;;;;;;~~EAa3D~~,QAAQ,MAAM,2BAA2B,IAAI,QAAK,QAAA,GAAA,SAAA;;;;;;;;;~~EAYlD~~,QACI,UACI,kBACC,GAAG;IACF;IACA;cAGP;EACH,QACI;IAGM;IACA;IACA;MAEP,QAAQ;EACX,QACI,UACI,kBACC,GAAG;IACF;IACA;cAGP,QAAQ;EACX,QACI,SAAS,GAAG;IACR;IACA;MAEL,QAAQ,GAAG;EACd,QACI;IACI;IACA;IACA;MAEL,QAAQ,MAAM,GAAG,OAAO;;;;;;;;;EAa3B,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;;;;;;;;;;;~~EAeX~~,OAAO,SAAS,WAAQ;;;;;;;;;EAYxB,MAAM,MAAM,2BAA2B,IAAI,MAAG;;;;;;;;;EAY9C,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;;~~EAapD~~,KACI,OAAO,GAAG;IACN;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KAAK,MAAM,GAAG;IAAgB;MAA0B,QAAQ,GAAG,cAAc,GAAG;EACpF,KAAK,OAAO,GAAG,cAAc,QAAQ,GAAG,cAAc,GAAG;;;;;;;;;~~EAwBzD~~,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;;;;;;EAY1D,UAAM;;;;;;;;;EAYN,aAAa,MAAM,2BAA2B,IAAI,aAAU"}
1	+ {"version":3,"file":"path.d.ts","names":[],"sources":["../../src/classes/path.ts"],"mappings":";;;;;KAMK,oBAAoB,cAAc,qBAAqB,WAAW,0BAA0B,KAAK;;;;YAK1F,WAAW,GAAG,WAAW;;;;;;;;;;qBAWxB;;;;;;;EAWG,eAAG,OAAO;;;;;;MAoBlB,UAAM;;;;MAON;;;;;;;;;;SAeG,OAAO,YAAY,SAAS,wBAAqB;;;;;;;;;;;;;;SAiBjD,WAAW,OAAO,aAAU;GASlC,OAAO,aAAa;;;;;;;;EAYrB,SAAS;;;;;;;;EAWT,WAAO;;;;;;;;EAWP;;;;;;;;EAWA;;;;;;;;EAWA,aAAS;;;;;;;;;;EAaT,QAAQ,OAAO,aAAU;;;;;;;;EAWzB,SAAK,SAAA;;;;;;;;;;EAaL,SAAS,IAAI,WAAQ;;;;;;;;;;;EAcrB,WAAO;EAIP;;;;;;;;;EAYA;;;;EAOA;;;;;;;;;EAYM,UAAU,MAAM,2BAA2B,IAAI,UAAO;;;;;;;;;EAYtD,cAAc,MAAM,2BAA2B,IAAI,cAAW;;;;;;;;;EAY9D,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;EAYpD,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;EAYpD,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;;;;;;;EAahE,MAAM,SAAS,GAAG;IAAyB;MAAoB;EAC/D,MACI,WACK,GAAG;IAAyB;OAC7B,GAAG,cAER;EACH,MAAM,UAAU,GAAG,uBAAuB,GAAG,cAAc;;;;;;;;;EAarD,QAAQ,MAAM,2BAA2B,IAAI,QAAK,QAAA,GAAA,SAAA;;;;;;;;;EAYxD,QACI,UACI,kBACC,GAAG;IACF;IACA;cAGP;EACH,QACI;IAGM;IACA;IACA;MAEP,QAAQ;EACX,QACI,UACI,kBACC,GAAG;IACF;IACA;cAGP,QAAQ;EACX,QACI,SAAS,GAAG;IACR;IACA;MAEL,QAAQ,GAAG;EACd,QACI;IACI;IACA;IACA;MAEL,QAAQ,MAAM,GAAG,OAAO;;;;;;;;;EAa3B,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;;;;;;;;;;;EAeL,OAAO,SAAS,WAAQ;;;;;;;;;EAYxB,MAAM,MAAM,2BAA2B,IAAI,MAAG;;;;;;;;;EAY9C,SAAS,MAAM,2BAA2B,IAAI,SAAM;;;;;;;;;;EAa1D,KACI,OAAO,GAAG;IACN;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KACI,MAAM,GAAG;IACL;IACA;MAEL,QAAQ,GAAG;EACd,KAAK,MAAM,GAAG;IAAgB;MAA0B,QAAQ,GAAG,cAAc,GAAG;EACpF,KAAK,OAAO,GAAG,cAAc,QAAQ,GAAG,cAAc,GAAG;;;;;;;;;EAwBnD,YAAY,MAAM,2BAA2B,IAAI,YAAS;;;;;;;;;EAY1D,UAAM;;;;;;;;;EAYN,aAAa,MAAM,2BAA2B,IAAI,aAAU"}

package/dist/classes/path.js CHANGED Viewed

@@ -200,8 +200,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.access}
 	*/
-	access(...args) {
-		return fsp.access(this.#value, ...args);
+	async access(...args) {
+		return await fsp.access(this.#value, ...args);
 	}
 	/**
 	* Appends data to the file at the stored path.
@@ -211,8 +211,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.appendFile}
 	*/
-	appendFile(...args) {
-		return fsp.appendFile(this.#value, ...args);
+	async appendFile(...args) {
+		return await fsp.appendFile(this.#value, ...args);
 	}
 	/**
 	* Changes the permissions of the stored path.
@@ -222,8 +222,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.chmod}
 	*/
-	chmod(...args) {
-		return fsp.chmod(this.#value, ...args);
+	async chmod(...args) {
+		return await fsp.chmod(this.#value, ...args);
 	}
 	/**
 	* Changes the owner and group of the stored path.
@@ -233,8 +233,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.chown}
 	*/
-	chown(...args) {
-		return fsp.chown(this.#value, ...args);
+	async chown(...args) {
+		return await fsp.chown(this.#value, ...args);
 	}
 	/**
 	* Copies the file at the stored path to a destination.
@@ -244,11 +244,11 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.copyFile}
 	*/
-	copyFile(...args) {
-		return fsp.copyFile(this.#value, ...args);
+	async copyFile(...args) {
+		return await fsp.copyFile(this.#value, ...args);
 	}
-	mkdir(...args) {
-		return fsp.mkdir(this.#value, ...args);
+	async mkdir(...args) {
+		return await fsp.mkdir(this.#value, ...args);
 	}
 	/**
 	* Opens the file at the stored path.
@@ -258,14 +258,14 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.open}
 	*/
-	open(...args) {
-		return fsp.open(this.#value, ...args);
+	async open(...args) {
+		return await fsp.open(this.#value, ...args);
 	}
-	readdir(...args) {
-		return fsp.readdir(this.#value, ...args);
+	async readdir(...args) {
+		return await fsp.readdir(this.#value, ...args);
 	}
-	readFile(...args) {
-		return fsp.readFile(this.#value, ...args);
+	async readFile(...args) {
+		return await fsp.readFile(this.#value, ...args);
 	}
 	/**
 	* Renames or moves the file or directory at the stored path.
@@ -277,8 +277,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rename}
 	*/
-	rename(newPath) {
-		return fsp.rename(this.#value, newPath.toString());
+	async rename(newPath) {
+		return await fsp.rename(this.#value, newPath.toString());
 	}
 	/**
 	* Removes the file or directory at the stored path.
@@ -288,8 +288,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rm}
 	*/
-	rm(...args) {
-		return fsp.rm(this.#value, ...args);
+	async rm(...args) {
+		return await fsp.rm(this.#value, ...args);
 	}
 	/**
 	* Removes the directory at the stored path.
@@ -299,8 +299,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.rmdir}
 	*/
-	rmdir(...args) {
-		return fsp.rmdir(this.#value, ...args);
+	async rmdir(...args) {
+		return await fsp.rmdir(this.#value, ...args);
 	}
 	async stat(opts) {
 		try {
@@ -318,8 +318,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.truncate}
 	*/
-	truncate(...args) {
-		return fsp.truncate(this.#value, ...args);
+	async truncate(...args) {
+		return await fsp.truncate(this.#value, ...args);
 	}
 	/**
 	* Deletes the file or symbolic link at the stored path.
@@ -329,8 +329,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.unlink}
 	*/
-	unlink() {
-		return fsp.unlink(this.#value);
+	async unlink() {
+		return await fsp.unlink(this.#value);
 	}
 	/**
 	* Writes data to the file at the stored path.
@@ -340,8 +340,8 @@ var Path = class Path {
 	*
 	* @see {@link https://nodejs.org/api/fs.html | Node.js fsPromises.writeFile}
 	*/
-	writeFile(...args) {
-		return fsp.writeFile(this.#value, ...args);
+	async writeFile(...args) {
+		return await fsp.writeFile(this.#value, ...args);
 	}
 };
 export { Path };

package/dist/classes/path.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"path.js","names":[],"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 * 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 An immutable file system path with Node.js path and file operations.\n \n @remarks\n * Path-composition methods return new instances and leave this instance unchanged.\n * File operations act on the stored path and forward Node.js defaults and promise rejections.\n * They do not update the stored path, including after a successful rename.\n * The constructor joins stringified inputs using the platform-specific Node.js path rules.\n /\nexport class Path {\n // Private instance properties\n readonly #value: string;\n\n // Constructor\n\n /\n Creates a normalized path value by joining the provided path segments.\n \n @param paths - Path segments accepted by Node.js `path.join` or another `Path` instance.\n /\n constructor(...paths: PathLike[]) {\n this.#value = nodePath.join(...this.#toStrings(paths));\n }\n\n // Private instance 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 instance accessors\n\n /\n The parent directory as a new `Path`; this instance is unchanged.\n \n @see {@link Path.dirname}\n /\n get parent() {\n return this.dirname();\n }\n\n /\n The normalized path string stored by this instance.\n /\n get value() {\n return this.#value;\n }\n\n // Public static methods\n\n /\n Creates a new path from a Node.js path object.\n \n @param pathObject - The path components to format.\n \n @returns A new normalized `Path`.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.format}\n /\n static format(pathObject: nodePath.FormatInputPathObject) {\n return new Path(nodePath.format(pathObject));\n }\n\n /\n Resolves joined path segments to an absolute path.\n \n @remarks\n * Inputs are joined before resolution; unlike Node.js `path.resolve`,\n * later absolute segments do not reset the path.\n \n @param paths - The stringified path segments to join.\n \n @returns A new absolute `Path`.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.resolve}\n /\n static resolve(...paths: PathLike[]) {\n return new this(...paths).resolve();\n }\n\n // Public instance methods\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 /\n Returns the final component of this path.\n \n @param suffix - An optional exact suffix to remove.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.basename}\n /\n basename(suffix?: string) {\n return nodePath.basename(this.#value, suffix);\n }\n\n /\n Returns the parent directory of this path.\n \n @returns A new `Path`; this instance is unchanged.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.dirname}\n /\n dirname() {\n return this.#newInstance(nodePath.dirname(this.#value));\n }\n\n /\n Returns the extension of the final path component.\n \n @returns The extension including its leading dot, or an empty string when absent.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.extname}\n /\n extname() {\n return nodePath.extname(this.#value);\n }\n\n /\n Checks whether this path is absolute on the current platform.\n \n @returns Whether this path is absolute.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.isAbsolute}\n /\n isAbsolute() {\n return nodePath.isAbsolute(this.#value);\n }\n\n /\n Normalizes separators and relative segments in this path.\n \n @returns A new `Path`; this instance is unchanged.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.normalize}\n /\n normalize() {\n return this.#newInstance(nodePath.normalize(this.#value));\n }\n\n /\n Joins additional segments onto this path.\n \n @param paths - The stringified path segments to append.\n \n @returns A new normalized `Path`; this instance is unchanged.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.join}\n /\n join(...paths: PathLike[]) {\n return this.#newInstance(this.#value, ...this.#toStrings(paths));\n }\n\n /\n Parses this path into its root, directory, basename, extension, and name.\n \n @returns A new object containing the path components.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.parse}\n /\n parse() {\n return nodePath.parse(this.#value);\n }\n\n /\n Computes a relative path from this path to the destination.\n \n @param to - The destination path.\n \n @returns A new `Path`; this instance is unchanged.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.relative}\n /\n relative(to: PathLike) {\n return this.#newInstance(nodePath.relative(this.#value, to.toString()));\n }\n\n /\n Resolves this path to an absolute path using the current working directory.\n \n @remarks\n * Relative paths use the current working directory. This instance is unchanged.\n \n @returns A new absolute `Path`.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.resolve}\n /\n resolve() {\n return this.#newInstance(nodePath.resolve(this.#value));\n }\n\n toJSON() {\n return this.#value;\n }\n\n /\n Converts this path to the Windows namespace form when applicable.\n \n @returns The namespace-converted path string; this instance is unchanged.\n * On non-Windows platforms, the path text is unchanged.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.toNamespacedPath}\n /\n toNamespacedPath() {\n return nodePath.toNamespacedPath(this.#value);\n }\n\n /\n Returns the stored path as a string.\n /\n toString() {\n return this.#value;\n }\n\n /\n Checks access permissions for the stored path.\n \n @remarks\n * The promise resolves when the access check succeeds and rejects if access is denied or the path is missing.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.access}\n /\n access(...args: DropFirstParameters<typeof fsp.access>) {\n return fsp.access(this.#value, ...args);\n }\n\n /\n Appends data to the file at the stored path.\n \n @remarks\n * The promise resolves when appending completes; a missing file is created according to the supplied options.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.appendFile}\n /\n appendFile(...args: DropFirstParameters<typeof fsp.appendFile>) {\n return fsp.appendFile(this.#value, ...args);\n }\n\n /\n Changes the permissions of the stored path.\n \n @remarks\n * The promise resolves when the permissions are changed.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.chmod}\n /\n chmod(...args: DropFirstParameters<typeof fsp.chmod>) {\n return fsp.chmod(this.#value, ...args);\n }\n\n /\n Changes the owner and group of the stored path.\n \n @remarks\n * The promise resolves when the ownership is changed.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.chown}\n /\n chown(...args: DropFirstParameters<typeof fsp.chown>) {\n return fsp.chown(this.#value, ...args);\n }\n\n /\n Copies the file at the stored path to a destination.\n \n @remarks\n * The promise resolves when copying completes. The stored path remains the source path.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.copyFile}\n /\n copyFile(...args: DropFirstParameters<typeof fsp.copyFile>) {\n return fsp.copyFile(this.#value, ...args);\n }\n\n /\n Creates a directory at the stored path.\n \n @remarks\n * The promise resolves after creation. Recursive mode resolves to the first created directory path, or\n * `undefined` if no directory is created; nonrecursive mode resolves without a value.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.mkdir}\n /\n mkdir(options: fs.MakeDirectoryOptions & { recursive: true }): Promise<string \| undefined>;\n mkdir(\n options?:\n \| (fs.MakeDirectoryOptions & { recursive?: false })\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 Opens the file at the stored path.\n \n @remarks\n * The promise resolves to a new file handle. The caller must close the handle when it is no longer needed.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.open}\n /\n open(...args: DropFirstParameters<typeof fsp.open>) {\n return fsp.open(this.#value, ...args);\n }\n\n /\n Reads the entries of the directory at the stored path.\n \n @remarks\n * The promise resolves to names, buffers, or directory entries according to the options.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.readdir}\n /\n readdir(\n options?:\n \| BufferEncoding\n \| (fs.ObjectEncodingOptions & {\n recursive?: boolean;\n withFileTypes?: false;\n })\n \| null,\n ): Promise<string[]>;\n readdir(\n options:\n \| 'buffer'\n \| {\n encoding: 'buffer';\n recursive?: boolean;\n withFileTypes?: false;\n },\n ): Promise<Buffer[]>;\n readdir(\n options?:\n \| BufferEncoding\n \| (fs.ObjectEncodingOptions & {\n recursive?: boolean;\n withFileTypes?: false;\n })\n \| null,\n ): Promise<Buffer[] \| string[]>;\n readdir(\n options: fs.ObjectEncodingOptions & {\n recursive?: boolean;\n withFileTypes: true;\n },\n ): Promise<fs.Dirent[]>;\n readdir(\n options: {\n encoding: 'buffer';\n recursive?: boolean;\n withFileTypes: true;\n },\n ): Promise<Array<fs.Dirent<Buffer>>>;\n readdir(...args: any): any {\n return fsp.readdir(this.#value, ...args);\n }\n\n /\n Reads the entire file at the stored path.\n \n @remarks\n * The promise resolves to a string when a text encoding is supplied, or a `Buffer` otherwise.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.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 Renames or moves the file or directory at the stored path.\n \n @remarks\n * The promise resolves when the rename completes. This instance retains its original stored path.\n \n @param newPath - The destination path; this instance retains its original value.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.rename}\n /\n rename(newPath: PathLike) {\n return fsp.rename(this.#value, newPath.toString());\n }\n\n /\n Removes the file or directory at the stored path.\n \n @remarks\n * The promise resolves after removal according to the supplied options.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.rm}\n /\n rm(...args: DropFirstParameters<typeof fsp.rm>) {\n return fsp.rm(this.#value, ...args);\n }\n\n /\n Removes the directory at the stored path.\n \n @remarks\n * The promise resolves after directory removal.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.rmdir}\n /\n rmdir(...args: DropFirstParameters<typeof fsp.rmdir>) {\n return fsp.rmdir(this.#value, ...args);\n }\n\n /\n Reads file system metadata for the stored path.\n \n @remarks\n * The promise resolves to `Stats`, or `BigIntStats` when `bigint` is enabled.\n * If `throwIfNoEntry` is `false`, a missing path resolves to `undefined` instead of rejecting.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.stat}\n /\n stat(\n opts?: fs.StatOptions & {\n bigint?: false;\n throwIfNoEntry?: true;\n },\n ): Promise<fs.Stats>;\n stat(\n opts: fs.StatOptions & {\n bigint: true;\n throwIfNoEntry?: true;\n },\n ): Promise<fs.BigIntStats>;\n stat(\n opts: fs.StatOptions & {\n bigint?: false;\n throwIfNoEntry: false;\n },\n ): Promise<fs.Stats \| undefined>;\n stat(\n opts: fs.StatOptions & {\n bigint: true;\n throwIfNoEntry: false;\n },\n ): Promise<fs.BigIntStats \| undefined>;\n stat(opts: fs.StatOptions & { throwIfNoEntry?: true }): Promise<fs.BigIntStats \| fs.Stats>;\n stat(opts?: fs.StatOptions): Promise<fs.BigIntStats \| fs.Stats \| undefined>;\n async stat(opts?: fs.StatOptions): Promise<fs.BigIntStats \| fs.Stats \| undefined> {\n try {\n return await fsp.stat(this.#value, opts);\n } catch (error) {\n if (\n opts?.throwIfNoEntry === false\n && error instanceof Error\n && 'code' in error\n && error.code === 'ENOENT'\n ) return undefined;\n\n throw error;\n }\n }\n\n /\n Truncates or extends the file at the stored path.\n \n @remarks\n * The promise resolves when the file reaches the requested length in bytes; the default length is `0`.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.truncate}\n /\n truncate(...args: DropFirstParameters<typeof fsp.truncate>) {\n return fsp.truncate(this.#value, ...args);\n }\n\n /\n Deletes the file or symbolic link at the stored path.\n \n @remarks\n * The promise resolves after deletion; directories are not removed.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.unlink}\n /\n unlink() {\n return fsp.unlink(this.#value);\n }\n\n /\n Writes data to the file at the stored path.\n \n @remarks\n * The promise resolves when writing completes; the default flag replaces existing file contents.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.writeFile}\n */\n writeFile(...args: DropFirstParameters<typeof fsp.writeFile>) {\n return fsp.writeFile(this.#value, ...args);\n }\n}\n"],"mappings":";;;;;;;;;;;;AAsBA,IAAa,OAAb,MAAa,KAAK;CAEd;;;;;;CASA,YAAY,GAAG,OAAmB;EAC9B,KAAK,SAAS,SAAS,KAAK,GAAG,KAAK,WAAW,KAAK,CAAC;CACzD;CAGA,aAAa,GAAG,OAAmB;EAC/B,OAAO,IAAI,KAAK,GAAG,KAAK;CAC5B;CAEA,WAAW,OAAmB;EAC1B,OAAO,MAAM,KAAK,SAAS,KAAK,SAAS,CAAC;CAC9C;;;;;;CASA,IAAI,SAAS;EACT,OAAO,KAAK,QAAQ;CACxB;;;;CAKA,IAAI,QAAQ;EACR,OAAO,KAAK;CAChB;;;;;;;;;;CAaA,OAAO,OAAO,YAA4C;EACtD,OAAO,IAAI,KAAK,SAAS,OAAO,UAAU,CAAC;CAC/C;;;;;;;;;;;;;;CAeA,OAAO,QAAQ,GAAG,OAAmB;EACjC,OAAO,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,QAAQ;CACtC;CAGA,CAAC,OAAO,IAAI,4BAA4B,KAAK;EACzC,OAAO,KAAK;CAChB;CAEA,CAAC,OAAO,aAAa,MAAc;EAC/B,IAAI,SAAS,UAAU,MAAM,IAAI,UAAU,mCAAmC;EAC9E,OAAO,KAAK;CAChB;;;;;;;;CASA,SAAS,QAAiB;EACtB,OAAO,SAAS,SAAS,KAAK,QAAQ,MAAM;CAChD;;;;;;;;CASA,UAAU;EACN,OAAO,KAAK,aAAa,SAAS,QAAQ,KAAK,MAAM,CAAC;CAC1D;;;;;;;;CASA,UAAU;EACN,OAAO,SAAS,QAAQ,KAAK,MAAM;CACvC;;;;;;;;CASA,aAAa;EACT,OAAO,SAAS,WAAW,KAAK,MAAM;CAC1C;;;;;;;;CASA,YAAY;EACR,OAAO,KAAK,aAAa,SAAS,UAAU,KAAK,MAAM,CAAC;CAC5D;;;;;;;;;;CAWA,KAAK,GAAG,OAAmB;EACvB,OAAO,KAAK,aAAa,KAAK,QAAQ,GAAG,KAAK,WAAW,KAAK,CAAC;CACnE;;;;;;;;CASA,QAAQ;EACJ,OAAO,SAAS,MAAM,KAAK,MAAM;CACrC;;;;;;;;;;CAWA,SAAS,IAAc;EACnB,OAAO,KAAK,aAAa,SAAS,SAAS,KAAK,QAAQ,GAAG,SAAS,CAAC,CAAC;CAC1E;;;;;;;;;;;CAYA,UAAU;EACN,OAAO,KAAK,aAAa,SAAS,QAAQ,KAAK,MAAM,CAAC;CAC1D;CAEA,SAAS;EACL,OAAO,KAAK;CAChB;;;;;;;;;CAUA,mBAAmB;EACf,OAAO,SAAS,iBAAiB,KAAK,MAAM;CAChD;;;;CAKA,WAAW;EACP,OAAO,KAAK;CAChB;;;;;;;;;CAUA,OAAO,GAAG,MAA8C;EACpD,OAAO,IAAI,OAAO,KAAK,QAAQ,GAAG,IAAI;CAC1C;;;;;;;;;CAUA,WAAW,GAAG,MAAkD;EAC5D,OAAO,IAAI,WAAW,KAAK,QAAQ,GAAG,IAAI;CAC9C;;;;;;;;;CAUA,MAAM,GAAG,MAA6C;EAClD,OAAO,IAAI,MAAM,KAAK,QAAQ,GAAG,IAAI;CACzC;;;;;;;;;CAUA,MAAM,GAAG,MAA6C;EAClD,OAAO,IAAI,MAAM,KAAK,QAAQ,GAAG,IAAI;CACzC;;;;;;;;;CAUA,SAAS,GAAG,MAAgD;EACxD,OAAO,IAAI,SAAS,KAAK,QAAQ,GAAG,IAAI;CAC5C;CAmBA,MAAM,GAAG,MAAgB;EACrB,OAAO,IAAI,MAAM,KAAK,QAAQ,GAAG,IAAI;CACzC;;;;;;;;;CAUA,KAAK,GAAG,MAA4C;EAChD,OAAO,IAAI,KAAK,KAAK,QAAQ,GAAG,IAAI;CACxC;CAkDA,QAAQ,GAAG,MAAgB;EACvB,OAAO,IAAI,QAAQ,KAAK,QAAQ,GAAG,IAAI;CAC3C;CAoCA,SAAS,GAAG,MAAgB;EACxB,OAAO,IAAI,SAAS,KAAK,QAAQ,GAAG,IAAI;CAC5C;;;;;;;;;;;CAYA,OAAO,SAAmB;EACtB,OAAO,IAAI,OAAO,KAAK,QAAQ,QAAQ,SAAS,CAAC;CACrD;;;;;;;;;CAUA,GAAG,GAAG,MAA0C;EAC5C,OAAO,IAAI,GAAG,KAAK,QAAQ,GAAG,IAAI;CACtC;;;;;;;;;CAUA,MAAM,GAAG,MAA6C;EAClD,OAAO,IAAI,MAAM,KAAK,QAAQ,GAAG,IAAI;CACzC;CAqCA,MAAM,KAAK,MAAuE;EAC9E,IAAI;GACA,OAAO,MAAM,IAAI,KAAK,KAAK,QAAQ,IAAI;EAC3C,SAAS,OAAO;GACZ,IACI,MAAM,mBAAmB,SACtB,iBAAiB,SACjB,UAAU,SACV,MAAM,SAAS,UACpB,OAAO,KAAA;GAET,MAAM;EACV;CACJ;;;;;;;;;CAUA,SAAS,GAAG,MAAgD;EACxD,OAAO,IAAI,SAAS,KAAK,QAAQ,GAAG,IAAI;CAC5C;;;;;;;;;CAUA,SAAS;EACL,OAAO,IAAI,OAAO,KAAK,MAAM;CACjC;;;;;;;;;CAUA,UAAU,GAAG,MAAiD;EAC1D,OAAO,IAAI,UAAU,KAAK,QAAQ,GAAG,IAAI;CAC7C;AACJ"}
1	+ {"version":3,"file":"path.js","names":[],"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 * 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 An immutable file system path with Node.js path and file operations.\n \n @remarks\n * Path-composition methods return new instances and leave this instance unchanged.\n * File operations act on the stored path and forward Node.js defaults and promise rejections.\n * They do not update the stored path, including after a successful rename.\n * The constructor joins stringified inputs using the platform-specific Node.js path rules.\n /\nexport class Path {\n // Private instance properties\n readonly #value: string;\n\n // Constructor\n\n /\n Creates a normalized path value by joining the provided path segments.\n \n @param paths - Path segments accepted by Node.js `path.join` or another `Path` instance.\n /\n constructor(...paths: PathLike[]) {\n this.#value = nodePath.join(...this.#toStrings(paths));\n }\n\n // Private instance 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 instance accessors\n\n /\n The parent directory as a new `Path`; this instance is unchanged.\n \n @see {@link Path.dirname}\n /\n get parent() {\n return this.dirname();\n }\n\n /\n The normalized path string stored by this instance.\n /\n get value() {\n return this.#value;\n }\n\n // Public static methods\n\n /\n Creates a new path from a Node.js path object.\n \n @param pathObject - The path components to format.\n \n @returns A new normalized `Path`.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.format}\n /\n static format(pathObject: nodePath.FormatInputPathObject) {\n return new Path(nodePath.format(pathObject));\n }\n\n /\n Resolves joined path segments to an absolute path.\n \n @remarks\n * Inputs are joined before resolution; unlike Node.js `path.resolve`,\n * later absolute segments do not reset the path.\n \n @param paths - The stringified path segments to join.\n \n @returns A new absolute `Path`.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.resolve}\n /\n static resolve(...paths: PathLike[]) {\n return new this(...paths).resolve();\n }\n\n // Public instance methods\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 /\n Returns the final component of this path.\n \n @param suffix - An optional exact suffix to remove.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.basename}\n /\n basename(suffix?: string) {\n return nodePath.basename(this.#value, suffix);\n }\n\n /\n Returns the parent directory of this path.\n \n @returns A new `Path`; this instance is unchanged.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.dirname}\n /\n dirname() {\n return this.#newInstance(nodePath.dirname(this.#value));\n }\n\n /\n Returns the extension of the final path component.\n \n @returns The extension including its leading dot, or an empty string when absent.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.extname}\n /\n extname() {\n return nodePath.extname(this.#value);\n }\n\n /\n Checks whether this path is absolute on the current platform.\n \n @returns Whether this path is absolute.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.isAbsolute}\n /\n isAbsolute() {\n return nodePath.isAbsolute(this.#value);\n }\n\n /\n Normalizes separators and relative segments in this path.\n \n @returns A new `Path`; this instance is unchanged.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.normalize}\n /\n normalize() {\n return this.#newInstance(nodePath.normalize(this.#value));\n }\n\n /\n Joins additional segments onto this path.\n \n @param paths - The stringified path segments to append.\n \n @returns A new normalized `Path`; this instance is unchanged.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.join}\n /\n join(...paths: PathLike[]) {\n return this.#newInstance(this.#value, ...this.#toStrings(paths));\n }\n\n /\n Parses this path into its root, directory, basename, extension, and name.\n \n @returns A new object containing the path components.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.parse}\n /\n parse() {\n return nodePath.parse(this.#value);\n }\n\n /\n Computes a relative path from this path to the destination.\n \n @param to - The destination path.\n \n @returns A new `Path`; this instance is unchanged.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.relative}\n /\n relative(to: PathLike) {\n return this.#newInstance(nodePath.relative(this.#value, to.toString()));\n }\n\n /\n Resolves this path to an absolute path using the current working directory.\n \n @remarks\n * Relative paths use the current working directory. This instance is unchanged.\n \n @returns A new absolute `Path`.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.resolve}\n /\n resolve() {\n return this.#newInstance(nodePath.resolve(this.#value));\n }\n\n toJSON() {\n return this.#value;\n }\n\n /\n Converts this path to the Windows namespace form when applicable.\n \n @returns The namespace-converted path string; this instance is unchanged.\n * On non-Windows platforms, the path text is unchanged.\n \n @see {@link https://nodejs.org/api/path.html \| Node.js path.toNamespacedPath}\n /\n toNamespacedPath() {\n return nodePath.toNamespacedPath(this.#value);\n }\n\n /\n Returns the stored path as a string.\n /\n toString() {\n return this.#value;\n }\n\n /\n Checks access permissions for the stored path.\n \n @remarks\n * The promise resolves when the access check succeeds and rejects if access is denied or the path is missing.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.access}\n /\n async access(...args: DropFirstParameters<typeof fsp.access>) {\n return await fsp.access(this.#value, ...args);\n }\n\n /\n Appends data to the file at the stored path.\n \n @remarks\n * The promise resolves when appending completes; a missing file is created according to the supplied options.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.appendFile}\n /\n async appendFile(...args: DropFirstParameters<typeof fsp.appendFile>) {\n return await fsp.appendFile(this.#value, ...args);\n }\n\n /\n Changes the permissions of the stored path.\n \n @remarks\n * The promise resolves when the permissions are changed.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.chmod}\n /\n async chmod(...args: DropFirstParameters<typeof fsp.chmod>) {\n return await fsp.chmod(this.#value, ...args);\n }\n\n /\n Changes the owner and group of the stored path.\n \n @remarks\n * The promise resolves when the ownership is changed.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.chown}\n /\n async chown(...args: DropFirstParameters<typeof fsp.chown>) {\n return await fsp.chown(this.#value, ...args);\n }\n\n /\n Copies the file at the stored path to a destination.\n \n @remarks\n * The promise resolves when copying completes. The stored path remains the source path.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.copyFile}\n /\n async copyFile(...args: DropFirstParameters<typeof fsp.copyFile>) {\n return await fsp.copyFile(this.#value, ...args);\n }\n\n /\n Creates a directory at the stored path.\n \n @remarks\n * The promise resolves after creation. Recursive mode resolves to the first created directory path, or\n * `undefined` if no directory is created; nonrecursive mode resolves without a value.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.mkdir}\n /\n mkdir(options: fs.MakeDirectoryOptions & { recursive: true }): Promise<string \| undefined>;\n mkdir(\n options?:\n \| (fs.MakeDirectoryOptions & { recursive?: false })\n \| fs.Mode\n \| null,\n ): Promise<void>;\n mkdir(options?: fs.MakeDirectoryOptions \| fs.Mode \| null): Promise<string \| undefined>;\n async mkdir(...args: any): Promise<any> {\n return await fsp.mkdir(this.#value, ...args);\n }\n\n /\n Opens the file at the stored path.\n \n @remarks\n * The promise resolves to a new file handle. The caller must close the handle when it is no longer needed.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.open}\n /\n async open(...args: DropFirstParameters<typeof fsp.open>) {\n return await fsp.open(this.#value, ...args);\n }\n\n /\n Reads the entries of the directory at the stored path.\n \n @remarks\n * The promise resolves to names, buffers, or directory entries according to the options.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.readdir}\n /\n readdir(\n options?:\n \| BufferEncoding\n \| (fs.ObjectEncodingOptions & {\n recursive?: boolean;\n withFileTypes?: false;\n })\n \| null,\n ): Promise<string[]>;\n readdir(\n options:\n \| 'buffer'\n \| {\n encoding: 'buffer';\n recursive?: boolean;\n withFileTypes?: false;\n },\n ): Promise<Buffer[]>;\n readdir(\n options?:\n \| BufferEncoding\n \| (fs.ObjectEncodingOptions & {\n recursive?: boolean;\n withFileTypes?: false;\n })\n \| null,\n ): Promise<Buffer[] \| string[]>;\n readdir(\n options: fs.ObjectEncodingOptions & {\n recursive?: boolean;\n withFileTypes: true;\n },\n ): Promise<fs.Dirent[]>;\n readdir(\n options: {\n encoding: 'buffer';\n recursive?: boolean;\n withFileTypes: true;\n },\n ): Promise<Array<fs.Dirent<Buffer>>>;\n async readdir(...args: any): Promise<any> {\n return await fsp.readdir(this.#value, ...args);\n }\n\n /\n Reads the entire file at the stored path.\n \n @remarks\n * The promise resolves to a string when a text encoding is supplied, or a `Buffer` otherwise.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.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 async readFile(...args: any): Promise<any> {\n return await fsp.readFile(this.#value, ...args);\n }\n\n /\n Renames or moves the file or directory at the stored path.\n \n @remarks\n * The promise resolves when the rename completes. This instance retains its original stored path.\n \n @param newPath - The destination path; this instance retains its original value.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.rename}\n /\n async rename(newPath: PathLike) {\n return await fsp.rename(this.#value, newPath.toString());\n }\n\n /\n Removes the file or directory at the stored path.\n \n @remarks\n * The promise resolves after removal according to the supplied options.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.rm}\n /\n async rm(...args: DropFirstParameters<typeof fsp.rm>) {\n return await fsp.rm(this.#value, ...args);\n }\n\n /\n Removes the directory at the stored path.\n \n @remarks\n * The promise resolves after directory removal.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.rmdir}\n /\n async rmdir(...args: DropFirstParameters<typeof fsp.rmdir>) {\n return await fsp.rmdir(this.#value, ...args);\n }\n\n /\n Reads file system metadata for the stored path.\n \n @remarks\n * The promise resolves to `Stats`, or `BigIntStats` when `bigint` is enabled.\n * If `throwIfNoEntry` is `false`, a missing path resolves to `undefined` instead of rejecting.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.stat}\n /\n stat(\n opts?: fs.StatOptions & {\n bigint?: false;\n throwIfNoEntry?: true;\n },\n ): Promise<fs.Stats>;\n stat(\n opts: fs.StatOptions & {\n bigint: true;\n throwIfNoEntry?: true;\n },\n ): Promise<fs.BigIntStats>;\n stat(\n opts: fs.StatOptions & {\n bigint?: false;\n throwIfNoEntry: false;\n },\n ): Promise<fs.Stats \| undefined>;\n stat(\n opts: fs.StatOptions & {\n bigint: true;\n throwIfNoEntry: false;\n },\n ): Promise<fs.BigIntStats \| undefined>;\n stat(opts: fs.StatOptions & { throwIfNoEntry?: true }): Promise<fs.BigIntStats \| fs.Stats>;\n stat(opts?: fs.StatOptions): Promise<fs.BigIntStats \| fs.Stats \| undefined>;\n async stat(opts?: fs.StatOptions): Promise<fs.BigIntStats \| fs.Stats \| undefined> {\n try {\n return await fsp.stat(this.#value, opts);\n } catch (error) {\n if (\n opts?.throwIfNoEntry === false\n && error instanceof Error\n && 'code' in error\n && error.code === 'ENOENT'\n ) return undefined;\n\n throw error;\n }\n }\n\n /\n Truncates or extends the file at the stored path.\n \n @remarks\n * The promise resolves when the file reaches the requested length in bytes; the default length is `0`.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.truncate}\n /\n async truncate(...args: DropFirstParameters<typeof fsp.truncate>) {\n return await fsp.truncate(this.#value, ...args);\n }\n\n /\n Deletes the file or symbolic link at the stored path.\n \n @remarks\n * The promise resolves after deletion; directories are not removed.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.unlink}\n /\n async unlink() {\n return await fsp.unlink(this.#value);\n }\n\n /\n Writes data to the file at the stored path.\n \n @remarks\n * The promise resolves when writing completes; the default flag replaces existing file contents.\n \n @see {@link https://nodejs.org/api/fs.html \| Node.js fsPromises.writeFile}\n */\n async writeFile(...args: DropFirstParameters<typeof fsp.writeFile>) {\n return await fsp.writeFile(this.#value, ...args);\n }\n}\n"],"mappings":"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"}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"precision-number.js","names":[],"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 A fixed-decimal number with mutable and immutable arithmetic operations.\n \n @remarks\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, leaving this instance unchanged.\n * Decimal.js exceptions propagate unchanged; non-finite arithmetic results are not converted into exceptions.\n \n @example\n \n ```ts\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 instance properties\n readonly #decimalPlaces: number;\n readonly #rounding: Decimal.Rounding;\n #decimal: Decimal;\n\n // Constructor\n\n /\n Creates a fixed-decimal number.\n \n @param value - Initial value (default: `'0'`).\n * @param decimalPlaces - Decimal places retained after operations (default: `2`).\n * @param 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 // Private instance 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 instance accessors\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 // Public static methods\n\n /\n Formats a value with decimal.js without creating a reusable instance.\n \n @param value - Value to format.\n * @param decimalPlaces - Decimal places to output (default: `2`).\n * @param rounding - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`).\n \n @returns 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 instance methods\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 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 /\n Replaces the current value with its absolute value.\n \n @returns This 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 @remarks\n * The stored value still uses this instance's configured decimal places for output.\n \n @returns This 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 min - Lower bound.\n * @param max - Upper bound.\n \n @returns This 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 value - Divisor.\n \n @returns This 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 value - Value to compare.\n \n @returns Whether 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 @remarks\n * The stored value still uses this instance's configured decimal places for output.\n \n @returns This 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 value - Divisor used to compute the remainder.\n \n @returns This 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 value - Exponent.\n \n @returns This 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 min - Lower bound.\n * @param 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 @remarks\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":";;;;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,kBAAb,MAAa,gBAAgB;CAEzB;CACA;CACA;;;;;;;;CAWA,YACI,QAA8B,KAC9B,gBAAwB,GACxB,WAA6B,QAAQ,YACvC;EACE,KAAK,iBAAiB;EACtB,KAAK,YAAY;EACjB,KAAK,WAAW,KAAK,uBAAuB,IAAI,QAAQ,MAAM,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;CACpF;CAGA,uBAAuB,SAAkB;EACrC,OAAO,QAAQ,gBAAgB,KAAK,gBAAgB,KAAK,SAAS;CACtE;CAEA,eAAe,OAA6B;EACxC,OAAO,MAAM,SAAS,CAAC,CAAC,KAAK;CACjC;;;;CAOA,IAAI,gBAAgB;EAChB,OAAO,KAAK;CAChB;;;;CAKA,IAAI,WAAW;EACX,OAAO,KAAK;CAChB;;;;CAKA,IAAI,QAAQ;EACR,OAAO,KAAK,SAAS,QAAQ,KAAK,gBAAgB,KAAK,SAAS;CACpE;;;;;;;;;;CAaA,OAAO,QACH,OACA,gBAAwB,GACxB,WAA6B,QAAQ,YACvC;EACE,OAAO,IAAI,QAAQ,MAAM,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,eAAe,QAAQ;CAC/E;;;;CAOA,CAAC,OAAO,IAAI,4BAA4B,KAAK;EACzC,OAAO,KAAK;CAChB;;;;;;CAOA,CAAC,OAAO,aAAa,MAAc;EAC/B,IAAI,SAAS,UAAU,OAAO,KAAK,SAAS,SAAS;EACrD,OAAO,KAAK;CAChB;;;;;;CAOA,gBAAgB;EACZ,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,cAAc,CAAC;EACzE,OAAO;CACX;;;;;;;;;CAUA,OAAO;EACH,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,KAAK,CAAC;EAChE,OAAO;CACX;;;;;;;;;;;CAYA,MAAM,KAA2B,KAA2B;EACxD,MAAM,aAAa,IAAI,QAAQ,KAAK,eAAe,GAAG,CAAC;EACvD,MAAM,aAAa,IAAI,QAAQ,KAAK,eAAe,GAAG,CAAC;EACvD,IAAI,WAAW,GAAG,UAAU,GAAG,MAAM,IAAI,MAAM,qDAAqD;EACpG,KAAK,WAAW,KAAK,uBAAuB,QAAQ,IAAI,QAAQ,IAAI,KAAK,UAAU,UAAU,GAAG,UAAU,CAAC;EAC3G,OAAO;CACX;;;;CAKA,QAAQ;EACJ,OAAO,IAAI,gBAAgB,KAAK,UAAU,KAAK,gBAAgB,KAAK,SAAS;CACjF;;;;;;;;CASA,UAAU,OAA6B;EACnC,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,UAAU,KAAK,eAAe,KAAK,CAAC,CAAC;EAC/F,OAAO;CACX;;;;;;;;CASA,OAAO,OAA6B;EAChC,OAAO,KAAK,SAAS,OAAO,KAAK,eAAe,KAAK,CAAC;CAC1D;;;;;;;;;CAUA,QAAQ;EACJ,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,MAAM,CAAC;EACjE,OAAO;CACX;;;;CAKA,GAAG,OAA6B;EAC5B,OAAO,KAAK,SAAS,GAAG,KAAK,eAAe,KAAK,CAAC;CACtD;;;;CAKA,IAAI,OAA6B;EAC7B,OAAO,KAAK,SAAS,IAAI,KAAK,eAAe,KAAK,CAAC;CACvD;;;;CAKA,WAAW;EACP,OAAO,KAAK,SAAS,SAAS;CAClC;;;;CAKA,YAAY;EACR,OAAO,KAAK,SAAS,UAAU;CACnC;;;;CAKA,QAAQ;EACJ,OAAO,KAAK,SAAS,MAAM;CAC/B;;;;CAKA,aAAa;EACT,OAAO,KAAK,SAAS,WAAW;CACpC;;;;CAKA,aAAa;EACT,OAAO,KAAK,SAAS,WAAW;CACpC;;;;CAKA,SAAS;EACL,OAAO,KAAK,SAAS,OAAO;CAChC;;;;CAKA,GAAG,OAA6B;EAC5B,OAAO,KAAK,SAAS,GAAG,KAAK,eAAe,KAAK,CAAC;CACtD;;;;CAKA,IAAI,OAA6B;EAC7B,OAAO,KAAK,SAAS,IAAI,KAAK,eAAe,KAAK,CAAC;CACvD;;;;CAKA,MAAM,OAA6B;EAC/B,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,MAAM,KAAK,eAAe,KAAK,CAAC,CAAC;EAC3F,OAAO;CACX;;;;;;;;CASA,OAAO,OAA6B;EAChC,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,OAAO,KAAK,eAAe,KAAK,CAAC,CAAC;EAC5F,OAAO;CACX;;;;CAKA,SAAS;EACL,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,QAAQ,CAAC;EACnE,OAAO;CACX;;;;CAKA,KAAK,OAA6B;EAC9B,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,KAAK,KAAK,eAAe,KAAK,CAAC,CAAC;EAC1F,OAAO;CACX;;;;;;;;CASA,IAAI,OAA6B;EAC7B,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,IAAI,KAAK,eAAe,KAAK,CAAC,CAAC;EACzF,OAAO;CACX;;;;CAKA,MAAM,OAA6B;EAC/B,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,MAAM,KAAK,eAAe,KAAK,CAAC,CAAC;EAC3F,OAAO;CACX;;;;CAKA,kBAAkB;EACd,OAAO,IAAI,gBAAgB,KAAK,SAAS,cAAc,GAAG,KAAK,gBAAgB,KAAK,SAAS;CACjG;;;;CAKA,SAAS;EACL,OAAO,IAAI,gBAAgB,KAAK,SAAS,KAAK,GAAG,KAAK,gBAAgB,KAAK,SAAS;CACxF;;;;;;;;;CAUA,UAAU,KAA2B,KAA2B;EAC5D,OAAO,KAAK,MAAM,CAAC,CAAC,MAAM,KAAK,GAAG;CACtC;;;;CAKA,YAAY,OAA6B;EACrC,OAAO,IAAI,gBACP,KAAK,SAAS,UAAU,KAAK,eAAe,KAAK,CAAC,GAClD,KAAK,gBACL,KAAK,SACT;CACJ;;;;CAKA,UAAU;EACN,OAAO,IAAI,gBAAgB,KAAK,SAAS,MAAM,GAAG,KAAK,gBAAgB,KAAK,SAAS;CACzF;;;;CAKA,SAAS;EACL,OAAO,KAAK;CAChB;;;;CAKA,QAAQ,OAA6B;EACjC,OAAO,IAAI,gBACP,KAAK,SAAS,MAAM,KAAK,eAAe,KAAK,CAAC,GAC9C,KAAK,gBACL,KAAK,SACT;CACJ;;;;CAKA,SAAS,OAA6B;EAClC,OAAO,IAAI,gBACP,KAAK,SAAS,OAAO,KAAK,eAAe,KAAK,CAAC,GAC/C,KAAK,gBACL,KAAK,SACT;CACJ;;;;CAKA,YAAY;EACR,OAAO,IAAI,gBAAgB,KAAK,SAAS,QAAQ,GAAG,KAAK,gBAAgB,KAAK,SAAS;CAC3F;;;;CAKA,OAAO,OAA6B;EAChC,OAAO,IAAI,gBAAgB,KAAK,SAAS,KAAK,KAAK,eAAe,KAAK,CAAC,GAAG,KAAK,gBAAgB,KAAK,SAAS;CAClH;;;;CAKA,MAAM,OAA6B;EAC/B,OAAO,IAAI,gBAAgB,KAAK,SAAS,IAAI,KAAK,eAAe,KAAK,CAAC,GAAG,KAAK,gBAAgB,KAAK,SAAS;CACjH;;;;;;;CAQA,WAAW;EACP,OAAO,KAAK,SAAS,SAAS;CAClC;;;;CAKA,WAAW;EACP,OAAO,KAAK;CAChB;;;;CAKA,QAAQ,gBAAwB,KAAK,gBAAgB,WAA6B,KAAK,WAAW;EAC9F,OAAO,KAAK,SAAS,QAAQ,eAAe,QAAQ;CACxD;;;;CAKA,QAAQ,OAA6B;EACjC,OAAO,IAAI,gBACP,KAAK,SAAS,MAAM,KAAK,eAAe,KAAK,CAAC,GAC9C,KAAK,gBACL,KAAK,SACT;CACJ;AACJ"}
1	+ {"version":3,"file":"precision-number.js","names":[],"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 A fixed-decimal number with mutable and immutable arithmetic operations.\n \n @remarks\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, leaving this instance unchanged.\n * Decimal.js exceptions propagate unchanged; non-finite arithmetic results are not converted into exceptions.\n \n @example\n \n ```ts\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 instance properties\n readonly #decimalPlaces: number;\n readonly #rounding: Decimal.Rounding;\n #decimal: Decimal;\n\n // Constructor\n\n /\n Creates a fixed-decimal number.\n \n @param value - Initial value (default: `'0'`).\n * @param decimalPlaces - Decimal places retained after operations (default: `2`).\n * @param 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 // Private instance 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 instance accessors\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 // Public static methods\n\n /\n Formats a value with decimal.js without creating a reusable instance.\n \n @param value - Value to format.\n * @param decimalPlaces - Decimal places to output (default: `2`).\n * @param rounding - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`).\n \n @returns 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 instance methods\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 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 /\n Replaces the current value with its absolute value.\n \n @returns This 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 @remarks\n * The stored value still uses this instance's configured decimal places for output.\n \n @returns This 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 min - Lower bound.\n * @param max - Upper bound.\n \n @returns This 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 value - Divisor.\n \n @returns This 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 value - Value to compare.\n \n @returns Whether 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 @remarks\n * The stored value still uses this instance's configured decimal places for output.\n \n @returns This 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 value - Divisor used to compute the remainder.\n \n @returns This 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 value - Exponent.\n \n @returns This 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 min - Lower bound.\n * @param 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 @remarks\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/enum.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
+import { ValueOf } from "type-fest";
 /**
  * Extracts only the numeric values from an enumeration-like object.
  *
@@ -22,7 +23,7 @@
  * console.log(getEnumNumberValues(RecordType)); // => [0, 1]
  * ```
  */
-export declare function getEnumNumberValues<T extends Record<string, any>>(enumObject: T): Array<Extract<T[keyof T], number>>;
+export declare function getEnumNumberValues<T extends Record<string, any>>(enumObject: T): Array<Extract<ValueOf<T>, number>>;
 /**
  * Extracts only the string values from an enumeration-like object.
  *
@@ -47,7 +48,7 @@ export declare function getEnumNumberValues<T extends Record<string, any>>(enumO
  * console.log(getEnumStringValues(RecordType)); // => ['unknown']
  * ```
  */
-export declare function getEnumStringValues<T extends Record<string, any>>(enumObject: T): Array<Extract<T[keyof T], string>>;
+export declare function getEnumStringValues<T extends Record<string, any>>(enumObject: T): Array<Extract<ValueOf<T>, string>>;
 /**
  * Extracts all values from an enumeration-like object.
  *
@@ -96,5 +97,5 @@ export declare function getEnumStringValues<T extends Record<string, any>>(enumO
  * console.log(getEnumValues(RecordType)); // => [0, 1, 'unknown']
  * ```
  */
-export declare function getEnumValues<T extends Record<string, any>>(enumObject: T): Array<T[keyof T]>;
+export declare function getEnumValues<T extends Record<string, any>>(enumObject: T): Array<ValueOf<T>>;
 //# sourceMappingURL=enum.d.ts.map

package/dist/enum.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"enum.d.ts","names":[],"sources":["../src/enum.ts"],"mappings":"~~;;;;;;;;;;;;;;;;;;;;;;;;wBAwBgB~~,oBAAoB,UAAU,qBAAqB,YAAY,IAAI,MAAM,QAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;wBA4BzF,oBAAoB,UAAU,qBAAqB,YAAY,IAAI,MAAM,QAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoDzF,cAAc,UAAU,qBAAqB,YAAY,IAAI,MAAM,QAAQ"}
1	+ {"version":3,"file":"enum.d.ts","names":[],"sources":["../src/enum.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;wBA8BgB,oBAAoB,UAAU,qBAAqB,YAAY,IAAI,MAAM,QAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;wBA4BzF,oBAAoB,UAAU,qBAAqB,YAAY,IAAI,MAAM,QAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoDzF,cAAc,UAAU,qBAAqB,YAAY,IAAI,MAAM,QAAQ"}

package/dist/enum.js CHANGED Viewed

@@ -1,3 +1,4 @@
+import { objectKeys, objectValues } from "ts-extras";
 // src/enum.ts
 /**
 * Extracts only the numeric values from an enumeration-like object.
@@ -102,9 +103,9 @@ function getEnumStringValues(enumObject) {
 * ```
 */
 function getEnumValues(enumObject) {
-	const values = Object.values(enumObject);
+	const values = objectValues(enumObject);
 	if (!values.some((value) => typeof value === "number")) return values;
-	return Object.keys(enumObject).filter((key) => Number.isNaN(Number(key))).map((key) => enumObject[key]);
+	return objectKeys(enumObject).filter((key) => Number.isNaN(Number(key))).map((key) => enumObject[key]);
 }
 export { getEnumNumberValues, getEnumStringValues, getEnumValues };

package/dist/enum.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"enum.js","names":[],"sources":["../src/enum.ts"],"sourcesContent":["/*\n Extracts only the numeric values from an enumeration-like object.\n \n @typeParam T - The type of the enum object.\n \n @param enumObject - The enumeration-like object to extract numeric values from,\n * the object can contain numeric values, string values, or both.\n \n @returns An array of numeric values extracted from the enum object.\n \n @example\n \n ```ts\n * import { getEnumNumberValues } from '@kikiutils/shared/enum';\n \n enum RecordType {\n * Receive = 0,\n * Send = 1,\n * Unknown = 'unknown',\n * }\n \n console.log(getEnumNumberValues(RecordType)); // => [0, 1]\n * ```\n /\nexport function getEnumNumberValues<T extends Record<string, any>>(enumObject: T): Array<Extract<T~~[keyof~~ ~~T],~~ number>> {\n return getEnumValues(enumObject).filter((value) => typeof value === 'number');\n}\n\n/\n Extracts only the string values from an enumeration-like object.\n \n @typeParam T - The type of the enum object.\n \n @param enumObject - The enumeration-like object to extract string values from,\n * the object can contain numeric values, string values, or both.\n \n @returns An array of string values extracted from the enum object.\n \n @example\n \n ```ts\n * import { getEnumStringValues } from '@kikiutils/shared/enum';\n \n enum RecordType {\n * Receive = 0,\n * Send = 1,\n * Unknown = 'unknown',\n * }\n \n console.log(getEnumStringValues(RecordType)); // => ['unknown']\n * ```\n /\nexport function getEnumStringValues<T extends Record<string, any>>(enumObject: T): Array<Extract<T~~[keyof~~ ~~T],~~ string>> {\n return getEnumValues(enumObject).filter((value) => typeof value === 'string');\n}\n\n/\n Extracts all values from an enumeration-like object.\n \n @remarks\n * This function handles TypeScript enums correctly by accounting for the reverse mapping\n * that occurs with numeric enums. It works with pure numeric enums, pure string enums,\n * and mixed enums.\n \n @typeParam T - The type of the enum object.\n \n @param enumObject - The enumeration-like object to extract values from,\n * the object can contain numeric values, string values, or both.\n \n @returns An array containing all the values from the enum object.\n \n @example\n \n ```ts\n * import { getEnumValues } from '@kikiutils/shared/enum';\n \n // Numeric enum\n * enum Status {\n * Active = 0,\n * Inactive = 1,\n * Pending = 2,\n * }\n \n console.log(getEnumValues(Status)); // => [0, 1, 2]\n \n // String enum\n * enum Color {\n * Red = 'RED',\n * Green = 'GREEN',\n * Blue = 'BLUE',\n * }\n \n console.log(getEnumValues(Color)); // => ['RED', 'GREEN', 'BLUE']\n \n // Mixed enum\n * enum RecordType {\n * Receive = 0,\n * Send = 1,\n * Unknown = 'unknown',\n * }\n \n console.log(getEnumValues(RecordType)); // => [0, 1, 'unknown']\n * ```\n */\nexport function getEnumValues<T extends Record<string, any>>(enumObject: T): Array<T~~[keyof~~ ~~T]>~~ {\n const values = ~~Object.values~~(enumObject);\n const hasNumberValues = values.some((value) => typeof value === 'number');\n if (!hasNumberValues) return values;\n return ~~Object.keys~~(enumObject).filter((key) => Number.isNaN(Number(key))).map((key) => enumObject[key]);\n}\n"],"mappings":"~~;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA~~,SAAgB,oBAAmD,YAAmD;CAClH,OAAO,cAAc,UAAU,CAAC,CAAC,QAAQ,UAAU,OAAO,UAAU,QAAQ;AAChF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,oBAAmD,YAAmD;CAClH,OAAO,cAAc,UAAU,CAAC,CAAC,QAAQ,UAAU,OAAO,UAAU,QAAQ;AAChF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,SAAgB,cAA6C,YAAkC;CAC3F,MAAM,SAAS,~~OAAO~~,~~OAAO,~~UAAU;~~CAEvC~~,IAAI,CADoB,OAAO,MAAM,UAAU,OAAO,UAAU,QAC7C,GAAG,OAAO;CAC7B,OAAO,~~OAAO~~,~~KAAK,~~UAAU,CAAC,CAAC,QAAQ,QAAQ,OAAO,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,WAAW,IAAI;~~AAC1G~~"}
1	+ {"version":3,"file":"enum.js","names":[],"sources":["../src/enum.ts"],"sourcesContent":["import {\n objectKeys,\n objectValues,\n} from 'ts-extras';\nimport type { ValueOf } from 'type-fest';\n\n/*\n Extracts only the numeric values from an enumeration-like object.\n \n @typeParam T - The type of the enum object.\n \n @param enumObject - The enumeration-like object to extract numeric values from,\n * the object can contain numeric values, string values, or both.\n \n @returns An array of numeric values extracted from the enum object.\n \n @example\n \n ```ts\n * import { getEnumNumberValues } from '@kikiutils/shared/enum';\n \n enum RecordType {\n * Receive = 0,\n * Send = 1,\n * Unknown = 'unknown',\n * }\n \n console.log(getEnumNumberValues(RecordType)); // => [0, 1]\n * ```\n /\nexport function getEnumNumberValues<T extends Record<string, any>>(enumObject: T): Array<Extract<ValueOf<T>, number>> {\n return getEnumValues(enumObject).filter((value) => typeof value === 'number');\n}\n\n/\n Extracts only the string values from an enumeration-like object.\n \n @typeParam T - The type of the enum object.\n \n @param enumObject - The enumeration-like object to extract string values from,\n * the object can contain numeric values, string values, or both.\n \n @returns An array of string values extracted from the enum object.\n \n @example\n \n ```ts\n * import { getEnumStringValues } from '@kikiutils/shared/enum';\n \n enum RecordType {\n * Receive = 0,\n * Send = 1,\n * Unknown = 'unknown',\n * }\n \n console.log(getEnumStringValues(RecordType)); // => ['unknown']\n * ```\n /\nexport function getEnumStringValues<T extends Record<string, any>>(enumObject: T): Array<Extract<ValueOf<T>, string>> {\n return getEnumValues(enumObject).filter((value) => typeof value === 'string');\n}\n\n/\n Extracts all values from an enumeration-like object.\n \n @remarks\n * This function handles TypeScript enums correctly by accounting for the reverse mapping\n * that occurs with numeric enums. It works with pure numeric enums, pure string enums,\n * and mixed enums.\n \n @typeParam T - The type of the enum object.\n \n @param enumObject - The enumeration-like object to extract values from,\n * the object can contain numeric values, string values, or both.\n \n @returns An array containing all the values from the enum object.\n \n @example\n \n ```ts\n * import { getEnumValues } from '@kikiutils/shared/enum';\n \n // Numeric enum\n * enum Status {\n * Active = 0,\n * Inactive = 1,\n * Pending = 2,\n * }\n \n console.log(getEnumValues(Status)); // => [0, 1, 2]\n \n // String enum\n * enum Color {\n * Red = 'RED',\n * Green = 'GREEN',\n * Blue = 'BLUE',\n * }\n \n console.log(getEnumValues(Color)); // => ['RED', 'GREEN', 'BLUE']\n \n // Mixed enum\n * enum RecordType {\n * Receive = 0,\n * Send = 1,\n * Unknown = 'unknown',\n * }\n \n console.log(getEnumValues(RecordType)); // => [0, 1, 'unknown']\n * ```\n */\nexport function getEnumValues<T extends Record<string, any>>(enumObject: T): Array<ValueOf<T>> {\n const values = objectValues(enumObject);\n const hasNumberValues = values.some((value) => typeof value === 'number');\n if (!hasNumberValues) return values;\n return objectKeys(enumObject).filter((key) => Number.isNaN(Number(key))).map((key) => enumObject[key]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,oBAAmD,YAAmD;CAClH,OAAO,cAAc,UAAU,CAAC,CAAC,QAAQ,UAAU,OAAO,UAAU,QAAQ;AAChF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,oBAAmD,YAAmD;CAClH,OAAO,cAAc,UAAU,CAAC,CAAC,QAAQ,UAAU,OAAO,UAAU,QAAQ;AAChF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,SAAgB,cAA6C,YAAkC;CAC3F,MAAM,SAAS,aAAa,UAAU;CAEtC,IAAI,CADoB,OAAO,MAAM,UAAU,OAAO,UAAU,QAC7C,GAAG,OAAO;CAC7B,OAAO,WAAW,UAAU,CAAC,CAAC,QAAQ,QAAQ,OAAO,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,WAAW,IAAI;AACzG"}

package/dist/env.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"env.js","names":[],"sources":["../src/env.ts"],"sourcesContent":["/*\n Custom error class for handling missing environment variables.\n \n @remarks\n * Extends the built-in `Error` class and includes the missing key.\n /\nexport class EnvironmentNotFoundError extends Error {\n readonly key: string;\n\n /\n Creates an error identifying a missing environment variable.\n \n @param key - The missing environment variable key.\n /\n constructor(key: string) {\n super(`Missing environment variable: ${key}`);\n this.key = key;\n this.name = this.constructor.name;\n Error.captureStackTrace?.(this, this.constructor);\n }\n}\n\n/\n Retrieves the value of an environment variable, or throws an error if it is not defined.\n \n @remarks\n * Only checks for `process.env[key] === undefined`. An empty string (for example `''`) or any falsy string\n * value like `'0'` or `'false'` is considered a valid (defined) value.\n \n @param key - The environment variable key to retrieve.\n \n @returns The value of the environment variable.\n \n @throws EnvironmentNotFoundError if the environment variable is not defined.\n \n @example\n \n ```ts\n * import {\n * checkAndGetEnvValue,\n * EnvironmentNotFoundError,\n * } from '@kikiutils/shared/env';\n \n process.env.API_KEY = '';\n * checkAndGetEnvValue('API_KEY'); // => ''\n \n delete process.env.API_KEY;\n * try {\n * checkAndGetEnvValue('API_KEY');\n * } catch (error) {\n * console.log(error instanceof EnvironmentNotFoundError); // => true\n * }\n * ```\n */\nexport function checkAndGetEnvValue(key: string) {\n if (process.env[key] === undefined) throw new EnvironmentNotFoundError(key);\n return process.env[key];\n}\n"],"mappings":";;;;;;;AAMA,IAAa,2BAAb,cAA8C,MAAM;~~CAChD~~;;;;;;~~CAOA~~,YAAY,KAAa;EACrB,MAAM,iCAAiC,KAAK;EAC5C,KAAK,MAAM;EACX,KAAK,OAAO,KAAK,YAAY;EAC7B,MAAM,oBAAoB,MAAM,KAAK,WAAW;CACpD;AACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,oBAAoB,KAAa;CAC7C,IAAI,QAAQ,IAAI,SAAS,KAAA,GAAW,MAAM,IAAI,yBAAyB,GAAG;CAC1E,OAAO,QAAQ,IAAI;AACvB"}
1	+ {"version":3,"file":"env.js","names":[],"sources":["../src/env.ts"],"sourcesContent":["/*\n Custom error class for handling missing environment variables.\n \n @remarks\n * Extends the built-in `Error` class and includes the missing key.\n /\nexport class EnvironmentNotFoundError extends Error {\n readonly key: string;\n\n /\n Creates an error identifying a missing environment variable.\n \n @param key - The missing environment variable key.\n /\n constructor(key: string) {\n super(`Missing environment variable: ${key}`);\n this.key = key;\n this.name = this.constructor.name;\n Error.captureStackTrace?.(this, this.constructor);\n }\n}\n\n/\n Retrieves the value of an environment variable, or throws an error if it is not defined.\n \n @remarks\n * Only checks for `process.env[key] === undefined`. An empty string (for example `''`) or any falsy string\n * value like `'0'` or `'false'` is considered a valid (defined) value.\n \n @param key - The environment variable key to retrieve.\n \n @returns The value of the environment variable.\n \n @throws EnvironmentNotFoundError if the environment variable is not defined.\n \n @example\n \n ```ts\n * import {\n * checkAndGetEnvValue,\n * EnvironmentNotFoundError,\n * } from '@kikiutils/shared/env';\n \n process.env.API_KEY = '';\n * checkAndGetEnvValue('API_KEY'); // => ''\n \n delete process.env.API_KEY;\n * try {\n * checkAndGetEnvValue('API_KEY');\n * } catch (error) {\n * console.log(error instanceof EnvironmentNotFoundError); // => true\n * }\n * ```\n */\nexport function checkAndGetEnvValue(key: string) {\n if (process.env[key] === undefined) throw new EnvironmentNotFoundError(key);\n return process.env[key];\n}\n"],"mappings":";;;;;;;AAMA,IAAa,2BAAb,cAA8C,MAAM;CACvC;;;;;;CAOT,YAAY,KAAa;EACrB,MAAM,iCAAiC,KAAK;EAC5C,KAAK,MAAM;EACX,KAAK,OAAO,KAAK,YAAY;EAC7B,MAAM,oBAAoB,MAAM,KAAK,WAAW;CACpD;AACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,oBAAoB,KAAa;CAC7C,IAAI,QAAQ,IAAI,SAAS,KAAA,GAAW,MAAM,IAAI,yBAAyB,GAAG;CAC1E,OAAO,QAAQ,IAAI;AACvB"}

package/dist/event-awaiter.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"event-awaiter.d.ts","names":[],"sources":["../src/event-awaiter.ts"],"mappings":";;;;;;;;;;;qBAWa,aAAa;;;;;;;;EAYtB,QAAQ,aAAa,OAAO;;;;;;EAa5B,WAAW,QAAO;;;;;;;;;;;;;;;;;;;;~~EAwBlB~~,KAAK,aAAa,oBAAoB,8BAA8B,SAAS,cAAW,QAAA;;;;;;;;;;;;;;EAgExF,cAAc,aAAa,oBAAoB,SAAS,cAAW,QAAA;;;;;;;;;;;;;;;EAkBnE,WAAW,aAAa,oBAAoB,SAAS,cAAW,QAAA"}
1	+ {"version":3,"file":"event-awaiter.d.ts","names":[],"sources":["../src/event-awaiter.ts"],"mappings":";;;;;;;;;;;qBAWa,aAAa;;;;;;;;EAYtB,QAAQ,aAAa,OAAO;;;;;;EAa5B,WAAW,QAAO;;;;;;;;;;;;;;;;;;;;EAwBZ,KAAK,aAAa,oBAAoB,8BAA8B,SAAS,cAAW,QAAA;;;;;;;;;;;;;;EAgExF,cAAc,aAAa,oBAAoB,SAAS,cAAW,QAAA;;;;;;;;;;;;;;;EAkBnE,WAAW,aAAa,oBAAoB,SAAS,cAAW,QAAA"}

package/dist/event-awaiter.js CHANGED Viewed

@@ -53,8 +53,8 @@ var EventAwaiter = class {
 	*
 	* @throws Error through promise rejection if `strict` mode encounters an existing waiter.
 	*/
-	wait(key, timeoutMs, mode, signal) {
-		return new Promise((resolve) => {
+	async wait(key, timeoutMs, mode, signal) {
+		return await new Promise((resolve) => {
 			const resolvers = this.#promiseResolvers.get(key) || [];
 			if (resolvers.length) switch (mode) {
 				case "override":
@@ -99,8 +99,8 @@ var EventAwaiter = class {
 	*
 	* @see {@link EventAwaiter.wait}
 	*/
-	waitExclusive(key, timeoutMs, signal) {
-		return this.wait(key, timeoutMs, "strict", signal);
+	async waitExclusive(key, timeoutMs, signal) {
+		return await this.wait(key, timeoutMs, "strict", signal);
 	}
 	/**
 	* Replaces existing waiters for a key and waits for its next trigger.
@@ -116,8 +116,8 @@ var EventAwaiter = class {
 	*
 	* @see {@link EventAwaiter.wait}
 	*/
-	waitLatest(key, timeoutMs, signal) {
-		return this.wait(key, timeoutMs, "override", signal);
+	async waitLatest(key, timeoutMs, signal) {
+		return await this.wait(key, timeoutMs, "override", signal);
 	}
 };
 export { EventAwaiter };

package/dist/event-awaiter.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"event-awaiter.js","names":[],"sources":["../src/event-awaiter.ts"],"sourcesContent":["/*\n An asynchronous keyed event rendezvous for one or more waiting consumers.\n \n @remarks\n * Triggers resolve the currently registered waiters; values are not retained for future waits.\n * Timeouts and subsequent abort events resolve affected waiters with `undefined`.\n * Use `triggerAll` to resolve pending waits during cleanup. Timers and abort listeners are not proactively\n * removed by triggers, so they may remain until their timeout or abort event occurs.\n \n @typeParam T - The value delivered to waiting consumers.\n /\nexport class EventAwaiter<T> {\n // Private instance properties\n #promiseResolvers = new Map<string, Array<(value: PromiseLike<T \| undefined> \| T \| undefined) => void>>();\n\n // Public instance methods\n\n /\n Resolves all currently pending waits for a key with the supplied value.\n \n @param key - The event identifier; a key without pending waits has no effect.\n * @param value - The delivered value; `undefined` indicates no result.\n /\n trigger(key: string, value: T \| undefined) {\n const resolvers = this.#promiseResolvers.get(key);\n if (resolvers) {\n this.#promiseResolvers.delete(key);\n resolvers?.forEach((resolve) => resolve(value));\n }\n }\n\n /\n Resolves all currently pending waits and clears their registrations.\n \n @param value - The delivered value; omission resolves all pending waits with `undefined`.\n /\n triggerAll(value: T \| undefined = undefined) {\n for (const [_, resolvers] of this.#promiseResolvers.entries()) resolvers.forEach((resolve) => resolve(value));\n this.#promiseResolvers.clear();\n }\n\n /\n Waits for a trigger associated with a key.\n \n @remarks\n * By default, multiple waiters share a key and all receive the next trigger value.\n * `strict` mode rejects duplicate waits; `override` mode resolves existing waits with `undefined` before\n * registering the new wait. Timeout and abort remove only the affected waiter's registration.\n * An already aborted signal is not checked; only an abort event emitted after registration ends the wait.\n * Without a timeout or subsequent abort, the wait remains pending until a trigger arrives.\n \n @param key - The event identifier to wait for.\n * @param timeoutMs - The optional timeout in milliseconds, using native `setTimeout` timing rules.\n * @param mode - The policy for existing waiters; omission allows multiple waiters.\n * @param signal - A signal whose subsequent abort event ends this wait.\n \n @returns A promise resolving to the triggered value, or `undefined` after timeout, abort, or replacement.\n \n @throws Error through promise rejection if `strict` mode encounters an existing waiter.\n /\n wait(key: string, timeoutMs?: number, mode?: 'override' \| 'strict', signal?: AbortSignal) {\n return new Promise<T \| undefined>((resolve) => {\n const resolvers = this.#promiseResolvers.get(key) \|\| [];\n if (resolvers.length) {\n switch (mode) {\n case 'override':\n resolvers.forEach((r) => r(undefined));\n resolvers.length = 0;\n break;\n case 'strict':\n throw new Error(`Duplicate wait detected for key: ${key}`);\n case undefined:\n break;\n }\n }\n\n resolvers.push(resolve);\n this.#promiseResolvers.set(key, resolvers);\n if (timeoutMs != null) {\n setTimeout(\n () => {\n const resolvers = this.#promiseResolvers.get(key);\n if (resolvers?.includes(resolve)) {\n resolve(undefined);\n const newResolvers = resolvers.filter((r) => r !== resolve);\n if (newResolvers.length) this.#promiseResolvers.set(key, newResolvers);\n else this.#promiseResolvers.delete(key);\n }\n },\n timeoutMs,\n );\n }\n\n if (signal) {\n signal.addEventListener(\n 'abort',\n () => {\n const resolvers = this.#promiseResolvers.get(key);\n if (resolvers?.includes(resolve)) {\n resolve(undefined);\n const newResolvers = resolvers.filter((r) => r !== resolve);\n if (newResolvers.length) this.#promiseResolvers.set(key, newResolvers);\n else this.#promiseResolvers.delete(key);\n }\n },\n { once: true },\n );\n }\n });\n }\n\n /\n Waits for a key while rejecting duplicate registrations.\n \n @param key - The event identifier to wait for.\n * @param timeoutMs - The optional timeout in milliseconds.\n * @param signal - A signal whose subsequent abort event ends this wait; an already aborted signal is not checked.\n \n @returns A promise resolving to the triggered value, or `undefined` on timeout or subsequent abort.\n \n @throws Error through promise rejection if the key already has a pending waiter.\n \n @see {@link EventAwaiter.wait}\n /\n waitExclusive(key: string, timeoutMs?: number, signal?: AbortSignal) {\n return this.wait(key, timeoutMs, 'strict', signal);\n }\n\n /\n Replaces existing waiters for a key and waits for its next trigger.\n \n @remarks\n * Existing waiters resolve with `undefined` before the new waiter is registered.\n \n @param key - The event identifier to wait for.\n * @param timeoutMs - The optional timeout in milliseconds.\n * @param signal - A signal whose subsequent abort event ends this wait; an already aborted signal is not checked.\n \n @returns A promise resolving to the triggered value, or `undefined` on timeout, subsequent abort, or replacement.\n \n @see {@link EventAwaiter.wait}\n */\n waitLatest(key: string, timeoutMs?: number, signal?: AbortSignal) {\n return this.wait(key, timeoutMs, 'override', signal);\n }\n}\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,eAAb,MAA6B;CAEzB,oCAAoB,IAAI,IAAgF;;;;;;;CAUxG,QAAQ,KAAa,OAAsB;EACvC,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;EAChD,IAAI,WAAW;GACX,KAAK,kBAAkB,OAAO,GAAG;GACjC,WAAW,SAAS,YAAY,QAAQ,KAAK,CAAC;EAClD;CACJ;;;;;;CAOA,WAAW,QAAuB,KAAA,GAAW;EACzC,KAAK,MAAM,CAAC,GAAG,cAAc,KAAK,kBAAkB,QAAQ,GAAG,UAAU,SAAS,YAAY,QAAQ,KAAK,CAAC;EAC5G,KAAK,kBAAkB,MAAM;CACjC;;;;;;;;;;;;;;;;;;;;CAqBA,KAAK,KAAa,WAAoB,MAA8B,QAAsB;~~EACtF~~,OAAO,IAAI,SAAwB,YAAY;~~GAC3C~~,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG,KAAK,CAAC;GACtD,IAAI,UAAU,QACV,QAAQ,MAAR;IACI,KAAK;KACD,UAAU,SAAS,MAAM,EAAE,KAAA,CAAS,CAAC;KACrC,UAAU,SAAS;KACnB;IACJ,KAAK,UACD,MAAM,IAAI,MAAM,oCAAoC,KAAK;IAC7D,KAAK,KAAA;GAET;GAGJ,UAAU,KAAK,OAAO;GACtB,KAAK,kBAAkB,IAAI,KAAK,SAAS;GACzC,IAAI,aAAa,MACb,iBACU;IACF,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;IAChD,IAAI,WAAW,SAAS,OAAO,GAAG;KAC9B,QAAQ,KAAA,CAAS;KACjB,MAAM,eAAe,UAAU,QAAQ,MAAM,MAAM,OAAO;KAC1D,IAAI,aAAa,QAAQ,KAAK,kBAAkB,IAAI,KAAK,YAAY;UAChE,KAAK,kBAAkB,OAAO,GAAG;IAC1C;GACJ,GACA,SACJ;GAGJ,IAAI,QACA,OAAO,iBACH,eACM;IACF,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;IAChD,IAAI,WAAW,SAAS,OAAO,GAAG;KAC9B,QAAQ,KAAA,CAAS;KACjB,MAAM,eAAe,UAAU,QAAQ,MAAM,MAAM,OAAO;KAC1D,IAAI,aAAa,QAAQ,KAAK,kBAAkB,IAAI,KAAK,YAAY;UAChE,KAAK,kBAAkB,OAAO,GAAG;IAC1C;GACJ,GACA,EAAE,MAAM,KAAK,CACjB;EAER,CAAC;CACL;;;;;;;;;;;;;;CAeA,cAAc,KAAa,WAAoB,QAAsB;~~EACjE~~,OAAO,KAAK,KAAK,KAAK,WAAW,UAAU,MAAM;~~CACrD~~;;;;;;;;;;;;;;;CAgBA,WAAW,KAAa,WAAoB,QAAsB;~~EAC9D~~,OAAO,KAAK,KAAK,KAAK,WAAW,YAAY,MAAM;~~CACvD~~;AACJ"}
1	+ {"version":3,"file":"event-awaiter.js","names":[],"sources":["../src/event-awaiter.ts"],"sourcesContent":["/*\n An asynchronous keyed event rendezvous for one or more waiting consumers.\n \n @remarks\n * Triggers resolve the currently registered waiters; values are not retained for future waits.\n * Timeouts and subsequent abort events resolve affected waiters with `undefined`.\n * Use `triggerAll` to resolve pending waits during cleanup. Timers and abort listeners are not proactively\n * removed by triggers, so they may remain until their timeout or abort event occurs.\n \n @typeParam T - The value delivered to waiting consumers.\n /\nexport class EventAwaiter<T> {\n // Private instance properties\n #promiseResolvers = new Map<string, Array<(value: PromiseLike<T \| undefined> \| T \| undefined) => void>>();\n\n // Public instance methods\n\n /\n Resolves all currently pending waits for a key with the supplied value.\n \n @param key - The event identifier; a key without pending waits has no effect.\n * @param value - The delivered value; `undefined` indicates no result.\n /\n trigger(key: string, value: T \| undefined) {\n const resolvers = this.#promiseResolvers.get(key);\n if (resolvers) {\n this.#promiseResolvers.delete(key);\n resolvers?.forEach((resolve) => resolve(value));\n }\n }\n\n /\n Resolves all currently pending waits and clears their registrations.\n \n @param value - The delivered value; omission resolves all pending waits with `undefined`.\n /\n triggerAll(value: T \| undefined = undefined) {\n for (const [_, resolvers] of this.#promiseResolvers.entries()) resolvers.forEach((resolve) => resolve(value));\n this.#promiseResolvers.clear();\n }\n\n /\n Waits for a trigger associated with a key.\n \n @remarks\n * By default, multiple waiters share a key and all receive the next trigger value.\n * `strict` mode rejects duplicate waits; `override` mode resolves existing waits with `undefined` before\n * registering the new wait. Timeout and abort remove only the affected waiter's registration.\n * An already aborted signal is not checked; only an abort event emitted after registration ends the wait.\n * Without a timeout or subsequent abort, the wait remains pending until a trigger arrives.\n \n @param key - The event identifier to wait for.\n * @param timeoutMs - The optional timeout in milliseconds, using native `setTimeout` timing rules.\n * @param mode - The policy for existing waiters; omission allows multiple waiters.\n * @param signal - A signal whose subsequent abort event ends this wait.\n \n @returns A promise resolving to the triggered value, or `undefined` after timeout, abort, or replacement.\n \n @throws Error through promise rejection if `strict` mode encounters an existing waiter.\n /\n async wait(key: string, timeoutMs?: number, mode?: 'override' \| 'strict', signal?: AbortSignal) {\n return await new Promise<T \| undefined>((resolve) => {\n const resolvers = this.#promiseResolvers.get(key) \|\| [];\n if (resolvers.length) {\n switch (mode) {\n case 'override':\n resolvers.forEach((r) => r(undefined));\n resolvers.length = 0;\n break;\n case 'strict':\n throw new Error(`Duplicate wait detected for key: ${key}`);\n case undefined:\n break;\n }\n }\n\n resolvers.push(resolve);\n this.#promiseResolvers.set(key, resolvers);\n if (timeoutMs != null) {\n setTimeout(\n () => {\n const resolvers = this.#promiseResolvers.get(key);\n if (resolvers?.includes(resolve)) {\n resolve(undefined);\n const newResolvers = resolvers.filter((r) => r !== resolve);\n if (newResolvers.length) this.#promiseResolvers.set(key, newResolvers);\n else this.#promiseResolvers.delete(key);\n }\n },\n timeoutMs,\n );\n }\n\n if (signal) {\n signal.addEventListener(\n 'abort',\n () => {\n const resolvers = this.#promiseResolvers.get(key);\n if (resolvers?.includes(resolve)) {\n resolve(undefined);\n const newResolvers = resolvers.filter((r) => r !== resolve);\n if (newResolvers.length) this.#promiseResolvers.set(key, newResolvers);\n else this.#promiseResolvers.delete(key);\n }\n },\n { once: true },\n );\n }\n });\n }\n\n /\n Waits for a key while rejecting duplicate registrations.\n \n @param key - The event identifier to wait for.\n * @param timeoutMs - The optional timeout in milliseconds.\n * @param signal - A signal whose subsequent abort event ends this wait; an already aborted signal is not checked.\n \n @returns A promise resolving to the triggered value, or `undefined` on timeout or subsequent abort.\n \n @throws Error through promise rejection if the key already has a pending waiter.\n \n @see {@link EventAwaiter.wait}\n /\n async waitExclusive(key: string, timeoutMs?: number, signal?: AbortSignal) {\n return await this.wait(key, timeoutMs, 'strict', signal);\n }\n\n /\n Replaces existing waiters for a key and waits for its next trigger.\n \n @remarks\n * Existing waiters resolve with `undefined` before the new waiter is registered.\n \n @param key - The event identifier to wait for.\n * @param timeoutMs - The optional timeout in milliseconds.\n * @param signal - A signal whose subsequent abort event ends this wait; an already aborted signal is not checked.\n \n @returns A promise resolving to the triggered value, or `undefined` on timeout, subsequent abort, or replacement.\n \n @see {@link EventAwaiter.wait}\n */\n async waitLatest(key: string, timeoutMs?: number, signal?: AbortSignal) {\n return await this.wait(key, timeoutMs, 'override', signal);\n }\n}\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,eAAb,MAA6B;CAEzB,oCAAoB,IAAI,IAAgF;;;;;;;CAUxG,QAAQ,KAAa,OAAsB;EACvC,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;EAChD,IAAI,WAAW;GACX,KAAK,kBAAkB,OAAO,GAAG;GACjC,WAAW,SAAS,YAAY,QAAQ,KAAK,CAAC;EAClD;CACJ;;;;;;CAOA,WAAW,QAAuB,KAAA,GAAW;EACzC,KAAK,MAAM,CAAC,GAAG,cAAc,KAAK,kBAAkB,QAAQ,GAAG,UAAU,SAAS,YAAY,QAAQ,KAAK,CAAC;EAC5G,KAAK,kBAAkB,MAAM;CACjC;;;;;;;;;;;;;;;;;;;;CAqBA,MAAM,KAAK,KAAa,WAAoB,MAA8B,QAAsB;EAC5F,OAAO,MAAM,IAAI,SAAwB,YAAY;GACjD,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG,KAAK,CAAC;GACtD,IAAI,UAAU,QACV,QAAQ,MAAR;IACI,KAAK;KACD,UAAU,SAAS,MAAM,EAAE,KAAA,CAAS,CAAC;KACrC,UAAU,SAAS;KACnB;IACJ,KAAK,UACD,MAAM,IAAI,MAAM,oCAAoC,KAAK;IAC7D,KAAK,KAAA;GAET;GAGJ,UAAU,KAAK,OAAO;GACtB,KAAK,kBAAkB,IAAI,KAAK,SAAS;GACzC,IAAI,aAAa,MACb,iBACU;IACF,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;IAChD,IAAI,WAAW,SAAS,OAAO,GAAG;KAC9B,QAAQ,KAAA,CAAS;KACjB,MAAM,eAAe,UAAU,QAAQ,MAAM,MAAM,OAAO;KAC1D,IAAI,aAAa,QAAQ,KAAK,kBAAkB,IAAI,KAAK,YAAY;UAChE,KAAK,kBAAkB,OAAO,GAAG;IAC1C;GACJ,GACA,SACJ;GAGJ,IAAI,QACA,OAAO,iBACH,eACM;IACF,MAAM,YAAY,KAAK,kBAAkB,IAAI,GAAG;IAChD,IAAI,WAAW,SAAS,OAAO,GAAG;KAC9B,QAAQ,KAAA,CAAS;KACjB,MAAM,eAAe,UAAU,QAAQ,MAAM,MAAM,OAAO;KAC1D,IAAI,aAAa,QAAQ,KAAK,kBAAkB,IAAI,KAAK,YAAY;UAChE,KAAK,kBAAkB,OAAO,GAAG;IAC1C;GACJ,GACA,EAAE,MAAM,KAAK,CACjB;EAER,CAAC;CACL;;;;;;;;;;;;;;CAeA,MAAM,cAAc,KAAa,WAAoB,QAAsB;EACvE,OAAO,MAAM,KAAK,KAAK,KAAK,WAAW,UAAU,MAAM;CAC3D;;;;;;;;;;;;;;;CAgBA,MAAM,WAAW,KAAa,WAAoB,QAAsB;EACpE,OAAO,MAAM,KAAK,KAAK,KAAK,WAAW,YAAY,MAAM;CAC7D;AACJ"}

package/dist/general.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
+import { Arrayable } from "type-fest";
 /**
  * Returns the first array element or the input value, with a nullish fallback.
  *
@@ -29,6 +30,6 @@
  * console.log(extractFirstValue(undefined, 'fallback')); // => 'fallback'
  * ```
  */
-export declare function extractFirstValue<T>(value: T | T[]): T | undefined;
-export declare function extractFirstValue<T, D>(value: T | T[], defaultValue: D): D | NonNullable<T>;
+export declare function extractFirstValue<T>(value: Arrayable<T>): T | undefined;
+export declare function extractFirstValue<T, D>(value: Arrayable<T>, defaultValue: D): D | NonNullable<T>;
 //# sourceMappingURL=general.d.ts.map

package/dist/general.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"general.d.ts","names":[],"sources":["../src/general.ts"],"mappings":"~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiCgB~~,kBAAkB,GAAG,OAAO,~~IAAI~~,~~MAAM~~;~~wBACtC~~,kBAAkB,GAAG,GAAG,OAAO,IAAI,~~KAAK,~~cAAc,IAAI,IAAI,YAAY"}
1	+ {"version":3,"file":"general.d.ts","names":[],"sources":["../src/general.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmCgB,kBAAkB,GAAG,OAAO,UAAU,KAAK;wBAC3C,kBAAkB,GAAG,GAAG,OAAO,UAAU,IAAI,cAAc,IAAI,IAAI,YAAY"}

package/dist/general.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"general.js","names":[],"sources":["../src/general.ts"],"sourcesContent":["/* eslint-disable jsdoc/check-param-names /\n\n/\n Returns the first array element or the input value, with a nullish fallback.\n \n @remarks\n * An empty array, `null`, or `undefined` selects the fallback; omission of a fallback yields `undefined`.\n * The input and selected values are not copied or changed.\n \n @typeParam T - The input value or array element type.\n * @typeParam D - The fallback type when the fallback overload is used.\n \n @param value - A single value or an array of values.\n * @param defaultValue - The fallback returned when the selected value is nullish.\n \n @returns The selected non-nullish value, or the fallback without copying either value.\n \n @example\n \n ```ts\n * import { extractFirstValue } from '@kikiutils/shared/general';\n \n console.log(extractFirstValue([\n * 1,\n * 2,\n * 3,\n * ])); // => 1\n \n console.log(extractFirstValue('hello')); // => 'hello'\n * console.log(extractFirstValue([], 'default')); // => 'default'\n * console.log(extractFirstValue(undefined, 'fallback')); // => 'fallback'\n * ```\n /\nexport function extractFirstValue<T>(value: T ~~\| T[]~~): T \| undefined;\nexport function extractFirstValue<T, D>(value: T ~~\| T[],~~ defaultValue: D): D \| NonNullable<T>;\nexport function extractFirstValue<T, D>(value: T ~~\| T[],~~ defaultValue?: D) {\n return (Array.isArray(value) ? value[0] : value) ?? defaultValue;\n}\n\n/ eslint-enable jsdoc/check-param-names */\n"],"mappings":";~~AAmCA~~,SAAgB,kBAAwB,~~OAAgB~~,cAAkB;~~CACtE~~,QAAQ,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,UAAU;AACxD"}
1	+ {"version":3,"file":"general.js","names":[],"sources":["../src/general.ts"],"sourcesContent":["import type { Arrayable } from 'type-fest';\n\n/* eslint-disable jsdoc/check-param-names /\n\n/\n Returns the first array element or the input value, with a nullish fallback.\n \n @remarks\n * An empty array, `null`, or `undefined` selects the fallback; omission of a fallback yields `undefined`.\n * The input and selected values are not copied or changed.\n \n @typeParam T - The input value or array element type.\n * @typeParam D - The fallback type when the fallback overload is used.\n \n @param value - A single value or an array of values.\n * @param defaultValue - The fallback returned when the selected value is nullish.\n \n @returns The selected non-nullish value, or the fallback without copying either value.\n \n @example\n \n ```ts\n * import { extractFirstValue } from '@kikiutils/shared/general';\n \n console.log(extractFirstValue([\n * 1,\n * 2,\n * 3,\n * ])); // => 1\n \n console.log(extractFirstValue('hello')); // => 'hello'\n * console.log(extractFirstValue([], 'default')); // => 'default'\n * console.log(extractFirstValue(undefined, 'fallback')); // => 'fallback'\n * ```\n /\nexport function extractFirstValue<T>(value: Arrayable<T>): T \| undefined;\nexport function extractFirstValue<T, D>(value: Arrayable<T>, defaultValue: D): D \| NonNullable<T>;\nexport function extractFirstValue<T, D>(value: Arrayable<T>, defaultValue?: D) {\n return (Array.isArray(value) ? value[0] : value) ?? defaultValue;\n}\n\n/ eslint-enable jsdoc/check-param-names */\n"],"mappings":";AAqCA,SAAgB,kBAAwB,OAAqB,cAAkB;CAC3E,QAAQ,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,UAAU;AACxD"}

package/dist/logger/_internals/logger.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"logger.d.ts","names":[],"sources":["../../../src/logger/_internals/logger.ts"],"mappings":";;~~UAWU~~;;;;EAIN,SAAS,OAAO;EAChB,QAAQ,QAAQ,iBAAiB;;;;;wBAoBrB,yBACZ,WAAW,OAAO,SAAS,4BAC3B,YAAY,4BACZ,OAAO;wBAkEK,iBAAiB,SAAS,eAAe,OAAO,cAAc,SAAS"}
1	+ {"version":3,"file":"logger.d.ts","names":[],"sources":["../../../src/logger/_internals/logger.ts"],"mappings":";;UAgBU;;;;EAIN,SAAS,OAAO;EAChB,QAAQ,QAAQ,iBAAiB;;;;;wBAoBrB,yBACZ,WAAW,OAAO,SAAS,4BAC3B,YAAY,4BACZ,OAAO;wBAkEK,iBAAiB,SAAS,eAAe,OAAO,cAAc,SAAS"}

package/dist/logger/_internals/logger.js CHANGED Viewed

@@ -1,4 +1,5 @@
 import { loggerMethods } from "./levels.js";
+import { objectHasOwn, objectKeys } from "ts-extras";
 // src/logger/_internals/logger.ts
 const booleanPresentationKeys = [
 	"console",
@@ -108,7 +109,7 @@ function createLoggerCore(options, hooks) {
 			else refreshLevel();
 		}
 	};
-	for (const type of Object.keys(loggerMethods)) logger[type] = async (...args) => {
+	for (const type of objectKeys(loggerMethods)) logger[type] = async (...args) => {
 		try {
 			refreshLevel();
 			if (loggerMethods[type].severity < getLevelSeverity(currentLevel)) return;
@@ -132,7 +133,7 @@ function getLevelSeverity(level) {
 	return level === "silent" ? Number.POSITIVE_INFINITY : loggerMethods[level].severity;
 }
 function isLevel(value) {
-	return typeof value === "string" && (value === "silent" || value !== "success" && Object.hasOwn(loggerMethods, value));
+	return typeof value === "string" && (value === "silent" || value !== "success" && objectHasOwn(loggerMethods, value));
 }
 function readEnvironmentLevel() {
 	return globalThis.process?.env?.LOG_LEVEL;