https://github.com/furkibuu/aiko_logger
Advanced, colorful logger for Node.js with file rotation, webhook integration and multilingual support (TR/EN)
https://github.com/furkibuu/aiko_logger
console debug discord logger logging nodejs npm-package webhook
Last synced: 1 day ago
JSON representation
Advanced, colorful logger for Node.js with file rotation, webhook integration and multilingual support (TR/EN)
- Host: GitHub
- URL: https://github.com/furkibuu/aiko_logger
- Owner: furkibuu
- License: mit
- Created: 2026-03-18T21:58:15.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-16T18:41:11.000Z (3 months ago)
- Last Synced: 2026-04-16T20:30:32.804Z (3 months ago)
- Topics: console, debug, discord, logger, logging, nodejs, npm-package, webhook
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/aiko.logger?activeTab=readme
- Size: 225 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🪵 aiko.logger
> ⚡ High-performance, zero-dependency logger for Node.js with JSON
> logging, transports, prefix & webhook support
------------------------------------------------------------------------
------------------------------------------------------------------------
## 🚀 Overview
**aiko.logger** is a fast, flexible and production-ready logging library
for Node.js.
- Discord bots 🤖\
- APIs & backend services 🌐\
- CLI tools 🖥️
Built with **non-blocking async I/O** and **zero dependencies**.
------------------------------------------------------------------------
## ✨ Features
- ⚡ Non-blocking async architecture
- 🎨 7 log levels
- 📦 JSON logging support
- 🔌 Custom transports system
- 🧩 Prefix (scoped loggers)
- 🎚️ Log filtering (`minLevel`)
- 📁 Daily log rotation
- 🧹 Auto cleanup system
- 🚀 Discord webhook integration (with embeds)
- 🛡️ Smart formatting (Object, Array, Error)
- 🌐 Auto language detection (TR/EN)
- 📘 TypeScript support
- 💎 Zero dependencies
------------------------------------------------------------------------
## 📦 Installation
``` bash
npm install aiko.logger
```
------------------------------------------------------------------------
## ⚡ Quick Start
``` js
const { Logger } = require('aiko.logger');
const logger = new Logger({
saveToFile: true,
webhookUrl: 'YOUR_WEBHOOK_URL',
prefix: 'App'
});
logger.info('System started');
logger.error('Something went wrong');
```
------------------------------------------------------------------------
## 🧩 Prefix & Log Filtering
``` js
const dbLogger = new Logger({ prefix: 'MongoDB' });
dbLogger.info('Connection established.');
const webLogger = new Logger({
prefix: 'Express',
minLevel: 'warn'
});
webLogger.info('This will NOT log');
webLogger.error('Timeout!');
```
------------------------------------------------------------------------
## 📦 JSON Logging
``` js
const logger = new Logger({
format: 'json',
saveToFile: true
});
```
Output:
``` json
{
"timestamp": "2026-01-01T12:00:00.000Z",
"level": "INFO",
"message": "System started",
"prefix": "App"
}
```
------------------------------------------------------------------------
## 🔌 Custom Transports
``` js
logger.addTransport((log) => {
console.log("Custom transport:", log);
});
```
------------------------------------------------------------------------
## 🚀 Webhook Integration
- Sends logs as **Discord embeds**
- Includes prefix, level and timestamp
------------------------------------------------------------------------
## 🧹 Auto Cleanup
``` js
const logger = new Logger({
saveToFile: true,
keepLogsFor: 7,
autoCleanup: true
});
```
------------------------------------------------------------------------
## ⚙️ Configuration
```js
Option Description
------------- ---------------------
saveToFile Enable file logging
logFolder Log directory
keepLogsFor Retention days
autoCleanup Delete old logs
webhookUrl Discord webhook
prefix Label logs
minLevel Filter logs
format `text` or `json`
```
------------------------------------------------------------------------
## ⚔️ Comparison
Feature aiko.logger winston pino
------------------- ------------- --------- ------
Zero dependency ✅ ❌ ❌
JSON logging ✅ ✅ ✅
Custom transports ✅ ✅ ⚠️
Lightweight ✅ ❌ ✅
------------------------------------------------------------------------
## 🚀 Why aiko.logger?
- No dependencies → no bloat\
- Clean API → easy to use\
- Production-ready features
------------------------------------------------------------------------
## ⭐ Support
Give a ⭐ if you like it!
------------------------------------------------------------------------
## 📄 License
MIT License