zario

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

Contributing

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

License

MIT License

Back to Top