@rzl-zone/utils-js 3.11.1 → 3.12.1-beta.0

package/dist/chunk-WETQI6HM.js

@@ -1,232 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-import { isURL } from './chunk-ONZFBJVW.js';
-import { normalizeString } from './chunk-BPYW5YL7.js';
-import { toStringArrayUnRecursive } from './chunk-22V4WP3H.js';
-import { isEmptyValue } from './chunk-UIAWUZ4H.js';
-import { isInteger } from './chunk-WVSPXFTY.js';
-import { normalizePathname } from './chunk-SZUNAEMR.js';
-import { isEmptyString } from './chunk-ULQPCIA2.js';
-import { assertIsArray } from './chunk-RZOGBYIS.js';
-import { safeStableStringify } from './chunk-AXDYWO67.js';
-import { isString, getPreciseType, isUndefined, isNonEmptyString, isFunction, isNumber, isError, isArray, isNil, isNull, isPlainObject, isBoolean, isNonEmptyArray } from './chunk-MSUW5VHZ.js';
-
-var constructURL = (baseUrl, queryParams, removeParams) => {
-  if (isString(baseUrl)) {
-    if (isEmptyString(baseUrl)) {
-      throw new TypeError(`First parameter (\`baseUrl\`) cannot be an empty-string.`);
-    }
-    baseUrl = normalizeString(baseUrl);
-  } else if (!isURL(baseUrl)) {
-    throw new TypeError(
-      `First parameter (\`baseUrl\`) must be of type an URL instance or a \`string\` and a non empty-string, but received: \`${getPreciseType(
-        baseUrl
-      )}\`, with current value: \`${safeStableStringify(baseUrl, {
-        keepUndefined: true
-      })}\`.`
-    );
-  }
-  if (!isUndefined(removeParams)) {
-    assertIsArray(removeParams, {
-      message: ({ currentType, validType }) => `Third parameter (\`removeParams\`) must be of type \`${validType} of strings\`, but received: \`${currentType}\`.`
-    });
-    if (!removeParams.every((param) => isNonEmptyString(param))) {
-      throw new TypeError(
-        `Third parameter (\`removeParams\`) must be of type \`array\` and contains \`string\` only and non empty-string.`
-      );
-    }
-  }
-  try {
-    if (!isUndefined(queryParams) && !isFunction(queryParams[Symbol.iterator])) {
-      throw new TypeError(
-        `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${getPreciseType(
-          queryParams
-        )}\`, with value: \`${safeStableStringify(queryParams, {
-          keepUndefined: true
-        })}\`.`
-      );
-    }
-    const urlInstance = new URL(baseUrl);
-    if (!isUndefined(queryParams)) {
-      const paramObject = Object.fromEntries(queryParams);
-      if (!isEmptyValue(paramObject)) {
-        const mergedParams = new URLSearchParams(urlInstance.search);
-        for (const [key, value] of Object.entries(paramObject)) {
-          if (!isNonEmptyString(value) && !isNumber(value, { includeNaN: true })) {
-            throw new TypeError(
-              `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${getPreciseType(
-                queryParams
-              )}\`, with value: \`${safeStableStringify(queryParams, {
-                keepUndefined: true
-              })}\`.`
-            );
-          }
-          mergedParams.set(key, String(value));
-        }
-        if (removeParams?.length) {
-          toStringArrayUnRecursive(removeParams).map((paramKey) => {
-            mergedParams.delete(paramKey);
-          });
-        }
-        urlInstance.search = mergedParams.toString();
-      }
-    }
-    removeParams?.forEach((param) => urlInstance.searchParams.delete(param));
-    return urlInstance;
-  } catch (error) {
-    if (isError(error)) throw error;
-    throw new Error(
-      "Failed to construct a valid URL in `constructURL()`, Error:" + error
-    );
-  }
-};
-
-var extractURLs = (url) => {
-  if (!isNonEmptyString(url)) return null;
-  let decoded;
-  try {
-    decoded = decodeURIComponent(url);
-  } catch {
-    return null;
-  }
-  const urlPattern = /https?:\/\/.*?(?=https?:\/\/|\s|$)/g;
-  const matches = decoded.match(urlPattern);
-  if (!matches) return null;
-  const cleaned = matches.map((url2) => url2.replace(/[.,;:!?)]*$/, "")).filter((url2) => {
-    try {
-      const u = new URL(url2);
-      return u.protocol === "http:" || u.protocol === "https:";
-    } catch {
-      return false;
-    }
-  });
-  return cleaned.length ? cleaned : null;
-};
-
-var getFirstPrefixPathname = (result, defaultValue = "/") => {
-  if (!isNonEmptyString(defaultValue)) {
-    throw new TypeError(
-      `Second parameter (\`defaultValue\`) must be of type \`string\` and not an \`empty-string\`, but received: \`${getPreciseType(
-        defaultValue
-      )}\`, with value: \`${safeStableStringify(defaultValue, {
-        keepUndefined: true
-      })}\`.`
-    );
-  }
-  if (isArray(result)) {
-    if (!result.every((item) => isString(item))) {
-      throw new TypeError(
-        `First parameter (\`result\`) must be of type \`string\` or \`array of string\`, but received: \`${getPreciseType(
-          result
-        )}\`, with value: \`${safeStableStringify(result, {
-          keepUndefined: true
-        })}\`.`
-      );
-    }
-    for (const item of result) {
-      const normalized = normalizePathname(item);
-      if (normalized !== "/") {
-        return normalized;
-      }
-    }
-    return normalizePathname(defaultValue);
-  }
-  if (isString(result)) {
-    const normalized = normalizePathname(result);
-    return normalized !== "/" ? normalized : normalizePathname(defaultValue);
-  }
-  if (!isNil(result)) {
-    throw new TypeError(
-      `First parameter (\`result\`) must be of type \`string\`, \`array-string\`, \`null\` or \`undefined\`, but received: \`${getPreciseType(
-        result
-      )}\`.`
-    );
-  }
-  return normalizePathname(defaultValue);
-};
-
-var getPrefixPathname = (url, base = null, options = {}) => {
-  const errors = [];
-  if (!isString(url) && !isArray(url)) {
-    errors.push(
-      `First parameter (\`url\`) must be of type \`string\` or \`array-string\`, but received: \`${getPreciseType(
-        url
-      )}\`.`
-    );
-  }
-  if (!isString(base) && !isArray(base) && !isNull(base)) {
-    errors.push(
-      `Second parameter (\`base\`) must be of type \`string\`, \`array-string\` or \`null\`, but received: \`${getPreciseType(
-        base
-      )}\`.`
-    );
-  }
-  if (!isPlainObject(options)) {
-    errors.push(
-      `Second parameter (\`options\`) must be of type \`plain-object\`, but received: \`${getPreciseType(
-        options
-      )}\`.`
-    );
-  }
-  const { levels = 1, removeDuplicates = true } = options;
-  if (!isInteger(levels) || isInteger(levels) && levels < 0) {
-    errors.push(
-      `Parameter \`levels\` property of the \`options\` (second parameter) must be of type \`integer-number\` and minimum is \`0\`, but received: \`${getPreciseType(
-        levels
-      )}\`, with value: \`${safeStableStringify(levels, {
-        keepUndefined: true
-      })}\`.`
-    );
-  }
-  if (!isBoolean(removeDuplicates)) {
-    errors.push(
-      `Parameter \`removeDuplicates\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: \`${getPreciseType(
-        removeDuplicates
-      )}\`.`
-    );
-  }
-  if (isNonEmptyArray(errors)) {
-    throw new TypeError(
-      `Invalid parameter(s) in \`getPrefixPathname\` function:
-- ${errors.join("\n- ")}`
-    );
-  }
-  function getLevel(singleUrl) {
-    const parts = normalizePathname(singleUrl).split("/").filter(Boolean);
-    return `/${parts.slice(0, levels).join("/")}`;
-  }
-  function processUrl(singleUrl) {
-    if (base) {
-      singleUrl = normalizePathname(singleUrl);
-      if (isArray(base)) {
-        for (const b of base) {
-          if (singleUrl.startsWith(normalizePathname(b))) {
-            return getLevel(singleUrl);
-          }
-        }
-      } else if (isNonEmptyString(base) && singleUrl.startsWith(normalizePathname(base))) {
-        return getLevel(singleUrl);
-      }
-      return null;
-    }
-    return getLevel(singleUrl);
-  }
-  if (isArray(url)) {
-    const result = url.map(processUrl).filter((r) => !isNull(r));
-    const uniqueResult = removeDuplicates ? [...new Set(result)] : result;
-    if (uniqueResult.length === 1) {
-      return uniqueResult[0];
-    }
-    return uniqueResult;
-  }
-  return processUrl(url);
-};
-
-export { constructURL, extractURLs, getFirstPrefixPathname, getPrefixPathname };

