@powerlines/engine 0.44.0 → 0.44.2

package/dist/index.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_chunk = require('./chunk-C0xms8kb.cjs');
-const require_engine_context = require('./engine-context-w4fts28j.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 _powerlines_core = require("@powerlines/core");
 let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
 let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let _stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
@@ -13,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;
@@ -27,18 +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_string.isSetString)(data?.level) && data?.args) return {
-		level: data.level,
-		source: (0, _stryke_type_checks_is_set.isSet)(data.source) ? String(data.source) : void 0,
-		environment: (0, _stryke_type_checks_is_set.isSet)(data.environment) ? String(data.environment) : void 0,
-		plugin: (0, _stryke_type_checks_is_set.isSet)(data.plugin) ? String(data.plugin) : void 0,
-		args: (0, _stryke_convert_to_array.toArray)(data.args).filter(Boolean)
+	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) && [
@@ -49,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
@@ -228,8 +225,7 @@ var Worker = class {
 	constructor(workerPath, options) {
 		this.workerPath = workerPath;
 		this.options = options;
-		const { timeout, onRestart, debuggerPortOffset = -1, enableSourceMaps = false, isolatedMemory = false, log: _log, ...rest } = this.options;
-		const log = (0, _powerlines_core.extendLogFn)(_log, { category: "ipc" });
+		const { timeout, onRestart, debuggerPortOffset = -1, enableSourceMaps = false, isolatedMemory = false, logger, ...rest } = this.options;
 		let restartPromise;
 		let resolveRestartPromise;
 		let activeTasks = 0;
@@ -263,7 +259,7 @@ var Worker = class {
 			if (!worker) return;
 			const resolve = resolveRestartPromise;
 			createWorker();
-			log("warn", `Sending SIGTERM signal to static worker due to timeout${timeout ? ` of ${(0, date_fns_formatDuration.formatDuration)({ seconds: timeout / 1e3 })}` : ""}. Subsequent errors may be a result of the worker exiting.`);
+			logger.warn(`Sending SIGTERM signal to static worker due to timeout${timeout ? ` of ${(0, date_fns_formatDuration.formatDuration)({ seconds: timeout / 1e3 })}` : ""}. Subsequent errors may be a result of the worker exiting.`);
 			worker.end().then(() => {
 				resolve(RESTARTED);
 			});
@@ -309,7 +305,7 @@ var Worker = class {
 			if (!rest.enableWorkerThreads) for (const worker of this.#worker._workerPool?._workers || []) {
 				worker._child?.on("exit", (code, signal) => {
 					if ((code || signal && signal !== "SIGINT") && this.#worker) {
-						log("error", `Worker exited with code: ${code} and signal: ${signal}`);
+						logger.error(`Worker exited with code: ${code} and signal: ${signal}`);
 						process.exit(code ?? 1);
 					}
 				});
@@ -318,40 +314,8 @@ var Worker = class {
 					else {
 						const message = parseIpcMessage(data);
 						if (message) {
-							log("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;
-							}
+							logger.trace(`Received IPC message from worker: ${JSON.stringify(message)}`);
+							Promise.resolve(this.options.onIpcMessage?.(message));
 						}
 					}
 				});
@@ -440,9 +404,10 @@ 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,
-			log: api.context.createLog()
+			logger: api.context.extendLogger({ category: "ipc" })
 		});
 		return api;
 	}
@@ -647,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,8 +1,8 @@
-import { t as PowerlinesEngineContext } from "./engine-context-PQ3BgcgR.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 { 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";
@@ -11,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;
@@ -25,18 +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 (isSetString(data?.level) && data?.args) return {
-		level: data.level,
-		source: isSet(data.source) ? String(data.source) : void 0,
-		environment: isSet(data.environment) ? String(data.environment) : void 0,
-		plugin: isSet(data.plugin) ? String(data.plugin) : void 0,
-		args: toArray(data.args).filter(Boolean)
+	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) && [
@@ -47,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
@@ -226,8 +223,7 @@ var Worker$1 = class {
 	constructor(workerPath, options) {
 		this.workerPath = workerPath;
 		this.options = options;
-		const { timeout, onRestart, debuggerPortOffset = -1, enableSourceMaps = false, isolatedMemory = false, log: _log, ...rest } = this.options;
-		const log = extendLogFn(_log, { category: "ipc" });
+		const { timeout, onRestart, debuggerPortOffset = -1, enableSourceMaps = false, isolatedMemory = false, logger, ...rest } = this.options;
 		let restartPromise;
 		let resolveRestartPromise;
 		let activeTasks = 0;
@@ -261,7 +257,7 @@ var Worker$1 = class {
 			if (!worker) return;
 			const resolve = resolveRestartPromise;
 			createWorker();
-			log("warn", `Sending SIGTERM signal to static worker due to timeout${timeout ? ` of ${formatDuration({ seconds: timeout / 1e3 })}` : ""}. Subsequent errors may be a result of the worker exiting.`);
+			logger.warn(`Sending SIGTERM signal to static worker due to timeout${timeout ? ` of ${formatDuration({ seconds: timeout / 1e3 })}` : ""}. Subsequent errors may be a result of the worker exiting.`);
 			worker.end().then(() => {
 				resolve(RESTARTED);
 			});
@@ -307,7 +303,7 @@ var Worker$1 = class {
 			if (!rest.enableWorkerThreads) for (const worker of this.#worker._workerPool?._workers || []) {
 				worker._child?.on("exit", (code, signal) => {
 					if ((code || signal && signal !== "SIGINT") && this.#worker) {
-						log("error", `Worker exited with code: ${code} and signal: ${signal}`);
+						logger.error(`Worker exited with code: ${code} and signal: ${signal}`);
 						process.exit(code ?? 1);
 					}
 				});
@@ -316,40 +312,8 @@ var Worker$1 = class {
 					else {
 						const message = parseIpcMessage(data);
 						if (message) {
-							log("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;
-							}
+							logger.trace(`Received IPC message from worker: ${JSON.stringify(message)}`);
+							Promise.resolve(this.options.onIpcMessage?.(message));
 						}
 					}
 				});
@@ -438,9 +402,10 @@ 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,
-			log: api.context.createLog()
+			logger: api.context.extendLogger({ category: "ipc" })
 		});
 		return api;
 	}
@@ -645,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