@cyberskill/shared 2.19.1 → 2.21.0

package/dist/node/storage/storage.util.js

@@ -1,31 +1,143 @@
-import u from "node-persist";
-import { getEnv as m } from "../../config/env/env.util.js";
-import { catchError as i, log as v } from "../log/log.util.js";
-var l = (r, e, n) => new Promise((h, a) => {
-  var d = (t) => {
+import _ from "localforage";
+import l from "node:fs/promises";
+import g from "node:path";
+import { STORAGE_KEY_EXTENSION as R, NODE_FS_DRIVER_NAME as I, STORAGE_STORE_NAME as p, STORAGE_INSTANCE_NAME as b } from "./storage.constant.js";
+import { getEnv as N } from "../../config/env/env.util.js";
+import { catchError as s, log as S } from "../log/log.util.js";
+var n = (e, r, t) => new Promise((i, d) => {
+  var y = (u) => {
     try {
-      s(n.next(t));
-    } catch (c) {
-      a(c);
+      m(t.next(u));
+    } catch (v) {
+      d(v);
     }
-  }, f = (t) => {
+  }, O = (u) => {
     try {
-      s(n.throw(t));
-    } catch (c) {
-      a(c);
+      m(t.throw(u));
+    } catch (v) {
+      d(v);
     }
-  }, s = (t) => t.done ? h(t.value) : Promise.resolve(t.value).then(d, f);
-  s((n = n.apply(r, e)).next());
+  }, m = (u) => u.done ? i(u.value) : Promise.resolve(u.value).then(y, O);
+  m((t = t.apply(e, r)).next());
 });
-const y = m();
-function o() {
-  return l(this, null, function* () {
-    u.defaultInstance || (yield u.init({
-      dir: y.CYBERSKILL_STORAGE_DIRECTORY
-    }));
+const h = N(), o = {
+  baseDir: h.CYBERSKILL_STORAGE_DIRECTORY
+};
+function k(e) {
+  return `${encodeURIComponent(e)}${R}`;
+}
+function T(e) {
+  return decodeURIComponent(e.slice(0, -R.length));
+}
+function E(e, r) {
+  return g.join(r, k(e));
+}
+const a = {
+  _driver: I,
+  _support: !0,
+  /** Ensures the storage directory exists and respects custom baseDir overrides. */
+  _initStorage(e) {
+    return n(this, null, function* () {
+      try {
+        const r = typeof e == "object" && e !== null && "baseDir" in e ? e.baseDir : void 0;
+        typeof r == "string" && r.length > 0 ? o.baseDir = r : o.baseDir = h.CYBERSKILL_STORAGE_DIRECTORY, yield l.mkdir(o.baseDir, { recursive: !0 });
+      } catch (r) {
+        throw S.error("[Storage:init]", r), r;
+      }
+    });
+  },
+  /** Deletes all stored entries by recreating the directory. */
+  clear() {
+    return n(this, null, function* () {
+      const { baseDir: e } = o;
+      yield l.rm(e, { recursive: !0, force: !0 }), yield l.mkdir(e, { recursive: !0 });
+    });
+  },
+  /** Reads and parses a stored value; returns null when the file is missing. */
+  getItem(e) {
+    return n(this, null, function* () {
+      const { baseDir: r } = o, t = E(e, r);
+      try {
+        const i = yield l.readFile(t, "utf8");
+        return JSON.parse(i);
+      } catch (i) {
+        if (i.code === "ENOENT")
+          return null;
+        throw i;
+      }
+    });
+  },
+  /** Iterates through all keys, invoking the iterator until it returns a value. */
+  iterate(e) {
+    return n(this, null, function* () {
+      const r = yield a.keys();
+      let t = 1;
+      for (const i of r) {
+        const d = yield a.getItem(i), y = e(d, i, t);
+        if (y !== void 0)
+          return y;
+        t += 1;
+      }
+    });
+  },
+  /** Returns the key name at the given index or null when out of bounds. */
+  key(e) {
+    return n(this, null, function* () {
+      var r;
+      return (r = (yield a.keys())[e]) != null ? r : null;
+    });
+  },
+  /** Lists all stored keys. */
+  keys() {
+    return n(this, null, function* () {
+      const { baseDir: e } = o;
+      try {
+        return (yield l.readdir(e)).filter((t) => t.endsWith(R)).map(T);
+      } catch (r) {
+        if (r.code === "ENOENT")
+          return [];
+        throw r;
+      }
+    });
+  },
+  /** Returns the count of stored keys. */
+  length() {
+    return n(this, null, function* () {
+      return (yield a.keys()).length;
+    });
+  },
+  /** Removes a stored value for the given key. */
+  removeItem(e) {
+    return n(this, null, function* () {
+      const { baseDir: r } = o, t = E(e, r);
+      yield l.rm(t, { force: !0 });
+    });
+  },
+  /** Stores a value as JSON on disk. */
+  setItem(e, r) {
+    return n(this, null, function* () {
+      const { baseDir: t } = o, i = E(e, t);
+      return yield l.mkdir(t, { recursive: !0 }), yield l.writeFile(i, JSON.stringify(r), "utf8"), r;
+    });
+  }
+};
+let c = null, D = null;
+function f() {
+  return n(this, null, function* () {
+    return c ? (yield c, D) : (c = n(null, null, function* () {
+      yield _.defineDriver(a), o.baseDir = h.CYBERSKILL_STORAGE_DIRECTORY;
+      const e = yield _.getDriver(I), r = {
+        baseDir: o.baseDir,
+        name: b,
+        storeName: p
+      };
+      yield e._initStorage(r), D = e;
+    }).catch((e) => {
+      throw c = null, e;
+    }), yield c, D);
   });
 }
-const R = {
+const w = {
   /**
    * Retrieves a value from persistent storage by key.
    * This method fetches data that was previously stored using the set method.
@@ -34,14 +146,13 @@ const R = {
    * @param key - The unique identifier for the stored value.
    * @returns A promise that resolves to the stored value or null if not found.
    */
-  get(r) {
-    return l(this, null, function* () {
+  get(e) {
+    return n(this, null, function* () {
       try {
-        yield o();
-        const e = yield u.getItem(r);
-        return e != null ? e : null;
-      } catch (e) {
-        return i(e, { returnValue: null });
+        const t = yield (yield f()).getItem(e);
+        return t != null ? t : null;
+      } catch (r) {
+        return s(r, { returnValue: null });
       }
     });
   },
@@ -54,12 +165,12 @@ const R = {
    * @param value - The data to store (will be automatically serialized).
    * @returns A promise that resolves when the storage operation is complete.
    */
-  set(r, e) {
-    return l(this, null, function* () {
+  set(e, r) {
+    return n(this, null, function* () {
       try {
-        yield o(), yield u.setItem(r, e);
-      } catch (n) {
-        i(n);
+        yield (yield f()).setItem(e, r);
+      } catch (t) {
+        s(t);
       }
     });
   },
@@ -70,12 +181,12 @@ const R = {
    * @param key - The unique identifier of the value to remove.
    * @returns A promise that resolves when the removal operation is complete.
    */
-  remove(r) {
-    return l(this, null, function* () {
+  remove(e) {
+    return n(this, null, function* () {
       try {
-        yield o(), yield u.removeItem(r);
-      } catch (e) {
-        i(e);
+        yield (yield f()).removeItem(e);
+      } catch (r) {
+        s(r);
       }
     });
   },
@@ -87,13 +198,12 @@ const R = {
    * @returns A promise that resolves to an array of storage keys.
    */
   keys() {
-    return l(this, null, function* () {
+    return n(this, null, function* () {
       try {
-        yield o();
-        const r = yield u.keys();
-        return Array.isArray(r) ? r : (v.warn("[Storage:keys] Invalid keys response:", r), []);
-      } catch (r) {
-        return i(r, { returnValue: [] });
+        const r = yield (yield f()).keys();
+        return Array.isArray(r) ? r : (S.warn("[Storage:keys] Invalid keys response:", r), []);
+      } catch (e) {
+        return s(e, { returnValue: [] });
       }
     });
   },
@@ -105,16 +215,16 @@ const R = {
    * @param key - The storage key to generate a log link for.
    * @returns A promise that resolves to a formatted log link string or null if an error occurs.
    */
-  getLogLink(r) {
-    return l(this, null, function* () {
+  getLogLink(e) {
+    return n(this, null, function* () {
       try {
-        return `${y.CYBERSKILL_STORAGE_DIRECTORY} (key: ${r})`;
-      } catch (e) {
-        return i(e, { returnValue: null });
+        return `${g.join(h.CYBERSKILL_STORAGE_DIRECTORY, k(e))} (key: ${e})`;
+      } catch (r) {
+        return s(r, { returnValue: null });
       }
     });
   }
 };
 export {
-  R as storage
+  w as storage
 };

package/dist/react/loading/loading.component.cjs

@@ -1,6 +1,6 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("clsx"),a=require("react"),l=require("./loading.module.scss.cjs");var _=Object.defineProperty,o=Object.getOwnPropertySymbols,f=Object.prototype.hasOwnProperty,u=Object.prototype.propertyIsEnumerable,m=(e,r,t)=>r in e?_(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t,p=(e,r)=>{for(var t in r||(r={}))f.call(r,t)&&m(e,t,r[t]);if(o)for(var t of o(r))u.call(r,t)&&m(e,t,r[t]);return e},y=(e,r)=>{var t={};for(var n in e)f.call(e,n)&&r.indexOf(n)<0&&(t[n]=e[n]);if(e!=null&&o)for(var n of o(e))r.indexOf(n)<0&&u.call(e,n)&&(t[n]=e[n]);return t};function E(){if(document.getElementById("noscroll-style"))return;const e=document.createElement("style");e.id="noscroll-style",e.innerHTML=`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("clsx"),n=require("react"),l=require("./loading.module.scss.cjs");var p=Object.defineProperty,i=Object.getOwnPropertySymbols,m=Object.prototype.hasOwnProperty,f=Object.prototype.propertyIsEnumerable,u=(e,r,t)=>r in e?p(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t,_=(e,r)=>{for(var t in r||(r={}))m.call(r,t)&&u(e,t,r[t]);if(i)for(var t of i(r))f.call(r,t)&&u(e,t,r[t]);return e},y=(e,r)=>{var t={};for(var a in e)m.call(e,a)&&r.indexOf(a)<0&&(t[a]=e[a]);if(e!=null&&i)for(var a of i(e))r.indexOf(a)<0&&f.call(e,a)&&(t[a]=e[a]);return t};function E(){if(document.getElementById("noscroll-style"))return;const e=document.createElement("style");e.id="noscroll-style",e.innerHTML=`
     .noscroll {
         overflow: hidden !important;
         height: 100vh !important;
     }
-    `,document.head.appendChild(e)}function N(e){var r=e,{full:t=!1,className:n="",message:i="Loading"}=r,v=y(r,["full","className","message"]);a.useEffect(()=>{if(t){document.body.classList.add("noscroll");const c=g=>g.preventDefault();return document.addEventListener("contextmenu",c),()=>{document.body.classList.remove("noscroll"),document.removeEventListener("contextmenu",c)}}},[t]),a.useEffect(()=>{E()},[]);function s(){return a.createElement("div",p({className:l.default.container},v),a.createElement("div",{className:l.default.ring}),a.createElement("div",{className:l.default.ring}),a.createElement("div",{className:l.default.ring}),a.createElement("div",{className:l.default.ring}),i&&a.createElement("div",{className:l.default.message},i))}return t?a.createElement("div",{className:d(l.default.full,n)},s()):a.createElement("div",{className:d(l.default.block,n)},s())}exports.Loading=N;
+    `,document.head.appendChild(e)}function h(e){var r=e,{full:t=!1,className:a="",message:o="Loading"}=r,v=y(r,["full","className","message"]);n.useEffect(()=>{if(t){document.body.classList.add("noscroll");const s=g=>g.preventDefault();return document.addEventListener("contextmenu",s),()=>{document.body.classList.remove("noscroll"),document.removeEventListener("contextmenu",s)}}},[t]),n.useEffect(()=>{E()},[]);function d(){return n.createElement("div",_({role:"status","aria-live":"polite","aria-label":o,className:l.default.container},v),n.createElement("div",{className:l.default.ring,"aria-hidden":"true"}),n.createElement("div",{className:l.default.ring,"aria-hidden":"true"}),n.createElement("div",{className:l.default.ring,"aria-hidden":"true"}),n.createElement("div",{className:l.default.ring,"aria-hidden":"true"}),o&&n.createElement("div",{className:l.default.message},o))}return t?n.createElement("div",{className:c(l.default.full,a)},d()):n.createElement("div",{className:c(l.default.block,a)},d())}exports.Loading=h;

package/dist/react/loading/loading.component.js

@@ -1,23 +1,23 @@
 import m from "clsx";
-import a, { useEffect as d } from "react";
+import n, { useEffect as d } from "react";
 import l from "./loading.module.scss.js";
-var _ = Object.defineProperty, o = Object.getOwnPropertySymbols, v = Object.prototype.hasOwnProperty, u = Object.prototype.propertyIsEnumerable, f = (e, r, t) => r in e ? _(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t, y = (e, r) => {
+var _ = Object.defineProperty, i = Object.getOwnPropertySymbols, u = Object.prototype.hasOwnProperty, v = Object.prototype.propertyIsEnumerable, f = (e, r, t) => r in e ? _(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t, y = (e, r) => {
   for (var t in r || (r = {}))
-    v.call(r, t) && f(e, t, r[t]);
-  if (o)
-    for (var t of o(r))
-      u.call(r, t) && f(e, t, r[t]);
+    u.call(r, t) && f(e, t, r[t]);
+  if (i)
+    for (var t of i(r))
+      v.call(r, t) && f(e, t, r[t]);
   return e;
 }, E = (e, r) => {
   var t = {};
-  for (var n in e)
-    v.call(e, n) && r.indexOf(n) < 0 && (t[n] = e[n]);
-  if (e != null && o)
-    for (var n of o(e))
-      r.indexOf(n) < 0 && u.call(e, n) && (t[n] = e[n]);
+  for (var a in e)
+    u.call(e, a) && r.indexOf(a) < 0 && (t[a] = e[a]);
+  if (e != null && i)
+    for (var a of i(e))
+      r.indexOf(a) < 0 && v.call(e, a) && (t[a] = e[a]);
   return t;
 };
-function N() {
+function h() {
   if (document.getElementById("noscroll-style"))
     return;
   const e = document.createElement("style");
@@ -28,8 +28,8 @@ function N() {
     }
     `, document.head.appendChild(e);
 }
-function b(e) {
-  var r = e, { full: t = !1, className: n = "", message: s = "Loading" } = r, p = E(r, ["full", "className", "message"]);
+function L(e) {
+  var r = e, { full: t = !1, className: a = "", message: o = "Loading" } = r, p = E(r, ["full", "className", "message"]);
   d(() => {
     if (t) {
       document.body.classList.add("noscroll");
@@ -39,13 +39,26 @@ function b(e) {
       };
     }
   }, [t]), d(() => {
-    N();
+    h();
   }, []);
-  function i() {
-    return /* @__PURE__ */ a.createElement("div", y({ className: l.container }, p), /* @__PURE__ */ a.createElement("div", { className: l.ring }), /* @__PURE__ */ a.createElement("div", { className: l.ring }), /* @__PURE__ */ a.createElement("div", { className: l.ring }), /* @__PURE__ */ a.createElement("div", { className: l.ring }), s && /* @__PURE__ */ a.createElement("div", { className: l.message }, s));
+  function s() {
+    return /* @__PURE__ */ n.createElement(
+      "div",
+      y({
+        role: "status",
+        "aria-live": "polite",
+        "aria-label": o,
+        className: l.container
+      }, p),
+      /* @__PURE__ */ n.createElement("div", { className: l.ring, "aria-hidden": "true" }),
+      /* @__PURE__ */ n.createElement("div", { className: l.ring, "aria-hidden": "true" }),
+      /* @__PURE__ */ n.createElement("div", { className: l.ring, "aria-hidden": "true" }),
+      /* @__PURE__ */ n.createElement("div", { className: l.ring, "aria-hidden": "true" }),
+      o && /* @__PURE__ */ n.createElement("div", { className: l.message }, o)
+    );
   }
-  return t ? /* @__PURE__ */ a.createElement("div", { className: m(l.full, n) }, i()) : /* @__PURE__ */ a.createElement("div", { className: m(l.block, n) }, i());
+  return t ? /* @__PURE__ */ n.createElement("div", { className: m(l.full, a) }, s()) : /* @__PURE__ */ n.createElement("div", { className: m(l.block, a) }, s());
 }
 export {
-  b as Loading
+  L as Loading
 };

package/dist/react/loading/loading.test.unit.d.ts

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

package/dist/react/loading/loading.type.d.ts

@@ -1,10 +1,11 @@
+import { HTMLAttributes } from 'react';
 export interface I_LoadingContext {
     isLoading: boolean;
     isGlobalLoading: boolean;
     showLoading: (global?: boolean) => void;
     hideLoading: () => void;
 }
-export interface I_LoadingProps {
+export interface I_LoadingProps extends HTMLAttributes<HTMLDivElement> {
     full?: boolean;
     block?: boolean;
     className?: string;

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

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

package/dist/util/common/common.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("unorm"),t=require("../../typescript/common.type.cjs");var m=Object.defineProperty,c=Object.getOwnPropertySymbols,_=Object.prototype.hasOwnProperty,O=Object.prototype.propertyIsEnumerable,a=(e,n,r)=>n in e?m(e,n,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[n]=r,p=(e,n)=>{for(var r in n||(n={}))_.call(n,r)&&a(e,r,n[r]);if(c)for(var r of c(n))O.call(n,r)&&a(e,r,n[r]);return e};const u={a:["à","á","ạ","ả","ã","â","ầ","ấ","ậ","ẩ","ẫ","ă","ằ","ắ","ặ","ẳ","ẵ"],e:["è","é","ẹ","ẻ","ẽ","ê","ề","ế","ệ","ể","ễ"],i:["ì","í","ị","ỉ","ĩ"],o:["ò","ó","ọ","ỏ","õ","ô","ồ","ố","ộ","ổ","ỗ","ơ","ờ","ớ","ợ","ở","ỡ"],u:["ù","ú","ụ","ủ","ũ","ư","ừ","ứ","ự","ử","ữ"],y:["ỳ","ý","ỵ","ỷ","ỹ"],d:["đ"]},f=Object.entries(u).reduce((e,[n,r])=>(e[n.toUpperCase()]=r.map(o=>o.toUpperCase()),e),{});function v(e){e=s.nfkc(e);const n=p(p({},u),f);for(const[r,o]of Object.entries(n)){const i=`[${r}${o.join("")}]`,E=`(${[r,...o].join("|")})`;e=e.replace(new RegExp(i,"g"),E)}return e}function l(e){return e.normalize("NFD").replace(new RegExp("\\p{Diacritic}","gu"),"")}function D(e,n){if(!n)return Array.from(new Set(e));const r=new Set,o=[];for(const i of e){const E=n(i);r.has(E)||(r.add(E),o.push(i))}return o}function N(e){const{NODE_ENV:n=t.E_Environment.DEVELOPMENT,NODE_ENV_MODE:r=t.E_Environment.DEVELOPMENT}=e,o=n===t.E_Environment.DEVELOPMENT&&r===t.E_Environment.DEVELOPMENT,i=n===t.E_Environment.PRODUCTION&&r===t.E_Environment.STAGING,E=n===t.E_Environment.PRODUCTION&&r===t.E_Environment.PRODUCTION;if(n===t.E_Environment.PRODUCTION&&r===t.E_Environment.DEVELOPMENT)throw new Error("NODE_ENV_MODE must be set to staging or production in production environment");return{IS_DEV:o,IS_STAG:i,IS_PROD:E}}exports.mapEnvironment=N;exports.regexSearchMapper=v;exports.removeAccent=l;exports.uniqueArray=D;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../../typescript/common.type.cjs");var s=Object.defineProperty,a=Object.getOwnPropertySymbols,m=Object.prototype.hasOwnProperty,_=Object.prototype.propertyIsEnumerable,c=(e,n,r)=>n in e?s(e,n,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[n]=r,p=(e,n)=>{for(var r in n||(n={}))m.call(n,r)&&c(e,r,n[r]);if(a)for(var r of a(n))_.call(n,r)&&c(e,r,n[r]);return e};const u={a:["à","á","ạ","ả","ã","â","ầ","ấ","ậ","ẩ","ẫ","ă","ằ","ắ","ặ","ẳ","ẵ"],e:["è","é","ẹ","ẻ","ẽ","ê","ề","ế","ệ","ể","ễ"],i:["ì","í","ị","ỉ","ĩ"],o:["ò","ó","ọ","ỏ","õ","ô","ồ","ố","ộ","ổ","ỗ","ơ","ờ","ớ","ợ","ở","ỡ"],u:["ù","ú","ụ","ủ","ũ","ư","ừ","ứ","ự","ử","ữ"],y:["ỳ","ý","ỵ","ỷ","ỹ"],d:["đ"]},O=Object.entries(u).reduce((e,[n,r])=>(e[n.toUpperCase()]=r.map(o=>o.toUpperCase()),e),{});function v(e){e=e.normalize("NFD");const n=p(p({},u),O);for(const[r,o]of Object.entries(n)){const i=`[${r}${o.join("")}]`,E=`(${[r,...o].join("|")})`;e=e.replace(new RegExp(i,"g"),E)}return e}function f(e){return e.normalize("NFD").replace(new RegExp("\\p{Diacritic}","gu"),"")}function l(e,n){if(!n)return Array.from(new Set(e));const r=new Set,o=[];for(const i of e){const E=n(i);r.has(E)||(r.add(E),o.push(i))}return o}function D(e){const{NODE_ENV:n=t.E_Environment.DEVELOPMENT,NODE_ENV_MODE:r=t.E_Environment.DEVELOPMENT}=e,o=n===t.E_Environment.DEVELOPMENT&&r===t.E_Environment.DEVELOPMENT,i=n===t.E_Environment.PRODUCTION&&r===t.E_Environment.STAGING,E=n===t.E_Environment.PRODUCTION&&r===t.E_Environment.PRODUCTION;if(n===t.E_Environment.PRODUCTION&&r===t.E_Environment.DEVELOPMENT)throw new Error("NODE_ENV_MODE must be set to staging or production in production environment");return{IS_DEV:o,IS_STAG:i,IS_PROD:E}}exports.mapEnvironment=D;exports.regexSearchMapper=v;exports.removeAccent=f;exports.uniqueArray=l;

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

@@ -1,11 +1,10 @@
-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) => {
+var u = Object.defineProperty, i = Object.getOwnPropertySymbols, O = Object.prototype.hasOwnProperty, f = Object.prototype.propertyIsEnumerable, p = (e, r, n) => r in e ? u(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]);
-  if (p)
-    for (var n of p(r))
-      m.call(r, n) && i(e, n, r[n]);
+    O.call(r, n) && p(e, n, r[n]);
+  if (i)
+    for (var n of i(r))
+      f.call(r, n) && p(e, n, r[n]);
   return e;
 };
 const s = {
@@ -20,8 +19,8 @@ const s = {
   (e, [r, n]) => (e[r.toUpperCase()] = n.map((o) => o.toUpperCase()), e),
   {}
 );
-function P(e) {
-  e = u.nfkc(e);
+function D(e) {
+  e = e.normalize("NFD");
   const r = E(E({}, s), _);
   for (const [n, o] of Object.entries(r)) {
     const a = `[${n}${o.join("")}]`, c = `(${[n, ...o].join("|")})`;
@@ -29,10 +28,10 @@ function P(e) {
   }
   return e;
 }
-function l(e) {
+function N(e) {
   return e.normalize("NFD").replace(new RegExp("\\p{Diacritic}", "gu"), "");
 }
-function v(e, r) {
+function l(e, r) {
   if (!r)
     return Array.from(new Set(e));
   const n = /* @__PURE__ */ new Set(), o = [];
@@ -42,15 +41,15 @@ function v(e, r) {
   }
   return o;
 }
-function d(e) {
+function P(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)
     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 };
 }
 export {
-  d as mapEnvironment,
-  P as regexSearchMapper,
-  l as removeAccent,
-  v as uniqueArray
+  P as mapEnvironment,
+  D as regexSearchMapper,
+  N as removeAccent,
+  l 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 A=Object.defineProperty,v=Object.defineProperties,h=Object.getOwnPropertyDescriptors,f=Object.getOwnPropertySymbols,w=Object.prototype.hasOwnProperty,_=Object.prototype.propertyIsEnumerable,y=(e,r,n)=>r in e?A(e,r,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[r]=n,p=(e,r)=>{for(var n in r||(r={}))w.call(r,n)&&y(e,n,r[n]);if(f)for(var n of f(r))_.call(r,n)&&y(e,n,r[n]);return e},d=(e,r)=>v(e,h(r));function P(e){try{return JSON.parse(e),!0}catch(r){return!1}}function b(e,r){let n=e;const o=r.length;for(let t=0;t<o;t++)if(n&&typeof n=="object"&&r[t]in n)n=n[r[t]];else return;return n}function O(e,r,n){if(r.length===0)return e;const[o,...t]=r;if(t.length===0)return d(p({},e),{[o]:n});const i=e[o];return d(p({},e),{[o]:O(typeof i=="object"&&i!==null?i:{},t,n)})}function u(e){if(e===null||typeof e!="object")return e;if(Array.isArray(e))return e.map(o=>u(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]=u(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 i of r){const c=i;for(const s in c)if(Object.prototype.hasOwnProperty.call(c,s)){const a=c[s];if(Object.prototype.hasOwnProperty.call(t,s)){const l=t[s];typeof a=="object"&&a!==null&&typeof l=="object"&&l!==null?Array.isArray(a)&&Array.isArray(l)?t[s]=l.concat(a):!Array.isArray(a)&&!Array.isArray(l)?t[s]=g(l,a):t[s]=a:t[s]=a}else t[s]=a}}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 m(e){if(!e||typeof e!="object")return e;const r={};for(const[n,o]of Object.entries(e))if(o&&typeof o=="object"&&!Array.isArray(o))if(Object.keys(o).some(i=>i.startsWith("$")))r[n]=o;else{const i=m(o);for(const[c,s]of Object.entries(i)){const a=`${n}.${c}`;r[a]=s}}else r[n]=o;return r}exports.deepClone=u;exports.deepMerge=g;exports.getNestedValue=b;exports.isJSON=P;exports.normalizeMongoFilter=m;exports.setNestedValue=O;

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