@cyberskill/shared 2.27.0 → 2.28.0

package/dist/node/storage/storage.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("localforage"),o=require("node:fs/promises"),D=require("node:path"),c=require("./storage.constant.cjs"),I=require("../../config/env/env.util.cjs"),s=require("../log/log.util.cjs");var n=(e,r,t)=>new Promise((i,y)=>{var h=u=>{try{v(t.next(u))}catch(_){y(_)}},O=u=>{try{v(t.throw(u))}catch(_){y(_)}},v=u=>u.done?i(u.value):Promise.resolve(u.value).then(h,O);v((t=t.apply(e,r)).next())});const E=I.getEnv(),l={baseDir:E.CYBERSKILL_STORAGE_DIRECTORY};function m(e){return`${encodeURIComponent(e)}${c.STORAGE_KEY_EXTENSION}`}function N(e){return decodeURIComponent(e.slice(0,-c.STORAGE_KEY_EXTENSION.length))}function R(e,r){return D.join(r,m(e))}const d={_driver:c.NODE_FS_DRIVER_NAME,_support:!0,_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?l.baseDir=r:l.baseDir=E.CYBERSKILL_STORAGE_DIRECTORY,yield o.mkdir(l.baseDir,{recursive:!0})}catch(r){throw s.log.error("[Storage:init]",r),r}})},clear(){return n(this,null,function*(){const{baseDir:e}=l;yield o.rm(e,{recursive:!0,force:!0}),yield o.mkdir(e,{recursive:!0})})},getItem(e){return n(this,null,function*(){const{baseDir:r}=l,t=R(e,r);try{const i=yield o.readFile(t,"utf8");return JSON.parse(i)}catch(i){if(i.code==="ENOENT")return null;throw i}})},iterate(e){return n(this,null,function*(){const r=yield d.keys();let t=1;for(const i of r){const y=yield d.getItem(i),h=e(y,i,t);if(h!==void 0)return h;t+=1}})},key(e){return n(this,null,function*(){var r;return(r=(yield d.keys())[e])!=null?r:null})},keys(){return n(this,null,function*(){const{baseDir:e}=l;try{return(yield o.readdir(e)).filter(t=>t.endsWith(c.STORAGE_KEY_EXTENSION)).map(N)}catch(r){if(r.code==="ENOENT")return[];throw r}})},length(){return n(this,null,function*(){return(yield d.keys()).length})},removeItem(e){return n(this,null,function*(){const{baseDir:r}=l,t=R(e,r);yield o.rm(t,{force:!0})})},setItem(e,r){return n(this,null,function*(){const{baseDir:t}=l,i=R(e,t);return yield o.mkdir(t,{recursive:!0}),yield o.writeFile(i,JSON.stringify(r),"utf8"),r})}};let a=null,S=null;function f(){return n(this,null,function*(){return a?(yield a,S):(a=n(null,null,function*(){yield g.defineDriver(d),l.baseDir=E.CYBERSKILL_STORAGE_DIRECTORY;const e=yield g.getDriver(c.NODE_FS_DRIVER_NAME),r={baseDir:l.baseDir,name:c.STORAGE_INSTANCE_NAME,storeName:c.STORAGE_STORE_NAME};yield e._initStorage(r),S=e}).catch(e=>{throw a=null,e}),yield a,S)})}const T={get(e){return n(this,null,function*(){try{const t=yield(yield f()).getItem(e);return t!=null?t:null}catch(r){return s.catchError(r,{returnValue:null})}})},set(e,r){return n(this,null,function*(){try{yield(yield f()).setItem(e,r)}catch(t){s.catchError(t)}})},remove(e){return n(this,null,function*(){try{yield(yield f()).removeItem(e)}catch(r){s.catchError(r)}})},keys(){return n(this,null,function*(){try{const r=yield(yield f()).keys();return Array.isArray(r)?r:(s.log.warn("[Storage:keys] Invalid keys response:",r),[])}catch(e){return s.catchError(e,{returnValue:[]})}})},getLogLink(e){return n(this,null,function*(){try{return`${D.join(E.CYBERSKILL_STORAGE_DIRECTORY,m(e))} (key: ${e})`}catch(r){return s.catchError(r,{returnValue:null})}})}};exports.storage=T;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("localforage"),o=require("node:fs/promises"),D=require("node:path"),c=require("./storage.constant.cjs"),s=require("../log/log.util.cjs"),I=require("../../config/env/env.util.cjs");var n=(e,r,t)=>new Promise((i,y)=>{var h=u=>{try{v(t.next(u))}catch(_){y(_)}},O=u=>{try{v(t.throw(u))}catch(_){y(_)}},v=u=>u.done?i(u.value):Promise.resolve(u.value).then(h,O);v((t=t.apply(e,r)).next())});const E=I.getEnv(),l={baseDir:E.CYBERSKILL_STORAGE_DIRECTORY};function m(e){return`${encodeURIComponent(e)}${c.STORAGE_KEY_EXTENSION}`}function N(e){return decodeURIComponent(e.slice(0,-c.STORAGE_KEY_EXTENSION.length))}function R(e,r){return D.join(r,m(e))}const d={_driver:c.NODE_FS_DRIVER_NAME,_support:!0,_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?l.baseDir=r:l.baseDir=E.CYBERSKILL_STORAGE_DIRECTORY,yield o.mkdir(l.baseDir,{recursive:!0})}catch(r){throw s.log.error("[Storage:init]",r),r}})},clear(){return n(this,null,function*(){const{baseDir:e}=l;yield o.rm(e,{recursive:!0,force:!0}),yield o.mkdir(e,{recursive:!0})})},getItem(e){return n(this,null,function*(){const{baseDir:r}=l,t=R(e,r);try{const i=yield o.readFile(t,"utf8");return JSON.parse(i)}catch(i){if(i.code==="ENOENT")return null;throw i}})},iterate(e){return n(this,null,function*(){const r=yield d.keys();let t=1;for(const i of r){const y=yield d.getItem(i),h=e(y,i,t);if(h!==void 0)return h;t+=1}})},key(e){return n(this,null,function*(){var r;return(r=(yield d.keys())[e])!=null?r:null})},keys(){return n(this,null,function*(){const{baseDir:e}=l;try{return(yield o.readdir(e)).filter(t=>t.endsWith(c.STORAGE_KEY_EXTENSION)).map(N)}catch(r){if(r.code==="ENOENT")return[];throw r}})},length(){return n(this,null,function*(){return(yield d.keys()).length})},removeItem(e){return n(this,null,function*(){const{baseDir:r}=l,t=R(e,r);yield o.rm(t,{force:!0})})},setItem(e,r){return n(this,null,function*(){const{baseDir:t}=l,i=R(e,t);return yield o.mkdir(t,{recursive:!0}),yield o.writeFile(i,JSON.stringify(r),"utf8"),r})}};let a=null,S=null;function f(){return n(this,null,function*(){return a?(yield a,S):(a=n(null,null,function*(){yield g.defineDriver(d),l.baseDir=E.CYBERSKILL_STORAGE_DIRECTORY;const e=yield g.getDriver(c.NODE_FS_DRIVER_NAME),r={baseDir:l.baseDir,name:c.STORAGE_INSTANCE_NAME,storeName:c.STORAGE_STORE_NAME};yield e._initStorage(r),S=e}).catch(e=>{throw a=null,e}),yield a,S)})}const T={get(e){return n(this,null,function*(){try{const t=yield(yield f()).getItem(e);return t!=null?t:null}catch(r){return s.catchError(r,{returnValue:null})}})},set(e,r){return n(this,null,function*(){try{yield(yield f()).setItem(e,r)}catch(t){s.catchError(t)}})},remove(e){return n(this,null,function*(){try{yield(yield f()).removeItem(e)}catch(r){s.catchError(r)}})},keys(){return n(this,null,function*(){try{const r=yield(yield f()).keys();return Array.isArray(r)?r:(s.log.warn("[Storage:keys] Invalid keys response:",r),[])}catch(e){return s.catchError(e,{returnValue:[]})}})},getLogLink(e){return n(this,null,function*(){try{return`${D.join(E.CYBERSKILL_STORAGE_DIRECTORY,m(e))} (key: ${e})`}catch(r){return s.catchError(r,{returnValue:null})}})}};exports.storage=T;

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

