logxpert 2.1.0 → 2.1.2

package/CHANGELOG.md

@@ -1,20 +1,20 @@
-# Changelog
-
-## Unreleased
-- Fix TS types for dual CJS/ESM: `export =` + namespace in `index.d.ts`, dedicated `index.d.mts` for the ESM entry (`attw` clean)
-- Rename `files` options with backward-compatible aliases: `prefix` (`appName`), `filePattern` (`filename`/`pattern`), `datePattern` (`filesName`/`dateFormat`); `%datePattern%` placeholder; `prefix` + `filePattern` now throws instead of silent precedence
-- Default file `datePattern` is now `YYYY_MM_DD`
-- License changed to `Apache-2.0`
-
-## 2.0.0
-- Replace `moment` with `dayjs`
-- Add ESM entry (`main.mjs`) + `index.d.ts` types
-- Add `log.setLevel/getLevel`, `LOG_LEVEL` env support
-- Add `log.createLogger()` isolated instances and `log.child()`
-- Add structured logging: objects, meta, `Error` stacks, `splat`
-- `files.filename` option, input validation in `settings()`
-- Fix license to `GPL-3.0-only`, add `exports`, `files`, `engines`
-- Add tests (`node --test`) and CI
-
-## 1.0.5
-- Previous CJS-only release with `moment` + `winston`.
+# Changelog
+
+## Unreleased
+- Fix TS types for dual CJS/ESM: `export =` + namespace in `index.d.ts`, dedicated `index.d.mts` for the ESM entry (`attw` clean)
+- Rename `files` options with backward-compatible aliases: `prefix` (`appName`), `filePattern` (`filename`/`pattern`), `datePattern` (`filesName`/`dateFormat`); `%datePattern%` placeholder; `prefix` + `filePattern` now throws instead of silent precedence
+- Default file `datePattern` is now `YYYY_MM_DD`
+- License changed to `Apache-2.0`
+
+## 2.0.0
+- Replace `moment` with `dayjs`
+- Add ESM entry (`main.mjs`) + `index.d.ts` types
+- Add `log.setLevel/getLevel`, `LOG_LEVEL` env support
+- Add `log.createLogger()` isolated instances and `log.child()`
+- Add structured logging: objects, meta, `Error` stacks, `splat`
+- `files.filename` option, input validation in `settings()`
+- Fix license to `GPL-3.0-only`, add `exports`, `files`, `engines`
+- Add tests (`node --test`) and CI
+
+## 1.0.5
+- Previous CJS-only release with `moment` + `winston`.

package/README.md

