@powerlines/core 0.44.0 → 0.44.1

package/dist/plugin-utils/logging.d.mts

@@ -1,6 +1,7 @@
-import { LogLevelResolvedConfig, LogLevelUserConfig } from "../types/log.mjs";
+import { CustomLogger, LogCategory, LogFn, LogFnOptions, LogLevel, LogLevelResolvedConfig, LogLevelUserConfig, LogMeta, Logger, LoggerMessage, LoggerOptions } from "../types/logging.mjs";
 import { UnresolvedContext } from "../types/context.mjs";
 import { Mode } from "../types/config.mjs";
+
 //#region src/plugin-utils/logging.d.ts
 /**
  * Determines if the provided log level is considered verbose (debug or trace).
@@ -23,7 +24,80 @@ declare function isVerbose(context: UnresolvedContext): boolean;
  * @param mode - The current mode of the application (e.g., "development", "test", "production"), which determines the default log levels.
  * @returns A LogLevelResolvedConfig object specifying the log level for each log category.
  */
-declare function resolveLogLevel(logLevel: LogLevelUserConfig, mode?: Mode): LogLevelResolvedConfig;
+declare function resolveLogLevel(logLevel?: LogLevelUserConfig, mode?: Mode): LogLevelResolvedConfig;
+/**
+ * Generate a consistent color based on the input text.
+ *
+ * @param text - The input text to generate the color from.
+ * @return A hexadecimal color string.
+ */
+declare const getTextColor: (text: string) => string;
+/**
+ * Generate a consistent color based on the input text.
+ *
+ * @param text - The input text to generate the color from.
+ * @return A hexadecimal color string.
+ */
+declare const colorText: (text: string) => string;
+/**
+ * Generate a consistent color based on the input text.
+ *
+ * @param text - The input text to generate the color from.
+ * @return A hexadecimal color string.
+ */
+declare const colorBackground: (text: string) => string;
+declare const consoleLog: (meta: LogMeta, ...args: string[]) => void;
+declare function isValidLogLevel(logLevel: LogLevel, type: LogLevel): boolean;
+declare function isValidLogLevelConfig(type: LogLevel, logLevel: LogLevelResolvedConfig, category?: LogCategory): boolean;
+/**
+ * Create a logging function with a specific name and options.
+ *
+ * @param name - The name of the logging function.
+ * @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.
+ * @returns A logging function.
+ */
+declare const createLogFn: (name: string, options: LogFnOptions) => LogFn;
+/**
+ * Create a logging function with a specific name and options.
+ *
+ * @param logger - The original logger to wrap with the custom logger.
+ * @param secondaryLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.
+ * @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.
+ */
+declare const withLogger: (logger: Logger, secondaryLogger: Logger) => Logger;
+/**
+ * Create a logging function with a specific name and options.
+ *
+ * @param logger - The original logger to wrap with the custom logger.
+ * @param customLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.
+ * @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.
+ */
+declare const withCustomLogger: (logger: Logger, customLogger: CustomLogger) => Logger;
+declare const consoleLogger: (type: LogLevel, message: string | LoggerMessage) => void;
+/**
+ * Create a logging function with a specific name and options.
+ *
+ * @param name - The name of the logging function.
+ * @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.
+ * @returns A logging function.
+ */
+declare const createLogger: (name: string, options: LoggerOptions, callback?: (type: LogLevel, message: string | LoggerMessage) => void) => Logger;
+/**
+ * Extend a logging function with a specific name, adding a colored badge to the log output.
+ *
+ * @param logFn - The original logging function to extend.
+ * @param options - The overlay metadata to use for the badge in the log output.
+ * @returns A new logging function that includes the badge in its output.
+ */
+declare const extendLogFn: (logFn: LogFn, options: LogFnOptions) => LogFn;
+/**
+ * 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.
+ *
+ * @param logger - The original logger to extend.
+ * @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.
+ * @returns A new logger that includes the badge in its output for each log message.
+ */
+declare const extendLogger: (logger: Logger, options: LoggerOptions) => Logger;
 //#endregion
