@cyberskill/shared 1.198.0 → 1.200.0

package/dist/src/react/storage/storage.util.js

@@ -0,0 +1,60 @@
+var c = (r, t, a) => new Promise((y, u) => {
+  var i = (e) => {
+    try {
+      s(a.next(e));
+    } catch (m) {
+      u(m);
+    }
+  }, l = (e) => {
+    try {
+      s(a.throw(e));
+    } catch (m) {
+      u(m);
+    }
+  }, s = (e) => e.done ? y(e.value) : Promise.resolve(e.value).then(i, l);
+  s((a = a.apply(r, t)).next());
+});
+import o from "localforage";
+import { catchError as n } from "../log/log.util.js";
+const p = {
+  get(r) {
+    return c(this, null, function* () {
+      try {
+        return yield o.getItem(r);
+      } catch (t) {
+        return n(t, { returnValue: null });
+      }
+    });
+  },
+  set(r, t) {
+    return c(this, null, function* () {
+      try {
+        yield o.setItem(r, t);
+      } catch (a) {
+        n(a);
+      }
+    });
+  },
+  remove(r) {
+    return c(this, null, function* () {
+      try {
+        yield o.removeItem(r);
+      } catch (t) {
+        n(t);
+      }
+    });
+  },
+  keys() {
+    return c(this, null, function* () {
+      try {
+        const r = yield o.keys();
+        return r != null ? r : [];
+      } catch (r) {
+        return n(r, { returnValue: [] });
+      }
+    });
+  }
+};
+export {
+  p as storage
+};

package/dist/src/react/toast/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react-hot-toast");Object.defineProperty(exports,"Toaster",{enumerable:!0,get:()=>e.Toaster});Object.defineProperty(exports,"toast",{enumerable:!0,get:()=>e.toast});

package/dist/src/react/toast/index.d.ts

@@ -0,0 +1 @@
+export { toast, Toaster } from 'react-hot-toast';

package/dist/src/react/toast/index.js

@@ -0,0 +1,5 @@
+import { Toaster as r, toast as a } from "react-hot-toast";
+export {
+  r as Toaster,
+  a as toast
+};

package/dist/src/react/userback/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./userback.component.cjs");exports.Userback=e.Userback;

package/dist/src/react/userback/index.d.ts

@@ -0,0 +1,2 @@
+export * from './userback.component.js';
+export * from './userback.type.js';

package/dist/src/react/userback/index.js

@@ -0,0 +1,4 @@
+import { Userback as o } from "./userback.component.js";
+export {
+  o as Userback
+};

package/dist/src/react/userback/userback.component.cjs

@@ -0,0 +1 @@
+"use strict";var i=Object.getOwnPropertySymbols;var b=Object.prototype.hasOwnProperty,h=Object.prototype.propertyIsEnumerable;var d=(r,u)=>{var e={};for(var t in r)b.call(r,t)&&u.indexOf(t)<0&&(e[t]=r[t]);if(r!=null&&i)for(var t of i(r))u.indexOf(t)<0&&h.call(r,t)&&(e[t]=r[t]);return e};var f=(r,u,e)=>new Promise((t,o)=>{var l=c=>{try{n(e.next(c))}catch(s){o(s)}},a=c=>{try{n(e.throw(c))}catch(s){o(s)}},n=c=>c.done?t(c.value):Promise.resolve(c.value).then(l,a);n((e=e.apply(r,u)).next())});Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("@userback/widget"),y=require("react");function g({token:r,options:u}){return y.useEffect(()=>{if(!r)return;let e;return f(null,null,function*(){const a=u||{},{hide:o}=a,l=d(a,["hide"]);yield m(r,l),o&&o.length>0&&o.forEach(n=>{document.querySelectorAll(n).forEach(c=>c.remove())}),e=new MutationObserver(()=>{o&&o.length>0&&o.forEach(n=>{document.querySelectorAll(n).forEach(c=>c.remove())})}),e.observe(document.body,{childList:!0,subtree:!0})}),()=>{e==null||e.disconnect()}},[r,u]),null}exports.Userback=g;

package/dist/src/react/userback/userback.component.d.ts

@@ -0,0 +1,2 @@
+import { I_UserBackProps } from './userback.type.js';
+export declare function Userback({ token, options }: I_UserBackProps): null;

