@powerlines/engine 0.14.5 → 0.15.1

package/dist/engine.mjs

@@ -0,0 +1,264 @@
+import { PowerlinesEngineContext } from "./context/engine-context.mjs";
+import { ExecutionHostWorker } from "./helpers/execution-host-worker.mjs";
+import { EXECUTION_API_METHODS } from "@powerlines/core/constants";
+import { createH3DevToolsHost } from "devframe/node";
+import { getPort } from "get-port-please";
+import { createApp, fromNodeMiddleware } from "h3";
+import { EventEmitter } from "node:events";
+import sirv from "sirv";
+
+//#region src/engine.ts
+/**
+* The Powerlines process' orchestration and coordination API.
+*
+* @public
+*/
+var PowerlinesEngine = class {
+	/**
+	* The Powerlines context
+	*/
+	#context;
+	/**
+	* The execution host, which provides methods to call the execution API functions from the engine context. This allows the engine to invoke commands and other API functions during the execution of Powerlines commands, enabling communication between the engine and the execution contexts.
+	*/
+	#host;
+	/**
+	* The Powerlines context
+	*/
+	get context() {
+		return this.#context;
+	}
+	/**
+	* The execution host, which provides methods to call the execution API functions from the engine context. This allows the engine to invoke commands and other API functions during the execution of Powerlines commands, enabling communication between the engine and the execution contexts.
+	*/
+	get host() {
+		return this.#host;
+	}
+	/**
+	* Create a new Powerlines Engine instance
+	*
+	* @param context - The Powerlines context
+	* @param host - The API host for the execution workers
+	* @returns A new instance of the Powerlines Engine
+	*/
+	constructor(context, host) {
+		this.#context = context;
+		this.#host = host;
+	}
+	/**
+	* Create a new Powerlines project
+	*
+	* @remarks
+	* This method will create a new Powerlines project in the current directory.
+	*
+	* @param inlineConfig - The inline configuration for the create command
+	* @returns A promise that resolves when the project has been created
+	*/
+	async create(inlineConfig) {
+		const timer = this.context.timer("Create");
+		this.context.info("🆕 Creating a new project");
+		await this.execute("create", inlineConfig);
+		this.context.debug("✔ Create command completed successfully");
+		timer();
+	}
+	/**
+	* Generate the Powerlines typescript declaration file
+	*
+	* @remarks
+	* This method will only generate the typescript declaration file for the Powerlines project. It is generally recommended to run the full `prepare` command, which will run this method as part of its process.
+	*
+	* @param inlineConfig - The inline configuration for the types command
+	*/
+	async types(inlineConfig) {
+		const timer = this.context.timer("Types");
+		this.context.info("🏗️  Generating typescript declarations for the project");
+		await this.execute("types", inlineConfig);
+		this.context.debug("✔ Types generation has completed successfully");
+		timer();
+	}
+	/**
+	* Prepare the Powerlines API
+	*
+	* @remarks
+	* This method will prepare the Powerlines API for use, initializing any necessary resources.
+	*
+	* @param inlineConfig - The inline configuration for the prepare command
+	*/
+	async prepare(inlineConfig) {
+		const timer = this.context.timer("Prepare");
+		this.context.info("🏗️ Preparing the project");
+		await this.execute("prepare", inlineConfig);
+		this.context.debug("✔ Preparation has completed successfully");
+		timer();
+	}
+	/**
+	* Clean any previously prepared artifacts
+	*
+	* @remarks
+	* This method will remove the previous Powerlines artifacts from the project.
+	*
+	* @param inlineConfig - The inline configuration for the clean command
+	* @returns A promise that resolves when the clean command has completed
+	*/
+	async clean(inlineConfig) {
+		const timer = this.context.timer("Clean");
+		this.context.info("🧹 Cleaning the previous artifacts");
+		await this.execute("clean", inlineConfig);
+		this.context.debug("✔ Cleaning completed successfully");
+		timer();
+	}
+	/**
+	* Lint the project
+	*
+	* @param inlineConfig - The inline configuration for the lint command
+	* @returns A promise that resolves when the lint command has completed
+	*/
+	async lint(inlineConfig) {
+		const timer = this.context.timer("Lint");
+		this.context.info("📝 Linting the project");
+		await this.execute("lint", inlineConfig);
+		this.context.debug("✔ Linting completed successfully");
+		timer();
+	}
+	/**
+	* Test the project
+	*
+	* @remarks
+	* This method will run the tests for the Powerlines project.
+	*
+	* @param inlineConfig - The inline configuration for the test command
+	* @returns A promise that resolves when the test command has completed
+	*/
+	async test(inlineConfig) {
+		const timer = this.context.timer("Test");
+		this.context.info("🧪 Running tests for the project");
+		await this.execute("test", inlineConfig);
+		this.context.debug("✔ Testing completed successfully");
+		timer();
+	}
+	/**
+	* Build the project
+	*
+	* @remarks
+	* This method will build the Powerlines project, generating the necessary artifacts.
+	*
+	* @param inlineConfig - The inline configuration for the build command
+	* @returns A promise that resolves when the build command has completed
+	*/
+	async build(inlineConfig) {
+		const timer = this.context.timer("Build");
+		this.context.info("📦 Building the project");
+		await this.execute("build", inlineConfig);
+		this.context.debug("✔ Build completed successfully");
+		timer();
+	}
+	/**
+	* Prepare the documentation for the project
+	*
+	* @param inlineConfig - The inline configuration for the docs command
+	* @returns A promise that resolves when the documentation generation has completed
+	*/
+	async docs(inlineConfig) {
+		const timer = this.context.timer("Docs");
+		this.context.info("📓 Generating documentation for the project");
+		await this.execute("docs", inlineConfig);
+		this.context.debug("✔ Documentation generation completed successfully");
+		timer();
+	}
+	/**
+	* Deploy the project source code
+	*
+	* @remarks
+	* This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.
+	*
+	* @param inlineConfig - The inline configuration for the deploy command
+	* @returns A promise that resolves when the deploy command has completed
+	*/
+	async deploy(inlineConfig) {
+		const timer = this.context.timer("Deploy");
+		this.context.info("🚀 Deploying the project");
+		await this.execute("deploy", inlineConfig);
+		this.context.debug("✔ Deployment completed successfully");
+		timer();
+	}
+	/**
+	* Finalization/cleanup processing for the Powerlines API
+	*
+	* @remarks
+	* This step includes any final processes or clean up required by Powerlines. It will be run after each Powerlines command.
+	*
+	* @returns A promise that resolves when the finalization process has completed
+	*/
+	async finalize() {
+		const timer = this.context.timer("Finalize");
+		this.context.info("🏁 Finalization processes started");
+		await this.host.end();
+		this.context.debug("✔ 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();
+	}
+	/**
+	* Execute a Powerlines command based on the provided execution path and inline configuration, loading the necessary executions from the context and managing their lifecycle.
+	*
+	* @remarks
+	* This method will load the executions for the specified command and inline configuration, then execute each one while managing their lifecycle, including handling their completion and any errors that may occur during execution.
+	*
+	* @param method - The path to the execution configuration to load and run, which can be used to specify different execution configurations for different commands or scenarios.
+	* @param inlineConfig - Additional configuration options provided at runtime, which can override or supplement the options defined in the user configuration file.
+	* @returns A promise that resolves when all executions for the specified command have completed
+	*/
+	async execute(method, inlineConfig) {
+		await Promise.all((await this.context.loadExecutions(method, inlineConfig)).map(async (execution) => {
+			try {
+				await this.host[method]({
+					options: execution.options,
+					inlineConfig
+				});
+			} catch (error) {
+				this.context.error(`Execution of method "${method}" failed for execution with invocation ID "${execution.invocationId}" and execution ID "${execution.options.executionId}": \n\n${error instanceof Error ? error.stack || error.message : String(error)}`);
+				throw error;
+			} finally {
+				this.context.completeExecution(execution.invocationId, execution.options.executionId);
+			}
+		}));
+	}
+};
+async function createContext(options) {
+	const port = options.port ?? await getPort({
+		host: options.host || "localhost",
+		random: true
+	});
+	const app = createApp();
+	const host = createH3DevToolsHost({
+		appName: options.framework?.name || "powerlines",
+		origin: `http://${options.host || "localhost"}:${port}`,
+		mount: (base, dir) => {
+			app.use(base, fromNodeMiddleware(sirv(dir, {
+				dev: true,
+				single: true
+			})));
+		}
+	});
+	return PowerlinesEngineContext.from(options, host, {
+		backend: "websocket",
+		websocket: port
+	});
+}
+async function createEngine(options, executionHostPath = "@powerlines/engine/execution-host", executionMethods = EXECUTION_API_METHODS) {
+	EventEmitter.setMaxListeners(100);
+	const context = await createContext(options);
+	return new PowerlinesEngine(context, await ExecutionHostWorker.from(executionHostPath, {
+		root: options.root,
+		context,
+		executionMethods
+	}));
+}
+
+//#endregion
+export { PowerlinesEngine, createContext, createEngine };
+//# sourceMappingURL=engine.mjs.map

package/dist/engine.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.mjs","names":["#context","#host"],"sources":["../src/engine.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 type {\n  BuildInlineConfig,\n  CleanInlineConfig,\n  CreateInlineConfig,\n  DeployInlineConfig,\n  DocsInlineConfig,\n  InlineConfig,\n  LintInlineConfig,\n  PrepareInlineConfig,\n  TestInlineConfig,\n  TypesInlineConfig\n} from \"@powerlines/core\";\nimport { EXECUTION_API_METHODS } from \"@powerlines/core/constants\";\nimport { createH3DevToolsHost } from \"devframe/node\";\nimport { getPort } from \"get-port-please\";\nimport { createApp, fromNodeMiddleware } from \"h3\";\nimport { EventEmitter } from \"node:events\";\nimport sirv from \"sirv\";\nimport { PowerlinesEngineContext } from \"./context/engine-context\";\nimport { ExecutionHostWorker } from \"./helpers/execution-host-worker\";\nimport { Engine, ExecutionHost } from \"./types/api\";\nimport { EngineOptions } from \"./types/config\";\nimport { EngineContext } from \"./types/context\";\n\n/**\n * The Powerlines process' orchestration and coordination API.\n *\n * @public\n */\nexport class PowerlinesEngine<\n  TExecutionAPI extends ReadonlyArray<string> = typeof EXECUTION_API_METHODS\n>\n  implements Engine<TExecutionAPI>, AsyncDisposable\n{\n  /**\n   * The Powerlines context\n   */\n  #context: EngineContext;\n\n  /**\n   * The execution host, which provides methods to call the execution API functions from the engine context. This allows the engine to invoke commands and other API functions during the execution of Powerlines commands, enabling communication between the engine and the execution contexts.\n   */\n  #host: ExecutionHost<TExecutionAPI>;\n\n  /**\n   * The Powerlines context\n   */\n  public get context(): EngineContext {\n    return this.#context;\n  }\n\n  /**\n   * The execution host, which provides methods to call the execution API functions from the engine context. This allows the engine to invoke commands and other API functions during the execution of Powerlines commands, enabling communication between the engine and the execution contexts.\n   */\n  public get host(): ExecutionHost<TExecutionAPI> {\n    return this.#host;\n  }\n\n  /**\n   * Create a new Powerlines Engine instance\n   *\n   * @param context - The Powerlines context\n   * @param host - The API host for the execution workers\n   * @returns A new instance of the Powerlines Engine\n   */\n  public constructor(\n    context: EngineContext,\n    host: ExecutionHost<TExecutionAPI>\n  ) {\n    this.#context = context;\n    this.#host = host;\n  }\n\n  /**\n   * Create a new Powerlines project\n   *\n   * @remarks\n   * This method will create a new Powerlines project in the current directory.\n   *\n   * @param inlineConfig - The inline configuration for the create command\n   * @returns A promise that resolves when the project has been created\n   */\n  public async create(inlineConfig: CreateInlineConfig) {\n    const timer = this.context.timer(\"Create\");\n    this.context.info(\"🆕 Creating a new project\");\n\n    await this.execute(\"create\", inlineConfig);\n\n    this.context.debug(\"✔ Create command completed successfully\");\n    timer();\n  }\n\n  /**\n   * Generate the Powerlines typescript declaration file\n   *\n   * @remarks\n   * This method will only generate the typescript declaration file for the Powerlines project. It is generally recommended to run the full `prepare` command, which will run this method as part of its process.\n   *\n   * @param inlineConfig - The inline configuration for the types command\n   */\n  public async types(inlineConfig: TypesInlineConfig) {\n    const timer = this.context.timer(\"Types\");\n    this.context.info(\"🏗️  Generating typescript declarations for the project\");\n\n    await this.execute(\"types\", inlineConfig);\n\n    this.context.debug(\"✔ Types generation has completed successfully\");\n    timer();\n  }\n\n  /**\n   * Prepare the Powerlines API\n   *\n   * @remarks\n   * This method will prepare the Powerlines API for use, initializing any necessary resources.\n   *\n   * @param inlineConfig - The inline configuration for the prepare command\n   */\n  public async prepare(inlineConfig: PrepareInlineConfig) {\n    const timer = this.context.timer(\"Prepare\");\n    this.context.info(\"🏗️ Preparing the project\");\n\n    await this.execute(\"prepare\", inlineConfig);\n\n    this.context.debug(\"✔ Preparation has completed successfully\");\n    timer();\n  }\n\n  /**\n   * Clean any previously prepared artifacts\n   *\n   * @remarks\n   * This method will remove the previous Powerlines artifacts from the project.\n   *\n   * @param inlineConfig - The inline configuration for the clean command\n   * @returns A promise that resolves when the clean command has completed\n   */\n  public async clean(inlineConfig: CleanInlineConfig) {\n    const timer = this.context.timer(\"Clean\");\n    this.context.info(\"🧹 Cleaning the previous artifacts\");\n\n    await this.execute(\"clean\", inlineConfig);\n\n    this.context.debug(\"✔ Cleaning completed successfully\");\n    timer();\n  }\n\n  /**\n   * Lint the project\n   *\n   * @param inlineConfig - The inline configuration for the lint command\n   * @returns A promise that resolves when the lint command has completed\n   */\n  public async lint(inlineConfig: LintInlineConfig) {\n    const timer = this.context.timer(\"Lint\");\n    this.context.info(\"📝 Linting the project\");\n\n    await this.execute(\"lint\", inlineConfig);\n\n    this.context.debug(\"✔ Linting completed successfully\");\n    timer();\n  }\n\n  /**\n   * Test the project\n   *\n   * @remarks\n   * This method will run the tests for the Powerlines project.\n   *\n   * @param inlineConfig - The inline configuration for the test command\n   * @returns A promise that resolves when the test command has completed\n   */\n  public async test(inlineConfig: TestInlineConfig) {\n    const timer = this.context.timer(\"Test\");\n    this.context.info(\"🧪 Running tests for the project\");\n\n    await this.execute(\"test\", inlineConfig);\n\n    this.context.debug(\"✔ Testing completed successfully\");\n    timer();\n  }\n\n  /**\n   * Build the project\n   *\n   * @remarks\n   * This method will build the Powerlines project, generating the necessary artifacts.\n   *\n   * @param inlineConfig - The inline configuration for the build command\n   * @returns A promise that resolves when the build command has completed\n   */\n  public async build(inlineConfig: BuildInlineConfig) {\n    const timer = this.context.timer(\"Build\");\n    this.context.info(\"📦 Building the project\");\n\n    await this.execute(\"build\", inlineConfig);\n\n    this.context.debug(\"✔ Build completed successfully\");\n    timer();\n  }\n\n  /**\n   * Prepare the documentation for the project\n   *\n   * @param inlineConfig - The inline configuration for the docs command\n   * @returns A promise that resolves when the documentation generation has completed\n   */\n  public async docs(inlineConfig: DocsInlineConfig) {\n    const timer = this.context.timer(\"Docs\");\n    this.context.info(\"📓 Generating documentation for the project\");\n\n    await this.execute(\"docs\", inlineConfig);\n\n    this.context.debug(\"✔ Documentation generation completed successfully\");\n    timer();\n  }\n\n  /**\n   * Deploy the project source code\n   *\n   * @remarks\n   * This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.\n   *\n   * @param inlineConfig - The inline configuration for the deploy command\n   * @returns A promise that resolves when the deploy command has completed\n   */\n  public async deploy(inlineConfig: DeployInlineConfig) {\n    const timer = this.context.timer(\"Deploy\");\n    this.context.info(\"🚀 Deploying the project\");\n\n    await this.execute(\"deploy\", inlineConfig);\n\n    this.context.debug(\"✔ Deployment completed successfully\");\n    timer();\n  }\n\n  /**\n   * Finalization/cleanup processing for the Powerlines API\n   *\n   * @remarks\n   * This step includes any final processes or clean up required by Powerlines. It will be run after each Powerlines command.\n   *\n   * @returns A promise that resolves when the finalization process has completed\n   */\n  public async finalize() {\n    const timer = this.context.timer(\"Finalize\");\n    this.context.info(\"🏁 Finalization processes started\");\n\n    await this.host.end();\n\n    this.context.debug(\"✔ Finalization completed successfully\");\n    timer();\n  }\n\n  /**\n   * Asynchronous disposal method for the Powerlines Engine, which will call the finalize method to perform any necessary cleanup when the engine is disposed of.\n   */\n  public async [Symbol.asyncDispose]() {\n    return this.finalize();\n  }\n\n  /**\n   * Execute a Powerlines command based on the provided execution path and inline configuration, loading the necessary executions from the context and managing their lifecycle.\n   *\n   * @remarks\n   * This method will load the executions for the specified command and inline configuration, then execute each one while managing their lifecycle, including handling their completion and any errors that may occur during execution.\n   *\n   * @param method - The path to the execution configuration to load and run, which can be used to specify different execution configurations for different commands or scenarios.\n   * @param inlineConfig - Additional configuration options provided at runtime, which can override or supplement the options defined in the user configuration file.\n   * @returns A promise that resolves when all executions for the specified command have completed\n   */\n  protected async execute(\n    method: TExecutionAPI[number],\n    inlineConfig: InlineConfig\n  ) {\n    await Promise.all(\n      (await this.context.loadExecutions(method, inlineConfig)).map(\n        async execution => {\n          try {\n            await this.host[method]({\n              options: execution.options,\n              inlineConfig\n            });\n          } catch (error) {\n            this.context.error(\n              `Execution of method \"${method}\" failed for execution with invocation ID \"${\n                execution.invocationId\n              }\" and execution ID \"${execution.options.executionId}\": \\n\\n${\n                error instanceof Error\n                  ? error.stack || error.message\n                  : String(error)\n              }`\n            );\n\n            throw error;\n          } finally {\n            this.context.completeExecution(\n              execution.invocationId,\n              execution.options.executionId\n            );\n          }\n        }\n      )\n    );\n  }\n}\n\nexport async function createContext(options: EngineOptions) {\n  const port =\n    options.port ??\n    (await getPort({\n      host: options.host || \"localhost\",\n      random: true\n    }));\n\n  const app = createApp();\n  const host = createH3DevToolsHost({\n    appName: options.framework?.name || \"powerlines\",\n    origin: `http://${options.host || \"localhost\"}:${port}`,\n    mount: (base, dir) => {\n      app.use(base, fromNodeMiddleware(sirv(dir, { dev: true, single: true })));\n    }\n  });\n\n  return PowerlinesEngineContext.from(options, host, {\n    backend: \"websocket\",\n    websocket: port\n  });\n}\n\nexport async function createEngine<TExecutionAPI extends ReadonlyArray<string>>(\n  options: EngineOptions,\n  executionHostPath = \"@powerlines/engine/execution-host\",\n  executionMethods: TExecutionAPI = EXECUTION_API_METHODS as unknown as TExecutionAPI\n) {\n  EventEmitter.setMaxListeners(100);\n\n  const context = await createContext(options);\n  const host = await ExecutionHostWorker.from<TExecutionAPI>(\n    executionHostPath,\n    {\n      root: options.root,\n      context,\n      executionMethods\n    }\n  );\n\n  return new PowerlinesEngine<TExecutionAPI>(context, host);\n}\n"],"mappings":";;;;;;;;;;;;;;;AA+CA,IAAa,mBAAb,MAIA;;;;CAIE;;;;CAKA;;;;CAKA,IAAW,UAAyB;AAClC,SAAO,MAAKA;;;;;CAMd,IAAW,OAAqC;AAC9C,SAAO,MAAKC;;;;;;;;;CAUd,AAAO,YACL,SACA,MACA;AACA,QAAKD,UAAW;AAChB,QAAKC,OAAQ;;;;;;;;;;;CAYf,MAAa,OAAO,cAAkC;EACpD,MAAM,QAAQ,KAAK,QAAQ,MAAM,SAAS;AAC1C,OAAK,QAAQ,KAAK,4BAA4B;AAE9C,QAAM,KAAK,QAAQ,UAAU,aAAa;AAE1C,OAAK,QAAQ,MAAM,0CAA0C;AAC7D,SAAO;;;;;;;;;;CAWT,MAAa,MAAM,cAAiC;EAClD,MAAM,QAAQ,KAAK,QAAQ,MAAM,QAAQ;AACzC,OAAK,QAAQ,KAAK,0DAA0D;AAE5E,QAAM,KAAK,QAAQ,SAAS,aAAa;AAEzC,OAAK,QAAQ,MAAM,gDAAgD;AACnE,SAAO;;;;;;;;;;CAWT,MAAa,QAAQ,cAAmC;EACtD,MAAM,QAAQ,KAAK,QAAQ,MAAM,UAAU;AAC3C,OAAK,QAAQ,KAAK,4BAA4B;AAE9C,QAAM,KAAK,QAAQ,WAAW,aAAa;AAE3C,OAAK,QAAQ,MAAM,2CAA2C;AAC9D,SAAO;;;;;;;;;;;CAYT,MAAa,MAAM,cAAiC;EAClD,MAAM,QAAQ,KAAK,QAAQ,MAAM,QAAQ;AACzC,OAAK,QAAQ,KAAK,qCAAqC;AAEvD,QAAM,KAAK,QAAQ,SAAS,aAAa;AAEzC,OAAK,QAAQ,MAAM,oCAAoC;AACvD,SAAO;;;;;;;;CAST,MAAa,KAAK,cAAgC;EAChD,MAAM,QAAQ,KAAK,QAAQ,MAAM,OAAO;AACxC,OAAK,QAAQ,KAAK,yBAAyB;AAE3C,QAAM,KAAK,QAAQ,QAAQ,aAAa;AAExC,OAAK,QAAQ,MAAM,mCAAmC;AACtD,SAAO;;;;;;;;;;;CAYT,MAAa,KAAK,cAAgC;EAChD,MAAM,QAAQ,KAAK,QAAQ,MAAM,OAAO;AACxC,OAAK,QAAQ,KAAK,mCAAmC;AAErD,QAAM,KAAK,QAAQ,QAAQ,aAAa;AAExC,OAAK,QAAQ,MAAM,mCAAmC;AACtD,SAAO;;;;;;;;;;;CAYT,MAAa,MAAM,cAAiC;EAClD,MAAM,QAAQ,KAAK,QAAQ,MAAM,QAAQ;AACzC,OAAK,QAAQ,KAAK,0BAA0B;AAE5C,QAAM,KAAK,QAAQ,SAAS,aAAa;AAEzC,OAAK,QAAQ,MAAM,iCAAiC;AACpD,SAAO;;;;;;;;CAST,MAAa,KAAK,cAAgC;EAChD,MAAM,QAAQ,KAAK,QAAQ,MAAM,OAAO;AACxC,OAAK,QAAQ,KAAK,8CAA8C;AAEhE,QAAM,KAAK,QAAQ,QAAQ,aAAa;AAExC,OAAK,QAAQ,MAAM,oDAAoD;AACvE,SAAO;;;;;;;;;;;CAYT,MAAa,OAAO,cAAkC;EACpD,MAAM,QAAQ,KAAK,QAAQ,MAAM,SAAS;AAC1C,OAAK,QAAQ,KAAK,2BAA2B;AAE7C,QAAM,KAAK,QAAQ,UAAU,aAAa;AAE1C,OAAK,QAAQ,MAAM,sCAAsC;AACzD,SAAO;;;;;;;;;;CAWT,MAAa,WAAW;EACtB,MAAM,QAAQ,KAAK,QAAQ,MAAM,WAAW;AAC5C,OAAK,QAAQ,KAAK,oCAAoC;AAEtD,QAAM,KAAK,KAAK,KAAK;AAErB,OAAK,QAAQ,MAAM,wCAAwC;AAC3D,SAAO;;;;;CAMT,OAAc,OAAO,gBAAgB;AACnC,SAAO,KAAK,UAAU;;;;;;;;;;;;CAaxB,MAAgB,QACd,QACA,cACA;AACA,QAAM,QAAQ,KACX,MAAM,KAAK,QAAQ,eAAe,QAAQ,aAAa,EAAE,IACxD,OAAM,cAAa;AACjB,OAAI;AACF,UAAM,KAAK,KAAK,QAAQ;KACtB,SAAS,UAAU;KACnB;KACD,CAAC;YACK,OAAO;AACd,SAAK,QAAQ,MACX,wBAAwB,OAAO,6CAC7B,UAAU,aACX,sBAAsB,UAAU,QAAQ,YAAY,SACnD,iBAAiB,QACb,MAAM,SAAS,MAAM,UACrB,OAAO,MAAM,GAEpB;AAED,UAAM;aACE;AACR,SAAK,QAAQ,kBACX,UAAU,cACV,UAAU,QAAQ,YACnB;;IAGN,CACF;;;AAIL,eAAsB,cAAc,SAAwB;CAC1D,MAAM,OACJ,QAAQ,QACP,MAAM,QAAQ;EACb,MAAM,QAAQ,QAAQ;EACtB,QAAQ;EACT,CAAC;CAEJ,MAAM,MAAM,WAAW;CACvB,MAAM,OAAO,qBAAqB;EAChC,SAAS,QAAQ,WAAW,QAAQ;EACpC,QAAQ,UAAU,QAAQ,QAAQ,YAAY,GAAG;EACjD,QAAQ,MAAM,QAAQ;AACpB,OAAI,IAAI,MAAM,mBAAmB,KAAK,KAAK;IAAE,KAAK;IAAM,QAAQ;IAAM,CAAC,CAAC,CAAC;;EAE5E,CAAC;AAEF,QAAO,wBAAwB,KAAK,SAAS,MAAM;EACjD,SAAS;EACT,WAAW;EACZ,CAAC;;AAGJ,eAAsB,aACpB,SACA,oBAAoB,qCACpB,mBAAkC,uBAClC;AACA,cAAa,gBAAgB,IAAI;CAEjC,MAAM,UAAU,MAAM,cAAc,QAAQ;AAU5C,QAAO,IAAI,iBAAgC,SAAS,MATjC,oBAAoB,KACrC,mBACA;EACE,MAAM,QAAQ;EACd;EACA;EACD,CACF,CAEwD"}

package/dist/execution-host.cjs

@@ -0,0 +1,44 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_api_prepare = require('./api/prepare.cjs');
+const require_api_build = require('./api/build.cjs');
+const require_api_clean = require('./api/clean.cjs');
+const require_api_create = require('./api/create.cjs');
+const require_api_deploy = require('./api/deploy.cjs');
+const require_api_docs = require('./api/docs.cjs');
+const require_api_lint = require('./api/lint.cjs');
+const require_api_test = require('./api/test.cjs');
+const require_api_types = require('./api/types.cjs');
+const require_helpers_create_execution_host = require('./helpers/create-execution-host.cjs');
+
+//#region src/execution-host.ts
+const executionHost = require_helpers_create_execution_host.createExecutionHost({
+	types: require_api_types.types,
+	prepare: require_api_prepare.prepare,
+	create: require_api_create.create,
+	clean: require_api_clean.clean,
+	lint: require_api_lint.lint,
+	test: require_api_test.test,
+	build: require_api_build.build,
+	docs: require_api_docs.docs,
+	deploy: require_api_deploy.deploy
+});
+const types = executionHost.types;
+const prepare = executionHost.prepare;
+const create = executionHost.create;
+const clean = executionHost.clean;
+const lint = executionHost.lint;
+const test = executionHost.test;
+const build = executionHost.build;
+const docs = executionHost.docs;
+const deploy = executionHost.deploy;
+
+//#endregion
+exports.build = build;
+exports.clean = clean;
+exports.create = create;
+exports.deploy = deploy;
+exports.docs = docs;
+exports.lint = lint;
+exports.prepare = prepare;
+exports.test = test;
+exports.types = types;

package/dist/execution-host.d.cts

@@ -0,0 +1,14 @@
+import { r as ExecutionHostParams } from "./api-6w4hZL6n.cjs";
+//#region src/execution-host.d.ts
+declare const types: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const prepare: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const create: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const clean: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const lint: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const test: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const build: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const docs: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const deploy: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+//#endregion
+export { build, clean, create, deploy, docs, lint, prepare, test, types };
+//# sourceMappingURL=execution-host.d.cts.map

package/dist/execution-host.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-host.d.cts","names":[],"sources":["../src/execution-host.ts"],"mappings":";;cAyCa,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,OAAA,IAAO,MAAA,EAAwB,mBAAA,KAAxB,OAAA;AAAA,cACP,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA;AAAA,cACN,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA"}

package/dist/execution-host.d.mts

@@ -0,0 +1,14 @@
+import { r as ExecutionHostParams } from "./api-Cdw4v0W4.mjs";
+//#region src/execution-host.d.ts
+declare const types: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const prepare: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const create: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const clean: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const lint: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const test: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const build: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const docs: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+declare const deploy: ((params: ExecutionHostParams) => Promise<void>) | undefined;
+//#endregion
+export { build, clean, create, deploy, docs, lint, prepare, test, types };
+//# sourceMappingURL=execution-host.d.mts.map

package/dist/execution-host.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-host.d.mts","names":[],"sources":["../src/execution-host.ts"],"mappings":";;cAyCa,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,OAAA,IAAO,MAAA,EAAwB,mBAAA,KAAxB,OAAA;AAAA,cACP,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA;AAAA,cACN,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA"}

package/dist/execution-host.mjs

@@ -0,0 +1,36 @@
+import { prepare as prepare$1 } from "./api/prepare.mjs";
+import { build as build$1 } from "./api/build.mjs";
+import { clean as clean$1 } from "./api/clean.mjs";
+import { create as create$1 } from "./api/create.mjs";
+import { deploy as deploy$1 } from "./api/deploy.mjs";
+import { docs as docs$1 } from "./api/docs.mjs";
+import { lint as lint$1 } from "./api/lint.mjs";
+import { test as test$1 } from "./api/test.mjs";
+import { types as types$1 } from "./api/types.mjs";
+import { createExecutionHost } from "./helpers/create-execution-host.mjs";
+
+//#region src/execution-host.ts
+const executionHost = createExecutionHost({
+	types: types$1,
+	prepare: prepare$1,
+	create: create$1,
+	clean: clean$1,
+	lint: lint$1,
+	test: test$1,
+	build: build$1,
+	docs: docs$1,
+	deploy: deploy$1
+});
+const types = executionHost.types;
+const prepare = executionHost.prepare;
+const create = executionHost.create;
+const clean = executionHost.clean;
+const lint = executionHost.lint;
+const test = executionHost.test;
+const build = executionHost.build;
+const docs = executionHost.docs;
+const deploy = executionHost.deploy;
+
+//#endregion
+export { build, clean, create, deploy, docs, lint, prepare, test, types };
+//# sourceMappingURL=execution-host.mjs.map

package/dist/execution-host.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-host.mjs","names":["executeTypes","executePrepare","executeCreate","executeClean","executeLint","executeTest","executeBuild","executeDocs","executeDeploy"],"sources":["../src/execution-host.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 { build as executeBuild } from \"./api/build\";\nimport { clean as executeClean } from \"./api/clean\";\nimport { create as executeCreate } from \"./api/create\";\nimport { deploy as executeDeploy } from \"./api/deploy\";\nimport { docs as executeDocs } from \"./api/docs\";\nimport { lint as executeLint } from \"./api/lint\";\nimport { prepare as executePrepare } from \"./api/prepare\";\nimport { test as executeTest } from \"./api/test\";\nimport { types as executeTypes } from \"./api/types\";\nimport { createExecutionHost } from \"./helpers/create-execution-host\";\n\nconst executionHost = createExecutionHost({\n  types: executeTypes,\n  prepare: executePrepare,\n  create: executeCreate,\n  clean: executeClean,\n  lint: executeLint,\n  test: executeTest,\n  build: executeBuild,\n  docs: executeDocs,\n  deploy: executeDeploy\n});\n\nexport const types = executionHost.types;\nexport const prepare = executionHost.prepare;\nexport const create = executionHost.create;\nexport const clean = executionHost.clean;\nexport const lint = executionHost.lint;\nexport const test = executionHost.test;\nexport const build = executionHost.build;\nexport const docs = executionHost.docs;\nexport const deploy = executionHost.deploy;\n"],"mappings":";;;;;;;;;;;;AA6BA,MAAM,gBAAgB,oBAAoB;CACxC,OAAOA;CACP,SAASC;CACT,QAAQC;CACR,OAAOC;CACP,MAAMC;CACN,MAAMC;CACN,OAAOC;CACP,MAAMC;CACN,QAAQC;CACT,CAAC;AAEF,MAAa,QAAQ,cAAc;AACnC,MAAa,UAAU,cAAc;AACrC,MAAa,SAAS,cAAc;AACpC,MAAa,QAAQ,cAAc;AACnC,MAAa,OAAO,cAAc;AAClC,MAAa,OAAO,cAAc;AAClC,MAAa,QAAQ,cAAc;AACnC,MAAa,OAAO,cAAc;AAClC,MAAa,SAAS,cAAc"}

