logixia 1.13.3 → 2.0.0

package/dist/logitron-logger-BFDSO8Io.d.mts

@@ -0,0 +1,257 @@
+import { b as LoggerWithLevels, f as ILogger, h as LogEntry, p as ILoggerDefault, v as LogLevelString, x as NamespaceLevels, y as LoggerConfig } from "./index-3mw5gaCw.mjs";
+
+//#region src/plugin.d.ts
+
+interface LogixiaPlugin {
+  /**
+   * Unique plugin name.
+   * logixia uses this to prevent duplicate registration of the same plugin
+   * on the same logger instance.
+   */
+  name: string;
+  /**
+   * Called once immediately after `logger.use(plugin)` is called.
+   * Use for one-time setup (open connections, allocate buffers, etc.).
+   * Async `onInit` errors are silently swallowed to avoid blocking the logger.
+   */
+  onInit?(): void | Promise<void>;
+  /**
+   * Called for every log entry **after** PII redaction and **before** transport
+   * dispatch. Plugins run in registration order; each receives the (possibly
+   * modified) output of the previous plugin.
+   *
+   * - Return the entry (modified or unchanged) to continue processing.
+   * - Return `null` to **drop** the entry — no transport will receive it.
+   *
+   * Errors thrown inside `onLog` are swallowed so a buggy plugin cannot crash
+   * logging; the chain continues with the previous (un-transformed) entry.
+   */
+  onLog?(entry: LogEntry): LogEntry | null | Promise<LogEntry | null>;
+  /**
+   * Called when a transport write fails (after any configured retries).
+   * Useful for routing transport errors to an alerting or metrics system.
+   * Errors thrown inside `onError` are silently swallowed.
+   */
+  onError?(error: Error, entry?: LogEntry): void | Promise<void>;
+  /**
+   * Called when the logger is closed via `logger.close()` or the process
+   * receives a shutdown signal (when `gracefulShutdown` is enabled).
+   * Errors thrown inside `onShutdown` are silently swallowed.
+   */
+  onShutdown?(): void | Promise<void>;
+}
+/**
+ * Holds an ordered list of `LogixiaPlugin` instances and dispatches lifecycle
+ * events to them. One registry is created per logger instance; a global
+ * singleton is also exported for process-wide registration.
+ */
+declare class PluginRegistry {
+  private readonly _plugins;
+  /**
+   * Register a plugin. Silently skips if a plugin with the same `name` is
+   * already registered on this registry.
+   */
+  register(plugin: LogixiaPlugin): void;
+  /** Remove a previously registered plugin by name. No-op if not found. */
+  unregister(name: string): void;
+  /** Returns `true` if a plugin with the given name is registered. */
+  has(name: string): boolean;
+  /** Number of currently registered plugins. */
+  get size(): number;
+  /**
+   * Run all `onLog` hooks in order.
+   * Returns `null` if any plugin cancels the entry; otherwise returns the
+   * (possibly transformed) entry.
+   */
+  runOnLog(entry: LogEntry): Promise<LogEntry | null>;
+  /**
+   * Notify all `onError` hooks.
+   * Errors thrown inside hooks are swallowed to prevent error cascades.
+   */
+  runOnError(error: Error, entry?: LogEntry): Promise<void>;
+  /** Run all `onShutdown` hooks concurrently. Hook errors are swallowed. */
+  runOnShutdown(): Promise<void>;
+}
+/**
+ * Module-level singleton registry.
+ *
+ * Plugins registered here are automatically copied into every **new** logger
+ * instance created after the registration. Already-created loggers are not
+ * retroactively affected — use `logger.use(plugin)` for per-instance control.
+ */
+declare const globalPluginRegistry: PluginRegistry;
+/**
+ * Register a plugin in the global registry so it applies to every future
+ * logger instance.
+ *
+ * @example
+ * ```ts
+ * import { usePlugin } from 'logixia';
+ *
+ * usePlugin({
+ *   name: 'audit-sink',
+ *   onLog(entry) {
+ *     if (entry.level === 'error') auditQueue.push(entry);
+ *     return entry;
+ *   },
+ * });
+ * ```
+ */
+declare function usePlugin(plugin: LogixiaPlugin): void;
+//#endregion
+//#region src/core/logitron-logger.d.ts
+declare class LogixiaLogger<TConfig extends LoggerConfig<Record<string, number>> = LoggerConfig> implements ILoggerDefault {
+  [K: string]: any;
+  private config;
+  private context?;
+  private timers;
+  private contextData;
+  private transportManager;
+  private fieldState;
+  /** Stable fallback trace ID generated ONCE per logger instance. */
+  private readonly fallbackTraceId;
+  /** Numeric value for each known log level — built once, read on every log call. */
+  private _levelValues;
+  /** Numeric threshold for the currently active log level. */
+  private _minLevelValue;
+  /** `source=value` pairs already reported as unknown levels — warn once per logger. */
+  private readonly _warnedInvalidLevels;
+  /** Pre-built ANSI color codes to avoid recreating the object in colorize(). */
+  private _colorMap;
+  /** Pre-computed field-enabled booleans so isFieldEnabled() isn't called per log. */
+  private _fieldCache;
+  /** True when contextData is non-empty — avoids Object.keys() check on hot path. */
+  private _hasContextData;
+  /**
+   * Pre-computed `[INFO] `, `[WARN] ` etc. strings — avoids a colorize() call per log.
+   * Key: lowercase level name. Value: formatted bracket string ready to concatenate.
+   */
+  private _formattedLevels;
+  /** Pre-computed `[appName] ` string — avoids template literal allocation per log. */
+  private _formattedAppName;
+  /** True when a redact config is present — short-circuits applyRedaction when false. */
+  private _hasRedact;
+  /** Sampling engine — only created when sampling config is present. */
+  private _sampler;
+  /** Per-instance plugin registry — also inherits from the global registry at creation time. */
+  private readonly _pluginRegistry;
+  /** Set on loggers created by child(); they borrow the root's transports, sampler and plugins. */
+  private readonly _parent;
+  constructor(config: TConfig, context?: string, parent?: LogixiaLogger<TConfig>);
+  private setupGracefulShutdown;
+  private createCustomLevelMethods;
+  /**
+   * Rebuild all hot-path caches after any config mutation or level change.
+   * Keeps the actual log() call free of allocations in the common case.
+   */
+  private _buildPerfCaches;
+  error(messageOrError: string | Error, data?: Record<string, unknown>): Promise<void>;
+  warn(message: string, data?: Record<string, unknown>): Promise<void>;
+  info(message: string, data?: Record<string, unknown>): Promise<void>;
+  debug(message: string, data?: Record<string, unknown>): Promise<void>;
+  trace(message: string, data?: Record<string, unknown>): Promise<void>;
+  verbose(message: string, data?: Record<string, unknown>): Promise<void>;
+  logLevel(level: string, message: string, data?: Record<string, unknown>): Promise<void>;
+  time(label: string): void;
+  timeEnd(label: string): Promise<number | undefined>;
+  timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T>;
+  setLevel(level: LogLevelString): void;
+  getLevel(): LogLevelString;
+  private _validLevelList;
+  /**
+   * Canonicalise a level from config/ENV. Unknown values return undefined so the
+   * caller falls through to the next source, and warn once per logger per source.
+   */
+  private _validLevel;
+  /**
+   * Replace the per-namespace level map at runtime — no restart needed.
+   *
+   * This is the runtime counterpart to the `namespaceLevels` config option and
+   * the most-requested logging feature across the Winston/Pino issue trackers
+   * (flip a module's verbosity live to chase a bug without raising global
+   * volume). The new map fully replaces the previous one.
+   *
+   * @example
+   * ```ts
+   * // Turn on debug for the DB layer only, live:
+   * logger.setNamespaceLevels({ 'db.*': 'debug', '*': 'info' });
+   * ```
+   */
+  setNamespaceLevels(levels: NamespaceLevels): void;
+  /** Merge entries into the existing per-namespace level map at runtime. */
+  patchNamespaceLevels(levels: NamespaceLevels): void;
+  /** Return a copy of the current per-namespace level map. */
+  getNamespaceLevels(): NamespaceLevels;
+  setContext(context: string): void;
+  getContext(): string | undefined;
+  enableField(fieldName: string): void;
+  disableField(fieldName: string): void;
+  isFieldEnabled(fieldName: string): boolean;
+  getFieldState(): Record<string, boolean>;
+  resetFieldState(): void;
+  /** @deprecated No-op. Library code never prompts on stdin; use setTransportLevels(). */
+  enableTransportLevelPrompting(): void;
+  /** @deprecated No-op. */
+  disableTransportLevelPrompting(): void;
+  setTransportLevels(transportId: string, levels: string[]): void;
+  getTransportLevels(transportId: string): string[] | undefined;
+  clearTransportLevelPreferences(): void;
+  getAvailableTransports(): string[];
+  child(context: string, data?: Record<string, unknown>): ILogger;
+  /**
+   * Register a plugin on this logger instance.
+   *
+   * @example
+   * ```ts
+   * logger.use({
+   *   name: 'audit',
+   *   onLog(entry) { auditQueue.push(entry); return entry; },
+   * });
+   * ```
+   */
+  use(plugin: LogixiaPlugin): this;
+  /**
+   * Remove a previously registered plugin by name.
+   * No-op if the plugin is not registered on this instance.
+   */
+  unuse(pluginName: string): this;
+  flush(): Promise<void>;
+  healthCheck(): Promise<{
+    healthy: boolean;
+    details: Record<string, unknown>;
+  }>;
+  close(): Promise<void>;
+  private log;
+  /**
+   * Hot-path level check: a single Map lookup + integer compare.
+   * The level map and threshold are pre-built in _buildPerfCaches().
+   */
+  private shouldLog;
+  /**
+   * Feature 3: Resolve the effective log level for this logger instance.
+   *
+   * Priority:
+   *  1. ENV `LOGIXIA_LEVEL_<NS_UPPER>` (e.g. LOGIXIA_LEVEL_DB for ns "db" or "db.queries")
+   *  2. Matching `namespaceLevels` config entry (longer pattern = more specific, wins)
+   *  3. Global `LOGIXIA_LEVEL` ENV override
+   *  4. `levelOptions.level` (resolved via Feature 5 in constructor)
+   */
+  private resolveEffectiveLevel;
+  private formatLog;
+  private colorize;
+  /**
+   * Dispatch the entry to transports (each formats itself). Returns `void` when
+   * the write completes synchronously (console-only hot path) and a Promise only
+   * when a transport is genuinely async — so the caller awaits only when needed.
+   * Formatting for the no-transport fallback is done lazily, never on the
+   * transport path.
+   */
+  private output;
+  /** Shared transport-failure handler: log internally, notify plugins, then fall
+   * back to a direct stdout/stderr write so the entry is never lost. */
+  private _handleOutputError;
+}
+declare function createLogger<T extends LoggerConfig<Record<string, number>>>(config: T, context?: string): LoggerWithLevels<T>;
+//#endregion
+export { globalPluginRegistry as a, PluginRegistry as i, createLogger as n, usePlugin as o, LogixiaPlugin as r, LogixiaLogger as t };
+//# sourceMappingURL=logitron-logger-BFDSO8Io.d.mts.map

