cyberia 2.8.885

package/src/client/components/core/CommonJs.js

@@ -0,0 +1,1010 @@
+/**
+ * Common JavaScript functions
+ * @module src/client/components/core/CommonJs.js
+ * @namespace CommonJS
+ */
+
+/**
+ * The function `s4` generates a random hexadecimal string with a length of 4 characters.
+ * @memberof CommonJS
+ */
+const s4 = () => (((1 + Math.random()) * 0x10000) | 0).toString(16).substring(1);
+
+/**
+ * The `range` function generates an array of numbers within a specified range, handling both ascending
+ * and descending ranges.
+ * @param start - The `start` parameter in the `range` function represents the starting value of the
+ * range you want to generate.
+ * @param end - The `end` parameter in the `range` function represents the ending value of the range
+ * that you want to generate.
+ * @returns The `range` function returns an array containing a range of numbers starting from the
+ * `start` value up to the `end` value (inclusive). If `end` is less than `start`, it will recursively
+ * call the `range` function with the arguments swapped and then reverse the resulting array.
+ * @memberof CommonJS
+ */
+const range = (start, end) => {
+  return end < start
+    ? range(end, start).reverse()
+    : Array.apply(0, Array(end - start + 1)).map((element, index) => index + start);
+};
+
+/**
+ * The `getId` function generates a unique identifier based on an array of objects or keys.
+ * @param arr - The `arr` parameter in the `getId` function is an array of objects or an object. If it
+ * is an object, the function converts it into an array of objects where each object has a key
+ * specified by the `keyId` parameter.
+ * @param suffix - The `suffix` parameter in the `getId` function is a string that can be added to
+ * the generated ID. It is optional and by default is an empty string. You can provide a suffix to be
+ * appended to the generated ID if needed.
+ * @param keyId - The `keyId` parameter in the `getId` function is used to specify the key in the
+ * array elements that contains the unique identifier (ID) for each element. By default, the function
+ * assumes that the ID is stored in a property named `'id'`, but you can customize this by providing
+ * @returns The `getId` function returns a unique identifier `_id` based on the input array `arr`,
+ * optional `suffix`, and `keyId`.
+ * @memberof CommonJS
+ */
+const getId = (arr, suffix = '', keyId = 'id') => {
+  if (!Array.isArray(arr) && typeof arr === 'object')
+    arr = Object.keys(arr).map((id) => {
+      const idElement = {};
+      idElement[keyId] = id;
+      return idElement;
+    });
+  let _id;
+  while (arr.find((element) => element[keyId] === _id) || !_id)
+    _id = suffix + (s4() + s4() + s4() + s4() + s4()).slice(1);
+  return _id;
+};
+
+/**
+ * The function `random` generates a random integer within a specified range.
+ * @param min - The `min` parameter represents the minimum value of the range from which you want to
+ * generate a random number.
+ * @param max - The `max` parameter in the `random` function represents the maximum value that you want
+ * to generate a random number up to.
+ * @memberof CommonJS
+ */
+const random = (min, max) => Math.floor(Math.random() * (max - min + 1) + min); // The maximum is inclusive and the minimum is inclusive
+
+const randomHexColor = () => '#' + ((Math.random() * 0xffffff) << 0).toString(16).padStart(6, '0');
+
+const getRawCsvFromArray = (array) =>
+  array[0]
+    ? Object.keys(array[0]).join(';') +
+      '\r\n' +
+      array
+        .map((x) => {
+          return (
+            Object.keys(x)
+              .map((attr) => x[attr])
+              .join(';') + '\r\n'
+          );
+        })
+        .join('')
+    : '';
+
+const newInstance = (obj) => {
+  // structuredClone() 2022 ES6 feature
+  try {
+    return JSON.parse(JSON.stringify(obj));
+  } catch (error) {
+    return { error: error.message };
+  }
+};
+
+const cap = (str) =>
+  str
+    .toLowerCase()
+    .split(' ')
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+    .join(' ');
+
+const capFirst = (str) => str.charAt(0).toUpperCase() + str.slice(1);
+
+const uniqueArray = (arr) => arr.filter((item, pos) => arr.indexOf(item) == pos);
+
+const orderArrayFromAttrInt = (arr, attr, type) =>
+  // type -> true asc
+  // type -> false desc
+  type === 'asc' ? arr.sort((a, b) => a[attr] - b[attr]) : arr.sort((a, b) => b[attr] - a[attr]);
+
+const getRandomPoint = (suffix, pointsArray) => {
+  const point = pointsArray[random(0, pointsArray.length - 1)];
+  const returnPoint = {};
+  returnPoint['x' + suffix] = point[0];
+  returnPoint['y' + suffix] = point[1];
+  return returnPoint;
+};
+
+const getYouTubeID = (url) => {
+  const p =
+    /^(?:https?:\/\/)?(?:m\.|www\.)?(?:youtu\.be\/|youtube\.com\/(?:embed\/|v\/|watch\?v=|watch\?.+&v=))((\w|-){11})(?:\S+)?$/;
+  if (url.match(p)) return url.match(p)[1];
+  return false;
+};
+
+const timer = (ms) => new Promise((res) => setTimeout(res, ms));
+
+const reOrderIntArray = (array) => {
+  /* shuffle */
+  let currentIndex = array.length,
+    randomIndex;
+
+  // While there remain elements to shuffle.
+  while (currentIndex != 0) {
+    // Pick a remaining element.
+    randomIndex = Math.floor(Math.random() * currentIndex);
+    currentIndex--;
+
+    // And swap it with the current element.
+    [array[currentIndex], array[randomIndex]] = [array[randomIndex], array[currentIndex]];
+  }
+
+  return array;
+};
+
+const orderAbc = (arr, attr) =>
+  arr.sort((a, b) => {
+    if (attr) {
+      if (a[attr] < b[attr]) {
+        return -1;
+      }
+      if (a[attr] > b[attr]) {
+        return 1;
+      }
+    } else {
+      if (a < b) {
+        return -1;
+      }
+      if (a > b) {
+        return 1;
+      }
+    }
+    return 0;
+  });
+
+const JSONmatrix = (matrix) => {
+  if (Array.isArray(matrix))
+    return `[\r\n${matrix
+      .map((x, i) => `   ` + JSON.stringify(x) + (i === matrix.length - 1 ? '' : ',') + '\r\n')
+      .join('')}]`;
+  else
+    return `[\r\n${Object.keys(matrix)
+      .map((x, i) => `   ` + JSON.stringify(Object.values(matrix[x])) + (i === matrix.length - 1 ? '' : ',') + '\r\n')
+      .join('')}]`;
+};
+
+const getDistance = (x1, y1, x2, y2) => {
+  const disX = Math.abs(x2 - x1);
+  const disY = Math.abs(y2 - y1);
+  return Math.sqrt(disX * disX + disY * disY);
+};
+
+const setPad = (num, padValue, targetLength, endPad, separator) => {
+  separator = separator ? separator : '.';
+  let str = String(num).split(separator);
+  let removeSeparator = false;
+  if (!str[1]) {
+    str[1] = '';
+    if (!endPad) removeSeparator = true;
+  }
+  while (endPad ? str[1].length < targetLength : str[0].length < targetLength)
+    endPad ? (str[1] = str[1] + padValue) : (str[0] = padValue + str[0]);
+  return removeSeparator ? str.join(separator).replace(separator, '') : str.join(separator);
+};
+
+/**
+ * Decimal setting of a number.
+ *
+ * @param {String} type The type of setting.
+ * @param {Number} value The number.
+ * @param {Integer} exp The exponent (the log 10 of the base fit).
+ * @returns {Number} The adjusted value.
+ * @memberof CommonJS
+ */
+const decimalAdjust = (type, value, exp) => {
+  if (typeof exp === 'undefined' || +exp === 0) {
+    return Math[type](value);
+  }
+  value = +value;
+  exp = +exp;
+
+  if (isNaN(value) || !(typeof exp === 'number' && exp % 1 === 0)) {
+    return NaN;
+  }
+  // Shift
+  value = value.toString().split('e');
+  value = Math[type](+(value[0] + 'e' + (value[1] ? +value[1] - exp : -exp)));
+  // Shift back
+  value = value.toString().split('e');
+  return +(value[0] + 'e' + (value[1] ? +value[1] + exp : exp));
+
+  // https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Math/round
+};
+
+const floatRound = (v, d) => parseFloat(parseFloat(v).toFixed(d));
+
+// Decimal round
+
+const round10 = (value, exp) => {
+  return decimalAdjust('round', value, exp);
+};
+
+// Decimal floor
+
+const floor10 = (value, exp) => {
+  return decimalAdjust('floor', value, exp);
+};
+
+// Decimal ceil
+
+const ceil10 = (value, exp) => {
+  return decimalAdjust('ceil', value, exp);
+};
+
+// // Round
+// round10(55.55, -1);   // 55.6
+// round10(55.549, -1);  // 55.5
+// round10(55, 1);       // 60
+// round10(54.9, 1);     // 50
+// round10(-55.55, -1);  // -55.5
+// round10(-55.551, -1); // -55.6
+// round10(-55, 1);      // -50
+// round10(-55.1, 1);    // -60
+// round10(1.005, -2);   // 1.01 -- compare this with round(1.005*100)/100 above
+// // Floor
+// floor10(55.59, -1);   // 55.5
+// floor10(59, 1);       // 50
+// floor10(-55.51, -1);  // -55.6
+// floor10(-51, 1);      // -60
+// // Ceil
+// ceil10(55.51, -1);    // 55.6
+// ceil10(51, 1);        // 60
+// ceil10(-55.59, -1);   // -55.5
+// ceil10(-59, 1);       // -50
+
+function objectEquals(x, y) {
+  // TODO:
+  // https://www.npmjs.com/package/deep-equal
+  // https://www.npmjs.com/package/fast-deep-equal
+  const ok = Object.keys,
+    tx = typeof x,
+    ty = typeof y;
+  return x && y && tx === 'object' && tx === ty
+    ? ok(x).length === ok(y).length && ok(x).every((key) => objectEquals(x[key], y[key]))
+    : x === y;
+}
+
+function insertTransitionCoordinates(coordinates, transitionFactor) {
+  // Create a new array to store the resulting coordinates
+  const coordinatesWithTransition = [];
+
+  // Iterate over the coordinates array
+  for (let i = 0; i < coordinates.length - 1; i++) {
+    const [x1, y1] = coordinates[i];
+    const [x2, y2] = coordinates[i + 1];
+
+    // Add the initial integer coordinate to the new array
+    coordinatesWithTransition.push([x1, y1]);
+
+    // Calculate the increments for each coordinate
+    const incrementX = (x2 - x1) / transitionFactor;
+    const incrementY = (y2 - y1) / transitionFactor;
+
+    // Add the intermediate coordinates
+    for (let j = 1; j <= transitionFactor - 1; j++) {
+      const xIntermediate = x1 + incrementX * j;
+      const yIntermediate = y1 + incrementY * j;
+      coordinatesWithTransition.push([xIntermediate, yIntermediate]);
+    }
+  }
+
+  // Add the last integer coordinate to the new array
+  coordinatesWithTransition.push(coordinates[coordinates.length - 1]);
+
+  // Now, coordinatesWithTransition contains the coordinates with transition
+  return coordinatesWithTransition;
+}
+
+const getIsoDate = (date) => date.toISOString().slice(0, -5).replace('T', ' ');
+
+const clearTerminalStringColor = (str) => str.replace(/\x1b\[[0-9;]*m/g, '');
+
+function getValueFromJoinString(obj, path, join = '.') {
+  // Split the path string into an array of attribute names
+  const attributes = path.split(join);
+
+  // Iterate through the attributes to access the desired value
+  let value = obj;
+  for (let i = 0; i < attributes.length; i++) {
+    value = value[attributes[i]];
+
+    // Check if the value is null or undefined at each step
+    if (value === null || value === undefined) {
+      // If the value is null or undefined, stop the iteration
+      break;
+    }
+  }
+
+  return value;
+}
+
+function getDirection(options = { x1: 1, y1: 1, x2: 1, y2: 1, radians: 1 }) {
+  const { x1, y1, x2, y2, radians } = options;
+  // Calculate the angle in radians
+  const angle = radians !== undefined ? radians : Math.atan2(y2 - y1, x2 - x1);
+
+  // Convert the angle to degrees
+  let degrees = angle * (180 / Math.PI);
+
+  // Adjust the angle to be positive
+  if (degrees < 0) {
+    degrees += 360;
+  }
+
+  // 45 / 2 = 22.5
+  // formula -> 22.5 + (45*n)
+
+  // Map the angle to one of the eight directions
+  let direction;
+  if (degrees >= 337.5 || degrees < 22.5) {
+    // direction = 'right';
+    // direction = 'East';
+    direction = 'e';
+  } else if (degrees >= 22.5 && degrees < 67.5) {
+    // direction = 'up-right';
+    // direction = 'South East';
+    direction = 'se';
+  } else if (degrees >= 67.5 && degrees < 112.5) {
+    // direction = 'up';
+    // direction = 'South';
+    direction = 's';
+  } else if (degrees >= 112.5 && degrees < 157.5) {
+    // direction = 'up-left';
+    // direction = 'South West';
+    direction = 'sw';
+  } else if (degrees >= 157.5 && degrees < 202.5) {
+    // direction = 'left';
+    // direction = 'West';
+    direction = 'w';
+  } else if (degrees >= 202.5 && degrees < 247.5) {
+    // direction = 'down-left';
+    // direction = 'North West';
+    direction = 'nw';
+  } else if (degrees >= 247.5 && degrees < 292.5) {
+    // direction = 'down';
+    // direction = 'North';
+    direction = 'n';
+  } else if (degrees >= 292.5 && degrees < 337.5) {
+    // direction = 'down-right';
+    // direction = 'North East';
+    direction = 'ne';
+  }
+
+  return direction;
+}
+
+// Function to amplify a matrix in horizontal and vertical directions
+const amplifyMatrix = (matrix, factor) => {
+  // Get the original dimensions of the matrix
+  const rows = matrix.length;
+  const cols = matrix[0].length;
+
+  // Create a new amplified matrix filled with zeros
+  const amplifiedMatrix = Array.from({ length: rows * factor }, () => Array(cols * factor).fill(0));
+
+  // Iterate over the original matrix
+  for (let i = 0; i < rows; i++) {
+    for (let j = 0; j < cols; j++) {
+      // Get the current value in the original matrix
+      const originalValue = matrix[i][j];
+
+      // Amplify in horizontal and vertical directions
+      for (let x = 0; x < factor; x++) {
+        for (let y = 0; y < factor; y++) {
+          // Assign the amplified value to the new matrix
+          amplifiedMatrix[i * factor + x][j * factor + y] = originalValue;
+        }
+      }
+    }
+  }
+
+  return amplifiedMatrix;
+};
+
+// Function to reduce a matrix by a factor in horizontal and vertical directions
+const reduceMatrix = (matrix, factor) => {
+  // Get the original dimensions of the matrix
+  const rows = matrix.length;
+  const cols = matrix[0].length;
+
+  // Calculate the dimensions of the reduced matrix
+  const reducedRows = Math.ceil(rows / factor);
+  const reducedCols = Math.ceil(cols / factor);
+
+  // Create a new reduced matrix filled with zeros
+  const reducedMatrix = Array.from({ length: reducedRows }, () => Array(reducedCols).fill(0));
+
+  // Iterate over the original matrix
+  for (let i = 0; i < reducedRows; i++) {
+    for (let j = 0; j < reducedCols; j++) {
+      // Calculate the sum of values in the corresponding block of the original matrix
+      let sum = 0;
+
+      for (let x = 0; x < factor; x++) {
+        for (let y = 0; y < factor; y++) {
+          // Safely access the original matrix considering the boundaries
+          const rowIndex = i * factor + x;
+          const colIndex = j * factor + y;
+
+          if (rowIndex < rows && colIndex < cols) {
+            sum += matrix[rowIndex][colIndex];
+          }
+        }
+      }
+
+      // Calculate the average value for the reduced matrix
+      reducedMatrix[i][j] = sum / Math.min(factor * factor, rows * cols);
+    }
+  }
+
+  return reducedMatrix;
+};
+
+const mergeMatrices = (input) => {
+  const rows = Object.keys(input).reduce((acc, key) => {
+    const rowData = Object.keys(input[key]).reduce((rowAcc, subKey) => {
+      const subArray = input[key][subKey];
+      const rowIndex = parseInt(key, 10) * subArray.length;
+      subArray.forEach((subRow, subRowIndex) => {
+        const fullRowIndex = rowIndex + subRowIndex;
+        if (!rowAcc[fullRowIndex]) {
+          rowAcc[fullRowIndex] = [];
+        }
+        rowAcc[fullRowIndex] = rowAcc[fullRowIndex].concat(subRow);
+      });
+      return rowAcc;
+    }, []);
+    acc = acc.concat(rowData);
+    return acc;
+  }, []);
+
+  // Remove empty rows
+  const nonEmptyRows = rows.filter((row) => row.some((cell) => cell !== undefined));
+
+  // Remove empty columns
+  const transpose = nonEmptyRows[0].map((col, i) => nonEmptyRows.map((row) => row[i]));
+  const nonEmptyColumns = transpose.filter((col) => col.some((cell) => cell !== undefined));
+
+  // Transpose back to rows
+  const result = nonEmptyColumns[0].map((row, i) => nonEmptyColumns.map((col) => col[i]));
+
+  return result;
+};
+
+const titleFormatted = (str) => cap(str.trim().replaceAll('/', '').replaceAll('-', ' '));
+
+const getSubpaths = (path) =>
+  path
+    .split('/')
+    .filter(Boolean)
+    .map((_, i, segments) => `/${segments.slice(0, i + 1).join('/')}`);
+
+function formatBytes(bytes, decimals = 2) {
+  if (!+bytes) return '0 Bytes';
+
+  const k = 1024;
+  const dm = decimals < 0 ? 0 : decimals;
+  const sizes = ['Bytes', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];
+
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
+}
+
+function getDirname(path) {
+  // Split the path based on the path separator
+  const parts = path.split(/[/|\\]/);
+
+  // Remove the last element (filename)
+  parts.pop();
+
+  // If the path ends with a separator, remove the empty element
+  if (parts[parts.length - 1] === '') {
+    parts.pop();
+  }
+
+  // Join the remaining parts to get the directory path
+  return parts.join('/'); // Adjust separator if needed for Windows ('\')
+}
+
+const isValidDate = (day, month, year) => {
+  if (!month && !year) return !(new Date(day) == 'Invalid Date');
+  // new Date('2025-12-28')
+  // Sat Dec 27 2025 19:00:00 GMT-0500 (Eastern Standard Time)
+  // new Date('2025/12/28')
+  // Sun Dec 28 2025 00:00:00 GMT-0500 (Eastern Standard Time)
+  return !(new Date(`${year}/${month}/${day}`) == 'Invalid Date');
+};
+
+// console.log(req.body.timeZoneClient, Intl.DateTimeFormat().resolvedOptions().timeZone);
+// DateTime.fromISO("2017-05-15T09:10:23", { zone: "Europe/Paris" });
+const strToDateUTC = (date = '2025-01-30T14:32') => {
+  const year = parseInt(date.split('-')[0]);
+  const month = parseInt(date.split('-')[1]);
+  const day = parseInt(date.split('-')[2].split('T')[0]);
+  const hour = parseInt(date.split('T')[1].split(':')[0]);
+  const minute = parseInt(date.split('T')[1].split(':')[1]);
+  date = new Date(Date.UTC(year, month - 1, day, hour, minute, 0, 0));
+  return date;
+};
+
+const isValidFormat = (value, format) => {
+  try {
+    switch (format) {
+      case 'ALPHANUMERIC':
+        return /^[a-z0-9]+$/i.test(value);
+      case 'DDMMYYYY': {
+        const day = parseInt(value.substring(0, 2));
+        const month = parseInt(value.substring(2, 4));
+        const year = parseInt(value.substring(4));
+        return isValidDate(day, month, year);
+      }
+      case 'YYYYDDMM': {
+        const day = parseInt(value.substring(4, 6));
+        const month = parseInt(value.substring(6, 8));
+        const year = parseInt(value.substring(0, 4));
+        return isValidDate(day, month, year);
+      }
+      case 'DD-MM-YYYY': {
+        value = value.split('-');
+        const day = parseInt(value[0]);
+        const month = parseInt(value[1]);
+        const year = parseInt(value[2]);
+        return isValidDate(day, month, year);
+      }
+
+      default:
+        return false;
+    }
+  } catch (error) {
+    console.error(error);
+    return false;
+  }
+};
+
+const getCurrentTrace = () => {
+  try {
+    _stack;
+  } catch (error) {
+    return error.stack;
+  }
+};
+
+/**
+ * Returns the time difference between UTC time and local time, in minutes.
+ * @memberof CommonJS
+ */
+const getTimezoneOffset = () => new Date().getTimezoneOffset();
+
+// https://unicode-explorer.com/c/<unicode>
+// example: https://unicode-explorer.com/c/0000
+function cleanString(string) {
+  // Define the problematic escape sequences unicode characters to remove with descriptions
+  const problematicCharacters = [
+    // '\u0000', // Null character (Represents absence of a character) not work
+    '\u0008', // Backspace character
+    '\u0002', // Start of Text (STX) character
+    '\u0009', // Horizontal Tab character
+    '\u000B', // Vertical Tab character
+    '\u000C', // Form Feed character
+    '\u000D', // Carriage Return character
+    '\u001D', // Group Separator (GS) character
+    '\u001F', // Substitution character
+    // '\u0020', // Space character
+    '\u200B', // Zero Width Space character
+    '\u200C', // Zero Width Non-Joiner character
+    '\u200D', // Zero Width Joiner character
+    '\u200F', // Right-to-Left Mark character
+    '\u2028', // Left-to-Right Mark character
+    '\u2060', // Word Spacing character
+    '\u2061', // Word Joiner character
+    '\u2062', // Invisible Text Character character
+    '\u2063', // Inhibit Explicit Word Joining character
+    '\u2064', // Invisible Text Processing character
+  ];
+
+  // Replace each problematic character with an empty string
+  return problematicCharacters.reduce((cleanString, character) => {
+    const charRegex = new RegExp(character, 'g'); // Regular expression for character
+    return cleanString.replace(charRegex, ''); // Replace with empty string
+  }, string);
+}
+
+function splitEveryXChar(originalString, everyXChar = 30, nextCharSplit) {
+  let modifiedString = '';
+  const arrayString = [];
+  let i = -1;
+  let charSplit = false;
+  for (let char of originalString) {
+    i++;
+    modifiedString += char;
+    if (i !== 0 && i % everyXChar === 0) charSplit = true;
+    if (modifiedString.length >= everyXChar && charSplit && (!nextCharSplit || nextCharSplit.includes(char))) {
+      arrayString.push(newInstance(modifiedString));
+      modifiedString = '';
+      charSplit = false;
+    }
+  }
+  if (modifiedString) arrayString.push(modifiedString);
+  return arrayString;
+}
+
+const getMostFrequentValue = (arr) =>
+  arr.sort((a, b) => arr.filter((v) => v === a).length - arr.filter((v) => v === b).length).pop();
+
+const getFillMatrix = (maxX, maxY, value = 0) =>
+  new Array(maxY).fill().map(() => new Array(maxX).fill().map(() => value));
+
+function validatePassword(password) {
+  let errors = [];
+  if (!/[a-z]/.test(password))
+    errors.push({ en: 'must contain at least one lowercase letter', es: 'debe contener al menos una letra minúscula' });
+  if (!/[A-Z]/.test(password))
+    errors.push({ en: 'must contain at least one uppercase letter', es: 'debe contener al menos una letra mayúscula' });
+  if (!/\d/.test(password))
+    errors.push({ en: 'must contain at least one number', es: 'debe contener al menos un número' });
+  if (!/[@#$-%^&*()_+{}\[\]:;<>,.!?\/\\|`~]/.test(password))
+    errors.push({
+      en: 'must contain at least one special character',
+      es: 'debe contener al menos un carácter especial',
+    });
+  if (password.length < 8)
+    errors.push({ en: 'must be at least 8 characters long', es: 'debe tener al menos 8 caracteres de largo' });
+
+  return errors;
+}
+
+function componentFromStr(numStr, percent) {
+  const num = Math.max(0, parseInt(numStr, 10));
+  return percent ? Math.floor((255 * Math.min(100, num)) / 100) : Math.min(255, num);
+}
+
+const isChileanIdentityDocument = function (rutCompleto) {
+  const dv = function (T) {
+    let M = 0,
+      S = 1;
+    for (; T; T = Math.floor(T / 10)) S = (S + (T % 10) * (9 - (M++ % 6))) % 11;
+    return S ? S - 1 : 'k';
+  };
+  rutCompleto = rutCompleto.replace('‐', '-');
+  if (!/^[0-9]+[-|‐]{1}[0-9kK]{1}$/.test(rutCompleto)) return false;
+  var tmp = rutCompleto.split('-');
+  var digv = tmp[1];
+  var rut = tmp[0];
+  if (digv == 'K') digv = 'k';
+  return dv(rut) == digv;
+};
+
+function rgbToHex(rgb) {
+  const rgbRegex = /^rgb\(\s*(-?\d+)(%?)\s*,\s*(-?\d+)(%?)\s*,\s*(-?\d+)(%?)\s*\)$/;
+  let result,
+    r,
+    g,
+    b,
+    hex = '';
+  if ((result = rgbRegex.exec(rgb))) {
+    r = componentFromStr(result[1], result[2]);
+    g = componentFromStr(result[3], result[4]);
+    b = componentFromStr(result[5], result[6]);
+
+    hex = '' + (0x1000000 + (r << 16) + (g << 8) + b).toString(16).slice(1);
+  }
+  return hex;
+}
+
+const getCapVariableName = (value = 'default') => cap(value.replaceAll('-', ' ')).replaceAll(' ', '');
+
+const hexToNumber = (hex = 0xdc) => Number(hex) || parseFloat(hex, 16);
+
+const numberToHex = (number = 0) => number.toString(16);
+
+const generateRandomPasswordSelection = (length) => {
+  const _random = (arr) => {
+    const rand = Math.floor(Math.random() * arr.length);
+    return arr[rand];
+  };
+
+  const uppercase = [
+    'A',
+    'B',
+    'C',
+    'D',
+    'E',
+    'F',
+    'G',
+    'H',
+    'I',
+    'J',
+    'K',
+    'L',
+    'M',
+    'N',
+    'O',
+    'P',
+    'Q',
+    'R',
+    'S',
+    'T',
+    'U',
+    'V',
+    'W',
+    'X',
+    'Y',
+    'Z',
+  ];
+  const lowercase = [
+    'a',
+    'b',
+    'c',
+    'd',
+    'e',
+    'f',
+    'g',
+    'h',
+    'i',
+    'j',
+    'k',
+    'l',
+    'm',
+    'n',
+    'o',
+    'p',
+    'q',
+    'r',
+    's',
+    't',
+    'u',
+    'v',
+    'w',
+    'x',
+    'y',
+    'z',
+  ];
+  const special = [
+    '~',
+    '!',
+    '@',
+    '#',
+    '$',
+    '%',
+    '^',
+    '&',
+    '*',
+    '(',
+    ')',
+    '_',
+    '+',
+    '-',
+    '=',
+    '{',
+    '}',
+    '[',
+    ']',
+    ':',
+    ';',
+    '?',
+    ',',
+    '.',
+    '|',
+    '\\',
+  ];
+  const numbers = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9'];
+
+  const nonSpecial = [...uppercase, ...lowercase, ...numbers];
+
+  let password = '';
+
+  for (let i = 0; i < length; i++) {
+    // Previous character is a special character
+    if (i !== 0 && special.includes(password[i - 1])) {
+      password += _random(nonSpecial);
+    } else password += _random([...nonSpecial, ...special]);
+  }
+
+  return password;
+};
+
+// 0x = Hexadecimal
+// 0b = Binary
+// 0o = Octal
+
+const commitData = {
+  feat: {
+    description: 'New feature or enhancement (frontend, backend, API, or UX)',
+    title: 'Features',
+    emoji: '✨',
+  },
+  fix: {
+    description: 'Fix a bug',
+    title: 'Bug Fixes',
+    emoji: '🐛',
+  },
+  docs: {
+    description: 'Documentation changes',
+    title: 'Documentation',
+    emoji: '📚',
+  },
+  style: {
+    description: 'Formatting, whitespace, semicolons, code style',
+    title: 'Styles',
+    emoji: '💎',
+  },
+  refactor: {
+    description: 'Code refactor.',
+    title: 'Code Refactoring',
+    emoji: '📦',
+  },
+  perf: {
+    description: 'Performance improvements across the stack.',
+    title: 'Performance Improvements',
+    emoji: '⚡️',
+  },
+  ci: {
+    description: 'CI pipeline changes (GitHub Actions, runners, caching)',
+    title: 'Continuous Integration',
+    emoji: '⚙️',
+  },
+  cd: {
+    description: 'CD / deployment changes (Remote ssh deployment scripts)',
+    title: 'Continuous Delivery',
+    emoji: '🚀',
+  },
+  infra: {
+    description: 'Infrastructure changes (MAAS, LXD, cloud infra, networking, provisioning).',
+    title: 'Infrastructure',
+    emoji: '🏗️',
+  },
+  build: {
+    description: 'Build system or dependency changes (tooling, bundler, build scripts).',
+    title: 'Builds',
+    emoji: '🛠',
+  },
+  test: {
+    description: 'Unit or integration tests added/updated, test helpers, flake fixes.',
+    title: 'Tests',
+    emoji: '🚨',
+  },
+  chore: {
+    description: "Other changes that don't modify src or tests (automation, housekeeping).",
+    title: 'Chores',
+    emoji: '♻️',
+  },
+  revert: {
+    description: 'Revert a previous commit or change.',
+    title: 'Reverts',
+    emoji: '🗑',
+  },
+  backup: {
+    description: 'Backups, snapshotting, restore scripts, or backup docs.',
+    title: 'Backups',
+    emoji: '💾',
+  },
+};
+
+const emotionsData = [
+  {
+    name: 'like',
+    ad_display: {
+      es: 'Me gusta',
+      en: 'Like',
+    },
+    emoji: '👍',
+  },
+  {
+    name: 'love',
+    ad_display: {
+      es: 'Me encanta',
+      en: 'Love',
+    },
+    emoji: '❤️',
+  },
+  {
+    name: 'haha',
+    ad_display: {
+      es: 'Me divierte',
+      en: 'Haha',
+    },
+    emoji: '😂',
+  },
+  {
+    name: 'wow',
+    ad_display: {
+      es: 'Me asombra',
+      en: 'Wow',
+    },
+    emoji: '😮',
+  },
+  {
+    name: 'sad',
+    ad_display: {
+      es: 'Me entristece',
+      en: 'Sad',
+    },
+    emoji: '😢',
+  },
+  {
+    name: 'angry',
+    ad_display: {
+      es: 'Me enoja',
+      en: 'Angry',
+    },
+    emoji: '😠',
+  },
+];
+
+const userRoleEnum = ['admin', 'moderator', 'user', 'guest'];
+const commonAdminGuard = (role) => userRoleEnum.indexOf(role) === userRoleEnum.indexOf('admin');
+const commonModeratorGuard = (role) => userRoleEnum.indexOf(role) <= userRoleEnum.indexOf('moderator');
+
+export {
+  s4,
+  range,
+  random,
+  newInstance,
+  cap,
+  uniqueArray,
+  orderArrayFromAttrInt,
+  getYouTubeID,
+  timer,
+  getRawCsvFromArray,
+  reOrderIntArray,
+  capFirst,
+  orderAbc,
+  getDistance,
+  decimalAdjust,
+  round10,
+  floor10,
+  ceil10,
+  JSONmatrix,
+  getRandomPoint,
+  objectEquals,
+  floatRound,
+  getId,
+  insertTransitionCoordinates,
+  randomHexColor,
+  clearTerminalStringColor,
+  getIsoDate,
+  getValueFromJoinString,
+  getDirection,
+  amplifyMatrix,
+  reduceMatrix,
+  mergeMatrices,
+  titleFormatted,
+  setPad,
+  getSubpaths,
+  formatBytes,
+  getDirname,
+  isValidDate,
+  isValidFormat,
+  strToDateUTC,
+  getTimezoneOffset,
+  cleanString,
+  splitEveryXChar,
+  getMostFrequentValue,
+  getFillMatrix,
+  validatePassword,
+  componentFromStr,
+  rgbToHex,
+  getCapVariableName,
+  hexToNumber,
+  numberToHex,
+  generateRandomPasswordSelection,
+  commonAdminGuard,
+  commonModeratorGuard,
+  isChileanIdentityDocument,
+  getCurrentTrace,
+  userRoleEnum,
+  commitData,
+  emotionsData,
+};