lograil 0.1.0 → 0.1.4

package/dist/cjs/types.d.ts

@@ -8,9 +8,12 @@ export type LogLevelName = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fata
 export type LogLevelValue = number;
 /**
  * Ordered by severity. Higher value means more severe.
+ * @internal
  */
 export declare const LOG_LEVELS: Record<LogLevelName, LogLevelValue>;
+/** @internal */
 export declare const LOG_LEVEL_NAMES: LogLevelName[];
+/** @internal */
 export declare function isLogLevelName(value: unknown): value is LogLevelName;
 /**
  * A single structured log record produced by the Logger.
@@ -35,7 +38,10 @@ export interface LogEntry {
     message: string;
     /** Extra positional arguments passed to the log call. */
     args: unknown[];
-    /** Epoch milliseconds when the entry was created. */
+    /**
+     * Epoch milliseconds when the entry was created. Internal — prefer `time`
+     * (ISO string) for display.
+     */
     timestamp: number;
     /** Coarse ISO timestamp for display / serialization. */
     time: string;
@@ -47,26 +53,31 @@ export interface LogEntry {
     context: Record<string, unknown>;
     /** One-off metadata attached to this entry only. */
     metadata: Record<string, unknown>;
-    /** Error object when the entry was created from one. */
-    error?: Error;
+    /** Error-like object when the entry was created from one. Supports both
+     * standard `Error` instances and arbitrary values (e.g. string messages) so
+     * callers can log non-Error exceptions without type casting. */
+    error?: unknown;
 }
 export type LogFn = (message: unknown, ...args: unknown[]) => void;
 export interface LoggerMethods {
     trace: LogFn;
     debug: LogFn;
     info: LogFn;
+    /** Alias for {@link info}. */
+    log: LogFn;
     warn: LogFn;
     error: LogFn;
     fatal: LogFn;
 }
 export type LogLevelInput = LogLevelName | LogLevelValue;
+/** @internal */
 export declare function normalizeLevel(input: LogLevelInput): LogLevelValue;
-/** Cross-process command sent over IPC to change log level. */
+/** @internal Cross-process command sent over IPC to change log level. */
 export interface LogLevelCommand {
     __lograilCmd: true;
     __lograilCmdType: 'setLevel';
     level: LogLevelName | LogLevelValue;
 }
-/** Returns true when the value is a {@link LogLevelCommand}. */
+/** @internal Returns true when the value is a {@link LogLevelCommand}. */
 export declare function isLogLevelCommand(value: unknown): value is LogLevelCommand;
 //# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,aAAa,CAO1D,CAAC;AAEF,eAAO,MAAM,eAAe,EAA8B,YAAY,EAAE,CAAC;AAEzE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,QAAQ;IACvB,gDAAgD;IAChD,KAAK,EAAE,aAAa,CAAC;IACrB,iCAAiC;IACjC,SAAS,EAAE,YAAY,CAAC;IACxB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,wDAAwD;IACxD,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzD,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CASlE;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,IAAI,CAAC;IACnB,gBAAgB,EAAE,UAAU,CAAC;IAC7B,KAAK,EAAE,YAAY,GAAG,aAAa,CAAC;CACrC;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,aAAa,CAO1D,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,eAAe,EAA8B,YAAY,EAAE,CAAC;AAEzE,gBAAgB;AAChB,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,QAAQ;IACvB,gDAAgD;IAChD,KAAK,EAAE,aAAa,CAAC;IACrB,iCAAiC;IACjC,SAAS,EAAE,YAAY,CAAC;IACxB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;oEAEgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,8BAA8B;IAC9B,GAAG,EAAE,KAAK,CAAC;IACX,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzD,gBAAgB;AAChB,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CASlE;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,IAAI,CAAC;IACnB,gBAAgB,EAAE,UAAU,CAAC;IAC7B,KAAK,EAAE,YAAY,GAAG,aAAa,CAAC;CACrC;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E"}

package/dist/cjs/types.js