package/dist/logitron-logger-BFDSO8Io.d.mts.map

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

package/dist/logitron-logger-UVeN-mQm.d.ts

@@ -0,0 +1,257 @@
+import { b as LoggerWithLevels, f as ILogger, h as LogEntry, p as ILoggerDefault, v as LogLevelString, x as NamespaceLevels, y as LoggerConfig } from "./index-DhIoploR.js";
+
+//#region src/plugin.d.ts
+
+interface LogixiaPlugin {
+  /**
+   * Unique plugin name.
+   * logixia uses this to prevent duplicate registration of the same plugin
+   * on the same logger instance.
+   */
+  name: string;
+  /**
+   * Called once immediately after `logger.use(plugin)` is called.
+   * Use for one-time setup (open connections, allocate buffers, etc.).
+   * Async `onInit` errors are silently swallowed to avoid blocking the logger.
+   */
+  onInit?(): void | Promise<void>;
+  /**
+   * Called for every log entry **after** PII redaction and **before** transport
+   * dispatch. Plugins run in registration order; each receives the (possibly
+   * modified) output of the previous plugin.
+   *
+   * - Return the entry (modified or unchanged) to continue processing.
+   * - Return `null` to **drop** the entry — no transport will receive it.
+   *
+   * Errors thrown inside `onLog` are swallowed so a buggy plugin cannot crash
+   * logging; the chain continues with the previous (un-transformed) entry.
+   */
+  onLog?(entry: LogEntry): LogEntry | null | Promise<LogEntry | null>;
+  /**
+   * Called when a transport write fails (after any configured retries).
+   * Useful for routing transport errors to an alerting or metrics system.
+   * Errors thrown inside `onError` are silently swallowed.
+   */
+  onError?(error: Error, entry?: LogEntry): void | Promise<void>;
+  /**
+   * Called when the logger is closed via `logger.close()` or the process
+   * receives a shutdown signal (when `gracefulShutdown` is enabled).
+   * Errors thrown inside `onShutdown` are silently swallowed.
+   */
+  onShutdown?(): void | Promise<void>;
+}
+/**
+ * Holds an ordered list of `LogixiaPlugin` instances and dispatches lifecycle
+ * events to them. One registry is created per logger instance; a global
+ * singleton is also exported for process-wide registration.
+ */
+declare class PluginRegistry {
+  private readonly _plugins;
+  /**
+   * Register a plugin. Silently skips if a plugin with the same `name` is
+   * already registered on this registry.
+   */
+  register(plugin: LogixiaPlugin): void;
+  /** Remove a previously registered plugin by name. No-op if not found. */
+  unregister(name: string): void;
+  /** Returns `true` if a plugin with the given name is registered. */
+  has(name: string): boolean;
+  /** Number of currently registered plugins. */
+  get size(): number;
+  /**
+   * Run all `onLog` hooks in order.
+   * Returns `null` if any plugin cancels the entry; otherwise returns the
+   * (possibly transformed) entry.
+   */
+  runOnLog(entry: LogEntry): Promise<LogEntry | null>;
+  /**
+   * Notify all `onError` hooks.
+   * Errors thrown inside hooks are swallowed to prevent error cascades.
+   */
+  runOnError(error: Error, entry?: LogEntry): Promise<void>;
+  /** Run all `onShutdown` hooks concurrently. Hook errors are swallowed. */
+  runOnShutdown(): Promise<void>;
+}
+/**
+ * Module-level singleton registry.
+ *
+ * Plugins registered here are automatically copied into every **new** logger
+ * instance created after the registration. Already-created loggers are not
+ * retroactively affected — use `logger.use(plugin)` for per-instance control.
+ */
+declare const globalPluginRegistry: PluginRegistry;
+/**
+ * Register a plugin in the global registry so it applies to every future
+ * logger instance.
+ *
+ * @example
+ * ```ts
+ * import { usePlugin } from 'logixia';
+ *
+ * usePlugin({
+ *   name: 'audit-sink',
+ *   onLog(entry) {
+ *     if (entry.level === 'error') auditQueue.push(entry);
+ *     return entry;
+ *   },
+ * });
+ * ```
+ */
+declare function usePlugin(plugin: LogixiaPlugin): void;
+//#endregion
+//#region src/core/logitron-logger.d.ts
+declare class LogixiaLogger<TConfig extends LoggerConfig<Record<string, number>> = LoggerConfig> implements ILoggerDefault {
+  [K: string]: any;
+  private config;
+  private context?;
+  private timers;
+  private contextData;
+  private transportManager;
+  private fieldState;
+  /** Stable fallback trace ID generated ONCE per logger instance. */
+  private readonly fallbackTraceId;
+  /** Numeric value for each known log level — built once, read on every log call. */
+  private _levelValues;
+  /** Numeric threshold for the currently active log level. */
+  private _minLevelValue;
+  /** `source=value` pairs already reported as unknown levels — warn once per logger. */
+  private readonly _warnedInvalidLevels;
+  /** Pre-built ANSI color codes to avoid recreating the object in colorize(). */
+  private _colorMap;
+  /** Pre-computed field-enabled booleans so isFieldEnabled() isn't called per log. */
+  private _fieldCache;
+  /** True when contextData is non-empty — avoids Object.keys() check on hot path. */
+  private _hasContextData;
+  /**
+   * Pre-computed `[INFO] `, `[WARN] ` etc. strings — avoids a colorize() call per log.
+   * Key: lowercase level name. Value: formatted bracket string ready to concatenate.
+   */
+  private _formattedLevels;
+  /** Pre-computed `[appName] ` string — avoids template literal allocation per log. */
+  private _formattedAppName;
+  /** True when a redact config is present — short-circuits applyRedaction when false. */
+  private _hasRedact;
+  /** Sampling engine — only created when sampling config is present. */
+  private _sampler;
+  /** Per-instance plugin registry — also inherits from the global registry at creation time. */
+  private readonly _pluginRegistry;
+  /** Set on loggers created by child(); they borrow the root's transports, sampler and plugins. */
+  private readonly _parent;
+  constructor(config: TConfig, context?: string, parent?: LogixiaLogger<TConfig>);
+  private setupGracefulShutdown;
+  private createCustomLevelMethods;
+  /**
+   * Rebuild all hot-path caches after any config mutation or level change.
+   * Keeps the actual log() call free of allocations in the common case.
+   */
+  private _buildPerfCaches;
+  error(messageOrError: string | Error, data?: Record<string, unknown>): Promise<void>;
+  warn(message: string, data?: Record<string, unknown>): Promise<void>;
+  info(message: string, data?: Record<string, unknown>): Promise<void>;
+  debug(message: string, data?: Record<string, unknown>): Promise<void>;
+  trace(message: string, data?: Record<string, unknown>): Promise<void>;
+  verbose(message: string, data?: Record<string, unknown>): Promise<void>;
+  logLevel(level: string, message: string, data?: Record<string, unknown>): Promise<void>;
+  time(label: string): void;
+  timeEnd(label: string): Promise<number | undefined>;
+  timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T>;
+  setLevel(level: LogLevelString): void;
+  getLevel(): LogLevelString;
+  private _validLevelList;
+  /**
+   * Canonicalise a level from config/ENV. Unknown values return undefined so the
+   * caller falls through to the next source, and warn once per logger per source.
+   */
+  private _validLevel;
+  /**
+   * Replace the per-namespace level map at runtime — no restart needed.
+   *
+   * This is the runtime counterpart to the `namespaceLevels` config option and
+   * the most-requested logging feature across the Winston/Pino issue trackers
+   * (flip a module's verbosity live to chase a bug without raising global
+   * volume). The new map fully replaces the previous one.
+   *
+   * @example
+   * ```ts
+   * // Turn on debug for the DB layer only, live:
+   * logger.setNamespaceLevels({ 'db.*': 'debug', '*': 'info' });
+   * ```
+   */
+  setNamespaceLevels(levels: NamespaceLevels): void;
+  /** Merge entries into the existing per-namespace level map at runtime. */
+  patchNamespaceLevels(levels: NamespaceLevels): void;
+  /** Return a copy of the current per-namespace level map. */
+  getNamespaceLevels(): NamespaceLevels;
+  setContext(context: string): void;
+  getContext(): string | undefined;
+  enableField(fieldName: string): void;
+  disableField(fieldName: string): void;
+  isFieldEnabled(fieldName: string): boolean;
+  getFieldState(): Record<string, boolean>;
+  resetFieldState(): void;
+  /** @deprecated No-op. Library code never prompts on stdin; use setTransportLevels(). */
+  enableTransportLevelPrompting(): void;
+  /** @deprecated No-op. */
+  disableTransportLevelPrompting(): void;
+  setTransportLevels(transportId: string, levels: string[]): void;
+  getTransportLevels(transportId: string): string[] | undefined;
+  clearTransportLevelPreferences(): void;
+  getAvailableTransports(): string[];
+  child(context: string, data?: Record<string, unknown>): ILogger;
+  /**
+   * Register a plugin on this logger instance.
+   *
+   * @example
+   * ```ts
+   * logger.use({
+   *   name: 'audit',
+   *   onLog(entry) { auditQueue.push(entry); return entry; },
+   * });
+   * ```
+   */
+  use(plugin: LogixiaPlugin): this;
+  /**
+   * Remove a previously registered plugin by name.
+   * No-op if the plugin is not registered on this instance.
+   */
+  unuse(pluginName: string): this;
+  flush(): Promise<void>;
+  healthCheck(): Promise<{
+    healthy: boolean;
+    details: Record<string, unknown>;
+  }>;
+  close(): Promise<void>;
+  private log;
+  /**
+   * Hot-path level check: a single Map lookup + integer compare.
+   * The level map and threshold are pre-built in _buildPerfCaches().
+   */
+  private shouldLog;
+  /**
+   * Feature 3: Resolve the effective log level for this logger instance.
+   *
+   * Priority:
+   *  1. ENV `LOGIXIA_LEVEL_<NS_UPPER>` (e.g. LOGIXIA_LEVEL_DB for ns "db" or "db.queries")
+   *  2. Matching `namespaceLevels` config entry (longer pattern = more specific, wins)
+   *  3. Global `LOGIXIA_LEVEL` ENV override
+   *  4. `levelOptions.level` (resolved via Feature 5 in constructor)
+   */
+  private resolveEffectiveLevel;
+  private formatLog;
+  private colorize;
+  /**
+   * Dispatch the entry to transports (each formats itself). Returns `void` when
+   * the write completes synchronously (console-only hot path) and a Promise only
+   * when a transport is genuinely async — so the caller awaits only when needed.
+   * Formatting for the no-transport fallback is done lazily, never on the
+   * transport path.
+   */
+  private output;
+  /** Shared transport-failure handler: log internally, notify plugins, then fall
+   * back to a direct stdout/stderr write so the entry is never lost. */
+  private _handleOutputError;
+}
+declare function createLogger<T extends LoggerConfig<Record<string, number>>>(config: T, context?: string): LoggerWithLevels<T>;
+//#endregion
+export { globalPluginRegistry as a, PluginRegistry as i, createLogger as n, usePlugin as o, LogixiaPlugin as r, LogixiaLogger as t };
+//# sourceMappingURL=logitron-logger-UVeN-mQm.d.ts.map

package/dist/logitron-logger-UVeN-mQm.d.ts.map

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

package/dist/middleware.d.mts

@@ -1,5 +1,5 @@
-import "./transport.types-CtNr3D7S.mjs";
-import { u as IBaseLogger } from "./index-BPwEisy4.mjs";
+import "./transport.types-BMnurPcc.mjs";
+import { u as IBaseLogger } from "./index-3mw5gaCw.mjs";
 
 //#region src/middleware/http-logger.d.ts
 

package/dist/middleware.d.ts

@@ -1,5 +1,5 @@
-import "./transport.types-DqVLZTyf.js";
-import { u as IBaseLogger } from "./index-nZEeCr3X.js";
+import "./transport.types-CGoHpWQR.js";
+import { u as IBaseLogger } from "./index-DhIoploR.js";
 
 //#region src/middleware/http-logger.d.ts