@powerlines/core 0.44.0 → 0.44.2

package/dist/plugin-utils/logging.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"logging.mjs","names":["defu"],"sources":["../../src/plugin-utils/logging.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { defu } from \"defu\";\nimport {\n  DEFAULT_DEVELOPMENT_LOG_LEVEL,\n  DEFAULT_PRODUCTION_LOG_LEVEL,\n  DEFAULT_TEST_LOG_LEVEL\n} from \"../constants/log-level\";\nimport { Mode, UnresolvedContext } from \"../types\";\nimport { LogLevelResolvedConfig, LogLevelUserConfig } from \"../types/log\";\n\n/**\n * Determines if the provided log level is considered verbose (debug or trace).\n *\n * @param logLevel - The log level to check, which can be a string or an UnresolvedContext containing the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(logLevel: string): boolean;\n\n/**\n * Determines if the provided context is considered verbose (debug or trace).\n *\n * @param context - The context to check, which contains the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(context: UnresolvedContext): boolean;\n\n/**\n * Determines if the provided log level is considered verbose (debug or trace).\n *\n * @param logLevelOrContext - The log level to check, which can be a string or an UnresolvedContext containing the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(\n  logLevelOrContext: string | UnresolvedContext\n): boolean {\n  const level = isString(logLevelOrContext)\n    ? logLevelOrContext\n    : logLevelOrContext.config.logLevel;\n\n  return level === \"debug\" || level === \"trace\";\n}\n\n/**\n * Resolves the log level configuration based on the provided log level and mode, returning a complete LogLevelResolvedConfig object that specifies the log level for each log category.\n *\n * @param logLevel - The user-provided log level configuration, which can be a string or an object specifying log levels for each category.\n * @param mode - The current mode of the application (e.g., \"development\", \"test\", \"production\"), which determines the default log levels.\n * @returns A LogLevelResolvedConfig object specifying the log level for each log category.\n */\nexport function resolveLogLevel(\n  logLevel: LogLevelUserConfig,\n  mode?: Mode\n): LogLevelResolvedConfig {\n  if (logLevel === \"trace\") {\n    return {\n      general: \"trace\",\n      fs: \"trace\",\n      performance: \"trace\",\n      network: \"trace\",\n      plugins: \"trace\",\n      hooks: \"trace\",\n      env: \"trace\",\n      ipc: \"trace\",\n      config: \"trace\"\n    };\n  } else if (logLevel === \"silent\") {\n    return {\n      general: \"silent\",\n      fs: \"silent\",\n      performance: \"silent\",\n      network: \"silent\",\n      plugins: \"silent\",\n      hooks: \"silent\",\n      env: \"silent\",\n      ipc: \"silent\",\n      config: \"silent\"\n    };\n  }\n\n  let defaultLogLevel: LogLevelResolvedConfig;\n  if (mode === \"development\") {\n    defaultLogLevel = DEFAULT_DEVELOPMENT_LOG_LEVEL;\n  } else if (mode === \"test\") {\n    defaultLogLevel = DEFAULT_TEST_LOG_LEVEL;\n  } else {\n    defaultLogLevel = DEFAULT_PRODUCTION_LOG_LEVEL;\n  }\n\n  if (isSetString(logLevel)) {\n    return {\n      general: logLevel,\n      fs: defaultLogLevel.fs,\n      performance: logLevel,\n      network: defaultLogLevel.network,\n      plugins: logLevel,\n      hooks: logLevel,\n      env: defaultLogLevel.env,\n      ipc: defaultLogLevel.ipc,\n      config: defaultLogLevel.config\n    };\n  } else if (isSetObject(logLevel)) {\n    return defu(logLevel, defaultLogLevel) as LogLevelResolvedConfig;\n  }\n\n  return defaultLogLevel;\n}\n"],"mappings":";;;;;;;;;;;;;AAoDA,SAAgB,UACd,mBACS;CACT,MAAM,QAAQ,SAAS,kBAAkB,GACrC,oBACA,kBAAkB,OAAO;AAE7B,QAAO,UAAU,WAAW,UAAU;;;;;;;;;AAUxC,SAAgB,gBACd,UACA,MACwB;AACxB,KAAI,aAAa,QACf,QAAO;EACL,SAAS;EACT,IAAI;EACJ,aAAa;EACb,SAAS;EACT,SAAS;EACT,OAAO;EACP,KAAK;EACL,KAAK;EACL,QAAQ;EACT;UACQ,aAAa,SACtB,QAAO;EACL,SAAS;EACT,IAAI;EACJ,aAAa;EACb,SAAS;EACT,SAAS;EACT,OAAO;EACP,KAAK;EACL,KAAK;EACL,QAAQ;EACT;CAGH,IAAI;AACJ,KAAI,SAAS,cACX,mBAAkB;UACT,SAAS,OAClB,mBAAkB;KAElB,mBAAkB;AAGpB,KAAI,YAAY,SAAS,CACvB,QAAO;EACL,SAAS;EACT,IAAI,gBAAgB;EACpB,aAAa;EACb,SAAS,gBAAgB;EACzB,SAAS;EACT,OAAO;EACP,KAAK,gBAAgB;EACrB,KAAK,gBAAgB;EACrB,QAAQ,gBAAgB;EACzB;UACQ,YAAY,SAAS,CAC9B,QAAOA,OAAK,UAAU,gBAAgB;AAGxC,QAAO"}
+{"version":3,"file":"logging.mjs","names":["defu"],"sources":["../../src/plugin-utils/logging.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { getLogFn, getLogLevel } from \"@storm-software/config-tools/logger\";\nimport { getColor } from \"@storm-software/config-tools/utilities/colors\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { RequiredKeys } from \"@stryke/types/base\";\nimport { uuid } from \"@stryke/unique-id/uuid\";\nimport chalk from \"chalk\";\nimport { defu } from \"defu\";\nimport { DEFAULT_ENVIRONMENT } from \"../constants/environments\";\nimport {\n  DEFAULT_DEVELOPMENT_LOG_LEVEL,\n  DEFAULT_PRODUCTION_LOG_LEVEL,\n  DEFAULT_TEST_LOG_LEVEL\n} from \"../constants/log-level\";\nimport { Mode } from \"../types/config\";\nimport { UnresolvedContext } from \"../types/context\";\nimport type {\n  CustomLogger,\n  CustomLoggerMessage,\n  LogCategory,\n  LogFn,\n  LogFnMeta,\n  LogFnOptions,\n  LoggerMessage,\n  LoggerOptions,\n  LogLevel,\n  LogLevelResolvedConfig,\n  LogLevelUserConfig,\n  LogMeta\n} from \"../types/logging\";\nimport { LOG_LEVELS, LogCategories, Logger, LogLevels } from \"../types/logging\";\n\n/**\n * Determines if the provided log level is considered verbose (debug or trace).\n *\n * @param logLevel - The log level to check, which can be a string or an UnresolvedContext containing the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(logLevel: string): boolean;\n\n/**\n * Determines if the provided context is considered verbose (debug or trace).\n *\n * @param context - The context to check, which contains the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(context: UnresolvedContext): boolean;\n\n/**\n * Determines if the provided log level is considered verbose (debug or trace).\n *\n * @param logLevelOrContext - The log level to check, which can be a string or an UnresolvedContext containing the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(\n  logLevelOrContext: string | UnresolvedContext\n): boolean {\n  const level = isString(logLevelOrContext)\n    ? logLevelOrContext\n    : logLevelOrContext.config.logLevel;\n\n  return level === \"debug\" || level === \"trace\";\n}\n\n/**\n * Resolves the log level configuration based on the provided log level and mode, returning a complete LogLevelResolvedConfig object that specifies the log level for each log category.\n *\n * @param logLevel - The user-provided log level configuration, which can be a string or an object specifying log levels for each category.\n * @param mode - The current mode of the application (e.g., \"development\", \"test\", \"production\"), which determines the default log levels.\n * @returns A LogLevelResolvedConfig object specifying the log level for each log category.\n */\nexport function resolveLogLevel(\n  logLevel?: LogLevelUserConfig,\n  mode?: Mode\n): LogLevelResolvedConfig {\n  if (logLevel === \"trace\") {\n    return {\n      general: \"trace\",\n      fs: \"trace\",\n      performance: \"trace\",\n      network: \"trace\",\n      plugins: \"trace\",\n      hooks: \"trace\",\n      env: \"trace\",\n      ipc: \"trace\",\n      config: \"trace\",\n      babel: \"trace\"\n    };\n  } else if (logLevel === \"silent\") {\n    return {\n      general: \"silent\",\n      fs: \"silent\",\n      performance: \"silent\",\n      network: \"silent\",\n      plugins: \"silent\",\n      hooks: \"silent\",\n      env: \"silent\",\n      ipc: \"silent\",\n      config: \"silent\",\n      babel: \"silent\"\n    };\n  }\n\n  let defaultLogLevel: LogLevelResolvedConfig;\n  if (mode === \"development\") {\n    defaultLogLevel = DEFAULT_DEVELOPMENT_LOG_LEVEL;\n  } else if (mode === \"test\") {\n    defaultLogLevel = DEFAULT_TEST_LOG_LEVEL;\n  } else {\n    defaultLogLevel = DEFAULT_PRODUCTION_LOG_LEVEL;\n  }\n\n  if (isSetString(logLevel)) {\n    return {\n      general: logLevel,\n      fs: defaultLogLevel.fs,\n      performance: logLevel,\n      network: defaultLogLevel.network,\n      plugins: logLevel,\n      hooks: logLevel,\n      env: defaultLogLevel.env,\n      ipc: defaultLogLevel.ipc,\n      config: defaultLogLevel.config,\n      babel: logLevel\n    };\n  } else if (isSetObject(logLevel)) {\n    return defu(logLevel, defaultLogLevel) as LogLevelResolvedConfig;\n  }\n\n  return defaultLogLevel;\n}\n\nconst BADGE_COLORS = [\n  \"#00A0DD\",\n  \"#6FCE4E\",\n  \"#FBBF24\",\n  \"#F43F5E\",\n  \"#3B82F6\",\n  \"#A855F7\",\n  \"#469592\",\n  \"#288EDF\",\n  \"#D8B4FE\",\n  \"#10B981\",\n  \"#EF4444\",\n  \"#F0EC56\",\n  \"#F472B6\",\n  \"#22D3EE\",\n  \"#EAB308\",\n  \"#84CC16\",\n  \"#F87171\",\n  \"#0EA5E9\",\n  \"#D946EF\",\n  \"#FACC15\",\n  \"#34D399\",\n  \"#8B5CF6\"\n] as const;\n\nconst BRAND_COLOR = getColor(\"brand\");\n\n/**\n * Generate a consistent color based on the input text.\n *\n * @param text - The input text to generate the color from.\n * @return A hexadecimal color string.\n */\nexport const getTextColor = (text: string): string => {\n  return (\n    BADGE_COLORS[\n      text\n        .split(\"\")\n        .map(char => char.charCodeAt(0))\n        .reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length\n    ] || BADGE_COLORS[0]\n  );\n};\n\n/**\n * Generate a consistent color based on the input text.\n *\n * @param text - The input text to generate the color from.\n * @return A hexadecimal color string.\n */\nexport const colorText = (text: string): string => {\n  const title = titleCase(text);\n\n  return chalk.hex(getTextColor(title))(title);\n};\n\n/**\n * Generate a consistent color based on the input text.\n *\n * @param text - The input text to generate the color from.\n * @return A hexadecimal color string.\n */\nexport const colorBackground = (text: string): string => {\n  const title = titleCase(text);\n\n  return chalk.inverse.hex(getTextColor(title))(` ${title} `);\n};\n\nexport const consoleLog = (meta: LogMeta, ...args: string[]) =>\n  getLogFn(getLogLevel(meta.type), {\n    logLevel: \"trace\"\n  })(\n    `${meta.name ? chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.name)) : \"\"}${\n      meta.command ? chalk.hex(BRAND_COLOR)(` (${meta.command})`) : \"\"\n    }${meta.name ? chalk.grey(\" > \") : \"\"}${\n      (meta.source || meta.plugin) &&\n      (!meta.name ||\n        kebabCase(meta.source || meta.plugin) !== kebabCase(meta.name))\n        ? `${chalk.bold.hex(BRAND_COLOR)(\n            kebabCase(meta.source || meta.plugin)\n          )}${chalk.grey(\" > \")}`\n        : \"\"\n    }${\n      meta.environment && kebabCase(meta.environment) !== DEFAULT_ENVIRONMENT\n        ? `${chalk.bold.hex(BRAND_COLOR)(\n            kebabCase(meta.environment)\n          )}${chalk.grey(\" > \")}`\n        : \"\"\n    }${\n      meta.category && meta.category !== LogCategories.GENERAL\n        ? `${colorBackground(kebabCase(meta.category))} `\n        : \"\"\n    }${args.join(\" \")} `.trim()\n  );\n\nexport function isValidLogLevel(logLevel: LogLevel, type: LogLevel): boolean {\n  if (logLevel === LogLevels.SILENT) {\n    return false;\n  }\n\n  return LOG_LEVELS.indexOf(logLevel) >= LOG_LEVELS.indexOf(type);\n}\n\nexport function isValidLogLevelConfig(\n  type: LogLevel,\n  logLevel: LogLevelResolvedConfig,\n  category: LogCategory = LogCategories.GENERAL\n): boolean {\n  return isValidLogLevel(logLevel[category], type);\n}\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param name - The name of the logging function.\n * @param options - The options to configure the logging function, including the source, command, environment, plugin, log level, custom logger, and colors. These options can be used to customize the appearance and behavior of the log messages generated by the logging function.\n * @returns A logging function.\n */\nexport const createLogFn = (name: string, options: LogFnOptions): LogFn => {\n  const logLevel = resolveLogLevel(options.logLevel, options.mode);\n\n  return (meta: LogFnMeta | LogLevel, ...args: string[]) => {\n    const logMeta = isSetObject(meta)\n      ? {\n          logId: uuid(),\n          timestamp: Date.now(),\n          category: LogCategories.GENERAL,\n          ...options,\n          ...meta,\n          name\n        }\n      : {\n          logId: uuid(),\n          timestamp: Date.now(),\n          category: LogCategories.GENERAL,\n          ...options,\n          type: meta,\n          name\n        };\n\n    if (\n      isValidLogLevelConfig(\n        logMeta.type,\n        logLevel,\n        logMeta.category ? logMeta.category : LogCategories.GENERAL\n      )\n    ) {\n      consoleLog(logMeta, ...args);\n    }\n  };\n};\n\nconst validateLogger = (\n  type: LogLevel,\n  name: string,\n  options: LoggerOptions,\n  callback: (message: string | LoggerMessage) => void\n) => {\n  const logLevel = resolveLogLevel(options.logLevel, options.mode);\n\n  return (message: string | LoggerMessage) => {\n    const params = isSetString(message)\n      ? {\n          name,\n          plugin: options.plugin,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            ...options\n          },\n          message\n        }\n      : {\n          name,\n          plugin: options.plugin,\n          ...message,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            plugin: message.plugin,\n            ...options,\n            ...message.meta\n          }\n        };\n\n    if (isValidLogLevelConfig(type, logLevel, params.meta.category)) {\n      callback(params);\n    }\n  };\n};\n\nconst validateCustomLogger = (\n  type: LogLevel,\n  name: string,\n  options: LoggerOptions,\n  callback?: (message: string | LoggerMessage) => void,\n  customCallback?: (message: CustomLoggerMessage) => void\n) => {\n  const logLevel = resolveLogLevel(options.logLevel, options.mode);\n\n  return (message: string | LoggerMessage) => {\n    const params = isSetString(message)\n      ? {\n          name,\n          plugin: options.plugin,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            ...options\n          },\n          message\n        }\n      : {\n          name,\n          plugin: options.plugin,\n          ...message,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            plugin: message.plugin,\n            ...options,\n            ...message.meta\n          }\n        };\n\n    if (isValidLogLevelConfig(type, logLevel, params.meta.category)) {\n      callback?.(params);\n      customCallback?.(params);\n    }\n  };\n};\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param logger - The original logger to wrap with the custom logger.\n * @param secondaryLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.\n * @returns A new logger that combines the original logger's options with the custom logger's methods, allowing for customized logging behavior while still maintaining the original logger's configuration.\n */\nexport const withLogger = (logger: Logger, secondaryLogger: Logger): Logger => {\n  const options = { ...secondaryLogger.options, ...logger.options };\n\n  const result = {\n    options,\n    error: validateLogger(\n      \"error\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.error?.(message);\n        secondaryLogger.error?.(message);\n      }\n    ),\n    warn: validateLogger(\n      \"warn\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.warn?.(message);\n        secondaryLogger.warn?.(message);\n      }\n    ),\n    info: validateLogger(\n      \"info\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.info?.(message);\n        secondaryLogger.info?.(message);\n      }\n    ),\n    debug: validateLogger(\n      \"debug\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.debug?.(message);\n        secondaryLogger.debug?.(message);\n      }\n    ),\n    trace: validateLogger(\n      \"trace\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.trace?.(message);\n        secondaryLogger.trace?.(message);\n      }\n    )\n  } as Logger;\n\n  result.log = (type: LogLevel, message: string | LoggerMessage) => {\n    switch (type) {\n      case \"error\":\n        result.error(message);\n        break;\n      case \"warn\":\n        result.warn(message);\n        break;\n      case \"info\":\n        result.info(message);\n        break;\n      case \"debug\":\n        result.debug(message);\n        break;\n      case \"trace\":\n        result.trace(message);\n        break;\n      case \"silent\":\n        break;\n      default:\n        result.info(message);\n        break;\n    }\n  };\n\n  return result;\n};\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param logger - The original logger to wrap with the custom logger.\n * @param customLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.\n * @returns A new logger that combines the original logger's options with the custom logger's methods, allowing for customized logging behavior while still maintaining the original logger's configuration.\n */\nexport const withCustomLogger = (\n  logger: Logger,\n  customLogger: CustomLogger\n): Logger => {\n  const result = {\n    options: logger.options,\n    error: validateCustomLogger(\n      \"error\",\n      logger.options.name!,\n      logger.options,\n      logger.error.bind(logger),\n      customLogger.error?.bind(customLogger)\n    ),\n    warn: validateCustomLogger(\n      \"warn\",\n      logger.options.name!,\n      logger.options,\n      logger.warn.bind(logger),\n      customLogger.warn?.bind(customLogger)\n    ),\n    info: validateCustomLogger(\n      \"info\",\n      logger.options.name!,\n      logger.options,\n      logger.info.bind(logger),\n      customLogger.info?.bind(customLogger)\n    ),\n    debug: validateCustomLogger(\n      \"debug\",\n      logger.options.name!,\n      logger.options,\n      logger.debug.bind(logger),\n      customLogger.debug?.bind(customLogger)\n    ),\n    trace: validateCustomLogger(\n      \"trace\",\n      logger.options.name!,\n      logger.options,\n      logger.trace.bind(logger),\n      customLogger.trace?.bind(customLogger)\n    )\n  } as Logger;\n\n  result.log = (type: LogLevel, message: string | LoggerMessage) => {\n    switch (type) {\n      case \"error\":\n        result.error(message);\n        break;\n      case \"warn\":\n        result.warn(message);\n        break;\n      case \"info\":\n        result.info(message);\n        break;\n      case \"debug\":\n        result.debug(message);\n        break;\n      case \"trace\":\n        result.trace(message);\n        break;\n      case \"silent\":\n        break;\n      default:\n        result.info(message);\n        break;\n    }\n  };\n\n  return result;\n};\n\nexport const consoleLogger = (\n  type: LogLevel,\n  message: string | LoggerMessage\n) =>\n  consoleLog(\n    isSetString(message)\n      ? {\n          type,\n          category: LogCategories.GENERAL,\n          logId: uuid(),\n          timestamp: Date.now()\n        }\n      : {\n          type,\n          category: LogCategories.GENERAL,\n          logId: uuid(),\n          timestamp: Date.now(),\n          ...message.meta\n        },\n    isSetString(message) ? message : message.message\n  );\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param name - The name of the logging function.\n * @param options - The options to configure the logging function, including the source, command, environment, plugin, log level, custom logger, and colors. These options can be used to customize the appearance and behavior of the log messages generated by the logging function.\n * @returns A logging function.\n */\nexport const createLogger = (\n  name: string,\n  options: LoggerOptions,\n  callback: (\n    type: LogLevel,\n    message: string | LoggerMessage\n  ) => void = consoleLogger\n): Logger => {\n  const result = {\n    options: { ...options, name },\n    error: validateLogger(\"error\", name, { ...options, name }, message =>\n      callback(\"error\", message)\n    ),\n    warn: validateLogger(\"warn\", name, { ...options, name }, message =>\n      callback(\"warn\", message)\n    ),\n    info: validateLogger(\"info\", name, { ...options, name }, message =>\n      callback(\"info\", message)\n    ),\n    debug: validateLogger(\"debug\", name, { ...options, name }, message =>\n      callback(\"debug\", message)\n    ),\n    trace: validateLogger(\"trace\", name, { ...options, name }, message =>\n      callback(\"trace\", message)\n    )\n  } as Logger;\n\n  result.log = (type: LogLevel, message: string | LoggerMessage) => {\n    switch (type) {\n      case \"error\":\n        result.error(message);\n        break;\n      case \"warn\":\n        result.warn(message);\n        break;\n      case \"info\":\n        result.info(message);\n        break;\n      case \"debug\":\n        result.debug(message);\n        break;\n      case \"trace\":\n        result.trace(message);\n        break;\n      case \"silent\":\n        break;\n      default:\n        result.info(message);\n        break;\n    }\n  };\n\n  return result;\n};\n\n/**\n * Extend a logging function with a specific name, adding a colored badge to the log output.\n *\n * @param logFn - The original logging function to extend.\n * @param options - The overlay metadata to use for the badge in the log output.\n * @returns A new logging function that includes the badge in its output.\n */\nexport const extendLogFn = (logFn: LogFn, options: LogFnOptions): LogFn => {\n  return (meta, ...args) =>\n    options.source || options.category\n      ? logFn(\n          isSetObject(meta)\n            ? { ...options, ...meta }\n            : { ...options, type: meta },\n          `${colorBackground(String(options.source || options.category))} ${args\n            .filter(Boolean)\n            .map(arg => String(arg).trim())\n            .join(\" \")} `\n        )\n      : logFn(meta, ...args);\n};\n\n/**\n * Extend a logger with a specific name and options, adding a colored badge to the log output for each log message generated by the logger.\n *\n * @param logger - The original logger to extend.\n * @param options - The options to configure the logging function, including the source, command, environment, plugin, log level, custom logger, and colors. These options can be used to customize the appearance and behavior of the log messages generated by the extended logger.\n * @returns A new logger that includes the badge in its output for each log message.\n */\nexport const extendLogger = (\n  logger: Logger,\n  options: LoggerOptions\n): Logger => {\n  const opts = { ...logger.options, ...options } as RequiredKeys<\n    LoggerOptions,\n    \"name\"\n  >;\n\n  const result = {\n    options: opts,\n    error: validateLogger(\"error\", opts.name, opts, logger.error.bind(logger)),\n    warn: validateLogger(\"warn\", opts.name, opts, logger.warn.bind(logger)),\n    info: validateLogger(\"info\", opts.name, opts, logger.info.bind(logger)),\n    debug: validateLogger(\"debug\", opts.name, opts, logger.debug.bind(logger)),\n    trace: validateLogger(\"trace\", opts.name, opts, logger.trace.bind(logger))\n  } as Logger;\n\n  result.log = (type: LogLevel, message: string | LoggerMessage) => {\n    switch (type) {\n      case \"error\":\n        result.error(message);\n        break;\n      case \"warn\":\n        result.warn(message);\n        break;\n      case \"info\":\n        result.info(message);\n        break;\n      case \"debug\":\n        result.debug(message);\n        break;\n      case \"trace\":\n        result.trace(message);\n        break;\n      case \"silent\":\n        break;\n      default:\n        result.info(message);\n        break;\n    }\n  };\n\n  return result;\n};\n"],"mappings":"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"}

