logixia 2.0.10 → 2.1.0

package/dist/{worker.transport-DQDv1nAJ.js → worker.transport-C7jNGhev.js}

@@ -1,4 +1,4 @@
-const require_secret_config = require("./secret-config-BvFl2dC8.js");
+const require_secret_config = require("./secret-config--cVTOWwp.js");
 const require_internal_log = require("./internal-log-DwqTjhpb.js");
 let node_path = require("node:path");
 node_path = require_secret_config.__toESM(node_path);
@@ -43,25 +43,56 @@ let node_worker_threads = require("node:worker_threads");
 * thread, completely removing JSON serialization and I/O from the main event loop.
 */
 var WorkerTransport = class {
+	name = "worker";
+	level;
+	batchSize = 1;
+	flushInterval = 0;
+	worker = null;
+	ready = false;
+	buffer = [];
+	bufferSize;
+	restarts = 0;
+	maxRestarts;
+	config;
+	/** Pending restart-backoff timer, so close() can cancel a queued restart. */
+	restartTimer = null;
+	/** Set once close() begins, so a worker 'exit' no longer triggers a restart. */
+	closing = false;
+	/** Writes have been posted since the last flush; keeps the beforeExit flush from looping. */
+	dirty = false;
+	/** Run once the worker reports ready, used when the process wants to exit before that. */
+	onReady;
+	/** Max time to wait for the worker's 'flushed' ack before giving up. */
+	FLUSH_TIMEOUT_MS = 5e3;
+	/** Max time to wait for a graceful worker exit before force-terminating. */
+	SHUTDOWN_TIMEOUT_MS = 5e3;
 	constructor(config) {
-		this.name = "worker";
-		this.batchSize = 1;
-		this.flushInterval = 0;
-		this.worker = null;
-		this.ready = false;
-		this.buffer = [];
-		this.restarts = 0;
-		this.restartTimer = null;
-		this.closing = false;
-		this.FLUSH_TIMEOUT_MS = 5e3;
-		this.SHUTDOWN_TIMEOUT_MS = 5e3;
 		this.config = config;
 		this.bufferSize = config.bufferSize ?? 1e3;
 		this.maxRestarts = config.maxRestarts ?? 3;
 		this.level = config.level;
 		require_secret_config.protectSecrets(this, ["config"]);
 		this.startWorker();
+		process.on("beforeExit", this.flushForExit);
 	}
+	/**
+	* The worker is unref'd so it never keeps the process alive on its own; the
+	* trade-off is that lines still queued on it would be lost when the event loop
+	* drains. On beforeExit, re-ref the worker until it acknowledges a flush.
+	*/
+	flushForExit = () => {
+		var _worker$ref;
+		const worker = this.worker;
+		if (!worker || this.closing || !this.dirty) return;
+		(_worker$ref = worker.ref) === null || _worker$ref === void 0 || _worker$ref.call(worker);
+		const timer = setTimeout(() => worker.unref(), this.FLUSH_TIMEOUT_MS);
+		const done = () => {
+			clearTimeout(timer);
+			worker.unref();
+		};
+		if (this.ready) this.flush().finally(done);
+		else this.onReady = () => void this.flush().finally(done);
+	};
 	startWorker() {
 		try {
 			this.worker = new node_worker_threads.Worker(this.workerFile(), { workerData: {
@@ -73,6 +104,9 @@ var WorkerTransport = class {
 				if (msg.type === "ready") {
 					this.ready = true;
 					this.drainBuffer();
+					const onReady = this.onReady;
+					this.onReady = void 0;
+					onReady === null || onReady === void 0 || onReady();
 				} else if (msg.type === "error" || msg.type === "write-error") require_internal_log.internalError(`WorkerTransport [${this.config.transportType}]: ${msg.error ?? "unknown"}`);
 			});
 			this.worker.on("error", (err) => {
@@ -85,6 +119,7 @@ var WorkerTransport = class {
 					this.handleWorkerExit();
 				}
 			});
+			this.worker.unref();
 		} catch (err) {
 			require_internal_log.internalError("WorkerTransport failed to start", err);
 		}
@@ -116,6 +151,7 @@ var WorkerTransport = class {
 		}
 	}
 	write(entry) {
+		this.dirty = true;
 		if (this.ready && this.worker) this.worker.postMessage({
 			type: "write",
 			entry
@@ -129,18 +165,25 @@ var WorkerTransport = class {
 		}
 	}
 	async flush() {
+		var _worker$ref2;
 		if (!this.ready || !this.worker) return;
 		const worker = this.worker;
+		this.dirty = false;
+		(_worker$ref2 = worker.ref) === null || _worker$ref2 === void 0 || _worker$ref2.call(worker);
 		return new Promise((resolve) => {
 			const timer = setTimeout(() => {
+				var _worker$unref;
 				worker.off("message", handler);
+				(_worker$unref = worker.unref) === null || _worker$unref === void 0 || _worker$unref.call(worker);
 				resolve();
 			}, this.FLUSH_TIMEOUT_MS);
 			if (timer.unref) timer.unref();
 			const handler = (msg) => {
 				if (msg.type === "flushed") {
+					var _worker$unref2;
 					clearTimeout(timer);
 					worker.off("message", handler);
+					(_worker$unref2 = worker.unref) === null || _worker$unref2 === void 0 || _worker$unref2.call(worker);
 					resolve();
 				}
 			};
@@ -156,7 +199,9 @@ var WorkerTransport = class {
 	* graceful exit, leaking the worker thread and dropping its buffered logs.
 	*/
 	async close() {
+		var _worker$ref3;
 		this.closing = true;
+		process.removeListener("beforeExit", this.flushForExit);
 		if (this.restartTimer) {
 			clearTimeout(this.restartTimer);
 			this.restartTimer = null;
@@ -166,6 +211,7 @@ var WorkerTransport = class {
 		this.worker = null;
 		this.drainBufferTo(worker);
 		worker.postMessage({ type: "shutdown" });
+		(_worker$ref3 = worker.ref) === null || _worker$ref3 === void 0 || _worker$ref3.call(worker);
 		await new Promise((resolve) => {
 			const timer = setTimeout(() => {
 				worker.terminate().finally(() => resolve());
@@ -198,4 +244,4 @@ Object.defineProperty(exports, "WorkerTransport", {
 	}
 });
 
-//# sourceMappingURL=worker.transport-DQDv1nAJ.js.map
+//# sourceMappingURL=worker.transport-C7jNGhev.js.map

package/dist/worker.transport-C7jNGhev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.transport-C7jNGhev.js","names":["Worker","path"],"sources":["../src/transports/worker.transport.ts"],"sourcesContent":["/**\n * logixia — Worker Thread Transport\n *\n * Offloads JSON serialization and all I/O to a Node.js worker thread,\n * completely eliminating any event-loop impact from logging. The main thread\n * only posts a raw message to the worker — it never calls JSON.stringify or\n * any I/O syscalls on the hot path.\n *\n * Architecture:\n *   Main thread  →  MessageChannel  →  Worker thread  →  Wrapped transport\n *\n * The worker runs an ordinary logixia transport (file, database, console…)\n * inside its own event loop. If the worker crashes it is restarted automatically\n * (up to `maxRestarts` times) and buffered messages are replayed.\n *\n * @example\n * ```ts\n * import { WorkerTransport } from 'logixia/worker';\n *\n * const logger = createLogger({\n *   transports: {\n *     // Run file transport inside a worker thread — zero event-loop impact\n *     custom: [\n *       new WorkerTransport({\n *         transportType: 'file',\n *         transportConfig: { filename: 'app.log', dirname: './logs' },\n *         bufferSize: 500,\n *         maxRestarts: 3,\n *       }),\n *     ],\n *   },\n * });\n * ```\n */\n\nimport path from 'node:path';\nimport { Worker } from 'node:worker_threads';\n\nimport type { ITransport, TransportLogEntry } from '../types/transport.types';\nimport { internalError, internalWarn } from '../utils/internal-log';\nimport { protectSecrets } from './secret-config';\n\nexport interface WorkerTransportConfig {\n  /**\n   * Which built-in logixia transport to run inside the worker thread.\n   * The worker resolves the correct module automatically.\n   */\n  transportType: 'file' | 'database' | 'console';\n  /** Config forwarded verbatim to the wrapped transport constructor. */\n  transportConfig: Record<string, unknown>;\n  /**\n   * Max log entries to buffer in the main thread while the worker is starting\n   * or restarting. Entries beyond this limit are dropped with a warning.\n   * @default 1000\n   */\n  bufferSize?: number;\n  /**\n   * How many times to restart the worker if it crashes unexpectedly.\n   * @default 3\n   */\n  maxRestarts?: number;\n  /**\n   * Custom level severities (`levelOptions.levels`) the wrapped transport's own\n   * `level` is compared against inside the worker. Built-in levels need no entry.\n   */\n  levels?: Record<string, number>;\n  /**\n   * Log level filter — only entries at or above this level are forwarded.\n   * Useful for routing only errors to an expensive transport in a worker.\n   */\n  level?: string;\n}\n\n/**\n * Transport that runs a wrapped transport inside a dedicated Node.js worker\n * thread, completely removing JSON serialization and I/O from the main event loop.\n */\nexport class WorkerTransport implements ITransport {\n  public readonly name = 'worker';\n  public readonly level: string | undefined;\n  public readonly batchSize = 1;\n  public readonly flushInterval = 0;\n\n  private worker: Worker | null = null;\n  private ready = false;\n  private readonly buffer: TransportLogEntry[] = [];\n  private readonly bufferSize: number;\n  private restarts = 0;\n  private readonly maxRestarts: number;\n  private readonly config: WorkerTransportConfig;\n  /** Pending restart-backoff timer, so close() can cancel a queued restart. */\n  private restartTimer: NodeJS.Timeout | null = null;\n  /** Set once close() begins, so a worker 'exit' no longer triggers a restart. */\n  private closing = false;\n  /** Writes have been posted since the last flush; keeps the beforeExit flush from looping. */\n  private dirty = false;\n  /** Run once the worker reports ready, used when the process wants to exit before that. */\n  private onReady: (() => void) | undefined;\n  /** Max time to wait for the worker's 'flushed' ack before giving up. */\n  private readonly FLUSH_TIMEOUT_MS = 5000;\n  /** Max time to wait for a graceful worker exit before force-terminating. */\n  private readonly SHUTDOWN_TIMEOUT_MS = 5000;\n\n  constructor(config: WorkerTransportConfig) {\n    this.config = config;\n    this.bufferSize = config.bufferSize ?? 1000;\n    this.maxRestarts = config.maxRestarts ?? 3;\n    this.level = config.level;\n    protectSecrets(this, ['config']);\n    this.startWorker();\n    process.on('beforeExit', this.flushForExit);\n  }\n\n  /**\n   * The worker is unref'd so it never keeps the process alive on its own; the\n   * trade-off is that lines still queued on it would be lost when the event loop\n   * drains. On beforeExit, re-ref the worker until it acknowledges a flush.\n   */\n  private readonly flushForExit = (): void => {\n    const worker = this.worker;\n    if (!worker || this.closing || !this.dirty) return;\n    worker.ref?.();\n    const timer = setTimeout(() => worker.unref(), this.FLUSH_TIMEOUT_MS);\n    const done = (): void => {\n      clearTimeout(timer);\n      worker.unref();\n    };\n    if (this.ready) {\n      void this.flush().finally(done);\n    } else {\n      this.onReady = () => void this.flush().finally(done);\n    }\n  };\n\n  private startWorker(): void {\n    try {\n      this.worker = new Worker(this.workerFile(), {\n        workerData: {\n          transportType: this.config.transportType,\n          transportConfig: this.config.transportConfig,\n          levels: this.config.levels,\n        },\n      });\n\n      this.worker.on('message', (msg: { type: string; error?: string }) => {\n        if (msg.type === 'ready') {\n          this.ready = true;\n          this.drainBuffer();\n          const onReady = this.onReady;\n          this.onReady = undefined;\n          onReady?.();\n        } else if (msg.type === 'error' || msg.type === 'write-error') {\n          internalError(\n            `WorkerTransport [${this.config.transportType}]: ${msg.error ?? 'unknown'}`\n          );\n        }\n      });\n\n      this.worker.on('error', (err) => {\n        internalError('WorkerTransport worker error', err);\n        this.handleWorkerExit();\n      });\n\n      this.worker.on('exit', (code) => {\n        if (code !== 0) {\n          internalWarn(`WorkerTransport worker exited with code ${code}`);\n          this.handleWorkerExit();\n        }\n      });\n\n      // After the listeners: adding a 'message' listener re-refs the worker's port.\n      this.worker.unref();\n    } catch (err) {\n      internalError('WorkerTransport failed to start', err);\n    }\n  }\n\n  /** The worker entry is always built as CommonJS, next to this module's output. */\n  protected workerFile(): string {\n    return path.join(__dirname, 'worker-entry.js');\n  }\n\n  private handleWorkerExit(): void {\n    this.ready = false;\n    // Don't resurrect a worker we're intentionally shutting down — close() sets\n    // `closing` and nulls the worker, so a late 'exit'/'error' event must not\n    // queue a restart (which would spawn a fresh leaked thread post-shutdown).\n    if (this.closing) return;\n    if (this.restarts < this.maxRestarts) {\n      this.restarts++;\n      internalWarn(`WorkerTransport restarting (attempt ${this.restarts}/${this.maxRestarts})`);\n      // Small backoff before restart. unref() so a perpetually-failing worker's\n      // pending restart never keeps the process alive on its own.\n      this.restartTimer = setTimeout(() => {\n        this.restartTimer = null;\n        this.startWorker();\n      }, 500 * this.restarts);\n      if (this.restartTimer.unref) this.restartTimer.unref();\n    } else {\n      internalError(\n        `WorkerTransport exhausted ${this.maxRestarts} restart attempts — transport disabled`\n      );\n    }\n  }\n\n  private drainBuffer(): void {\n    while (this.buffer.length > 0 && this.ready && this.worker) {\n      const entry = this.buffer.shift();\n      if (entry) {\n        this.worker.postMessage({ type: 'write', entry });\n      }\n    }\n  }\n\n  write(entry: TransportLogEntry): void {\n    this.dirty = true;\n    if (this.ready && this.worker) {\n      this.worker.postMessage({ type: 'write', entry });\n    } else {\n      if (this.buffer.length >= this.bufferSize) {\n        internalWarn('WorkerTransport buffer full — dropping oldest entry');\n        this.buffer.shift();\n      }\n      this.buffer.push(entry);\n    }\n  }\n\n  async flush(): Promise<void> {\n    if (!this.ready || !this.worker) return;\n    const worker = this.worker;\n    this.dirty = false;\n    // Unref'd between flushes; ref'd here so an awaited flush() keeps the process alive.\n    worker.ref?.();\n    return new Promise<void>((resolve) => {\n      // Time-box the flush: if the worker dies or restarts before answering,\n      // the 'flushed' message would never arrive and this promise would hang\n      // forever, blocking shutdown until the force-exit timer kills the process\n      // (losing everything). Resolve on timeout so close() can still terminate.\n      const timer = setTimeout(() => {\n        worker.off('message', handler);\n        worker.unref?.();\n        resolve();\n      }, this.FLUSH_TIMEOUT_MS);\n      if (timer.unref) timer.unref();\n\n      const handler = (msg: { type: string }) => {\n        if (msg.type === 'flushed') {\n          clearTimeout(timer);\n          worker.off('message', handler);\n          worker.unref?.();\n          resolve();\n        }\n      };\n      worker.on('message', handler);\n      worker.postMessage({ type: 'flush' });\n    });\n  }\n\n  /**\n   * Flush the worker's buffer and terminate the thread on shutdown.\n   *\n   * This MUST be named close() — TransportManager.close() invokes\n   * transport.close(), so a method named only shutdown() was never called on\n   * graceful exit, leaking the worker thread and dropping its buffered logs.\n   */\n  async close(): Promise<void> {\n    // Stop the restart loop first: cancel any queued backoff restart and flag\n    // that further worker exits are expected (so handleWorkerExit no-ops).\n    this.closing = true;\n    process.removeListener('beforeExit', this.flushForExit);\n    if (this.restartTimer) {\n      clearTimeout(this.restartTimer);\n      this.restartTimer = null;\n    }\n\n    if (!this.worker) return;\n    const worker = this.worker;\n    this.worker = null;\n\n    // Push any locally-buffered (pre-ready) entries first: the worker's port\n    // queues them until its listener attaches, so they are handled before the\n    // shutdown message, which flushes the wrapped transport and exits.\n    this.drainBufferTo(worker);\n    worker.postMessage({ type: 'shutdown' });\n    // The worker is unref'd, so hold the process open until it has drained and exited.\n    worker.ref?.();\n\n    await new Promise<void>((resolve) => {\n      // Don't wait forever for a wedged worker — terminate() it after a timeout.\n      const timer = setTimeout(() => {\n        worker.terminate().finally(() => resolve());\n      }, this.SHUTDOWN_TIMEOUT_MS);\n      if (timer.unref) timer.unref();\n\n      worker.once('exit', () => {\n        clearTimeout(timer);\n        resolve();\n      });\n    });\n  }\n\n  /** Back-compat alias — prefer close(). */\n  async shutdown(): Promise<void> {\n    await this.close();\n  }\n\n  private drainBufferTo(worker: Worker): void {\n    while (this.buffer.length > 0) {\n      const entry = this.buffer.shift();\n      if (entry) worker.postMessage({ type: 'write', entry });\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/{worker.transport-Bl8lFRck.d.mts → worker.transport-DnU0_9Bd.d.mts}

@@ -1,4 +1,4 @@
-import { _ as TransportLogEntry, d as ITransport } from "./transport.types-CzJq4IrF.mjs";
+import { _ as TransportLogEntry, d as ITransport } from "./transport.types-B1ejJJP6.mjs";
 interface WorkerTransportConfig {
   /**
    * Which built-in logixia transport to run inside the worker thread.
@@ -49,11 +49,21 @@ declare class WorkerTransport implements ITransport {
   private restartTimer;
   /** Set once close() begins, so a worker 'exit' no longer triggers a restart. */
   private closing;
+  /** Writes have been posted since the last flush; keeps the beforeExit flush from looping. */
+  private dirty;
+  /** Run once the worker reports ready, used when the process wants to exit before that. */
+  private onReady;
   /** Max time to wait for the worker's 'flushed' ack before giving up. */
   private readonly FLUSH_TIMEOUT_MS;
   /** Max time to wait for a graceful worker exit before force-terminating. */
   private readonly SHUTDOWN_TIMEOUT_MS;
   constructor(config: WorkerTransportConfig);
+  /**
+   * The worker is unref'd so it never keeps the process alive on its own; the
+   * trade-off is that lines still queued on it would be lost when the event loop
+   * drains. On beforeExit, re-ref the worker until it acknowledges a flush.
+   */
+  private readonly flushForExit;
   private startWorker;
   /** The worker entry is always built as CommonJS, next to this module's output. */
   protected workerFile(): string;
@@ -74,4 +84,4 @@ declare class WorkerTransport implements ITransport {
   private drainBufferTo;
 }
 export { WorkerTransportConfig as n, WorkerTransport as t };
-//# sourceMappingURL=worker.transport-Bl8lFRck.d.mts.map
+//# sourceMappingURL=worker.transport-DnU0_9Bd.d.mts.map

package/dist/worker.transport-DnU0_9Bd.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.transport-DnU0_9Bd.d.mts","names":[],"sources":["../src/transports/worker.transport.ts"],"mappings":";UA0CiB;;;;;EAKf;;EAEA,iBAAiB;;;;;;EAMjB;;;;;EAKA;;;;;EAKA,SAAS;;;;;EAKT;;;;;;cAOW,2BAA2B;WACtB;WACA;WACA;WACA;UAER;UACA;mBACS;mBACA;UACT;mBACS;mBACA;;UAET;;UAEA;;UAEA;;UAEA;;mBAES;;mBAEA;EAEL,YAAA,QAAQ;;;;;;mBAeH;UAgBT;;YA4CE;UAIF;UAuBA;EASR,MAAM,OAAO;EAaP,SAAS;;;;;;;;EAsCT,SAAS;;EAqCT,YAAY;UAIV"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "logixia",
-  "version": "2.0.10",
-  "description": "Async-first TypeScript logger for Node, NestJS and the edge: request tracing, redaction, OpenTelemetry/OTLP export, file/database/cloud transports, sampling and log search. Winston/Pino alternative.",
+  "version": "2.1.0",
+  "description": "TypeScript logger for Node.js, NestJS and edge runtimes: structured JSON logs, request trace IDs, redaction, OpenTelemetry/OTLP and cloud transports. Pino/Winston alternative.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -171,6 +171,7 @@
     "dev:intelligent-search": "ts-node -P tsconfig.examples.json --transpile-only -r ./examples/register.js examples/intelligent-search.ts",
     "benchmark": "npm run build && node benchmarks/run.mjs",
     "check:browser": "node --experimental-vm-modules --no-warnings scripts/check-browser-entry.mjs",
+    "check:dist": "node scripts/check-dist-runtime.mjs",
     "check:exports": "node scripts/check-exports.mjs",
     "check:optional-peers": "node scripts/check-optional-peers.mjs",
     "size": "size-limit",
@@ -216,7 +217,13 @@
     "log-rotation",
     "log-search",
     "prometheus",
-    "observability"
+    "observability",
+    "nodejs-logger",
+    "json-logger",
+    "log-redaction",
+    "pii",
+    "bun",
+    "nodejs"
   ],
   "author": {
     "name": "Sanjeev Sharma",