@i14a/logger 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 i14a-dsc
+
+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,19 @@
+# FancyLogger
+
+Simple console logger that prints boxed, colored messages.
+
+Usage:
+
+Install:
+
+```bash
+npm install @i14a/logger
+```
+
+Import:
+
+```ts
+import FancyLogger from '@i14a/logger';
+
+FancyLogger.success('Done');
+```

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { FancyLogger } from './logger';
+export { FancyLogger };
+export type { FancyLoggerOptions } from './types';
+export default FancyLogger;

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FancyLogger = void 0;
+const logger_1 = require("./logger");
+Object.defineProperty(exports, "FancyLogger", { enumerable: true, get: function () { return logger_1.FancyLogger; } });
+exports.default = logger_1.FancyLogger;

package/dist/logger.d.ts

@@ -0,0 +1,68 @@
+import type { FancyLoggerOptions } from './types';
+export declare class FancyLogger {
+    /**
+     * Log with green color box.
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.success('Success!');
+     */
+    static success(message: string | string[], options?: FancyLoggerOptions): void;
+    /**
+     * Log with blue color box.
+     *
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.info('An info message');
+     */
+    static info(message: string | string[], options?: FancyLoggerOptions): void;
+    /**
+     * Log with yellow color box.
+     *
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.warning('Be careful!');
+     */
+    static warning(message: string | string[], options?: FancyLoggerOptions): void;
+    /**
+     * @deprecated This method is deprecated. Use `FancyLogger.warning` instead.
+     */
+    static warn(message: string | string[], options?: FancyLoggerOptions): void;
+    /**
+     * Log with red color box.
+     *
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.error(['An error has occurred');
+     */
+    static error(message: string | string[], options?: FancyLoggerOptions): void;
+    /**
+     * Log with rainbow colors
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.rainbow('Rainbow');
+     */
+    static rainbow(message: string | string[], options?: FancyLoggerOptions): void;
+    /**
+     * with a sparkle effect.
+     *
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.sparkle('Sparkle!');
+     */
+    static sparkle(message: string | string[], options?: FancyLoggerOptions): void;
+    /**
+     * The log is output as a loading message in a box.
+     * @param message Message to be output
+     * @param title Title to be output (optional)
+     * @example
+     * FancyLogger.loading('Loading...');
+     * FancyLogger.loading('Please wait...', '🔥 LOADING');
+     */
+    static loading(message: string, title?: string): void;
+}

package/dist/logger.js