@@ -1,118 +1,119 @@
-# LogXpert
-
-Colorful console logging for Node.js with optional daily file rotation.
-
-- Zero heavy dependencies — built-in engine.
-- Daily file rotation with retention, size limits and gzip.
-- Per-level colors, lazy messages, child loggers, isolated instances.
-- Works from JS and TS, CommonJS and ESM.
-
-## Installation
-
-```sh
-npm install logxpert
-```
-
-Requires Node.js `>=18`. Recommended minimum: Node.js 22 LTS. See [NODE_SUPPORT.md](NODE_SUPPORT.md) for the full support policy.
-
-## Quick start
-
-```js
-const log = require('logxpert');
-// or: import log from 'logxpert';
-
-log('general message');          // shortcut for info
-log.info('hello', { user: 1 });  // with metadata
-log.error(new Error('boom'));    // Errors print message + stack
-log.debug(() => JSON.stringify(hugeObject)); // lazy: skipped if level disabled
-```
-
-Levels: `error → warn → info → http → verbose → debug → silly` (default `debug`).
-
-```js
-log.setLevel('info'); // or via LOG_LEVEL env variable
-```
-
-## File logging
-
-```js
-log.settings({ files: { folder: 'logs' } });
-// → logs/logxpert-2026_10_08.log (prefix defaults to your package.json name)
-
-log.settings({ files: { folder: 'logs', prefix: 'api' } });
-// → logs/api-2026_10_08.log
-
-// Full control (omit prefix when used):
-log.settings({ files: { folder: 'logs', filePattern: 'app-%datePattern%.log' } });
-```
-
-`%datePattern%` is replaced by the date (`datePattern` defaults to `YYYY_MM_DD`). Combining `prefix` with `filePattern` throws — pick one.
-
-```js
-log.settings({
-  files: {
-    folder: 'logs',
-    runNumber: true,    // off by default → app-2026_10_08-1.log, -2.log, ...
-    maxFile: '14d',     // retention
-    maxSize: '20m',     // rotate above this size
-    zippedArchive: true,
-  },
-});
-log.close(); // call on shutdown
-```
-
-## Console & instances
-
-```js
-log.settings({
-  console: {
-    enableTimestamp: true,
-    timestampFormat: 'YYYY-MM-DD HH:mm:ss',
-    colorize: true,
-    colors: { info: 'blue', error: false }, // names, ANSI 0-255, or false per level
-  },
-});
-
-// Default colors: error red, warn yellow, info green, http magenta,
-// verbose cyan, debug blue, silly gray. Only the [level] tag is colored.
-
-const { createLogger } = require('logxpert');
-const apiLog = createLogger({ level: 'info' }); // independent instance
-
-const child = log.child({ service: 'api' }); // bound context
-```
-
-## Full configuration (copy-paste)
-
-```js
-log.settings({
-  level: 'debug', // or process.env.LOG_LEVEL
-  console: {
-    enableTimestamp: true,
-    timestampFormat: 'YYYY-MM-DD HH:mm:ss',
-    timestampPrefix: '',
-    timestampSuffix: '',
-    colorize: true,
-    colors: { info: 'blue', warn: 208, error: false }
-    // enabled: false, // file-only logging: silence the console
-  },
-  files: {
-    folder: 'logs',
-    prefix: undefined, // defaults to your package.json name
-    // filePattern: 'app-%datePattern%.log', // full control (omit prefix if used)
-    datePattern: 'YYYY_MM_DD',
-    runNumber: false, // or true, or { separator: '-', padding: 0, startAt: 1 }
-    maxFile: '14d',
-    maxSize: '20m',
-    zippedArchive: false,
-  }
-});
-```
-
-Legacy aliases: `appName` (= `prefix`), `filename`/`pattern` (= `filePattern`), `filesName`/`dateFormat` (= `datePattern`).
-
-Security: messages are stripped of ANSI escapes and control characters (except `\n`, `\t`); file patterns escaping the log folder (`..`, absolute paths) are rejected.
-
-## License
-
-Apache-2.0. See [LICENSE](LICENSE).
+# LogXpert
+
+Colorful console logging for Node.js with optional daily file rotation.
+
+- Zero heavy dependencies — built-in engine.
+- Daily file rotation with retention, size limits and gzip.
+- Per-level colors, lazy messages, child loggers, isolated instances.
+- Works from JS and TS, CommonJS and ESM.
+
+## Installation
+
+```sh
+npm install logxpert
+```
+
+Requires Node.js `>=18`. Recommended minimum: Node.js 22 LTS. See [NODE_SUPPORT.md](NODE_SUPPORT.md) for the full support policy.
+
+## Quick start
+
+```js
+const log = require('logxpert');
+// or: import log from 'logxpert';
+
+log('general message');          // shortcut for info
+log.info('hello', { user: 1 });  // with metadata
+log.error(new Error('boom'));    // Errors print message + stack
+log.debug(() => JSON.stringify(hugeObject)); // lazy: skipped if level disabled
+```
+
+Levels: `error → warn → info → http → verbose → debug → silly` (default `debug`).
+
+```js
+log.setLevel('info'); // or via LOG_LEVEL env variable
+```
+
+## File logging
+
+```js
+log.settings({ files: { folder: 'logs' } });
+// → logs/logxpert-2026_10_08.log (prefix defaults to your package.json name)
+
+log.settings({ files: { folder: 'logs', prefix: 'api' } });
+// → logs/api-2026_10_08.log
+
+// Full control (omit prefix when used):
+log.settings({ files: { folder: 'logs', filePattern: 'app-%datePattern%.log' } });
+```
+
+`%datePattern%` is replaced by the date (`datePattern` defaults to `YYYY_MM_DD`). Combining `prefix` with `filePattern` throws — pick one.
+
+```js
+log.settings({
+  files: {
+    folder: 'logs',
+    runNumber: true,    // off by default → app-2026_10_08-1.log, -2.log, ...
+    maxFile: '14d',     // retention
+    maxSize: '20m',     // rotate above this size
+    zippedArchive: true,
+  },
+});
+log.close(); // call on shutdown
+```
+
+## Console & instances
+
+```js
+log.settings({
+  console: {
+    enableTimestamp: true,
+    timestampFormat: 'YYYY-MM-DD HH:mm:ss',
+    colorize: true,
+    colors: { info: 'blue', error: false }, // names, ANSI 0-255, or false per level
+  },
+});
+
+// Default colors: error red, warn yellow, info green, http magenta,
+// verbose cyan, debug blue, silly gray. Only the [level] tag is colored.
+
+const { createLogger } = require('logxpert');
+const apiLog = createLogger({ level: 'info' }); // independent instance
+
+const child = log.child({ service: 'api' }); // bound context
+```
+
+## Full configuration (copy-paste)
+
+```js
+log.settings({
+  level: 'debug', // or process.env.LOG_LEVEL
+  sanitize: true, // strip ANSI escapes and control chars; false = pass through untouched
+  console: {
+    enableTimestamp: true,
+    timestampFormat: 'YYYY-MM-DD HH:mm:ss',
+    timestampPrefix: '',
+    timestampSuffix: '',
+    colorize: true,
+    colors: { info: 'blue', warn: 208, error: false }
+    // enabled: false, // file-only logging: silence the console
+  },
+  files: {
+    folder: 'logs',
+    prefix: undefined, // defaults to your package.json name
+    // filePattern: 'app-%datePattern%.log', // full control (omit prefix if used)
+    datePattern: 'YYYY_MM_DD',
+    runNumber: false, // or true, or { separator: '-', padding: 0, startAt: 1 }
+    maxFile: '14d',
+    maxSize: '20m',
+    zippedArchive: false,
+  }
+});
+```
+
+Legacy aliases: `appName` (= `prefix`), `filename`/`pattern` (= `filePattern`), `filesName`/`dateFormat` (= `datePattern`).
+
+Security: messages are stripped of ANSI escapes and control characters (except `\n`, `\t`); file patterns escaping the log folder (`..`, absolute paths) are rejected.
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE).

