logixia 1.12.3 → 1.12.5

package/README.md

@@ -1,5 +1,9 @@
 # logixia
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Logixia/logixia/main/.github/assets/logixia-banner.png" alt="logixia: the async-first TypeScript logger. One install, every transport, never blocks the event loop." width="100%"/>
+</p>
+
 <p align="center">
   <strong>The async-first TypeScript logger that ships complete.</strong><br/>
   Wide events &middot; OpenTelemetry (OTLP) &middot; Runtime log levels &middot; Redaction &middot; Adaptive sampling<br/>
@@ -14,6 +18,7 @@
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT"/></a>
   <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.0%2B-blue" alt="TypeScript"/></a>
   <a href="https://logixia.github.io/logixia/"><img src="https://img.shields.io/badge/website-logixia.github.io-a855f7" alt="website"/></a>
+  <a href="#sponsor"><img src="https://img.shields.io/badge/sponsor-%E2%99%A5-a855f7" alt="sponsor"/></a>
 </p>
 
 <p align="center">
@@ -130,6 +135,7 @@ await logger.info('Server started', { port: 3000 });
 - [CLI tool](#cli-tool)
   - [explore — Visual TUI log explorer](#explore--visual-tui-log-explorer)
 - [Configuration reference](#configuration-reference)
+- [Sponsor](#sponsor)
 - [Contributing](#contributing)
 - [License](#license)
 
@@ -196,24 +202,26 @@ logixia takes a different approach: **everything ships built-in, and nothing blo
 
 ## Performance
 
-logixia is async-first and built for the hot path: a synchronous fast path for in-process transports (no Promise allocated when the write completes synchronously), a millisecond-cached timestamp, lazy formatting (each transport formats once — no wasted pre-format), and per-call work (level check, namespace resolution, redaction decision) served off pre-built caches. The result: logixia **beats pino on 5 of 6 real-world scenarios**, beats winston and bunyan across the board, and keeps **p99 latency at 1–3µs** with no tail spikes.
+logixia is async-first and built for the hot path: a synchronous fast path for in-process transports (no Promise allocated when the write completes synchronously), a millisecond-cached timestamp, lazy formatting (each transport formats once), and per-call work (level check, namespace resolution, redaction decision) served off pre-built caches.
 
-Benchmarked against **pino, winston, and bunyan** — all writing to `/dev/null` (pure serialization + framework overhead, no disk/terminal cost). Node 20, Apple M-series; numbers are ops/sec, higher is better. Reproduce with `npm run benchmark`.
+Every library below writes the **same JSON output** to a null sink, so this measures serialization and framework overhead, not disk or terminal speed. Node 22, Apple Silicon, ops/sec (higher is better). Reproduce with `npm run benchmark`.
 
-| Scenario                       |      pino |   **logixia** |   winston |  bunyan |
-| ------------------------------ | --------: | ------------: | --------: | ------: |
-| Simple string log              | 3,220,000 |     2,769,000 | 1,577,000 | 707,000 |
-| **Structured log (5 fields)**  | 1,319,000 | **1,536,000** |   699,000 | 536,000 |
-| **Error object logging**       |   907,000 | **1,940,000** | 1,062,000 | 573,000 |
-| **Child / per-request logger** | 1,093,000 | **1,436,000** |   321,000 | 380,000 |
-| **Deep nested object**         |   891,000 | **1,040,000** |   435,000 | 442,000 |
-| **High-cardinality (12 flds)** |   651,000 | **1,027,000** |   316,000 | 404,000 |
+| Scenario                     |      pino | logixia (json) |   winston |
+| ---------------------------- | --------: | -------------: | --------: |
+| Simple string log            | 3,396,000 |      1,804,000 | 1,533,000 |
+| Structured log (5 fields)    | 1,308,000 |        931,000 |   729,000 |
+| Error object logging         | 1,192,000 |      1,587,000 | 1,078,000 |
+| Child / per-request logger   | 1,134,000 |        892,000 |   494,000 |
+| Deep nested object           | 1,327,000 |      1,023,000 |   549,000 |
+| High-cardinality (12 fields) |   734,000 |        525,000 |   400,000 |
 
 **What this means:**
 
-- ✅ **logixia is faster than pino on 5 of 6 scenarios** — including **+114% on error logging**, **+58% on high-cardinality**, **+31% on child loggers**, and **+16% on structured logs** — the shapes that dominate real production traffic.
-- ✅ **logixia beats winston and bunyan in every scenario**, often by 2–3×, and avoids their tail-latency spikes (winston hit **3,038µs p99** on high-cardinality and **412µs** on deep objects; logixia stays **1–3µs p99** throughout).
-- ⚖️ **pino still wins the trivial simple-string case** (−14%) because it writes synchronously straight to `process.stdout` — fast in a microbenchmark, but it blocks the event loop under real I/O and is exactly the path behind pino's open [flush-on-exit log-loss bug](#graceful-shutdown). logixia stays non-blocking and guarantees delivery, and pulls ahead the moment you log anything structured.
+- **pino is the fastest raw JSON serializer here.** It leads in 5 of 6 scenarios, by 21–47%. If raw throughput is the only thing you need, pino is a great choice.
+- **logixia is 1.2–1.9× faster than winston in every scenario**, with p99 latency of 1–5µs, against winston's 2.5–7.5µs.
+- logixia is ahead on error logging, partly because pino also serializes the full stack through its error serializer.
+- logixia's default human-readable console format is faster than its JSON mode. `npm run benchmark` prints both.
+- The point of logixia is everything else in one package: non-blocking file and database transports, tracing, redaction, OpenTelemetry, NestJS and the CLI. It aims to be fast enough that you never notice it, without six extra installs.
 
 **Distinctive-feature throughput** (no cross-library equivalent — `npm run benchmark:features`):
 
@@ -2595,6 +2603,17 @@ interface LoggerConfig {
 
 ---
 
+## Sponsor
+
+logixia is free and MIT-licensed, and it is built and maintained by one person. If it saves you time, sponsoring keeps it moving:
+
+- [GitHub Sponsors](https://github.com/sponsors/webcoderspeed)
+- [PayPal](https://paypal.me/Sniperspeed)
+
+`npm fund logixia` prints the same links.
+
+---
+
 ## Contributing
 
 ```bash