@nxtedition/logger 1.0.4 → 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nxtedition
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @nxtedition/logger
+
+A high-performance, structured JSON logger built on [pino](https://github.com/pinojs/pino) with a dedicated worker thread for I/O.
+
+## Why a logger worker?
+
+In Node.js, multiple threads writing to stdout concurrently can interleave
+partial writes, producing corrupted or merged log lines. This is especially
+problematic when several worker threads each emit structured JSON — a single
+torn line breaks every downstream log parser.
+
+This package solves the problem by routing all log output through a single
+dedicated worker thread:
+
+1. **No tearing / interleaving** — Only one thread ever calls `write(2)` on
+   fd 1, so every JSON line is atomically written.
+2. **Better throughput** — Writers serialize log messages into lock-free ring
+   buffers backed by `SharedArrayBuffer` (SAB). The logger worker drains these
+   buffers and writes to stdout using synchronous I/O, avoiding back-pressure
+   from slow consumers stalling application threads.
+3. **Minimal latency on the hot path** — `writeSync` into a shared ring buffer
+   is a memory copy + atomic store. No syscall, no serialization contention.
+   The actual `write(2)` happens asynchronously on the worker thread.
+
+## Architecture
+
+```
+  ┌──────────────┐   ┌─────────────┐   ┌─────────────┐
+  │  Main thread │   │  Worker A   │   │  Worker B   │
+  │  (logger)    │   │  (logger)   │   │  (logger)   │
+  └──────┬───────┘   └──────┬──────┘   └──────┬──────┘
+         │                  │                 │
+    writeSync()        writeSync()        writeSync()
+         │                  │                 │
+    ┌────▼─────┐       ┌────▼─────┐      ┌────▼─────┐
+    │ Ring buf │       │ Ring buf │      │ Ring buf │
+    │  (SAB)   │       │  (SAB)   │      │  (SAB)   │
+    └────┬─────┘       └────┬─────┘      └────┬─────┘
+         │                  │                 │
+         └──────────┬───────┘─────────────────┘
+                    │
+             ┌──────▼──────┐
+             │Logger worker│
+             │  (single)   │
+             │             │
+             │ readSome()  │
+             │ fs.writeSync│
+             │   fd 1      │
+             └─────────────┘
+```
+
+SAB = `SharedArrayBuffer`
+
+Each call to `createLogger()` allocates a 2 MiB `SharedArrayBuffer` ring
+buffer. The writer (application side) serializes pino JSON into the buffer.
+The logger worker polls all registered readers and flushes their contents to
+stdout.
+
+Registration and unregistration use `BroadcastChannel` with a
+`SharedArrayBuffer`-based ack to ensure the worker has set up the reader
+before the caller proceeds.
+
+## Graceful shutdown
+
+On process exit (`process.exit()`, uncaught exceptions, SIGTERM, SIGINT):
+
+1. All writers call `flushSync()` to publish pending data to their ring
+   buffers.
+2. The main thread signals the logger worker to drain via a shared
+   `Int32Array` flag.
+3. The main thread blocks (up to 2 s) until the worker confirms drain is
+   complete.
+4. The logger worker also registers a `process.on('exit')` handler as a
+   safety net — if the normal drain protocol fails, the handler performs a
+   final synchronous drain of all readers.
+
+## Usage
+
+```ts
+import { createLogger } from '@nxtedition/logger'
+
+const logger = createLogger({ level: 'info' })
+logger.info({ key: 'value' }, 'hello world')
+```
+
+`createLogger` accepts all [pino options](https://getpino.io/#/docs/api?id=options).
+Custom serializers are merged with the built-in set (err, req, res, etc.).
+
+### Worker threads
+
+Call `createLogger()` on the **main thread first** — this starts the logger
+worker. Worker threads can then call `createLogger()` freely; each gets its
+own ring buffer registered with the shared logger worker.
+
+```ts
+// main.ts
+import { createLogger } from '@nxtedition/logger'
+const logger = createLogger({ level: 'info' }) // starts worker
+
+// worker.ts
+import { createLogger } from '@nxtedition/logger'
+const logger = createLogger({ level: 'debug' }) // registers with existing worker
+```
+
+## Development
+
+```sh
+yarn build           # compile TypeScript → lib/
+yarn test            # run tests
+yarn test:coverage   # run tests with c8 coverage report
+```
+
+## License
+
+See [LICENSE](./LICENSE).

package/lib/logger-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger-worker.d.ts.map

package/lib/logger-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-worker.d.ts","sourceRoot":"","sources":["../src/logger-worker.ts"],"names":[],"mappings":""}

package/lib/logger-worker.js

@@ -0,0 +1,104 @@
+import { workerData } from 'node:worker_threads';
+import { Reader } from '@nxtedition/shared';
+import tp from 'node:timers/promises';
+import fs from 'node:fs';
+const readersByToken = new Map();
+let readers = [];
+const backoffBuffer = new Int32Array(new SharedArrayBuffer(4));
+function writeAll(buffer, offset, length) {
+    // fd 1 may be non-blocking in worker threads, so fs.writeSync can
+    // return partial writes or throw EAGAIN/EBUSY. Loop until all bytes
+    // are out, backing off with Atomics.wait after repeated retries.
+    let retries = 0;
+    while (length > 0) {
+        try {
+            const written = fs.writeSync(1, buffer, offset, length);
+            offset += written;
+            length -= written;
+            retries = 0;
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'EAGAIN' || code === 'EBUSY') {
+                retries++;
+                if (retries > 4096) {
+                    throw new Error(`writeAll: failed to make progress after ${retries} retries (${code})`);
+                }
+                else if (retries > 2) {
+                    Atomics.wait(backoffBuffer, 0, 0, 1);
+                }
+                else {
+                    Atomics.pause();
+                }
+                continue;
+            }
+            throw err;
+        }
+    }
+}
+function readerDrain(r) {
+    while (r.readSome((data) => {
+        writeAll(data.buffer, data.byteOffset, data.byteLength);
+    }) > 0) {
+        // Keep draining until empty.
+    }
+}
+const bc = new BroadcastChannel('nxt:logger');
+bc.onmessage = (event) => {
+    const { type, token, sharedBuffer, ackBuffer } = event.data;
+    if (type === 'nxt:logger:register' && token != null && sharedBuffer) {
+        const r = new Reader(sharedBuffer);
+        readersByToken.set(token, r);
+        readers = [...readersByToken.values()];
+        if (ackBuffer) {
+            Atomics.store(new Int32Array(ackBuffer), 0, 1);
+            Atomics.notify(new Int32Array(ackBuffer), 0);
+        }
+        readerDrain(r); // Drain any initial data...
+    }
+    else if (type === 'nxt:logger:unregister' && token != null) {
+        const r = readersByToken.get(token);
+        if (r) {
+            // Drain any remaining data before removing.
+            readerDrain(r);
+            readersByToken.delete(token);
+            readers = [...readersByToken.values()];
+        }
+    }
+};
+// Drain signal: 0 = running, 1 = drain requested, 2 = drain complete.
+const drainState = new Int32Array(workerData.drainBuffer);
+// Safety net: if the worker is terminated before the normal drain path runs
+// (e.g. main thread crash, exit handler failure), do a final synchronous
+// drain so buffered log data is not silently lost.
+process.on('exit', () => {
+    for (let i = 0; i < readers.length; i++) {
+        readerDrain(readers[i]);
+    }
+});
+// Signal readiness to the parent thread so it can proceed with registration.
+const readyState = new Int32Array(workerData.readyBuffer);
+Atomics.store(readyState, 0, 1);
+Atomics.notify(readyState, 0);
+while (true) {
+    let count = 0;
+    for (let i = 0; i < readers.length; i++) {
+        count += readers[i].readSome((data) => {
+            writeAll(data.buffer, data.byteOffset, data.byteLength);
+        });
+    }
+    // Let bc.onmessage handlers run to pick up new readers or drain requests.
+    await (count > 0 ? tp.setImmediate() : tp.setTimeout(10));
+    // Check if drain was requested by the main thread.
+    if (Atomics.load(drainState, 0) === 1) {
+        // Drain all remaining data from every reader until empty.
+        for (let i = 0; i < readers.length; i++) {
+            readerDrain(readers[i]);
+        }
+        Atomics.store(drainState, 0, 2);
+        Atomics.notify(drainState, 0);
+        bc.close();
+        break;
+    }
+}
+//# sourceMappingURL=logger-worker.js.map

package/lib/logger-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-worker.js","sourceRoot":"","sources":["../src/logger-worker.ts"],"names":[],"mappings":"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"}

package/lib/logger.d.ts

@@ -1,10 +1,4 @@
-import type { Logger as PinoLogger, LoggerOptions as PinoLoggerOptions } from 'pino';
-import type { SonicBoom } from 'sonic-boom';
+import type { Logger as PinoLogger, LoggerOptions } from 'pino';
 export type Logger = PinoLogger;
-interface LoggerOptions extends PinoLoggerOptions {
-    flushInterval?: number;
-    stream?: SonicBoom | null;
-}
-export declare function createLogger({ level, flushInterval, stream, ...options }?: LoggerOptions, onTerminate?: unknown): Logger;
-export {};
+export declare function createLogger({ level, ...options }?: LoggerOptions): Logger;
 //# sourceMappingURL=logger.d.ts.map

package/lib/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,MAAM,CAAA;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,MAAM,MAAM,MAAM,GAAG,UAAU,CAAA;AAE/B,UAAU,aAAc,SAAQ,iBAAiB;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;CAC1B;AAID,wBAAgB,YAAY,CAC1B,EACE,KAAwC,EACxC,aAAmB,EACnB,MAAM,EACN,GAAG,OAAO,EACX,GAAE,aAAkB,EACrB,WAAW,CAAC,EAAE,OAAO,GACpB,MAAM,CA2DR"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAQ/D,MAAM,MAAM,MAAM,GAAG,UAAU,CAAA;AAmG/B,wBAAgB,YAAY,CAAC,EAC3B,KAAwC,EACxC,GAAG,OAAO,EACX,GAAE,aAAkB,GAAG,MAAM,CA+C7B"}

