https://github.com/dev-dami/zario
A Minimal and Fast Logging Solution for TypeScript
https://github.com/dev-dami/zario
logger opensource typescript
Last synced: 22 days ago
JSON representation
A Minimal and Fast Logging Solution for TypeScript
- Host: GitHub
- URL: https://github.com/dev-dami/zario
- Owner: dev-dami
- License: mit
- Created: 2025-11-09T16:21:25.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-11T02:09:29.000Z (about 2 months ago)
- Last Synced: 2026-02-11T06:34:42.495Z (about 2 months ago)
- Topics: logger, opensource, typescript
- Language: TypeScript
- Homepage:
- Size: 584 KB
- Stars: 5
- Watchers: 1
- Forks: 10
- Open Issues: 3
-
Metadata Files:
- Readme: README-JP.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Roadmap: docs/roadmap-JP.md
Awesome Lists containing this project
README
# 📝 Zario
### TypeScript向けのミニマルなロギングソリューション
[](https://www.npmjs.com/package/zario)
[](./LICENSE)
[](https://www.npmjs.com/package/zario)
[](https://bundlephobia.com/package/zario)
](https://github.com/Dev-Dami/zario/actions)
[English](README.md)
**高速** • **軽量** • **依存関係ゼロ** • **TypeScriptネイティブ**
[📖 ドキュメント](#-documentation) · [⚡ クイックスタート](#-quick-start) · [✨ 特徴](#-features) · [🤝 コントリビューション](#-contributing)
## 特徴
- **軽量** — 最小限のサイズで高速に動作
- **シンプルなAPI** — `info()`, `warn()`, `error()` など直感的なメソッド
- **柔軟なフォーマット** — プレーンテキスト / 構造化JSONに対応
- **複数トランスポート** — Console、File（ストリーミング＋ローテーション）、HTTP（非同期リトライ）、CircuitBreaker、DeadLetterQueue
- **子ロガー** — モジュールやリクエスト単位のスコープ付きロギング
- **非同期モード** — 高負荷環境向けのノンブロッキング書き込み
- **メモリ安全** — 上限付きキューとメモリ効率の高いストリーミング設計
- **高い拡張性** — カスタムログレベル、カラー、フィルタリングに対応
## 📦 インストール
```bash
bun add zario
```
## 🚀 クイックスタート
```typescript
import { Logger, ConsoleTransport } from "zario";
const logger = new Logger({
level: "info",
colorize: true,
transports: [new ConsoleTransport()],
prefix: "[MyApp]",
});
logger.info("🚀 サーバーがポート3000で起動しました");
logger.warn("⚠️ メモリ使用量が高くなっています");
logger.error("❌ データベース接続に失敗しました", { code: 500 });
```
### 軽量インポートパス
`Logger` だけが必要な場合は、バンドルサイズ削減のために軽量エントリポイントを利用できます。
```typescript
import { Logger } from "zario/logger";
```
`zario/logger` は `Logger` と logger 関連型のみを公開します。
このエントリポイントで `retryOptions` を使う場合は、起動時に一度だけ `Logger.retryTransportFactory` を設定してください。
## 📖 ドキュメント
ドキュメント:
| セクション | 説明 |
|-----------|------|
| 📘 [**はじめに**](./docs/introduction-JP.md) | 設計思想、コア機能、主なユースケースの概要 |
| 🚀 [**スタートガイド**](./docs/getting-started-JP.md) | インストール方法と環境の自動セットアップ手順 |
| ⚙️ [**設定**](./docs/configuration-JP.md) | ロガー設定・カスタムレベル・カラー設定の完全リファレンス |
| 📖 [**APIリファレンス**](./docs/api-reference-JP.md) | Logger クラスおよび各種ユーティリティの詳細API仕様 |
| 📁 [**トランスポート**](./docs/transports-JP.md) | Console / File / HTTP / Circuit Breaker / Dead Letter Queue の解説 |
| 🧩 [**高度な使い方**](./docs/advanced-usage-JP.md) | フィルター・エンリッチャー（構造化ログ）・アグリゲーター |
| 📊 [**ログフォーマット**](./docs/log-formats-JP.md) | テキストおよび JSON 出力形式の仕様 |
| ⚡ [**ベンチマーク**](./docs/benchmarks-JP.md) | 他のロギングライブラリとの性能比較 |
| 🗺️ [**ロードマップ**](./docs/roadmap-JP.md) | 今後の計画と追加予定の機能 |
## 🤝 コントリビューション
バグ報告、機能提案、コードのコントリビューションを歓迎します。 詳細は [Contributing Guide](./CONTRIBUTING.md) をご覧ください。
## 📄 ライセンス
本プロジェクトは MIT License のもとで公開されています。詳細は[LICENSE](./LICENSE) をご覧ください。
### 開発者のために作られました
⭐ このリポジトリにスターを付けて応援してください
[⬆ トップへ戻る](#top)