📝 Zario

A Minimal Logging Solution for TypeScript

Japanese

Fast • Lightweight • Zero Dependencies • TypeScript Native

📖 Documentation · ⚡ Quick Start · ✨ Features · 🤝 Contributing

Features

• Lightweight — minimal footprint, fast execution
• Simple API — intuitive methods like info(), warn(), error()
• Flexible formatting — plain text or structured JSON
• Multiple transports — Console, File (streaming rotation), HTTP (async retry), CircuitBreaker, and DeadLetterQueue
• Child loggers — scoped logging for modules or requests
• Async mode — non-blocking writes for high-performance applications
• Memory safe — bounded queues and memory-efficient streaming
• Customizable — custom log levels, colors, and filtering

📦 Installation

bun add zario

🚀 Quick Start

import { Logger, ConsoleTransport } from "zario";

const logger = new Logger({
  level: "info",
  colorize: true,
  transports: [new ConsoleTransport()],
  prefix: "[MyApp]",
});

logger.info("🚀 Server started on port 3000");
logger.warn("⚠️ High memory usage detected");
logger.error("❌ Database connection failed", { code: 500 });

Lean Import Path

If you only need the logger class, use the lightweight entrypoint to reduce bundled code:

import { Logger } from "zario/logger";

zario/logger exports only Logger and related logger types. If you use retryOptions from this entrypoint, set Logger.retryTransportFactory with RetryTransport once at startup.

📘 More Examples

Child Logger

const requestLogger = logger.createChild({
  context: { scope: "request" },
});
requestLogger.info("Incoming request");

JSON Logging

import { Logger, ConsoleTransport } from "zario";

const jsonLogger = new Logger({
  json: true,
  transports: [new ConsoleTransport()],
});

File Transport

import { Logger, FileTransport } from "zario";

const logger = new Logger({
  transports: [
    new FileTransport({
      path: "./logs/app.log",
      maxSize: 10 * 1024 * 1024,
      maxFiles: 5,
    }),
  ],
});

logger.info("This log is written to a file");

📖 Documentation

Documentation:

Section	Description
📘 Introduction	Philosophy, core features, and common use cases.
🚀 Getting Started	Detailed installation and environment auto-configuration.
⚙️ Configuration	Full reference for all logger options, custom levels, and colors.
📖 API Reference	Detailed API documentation for the Logger class and utilities.
📁 Transports	Guide to Console, File, HTTP, CircuitBreaker, and DeadLetterQueue transports.
🧩 Advanced Usage	Filters, Enrichers (Structured Logging), and Aggregators.
📊 Log Formats	Specification for Text and JSON output formats.
🗺️ Roadmap	Future plans and upcoming features.
📊 Benchmarks	Performance comparison with other logging libraries.

🤝 Contributing

We welcome contributions! Whether it's bug reports, feature requests, or code contributions. Please see our Contributing Guide for more details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for full details.

Developed for developers

⭐ Star this repository to show your support

⬆ Back to Top