package/dist/src/react/userback/userback.component.js

@@ -0,0 +1,54 @@
+var i = Object.getOwnPropertySymbols;
+var m = Object.prototype.hasOwnProperty, h = Object.prototype.propertyIsEnumerable;
+var s = (r, n) => {
+  var e = {};
+  for (var t in r)
+    m.call(r, t) && n.indexOf(t) < 0 && (e[t] = r[t]);
+  if (r != null && i)
+    for (var t of i(r))
+      n.indexOf(t) < 0 && h.call(r, t) && (e[t] = r[t]);
+  return e;
+};
+var d = (r, n, e) => new Promise((t, o) => {
+  var l = (c) => {
+    try {
+      u(e.next(c));
+    } catch (f) {
+      o(f);
+    }
+  }, a = (c) => {
+    try {
+      u(e.throw(c));
+    } catch (f) {
+      o(f);
+    }
+  }, u = (c) => c.done ? t(c.value) : Promise.resolve(c.value).then(l, a);
+  u((e = e.apply(r, n)).next());
+});
+import b from "@userback/widget";
+import { useEffect as E } from "react";
+function v({ token: r, options: n }) {
+  return E(() => {
+    if (!r)
+      return;
+    let e;
+    return d(null, null, function* () {
+      const a = n || {}, { hide: o } = a, l = s(a, ["hide"]);
+      yield b(r, l), o && o.length > 0 && o.forEach((u) => {
+        document.querySelectorAll(u).forEach((c) => c.remove());
+      }), e = new MutationObserver(() => {
+        o && o.length > 0 && o.forEach((u) => {
+          document.querySelectorAll(u).forEach((c) => c.remove());
+        });
+      }), e.observe(document.body, {
+        childList: !0,
+        subtree: !0
+      });
+    }), () => {
+      e == null || e.disconnect();
+    };
+  }, [r, n]), null;
+}
+export {
+  v as Userback
+};

package/dist/src/react/userback/userback.type.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/react/userback/userback.type.d.ts

@@ -0,0 +1,8 @@
+import { UserbackOptions } from '@userback/widget';
+export interface I_UserBackOptions extends UserbackOptions {
+    hide: string[];
+}
+export interface I_UserBackProps {
+    token?: string;
+    options?: I_UserBackOptions;
+}

package/dist/src/react/userback/userback.type.js

@@ -0,0 +1 @@
+

package/dist/src/typescript/common.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var t=(e=>(e.PRODUCTION="production",e.STAGING="staging",e.DEVELOPMENT="development",e))(t||{});exports.E_Environment=t;

package/dist/src/typescript/common.d.ts

@@ -0,0 +1,35 @@
+import { default as consola } from 'consola';
+export type T_Object<T = unknown> = Record<string, T>;
+export interface I_Log {
+    silent: typeof consola['silent'];
+    level: typeof consola['level'];
+    fatal: typeof consola['fatal'];
+    error: typeof consola['error'];
+    warn: typeof consola['warn'];
+    log: typeof consola['log'];
+    info: typeof consola['info'];
+    success: typeof consola['success'];
+    ready: typeof consola['ready'];
+    start: typeof consola['start'];
+    box: typeof consola['box'];
+    debug: typeof consola['debug'];
+    trace: typeof consola['trace'];
+    verbose: typeof consola['verbose'];
+}
+export interface I_ReturnSuccess<T, E = unknown> {
+    success: true;
+    result: T & E;
+    message?: string;
+    code?: number | string;
+}
+export interface I_ReturnFailure {
+    success: false;
+    message: string;
+    code: number | string;
+}
+export type I_Return<T = void, E = unknown> = I_ReturnSuccess<T, E> | I_ReturnFailure;
+export declare enum E_Environment {
+    PRODUCTION = "production",
+    STAGING = "staging",
+    DEVELOPMENT = "development"
+}

package/dist/src/typescript/common.js

@@ -0,0 +1,4 @@
+var p = /* @__PURE__ */ ((e) => (e.PRODUCTION = "production", e.STAGING = "staging", e.DEVELOPMENT = "development", e))(p || {});
+export {
+  p as E_Environment
+};

