@vpmedia/simplify 1.53.0 → 1.55.0

package/src/util/validate.test.js

@@ -0,0 +1,325 @@
+/* eslint-disable unicorn/no-useless-undefined */
+
+import {
+  isArray,
+  isArrayOf,
+  isBoolean,
+  isEnum,
+  isFunction,
+  isInstance,
+  isInteger,
+  isNonNegativeInteger,
+  isNonNegativeNumber,
+  isNull,
+  isNumber,
+  isPlainObject,
+  isPlainObjectOf,
+  isAnyOf,
+  isPositiveInteger,
+  isPositiveNumber,
+  isString,
+  isUndefined,
+  typeCheck,
+  typeCheckArray,
+  TypeCheckError,
+  refineValidator,
+  isNumberLess,
+  isNumberGreater,
+  isNumberLessOrEqual,
+  isNumberGreaterOrEqual,
+  isIntegerLess,
+  isIntegerGreater,
+  isIntegerLessOrEqual,
+  isIntegerGreaterOrEqual,
+  isNumberInRange,
+  isIntegerInRange,
+  isArrayLengthEqual,
+  isArrayLengthInRange,
+  isStringLengthEqual,
+  isStringLengthInRange,
+  isNullOrUndefined,
+} from './validate.js';
+
+describe('validate', () => {
+  test('isArray', () => {
+    expect(isArray('string')).toBe(false);
+    expect(isArray([])).toBe(true);
+    expect(isArray([1, 2, 3])).toBe(true);
+    expect(isArray({ string: '1' })).toBe(false);
+    expect(isArray(0.1)).toBe(false);
+    expect(isArray(1)).toBe(false);
+    expect(isArray(false)).toBe(false);
+    expect(isArray(null)).toBe(false);
+    expect(isArray(true)).toBe(false);
+    expect(isArray(undefined)).toBe(false);
+    expect(isArray(() => true)).toBe(false);
+  });
+
+  test('isBoolean', () => {
+    expect(isBoolean('string')).toBe(false);
+    expect(isBoolean([])).toBe(false);
+    expect(isBoolean([1, 2, 3])).toBe(false);
+    expect(isBoolean({ string: '1' })).toBe(false);
+    expect(isBoolean(0.1)).toBe(false);
+    expect(isBoolean(1)).toBe(false);
+    expect(isBoolean(false)).toBe(true);
+    expect(isBoolean(null)).toBe(false);
+    expect(isBoolean(true)).toBe(true);
+    expect(isBoolean(undefined)).toBe(false);
+    expect(isBoolean(() => true)).toBe(false);
+  });
+
+  test('isNumber', () => {
+    expect(isNumber('string')).toBe(false);
+    expect(isNumber([])).toBe(false);
+    expect(isNumber([1, 2, 3])).toBe(false);
+    expect(isNumber({ string: '1' })).toBe(false);
+    expect(isNumber(0.1)).toBe(true);
+    expect(isNumber(1)).toBe(true);
+    expect(isNumber(false)).toBe(false);
+    expect(isNumber(null)).toBe(false);
+    expect(isNumber(Number.NaN)).toBe(false);
+    expect(isNumber(Number.POSITIVE_INFINITY)).toBe(false);
+    expect(isNumber(true)).toBe(false);
+    expect(isNumber(undefined)).toBe(false);
+    expect(isNumber(() => true)).toBe(false);
+  });
+
+  test('isPositiveNumber', () => {
+    expect(isPositiveNumber(0)).toBe(false);
+    expect(isPositiveNumber(1)).toBe(true);
+    expect(isPositiveNumber(1.1)).toBe(true);
+    expect(isPositiveNumber(-1)).toBe(false);
+    expect(isPositiveNumber(-1.1)).toBe(false);
+  });
+
+  test('isNonNegativeNumber', () => {
+    expect(isNonNegativeNumber(0)).toBe(true);
+    expect(isNonNegativeNumber(1)).toBe(true);
+    expect(isNonNegativeNumber(1.1)).toBe(true);
+    expect(isNonNegativeNumber(-1)).toBe(false);
+    expect(isNonNegativeNumber(-1.1)).toBe(false);
+  });
+
+  test('isInteger', () => {
+    expect(isInteger('string')).toBe(false);
+    expect(isInteger(() => true)).toBe(false);
+    expect(isInteger([])).toBe(false);
+    expect(isInteger([1, 2, 3])).toBe(false);
+    expect(isInteger({ string: '1' })).toBe(false);
+    expect(isInteger(0.1)).toBe(false);
+    expect(isInteger(1)).toBe(true);
+    expect(isInteger(false)).toBe(false);
+    expect(isInteger(null)).toBe(false);
+    expect(isInteger(Number.NaN)).toBe(false);
+    expect(isInteger(Number.POSITIVE_INFINITY)).toBe(false);
+    expect(isInteger(true)).toBe(false);
+    expect(isInteger(undefined)).toBe(false);
+  });
+
+  test('isPositiveInteger', () => {
+    expect(isPositiveInteger(0)).toBe(false);
+    expect(isPositiveInteger(1)).toBe(true);
+    expect(isPositiveInteger(1.1)).toBe(false);
+    expect(isPositiveInteger(-1)).toBe(false);
+    expect(isPositiveInteger(-1.1)).toBe(false);
+  });
+
+  test('isNonNegativeInteger', () => {
+    expect(isNonNegativeInteger(0)).toBe(true);
+    expect(isNonNegativeInteger(1)).toBe(true);
+    expect(isNonNegativeInteger(1.1)).toBe(false);
+    expect(isNonNegativeInteger(-1)).toBe(false);
+    expect(isNonNegativeInteger(-1.1)).toBe(false);
+  });
+
+  test('isString', () => {
+    expect(isString('string')).toBe(true);
+    expect(isString([])).toBe(false);
+    expect(isString([1, 2, 3])).toBe(false);
+    expect(isString({ string: '1' })).toBe(false);
+    expect(isString(0.1)).toBe(false);
+    expect(isString(1)).toBe(false);
+    expect(isString(false)).toBe(false);
+    expect(isString(null)).toBe(false);
+    expect(isString(true)).toBe(false);
+    expect(isString(undefined)).toBe(false);
+    expect(isString(() => true)).toBe(false);
+  });
+
+  test('isFunction', () => {
+    expect(isFunction('string')).toBe(false);
+    expect(isFunction([])).toBe(false);
+    expect(isFunction([1, 2, 3])).toBe(false);
+    expect(isFunction({ string: '1' })).toBe(false);
+    expect(isFunction(0.1)).toBe(false);
+    expect(isFunction(1)).toBe(false);
+    expect(isFunction(false)).toBe(false);
+    expect(isFunction(null)).toBe(false);
+    expect(isFunction(true)).toBe(false);
+    expect(isFunction(undefined)).toBe(false);
+    expect(isFunction(() => true)).toBe(true);
+  });
+
+  test('isNull', () => {
+    expect(isNull('string')).toBe(false);
+    expect(isNull([])).toBe(false);
+    expect(isNull([1, 2, 3])).toBe(false);
+    expect(isNull({ string: '1' })).toBe(false);
+    expect(isNull(0.1)).toBe(false);
+    expect(isNull(1)).toBe(false);
+    expect(isNull(false)).toBe(false);
+    expect(isNull(null)).toBe(true);
+    expect(isNull(true)).toBe(false);
+    expect(isNull(undefined)).toBe(false);
+    expect(isNull(() => true)).toBe(false);
+  });
+
+  test('isUndefined', () => {
+    expect(isUndefined('string')).toBe(false);
+    expect(isUndefined([])).toBe(false);
+    expect(isUndefined([1, 2, 3])).toBe(false);
+    expect(isUndefined({ string: '1' })).toBe(false);
+    expect(isUndefined(0.1)).toBe(false);
+    expect(isUndefined(1)).toBe(false);
+    expect(isUndefined(false)).toBe(false);
+    expect(isUndefined(null)).toBe(false);
+    expect(isUndefined(true)).toBe(false);
+    expect(isUndefined(undefined)).toBe(true);
+    expect(isUndefined(() => true)).toBe(false);
+  });
+
+  test('isNullOrUndefined', () => {
+    expect(isNullOrUndefined('string')).toBe(false);
+    expect(isNullOrUndefined([])).toBe(false);
+    expect(isNullOrUndefined([1, 2, 3])).toBe(false);
+    expect(isNullOrUndefined({ string: '1' })).toBe(false);
+    expect(isNullOrUndefined(0.1)).toBe(false);
+    expect(isNullOrUndefined(1)).toBe(false);
+    expect(isNullOrUndefined(false)).toBe(false);
+    expect(isNullOrUndefined(null)).toBe(true);
+    expect(isNullOrUndefined(true)).toBe(false);
+    expect(isNullOrUndefined(undefined)).toBe(true);
+    expect(isNullOrUndefined(() => true)).toBe(false);
+  });
+
+  test('isPlainObject', () => {
+    expect(isPlainObject('string')).toBe(false);
+    expect(isPlainObject(() => true)).toBe(false);
+    expect(isPlainObject([])).toBe(false);
+    expect(isPlainObject([1, 2, 3])).toBe(false);
+    expect(isPlainObject({ string: '1' })).toBe(true);
+    expect(isPlainObject(0.1)).toBe(false);
+    expect(isPlainObject(1)).toBe(false);
+    expect(isPlainObject(false)).toBe(false);
+    expect(isPlainObject(new Date())).toBe(false);
+    expect(isPlainObject(null)).toBe(false);
+    expect(isPlainObject(true)).toBe(false);
+    expect(isPlainObject(undefined)).toBe(false);
+  });
+
+  test('isInstance', () => {
+    class CustomError extends Error {}
+    // @ts-expect-error
+    expect(isInstance({}, {})).toBe(false);
+    expect(isInstance({}, Number)).toBe(false);
+    // @ts-expect-error
+    expect(isInstance(new CustomError(), {})).toBe(false);
+    expect(isInstance(new CustomError(), Error)).toBe(true);
+    expect(isInstance(new CustomError(), Number)).toBe(false);
+  });
+
+  test('isEnum', () => {
+    expect(isEnum(0, [1, 2])).toBe(false);
+    expect(isEnum(1, [1, 2])).toBe(true);
+    expect(isEnum('AB', ['AB', 'CD'])).toBe(true);
+    expect(isEnum('EF', ['AB', 'CD'])).toBe(false);
+    expect(isEnum('AB', { AB: 'AB', CD: 'CD' })).toBe(true);
+    expect(isEnum('EF', { AB: 'AB', CD: 'CD' })).toBe(false);
+    expect(isEnum('AB', new Set(['AB', 'CD']))).toBe(true);
+    expect(isEnum('EF', new Set(['AB', 'CD']))).toBe(false);
+    expect(isEnum('EF', null)).toBe(false);
+    expect(isEnum('EF', undefined)).toBe(false);
+    // @ts-expect-error
+    expect(isEnum('EF', 1)).toBe(false);
+    // @ts-expect-error
+    expect(isEnum('EF', 'string')).toBe(false);
+    // @ts-expect-error
+    expect(isEnum(false, 'string')).toBe(false);
+  });
+
+  test('isArrayOf', () => {
+    expect(isArrayOf(0.1, isNumber)).toBe(false);
+    expect(isArrayOf([0.1, 'string'], isNumber)).toBe(false);
+    expect(isArrayOf([0.1, 0.2], isNumber)).toBe(true);
+    expect(isArrayOf([0.1, 1, 2], isInteger)).toBe(false);
+    expect(isArrayOf([1, 2], isInteger)).toBe(true);
+  });
+
+  test('isPlainObjectOf', () => {
+    // @ts-expect-error
+    expect(isPlainObjectOf(0.1, isNumber)).toBe(false);
+    expect(isPlainObjectOf({ a: 0.1, b: 'string' }, isNumber)).toBe(false);
+    expect(isPlainObjectOf({ a: 0.1, b: 0.2 }, isNumber)).toBe(true);
+    expect(isPlainObjectOf({ a: 0.1, b: 1, c: 2 }, isInteger)).toBe(false);
+    expect(isPlainObjectOf({ a: 1, b: 2 }, isInteger)).toBe(true);
+  });
+
+  test('typeCheck', () => {
+    expect(() => typeCheck(0.1, isNumber)).not.toThrowError(TypeCheckError);
+    expect(() => typeCheck(-0.1, isPositiveInteger)).toThrowError(TypeCheckError);
+    expect(() => typeCheck('string', isNumber)).toThrowError(TypeCheckError);
+  });
+
+  test('typeCheckArray', () => {
+    expect(() => typeCheckArray([0.1], isNumber)).not.toThrowError(TypeCheckError);
+    expect(() => typeCheckArray(['string'], isNumber)).toThrowError(TypeCheckError);
+    // @ts-expect-error
+    expect(() => typeCheckArray(-0.1, isPositiveInteger)).toThrowError(TypeCheckError);
+    // @ts-expect-error
+    expect(() => typeCheckArray('string', isNumber)).toThrowError(TypeCheckError);
+  });
+
+  test('isAnyOf', () => {
+    expect(isAnyOf(isNumber, isNull)(1)).toBe(true);
+    expect(isAnyOf(isNumber, isNull)(null)).toBe(true);
+    expect(isAnyOf(isNumber, isNull)('string')).toBe(false);
+  });
+
+  test('refineValidator', () => {
+    expect(refineValidator(isNumber, (v) => v > 0)(-1)).toBe(false);
+    expect(refineValidator(isNumber, (v) => v > 0)(1)).toBe(true);
+    expect(refineValidator(isNumber, (v) => v > 0).name).toBe('isNumberRefined');
+  });
+
+  test('isRefinedExtensions', () => {
+    expect(isNumberLess(0)(-1.1)).toBe(true);
+    expect(isNumberLess(0)(0)).toBe(false);
+    expect(isNumberLessOrEqual(0)(0)).toBe(true);
+    expect(isNumberGreater(0)(0)).toBe(false);
+    expect(isNumberGreater(0)(1.1)).toBe(true);
+    expect(isNumberGreaterOrEqual(0)(0)).toBe(true);
+    expect(isNumberInRange(0, 1.1)(0)).toBe(true);
+    expect(isNumberInRange.name).toBe('isNumberInRange');
+
+    expect(isIntegerLess(0)(-1)).toBe(true);
+    expect(isIntegerLess(0)(0)).toBe(false);
+    expect(isIntegerLessOrEqual(0)(0)).toBe(true);
+    expect(isIntegerGreater(0)(0)).toBe(false);
+    expect(isIntegerGreater(0)(1)).toBe(true);
+    expect(isIntegerGreater(0)(1.1)).toBe(false);
+    expect(isIntegerGreaterOrEqual(0)(0)).toBe(true);
+    expect(isIntegerInRange(0, 1)(0)).toBe(true);
+    expect(isIntegerInRange(0, 1)(2)).toBe(false);
+
+    expect(isStringLengthEqual(1)('a')).toBe(true);
+    expect(isStringLengthEqual(1)('ab')).toBe(false);
+    expect(isStringLengthInRange(1, 2)('ab')).toBe(true);
+    expect(isStringLengthInRange(1, 2)('abc')).toBe(false);
+
+    expect(isArrayLengthEqual(1)([1])).toBe(true);
+    expect(isArrayLengthEqual(1)([1, 2])).toBe(false);
+    expect(isArrayLengthInRange(1, 2)([1, 2])).toBe(true);
+    expect(isArrayLengthInRange(1, 2)([1, 2, 3])).toBe(false);
+  });
+});