package/lib/logger.js

@@ -1,53 +1,116 @@
-import { isMainThread } from 'node:worker_threads';
-import serializers from './serializers.js';
+import { isMainThread, Worker } from 'node:worker_threads';
 import pino from 'pino';
+import onExit from 'on-exit-leak-free';
+import xuid from 'xuid';
+import { Writer } from '@nxtedition/shared';
+import serializers from './serializers.js';
 const isProduction = process.env.NODE_ENV === 'production';
-export function createLogger({ level = isProduction ? 'debug' : 'trace', flushInterval = 1e3, stream, ...options } = {}, onTerminate) {
-    if (!stream) {
-        if (process.stdout.write !== process.stdout.constructor.prototype.write ||
-            process.stdout.fd == null) {
-            stream = pino.destination(process.stdout);
+let workerStarted = false;
+const writers = new Set();
+class SharedWriter {
+    #w;
+    #token;
+    #destroyed = false;
+    constructor(token, sharedBuffer) {
+        this.#token = token;
+        this.#w = new Writer(sharedBuffer);
+        writers.add(this);
+    }
+    write(msg) {
+        if (this.#destroyed) {
+            return false;
+        }
+        this.#w.writeSync(msg.length * 3, (data, msg) => data.byteOffset + data.buffer.write(msg, data.byteOffset, 'utf-8'), msg);
+        return true;
+    }
+    flushSync() {
+        if (!this.#destroyed) {
+            this.#w.flushSync();
+        }
+    }
+    end() {
+        if (this.#destroyed) {
+            return;
+        }
+        this.#destroyed = true;
+        this.#w.flushSync();
+        writers.delete(this);
+        onExit.unregister(this);
+        const bc = new BroadcastChannel('nxt:logger');
+        bc.postMessage({ type: 'nxt:logger:unregister', token: this.#token });
+        bc.close();
+    }
+}
+// Starts the logger worker. Must be called on the main thread before any
+// worker thread calls createLogger, otherwise the BroadcastChannel
+// registration message will be lost (no listener).
+function startWorker() {
+    if (workerStarted) {
+        return;
+    }
+    workerStarted = true;
+    const readyBuffer = new SharedArrayBuffer(4);
+    const drainBuffer = new SharedArrayBuffer(4);
+    const drainState = new Int32Array(drainBuffer);
+    const w = new Worker(new URL('./logger-worker.js', import.meta.url), {
+        workerData: { readyBuffer, drainBuffer },
+        execArgv: [], // Don't inherit CLI flags (e.g. --inspect) from parent.
+    })
+        .on('error', (err) => {
+        throw new Error('Logger worker crashed', { cause: err });
+    })
+        .on('exit', (code) => {
+        if (Atomics.load(drainState, 0) !== 2) {
+            throw new Error(`Logger worker exited unexpectedly with code ${code}`);
+        }
+    });
+    w.unref();
+    // Block until the worker has set up its BroadcastChannel listener.
+    const res = Atomics.wait(new Int32Array(readyBuffer), 0, 0, 10_000);
+    if (res === 'timed-out') {
+        void w.terminate();
+        workerStarted = false;
+        throw new Error('Logger worker failed to start within 10 seconds.');
+    }
+    // On exit: flush writers, signal worker to drain, block until done.
+    onExit.register(drainState, (drainState) => {
+        for (const w of writers) {
+            w.flushSync();
+        }
+        Atomics.store(drainState, 0, 1);
+        Atomics.notify(drainState, 0);
+        Atomics.wait(drainState, 0, 1, 2000);
+    });
+}
+export function createLogger({ level = isProduction ? 'debug' : 'trace', ...options } = {}) {
+    if (isMainThread) {
+        startWorker();
+    }
+    const sharedBuffer = new SharedArrayBuffer(2 * 1024 * 1024); // 2 MiB per thread
+    const token = xuid();
+    const stream = new SharedWriter(token, sharedBuffer);
+    {
+        const ackBuffer = new SharedArrayBuffer(4);
+        const bc = new BroadcastChannel('nxt:logger');
+        bc.postMessage({ type: 'nxt:logger:register', token, sharedBuffer, ackBuffer });
+        bc.close();
+        // Block until the logger worker acknowledges the registration.
+        // If createLogger() was never called on the main thread the ack
+        // will never arrive and we throw a clear error instead of silently
+        // dropping log output.
+        const res = Atomics.wait(new Int32Array(ackBuffer), 0, 0, 10_000);
+        if (res === 'timed-out') {
+            writers.delete(stream);
+            throw new Error('Logger worker did not acknowledge registration. ' +
+                'Ensure createLogger() is called on the main thread before any worker thread calls createLogger().');
         }
     }
-    if (stream) {
-        // Do nothing...
-    }
-    else if (!isProduction) {
-        stream = pino.destination({ fd: process.stdout.fd ?? 1, sync: true, fsync: false });
-    }
-    else if (!isMainThread) {
-        // TODO (perf): Async mode doesn't work super well in workers.
-        stream = pino.destination({ fd: 1, sync: true, fsync: false });
-    }
-    else {
-        stream = pino.destination({
-            sync: false,
-            fsync: false,
-            minLength: 4 * 1024,
-            maxWrite: 32 * 1024,
-        });
-        let flushing = 0;
-        const onFlush = () => {
-            flushing--;
-        };
-        const flushTimeout = setInterval(() => {
-            if (flushing >= 10) {
-                try {
-                    logger.warn('logger is flushing too slow');
-                    stream?.flushSync();
-                }
-                catch (err) {
-                    console.error(err);
-                }
-            }
-            else {
-                flushing++;
-                stream?.flush(onFlush);
-            }
-            flushTimeout.refresh();
-        }, flushInterval).unref();
-    }
-    const logger = pino({
+    // When this thread exits, flush the writer and tell the logger worker
+    // to remove the reader for this buffer.
+    onExit.register(stream, (stream) => {
+        stream.end();
+    });
+    return pino({
         level,
         ...options,
         serializers: {
@@ -55,6 +118,5 @@ export function createLogger({ level = isProduction ? 'debug' : 'trace', flushIn
             ...options.serializers,
         },
     }, stream);
-    return logger;
 }
 //# sourceMappingURL=logger.js.map

package/lib/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,WAAW,MAAM,kBAAkB,CAAA;AAC1C,OAAO,IAAI,MAAM,MAAM,CAAA;AAWvB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAA;AAE1D,MAAM,UAAU,YAAY,CAC1B,EACE,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EACxC,aAAa,GAAG,GAAG,EACnB,MAAM,EACN,GAAG,OAAO,KACO,EAAE,EACrB,WAAqB;IAErB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IACE,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK;YACnE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,EACzB,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,gBAAgB;IAClB,CAAC;SAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IACrF,CAAC;SAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACzB,8DAA8D;QAC9D,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IAChE,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;YACxB,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,KAAK;YACZ,SAAS,EAAE,CAAC,GAAG,IAAI;YACnB,QAAQ,EAAE,EAAE,GAAG,IAAI;SACpB,CAAC,CAAA;QAEF,IAAI,QAAQ,GAAG,CAAC,CAAA;QAChB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,QAAQ,EAAE,CAAA;QACZ,CAAC,CAAA;QAED,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;YACpC,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;gBACnB,IAAI,CAAC;oBACH,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;oBAC1C,MAAM,EAAE,SAAS,EAAE,CAAA;gBACrB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;gBACpB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,QAAQ,EAAE,CAAA;gBACV,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YACxB,CAAC;YACD,YAAY,CAAC,OAAO,EAAE,CAAA;QACxB,CAAC,EAAE,aAAa,CAAC,CAAC,KAAK,EAAE,CAAA;IAC3B,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CACjB;QACE,KAAK;QACL,GAAG,OAAO;QACV,WAAW,EAAE;YACX,GAAG,WAAW;YACd,GAAG,OAAO,CAAC,WAAW;SACvB;KACF,EACD,MAAM,CACP,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,OAAO,MAAM,MAAM,mBAAmB,CAAA;AACtC,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C,OAAO,WAAW,MAAM,kBAAkB,CAAA;AAI1C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAA;AAE1D,IAAI,aAAa,GAAG,KAAK,CAAA;AAEzB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgB,CAAA;AAEvC,MAAM,YAAY;IAChB,EAAE,CAAQ;IACV,MAAM,CAAQ;IACd,UAAU,GAAG,KAAK,CAAA;IAElB,YAAY,KAAa,EAAE,YAA+B;QACxD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,EAAE,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAA;QAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC;IAED,KAAK,CAAC,GAAW;QACf,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,SAAS,CACf,GAAG,CAAC,MAAM,GAAG,CAAC,EACd,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EACjF,GAAG,CACJ,CAAA;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAA;QACrB,CAAC;IACH,CAAC;IAED,GAAG;QACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAM;QACR,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QAEtB,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAA;QACnB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACpB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QAEvB,MAAM,EAAE,GAAG,IAAI,gBAAgB,CAAC,YAAY,CAAC,CAAA;QAC7C,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QACrE,EAAE,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;CACF;AAED,yEAAyE;AACzE,mEAAmE;AACnE,mDAAmD;AACnD,SAAS,WAAW;IAClB,IAAI,aAAa,EAAE,CAAC;QAClB,OAAM;IACR,CAAC;IACD,aAAa,GAAG,IAAI,CAAA;IAEpB,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAA;IAC5C,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAA;IAC5C,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAA;IAE9C,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACnE,UAAU,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE;QACxC,QAAQ,EAAE,EAAE,EAAE,wDAAwD;KACvE,CAAC;SACC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;IAC1D,CAAC,CAAC;SACD,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACnB,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,EAAE,CAAC,CAAA;QACxE,CAAC;IACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,KAAK,EAAE,CAAA;IAET,mEAAmE;IACnE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;IACnE,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,KAAK,CAAC,CAAC,SAAS,EAAE,CAAA;QAClB,aAAa,GAAG,KAAK,CAAA;QACrB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IACrE,CAAC;IAED,oEAAoE;IACpE,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE;QACzC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,CAAC,CAAC,SAAS,EAAE,CAAA;QACf,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QAC/B,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;QAC7B,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAC3B,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EACxC,GAAG,OAAO,KACO,EAAE;IACnB,IAAI,YAAY,EAAE,CAAC;QACjB,WAAW,EAAE,CAAA;IACf,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,iBAAiB,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA,CAAC,mBAAmB;IAC/E,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;IAEpB,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IAEpD,CAAC;QACC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAA;QAC1C,MAAM,EAAE,GAAG,IAAI,gBAAgB,CAAC,YAAY,CAAC,CAAA;QAC7C,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAA;QAC/E,EAAE,CAAC,KAAK,EAAE,CAAA;QAEV,+DAA+D;QAC/D,gEAAgE;QAChE,mEAAmE;QACnE,uBAAuB;QACvB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;QACjE,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACtB,MAAM,IAAI,KAAK,CACb,kDAAkD;gBAChD,mGAAmG,CACtG,CAAA;QACH,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,wCAAwC;IACxC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjC,MAAM,CAAC,GAAG,EAAE,CAAA;IACd,CAAC,CAAC,CAAA;IAEF,OAAO,IAAI,CACT;QACE,KAAK;QACL,GAAG,OAAO;QACV,WAAW,EAAE;YACX,GAAG,WAAW;YACd,GAAG,OAAO,CAAC,WAAW;SACvB;KACF,EACD,MAAM,CACP,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxtedition/logger",
-  "version": "1.0.4",
+  "version": "2.0.1",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -10,18 +10,23 @@
   "files": [
     "lib"
   ],
-  "license": "UNLICENSED",
+  "license": "MIT",
   "scripts": {
     "build": "rimraf lib && tsc",
     "prepublishOnly": "yarn build",
     "typecheck": "tsc --noEmit",
     "test": "node --test",
-    "test:ci": "node --test"
+    "test:ci": "node --test",
+    "test:coverage": "c8 node --test"
   },
   "dependencies": {
+    "@nxtedition/nxt-undici": "^7.3.2",
+    "@nxtedition/shared": "^4.0.3",
     "fast-querystring": "^1.1.2",
+    "on-exit-leak-free": "^2.1.2",
     "pino": "^10.3.1",
-    "request-target": "^1.0.2"
+    "request-target": "^1.0.0",
+    "xuid": "^4.1.5"
   },
-  "gitHead": "14911159426261fac913d65de5ec332cf3f7c78e"
+  "gitHead": "239c3eeff1f228d4d71ff6f8c884642f359065b5"
 }