lograil 0.1.0 → 0.1.4

package/CHANGELOG.md

@@ -4,8 +4,107 @@ All notable changes to this project are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This file is generated from git history by `scripts/gen-changelog.mjs` (run via `yarn changelog`) and refreshed automatically on each release.
 
-## [Unreleased] - 2026-08-29
+## [v0.1.4] - 2026-09-04
 
+- chore: 在 package.json 补充 repository、homepage 与 bugs 元信息
+- 0.1.4
+- ci: 升级 actions/setup-node 至 v6，发布环境改用 Node 24 并简化 npm publish
+
+## [v0.1.3] - 2026-09-04
+
+- 0.1.3
+- docs: 在 AGENTS.md 新增类型检查章节，记录 typecheck 双命令与常见测试类型陷阱
+- fix: 修复测试类型定义与 OpenTelemetry 类型路径
+
+## [v0.1.2] - 2026-09-04
+
+- 0.1.2
+- ci: 移除 Publish 步骤的 NODE_AUTH_TOKEN，改用 npm OIDC 可信发布
+- test: 补充 PluginContext 移除 transport/卸载插件与 setOnLevelCommand 回调接线的用例
+- fix: 处理缺失 Electron 二进制时的错误，返回最小存根以避免运行时崩溃
+- fix: 安全审计修复 8 个隐患问题，补充 10 个回归测试
+- fix: add global deduplication for cluster/worker/electron IPC receivers
+- chore: remove zero-copy IPC path from ElectronIpcTransport and update docs
+- feat: 添加 log 方法作为 info 的别名
+- fix: inject ipcRenderer explicitly in createElectronRuntime renderer path
+- fix: remove invalid buffer transfer arg from electron postMessage calls
+- chore: bump @opentelemetry/api peer dependency to ^1.9.1 and simplify dynamic import
+- Optimize sampler, console, and context for performance improvements (#2)
+
+## [v0.1.1] - 2026-09-02
+
+- 0.1.1
+- test: increase timeout for single mode capacity caps no-op test
+- docs: add Glossary page and clarify key terms in guides
+- docs: add per-transport level filtering, clarify scope vs child, fix plugin immutability
+- refactor: rename namespace options to scope for consistency
+- docs: add Context & Metadata guide and cross-link across docs
+- feat: accept non-Error values as error in log entries
+- test: add coverage tests for serialize processors and jsonFormatter, simplify vitest config
+- ci: simplify docs deploy to latest root only, drop versioned docs and versions.json
+- ci: use orphan commits for docs branch deployments
+- Harden logging pipeline edge cases: OTLP flush drain, rotation semantics, plugin rollback, and transport teardown (#1)
+- test: add braces to arrow function callback in signal handler test
+- test: add integration tests for Node runtime cluster and worker_threads
+- test: add coverage for edge cases in printf, formatter, pipeline, serializer, and sampler
+- test: add coverage for edge cases in formatter, lifecycle, processor, and runtime
+- test: add integration tests for LiveTransport replay/buffer and Logger.destroy edge cases
+- test: add process handler cleanup and fix LiveTransport buffer validation
+- fix: properly restore previous onmessage handler and add close to WorkerIpcTransport
+- perf: replace unbounded dispatch promise chain with bounded inflight counter
+- perf: cache namespace filters and share mutable path in redactNode
+- docs: translate pronunciation guide to English
+- docs: add pronunciation guide for lograil
+- fix: correct GitHub repo name in logo URL from electron-logger to lograil
+- fix: update logo image URL to GitHub raw link in README.md
+- chore: update logo SVG design to train wheel motif
+
+## [v0.1.0] - 2026-09-01
+
+- chore: add author field to package.json
+- test: remove unused LOG_LEVELS import and _entry helper
+- feat(core): getLevel() returns peer level for cross-process consistency
+- feat(transport): add cross-process log level sync via IPC
+- feat(transport): add FileTransport file inspection API and tests
+- test: align write calls with updated Transport interface signature
+- fix(electron-ipc,core): surface IPC transport errors and guard flush against stalls
+- refactor(transport): align write signatures with Transport interface
+- docs: enable Mermaid support in VitePress docs
+- docs(plugins): expand lifecycle docs with flow diagrams and error handling
+- feat(worker-threads): add automatic log forwarding from workers to main thread
+- feat(node): add cluster support with automatic worker-to-primary log forwarding
+- docs: add runtime-specific guides and update navigation
+- docs(FileTransport): document name option semantics
+- refactor(FileTransport): remove custom fileName option from rotate-size and rotate-time modes
+- feat(runtime): apply disk-safety defaults to default file transports and add maxFilesPerBucket cap
+- feat(FileTransport): split rotate-time buckets by maxSize and trim maxFiles by time bucket
+- docs: document browser bundling and web runtime usage
+- fix(test): ensure dist directory exists before writing browser bundle
+- feat(shims): add browser-compatible Node API shims and enforce their use
+- fix(FileTransport): clarify maxAge semantics, track owned files, and suppress repeated write errors
+- feat(FileTransport): add global capacity caps (maxTotalSize / maxAge) with throttled checks
+- feat(runtime): move Electron log dir to app.getPath('logs'), allow dir override
+- refactor(FileTransport): split 5 modes into isolated Rotator strategies
+- fix(FileTransport): harden single-truncate on Windows and resume rotate-time ring on restart
+- feat: replace RotatingFileTransport with unified FileTransport (5 modes, appName required)
+- docs: reposition as universal logging library with Web/Node/Electron as first-class runtimes, plugins for other platforms
+- docs: document runtime lifecycle hooks and Electron app quit events
+- feat: wire runtime lifecycle hooks and cover Electron app quit events
+- ci(test): harden verify.yml, lift coverage past 90% and fix otel-trace crash
+- feat: lightweight child/scope loggers and printf-style message formatting
+- perf: eliminate per-call allocations on hot path and fix transport queue leak
+- style(theme): flatten version map
+- fix(core): flush logs on exit with timeout safety
+- docs(agents): add documentation wording guidelines
+- docs(guide): add Introduction chapter covering what/why/when and core concepts
+- docs(transport): restructure LiveTransport guide into entity vs formatted-string rendering
+- fix(test): close loggers before removing temp dir in node-file integration
+- feat(transport): add LiveTransport for in-process log streaming
+- fix(ci): pass boolean input only on workflow_dispatch
+- ci: add coverage thresholds and CI coverage gate
+- test: 新增分层集成测试（Node 落盘 / Web jsdom / Electron 真实 IPC）
+- docs: 用更口语化的措辞重写文档术语
+- docs: 补充项目文档并修正迁移/排查表述
 - fix(docs): 更新 GitHub 链接以指向正确的仓库
 - feat: define immutable LogEntry contract and zero-copy IPC transfer
 - feat(logger): 添加异步插件拦截顺序处理，确保传输队列独立，避免阻塞
@@ -36,3 +135,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - feat: init
 - Create README.md
 
+[v0.1.0]: https://github.com/axetroy/lograil/compare/v0.1.0...v0.1.0
+[v0.1.1]: https://github.com/axetroy/lograil/compare/v0.1.0...v0.1.1
+[v0.1.2]: https://github.com/axetroy/lograil/compare/v0.1.1...v0.1.2
+[v0.1.3]: https://github.com/axetroy/lograil/compare/v0.1.2...v0.1.3
+[v0.1.4]: https://github.com/axetroy/lograil/compare/v0.1.3...v0.1.4

package/README.md

@@ -1,9 +1,11 @@
 <div align="center">
-  <img src="./logo.svg" alt="lograil" width="128" height="128" />
+  <img src="https://raw.githubusercontent.com/axetroy/lograil/refs/heads/main/logo.svg" alt="lograil" width="128" height="128" />
 </div>
 
 # lograil
 
+**Pronunciation**: /lɒɡ-reɪl/ (log-rail)
+
 Structured, secure logging for **Web**, **Node.js**, and **Electron** — three first-class runtimes, one zero-config `logger`, pluggable transports, filters, processors, formatters, and plugins. Extend to any other platform through the plugin and runtime-adapter APIs.
 
 The same `import { logger } from 'lograil'` works untouched in every runtime. On Electron, the main process writes logs to the console **and** daily rotating files, and renderer logs are forwarded over IPC automatically; on Node it persists to a rotating file by default; in the browser it speaks the console and any remote transport you add.

package/dist/cjs/context/async-context.browser.d.ts

@@ -1,10 +1,4 @@
-export type AmbientContext = Record<string, unknown>;
-/**
- * Browser / non-Node stub. `AsyncLocalStorage` is unavailable here, so ambient
- * context is a no-op — logs are unaffected and no context propagates. The real
- * implementation (`async-context.ts`) is selected over this file in Node builds
- * via the `browser` field in `package.json`.
- */
+import type { AmbientContext } from './async-context.js';
 export declare const asyncContext: {
     run<T>(fn: () => T, _context: AmbientContext): T;
     runAsync<T>(fn: () => Promise<T>, _context: AmbientContext): Promise<T>;

package/dist/cjs/context/async-context.browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async-context.browser.d.ts","sourceRoot":"","sources":["../../../src/context/async-context.browser.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,YAAY;QACnB,CAAC,MAAM,MAAM,CAAC,YAAY,cAAc,GAAG,CAAC;aAGvC,CAAC,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;WAGhE,cAAc;iBAGR,OAAO;CAGrB,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,cAAc,GAAG,CAAC,CAE1E"}
+{"version":3,"file":"async-context.browser.d.ts","sourceRoot":"","sources":["../../../src/context/async-context.browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAWzD,eAAO,MAAM,YAAY;QACnB,CAAC,MAAM,MAAM,CAAC,YAAY,cAAc,GAAG,CAAC;aAGvC,CAAC,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;WAGhE,cAAc;iBAGR,OAAO;CAGrB,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,cAAc,GAAG,CAAC,CAE1E"}

package/dist/cjs/context/async-context.browser.js

@@ -8,6 +8,9 @@ exports.runWithContext = runWithContext;
  * implementation (`async-context.ts`) is selected over this file in Node builds
  * via the `browser` field in `package.json`.
  */
+// Shared frozen empty object returned when no async store is active, so the
+// common (no ambient context) path allocates nothing on every `get()`.
+const EMPTY_AMBIENT = Object.freeze({});
 exports.asyncContext = {
     run(fn, _context) {
         return fn();
@@ -16,7 +19,7 @@ exports.asyncContext = {
         return fn();
     },
     get() {
-        return {};
+        return EMPTY_AMBIENT;
     },
     supported() {
         return false;

package/dist/cjs/context/async-context.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"async-context.browser.js","sourceRoot":"","sources":["../../../src/context/async-context.browser.ts"],"names":[],"mappings":";;;AAwBA,wCAEC;AAxBD;;;;;GAKG;AACU,QAAA,YAAY,GAAG;IAC1B,GAAG,CAAI,EAAW,EAAE,QAAwB;QAC1C,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IACD,QAAQ,CAAI,EAAoB,EAAE,QAAwB;QACxD,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IACD,GAAG;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,SAAS;QACP,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC;AAEF,0FAA0F;AAC1F,SAAgB,cAAc,CAAI,EAAW,EAAE,QAAwB;IACrE,OAAO,EAAE,EAAE,CAAC;AACd,CAAC"}
+{"version":3,"file":"async-context.browser.js","sourceRoot":"","sources":["../../../src/context/async-context.browser.ts"],"names":[],"mappings":";;;AA2BA,wCAEC;AA3BD;;;;;GAKG;AACH,4EAA4E;AAC5E,uEAAuE;AACvE,MAAM,aAAa,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC3C,QAAA,YAAY,GAAG;IAC1B,GAAG,CAAI,EAAW,EAAE,QAAwB;QAC1C,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IACD,QAAQ,CAAI,EAAoB,EAAE,QAAwB;QACxD,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IACD,GAAG;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,SAAS;QACP,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC;AAEF,0FAA0F;AAC1F,SAAgB,cAAc,CAAI,EAAW,EAAE,QAAwB;IACrE,OAAO,EAAE,EAAE,CAAC;AACd,CAAC"}

package/dist/cjs/context/context.js

@@ -32,7 +32,7 @@ function createContextStore(initial) {
             // Avoid cloning (and allocating) when the store is empty — the shared
             // frozen object can never be mutated by callers.
             for (const _k in data)
-                return { ...data };
+                return Object.assign({}, data);
             return EMPTY_CONTEXT;
         },
         set(key, value) {

package/dist/cjs/context/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/context/context.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA4BH,sCAGC;AAED,gDA6BC;AA7CD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAA4B,CAAC;AAEnE;;;;;GAKG;AACU,QAAA,YAAY,GAAG,aAAa,CAAC;AAE1C,uDAAuD;AACvD,SAAgB,aAAa,CAAC,CAA0B;IACtD,KAAK,MAAM,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,kBAAkB,CAAC,OAAiC;IAClE,IAAI,IAAI,GAA4B,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IAE3D,MAAM,KAAK,GAAiB;QAC1B,GAAG;YACD,sEAAsE;YACtE,iDAAiD;YACjD,KAAK,MAAM,EAAE,IAAI,IAAI;gBAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;YAC1C,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,KAAK;YACZ,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,KAAK,CAAC,MAAM;YACV,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,CAAC,GAAG;YACR,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QACD,KAAK;YACH,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;QACD,KAAK;YACH,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/context/context.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA4BH,sCAGC;AAED,gDA6BC;AA7CD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAA4B,CAAC;AAEnE;;;;;GAKG;AACU,QAAA,YAAY,GAAG,aAAa,CAAC;AAE1C,uDAAuD;AACvD,SAAgB,aAAa,CAAC,CAA0B;IACtD,KAAK,MAAM,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,kBAAkB,CAAC,OAAiC;IAClE,IAAI,IAAI,GAA4B,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IAE3D,MAAM,KAAK,GAAiB;QAC1B,GAAG;YACD,sEAAsE;YACtE,iDAAiD;YACjD,KAAK,MAAM,EAAE,IAAI,IAAI;gBAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACtD,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,KAAK;YACZ,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,KAAK,CAAC,MAAM;YACV,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,CAAC,GAAG;YACR,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QACD,KAAK;YACH,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;QACD,KAAK;YACH,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cjs/core/logger.d.ts

@@ -42,9 +42,9 @@ export interface LoggerOptions {
     /**
      * Maximum time (ms) to spend flushing on process exit (`beforeExit`,
      * `SIGINT`, `SIGTERM`) before giving up and letting the process exit, so a
-     * stalled transport flush can never hang shutdown. Default `2000`.
+     * stalled transport flush can never hang shutdown. Default `2000`.\
      */
-    exitFlushTimeoutMs?: number;
+    flushTimeoutMs?: number;
     /** Optional scope / namespace for this logger. */
     scope?: string;
     /** Runtime adapter. Auto-detected when omitted. */
@@ -69,17 +69,17 @@ export interface LoggerOptions {
      */
     levelEnvVar?: string | null;
     /**
-     * Scope/namespace filter. A comma- or space-separated list of glob patterns
+     * Scope filter. A comma- or space-separated list of glob patterns
      * (with `*` wildcards); a leading `-` excludes. Only entries whose `scope`
-     * matches are emitted. Read automatically from `namespaceEnvVar` when omitted.
+     * matches are emitted. Read automatically from `scopeFilterEnvVar` when omitted.
      */
-    namespaceFilter?: string | string[];
+    scopeFilter?: string | string[];
     /**
-     * Environment variable whose value supplies the namespace filter when
-     * `namespaceFilter` is not set. Defaults to `"LOGRAIL_DEBUG"`. Set to `null`
+     * Environment variable whose value supplies the scope filter when
+     * `scopeFilter` is not set. Defaults to `"LOGRAIL_DEBUG"`. Set to `null`
      * to disable.
      */
-    namespaceEnvVar?: string | null;
+    scopeFilterEnvVar?: string | null;
 }
 /**
  * Internal options passed by `scope`/`child` to build a **lightweight** child
@@ -115,12 +115,14 @@ export declare class Logger implements LoggerMethods {
     private parent?;
     private levelOverride?;
     /**
-     * Sequences the async plugin-interception step so entries are processed in
-     * emit order. Transport writes fan out to their own per-transport queues
-     * (see `transportQueues`), so a slow/blocked transport can never stall the
-     * others or this front queue.
+     * Bounded async queue for plugin interception. Tracks in-flight entries so
+     * `flush()` and `destroy()` know when all interceptions are done without
+     * letting the dispatch chain grow unboundedly (each push would append a
+     * `.then()` to an ever-longer Promise chain).
      */
-    private dispatchQueue;
+    private dispatchInflight;
+    private dispatchDrain;
+    private dispatchDrainResolve;
     /** Independent async-write queue per transport. */
     private transportQueues;
     private destroyed;
@@ -130,9 +132,9 @@ export declare class Logger implements LoggerMethods {
     private removeProcessHandlers?;
     private onLoggerError?;
     private writeTimeoutMs;
-    private exitFlushTimeoutMs;
+    private flushTimeoutMs;
     private _exiting;
-    private namespaceFilter?;
+    private scopeFilter?;
     /** True for loggers created via `scope`/`child` (share the parent's plumbing). */
     private isChild;
     /** Cached peer process level. When set, takes precedence over local `level` in `getLevel()`. */
@@ -209,6 +211,8 @@ export declare class Logger implements LoggerMethods {
     trace: LogFn;
     debug: LogFn;
     info: LogFn;
+    /** Alias for {@link info}. */
+    log: LogFn;
     warn: LogFn;
     error: LogFn;
     fatal: LogFn;
@@ -241,7 +245,7 @@ export declare class Logger implements LoggerMethods {
      * exit the process) without risking a hang on a stalled transport.
      */
     private flushWithTimeout;
-    /** Set the max time (ms) to flush on process exit before giving up. */
+    /** Set the max time (ms) to flush before process exit before giving up. */
     setExitFlushTimeout(ms: number): this;
     /** Get the current exit-flush timeout (ms). */
     getExitFlushTimeout(): number;

package/dist/cjs/core/logger.d.ts.map

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

package/dist/cjs/core/logger.js

@@ -32,6 +32,15 @@ function isoFromMs(ms) {
     TIME_DATE.setTime(ms);
     return `${pad(TIME_DATE.getUTCFullYear(), 4)}-${pad(TIME_DATE.getUTCMonth() + 1, 2)}-${pad(TIME_DATE.getUTCDate(), 2)}T${pad(TIME_DATE.getUTCHours(), 2)}:${pad(TIME_DATE.getUTCMinutes(), 2)}:${pad(TIME_DATE.getUTCSeconds(), 2)}.${pad(TIME_DATE.getUTCMilliseconds(), 3)}Z`;
 }
+/** Cache compiled namespace filters by normalized input to avoid recompiling regexes on every call. */
+const nsFilterCache = new Map();
+function serializeNsInput(input) {
+    if (!input)
+        return '';
+    if (Array.isArray(input))
+        return input.join(',');
+    return input;
+}
 function escapeRegex(s) {
     return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
@@ -48,22 +57,34 @@ function toPattern(token) {
  * `undefined` (no filtering).
  */
 function compileNamespaceFilter(input) {
-    if (!input || (Array.isArray(input) && input.length === 0))
-        return undefined;
-    const tokens = (Array.isArray(input) ? input : input.split(/[ ,]+/))
-        .map((t) => t.trim())
-        .filter(Boolean);
-    if (tokens.length === 0)
-        return undefined;
-    const includes = [];
-    const excludes = [];
-    for (const token of tokens) {
-        if (token.startsWith('-'))
-            excludes.push(toPattern(token.slice(1)));
-        else
-            includes.push(toPattern(token));
+    const key = serializeNsInput(input);
+    if (nsFilterCache.has(key))
+        return nsFilterCache.get(key);
+    let result;
+    if (!input || (Array.isArray(input) && input.length === 0)) {
+        result = undefined;
+    }
+    else {
+        const tokens = (Array.isArray(input) ? input : input.split(/[ ,]+/))
+            .map((t) => t.trim())
+            .filter(Boolean);
+        if (tokens.length === 0) {
+            result = undefined;
+        }
+        else {
+            const includes = [];
+            const excludes = [];
+            for (const token of tokens) {
+                if (token.startsWith('-'))
+                    excludes.push(toPattern(token.slice(1)));
+                else
+                    includes.push(toPattern(token));
+            }
+            result = { includes, excludes };
+        }
     }
-    return { includes, excludes };
+    nsFilterCache.set(key, result);
+    return result;
 }
 function matchesNamespace(scope, filter) {
     if (!filter)
@@ -106,12 +127,14 @@ function getNodeProcess() {
 class Logger {
     constructor(options = {}) {
         /**
-         * Sequences the async plugin-interception step so entries are processed in
-         * emit order. Transport writes fan out to their own per-transport queues
-         * (see `transportQueues`), so a slow/blocked transport can never stall the
-         * others or this front queue.
+         * Bounded async queue for plugin interception. Tracks in-flight entries so
+         * `flush()` and `destroy()` know when all interceptions are done without
+         * letting the dispatch chain grow unboundedly (each push would append a
+         * `.then()` to an ever-longer Promise chain).
          */
-        this.dispatchQueue = Promise.resolve();
+        this.dispatchInflight = 0;
+        this.dispatchDrain = null;
+        this.dispatchDrainResolve = undefined;
         /** Independent async-write queue per transport. */
         this.transportQueues = new Map();
         this.destroyed = false;
@@ -126,6 +149,8 @@ class Logger {
         this.trace = (message, ...args) => this.emit('trace', message, args);
         this.debug = (message, ...args) => this.emit('debug', message, args);
         this.info = (message, ...args) => this.emit('info', message, args);
+        /** Alias for {@link info}. */
+        this.log = (message, ...args) => this.emit('info', message, args);
         this.warn = (message, ...args) => this.emit('warn', message, args);
         this.error = (message, ...args) => this.emit('error', message, args);
         this.fatal = (message, ...args) => this.emit('fatal', message, args);
@@ -153,11 +178,11 @@ class Logger {
         this.level = (0, types_js_1.normalizeLevel)(levelInput);
         this.originalLevel = this.level;
         this.scopeName = options.scope;
-        const nsInput = options.namespaceFilter ??
-            (options.namespaceEnvVar === null
+        const nsInput = options.scopeFilter ??
+            (options.scopeFilterEnvVar === null
                 ? undefined
-                : readEnvVar(options.namespaceEnvVar ?? 'LOGRAIL_DEBUG'));
-        this.namespaceFilter = compileNamespaceFilter(nsInput);
+                : readEnvVar(options.scopeFilterEnvVar ?? 'LOGRAIL_DEBUG'));
+        this.scopeFilter = compileNamespaceFilter(nsInput);
         // On the Electron main process, receive renderer logs over IPC.
         if (this.runtime.attachReceiver) {
             this.detachReceiver = this.runtime.attachReceiver((entry) => this.ingestEntry(entry));
@@ -169,7 +194,7 @@ class Logger {
             this.attachExitHandlers();
         this.onLoggerError = options.onError;
         this.writeTimeoutMs = options.writeTimeoutMs ?? 5000;
-        this.exitFlushTimeoutMs = options.exitFlushTimeoutMs ?? 2000;
+        this.flushTimeoutMs = options.flushTimeoutMs ?? 2000;
         // Wire the pipeline/plugin error sinks into the unified handler.
         this.pipeline.onError = (err, info) => this.reportError(info.phase, err, info.entry);
         this.plugins.onError = (name, err, entry) => this.reportError('plugin', err, entry, name);
@@ -187,13 +212,13 @@ class Logger {
         this.pipeline = parent.pipeline;
         this.plugins = parent.plugins;
         this.transports = parent.transports;
-        this.namespaceFilter = parent.namespaceFilter;
+        this.scopeFilter = parent.scopeFilter;
         this.context = opts.context ?? (0, index_js_3.createContextStore)();
         this.scopeName = opts.scope;
         // Only a root logger owns the shared plugin error sink; children inherit it.
         this.onLoggerError = parent.onLoggerError;
         this.writeTimeoutMs = parent.writeTimeoutMs;
-        this.exitFlushTimeoutMs = parent.exitFlushTimeoutMs;
+        this.flushTimeoutMs = parent.flushTimeoutMs;
         if (opts.levelOverride !== undefined)
             this.levelOverride = opts.levelOverride;
     }
@@ -207,7 +232,7 @@ class Logger {
             return;
         if (entry.level < this.getLevel())
             return;
-        if (!matchesNamespace(entry.scope, this.namespaceFilter))
+        if (!matchesNamespace(entry.scope, this.scopeFilter))
             return;
         this.dispatch(entry);
     }
@@ -258,9 +283,22 @@ class Logger {
     }
     removeTransport(name) {
         const removed = this.transports.filter((t) => t.name === name);
-        for (const t of removed)
-            this.transportQueues.delete(t);
         this.transports = this.transports.filter((t) => t.name !== name);
+        for (const transport of removed) {
+            const prev = this.transportQueues.get(transport) ?? Promise.resolve();
+            const teardown = prev
+                .then(async () => {
+                if (transport.flush)
+                    await this.guardFlush(transport.flush.bind(transport));
+                if (transport.close)
+                    await Promise.resolve(transport.close());
+            })
+                .catch((err) => this.reportError('transport', err, undefined, transport.name))
+                .finally(() => {
+                this.transportQueues.delete(transport);
+            });
+            this.transportQueues.set(transport, teardown);
+        }
     }
     /** Unregister a plugin by name at runtime. */
     unregisterPlugin(name) {
@@ -348,7 +386,7 @@ class Logger {
         const levelValue = types_js_1.LOG_LEVELS[levelName];
         if (levelValue < this.getLevel())
             return;
-        if (!matchesNamespace(this.scopeName, this.namespaceFilter))
+        if (!matchesNamespace(this.scopeName, this.scopeFilter))
             return;
         const entry = this.buildEntry(levelName, levelValue, message, args);
         const processed = this.pipeline.process(entry);
@@ -364,13 +402,29 @@ class Logger {
      */
     dispatch(entry) {
         if (this.plugins.hasEntryInterceptors()) {
-            const p = this.plugins.intercept(entry).then((intercepted) => {
+            // Create or reset the drain promise eagerly so that `flush()` callers
+            // always have a non-null promise to await, even if they arrive before
+            // the current batch of in-flight interceptions completes.
+            this.dispatchDrain = new Promise((resolve) => {
+                this.dispatchDrainResolve = resolve;
+            });
+            this.dispatchInflight++;
+            this.plugins
+                .intercept(entry)
+                .then((intercepted) => {
                 if (intercepted)
                     this.writeToTransports(intercepted);
+            })
+                .catch((err) => this.reportError('plugin', err))
+                .finally(() => {
+                this.dispatchInflight--;
+                if (this.dispatchInflight === 0) {
+                    const resolve = this.dispatchDrainResolve;
+                    this.dispatchDrain = null;
+                    this.dispatchDrainResolve = undefined;
+                    resolve?.();
+                }
             });
-            this.dispatchQueue = this.dispatchQueue
-                .then(() => p)
-                .catch((err) => this.reportError('plugin', err));
             return;
         }
         this.writeToTransports(entry);
@@ -416,7 +470,9 @@ class Logger {
             rest = [message, ...args];
         }
         if (!error) {
-            error = rest.find((a) => a instanceof Error);
+            error =
+                rest.find((a) => a instanceof Error) ??
+                    rest.find((a) => typeof a === 'string' && a.length > 0);
         }
         const now = this.runtime.now();
         const ts = typeof now === 'number' ? now : new Date(now).getTime();
@@ -503,7 +559,7 @@ class Logger {
     }
     /** Await a transport's async `flush`, but never let it stall teardown. */
     guardFlush(p) {
-        if (!this.writeTimeoutMs)
+        if (!this.flushTimeoutMs)
             return Promise.resolve();
         const result = p();
         if (!result || typeof result.then !== 'function')
@@ -521,7 +577,8 @@ class Logger {
     async flush() {
         // Let in-flight interception finish so every scheduled write has been
         // enqueued onto its transport's own queue.
-        await this.dispatchQueue;
+        if (this.dispatchInflight > 0)
+            await this.dispatchDrain;
         // Aggregate all per-transport async-write queues. `allSettled` means a
         // rejected/errored transport queue never rejects flush; a stalled one is
         // bounded by `writeTimeoutMs` via `guardWrite`.
@@ -552,15 +609,15 @@ class Logger {
             this.flush().then(done, done);
         });
     }
-    /** Set the max time (ms) to flush on process exit before giving up. */
+    /** Set the max time (ms) to flush before process exit before giving up. */
     setExitFlushTimeout(ms) {
         if (Number.isFinite(ms) && ms >= 0)
-            this.exitFlushTimeoutMs = ms;
+            this.flushTimeoutMs = ms;
         return this;
     }
     /** Get the current exit-flush timeout (ms). */
     getExitFlushTimeout() {
-        return this.exitFlushTimeoutMs;
+        return this.flushTimeoutMs;
     }
     // ---- Process integration ----
     /**
@@ -577,7 +634,7 @@ class Logger {
         // adapters that don't supply lifecycle hooks (e.g. custom test runtimes).
         const lc = this.runtime.lifecycle;
         if (lc) {
-            const ms = this.exitFlushTimeoutMs;
+            const ms = this.flushTimeoutMs;
             const detach = lc.onFlushBeforeExit(() => {
                 void this.flushWithTimeout(ms);
             });
@@ -592,7 +649,7 @@ class Logger {
         const proc = getNodeProcess();
         if (!proc)
             return;
-        const ms = this.exitFlushTimeoutMs;
+        const ms = this.flushTimeoutMs;
         // On normal exit the event loop is about to empty: flush pending writes.
         // `beforeExit` re-fires as long as async writes keep the loop alive, so the
         // queue keeps draining until empty (bounded by `ms` if a sink stalls).
@@ -619,6 +676,14 @@ class Logger {
         proc.on('beforeExit', onBeforeExit);
         proc.on('SIGINT', onSigInt);
         proc.on('SIGTERM', onSigTerm);
+        // Windows does not emit `SIGTERM`. Register `SIGBREAK` (Ctrl+Break) as a
+        // best-effort fallback so `autoFlushOnExit` has a signal hook on that
+        // platform. In practice taskkill / OS shutdown kills without emitting any
+        // Node signal, so no handler can cover that path — the `beforeExit` hook
+        // is the only portable shutdown flush mechanism.
+        if (process.platform === 'win32') {
+            proc.on('SIGBREAK', onSigInt);
+        }
         this.processHandlersAttached = true;
         const prev = this.removeProcessHandlers;
         this.removeProcessHandlers = () => {
@@ -643,7 +708,7 @@ class Logger {
         // fall back to the direct `process` binding below, which is a no-op there.
         const lc = this.runtime.lifecycle;
         if (lc?.onUncaughtError) {
-            const ms = this.exitFlushTimeoutMs;
+            const ms = this.flushTimeoutMs;
             const detach = lc.onUncaughtError((err) => {
                 this.fatal(err);
                 return this.flushWithTimeout(ms);
@@ -661,11 +726,11 @@ class Logger {
             return;
         const onUncaught = (err) => {
             this.fatal(err);
-            void this.flushWithTimeout(this.exitFlushTimeoutMs).finally(() => proc.exit(1));
+            void this.flushWithTimeout(this.flushTimeoutMs).finally(() => proc.exit(1));
         };
         const onRejection = (reason) => {
             this.fatal(reason);
-            void this.flushWithTimeout(this.exitFlushTimeoutMs).finally(() => proc.exit(1));
+            void this.flushWithTimeout(this.flushTimeoutMs).finally(() => proc.exit(1));
         };
         proc.on('uncaughtException', onUncaught);
         proc.on('unhandledRejection', onRejection);
@@ -730,7 +795,7 @@ class Logger {
         // Flush pending writes before tearing down transports, so buffered logs
         // are not lost. Bounded by the exit-flush timeout so a stalled sink can
         // never hang teardown.
-        await this.flushWithTimeout(this.exitFlushTimeoutMs).catch(() => { });
+        await this.flushWithTimeout(this.flushTimeoutMs).catch(() => { });
         await this.plugins.destroy().catch(() => { });
         this.detachReceiver?.();
         this.peerLevel = undefined;
@@ -744,7 +809,9 @@ class Logger {
             }
         }
         this.transportQueues.clear();
-        this.dispatchQueue = Promise.resolve();
+        this.dispatchInflight = 0;
+        this.dispatchDrain = null;
+        this.dispatchDrainResolve = undefined;
     }
 }
 exports.Logger = Logger;