@kawaiininja/logger 1.0.2

package/README.md

@@ -0,0 +1,83 @@
+# @kawaiininja/logger
+
+A lightweight, customizable logger for TypeScript/JavaScript applications, featuring log levels, custom colors, and grouping capabilities.
+
+## Installation
+
+```bash
+npm install @kawaiininja/logger
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { Logger } from "@kawaiininja/logger";
+
+const logger = new Logger({
+  name: "MyArgs",
+  level: "debug",
+});
+
+logger.info("Application started");
+logger.error("Something went wrong", { error: "details" });
+```
+
+### Configuration Options
+
+You can configure the logger when initializing:
+
+```typescript
+const logger = new Logger({
+  // Name to display in the log prefix (default: "App")
+  name: "AuthService",
+
+  // Minimum log level to display (default: "error")
+  // Levels: "debug" | "info" | "warn" | "error" | "off"
+  level: "debug",
+
+  // Force development mode (default: false)
+  // If true, enables debug logs regardless of other settings
+  isDevelopment: process.env.NODE_ENV === "development",
+
+  // Override default colors (optional)
+  colors: {
+    info: "#3b82f6",
+    error: "#ef4444",
+  },
+});
+```
+
+### Log Levels
+
+The logger supports the following levels in order of priority:
+
+1. `error` (High priority)
+2. `warn`
+3. `info`
+4. `debug` (Low priority)
+
+Setting certain level will show logs of that level and higher. For example, setting `level: 'warn'` will show `warn` and `error` logs, but hide `info` and `debug`.
+
+### Advanced Features
+
+#### Grouping Logs
+
+```typescript
+logger.group("User Details");
+logger.info("Name: Myu");
+logger.info("Role: Admin");
+logger.groupEnd();
+```
+
+#### Table Logging
+
+```typescript
+const users = [
+  { id: 1, name: "Alice" },
+  { id: 2, name: "Bob" },
+];
+
+logger.table(users);
+```

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Logger class for application logging
+ * Based on variant.v2/logger.util.js from frontend-libs
+ */
+export interface LoggerOptions {
+    name?: string;
+    level?: string;
+    isDevelopment?: boolean;
+    colors?: Partial<Record<LogLevel, string>>;
+}
+type LogLevel = "debug" | "info" | "warn" | "error" | "off";
+export declare class Logger {
+    private name;
+    private levels;
+    private currentLevel;
+    private isDevelopment;
+    private colors;
+    constructor(options?: LoggerOptions);
+    private shouldLog;
+    private log;
+    debug(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    /**
+     * Start a collapsible group
+     */
+    group(title: string, level?: LogLevel): void;
+    /**
+     * End a collapsible group
+     */
+    groupEnd(): void;
+    /**
+     * Log data as a table
+     */
+    table(data: any, level?: LogLevel): void;
+}
+export {};

package/dist/index.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Logger class for application logging
+ * Based on variant.v2/logger.util.js from frontend-libs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+class Logger {
+    constructor(options = {}) {
+        this.name = options.name || "App";
+        this.levels = { debug: 4, info: 3, warn: 2, error: 1, off: 0 };
+        const requestedLevel = options.level?.toLowerCase();
+        this.currentLevel =
+            requestedLevel && this.levels[requestedLevel] !== undefined
+                ? this.levels[requestedLevel]
+                : this.levels.error;
+        this.isDevelopment = options.isDevelopment ?? false;
+        this.colors = {
+            debug: "#38BDF8",
+            info: "#10B981",
+            warn: "#FBBF24",
+            error: "#F87171",
+            ...options.colors,
+        };
+    }
+    shouldLog(level) {
+        if (!this.isDevelopment && level === "debug")
+            return false;
+        const req = this.levels[level.toLowerCase()] || 0;
+        return req > 0 && req <= this.currentLevel;
+    }
+    log(level, ...args) {
+        if (!this.shouldLog(level))
+            return;
+        const prefix = `%c[${this.name}] ${level.toUpperCase()}`;
+        const style = `color: ${this.colors[level]}; font-weight: bold;`;
+        const method = console[level] || console.log;
+        method(prefix, style, ...args);
+    }
+    debug(...args) {
+        this.log("debug", ...args);
+    }
+    info(...args) {
+        this.log("info", ...args);
+    }
+    warn(...args) {
+        this.log("warn", ...args);
+    }
+    error(...args) {
+        this.log("error", ...args);
+    }
+    /**
+     * Start a collapsible group
+     */
+    group(title, level = "info") {
+        if (!this.shouldLog(level))
+            return;
+        console.group(`%c${title}`, "color: #10B981; font-weight: bold;");
+    }
+    /**
+     * End a collapsible group
+     */
+    groupEnd() {
+        console.groupEnd();
+    }
+    /**
+     * Log data as a table
+     */
+    table(data, level = "debug") {
+        if (!this.shouldLog(level))
+            return;
+        console.table(data);
+    }
+}
+exports.Logger = Logger;

package/package.json

@@ -0,0 +1,20 @@
+{
+    "name": "@kawaiininja/logger",
+    "version": "1.0.2",
+    "description": "Logger class for application logging",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc"
+    },
+    "keywords": [
+        "logger",
+        "logging",
+        "typescript"
+    ],
+    "author": "",
+    "license": "ISC",
+    "devDependencies": {
+        "typescript": "^5.3.0"
+    }
+}