npm package: @kaushverse/fast-logger
Description: ⚡ Ultra fast TypeScript logging library
Author: Kaushik
Latest version: 1.0.6

# ⚡ @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

```bash
npm install @kaushverse/fast-logger
```

---

# ⚡ Quick Start

```ts
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:

```ts
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

```ts
import { textFormatter } from "@kaushverse/fast-logger"

const log = textFormatter("info", "Server started")
```

Output

```
[INFO] 2026-01-01T10:00:00Z Server started
```

---

## 📦 JSON Formatter

```ts
import { jsonFormatter } from "@kaushverse/fast-logger"

const log = jsonFormatter("info", "Server started")
console.log(log)
```

Output

```json
{"level":"info","message":"Server started","timestamp":"2026-01-01T10:00:00Z"}
```

---

## 🎨 Color Formatter

```ts
import { colorize } from "@kaushverse/fast-logger"

console.log(colorize("error", "[ERROR] Database failed"))
```

---

# 🚚 Transports

Transports define **where logs go**.

## 🖥 Console Transport

```ts
import { consoleTransport } from "@kaushverse/fast-logger"

consoleTransport("info", "Server started")
```

---

## 📂 File Transport

```ts
import { fileTransport } from "@kaushverse/fast-logger"

fileTransport("error", "Database failed")
```

Example log file:

```
2026-01-01T10:00:00Z [ERROR] Database failed
```

---

## 🌐 HTTP Transport

```ts
import { httpTransport } from "@kaushverse/fast-logger"

await httpTransport(
  "error",
  "Database failed",
  { url: "https://log-server.com/logs" }
)
```

---

# 🧰 Utilities

## ⏱ Timestamp

```ts
import { getTimestamp } from "@kaushverse/fast-logger"

console.log(getTimestamp())
```

---

## 📦 stringify()

Safely convert values to strings.

```ts
import { stringify } from "@kaushverse/fast-logger"

stringify({ user: "chhotu", id: 1 })
```

---

## 🛡 safeJson()

Prevents crashes caused by circular objects.

```ts
import { safeJson } from "@kaushverse/fast-logger"

const obj:any = {}
obj.self = obj

console.log(safeJson(obj))
```

---

# 🎨 Constants

```ts
import { COLORS } from "@kaushverse/fast-logger"

console.log(COLORS.red + "Error occurred" + COLORS.reset)
```

---

# 🧠 TypeScript Support

```ts
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.**