@gerync/utils 1.0.0 → 1.0.1

package/README.md

@@ -21,12 +21,12 @@ npm install @gerync/utils
 
 ### 1. coloredlog
 
-Log messages to the console with color support. Accepts hex, RGB, or CSS named colors.
+Log messages to the console with color support. Accepts hex, RGB, or CSS named colors. Optional bold styling works in both browser (`%c`) and Node (ANSI) consoles.
 
 **Import:**
 ```typescript
 import utils from '@gerync/utils';
-utils.coloredlog(message, color);
+utils.coloredlog(message, color, bold?);
 ```
 
 **Usage:**
@@ -35,6 +35,7 @@ utils.coloredlog(message, color);
 utils.coloredlog('This is an error', 'red');
 utils.coloredlog('This is a warning', 'orange');
 utils.coloredlog('Success!', 'green');
+utils.coloredlog('Bold success!', 'green', true);
 
 // Hex colors
 utils.coloredlog('Custom color', '#FF5733');
@@ -51,6 +52,7 @@ utils.coloredlog('No styling', 'invalid-color');
 **Parameters:**
 - `message` (string): The text to log
 - `color` (string): A valid hex (`#XXX`, `#XXXX`, `#XXXXXX`, `#XXXXXXXX`), RGB (`rgb(r, g, b)`), RGBA (`rgba(r, g, b, a)`), or CSS named color
+- `bold` (boolean, default `false`): When true, renders bold text (ANSI in Node, `font-weight` in browsers)
 
 ---
 