package/dist/plugin-utils/paths.cjs

@@ -44,7 +44,7 @@ let _stryke_path_join = require("@stryke/path/join");
 */
 function replacePathTokens(context, path) {
 	if (!path) return path;
-	const result = path.replaceAll("{cwd}", context.config.cwd || process.cwd() || "./").replaceAll("{workspaceRoot}", context.config.cwd || process.cwd() || "./").replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", (0, _stryke_path_join.joinPaths)(context.config.root, "src")).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.path).replaceAll("{output}", context.config.output.path).replaceAll("{artifactsPath}", (0, _stryke_path_replace.replacePath)(context.artifactsPath, context.config.cwd)).replaceAll("{builtinPath}", (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.config.cwd)).replaceAll("{builtinsPath}", (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.config.cwd)).replaceAll("{entryPath}", (0, _stryke_path_replace.replacePath)(context.entryPath, context.config.cwd));
+	const result = path.replaceAll("{cwd}", context.config.cwd || process.cwd()).replaceAll("{workspaceRoot}", context.config.cwd || process.cwd()).replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", (0, _stryke_path_join.joinPaths)(context.config.root, "src")).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.path).replaceAll("{output}", context.config.output.path).replaceAll("{artifactsPath}", (0, _stryke_path_replace.replacePath)(context.artifactsPath, context.config.cwd)).replaceAll("{builtinPath}", (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.config.cwd)).replaceAll("{builtinsPath}", (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.config.cwd)).replaceAll("{entryPath}", (0, _stryke_path_replace.replacePath)(context.entryPath, context.config.cwd));
 	return context.config.output.copy && (0, _stryke_type_checks_is_set_string.isSetString)(context.config.output.copy.path) ? result.replaceAll("{copyPath}", context.config.output.copy.path).replaceAll("{copy}", context.config.output.copy.path) : result;
 }
 

