node-ansi-logger 3.3.2-dev-20261022-1fdc86a → 3.3.2-dev-20261101-706d6a5

package/CHANGELOG.md

@@ -25,6 +25,7 @@ If you like this project and find it useful, please consider giving it a star on
 
 ### Added
 
+- [logger]: Add `AnsiLogger.isLogLevel()` and `AnsiLogger.isTimestampFormat()` static type guard helpers.
 - [logger]: Add an opt-in global circular message cache with configurable capacity, snapshots, callback replay, clearing and static setter/getter.
 - [devcontainer]: Add [`Dev Container`](.devcontainer/README.md) v.2.2.0 with dual Node and Bun runtime support.
 - [agents]: Add a [`shared setup`](.agents/README.md) for all agents: OpenAI Codex, Claude Code, GitHub Copilot and Google Gemini / Antigravity.
@@ -32,18 +33,33 @@ If you like this project and find it useful, please consider giving it a star on
 
 ### Changed
 
-- [vscode]: Update `.vscode/settings.json` to v.1.0.15.
+- [logger]: BREAKING: Remove the deprecated `logDebug` constructor option. Use `logLevel` instead.
+- [vscode]: Update `.vscode/settings.json` to v.1.0.17.
 - [config]: Update Oxlint and Oxfmt configurations to v.1.1.0 and Antigravity settings to v.1.0.5.
 - [config]: Update TypeScript build configurations and rename `vite.config.ts` to `vitest.config.ts`, including CI workflow detection.
 - [styleguide]: Update [`STYLEGUIDE.md`](STYLEGUIDE.md) to v.1.1.0: align it with the lint and format config and add the Commit Messages and Changelog sections.
 - [scripts]: Update scripts to v.2.0.0.
 - [package]: Upgrade package.
-- [package]: Bump `oxfmt` to v.0.74.0.
-- [package]: Bump `oxlint` to v.1.89.0.
+- [package]: Bump `oxfmt` to v.0.75.0.
+- [package]: Bump `oxlint` to v.1.90.0.
 - [package]: Bump `oxlint-tsgolint` to v.7.0.2004.
 - [package]: Bump `vitest` to v.5.0.5.
 - [package]: Bump `@vitest/coverage-v8` to v.5.0.5.
-- [package]: Bump `@types/node` to v.26.6.5.
+- [package]: Bump `@types/node` to v.26.6.6.
+- [codex]: Update `.codex/config.toml` to v.1.0.6.
+- [agents]: Update `.github/commit-message-instructions.md` to v.1.0.1.
+- [vscode]: Update `.vscode/tasks.json`.
+- [agents]: Update `AGENTS.md` to v.1.0.8.
+- [config]: Update `CODE_OF_CONDUCT.md` to v.1.0.0.
+- [config]: Update `CONTRIBUTING.md` to v.1.0.1.
+- [scripts]: Update `scripts/downloads.mjs`.
+- [scripts]: Update `scripts/git-sync-dev.mjs`.
+- [config]: Update `src/logger.ts`.
+- [config]: Update `vitest/cache.test.ts`.
+- [config]: Update `vitest/logger.branchcoverage.test.ts`.
+- [config]: Update `vitest/logger.test.ts`.
+- [config]: Add `SHARED-AGENTS.md`.
+- [config]: Add `TOOLCHAIN.md` v.1.0.1.
 
 ### Fixed
 

package/dist/logger.d.ts