package/dist/helpers/create-execution-host.cjs

@@ -0,0 +1,51 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../chunk-C0xms8kb.cjs');
+const require_helpers_rpc = require('./rpc.cjs');
+let _powerlines_core_plugin_utils = require("@powerlines/core/plugin-utils");
+let _stryke_unique_id_uuid = require("@stryke/unique-id/uuid");
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let _powerlines_core_context_execution_context = require("@powerlines/core/context/execution-context");
+let _powerlines_core_lib_context_helpers = require("@powerlines/core/lib/context-helpers");
+let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let _stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let defu = require("defu");
+
+//#region src/helpers/create-execution-host.ts
+/**
+* Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
+*
+* @param methods - An object where keys are method names and values are functions that take an execution context and return a promise.
+* @param inlineConfig - An optional partial inline configuration object that will be merged with the context's options when creating the execution context for each method.
+* @returns An object with the same keys as the input methods, but each function is wrapped to create an execution context and handle errors.
+*/
+function createExecutionHost(methods, inlineConfig = {}) {
+	return Object.fromEntries(Object.entries(methods).map(([method, fn]) => [method, async (params) => {
+		const { options } = params;
+		let rpc;
+		if (options.baseURL && options.connection) rpc = require_helpers_rpc.createRpcClient(options);
+		else throw new Error(`Execution RPC client could not be created - Missing ${!options.baseURL ? `baseURL${options.connection ? ` and connection information` : ""}` : "connection"} or connection information.`);
+		const logFn = (meta, message) => {
+			(0, _powerlines_core_plugin_utils.consoleLogger)(meta, message);
+			if (rpc) rpc.callEvent("powerlines:log", {
+				meta: {
+					category: "general",
+					...options,
+					...(0, _stryke_type_checks_is_set_object.isSetObject)(meta) ? meta : { type: meta },
+					logId: (0, _stryke_unique_id_uuid.uuid)(),
+					timestamp: Date.now()
+				},
+				message
+			});
+		};
+		const context = await _powerlines_core_context_execution_context.PowerlinesExecutionContext.from({
+			...options,
+			logFn
+		}, (0, _stryke_type_checks_is_function.isFunction)(inlineConfig) ? await Promise.resolve(inlineConfig(params.inlineConfig ?? {})) : (0, defu.defu)(inlineConfig, params.inlineConfig ?? {}), { rpc });
+		context.logger.info(`Starting ${(0, _stryke_string_format_title_case.titleCase)(options.framework?.name) || "Powerlines"} - ${(0, _stryke_string_format_title_case.titleCase)(method)} execution (${options.executionId})`);
+		await (0, _powerlines_core_lib_context_helpers.resolvePluginConfig)(context);
+		await fn(context);
+	}]));
+}
+
+//#endregion
+exports.createExecutionHost = createExecutionHost;