package/tsconfig.build.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "jsx": "react-jsx",
+    "module": "NodeNext",
+    "moduleResolution": "nodenext",
+    "types": ["node", "vitest/globals"],
+    "allowJs": true,
+    "checkJs": true,
+    "declaration": true,
+    "declarationMap": true,
+    "emitDeclarationOnly": true,
+    "declarationDir": "./types",
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "noImplicitAny": false,
+    "strictNullChecks": false,
+    "skipLibCheck": true
+  },
+  "include": ["./src/**/*"],
+  "exclude": ["./src/**/*.test.js"]
+}

package/types/index.d.ts

@@ -4,29 +4,19 @@ export * from "./pagelifecycle/const.js";
 export * from "./pagelifecycle/event.js";
 export * from "./pagelifecycle/typedef.js";
 export * from "./pagelifecycle/util.js";
+export * from "./util/async.js";
+export * from "./util/error.js";
+export * from "./util/number.js";
+export * from "./util/object.js";
+export * from "./util/query.js";
+export * from "./util/state.js";
+export * from "./util/string.js";
+export * from "./util/validate.js";
 export { AbstractLogHandler } from "./logging/AbstractLogHandler.js";
 export { ConsoleLogHandler } from "./logging/ConsoleLogHandler.js";
 export { Logger } from "./logging/Logger.js";
 export { OpenTelemetryLogHandler } from "./logging/OpenTelemetryLogHandler.js";
 export { SentryLogHandler } from "./logging/SentryLogHandler.js";
