📝 Zario

Fast and simple logging library for TypeScript

Japanese

Fast • Simple • Zero Dependencies • TypeScript Native

⚡ Quick Start · 📖 Documentation · 🤝 Contributing

Features

• Zero dependencies — nothing to install, nothing to break
• Simple API — logger.info(), logger.warn(), logger.error()
• Flexible formatting — plain text or structured JSON
• Multiple transports — Console, File (rotation + compression), HTTP (with retry)
• Child loggers — scoped logging for modules or requests
• Async mode — non-blocking writes for high-throughput apps
• Customizable — custom log levels, colors, and filters

📦 Installation

npm install 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 });

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,
    }),
  ],
});

Lean Import

If you only need the core logger:

import { Logger } from "zario/logger";

📖 Documentation

| Section | Description | |---|---| | Configuration | Logger options, custom levels, and colors | | API Reference | Logger class and utilities | | Transports | Console, File, HTTP, CircuitBreaker, DeadLetterQueue | | Advanced Usage | Filters, enrichers, aggregators, async mode | | Log Formats | Text and JSON output spec | | Benchmarks | Performance comparison with other libraries | | Roadmap | Future plans |

🤝 Contributing

Bug reports, feature requests, and pull requests welcome. See Contributing Guide.

📄 License

MIT License

⭐ Star this repository if you find it useful

⬆ Back to Top