cs2-gsi-z/src/utils/Logger.js

A modular, event-driven Game State Integration (GSI) handler for Counter-Strike 2 built with Node.js.

// src/utils/Logger.js
import chalk from 'chalk';

export class Logger {
  static LEVELS = {
    error: 0,
    warn: 1,
    info: 2,
    verbose: 3,
  };

  constructor({ level = 'info', showTimestamps = true, tag = '' } = {}) {
    this.level = Logger.LEVELS[level] ?? Logger.LEVELS.info;
    this.showTimestamps = showTimestamps;
    this.tag = tag ? `[${tag}]` : '';
  }

  _timestamp() {
    if (!this.showTimestamps) return '';
    const now = new Date();
    const localTime = now.toLocaleTimeString('en-US', { hour12: false }); // HH:MM:SS local
    return chalk.gray(`[${localTime}]`);
  }

  _prefix(levelLabel, emoji) {
    return `${chalk.blue('[CS2GSIz]')} ${chalk.magenta(this.tag)} ${chalk.bold(levelLabel)} ${emoji}`;
  }

  log(message, ...args) {
    if (this.level < Logger.LEVELS.info) return;
    console.log(this._timestamp(), this._prefix(chalk.green('[INFO]'), '🎯'), message, ...args);
  }

  verbose(message, ...args) {
    if (this.level < Logger.LEVELS.verbose) return;
    console.log(this._timestamp(), this._prefix(chalk.cyan('[VERBOSE]'), '🔍'), message, ...args);
  }

  warn(message, ...args) {
    if (this.level < Logger.LEVELS.warn) return;
    console.warn(this._timestamp(), this._prefix(chalk.yellow('[WARN]'), '⚠️'), message, ...args);
  }

  error(message, ...args) {
    if (this.level < Logger.LEVELS.error) return;
    console.error(this._timestamp(), this._prefix(chalk.red('[ERROR]'), '❌'), message, ...args);
  }

  event(eventName, { previously, current } = {}) {
    if (this.level < Logger.LEVELS.verbose) return;
    let eventInfo = chalk.yellow(eventName);

    if (previously !== undefined || current !== undefined) {
      eventInfo += ` ${chalk.cyan('(')}${chalk.red(previously)}${chalk.cyan(' → ')}${chalk.green(current)}${chalk.cyan(')')}`;
    }

    console.log(this._timestamp(), chalk.magenta('[EVENT]'), chalk.yellow('🎮'), eventInfo);
  }

  raw(json) {
    if (this.level < Logger.LEVELS.verbose) return;
    console.log(this._timestamp(), chalk.gray('[RAW]'), chalk.gray('📥 JSON received:'), JSON.stringify(json, null, 2));
  }

  setLevel(newLevel) {
    this.level = Logger.LEVELS[newLevel] ?? this.level;
  }

  toggleTimestamps() {
    this.showTimestamps = !this.showTimestamps;
  }

  child(tag) {
    return new Logger({
      level: this.getLevelName(),
      showTimestamps: this.showTimestamps,
      tag,
    });
  }

  getLevelName() {
    return Object.keys(Logger.LEVELS).find(key => Logger.LEVELS[key] === this.level) || 'info';
  }
}