-export { addLeadingZero } from "./util/addLeadingZero.js";
-export { capitalize } from "./util/capitalize.js";
-export { deepMerge } from "./util/deepMerge.js";
-export { deg2rad } from "./util/deg2rad.js";
-export { delayPromise } from "./util/delayPromise.js";
-export { fixFloatPrecision } from "./util/fixFloatPrecision.js";
-export { getErrorDetails } from "./util/getErrorDetails.js";
-export { getObjValueByPath } from "./util/getObjValueByPath.js";
-export { getRandomInt } from "./util/getRandomInt.js";
-export { getURLParam } from "./util/getURLParam.js";
-export { loadJSON } from "./util/loadJSON.js";
-export { purgeObject } from "./util/purgeObject.js";
-export { sanitizeURLParam } from "./util/sanitizeURLParam.js";
-export { saveAsFile } from "./util/saveAsFile.js";
-export { serverDataToState } from "./util/serverDataToState.js";
-export { setObjValueByPath } from "./util/setObjValueByPath.js";
-export { underscoreToCamelCase } from "./util/underscoreToCamelCase.js";
 export { formatLogMessage, getLogLevelName } from "./logging/util.js";
-export { FetchError, fetchRetry, HTTP_0_ANY } from "./util/fetchRetry.js";
-export { addFloat, fixFloat, subFloat } from "./util/safeFloat.js";
+export { FetchError, fetchRetry, HTTP_0_ANY } from "./util/fetch.js";
 //# sourceMappingURL=index.d.ts.map

