@kawaiininja/logger

A lightweight, customizable logger for TypeScript/JavaScript applications, featuring log levels, custom colors, and grouping capabilities.

Installation

npm install @kawaiininja/logger

Usage

Basic Usage

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:

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

logger.group("User Details");
logger.info("Name: Myu");
logger.info("Role: Admin");
logger.groupEnd();

Table Logging

const users = [
  { id: 1, name: "Alice" },
  { id: 2, name: "Bob" },
];

logger.table(users);