-export { isVerbose, resolveLogLevel };
+export { colorBackground, colorText, consoleLog, consoleLogger, createLogFn, createLogger, extendLogFn, extendLogger, getTextColor, isValidLogLevel, isValidLogLevelConfig, isVerbose, resolveLogLevel, withCustomLogger, withLogger };
 //# sourceMappingURL=logging.d.mts.map

package/dist/plugin-utils/logging.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.mts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;;;AAoCA;;iBAAgB,SAAA,CAAU,QAAA;;;AAQ1B;;;;iBAAgB,SAAA,CAAU,OAAA,EAAS,iBAAA;AAyBnC;;;;;;;AAAA,iBAAgB,eAAA,CACd,QAAA,EAAU,kBAAA,EACV,IAAA,GAAO,IAAA,GACN,sBAAA"}
+{"version":3,"file":"logging.d.mts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;AA2DA;;;;;iBAAgB,SAAA,CAAU,QAAA;;;;;AAiC1B;;iBAzBgB,SAAA,CAAU,OAAA,EAAS,iBAAA;;;;;;;;iBAyBnB,eAAA,CACd,QAAA,GAAW,kBAAA,EACX,IAAA,GAAO,IAAA,GACN,sBAAA;;;;;AA2FH;;cAAa,YAAA,GAAgB,IAAA;;;AAiB7B;;;;cAAa,SAAA,GAAa,IAAA;AAY1B;;;;;AAMA;AANA,cAAa,eAAA,GAAmB,IAAA;AAAA,cAMnB,UAAA,GAAc,IAAA,EAAM,OAAA,KAAY,IAAA;AAAA,iBA2B7B,eAAA,CAAgB,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,QAAA;AAAA,iBAQ1C,qBAAA,CACd,IAAA,EAAM,QAAA,EACN,QAAA,EAAU,sBAAA,EACV,QAAA,GAAU,WAAA;;;;;AAXZ;;;cAuBa,WAAA,GAAe,IAAA,UAAc,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;AAflE;cAoJa,UAAA,GAAc,MAAA,EAAQ,MAAA,EAAQ,eAAA,EAAiB,MAAA,KAAS,MAAA;;;;;;;;cA4DxD,gBAAA,GACX,MAAA,EAAQ,MAAA,EACR,YAAA,EAAc,YAAA,KACb,MAAA;AAAA,cAyCU,aAAA,GACX,IAAA,EAAM,QAAA,EACN,OAAA,WAAkB,aAAA;;;;;;AA/OpB;;cA0Qa,YAAA,GACX,IAAA,UACA,OAAA,EAAS,aAAA,EACT,QAAA,IACE,IAAA,EAAM,QAAA,EACN,OAAA,WAAkB,aAAA,cAEnB,MAAA;;;;;;;;cA4BU,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;;cAsBrD,YAAA,GACX,MAAA,EAAQ,MAAA,EACR,OAAA,EAAS,aAAA,KACR,MAAA"}

package/dist/plugin-utils/logging.mjs

@@ -1,8 +1,16 @@
+import { LOG_LEVELS, LogCategories, LogLevels } from "../types/logging.mjs";
+import { DEFAULT_ENVIRONMENT } from "../constants/environments.mjs";
 import { DEFAULT_DEVELOPMENT_LOG_LEVEL, DEFAULT_PRODUCTION_LOG_LEVEL, DEFAULT_TEST_LOG_LEVEL } from "../constants/log-level.mjs";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { defu as defu$1 } from "defu";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import { isString } from "@stryke/type-checks/is-string";