package/types/logging/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/logging/util.js"],"names":[],"mappings":"AAUO,yCANI,OAAO,aAAa,EAAE,MAAM,aAC5B,MAAM,SACN,MAAM,WACN,MAAM,GACJ,MAAM,CAE8F;AAO1G,uCAHI,MAAM,GACJ,MAAM,CAE6C;AAMzD,qCAFM,MAAM,CAmBlB"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/logging/util.js"],"names":[],"mappings":"AAYO,yCANI,OAAO,aAAa,EAAE,MAAM,aAC5B,MAAM,SACN,MAAM,WACN,MAAM,GACJ,MAAM,CAE8F;AAO1G,uCAHI,MAAM,GACJ,MAAM,CAE6C;AAMzD,qCAFM,MAAM,CAmBlB"}

package/types/pagelifecycle/util.d.ts

@@ -1,8 +1,8 @@
-export function addPageLifecycleCallback(state: import("./typedef.js").DocumentState | import("./typedef.js").PageLifecycleState, callback: () => void): void;
 export function initPageLifecycle(): void;
 export function getPageLifecycleState(): string | null | undefined;
 export function getDocumentState(): import("./typedef.js").DocumentState | null | undefined;
 export function getPageLifecycleEventEmitter(): EventEmitter;
 export function isPageLifecycleInitialized(): boolean;