package/dist/helpers/create-execution-host.d.cts

@@ -0,0 +1,21 @@
+import { r as EngineResolvedConfig } from "../config-D6xUniHh.cjs";
+import { r as EngineSystemContext } from "../context-epL7NPvL.cjs";
+import { r as ExecutionHostParams } from "../api-6w4hZL6n.cjs";
+import { InlineConfig } from "@powerlines/core";
+import { DeepPartial, MaybePromise } from "@stryke/types/base";
+import { PowerlinesExecutionContext } from "@powerlines/core/context/execution-context";
+
+//#region src/helpers/create-execution-host.d.ts
+/**
+ * Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
+ *
+ * @param methods - An object where keys are method names and values are functions that take an execution context and return a promise.
+ * @param inlineConfig - An optional partial inline configuration object that will be merged with the context's options when creating the execution context for each method.
+ * @returns An object with the same keys as the input methods, but each function is wrapped to create an execution context and handle errors.
+ */
+declare function createExecutionHost<TContext extends PowerlinesExecutionContext<EngineResolvedConfig, EngineSystemContext> = PowerlinesExecutionContext<EngineResolvedConfig, EngineSystemContext>>(methods: Record<string, (context: TContext) => Promise<void>>, inlineConfig?: DeepPartial<InlineConfig> | ((prev: InlineConfig) => MaybePromise<InlineConfig>)): {
+  [k: string]: (params: ExecutionHostParams) => Promise<void>;
+};
+//#endregion
+export { createExecutionHost };
+//# sourceMappingURL=create-execution-host.d.cts.map

