tiny-essentials 1.9.2 → 1.10.1

package/dist/v1/basics/index.mjs

@@ -2,7 +2,7 @@ import arraySortPositions from '../../legacy/libs/arraySortPositions.mjs';
 import asyncReplace from '../../legacy/libs/replaceAsync.mjs';
 import { shuffleArray } from './array.mjs';
 import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration } from './clock.mjs';
-import { countObj, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, } from './objFilter.mjs';
+import { countObj, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, isJsonObject, } from './objFilter.mjs';
 import { formatBytes, getAge, getSimplePerc, ruleOfThree } from './simpleMath.mjs';
 import { addAiMarkerShortcut, toTitleCase, toTitleCaseLowerFirst } from './text.mjs';
-export { arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/basics/objFilter.cjs

@@ -214,6 +214,28 @@ function countObj(obj) {
   return 0;
 }
 
+/**
+ * Determines whether a given value is a pure JSON object (plain object).
+ *
+ * A pure object satisfies the following:
+ * - It is not null.
+ * - Its type is "object".
+ * - Its internal [[Class]] is "[object Object]".
+ * - It is not an instance of built-in types like Array, Date, Map, Set, etc.
+ *
+ * This function is useful for strict data validation when you want to ensure
+ * a value is a clean JSON-compatible object, free of class instances or special types.
+ *
+ * @param {unknown} value - The value to test.
+ * @returns {value is Record<unknown, unknown>} Returns true if the value is a pure object.
+ */
+function isJsonObject(value) {
+  if (value === null || typeof value !== 'object') return false;
+  if (Array.isArray(value)) return false;
+  if (Object.prototype.toString.call(value) !== '[object Object]') return false;
+  return true;
+}
+
 // Insert obj types
 
 extendObjType([
@@ -297,27 +319,27 @@ extendObjType([
   ],
   [
     'map',
-    /** @param {*} val @returns {val is Map<any, any>} */
+    /** @param {*} val @returns {val is Map<unknown, unknown>} */
     (val) => val instanceof Map,
   ],
   [
     'set',
-    /** @param {*} val @returns {val is Set<any>} */
+    /** @param {*} val @returns {val is Set<unknown>} */
     (val) => val instanceof Set,
   ],
   [
     'weakmap',
-    /** @param {*} val @returns {val is WeakMap<any, any>} */
+    /** @param {*} val @returns {val is WeakMap<unknown, unknown>} */
     (val) => val instanceof WeakMap,
   ],
   [
     'weakset',
-    /** @param {*} val @returns {val is WeakSet<any>} */
+    /** @param {*} val @returns {val is WeakSet<unknown>} */
     (val) => val instanceof WeakSet,
   ],
   [
     'promise',
-    /** @param {*} val @returns {val is Promise<any>} */
+    /** @param {*} val @returns {val is Promise<unknown>} */
     (val) => val instanceof Promise,
   ],
 ]);
@@ -335,8 +357,8 @@ if (isBrowser) {
 extendObjType([
   [
     'object',
-    /** @param {*} val @returns {val is object} */
-    (val) => typeof val === 'object' && val !== null && !Array.isArray(val),
+    /** @param {*} val @returns {val is Record<unknown, unknown>} */
+    (val) => isJsonObject(val),
   ],
 ]);
 
@@ -345,5 +367,6 @@ exports.cloneObjTypeOrder = cloneObjTypeOrder;
 exports.countObj = countObj;
 exports.extendObjType = extendObjType;
 exports.getCheckObj = getCheckObj;
+exports.isJsonObject = isJsonObject;
 exports.objType = objType;
 exports.reorderObjTypeOrder = reorderObjTypeOrder;

package/dist/v1/basics/objFilter.d.mts

@@ -88,6 +88,22 @@ export function getCheckObj(): {
  * countObj('not an object'); // 0
  */
 export function countObj(obj: Array<any> | Record<string | number, any>): number;
+/**
+ * Determines whether a given value is a pure JSON object (plain object).
+ *
+ * A pure object satisfies the following:
+ * - It is not null.
+ * - Its type is "object".
+ * - Its internal [[Class]] is "[object Object]".
+ * - It is not an instance of built-in types like Array, Date, Map, Set, etc.
+ *
+ * This function is useful for strict data validation when you want to ensure
+ * a value is a clean JSON-compatible object, free of class instances or special types.
+ *
+ * @param {unknown} value - The value to test.
+ * @returns {value is Record<unknown, unknown>} Returns true if the value is a pure object.
+ */
+export function isJsonObject(value: unknown): value is Record<unknown, unknown>;
 export type ExtendObjType = {
     [x: string]: (val: any) => any;
 };

package/dist/v1/basics/objFilter.mjs

@@ -197,6 +197,30 @@ export function countObj(obj) {
     // Nothing
     return 0;
 }
+/**
+ * Determines whether a given value is a pure JSON object (plain object).
+ *
+ * A pure object satisfies the following:
+ * - It is not null.
+ * - Its type is "object".
+ * - Its internal [[Class]] is "[object Object]".
+ * - It is not an instance of built-in types like Array, Date, Map, Set, etc.
+ *
+ * This function is useful for strict data validation when you want to ensure
+ * a value is a clean JSON-compatible object, free of class instances or special types.
+ *
+ * @param {unknown} value - The value to test.
+ * @returns {value is Record<unknown, unknown>} Returns true if the value is a pure object.
+ */
+export function isJsonObject(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    if (Array.isArray(value))
+        return false;
+    if (Object.prototype.toString.call(value) !== '[object Object]')
+        return false;
+    return true;
+}
 // Insert obj types
 extendObjType([
     [
@@ -276,27 +300,27 @@ extendObjType([
     ],
     [
         'map',
-        /** @param {*} val @returns {val is Map<any, any>} */
+        /** @param {*} val @returns {val is Map<unknown, unknown>} */
         (val) => val instanceof Map,
     ],
     [
         'set',
-        /** @param {*} val @returns {val is Set<any>} */
+        /** @param {*} val @returns {val is Set<unknown>} */
         (val) => val instanceof Set,
     ],
     [
         'weakmap',
-        /** @param {*} val @returns {val is WeakMap<any, any>} */
+        /** @param {*} val @returns {val is WeakMap<unknown, unknown>} */
         (val) => val instanceof WeakMap,
     ],
     [
         'weakset',
-        /** @param {*} val @returns {val is WeakSet<any>} */
+        /** @param {*} val @returns {val is WeakSet<unknown>} */
         (val) => val instanceof WeakSet,
     ],
     [
         'promise',
-        /** @param {*} val @returns {val is Promise<any>} */
+        /** @param {*} val @returns {val is Promise<unknown>} */
         (val) => val instanceof Promise,
     ],
 ]);
@@ -312,7 +336,7 @@ if (isBrowser) {
 extendObjType([
     [
         'object',
-        /** @param {*} val @returns {val is object} */
-        (val) => typeof val === 'object' && val !== null && !Array.isArray(val),
+        /** @param {*} val @returns {val is Record<unknown, unknown>} */
+        (val) => isJsonObject(val),
     ],
 ]);

package/dist/v1/index.cjs

@@ -26,6 +26,7 @@ exports.checkObj = objFilter.checkObj;
 exports.cloneObjTypeOrder = objFilter.cloneObjTypeOrder;
 exports.countObj = objFilter.countObj;
 exports.extendObjType = objFilter.extendObjType;
+exports.isJsonObject = objFilter.isJsonObject;
 exports.objType = objFilter.objType;
 exports.reorderObjTypeOrder = objFilter.reorderObjTypeOrder;
 exports.formatBytes = simpleMath.formatBytes;

package/dist/v1/index.d.mts

@@ -2,6 +2,7 @@ import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyLevelUp from '../legacy/libs/userLevel.mjs';
+import { isJsonObject } from './basics/objFilter.mjs';
 import arraySortPositions from '../legacy/libs/arraySortPositions.mjs';
 import { formatBytes } from './basics/simpleMath.mjs';
 import { addAiMarkerShortcut } from './basics/text.mjs';
@@ -22,5 +23,5 @@ import { getTimeDuration } from './basics/clock.mjs';
 import { shuffleArray } from './basics/array.mjs';
 import { toTitleCase } from './basics/text.mjs';
 import { toTitleCaseLowerFirst } from './basics/text.mjs';
-export { TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/index.mjs

@@ -3,10 +3,10 @@ import TinyLevelUp from '../legacy/libs/userLevel.mjs';
 import arraySortPositions from '../legacy/libs/arraySortPositions.mjs';
 import { shuffleArray } from './basics/array.mjs';
 import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './basics/clock.mjs';
-import { countObj, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, } from './basics/objFilter.mjs';
+import { countObj, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, isJsonObject, } from './basics/objFilter.mjs';
 import { formatBytes, getAge, getSimplePerc, ruleOfThree } from './basics/simpleMath.mjs';
 import { addAiMarkerShortcut, toTitleCase, toTitleCaseLowerFirst } from './basics/text.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
-export { TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };