sweet-error 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 𝖊𝖈𝖍𝖔
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# SweetError
+
+Makes nodeJs Error cleaner, more readable and better formatted
+
+## Installation
+
+#### NodeJs
+
+```sh
+npm install sweet-error
+```
+
+## Example
+
+```js
+// cjs
+const { SweetError } = require('sweet-error');
+// mjs
+import { SweetError } from 'sweet-error';
+
+new SweetError(
+  [
+    'Invalid password',
+    'A password should ... for example:',
+    ['Abc242$3231@', '323CR#@#IY', 'sgfgsfg%$$5#22323'],
+  ],
+  {
+    name: 'PwdValidator',
+    code: 'PwdValidator.invalidPwd',
+    exitCode: 1,
+  }
+);
+```
+
+<br />
+
+<div align='center'>
+  <img src="./sweet-error.png" style='border-radius: 10px'></img>
+</div>
+
+## Api
+
+```js
+const error = new SweetError(messages, [options]);
+```
+
+### messages
+
+**required**
+Type: `any[]`  
+An array of messages, where each message can be of any data type, and each index in the array represents a line.
+
+### options
+
+- **name**  
+  Type: `string`  
+  The string represents the instance name e.g: `SomeError`
+
+- **code**  
+  Type: `string`  
+  The string represents the instance code e.g: `SomeError.SomethingWrong`
+
+- **exitCode**  
+  Type: `string | number`  
+  The code to exit the `node.js` process with
+
+- **colorize**  
+  Type: `boolean`  
+  Default: `true`  
+  Enables or disables text colorization
+
+- **logger**  
+  Type: `function`  
+  The function that controls how the Error appears and how its parts are arranged, with some helpful utils that the `SweetError` uses internally
+
+### error.messages
+
+Type: `any[]`  
+Returns the specified messages array that is used to initialize the instance
+
+### error.options
+
+Type: `SweetErrorOptions | undefined`  
+Returns the options object that the instance initialized with
+
+### error.name
+
+Type: `string | undefined`  
+Returns the instance name
+
+### error.code
+
+Type: `string | undefined`  
+Returns the instance code of the error
+
+### error.exitCode
+
+Type: `string | number | undefined`  
+Returns the instance exit code that was used to exit the runtime.
+
+### error.stack
+
+Type: `any[]`  
+Returns an array of objects representing the captured instance stack.
+
+### error.func
+
+Type: `Function[]`  
+Returns an array of utility functions used internally to customize error output. These functions can also be destructured from this within the logger function in the instance's options object.
+
+<h4 align='center'>Please Hit the ⭐ button if you found this useful</h4>
+
+## License
+
+[MIT License ©](./LICENSE)

package/dist/SweetError.js

@@ -0,0 +1,252 @@
+'use strict';
+
+var StackUtils = require('stack-utils');
+var chalk = require('chalk');
+var json5 = require('json5');
+
+/**
+ * Colorize string sentences
+ *
+ * @param {string} sentence string to colorize
+ * @returns {string}
+ */
+function colorize(sentence) {
+    const colors = [
+        'red',
+        'green',
+        'redBright',
+        'yellow',
+        'blue',
+        'greenBright',
+        'magenta',
+        'cyan',
+        'yellowBright',
+        'white',
+        'blueBright',
+        'magentaBright',
+        'cyanBright',
+        'whiteBright',
+    ];
+    const parts = sentence.split(/(\s+)/);
+    return parts
+        .map((part) => {
+        if (/\S/.test(part)) {
+            return chalk[colors[Math.floor(Math.random() * colors.length)]](part);
+        }
+        return part;
+    })
+        .join('');
+}
+
+/**
+ * json5 stringifier
+ *
+ * @param {object} obj
+ * @returns {string}
+ */
+function format(object) {
+    return json5.stringify(object, null, 2);
+}
+
+/**
+ * Add string indentation
+ *
+ * @param {string} string
+ * @param {number} padding indentation lavel
+ * @returns {string}
+ */
+function indent(string, padding) {
+    return string
+        .trim()
+        .split('\n')
+        .map((line) => {
+        return `${' '.repeat(padding || 0)}${line}`;
+    })
+        .join('\n');
+}
+
+/**
+ * Controls how lines should wrap
+ *
+ * @param {string} text
+ * @param {number} width
+ * @returns {string}
+ */
+function wrap(
+/** The string to wrap */
+text, 
+/** Line width to break the words at */
+width = Math.min(Math.max(20, process.stdout.columns) || 80, 80)) {
+    let result = '';
+    let lineLength = 0;
+    for (const word of text.split(' ')) {
+        if (lineLength + word.length > width) {
+            result += '\n' + word;
+            lineLength = word.length;
+        }
+        else {
+            if (lineLength > 0) {
+                result += ' ';
+                lineLength++;
+            }
+            result += word;
+            lineLength += word.length;
+        }
+    }
+    return result;
+}
+
+/**
+ * The function that controls how the Error appears and how its parts are arranged
+ *
+ * @memberof SweetError
+ * @example ```js
+ * function logger() {
+ *   // you have access to all the properties of the SweetError to customize the way it appears
+ *   const { messages, name, code, stack, func } = this;
+ *   // also some utils may be helpful
+ *   const { format, indent, wrap } = func;
+ * }
+ *
+ * const opts = { logger };
+ *
+ * new SweetError([], opts);
+ * ```
+ */
+function logger() {
+    var _a, _b, _c;
+    logName(this);
+    for (let i = 0; i < this.messages.length; i++) {
+        const message = this.messages[i];
+        const lastIndex = this.messages.length - 1;
+        if (typeof message === 'string') {
+            if (this === null || this === void 0 ? void 0 : this.name) {
+                if (((_a = this === null || this === void 0 ? void 0 : this.options) === null || _a === void 0 ? void 0 : _a.colorize) === true) {
+                    console.log(colorize(indent(wrap(message), 2)));
+                }
+                else {
+                    console.log(indent(wrap(message), 2));
+                }
+            }
+            else {
+                if (((_b = this === null || this === void 0 ? void 0 : this.options) === null || _b === void 0 ? void 0 : _b.colorize) === true) {
+                    console.log(colorize(wrap(message)));
+                }
+                else {
+                    console.log(wrap(message));
+                }
+            }
+        }
+        else if (typeof message === 'object') {
+            if (i != 0) {
+                console.log('');
+            }
+            console.log(indent(format(message), 2));
+            if (i != lastIndex) {
+                console.log('');
+            }
+        }
+        else {
+            console.log('  ' + message);
+        }
+    }
+    console.log('');
+    logStack(this);
+    console.log('');
+    logCode(this);
+    if (this === null || this === void 0 ? void 0 : this.exitCode) {
+        console.log('');
+        ((_c = this === null || this === void 0 ? void 0 : this.options) === null || _c === void 0 ? void 0 : _c.colorize)
+            ? console.log('🟡', chalk.yellow('Exit:'), this.exitCode)
+            : console.log('🟡', 'Exit:', this.exitCode);
+    }
+}
+/**
+ * Log the SweetError name
+ *
+ * @memberof logger
+ * @param {SweetError} error
+ */
+function logName(error) {
+    if (!(error === null || error === void 0 ? void 0 : error.name))
+        return;
+    return console.log('🔴', chalk.red.bold.underline(error.name));
+}
+/**
+ * Log the SweetError code
+ * @memberof logger
+ * @param {SweetError} error
+ */
+function logCode(error) {
+    var _a;
+    if (!(error === null || error === void 0 ? void 0 : error.code))
+        return;
+    return ((_a = error === null || error === void 0 ? void 0 : error.options) === null || _a === void 0 ? void 0 : _a.colorize)
+        ? console.log(indent(chalk.gray.underline(`${error.code}`), 2))
+        : console.log(indent(chalk.underline(`${error.code}`), 2));
+}
+/**
+ * Log the SweetError stack trace lines
+ * @memberof logger
+ * @param {SweetError} error
+ */
+function logStack(error) {
+    error.stack.shift();
+    error.stack.forEach((object) => {
+        if (!object)
+            return;
+        let stackLine = '';
+        Object.keys(object).forEach((key) => {
+            var _a;
+            if (((_a = error === null || error === void 0 ? void 0 : error.options) === null || _a === void 0 ? void 0 : _a.colorize) === true) {
+                stackLine += `${chalk.bold(key)}: ${colorize(chalk.italic(object[key]))} `;
+            }
+            else {
+                stackLine += `${chalk.bold(key)}: ${chalk.italic(object[key])} `;
+            }
+        });
+        return console.log(indent('→ ' + stackLine.trim(), 2));
+    });
+}
+
+const stackUtils = new StackUtils({ cwd: process.cwd() });
+/**
+ * Initializ a new `SweetError` instance
+ */
+class SweetError {
+    constructor(messages, options) {
+        if (!Array.isArray(messages)) {
+            throw new Error('SweetError.messages is not array');
+        }
+        this.messages = messages;
+        if (Object.prototype.toString.call(options) === '[object Object]') {
+            this.options = options;
+            if (!('logger' in this.options)) {
+                this.options.logger = logger;
+            }
+            if (!('colorize' in this.options)) {
+                this.options.colorize = true;
+            }
+            Object.keys(options).forEach(opt => {
+                if (options[opt] && opt != 'colorize' && opt != 'logger') {
+                    this[opt] = options[opt];
+                }
+            });
+        }
+        else {
+            this.options = { logger, colorize: true };
+        }
+        this.stack = stackUtils
+            .captureString()
+            .split('\n')
+            .map((line) => {
+            return stackUtils.parseLine(line);
+        });
+        this.func = { colorize, format, indent, wrap };
+        this.options.logger.call(this);
+        return process.exit((this === null || this === void 0 ? void 0 : this.exitCode) || 0);
+    }
+}
+
+exports.SweetError = SweetError;
+//# sourceMappingURL=SweetError.js.map

package/dist/SweetError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SweetError.js","sources":["../src/utils/colorize.ts","../src/utils/format.ts","../src/utils/indent.ts","../src/utils/wrap.ts","../src/utils/logger.ts","../src/SweetError.ts"],"sourcesContent":[null,null,null,null,null,null],"names":[],"mappings":"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"}

package/dist/SweetError.mjs

@@ -0,0 +1,250 @@
+import StackUtils from 'stack-utils';
+import chalk from 'chalk';
+import json5 from 'json5';
+
+/**
+ * Colorize string sentences
+ *
+ * @param {string} sentence string to colorize
+ * @returns {string}
+ */
+function colorize(sentence) {
+    const colors = [
+        'red',
+        'green',
+        'redBright',
+        'yellow',
+        'blue',
+        'greenBright',
+        'magenta',
+        'cyan',
+        'yellowBright',
+        'white',
+        'blueBright',
+        'magentaBright',
+        'cyanBright',
+        'whiteBright',
+    ];
+    const parts = sentence.split(/(\s+)/);
+    return parts
+        .map((part) => {
+        if (/\S/.test(part)) {
+            return chalk[colors[Math.floor(Math.random() * colors.length)]](part);
+        }
+        return part;
+    })
+        .join('');
+}
+
+/**
+ * json5 stringifier
+ *
+ * @param {object} obj
+ * @returns {string}
+ */
+function format(object) {
+    return json5.stringify(object, null, 2);
+}
+
+/**
+ * Add string indentation
+ *
+ * @param {string} string
+ * @param {number} padding indentation lavel
+ * @returns {string}
+ */
+function indent(string, padding) {
+    return string
+        .trim()
+        .split('\n')
+        .map((line) => {
+        return `${' '.repeat(padding || 0)}${line}`;
+    })
+        .join('\n');
+}
+
+/**
+ * Controls how lines should wrap
+ *
+ * @param {string} text
+ * @param {number} width
+ * @returns {string}
+ */
+function wrap(
+/** The string to wrap */
+text, 
+/** Line width to break the words at */
+width = Math.min(Math.max(20, process.stdout.columns) || 80, 80)) {
+    let result = '';
+    let lineLength = 0;
+    for (const word of text.split(' ')) {
+        if (lineLength + word.length > width) {
+            result += '\n' + word;
+            lineLength = word.length;
+        }
+        else {
+            if (lineLength > 0) {
+                result += ' ';
+                lineLength++;
+            }
+            result += word;
+            lineLength += word.length;
+        }
+    }
+    return result;
+}
+
+/**
+ * The function that controls how the Error appears and how its parts are arranged
+ *
+ * @memberof SweetError
+ * @example ```js
+ * function logger() {
+ *   // you have access to all the properties of the SweetError to customize the way it appears
+ *   const { messages, name, code, stack, func } = this;
+ *   // also some utils may be helpful
+ *   const { format, indent, wrap } = func;
+ * }
+ *
+ * const opts = { logger };
+ *
+ * new SweetError([], opts);
+ * ```
+ */
+function logger() {
+    var _a, _b, _c;
+    logName(this);
+    for (let i = 0; i < this.messages.length; i++) {
+        const message = this.messages[i];
+        const lastIndex = this.messages.length - 1;
+        if (typeof message === 'string') {
+            if (this === null || this === void 0 ? void 0 : this.name) {
+                if (((_a = this === null || this === void 0 ? void 0 : this.options) === null || _a === void 0 ? void 0 : _a.colorize) === true) {
+                    console.log(colorize(indent(wrap(message), 2)));
+                }
+                else {
+                    console.log(indent(wrap(message), 2));
+                }
+            }
+            else {
+                if (((_b = this === null || this === void 0 ? void 0 : this.options) === null || _b === void 0 ? void 0 : _b.colorize) === true) {
+                    console.log(colorize(wrap(message)));
+                }
+                else {
+                    console.log(wrap(message));
+                }
+            }
+        }
+        else if (typeof message === 'object') {
+            if (i != 0) {
+                console.log('');
+            }
+            console.log(indent(format(message), 2));
+            if (i != lastIndex) {
+                console.log('');
+            }
+        }
+        else {
+            console.log('  ' + message);
+        }
+    }
+    console.log('');
+    logStack(this);
+    console.log('');
+    logCode(this);
+    if (this === null || this === void 0 ? void 0 : this.exitCode) {
+        console.log('');
+        ((_c = this === null || this === void 0 ? void 0 : this.options) === null || _c === void 0 ? void 0 : _c.colorize)
+            ? console.log('🟡', chalk.yellow('Exit:'), this.exitCode)
+            : console.log('🟡', 'Exit:', this.exitCode);
+    }
+}
+/**
+ * Log the SweetError name
+ *
+ * @memberof logger
+ * @param {SweetError} error
+ */
+function logName(error) {
+    if (!(error === null || error === void 0 ? void 0 : error.name))
+        return;
+    return console.log('🔴', chalk.red.bold.underline(error.name));
+}
+/**
+ * Log the SweetError code
+ * @memberof logger
+ * @param {SweetError} error
+ */
+function logCode(error) {
+    var _a;
+    if (!(error === null || error === void 0 ? void 0 : error.code))
+        return;
+    return ((_a = error === null || error === void 0 ? void 0 : error.options) === null || _a === void 0 ? void 0 : _a.colorize)
+        ? console.log(indent(chalk.gray.underline(`${error.code}`), 2))
+        : console.log(indent(chalk.underline(`${error.code}`), 2));
+}
+/**
+ * Log the SweetError stack trace lines
+ * @memberof logger
+ * @param {SweetError} error
+ */
+function logStack(error) {
+    error.stack.shift();
+    error.stack.forEach((object) => {
+        if (!object)
+            return;
+        let stackLine = '';
+        Object.keys(object).forEach((key) => {
+            var _a;
+            if (((_a = error === null || error === void 0 ? void 0 : error.options) === null || _a === void 0 ? void 0 : _a.colorize) === true) {
+                stackLine += `${chalk.bold(key)}: ${colorize(chalk.italic(object[key]))} `;
+            }
+            else {
+                stackLine += `${chalk.bold(key)}: ${chalk.italic(object[key])} `;
+            }
+        });
+        return console.log(indent('→ ' + stackLine.trim(), 2));
+    });
+}
+
+const stackUtils = new StackUtils({ cwd: process.cwd() });
+/**
+ * Initializ a new `SweetError` instance
+ */
+class SweetError {
+    constructor(messages, options) {
+        if (!Array.isArray(messages)) {
+            throw new Error('SweetError.messages is not array');
+        }
+        this.messages = messages;
+        if (Object.prototype.toString.call(options) === '[object Object]') {
+            this.options = options;
+            if (!('logger' in this.options)) {
+                this.options.logger = logger;
+            }
+            if (!('colorize' in this.options)) {
+                this.options.colorize = true;
+            }
+            Object.keys(options).forEach(opt => {
+                if (options[opt] && opt != 'colorize' && opt != 'logger') {
+                    this[opt] = options[opt];
+                }
+            });
+        }
+        else {
+            this.options = { logger, colorize: true };
+        }
+        this.stack = stackUtils
+            .captureString()
+            .split('\n')
+            .map((line) => {
+            return stackUtils.parseLine(line);
+        });
+        this.func = { colorize, format, indent, wrap };
+        this.options.logger.call(this);
+        return process.exit((this === null || this === void 0 ? void 0 : this.exitCode) || 0);
+    }
+}
+
+export { SweetError };
+//# sourceMappingURL=SweetError.mjs.map

package/dist/SweetError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SweetError.mjs","sources":["../src/utils/colorize.ts","../src/utils/format.ts","../src/utils/indent.ts","../src/utils/wrap.ts","../src/utils/logger.ts","../src/SweetError.ts"],"sourcesContent":[null,null,null,null,null,null],"names":[],"mappings":"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"}

package/dist/types/SweetError.d.ts

@@ -0,0 +1,64 @@
+interface SweetErrorOptions {
+    /** The instance name e.g `SomeError` */
+    name?: string;
+    /** The instance code e.g `SomeError.SomethingWrong` */
+    code?: string;
+    /** The code to exit the `node.js` process with */
+    exitCode?: string | number;
+    /** Enables or disables text colorization - (default is true) */
+    colorize?: boolean;
+    /** Controls how should `SweetError` output looks and organized */
+    logger?: () => void;
+}
+/**
+ * Initializ a new `SweetError` instance
+ */
+export declare class SweetError {
+    /** An array of messages, each index represents a line */
+    messages: any[];
+    /** SweetError options object */
+    options?: SweetErrorOptions;
+    /** The instance name e.g `SomeError` */
+    name?: string;
+    /** The instance code e.g `SomeError.SomethingWrong` */
+    code?: string;
+    /** The number or string to exit the `node.js` process with */
+    exitCode?: number | string;
+    /** The instance captured stack */
+    stack?: any[];
+    /** SweetError utils */
+    func: {
+        /**
+         * Colorize string sentences
+         *
+         * @param {string} sentence string to colorize
+         * @returns {string}
+         */
+        colorize: (sentence: string) => string;
+        /**
+         * json5 stringifier
+         *
+         * @param {object} obj
+         * @returns {string}
+         */
+        format: (object: any) => string;
+        /**
+         * Add string indentation
+         *
+         * @param {string} string
+         * @param {number} padding indentation lavel
+         * @returns {string}
+         */
+        indent: (string: string, padding: number) => string;
+        /**
+         * Controls how lines should wrap
+         *
+         * @param {string} text
+         * @param {number} width
+         * @returns {string}
+         */
+        wrap: (text: string, width: number) => string;
+    };
+    constructor(messages: any[], options?: SweetErrorOptions);
+}
+export {};