package/index.d.ts

@@ -1,83 +1,84 @@
-declare namespace log {
-  export type LogLevel = 'error' | 'warn' | 'info' | 'http' | 'verbose' | 'debug' | 'silly';
-
-  export type LevelColor = string | number | false | null;
-
-  export interface ConsoleOptions {
-    enabled?: boolean;
-    enableTimestamp?: boolean;
-    timestampFormat?: string;
-    timestampPrefix?: string;
-    timestampSuffix?: string;
-    colorize?: boolean;
-    colors?: Partial<Record<LogLevel, LevelColor>>;
-    level?: LogLevel;
-  }
-
-  export interface RunNumberOptions {
-    enabled?: boolean;
-    separator?: string;
-    padding?: number;
-    startAt?: number;
-  }
-
-  export interface FilesOptions {
-    folder?: string;
-    /** Preferred: date format for %DATE%. */
-    datePattern?: string;
-    /** @deprecated Use datePattern. */
-    filesName?: string;
-    dateFormat?: string;
-    /** Preferred: filename template containing %DATE%. */
-    filePattern?: string;
-    pattern?: string;
-    /** @deprecated Use filePattern. */
-    filename?: string;
-    /** Preferred: filename prefix used when no pattern is given. */
-    prefix?: string;
-    /** @deprecated Use prefix. */
-    appName?: string;
-    runNumber?: boolean | RunNumberOptions;
-    maxFile?: string;
-    maxFiles?: string;
-    maxSize?: string;
-    zippedArchive?: boolean;
-    level?: LogLevel;
-  }
-
-  export interface LogSettingsOptions {
-    console?: ConsoleOptions | false;
-    files?: FilesOptions;
-    level?: LogLevel;
-  }
-
-  export interface ChildLogger {
-    error(message: unknown, ...meta: unknown[]): void;
-    warn(message: unknown, ...meta: unknown[]): void;
-    info(message: unknown, ...meta: unknown[]): void;
-    debug(message: unknown, ...meta: unknown[]): void;
-    log(level: LogLevel, message: unknown, ...meta: unknown[]): void;
-  }
-
-  export interface LogXpert {
-    (message: unknown, ...meta: unknown[]): void;
-    error(message: unknown, ...meta: unknown[]): void;
-    warn(message: unknown, ...meta: unknown[]): void;
-    info(message: unknown, ...meta: unknown[]): void;
-    debug(message: unknown, ...meta: unknown[]): void;
-    http(message: unknown, ...meta: unknown[]): void;
-    verbose(message: unknown, ...meta: unknown[]): void;
-    silly(message: unknown, ...meta: unknown[]): void;
-    log(level: LogLevel, message: unknown, ...meta: unknown[]): void;
-    settings(options?: LogSettingsOptions): void;
-    setLevel(level: LogLevel): void;
-    getLevel(): string;
-    child(meta?: Record<string, unknown>): ChildLogger;
-    close(): void;
-    createLogger(options?: LogSettingsOptions): LogXpert;
-  }
-}
-
-declare const log: log.LogXpert;
-
-export = log;
+declare namespace log {
+  export type LogLevel = 'error' | 'warn' | 'info' | 'http' | 'verbose' | 'debug' | 'silly';
+
+  export type LevelColor = string | number | false | null;
+
+  export interface ConsoleOptions {
+    enabled?: boolean;
+    enableTimestamp?: boolean;
+    timestampFormat?: string;
+    timestampPrefix?: string;
+    timestampSuffix?: string;
+    colorize?: boolean;
+    colors?: Partial<Record<LogLevel, LevelColor>>;
+    level?: LogLevel;
+  }
+
+  export interface RunNumberOptions {
+    enabled?: boolean;
+    separator?: string;
+    padding?: number;
+    startAt?: number;
+  }
+
+  export interface FilesOptions {
+    folder?: string;
+    /** Preferred: date format for %DATE%. */
+    datePattern?: string;
+    /** @deprecated Use datePattern. */
+    filesName?: string;
+    dateFormat?: string;
+    /** Preferred: filename template containing %DATE%. */
+    filePattern?: string;
+    pattern?: string;
+    /** @deprecated Use filePattern. */
+    filename?: string;
+    /** Preferred: filename prefix used when no pattern is given. */
+    prefix?: string;
+    /** @deprecated Use prefix. */
+    appName?: string;
+    runNumber?: boolean | RunNumberOptions;
+    maxFile?: string;
+    maxFiles?: string;
+    maxSize?: string;
+    zippedArchive?: boolean;
+    level?: LogLevel;
+  }
+
+  export interface LogSettingsOptions {
+    console?: ConsoleOptions | false;
+    files?: FilesOptions;
+    level?: LogLevel;
+    sanitize?: boolean;
+  }
+
+  export interface ChildLogger {
+    error(message: unknown, ...meta: unknown[]): void;
+    warn(message: unknown, ...meta: unknown[]): void;
+    info(message: unknown, ...meta: unknown[]): void;
+    debug(message: unknown, ...meta: unknown[]): void;
+    log(level: LogLevel, message: unknown, ...meta: unknown[]): void;
+  }
+
+  export interface LogXpert {
+    (message: unknown, ...meta: unknown[]): void;
+    error(message: unknown, ...meta: unknown[]): void;
+    warn(message: unknown, ...meta: unknown[]): void;
+    info(message: unknown, ...meta: unknown[]): void;
+    debug(message: unknown, ...meta: unknown[]): void;
+    http(message: unknown, ...meta: unknown[]): void;
+    verbose(message: unknown, ...meta: unknown[]): void;
+    silly(message: unknown, ...meta: unknown[]): void;
+    log(level: LogLevel, message: unknown, ...meta: unknown[]): void;
+    settings(options?: LogSettingsOptions): void;
+    setLevel(level: LogLevel): void;
+    getLevel(): string;
+    child(meta?: Record<string, unknown>): ChildLogger;
+    close(): void;
+    createLogger(options?: LogSettingsOptions): LogXpert;
+  }
+}
+
+declare const log: log.LogXpert;
+
+export = log;