package/dist/chunk-WLOQQFDS.cjs

@@ -1,18 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-'use strict';
-
-var chunkSYHPSOUU_cjs = require('./chunk-SYHPSOUU.cjs');
-
-var isEmptyString = (value, options = {}) => {
-  return !chunkSYHPSOUU_cjs.isNonEmptyString(value, options);
-};
-
-exports.isEmptyString = isEmptyString;

package/dist/chunk-WVSPXFTY.js

@@ -1,14 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-function isInteger(value) {
-  return typeof value === "number" && Number.isInteger(value);
-}
-
-export { isInteger };

package/dist/chunk-WXFTVXBF.cjs

@@ -1,23 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-'use strict';
-
-var chunkSYHPSOUU_cjs = require('./chunk-SYHPSOUU.cjs');
-
-var assertIsString = (value, options = {}) => {
-  if (chunkSYHPSOUU_cjs.isString(value)) return;
-  chunkSYHPSOUU_cjs.resolveErrorMessageAssertions({
-    value,
-    options,
-    requiredValidType: "string"
-  });
-};
-
-exports.assertIsString = assertIsString;

package/dist/chunk-XPVTIGU2.cjs

@@ -1,113 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-'use strict';
-
-var chunkK5536YHG_cjs = require('./chunk-K5536YHG.cjs');
-var chunkGIKL4PUF_cjs = require('./chunk-GIKL4PUF.cjs');
-var chunk7FGNVDEV_cjs = require('./chunk-7FGNVDEV.cjs');
-var chunkDLS3G6WQ_cjs = require('./chunk-DLS3G6WQ.cjs');
-var chunkDAPAK2W3_cjs = require('./chunk-DAPAK2W3.cjs');
-var chunkSYHPSOUU_cjs = require('./chunk-SYHPSOUU.cjs');
-
-var findDuplicates = (values) => {
-  chunkDLS3G6WQ_cjs.assertIsArray(values, {
-    message: ({ currentType, validType }) => `First parameter (\`values\`) must be of type \`${validType}\` (array literal or instance), but received: \`${currentType}\`.`
-  });
-  const duplicates = [];
-  values.forEach((item, index) => {
-    for (let i = index + 1; i < values.length; i++) {
-      if (chunkGIKL4PUF_cjs.isEqual(item, values[i])) {
-        if (!duplicates.some((dup) => chunkGIKL4PUF_cjs.isEqual(dup, item))) {
-          duplicates.push(item);
-        }
-        break;
-      }
-    }
-  });
-  return duplicates;
-};
-
-var omitKeys = (object, keysToOmit) => {
-  if (!chunkSYHPSOUU_cjs.isPlainObject(object)) return {};
-  chunkDLS3G6WQ_cjs.assertIsArray(keysToOmit, {
-    message: ({ currentType, validType }) => `Second parameter (\`keysToOmit\`) must be of type \`${validType}\` (array literal or instance), but received: \`${currentType}\`.`
-  });
-  const duplicates = findDuplicates(keysToOmit);
-  if (duplicates.length > 0) {
-    throw new Error(
-      `Function "omitKeys" Error: Duplicate keys detected - \`${duplicates}\``
-    );
-  }
-  return Object.fromEntries(
-    Object.entries(object).filter(([key]) => !keysToOmit.includes(key))
-  );
-};
-
-var omitKeysDeep = (object, keysToOmit) => {
-  if (!chunkSYHPSOUU_cjs.isPlainObject(object)) return {};
-  chunkDLS3G6WQ_cjs.assertIsArray(keysToOmit, {
-    message: ({ currentType, validType }) => `Second parameter (\`keysToOmit\`) must be of type \`${validType}\` (array literal or instance), but received: \`${currentType}\`.`
-  });
-  const duplicates = findDuplicates(keysToOmit);
-  if (chunkSYHPSOUU_cjs.isNonEmptyArray(duplicates)) {
-    throw new Error(
-      `Function "omitKeysDeep" Error: Duplicate keys detected - \`${chunkDAPAK2W3_cjs.safeStableStringify(
-        duplicates,
-        {
-          keepUndefined: true
-        }
-      )}\`.`
-    );
-  }
-  const omitAtPath = (obj, pathParts) => {
-    if (!chunkSYHPSOUU_cjs.isObjectOrArray(obj)) return obj;
-    const [current, ...rest] = pathParts;
-    if (chunk7FGNVDEV_cjs.isEmptyArray(rest)) {
-      if (chunkSYHPSOUU_cjs.isArray(obj)) {
-        const index = parseInt(current);
-        if (!chunkSYHPSOUU_cjs.isNaN(index) && index in obj) {
-          obj.splice(index, 1);
-        }
-      } else {
-        delete obj[current];
-      }
-    } else {
-      const next = obj[current];
-      if (chunkSYHPSOUU_cjs.isObjectOrArray(next)) {
-        obj[current] = omitAtPath(next, rest);
-      }
-    }
-    return obj;
-  };
-  const deepRemoveEmptyObjects = (obj) => {
-    if (chunkSYHPSOUU_cjs.isArray(obj)) {
-      return obj.map(deepRemoveEmptyObjects).filter((item) => !(chunkSYHPSOUU_cjs.isObjectOrArray(item) && Object.keys(item).length === 0));
-    }
-    if (chunkSYHPSOUU_cjs.isObjectOrArray(obj)) {
-      const cleaned = Object.fromEntries(
-        Object.entries(obj).map(([k, v]) => [k, deepRemoveEmptyObjects(v)]).filter(
-          ([, v]) => !chunkSYHPSOUU_cjs.isUndefined(v) && !(chunkSYHPSOUU_cjs.isObjectOrArray(v) && Object.keys(v).length === 0)
-        )
-      );
-      return cleaned;
-    }
-    return obj;
-  };
-  const result = chunkK5536YHG_cjs.safeJsonParse(chunkDAPAK2W3_cjs.safeStableStringify(object));
-  for (const key of keysToOmit) {
-    const parts = key.split(".");
-    omitAtPath(result, parts);
-  }
-  return deepRemoveEmptyObjects(result);
-};
-
-exports.findDuplicates = findDuplicates;
-exports.omitKeys = omitKeys;
-exports.omitKeysDeep = omitKeysDeep;

