@powerlines/engine 0.44.0 → 0.44.2

package/dist/{execution-context-zedP0h4Z.mjs → execution-context-CFJst4Fz.mjs}

@@ -1,19 +1,19 @@
-import { t as PowerlinesBaseContext } from "./base-context-D_ZidDDm.mjs";
+import { t as PowerlinesBaseContext } from "./base-context-fOM4ZWUo.mjs";
 import { a as FileSystem } from "./fs-D1nIP45P.mjs";
-import { n as FileSystemStorageAdapter, t as VirtualStorageAdapter } from "./virtual-CUgOdyIa.mjs";
-import { i as getTsconfigFilePath } from "./tsconfig-Cstsoprg.mjs";
+import { n as FileSystemStorageAdapter, t as VirtualStorageAdapter } from "./virtual-CYGZHTDd.mjs";
+import { i as getTsconfigFilePath } from "./tsconfig-CI6bla4E.mjs";
 import { CACHE_HASH_LENGTH, DEFAULT_DEVELOPMENT_LOG_LEVEL, DEFAULT_ENVIRONMENT, DEFAULT_PRODUCTION_LOG_LEVEL, DEFAULT_TEST_LOG_LEVEL, GLOBAL_ENVIRONMENT, PLUGIN_NON_HOOK_FIELDS, ROOT_HASH_LENGTH } from "@powerlines/core/constants";
+import { toArray } from "@stryke/convert/to-array";
 import { getResolutionCombinations, resolve, resolvePackage, resolveSync } from "@stryke/fs/resolve";
 import { joinPaths } from "@stryke/path/join";
-import { createLogFn, extendLogFn } from "@powerlines/core";
 import { isSet } from "@stryke/type-checks/is-set";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { isString } from "@stryke/type-checks/is-string";
-import { toArray } from "@stryke/convert/to-array";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import { uuid } from "@stryke/unique-id/uuid";
-import { colorText } from "@powerlines/core/lib/logger";
-import { addPluginHook, dedupeHooklist, isDuplicate, isPlugin, isPluginConfig, isPluginHook, isPluginHookField, mergeConfig, replacePathTokens } from "@powerlines/core/plugin-utils";
+import { addPluginHook, createLogger, dedupeHooklist, isDuplicate, isPlugin, isPluginConfig, isPluginHook, isPluginHookField, mergeConfig, replacePathTokens, withCustomLogger, withLogger } from "@powerlines/core/plugin-utils";
+import { colorText } from "@powerlines/core/plugin-utils/logging";
+import { appendPath } from "@stryke/path/append";
 import { isEqual } from "@stryke/path/is-equal";
 import { replaceExtension, replacePath } from "@stryke/path/replace";
 import chalk from "chalk";
@@ -24,7 +24,6 @@ import { format } from "@powerlines/core/lib/utilities/format";
 import { existsSync } from "@stryke/fs/exists";
 import { getUnique, getUniqueBy } from "@stryke/helpers/get-unique";
 import { omit } from "@stryke/helpers/omit";
-import { appendPath } from "@stryke/path/append";
 import { findFileDotExtensionSafe, findFileExtensionSafe, findFileName, findFilePath, hasFileExtension } from "@stryke/path/file-path-fns";
 import { isParentPath } from "@stryke/path/is-parent-path";
 import { isFunction } from "@stryke/type-checks/is-function";
@@ -43,6 +42,7 @@ import { create } from "flat-cache";
 import { parse } from "oxc-parser";
 import { Agent, Response, interceptors, setGlobalDispatcher } from "undici";
 import "@stryke/fs/remove-file";
+import { LogCategories } from "@powerlines/core";
 import * as capnp from "@stryke/capnp";
 import { readFileBuffer, readFileBufferSync, writeFileBuffer } from "@stryke/fs/buffer";
 import { correctPath, stripStars } from "@stryke/path/correct-path";
@@ -143,6 +143,40 @@ async function writeMetaFile(context) {
 	await context.fs.write(metaFilePath, JSON.stringify(context.meta, null, 2));
 }
 
