melperjs 11.0.0 → 12.0.0

package/README.md

@@ -14,136 +14,8 @@ To install use npm:
 npm i melperjs
 ```
 
-## Usage
-
-```javascript
-// const helper = require("melperjs");
-// const nodeHelper = require("melperjs/node");
-// const axios = require("axios");
-import * as helper from "melperjs";
-import * as nodeHelper from "melperjs/node";
-import axios from "axios";
-
-console.log(helper.CONSTANTS);
-console.log(helper.time());
-await helper.sleepMs(1000);
-console.log(helper.time());
-await helper.sleep(1);
-console.log(helper.time());
-try {
-    await helper.promiseTimeout(1000, helper.sleepMs(2000));
-} catch (e) {
-    console.error(e.message);
-    console.log("Timeout, Internal Error ?", helper.isIntlHttpError(e));
-}
-const errorPronePromise = helper.retryFn(async () => {
-    console.log("Retry this function");
-    throw new Error("error")
-}, 5, (attempt, error, result) => {
-    if (attempt % 2 === 0) {
-        console.error("Even attempt error");
-    }
-});
-helper.promiseSilent(errorPronePromise);
-console.log("Is valid URL ?", helper.isValidURL("https://google.com"));
-console.log(helper.splitClear(`
-    2.satır
-    
-    4.satır
-    `))
-console.log(helper.findKeyNode("c", {
-    a: {
-        b: {
-            x: 1,
-            y: 2,
-            c: {
-                d: true
-            }
-        }
-    }
-}));
-console.log("'' empty ?", helper.checkEmpty(''));
-console.log("1 empty ?", helper.checkEmpty(1));
-console.log("0 empty ?", helper.checkEmpty(1));
-console.log("[] empty ?", helper.checkEmpty([]));
-console.log(helper.pascalCase("pascal case"));
-console.log(helper.titleCase("THIS mUsT be Title"));
-console.log(helper.parseNumFromObj({
-    a: "123",
-    b: 456,
-    c: "789.01",
-    d: "hello",
-    e: "0",
-    f: true,
-    g: "5000"
-}));
-console.log(helper.parseIntFromObj({
-    a: "123",
-    b: 456,
-    c: "789.01",
-    d: "hello",
-    e: "0",
-    f: true,
-    g: "5000"
-}))
-console.log(helper.objectStringify({
-    a: "hello",
-    b: 1,
-    c: undefined,
-    d: null,
-    e: {
-        ea: 2
-    },
-    f: [3, 4, 5],
-    g: false
-}));
-console.log(helper.modifyObjectKeys({"A": "B"}, (key) => key.toLowerCase()));
-console.log(helper.limitString("LONG TEXT", 7));
-console.log(helper.safeString("<strong>SAFE TEXT</strong>"));
-console.log(helper.shuffleString("ABC123"));
-console.log(helper.randomString(32, true, true));
-console.log(helper.randomHex(8));
-console.log(helper.randomInteger(100, 1000));
-console.log(helper.randomUuid(true));
-console.log(helper.randomWeighted({strongProbability: 1000, lowProbability: 1}));
-console.log(helper.randomElement({a: "vA", b: "vB", c: "vC"}));
-console.log(nodeHelper.tokenString(32, true, true));
-console.log(nodeHelper.tokenHex(8));
-console.log(nodeHelper.tokenUuid(true));
-console.log(nodeHelper.tokenWeighted({strongProbability: 1000, lowProbability: 1}));
-console.log(nodeHelper.tokenElement(["vA", "vB", "vC"]));
-console.log(nodeHelper.hash("md5", "data"));
-const password = nodeHelper.hashBcrypt("plain", "encryptionKey");
-console.log(password)
-console.log("passwordHash verified ?", nodeHelper.verifyBcrypt("plain", password, "encryptionKey"));
-console.log(await nodeHelper.executeCommand("python --version"));
-console.log(helper.indexByTime(5));
-const cookies = helper.cookieDict(await axios.get("https://google.com"));
-console.log(cookies);
-console.log(helper.cookieHeader(cookies));
-const proxy = nodeHelper.formatProxy("127.0.0.1:8080:id:pw-{SESSION}");
-console.log(proxy);
-console.log(nodeHelper.proxyObject(proxy));
-console.log(nodeHelper.proxyValue(proxy));
-console.log(nodeHelper.serverIp());
-console.log("HTTP CODE: 400 (Bad Request) ?", helper.isIntlHttpCode(401));
-console.log("HTTP CODE: 407 (Failed Proxy Auth) ?", helper.isIntlHttpCode(407));
-nodeHelper.createNumDir("test");
-await nodeHelper.writeJsonFile("test.json", {test: "test json file"});
-console.log(nodeHelper.readJsonFileSync("test.json"));
-console.log("VERSIONED BY .GIT", "v" + nodeHelper.getVersion());
-console.log(helper.Exception("something went wrong", {status: 400}, "bad request error"));
-await helper.forever(1000, async () => {
-        await helper.sleep(1);
-        console.log("Do something!")
-    }, (e) => {
-        console.error("Error!", e);
-        return 5000
-    }, () => {
-        console.log("Run this process forever!")
-    }
-);
-```
+## Documentation
+The documentation is available at [docs folder](docs/index.md).
 
 ## License
 

package/lib/cjs/index.js

@@ -50,15 +50,13 @@ const CONSTANTS = exports.CONSTANTS = {
   NUMBERS: "0123456789"
 };
 function Exception(message, response = {}, name = null) {
-  class ExceptionClass extends Error {
-    constructor(message, response, name) {
-      super(message);
-      response.status = response.status || 400;
-      this.response = response;
-      this.name = name ? pascalCase(name) : "Exception";
-    }
+  const error = new Error(message);
+  error.name = name || "Exception";
+  error.response = response;
+  if (!error.response?.status && typeof error.response === "object") {
+    error.response.status = 400;
   }
-  return new ExceptionClass(message, response, name);
+  return error;
 }
 async function forever(cooldown, onSuccess, onError = null, onCompleted = null) {
   const checkCooldown = value => value && !isNaN(value) && value > 0;
@@ -152,15 +150,16 @@ function checkEmpty(value) {
 function pascalCase(str) {
   return (0, _upperFirst.default)((0, _camelCase.default)(str));
 }
-function titleCase(str) {
+function titleCase(str, separator = " ") {
   str = str || "";
-  return str.replace(/\b\w/g, char => char.toUpperCase());
+  const words = str.split(separator);
+  return words.map(word => (0, _upperFirst.default)(word)).join(separator);
 }
 function parseNumFromObj(obj) {
   for (let key in obj) {
     let value = obj[key];
     let number = parseFloat(value);
-    if (typeof value === 'string' && !isNaN(number)) {
+    if (typeof value === 'string' && !isNaN(number) && !value.includes("_")) {
       value = number;
     }
     obj[key] = value;

package/lib/cjs/node.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.cleanDirectory = cleanDirectory;
 exports.createNumDir = createNumDir;
 exports.executeCommand = executeCommand;
 exports.formatProxy = formatProxy;
@@ -18,6 +19,7 @@ exports.serverIp = serverIp;
 exports.sha256 = sha256;
 exports.tokenElement = tokenElement;
 exports.tokenHex = tokenHex;
+exports.tokenInteger = tokenInteger;
 exports.tokenString = tokenString;
 exports.tokenUuid = tokenUuid;
 exports.tokenWeighted = tokenWeighted;
@@ -32,8 +34,7 @@ var _child_process = require("child_process");
 var _bcryptjs = _interopRequireDefault(require("bcryptjs"));
 var _index = require("./index.js");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 function tokenString(length, useNumbers = true, useUppercase = false) {
   const lowercaseChars = _index.CONSTANTS.LOWER_CASE;
   const uppercaseChars = _index.CONSTANTS.UPPER_CASE;
@@ -54,6 +55,9 @@ function tokenString(length, useNumbers = true, useUppercase = false) {
 function tokenHex(length) {
   return _crypto.default.randomBytes(Math.ceil(length / 2)).toString('hex').slice(0, length);
 }
+function tokenInteger(min, max) {
+  return _crypto.default.randomInt(min, max);
+}
 function tokenUuid(useDashes = true) {
   const uuid = _crypto.default.randomUUID().toString();
   return useDashes ? uuid : uuid.replaceAll("-", "");
@@ -106,11 +110,11 @@ function getVersion() {
     return "1.0";
   }
 }
-function createNumDir(mainDirectory) {
+function createNumDir(mainDirectory, start = 0, end = 9) {
   _fs.default.mkdirSync(mainDirectory, {
     recursive: true
   });
-  for (let i = 0; i <= 9; i++) {
+  for (let i = start; i <= end; i++) {
     try {
       _fs.default.mkdirSync(_path.default.join(mainDirectory, i.toString()), {
         recursive: true
@@ -210,4 +214,33 @@ async function writeJsonFile(filePath, data) {
 function writeJsonFileSync(filePath, data) {
   const jsonData = JSON.stringify(data);
   return _fs.default.writeFileSync(filePath, jsonData, 'utf8');
+}
+async function cleanDirectory(directoryPath, keepDir = true) {
+  try {
+    const stats = await _fs.promises.stat(directoryPath).catch(() => null);
+    if (!stats) {
+      if (keepDir) {
+        await _fs.promises.mkdir(directoryPath, {
+          recursive: true
+        });
+      }
+      return;
+    }
+    const files = await _fs.promises.readdir(directoryPath);
+    for (const file of files) {
+      const filePath = _path.default.join(directoryPath, file);
+      const fileStat = await _fs.promises.stat(filePath);
+      if (fileStat.isDirectory()) {
+        await cleanDirectory(filePath, false);
+      } else {
+        await _fs.promises.unlink(filePath);
+      }
+    }
+    if (!keepDir) {
+      await _fs.promises.rmdir(directoryPath);
+    }
+    return true;
+  } catch (error) {
+    throw error;
+  }
 }

package/lib/esm/index.js

@@ -11,15 +11,13 @@ export const CONSTANTS = {
   NUMBERS: "0123456789"
 };
 export function Exception(message, response = {}, name = null) {
-  class ExceptionClass extends Error {
-    constructor(message, response, name) {
-      super(message);
-      response.status = response.status || 400;
-      this.response = response;
-      this.name = name ? pascalCase(name) : "Exception";
-    }
+  const error = new Error(message);
+  error.name = name || "Exception";
+  error.response = response;
+  if (!error.response?.status && typeof error.response === "object") {
+    error.response.status = 400;
   }
-  return new ExceptionClass(message, response, name);
+  return error;
 }
 export async function forever(cooldown, onSuccess, onError = null, onCompleted = null) {
   const checkCooldown = value => value && !isNaN(value) && value > 0;
@@ -113,15 +111,16 @@ export function checkEmpty(value) {
 export function pascalCase(str) {
   return upperFirst(camelCase(str));
 }
-export function titleCase(str) {
+export function titleCase(str, separator = " ") {
   str = str || "";
-  return str.replace(/\b\w/g, char => char.toUpperCase());
+  const words = str.split(separator);
+  return words.map(word => upperFirst(word)).join(separator);
 }
 export function parseNumFromObj(obj) {
   for (let key in obj) {
     let value = obj[key];
     let number = parseFloat(value);
-    if (typeof value === 'string' && !isNaN(number)) {
+    if (typeof value === 'string' && !isNaN(number) && !value.includes("_")) {
       value = number;
     }
     obj[key] = value;

package/lib/esm/node.js

@@ -26,6 +26,9 @@ export function tokenString(length, useNumbers = true, useUppercase = false) {
 export function tokenHex(length) {
   return crypto.randomBytes(Math.ceil(length / 2)).toString('hex').slice(0, length);
 }
+export function tokenInteger(min, max) {
+  return crypto.randomInt(min, max);
+}
 export function tokenUuid(useDashes = true) {
   const uuid = crypto.randomUUID().toString();
   return useDashes ? uuid : uuid.replaceAll("-", "");
@@ -78,11 +81,11 @@ export function getVersion() {
     return "1.0";
   }
 }
-export function createNumDir(mainDirectory) {
+export function createNumDir(mainDirectory, start = 0, end = 9) {
   fs.mkdirSync(mainDirectory, {
     recursive: true
   });
-  for (let i = 0; i <= 9; i++) {
+  for (let i = start; i <= end; i++) {
     try {
       fs.mkdirSync(path.join(mainDirectory, i.toString()), {
         recursive: true
@@ -182,4 +185,33 @@ export async function writeJsonFile(filePath, data) {
 export function writeJsonFileSync(filePath, data) {
   const jsonData = JSON.stringify(data);
   return fs.writeFileSync(filePath, jsonData, 'utf8');
+}
+export async function cleanDirectory(directoryPath, keepDir = true) {
+  try {
+    const stats = await fsp.stat(directoryPath).catch(() => null);
+    if (!stats) {
+      if (keepDir) {
+        await fsp.mkdir(directoryPath, {
+          recursive: true
+        });
+      }
+      return;
+    }
+    const files = await fsp.readdir(directoryPath);
+    for (const file of files) {
+      const filePath = path.join(directoryPath, file);
+      const fileStat = await fsp.stat(filePath);
+      if (fileStat.isDirectory()) {
+        await cleanDirectory(filePath, false);
+      } else {
+        await fsp.unlink(filePath);
+      }
+    }
+    if (!keepDir) {
+      await fsp.rmdir(directoryPath);
+    }
+    return true;
+  } catch (error) {
+    throw error;
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "melperjs",
-  "version": "11.0.0",
+  "version": "12.0.0",
   "description": "Javascript module to use predefined common functions and utilities",
   "keywords": [
     "melperjs",
@@ -39,17 +39,17 @@
     "test": "node test/script.js"
   },
   "dependencies": {
-    "bcryptjs": "^2.4.3",
+    "bcryptjs": "^3.0.2",
     "hpagent": "^1.2.0",
     "lodash": "^4.17.21",
-    "set-cookie-parser": "^2.6.0",
+    "set-cookie-parser": "^2.7.1",
     "xss": "^1.0.15"
   },
   "devDependencies": {
-    "@babel/cli": "^7.24.7",
-    "@babel/core": "^7.24.7",
-    "@babel/preset-env": "^7.24.7",
-    "axios": "^1.6.8",
+    "@babel/cli": "^7.27.2",
+    "@babel/core": "^7.27.1",
+    "@babel/preset-env": "^7.27.2",
+    "axios": "^1.9.0",
     "cross-env": "^7.0.3"
   }
 }