package/dist/helpers/create-execution-host.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-execution-host.d.cts","names":[],"sources":["../../src/helpers/create-execution-host.ts"],"mappings":";;;;;;;;;;AAyCA;;;;;iBAAgB,mBAAA,kBACG,0BAAA,CACf,oBAAA,EACA,mBAAA,IACE,0BAAA,CAA2B,oBAAA,EAAsB,mBAAA,EAAA,CAErD,OAAA,EAAS,MAAA,UAAgB,OAAA,EAAS,QAAA,KAAa,OAAA,SAC/C,YAAA,GACI,WAAA,CAAY,YAAA,MACV,IAAA,EAAM,YAAA,KAAiB,YAAA,CAAa,YAAA;EAAA,sBAKvB,mBAAA,KAAmB,OAAA;AAAA"}

package/dist/helpers/create-execution-host.d.mts

@@ -0,0 +1,21 @@
+import { r as EngineResolvedConfig } from "../config-BNe23XHx.mjs";
+import { r as EngineSystemContext } from "../context-DzgsMSWr.mjs";
+import { r as ExecutionHostParams } from "../api-Cdw4v0W4.mjs";
+import { InlineConfig } from "@powerlines/core";
+import { PowerlinesExecutionContext } from "@powerlines/core/context/execution-context";
+import { DeepPartial, MaybePromise } from "@stryke/types/base";
+
+//#region src/helpers/create-execution-host.d.ts
+/**
+ * Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
+ *
+ * @param methods - An object where keys are method names and values are functions that take an execution context and return a promise.
+ * @param inlineConfig - An optional partial inline configuration object that will be merged with the context's options when creating the execution context for each method.
+ * @returns An object with the same keys as the input methods, but each function is wrapped to create an execution context and handle errors.
+ */
+declare function createExecutionHost<TContext extends PowerlinesExecutionContext<EngineResolvedConfig, EngineSystemContext> = PowerlinesExecutionContext<EngineResolvedConfig, EngineSystemContext>>(methods: Record<string, (context: TContext) => Promise<void>>, inlineConfig?: DeepPartial<InlineConfig> | ((prev: InlineConfig) => MaybePromise<InlineConfig>)): {
+  [k: string]: (params: ExecutionHostParams) => Promise<void>;
+};
+//#endregion
+export { createExecutionHost };
+//# sourceMappingURL=create-execution-host.d.mts.map

