@loggerjs/node 0.1.0 → 0.3.1

package/README.md

@@ -70,11 +70,31 @@ rotatingFileTransport({ path: "audit.log", maxBytes: 10 * 1024 * 1024 });
 
 | Transport | Delivers to |
 | --- | --- |
-| `stdoutTransport` / `stderrTransport` | process streams, one NDJSON line per log |
-| `fileTransport` / `rotatingFileTransport` | files, with size-based rotation |
+| `stdoutTransport` / `stderrTransport` | process streams, one NDJSON line per log, drain-aware flush, optional `minLength` buffering, clean `EPIPE` shutdown |
+| `fileTransport` / `rotatingFileTransport` | files, with `mkdir`/`append` controls, optional `sync: true`, crash-path `flushSync`, and size-based rotation |
 | `nodeHttpTransport` | a collector over `fetch`, wrapped in `batchTransport` (batching + retry) |
 | `nodeSyslogTransport` | RFC 5424 syslog over UDP/TCP |
-| `workerTransport` | a worker thread (encodes batches with a codec, optional buffer transfer, fallback on worker death) |
+| `workerTransport` | a worker thread (encodes batches with a codec, optional buffer transfer, ready/ack lifecycle, fallback on worker failure) |
+
+File and process-stream transports share the same internal destination logic for
+write callbacks, drain waiting, `minLength` buffering, close, and sync crash
+flush. Use `await flush()` for normal shutdown. Use `flushSync()` only on fatal
+paths, or configure `fileTransport({ sync: true })` when every write must reach
+the filesystem before the log call returns.
+
+`workerTransport()` is fire-and-forget unless you opt into lifecycle checks.
+Use `readyTimeoutMs` for workers that send `{ type: "loggerjs:ready" }`, and
+`ackTimeoutMs` for workers that acknowledge `{ type: "loggerjs:batch", id }`
+with `{ type: "loggerjs:batch:ack", id }`. Pending batches fall back or are
+counted as drops when readiness, posting, ack, or worker exit fails. Set
+`autoEnd: false` for shared workers you close elsewhere. Explicit
+`transport.ready()` / `logger.ready()` waits for the ready handshake when
+`readyTimeoutMs` is configured.
+
+Call `installLoggerDiagnosticsChannel()` to publish LoggerJS internal
+diagnostics to Node `diagnostics_channel` channels such as `loggerjs.dispatch`,
+`loggerjs.transport`, `loggerjs.flush`, `loggerjs.encode`, and
+`loggerjs.worker`.
 
 ## Integrations (16)
 
@@ -85,7 +105,7 @@ rotatingFileTransport({ path: "audit.log", maxBytes: 10 * 1024 * 1024 });
 | **Clients** | `nodeFetchIntegration`, `nodeHttpClientIntegration`, `redisIntegration`, `prismaIntegration`, `databaseIntegration` |
 | **Queues** | `queueIntegration`, `bullMqIntegration` |
 
-`captureProcessIntegration()` turns uncaught exceptions (fatal), unhandled rejections, warnings, and exit into log events; with `exitOnUncaught` it flushes synchronously before exiting. Every integration is tagged `source: "integration:<name>"` and guarded against capture loops.
+`captureProcessIntegration()` turns uncaught exceptions (fatal), unhandled rejections, warnings, and exit into log events; with `exitOnUncaught` it captures the fatal record, calls `flushSync()`, waits for bounded async `flush()`, then exits. Every integration is tagged `source: "integration:<name>"` and guarded against capture loops.
 
 ### Context manager
 
@@ -100,7 +120,7 @@ await withContext({ requestId: "req_123" }, async () => {
 
 ## Subpath exports
 
-Transports — `transport-stdout` · `transport-file` · `transport-rotating-file` · `transport-http` · `transport-syslog` · `transport-worker` · `payload-transforms` · `context`
+Transports — `transport-stdout` · `transport-file` · `transport-rotating-file` · `transport-http` · `transport-syslog` · `transport-worker` · `payload-transforms` · `logger-diagnostics` · `context`
 
 Integrations — `integration-process` · `integration-cli` · `integration-diagnostics` · `integration-serverless` · `integration-express` · `integration-fastify` · `integration-koa` · `integration-nest` · `integration-hapi` · `integration-fetch` · `integration-http-client` · `integration-redis` · `integration-prisma` · `integration-database` · `integration-queue` · `integration-bullmq`
 

package/dist/file-transport.d.ts

@@ -1,14 +1,18 @@
-import { type WriteStream } from "fs";
 import { type Codec, type LoggerLevel, type Transport } from "@loggerjs/core";
+import type { WriteStream } from "fs";
 export interface FileTransportOptions {
     path: string;
     name?: string;
     codec?: Codec<string | Uint8Array>;
     minLevel?: LoggerLevel;
     flags?: string;
+    append?: boolean;
+    mkdir?: boolean;
+    sync?: boolean;
+    minLength?: number;
 }
 export interface FileTransport extends Transport {
-    stream: WriteStream;
+    stream?: WriteStream;
     flushSync: () => void;
 }
 export declare function fileTransport(options: FileTransportOptions): FileTransport;

package/dist/file-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-transport.d.ts","sourceRoot":"","sources":["../src/file-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqD,KAAK,WAAW,EAAE,MAAM,IAAI,CAAC;AACzF,OAAO,EAGL,KAAK,KAAK,EAEV,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA8D1E"}
+{"version":3,"file":"file-transport.d.ts","sourceRoot":"","sources":["../src/file-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,KAAK,EAEV,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAGtC,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAwB1E"}