@cyberskill/shared 1.198.0 → 1.200.0

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

@@ -0,0 +1,75 @@
+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 = {
+  /**
+   * Serializes a value to a JSON string.
+   * If the value is of a known type (Date, Map, Set, RegExp, BigInt),
+   * it will be serialized using the corresponding handler.
+   * Otherwise, it will be serialized as is.
+   *
+   * @param value - The value to serialize.
+   * @returns The serialized JSON string.
+   */
+  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;
+    });
+  },
+  /**
+   * Deserializes a JSON string to its original value.
+   * If the value is of a known type (Date, Map, Set, RegExp, BigInt),
+   * it will be deserialized using the corresponding handler.
+   * Otherwise, it will be deserialized as is.
+   *
+   * @param json - The JSON string to deserialize.
+   * @returns The deserialized value.
+   */
+  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;
+    });
+  }
+};
+export {
+  a as serializer
+};

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

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

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

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

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

@@ -0,0 +1,8 @@
+import { generateRandomPassword as t, generateShortId as a, generateSlug as g, getFileName as n, substringBetween as o } from "./string.util.js";
+export {
+  t as generateRandomPassword,
+  a as generateShortId,
+  g as generateSlug,
+  n as getFileName,
+  o as substringBetween
+};

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

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

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

@@ -0,0 +1,8 @@
+export interface I_SlugifyOptions {
+    replacement?: string;
+    remove?: RegExp;
+    lower?: boolean;
+    strict?: boolean;
+    locale?: string;
+    trim?: boolean;
+}

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

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1,39 @@
+import { I_SlugifyOptions } from './string.type.js';
+/**
+ * Generates a slug from a string or an object containing strings.
+ * The slug is a URL-friendly version of the string.
+ * @param input - The string or object to be slugified.
+ * @param options - Options for slugification.
+ * @returns The slugified string or object.
+ */
+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.
+ * @param uuid - The UUID to be converted.
+ * @param length - The length of the short ID.
+ * @returns The short ID.
+ */
+export declare function generateShortId(uuid: string, length?: number): string;
+/**
+ * Generates a random password of a given length.
+ * The password contains a mix of letters, numbers, and special characters.
+ * @param length - The length of the password.
+ * @returns The generated password.
+ */
+export declare function generateRandomPassword(length?: number): string;
+/**
+ * Get the file name from a URL.
+ * @param url - The URL to extract the file name from.
+ * @param getExtension - Whether to include the file extension.
+ * @returns The file name.
+ */
+export declare function getFileName(url?: string, getExtension?: boolean): string;
+/**
+ * Extracts a substring between two strings.
+ * @param s - The original string.
+ * @param a - The starting string.
+ * @param b - The ending string.
+ * @returns The substring between the two strings.
+ */
+export declare function substringBetween(s: string, a: string, b: string): string;

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,27 @@
+export declare const validate: {
+    /**
+     * Checks if a value is empty.
+     * - For strings, it checks if the string is empty or contains only whitespace.
+     * - For arrays, it checks if the array has no elements.
+     * - For objects, it checks if the object has no own properties.
+     * - For Maps and Sets, it checks if they are empty.
+     * - For WeakMaps and WeakSets, it returns true (as they are not enumerable).
+     * - For ArrayBuffer views, it checks if the byte length is 0.
+     * - For Dates, it returns false.
+     * - For null and undefined, it returns true.
+     * - For all other types, it returns false.
+     * @param value - The value to check.
+     * @returns True if the value is empty, false otherwise.
+     */
+    isEmpty(value: unknown): boolean;
+    /**
+     * Checks if a string is a valid IP address (IPv4 or IPv6).
+     *
+     * - IPv4: Four octets separated by dots, each between 0–255.
+     * - IPv6: Eight groups of four hex digits, possibly compressed with `::`.
+     *
+     * @param ip - The IP address string to validate.
+     * @returns True if the IP is valid IPv4 or IPv6.
+     */
+    isValidIP(ip: string): boolean;
+};

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