+export function addPageLifecycleCallback(state: import("./typedef.js").DocumentState | import("./typedef.js").PageLifecycleState, callback: () => void): void;
 import { EventEmitter } from 'eventemitter3';
 //# sourceMappingURL=util.d.ts.map

package/types/pagelifecycle/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/util.js"],"names":[],"mappings":"AAsCO,gDAHI,OAAO,cAAc,EAAE,aAAa,GAAG,OAAO,cAAc,EAAE,kBAAkB,YAChF,MAAM,IAAI,QAMpB;AAgEM,0CAyBN;AAMM,yCAFM,MAAM,GAAG,IAAI,GAAG,SAAS,CAIrC;AAMM,oCAFM,OAAO,cAAc,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,CAInE;AAMM,gDAFM,YAAY,CAOxB;AAMM,8CAFM,OAAO,CAInB;6BAjK4B,eAAe"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/util.js"],"names":[],"mappings":"AAiGO,0CAyBN;AAMM,yCAFM,MAAM,GAAG,IAAI,GAAG,SAAS,CAE8B;AAM7D,oCAFM,OAAO,cAAc,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,CAEV;AAMnD,gDAFM,YAAY,CAOxB;AAMM,8CAFM,OAAO,CAEyC;AAOtD,gDAHI,OAAO,cAAc,EAAE,aAAa,GAAG,OAAO,cAAc,EAAE,kBAAkB,YAChF,MAAM,IAAI,QAMpB;6BA3J4B,eAAe"}

package/types/util/async.d.ts

@@ -0,0 +1,3 @@
+export function delayPromise(delayMS: number): Promise<void>;
+export function loadJSON(url: string): Promise<string>;
+//# sourceMappingURL=async.d.ts.map

package/types/util/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/util/async.js"],"names":[],"mappings":"AAKO,sCAHI,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAKtB;AAOG,8BAHI,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAM3B"}

package/types/util/{getErrorDetails.d.ts → error.d.ts}

