@cyberskill/shared 2.20.0 → 2.21.0

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

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

@@ -1,97 +1,130 @@
-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 d = Object.defineProperty, g = Object.defineProperties, m = Object.getOwnPropertyDescriptors, f = Object.getOwnPropertySymbols, A = Object.prototype.hasOwnProperty, v = Object.prototype.propertyIsEnumerable, u = (e, r, n) => r in e ? d(e, r, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[r] = n, y = (e, r) => {
+  for (var n in r || (r = {}))
+    A.call(r, n) && u(e, n, r[n]);
+  if (f)
+    for (var n of f(r))
+      v.call(r, n) && u(e, n, r[n]);
+  return e;
+}, p = (e, r) => g(e, m(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 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 _(r, e, t) {
-  if (e.length === 0)
-    return r;
-  const [n, ...o] = e;
-  if (o.length === 0)
-    return c(f({}, r), {
-      [n]: t
+function h(e, r, n) {
+  if (r.length === 0)
+    return e;
+  const [o, ...t] = r;
+  if (t.length === 0)
+    return p(y({}, e), {
+      [o]: n
     });
-  const s = r[n];
-  return c(f({}, r), {
-    [n]: _(
-      typeof s == "object" && s !== null ? s : {},
-      o,
-      t
+  const i = e[o];
+  return p(y({}, e), {
+    [o]: h(
+      typeof i == "object" && i !== null ? i : {},
+      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 i of r) {
+      const l = i;
+      for (const s in l)
+        if (Object.prototype.hasOwnProperty.call(l, s)) {
+          const a = l[s];
+          if (Object.prototype.hasOwnProperty.call(t, s)) {
+            const c = t[s];
+            typeof a == "object" && a !== null && typeof c == "object" && c !== null ? Array.isArray(a) && Array.isArray(c) ? t[s] = c.concat(a) : !Array.isArray(a) && !Array.isArray(c) ? t[s] = w(
+              c,
+              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 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("$")
+function _(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("$")
       ))
-        e[t] = n;
+        r[n] = o;
       else {
-        const s = g(n);
-        for (const [l, p] of Object.entries(s)) {
-          const y = `${t}.${l}`;
-          e[y] = p;
+        const i = _(o);
+        for (const [l, s] of Object.entries(i)) {
+          const a = `${n}.${l}`;
+          r[a] = s;
         }
       }
     else
-      e[t] = n;
-  return e;
+      r[n] = o;
+  return r;
 }
 export {
-  A as deepMerge,
-  P as getNestedValue,
-  w as isJSON,
-  g as normalizeMongoFilter,
-  _ as setNestedValue
+  O as deepClone,
+  w as deepMerge,
+  b as getNestedValue,
+  P as isJSON,
+  _ as normalizeMongoFilter,
+  h 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;
 /**

package/dist/util/string/string.util.js

@@ -1,59 +1,50 @@
-import a from "crypto-js";
-import { isObject as s } from "lodash-es";
-import u from "slugify";
-var c = Object.defineProperty, f = Object.getOwnPropertySymbols, d = Object.prototype.hasOwnProperty, m = Object.prototype.propertyIsEnumerable, i = (e, r, t) => r in e ? c(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t, g = (e, r) => {
-  for (var t in r || (r = {}))
-    d.call(r, t) && i(e, t, r[t]);
-  if (f)
-    for (var t of f(r))
-      m.call(r, t) && i(e, t, r[t]);
-  return e;
-};
-const p = u.default || u;
-function h(e, r) {
-  const t = (n) => {
-    var o, l;
-    return p(n != null ? n : "", g({
-      lower: (o = r == null ? void 0 : r.lower) != null ? o : !0,
-      locale: (l = r == null ? void 0 : r.locale) != null ? l : "vi"
-    }, r));
-  };
-  if (s(e)) {
+import { removeAccent as c } from "../common/common.util.js";
+function l(t, r) {
+  let e = t.trim();
+  return e = c(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 a(t, r) {
+  const e = (n) => l(n != null ? n : "", r);
+  if (typeof t == "object" && t !== null) {
     const n = {};
-    for (const [o, l] of Object.entries(e))
-      n[o] = t(l);
+    for (const [o, s] of Object.entries(t))
+      n[o] = e(s);
     return n;
   }
-  return t(e);
+  return e(t);
 }
-function v(e, r = 4) {
-  return a.SHA256(e).toString(a.enc.Hex).slice(0, r);
+function f(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 w(e = 8) {
+function u(t = 8) {
   const r = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()_+[]{}|;:,.<>?";
-  return Array.from({ length: e }, () => {
-    const t = Math.floor(Math.random() * r.length);
-    return r.charAt(t);
+  return Array.from({ length: t }, () => {
+    const e = Math.floor(Math.random() * r.length);
+    return r.charAt(e);
   }).join("");
 }
-function x(e = "", r = !1) {
-  const t = e.split(/[?#]/)[0] || "", n = t.substring(t.lastIndexOf("/") + 1);
+function g(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 P(e, r, t) {
-  const n = e.indexOf(r);
+function d(t, r, e) {
+  const n = t.indexOf(r);
   if (n === -1)
     return "";
-  const o = n + r.length, l = e.indexOf(t, o);
-  return l === -1 ? "" : e.slice(o, l);
+  const o = n + r.length, s = t.indexOf(e, o);
+  return s === -1 ? "" : t.slice(o, s);
 }
 export {
-  w as generateRandomPassword,
-  v as generateShortId,
-  h as generateSlug,
-  x as getFileName,
-  P as substringBetween
+  u as generateRandomPassword,
+  f as generateShortId,
+  a as generateSlug,
+  g as getFileName,
+  d as substringBetween
 };

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

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

package/dist/util/validate/validate.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i={isEmpty(t){return t==null?!0:typeof t=="string"?t.trim().length===0:Array.isArray(t)?t.length===0:typeof t=="object"?t instanceof Date?!1:t instanceof Map||t instanceof Set?t.size===0:t instanceof WeakMap||t instanceof WeakSet?!0:ArrayBuffer.isView(t)?t.byteLength===0:Object.keys(t).length===0:!1},isValidIP(t){const r=t.split(".");return r.length===4&&r.every(e=>/^\d+$/.test(e)&&Number(e)>=0&&Number(e)<=255)?!0:/^(([a-f\d]{1,4}:){7}[a-f\d]{1,4}|((?:[a-f\d]{1,4}:){1,7}:)|((?:[a-f\d]{1,4}:){1,6}:[a-f\d]{1,4})|::)$/i.test(t)}};exports.validate=i;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r={isEmpty(d){return d==null?!0:typeof d=="string"?d.trim().length===0:Array.isArray(d)?d.length===0:typeof d=="object"?d instanceof Date?!1:d instanceof Map||d instanceof Set?d.size===0:d instanceof WeakMap||d instanceof WeakSet?!0:ArrayBuffer.isView(d)?d.byteLength===0:Object.keys(d).length===0:!1},isValidIP(d){const e=d.split(".");return e.length===4&&e.every(t=>/^\d+$/.test(t)&&Number(t)>=0&&Number(t)<=255)?!0:/^(?:(?:[a-fA-F\d]{1,4}:){7}(?:[a-fA-F\d]{1,4}|:)|(?:[a-fA-F\d]{1,4}:){6}(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|:[a-fA-F\d]{1,4}|:)|(?:[a-fA-F\d]{1,4}:){5}(?::(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,2}|:)|(?:[a-fA-F\d]{1,4}:){4}(?:(?::[a-fA-F\d]{1,4}){0,1}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,3}|:)|(?:[a-fA-F\d]{1,4}:){3}(?:(?::[a-fA-F\d]{1,4}){0,2}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,4}|:)|(?:[a-fA-F\d]{1,4}:){2}(?:(?::[a-fA-F\d]{1,4}){0,3}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,5}|:)|(?:[a-fA-F\d]{1,4}:){1}(?:(?::[a-fA-F\d]{1,4}){0,4}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,6}|:)|(?::(?:(?::[a-fA-F\d]{1,4}){0,5}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,7}|:)))(?:%[0-9a-zA-Z]{1,})?$/.test(d)}};exports.validate=r;

package/dist/util/validate/validate.util.js

@@ -1,4 +1,4 @@
-const i = {
+const e = {
   /**
    * Checks if a value is empty.
    * This function provides comprehensive empty checking for different data types:
@@ -15,8 +15,8 @@ const i = {
    * @param value - The value to check for emptiness.
    * @returns True if the value is empty, false otherwise.
    */
-  isEmpty(t) {
-    return t == null ? !0 : typeof t == "string" ? t.trim().length === 0 : Array.isArray(t) ? t.length === 0 : typeof t == "object" ? t instanceof Date ? !1 : t instanceof Map || t instanceof Set ? t.size === 0 : t instanceof WeakMap || t instanceof WeakSet ? !0 : ArrayBuffer.isView(t) ? t.byteLength === 0 : Object.keys(t).length === 0 : !1;
+  isEmpty(d) {
+    return d == null ? !0 : typeof d == "string" ? d.trim().length === 0 : Array.isArray(d) ? d.length === 0 : typeof d == "object" ? d instanceof Date ? !1 : d instanceof Map || d instanceof Set ? d.size === 0 : d instanceof WeakMap || d instanceof WeakSet ? !0 : ArrayBuffer.isView(d) ? d.byteLength === 0 : Object.keys(d).length === 0 : !1;
   },
   /**
    * Checks if a string is a valid IP address (IPv4 or IPv6).
@@ -27,13 +27,13 @@ const i = {
    * @param ip - The IP address string to validate.
    * @returns True if the IP is valid IPv4 or IPv6, false otherwise.
    */
-  isValidIP(t) {
-    const e = t.split(".");
-    return e.length === 4 && e.every(
-      (r) => /^\d+$/.test(r) && Number(r) >= 0 && Number(r) <= 255
-    ) ? !0 : /^(([a-f\d]{1,4}:){7}[a-f\d]{1,4}|((?:[a-f\d]{1,4}:){1,7}:)|((?:[a-f\d]{1,4}:){1,6}:[a-f\d]{1,4})|::)$/i.test(t);
+  isValidIP(d) {
+    const f = d.split(".");
+    return f.length === 4 && f.every(
+      (t) => /^\d+$/.test(t) && Number(t) >= 0 && Number(t) <= 255
+    ) ? !0 : /^(?:(?:[a-fA-F\d]{1,4}:){7}(?:[a-fA-F\d]{1,4}|:)|(?:[a-fA-F\d]{1,4}:){6}(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|:[a-fA-F\d]{1,4}|:)|(?:[a-fA-F\d]{1,4}:){5}(?::(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,2}|:)|(?:[a-fA-F\d]{1,4}:){4}(?:(?::[a-fA-F\d]{1,4}){0,1}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,3}|:)|(?:[a-fA-F\d]{1,4}:){3}(?:(?::[a-fA-F\d]{1,4}){0,2}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,4}|:)|(?:[a-fA-F\d]{1,4}:){2}(?:(?::[a-fA-F\d]{1,4}){0,3}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,5}|:)|(?:[a-fA-F\d]{1,4}:){1}(?:(?::[a-fA-F\d]{1,4}){0,4}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,6}|:)|(?::(?:(?::[a-fA-F\d]{1,4}){0,5}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,7}|:)))(?:%[0-9a-zA-Z]{1,})?$/.test(d);
   }
 };
 export {
-  i as validate
+  e as validate
 };