package/lib/mini.js

@@ -1,134 +1,134 @@
-const LEVELS = {
-  error: 0,
-  warn: 1,
-  info: 2,
-  http: 3,
-  verbose: 4,
-  debug: 5,
-  silly: 6,
-};
-
-const COLORS = {
-  error: 31,
-  warn: 33,
-  info: 32,
-  http: 35,
-  verbose: 36,
-  debug: 34,
-  silly: 90,
-};
-
-const NAMED_COLORS = {
-  black: 30,
-  red: 31,
-  green: 32,
-  yellow: 33,
-  blue: 34,
-  magenta: 35,
-  cyan: 36,
-  white: 37,
-  gray: 90,
-  grey: 90,
-};
-
-function resolveColorCode(value, level) {
-  if (value === undefined || value === null || value === false) return null;
-  if (typeof value === 'number' && Number.isInteger(value) && value >= 0 && value <= 255) return value;
-  if (typeof value === 'string' && NAMED_COLORS[value.toLowerCase()] !== undefined) return NAMED_COLORS[value.toLowerCase()];
-  throw new Error(`Unknown color "${value}" for level "${level}". Use one of: ${Object.keys(NAMED_COLORS).join(', ')}, an ANSI code 0-255, or false to disable`);
-}
-
-function resolveLevelColors(custom = {}) {
-  if (custom === null || typeof custom !== 'object' || Array.isArray(custom)) {
-    throw new Error('console.colors must be an object mapping level names to colors');
-  }
-  const map = {};
-  for (const level of Object.keys(COLORS)) {
-    if (custom[level] !== undefined) {
-      const code = resolveColorCode(custom[level], level);
-      if (code !== null) map[level] = code;
-    } else {
-      map[level] = COLORS[level];
-    }
-  }
-  return map;
-}
-
-function colorizeLevel(level, text, colors = COLORS) {
-  const code = colors[level] ?? 0;
-  if (!code) return text;
-  return `\x1b[${code}m${text}\x1b[0m`;
-}
-
-class NullTransport {
-  constructor() {
-    this.level = 'off';
-  }
-
-  write() {}
-
-  close() {}
-}
-
-class ConsoleTransport {
-  constructor({ level, render } = {}) {
-    this.level = level;
-    this.render = render;
-  }
-
-  write(entry) {
-    const line = this.render(entry);
-    const stream = entry.level === 'error' || entry.level === 'warn' ? process.stderr : process.stdout;
-    stream.write(line + '\n');
-  }
-
-  close() {}
-}
-
-class MiniLogger {
-  constructor({ level = 'debug' } = {}) {
-    this.level = level;
-    this.levels = LEVELS;
-    this.transports = [];
-  }
-
-  add(transport) {
-    this.transports.push(transport);
-    return this;
-  }
-
-  remove(transport) {
-    const i = this.transports.indexOf(transport);
-    if (i >= 0) this.transports.splice(i, 1);
-    try {
-      transport.close?.();
-    } catch {}
-    return this;
-  }
-
-  enabled(level, transportLevel) {
-    const want = LEVELS[level];
-    const current = LEVELS[transportLevel ?? this.level];
-    return want !== undefined && current !== undefined && want <= current;
-  }
-
-  log(level, message, ...meta) {
-    for (const t of [...this.transports]) {
-      if (this.enabled(level, t.level)) t.write({ level, message, meta });
-    }
-  }
-
-  child(meta = {}) {
-    const self = this;
-    const make = (level) => (message, ...args) => self.log(level, message, meta, ...args);
-    return {
-      error: make('error'),
-      warn: make('warn'),
-      info: make('info'),
-      debug: make('debug'),
-      log: (level, message, ...args) => self.log(level, message, meta, ...args),
-    };
-  }
-}
-
-module.exports = { LEVELS, ConsoleTransport, NullTransport, MiniLogger, colorizeLevel, resolveLevelColors, NAMED_COLORS };
+const LEVELS = {
+  error: 0,
+  warn: 1,
+  info: 2,
+  http: 3,
+  verbose: 4,
+  debug: 5,
+  silly: 6,
+};
+
+const COLORS = {
+  error: 31,
+  warn: 33,
+  info: 32,
+  http: 35,
+  verbose: 36,
+  debug: 34,
+  silly: 90,
+};
+
+const NAMED_COLORS = {
+  black: 30,
+  red: 31,
+  green: 32,
+  yellow: 33,
+  blue: 34,
+  magenta: 35,
+  cyan: 36,
+  white: 37,
+  gray: 90,
+  grey: 90,
+};
+
+function resolveColorCode(value, level) {
+  if (value === undefined || value === null || value === false) return null;
+  if (typeof value === 'number' && Number.isInteger(value) && value >= 0 && value <= 255) return value;
+  if (typeof value === 'string' && NAMED_COLORS[value.toLowerCase()] !== undefined) return NAMED_COLORS[value.toLowerCase()];
+  throw new Error(`Unknown color "${value}" for level "${level}". Use one of: ${Object.keys(NAMED_COLORS).join(', ')}, an ANSI code 0-255, or false to disable`);
+}
+
+function resolveLevelColors(custom = {}) {
+  if (custom === null || typeof custom !== 'object' || Array.isArray(custom)) {
+    throw new Error('console.colors must be an object mapping level names to colors');
+  }
+  const map = {};
+  for (const level of Object.keys(COLORS)) {
+    if (custom[level] !== undefined) {
+      const code = resolveColorCode(custom[level], level);
+      if (code !== null) map[level] = code;
+    } else {
+      map[level] = COLORS[level];
+    }
+  }
+  return map;
+}
+
+function colorizeLevel(level, text, colors = COLORS) {
+  const code = colors[level] ?? 0;
+  if (!code) return text;
+  return `\x1b[${code}m${text}\x1b[0m`;
+}
+
+class NullTransport {
+  constructor() {
+    this.level = 'off';
+  }
+
+  write() {}
+
+  close() {}
+}
+
+class ConsoleTransport {
+  constructor({ level, render } = {}) {
+    this.level = level;
+    this.render = render;
+  }
+
+  write(entry) {
+    const line = this.render(entry);
+    const stream = entry.level === 'error' || entry.level === 'warn' ? process.stderr : process.stdout;
+    stream.write(line + '\n');
+  }
+
+  close() {}
+}
+
+class MiniLogger {
+  constructor({ level = 'debug' } = {}) {
+    this.level = level;
+    this.levels = LEVELS;
+    this.transports = [];
+  }
+
+  add(transport) {
+    this.transports.push(transport);
+    return this;
+  }
+
+  remove(transport) {
+    const i = this.transports.indexOf(transport);
+    if (i >= 0) this.transports.splice(i, 1);
+    try {
+      transport.close?.();
+    } catch {}
+    return this;
+  }
+
+  enabled(level, transportLevel) {
+    const want = LEVELS[level];
+    const current = LEVELS[transportLevel ?? this.level];
+    return want !== undefined && current !== undefined && want <= current;
+  }
+
+  log(level, message, ...meta) {
+    for (const t of [...this.transports]) {
+      if (this.enabled(level, t.level)) t.write({ level, message, meta });
+    }
+  }
+
+  child(meta = {}) {
+    const self = this;
+    const make = (level) => (message, ...args) => self.log(level, message, meta, ...args);
+    return {
+      error: make('error'),
+      warn: make('warn'),
+      info: make('info'),
+      debug: make('debug'),
+      log: (level, message, ...args) => self.log(level, message, meta, ...args),
+    };
+  }
+}
+
+module.exports = { LEVELS, ConsoleTransport, NullTransport, MiniLogger, colorizeLevel, resolveLevelColors, NAMED_COLORS };