@@ -0,0 +1,37 @@
+const i = {
+  /**
+   * Checks if a value is empty.
+   * - For strings, it checks if the string is empty or contains only whitespace.
+   * - For arrays, it checks if the array has no elements.
+   * - For objects, it checks if the object has no own properties.
+   * - For Maps and Sets, it checks if they are empty.
+   * - For WeakMaps and WeakSets, it returns true (as they are not enumerable).
+   * - For ArrayBuffer views, it checks if the byte length is 0.
+   * - For Dates, it returns false.
+   * - For null and undefined, it returns true.
+   * - For all other types, it returns false.
+   * @param value - The value to check.
+   * @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;
+  },
+  /**
+   * Checks if a string is a valid IP address (IPv4 or IPv6).
+   *
+   * - IPv4: Four octets separated by dots, each between 0–255.
+   * - IPv6: Eight groups of four hex digits, possibly compressed with `::`.
+   *
+   * @param ip - The IP address string to validate.
+   * @returns True if the IP is valid IPv4 or IPv6.
+   */
+  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);
+  }
+};
+export {
+  i as validate
+};

package/dist/style.css

@@ -0,0 +1 @@
+._overlay_1ank4_1,._fullscreen_1ank4_1,._block_1ank4_2{z-index:999999;background:linear-gradient(135deg,#ffffff59,#ffffffb3);backdrop-filter:blur(20px) saturate(200%);display:flex;justify-content:center;align-items:center;width:100%;height:100%;animation:_overlay-fade-in_1ank4_1 .5s ease-out;border:1.5px solid rgba(255,255,255,.35);box-shadow:0 4px 32px #1f26872e,inset 0 1.5px 8px #ffffff40}._fullscreen_1ank4_1,._block_1ank4_2{pointer-events:none}._fullscreen_1ank4_1{position:fixed;inset:0}._block_1ank4_2{position:relative;width:auto;height:auto}._container_1ank4_35{display:flex;flex-direction:column;justify-content:center;align-items:center;position:relative;padding:1rem;gap:1.5rem;text-align:center}._container_1ank4_35 ._ring_1ank4_45{width:clamp(60px,10vw,150px);height:clamp(60px,10vw,150px);border:2px solid transparent;border-radius:50%;position:absolute;transition:transform .3s ease}._container_1ank4_35 ._ring_1ank4_45:nth-child(1){border-bottom:8px solid hsl(315,90%,60%);animation:_rotate1_1ank4_1 1s linear infinite}._container_1ank4_35 ._ring_1ank4_45:nth-child(2){border-bottom:8px solid hsl(345,90%,50%);animation:_rotate2_1ank4_1 1s linear infinite}._container_1ank4_35 ._ring_1ank4_45:nth-child(3){border-bottom:8px solid hsl(180,80%,40%);animation:_rotate3_1ank4_1 1s linear infinite}._container_1ank4_35 ._ring_1ank4_45:nth-child(4){border-bottom:8px solid hsl(40,100%,45%);animation:_rotate4_1ank4_1 1s linear infinite}._container_1ank4_35 ._message_1ank4_69{font-weight:700;color:#2f2f37;text-shadow:0 1px 2px rgba(255,255,255,.8);animation:_text-fade_1ank4_1 2s ease-in-out infinite alternate;word-break:break-word;hyphens:auto}@keyframes _rotate1_1ank4_1{0%{transform:rotateX(50deg) rotate(110deg)}to{transform:rotateX(50deg) rotate(470deg)}}@keyframes _rotate2_1ank4_1{0%{transform:rotateX(20deg) rotateY(50deg) rotate(20deg)}to{transform:rotateX(20deg) rotateY(50deg) rotate(380deg)}}@keyframes _rotate3_1ank4_1{0%{transform:rotateX(40deg) rotateY(130deg) rotate(450deg)}to{transform:rotateX(40deg) rotateY(130deg) rotate(90deg)}}@keyframes _rotate4_1ank4_1{0%{transform:rotateX(70deg) rotate(270deg)}to{transform:rotateX(70deg) rotate(630deg)}}@keyframes _text-fade_1ank4_1{0%{opacity:.6}to{opacity:1}}@keyframes _overlay-fade-in_1ank4_1{0%{opacity:0}to{opacity:1}}@media (prefers-reduced-motion: reduce){._ring_1ank4_45,._message_1ank4_69,._overlay_1ank4_1,._fullscreen_1ank4_1,._block_1ank4_2{animation:none!important}}._modal-backdrop_8fveh_1{position:fixed;inset:0;z-index:9999999;background-color:#0009;display:flex;align-items:center;justify-content:center;padding:1rem}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11{position:relative;background-color:#0f172a;color:#fff;max-width:80vw;width:100%;border-radius:.75rem;box-shadow:0 10px 20px #00000080;overflow:hidden;padding:2rem}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._btn-close_8fveh_22{position:absolute;top:.75rem;right:1rem;font-size:1.25rem;color:#fff;background:none;border:none;cursor:pointer;transition:color .2s}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._btn-close_8fveh_22:hover{color:#f87171}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._error-title_8fveh_36{font-size:1.75rem;font-weight:700;margin-bottom:1rem}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._error-title_8fveh_36 ._btn-retry_8fveh_41{background:linear-gradient(to right,#3b82f6,#06b6d4);color:#fff;font-weight:600;padding:.5rem 1.5rem;border-radius:.75rem;transition:background .3s ease;border:none;cursor:pointer}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._error-title_8fveh_36 ._btn-retry_8fveh_41:hover{background:linear-gradient(to right,#2563eb,#0891b2)}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._error-details_8fveh_54{background-color:#1e293b;text-align:left;font-size:.875rem;border-radius:.5rem;padding:1rem;margin-bottom:1.5rem;max-height:50vh;overflow-y:auto;border:1px solid #334155;display:flex;flex-direction:column;gap:.5rem}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._error-details_8fveh_54 pre{white-space:pre-wrap;word-break:break-word}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._error-details_8fveh_54 pre._main_8fveh_72{color:#fca5a5}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._error-details_8fveh_54 pre._network_8fveh_75{color:#fde68a}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._error-details_8fveh_54 pre._extra_8fveh_78{color:#67e8f9;overflow-x:auto;white-space:pre;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;background-color:#0f172a;padding:.5rem;border-radius:.375rem}._modal-backdrop_8fveh_1 ._modal-content_8fveh_11 ._error-details_8fveh_54 ul{padding-left:1rem;color:#fda4af;list-style:disc}

package/dist/tsconfig.base.json

@@ -0,0 +1,37 @@
+{
+    "compilerOptions": {
+        "target": "ES6",
+        "jsx": "react",
+        "lib": ["ESNext", "DOM", "DOM.Iterable"],
+        "useDefineForClassFields": true,
+        "emitDecoratorMetadata": true,
+        "experimentalDecorators": true,
+        "resolveJsonModule": true,
+        "allowJs": true,
+        "checkJs": true,
+        "strict": true,
+        "strictBindCallApply": true,
+        "strictFunctionTypes": true,
+        "strictNullChecks": true,
+        "strictPropertyInitialization": true,
+        "allowUnreachableCode": false,
+        "allowUnusedLabels": false,
+        "exactOptionalPropertyTypes": false,
+        "noFallthroughCasesInSwitch": true,
+        "noImplicitAny": true,
+        "noImplicitOverride": true,
+        "noImplicitThis": true,
+        "noPropertyAccessFromIndexSignature": true,
+        "noUncheckedIndexedAccess": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "useUnknownInCatchVariables": true,
+        "allowSyntheticDefaultImports": true,
+        "esModuleInterop": true,
+        "forceConsistentCasingInFileNames": true,
+        "isolatedModules": true,
+        "verbatimModuleSyntax": true,
+        "noUncheckedSideEffectImports": true,
+        "skipLibCheck": true
+    }
+}