@@ -2,8 +2,8 @@ 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";
+import { getEnv as N } from "../../config/env/env.util.js";
 var n = (e, r, t) => new Promise((i, d) => {
   var y = (u) => {
     try {

package/dist/node/upload/upload.util.js

@@ -1,7 +1,7 @@
 import { Buffer as w } from "node:buffer";
 import { Transform as C } from "node:stream";
 import { ReadableStream as D } from "node:stream/web";
-import { BYTES_PER_MB as R, DEFAULT_UPLOAD_CONFIG as h } from "./upload.constant.js";
+import { DEFAULT_UPLOAD_CONFIG as R, BYTES_PER_MB as h } from "./upload.constant.js";
 import { E_UploadType as p } from "./upload.type.js";
 import { dirname as x } from "../path/path.util.js";
 import { pathExistsSync as z, mkdirSync as A, createWriteStream as F } from "../fs/fs.util.js";
@@ -66,7 +66,7 @@ function G(t, r, e) {
     let n = a.sizeLimit;
     const l = new C({
       transform(f, d, y) {
-        n -= f.length, n < 0 ? y(new Error(`File size exceeds limit of ${a.sizeLimit / R}MB`)) : y(null, f);
+        n -= f.length, n < 0 ? y(new Error(`File size exceeds limit of ${a.sizeLimit / h}MB`)) : y(null, f);
       }
     }), m = o().pipe(l);
     return {
@@ -105,7 +105,7 @@ function U(t, r, e) {
   return { isValid: !0 };
 }
 function O(t) {
-  return _(_({}, h), t);
+  return _(_({}, R), t);
 }
 function W(t) {
   return E(this, null, function* () {

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

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

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

@@ -1,4 +1,13 @@
 import { I_EnvFlags, I_NodeEnvInput } from './common.type.js';
+/**
+ * Escapes special characters in a string for use in a regular expression.
+ * This function escapes characters that have special meaning in regex (e.g., ., *, +, ?, etc.)
+ * so they are treated as literal characters.
+ *
+ * @param str - The string to escape.
+ * @returns The escaped string safe for use in a RegExp.
+ */
+export declare function escapeRegExp(str: string): string;
 /**
  * Convert a string to a regex pattern that matches the string and its accented variations.
  * This function normalizes the input string and creates a regex pattern that can match

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

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

package/dist/util/common/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./common.util.cjs");exports.mapEnvironment=e.mapEnvironment;exports.regexSearchMapper=e.regexSearchMapper;exports.removeAccent=e.removeAccent;exports.uniqueArray=e.uniqueArray;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./common.util.cjs");exports.escapeRegExp=e.escapeRegExp;exports.mapEnvironment=e.mapEnvironment;exports.regexSearchMapper=e.regexSearchMapper;exports.removeAccent=e.removeAccent;exports.uniqueArray=e.uniqueArray;

package/dist/util/common/index.js

@@ -1,7 +1,8 @@
-import { mapEnvironment as n, regexSearchMapper as a, removeAccent as m, uniqueArray as o } from "./common.util.js";
+import { escapeRegExp as p, mapEnvironment as a, regexSearchMapper as n, removeAccent as c, uniqueArray as m } from "./common.util.js";
 export {
-  n as mapEnvironment,
-  a as regexSearchMapper,
-  m as removeAccent,
-  o as uniqueArray
+  p as escapeRegExp,
+  a as mapEnvironment,
+  n as regexSearchMapper,
+  c as removeAccent,
+  m 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.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;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./object/object.util.cjs"),r=require("./common/common.util.cjs"),t=require("./string/string.util.cjs"),a=require("./serializer/serializer.util.cjs"),i=require("./validate/validate.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;exports.escapeRegExp=r.escapeRegExp;exports.mapEnvironment=r.mapEnvironment;exports.regexSearchMapper=r.regexSearchMapper;exports.removeAccent=r.removeAccent;exports.uniqueArray=r.uniqueArray;exports.generateRandomPassword=t.generateRandomPassword;exports.generateShortId=t.generateShortId;exports.generateSlug=t.generateSlug;exports.getFileName=t.getFileName;exports.substringBetween=t.substringBetween;exports.serializer=a.serializer;exports.validate=i.validate;

package/dist/util/index.js

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

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

@@ -1 +1 @@
-"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;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var m=Object.defineProperty,A=Object.defineProperties,v=Object.getOwnPropertyDescriptors,f=Object.getOwnPropertySymbols,w=Object.prototype.hasOwnProperty,h=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={}))w.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},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 g(e,r,n,o){if(o>=r.length)return e;const t=r[o];if(o===r.length-1)return O(p({},e),{[t]:n});const s=e[t];return O(p({},e),{[t]:g(typeof s=="object"&&s!==null?s:{},r,n,o+1)})}function b(e,r,n){return r.length===0?e:g(e,r,n,0)}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 d(...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 l=s;for(const a in l)if(Object.prototype.hasOwnProperty.call(l,a)){const i=l[a];if(Object.prototype.hasOwnProperty.call(t,a)){const c=t[a];typeof i=="object"&&i!==null&&typeof c=="object"&&c!==null?Array.isArray(i)&&Array.isArray(c)?t[a]=c.concat(i):!Array.isArray(i)&&!Array.isArray(c)?t[a]=d(c,i):t[a]=i:t[a]=i}else t[a]=i}}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 j(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 l=o[s],a=t?`${t}.${s}`:s;if(l&&typeof l=="object"&&!Array.isArray(l)){let i=!1;for(const c in l)if(Object.prototype.hasOwnProperty.call(l,c)&&c.startsWith("$")){i=!0;break}i?r[a]=l:n(l,a)}else r[a]=l}}return n(e,""),r}exports.deepClone=u;exports.deepMerge=d;exports.getNestedValue=_;exports.isJSON=P;exports.normalizeMongoFilter=j;exports.setNestedValue=b;

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

@@ -1,11 +1,11 @@
-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) => {
+var A = Object.defineProperty, m = Object.defineProperties, d = Object.getOwnPropertyDescriptors, f = Object.getOwnPropertySymbols, v = Object.prototype.hasOwnProperty, w = Object.prototype.propertyIsEnumerable, u = (e, r, n) => r in e ? A(e, r, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[r] = n, y = (e, r) => {
   for (var n in r || (r = {}))
-    m.call(r, n) && y(e, n, r[n]);
+    v.call(r, n) && u(e, n, r[n]);
   if (f)
     for (var n of f(r))
-      h.call(r, n) && y(e, n, r[n]);
+      w.call(r, n) && u(e, n, r[n]);
   return e;
-}, p = (e, r) => d(e, g(r));
+}, p = (e, r) => m(e, d(r));
 function P(e) {
   try {
     return JSON.parse(e), !0;
@@ -25,23 +25,27 @@ function _(e, r) {
   }
   return n;
 }
-function v(e, r, n) {
-  if (r.length === 0)
+function g(e, r, n, o) {
+  if (o >= r.length)
     return e;
-  const [o, ...t] = r;
-  if (t.length === 0)
-    return p(u({}, e), {
-      [o]: n
+  const t = r[o];
+  if (o === r.length - 1)
+    return p(y({}, e), {
+      [t]: n
     });
-  const s = e[o];
-  return p(u({}, e), {
-    [o]: v(
+  const s = e[t];
+  return p(y({}, e), {
+    [t]: g(
       typeof s == "object" && s !== null ? s : {},
-      t,
-      n
+      r,
+      n,
+      o + 1
     )
   });
 }
+function b(e, r, n) {
+  return r.length === 0 ? e : g(e, r, n, 0);
+}
 function O(e) {
   if (e === null || typeof e != "object")
     return e;
@@ -59,7 +63,7 @@ function O(e) {
     Object.prototype.hasOwnProperty.call(e, o) && (n[o] = O(e[o]));
   return n;
 }
-function w(...e) {
+function h(...e) {
   if (e.length === 0)
     return {};
   const r = e.filter((t) => t != null);
@@ -72,18 +76,18 @@ function w(...e) {
   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];
+      const l = s;
+      for (const a in l)
+        if (Object.prototype.hasOwnProperty.call(l, a)) {
+          const i = l[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(
+            typeof i == "object" && i !== null && typeof c == "object" && c !== null ? Array.isArray(i) && Array.isArray(c) ? t[a] = c.concat(i) : !Array.isArray(i) && !Array.isArray(c) ? t[a] = h(
               c,
-              l
-            ) : t[a] = l : t[a] = l;
+              i
+            ) : t[a] = i : t[a] = i;
           } else
-            t[a] = l;
+            t[a] = i;
         }
     }
     return t;
@@ -101,7 +105,7 @@ function w(...e) {
     "deepMerge: Invalid arguments provided. All arguments must be objects or arrays of the same type."
   );
 }
-function b(e) {
+function j(e) {
   if (!e || typeof e != "object")
     return e;
   const r = {};
@@ -109,26 +113,26 @@ function b(e) {
     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;
+      const l = o[s], a = t ? `${t}.${s}` : s;
+      if (l && typeof l == "object" && !Array.isArray(l)) {
+        let i = !1;
+        for (const c in l)
+          if (Object.prototype.hasOwnProperty.call(l, c) && c.startsWith("$")) {
+            i = !0;
             break;
           }
-        l ? r[a] = i : n(i, a);
+        i ? r[a] = l : n(l, a);
       } else
-        r[a] = i;
+        r[a] = l;
     }
   }
   return n(e, ""), r;
 }
 export {
   O as deepClone,
-  w as deepMerge,
+  h as deepMerge,
   _ as getNestedValue,
   P as isJSON,
-  b as normalizeMongoFilter,
-  v as setNestedValue
+  j as normalizeMongoFilter,
+  b as setNestedValue
 };

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@cyberskill/shared",
     "type": "module",
-    "version": "2.27.0",
+    "version": "2.28.0",
     "description": "CyberSkill Shared",
     "author": "Stephen Cheng",
     "license": "MIT",
@@ -213,69 +213,69 @@
         "test:unit": "tsx src/node/cli/index.ts test:unit"
     },
     "dependencies": {
-        "@antfu/eslint-config": "7.1.0",
-        "@apollo/client": "4.1.0",
+        "@antfu/eslint-config": "7.4.3",
+        "@apollo/client": "4.1.5",
         "@apollo/client-integration-nextjs": "0.14.4",
-        "@apollo/server": "5.2.0",
+        "@apollo/server": "5.4.0",
         "@as-integrations/express5": "1.1.2",
-        "@dotenvx/dotenvx": "1.51.4",
+        "@dotenvx/dotenvx": "1.52.0",
         "@eddeee888/gcg-typescript-resolver-files": "0.15.0",
-        "@eslint-react/eslint-plugin": "2.7.2",
+        "@eslint-react/eslint-plugin": "2.13.0",
         "@graphql-codegen/cli": "6.1.1",
-        "@graphql-codegen/client-preset": "5.2.2",
-        "@nestjs/common": "11.1.12",
-        "@nestjs/core": "11.1.12",
+        "@graphql-codegen/client-preset": "5.2.3",
+        "@nestjs/common": "11.1.14",
+        "@nestjs/core": "11.1.14",
         "@userback/widget": "0.3.12",
-        "@vitejs/plugin-react-swc": "4.2.2",
+        "@vitejs/plugin-react-swc": "4.2.3",
         "body-parser": "2.2.2",
         "chalk": "5.6.2",
         "clsx": "2.1.1",
         "compression": "1.8.1",
         "consola": "3.4.2",
         "cookie-parser": "1.4.7",
-        "cors": "2.8.5",
+        "cors": "2.8.6",
         "date-fns": "4.1.0",
         "envalid": "8.1.1",
-        "eslint-plugin-format": "1.3.1",
+        "eslint-plugin-format": "1.4.0",
         "eslint-plugin-react-hooks": "7.0.1",
-        "eslint-plugin-react-refresh": "0.4.26",
+        "eslint-plugin-react-refresh": "0.5.0",
         "express": "5.2.1",
-        "express-session": "1.18.2",
-        "express-useragent": "2.0.2",
+        "express-session": "1.19.0",
+        "express-useragent": "2.1.0",
         "extract-files": "13.0.0",
         "fs-extra": "11.3.3",
-        "globals": "17.0.0",
+        "globals": "17.3.0",
         "graphql": "16.12.0",
         "graphql-upload": "17.0.0",
-        "graphql-ws": "6.0.6",
+        "graphql-ws": "6.0.7",
         "helmet": "8.1.0",
-        "i18next": "25.8.0",
-        "jsdom": "27.4.0",
+        "i18next": "25.8.11",
+        "jsdom": "28.1.0",
         "localforage": "1.10.0",
         "migrate-mongo": "14.0.7",
-        "mongodb": "7.0.0",
-        "mongoose": "9.1.5",
+        "mongodb": "7.1.0",
+        "mongoose": "9.2.1",
         "mongoose-aggregate-paginate-v2": "1.1.4",
         "mongoose-paginate-v2": "1.9.1",
-        "next-intl": "4.7.0",
+        "next-intl": "4.8.3",
         "node-fetch": "3.3.2",
-        "qs": "6.14.1",
-        "react": "19.2.3",
-        "react-dom": "19.2.3",
+        "qs": "6.15.0",
+        "react": "19.2.4",
+        "react-dom": "19.2.4",
         "react-hot-toast": "2.6.0",
-        "react-i18next": "16.5.3",
+        "react-i18next": "16.5.4",
         "rxjs": "7.8.2",
         "vite": "7.3.1",
         "ws": "8.19.0",
         "yargs": "18.0.0"
     },
     "devDependencies": {
-        "@commitlint/cli": "20.3.1",
-        "@commitlint/config-conventional": "20.3.1",
+        "@commitlint/cli": "20.4.2",
+        "@commitlint/config-conventional": "20.4.2",
         "@eslint/config-inspector": "1.4.2",
-        "@next/eslint-plugin-next": "16.1.4",
-        "@storybook/react": "10.1.11",
-        "@storybook/react-vite": "10.1.11",
+        "@next/eslint-plugin-next": "16.1.6",
+        "@storybook/react": "10.2.10",
+        "@storybook/react-vite": "10.2.10",
         "@testing-library/jest-dom": "6.9.1",
         "@testing-library/react": "16.3.2",
         "@types/body-parser": "1.19.6",
@@ -289,25 +289,25 @@
         "@types/fs-extra": "11.0.4",
         "@types/graphql-upload": "17.0.0",
         "@types/migrate-mongo": "10.0.6",
-        "@types/node": "25.0.9",
-        "@types/react": "19.2.9",
+        "@types/node": "25.3.0",
+        "@types/react": "19.2.14",
         "@types/react-dom": "19.2.3",
         "@types/ws": "8.18.1",
         "@types/yargs": "17.0.35",
-        "@vitest/browser": "4.0.17",
-        "eslint": "9.39.2",
-        "eslint-config-next": "16.1.4",
-        "glob": "13.0.0",
+        "@vitest/browser": "4.0.18",
+        "eslint": "10.0.0",
+        "eslint-config-next": "16.1.6",
+        "glob": "13.0.6",
         "lint-staged": "16.2.7",
-        "node-modules-inspector": "1.2.0",
+        "node-modules-inspector": "1.3.2",
         "npm-run-all2": "8.0.4",
-        "sass": "1.97.2",
+        "sass": "1.97.3",
         "simple-git-hooks": "2.13.1",
         "tsx": "4.21.0",
         "typescript": "5.9.3",
         "vite": "7.3.1",
         "vite-plugin-dts": "4.5.4",
-        "vitest": "4.0.17"
+        "vitest": "4.0.18"
     },
     "publishConfig": {
         "access": "public",