+import { kebabCase } from "@stryke/string-format/kebab-case";
+import { titleCase } from "@stryke/string-format/title-case";
+import { getLogFn, getLogLevel } from "@storm-software/config-tools/logger";
+import { getColor } from "@storm-software/config-tools/utilities/colors";
+import { uuid } from "@stryke/unique-id/uuid";
+import chalk from "chalk";
 
 //#region src/plugin-utils/logging.ts
 /**
@@ -32,7 +40,8 @@ function resolveLogLevel(logLevel, mode) {
 		hooks: "trace",
 		env: "trace",
 		ipc: "trace",
-		config: "trace"
+		config: "trace",
+		babel: "trace"
 	};
 	else if (logLevel === "silent") return {
 		general: "silent",
@@ -43,7 +52,8 @@ function resolveLogLevel(logLevel, mode) {
 		hooks: "silent",
 		env: "silent",
 		ipc: "silent",
-		config: "silent"
+		config: "silent",
+		babel: "silent"
 	};
 	let defaultLogLevel;
 	if (mode === "development") defaultLogLevel = DEFAULT_DEVELOPMENT_LOG_LEVEL;
@@ -58,12 +68,309 @@ function resolveLogLevel(logLevel, mode) {
 		hooks: logLevel,
 		env: defaultLogLevel.env,
 		ipc: defaultLogLevel.ipc,
-		config: defaultLogLevel.config
+		config: defaultLogLevel.config,
+		babel: logLevel
 	};
 	else if (isSetObject(logLevel)) return defu$1(logLevel, defaultLogLevel);
 	return defaultLogLevel;
 }
+const BADGE_COLORS = [
+	"#00A0DD",
+	"#6FCE4E",
+	"#FBBF24",
+	"#F43F5E",
+	"#3B82F6",
+	"#A855F7",
+	"#469592",
+	"#288EDF",
+	"#D8B4FE",
+	"#10B981",
+	"#EF4444",
+	"#F0EC56",
+	"#F472B6",
+	"#22D3EE",
+	"#EAB308",
+	"#84CC16",
+	"#F87171",
+	"#0EA5E9",
+	"#D946EF",
+	"#FACC15",
+	"#34D399",
+	"#8B5CF6"
+];
+const BRAND_COLOR = getColor("brand");
+/**
+* Generate a consistent color based on the input text.
+*
+* @param text - The input text to generate the color from.
+* @return A hexadecimal color string.
+*/
+const getTextColor = (text) => {
+	return BADGE_COLORS[text.split("").map((char) => char.charCodeAt(0)).reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length] || BADGE_COLORS[0];
+};
+/**
+* Generate a consistent color based on the input text.
+*
+* @param text - The input text to generate the color from.
+* @return A hexadecimal color string.
+*/
+const colorText = (text) => {
+	const title = titleCase(text);
+	return chalk.hex(getTextColor(title))(title);
+};
+/**
+* Generate a consistent color based on the input text.
+*
+* @param text - The input text to generate the color from.
+* @return A hexadecimal color string.
+*/
+const colorBackground = (text) => {
+	const title = titleCase(text);
+	return chalk.inverse.hex(getTextColor(title))(` ${title} `);
+};
+const consoleLog = (meta, ...args) => getLogFn(getLogLevel(meta.type), { logLevel: "trace" })(`${meta.name ? chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.name)) : ""}${meta.command ? chalk.hex(BRAND_COLOR)(` (${meta.command})`) : ""}${meta.name ? chalk.grey(" > ") : ""}${(meta.source || meta.plugin) && (!meta.name || kebabCase(meta.source || meta.plugin) !== kebabCase(meta.name)) ? `${chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.source || meta.plugin))}${chalk.grey(" > ")}` : ""}${meta.environment && kebabCase(meta.environment) !== "default" ? `${chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.environment))}${chalk.grey(" > ")}` : ""}${meta.category && meta.category !== LogCategories.GENERAL ? ` ${colorBackground(kebabCase(meta.category))} ` : ""}${args.join(" ")} `.trim());
+function isValidLogLevel(logLevel, type) {
+	if (logLevel === LogLevels.SILENT) return false;
+	return LOG_LEVELS.indexOf(logLevel) >= LOG_LEVELS.indexOf(type);
+}
+function isValidLogLevelConfig(type, logLevel, category = LogCategories.GENERAL) {
+	return isValidLogLevel(logLevel[category], type);
+}
+/**
+* Create a logging function with a specific name and options.
+*
+* @param name - The name of the logging function.
+* @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.
+* @returns A logging function.
+*/
+const createLogFn = (name, options) => {
+	const logLevel = resolveLogLevel(options.logLevel, options.mode);
+	return (meta, ...args) => {
+		const logMeta = isSetObject(meta) ? {
+			logId: uuid(),
+			timestamp: Date.now(),
+			category: LogCategories.GENERAL,
+			...options,
+			...meta,
+			name
+		} : {
+			logId: uuid(),
+			timestamp: Date.now(),
+			category: LogCategories.GENERAL,
+			...options,
+			type: meta,
+			name
+		};
+		if (isValidLogLevelConfig(logMeta.type, logLevel, logMeta.category ? logMeta.category : LogCategories.GENERAL)) consoleLog(logMeta, ...args);
+	};
+};
+const validateLogger = (type, name, options, callback) => {
+	const logLevel = resolveLogLevel(options.logLevel, options.mode);
+	return (message) => {
+		const params = isSetString(message) ? {
+			name,
+			plugin: options.plugin,
+			meta: {
+				type,
+				name,
+				category: LogCategories.GENERAL,
+				logId: uuid(),
+				timestamp: Date.now(),
+				...options
+			},
+			message
+		} : {
+			name,
+			plugin: options.plugin,
+			...message,
+			meta: {
+				type,
+				name,
+				category: LogCategories.GENERAL,
+				logId: uuid(),
+				timestamp: Date.now(),
+				plugin: message.plugin,
+				...options,
+				...message.meta
+			}
+		};
+		if (isValidLogLevelConfig(type, logLevel, params.meta.category)) callback(params);
+	};
+};
+const validateCustomLogger = (type, name, options, callback, customCallback) => {
+	const logLevel = resolveLogLevel(options.logLevel, options.mode);
+	return (message) => {
+		const params = isSetString(message) ? {
+			name,
+			plugin: options.plugin,
+			meta: {
+				type,
+				name,
+				category: LogCategories.GENERAL,
+				logId: uuid(),
+				timestamp: Date.now(),
+				...options
+			},
+			message
+		} : {
+			name,
+			plugin: options.plugin,
+			...message,
+			meta: {
+				type,
+				name,
+				category: LogCategories.GENERAL,
+				logId: uuid(),
+				timestamp: Date.now(),
+				plugin: message.plugin,
+				...options,
+				...message.meta
+			}
+		};
+		if (isValidLogLevelConfig(type, logLevel, params.meta.category)) {
+			callback?.(params);
+			customCallback?.(params);
+		}
+	};
+};
+/**
+* Create a logging function with a specific name and options.
+*
+* @param logger - The original logger to wrap with the custom logger.
+* @param secondaryLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.
+* @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.
+*/
+const withLogger = (logger, secondaryLogger) => {
+	const options = {
+		...secondaryLogger.options,
+		...logger.options
+	};
+	return {
+		options,
+		error: validateLogger("error", options.name, options, (message) => {
+			logger.error?.(message);
+			secondaryLogger.error?.(message);
+		}),
+		warn: validateLogger("warn", options.name, options, (message) => {
+			logger.warn?.(message);
+			secondaryLogger.warn?.(message);
+		}),
+		info: validateLogger("info", options.name, options, (message) => {
+			logger.info?.(message);
+			secondaryLogger.info?.(message);
+		}),
+		debug: validateLogger("debug", options.name, options, (message) => {
+			logger.debug?.(message);
+			secondaryLogger.debug?.(message);
+		}),
+		trace: validateLogger("trace", options.name, options, (message) => {
+			logger.trace?.(message);
+			secondaryLogger.trace?.(message);
+		})
+	};
+};
+/**
+* Create a logging function with a specific name and options.
+*
+* @param logger - The original logger to wrap with the custom logger.
+* @param customLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.
+* @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.
+*/
+const withCustomLogger = (logger, customLogger) => {
+	return {
+		options: logger.options,
+		error: validateCustomLogger("error", logger.options.name, logger.options, logger.error.bind(logger), customLogger.error?.bind(customLogger)),
+		warn: validateCustomLogger("warn", logger.options.name, logger.options, logger.warn.bind(logger), customLogger.warn?.bind(customLogger)),
+		info: validateCustomLogger("info", logger.options.name, logger.options, logger.info.bind(logger), customLogger.info?.bind(customLogger)),
+		debug: validateCustomLogger("debug", logger.options.name, logger.options, logger.debug.bind(logger), customLogger.debug?.bind(customLogger)),
+		trace: validateCustomLogger("trace", logger.options.name, logger.options, logger.trace.bind(logger), customLogger.trace?.bind(customLogger))
+	};
+};
+const consoleLogger = (type, message) => consoleLog(isSetString(message) ? {
+	type,
+	category: LogCategories.GENERAL,
+	logId: uuid(),
+	timestamp: Date.now()
+} : {
+	type,
+	category: LogCategories.GENERAL,
+	logId: uuid(),
+	timestamp: Date.now(),
+	...message
+}, isSetString(message) ? message : message.message);
+/**
+* Create a logging function with a specific name and options.
+*
+* @param name - The name of the logging function.
+* @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.
+* @returns A logging function.
+*/
+const createLogger = (name, options, callback = consoleLogger) => {
+	return {
+		options: {
+			...options,
+			name
+		},
+		error: validateLogger("error", name, {
+			...options,
+			name
+		}, (message) => callback("error", message)),
+		warn: validateLogger("warn", name, {
+			...options,
+			name
+		}, (message) => callback("warn", message)),
+		info: validateLogger("info", name, {
+			...options,
+			name
+		}, (message) => callback("info", message)),
+		debug: validateLogger("debug", name, {
+			...options,
+			name
+		}, (message) => callback("debug", message)),
+		trace: validateLogger("trace", name, {
+			...options,
+			name
+		}, (message) => callback("trace", message))
+	};
+};
+/**
+* Extend a logging function with a specific name, adding a colored badge to the log output.
+*
+* @param logFn - The original logging function to extend.
+* @param options - The overlay metadata to use for the badge in the log output.
+* @returns A new logging function that includes the badge in its output.
+*/
+const extendLogFn = (logFn, options) => {
+	return (meta, ...args) => options.source || options.category ? logFn(isSetObject(meta) ? {
+		...options,
+		...meta
+	} : {
+		...options,
+		type: meta
+	}, `${colorBackground(String(options.source || options.category))} ${args.filter(Boolean).map((arg) => String(arg).trim()).join(" ")} `) : logFn(meta, ...args);
+};
+/**
+* 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.
+*
+* @param logger - The original logger to extend.
+* @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.
+* @returns A new logger that includes the badge in its output for each log message.
+*/
+const extendLogger = (logger, options) => {
+	const opts = {
+		...logger.options,
+		...options
+	};
+	return {
+		options: opts,
+		error: validateLogger("error", opts.name, opts, logger.error.bind(logger)),
+		warn: validateLogger("warn", opts.name, opts, logger.warn.bind(logger)),
+		info: validateLogger("info", opts.name, opts, logger.info.bind(logger)),
+		debug: validateLogger("debug", opts.name, opts, logger.debug.bind(logger)),
+		trace: validateLogger("trace", opts.name, opts, logger.trace.bind(logger))
+	};
+};
 
 //#endregion
-export { isVerbose, resolveLogLevel };
+export { colorBackground, colorText, consoleLog, consoleLogger, createLogFn, createLogger, extendLogFn, extendLogger, getTextColor, isValidLogLevel, isValidLogLevelConfig, isVerbose, resolveLogLevel, withCustomLogger, withLogger };
 //# sourceMappingURL=logging.mjs.map

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  return {\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  };\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  return {\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  };\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\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  return {\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  };\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  return {\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  };\n};\n"],"mappings":"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"}

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
    *