@@ -12,6 +12,7 @@ exports.normalizeLevel = normalizeLevel;
 exports.isLogLevelCommand = isLogLevelCommand;
 /**
  * Ordered by severity. Higher value means more severe.
+ * @internal
  */
 exports.LOG_LEVELS = {
     trace: 10,
@@ -21,10 +22,13 @@ exports.LOG_LEVELS = {
     error: 50,
     fatal: 60,
 };
+/** @internal */
 exports.LOG_LEVEL_NAMES = Object.keys(exports.LOG_LEVELS);
+/** @internal */
 function isLogLevelName(value) {
     return typeof value === 'string' && value in exports.LOG_LEVELS;
 }
+/** @internal */
 function normalizeLevel(input) {
     if (typeof input === 'number') {
         return input;
@@ -35,7 +39,7 @@ function normalizeLevel(input) {
     }
     return value;
 }
-/** Returns true when the value is a {@link LogLevelCommand}. */
+/** @internal Returns true when the value is a {@link LogLevelCommand}. */
 function isLogLevelCommand(value) {
     return (typeof value === 'object' &&
         value !== null &&

package/dist/cjs/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAoBH,wCAEC;AAsDD,wCASC;AAUD,8CAOC;AAhGD;;GAEG;AACU,QAAA,UAAU,GAAwC;IAC7D,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC;AAEW,QAAA,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAU,CAAmB,CAAC;AAEzE,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,kBAAU,CAAC;AAC1D,CAAC;AAsDD,SAAgB,cAAc,CAAC,KAAoB;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,kBAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AASD,gEAAgE;AAChE,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,YAAY,KAAK,IAAI;QACvD,KAAiC,CAAC,gBAAgB,KAAK,UAAU,CACnE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAuBH,wCAEC;AA8DD,wCASC;AAUD,8CAOC;AA3GD;;;GAGG;AACU,QAAA,UAAU,GAAwC;IAC7D,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,gBAAgB;AACH,QAAA,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAU,CAAmB,CAAC;AAEzE,gBAAgB;AAChB,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,kBAAU,CAAC;AAC1D,CAAC;AA6DD,gBAAgB;AAChB,SAAgB,cAAc,CAAC,KAAoB;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,kBAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AASD,0EAA0E;AAC1E,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,YAAY,KAAK,IAAI;QACvD,KAAiC,CAAC,gBAAgB,KAAK,UAAU,CACnE,CAAC;AACJ,CAAC"}

package/dist/esm/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/esm/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/esm/context/async-context.browser.js

@@ -4,6 +4,9 @@
  * 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({});
 export const asyncContext = {
     run(fn, _context) {
         return fn();
@@ -12,7 +15,7 @@ export const asyncContext = {
         return fn();
     },
     get() {
-        return {};
+        return EMPTY_AMBIENT;
     },
     supported() {
         return false;

package/dist/esm/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":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,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,MAAM,UAAU,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":"AAEA;;;;;GAKG;AACH,4EAA4E;AAC5E,uEAAuE;AACvE,MAAM,aAAa,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,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,MAAM,UAAU,cAAc,CAAI,EAAW,EAAE,QAAwB;IACrE,OAAO,EAAE,EAAE,CAAC;AACd,CAAC"}

package/dist/esm/context/context.js

@@ -27,7 +27,7 @@ export 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/esm/context/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/context/context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAA4B,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,uDAAuD;AACvD,MAAM,UAAU,aAAa,CAAC,CAA0B;IACtD,KAAK,MAAM,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,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;AAiBH,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAA4B,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,uDAAuD;AACvD,MAAM,UAAU,aAAa,CAAC,CAA0B;IACtD,KAAK,MAAM,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,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/esm/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/esm/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/esm/core/logger.js

@@ -29,6 +29,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, '\\$&');
 }
@@ -45,22 +54,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)
@@ -103,12 +124,14 @@ function getNodeProcess() {
 export 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;
@@ -123,6 +146,8 @@ export 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);
@@ -150,11 +175,11 @@ export class Logger {
         this.level = 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));
@@ -166,7 +191,7 @@ export 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);
@@ -184,13 +209,13 @@ export 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 ?? 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;
     }
@@ -204,7 +229,7 @@ export 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);
     }
@@ -255,9 +280,22 @@ export 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) {
@@ -345,7 +383,7 @@ export class Logger {
         const levelValue = 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);
@@ -361,13 +399,29 @@ export 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);
@@ -413,7 +467,9 @@ export 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();
@@ -500,7 +556,7 @@ export 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')
@@ -518,7 +574,8 @@ export 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`.
@@ -549,15 +606,15 @@ export 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 ----
     /**
@@ -574,7 +631,7 @@ export 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);
             });
@@ -589,7 +646,7 @@ export 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).
@@ -616,6 +673,14 @@ export 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 = () => {
@@ -640,7 +705,7 @@ export 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);
@@ -658,11 +723,11 @@ export 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);
@@ -727,7 +792,7 @@ export 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;
@@ -741,7 +806,9 @@ export class Logger {
             }
         }
         this.transportQueues.clear();
-        this.dispatchQueue = Promise.resolve();
+        this.dispatchInflight = 0;
+        this.dispatchDrain = null;
+        this.dispatchDrainResolve = undefined;
     }
 }
 //# sourceMappingURL=logger.js.map