package/dist/chunk-XX6RUGTM.cjs

@@ -1,18 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-'use strict';
-
-var chunkSYHPSOUU_cjs = require('./chunk-SYHPSOUU.cjs');
-
-function isFinite(value) {
-  return chunkSYHPSOUU_cjs.isNumber(value) && Number.isFinite(value);
-}
-
-exports.isFinite = isFinite;

package/dist/chunk-YWHHVDT4.js

@@ -1,13 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-var noop = () => {
-};
-
-export { noop };

package/dist/chunk-ZPDMWDGZ.cjs

@@ -1,101 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-'use strict';
-
-var chunkWLOQQFDS_cjs = require('./chunk-WLOQQFDS.cjs');
-var chunkSYHPSOUU_cjs = require('./chunk-SYHPSOUU.cjs');
-
-var capitalizeFirst = (string, options = {
-  lowerCaseNextRest: true,
-  trim: false
-}) => {
-  if (!chunkSYHPSOUU_cjs.isNonEmptyString(string)) return "";
-  if (!chunkSYHPSOUU_cjs.isPlainObject(options)) {
-    options = {};
-  }
-  const lowerCaseNextRest = options.lowerCaseNextRest !== false;
-  const trim = options.trim === true;
-  if (trim) string = string.trim();
-  return string[0].toUpperCase() + (lowerCaseNextRest ? string.slice(1).toLowerCase() : string.slice(1));
-};
-
-var capitalizeWords = (value, options = {
-  collapseSpaces: false,
-  trim: false
-}) => {
-  if (!chunkSYHPSOUU_cjs.isNonEmptyString(value)) return "";
-  let result = value;
-  if (!chunkSYHPSOUU_cjs.isPlainObject(options)) {
-    options = {};
-  }
-  const collapseSpaces = options.collapseSpaces === true;
-  const trim = options.trim === true;
-  if (trim) {
-    result = result.trim();
-  }
-  if (collapseSpaces) {
-    const leadingSpaces = result.match(/^\s*/)?.[0] ?? "";
-    const trailingSpaces = result.match(/\s*$/)?.[0] ?? "";
-    result = result.trim().replace(/\s+/g, " ");
-    result = `${leadingSpaces}${result}${trailingSpaces}`;
-  }
-  return result.toLowerCase().split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-};
-
-function stripHtmlTags(input) {
-  if (!chunkSYHPSOUU_cjs.isString(input)) {
-    return void 0;
-  }
-  if (chunkWLOQQFDS_cjs.isEmptyString(input)) {
-    return "";
-  }
-  const stripped = input.replace(/<\/?[a-zA-Z][^<>]*\/?>/g, " ").trim();
-  const cleaned = stripped.replace(/\s+/g, " ").trim();
-  return cleaned;
-}
-
-var getInitialsName = (name) => {
-  if (!chunkSYHPSOUU_cjs.isNonEmptyString(name)) return "";
-  name = name.replace(/\s+/g, " ").trim();
-  const nameParts = name.split(" ");
-  if (nameParts.length > 1) {
-    return nameParts[0][0] + nameParts[1][0].toUpperCase();
-  }
-  return name.length > 1 ? name.substring(0, 2).toUpperCase() : (
-    // First two letters for single-word names
-    name[0].toUpperCase()
-  );
-};
-
-var replaceAt = (index, originalString, replaceTo) => {
-  if (!chunkSYHPSOUU_cjs.isNumber(index) || !chunkSYHPSOUU_cjs.isString(replaceTo) || !chunkSYHPSOUU_cjs.isString(originalString)) {
-    throw new TypeError(
-      `First parameter (\`index\`) must be of type \`number\`, second parameter (\`originalString\`) and third parameter (\`replaceTo\`) must be of type \`string\`, but received: "['index': \`${chunkSYHPSOUU_cjs.getPreciseType(
-        index
-      )}\`, 'originalString': \`${chunkSYHPSOUU_cjs.getPreciseType(
-        originalString
-      )}\`, 'replaceTo': \`${chunkSYHPSOUU_cjs.getPreciseType(replaceTo)}\`]".`
-    );
-  }
-  if (index < 0 || index >= originalString.length) {
-    throw new RangeError(
-      `First parameter (\`index\`) is out of range from second parameter (\`originalString\`).`
-    );
-  }
-  return originalString.slice(0, index) + // Extract before the index
-  replaceTo + // Insert replacement
-  originalString.slice(index + 1);
-};
-
-exports.capitalizeFirst = capitalizeFirst;
-exports.capitalizeWords = capitalizeWords;
-exports.getInitialsName = getInitialsName;
-exports.replaceAt = replaceAt;
-exports.stripHtmlTags = stripHtmlTags;