@@ -1,2 +1,2 @@
 export function getErrorDetails(error: Error, excludes?: string[]): object;
-//# sourceMappingURL=getErrorDetails.d.ts.map
+//# sourceMappingURL=error.d.ts.map

package/types/util/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/util/error.js"],"names":[],"mappings":"AAMO,uCAJI,KAAK,aACL,MAAM,EAAE,GACN,MAAM,CAmBlB"}

package/types/util/{fetchRetry.d.ts → fetch.d.ts}

@@ -18,4 +18,4 @@ export function fetchRetry(resource: string | URL | Request, fetchOptions: Reque
     statusExcludes?: number[];
     timeout?: number;
 }): Promise<Response>;
-//# sourceMappingURL=fetchRetry.d.ts.map
+//# sourceMappingURL=fetch.d.ts.map

package/types/util/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/util/fetch.js"],"names":[],"mappings":"AAcA,yBAA0B,CAAC,CAAC;AAE5B;IACE;;;;;;OAMG;IACH,qBALW,MAAM,YACN,MAAM,GAAG,GAAG,GAAG,OAAO,gBACtB,WAAW,YACX,QAAQ,EAQlB;IAHC,iCAAwB;IACxB,0BAAgC;IAChC,mBAAwB;CAE3B;AASM,qCALI,MAAM,GAAG,GAAG,GAAG,OAAO,gBACtB,WAAW,iBACX;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC9E,OAAO,CAAC,QAAQ,CAAC,CAgD7B"}

package/types/util/number.d.ts

@@ -0,0 +1,13 @@
+export function deg2rad(deg: number): number;
+export function getRandomInt(min: number, max: number): number;
+export function fixFloatPrecision(value: number | string): number;
+export function fixFloat(value: number, p?: number): number;
+export function addFloat(a: number, b: number): number;
+export function subFloat(a: number, b: number): number;
+export function isGt(value: number, min: number): boolean;
+export function isGtOrEq(value: number, min: number): boolean;
+export function isLe(value: number, min: number): boolean;
+export function isLeOrEq(value: number, min: number): boolean;
+export function isInRange(value: number, min: number, max: number): boolean;
+export function isEq(value: number, expected: number): boolean;
+//# sourceMappingURL=number.d.ts.map

package/types/util/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/util/number.js"],"names":[],"mappings":"AAKO,6BAHI,MAAM,GACJ,MAAM,CAEkC;AAQ9C,kCAJI,MAAM,OACN,MAAM,GACJ,MAAM,CAEwE;AAOpF,yCAHI,MAAM,GAAG,MAAM,GACb,MAAM,CAYlB;AAQM,gCAJI,MAAM,MACN,MAAM,GACJ,MAAM,CAE0D;AAQtE,4BAJI,MAAM,KACN,MAAM,GACJ,MAAM,CAKlB;AAQM,4BAJI,MAAM,KACN,MAAM,GACJ,MAAM,CAKlB;AASM,4BALI,MAAM,OACN,MAAM,GACJ,OAAO,CAG2B;AASxC,gCALI,MAAM,OACN,MAAM,GACJ,OAAO,CAGgC;AAS7C,4BALI,MAAM,OACN,MAAM,GACJ,OAAO,CAG2B;AASxC,gCALI,MAAM,OACN,MAAM,GACJ,OAAO,CAGgC;AAU7C,iCANI,MAAM,OACN,MAAM,OACN,MAAM,GACJ,OAAO,CAGsD;AASnE,4BALI,MAAM,YACN,MAAM,GACJ,OAAO,CAGuC"}

package/types/util/object.d.ts

@@ -0,0 +1,6 @@
+export function purgeObject(target: object): void;
+export function deepMerge(target: object, source: object): object;
+export function getObjArrayPropSum(arr: object[], prop: string): number;
+export function getObjValueByPath(obj: object, path: string): object | null;
+export function setObjValueByPath(obj: object, path: string, value: object | null | undefined): void;
+//# sourceMappingURL=object.d.ts.map

package/types/util/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/util/object.js"],"names":[],"mappings":"AAIO,oCAFI,MAAM,QAUhB;AAQM,kCAJI,MAAM,UACN,MAAM,GACJ,MAAM,CAuBlB;AAQM,wCAJI,MAAM,EAAE,QACR,MAAM,GACJ,MAAM,CAEgG;AAO5G,uCAJI,MAAM,QACN,MAAM,GACJ,MAAM,GAAG,IAAI,CAezB;AASM,uCALI,MAAM,QACN,MAAM,SACN,MAAM,GAAG,IAAI,GAAG,SAAS,QAqBnC"}