package/dist/types/utils/colorize.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Colorize string sentences
+ *
+ * @param {string} sentence string to colorize
+ * @returns {string}
+ */
+export declare function colorize(sentence: string): string;

package/dist/types/utils/format.d.ts

@@ -0,0 +1,7 @@
+/**
+ * json5 stringifier
+ *
+ * @param {object} obj
+ * @returns {string}
+ */
+export declare function format(object: any): string;

package/dist/types/utils/indent.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Add string indentation
+ *
+ * @param {string} string
+ * @param {number} padding indentation lavel
+ * @returns {string}
+ */
+export declare function indent(string: string, padding?: number): string;

package/dist/types/utils/logger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The function that controls how the Error appears and how its parts are arranged
+ *
+ * @memberof SweetError
+ * @example ```js
+ * function logger() {
+ *   // you have access to all the properties of the SweetError to customize the way it appears
+ *   const { messages, name, code, stack, func } = this;
+ *   // also some utils may be helpful
+ *   const { format, indent, wrap } = func;
+ * }
+ *
+ * const opts = { logger };
+ *
+ * new SweetError([], opts);
+ * ```
+ */
+export declare function logger(): void;

package/dist/types/utils/wrap.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Controls how lines should wrap
+ *
+ * @param {string} text
+ * @param {number} width
+ * @returns {string}
+ */
+export declare function wrap(
+/** The string to wrap */
+text: string, 
+/** Line width to break the words at */
+width?: number): string;

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "sweet-error",
+  "version": "1.0.1",
+  "description": "Makes nodeJs Error cleaner, more readable and better formatted",
+  "author": "𝖊𝖈𝖍𝖔 <https://github.com/echo-64>",
+  "license": "MIT",
+  "main": "./dist/SweetError.js",
+  "module": "./dist/SweetError.mjs",
+  "types": "./dist/types/SweetError.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/SweetError.js",
+      "import": "./dist/SweetError.mjs",
+      "types": "./dist/types/SweetError.d.ts"
+    }
+  },
+  "files": [
+    "./dist",
+    "./LICENSE",
+    "./README.md",
+    "./package.json",
+    "./sweet-error.png"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/echo-64/sweet-error.git"
+  },
+  "scripts": {
+    "clean": "rm -rf ./dist/*",
+    "watch": "rollup -c -w",
+    "build": "npm run clean && rollup -c"
+  },
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/node": "^22.15.23",
+    "tslib": "^2.8.1"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "json5": "^2.2.3",
+    "stack-utils": "^2.0.6"
+  }
+}