@@ -172,7 +174,7 @@ app.use(utils.errorHandler);
 
 ```json
 {
-    "status": "error",
+    "status": 409,
     "code": "ER_DUP_ENTRY",
     "message": "Email address already exists."
 }

package/dist/functions/Colorlog.d.ts

@@ -13,5 +13,5 @@
  * coloredlog('Success', '#00FF00');
  * coloredlog('Info', 'rgb(0, 0, 255)');
  */
-export default function Coloredlog(message: string, color: string): void;
+export default function Coloredlog(message: string, color: string, bolded?: boolean): void;
 //# sourceMappingURL=Colorlog.d.ts.map

package/dist/functions/Colorlog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Colorlog.d.ts","sourceRoot":"","sources":["../../functions/Colorlog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CA8BvE"}
+{"version":3,"file":"Colorlog.d.ts","sourceRoot":"","sources":["../../functions/Colorlog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,GAAG,IAAI,CA6GhG"}

package/dist/functions/Colorlog.js

@@ -13,7 +13,7 @@
  * coloredlog('Success', '#00FF00');
  * coloredlog('Info', 'rgb(0, 0, 255)');
  */
-export default function Coloredlog(message, color) {
+export default function Coloredlog(message, color, bolded = false) {
     // #region Color Validation Regexes
     /** Regex patterns to validate different color formats */
     const ColorRegex = {
@@ -22,7 +22,67 @@ export default function Coloredlog(message, color) {
         /** RGB/RGBA colors: rgb(r, g, b) or rgba(r, g, b, a) */
         rgb: /^rgba?\(\s*(\d{1,3}%?)\s*[\s,]\s*(\d{1,3}%?)\s*[\s,]\s*(\d{1,3}%?)(?:\s*[\s,/]\s*((?:0|1|0?\.\d+)(?:%?)))?\s*\)$/,
         /** CSS named colors (e.g., 'red', 'blue', 'aliceblue') */
-        named: /^(?:aliceblue|antiquewhite|aqua|aquamarine|azure|beige|bisque|black|blanchedalmond|blue|blueviolet|brown|burlywood|cadetblue|chartreuse|chocolate|coral|cornflowerblue|cornsilk|crimson|cyan|darkblue|darkcyan|darkgoldenrod|darkgray|darkgreen|darkgrey|darkkhaki|darkmagenta|darkolivegreen|darkorange|darkorchid|darkred|darksalmon|darkseagreen|darkslateblue|darkslategray|darkslategrey|darkturquoise|darkviolet|deeppink|deepskyblue|dimgray|dimgrey|dodgerblue|firebrick|floralwhite|forestgreen|fuchsia|gainsboro|ghostwhite|gold|goldenrod|gray|green|greenyellow|grey|honeydew|hotpink|indianred|indigo|ivory|khaki|lavender|lavenderblush|lawngreen|lemonchiffon|lightblue|lightcoral|lightcyan|lightgoldenrodyellow|lightgray|lightgreen|lightgrey|lightpink|lightsalmon|lightseagreen|lightskyblue|mineskyblue|lightslategray|lightslategrey|lightsteelblue|lightyellow|limegreen|linen|magenta|mediumaquamarine|mediumblue|mediumorchid|mediumpurple|mediumseagreen|mediumslateblue|mediumspringgreen|mediumturquoise|mediumvioletred|midnightblue|mintcream|mistyrose|moccasin|navajowhite|oldlace|olivedrab|orangered|palegoldenrod|palegreen|palevioletred)$/i,
+        named: /^(?:aliceblue|antiquewhite|aqua|aquamarine|azure|beige|bisque|black|blanchedalmond|blue|blueviolet|brown|burlywood|cadetblue|chartreuse|chocolate|coral|cornflowerblue|cornsilk|crimson|cyan|darkblue|darkcyan|darkgoldenrod|darkgray|darkgreen|darkgrey|darkkhaki|darkmagenta|darkolivegreen|darkorange|darkorchid|darkred|darksalmon|darkseagreen|darkslateblue|darkslategray|darkslategrey|darkturquoise|darkviolet|deeppink|deepskyblue|dimgray|dimgrey|dodgerblue|firebrick|floralwhite|forestgreen|fuchsia|gainsboro|ghostwhite|gold|goldenrod|gray|green|greenyellow|grey|honeydew|hotpink|indianred|indigo|ivory|khaki|lavender|lavenderblush|lawngreen|lemonchiffon|lightblue|lightcoral|lightcyan|lightgoldenrodyellow|lightgray|lightgreen|lightgrey|lightpink|lightsalmon|lightseagreen|lightskyblue|mineskyblue|lightslategray|lightslategrey|lightsteelblue|lightyellow|limegreen|linen|magenta|mediumaquamarine|mediumblue|mediumorchid|mediumpurple|mediumseagreen|mediumslateblue|mediumspringgreen|mediumturquoise|mediumvioletred|midnightblue|mincream|mistyrose|moccasin|navajowhite|oldlace|olivedrab|orangered|palegoldenrod|palegreen|palevioletred)$/i,
+    };
+    // #endregion
+    // #region Helpers for Node console coloring
+    const isBrowser = typeof globalThis !== 'undefined' && typeof globalThis.document !== 'undefined';
+    const namedAnsi = {
+        black: '\x1b[30m',
+        red: '\x1b[31m',
+        green: '\x1b[32m',
+        yellow: '\x1b[33m',
+        blue: '\x1b[34m',
+        magenta: '\x1b[35m',
+        cyan: '\x1b[36m',
+        white: '\x1b[37m',
+        gray: '\x1b[90m',
+        grey: '\x1b[90m'
+    };
+    const hexToRgb = (value) => {
+        const clean = value.replace('#', '');
+        if (clean.length === 3 || clean.length === 4) {
+            const r = parseInt(clean[0] + clean[0], 16);
+            const g = parseInt(clean[1] + clean[1], 16);
+            const b = parseInt(clean[2] + clean[2], 16);
+            return { r, g, b };
+        }
+        if (clean.length === 6 || clean.length === 8) {
+            const r = parseInt(clean.slice(0, 2), 16);
+            const g = parseInt(clean.slice(2, 4), 16);
+            const b = parseInt(clean.slice(4, 6), 16);
+            return { r, g, b };
+        }
+        return null;
+    };
+    const rgbStringToRgb = (value) => {
+        const match = ColorRegex.rgb.exec(value);
+        if (!match)
+            return null;
+        const toNum = (input) => {
+            if (input.endsWith('%')) {
+                const pct = parseFloat(input.replace('%', ''));
+                return Math.max(0, Math.min(255, Math.round((pct / 100) * 255)));
+            }
+            return Math.max(0, Math.min(255, parseInt(input, 10)));
+        };
+        return { r: toNum(match[1]), g: toNum(match[2]), b: toNum(match[3]) };
+    };
+    const colorToAnsi = (value) => {
+        const lower = value.toLowerCase();
+        if (namedAnsi[lower])
+            return namedAnsi[lower];
+        if (ColorRegex.hex.test(value)) {
+            const rgb = hexToRgb(value);
+            if (rgb)
+                return `\x1b[38;2;${rgb.r};${rgb.g};${rgb.b}m`;
+        }
+        if (ColorRegex.rgb.test(value)) {
+            const rgb = rgbStringToRgb(value);
+            if (rgb)
+                return `\x1b[38;2;${rgb.r};${rgb.g};${rgb.b}m`;
+        }
+        return null;
     };
     // #endregion
     // #region Validate Color Format
@@ -33,12 +93,31 @@ export default function Coloredlog(message, color) {
     // #endregion
     // #region Output
     if (isValid) {
-        /** Use CSS styling for valid colors */
-        console.log(`%c${message}`, `color: ${color}; font-weight: bold;`);
+        if (isBrowser) {
+            const weight = bolded ? 'bold' : 'normal';
+            console.log(`%c${message}`, `color: ${color}; font-weight: ${weight};`);
+        }
+        else {
+            const ansi = colorToAnsi(color);
+            const boldAnsi = bolded ? '\x1b[1m' : '';
+            if (ansi) {
+                console.log(`${ansi}${boldAnsi}${message}\x1b[0m`);
+            }
+            else if (bolded) {
+                console.log(`\x1b[1m${message}\x1b[0m`);
+            }
+            else {
+                console.log(message);
+            }
+        }
     }
     else {
-        /** Fallback: plain console.log if color is invalid */
-        console.log(message);
+        if (bolded) {
+            console.log(`\x1b[1m${message}\x1b[0m`);
+        }
+        else {
+            console.log(message);
+        }
     }
     // #endregion
 }

package/dist/functions/handleError.js

@@ -1,5 +1,5 @@
-import Configs from './Config';
-import Coloredlog from './Colorlog';
+import Configs from './Config.js';
+import Coloredlog from './Colorlog.js';
 /**
  * Express error handler middleware for centralized error handling
  * with multi-language support, smart logging, and user-friendly messages.
@@ -104,7 +104,7 @@ export default function errorHandler(err, req, res, next) {
     const requestId = (req.id || req.requestId || '');
     /** Log detailed, color-coded error report for maintainers (skip for user-caused errors) */
     if (!isUserError) {
-        Coloredlog('===================== ERROR REPORT =====================', 'red');
+        Coloredlog('===================== ERROR REPORT =====================', 'red', true);
         // Timestamp
         let exactTime = new Date().toISOString();
         exactTime = exactTime.replace('T', ' ').replace('Z', '');
@@ -115,21 +115,21 @@ export default function errorHandler(err, req, res, next) {
         if (requestId)
             Coloredlog(`RequestId: ${requestId}`, 'yellow');
         // Error details
-        Coloredlog(`Status: ${statusCode}`, 'magenta');
-        Coloredlog(`Code: ${code}`, 'magenta');
+        Coloredlog(`Status: ${statusCode}`, 'magenta', true);
+        Coloredlog(`Code: ${code}`, 'magenta', true);
         // Messages for comparison
         Coloredlog(`UserMessage: ${responseMessage}`, 'cyan');
         Coloredlog(`RawMessage: ${rawErrorMessage}`, 'white');
         // Stack trace for debugging
-        Coloredlog('Stack:', 'gray');
+        Coloredlog('Stack:', 'gray', true);
         Coloredlog(err && err.stack ? String(err.stack) : 'N/A', 'gray');
-        Coloredlog('========================================================', 'red');
+        Coloredlog('========================================================', 'red', true);
     }
     // #endregion
     // #region Send Response to Client
     /** Return JSON response with error details (safe for client) */
     res.status(statusCode).json({
-        status: 'error',
+        status: statusCode,
         code: code,
         message: responseMessage
     });

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import coloredlog from "./functions/Colorlog";
-import errorHandler from "./functions/handleError";
+import coloredlog from "./functions/Colorlog.js";
+import errorHandler from "./functions/handleError.js";
 declare const _default: {
     coloredlog: typeof coloredlog;
     errorHandler: typeof errorHandler;
@@ -18,10 +18,10 @@ declare const _default: {
         prefs: any;
     }) => void;
     object: {
-        Keysamount: typeof import("./functions/ObjectKeys").Keysamount;
-        KeysInRange: typeof import("./functions/ObjectKeys").KeysInRange;
-        KeysInRangeDetailed: typeof import("./functions/ObjectKeys").KeysInRangeDetailed;
-        AllowedKeys: typeof import("./functions/ObjectKeys").AllowedKeys;
+        Keysamount: typeof import("./functions/ObjectKeys.js").Keysamount;
+        KeysInRange: typeof import("./functions/ObjectKeys.js").KeysInRange;
+        KeysInRangeDetailed: typeof import("./functions/ObjectKeys.js").KeysInRangeDetailed;
+        AllowedKeys: typeof import("./functions/ObjectKeys.js").AllowedKeys;
     };
 };
 export default _default;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,sBAAsB,CAAC;AAC9C,OAAO,YAAY,MAAM,yBAAyB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AAKnD,wBAME"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,yBAAyB,CAAC;AACjD,OAAO,YAAY,MAAM,4BAA4B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AAKtD,wBAME"}

package/dist/index.js

@@ -1,7 +1,7 @@
-import coloredlog from "./functions/Colorlog";
-import errorHandler from "./functions/handleError";
-import config from "./functions/Config";
-import object from "./functions/ObjectKeys";
+import coloredlog from "./functions/Colorlog.js";
+import errorHandler from "./functions/handleError.js";
+import config from "./functions/Config.js";
+import object from "./functions/ObjectKeys.js";
 export default {
     coloredlog,
     errorHandler,

package/package.json

@@ -1,62 +1,62 @@
-{
-  "name": "@gerync/utils",
-  "version": "1.0.0",
-  "description": "A collection of utilities for any type of project, providing logging, error handling, configuration management, and object manipulation helpers.",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "type": "module",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "SECURITY.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "keywords": [
-    "utilities",
-    "error-handling",
-    "logging",
-    "express",
-    "middleware",
-    "validation",
-    "configuration",
-    "i18n",
-    "object-manipulation",
-    "typescript",
-    "multi-language",
-    "utils",
-    "multilingual"
-  ],
-  "author": "gerync",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/gerync/utils.git"
-  },
-  "bugs": {
-    "url": "https://github.com/gerync/utils/issues"
-  },
-  "homepage": "https://github.com/gerync/utils#readme",
-  "peerDependencies": {
-    "express": "^5.0.0"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/node": "^20.11.30",
-    "@types/express": "^4.17.21",
-    "express": "^5.2.1",
-    "typescript": "^5.6.3",
-    "vitest": "^1.6.0"
-  }
+{
+  "name": "@gerync/utils",
+  "version": "1.0.1",
+  "description": "A collection of utilities for any type of project, providing logging, error handling, configuration management, and object manipulation helpers.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "utilities",
+    "error-handling",
+    "logging",
+    "express",
+    "middleware",
+    "validation",
+    "configuration",
+    "i18n",
+    "object-manipulation",
+    "typescript",
+    "multi-language",
+    "utils",
+    "multilingual"
+  ],
+  "author": "gerync",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gerync/utils.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gerync/utils/issues"
+  },
+  "homepage": "https://github.com/gerync/utils#readme",
+  "peerDependencies": {
+    "express": "^5.0.0"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.11.30",
+    "@types/express": "^4.17.21",
+    "express": "^5.2.1",
+    "typescript": "^5.6.3",
+    "vitest": "^1.6.0"
+  }
 }