package/dist/plugin-utils/paths.mjs

@@ -42,7 +42,7 @@ import { joinPaths } from "@stryke/path/join";
 */
 function replacePathTokens(context, path) {
 	if (!path) return path;
-	const result = path.replaceAll("{cwd}", context.config.cwd || process.cwd() || "./").replaceAll("{workspaceRoot}", context.config.cwd || process.cwd() || "./").replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", joinPaths(context.config.root, "src")).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.path).replaceAll("{output}", context.config.output.path).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.config.cwd)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.config.cwd)).replaceAll("{builtinsPath}", replacePath(context.builtinsPath, context.config.cwd)).replaceAll("{entryPath}", replacePath(context.entryPath, context.config.cwd));
+	const result = path.replaceAll("{cwd}", context.config.cwd || process.cwd()).replaceAll("{workspaceRoot}", context.config.cwd || process.cwd()).replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", joinPaths(context.config.root, "src")).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.path).replaceAll("{output}", context.config.output.path).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.config.cwd)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.config.cwd)).replaceAll("{builtinsPath}", replacePath(context.builtinsPath, context.config.cwd)).replaceAll("{entryPath}", replacePath(context.entryPath, context.config.cwd));
 	return context.config.output.copy && isSetString(context.config.output.copy.path) ? result.replaceAll("{copyPath}", context.config.output.copy.path).replaceAll("{copy}", context.config.output.copy.path) : result;
 }
 

