logixia 2.0.0 → 2.0.6

package/dist/worker.d.mts

@@ -1,3 +1,2 @@
-import "./transport.types-BMnurPcc.mjs";
-import { n as WorkerTransportConfig, t as WorkerTransport } from "./worker.transport-JvGPog3C.mjs";
+import { n as WorkerTransportConfig, t as WorkerTransport } from "./worker.transport-Bl8lFRck.mjs";
 export { WorkerTransport, WorkerTransportConfig };

package/dist/worker.d.ts

@@ -1,3 +1,2 @@
-import "./transport.types-CGoHpWQR.js";
-import { n as WorkerTransportConfig, t as WorkerTransport } from "./worker.transport-CdzSZJmw.js";
+import { n as WorkerTransportConfig, t as WorkerTransport } from "./worker.transport-B9mCQSM1.js";
 export { WorkerTransport, WorkerTransportConfig };

package/dist/worker.js

@@ -1,4 +1,3 @@
-require('./internal-log-BUJYMZbE.js');
-const require_worker_transport = require('./worker.transport-BdPxu3PN.js');
-
-exports.WorkerTransport = require_worker_transport.WorkerTransport;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_worker_transport = require("./worker.transport-DxxbqQCG.js");
+exports.WorkerTransport = require_worker_transport.WorkerTransport;

package/dist/worker.mjs

@@ -1,4 +1 @@
-import "./internal-log-Cm8SOWSV.mjs";
-import { t as WorkerTransport } from "./worker.transport-lPxO2MVL.mjs";
-
-export { WorkerTransport };
+export { t as WorkerTransport } from "./worker.transport-BmmOKb1-.mjs";

package/dist/{worker.transport-JvGPog3C.d.mts → worker.transport-B9mCQSM1.d.ts}