package/dist/src/typescript/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./common.cjs");exports.E_Environment=e.E_Environment;

package/dist/src/typescript/index.d.ts

@@ -0,0 +1,2 @@
+export * from './common.js';
+export * from './react.js';

package/dist/src/typescript/index.js

@@ -0,0 +1,4 @@
+import { E_Environment as r } from "./common.js";
+export {
+  r as E_Environment
+};

package/dist/src/typescript/react.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/typescript/react.d.ts

@@ -0,0 +1,5 @@
+import { JSX, ReactElement, ReactNode } from 'react';
+export type T_Children = ReactNode | ReactNode[] | ReactElement | JSX.Element | null;
+export interface I_Children {
+    children: T_Children;
+}

package/dist/src/typescript/react.js

@@ -0,0 +1 @@
+

package/dist/src/typescript/style.d.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/typescript/style.d.js

@@ -0,0 +1 @@
+

package/dist/src/util/common/common.type.cjs

@@ -0,0 +1 @@
+"use strict";

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

@@ -0,0 +1,9 @@
+export interface I_NodeEnvInput {
+    NODE_ENV?: string;
+    NODE_ENV_MODE?: string;
+}
+export interface I_EnvFlags {
+    IS_DEV: boolean;
+    IS_STAG: boolean;
+    IS_PROD: boolean;
+}

package/dist/src/util/common/common.type.js

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1,26 @@
+import { I_EnvFlags, I_NodeEnvInput } from './common.type.js';
+/**
+ * Convert a string to a regex pattern that matches the string and its accented variations.
+ * @param str - The string to convert.
+ * @returns The regex pattern as a string.
+ */
+export declare function regexSearchMapper(str: string): string;
+/**
+ * Remove accents from a string.
+ * @param str - The string to remove accents from.
+ * @returns The string without accents.
+ */
+export declare function removeAccent(str: string): string;
+/**
+ * Remove duplicates from an array based on a key function.
+ * @param arr - The array to remove duplicates from.
+ * @param keyFn - A function that returns a unique key for each item in the array.
+ * @returns A new array with duplicates removed.
+ */
+export declare function uniqueArray<T>(arr: T[], keyFn?: (item: T) => string | number): T[];
+/**
+ *
+ * @param env - The environment variables to map.
+ * @returns  An object containing flags for the environment.
+ */
+export declare function mapEnvironment(env: I_NodeEnvInput): I_EnvFlags;

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

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

package/dist/src/util/common/index.cjs

@@ -0,0 +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;

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

@@ -0,0 +1,2 @@
+export * from './common.type.js';
+export * from './common.util.js';

package/dist/src/util/common/index.js

@@ -0,0 +1,7 @@
+import { mapEnvironment as n, regexSearchMapper as a, removeAccent as m, uniqueArray as o } from "./common.util.js";
+export {
+  n as mapEnvironment,
+  a as regexSearchMapper,
+  m as removeAccent,
+  o as uniqueArray
+};

package/dist/src/util/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./common/common.util.cjs"),e=require("./object/object.util.cjs"),i=require("./serializer/serializer.util.cjs"),r=require("./string/string.util.cjs"),a=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.isObject=e.isObject;exports.setNestedValue=e.setNestedValue;exports.serializer=i.serializer;exports.generateRandomPassword=r.generateRandomPassword;exports.generateShortId=r.generateShortId;exports.generateSlug=r.generateSlug;exports.getFileName=r.getFileName;exports.substringBetween=r.substringBetween;exports.validate=a.validate;

package/dist/src/util/index.d.ts

@@ -0,0 +1,5 @@
+export * from './common/index.js';
+export * from './object/index.js';
+export * from './serializer/index.js';
+export * from './string/index.js';
+export * from './validate/index.js';

package/dist/src/util/index.js