+//#endregion
+//#region src/_internal/ipc/send.ts
+function sendWriteLogMessage(context, type, message) {
+	const meta = {
+		...isSetObject(message) && isSetObject(message.meta) ? message.meta : {},
+		...context.logger.options
+	};
+	process.send?.({
+		id: uuid(),
+		type: "write-log",
+		executionId: meta.executionId ?? context.config.executionId,
+		executionIndex: meta.executionIndex ?? context.config.executionIndex,
+		environment: meta.environment,
+		timestamp: Date.now(),
+		payload: {
+			meta: {
+				type,
+				category: meta.category ?? LogCategories.GENERAL,
+				logId: meta.logId ?? uuid(),
+				timestamp: meta.timestamp ?? Date.now(),
+				name: meta.name ?? context.config.name,
+				executionId: meta.executionId ?? context.config.executionId,
+				executionIndex: meta.executionIndex ?? context.config.executionIndex,
+				command: meta.command ?? context.config.command,
+				hook: meta.hook,
+				environment: meta.environment,
+				plugin: meta.plugin,
+				source: meta.source
+			},
+			message: isSetString(message) ? message : message.message
+		}
+	});
+}
+
 //#endregion
 //#region src/_internal/helpers/constants.ts
 const DEFAULT_EXTENSIONS = [
@@ -254,9 +288,9 @@ var VirtualFileSystem = class VirtualFileSystem {
 	*/
 	#context;
 	/**
-	* The file system's logging function.
+	* The file system's logger client utility.
 	*/
-	#log;
+	#logger;
 	/**
 	* Normalizes a given module id by resolving it against the built-ins path.
 	*
@@ -470,7 +504,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 				}
 			}));
 		} else result = new VirtualFileSystem(context, new capnp.Message().initRoot(FileSystem));
-		result.#log("debug", "Successfully completed virtual file system (VFS) initialization.");
+		result.#logger.debug("Successfully completed virtual file system (VFS) initialization.");
 		return result;
 	}
 	/**
@@ -504,7 +538,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 				}
 			});
 		} else result = new VirtualFileSystem(context, new capnp.Message().initRoot(FileSystem));
-		result.#log("debug", "Successfully completed virtual file system (VFS) initialization.");
+		result.#logger.debug("Successfully completed virtual file system (VFS) initialization.");
 		return result;
 	}
 	/**
@@ -638,7 +672,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 				return ret;
 			}, {});
 		}
-		this.#log = context.extendLog({
+		this.#logger = context.extendLogger({
 			source: "VFS",
 			category: "fs"
 		});
@@ -768,7 +802,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	listSync(path) {
 		let resolvedPath = path;
 		if (resolvedPath.includes("*")) {
-			this.#log("warn", `Invoking "listSync" with a glob pattern is not supported. It is likely you meant to use "globSync". Path: ${path}`);
+			this.#logger.warn(`Invoking "listSync" with a glob pattern is not supported. It is likely you meant to use "globSync". Path: ${path}`);
 			resolvedPath = stripStars(resolvedPath);
 		}
 		return getUnique(this.#getStorages(resolvedPath, true).map((storage) => storage.adapter.listSync(storage.relativeBase ? storage.base ? appendPath(storage.relativeBase, storage.base) : storage.relativeBase : storage.base)).flat().filter(Boolean));
@@ -782,7 +816,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	async list(path) {
 		let resolvedPath = path;
 		if (resolvedPath.includes("*")) {
-			this.#log("warn", `Invoking "list" with a glob pattern is not supported. It is likely you meant to use "glob". Path: ${path}`);
+			this.#logger.warn(`Invoking "list" with a glob pattern is not supported. It is likely you meant to use "glob". Path: ${path}`);
 			resolvedPath = stripStars(resolvedPath);
 		}
 		return getUnique((await Promise.all(this.#getStorages(resolvedPath, true).map(async (storage) => storage.adapter.list(storage.relativeBase ? storage.base ? appendPath(storage.relativeBase, storage.base) : storage.relativeBase : storage.base)))).flat().filter(Boolean));
@@ -794,7 +828,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	*/
 	async remove(path) {
 		const normalizedPath = this.#normalizePath(path);
-		this.#log("trace", `Removing file: ${normalizedPath}`);
+		this.#logger.trace(`Removing file: ${normalizedPath}`);
 		const { relativeKey, adapter } = this.#getStorage(normalizedPath);
 		if (hasFileExtension(normalizedPath)) await adapter.remove(relativeKey);
 		else await adapter.clear(relativeKey);
@@ -812,7 +846,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	*/
 	removeSync(path) {
 		const normalizedPath = this.#normalizePath(path);
-		this.#log("trace", `Removing file: ${normalizedPath}`);
+		this.#logger.trace(`Removing file: ${normalizedPath}`);
 		const { relativeKey, adapter } = this.#getStorage(normalizedPath);
 		if (hasFileExtension(normalizedPath)) adapter.removeSync(relativeKey);
 		else adapter.clearSync(relativeKey);
@@ -958,7 +992,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const filePath = await this.resolve(path, void 0, { isFile: true });
 		if (!filePath || !this.existsSync(filePath)) return;
 		const { adapter } = this.#getStorage(filePath);
-		this.#log("trace", `Reading ${adapter.name} file: ${filePath}`);
+		this.#logger.trace(`Reading ${adapter.name} file: ${filePath}`);
 		return await adapter.get(filePath) ?? void 0;
 	}
 	/**
@@ -971,7 +1005,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const filePath = this.resolveSync(path, void 0, { isFile: true });
 		if (!filePath || !this.existsSync(filePath)) return;
 		const { adapter } = this.#getStorage(filePath);
-		this.#log("trace", `Reading ${adapter.name} file: ${filePath}`);
+		this.#logger.trace(`Reading ${adapter.name} file: ${filePath}`);
 		return adapter.getSync(filePath) ?? void 0;
 	}
 	/**
@@ -986,15 +1020,15 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const meta = options.meta ?? {};
 		const resolvedPath = await this.resolve(this.#normalizePath(path)) || path;
 		const { relativeKey, adapter } = this.#getStorage(resolvedPath, options.storage);
-		this.#log("trace", `Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(data)).size)})`);
+		this.#logger.trace(`Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(data)).size)})`);
 		let code = data;
 		try {
 			if (!options.skipFormat) code = await format(this.#context, resolvedPath, data);
 		} catch (err) {
-			if (DEFAULT_EXTENSIONS.includes(findFileExtensionSafe(resolvedPath, { fullExtension: true }))) this.#log("warn", `Failed to format file ${resolvedPath} before writing: ${err.message}`);
+			if (DEFAULT_EXTENSIONS.includes(findFileExtensionSafe(resolvedPath, { fullExtension: true }))) this.#logger.warn(`Failed to format file ${resolvedPath} before writing: ${err.message}`);
 			code = data;
 		}
-		this.#log("trace", `Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(code)).size)})`);
+		this.#logger.trace(`Writing ${resolvedPath} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(code)).size)})`);
 		const id = this.#normalizeId(meta.id || resolvedPath);
 		this.metadata[id] = {
 			type: "normal",
@@ -1017,7 +1051,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 		const meta = options.meta ?? {};
 		const resolvedPath = this.resolveSync(this.#normalizePath(path)) || path;
 		const { relativeKey, adapter } = this.#getStorage(resolvedPath, options.storage);
-		this.#log("trace", `Writing ${resolvedPath} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(data)).size)})`);
+		this.#logger.trace(`Writing ${resolvedPath} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(data)).size)})`);
 		const id = this.#normalizeId(meta.id || resolvedPath);
 		this.metadata[id] = {
 			type: "normal",
@@ -1181,7 +1215,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 	async dispose() {
 		if (!this.#isDisposed) {
 			this.#isDisposed = true;
-			this.#log("debug", "Disposing virtual file system...");
+			this.#logger.debug("Disposing virtual file system...");
 			await this.remove(joinPaths(this.#context.dataPath, "fs.bin"));
 			const message = new capnp.Message();
 			const fs = message.initRoot(FileSystem);
@@ -1216,7 +1250,7 @@ var VirtualFileSystem = class VirtualFileSystem {
 			await writeFileBuffer(joinPaths(this.#context.dataPath, "fs.bin"), message.toArrayBuffer());
 			if (!this.#context.config.skipCache) this.resolverCache.save(true);
 			await Promise.all(this.#getStorages().map(async (storage) => storage.adapter.dispose()));
-			this.#log("trace", "Virtual file system has been disposed.");
+			this.#logger.trace("Virtual file system has been disposed.");
 		}
 	}
 	/**
@@ -1477,6 +1511,18 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		}, {}) : this.config.resolve.alias : {});
 	}
 	/**
+	* The logger instance for the context, which can be used to create log messages with consistent formatting and metadata. This logger is extended by plugin contexts to include additional metadata such as the plugin name and category, which can be used to filter and format log messages in a more granular way.
+	*/
+	get logger() {
+		const options = {
+			...this.config,
+			...this.options
+		};
+		const logger = withLogger(createLogger(this.config.name, options), createLogger(this.config.name, options, (type, message) => sendWriteLogMessage(this, type, message)));
+		if (this.config.customLogger) return withCustomLogger(logger, this.config.customLogger);
+		return logger;
+	}
+	/**
 	* Gets the parser cache.
 	*/
 	get parserCache() {
@@ -1531,60 +1577,6 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		this.options = options;
 	}
 	/**
-	* Create a new log function with the specified configuration, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
-	*
-	* @param config - Optional configuration for the log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
-	* @returns A log function that can be used to log messages with the specified configuration.
-	*/
-	createLog(config) {
-		const log = createLogFn({
-			...config,
-			logLevel: this.logLevel
-		});
-		return (meta, ...args) => {
-			log(meta, ...args);
-			process.send?.({
-				id: uuid(),
-				type: "write-log",
-				executionId: config?.executionId ?? this.options.executionId,
-				executionIndex: config?.executionIndex ?? this.options.executionIndex,
-				timestamp: Date.now(),
-				payload: {
-					level: meta && isSetObject(meta) && isSetString(meta.level) ? meta.level : isSetString(meta) ? meta : "info",
-					...config,
-					args
-				}
-			});
-		};
-	}
-	/**
-	* Extend the current log function instance with a new name
-	*
-	* @param config - The configuration for the extended log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the log function instance according to your needs.
-	* @returns A log function
-	*/
-	extendLog(config) {
-		const log = extendLogFn(this.log, {
-			...config,
-			logLevel: this.logLevel
-		});
-		return (meta, ...args) => {
-			log(meta, ...args);
-			process.send?.({
-				id: uuid(),
-				type: "write-log",
-				executionId: config.executionId ?? this.options.executionId,
-				executionIndex: config.executionIndex ?? this.options.executionIndex,
-				timestamp: Date.now(),
-				payload: {
-					level: meta && isSetObject(meta) && isSetString(meta.level) ? meta.level : isSetString(meta) ? meta : "info",
-					...config,
-					args
-				}
-			});
-		};
-	}
-	/**
 	* Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.
 	*
 	* @remarks
@@ -1627,6 +1619,9 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 				headers: cached.headers
 			});
 		}
+		const logger = this.extendLogger({ category: "network" });
+		const startTime = Date.now();
+		logger.trace(`Sending fetch request (${options.method?.toUpperCase() || "GET"}): ${input.toString()}`);
 		const response = await fetchRequest(input, {
 			timeout: 12e3,
 			...options
@@ -1640,6 +1635,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		if (!this.config.skipCache && !options.skipCache) try {
 			this.requestCache.set(cacheKey, result);
 		} catch {}
+		logger.trace(`Fetch request (${options.method?.toUpperCase() || "GET"}) completed in ${Date.now() - startTime}ms: ${input.toString()} - ${response.status} / ${response.statusText} \n - Response Headers: ${JSON.stringify(result.headers)}\n - Response Body: ${typeof result.body === "string" ? result.body.length > 1e3 ? `${result.body.slice(0, 1e3)}... (truncated, total length: ${result.body.length})` : result.body : "[Non-string body]"}`);
 		return new Response(result.body, {
 			status: result.status,
 			statusText: result.statusText,
@@ -2015,6 +2011,13 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 	* Initialize the context with the provided configuration options
 	*/
 	async innerSetup() {
+		const logger = this.extendLogger({ category: "config" });
+		logger.trace(`Pre-setup Powerlines configuration object: \n${JSON.stringify({
+			...omit(this.config, ["plugins"]),
+			userConfig: this.config.userConfig ? omit(this.config.userConfig, ["plugins"]) : {},
+			inlineConfig: this.config.inlineConfig ? omit(this.config.inlineConfig, ["plugins"]) : {},
+			pluginConfig: this.config.pluginConfig ? omit(this.config.pluginConfig, ["plugins"]) : {}
+		}, null, 2)}`);
 		if (!this.inputOptions.mode && !this.config.userConfig?.mode && !this.config.inlineConfig?.mode && !this.config.pluginConfig?.mode) {
 			this.options.mode = "production";
 			this.config.mode = "production";
@@ -2041,8 +2044,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		else this.config.logLevel = DEFAULT_PRODUCTION_LOG_LEVEL;
 		if (!this.config.userConfig?.tsconfig && !this.config.inlineConfig?.tsconfig) this.config.tsconfig = getTsconfigFilePath(this.config.cwd, this.config.root);
 		else if (this.config.tsconfig) this.config.tsconfig = replacePath(replacePathTokens(this, this.config.tsconfig), this.config.cwd);
-		this.resolvedConfig.output = defu(this.config.output ?? {}, {
-			path: joinPaths(this.config.root, "dist"),
+		this.config.output = defu(this.config.output ?? {}, {
 			copy: { assets: [
 				{ glob: "LICENSE" },
 				{
@@ -2059,6 +2061,7 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		});
 		this.config.output.format = getUnique(toArray(this.config.output?.format ?? (this.config.projectType === "library" ? ["cjs", "esm"] : ["esm"])));
 		if (this.config.output.path) this.config.output.path = appendPath(replacePathTokens(this, this.config.output.path), this.config.cwd);
+		else this.config.output.path = appendPath(joinPaths(this.config.root, "dist"), this.config.cwd);
 		if (this.config.output.copy !== false) {
 			this.config.output.copy ??= {};
 			if (!this.config.root.replace(/^\.\/?/, "")) this.config.output.copy.path = this.config.output.copy.path ? appendPath(replacePathTokens(this, this.config.output.copy.path), this.config.cwd) : this.config.output.path;
@@ -2086,7 +2089,12 @@ var PowerlinesContext = class PowerlinesContext extends PowerlinesBaseContext {
 		}));
 		if (isSetString(this.config.output?.storage) && this.config.output.storage === "virtual" || isSetObject(this.config.output?.storage) && Object.values(this.config.output.storage).every((adapter) => adapter.preset === "virtual")) this.config.output.overwrite = true;
 		this.#fs ??= await VirtualFileSystem.create(this);
-		this.extendLog({ category: "config" })("debug", `Resolved Powerlines configuration object: \n${JSON.stringify(this.resolvedConfig, null, 2)}`);
+		if (isSetObject(this.config.userConfig) && isSetObject(this.config.inlineConfig) && isSetObject(this.config.pluginConfig)) logger.debug(`Resolved Powerlines configuration object: \n${JSON.stringify({
+			...omit(this.config, ["plugins"]),
+			userConfig: this.config.userConfig ? omit(this.config.userConfig, ["plugins"]) : {},
+			inlineConfig: this.config.inlineConfig ? omit(this.config.inlineConfig, ["plugins"]) : {},
+			pluginConfig: this.config.pluginConfig ? omit(this.config.pluginConfig, ["plugins"]) : {}
+		}, null, 2)}`);
 	}
 };
 
@@ -2136,7 +2144,7 @@ function mergeConfigs(currentResult, previousResults) {
 async function callHook(context, key, options, ...args) {
 	const hooks = context.selectHooks(key, options);
 	if (hooks.length > 0) {
-		context.debug(` 🧩 Calling ${hooks.length} ${chalk.bold.cyanBright(`${key}${options?.order ? ` (${options.order})` : ""}`)} plugin hook${hooks.length > 1 ? "s" : ""}:\n${hooks.map((hook, index) => ` ${index + 1}. ${colorText(hook.plugin.name)}`).join("\n")}`);
+		context.extendLogger({ category: "hooks" }).debug(` 🧩 Calling ${hooks.length} ${chalk.bold.cyanBright(`${key}${options?.order ? ` (${options.order})` : ""}`)} plugin hook${hooks.length > 1 ? "s" : ""}:\n${hooks.map((hook, index) => ` ${index + 1}. ${colorText(hook.plugin.name)}`).join("\n")}`);
 		const invokeHook = async (hook, hookArgs) => {
 			return Reflect.apply(hook.handler, hook.context, hookArgs);
 		};
@@ -2236,7 +2244,7 @@ function createPluginContext(pluginId, plugin, environment) {
 	const normalizeMessage = (message) => {
 		return isString(message) ? message : message.message;
 	};
-	const log = environment.extendLog({ plugin: plugin.name.replaceAll(":", " - ") });
+	const logger = environment.extendLogger({ plugin: plugin.name.replaceAll(":", " - ") });
 	const callHookFn = async (hook, options, ...args) => {
 		return environment.$$internal.api.callHook(hook, {
 			sequential: true,
@@ -2255,24 +2263,24 @@ function createPluginContext(pluginId, plugin, environment) {
 				meta
 			};
 			if (prop === "id") return pluginId;
-			if (prop === "log" || prop === "logger") return log;
+			if (prop === "logger") return logger;
 			if (prop === "fatal") return (message) => {
-				log("error", normalizeMessage(message));
+				logger.error(normalizeMessage(message));
 			};
 			if (prop === "error") return (message) => {
-				log("error", normalizeMessage(message));
+				logger.error(normalizeMessage(message));
 			};
 			if (prop === "warn") return (message) => {
-				log("warn", normalizeMessage(message));
+				logger.warn(normalizeMessage(message));
 			};
 			if (prop === "info") return (message) => {
-				log("info", normalizeMessage(message));
+				logger.info(normalizeMessage(message));
 			};
 			if (prop === "debug") return (message) => {
-				log("debug", normalizeMessage(message));
+				logger.debug(normalizeMessage(message));
 			};
 			if (prop === "trace") return (message) => {
-				log("trace", normalizeMessage(message));
+				logger.trace(normalizeMessage(message));
 			};
 			return environment[prop];
 		},
@@ -2291,7 +2299,7 @@ function createPluginContext(pluginId, plugin, environment) {
 				"addPlugin",
 				"selectHooks"
 			].includes(prop)) {
-				log("warn", `Cannot set read-only property "${String(prop)}"`);
+				logger.warn(`Cannot set the read-only "${String(prop)}" property`);
 				return false;
 			}
 			environment[prop] = value;
@@ -2343,26 +2351,26 @@ var PowerlinesEnvironmentContext = class PowerlinesEnvironmentContext extends Po
 		return this.#hooks;
 	}
 	/**
-	* Create a new log function with the specified configuration, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
+	* Create a new logger instance
 	*
-	* @param config - Optional configuration for the log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
-	* @returns A log function that can be used to log messages with the specified configuration.
+	* @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) {
-		return super.createLog({
-			...config,
+	createLogger(options, callback) {
+		return super.createLogger({
+			...options,
 			environment: this.environment?.name
-		});
+		}, callback);
 	}
 	/**
-	* Extend the current log function instance with a new name
+	* Extend the base logger with additional configuration options
 	*
-	* @param config - The configuration for the extended log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the log function instance according to your needs.
-	* @returns A log function
+	* @param options - The configuration options to extend the base logger with, which can be used to add additional metadata or customize the appearance of log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance, as well as any additional metadata such as the plugin category or environment.
+	* @returns A new logger client instance that extends the base logger with the provided configuration options.
 	*/
-	extendLog(config) {
-		return super.extendLog({
-			...config,
+	extendLogger(options) {
+		return super.extendLogger({
+			...options,
 			environment: this.environment?.name
 		});
 	}
@@ -2548,27 +2556,27 @@ var PowerlinesExecutionContext = class PowerlinesExecutionContext extends Powerl
 		super(options);
 	}
 	/**
-	* Create a new log function with the specified configuration, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
+	* Create a new logger instance
 	*
-	* @param config - Optional configuration for the log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the logger instance according to your needs.
-	* @returns A log function that can be used to log messages with the specified configuration.
+	* @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) {
-		return super.createLog({
-			...config,
+	createLogger(options, callback) {
+		return super.createLogger({
+			...options,
 			executionId: this.id,
 			executionIndex: this.options.executionIndex
-		});
+		}, callback);
 	}
 	/**
-	* Extend the current log function instance with a new name
+	* Extend the base logger with additional configuration options
 	*
-	* @param config - The configuration for the extended log function instance, which can include properties such as log level, colors, and other metadata to be included with each log message. This allows you to customize the behavior and appearance of the log function instance according to your needs.
-	* @returns A log function
+	* @param options - The configuration options to extend the base logger with, which can be used to add additional metadata or customize the appearance of log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance, as well as any additional metadata such as the plugin category or environment.
+	* @returns A new logger client instance that extends the base logger with the provided configuration options.
 	*/
-	extendLog(config) {
-		return super.extendLog({
-			...config,
+	extendLogger(options) {
+		return super.extendLogger({
+			...options,
 			executionId: this.id,
 			executionIndex: this.options.executionIndex
 		});
@@ -2675,4 +2683,4 @@ var PowerlinesExecutionContext = class PowerlinesExecutionContext extends Powerl
 
 //#endregion
 export { mergeConfigs as a, callHook as i, PowerlinesEnvironmentContext as n, PowerlinesContext as o, createPluginContext as r, writeMetaFile as s, PowerlinesExecutionContext as t };
-//# sourceMappingURL=execution-context-zedP0h4Z.mjs.map
+//# sourceMappingURL=execution-context-CFJst4Fz.mjs.map