@@ -106,10 +106,6 @@ export interface AnsiLoggerParams {
     extLog?: Logger;
     logName?: string;
     logNameColor?: string;
-    /**
-     * @deprecated Use logLevel instead.
-     */
-    logDebug?: boolean;
     logLevel?: LogLevel;
     logWithColors?: boolean;
     logTimestampFormat?: TimestampFormat;
@@ -165,6 +161,20 @@ export declare class AnsiLogger {
      * AnsiLogger.create({ logName: 'MyLogger' }).info('This is a info message');
      */
     static create(params: AnsiLoggerParams): AnsiLogger;
+    /**
+     * Checks whether a value is a valid LogLevel.
+     *
+     * @param {unknown} value - The value to check.
+     * @returns {value is LogLevel} True if the value is one of the LogLevel values.
+     */
+    static isLogLevel(value: unknown): value is LogLevel;
+    /**
+     * Checks whether a value is a valid TimestampFormat.
+     *
+     * @param {unknown} value - The value to check.
+     * @returns {value is TimestampFormat} True if the value is one of the TimestampFormat values.
+     */
+    static isTimestampFormat(value: unknown): value is TimestampFormat;
     /**
      * Gets the name of the logger.
      *

package/dist/logger.js

@@ -150,16 +150,10 @@ export class AnsiLogger {
         this.#extLog = params.extLog;
         this.#logName = params.logName ?? 'NodeAnsiLogger';
         this.#logNameColor = params.logNameColor ?? '';
-        // oxlint-disable-next-line @typescript-eslint/no-deprecated
-        this.#logLevel = params.logLevel ?? (params.logDebug === true ? "debug" /* LogLevel.DEBUG */ : "info" /* LogLevel.INFO */);
+        this.#logLevel = params.logLevel ?? "info" /* LogLevel.INFO */;
         this.#logWithColors = params.logWithColors ?? process.env.NO_COLOR !== '1';
-        this.#logTimestampFormat =
-            // oxlint-disable-next-line typescript/prefer-nullish-coalescing
-            params.logTimestampFormat !== undefined
-                ? params.logTimestampFormat
-                : process.env.NODE_ANSI_LOGGER_TIMESTAMP_FORMAT !== undefined && ['0', '1', '2', '3', '4', '5', '6'].includes(process.env.NODE_ANSI_LOGGER_TIMESTAMP_FORMAT)
-                    ? Number(process.env.NODE_ANSI_LOGGER_TIMESTAMP_FORMAT)
-                    : 3 /* TimestampFormat.LOCAL_DATE_TIME */;
+        const envTimestampFormat = /^\d$/.test(process.env.NODE_ANSI_LOGGER_TIMESTAMP_FORMAT ?? '') ? Number(process.env.NODE_ANSI_LOGGER_TIMESTAMP_FORMAT) : undefined;
+        this.#logTimestampFormat = params.logTimestampFormat ?? (AnsiLogger.isTimestampFormat(envTimestampFormat) ? envTimestampFormat : 3 /* TimestampFormat.LOCAL_DATE_TIME */);
         this.#logTimeStampColor = params.logTimeStampColor ?? '';
         this.#logCustomTimestampFormat =
             params.logCustomTimestampFormat !== undefined && typeof params.logCustomTimestampFormat === 'string'
@@ -182,6 +176,34 @@ export class AnsiLogger {
     static create(params) {
         return new AnsiLogger(params);
     }
+    /**
+     * Checks whether a value is a valid LogLevel.
+     *
+     * @param {unknown} value - The value to check.
+     * @returns {value is LogLevel} True if the value is one of the LogLevel values.
+     */
+    static isLogLevel(value) {
+        const levels = ["debug" /* LogLevel.DEBUG */, "info" /* LogLevel.INFO */, "notice" /* LogLevel.NOTICE */, "warn" /* LogLevel.WARN */, "error" /* LogLevel.ERROR */, "fatal" /* LogLevel.FATAL */, "" /* LogLevel.NONE */];
+        return typeof value === 'string' && levels.includes(value);
+    }
+    /**
+     * Checks whether a value is a valid TimestampFormat.
+     *
+     * @param {unknown} value - The value to check.
+     * @returns {value is TimestampFormat} True if the value is one of the TimestampFormat values.
+     */
+    static isTimestampFormat(value) {
+        const formats = [
+            0 /* TimestampFormat.ISO */,
+            1 /* TimestampFormat.LOCAL_DATE */,
+            2 /* TimestampFormat.LOCAL_TIME */,
+            3 /* TimestampFormat.LOCAL_DATE_TIME */,
+            4 /* TimestampFormat.TIME_MILLIS */,
+            5 /* TimestampFormat.HOMEBRIDGE */,
+            6 /* TimestampFormat.CUSTOM */,
+        ];
+        return typeof value === 'number' && formats.includes(value);
+    }
     /**
      * Gets the name of the logger.
      *

package/npm-shrinkwrap.json

@@ -1,15 +1,15 @@
 {
   "name": "node-ansi-logger",
-  "version": "3.3.2-dev-20261022-1fdc86a",
+  "version": "3.3.2-dev-20261101-706d6a5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "node-ansi-logger",
-      "version": "3.3.2-dev-20261022-1fdc86a",
+      "version": "3.3.2-dev-20261101-706d6a5",
       "license": "Apache-2.0",
       "engines": {
-        "node": ">=20.19.0 <21.0.0 || >=22.13.0 <23.0.0 || >=24.0.0 <25.0.0 || >=26.0.0 <27.0.0"
+        "node": ">=22.13.0 <23.0.0 || >=24.0.0 <25.0.0 || >=26.0.0 <27.0.0"
       },
       "funding": {
         "type": "buymeacoffee",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-ansi-logger",
-  "version": "3.3.2-dev-20261022-1fdc86a",
+  "version": "3.3.2-dev-20261101-706d6a5",
   "description": "Enhanced Ansi Color Logging and Stringify for Node.js in type script",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
@@ -36,7 +36,7 @@
     }
   },
   "engines": {
-    "node": ">=20.19.0 <21.0.0 || >=22.13.0 <23.0.0 || >=24.0.0 <25.0.0 || >=26.0.0 <27.0.0"
+    "node": ">=22.13.0 <23.0.0 || >=24.0.0 <25.0.0 || >=26.0.0 <27.0.0"
   },
   "files": [
     "dist",