@@ -0,0 +1,24 @@
+import { mapEnvironment as t, regexSearchMapper as o, removeAccent as a, uniqueArray as n } from "./common/common.util.js";
+import { deepClone as m, deepMerge as p, getNestedValue as g, isJson as i, isObject as d, setNestedValue as l } from "./object/object.util.js";
+import { serializer as x } from "./serializer/serializer.util.js";
+import { generateRandomPassword as c, generateShortId as v, generateSlug as N, getFileName as S, substringBetween as b } from "./string/string.util.js";
+import { validate as w } from "./validate/validate.util.js";
+export {
+  m as deepClone,
+  p as deepMerge,
+  c as generateRandomPassword,
+  v as generateShortId,
+  N as generateSlug,
+  S as getFileName,
+  g as getNestedValue,
+  i as isJson,
+  d as isObject,
+  t as mapEnvironment,
+  o as regexSearchMapper,
+  a as removeAccent,
+  x as serializer,
+  l as setNestedValue,
+  b as substringBetween,
+  n as uniqueArray,
+  w as validate
+};

package/dist/src/util/object/index.cjs

@@ -0,0 +1 @@
+"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.isObject=e.isObject;exports.setNestedValue=e.setNestedValue;

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

@@ -0,0 +1 @@
+export * from './object.util.js';

package/dist/src/util/object/index.js

@@ -0,0 +1,9 @@
+import { deepClone as t, deepMerge as d, getNestedValue as o, isJson as l, isObject as p, setNestedValue as r } from "./object.util.js";
+export {
+  t as deepClone,
+  d as deepMerge,
+  o as getNestedValue,
+  l as isJson,
+  p as isObject,
+  r as setNestedValue
+};

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

