@powerlines/engine 0.44.1 → 0.44.2

package/dist/index.cjs

@@ -1,7 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_chunk = require('./chunk-C0xms8kb.cjs');
-const require_engine_context = require('./engine-context-CDSR7PHF.cjs');
+const require_engine_context = require('./engine-context-CUPubmrM.cjs');
 let _powerlines_core_constants = require("@powerlines/core/constants");
+let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_fs_resolve = require("@stryke/fs/resolve");
 let _stryke_path_join = require("@stryke/path/join");
 let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
@@ -12,10 +13,9 @@ let jest_worker = require("jest-worker");
 let node_os = require("node:os");
 let node_stream = require("node:stream");
 let node_util = require("node:util");
-let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 
-//#region src/_internal/ipc/helpers.ts
+//#region src/_internal/ipc/parse.ts
 function parseIpcMessage(data) {
 	let message;
 	if ((0, _stryke_type_checks_is_set_object.isSetObject)(data)) message = data;
@@ -26,15 +26,16 @@ function parseIpcMessage(data) {
 	if (message && (0, _stryke_type_checks_is_set_string.isSetString)(message.id) && (0, _stryke_type_checks_is_set_string.isSetString)(message.type) && (0, _stryke_type_checks_is_set_string.isSetString)(message.executionId) && Number.isInteger(message.executionIndex) && !Number.isNaN(message.timestamp)) return message;
 }
 function parseWriteLogMessagePayload(data) {
-	if ((0, _stryke_type_checks_is_set_object.isSetObject)(data) && (0, _stryke_type_checks_is_set_string.isSetString)(data.type) && (0, _stryke_type_checks_is_set_string.isSetString)(data.category) && (0, _stryke_type_checks_is_set_string.isSetString)(data.logId) && (0, _stryke_type_checks_is_set_string.isSetString)(data.message)) return {
+	if ((0, _stryke_type_checks_is_set_object.isSetObject)(data) && (0, _stryke_type_checks_is_set_object.isSetObject)(data.meta) && (0, _stryke_type_checks_is_set_string.isSetString)(data.meta.type) && ((0, _stryke_type_checks_is_set_string.isSetString)(data.message) || Array.isArray(data.message))) return {
 		...data,
+		meta: data.meta,
 		message: (0, _stryke_convert_to_array.toArray)(data.message).filter(Boolean)
 	};
-	throw new Error("Invalid \"write-log\" message payload.");
+	throw new Error(`Invalid "write-log" message payload: ${JSON.stringify(data)}`);
 }
 function parseUpdateCommandMessagePayload(data) {
 	if ((0, _stryke_type_checks_is_set_string.isSetString)(data?.command)) return { command: data.command };
-	throw new Error("Invalid \"update-command\" message payload.");
+	throw new Error(`Invalid "update-command" message payload: ${JSON.stringify(data)}`);
 }
 function parseUpdateHookMessagePayload(data) {
 	if ((0, _stryke_type_checks_is_set_string.isSetString)(data?.hook) && [
@@ -45,11 +46,11 @@ function parseUpdateHookMessagePayload(data) {
 		hook: data.hook,
 		order: data.order
 	};
-	throw new Error("Invalid \"update-hook\" message payload.");
+	throw new Error(`Invalid "update-hook" message payload: ${JSON.stringify(data)}`);
 }
 function parseUpdatePluginMessagePayload(data) {
 	if ((0, _stryke_type_checks_is_set_string.isSetString)(data?.plugin)) return { plugin: data.plugin };
-	throw new Error("Invalid \"update-plugin\" message payload.");
+	throw new Error(`Invalid "update-plugin" message payload: ${JSON.stringify(data)}`);
 }
 
 //#endregion
@@ -314,39 +315,7 @@ var Worker = class {
 						const message = parseIpcMessage(data);
 						if (message) {
 							logger.trace(`Received IPC message from worker: ${JSON.stringify(message)}`);
-							switch (message.type) {
-								case "write-log":
-									if (options.onWriteLog) Promise.resolve(options.onWriteLog({
-										...message,
-										type: "write-log",
-										payload: parseWriteLogMessagePayload(message.payload)
-									}));
-									break;
-								case "update-command":
-									if (options.onUpdateCommand) Promise.resolve(options.onUpdateCommand({
-										...message,
-										type: "update-command",
-										payload: parseUpdateCommandMessagePayload(message.payload)
-									}));
-									break;
-								case "update-hook":
-									if (options.onUpdateHook) Promise.resolve(options.onUpdateHook({
-										...message,
-										type: "update-hook",
-										payload: parseUpdateHookMessagePayload(message.payload)
-									}));
-									break;
-								case "update-plugin":
-									if (options.onUpdatePlugin) Promise.resolve(options.onUpdatePlugin({
-										...message,
-										type: "update-plugin",
-										payload: parseUpdatePluginMessagePayload(message.payload)
-									}));
-									break;
-								case "activity":
-								case void 0:
-								default: break;
-							}
+							Promise.resolve(this.options.onIpcMessage?.(message));
 						}
 					}
 				});
@@ -435,6 +404,7 @@ var PowerlinesEngine = class PowerlinesEngine {
 		const packagePath = await (0, _stryke_fs_resolve.resolvePackage)("@powerlines/engine");
 		if (!packagePath) throw new Error("Could not resolve `@powerlines/engine` package location.");
 		api.#worker = new Worker((0, _stryke_path_join.joinPaths)(packagePath, "./_internal/worker.mjs"), {
+			onIpcMessage: api.handleIpcMessage.bind(api),
 			enableSourceMaps: options.mode === "development",
 			exposedMethods: _powerlines_core_constants.POWERLINES_API_FUNCTIONS,
 			logger: api.context.extendLogger({ category: "ipc" })
@@ -642,9 +612,105 @@ var PowerlinesEngine = class PowerlinesEngine {
 		this.context.debug("✔ Powerlines finalization completed successfully");
 		timer();
 	}
+	/**
+	* Asynchronous disposal method for the Powerlines Engine, which will call the finalize method to perform any necessary cleanup when the engine is disposed of.
+	*/
 	async [Symbol.asyncDispose]() {
 		return this.finalize();
 	}
+	async handleIpcMessage(message) {
+		switch (message.type) {
+			case "write-log":
+				this.context.logger.debug({
+					meta: {
+						category: "ipc",
+						executionId: message.executionId,
+						executionIndex: message.executionIndex,
+						environment: message.environment
+					},
+					message: "Received a \"write-log\" IPC message from worker"
+				});
+				await this.handleWriteLog({
+					...message,
+					type: "write-log",
+					payload: parseWriteLogMessagePayload(message.payload)
+				});
+				break;
+			case "update-command":
+				this.context.logger.debug({
+					meta: {
+						category: "ipc",
+						executionId: message.executionId,
+						executionIndex: message.executionIndex,
+						environment: message.environment
+					},
+					message: "Received an \"update-command\" IPC message from worker"
+				});
+				await this.handleUpdateCommand({
+					...message,
+					type: "update-command",
+					payload: parseUpdateCommandMessagePayload(message.payload)
+				});
+				break;
+			case "update-hook":
+				this.context.logger.debug({
+					meta: {
+						category: "ipc",
+						executionId: message.executionId,
+						executionIndex: message.executionIndex,
+						environment: message.environment
+					},
+					message: "Received an \"update-hook\" IPC message from worker"
+				});
+				await this.handleUpdateHook({
+					...message,
+					type: "update-hook",
+					payload: parseUpdateHookMessagePayload(message.payload)
+				});
+				break;
+			case "update-plugin":
+				this.context.logger.debug({
+					meta: {
+						category: "ipc",
+						executionId: message.executionId,
+						executionIndex: message.executionIndex,
+						environment: message.environment
+					},
+					message: "Received an \"update-plugin\" IPC message from worker"
+				});
+				await this.handleUpdatePlugin({
+					...message,
+					type: "update-plugin",
+					payload: parseUpdatePluginMessagePayload(message.payload)
+				});
+				break;
+			case "activity":
+			case void 0:
+			default: break;
+		}
+	}
+	async handleWriteLog(message) {
+		const { payload } = message;
+		this.context.logger.log(payload.meta.type, {
+			message: (0, _stryke_convert_to_array.toArray)(payload.message).filter(Boolean).join("\n"),
+			meta: {
+				category: payload.meta.category,
+				logId: payload.meta.logId,
+				name: payload.meta.name,
+				executionId: message.executionId,
+				executionIndex: message.executionIndex,
+				command: payload.meta.command,
+				hook: payload.meta.hook,
+				environment: message.environment,
+				plugin: payload.meta.plugin,
+				source: payload.meta.source,
+				timestamp: message.timestamp
+			}
+		});
+	}
+	async handleUpdatePlugin(_) {}
+	async handleUpdateHook(_) {}
+	async handleUpdateCommand(_) {}
 };
 
 //#endregion

package/dist/index.d.cts

@@ -119,7 +119,15 @@ declare class PowerlinesEngine implements Engine, AsyncDisposable {
    * @returns A promise that resolves when the finalization process has completed
    */
   finalize(): Promise<void>;
+  /**
+   * Asynchronous disposal method for the Powerlines Engine, which will call the finalize method to perform any necessary cleanup when the engine is disposed of.
+   */
   [Symbol.asyncDispose](): Promise<void>;
+  private handleIpcMessage;
+  private handleWriteLog;
+  private handleUpdatePlugin;
+  private handleUpdateHook;
+  private handleUpdateCommand;
 }
 //#endregion
 export { PowerlinesEngine };

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;AAgDA;;;;;;cAAa,gBAAA,YAA4B,MAAA,EAAQ,eAAA;EAAA;EAkEtC;;;;;;EAAA,OAjDW,WAAA,CAClB,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,gBAAA;EAyFY;;;EAAA,IAjEZ,OAAA,CAAA,GAAW,aAAA;EAkEJ;;;;;EAAA,UAzDT,WAAA,CAAa,OAAA,EAAS,aAAA;EA2Db;;;;;;;;EA/CL,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EA4Ce;;;;;;;;EATL,OAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,mBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,eAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,kBAAA,8BAEpB,OAAA;EA8DoB;;;;;;;;;EA9BV,GAAA,CAAI,YAAA,EAAc,WAAA,CAAY,eAAA,eAA2B,OAAA;EA8DnE;;;;;;;;;EAnCU,KAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,mBAAA,8BAEpB,OAAA;EA4Fa;;;;;;EAnEH,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAmIC;;;;;;;;;EAvGS,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAnPoC;;;;;;;;;EA+Q1B,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EAjOM;;;;;;EAyPI,IAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,gBAAA,8BAIN,OAAA;EAlPD;;;;;;;;EAkRW,MAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,kBAAA,8BAIN,OAAA;EA5OG;;;;;;;;EAwQO,QAAA,CAAA,GAAQ,OAAA;EAAA,CAUd,MAAA,CAAO,YAAA,KAAa,OAAA;AAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;AA+DA;;;;;;cAAa,gBAAA,YAA4B,MAAA,EAAQ,eAAA;EAAA;EAmEtC;;;;;;EAAA,OAlDW,WAAA,CAClB,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,gBAAA;EA0FY;;;EAAA,IAjEZ,OAAA,CAAA,GAAW,aAAA;EAkEJ;;;;;EAAA,UAzDT,WAAA,CAAa,OAAA,EAAS,aAAA;EA2Db;;;;;;;;EA/CL,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EA4Ce;;;;;;;;EATL,OAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,mBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,eAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,kBAAA,8BAEpB,OAAA;EA8DoB;;;;;;;;;EA9BV,GAAA,CAAI,YAAA,EAAc,WAAA,CAAY,eAAA,eAA2B,OAAA;EA8DnE;;;;;;;;;EAnCU,KAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,mBAAA,8BAEpB,OAAA;EA4Fa;;;;;;EAnEH,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAmIC;;;;;;;;;EAvGS,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EApPoC;;;;;;;;;EAgR1B,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EAjOM;;;;;;EAyPI,IAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,gBAAA,8BAIN,OAAA;EAlPD;;;;;;;;EAkRW,MAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,kBAAA,8BAIN,OAAA;EA5OG;;;;;;;;EAwQO,QAAA,CAAA,GAAQ,OAAA;EArQf;;;EAAA,CAkRQ,MAAA,CAAO,YAAA,KAAa,OAAA;EAAA,QAIpB,gBAAA;EAAA,QAsFA,cAAA;EAAA,QAqBA,kBAAA;EAAA,QAEA,gBAAA;EAAA,QAEA,mBAAA;AAAA"}

package/dist/index.d.mts

@@ -119,7 +119,15 @@ declare class PowerlinesEngine implements Engine, AsyncDisposable {
    * @returns A promise that resolves when the finalization process has completed
    */
   finalize(): Promise<void>;
+  /**
+   * Asynchronous disposal method for the Powerlines Engine, which will call the finalize method to perform any necessary cleanup when the engine is disposed of.
+   */
   [Symbol.asyncDispose](): Promise<void>;
+  private handleIpcMessage;
+  private handleWriteLog;
+  private handleUpdatePlugin;
+  private handleUpdateHook;
+  private handleUpdateCommand;
 }
 //#endregion
 export { PowerlinesEngine };

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;AAgDA;;;;;;cAAa,gBAAA,YAA4B,MAAA,EAAQ,eAAA;EAAA;EAkEtC;;;;;;EAAA,OAjDW,WAAA,CAClB,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,gBAAA;EAyFY;;;EAAA,IAjEZ,OAAA,CAAA,GAAW,aAAA;EAkEJ;;;;;EAAA,UAzDT,WAAA,CAAa,OAAA,EAAS,aAAA;EA2Db;;;;;;;;EA/CL,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EA4Ce;;;;;;;;EATL,OAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,mBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,eAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,kBAAA,8BAEpB,OAAA;EA8DoB;;;;;;;;;EA9BV,GAAA,CAAI,YAAA,EAAc,WAAA,CAAY,eAAA,eAA2B,OAAA;EA8DnE;;;;;;;;;EAnCU,KAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,mBAAA,8BAEpB,OAAA;EA4Fa;;;;;;EAnEH,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAmIC;;;;;;;;;EAvGS,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAnPoC;;;;;;;;;EA+Q1B,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EAjOM;;;;;;EAyPI,IAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,gBAAA,8BAIN,OAAA;EAlPD;;;;;;;;EAkRW,MAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,kBAAA,8BAIN,OAAA;EA5OG;;;;;;;;EAwQO,QAAA,CAAA,GAAQ,OAAA;EAAA,CAUd,MAAA,CAAO,YAAA,KAAa,OAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;AA+DA;;;;;;cAAa,gBAAA,YAA4B,MAAA,EAAQ,eAAA;EAAA;EAmEtC;;;;;;EAAA,OAlDW,WAAA,CAClB,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,gBAAA;EA0FY;;;EAAA,IAjEZ,OAAA,CAAA,GAAW,aAAA;EAkEJ;;;;;EAAA,UAzDT,WAAA,CAAa,OAAA,EAAS,aAAA;EA2Db;;;;;;;;EA/CL,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EA4Ce;;;;;;;;EATL,OAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,mBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,eAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,kBAAA,8BAEpB,OAAA;EA8DoB;;;;;;;;;EA9BV,GAAA,CAAI,YAAA,EAAc,WAAA,CAAY,eAAA,eAA2B,OAAA;EA8DnE;;;;;;;;;EAnCU,KAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,mBAAA,8BAEpB,OAAA;EA4Fa;;;;;;EAnEH,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAmIC;;;;;;;;;EAvGS,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EApPoC;;;;;;;;;EAgR1B,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EAjOM;;;;;;EAyPI,IAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,gBAAA,8BAIN,OAAA;EAlPD;;;;;;;;EAkRW,MAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,kBAAA,8BAIN,OAAA;EA5OG;;;;;;;;EAwQO,QAAA,CAAA,GAAQ,OAAA;EArQf;;;EAAA,CAkRQ,MAAA,CAAO,YAAA,KAAa,OAAA;EAAA,QAIpB,gBAAA;EAAA,QAsFA,cAAA;EAAA,QAqBA,kBAAA;EAAA,QAEA,gBAAA;EAAA,QAEA,mBAAA;AAAA"}

package/dist/index.mjs

@@ -1,5 +1,6 @@
-import { t as PowerlinesEngineContext } from "./engine-context-CytME-Ht.mjs";
+import { t as PowerlinesEngineContext } from "./engine-context-BWGxMU_n.mjs";
 import { POWERLINES_API_FUNCTIONS } from "@powerlines/core/constants";
+import { toArray } from "@stryke/convert/to-array";
 import { resolvePackage } from "@stryke/fs/resolve";
 import { joinPaths } from "@stryke/path/join";
 import { isSet } from "@stryke/type-checks/is-set";
@@ -10,10 +11,9 @@ import { Worker } from "jest-worker";
 import { cpus } from "node:os";
 import { Transform } from "node:stream";
 import { parseArgs } from "node:util";
-import { toArray } from "@stryke/convert/to-array";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 
-//#region src/_internal/ipc/helpers.ts
+//#region src/_internal/ipc/parse.ts
 function parseIpcMessage(data) {
 	let message;
 	if (isSetObject(data)) message = data;
@@ -24,15 +24,16 @@ function parseIpcMessage(data) {
 	if (message && isSetString(message.id) && isSetString(message.type) && isSetString(message.executionId) && Number.isInteger(message.executionIndex) && !Number.isNaN(message.timestamp)) return message;
 }
 function parseWriteLogMessagePayload(data) {
-	if (isSetObject(data) && isSetString(data.type) && isSetString(data.category) && isSetString(data.logId) && isSetString(data.message)) return {
+	if (isSetObject(data) && isSetObject(data.meta) && isSetString(data.meta.type) && (isSetString(data.message) || Array.isArray(data.message))) return {
 		...data,
+		meta: data.meta,
 		message: toArray(data.message).filter(Boolean)
 	};
-	throw new Error("Invalid \"write-log\" message payload.");
+	throw new Error(`Invalid "write-log" message payload: ${JSON.stringify(data)}`);
 }
 function parseUpdateCommandMessagePayload(data) {
 	if (isSetString(data?.command)) return { command: data.command };
-	throw new Error("Invalid \"update-command\" message payload.");
+	throw new Error(`Invalid "update-command" message payload: ${JSON.stringify(data)}`);
 }
 function parseUpdateHookMessagePayload(data) {
 	if (isSetString(data?.hook) && [
@@ -43,11 +44,11 @@ function parseUpdateHookMessagePayload(data) {
 		hook: data.hook,
 		order: data.order
 	};
-	throw new Error("Invalid \"update-hook\" message payload.");
+	throw new Error(`Invalid "update-hook" message payload: ${JSON.stringify(data)}`);
 }
 function parseUpdatePluginMessagePayload(data) {
 	if (isSetString(data?.plugin)) return { plugin: data.plugin };
-	throw new Error("Invalid \"update-plugin\" message payload.");
+	throw new Error(`Invalid "update-plugin" message payload: ${JSON.stringify(data)}`);
 }
 
 //#endregion
@@ -312,39 +313,7 @@ var Worker$1 = class {
 						const message = parseIpcMessage(data);
 						if (message) {
 							logger.trace(`Received IPC message from worker: ${JSON.stringify(message)}`);
-							switch (message.type) {
-								case "write-log":
-									if (options.onWriteLog) Promise.resolve(options.onWriteLog({
-										...message,
-										type: "write-log",
-										payload: parseWriteLogMessagePayload(message.payload)
-									}));
-									break;
-								case "update-command":
-									if (options.onUpdateCommand) Promise.resolve(options.onUpdateCommand({
-										...message,
-										type: "update-command",
-										payload: parseUpdateCommandMessagePayload(message.payload)
-									}));
-									break;
-								case "update-hook":
-									if (options.onUpdateHook) Promise.resolve(options.onUpdateHook({
-										...message,
-										type: "update-hook",
-										payload: parseUpdateHookMessagePayload(message.payload)
-									}));
-									break;
-								case "update-plugin":
-									if (options.onUpdatePlugin) Promise.resolve(options.onUpdatePlugin({
-										...message,
-										type: "update-plugin",
-										payload: parseUpdatePluginMessagePayload(message.payload)
-									}));
-									break;
-								case "activity":
-								case void 0:
-								default: break;
-							}
+							Promise.resolve(this.options.onIpcMessage?.(message));
 						}
 					}
 				});
@@ -433,6 +402,7 @@ var PowerlinesEngine = class PowerlinesEngine {
 		const packagePath = await resolvePackage("@powerlines/engine");
 		if (!packagePath) throw new Error("Could not resolve `@powerlines/engine` package location.");
 		api.#worker = new Worker$1(joinPaths(packagePath, "./_internal/worker.mjs"), {
+			onIpcMessage: api.handleIpcMessage.bind(api),
 			enableSourceMaps: options.mode === "development",
 			exposedMethods: POWERLINES_API_FUNCTIONS,
 			logger: api.context.extendLogger({ category: "ipc" })
@@ -640,9 +610,105 @@ var PowerlinesEngine = class PowerlinesEngine {
 		this.context.debug("✔ Powerlines finalization completed successfully");
 		timer();
 	}
+	/**
+	* Asynchronous disposal method for the Powerlines Engine, which will call the finalize method to perform any necessary cleanup when the engine is disposed of.
+	*/
 	async [Symbol.asyncDispose]() {
 		return this.finalize();
 	}
+	async handleIpcMessage(message) {
+		switch (message.type) {
+			case "write-log":
+				this.context.logger.debug({
+					meta: {
+						category: "ipc",
+						executionId: message.executionId,
+						executionIndex: message.executionIndex,
+						environment: message.environment
+					},
+					message: "Received a \"write-log\" IPC message from worker"
+				});
+				await this.handleWriteLog({
+					...message,
+					type: "write-log",
+					payload: parseWriteLogMessagePayload(message.payload)
+				});
+				break;
+			case "update-command":
+				this.context.logger.debug({
+					meta: {
+						category: "ipc",
+						executionId: message.executionId,
+						executionIndex: message.executionIndex,
+						environment: message.environment
+					},
+					message: "Received an \"update-command\" IPC message from worker"
+				});
+				await this.handleUpdateCommand({
+					...message,
+					type: "update-command",
+					payload: parseUpdateCommandMessagePayload(message.payload)
+				});
+				break;
+			case "update-hook":
+				this.context.logger.debug({
+					meta: {
+						category: "ipc",
+						executionId: message.executionId,
+						executionIndex: message.executionIndex,
+						environment: message.environment
+					},
+					message: "Received an \"update-hook\" IPC message from worker"
+				});
+				await this.handleUpdateHook({
+					...message,
+					type: "update-hook",
+					payload: parseUpdateHookMessagePayload(message.payload)
+				});
+				break;
+			case "update-plugin":
+				this.context.logger.debug({
+					meta: {
+						category: "ipc",
+						executionId: message.executionId,
+						executionIndex: message.executionIndex,
+						environment: message.environment
+					},
+					message: "Received an \"update-plugin\" IPC message from worker"
+				});
+				await this.handleUpdatePlugin({
+					...message,
+					type: "update-plugin",
+					payload: parseUpdatePluginMessagePayload(message.payload)
+				});
+				break;
+			case "activity":
+			case void 0:
+			default: break;
+		}
+	}
+	async handleWriteLog(message) {
+		const { payload } = message;
+		this.context.logger.log(payload.meta.type, {
+			message: toArray(payload.message).filter(Boolean).join("\n"),
+			meta: {
+				category: payload.meta.category,
+				logId: payload.meta.logId,
+				name: payload.meta.name,
+				executionId: message.executionId,
+				executionIndex: message.executionIndex,
+				command: payload.meta.command,
+				hook: payload.meta.hook,
+				environment: message.environment,
+				plugin: payload.meta.plugin,
+				source: payload.meta.source,
+				timestamp: message.timestamp
+			}
+		});
+	}
+	async handleUpdatePlugin(_) {}
+	async handleUpdateHook(_) {}
+	async handleUpdateCommand(_) {}
 };
 
 //#endregion