package/lib/sanitize.js

@@ -10,29 +10,28 @@ function stripAnsi(str) {
   let out = '';
   let i = 0;
   while (i < str.length) {
-    if (str[i] !== '\x1b') {
+    if (str[i] !== '\x1b' && str[i] !== '\x9b' && str[i] !== '\x9d') {
       out += str[i];
       i++;
       continue;
     }
-    const next = str[i + 1];
-    if (next === ']') {
+    if (str[i] === '\x9d' || str[i + 1] === ']') {
       let j = i + 2;
       while (j < str.length) {
-        if (str[j] === '\x07') { j++; break; }
+        if (str[j] === '\x07' || str[j] === '\x9c') { j++; break; }
         if (str[j] === '\x1b' && str[j + 1] === '\\') { j += 2; break; }
         j++;
       }
       i = j;
-    } else if (next === '[') {
+    } else if (str[i] === '\x9b' || str[i + 1] === '[') {
       let j = i + 2;
       while (j < str.length && str[j] >= ' ' && str[j] <= '?') j++;
       if (j < str.length) j++;
       i = j;
-    } else if (next === '(' || next === ')') {
+    } else if (str[i + 1] === '(' || str[i + 1] === ')') {
       i += 3;
     } else {
-      i += next === undefined ? 1 : 2;
+      i += str[i + 1] === undefined ? 1 : 2;
     }
   }
   return out;

package/main.js

@@ -1,136 +1,144 @@
-const fs = require('fs');
-const path = require('path');
-const { MiniLogger, ConsoleTransport, NullTransport, colorizeLevel, resolveLevelColors } = require('./lib/mini');
-const { FileTransport } = require('./lib/rotate');
-const { DEFAULT_CONSOLE_FORMAT, compileTimestampFormatter } = require('./lib/time');
-const { buildLine } = require('./lib/format');
-const { assertLevel, sanitizeMessage } = require('./lib/sanitize');
-const { normalizeFilesOptions } = require('./lib/files');
-
-function normalizeConsoleOpts(input) {
-  if (input === false) return { enabled: false };
-  return input || {};
-}
-
-function buildConsoleTransport({ enabled = true, enableTimestamp = true, timestampFormat = DEFAULT_CONSOLE_FORMAT, timestampPrefix = '', timestampSuffix = '', colorize = true, colors, level } = {}) {
-  if (!enabled) return new NullTransport();
-  const stamp = enableTimestamp ? compileTimestampFormatter(timestampFormat) : null;
-  const palette = resolveLevelColors(colors);
-  const render = ({ level, message, meta }) => {
-    const timestamp = stamp ? `${timestampPrefix}${stamp()}${timestampSuffix}` : '';
-    const tag = colorize ? colorizeLevel(level, `[${level}]`, palette) : `[${level}]`;
-    return buildLine(timestamp, level, message, meta, tag);
-  };
-  return new ConsoleTransport({ level, render });
-}
-
-function buildFileTransport({ folder, datePattern, filename, maxFiles, maxSize, zippedArchive, level }) {
-  if (!fs.existsSync(folder)) fs.mkdirSync(folder, { recursive: true });
-  return new FileTransport({
-    folder: path.normalize(folder),
-    filename,
-    datePattern,
-    zippedArchive,
-    maxSize,
-    maxFiles,
-    level,
-    render: ({ level, message, meta }) => buildLine(new Date().toISOString(), level, message, meta),
-  });
-}
-
-function createLoggerInstance(initial = {}) {
-  const globalLevel = process.env.LOG_LEVEL || initial.level || 'debug';
-  assertLevel(globalLevel);
-
-  const logger = new MiniLogger({ level: globalLevel });
-
-  let consoleTransport = buildConsoleTransport(normalizeConsoleOpts(initial.console));
-  consoleTransport.level = normalizeConsoleOpts(initial.console).level;
-  logger.add(consoleTransport);
-
-  let fileTransport = null;
-  let consoleOpts = { ...normalizeConsoleOpts(initial.console) };
-  let filesOpts = null;
-
-  function applySettings(options = {}) {
-    if (options.level !== undefined) {
-      assertLevel(options.level);
-      logger.level = options.level;
-    }
-    if (options.console !== undefined) {
-      const next = normalizeConsoleOpts(options.console);
-      if (next.level !== undefined && next.level !== null) assertLevel(next.level);
-      consoleOpts = { ...consoleOpts, ...next };
-      logger.remove(consoleTransport);
-      consoleTransport = buildConsoleTransport(consoleOpts);
-      consoleTransport.level = consoleOpts.level;
-      logger.add(consoleTransport);
-    }
-    if (options.files) {
-      const normalized = normalizeFilesOptions(options.files);
-      if (normalized.level !== undefined && normalized.level !== null) assertLevel(normalized.level);
-      filesOpts = normalized;
-      if (fileTransport) logger.remove(fileTransport);
-      fileTransport = buildFileTransport(normalized);
-      logger.add(fileTransport);
-    }
-  }
-
-  function isEnabled(level) {
-    const want = logger.levels[level];
-    const current = logger.levels[logger.level];
-    return want !== undefined && current !== undefined && want <= current;
-  }
-
-  function write(level, message, ...meta) {
-    if (typeof message === 'function') {
-      if (!isEnabled(level)) return;
-      message = message();
-    }
-    if (message instanceof Error) {
-      logger.log(level, sanitizeMessage(message.message), { stack: message.stack, ...meta[0] });
-      return;
-    }
-    logger.log(level, sanitizeMessage(message), ...meta);
-  }
-
-  function callable(message, ...meta) {
-    write('info', message, ...meta);
-  }
-
-  callable.error = (m, ...a) => write('error', m, ...a);
-  callable.warn = (m, ...a) => write('warn', m, ...a);
-  callable.info = (m, ...a) => write('info', m, ...a);
-  callable.debug = (m, ...a) => write('debug', m, ...a);
-  callable.http = (m, ...a) => write('http', m, ...a);
-  callable.verbose = (m, ...a) => write('verbose', m, ...a);
-  callable.silly = (m, ...a) => write('silly', m, ...a);
-  callable.log = (level, m, ...a) => { assertLevel(level); write(level, m, ...a); };
-
-  callable.settings = applySettings;
-  callable.setLevel = (level) => { assertLevel(level); logger.level = level; };
-  callable.getLevel = () => logger.level;
-  callable.child = (meta = {}) => {
-    const child = logger.child(meta);
-    return {
-      error: (m, ...a) => child.error(m, ...a),
-      warn: (m, ...a) => child.warn(m, ...a),
-      info: (m, ...a) => child.info(m, ...a),
-      debug: (m, ...a) => child.debug(m, ...a),
-      log: child.log.bind(child),
-    };
-  };
-  callable.close = () => {
-    if (fileTransport) { logger.remove(fileTransport); try { fileTransport.close?.(); } catch {} fileTransport = null; }
-  };
-  callable.createLogger = (opts = {}) => createLoggerInstance(opts);
-  callable._winston = logger;
-
-  if (initial.files) applySettings({ files: initial.files });
-  if (initial.console || initial.level) applySettings({ console: initial.console, level: initial.level });
-
-  return callable;
-}
-
-module.exports = createLoggerInstance();
-module.exports.createLogger = createLoggerInstance;
+const fs = require('fs');
+const path = require('path');
+const { MiniLogger, ConsoleTransport, NullTransport, colorizeLevel, resolveLevelColors } = require('./lib/mini');
+const { FileTransport } = require('./lib/rotate');
+const { DEFAULT_CONSOLE_FORMAT, compileTimestampFormatter } = require('./lib/time');
+const { buildLine } = require('./lib/format');
+const { assertLevel, sanitizeMessage } = require('./lib/sanitize');
+const { normalizeFilesOptions } = require('./lib/files');
+
+function normalizeConsoleOpts(input) {
+  if (input === false) return { enabled: false };
+  return input || {};
+}
+
+function buildConsoleTransport({ enabled = true, enableTimestamp = true, timestampFormat = DEFAULT_CONSOLE_FORMAT, timestampPrefix = '', timestampSuffix = '', colorize = true, colors, level } = {}) {
+  if (!enabled) return new NullTransport();
+  const stamp = enableTimestamp ? compileTimestampFormatter(timestampFormat) : null;
+  const palette = resolveLevelColors(colors);
+  const render = ({ level, message, meta }) => {
+    const timestamp = stamp ? `${timestampPrefix}${stamp()}${timestampSuffix}` : '';
+    const tag = colorize ? colorizeLevel(level, `[${level}]`, palette) : `[${level}]`;
+    return buildLine(timestamp, level, message, meta, tag);
+  };
+  return new ConsoleTransport({ level, render });
+}
+
+function buildFileTransport({ folder, datePattern, filename, maxFiles, maxSize, zippedArchive, level }) {
+  if (!fs.existsSync(folder)) fs.mkdirSync(folder, { recursive: true });
+  return new FileTransport({
+    folder: path.normalize(folder),
+    filename,
+    datePattern,
+    zippedArchive,
+    maxSize,
+    maxFiles,
+    level,
+    render: ({ level, message, meta }) => buildLine(new Date().toISOString(), level, message, meta),
+  });
+}
+
+function createLoggerInstance(initial = {}) {
+  const globalLevel = process.env.LOG_LEVEL || initial.level || 'debug';
+  assertLevel(globalLevel);
+
+  const logger = new MiniLogger({ level: globalLevel });
+
+  let consoleTransport = buildConsoleTransport(normalizeConsoleOpts(initial.console));
+  consoleTransport.level = normalizeConsoleOpts(initial.console).level;
+  logger.add(consoleTransport);
+
+  let fileTransport = null;
+  let consoleOpts = { ...normalizeConsoleOpts(initial.console) };
+  let filesOpts = null;
+  let sanitizeEnabled = initial.sanitize ?? true;
+
+  function applySettings(options = {}) {
+    if (options.level !== undefined) {
+      assertLevel(options.level);
+      logger.level = options.level;
+    }
+    if (options.sanitize !== undefined) {
+      if (typeof options.sanitize !== 'boolean') throw new Error('log.settings sanitize must be a boolean');
+      sanitizeEnabled = options.sanitize;
+    }
+    if (options.console !== undefined) {
+      const next = normalizeConsoleOpts(options.console);
+      if (next.level !== undefined && next.level !== null) assertLevel(next.level);
+      consoleOpts = { ...consoleOpts, ...next };
+      logger.remove(consoleTransport);
+      consoleTransport = buildConsoleTransport(consoleOpts);
+      consoleTransport.level = consoleOpts.level;
+      logger.add(consoleTransport);
+    }
+    if (options.files) {
+      const normalized = normalizeFilesOptions(options.files);
+      if (normalized.level !== undefined && normalized.level !== null) assertLevel(normalized.level);
+      filesOpts = normalized;
+      if (fileTransport) logger.remove(fileTransport);
+      fileTransport = buildFileTransport(normalized);
+      logger.add(fileTransport);
+    }
+  }
+
+  function isEnabled(level) {
+    const want = logger.levels[level];
+    const current = logger.levels[logger.level];
+    return want !== undefined && current !== undefined && want <= current;
+  }
+
+  function write(level, message, ...meta) {
+    if (typeof message === 'function') {
+      if (!isEnabled(level)) return;
+      message = message();
+    }
+    if (message instanceof Error) {
+      const text = sanitizeEnabled ? sanitizeMessage(message.message) : message.message;
+      logger.log(level, text, { stack: message.stack, ...meta[0] });
+      return;
+    }
+    logger.log(level, sanitizeEnabled ? sanitizeMessage(message) : message, ...meta);
+  }
+
+  function callable(message, ...meta) {
+    write('info', message, ...meta);
+  }
+
+  callable.error = (m, ...a) => write('error', m, ...a);
+  callable.warn = (m, ...a) => write('warn', m, ...a);
+  callable.info = (m, ...a) => write('info', m, ...a);
+  callable.debug = (m, ...a) => write('debug', m, ...a);
+  callable.http = (m, ...a) => write('http', m, ...a);
+  callable.verbose = (m, ...a) => write('verbose', m, ...a);
+  callable.silly = (m, ...a) => write('silly', m, ...a);
+  callable.log = (level, m, ...a) => { assertLevel(level); write(level, m, ...a); };
+
+  callable.settings = applySettings;
+  callable.setLevel = (level) => { assertLevel(level); logger.level = level; };
+  callable.getLevel = () => logger.level;
+  callable.child = (meta = {}) => {
+    const child = logger.child(meta);
+    return {
+      error: (m, ...a) => child.error(m, ...a),
+      warn: (m, ...a) => child.warn(m, ...a),
+      info: (m, ...a) => child.info(m, ...a),
+      debug: (m, ...a) => child.debug(m, ...a),
+      log: child.log.bind(child),
+    };
+  };
+  callable.close = () => {
+    if (fileTransport) { logger.remove(fileTransport); try { fileTransport.close?.(); } catch {} fileTransport = null; }
+  };
+  callable.createLogger = (opts = {}) => createLoggerInstance(opts);
+  callable._winston = logger;
+
+  if (initial.files) applySettings({ files: initial.files });
+  if (initial.console || initial.level || initial.sanitize !== undefined) {
+    applySettings({ console: initial.console, level: initial.level, sanitize: initial.sanitize });
+  }
+
+  return callable;
+}
+
+module.exports = createLoggerInstance();
+module.exports.createLogger = createLoggerInstance;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logxpert",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "A powerful logging library for Node.js with colorful output and daily file rotation",
   "main": "main.js",
   "types": "index.d.ts",