Class Logger

packages/utils/src/lib/logger.ts:36–526

 * Use {@link logger} singleton.
 */
export class Logger {
  #isVerbose = isEnvVarEnabled('CP_VERBOSE');
  #isCI = isEnvVarEnabled('CI');
  #ciPlatform: CiPlatform | undefined = isEnvVarEnabled('GITHUB_ACTIONS')
    ? 'GitHub'
    : isEnvVarEnabled('GITLAB_CI')
      ? 'GitLab'
      : undefined;
  #groupColor: GroupColor | undefined;

  #groupsCount = 0;
  #activeSpinner: Ora | undefined;
  #activeSpinnerLogs: string[] = [];
  #endsWithBlankLine = false;

  #groupSymbols = {
    start: '❯',
    middle: '│',
    end: '└',
  };

  #sigintListener = () => {
    if (this.#activeSpinner != null) {
      const text = `${this.#activeSpinner.text} ${ansis.red.bold('[SIGINT]')}`;
      if (this.#groupColor) {
        this.#activeSpinner.stopAndPersist({
          text,
          symbol: this.#colorize(this.#groupSymbols.end, this.#groupColor),
        });
        this.#groupColor = undefined;
      } else {
        this.#activeSpinner.fail(text);
      }
      this.#activeSpinner = undefined;
    }
    this.newline();
    this.error(ansis.bold('Cancelled by SIGINT'));
    // eslint-disable-next-line n/no-process-exit, unicorn/no-process-exit
    process.exit(SIGNAL_EXIT_CODES().SIGINT);
  };

  /**
   * Logs an error to the console (red).
   *
   * Automatically adapts to logger state if called within {@link task}, {@link group}, etc.
   *
   * @example
   * logger.error('Config file is invalid');
   *
   * @param message Error text
   * @param options Additional options
   */
  error(message: string, options?: LogOptions): void {
    this.#log(message, 'red', options);
  }

  /**
   * Logs a warning to the console (yellow).