package/dist/helpers/create-execution-host.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-execution-host.d.mts","names":[],"sources":["../../src/helpers/create-execution-host.ts"],"mappings":";;;;;;;;;;AAyCA;;;;;iBAAgB,mBAAA,kBACG,0BAAA,CACf,oBAAA,EACA,mBAAA,IACE,0BAAA,CAA2B,oBAAA,EAAsB,mBAAA,EAAA,CAErD,OAAA,EAAS,MAAA,UAAgB,OAAA,EAAS,QAAA,KAAa,OAAA,SAC/C,YAAA,GACI,WAAA,CAAY,YAAA,MACV,IAAA,EAAM,YAAA,KAAiB,YAAA,CAAa,YAAA;EAAA,sBAKvB,mBAAA,KAAmB,OAAA;AAAA"}

package/dist/helpers/create-execution-host.mjs

@@ -0,0 +1,50 @@
+import { createRpcClient } from "./rpc.mjs";
+import { consoleLogger } from "@powerlines/core/plugin-utils";
+import { uuid } from "@stryke/unique-id/uuid";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { PowerlinesExecutionContext } from "@powerlines/core/context/execution-context";
+import { resolvePluginConfig } from "@powerlines/core/lib/context-helpers";
+import { titleCase } from "@stryke/string-format/title-case";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { defu } from "defu";
+
+//#region src/helpers/create-execution-host.ts
+/**
+* Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
+*
+* @param methods - An object where keys are method names and values are functions that take an execution context and return a promise.
+* @param inlineConfig - An optional partial inline configuration object that will be merged with the context's options when creating the execution context for each method.
+* @returns An object with the same keys as the input methods, but each function is wrapped to create an execution context and handle errors.
+*/
+function createExecutionHost(methods, inlineConfig = {}) {
+	return Object.fromEntries(Object.entries(methods).map(([method, fn]) => [method, async (params) => {
+		const { options } = params;
+		let rpc;
+		if (options.baseURL && options.connection) rpc = createRpcClient(options);
+		else throw new Error(`Execution RPC client could not be created - Missing ${!options.baseURL ? `baseURL${options.connection ? ` and connection information` : ""}` : "connection"} or connection information.`);
+		const logFn = (meta, message) => {
+			consoleLogger(meta, message);
+			if (rpc) rpc.callEvent("powerlines:log", {
+				meta: {
+					category: "general",
+					...options,
+					...isSetObject(meta) ? meta : { type: meta },
+					logId: uuid(),
+					timestamp: Date.now()
+				},
+				message
+			});
+		};
+		const context = await PowerlinesExecutionContext.from({
+			...options,
+			logFn
+		}, isFunction(inlineConfig) ? await Promise.resolve(inlineConfig(params.inlineConfig ?? {})) : defu(inlineConfig, params.inlineConfig ?? {}), { rpc });
+		context.logger.info(`Starting ${titleCase(options.framework?.name) || "Powerlines"} - ${titleCase(method)} execution (${options.executionId})`);
+		await resolvePluginConfig(context);
+		await fn(context);
+	}]));
+}
+
+//#endregion
+export { createExecutionHost };
+//# sourceMappingURL=create-execution-host.mjs.map