@@ -0,0 +1,180 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FancyLogger = void 0;
+const boxen_1 = __importDefault(require("boxen"));
+const chalk_1 = __importDefault(require("chalk"));
+class FancyLogger {
+    /**
+     * Log with green color box.
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.success('Success!');
+     */
+    static success(message, options) {
+        const { title } = options ?? {};
+        const boxedMessage = (0, boxen_1.default)(chalk_1.default.green.bold(message), {
+            padding: 1,
+            margin: 1,
+            borderStyle: 'round',
+            borderColor: 'green',
+            backgroundColor: '#1a1a1a',
+            title: title ?? chalk_1.default.green.bold('✅ SUCCESS'),
+            titleAlignment: 'center',
+        });
+        console.log(boxedMessage);
+    }
+    /**
+     * Log with blue color box.
+     *
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.info('An info message');
+     */
+    static info(message, options) {
+        const { title } = options ?? {};
+        const boxedMessage = (0, boxen_1.default)(chalk_1.default.blue.bold(message), {
+            padding: 1,
+            margin: 1,
+            borderStyle: 'round',
+            borderColor: 'blue',
+            backgroundColor: '#1a1a1a',
+            title: title ?? chalk_1.default.blue.bold('ℹ️  INFO'),
+            titleAlignment: 'center',
+        });
+        console.log(boxedMessage);
+    }
+    /**
+     * Log with yellow color box.
+     *
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.warning('Be careful!');
+     */
+    static warning(message, options) {
+        const { title } = options ?? {};
+        const boxedMessage = (0, boxen_1.default)(chalk_1.default.yellow.bold(message), {
+            padding: 1,
+            margin: 1,
+            borderStyle: 'round',
+            borderColor: 'yellow',
+            backgroundColor: '#1a1a1a',
+            title: title ?? chalk_1.default.yellow.bold('⚠️  WARNING'),
+            titleAlignment: 'center',
+        });
+        console.log(boxedMessage);
+    }
+    /**
+     * @deprecated This method is deprecated. Use `FancyLogger.warning` instead.
+     */
+    static warn(message, options) {
+        this.warning(message, options);
+    }
+    /**
+     * Log with red color box.
+     *
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.error(['An error has occurred');
+     */
+    static error(message, options) {
+        const { title } = options ?? {};
+        const boxedMessage = (0, boxen_1.default)(chalk_1.default.red.bold(message), {
+            padding: 1,
+            margin: 1,
+            borderStyle: 'round',
+            borderColor: 'red',
+            backgroundColor: '#1a1a1a',
+            title: title ?? chalk_1.default.red.bold('❌ ERROR'),
+            titleAlignment: 'center',
+        });
+        console.log(boxedMessage);
+    }
+    /**
+     * Log with rainbow colors
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.rainbow('Rainbow');
+     */
+    static rainbow(message, options) {
+        const { title } = options ?? {};
+        if (Array.isArray(message)) {
+            message = message.join('\n');
+        }
+        const rainbowColors = [chalk_1.default.red, chalk_1.default.yellow, chalk_1.default.green, chalk_1.default.cyan, chalk_1.default.blue, chalk_1.default.magenta];
+        let rainbowContent;
+        if (rainbowColors.length === 0) {
+            rainbowContent = message;
+        }
+        else {
+            rainbowContent = message
+                .split('')
+                .map((char, index) => {
+                const colorFn = rainbowColors[index % rainbowColors.length];
+                return colorFn ? colorFn(char) : char;
+            })
+                .join('');
+        }
+        const boxedMessage = (0, boxen_1.default)(rainbowContent, {
+            padding: 1,
+            margin: 1,
+            borderStyle: 'double',
+            borderColor: 'magenta',
+            backgroundColor: '#1a1a1a',
+            title: title ?? chalk_1.default.magenta.bold('🌈 RAINBOW'),
+            titleAlignment: 'center',
+        });
+        console.log(boxedMessage);
+    }
+    /**
+     * with a sparkle effect.
+     *
+     * @param message Message string or array
+     * @param title The title of message
+     * @example
+     * FancyLogger.sparkle('Sparkle!');
+     */
+    static sparkle(message, options) {
+        const { title } = options ?? {};
+        const sparkleContent = `✨ ${message} ✨`;
+        const boxedMessage = (0, boxen_1.default)(chalk_1.default.cyan.bold(sparkleContent), {
+            padding: 1,
+            margin: 1,
+            borderStyle: 'round',
+            borderColor: 'cyan',
+            backgroundColor: '#1a1a1a',
+            title: title ?? chalk_1.default.cyan.bold('⭐ SPARKLE'),
+            titleAlignment: 'center',
+        });
+        console.log(boxedMessage);
+    }
+    /**
+     * The log is output as a loading message in a box.
+     * @param message Message to be output
+     * @param title Title to be output (optional)
+     * @example
+     * FancyLogger.loading('Loading...');
+     * FancyLogger.loading('Please wait...', '🔥 LOADING');
+     */
+    static loading(message, title) {
+        const content = chalk_1.default.yellow.bold(`⏳ ${message}...`);
+        const boxedMessage = (0, boxen_1.default)(content, {
+            padding: 1,
+            margin: 1,
+            borderStyle: 'round',
+            borderColor: 'yellow',
+            backgroundColor: '#1a1a1a',
+            title: title ?? chalk_1.default.yellow.bold('🔄 LOADING'),
+            titleAlignment: 'center',
+        });
+        console.log(boxedMessage);
+    }
+}
+exports.FancyLogger = FancyLogger;

package/dist/types.d.ts

@@ -0,0 +1,3 @@
+export interface FancyLoggerOptions {
+    title?: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@i14a/logger",
+  "version": "1.0.0",
+  "description": "Fancy logger for my projects",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "database",
+    "json",
+    "key-value",
+    "storage"
+  ],
+  "author": "i14a <dev.i14a.dsc@gmail.com>",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@types/node": "^25.0.10",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.0.1",
+    "@typescript-eslint/parser": "^8.54.0",
+    "eslint": "^9.39.2",
+    "eslint-plugin-unused-imports": "^4.3.0",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3"
+  }
+}