@cyberskill/shared 2.20.0 → 2.25.0

package/dist/util/common/common.util.d.ts

@@ -4,6 +4,9 @@ import { I_EnvFlags, I_NodeEnvInput } from './common.type.js';
  * This function normalizes the input string and creates a regex pattern that can match
  * both the original characters and their accented equivalents.
  *
+ * Optimization: Uses pre-computed regex and map to perform replacement in a single pass (O(N)),
+ * instead of iterating through all character groups (O(K*N)).
+ *
  * @param str - The string to convert to a regex pattern.
  * @returns The regex pattern as a string that matches the original string and its accented variations.
  */

package/dist/util/common/common.util.js

@@ -1,14 +1,13 @@
-import u from "unorm";
 import { E_Environment as t } from "../../typescript/common.type.js";
-var O = Object.defineProperty, p = Object.getOwnPropertySymbols, f = Object.prototype.hasOwnProperty, m = Object.prototype.propertyIsEnumerable, i = (e, r, n) => r in e ? O(e, r, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[r] = n, E = (e, r) => {
-  for (var n in r || (r = {}))
-    f.call(r, n) && i(e, n, r[n]);
+var f = Object.defineProperty, p = Object.getOwnPropertySymbols, m = Object.prototype.hasOwnProperty, _ = Object.prototype.propertyIsEnumerable, i = (r, e, n) => e in r ? f(r, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : r[e] = n, s = (r, e) => {
+  for (var n in e || (e = {}))
+    m.call(e, n) && i(r, n, e[n]);
   if (p)
-    for (var n of p(r))
-      m.call(r, n) && i(e, n, r[n]);
-  return e;
+    for (var n of p(e))
+      _.call(e, n) && i(r, n, e[n]);
+  return r;
 };
-const s = {
+const E = {
   a: ["à", "á", "ạ", "ả", "ã", "â", "ầ", "ấ", "ậ", "ẩ", "ẫ", "ă", "ằ", "ắ", "ặ", "ẳ", "ẵ"],
   e: ["è", "é", "ẹ", "ẻ", "ẽ", "ê", "ề", "ế", "ệ", "ể", "ễ"],
   i: ["ì", "í", "ị", "ỉ", "ĩ"],
@@ -16,41 +15,42 @@ const s = {
   u: ["ù", "ú", "ụ", "ủ", "ũ", "ư", "ừ", "ứ", "ự", "ử", "ữ"],
   y: ["ỳ", "ý", "ỵ", "ỷ", "ỹ"],
   d: ["đ"]
-}, _ = Object.entries(s).reduce(
-  (e, [r, n]) => (e[r.toUpperCase()] = n.map((o) => o.toUpperCase()), e),
+}, D = Object.entries(E).reduce(
+  (r, [e, n]) => (r[e.toUpperCase()] = n.map((o) => o.toUpperCase()), r),
   {}
-);
-function P(e) {
-  e = u.nfkc(e);
-  const r = E(E({}, s), _);
-  for (const [n, o] of Object.entries(r)) {
-    const a = `[${n}${o.join("")}]`, c = `(${[n, ...o].join("|")})`;
-    e = e.replace(new RegExp(a, "g"), c);
-  }
-  return e;
+), N = s(s({}, E), D), u = /* @__PURE__ */ new Map(), O = /* @__PURE__ */ new Set();
+Object.entries(N).forEach(([r, e]) => {
+  const n = `(${[r, ...e].join("|")})`;
+  [r, ...e].forEach((o) => {
+    u.set(o, n), O.add(o);
+  });
+});
+const l = Array.from(O).join(""), P = new RegExp(`[${l}]`, "g");
+function d(r) {
+  return r = r.normalize("NFD"), r.replace(P, (e) => u.get(e) || e);
 }
-function l(e) {
-  return e.normalize("NFD").replace(new RegExp("\\p{Diacritic}", "gu"), "");
+function g(r) {
+  return r.normalize("NFD").replace(new RegExp("\\p{Diacritic}", "gu"), "");
 }
-function v(e, r) {
-  if (!r)
-    return Array.from(new Set(e));
+function w(r, e) {
+  if (!e)
+    return Array.from(new Set(r));
   const n = /* @__PURE__ */ new Set(), o = [];
-  for (const a of e) {
-    const c = r(a);
-    n.has(c) || (n.add(c), o.push(a));
+  for (const c of r) {
+    const a = e(c);
+    n.has(a) || (n.add(a), o.push(c));
   }
   return o;
 }
-function d(e) {
-  const { NODE_ENV: r = t.DEVELOPMENT, NODE_ENV_MODE: n = t.DEVELOPMENT } = e, o = r === t.DEVELOPMENT && n === t.DEVELOPMENT, a = r === t.PRODUCTION && n === t.STAGING, c = r === t.PRODUCTION && n === t.PRODUCTION;
-  if (r === t.PRODUCTION && n === t.DEVELOPMENT)
+function S(r) {
+  const { NODE_ENV: e = t.DEVELOPMENT, NODE_ENV_MODE: n = t.DEVELOPMENT } = r, o = e === t.DEVELOPMENT && n === t.DEVELOPMENT, c = e === t.PRODUCTION && n === t.STAGING, a = e === t.PRODUCTION && n === t.PRODUCTION;
+  if (e === t.PRODUCTION && n === t.DEVELOPMENT)
     throw new Error("NODE_ENV_MODE must be set to staging or production in production environment");
-  return { IS_DEV: o, IS_STAG: a, IS_PROD: c };
+  return { IS_DEV: o, IS_STAG: c, IS_PROD: a };
 }
 export {
-  d as mapEnvironment,
-  P as regexSearchMapper,
-  l as removeAccent,
-  v as uniqueArray
+  S as mapEnvironment,
+  d as regexSearchMapper,
+  g as removeAccent,
+  w as uniqueArray
 };

package/dist/util/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./common/common.util.cjs"),e=require("./object/object.util.cjs"),a=require("./serializer/serializer.util.cjs"),r=require("./string/string.util.cjs"),i=require("./validate/validate.util.cjs");exports.mapEnvironment=t.mapEnvironment;exports.regexSearchMapper=t.regexSearchMapper;exports.removeAccent=t.removeAccent;exports.uniqueArray=t.uniqueArray;exports.deepMerge=e.deepMerge;exports.getNestedValue=e.getNestedValue;exports.isJSON=e.isJSON;exports.normalizeMongoFilter=e.normalizeMongoFilter;exports.setNestedValue=e.setNestedValue;exports.serializer=a.serializer;exports.generateRandomPassword=r.generateRandomPassword;exports.generateShortId=r.generateShortId;exports.generateSlug=r.generateSlug;exports.getFileName=r.getFileName;exports.substringBetween=r.substringBetween;exports.validate=i.validate;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./common/common.util.cjs"),e=require("./object/object.util.cjs"),a=require("./serializer/serializer.util.cjs"),r=require("./string/string.util.cjs"),i=require("./validate/validate.util.cjs");exports.mapEnvironment=t.mapEnvironment;exports.regexSearchMapper=t.regexSearchMapper;exports.removeAccent=t.removeAccent;exports.uniqueArray=t.uniqueArray;exports.deepClone=e.deepClone;exports.deepMerge=e.deepMerge;exports.getNestedValue=e.getNestedValue;exports.isJSON=e.isJSON;exports.normalizeMongoFilter=e.normalizeMongoFilter;exports.setNestedValue=e.setNestedValue;exports.serializer=a.serializer;exports.generateRandomPassword=r.generateRandomPassword;exports.generateShortId=r.generateShortId;exports.generateSlug=r.generateSlug;exports.getFileName=r.getFileName;exports.substringBetween=r.substringBetween;exports.validate=i.validate;

package/dist/util/index.js

@@ -1,23 +1,24 @@
 import { mapEnvironment as t, regexSearchMapper as o, removeAccent as a, uniqueArray as n } from "./common/common.util.js";
-import { deepMerge as g, getNestedValue as i, isJSON as p, normalizeMongoFilter as s, setNestedValue as l } from "./object/object.util.js";
-import { serializer as u } from "./serializer/serializer.util.js";
-import { generateRandomPassword as f, generateShortId as N, generateSlug as S, getFileName as c, substringBetween as v } from "./string/string.util.js";
-import { validate as h } from "./validate/validate.util.js";
+import { deepClone as g, deepMerge as i, getNestedValue as p, isJSON as l, normalizeMongoFilter as s, setNestedValue as d } from "./object/object.util.js";
+import { serializer as x } from "./serializer/serializer.util.js";
+import { generateRandomPassword as N, generateShortId as S, generateSlug as c, getFileName as v, substringBetween as M } from "./string/string.util.js";
+import { validate as w } from "./validate/validate.util.js";
 export {
-  g as deepMerge,
-  f as generateRandomPassword,
-  N as generateShortId,
-  S as generateSlug,
-  c as getFileName,
-  i as getNestedValue,
-  p as isJSON,
+  g as deepClone,
+  i as deepMerge,
+  N as generateRandomPassword,
+  S as generateShortId,
+  c as generateSlug,
+  v as getFileName,
+  p as getNestedValue,
+  l as isJSON,
   t as mapEnvironment,
   s as normalizeMongoFilter,
   o as regexSearchMapper,
   a as removeAccent,
-  u as serializer,
-  l as setNestedValue,
-  v as substringBetween,
+  x as serializer,
+  d as setNestedValue,
+  M as substringBetween,
   n as uniqueArray,
-  h as validate
+  w as validate
 };

package/dist/util/object/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./object.util.cjs");exports.deepMerge=e.deepMerge;exports.getNestedValue=e.getNestedValue;exports.isJSON=e.isJSON;exports.normalizeMongoFilter=e.normalizeMongoFilter;exports.setNestedValue=e.setNestedValue;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./object.util.cjs");exports.deepClone=e.deepClone;exports.deepMerge=e.deepMerge;exports.getNestedValue=e.getNestedValue;exports.isJSON=e.isJSON;exports.normalizeMongoFilter=e.normalizeMongoFilter;exports.setNestedValue=e.setNestedValue;

package/dist/util/object/index.js

@@ -1,8 +1,9 @@
-import { deepMerge as o, getNestedValue as r, isJSON as l, normalizeMongoFilter as s, setNestedValue as a } from "./object.util.js";
+import { deepClone as t, deepMerge as l, getNestedValue as r, isJSON as d, normalizeMongoFilter as s, setNestedValue as a } from "./object.util.js";
 export {
-  o as deepMerge,
+  t as deepClone,
+  l as deepMerge,
   r as getNestedValue,
-  l as isJSON,
+  d as isJSON,
   s as normalizeMongoFilter,
   a as setNestedValue
 };

package/dist/util/object/object.test.unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/util/object/object.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("lodash-es");var g=Object.defineProperty,v=Object.defineProperties,O=Object.getOwnPropertyDescriptors,a=Object.getOwnPropertySymbols,b=Object.prototype.hasOwnProperty,h=Object.prototype.propertyIsEnumerable,u=(r,e,t)=>e in r?g(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t,l=(r,e)=>{for(var t in e||(e={}))b.call(e,t)&&u(r,t,e[t]);if(a)for(var t of a(e))h.call(e,t)&&u(r,t,e[t]);return r},c=(r,e)=>v(r,O(e));function _(r){try{return JSON.parse(r),!0}catch(e){return!1}}function j(r,e){return e.reduce((t,n)=>{if(t&&typeof t=="object"&&n in t)return t[n]},r)}function f(r,e,t){if(e.length===0)return r;const[n,...o]=e;if(o.length===0)return c(l({},r),{[n]:t});const s=r[n];return c(l({},r),{[n]:f(typeof s=="object"&&s!==null?s:{},o,t)})}function w(...r){if(r.length===0)return{};const e=r.filter(o=>o!=null).map(o=>typeof o!="object"?{}:o);if(e.length===0)return{};if(e.length===1)return e[0];if(e.every(i.isArray))return[].concat(...e);if(e.every(o=>typeof o=="object"&&o!==null&&!i.isArray(o)))return i.mergeWith({},...e,(o,s)=>{if(i.isArray(o)&&i.isArray(s))return o.concat(s)});if(e.every(o=>typeof o!="object"||o===null))throw new Error("deepMerge: Cannot merge primitive values. All arguments must be objects or arrays.");const t=e.some(i.isArray),n=e.some(o=>typeof o=="object"&&o!==null&&!i.isArray(o));throw t&&n?new Error("deepMerge: Cannot mix arrays and objects. All arguments must be either arrays or objects."):new Error("deepMerge: Invalid arguments provided. All arguments must be objects or arrays of the same type.")}function p(r){if(!r||typeof r!="object")return r;const e={};for(const[t,n]of Object.entries(r))if(n&&typeof n=="object"&&!Array.isArray(n))if(Object.keys(n).some(s=>s.startsWith("$")))e[t]=n;else{const s=p(n);for(const[y,d]of Object.entries(s)){const m=`${t}.${y}`;e[m]=d}}else e[t]=n;return e}exports.deepMerge=w;exports.getNestedValue=j;exports.isJSON=_;exports.normalizeMongoFilter=p;exports.setNestedValue=f;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var m=Object.defineProperty,A=Object.defineProperties,v=Object.getOwnPropertyDescriptors,u=Object.getOwnPropertySymbols,h=Object.prototype.hasOwnProperty,w=Object.prototype.propertyIsEnumerable,y=(e,r,n)=>r in e?m(e,r,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[r]=n,p=(e,r)=>{for(var n in r||(r={}))h.call(r,n)&&y(e,n,r[n]);if(u)for(var n of u(r))w.call(r,n)&&y(e,n,r[n]);return e},O=(e,r)=>A(e,v(r));function P(e){try{return JSON.parse(e),!0}catch(r){return!1}}function _(e,r){let n=e;const o=r.length;for(let t=0;t<o;t++){const s=r[t];if(s!==void 0&&n&&typeof n=="object"&&s in n)n=n[s];else return}return n}function d(e,r,n){if(r.length===0)return e;const[o,...t]=r;if(t.length===0)return O(p({},e),{[o]:n});const s=e[o];return O(p({},e),{[o]:d(typeof s=="object"&&s!==null?s:{},t,n)})}function f(e){if(e===null||typeof e!="object")return e;if(Array.isArray(e))return e.map(o=>f(o));if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);const r=Object.getPrototypeOf(e);if(r!==Object.prototype&&r!==null)return e;const n={};for(const o in e)Object.prototype.hasOwnProperty.call(e,o)&&(n[o]=f(e[o]));return n}function g(...e){if(e.length===0)return{};const r=e.filter(t=>t!=null);if(r.length===0)return{};if(r.length===1)return r[0];if(r.every(Array.isArray))return[].concat(...r);if(r.every(t=>typeof t=="object"&&t!==null&&!Array.isArray(t))){const t={};for(const s of r){const i=s;for(const a in i)if(Object.prototype.hasOwnProperty.call(i,a)){const l=i[a];if(Object.prototype.hasOwnProperty.call(t,a)){const c=t[a];typeof l=="object"&&l!==null&&typeof c=="object"&&c!==null?Array.isArray(l)&&Array.isArray(c)?t[a]=c.concat(l):!Array.isArray(l)&&!Array.isArray(c)?t[a]=g(c,l):t[a]=l:t[a]=l}else t[a]=l}}return t}if(r.every(t=>typeof t!="object"||t===null))throw new Error("deepMerge: Cannot merge primitive values. All arguments must be objects or arrays.");const n=r.some(Array.isArray),o=r.some(t=>typeof t=="object"&&t!==null&&!Array.isArray(t));throw n&&o?new Error("deepMerge: Cannot mix arrays and objects. All arguments must be either arrays or objects."):new Error("deepMerge: Invalid arguments provided. All arguments must be objects or arrays of the same type.")}function b(e){if(!e||typeof e!="object")return e;const r={};function n(o,t){for(const s in o){if(!Object.prototype.hasOwnProperty.call(o,s))continue;const i=o[s],a=t?`${t}.${s}`:s;if(i&&typeof i=="object"&&!Array.isArray(i)){let l=!1;for(const c in i)if(Object.prototype.hasOwnProperty.call(i,c)&&c.startsWith("$")){l=!0;break}l?r[a]=i:n(i,a)}else r[a]=i}}return n(e,""),r}exports.deepClone=f;exports.deepMerge=g;exports.getNestedValue=_;exports.isJSON=P;exports.normalizeMongoFilter=b;exports.setNestedValue=d;

package/dist/util/object/object.util.d.ts

@@ -29,48 +29,28 @@ export declare function getNestedValue<T>(obj: T, path: (string | number)[]): un
  */
 export declare function setNestedValue<T>(obj: T, path: (string | number)[], value: unknown): T;
 /**
- * Deep merges multiple objects or arrays into a single object or array.
- * This function handles different types of merging with improved type safety and error handling:
- * - If all arguments are arrays, it concatenates them
- * - If all arguments are objects, it deeply merges them (concatenating arrays within objects)
- * - Handles null/undefined values gracefully by treating them as empty objects
- * - Provides better type inference and safety
- * - Throws descriptive errors for invalid input
+ * Deep clones an object or array.
+ * This function creates a deep copy of the input, recursively cloning objects and arrays.
+ * Primitive values, dates, and other non-plain objects are returned as is (or cloned if supported).
+ * Note: This implementation focuses on plain objects and arrays. For complex types like Map/Set/Buffer/ObjectId,
+ * it returns the reference or handles them according to specific logic.
  *
- * @param args - The objects or arrays to merge. Can be empty, in which case returns an empty object.
- * @returns The merged result - either a concatenated array or a deeply merged object.
- * @throws {Error} When arguments are mixed types (some arrays, some objects) or when all arguments are primitive values.
- *
- * @example
- * ```typescript
- * // Merge objects
- * deepMerge({ a: 1 }, { b: 2 }, { a: 3 }) // { a: 3, b: 2 }
- *
- * // Merge arrays
- * deepMerge([1, 2], [3, 4]) // [1, 2, 3, 4]
- *
- * // Handle null/undefined
- * deepMerge({ a: 1 }, null, undefined, { b: 2 }) // { a: 1, b: 2 }
- *
- * // Nested objects with arrays
- * deepMerge(
- *   { items: [1, 2], config: { theme: 'dark' } },
- *   { items: [3, 4], config: { size: 'large' } }
- * ) // { items: [1, 2, 3, 4], config: { theme: 'dark', size: 'large' } }
- * ```
+ * @param obj - The object to clone.
+ * @returns A deep copy of the object.
  */
+export declare function deepClone<T>(obj: T): T;
 /**
  * Deep merges multiple objects into a single object.
  * @param args - The objects to merge. Can be empty, in which case returns an empty object.
  * @returns The merged object.
  */
-export declare function deepMerge<T extends Record<string, unknown>>(...args: (T | null | undefined)[]): T;
+export declare function deepMerge<T = Record<string, unknown>>(...args: (object | null | undefined)[]): T;
 /**
  * Deep merges multiple arrays into a single array.
  * @param args - The arrays to merge. Can be empty, in which case returns an empty array.
  * @returns The merged array.
  */
-export declare function deepMerge<T extends unknown[]>(...args: (T | null | undefined)[]): T;
+export declare function deepMerge<T = unknown[]>(...args: (unknown[] | null | undefined)[]): T;
 /**
  * Normalizes MongoDB filters to support both dot notation strings and nested objects.
  * This function converts nested object filters to dot notation format while preserving

package/dist/util/object/object.util.js

@@ -1,97 +1,134 @@
-import { isArray as i, mergeWith as d } from "lodash-es";
-var m = Object.defineProperty, v = Object.defineProperties, O = Object.getOwnPropertyDescriptors, a = Object.getOwnPropertySymbols, b = Object.prototype.hasOwnProperty, h = Object.prototype.propertyIsEnumerable, u = (r, e, t) => e in r ? m(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t, f = (r, e) => {
-  for (var t in e || (e = {}))
-    b.call(e, t) && u(r, t, e[t]);
-  if (a)
-    for (var t of a(e))
-      h.call(e, t) && u(r, t, e[t]);
-  return r;
-}, c = (r, e) => v(r, O(e));
-function w(r) {
+var A = Object.defineProperty, d = Object.defineProperties, g = Object.getOwnPropertyDescriptors, f = Object.getOwnPropertySymbols, m = Object.prototype.hasOwnProperty, h = Object.prototype.propertyIsEnumerable, y = (e, r, n) => r in e ? A(e, r, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[r] = n, u = (e, r) => {
+  for (var n in r || (r = {}))
+    m.call(r, n) && y(e, n, r[n]);
+  if (f)
+    for (var n of f(r))
+      h.call(r, n) && y(e, n, r[n]);
+  return e;
+}, p = (e, r) => d(e, g(r));
+function P(e) {
   try {
-    return JSON.parse(r), !0;
-  } catch (e) {
+    return JSON.parse(e), !0;
+  } catch (r) {
     return !1;
   }
 }
-function P(r, e) {
-  return e.reduce((t, n) => {
-    if (t && typeof t == "object" && n in t)
-      return t[n];
-  }, r);
+function _(e, r) {
+  let n = e;
+  const o = r.length;
+  for (let t = 0; t < o; t++) {
+    const s = r[t];
+    if (s !== void 0 && n && typeof n == "object" && s in n)
+      n = n[s];
+    else
+      return;
+  }
+  return n;
 }
-function _(r, e, t) {
-  if (e.length === 0)
-    return r;
-  const [n, ...o] = e;
-  if (o.length === 0)
-    return c(f({}, r), {
-      [n]: t
+function v(e, r, n) {
+  if (r.length === 0)
+    return e;
+  const [o, ...t] = r;
+  if (t.length === 0)
+    return p(u({}, e), {
+      [o]: n
     });
-  const s = r[n];
-  return c(f({}, r), {
-    [n]: _(
+  const s = e[o];
+  return p(u({}, e), {
+    [o]: v(
       typeof s == "object" && s !== null ? s : {},
-      o,
-      t
+      t,
+      n
     )
   });
 }
-function A(...r) {
-  if (r.length === 0)
-    return {};
-  const e = r.filter((o) => o != null).map((o) => typeof o != "object" ? {} : o);
+function O(e) {
+  if (e === null || typeof e != "object")
+    return e;
+  if (Array.isArray(e))
+    return e.map((o) => O(o));
+  if (e instanceof Date)
+    return new Date(e.getTime());
+  if (e instanceof RegExp)
+    return new RegExp(e.source, e.flags);
+  const r = Object.getPrototypeOf(e);
+  if (r !== Object.prototype && r !== null)
+    return e;
+  const n = {};
+  for (const o in e)
+    Object.prototype.hasOwnProperty.call(e, o) && (n[o] = O(e[o]));
+  return n;
+}
+function w(...e) {
   if (e.length === 0)
     return {};
-  if (e.length === 1)
-    return e[0];
-  if (e.every(i))
-    return [].concat(...e);
-  if (e.every(
-    (o) => typeof o == "object" && o !== null && !i(o)
-  ))
-    return d({}, ...e, (o, s) => {
-      if (i(o) && i(s))
-        return o.concat(s);
-    });
-  if (e.every((o) => typeof o != "object" || o === null))
+  const r = e.filter((t) => t != null);
+  if (r.length === 0)
+    return {};
+  if (r.length === 1)
+    return r[0];
+  if (r.every(Array.isArray))
+    return [].concat(...r);
+  if (r.every((t) => typeof t == "object" && t !== null && !Array.isArray(t))) {
+    const t = {};
+    for (const s of r) {
+      const i = s;
+      for (const a in i)
+        if (Object.prototype.hasOwnProperty.call(i, a)) {
+          const l = i[a];
+          if (Object.prototype.hasOwnProperty.call(t, a)) {
+            const c = t[a];
+            typeof l == "object" && l !== null && typeof c == "object" && c !== null ? Array.isArray(l) && Array.isArray(c) ? t[a] = c.concat(l) : !Array.isArray(l) && !Array.isArray(c) ? t[a] = w(
+              c,
+              l
+            ) : t[a] = l : t[a] = l;
+          } else
+            t[a] = l;
+        }
+    }
+    return t;
+  }
+  if (r.every((t) => typeof t != "object" || t === null))
     throw new Error(
       "deepMerge: Cannot merge primitive values. All arguments must be objects or arrays."
     );
-  const t = e.some(i), n = e.some(
-    (o) => typeof o == "object" && o !== null && !i(o)
+  const n = r.some(Array.isArray), o = r.some(
+    (t) => typeof t == "object" && t !== null && !Array.isArray(t)
   );
-  throw t && n ? new Error(
+  throw n && o ? new Error(
     "deepMerge: Cannot mix arrays and objects. All arguments must be either arrays or objects."
   ) : new Error(
     "deepMerge: Invalid arguments provided. All arguments must be objects or arrays of the same type."
   );
 }
-function g(r) {
-  if (!r || typeof r != "object")
-    return r;
-  const e = {};
-  for (const [t, n] of Object.entries(r))
-    if (n && typeof n == "object" && !Array.isArray(n))
-      if (Object.keys(n).some(
-        (s) => s.startsWith("$")
-      ))
-        e[t] = n;
-      else {
-        const s = g(n);
-        for (const [l, p] of Object.entries(s)) {
-          const y = `${t}.${l}`;
-          e[y] = p;
-        }
-      }
-    else
-      e[t] = n;
-  return e;
+function b(e) {
+  if (!e || typeof e != "object")
+    return e;
+  const r = {};
+  function n(o, t) {
+    for (const s in o) {
+      if (!Object.prototype.hasOwnProperty.call(o, s))
+        continue;
+      const i = o[s], a = t ? `${t}.${s}` : s;
+      if (i && typeof i == "object" && !Array.isArray(i)) {
+        let l = !1;
+        for (const c in i)
+          if (Object.prototype.hasOwnProperty.call(i, c) && c.startsWith("$")) {
+            l = !0;
+            break;
+          }
+        l ? r[a] = i : n(i, a);
+      } else
+        r[a] = i;
+    }
+  }
+  return n(e, ""), r;
 }
 export {
-  A as deepMerge,
-  P as getNestedValue,
-  w as isJSON,
-  g as normalizeMongoFilter,
-  _ as setNestedValue
+  O as deepClone,
+  w as deepMerge,
+  _ as getNestedValue,
+  P as isJSON,
+  b as normalizeMongoFilter,
+  v as setNestedValue
 };

package/dist/util/serializer/serializer.test.unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/util/serializer/serializer.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n={Date:{is:e=>e instanceof Date,serialize:e=>({__type:"Date",value:e.toISOString()}),deserialize:e=>new Date(e)},Map:{is:e=>e instanceof Map,serialize:e=>({__type:"Map",value:Array.from(e.entries())}),deserialize:e=>new Map(e)},Set:{is:e=>e instanceof Set,serialize:e=>({__type:"Set",value:Array.from(e)}),deserialize:e=>new Set(e)},RegExp:{is:e=>e instanceof RegExp,serialize:e=>({__type:"RegExp",value:{source:e.source,flags:e.flags}}),deserialize:e=>{const{source:r,flags:i}=e;return new RegExp(r,i)}},BigInt:{is:e=>typeof e=="bigint",serialize:e=>({__type:"BigInt",value:e.toString()}),deserialize:e=>BigInt(e)}},a={serialize(e){return JSON.stringify(e,(r,i)=>{for(const s of Object.keys(n)){const t=n[s];if(t.is(i))return t.serialize(i)}return i})},deserialize(e){return JSON.parse(e,(r,i)=>{if(i&&typeof i=="object"&&"__type"in i&&typeof i.__type=="string"){const s=i.__type,t=n[s];if(t)return t.deserialize(i.value)}return i})}};exports.serializer=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s={Date:{is:e=>e instanceof Date,serialize:e=>({__type:"Date",value:e.toISOString()}),deserialize:e=>new Date(e)},Map:{is:e=>e instanceof Map,serialize:e=>({__type:"Map",value:Array.from(e.entries())}),deserialize:e=>new Map(e)},Set:{is:e=>e instanceof Set,serialize:e=>({__type:"Set",value:Array.from(e)}),deserialize:e=>new Set(e)},RegExp:{is:e=>e instanceof RegExp,serialize:e=>({__type:"RegExp",value:{source:e.source,flags:e.flags}}),deserialize:e=>{const{source:r,flags:t}=e;return new RegExp(r,t)}},BigInt:{is:e=>typeof e=="bigint",serialize:e=>({__type:"BigInt",value:e.toString()}),deserialize:e=>BigInt(e)}},l={serialize(e){return JSON.stringify(e,function(r,t){const i=this[r];if(i instanceof Date)return s.Date.serialize(i);for(const o of Object.keys(s)){const a=s[o];if(a.is(t))return a.serialize(t)}return t})},deserialize(e){return JSON.parse(e,(r,t)=>{if(t&&typeof t=="object"&&"__type"in t&&typeof t.__type=="string"){const n=t.__type,i=s[n];if(i)return i.deserialize(t.value)}return t})}};exports.serializer=l;

package/dist/util/serializer/serializer.util.js

@@ -21,8 +21,8 @@ const n = {
       value: { source: e.source, flags: e.flags }
     }),
     deserialize: (e) => {
-      const { source: r, flags: i } = e;
-      return new RegExp(r, i);
+      const { source: r, flags: t } = e;
+      return new RegExp(r, t);
     }
   },
   BigInt: {
@@ -30,7 +30,7 @@ const n = {
     serialize: (e) => ({ __type: "BigInt", value: e.toString() }),
     deserialize: (e) => BigInt(e)
   }
-}, a = {
+}, p = {
   /**
    * Serializes a value to a JSON string.
    * If the value is of a known type (Date, Map, Set, RegExp, BigInt),
@@ -41,13 +41,16 @@ const n = {
    * @returns The serialized JSON string that can be safely stored or transmitted.
    */
   serialize(e) {
-    return JSON.stringify(e, (r, i) => {
-      for (const s of Object.keys(n)) {
-        const t = n[s];
-        if (t.is(i))
-          return t.serialize(i);
+    return JSON.stringify(e, function(r, t) {
+      const i = this[r];
+      if (i instanceof Date)
+        return n.Date.serialize(i);
+      for (const o of Object.keys(n)) {
+        const a = n[o];
+        if (a.is(t))
+          return a.serialize(t);
       }
-      return i;
+      return t;
     });
   },
   /**
@@ -60,16 +63,16 @@ const n = {
    * @returns The deserialized value with all special types reconstructed.
    */
   deserialize(e) {
-    return JSON.parse(e, (r, i) => {
-      if (i && typeof i == "object" && "__type" in i && typeof i.__type == "string") {
-        const s = i.__type, t = n[s];
-        if (t)
-          return t.deserialize(i.value);
+    return JSON.parse(e, (r, t) => {
+      if (t && typeof t == "object" && "__type" in t && typeof t.__type == "string") {
+        const s = t.__type, i = n[s];
+        if (i)
+          return i.deserialize(t.value);
       }
-      return i;
+      return t;
     });
   }
 };
 export {
-  a as serializer
+  p as serializer
 };

package/dist/util/string/string.test.unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/util/string/string.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("crypto-js"),c=require("lodash-es"),u=require("slugify");var f=Object.defineProperty,s=Object.getOwnPropertySymbols,d=Object.prototype.hasOwnProperty,g=Object.prototype.propertyIsEnumerable,i=(r,e,t)=>e in r?f(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t,m=(r,e)=>{for(var t in e||(e={}))d.call(e,t)&&i(r,t,e[t]);if(s)for(var t of s(e))g.call(e,t)&&i(r,t,e[t]);return r};const O=u.default||u;function y(r,e){const t=n=>{var o,l;return O(n!=null?n:"",m({lower:(o=e==null?void 0:e.lower)!=null?o:!0,locale:(l=e==null?void 0:e.locale)!=null?l:"vi"},e))};if(c.isObject(r)){const n={};for(const[o,l]of Object.entries(r))n[o]=t(l);return n}return t(r)}function _(r,e=4){return a.SHA256(r).toString(a.enc.Hex).slice(0,e)}function h(r=8){const e="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()_+[]{}|;:,.<>?";return Array.from({length:r},()=>{const t=Math.floor(Math.random()*e.length);return e.charAt(t)}).join("")}function w(r="",e=!1){const t=r.split(/[?#]/)[0]||"",n=t.substring(t.lastIndexOf("/")+1);if(e)return n;const o=n.lastIndexOf(".");return o>0?n.slice(0,o):n}function p(r,e,t){const n=r.indexOf(e);if(n===-1)return"";const o=n+e.length,l=r.indexOf(t,o);return l===-1?"":r.slice(o,l)}exports.generateRandomPassword=h;exports.generateShortId=_;exports.generateSlug=y;exports.getFileName=w;exports.substringBetween=p;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("../common/common.util.cjs");function a(t,r){let e=t.trim();return e=l.removeAccent(e),(r==null?void 0:r.lower)!==!1&&(e=e.toLowerCase()),e=e.replace(/[^a-z0-9\s-]/gi," "),e=e.replace(/[\s-]+/g,"-"),e=e.replace(/^-+|-+$/g,""),e}function c(t,r){const e=n=>a(n!=null?n:"",r);if(typeof t=="object"&&t!==null){const n={};for(const[o,s]of Object.entries(t))n[o]=e(s);return n}return e(t)}function i(t,r=4){let e=2166136261;for(let o=0;o<t.length;o++)e^=t.charCodeAt(o),e=Math.imul(e,16777619);const n=(e>>>0).toString(16).padStart(8,"0");return r>8?t.replace(/-/g,"").slice(0,r):n.slice(0,r)}function u(t=8){const r="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()_+[]{}|;:,.<>?";return Array.from({length:t},()=>{const e=Math.floor(Math.random()*r.length);return r.charAt(e)}).join("")}function f(t="",r=!1){const e=t.split(/[?#]/)[0]||"",n=e.substring(e.lastIndexOf("/")+1);if(r)return n;const o=n.lastIndexOf(".");return o>0?n.slice(0,o):n}function g(t,r,e){const n=t.indexOf(r);if(n===-1)return"";const o=n+r.length,s=t.indexOf(e,o);return s===-1?"":t.slice(o,s)}exports.generateRandomPassword=u;exports.generateShortId=i;exports.generateSlug=c;exports.getFileName=f;exports.substringBetween=g;

package/dist/util/string/string.util.d.ts

@@ -12,12 +12,13 @@ import { I_SlugifyOptions } from './string.type.js';
 export declare function generateSlug<T = string>(input: T, options?: I_SlugifyOptions): T;
 /**
  * Generates a short ID from a UUID.
- * The ID is a substring of the SHA256 hash of the UUID, providing a shorter
- * but still unique identifier based on the original UUID.
+ * The ID is a substring of the UUID, providing a shorter identifier.
+ * Note: This is NOT cryptographically secure and collisions are possible,
+ * but suitable for display purposes where uniqueness is handled elsewhere.
  *
  * @param uuid - The UUID to be converted to a short ID.
  * @param length - The desired length of the short ID (default: 4 characters).
- * @returns A short ID string of the specified length derived from the UUID's SHA256 hash.
+ * @returns A short ID string of the specified length derived from the UUID.
  */
 export declare function generateShortId(uuid: string, length?: number): string;
 /**