package/dist/helpers/create-execution-host.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-execution-host.mjs","names":[],"sources":["../../src/helpers/create-execution-host.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 { InlineConfig, LogFnMeta } from \"@powerlines/core\";\nimport { PowerlinesExecutionContext } from \"@powerlines/core/context/execution-context\";\nimport { resolvePluginConfig } from \"@powerlines/core/lib/context-helpers\";\nimport { consoleLogger } from \"@powerlines/core/plugin-utils\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { DeepPartial, MaybePromise } from \"@stryke/types/base\";\nimport { uuid } from \"@stryke/unique-id/uuid\";\nimport { defu } from \"defu\";\nimport { RpcClient } from \"../types\";\nimport { ExecutionHostParams } from \"../types/api\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { createRpcClient } from \"./rpc\";\n\n/**\n * Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.\n *\n * @param methods - An object where keys are method names and values are functions that take an execution context and return a promise.\n * @param inlineConfig - An optional partial inline configuration object that will be merged with the context's options when creating the execution context for each method.\n * @returns An object with the same keys as the input methods, but each function is wrapped to create an execution context and handle errors.\n */\nexport function createExecutionHost<\n  TContext extends PowerlinesExecutionContext<\n    EngineResolvedConfig,\n    EngineSystemContext\n  > = PowerlinesExecutionContext<EngineResolvedConfig, EngineSystemContext>\n>(\n  methods: Record<string, (context: TContext) => Promise<void>>,\n  inlineConfig:\n    | DeepPartial<InlineConfig>\n    | ((prev: InlineConfig) => MaybePromise<InlineConfig>) = {}\n) {\n  return Object.fromEntries(\n    Object.entries(methods).map(([method, fn]) => [\n      method,\n      async (params: ExecutionHostParams) => {\n        const { options } = params;\n\n        let rpc!: RpcClient;\n        if (options.baseURL && options.connection) {\n          rpc = createRpcClient(options);\n        } else {\n          throw new Error(\n            `Execution RPC client could not be created - Missing ${\n              !options.baseURL\n                ? `baseURL${options.connection ? ` and connection information` : \"\"}`\n                : \"connection\"\n            } or connection information.`\n          );\n        }\n\n        const logFn = (meta: LogFnMeta, message: string) => {\n          consoleLogger(meta, message);\n          if (rpc) {\n            void rpc.callEvent(\"powerlines:log\", {\n              meta: {\n                category: \"general\",\n                ...options,\n                ...(isSetObject(meta) ? meta : { type: meta }),\n                logId: uuid(),\n                timestamp: Date.now()\n              },\n              message\n            });\n          }\n        };\n\n        const context = (await PowerlinesExecutionContext.from<\n          EngineResolvedConfig,\n          EngineSystemContext\n        >(\n          { ...options, logFn },\n          isFunction(inlineConfig)\n            ? await Promise.resolve(inlineConfig(params.inlineConfig ?? {}))\n            : (defu(inlineConfig, params.inlineConfig ?? {}) as InlineConfig),\n          {\n            rpc\n          }\n        )) as TContext;\n\n        context.logger.info(\n          `Starting ${\n            titleCase(options.framework?.name) || \"Powerlines\"\n          } - ${titleCase(method)} execution (${options.executionId})`\n        );\n\n        await resolvePluginConfig(context as PowerlinesExecutionContext<any>);\n\n        await fn(context);\n      }\n    ])\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAyCA,SAAgB,oBAMd,SACA,eAE2D,EAAE,EAC7D;AACA,QAAO,OAAO,YACZ,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,QAAQ,QAAQ,CAC5C,QACA,OAAO,WAAgC;EACrC,MAAM,EAAE,YAAY;EAEpB,IAAI;AACJ,MAAI,QAAQ,WAAW,QAAQ,WAC7B,OAAM,gBAAgB,QAAQ;MAE9B,OAAM,IAAI,MACR,uDACE,CAAC,QAAQ,UACL,UAAU,QAAQ,aAAa,gCAAgC,OAC/D,aACL,6BACF;EAGH,MAAM,SAAS,MAAiB,YAAoB;AAClD,iBAAc,MAAM,QAAQ;AAC5B,OAAI,IACF,CAAK,IAAI,UAAU,kBAAkB;IACnC,MAAM;KACJ,UAAU;KACV,GAAG;KACH,GAAI,YAAY,KAAK,GAAG,OAAO,EAAE,MAAM,MAAM;KAC7C,OAAO,MAAM;KACb,WAAW,KAAK,KAAK;KACtB;IACD;IACD,CAAC;;EAIN,MAAM,UAAW,MAAM,2BAA2B,KAIhD;GAAE,GAAG;GAAS;GAAO,EACrB,WAAW,aAAa,GACpB,MAAM,QAAQ,QAAQ,aAAa,OAAO,gBAAgB,EAAE,CAAC,CAAC,GAC7D,KAAK,cAAc,OAAO,gBAAgB,EAAE,CAAC,EAClD,EACE,KACD,CACF;AAED,UAAQ,OAAO,KACb,YACE,UAAU,QAAQ,WAAW,KAAK,IAAI,aACvC,KAAK,UAAU,OAAO,CAAC,cAAc,QAAQ,YAAY,GAC3D;AAED,QAAM,oBAAoB,QAA2C;AAErE,QAAM,GAAG,QAAQ;GAEpB,CAAC,CACH"}