⚡ @kaushverse/fast-logger

Ultra‑fast, lightweight TypeScript logging library for Node.js applications.

🚀 Features

• ⚡ Fast logging pipeline
• 🎨 Colored terminal logs
• 🧾 Human readable text logs
• 📦 Structured JSON logs
• 🚚 Multiple transports (Console, File, HTTP)
• 🧠 Log level filtering
• 🧰 Utility helpers
• 🔒 Type‑safe TypeScript API

📦 Installation

npm install @kaushverse/fast-logger

⚡ Quick Start

import { createLogger } from "@kaushverse/fast-logger"

const logger = createLogger({
  level: "debug",
  enableColors: true
})

logger.info("Server started")
logger.warn("Memory usage high")
logger.error("Database failed")

Output:

[INFO] Server started
[WARN] Memory usage high
[ERROR] Database failed

🧠 Log Levels

| Level | Purpose | | -------- | --------------------- | | 🐛 debug | debugging information | | ℹ info | general logs | | ⚠ warn | warnings | | ❌ error | runtime errors | | 💀 fatal | critical failures |

Example:

logger.debug("Cache hit")
logger.info("Server started")
logger.warn("Memory high")
logger.error("DB failed")
logger.fatal("Application crashed")

🎨 Formatters

Formatters control how logs are formatted before sending to transports.

🧾 Text Formatter

import { textFormatter } from "@kaushverse/fast-logger"

const log = textFormatter("info", "Server started")

Output

[INFO] 2026-01-01T10:00:00Z Server started

📦 JSON Formatter

import { jsonFormatter } from "@kaushverse/fast-logger"

const log = jsonFormatter("info", "Server started")
console.log(log)

Output

{"level":"info","message":"Server started","timestamp":"2026-01-01T10:00:00Z"}

🎨 Color Formatter

import { colorize } from "@kaushverse/fast-logger"

console.log(colorize("error", "[ERROR] Database failed"))

🚚 Transports

Transports define where logs go.

🖥 Console Transport

import { consoleTransport } from "@kaushverse/fast-logger"

consoleTransport("info", "Server started")

📂 File Transport

import { fileTransport } from "@kaushverse/fast-logger"

fileTransport("error", "Database failed")

Example log file:

2026-01-01T10:00:00Z [ERROR] Database failed

🌐 HTTP Transport

import { httpTransport } from "@kaushverse/fast-logger"

await httpTransport(
  "error",
  "Database failed",
  { url: "https://log-server.com/logs" }
)

🧰 Utilities

⏱ Timestamp

import { getTimestamp } from "@kaushverse/fast-logger"

console.log(getTimestamp())

📦 stringify()

Safely convert values to strings.

import { stringify } from "@kaushverse/fast-logger"

stringify({ user: "chhotu", id: 1 })

🛡 safeJson()

Prevents crashes caused by circular objects.

import { safeJson } from "@kaushverse/fast-logger"

const obj:any = {}
obj.self = obj

console.log(safeJson(obj))

🎨 Constants

import { COLORS } from "@kaushverse/fast-logger"

console.log(COLORS.red + "Error occurred" + COLORS.reset)

🧠 TypeScript Support

import type { LogLevel, LoggerOptions } from "@kaushverse/fast-logger"

const options: LoggerOptions = {
  level: "debug",
  enableColors: true
}

⚡ Logger Pipeline

Application
     │
     ▼
createLogger()
     │
     ▼
Logger Engine
     │
     ▼
Formatter Layer
     │
     ▼
Transport Layer
  │      │      │
  ▼      ▼      ▼
Console  File   HTTP

🧠 Design Patterns Used

| Pattern | Purpose | | ----------------------- | ---------------- | | 🏭 Factory Pattern | createLogger | | 🎨 Formatter Pattern | formatters | | 🚚 Transport Pattern | log destinations | | 📦 Modular Architecture | scalable code |

🚀 Future Features

• ⚡ Async logging queue
• 📂 Log rotation
• 🧠 Child loggers
• 📊 Structured analytics

📜 License

MIT License

⭐ Support

If you like this project:

• ⭐ Star the repository
• 🐛 Report issues
• 🚀 Contribute improvements

@kaushverse/fast-logger — simple, fast, production‑ready logging.