melperjs 17.0.0 → 17.1.1

package/docs/{index.md → general.md}

@@ -114,7 +114,7 @@ Splits a string, trims each piece, and drops empty results. Default separator is
 
 ### pascalCase(string)
 
-Converts arbitrary text to `PascalCase` (uses lodash internally).
+Converts arbitrary text to `PascalCase` (uses es-toolkit internally).
 
 - **Parameters:**
   - `string` (String): Input text.
@@ -149,7 +149,7 @@ Strips HTML tags via the `xss` library and additionally removes the body of dang
 
 ### shuffleString(string)
 
-Randomly reorders the characters in a string using lodash's `shuffle` (Fisher-Yates).
+Randomly reorders the characters in a string using es-toolkit's `shuffle` (Fisher-Yates).
 
 - **Parameters:**
   - `string` (String): Source string.
@@ -238,7 +238,7 @@ Builds a deterministic hex string of the requested length from a seed via `mulbe
 
 ### checkEmpty(value)
 
-Like lodash's `isEmpty` but additionally treats `0` (numeric zero) as empty.
+Like es-toolkit's `isEmpty` but additionally treats `0` (numeric zero) as empty.
 
 - **Parameters:**
   - `value` (Any): Value to test.
@@ -288,17 +288,17 @@ Depth-first search through a nested object for the first node that owns `key`. I
   - `pair` (Any): Optional value constraint. `null` means "match any value".
 - **Returns:** The matching node, or `null` if not found.
 
-### waitForProperty(object, property, timeout, interval = 100)
+### waitForProperty(object, property, timeoutMs, interval = 100)
 
 Polls `object` until it owns `property`, then resolves with the property's value. Rejects after `timeout` milliseconds.
 
 - **Parameters:**
   - `object` (Object): Object to watch.
   - `property` (String): Property name to wait for.
-  - `timeout` (Number): Maximum wait time in milliseconds.
+  - `timeoutMs` (Number): Maximum wait time in milliseconds.
   - `interval` (Number): Poll interval in milliseconds.
 - **Returns:** `Promise` resolving to the property's value.
-- **Throws:** When the property does not appear within `timeout`.
+- **Throws:** When the property does not appear within `timeoutMs`.
 
 ### shuffleObject(object)
 

package/docs/node.md

@@ -7,7 +7,7 @@ and will not run in a browser.
 
 All `secureRandom*` helpers use Node's `crypto` module (`crypto.randomInt`, `crypto.randomBytes`, `crypto.randomUUID`).
 Use these for session tokens, API keys, nonces, and anything security-sensitive. For non-secure / faster equivalents,
-see the `random*` family in [General Functions](index.md).
+see the `random*` family in [General Functions](general.md).
 
 ### secureRandomBoolean()
 

package/package.json

@@ -1,5 +1,6 @@
 {
   "name": "melperjs",
+  "version": "17.1.1",
   "description": "A compact JavaScript utility library for strings, objects, tokens, hashing, cookies, proxies, file I/O, shell, and more.",
   "keywords": [
     "melperjs",
@@ -24,51 +25,51 @@
     "file-system",
     "shell"
   ],
+  "homepage": "https://github.com/mahelbir/melperjs#readme",
+  "bugs": {
+    "url": "https://github.com/mahelbir/melperjs/issues"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mahelbir/melperjs.git"
   },
-  "author": "Mahmuthan Elbir",
   "license": "MIT",
+  "author": "Mahmuthan Elbir",
   "type": "module",
-  "files": [
-    "lib/**/*",
-    "docs/**/*"
-  ],
-  "private": false,
-  "publishConfig": {
-    "access": "public"
+  "engines": {
+    "node": ">=18.0.0"
   },
+  "sideEffects": false,
   "exports": {
     ".": {
-      "import": "./lib/esm/index.mjs",
-      "require": "./lib/cjs/index.cjs"
+      "import": "./dist/general.mjs",
+      "require": "./dist/general.cjs"
     },
     "./node": {
-      "import": "./lib/esm/node.mjs",
-      "require": "./lib/cjs/node.cjs"
+      "import": "./dist/node.mjs",
+      "require": "./dist/node.cjs"
     }
   },
+  "files": [
+    "dist/**/*",
+    "docs/**/*"
+  ],
   "scripts": {
-    "build:esm": "npx cross-env BABEL_ENV=esm babel ./src --out-dir ./lib/esm --out-file-extension .mjs",
-    "build:cjs": "npx cross-env BABEL_ENV=cjs babel ./src --out-dir ./lib/cjs --out-file-extension .cjs",
-    "build": "npm run build:esm && npm run build:cjs",
-    "test": "node --test 'tests/**/*.test.js'",
-    "prepublishOnly": "npm run build && npm test"
+    "build": "tsdown",
+    "test": "node --test",
+    "prepublishOnly": "npm run build && npm test",
+    "relock": "rm -rf node_modules package-lock.json && NODE_ENV= npm install --include=dev --include=optional"
   },
   "dependencies": {
     "bcryptjs": "^3.0.3",
-    "lodash": "4.18.1",
+    "es-toolkit": "^1.47.0",
     "set-cookie-parser": "^3.1.0",
     "xss": "^1.0.15"
   },
   "devDependencies": {
-    "@babel/cli": "^7.28.6",
-    "@babel/core": "^7.29.0",
-    "@babel/preset-env": "^7.29.5",
-    "babel-plugin-replace-import-extension": "^1.1.5",
-    "babel-plugin-transform-import-meta": "^2.3.3",
-    "cross-env": "^10.1.0"
+    "tsdown": "^0.22.2"
   },
-  "version": "17.0.0"
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/lib/cjs/index.cjs

@@ -1,474 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.CONSTANTS = void 0;
-exports.Exception = Exception;
-exports.checkEmpty = checkEmpty;
-exports.coerceObjectIntegers = coerceObjectIntegers;
-exports.coerceObjectNumbers = coerceObjectNumbers;
-exports.cookiesFromHeader = cookiesFromHeader;
-exports.cookiesFromResponse = cookiesFromResponse;
-exports.cookiesToHeader = cookiesToHeader;
-exports.findNodeByKey = findNodeByKey;
-exports.forever = forever;
-exports.getResponseError = getResponseError;
-exports.isInt32 = isInt32;
-exports.isPositiveNumber = isPositiveNumber;
-exports.isTransientHttpCode = isTransientHttpCode;
-exports.isValidURL = isValidURL;
-exports.limitString = limitString;
-exports.mulberry32 = mulberry32;
-exports.normalizeProxy = normalizeProxy;
-exports.objectStringify = objectStringify;
-exports.parseProxy = parseProxy;
-exports.pascalCase = pascalCase;
-exports.promiseSilent = promiseSilent;
-exports.promiseTimeout = promiseTimeout;
-exports.proxyValue = proxyValue;
-exports.randomBoolean = randomBoolean;
-exports.randomElement = randomElement;
-exports.randomHex = randomHex;
-exports.randomInteger = randomInteger;
-exports.randomString = randomString;
-exports.randomUuid = randomUuid;
-exports.randomWeighted = randomWeighted;
-exports.retry = retry;
-exports.safeString = safeString;
-exports.seedHex = seedHex;
-exports.shuffleObject = shuffleObject;
-exports.shuffleString = shuffleString;
-exports.sleep = sleep;
-exports.sleepMs = sleepMs;
-exports.splitTrim = splitTrim;
-exports.time = time;
-exports.titleCase = titleCase;
-exports.waitForProperty = waitForProperty;
-var _xss = _interopRequireDefault(require("xss"));
-var _setCookieParser = _interopRequireDefault(require("set-cookie-parser"));
-var _camelCase = _interopRequireDefault(require("lodash/camelCase.js"));
-var _upperFirst = _interopRequireDefault(require("lodash/upperFirst.js"));
-var _isEmpty = _interopRequireDefault(require("lodash/isEmpty.js"));
-var _shuffle = _interopRequireDefault(require("lodash/shuffle.js"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-const CONSTANTS = exports.CONSTANTS = {
-  LOWER_CASE: "abcdefghijklmnopqrstuvwxyz",
-  UPPER_CASE: "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
-  HEXADECIMAL: "0123456789abcdef",
-  NUMBERS: "0123456789",
-  INT32_MIN: -2147483648,
-  INT32_MAX: 2147483647
-};
-const NUMBER_PATTERN = /^-?\d+(\.\d+)?(e[+-]?\d+)?$/i;
-const INTEGER_PATTERN = /^-?\d+$/;
-function Exception(message, response = {}, name = null) {
-  const error = new Error(message);
-  error.name = name || "Exception";
-  error.response = response;
-  if (checkEmpty(response)) {
-    error.response = {};
-  }
-  return error;
-}
-function time() {
-  return Math.floor(Date.now() / 1000);
-}
-function sleepMs(milliseconds) {
-  return new Promise(resolve => setTimeout(resolve, milliseconds));
-}
-function sleep(seconds) {
-  return sleepMs(seconds * 1000);
-}
-function promiseTimeout(milliseconds, promise) {
-  let timer;
-  const timeout = new Promise((_, reject) => {
-    timer = setTimeout(() => reject(new Error(`Promise timed out after ${milliseconds}ms`)), milliseconds);
-  });
-  return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));
-}
-function promiseSilent(promise) {
-  return promise.then(() => {}).catch(() => {});
-}
-async function forever(delayMs, task, onError = null, onFinally = null) {
-  if (!isPositiveNumber(delayMs)) throw new Error("delayMs must be a positive number");
-  const update = value => {
-    if (isPositiveNumber(value)) delayMs = value;
-  };
-  while (true) {
-    try {
-      update(await task());
-    } catch (error) {
-      if (onError) update(await onError(error));
-    } finally {
-      if (onFinally) {
-        try {
-          update(await onFinally());
-        } catch {}
-      }
-      await sleepMs(delayMs);
-    }
-  }
-}
-async function retry(task, maxAttempts = 1, onError = null, {
-  delayMs = 0,
-  backoffFactor = 1
-} = {}) {
-  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-    try {
-      return await task();
-    } catch (error) {
-      if (onError) await onError(error, attempt);
-      if (attempt >= maxAttempts) throw error;
-      if (delayMs > 0) await sleepMs(delayMs * backoffFactor ** (attempt - 1));
-    }
-  }
-}
-function isValidURL(url) {
-  try {
-    new URL(url);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function splitTrim(string, separator = null) {
-  return string.split(separator ?? /\r?\n/).map(item => item.trim()).filter(Boolean);
-}
-function checkEmpty(value) {
-  if (typeof value === "number") return value === 0;
-  return (0, _isEmpty.default)(value);
-}
-function pascalCase(string) {
-  return (0, _upperFirst.default)((0, _camelCase.default)(string));
-}
-function titleCase(string, separator = " ") {
-  return (string || "").split(separator).map(_upperFirst.default).join(separator);
-}
-function isInt32(value) {
-  return Number.isInteger(value) && value >= CONSTANTS.INT32_MIN && value <= CONSTANTS.INT32_MAX;
-}
-function isPositiveNumber(value) {
-  return Number.isFinite(value) && value > 0;
-}
-function coerceObjectNumbers(object) {
-  for (const key of Object.keys(object)) {
-    const value = object[key];
-    if (typeof value === 'string' && NUMBER_PATTERN.test(value)) {
-      object[key] = parseFloat(value);
-    }
-  }
-  return object;
-}
-function coerceObjectIntegers(object) {
-  for (const key of Object.keys(object)) {
-    const value = object[key];
-    if (typeof value === 'string' && INTEGER_PATTERN.test(value)) {
-      object[key] = parseInt(value);
-    }
-  }
-  return object;
-}
-function findNodeByKey(key, node, pair = null) {
-  if (node && typeof node === 'object') {
-    if (Object.hasOwn(node, key) && (pair === null || node[key] === pair)) {
-      return node;
-    }
-    for (const childKey of Object.keys(node)) {
-      const result = findNodeByKey(key, node[childKey], pair);
-      if (result) return result;
-    }
-  }
-  return null;
-}
-function waitForProperty(object, property, timeout, interval = 100) {
-  return new Promise((resolve, reject) => {
-    if (Object.hasOwn(object, property)) {
-      resolve(object[property]);
-      return;
-    }
-    const startTime = Date.now();
-    const checkProperty = setInterval(() => {
-      if (Object.hasOwn(object, property)) {
-        clearInterval(checkProperty);
-        resolve(object[property]);
-      } else if (Date.now() - startTime >= timeout) {
-        clearInterval(checkProperty);
-        reject(new Error(`Property "${property}" did not appear within ${timeout}ms`));
-      }
-    }, interval);
-  });
-}
-function shuffleObject(object) {
-  return Object.fromEntries((0, _shuffle.default)(Object.entries(object)));
-}
-function objectStringify(object) {
-  for (const key of Object.keys(object)) {
-    const value = object[key];
-    if (value !== null && typeof value === 'object') {
-      objectStringify(value);
-    } else {
-      object[key] = String(value);
-    }
-  }
-  return object;
-}
-function limitString(string, limit = 35, omission = "...") {
-  string = string || "";
-  if (string.length <= limit) return string;
-  return string.slice(0, limit - omission.length) + omission;
-}
-function safeString(string) {
-  return (0, _xss.default)(string || "", {
-    whiteList: {},
-    stripIgnoreTag: true,
-    stripIgnoreTagBody: ["script", "style", "iframe", "object", "embed", "form"],
-    css: false
-  });
-}
-function shuffleString(string) {
-  return (0, _shuffle.default)(string.split('')).join('');
-}
-function randomBoolean() {
-  return Math.random() < 0.5;
-}
-function randomString(length, useNumbers = true, useUppercase = false) {
-  let characters = CONSTANTS.LOWER_CASE;
-  if (useUppercase) characters += CONSTANTS.UPPER_CASE;
-  if (useNumbers) characters += CONSTANTS.NUMBERS;
-  let result = '';
-  for (let i = 0; i < length; i++) {
-    result += characters[Math.random() * characters.length | 0];
-  }
-  return result;
-}
-function randomHex(length) {
-  let result = '';
-  for (let i = 0; i < length; i++) {
-    result += CONSTANTS.HEXADECIMAL[Math.random() * 16 | 0];
-  }
-  return result;
-}
-function randomInteger(min, max = undefined) {
-  if (typeof max === 'undefined') {
-    max = min;
-    min = 0;
-  }
-  if (typeof min !== 'number' || typeof max !== 'number') {
-    throw new Error('min and max must be numerical values');
-  }
-  if (max <= min) {
-    throw new Error('max must be greater than min');
-  }
-  return Math.floor(Math.random() * (max - min)) + min;
-}
-function randomUuid(useDashes = true) {
-  const uuid = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
-    const r = Math.random() * 16 | 0;
-    return (c === 'x' ? r : r & 0x3 | 0x8).toString(16);
-  });
-  return useDashes ? uuid : uuid.replaceAll("-", "");
-}
-function randomWeighted(object) {
-  if (checkEmpty(object)) return undefined;
-  const elements = Object.keys(object);
-  const weights = Object.values(object);
-  const totalWeight = weights.reduce((sum, weight) => sum + weight, 0);
-  const randomNum = Math.random() * totalWeight;
-  let weightSum = 0;
-  for (let i = 0; i < elements.length; i++) {
-    weightSum += weights[i];
-    if (randomNum < weightSum) {
-      return elements[i];
-    }
-  }
-}
-function randomElement(object) {
-  if (checkEmpty(object)) return undefined;
-  const values = Array.isArray(object) ? object : Object.values(object);
-  if (values.length === 0) return undefined;
-  return values[Math.floor(Math.random() * values.length)];
-}
-function mulberry32(seed) {
-  if (typeof seed === "string") {
-    let h = 0;
-    for (let i = 0; i < seed.length; i++) {
-      h = Math.imul(h ^ seed.charCodeAt(i), 2654435761);
-    }
-    seed = h >>> 0;
-  }
-  return function () {
-    seed = seed + 0x6D2B79F5 | 0;
-    let t = seed;
-    t = Math.imul(t ^ t >>> 15, t | 1);
-    t ^= t + Math.imul(t ^ t >>> 7, t | 61);
-    return ((t ^ t >>> 14) >>> 0) / 4294967296;
-  };
-}
-function seedHex(seed, length) {
-  const rng = mulberry32(String(seed));
-  let result = '';
-  while (result.length < length) {
-    result += Math.floor(rng() * 0x100000000).toString(16).padStart(8, '0');
-  }
-  return result.slice(0, length);
-}
-function cookiesFromResponse(response, decodeValues = false) {
-  const obj = {};
-  const cookies = _setCookieParser.default.parse(response, {
-    decodeValues
-  });
-  for (const cookie of cookies) {
-    obj[cookie.name] = cookie.value;
-  }
-  return obj;
-}
-function cookiesToHeader(cookies) {
-  if (!cookies) return "";
-  return Object.entries(cookies).filter(([, value]) => value !== null && value !== undefined).map(([key, value]) => `${key}=${value}`).join("; ");
-}
-function cookiesFromHeader(header) {
-  const cookies = {};
-  if (!header) return cookies;
-  header.split(';').forEach(cookie => {
-    const trimmed = cookie.trim();
-    if (!trimmed.includes('=')) return;
-    const [key, ...valueParts] = trimmed.split('=');
-    const trimmedKey = key.trim();
-    if (trimmedKey) {
-      cookies[trimmedKey] = valueParts.join('=').trim();
-    }
-  });
-  return cookies;
-}
-function isTransientHttpCode(httpCode) {
-  return !httpCode || isNaN(httpCode) || httpCode === 100 || httpCode === 402 || httpCode === 407 || 460 <= httpCode && httpCode < 470 || 500 <= httpCode;
-}
-function getResponseError(error, limit = 200) {
-  let response;
-  if (error?.response?.status && error.response.data) {
-    response = `${error.response.status}|${error.response.data}`;
-  } else if (error?.response?.data) {
-    response = error.response.data;
-  }
-  return limitString(response || error.message, limit).trim();
-}
-function normalizeProxy(proxy, protocol = "http") {
-  proxy = proxy?.trim();
-  if (!proxy) return null;
-  const schemeMatch = proxy.match(/^([a-z][a-z0-9+.-]*):\/\/(.+)$/i);
-  if (schemeMatch) {
-    protocol = schemeMatch[1];
-    proxy = schemeMatch[2];
-  }
-  let auth = "";
-  let body = proxy;
-  const atIdx = body.lastIndexOf("@");
-  if (atIdx !== -1) {
-    auth = body.slice(0, atIdx) + "@";
-    body = body.slice(atIdx + 1);
-  }
-  if (!auth) {
-    /* Note: when host is single-token (e.g. "localhost") AND password is all-digit port-shaped,
-     the heuristic stays ambiguous; prefer `user:pass@host:port` for those cases. */
-    const parts = body.split(":");
-    const isPort = s => /^\d+$/.test(s) && +s >= 1 && +s <= 65535;
-    const isHost = s => s.includes(".") || /[a-z]/i.test(s);
-    if (parts.length === 4) {
-      if (isPort(parts[3]) && !isPort(parts[1])) {
-        // user:pass:host:port
-        auth = `${parts[0]}:${parts[1]}@`;
-        body = `${parts[2]}:${parts[3]}`;
-      } else if (isPort(parts[1]) && !isPort(parts[3])) {
-        // host:port:user:pass
-        auth = `${parts[2]}:${parts[3]}@`;
-        body = `${parts[0]}:${parts[1]}`;
-      } else if (isHost(parts[2]) && !isHost(parts[0])) {
-        // user:pass:host:port (ambiguous; host detected at parts[2])
-        auth = `${parts[0]}:${parts[1]}@`;
-        body = `${parts[2]}:${parts[3]}`;
-      } else {
-        // host:port:user:pass (ambiguous fallback)
-        auth = `${parts[2]}:${parts[3]}@`;
-        body = `${parts[0]}:${parts[1]}`;
-      }
-    } else if (parts.length === 5) {
-      if (isPort(parts[3]) && isPort(parts[4]) && !isPort(parts[1])) {
-        // user:pass:host:portStart:portEnd
-        auth = `${parts[0]}:${parts[1]}@`;
-        body = `${parts[2]}:${parts[3]}:${parts[4]}`;
-      } else if (isPort(parts[1]) && isPort(parts[2]) && !isPort(parts[3])) {
-        // host:portStart:portEnd:user:pass
-        auth = `${parts[3]}:${parts[4]}@`;
-        body = `${parts[0]}:${parts[1]}:${parts[2]}`;
-      } else if (isHost(parts[2]) && !isHost(parts[0])) {
-        // user:pass:host:portStart:portEnd (ambiguous; host detected at parts[2])
-        auth = `${parts[0]}:${parts[1]}@`;
-        body = `${parts[2]}:${parts[3]}:${parts[4]}`;
-      } else {
-        // host:portStart:portEnd:user:pass (ambiguous fallback)
-        auth = `${parts[3]}:${parts[4]}@`;
-        body = `${parts[0]}:${parts[1]}:${parts[2]}`;
-      }
-    }
-  }
-  const parts = body.split(":");
-  if (parts.length === 3) {
-    const start = Number(parts[1]);
-    const end = Number(parts[2]);
-    if (Number.isInteger(start) && Number.isInteger(end) && start >= 0 && start <= end) {
-      body = `${parts[0]}:${randomInteger(start, end + 1)}`;
-    }
-  }
-  return `${protocol}://${auth}${body}`;
-}
-function parseProxy(proxy, protocol = "http") {
-  const normalized = normalizeProxy(proxy, protocol);
-  if (!normalized) return null;
-  const [scheme, rest] = normalized.split("://");
-  const atIdx = rest.lastIndexOf("@");
-  const authPart = atIdx === -1 ? null : rest.slice(0, atIdx);
-  const hostPart = atIdx === -1 ? rest : rest.slice(atIdx + 1);
-  const [host, port] = hostPart.split(":");
-  const result = {
-    protocol: scheme,
-    host,
-    port: parseInt(port, 10)
-  };
-  if (authPart !== null) {
-    const colonIdx = authPart.indexOf(":");
-    const [username, password] = colonIdx === -1 ? [authPart, ""] : [authPart.slice(0, colonIdx), authPart.slice(colonIdx + 1)];
-    result.auth = {
-      username,
-      password
-    };
-  }
-  return result;
-}
-function proxyValue(rawProxy, replacements = {}) {
-  const list = splitTrim(rawProxy || "");
-  if (list.length === 0) return null;
-  const picked = list[randomInteger(0, list.length)];
-  let result = normalizeProxy(picked);
-  if (!result) return null;
-  if (result.includes("{")) {
-    const {
-      SESSION,
-      ...rest
-    } = replacements;
-    let sessionValue;
-    if (SESSION === undefined) {
-      sessionValue = randomHex(8);
-    } else if (typeof SESSION === "function") {
-      sessionValue = SESSION();
-    } else {
-      sessionValue = seedHex(String(SESSION), 8);
-    }
-    result = result.replace("{SESSION}", sessionValue);
-    for (const [key, value] of Object.entries(rest)) {
-      const v = typeof value === "function" ? value() : String(value);
-      result = result.replace(`{${key}}`, v);
-    }
-  }
-  return result;
-}