@powfix/core-js 0.23.1 → 0.23.3

package/dist/shared/utils/RandomUtils.d.ts

@@ -1,4 +1,4 @@
-declare class RandomUtils {
+export declare class RandomUtils {
     static randomNumber(min: number, max: number): number;
     static randomLatinStrings(length: number): string;
     static randomLatinLowercaseStrings(length: number): string;
@@ -6,5 +6,3 @@ declare class RandomUtils {
     static randomNumberStrings(length: number): string;
     static randomStrings(length: number): string;
 }
-
-export { RandomUtils };

package/dist/shared/utils/Sequencer.d.ts

@@ -1,41 +1,38 @@
-import EventEmitter from 'eventemitter3';
-
-interface Sequence {
+import EventEmitter3 from 'eventemitter3';
+export interface Sequence {
     key: string;
     required?: boolean;
     minimumExecutionTime?: number;
     task: Function;
     description?: string;
 }
-declare enum SequencerStatus {
+export declare enum SequencerStatus {
     IDLE = 0,
     RUNNING = 1,
     ERROR = 2,
     DONE = 3
 }
-interface SequencerOption {
+export interface SequencerOption {
     sequences?: Sequence[];
     minimumExecutionTime?: number;
 }
-declare enum SequencerEvent {
+export declare enum SequencerEvent {
     START = "START",
     END = "END",
     SEQUENCE_START = "SEQUENCE_START",
     SEQUENCE_END = "SEQUENCE_END"
 }
-declare class Sequencer {
+export declare class Sequencer {
     protected readonly sequences: Sequence[];
     protected status: SequencerStatus;
     protected minimumExecutionTime: number;
     currentSequence: Sequence | null;
     startTimestamp: number | null;
     endTimestamp: number | null;
-    eventEmitter: EventEmitter<string | symbol, any>;
+    eventEmitter: EventEmitter3<string | symbol, any>;
     constructor(option?: SequencerOption);
     get getCurrentTimeStamp(): number;
     get executionTime(): number | null;
     pushSequence: (sequence: Sequence) => void;
     start: () => Promise<undefined>;
 }
-
-export { type Sequence, Sequencer, SequencerEvent, type SequencerOption, SequencerStatus };

package/dist/shared/utils/StringUtils.d.ts

@@ -1,7 +1,5 @@
-declare class StringUtils {
+export declare class StringUtils {
     static numberWithCommas(x: string | any): string;
     static getByte(s: string): number;
     static levenshteinDistance: (str1?: string, str2?: string) => number;
 }
-
-export { StringUtils };

package/dist/shared/utils/Uint8ArrayUtils.d.ts

@@ -1,6 +1,4 @@
-declare class Uint8ArrayUtils {
+export declare class Uint8ArrayUtils {
     static fromHex(hex: string): Uint8Array;
     static toHex(bytes: Uint8Array): string;
 }
-
-export { Uint8ArrayUtils };

package/dist/shared/utils/UuidUtils.cjs

@@ -48,13 +48,39 @@ var UuidUtils = /*#__PURE__*/ function() {
     _create_class(UuidUtils, null, [
         {
             key: "v4",
-            value: function v4() {
+            value: /**
+   * Generate a random UUID v4 string.
+   *
+   * @deprecated This method is deprecated and will be removed in future versions.
+   * Please use the `UUID` class from the `@powfix/uuid` package instead:
+   *
+   * ```ts
+   * import { UUID } from "@powfix/uuid";
+   * UUID.v4().toString();
+   * ```
+   *
+   * @returns {string} A randomly generated UUID v4 string.
+   */ function v4() {
                 return uuid__namespace.v4();
             }
         },
         {
             key: "format",
-            value: function format(uuid2) {
+            value: /**
+   * Format a UUID string with or without dashes into the canonical
+   * lowercase dashed UUID string representation.
+   *
+   * @deprecated This method is deprecated and will be removed in future versions.
+   * Please use the `UUID` class from the `@powfix/uuid` package instead:
+   *
+   * ```ts
+   * import { UUID } from "@powfix/uuid";
+   * UUID.fromString(str).toString();
+   * ```
+   *
+   * @param uuid A UUID string (32 characters without dashes, or 36 characters with dashes).
+   * @returns {string} Canonical UUID string in lowercase with dashes.
+   */ function format(uuid2) {
                 if (uuid2.length === 32) {
                     return "".concat(uuid2.substring(0, 8), "-").concat(uuid2.substring(8, 12), "-").concat(uuid2.substring(12, 16), "-").concat(uuid2.substring(16, 20), "-").concat(uuid2.substring(20, 32)).toLowerCase();
                 } else if (uuid2.length === 36) {
@@ -83,7 +109,17 @@ var UuidUtils = /*#__PURE__*/ function() {
         },
         {
             key: "isValidUUID",
-            value: function isValidUUID(uuid2) {
+            value: /**
+   * Check is provided uuid string is valid UUID
+   *
+   * @deprecated This method is deprecated and will be removed in future versions.
+   * Please use the `UUID` class from the `@powfix/uuid` package instead:
+   *
+   * ```ts
+   * import { UUID } from "@powfix/uuid";
+   * UUID.isValidString(uuid);
+   * ```
+   */ function isValidUUID(uuid2) {
                 if (!uuid2) return false;
                 if (typeof uuid2 !== "string") return false;
                 return RegExp(/^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$/i).test(uuid2);

package/dist/shared/utils/UuidUtils.d.ts

@@ -1,16 +1,72 @@
-declare class UuidUtils {
+export declare class UuidUtils {
+    /**
+     * Generate a random UUID v4 string.
+     *
+     * @deprecated This method is deprecated and will be removed in future versions.
+     * Please use the `UUID` class from the `@powfix/uuid` package instead:
+     *
+     * ```ts
+     * import { UUID } from "@powfix/uuid";
+     * UUID.v4().toString();
+     * ```
+     *
+     * @returns {string} A randomly generated UUID v4 string.
+     */
     static v4(): string;
+    /**
+     * Format a UUID string with or without dashes into the canonical
+     * lowercase dashed UUID string representation.
+     *
+     * @deprecated This method is deprecated and will be removed in future versions.
+     * Please use the `UUID` class from the `@powfix/uuid` package instead:
+     *
+     * ```ts
+     * import { UUID } from "@powfix/uuid";
+     * UUID.fromString(str).toString();
+     * ```
+     *
+     * @param uuid A UUID string (32 characters without dashes, or 36 characters with dashes).
+     * @returns {string} Canonical UUID string in lowercase with dashes.
+     */
     static format(uuid: string): string;
     /**
-     * (UUID: Buffer) to (UUID: string)
-     * @param binary UUID
-     * @returns {string|null} When binary not exists return null
+     * Convert a UUID Buffer/Uint8Array into a string representation.
+     *
+     * @deprecated This method is deprecated and will be removed in future versions.
+     * Please use the `UUID` class from the `@powfix/uuid` package instead:
+     *
+     * ```ts
+     * import { UUID } from "@powfix/uuid";
+     * UUID.fromBuffer(binary).toString();
+     * ```
+     *
+     * @param binary A UUID in Buffer or Uint8Array form.
+     * @returns {string|null} The UUID string, or null if the input is not provided.
      */
     static toString(binary: Uint8Array): string;
-    /** (UUID: string) to (UUID: Buffer) */
+    /**
+     * Convert a UUID string to a Buffer.
+     *
+     * @deprecated This method is deprecated and will be removed in future versions.
+     * Please use the `UUID` class from the `@powfix/uuid` package instead:
+     *
+     * ```ts
+     * import { UUID } from "@powfix/uuid";
+     * UUID.fromString(uuid).toBuffer();
+     * ```
+     */
     static toBuffer(uuid: string): Buffer;
     static toBuffer(uuid: string | null | undefined): Buffer | null;
+    /**
+     * Check is provided uuid string is valid UUID
+     *
+     * @deprecated This method is deprecated and will be removed in future versions.
+     * Please use the `UUID` class from the `@powfix/uuid` package instead:
+     *
+     * ```ts
+     * import { UUID } from "@powfix/uuid";
+     * UUID.isValidString(uuid);
+     * ```
+     */
     static isValidUUID(uuid: string): boolean;
 }
-
-export { UuidUtils };

package/dist/shared/utils/UuidUtils.js

@@ -28,13 +28,39 @@ var UuidUtils = /*#__PURE__*/ function() {
     _create_class(UuidUtils, null, [
         {
             key: "v4",
-            value: function v4() {
+            value: /**
+   * Generate a random UUID v4 string.
+   *
+   * @deprecated This method is deprecated and will be removed in future versions.
+   * Please use the `UUID` class from the `@powfix/uuid` package instead:
+   *
+   * ```ts
+   * import { UUID } from "@powfix/uuid";
+   * UUID.v4().toString();
+   * ```
+   *
+   * @returns {string} A randomly generated UUID v4 string.
+   */ function v4() {
                 return uuid.v4();
             }
         },
         {
             key: "format",
-            value: function format(uuid2) {
+            value: /**
+   * Format a UUID string with or without dashes into the canonical
+   * lowercase dashed UUID string representation.
+   *
+   * @deprecated This method is deprecated and will be removed in future versions.
+   * Please use the `UUID` class from the `@powfix/uuid` package instead:
+   *
+   * ```ts
+   * import { UUID } from "@powfix/uuid";
+   * UUID.fromString(str).toString();
+   * ```
+   *
+   * @param uuid A UUID string (32 characters without dashes, or 36 characters with dashes).
+   * @returns {string} Canonical UUID string in lowercase with dashes.
+   */ function format(uuid2) {
                 if (uuid2.length === 32) {
                     return "".concat(uuid2.substring(0, 8), "-").concat(uuid2.substring(8, 12), "-").concat(uuid2.substring(12, 16), "-").concat(uuid2.substring(16, 20), "-").concat(uuid2.substring(20, 32)).toLowerCase();
                 } else if (uuid2.length === 36) {
@@ -63,7 +89,17 @@ var UuidUtils = /*#__PURE__*/ function() {
         },
         {
             key: "isValidUUID",
-            value: function isValidUUID(uuid2) {
+            value: /**
+   * Check is provided uuid string is valid UUID
+   *
+   * @deprecated This method is deprecated and will be removed in future versions.
+   * Please use the `UUID` class from the `@powfix/uuid` package instead:
+   *
+   * ```ts
+   * import { UUID } from "@powfix/uuid";
+   * UUID.isValidString(uuid);
+   * ```
+   */ function isValidUUID(uuid2) {
                 if (!uuid2) return false;
                 if (typeof uuid2 !== "string") return false;
                 return RegExp(/^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$/i).test(uuid2);

package/dist/shared/utils/Validator.d.ts

@@ -1,4 +1,4 @@
-declare class Validator {
+export declare class Validator {
     static validate(value: string | null | undefined, options: Validator.Options): {
         result: boolean;
         validations: Validator.VALIDATION[];
@@ -6,7 +6,7 @@ declare class Validator {
         errors: Validator.VALIDATION[];
     };
 }
-declare namespace Validator {
+export declare namespace Validator {
     enum VALIDATION {
         MIN_LENGTH = "MIN_LENGTH",
         MAX_LENGTH = "MAX_LENGTH",
@@ -46,5 +46,3 @@ declare namespace Validator {
         startsWithSpecialCharacter?: boolean;
     }
 }
-
-export { Validator };

package/dist/shared/utils/global/atob.d.ts

@@ -1,5 +1,2 @@
-import base64 from 'base-64';
-
-declare const atob: typeof base64.decode;
-
-export { atob };
+import base64 from "base-64";
+export declare const atob: typeof base64.decode;

package/dist/shared/utils/global/base64.d.ts

@@ -1,4 +1,2 @@
-declare function encodeBase64(str: string): string;
-declare function decodeBase64(base64: string): string;
-
-export { decodeBase64, encodeBase64 };
+export declare function encodeBase64(str: string): string;
+export declare function decodeBase64(base64: string): string;

package/dist/shared/utils/global/between.d.ts

@@ -1,3 +1 @@
-declare const between: (value: number, from: number, to: number) => boolean;
-
-export { between };
+export declare const between: (value: number, from: number, to: number) => boolean;

package/dist/shared/utils/global/btoa.d.ts

@@ -1,5 +1,2 @@
-import base64 from 'base-64';
-
-declare const btoa: typeof base64.encode;
-
-export { btoa };
+import base64 from "base-64";
+export declare const btoa: typeof base64.encode;

package/dist/shared/utils/global/castArray.d.ts

@@ -1,3 +1 @@
-declare function castArray<T>(value: T | T[]): T[];
-
-export { castArray };
+export declare function castArray<T>(value: T | T[]): T[];

package/dist/shared/utils/global/circularDistance.d.ts

@@ -1,3 +1 @@
-declare function circularDistance(value: number, target: number, min: number, max: number): number;
-
-export { circularDistance };
+export declare function circularDistance(value: number, target: number, min: number, max: number): number;

package/dist/shared/utils/global/fallbackIfMatch.d.ts

@@ -1,3 +1 @@
-declare function fallbackIfMatch<V, C, F>(value: V, condition: C, fallback: F): V | F;
-
-export { fallbackIfMatch };
+export declare function fallbackIfMatch<V, C, F>(value: V, condition: C, fallback: F): V | F;

package/dist/shared/utils/global/fallbackIfNull.d.ts

@@ -1,3 +1 @@
-declare function fallbackIfNull<V, F>(value: V, fallback: F): V | F;
-
-export { fallbackIfNull };
+export declare function fallbackIfNull<V, F>(value: V, fallback: F): V | F;

package/dist/shared/utils/global/fallbackIfNullish.d.ts

@@ -1,3 +1 @@
-declare function fallbackIfNullish<T, F>(value: T | null | undefined, fallback: F): T | F;
-
-export { fallbackIfNullish };
+export declare function fallbackIfNullish<T, F>(value: T | null | undefined, fallback: F): T | F;

package/dist/shared/utils/global/fallbackIfUndefined.d.ts

@@ -1,3 +1 @@
-declare function fallbackIfUndefined<V, F>(value: V, fallback: F): V | F;
-
-export { fallbackIfUndefined };
+export declare function fallbackIfUndefined<V, F>(value: V, fallback: F): V | F;

package/dist/shared/utils/global/firstNonNullish.d.ts

@@ -1,3 +1 @@
-declare function firstNonNullish<T>(...args: T[]): NonNullable<T> | undefined;
-
-export { firstNonNullish };
+export declare function firstNonNullish<T>(...args: T[]): NonNullable<T> | undefined;

package/dist/shared/utils/global/flat.d.ts

@@ -1,16 +1,14 @@
-interface FlattenOptions {
+export interface FlattenOptions {
     delimiter?: string;
     maxDepth?: number;
     safe?: boolean;
     transformKey?: (key: string) => string;
 }
-interface UnflattenOptions {
+export interface UnflattenOptions {
     delimiter?: string;
     object?: boolean;
     overwrite?: boolean;
     transformKey?: (key: string) => string;
 }
-declare function flatten<T extends object>(target: T, opts?: FlattenOptions): Record<string, any>;
-declare function unflatten<T extends object>(target: T, opts?: UnflattenOptions): any;
-
-export { type FlattenOptions, type UnflattenOptions, flatten, unflatten };
+export declare function flatten<T extends object>(target: T, opts?: FlattenOptions): Record<string, any>;
+export declare function unflatten<T extends object>(target: T, opts?: UnflattenOptions): any;

package/dist/shared/utils/global/index.d.ts

@@ -1,16 +1,15 @@
-export { atob } from './atob.js';
-export { decodeBase64, encodeBase64 } from './base64.js';
-export { between } from './between.js';
-export { btoa } from './btoa.js';
-export { castArray } from './castArray.js';
-export { circularDistance } from './circularDistance.js';
-export { sleep } from './sleep.js';
-export { fallbackIfMatch } from './fallbackIfMatch.js';
-export { fallbackIfNull } from './fallbackIfNull.js';
-export { fallbackIfNullish } from './fallbackIfNullish.js';
-export { fallbackIfUndefined } from './fallbackIfUndefined.js';
-export { firstNonNullish } from './firstNonNullish.js';
-export { FlattenOptions, UnflattenOptions, flatten, unflatten } from './flat.js';
-export { processFirstNonNullish } from './processFirstNonNullish.js';
-export { pureEnum, pureEnumKeys, pureEnumValues } from './pureEnum.js';
-import 'base-64';
+export * from './atob';
+export * from './base64';
+export * from './between';
+export * from './btoa';
+export * from './castArray';
+export * from './circularDistance';
+export * from './sleep';
+export * from './fallbackIfMatch';
+export * from './fallbackIfNull';
+export * from './fallbackIfNullish';
+export * from './fallbackIfUndefined';
+export * from './firstNonNullish';
+export * from './flat';
+export * from './processFirstNonNullish';
+export * from './pureEnum';

package/dist/shared/utils/global/processFirstNonNullish.d.ts

@@ -1,3 +1 @@
-declare function processFirstNonNullish<T, R>(processor: (nonNullish: NonNullable<T>) => R, ...args: T[]): R | undefined;
-
-export { processFirstNonNullish };
+export declare function processFirstNonNullish<T, R>(processor: (nonNullish: NonNullable<T>) => R, ...args: T[]): R | undefined;

package/dist/shared/utils/global/pureEnum.d.ts

@@ -5,14 +5,13 @@ type PureEnumReturnType<E extends object> = [NonFunction<E, "keys">, NonFunction
 /**
  * @deprecated Use Enum instead.
  */
-declare function pureEnum<E extends object>(e: E): PureEnumReturnType<E>;
+export declare function pureEnum<E extends object>(e: E): PureEnumReturnType<E>;
 /**
  * @deprecated Use Enum instead.
  */
-declare function pureEnumKeys<E extends object>(e: E): NonFunction<E, "keys">[];
+export declare function pureEnumKeys<E extends object>(e: E): NonFunction<E, "keys">[];
 /**
  * @deprecated Use Enum instead.
  */
-declare function pureEnumValues<E extends object>(e: E): NonFunction<E, "values">[];
-
-export { pureEnum, pureEnumKeys, pureEnumValues };
+export declare function pureEnumValues<E extends object>(e: E): NonFunction<E, "values">[];
+export {};

package/dist/shared/utils/global/sleep.d.ts

@@ -1,3 +1 @@
-declare const sleep: (ms: number) => Promise<unknown>;
-
-export { sleep };
+export declare const sleep: (ms: number) => Promise<unknown>;

package/dist/shared/utils/index.d.ts

@@ -1,44 +1,21 @@
-export { atob } from './global/atob.js';
-export { decodeBase64, encodeBase64 } from './global/base64.js';
-export { between } from './global/between.js';
-export { btoa } from './global/btoa.js';
-export { castArray } from './global/castArray.js';
-export { circularDistance } from './global/circularDistance.js';
-export { sleep } from './global/sleep.js';
-export { fallbackIfMatch } from './global/fallbackIfMatch.js';
-export { fallbackIfNull } from './global/fallbackIfNull.js';
-export { fallbackIfNullish } from './global/fallbackIfNullish.js';
-export { fallbackIfUndefined } from './global/fallbackIfUndefined.js';
-export { firstNonNullish } from './global/firstNonNullish.js';
-export { FlattenOptions, UnflattenOptions, flatten, unflatten } from './global/flat.js';
-export { processFirstNonNullish } from './global/processFirstNonNullish.js';
-export { pureEnum, pureEnumKeys, pureEnumValues } from './global/pureEnum.js';
-export { ArrayUtils } from './ArrayUtils.js';
-export { AxiosUtils } from './AxiosUtils.js';
-export { StringUtils } from './StringUtils.js';
-export { Uint8ArrayUtils } from './Uint8ArrayUtils.js';
-export { UuidUtils } from './UuidUtils.js';
-export { parseBoolean } from './BooleanUtils.js';
-export { Calc } from './Calc.js';
-export { CoordinateUtils } from './CoordinateUtils.js';
-export { DateUtils } from './DateUtils.js';
-export { Enum } from './Enum.js';
-export { EnumEntries, EnumEntry } from './Enum.types.js';
-export { I18nUtils } from './I18nUtils.js';
-export { NumberUtils } from './NumberUtils.js';
-export { ObjectIdUtils } from './ObjectIdUtils.js';
-export { Point3Utils } from './Point3Utils.js';
-export { RandomUtils } from './RandomUtils.js';
-export { Validator } from './Validator.js';
-export { JuminNumberUtils } from './JuminNumberUtils.js';
-export { Sequence, Sequencer, SequencerEvent, SequencerOption, SequencerStatus } from './Sequencer.js';
-export { TryCatch } from './try-catch/TryCatch.js';
-import 'base-64';
-import 'axios';
-import '../interfaces/Coordinate.js';
-import 'moment';
-import '../constants/DATE.js';
-import 'i18next';
-import '../interfaces/Point3.js';
-import '../interfaces/Point2.js';
-import 'eventemitter3';
+export * from './global';
+export * from './ArrayUtils';
+export * from './AxiosUtils';
+export * from './StringUtils';
+export * from './Uint8ArrayUtils';
+export * from './UuidUtils';
+export * from './BooleanUtils';
+export * from './Calc';
+export * from './CoordinateUtils';
+export * from './DateUtils';
+export * from './Enum';
+export * from './Enum.types';
+export * from './I18nUtils';
+export * from './NumberUtils';
+export * from './ObjectIdUtils';
+export * from './Point3Utils';
+export * from './RandomUtils';
+export * from './Validator';
+export * from './JuminNumberUtils';
+export * from './Sequencer';
+export * from './try-catch';

package/dist/shared/utils/try-catch/TryCatch.d.ts

@@ -2,7 +2,7 @@
  * Provides a utility class for handling synchronous and asynchronous operations with a consistent try-catch pattern.
  * It returns a tuple where the first element is the error (or null on success) and the second element is the result (or undefined on error).
  */
-declare class TryCatch {
+export declare class TryCatch {
     /**
      * Executes a synchronous function within a try-catch block.
      * @template T The return type of the function.
@@ -22,5 +22,3 @@ declare class TryCatch {
      */
     static asyncFunction<T, E = Error>(fn: Promise<T>, disableLogging?: boolean): Promise<readonly [null, Awaited<T>] | readonly [E, undefined]>;
 }
-
-export { TryCatch };

package/dist/shared/utils/try-catch/index.d.ts

@@ -1 +1 @@
-export { TryCatch } from './TryCatch.js';
+export * from "./TryCatch";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powfix/core-js",
-  "version": "0.23.1",
+  "version": "0.23.3",
   "description": "core package",
   "author": "Kwon Kyung-Min <powfix@gmail.com>",
   "private": false,
@@ -19,6 +19,22 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "scripts": {
+    "clean": "rm -rf dist | wc -l",
+    "esmfix": "tsc-esm-fix --ext='.mjs'",
+    "compile": "tsc",
+    "prebuild": "yarn clean",
+    "build": "yarn run build:cjs && yarn run build:esm && yarn run build:dts",
+    "build:dts": "tsc -p tsconfig.declaration.json",
+    "build:cjs": "tsup --config tsup.cjs.config.ts",
+    "build:esm": "tsup --config tsup.esm.config.ts"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -36,17 +52,6 @@
       "require": "./dist/index.node.cjs"
     }
   },
-  "scripts": {
-    "clean": "rm -rf dist | wc -l",
-    "esmfix": "tsc-esm-fix --ext='.mjs'",
-    "prebuild": "yarn clean",
-    "build": "yarn run build:cjs && yarn run build:esm",
-    "build:cjs": "tsup --config tsup.cjs.config.ts",
-    "build:esm": "tsup --config tsup.esm.config.ts"
-  },
-  "files": [
-    "dist"
-  ],
   "dependencies": {
     "base-64": "^1.0.0",
     "eventemitter3": "^5.0.1",
@@ -54,7 +59,7 @@
     "uuid": "9.0.1"
   },
   "devDependencies": {
-    "@powfix/uuid": "^0.2.1",
+    "@powfix/uuid": "^0.2.4",
     "@swc/core": "^1.13.5",
     "@types/base-64": "1.0.2",
     "@types/node": "^24.5.1",