package/dist/plugin-utils/paths.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"paths.mjs","names":[],"sources":["../../src/plugin-utils/paths.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { IsUndefined } from \"@stryke/types/base\";\nimport { UnresolvedContext } from \"../types/context\";\n\n/**\n * Replaces tokens in the given path string with their corresponding values from the context.\n *\n * @remarks\n * The following tokens are supported:\n * - `{cwd}` - The current working directory.\n * - `{workspaceRoot}` - The current working directory (same as `{cwd}`).\n * - `{root}` - The root directory of the project (same as `{projectRoot}`).\n * - `{projectRoot}` - The root directory of the project (same as `{root}`).\n * - `{sourceRoot}` - The source root directory of the project (usually `{root}/src`).\n * - `{powerlinesPath}` - The directory where Powerlines is installed.\n * - `{cachePath}` - The environment's directory for cached files.\n * - `{dataPath}` - The environment's directory for data files.\n * - `{logPath}` - The environment's directory for log files.\n * - `{tempPath}` - The environment's directory for temporary files.\n * - `{configPath}` - The environment's directory for configuration files.\n * - `{output}` - The configured output directory for the project.\n * - `{outputPath}` - The configured output directory for the project.\n * - `{copy}` - The configured final/copied distribution directory for the project.\n * - `{copyPath}` - The configured final/copied distribution directory for the project.\n * - `{artifactsPath}` - The configured directory for build artifacts.\n * - `{builtinPath}` - The configured directory for generated built-in plugins.\n * - `{entryPath}` - The configured directory for generated entry files.\n *\n * @example\n * ```ts\n * const path = replacePathTokens(context, \"{root}/dist\");\n * // If context.config.root is \"/home/user/project\", this will return \"/home/user/project/dist\"\n *\n * const pathWithCopy = replacePathTokens(context, \"{copy}\");\n * // If context.config.output.copy.path is \"/home/user/project/dist-copy\", this will return \"/home/user/project/dist-copy\"\n * ```\n *\n * @param context - The context containing the values for the path tokens.\n * @param path - The path string with tokens to replace.\n * @returns The path string with tokens replaced by their corresponding values from the context.\n */\nexport function replacePathTokens(\n  context: UnresolvedContext,\n  path?: string\n): IsUndefined<typeof path> extends true ? undefined : string {\n  if (!path) {\n    return path as IsUndefined<typeof path> extends true ? undefined : string;\n  }\n\n  const result = path\n    .replaceAll(\"{cwd}\", context.config.cwd || process.cwd() || \"./\")\n    .replaceAll(\"{workspaceRoot}\", context.config.cwd || process.cwd() || \"./\")\n    .replaceAll(\"{root}\", context.config.root)\n    .replaceAll(\"{projectRoot}\", context.config.root)\n    .replaceAll(\"{sourceRoot}\", joinPaths(context.config.root, \"src\"))\n    .replaceAll(\"{powerlinesPath}\", context.powerlinesPath)\n    .replaceAll(\"{cachePath}\", context.cachePath)\n    .replaceAll(\"{dataPath}\", context.dataPath)\n    .replaceAll(\"{logPath}\", context.envPaths.log)\n    .replaceAll(\"{tempPath}\", context.envPaths.temp)\n    .replaceAll(\"{configPath}\", context.envPaths.config)\n    .replaceAll(\"{outputPath}\", context.config.output.path)\n    .replaceAll(\"{output}\", context.config.output.path)\n\n    .replaceAll(\n      \"{artifactsPath}\",\n      replacePath(context.artifactsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{builtinPath}\",\n      replacePath(context.builtinsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{builtinsPath}\",\n      replacePath(context.builtinsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{entryPath}\",\n      replacePath(context.entryPath, context.config.cwd)\n    );\n\n  return context.config.output.copy &&\n    isSetString(context.config.output.copy.path)\n    ? result\n        .replaceAll(\"{copyPath}\", context.config.output.copy.path)\n        .replaceAll(\"{copy}\", context.config.output.copy.path)\n    : result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,SAAgB,kBACd,SACA,MAC4D;AAC5D,KAAI,CAAC,KACH,QAAO;CAGT,MAAM,SAAS,KACZ,WAAW,SAAS,QAAQ,OAAO,OAAO,QAAQ,KAAK,IAAI,KAAK,CAChE,WAAW,mBAAmB,QAAQ,OAAO,OAAO,QAAQ,KAAK,IAAI,KAAK,CAC1E,WAAW,UAAU,QAAQ,OAAO,KAAK,CACzC,WAAW,iBAAiB,QAAQ,OAAO,KAAK,CAChD,WAAW,gBAAgB,UAAU,QAAQ,OAAO,MAAM,MAAM,CAAC,CACjE,WAAW,oBAAoB,QAAQ,eAAe,CACtD,WAAW,eAAe,QAAQ,UAAU,CAC5C,WAAW,cAAc,QAAQ,SAAS,CAC1C,WAAW,aAAa,QAAQ,SAAS,IAAI,CAC7C,WAAW,cAAc,QAAQ,SAAS,KAAK,CAC/C,WAAW,gBAAgB,QAAQ,SAAS,OAAO,CACnD,WAAW,gBAAgB,QAAQ,OAAO,OAAO,KAAK,CACtD,WAAW,YAAY,QAAQ,OAAO,OAAO,KAAK,CAElD,WACC,mBACA,YAAY,QAAQ,eAAe,QAAQ,OAAO,IAAI,CACvD,CACA,WACC,iBACA,YAAY,QAAQ,cAAc,QAAQ,OAAO,IAAI,CACtD,CACA,WACC,kBACA,YAAY,QAAQ,cAAc,QAAQ,OAAO,IAAI,CACtD,CACA,WACC,eACA,YAAY,QAAQ,WAAW,QAAQ,OAAO,IAAI,CACnD;AAEH,QAAO,QAAQ,OAAO,OAAO,QAC3B,YAAY,QAAQ,OAAO,OAAO,KAAK,KAAK,GAC1C,OACG,WAAW,cAAc,QAAQ,OAAO,OAAO,KAAK,KAAK,CACzD,WAAW,UAAU,QAAQ,OAAO,OAAO,KAAK,KAAK,GACxD"}
+{"version":3,"file":"paths.mjs","names":[],"sources":["../../src/plugin-utils/paths.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { joinPaths } from \"@stryke/path/join\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { IsUndefined } from \"@stryke/types/base\";\nimport { UnresolvedContext } from \"../types/context\";\n\n/**\n * Replaces tokens in the given path string with their corresponding values from the context.\n *\n * @remarks\n * The following tokens are supported:\n * - `{cwd}` - The current working directory.\n * - `{workspaceRoot}` - The current working directory (same as `{cwd}`).\n * - `{root}` - The root directory of the project (same as `{projectRoot}`).\n * - `{projectRoot}` - The root directory of the project (same as `{root}`).\n * - `{sourceRoot}` - The source root directory of the project (usually `{root}/src`).\n * - `{powerlinesPath}` - The directory where Powerlines is installed.\n * - `{cachePath}` - The environment's directory for cached files.\n * - `{dataPath}` - The environment's directory for data files.\n * - `{logPath}` - The environment's directory for log files.\n * - `{tempPath}` - The environment's directory for temporary files.\n * - `{configPath}` - The environment's directory for configuration files.\n * - `{output}` - The configured output directory for the project.\n * - `{outputPath}` - The configured output directory for the project.\n * - `{copy}` - The configured final/copied distribution directory for the project.\n * - `{copyPath}` - The configured final/copied distribution directory for the project.\n * - `{artifactsPath}` - The configured directory for build artifacts.\n * - `{builtinPath}` - The configured directory for generated built-in plugins.\n * - `{entryPath}` - The configured directory for generated entry files.\n *\n * @example\n * ```ts\n * const path = replacePathTokens(context, \"{root}/dist\");\n * // If context.config.root is \"/home/user/project\", this will return \"/home/user/project/dist\"\n *\n * const pathWithCopy = replacePathTokens(context, \"{copy}\");\n * // If context.config.output.copy.path is \"/home/user/project/dist-copy\", this will return \"/home/user/project/dist-copy\"\n * ```\n *\n * @param context - The context containing the values for the path tokens.\n * @param path - The path string with tokens to replace.\n * @returns The path string with tokens replaced by their corresponding values from the context.\n */\nexport function replacePathTokens(\n  context: UnresolvedContext,\n  path?: string\n): IsUndefined<typeof path> extends true ? undefined : string {\n  if (!path) {\n    return path as IsUndefined<typeof path> extends true ? undefined : string;\n  }\n\n  const result = path\n    .replaceAll(\"{cwd}\", context.config.cwd || process.cwd())\n    .replaceAll(\"{workspaceRoot}\", context.config.cwd || process.cwd())\n    .replaceAll(\"{root}\", context.config.root)\n    .replaceAll(\"{projectRoot}\", context.config.root)\n    .replaceAll(\"{sourceRoot}\", joinPaths(context.config.root, \"src\"))\n    .replaceAll(\"{powerlinesPath}\", context.powerlinesPath)\n    .replaceAll(\"{cachePath}\", context.cachePath)\n    .replaceAll(\"{dataPath}\", context.dataPath)\n    .replaceAll(\"{logPath}\", context.envPaths.log)\n    .replaceAll(\"{tempPath}\", context.envPaths.temp)\n    .replaceAll(\"{configPath}\", context.envPaths.config)\n    .replaceAll(\"{outputPath}\", context.config.output.path)\n    .replaceAll(\"{output}\", context.config.output.path)\n    .replaceAll(\n      \"{artifactsPath}\",\n      replacePath(context.artifactsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{builtinPath}\",\n      replacePath(context.builtinsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{builtinsPath}\",\n      replacePath(context.builtinsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{entryPath}\",\n      replacePath(context.entryPath, context.config.cwd)\n    );\n\n  return context.config.output.copy &&\n    isSetString(context.config.output.copy.path)\n    ? result\n        .replaceAll(\"{copyPath}\", context.config.output.copy.path)\n        .replaceAll(\"{copy}\", context.config.output.copy.path)\n    : result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,SAAgB,kBACd,SACA,MAC4D;AAC5D,KAAI,CAAC,KACH,QAAO;CAGT,MAAM,SAAS,KACZ,WAAW,SAAS,QAAQ,OAAO,OAAO,QAAQ,KAAK,CAAC,CACxD,WAAW,mBAAmB,QAAQ,OAAO,OAAO,QAAQ,KAAK,CAAC,CAClE,WAAW,UAAU,QAAQ,OAAO,KAAK,CACzC,WAAW,iBAAiB,QAAQ,OAAO,KAAK,CAChD,WAAW,gBAAgB,UAAU,QAAQ,OAAO,MAAM,MAAM,CAAC,CACjE,WAAW,oBAAoB,QAAQ,eAAe,CACtD,WAAW,eAAe,QAAQ,UAAU,CAC5C,WAAW,cAAc,QAAQ,SAAS,CAC1C,WAAW,aAAa,QAAQ,SAAS,IAAI,CAC7C,WAAW,cAAc,QAAQ,SAAS,KAAK,CAC/C,WAAW,gBAAgB,QAAQ,SAAS,OAAO,CACnD,WAAW,gBAAgB,QAAQ,OAAO,OAAO,KAAK,CACtD,WAAW,YAAY,QAAQ,OAAO,OAAO,KAAK,CAClD,WACC,mBACA,YAAY,QAAQ,eAAe,QAAQ,OAAO,IAAI,CACvD,CACA,WACC,iBACA,YAAY,QAAQ,cAAc,QAAQ,OAAO,IAAI,CACtD,CACA,WACC,kBACA,YAAY,QAAQ,cAAc,QAAQ,OAAO,IAAI,CACtD,CACA,WACC,eACA,YAAY,QAAQ,WAAW,QAAQ,OAAO,IAAI,CACnD;AAEH,QAAO,QAAQ,OAAO,OAAO,QAC3B,YAAY,QAAQ,OAAO,OAAO,KAAK,KAAK,GAC1C,OACG,WAAW,cAAc,QAAQ,OAAO,OAAO,KAAK,KAAK,CACzD,WAAW,UAAU,QAAQ,OAAO,OAAO,KAAK,KAAK,GACxD"}

package/dist/types/config.d.cts

@@ -1,6 +1,6 @@
 import { StoragePort, StoragePreset } from "./fs.cjs";
 import { Plugin } from "./plugin.cjs";
-import { CreateLoggerFunction, LogLevelResolvedConfig, LogLevelUserConfig } from "./log.cjs";
+import { CustomLogger, LogLevelResolvedConfig, LogLevelUserConfig } from "./logging.cjs";
 import { TSConfig } from "./tsconfig.cjs";
 import { PluginContext } from "./context.cjs";
 import { Format } from "@storm-software/build-tools/types";
@@ -234,6 +234,10 @@ interface OutputConfig {
   storage?: StoragePort | StoragePreset;
 }
 interface EngineOptions {
+  /**
+   * The name of the project
+   */
+  name?: string;
   /**
    * The root directory of the project
    */
@@ -276,7 +280,7 @@ interface EngineOptions {
    */
   configFile?: string;
 }
-type ResolvedEngineOptions = PartialKeys<Required<EngineOptions>, "organization" | "configFile">;
+type ResolvedEngineOptions = PartialKeys<Required<EngineOptions>, "organization" | "configFile" | "name">;
 interface ExecutionOptions extends EngineOptions {
   /**
    * A unique identifier for the current execution instance, which can be used for logging and other purposes to distinguish between different executions in the same process.
@@ -429,9 +433,12 @@ interface UserConfig extends Config, ExecutionOptions {
    */
   logLevel?: LogLevelUserConfig;
   /**
-   * A custom logger function that can be provided by the user to handle log messages in a specific way, such as sending them to an external logging service or formatting them differently. If a custom logger is provided, it will be used instead of the default logging mechanism.
+   * A custom logger instance that implements the {@link CustomLogger} interface, which can be used for logging messages during the build process instead of the default Powerlines logger.
+   *
+   * @remarks
+   * Providing a custom logger allows you to integrate Powerlines logging with your own logging system or to customize the logging behavior, such as formatting log messages differently or sending logs to an external service. If a custom logger is not provided, Powerlines will use its default logger implementation.
    */
-  customLogger?: CreateLoggerFunction;
+  customLogger?: CustomLogger;
   /**
    * The type of project being built
    *

package/dist/types/config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/types/config.ts"],"mappings":"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"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/types/config.ts"],"mappings":"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"}

package/dist/types/config.d.mts

@@ -1,6 +1,6 @@
 import { StoragePort, StoragePreset } from "./fs.mjs";
 import { Plugin } from "./plugin.mjs";
-import { CreateLoggerFunction, LogLevelResolvedConfig, LogLevelUserConfig } from "./log.mjs";
+import { CustomLogger, LogLevelResolvedConfig, LogLevelUserConfig } from "./logging.mjs";
 import { TSConfig } from "./tsconfig.mjs";
 import { PluginContext } from "./context.mjs";
 import { ConfigLayer, ResolvedConfig } from "c12";
@@ -234,6 +234,10 @@ interface OutputConfig {
   storage?: StoragePort | StoragePreset;
 }
 interface EngineOptions {
+  /**
+   * The name of the project
+   */
+  name?: string;
   /**
    * The root directory of the project
    */
@@ -276,7 +280,7 @@ interface EngineOptions {
    */
   configFile?: string;
 }
-type ResolvedEngineOptions = PartialKeys<Required<EngineOptions>, "organization" | "configFile">;
+type ResolvedEngineOptions = PartialKeys<Required<EngineOptions>, "organization" | "configFile" | "name">;
 interface ExecutionOptions extends EngineOptions {
   /**
    * A unique identifier for the current execution instance, which can be used for logging and other purposes to distinguish between different executions in the same process.
@@ -429,9 +433,12 @@ interface UserConfig extends Config, ExecutionOptions {
    */
   logLevel?: LogLevelUserConfig;
   /**
-   * A custom logger function that can be provided by the user to handle log messages in a specific way, such as sending them to an external logging service or formatting them differently. If a custom logger is provided, it will be used instead of the default logging mechanism.
+   * A custom logger instance that implements the {@link CustomLogger} interface, which can be used for logging messages during the build process instead of the default Powerlines logger.
+   *
+   * @remarks
+   * Providing a custom logger allows you to integrate Powerlines logging with your own logging system or to customize the logging behavior, such as formatting log messages differently or sending logs to an external service. If a custom logger is not provided, Powerlines will use its default logger implementation.
    */
-  customLogger?: CreateLoggerFunction;
+  customLogger?: CustomLogger;
   /**
    * The type of project being built
    *

package/dist/types/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"mappings":"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"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"mappings":"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"}

package/dist/types/context.d.cts

@@ -1,7 +1,7 @@
 import { ResolveOptions, VirtualFile, VirtualFileSystemInterface, WriteOptions } from "./fs.cjs";
 import { Plugin } from "./plugin.cjs";
 import { HooksList, HooksListItem } from "./hooks.cjs";
-import { LogFn, LogFnConfig, LogLevelResolvedConfig, LogMeta } from "./log.cjs";
+import { LogLevelResolvedConfig, LogMessage, Logger, LoggerOptions } from "./logging.cjs";
 import { ParsedTypeScriptConfig } from "./tsconfig.cjs";
 import { EngineOptions, EnvironmentResolvedConfig, ParsedUserConfig, ResolvedConfig, ResolvedEngineOptions, ResolvedEntryTypeDefinition, ResolvedExecutionOptions } from "./config.cjs";
 import { Jiti } from "jiti";
@@ -13,7 +13,7 @@ import { ParseResult, ParserOptions } from "oxc-parser";
 import { Range } from "semver";
 import { RequestInfo, Response } from "undici";
 import { Unimport } from "unimport";
-import { ExternalIdResult, UnpluginBuildContext, UnpluginMessage } from "unplugin";
+import { ExternalIdResult, UnpluginBuildContext } from "unplugin";
 
 //#region src/types/context.d.ts
 interface MetaInfo {
@@ -129,9 +129,6 @@ interface ResolveResult extends ExternalIdResult {
    */
   virtual?: boolean;
 }
-interface PowerlinesMessage extends UnpluginMessage {
-  meta: Partial<LogMeta>;
-}
 /**
  * The base Powerlines context.
  *
@@ -164,33 +161,33 @@ interface BaseContext {
    */
   logLevel: LogLevelResolvedConfig;
   /**
-   * A logging function for the Powerlines engine
+   * An instance of the Powerlines logger client that can be used to generate log messages with consistent formatting and metadata.
    */
-  log: LogFn;
+  logger: Logger;
   /**
    * A logging function for fatal messages
    */
-  fatal: (message: string | PowerlinesMessage) => void;
+  fatal: (message: string | LogMessage) => void;
   /**
    * A logging function for error messages
    */
-  error: (message: string | PowerlinesMessage) => void;
+  error: (message: string | LogMessage) => void;
   /**
    * A logging function for warning messages
    */
-  warn: (message: string | PowerlinesMessage) => void;
+  warn: (message: string | LogMessage) => void;
   /**
    * A logging function for informational messages
    */
-  info: (message: string | PowerlinesMessage) => void;
+  info: (message: string | LogMessage) => void;
   /**
    * A logging function for debug messages
    */
-  debug: (message: string | PowerlinesMessage) => void;
+  debug: (message: string | LogMessage) => void;
   /**
    * A logging function for trace messages
    */
-  trace: (message: string | PowerlinesMessage) => void;
+  trace: (message: string | LogMessage) => void;
   /**
    * A function to create a timer for measuring the duration of asynchronous operations
    *
@@ -208,17 +205,17 @@ interface BaseContext {
   /**
    * Create a new logger instance
    *
-   * @param config - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.
-   * @returns A logger function
+   * @param options - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.
+   * @returns A logger client instance that can be used to generate log messages with consistent formatting and metadata.
    */
-  createLog: (config?: LogFnConfig) => LogFn;
+  createLogger: (options: LoggerOptions) => Logger;
   /**
    * Extend the current logger instance with a new source
    *
-   * @param config - The overlay metadata to use for the badge in the log output.
-   * @returns A logger function
+   * @param options - The overlay metadata to use for the badge in the log output.
+   * @returns A logger client instance that extends the current logger with the provided configuration options.
    */
-  extendLog: (config: LogFnConfig) => LogFn;
+  extendLogger: (options: LoggerOptions) => Logger;
   /**
    * A function to create a deep clone of the context
    *
@@ -708,13 +705,6 @@ interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The environment specific resolved configuration
    */
   environment: EnvironmentResolvedConfig;
-  /**
-   * An alternative property name for the {@link log} property
-   *
-   * @remarks
-   * This is provided for compatibility with other logging libraries that expect a `logger` property.
-   */
-  logger: LogFn;
   /**
    * A function to create a deep clone of the context
    *
@@ -737,7 +727,6 @@ declare type __ΩParseOptions = any[];
 declare type __ΩEmitOptions = any[];
 declare type __ΩEmitEntryOptions = any[];
 declare type __ΩResolveResult = any[];
-declare type __ΩPowerlinesMessage = any[];
 declare type __ΩBaseContext = any[];
 declare type __ΩExecutionStateItem = any[];
 declare type __ΩHookExecutionStateItem = any[];
@@ -754,5 +743,5 @@ declare type __ΩPluginContext = any[];
 declare type __ΩBuildPluginContext = any[];
 declare type __ΩWithUnpluginBuildContext = any[];
 //#endregion
-export { BaseContext, BuildPluginContext, Context, EmitEntryOptions, EmitOptions, EngineContext, EnvironmentContext, EnvironmentContextPlugin, ExecutionContext, ExecutionState, ExecutionStateItem, FetchOptions, HookExecutionStateItem, InitContextOptions, MetaInfo, ParseOptions, PluginContext, PowerlinesMessage, ResolveResult, Resolver, SelectHookResult, SelectHookResultItem, SelectHooksOptions, SourceFile, TransformResult$1 as TransformResult, UnimportContext, UnresolvedContext, WithUnpluginBuildContext, __ΩBaseContext, __ΩBuildPluginContext, __ΩContext, __ΩEmitEntryOptions, __ΩEmitOptions, __ΩEngineContext, __ΩEnvironmentContext, __ΩEnvironmentContextPlugin, __ΩExecutionContext, __ΩExecutionState, __ΩExecutionStateItem, __ΩFetchOptions, __ΩHookExecutionStateItem, __ΩInitContextOptions, __ΩMetaInfo, __ΩParseOptions, __ΩPluginContext, __ΩPowerlinesMessage, __ΩResolveResult, __ΩResolver, __ΩSelectHookResult, __ΩSelectHookResultItem, __ΩSelectHooksOptions, __ΩSourceFile, __ΩTransformResult, __ΩUnimportContext, __ΩUnresolvedContext, __ΩWithUnpluginBuildContext };
+export { BaseContext, BuildPluginContext, Context, EmitEntryOptions, EmitOptions, EngineContext, EnvironmentContext, EnvironmentContextPlugin, ExecutionContext, ExecutionState, ExecutionStateItem, FetchOptions, HookExecutionStateItem, InitContextOptions, MetaInfo, ParseOptions, PluginContext, ResolveResult, Resolver, SelectHookResult, SelectHookResultItem, SelectHooksOptions, SourceFile, TransformResult$1 as TransformResult, UnimportContext, UnresolvedContext, WithUnpluginBuildContext, __ΩBaseContext, __ΩBuildPluginContext, __ΩContext, __ΩEmitEntryOptions, __ΩEmitOptions, __ΩEngineContext, __ΩEnvironmentContext, __ΩEnvironmentContextPlugin, __ΩExecutionContext, __ΩExecutionState, __ΩExecutionStateItem, __ΩFetchOptions, __ΩHookExecutionStateItem, __ΩInitContextOptions, __ΩMetaInfo, __ΩParseOptions, __ΩPluginContext, __ΩResolveResult, __ΩResolver, __ΩSelectHookResult, __ΩSelectHookResultItem, __ΩSelectHooksOptions, __ΩSourceFile, __ΩTransformResult, __ΩUnimportContext, __ΩUnresolvedContext, __ΩWithUnpluginBuildContext };
 //# sourceMappingURL=context.d.cts.map

package/dist/types/context.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.cts","names":[],"sources":["../../src/types/context.ts"],"mappings":"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"}
+{"version":3,"file":"context.d.cts","names":[],"sources":["../../src/types/context.ts"],"mappings":"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"}

package/dist/types/context.d.mts

@@ -1,10 +1,10 @@
 import { ResolveOptions, VirtualFile, VirtualFileSystemInterface, WriteOptions } from "./fs.mjs";
 import { Plugin } from "./plugin.mjs";
 import { HooksList, HooksListItem } from "./hooks.mjs";
-import { LogFn, LogFnConfig, LogLevelResolvedConfig, LogMeta } from "./log.mjs";
+import { LogLevelResolvedConfig, LogMessage, Logger, LoggerOptions } from "./logging.mjs";
 import { ParsedTypeScriptConfig } from "./tsconfig.mjs";
 import { EngineOptions, EnvironmentResolvedConfig, ParsedUserConfig, ResolvedConfig, ResolvedEngineOptions, ResolvedEntryTypeDefinition, ResolvedExecutionOptions } from "./config.mjs";
-import { ExternalIdResult, UnpluginBuildContext, UnpluginMessage } from "unplugin";
+import { ExternalIdResult, UnpluginBuildContext } from "unplugin";
 import MagicString, { SourceMap } from "magic-string";
 import { Jiti } from "jiti";
 import { EnvPaths } from "@stryke/env/get-env-paths";
@@ -129,9 +129,6 @@ interface ResolveResult extends ExternalIdResult {
    */
   virtual?: boolean;
 }
-interface PowerlinesMessage extends UnpluginMessage {
-  meta: Partial<LogMeta>;
-}
 /**
  * The base Powerlines context.
  *
@@ -164,33 +161,33 @@ interface BaseContext {
    */
   logLevel: LogLevelResolvedConfig;
   /**
-   * A logging function for the Powerlines engine
+   * An instance of the Powerlines logger client that can be used to generate log messages with consistent formatting and metadata.
    */
-  log: LogFn;
+  logger: Logger;
   /**
    * A logging function for fatal messages
    */
-  fatal: (message: string | PowerlinesMessage) => void;
+  fatal: (message: string | LogMessage) => void;
   /**
    * A logging function for error messages
    */
-  error: (message: string | PowerlinesMessage) => void;
+  error: (message: string | LogMessage) => void;
   /**
    * A logging function for warning messages
    */
-  warn: (message: string | PowerlinesMessage) => void;
+  warn: (message: string | LogMessage) => void;
   /**
    * A logging function for informational messages
    */
-  info: (message: string | PowerlinesMessage) => void;
+  info: (message: string | LogMessage) => void;
   /**
    * A logging function for debug messages
    */
-  debug: (message: string | PowerlinesMessage) => void;
+  debug: (message: string | LogMessage) => void;
   /**
    * A logging function for trace messages
    */
-  trace: (message: string | PowerlinesMessage) => void;
+  trace: (message: string | LogMessage) => void;
   /**
    * A function to create a timer for measuring the duration of asynchronous operations
    *
@@ -208,17 +205,17 @@ interface BaseContext {
   /**
    * Create a new logger instance
    *
-   * @param config - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.
-   * @returns A logger function
+   * @param options - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.
+   * @returns A logger client instance that can be used to generate log messages with consistent formatting and metadata.
    */
-  createLog: (config?: LogFnConfig) => LogFn;
+  createLogger: (options: LoggerOptions) => Logger;
   /**
    * Extend the current logger instance with a new source
    *
-   * @param config - The overlay metadata to use for the badge in the log output.
-   * @returns A logger function
+   * @param options - The overlay metadata to use for the badge in the log output.
+   * @returns A logger client instance that extends the current logger with the provided configuration options.
    */
-  extendLog: (config: LogFnConfig) => LogFn;
+  extendLogger: (options: LoggerOptions) => Logger;
   /**
    * A function to create a deep clone of the context
    *
@@ -708,13 +705,6 @@ interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The environment specific resolved configuration
    */
   environment: EnvironmentResolvedConfig;
-  /**
-   * An alternative property name for the {@link log} property
-   *
-   * @remarks
-   * This is provided for compatibility with other logging libraries that expect a `logger` property.
-   */
-  logger: LogFn;
   /**
    * A function to create a deep clone of the context
    *
@@ -737,7 +727,6 @@ declare type __ΩParseOptions = any[];
 declare type __ΩEmitOptions = any[];
 declare type __ΩEmitEntryOptions = any[];
 declare type __ΩResolveResult = any[];
-declare type __ΩPowerlinesMessage = any[];
 declare type __ΩBaseContext = any[];
 declare type __ΩExecutionStateItem = any[];
 declare type __ΩHookExecutionStateItem = any[];
@@ -754,5 +743,5 @@ declare type __ΩPluginContext = any[];
 declare type __ΩBuildPluginContext = any[];
 declare type __ΩWithUnpluginBuildContext = any[];
 //#endregion
-export { BaseContext, BuildPluginContext, Context, EmitEntryOptions, EmitOptions, EngineContext, EnvironmentContext, EnvironmentContextPlugin, ExecutionContext, ExecutionState, ExecutionStateItem, FetchOptions, HookExecutionStateItem, InitContextOptions, MetaInfo, ParseOptions, PluginContext, PowerlinesMessage, ResolveResult, Resolver, SelectHookResult, SelectHookResultItem, SelectHooksOptions, SourceFile, TransformResult$1 as TransformResult, UnimportContext, UnresolvedContext, WithUnpluginBuildContext, __ΩBaseContext, __ΩBuildPluginContext, __ΩContext, __ΩEmitEntryOptions, __ΩEmitOptions, __ΩEngineContext, __ΩEnvironmentContext, __ΩEnvironmentContextPlugin, __ΩExecutionContext, __ΩExecutionState, __ΩExecutionStateItem, __ΩFetchOptions, __ΩHookExecutionStateItem, __ΩInitContextOptions, __ΩMetaInfo, __ΩParseOptions, __ΩPluginContext, __ΩPowerlinesMessage, __ΩResolveResult, __ΩResolver, __ΩSelectHookResult, __ΩSelectHookResultItem, __ΩSelectHooksOptions, __ΩSourceFile, __ΩTransformResult, __ΩUnimportContext, __ΩUnresolvedContext, __ΩWithUnpluginBuildContext };
+export { BaseContext, BuildPluginContext, Context, EmitEntryOptions, EmitOptions, EngineContext, EnvironmentContext, EnvironmentContextPlugin, ExecutionContext, ExecutionState, ExecutionStateItem, FetchOptions, HookExecutionStateItem, InitContextOptions, MetaInfo, ParseOptions, PluginContext, ResolveResult, Resolver, SelectHookResult, SelectHookResultItem, SelectHooksOptions, SourceFile, TransformResult$1 as TransformResult, UnimportContext, UnresolvedContext, WithUnpluginBuildContext, __ΩBaseContext, __ΩBuildPluginContext, __ΩContext, __ΩEmitEntryOptions, __ΩEmitOptions, __ΩEngineContext, __ΩEnvironmentContext, __ΩEnvironmentContextPlugin, __ΩExecutionContext, __ΩExecutionState, __ΩExecutionStateItem, __ΩFetchOptions, __ΩHookExecutionStateItem, __ΩInitContextOptions, __ΩMetaInfo, __ΩParseOptions, __ΩPluginContext, __ΩResolveResult, __ΩResolver, __ΩSelectHookResult, __ΩSelectHookResultItem, __ΩSelectHooksOptions, __ΩSourceFile, __ΩTransformResult, __ΩUnimportContext, __ΩUnresolvedContext, __ΩWithUnpluginBuildContext };
 //# sourceMappingURL=context.d.mts.map