@aztec/foundation 0.65.2 → 0.66.0

package/dest/log/logger.js

@@ -1,139 +0,0 @@
-import debug from 'debug';
-import { inspect } from 'util';
-const LogLevels = ['silent', 'error', 'warn', 'info', 'verbose', 'debug'];
-function getLogLevel() {
-    const envLogLevel = process.env.LOG_LEVEL?.toLowerCase();
-    let defaultLogLevel = 'info';
-    if (process.env.DEBUG) {
-        // if we set DEBUG to a non-empty string, use debug as default
-        defaultLogLevel = 'debug';
-    }
-    else if (process.env.NODE_ENV === 'test') {
-        // otherwise, be silent in tests as these are frequently ran en-masse
-        defaultLogLevel = 'silent';
-    }
-    return LogLevels.includes(envLogLevel) ? envLogLevel : defaultLogLevel;
-}
-export let currentLevel = getLogLevel();
-const logElapsedTime = ['1', 'true'].includes(process.env.LOG_ELAPSED_TIME ?? '');
-const firstTimestamp = Date.now();
-function filterNegativePatterns(debugString) {
-    return debugString
-        .split(',')
-        .filter(p => !p.startsWith('-'))
-        .join(',');
-}
-function extractNegativePatterns(debugString) {
-    return (debugString
-        .split(',')
-        .filter(p => p.startsWith('-'))
-        // Remove the leading '-' from the pattern
-        .map(p => p.slice(1)));
-}
-const namespaces = process.env.DEBUG ?? 'aztec:*';
-debug.enable(filterNegativePatterns(namespaces));
-/**
- * Creates a new DebugLogger for the current module, defaulting to the LOG_LEVEL env var.
- * If DEBUG="[module]" env is set, will enable debug logging if the module matches.
- * Uses npm debug for debug level and console.error for other levels.
- * @param name - Name of the module.
- * @param fixedLogData - Additional data to include in the log message.
- * @usage createDebugLogger('aztec:validator');
- * // will always add the validator address to the log labels
- * @returns A debug logger.
- */
-export function createDebugLogger(name) {
-    const debugLogger = debug(name);
-    const negativePatterns = extractNegativePatterns(namespaces);
-    const accepted = () => {
-        return !negativePatterns.some(pattern => name.match(pattern));
-    };
-    const log = (level, msg, data) => {
-        if (accepted()) {
-            logWithDebug(debugLogger, level, msg, data);
-        }
-    };
-    const logger = {
-        silent: () => { },
-        error: (msg, err, data) => log('error', fmtErr(msg, err), data),
-        warn: (msg, data) => log('warn', msg, data),
-        info: (msg, data) => log('info', msg, data),
-        verbose: (msg, data) => log('verbose', msg, data),
-        debug: (msg, data) => log('debug', msg, data),
-    };
-    return Object.assign((msg, data) => log('debug', msg, data), logger);
-}
-/**
- * A function to create a logger that automatically includes fixed data in each log entry.
- * @param debugLogger - The base DebugLogger instance to which we attach fixed log data.
- * @param fixedLogData - The data to be included in every log entry.
- * @returns A DebugLogger with log level methods (error, warn, info, verbose, debug) that
- * automatically attach `fixedLogData` to every log message.
- */
-export function attachedFixedDataToLogger(debugLogger, fixedLogData) {
-    // Helper function to merge fixed data with additional data passed to log entries.
-    const attach = (data) => ({ ...fixedLogData, ...data });
-    // Define the logger with all the necessary log level methods.
-    const logger = {
-        // Silent log level does nothing.
-        silent: () => { },
-        error: (msg, err, data) => debugLogger.error(fmtErr(msg, err), attach(data)),
-        warn: (msg, data) => debugLogger.warn(msg, attach(data)),
-        info: (msg, data) => debugLogger.info(msg, attach(data)),
-        verbose: (msg, data) => debugLogger.verbose(msg, attach(data)),
-        debug: (msg, data) => debugLogger.debug(msg, attach(data)),
-    };
-    return Object.assign((msg, data) => debugLogger.debug(msg, attach(data)), logger);
-}
-const logHandlers = [];
-/**
- * Registers a callback for all logs, whether they are emitted in the current log level or not.
- * @param handler - Callback to be called on every log.
- */
-export function onLog(handler) {
-    logHandlers.push(handler);
-}
-/** Overrides current log level. */
-export function setLevel(level) {
-    currentLevel = level;
-}
-/**
- * Logs args to npm debug if enabled or log level is debug, console.error otherwise.
- * @param debug - Instance of npm debug.
- * @param level - Intended log level.
- * @param args - Args to log.
- */
-function logWithDebug(debug, level, msg, data) {
-    for (const handler of logHandlers) {
-        handler(level, debug.namespace, msg, data);
-    }
-    msg = data ? `${msg} ${fmtLogData(data)}` : msg;
-    if (debug.enabled && LogLevels.indexOf(level) <= LogLevels.indexOf(currentLevel)) {
-        if (logElapsedTime) {
-            const ts = ((Date.now() - firstTimestamp) / 1000).toFixed(3);
-            debug('%ss [%s] %s', ts, level.toUpperCase(), msg);
-        }
-        else {
-            debug('[%s] %s', level.toUpperCase(), msg);
-        }
-    }
-}
-/**
- * Concatenates a log message and an exception.
- * @param msg - Log message
- * @param err - Error to log
- * @returns A string with both the log message and the error message.
- */
-function fmtErr(msg, err) {
-    return err ? `${msg}: ${inspect(err)}` : msg;
-}
-/**
- * Formats structured log data as a string for console output.
- * @param data - Optional log data.
- */
-export function fmtLogData(data) {
-    return Object.entries(data ?? {})
-        .map(([key, value]) => `${key}=${typeof value === 'object' && 'toString' in value ? value.toString() : value}`)
-        .join(' ');
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZy9sb2dnZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE1BQU0sT0FBTyxDQUFDO0FBQzFCLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxNQUFNLENBQUM7QUFJL0IsTUFBTSxTQUFTLEdBQUcsQ0FBQyxRQUFRLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLE9BQU8sQ0FBVSxDQUFDO0FBT25GLFNBQVMsV0FBVztJQUNsQixNQUFNLFdBQVcsR0FBRyxPQUFPLENBQUMsR0FBRyxDQUFDLFNBQVMsRUFBRSxXQUFXLEVBQWMsQ0FBQztJQUNyRSxJQUFJLGVBQWUsR0FBYSxNQUFNLENBQUM7SUFDdkMsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ3RCLDhEQUE4RDtRQUM5RCxlQUFlLEdBQUcsT0FBTyxDQUFDO0lBQzVCLENBQUM7U0FBTSxJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsUUFBUSxLQUFLLE1BQU0sRUFBRSxDQUFDO1FBQzNDLHFFQUFxRTtRQUNyRSxlQUFlLEdBQUcsUUFBUSxDQUFDO0lBQzdCLENBQUM7SUFDRCxPQUFPLFNBQVMsQ0FBQyxRQUFRLENBQUMsV0FBVyxDQUFDLENBQUMsQ0FBQyxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsZUFBZSxDQUFDO0FBQ3pFLENBQUM7QUFFRCxNQUFNLENBQUMsSUFBSSxZQUFZLEdBQUcsV0FBVyxFQUFFLENBQUM7QUFFeEMsTUFBTSxjQUFjLEdBQUcsQ0FBQyxHQUFHLEVBQUUsTUFBTSxDQUFDLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsZ0JBQWdCLElBQUksRUFBRSxDQUFDLENBQUM7QUFDbEYsTUFBTSxjQUFjLEdBQVcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO0FBRTFDLFNBQVMsc0JBQXNCLENB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

package/src/log/logger.ts

@@ -1,179 +0,0 @@
-import debug from 'debug';
-import { inspect } from 'util';
-
-import { type LogData, type LogFn } from './log_fn.js';
-
-const LogLevels = ['silent', 'error', 'warn', 'info', 'verbose', 'debug'] as const;
-
-/**
- * A valid log severity level.
- */
-export type LogLevel = (typeof LogLevels)[number];
-
-function getLogLevel() {
-  const envLogLevel = process.env.LOG_LEVEL?.toLowerCase() as LogLevel;
-  let defaultLogLevel: LogLevel = 'info';
-  if (process.env.DEBUG) {
-    // if we set DEBUG to a non-empty string, use debug as default
-    defaultLogLevel = 'debug';
-  } else if (process.env.NODE_ENV === 'test') {
-    // otherwise, be silent in tests as these are frequently ran en-masse
-    defaultLogLevel = 'silent';
-  }
-  return LogLevels.includes(envLogLevel) ? envLogLevel : defaultLogLevel;
-}
-
-export let currentLevel = getLogLevel();
-
-const logElapsedTime = ['1', 'true'].includes(process.env.LOG_ELAPSED_TIME ?? '');
-const firstTimestamp: number = Date.now();
-
-function filterNegativePatterns(debugString: string): string {
-  return debugString
-    .split(',')
-    .filter(p => !p.startsWith('-'))
-    .join(',');
-}
-function extractNegativePatterns(debugString: string): string[] {
-  return (
-    debugString
-      .split(',')
-      .filter(p => p.startsWith('-'))
-      // Remove the leading '-' from the pattern
-      .map(p => p.slice(1))
-  );
-}
-
-const namespaces = process.env.DEBUG ?? 'aztec:*';
-debug.enable(filterNegativePatterns(namespaces));
-
-/** Log function that accepts an exception object */
-type ErrorLogFn = (msg: string, err?: Error | unknown, data?: LogData) => void;
-
-/**
- * Logger that supports multiple severity levels.
- */
-export type Logger = { [K in LogLevel]: LogFn } & { /** Error log function */ error: ErrorLogFn };
-
-/**
- * Logger that supports multiple severity levels and can be called directly to issue a debug statement.
- * Intended as a drop-in replacement for the debug module.
- */
-export type DebugLogger = Logger;
-
-/**
- * Creates a new DebugLogger for the current module, defaulting to the LOG_LEVEL env var.
- * If DEBUG="[module]" env is set, will enable debug logging if the module matches.
- * Uses npm debug for debug level and console.error for other levels.
- * @param name - Name of the module.
- * @param fixedLogData - Additional data to include in the log message.
- * @usage createDebugLogger('aztec:validator');
- * // will always add the validator address to the log labels
- * @returns A debug logger.
- */
-
-export function createDebugLogger(name: string): DebugLogger {
-  const debugLogger = debug(name);
-
-  const negativePatterns = extractNegativePatterns(namespaces);
-  const accepted = () => {
-    return !negativePatterns.some(pattern => name.match(pattern));
-  };
-  const log = (level: LogLevel, msg: string, data?: LogData) => {
-    if (accepted()) {
-      logWithDebug(debugLogger, level, msg, data);
-    }
-  };
-  const logger = {
-    silent: () => {},
-    error: (msg: string, err?: unknown, data?: LogData) => log('error', fmtErr(msg, err), data),
-    warn: (msg: string, data?: LogData) => log('warn', msg, data),
-    info: (msg: string, data?: LogData) => log('info', msg, data),
-    verbose: (msg: string, data?: LogData) => log('verbose', msg, data),
-    debug: (msg: string, data?: LogData) => log('debug', msg, data),
-  };
-  return Object.assign((msg: string, data?: LogData) => log('debug', msg, data), logger);
-}
-
-/**
- * A function to create a logger that automatically includes fixed data in each log entry.
- * @param debugLogger - The base DebugLogger instance to which we attach fixed log data.
- * @param fixedLogData - The data to be included in every log entry.
- * @returns A DebugLogger with log level methods (error, warn, info, verbose, debug) that
- * automatically attach `fixedLogData` to every log message.
- */
-export function attachedFixedDataToLogger(debugLogger: DebugLogger, fixedLogData: LogData): DebugLogger {
-  // Helper function to merge fixed data with additional data passed to log entries.
-  const attach = (data?: LogData) => ({ ...fixedLogData, ...data });
-  // Define the logger with all the necessary log level methods.
-  const logger = {
-    // Silent log level does nothing.
-    silent: () => {},
-    error: (msg: string, err?: unknown, data?: LogData) => debugLogger.error(fmtErr(msg, err), attach(data)),
-    warn: (msg: string, data?: LogData) => debugLogger.warn(msg, attach(data)),
-    info: (msg: string, data?: LogData) => debugLogger.info(msg, attach(data)),
-    verbose: (msg: string, data?: LogData) => debugLogger.verbose(msg, attach(data)),
-    debug: (msg: string, data?: LogData) => debugLogger.debug(msg, attach(data)),
-  };
-  return Object.assign((msg: string, data?: LogData) => debugLogger.debug(msg, attach(data)), logger);
-}
-
-/** A callback to capture all logs. */
-export type LogHandler = (level: LogLevel, namespace: string, msg: string, data?: LogData) => void;
-
-const logHandlers: LogHandler[] = [];
-
-/**
- * Registers a callback for all logs, whether they are emitted in the current log level or not.
- * @param handler - Callback to be called on every log.
- */
-export function onLog(handler: LogHandler) {
-  logHandlers.push(handler);
-}
-
-/** Overrides current log level. */
-export function setLevel(level: LogLevel) {
-  currentLevel = level;
-}
-
-/**
- * Logs args to npm debug if enabled or log level is debug, console.error otherwise.
- * @param debug - Instance of npm debug.
- * @param level - Intended log level.
- * @param args - Args to log.
- */
-function logWithDebug(debug: debug.Debugger, level: LogLevel, msg: string, data?: LogData) {
-  for (const handler of logHandlers) {
-    handler(level, debug.namespace, msg, data);
-  }
-
-  msg = data ? `${msg} ${fmtLogData(data)}` : msg;
-  if (debug.enabled && LogLevels.indexOf(level) <= LogLevels.indexOf(currentLevel)) {
-    if (logElapsedTime) {
-      const ts = ((Date.now() - firstTimestamp) / 1000).toFixed(3);
-      debug('%ss [%s] %s', ts, level.toUpperCase(), msg);
-    } else {
-      debug('[%s] %s', level.toUpperCase(), msg);
-    }
-  }
-}
-
-/**
- * Concatenates a log message and an exception.
- * @param msg - Log message
- * @param err - Error to log
- * @returns A string with both the log message and the error message.
- */
-function fmtErr(msg: string, err?: Error | unknown): string {
-  return err ? `${msg}: ${inspect(err)}` : msg;
-}
-
-/**
- * Formats structured log data as a string for console output.
- * @param data - Optional log data.
- */
-export function fmtLogData(data?: LogData): string {
-  return Object.entries(data ?? {})
-    .map(([key, value]) => `${key}=${typeof value === 'object' && 'toString' in value ? value.toString() : value}`)
-    .join(' ');
-}