package/dist/chunk-ZVWZEGQP.js

@@ -1,28 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-import { isNonEmptyString, isPlainObject } from './chunk-MSUW5VHZ.js';
-
-var normalizeSpaces = (value, options = {
-  withTrim: true,
-  trimOnly: false
-}) => {
-  if (!isNonEmptyString(value)) return "";
-  if (!isPlainObject(options)) {
-    options = {};
-  }
-  const { trimOnly = false, withTrim = true } = options;
-  if (trimOnly) return value.trim();
-  if (withTrim) {
-    value = value.trim();
-  }
-  return value.replace(/\s+/g, " ");
-};
-
-export { normalizeSpaces };

package/dist/index.d.ts

@@ -1,24 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-//! References Paths:
-/// <reference path="./assertions/index.d.ts" />
-/// <reference path="./conversions/index.d.ts" />
-/// <reference path="./events/index.d.ts" />
-/// <reference path="./formatters/index.d.ts" />
-/// <reference path="./generators/index.d.ts" />
-/// <reference path="./next/index.d.ts" />
-/// <reference path="./next/server/index.d.ts" />
-/// <reference path="./operations/index.d.ts" />
-/// <reference path="./parsers/index.d.ts" />
-/// <reference path="./predicates/index.d.ts" />
-/// <reference path="./promises/index.d.ts" />
-/// <reference path="./strings/index.d.ts" />
-/// <reference path="./tailwind/index.d.ts" />
-/// <reference path="./urls/index.d.ts" />