package/types/util/{getURLParam.d.ts → query.d.ts}

@@ -1,2 +1,3 @@
+export function sanitizeURLParam(input: string): string;
 export function getURLParam<T>(key: string, defaultValue?: T, isSanitize?: boolean): string | T;
-//# sourceMappingURL=getURLParam.d.ts.map
+//# sourceMappingURL=query.d.ts.map

package/types/util/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/util/query.js"],"names":[],"mappings":"AAOO,wCAHI,MAAM,GACJ,MAAM,CAOlB;AAUM,4BANM,CAAC,OACH,MAAM,iBACN,CAAC,eACD,OAAO,GACL,MAAM,GAAG,CAAC,CAWtB"}

package/types/util/{serverDataToState.d.ts → state.d.ts}

@@ -1,2 +1,2 @@
 export function serverDataToState(data: object, isRecursive?: boolean): object;
-//# sourceMappingURL=serverDataToState.d.ts.map
+//# sourceMappingURL=state.d.ts.map

package/types/util/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/util/state.js"],"names":[],"mappings":"AAQO,wCAJI,MAAM,gBACN,OAAO,GACL,MAAM,CAiBlB"}

package/types/util/string.d.ts

@@ -0,0 +1,5 @@
+export function addLeadingZero(value: number | string | null | undefined, size?: number): string | null;
+export function capitalize(value: string | null | undefined): string | null;
+export function underscoreToCamelCase(value: string): string;
+export function saveAsFile(filename: string, text: string): void;
+//# sourceMappingURL=string.d.ts.map

package/types/util/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/util/string.js"],"names":[],"mappings":"AAMO,sCAJI,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,SAClC,MAAM,GACJ,MAAM,GAAG,IAAI,CAWzB;AAOM,kCAHI,MAAM,GAAG,IAAI,GAAG,SAAS,GACvB,MAAM,GAAG,IAAI,CAWzB;AAOM,6CAHI,MAAM,GACJ,MAAM,CAEmF;AAO/F,qCAHI,MAAM,QACN,MAAM,QAUhB"}

package/types/util/validate.d.ts

@@ -0,0 +1,54 @@
+export function isBoolean(value: unknown): value is boolean;
+export function isFunction(value: unknown): value is (...args: any[]) => any;
+export function isNumber(value: unknown): value is number;
+export function isPositiveNumber(value: unknown): value is number;
+export function isNonNegativeNumber(value: unknown): value is number;
+export function isInteger(value: unknown): value is number;
+export function isPositiveInteger(value: unknown): value is number;
+export function isNonNegativeInteger(value: unknown): value is number;
+export function isString(value: unknown): value is string;
+export function isArray<T>(value: unknown): value is T[];
+export function isNull(value: unknown): value is null;
+export function isUndefined(value: unknown): value is undefined;
+export function isNullOrUndefined(value: unknown): value is null | undefined;
+export function isPlainObject(value: unknown): value is Record<string, unknown>;
+export function isInstance<T>(value: unknown, type: new (...args: any[]) => T): value is T;
+export function isEnum(value: unknown, choices: unknown[] | Set<string | number> | Record<string | number, unknown>): boolean;
+export function isArrayOf<T>(values: unknown, validator: (value: unknown) => value is T): values is T[];
+export function isPlainObjectOf<T>(record: Record<string | number, unknown>, validator: (value: unknown) => value is T): record is Record<string | number, T>;
+export function refineValidator<T>(base: (value: unknown) => value is T, predicate: (value: T) => boolean, name?: string | null): (value: unknown) => value is T;
+export function isAnyOf<A, B>(a: (value: unknown) => value is A, b: (value: unknown) => value is B): (value: unknown) => value is A | B;
+export function isNumberGreater(min: any): (value: unknown) => value is number;
+export function isNumberGreaterOrEqual(min: any): (value: unknown) => value is number;
+export function isNumberLess(min: any): (value: unknown) => value is number;
+export function isNumberLessOrEqual(min: any): (value: unknown) => value is number;
+export function isNumberInRange(min: any, max: any): (value: unknown) => value is number;
+export function isNumberEqual(expected: any): (value: unknown) => value is number;
+export function isIntegerGreater(min: any): (value: unknown) => value is number;
+export function isIntegerGreaterOrEqual(min: any): (value: unknown) => value is number;
+export function isIntegerLess(min: any): (value: unknown) => value is number;
+export function isIntegerLessOrEqual(min: any): (value: unknown) => value is number;
+export function isIntegerInRange(min: any, max: any): (value: unknown) => value is number;
+export function isIntegerEqual(expected: any): (value: unknown) => value is number;
+export function isStringLengthGreater(min: any): (value: unknown) => value is string;
+export function isStringLengthGreaterOrEqual(min: any): (value: unknown) => value is string;
+export function isStringLengthLess(min: any): (value: unknown) => value is string;
+export function isStringLengthLessOrEqual(min: any): (value: unknown) => value is string;
+export function isStringLengthInRange(min: any, max: any): (value: unknown) => value is string;
+export function isStringLengthEqual(expected: any): (value: unknown) => value is string;
+export function isArrayLengthGreater(min: any): (value: unknown) => value is unknown[];
+export function isArrayLengthGreaterOrEqual(min: any): (value: unknown) => value is unknown[];
+export function isArrayLengthLess(min: any): (value: unknown) => value is unknown[];
+export function isArrayLengthLessOrEqual(min: any): (value: unknown) => value is unknown[];
+export function isArrayLengthInRange(min: any, max: any): (value: unknown) => value is unknown[];
+export function isArrayLengthEqual(expected: any): (value: unknown) => value is unknown[];
+export class TypeCheckError extends TypeError {
+    /**
+     * Creates a new `TypeCheckError` instance.
+     * @param {string} message - Error message.
+     */
+    constructor(message: string);
+}
+export function typeCheck<T>(value: unknown, validator: (value: unknown) => value is T): T;
+export function typeCheckArray<T>(value: unknown[], validator: (value: unknown) => value is T): T[];
+//# sourceMappingURL=validate.d.ts.map