@@ -0,0 +1 @@
+"use strict";var g=Object.defineProperty,p=Object.defineProperties;var N=Object.getOwnPropertyDescriptors;var f=Object.getOwnPropertySymbols;var O=Object.prototype.hasOwnProperty,b=Object.prototype.propertyIsEnumerable;var l=(e,t,r)=>t in e?g(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r,o=(e,t)=>{for(var r in t||(t={}))O.call(t,r)&&l(e,r,t[r]);if(f)for(var r of f(t))b.call(t,r)&&l(e,r,t[r]);return e},i=(e,t)=>p(e,N(t));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function A(e){try{return JSON.parse(e),!0}catch(t){return!1}}function c(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function a(...e){const t={};for(const r of e.flat())for(const[n,u]of Object.entries(r)){const s=t[n];if(Array.isArray(u)){const y=Array.isArray(s)?s:[];t[n]=[...new Set([...y,...u])];continue}if(c(u)){t[n]=a(c(s)?s:{},u);continue}t[n]=u}return t}function S(e){return JSON.parse(JSON.stringify(e))}function V(e,t){return t.reduce((r,n)=>{if(r&&typeof r=="object"&&n in r)return r[n]},e)}function d(e,t,r){if(t.length===0)return e;const[n,...u]=t;if(u.length===0)return i(o({},e),{[n]:r});const s=e[n];return i(o({},e),{[n]:d(typeof s=="object"&&s!==null?s:{},u,r)})}exports.deepClone=S;exports.deepMerge=a;exports.getNestedValue=V;exports.isJson=A;exports.isObject=c;exports.setNestedValue=d;

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

@@ -0,0 +1,46 @@
+import { T_Object } from '../../typescript/common.js';
+/**
+ * Check if a string is a valid JSON string.
+ * @param str - The string to check.
+ * @returns True if the string is a valid JSON string, false otherwise.
+ */
+export declare function isJson(str: string): boolean;
+/**
+ * Checks if a value is an object.
+ * An object is an object that is not an array, null, or a function.
+ * @param val - The value to check.
+ * @returns True if the value is an object, false otherwise.
+ */
+export declare function isObject(val: unknown): val is T_Object;
+/**
+ * Merges multiple objects deeply.
+ * If a property is an array, it will be merged without duplicates.
+ * If a property is an object, it will be merged recursively.
+ * If a property is a primitive, it will be overwritten.
+ * @param objects - The objects to merge.
+ * @returns The merged object.
+ */
+export declare function deepMerge(...objects: T_Object[]): T_Object;
+/**
+ * This function uses JSON.stringify and JSON.parse to create a deep clone.
+ * This method is not suitable for objects with circular references or functions.
+ * @param obj - The object to clone.
+ * @returns A deep clone of the object.
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Gets a nested value from an object.
+ * @param obj - The object to get the value from.
+ * @param path - The path to the value.
+ * @returns The value at the specified path, or undefined if it does not exist.
+ */
+export declare function getNestedValue<T>(obj: T, path: (string | number)[]): unknown;
+/**
+ * Sets a nested value in an object.
+ * If the path does not exist, it will be created.
+ * @param obj - The object to set the value in.
+ * @param path - The path to the value.
+ * @param value - The value to set.
+ * @returns The updated object.
+ */
+export declare function setNestedValue<T>(obj: T, path: (string | number)[], value: unknown): T;

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

@@ -0,0 +1,77 @@
+var y = Object.defineProperty, d = Object.defineProperties;
+var p = Object.getOwnPropertyDescriptors;
+var f = Object.getOwnPropertySymbols;
+var g = Object.prototype.hasOwnProperty, A = Object.prototype.propertyIsEnumerable;
+var c = (e, r, t) => r in e ? y(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t, s = (e, r) => {
+  for (var t in r || (r = {}))
+    g.call(r, t) && c(e, t, r[t]);
+  if (f)
+    for (var t of f(r))
+      A.call(r, t) && c(e, t, r[t]);
+  return e;
+}, i = (e, r) => d(e, p(r));
+function S(e) {
+  try {
+    return JSON.parse(e), !0;
+  } catch (r) {
+    return !1;
+  }
+}
+function a(e) {
+  return typeof e == "object" && e !== null && !Array.isArray(e);
+}
+function N(...e) {
+  const r = {};
+  for (const t of e.flat())
+    for (const [n, u] of Object.entries(t)) {
+      const o = r[n];
+      if (Array.isArray(u)) {
+        const l = Array.isArray(o) ? o : [];
+        r[n] = [.../* @__PURE__ */ new Set([...l, ...u])];
+        continue;
+      }
+      if (a(u)) {
+        r[n] = N(
+          a(o) ? o : {},
+          u
+        );
+        continue;
+      }
+      r[n] = u;
+    }
+  return r;
+}
+function V(e) {
+  return JSON.parse(JSON.stringify(e));
+}
+function b(e, r) {
+  return r.reduce((t, n) => {
+    if (t && typeof t == "object" && n in t)
+      return t[n];
+  }, e);
+}
+function O(e, r, t) {
+  if (r.length === 0)
+    return e;
+  const [n, ...u] = r;
+  if (u.length === 0)
+    return i(s({}, e), {
+      [n]: t
+    });
+  const o = e[n];
+  return i(s({}, e), {
+    [n]: O(
+      typeof o == "object" && o !== null ? o : {},
+      u,
+      t
+    )
+  });
+}
+export {
+  V as deepClone,
+  N as deepMerge,
+  b as getNestedValue,
+  S as isJson,
+  a as isObject,
+  O as setNestedValue
+};

package/dist/src/util/serializer/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./serializer.util.cjs");exports.serializer=e.serializer;

package/dist/src/util/serializer/index.d.ts

@@ -0,0 +1,2 @@
+export * from './serializer.type.js';
+export * from './serializer.util.js';

package/dist/src/util/serializer/index.js

@@ -0,0 +1,4 @@
+import { serializer as i } from "./serializer.util.js";
+export {
+  i as serializer
+};

package/dist/src/util/serializer/serializer.type.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/util/serializer/serializer.type.d.ts

@@ -0,0 +1,16 @@
+export type T_SerializerKnownTypes = 'Date' | 'Map' | 'Set' | 'RegExp' | 'BigInt';
+export interface T_SerializerValueMap {
+    Date: Date;
+    Map: Map<unknown, unknown>;
+    Set: Set<unknown>;
+    RegExp: RegExp;
+    BigInt: bigint;
+}
+export interface I_SerializerTypeWrapper<T extends T_SerializerKnownTypes = T_SerializerKnownTypes> {
+    __type: T;
+    value: unknown;
+}
+export interface I_Serializer<T = unknown> {
+    serialize: (value: T) => string;
+    deserialize: (value: string) => T;
+}

package/dist/src/util/serializer/serializer.type.js

@@ -0,0 +1 @@
+

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

@@ -0,0 +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;

package/dist/src/util/serializer/serializer.util.d.ts

@@ -0,0 +1,2 @@
+import { I_Serializer } from './serializer.type.js';
+export declare const serializer: I_Serializer<unknown>;