@@ -1,7 +1,4 @@
-import { l as ITransport, p as TransportLogEntry } from "./transport.types-BMnurPcc.mjs";
-
-//#region src/transports/worker.transport.d.ts
-
+import { _ as TransportLogEntry, d as ITransport } from "./transport.types-CzJq4IrF.js";
 interface WorkerTransportConfig {
   /**
    * Which built-in logixia transport to run inside the worker thread.
@@ -21,6 +18,11 @@ interface WorkerTransportConfig {
    * @default 3
    */
   maxRestarts?: number;
+  /**
+   * Custom level severities (`levelOptions.levels`) the wrapped transport's own
+   * `level` is compared against inside the worker. Built-in levels need no entry.
+   */
+  levels?: Record<string, number>;
   /**
    * Log level filter — only entries at or above this level are forwarded.
    * Useful for routing only errors to an expensive transport in a worker.
@@ -71,6 +73,5 @@ declare class WorkerTransport implements ITransport {
   shutdown(): Promise<void>;
   private drainBufferTo;
 }
-//#endregion
 export { WorkerTransportConfig as n, WorkerTransport as t };
-//# sourceMappingURL=worker.transport-JvGPog3C.d.mts.map
+//# sourceMappingURL=worker.transport-B9mCQSM1.d.ts.map

package/dist/worker.transport-B9mCQSM1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.transport-B9mCQSM1.d.ts","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;;mBAES;;mBAEA;EAEL,YAAA,QAAQ;UASZ;;YAsCE;UAIF;UAuBA;EASR,MAAM,OAAO;EAYP,SAAS;;;;;;;;EAiCT,SAAS;;EAkCT,YAAY;UAIV"}

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

@@ -1,7 +1,4 @@
-import { l as ITransport, p as TransportLogEntry } from "./transport.types-CGoHpWQR.js";
-
-//#region src/transports/worker.transport.d.ts
-
+import { _ as TransportLogEntry, d as ITransport } from "./transport.types-CzJq4IrF.mjs";
 interface WorkerTransportConfig {
   /**
    * Which built-in logixia transport to run inside the worker thread.
@@ -21,6 +18,11 @@ interface WorkerTransportConfig {
    * @default 3
    */
   maxRestarts?: number;
+  /**
+   * Custom level severities (`levelOptions.levels`) the wrapped transport's own
+   * `level` is compared against inside the worker. Built-in levels need no entry.
+   */
+  levels?: Record<string, number>;
   /**
    * Log level filter — only entries at or above this level are forwarded.
    * Useful for routing only errors to an expensive transport in a worker.
@@ -71,6 +73,5 @@ declare class WorkerTransport implements ITransport {
   shutdown(): Promise<void>;
   private drainBufferTo;
 }
-//#endregion
 export { WorkerTransportConfig as n, WorkerTransport as t };
-//# sourceMappingURL=worker.transport-CdzSZJmw.d.ts.map
+//# sourceMappingURL=worker.transport-Bl8lFRck.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.transport-Bl8lFRck.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;;mBAES;;mBAEA;EAEL,YAAA,QAAQ;UASZ;;YAsCE;UAIF;UAuBA;EASR,MAAM,OAAO;EAYP,SAAS;;;;;;;;EAiCT,SAAS;;EAkCT,YAAY;UAIV"}

package/dist/{worker.transport-lPxO2MVL.mjs → worker.transport-BmmOKb1-.mjs}

@@ -1,15 +1,47 @@
-import { r as internalWarn, t as internalError } from "./internal-log-Cm8SOWSV.mjs";
+import { r as internalWarn, t as internalError } from "./internal-log-Bg4V1cPg.mjs";
+import { n as protectSecrets } from "./secret-config-Dhb6pqTU.mjs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { Worker } from "node:worker_threads";
-
-//#region node_modules/tsdown/esm-shims.js
+// node_modules/tsdown/esm-shims.js
 const getFilename = () => fileURLToPath(import.meta.url);
 const getDirname = () => path.dirname(getFilename());
 const __dirname = /* @__PURE__ */ getDirname();
-
-//#endregion
-//#region src/transports/worker.transport.ts
+// src/transports/worker.transport.ts
+/**
+* logixia — Worker Thread Transport
+*
+* Offloads JSON serialization and all I/O to a Node.js worker thread,
+* completely eliminating any event-loop impact from logging. The main thread
+* only posts a raw message to the worker — it never calls JSON.stringify or
+* any I/O syscalls on the hot path.
+*
+* Architecture:
+*   Main thread  →  MessageChannel  →  Worker thread  →  Wrapped transport
+*
+* The worker runs an ordinary logixia transport (file, database, console…)
+* inside its own event loop. If the worker crashes it is restarted automatically
+* (up to `maxRestarts` times) and buffered messages are replayed.
+*
+* @example
+* ```ts
+* import { WorkerTransport } from 'logixia/worker';
+*
+* const logger = createLogger({
+*   transports: {
+*     // Run file transport inside a worker thread — zero event-loop impact
+*     custom: [
+*       new WorkerTransport({
+*         transportType: 'file',
+*         transportConfig: { filename: 'app.log', dirname: './logs' },
+*         bufferSize: 500,
+*         maxRestarts: 3,
+*       }),
+*     ],
+*   },
+* });
+* ```
+*/
 /**
 * Transport that runs a wrapped transport inside a dedicated Node.js worker
 * thread, completely removing JSON serialization and I/O from the main event loop.
@@ -31,13 +63,15 @@ var WorkerTransport = class {
 		this.bufferSize = config.bufferSize ?? 1e3;
 		this.maxRestarts = config.maxRestarts ?? 3;
 		this.level = config.level;
+		protectSecrets(this, ["config"]);
 		this.startWorker();
 	}
 	startWorker() {
 		try {
 			this.worker = new Worker(this.workerFile(), { workerData: {
 				transportType: this.config.transportType,
-				transportConfig: this.config.transportConfig
+				transportConfig: this.config.transportConfig,
+				levels: this.config.levels
 			} });
 			this.worker.on("message", (msg) => {
 				if (msg.type === "ready") {
@@ -161,7 +195,6 @@ var WorkerTransport = class {
 		}
 	}
 };
-
-//#endregion
 export { WorkerTransport as t };
-//# sourceMappingURL=worker.transport-lPxO2MVL.mjs.map
+
+//# sourceMappingURL=worker.transport-BmmOKb1-.mjs.map

package/dist/worker.transport-BmmOKb1-.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.transport-BmmOKb1-.mjs","names":[],"sources":["../node_modules/tsdown/esm-shims.js","../src/transports/worker.transport.ts"],"sourcesContent":["// Shim globals in esm bundle\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst getFilename = () => fileURLToPath(import.meta.url)\nconst getDirname = () => path.dirname(getFilename())\n\nexport const __dirname = /* @__PURE__ */ getDirname()\nexport const __filename = /* @__PURE__ */ getFilename()\n","/**\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  /** 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  }\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        } 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    } 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    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    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        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          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    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\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"],"ignoreList":[0],"mappings":"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"}

package/dist/{worker.transport-BdPxu3PN.js → worker.transport-DxxbqQCG.js}

@@ -1,11 +1,43 @@
-const require_chunk = require('./chunk-nOFOJqeH.js');
-const require_internal_log = require('./internal-log-BUJYMZbE.js');
+const require_secret_config = require("./secret-config-CmK2wVkr.js");
+const require_internal_log = require("./internal-log-By4Govmu.js");
 let node_path = require("node:path");
-node_path = require_chunk.__toESM(node_path);
+node_path = require_secret_config.__toESM(node_path);
 let node_worker_threads = require("node:worker_threads");
-node_worker_threads = require_chunk.__toESM(node_worker_threads);
-
-//#region src/transports/worker.transport.ts
+// src/transports/worker.transport.ts
+/**
+* logixia — Worker Thread Transport
+*
+* Offloads JSON serialization and all I/O to a Node.js worker thread,
+* completely eliminating any event-loop impact from logging. The main thread
+* only posts a raw message to the worker — it never calls JSON.stringify or
+* any I/O syscalls on the hot path.
+*
+* Architecture:
+*   Main thread  →  MessageChannel  →  Worker thread  →  Wrapped transport
+*
+* The worker runs an ordinary logixia transport (file, database, console…)
+* inside its own event loop. If the worker crashes it is restarted automatically
+* (up to `maxRestarts` times) and buffered messages are replayed.
+*
+* @example
+* ```ts
+* import { WorkerTransport } from 'logixia/worker';
+*
+* const logger = createLogger({
+*   transports: {
+*     // Run file transport inside a worker thread — zero event-loop impact
+*     custom: [
+*       new WorkerTransport({
+*         transportType: 'file',
+*         transportConfig: { filename: 'app.log', dirname: './logs' },
+*         bufferSize: 500,
+*         maxRestarts: 3,
+*       }),
+*     ],
+*   },
+* });
+* ```
+*/
 /**
 * Transport that runs a wrapped transport inside a dedicated Node.js worker
 * thread, completely removing JSON serialization and I/O from the main event loop.
@@ -27,13 +59,15 @@ var WorkerTransport = class {
 		this.bufferSize = config.bufferSize ?? 1e3;
 		this.maxRestarts = config.maxRestarts ?? 3;
 		this.level = config.level;
+		require_secret_config.protectSecrets(this, ["config"]);
 		this.startWorker();
 	}
 	startWorker() {
 		try {
 			this.worker = new node_worker_threads.Worker(this.workerFile(), { workerData: {
 				transportType: this.config.transportType,
-				transportConfig: this.config.transportConfig
+				transportConfig: this.config.transportConfig,
+				levels: this.config.levels
 			} });
 			this.worker.on("message", (msg) => {
 				if (msg.type === "ready") {
@@ -157,12 +191,11 @@ var WorkerTransport = class {
 		}
 	}
 };
-
-//#endregion
-Object.defineProperty(exports, 'WorkerTransport', {
-  enumerable: true,
-  get: function () {
-    return WorkerTransport;
-  }
+Object.defineProperty(exports, "WorkerTransport", {
+	enumerable: true,
+	get: function() {
+		return WorkerTransport;
+	}
 });
-//# sourceMappingURL=worker.transport-BdPxu3PN.js.map
+
+//# sourceMappingURL=worker.transport-DxxbqQCG.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.transport-DxxbqQCG.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  /** 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  }\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        } 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    } 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    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    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        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          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    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\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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "logixia",
-  "version": "2.0.0",
-  "description": "Async-first TypeScript logger: wide events / canonical log lines, OTLP OpenTelemetry export, runtime log levels, redaction, adaptive sampling, NestJS, multi-transport (file, DB, cloud), tracing & log search. A fast Winston/Pino alternative.",
+  "version": "2.0.6",
+  "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.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -151,6 +151,8 @@
     "format:check": "prettier --check .",
     "typecheck": "tsc --noEmit",
     "typecheck:examples": "tsc -p tsconfig.examples.json && tsc -p examples/cloudflare-worker/tsconfig.json",
+    "typecheck:consumer": "npm run build && tsc -p tests/consumer/tsconfig.json",
+    "typecheck:express4": "node scripts/typecheck-express4.mjs",
     "check": "npm run typecheck && npm run lint:check",
     "ci": "npm run typecheck && npm run lint:check && npm run test:ci",
     "validate": "npm run clean && npm run build && npm run typecheck && npm run lint:check && npm run test:coverage",
@@ -165,8 +167,10 @@
     "dev:performance": "ts-node -P tsconfig.examples.json --transpile-only -r ./examples/register.js examples/performance-monitoring.ts",
     "dev:fields": "ts-node -P tsconfig.examples.json --transpile-only -r ./examples/register.js examples/field-configuration.ts",
     "dev:search": "ts-node -P tsconfig.examples.json --transpile-only -r ./examples/register.js examples/search-quickstart.ts",
+    "dev:search-readme": "ts-node -P tsconfig.examples.json --transpile-only -r ./examples/register.js examples/search-readme.ts",
     "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:exports": "node scripts/check-exports.mjs",
     "check:optional-peers": "node scripts/check-optional-peers.mjs",
     "size": "size-limit",
@@ -178,81 +182,41 @@
     "logging",
     "typescript",
     "typescript-logger",
+    "structured-logging",
+    "json-logging",
     "nestjs",
     "nestjs-logger",
-    "nestjs-logging",
-    "nestjs-module",
     "winston-alternative",
     "pino-alternative",
-    "structured-logging",
-    "json-logging",
-    "custom-log-levels",
-    "log-levels",
-    "request-tracing",
+    "request-id",
     "trace-id",
-    "opentelemetry",
-    "w3c-trace-context",
-    "multi-transport",
-    "console-transport",
-    "file-transport",
-    "log-rotation",
-    "database-logging",
-    "mongodb-logger",
-    "postgresql-logger",
-    "analytics-logging",
-    "datadog",
-    "mixpanel",
-    "segment",
-    "log-search",
-    "log-analysis",
-    "log-aggregation",
-    "nodejs",
-    "bun",
-    "express",
-    "microservices",
+    "request-tracing",
+    "correlation-id",
     "distributed-tracing",
-    "observability",
-    "developer-tools",
-    "enterprise-logging",
-    "wide-events",
-    "canonical-log-lines",
-    "observability-2.0",
+    "opentelemetry",
     "otlp",
-    "otlp-logs",
-    "opentelemetry-logs",
-    "otel-logs",
-    "log-correlation",
-    "trace-log-correlation",
-    "log-redaction",
+    "w3c-trace-context",
+    "redaction",
     "pii-redaction",
-    "secret-redaction",
     "log-sampling",
-    "adaptive-sampling",
-    "dynamic-log-level",
-    "runtime-log-level",
-    "prometheus",
-    "metrics",
-    "prometheus-metrics",
-    "graceful-shutdown",
-    "flush-on-exit",
+    "log-levels",
+    "wide-events",
+    "express",
+    "fastify",
+    "cloudflare-workers",
+    "edge",
+    "browser-logger",
+    "datadog",
     "cloudwatch",
     "gcp-logging",
     "azure-monitor",
-    "fastify",
-    "fastify-logger",
-    "fastify-logging",
-    "browser-logger",
-    "edge-logging",
-    "correlation-id",
-    "async-logger",
-    "non-blocking-logger",
-    "fast-logger",
-    "high-performance-logging",
-    "log-management",
-    "structured-logs",
-    "json-logger",
-    "typescript-logging",
-    "bunyan-alternative"
+    "slack",
+    "discord",
+    "database-logging",
+    "log-rotation",
+    "log-search",
+    "prometheus",
+    "observability"
   ],
   "author": {
     "name": "Sanjeev Sharma",
@@ -281,6 +245,7 @@
   ],
   "peerDependencies": {
     "@nestjs/common": "^10.0.0 || ^11.0.0",
+    "@opentelemetry/api": "^1.0.0",
     "express": "^4.0.0 || ^5.0.0",
     "reflect-metadata": "^0.1.13 || ^0.2.0"
   },
@@ -288,6 +253,9 @@
     "@nestjs/common": {
       "optional": true
     },
+    "@opentelemetry/api": {
+      "optional": true
+    },
     "express": {
       "optional": true
     },
@@ -307,22 +275,24 @@
     "@nestjs/platform-express": "^11.1.17",
     "@nestjs/platform-socket.io": "^11.1.17",
     "@nestjs/websockets": "^11.1.17",
+    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/context-async-hooks": "3.0.0",
+    "@opentelemetry/sdk-trace-base": "2.12.0",
     "@semantic-release/commit-analyzer": "13.0.1",
     "@semantic-release/github": "12.0.10",
     "@semantic-release/npm": "13.2.0",
     "@semantic-release/release-notes-generator": "14.1.1",
-    "@size-limit/file": "^12.0.1",
-    "@types/express": "^4.17.0",
+    "@size-limit/file": "^14.3.0",
+    "@types/express": "^5.0.6",
     "@types/jest": "^30.0.0",
-    "@types/node": "^20.0.0",
+    "@types/node": "^20.19.43",
     "@types/pg": "^8.15.5",
-    "@types/pino": "^7.0.4",
     "conventional-changelog-conventionalcommits": "8.0.0",
     "eslint": "^10.0.3",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-simple-import-sort": "^12.1.1",
-    "eslint-plugin-sonarjs": "4.2.0",
-    "eslint-plugin-unicorn": "^63.0.0",
+    "eslint-plugin-simple-import-sort": "^14.0.0",
+    "eslint-plugin-sonarjs": "^4.2.2",
+    "eslint-plugin-unicorn": "^78.0.0",
     "express": "^5.2.1",
     "fastify": "^5.12.7",
     "globals": "^17.4.0",
@@ -338,20 +308,26 @@
     "prettier": "^3.8.1",
     "reflect-metadata": "^0.2.2",
     "semantic-release": "25.0.9",
-    "size-limit": "^12.0.1",
+    "size-limit": "^14.3.0",
     "socket.io": "^4.8.3",
     "tinybench": "^6.0.0",
     "ts-jest": "^29.0.0",
     "ts-node": "^10.9.2",
-    "tsdown": "^0.15.0",
+    "tsdown": "^0.23.1",
     "typescript": "^5.0.0",
     "typescript-eslint": "^8.57.0",
-    "uuid": "^11.1.1",
     "winston": "^3.19.0"
   },
   "engines": {
     "node": ">=16.0.0"
   },
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": "^22.19.0 || ^24.11.0 || >=26.0.0",
+      "onFail": "warn"
+    }
+  },
   "bin": {
     "logixia": "./dist/cli/index.js"
   },

package/dist/async-context-BzJrbfQs.mjs

@@ -1,72 +0,0 @@
-import { d as sanitizeIncomingId } from "./trace.utils-CvXgaiQT.mjs";
-import { randomUUID } from "node:crypto";
-import { AsyncLocalStorage } from "node:async_hooks";
-
-//#region src/context/async-context.ts
-/** Generates an 8-character random ID using Node's crypto module. */
-function randomShortId() {
-	return randomUUID().slice(0, 8);
-}
-const _storage = new AsyncLocalStorage();
-const LogixiaContext = {
-	run(store, callback) {
-		const parent = _storage.getStore() ?? {};
-		return _storage.run({
-			...parent,
-			...store
-		}, callback);
-	},
-	get() {
-		return _storage.getStore();
-	},
-	set(fields) {
-		const store = _storage.getStore();
-		if (!store) return;
-		for (const key of Object.keys(fields)) {
-			if (key === "__proto__" || key === "constructor" || key === "prototype") continue;
-			store[key] = fields[key];
-		}
-	},
-	getStorage() {
-		return _storage;
-	}
-};
-/**
-* Create an Express/Connect-compatible middleware that wraps each request in
-* a `LogixiaContext.run()` scope populated with common request fields.
-*
-* @example
-* ```ts
-* import { createExpressContextMiddleware } from 'logixia';
-* app.use(createExpressContextMiddleware());
-* ```
-*/
-function createExpressContextMiddleware(options = {}) {
-	const { enrich, traceIdHeader = "x-trace-id" } = options;
-	return function logixiaContextMiddleware(req, _res, next) {
-		const base = { traceId: sanitizeIncomingId((req["headers"] ?? {})[traceIdHeader.toLowerCase()]) ?? randomShortId() };
-		LogixiaContext.run({
-			...base,
-			...enrich ? enrich(req) : {}
-		}, next);
-	};
-}
-/**
-* Create a Fastify lifecycle hook that wraps each request in a context scope.
-*
-* Register with `fastify.addHook('onRequest', createFastifyContextHook())`.
-*/
-function createFastifyContextHook(options = {}) {
-	const { enrich, traceIdHeader = "x-trace-id" } = options;
-	return function logixiaFastifyHook(request, _reply, done) {
-		const base = { traceId: sanitizeIncomingId((request["headers"] ?? {})[traceIdHeader.toLowerCase()]) ?? sanitizeIncomingId(request["id"]) ?? randomShortId() };
-		LogixiaContext.run({
-			...base,
-			...enrich ? enrich(request) : {}
-		}, done);
-	};
-}
-
-//#endregion
-export { createExpressContextMiddleware as n, createFastifyContextHook as r, LogixiaContext as t };
-//# sourceMappingURL=async-context-BzJrbfQs.mjs.map

package/dist/async-context-BzJrbfQs.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"async-context-BzJrbfQs.mjs","names":["base: LogContext"],"sources":["../src/context/async-context.ts"],"sourcesContent":["/**\n * LogixiaContext — Zero-boilerplate AsyncLocalStorage context propagation.\n *\n * Lets every `logger.info()` call inside a context automatically pick up stored\n * fields (requestId, userId, tenantId, …) without passing them through every function.\n *\n * Works across `Promise.all`, `setTimeout`, and event emitters — anything that\n * inherits the async execution context.\n *\n * @example\n * ```ts\n * import { LogixiaContext } from 'logixia';\n *\n * // Wrap a request handler:\n * app.use((req, res, next) => {\n *   LogixiaContext.run({ requestId: req.id, userId: req.user?.id }, next);\n * });\n *\n * // Anywhere deeper in the call tree:\n * async function processOrder(orderId: string) {\n *   const ctx = LogixiaContext.get();  // { requestId, userId, orderId }\n *   logger.info('Processing order', { orderId, ...ctx });\n * }\n * ```\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport { randomUUID } from 'node:crypto';\n\nimport { sanitizeIncomingId } from '../utils/trace.utils';\n\n/** Generates an 8-character random ID using Node's crypto module. */\nfunction randomShortId(): string {\n  return randomUUID().slice(0, 8);\n}\n\nexport interface LogContext {\n  traceId?: string;\n  spanId?: string;\n  userId?: string;\n  tenantId?: string;\n  sessionId?: string;\n  [key: string]: unknown;\n}\n\n// Module-level singleton so all loggers share the same ALS store.\nconst _storage = new AsyncLocalStorage<LogContext>();\n\nexport const LogixiaContext = {\n  /**\n   * Run `callback` inside an async context that carries `store` fields.\n   * All loggers queried within `callback` (and its async descendants) will\n   * automatically see these fields.\n   *\n   * @example\n   * ```ts\n   * LogixiaContext.run({ requestId: 'abc', userId: '42' }, async () => {\n   *   await processOrder();   // sees requestId + userId in every log\n   * });\n   * ```\n   */\n  run<T>(store: LogContext, callback: () => T): T {\n    const parent = _storage.getStore() ?? {};\n    return _storage.run({ ...parent, ...store }, callback);\n  },\n\n  /**\n   * Return the context fields active in the current async scope.\n   * Returns `undefined` when called outside any `LogixiaContext.run()`.\n   */\n  get(): LogContext | undefined {\n    return _storage.getStore();\n  },\n\n  /**\n   * Merge `fields` into the **existing** context for the current scope.\n   * If called outside a `run()` context this is a no-op (logs a dev warning).\n   */\n  set(fields: Partial<LogContext>): void {\n    const store = _storage.getStore();\n    if (!store) {\n      // Silently ignore — avoids crashing in code that may call setContext\n      // before a request context is established (e.g. background jobs).\n      return;\n    }\n    for (const key of Object.keys(fields)) {\n      if (key === '__proto__' || key === 'constructor' || key === 'prototype') continue;\n      store[key] = fields[key];\n    }\n  },\n\n  /**\n   * Retrieve the underlying `AsyncLocalStorage` instance.\n   * Useful for advanced use-cases like custom middleware.\n   */\n  getStorage(): AsyncLocalStorage<LogContext> {\n    return _storage;\n  },\n};\n\n/**\n * Create an Express/Connect-compatible middleware that wraps each request in\n * a `LogixiaContext.run()` scope populated with common request fields.\n *\n * @example\n * ```ts\n * import { createExpressContextMiddleware } from 'logixia';\n * app.use(createExpressContextMiddleware());\n * ```\n */\nexport function createExpressContextMiddleware(\n  options: {\n    /** Extract additional fields from the request. */\n    enrich?: (req: Record<string, unknown>) => Partial<LogContext>;\n    /** Header to read the traceId from. Default: 'x-trace-id'. */\n    traceIdHeader?: string;\n  } = {}\n) {\n  const { enrich, traceIdHeader = 'x-trace-id' } = options;\n\n  return function logixiaContextMiddleware(\n    req: Record<string, unknown>,\n    _res: unknown,\n    next: () => void\n  ): void {\n    const headers = (req['headers'] ?? {}) as Record<string, string | undefined>;\n    const traceId = sanitizeIncomingId(headers[traceIdHeader.toLowerCase()]) ?? randomShortId();\n    const base: LogContext = { traceId };\n    LogixiaContext.run({ ...base, ...(enrich ? enrich(req) : {}) }, next);\n  };\n}\n\n/**\n * Create a Fastify lifecycle hook that wraps each request in a context scope.\n *\n * Register with `fastify.addHook('onRequest', createFastifyContextHook())`.\n */\nexport function createFastifyContextHook(\n  options: {\n    enrich?: (request: Record<string, unknown>) => Partial<LogContext>;\n    traceIdHeader?: string;\n  } = {}\n) {\n  const { enrich, traceIdHeader = 'x-trace-id' } = options;\n\n  return function logixiaFastifyHook(\n    request: Record<string, unknown>,\n    _reply: unknown,\n    done: () => void\n  ): void {\n    const headers = (request['headers'] ?? {}) as Record<string, string | undefined>;\n    const traceId =\n      sanitizeIncomingId(headers[traceIdHeader.toLowerCase()]) ??\n      sanitizeIncomingId(request['id']) ??\n      randomShortId();\n    const base: LogContext = { traceId };\n    LogixiaContext.run({ ...base, ...(enrich ? enrich(request) : {}) }, done);\n  };\n}\n"],"mappings":";;;;;;AAgCA,SAAS,gBAAwB;AAC/B,QAAO,YAAY,CAAC,MAAM,GAAG,EAAE;;AAajC,MAAM,WAAW,IAAI,mBAA+B;AAEpD,MAAa,iBAAiB;CAa5B,IAAO,OAAmB,UAAsB;EAC9C,MAAM,SAAS,SAAS,UAAU,IAAI,EAAE;AACxC,SAAO,SAAS,IAAI;GAAE,GAAG;GAAQ,GAAG;GAAO,EAAE,SAAS;;CAOxD,MAA8B;AAC5B,SAAO,SAAS,UAAU;;CAO5B,IAAI,QAAmC;EACrC,MAAM,QAAQ,SAAS,UAAU;AACjC,MAAI,CAAC,MAGH;AAEF,OAAK,MAAM,OAAO,OAAO,KAAK,OAAO,EAAE;AACrC,OAAI,QAAQ,eAAe,QAAQ,iBAAiB,QAAQ,YAAa;AACzE,SAAM,OAAO,OAAO;;;CAQxB,aAA4C;AAC1C,SAAO;;CAEV;;;;;;;;;;;AAYD,SAAgB,+BACd,UAKI,EAAE,EACN;CACA,MAAM,EAAE,QAAQ,gBAAgB,iBAAiB;AAEjD,QAAO,SAAS,yBACd,KACA,MACA,MACM;EAGN,MAAMA,OAAmB,EAAE,SADX,oBADC,IAAI,cAAc,EAAE,EACM,cAAc,aAAa,EAAE,IAAI,eAAe,EACvD;AACpC,iBAAe,IAAI;GAAE,GAAG;GAAM,GAAI,SAAS,OAAO,IAAI,GAAG,EAAE;GAAG,EAAE,KAAK;;;;;;;;AASzE,SAAgB,yBACd,UAGI,EAAE,EACN;CACA,MAAM,EAAE,QAAQ,gBAAgB,iBAAiB;AAEjD,QAAO,SAAS,mBACd,SACA,QACA,MACM;EAMN,MAAMA,OAAmB,EAAE,SAHzB,oBAFe,QAAQ,cAAc,EAAE,EAEZ,cAAc,aAAa,EAAE,IACxD,mBAAmB,QAAQ,MAAM,IACjC,eAAe,EACmB;AACpC,iBAAe,IAAI;GAAE,GAAG;GAAM,GAAI,SAAS,OAAO,QAAQ,GAAG,EAAE;GAAG,EAAE,KAAK"}