package/types/util/validate.d.ts.map

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

package/src/util/addLeadingZero.js

@@ -1,16 +0,0 @@
-/**
- * Add leading zeros to a value to ensure it has a minimum width.
- * @param {number | string | null | undefined} value - The value to pad with leading zeros.
- * @param {number} size - The minimum width of the resulting string.
- * @returns {string | null} The value padded with leading zeros or null if the input is null/undefined.
- */
-export const addLeadingZero = (value, size = 2) => {
-  if (value === null || value === undefined) {
-    return null;
-  }
-  value = value.toString();
-  while (value.length < size) {
-    value = `0${value}`;
-  }
-  return value;
-};

package/src/util/addLeadingZero.test.js

@@ -1,11 +0,0 @@
-import { addLeadingZero } from './addLeadingZero.js';
-
-test('Tests add leading zero', () => {
-  expect(addLeadingZero(1)).toBe('01');
-  expect(addLeadingZero('1')).toBe('01');
-  expect(addLeadingZero(1, 3)).toBe('001');
-  expect(addLeadingZero('21')).toBe('21');
-  expect(addLeadingZero(21)).toBe('21');
-  expect(addLeadingZero(null)).toBe(null);
-  expect(addLeadingZero()).toBe(null);
-});

package/src/util/capitalize.js

@@ -1,15 +0,0 @@
-/**
- * Capitalize a string.
- * @param {string | null | undefined} value - The input string to capitalize.
- * @returns {string | null} The capitalized string or null if the input is null/undefined.
- */
-export const capitalize = (value) => {
-  if (value === null || value === undefined) {
-    return null;
-  }
-  if (!value || value?.length === 0) {
-    return value;
-  }
-  const normValue = value.toLowerCase();
-  return normValue.charAt(0).toUpperCase() + normValue.slice(1);
-};

package/src/util/deepMerge.js

@@ -1,24 +0,0 @@
-/**
- * Merge two objects.
- * @param {object} target - Target merge object.
- * @param {object} source - Source merge object.
- * @returns {object} Merged result object.
- */
-export const deepMerge = (target, source) => {
-  if (typeof target !== 'object' || target === null) return source;
-  if (typeof source !== 'object' || source === null) return target;
-
-  for (const key of Object.keys(source)) {
-    if (key === '__proto__' || key === 'constructor') continue;
-    if (typeof source[key] === 'object' && source[key] !== null) {
-      if (!target[key] || typeof target[key] !== 'object') {
-        target[key] = {};
-      }
-      deepMerge(target[key], source[key]);
-    } else {
-      target[key] = source[key];
-    }
-  }
-
-  return target;
-};