@powerlines/engine 0.49.13 → 0.49.14

package/dist/engine.d.cts

@@ -1,143 +1,2 @@
-import { n as EngineOptions } from "./config-DKEmqMrh.cjs";
-import { t as EngineContext } from "./context-D0_a0kRO.cjs";
-import { n as ExecutionHost, t as Engine } from "./api-DcHfCjQK.cjs";
-import { t as PowerlinesEngineContext } from "./engine-context-B8K6Jtkk.cjs";
-import { BuildInlineConfig, CleanInlineConfig, CreateInlineConfig, DeployInlineConfig, DocsInlineConfig, InlineConfig, LintInlineConfig, PrepareInlineConfig, TestInlineConfig, TypesInlineConfig } from "@powerlines/core";
-import { EXECUTION_API_METHODS } from "@powerlines/core/constants";
-
-//#region src/engine.d.ts
-/**
- * The Powerlines process' orchestration and coordination API.
- *
- * @public
- */
-declare class PowerlinesEngine<TExecutionAPI extends ReadonlyArray<string> = typeof EXECUTION_API_METHODS> implements Engine<TExecutionAPI>, AsyncDisposable {
-  #private;
-  /**
-   * The Powerlines context
-   */
-  get context(): EngineContext;
-  /**
-   * 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(): ExecutionHost<TExecutionAPI>;
-  /**
-   * 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: EngineContext, host: ExecutionHost<TExecutionAPI>);
-  /**
-   * 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
-   */
-  create(inlineConfig: CreateInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  types(inlineConfig: TypesInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  prepare(inlineConfig: PrepareInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  clean(inlineConfig: CleanInlineConfig): Promise<void>;
-  /**
-   * Lint the project
-   *
-   * @param inlineConfig - The inline configuration for the lint command
-   * @returns A promise that resolves when the lint command has completed
-   */
-  lint(inlineConfig: LintInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  test(inlineConfig: TestInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  build(inlineConfig: BuildInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  docs(inlineConfig: DocsInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  deploy(inlineConfig: DeployInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  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>;
-  /**
-   * 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
-   */
-  protected execute(method: TExecutionAPI[number], inlineConfig: InlineConfig): Promise<void>;
-}
-declare function createContext(options: EngineOptions): Promise<PowerlinesEngineContext<unknown>>;
-declare function createEngine<TExecutionAPI extends ReadonlyArray<string>>(options: EngineOptions, apiPath?: string, apiMethods?: TExecutionAPI): Promise<PowerlinesEngine<TExecutionAPI>>;
-//#endregion
-export { PowerlinesEngine, createContext, createEngine };
-//# sourceMappingURL=engine.d.cts.map
+import { n as createContext, r as createEngine, t as PowerlinesEngine } from "./engine-DFKgU8-G.cjs";
+export { PowerlinesEngine, createContext, createEngine };

package/dist/engine.d.mts

@@ -1,143 +1,2 @@
-import { n as EngineOptions } from "./config-ByLyzMI0.mjs";
-import { t as EngineContext } from "./context-DcXV6_GL.mjs";
-import { n as ExecutionHost, t as Engine } from "./api-BgyEi2hF.mjs";
-import { t as PowerlinesEngineContext } from "./engine-context-DKlA5Pgu.mjs";
-import { BuildInlineConfig, CleanInlineConfig, CreateInlineConfig, DeployInlineConfig, DocsInlineConfig, InlineConfig, LintInlineConfig, PrepareInlineConfig, TestInlineConfig, TypesInlineConfig } from "@powerlines/core";
-import { EXECUTION_API_METHODS } from "@powerlines/core/constants";
-
-//#region src/engine.d.ts
-/**
- * The Powerlines process' orchestration and coordination API.
- *
- * @public
- */
-declare class PowerlinesEngine<TExecutionAPI extends ReadonlyArray<string> = typeof EXECUTION_API_METHODS> implements Engine<TExecutionAPI>, AsyncDisposable {
-  #private;
-  /**
-   * The Powerlines context
-   */
-  get context(): EngineContext;
-  /**
-   * 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(): ExecutionHost<TExecutionAPI>;
-  /**
-   * 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: EngineContext, host: ExecutionHost<TExecutionAPI>);
-  /**
-   * 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
-   */
-  create(inlineConfig: CreateInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  types(inlineConfig: TypesInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  prepare(inlineConfig: PrepareInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  clean(inlineConfig: CleanInlineConfig): Promise<void>;
-  /**
-   * Lint the project
-   *
-   * @param inlineConfig - The inline configuration for the lint command
-   * @returns A promise that resolves when the lint command has completed
-   */
-  lint(inlineConfig: LintInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  test(inlineConfig: TestInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  build(inlineConfig: BuildInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  docs(inlineConfig: DocsInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  deploy(inlineConfig: DeployInlineConfig): Promise<void>;
-  /**
-   * 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
-   */
-  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>;
-  /**
-   * 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
-   */
-  protected execute(method: TExecutionAPI[number], inlineConfig: InlineConfig): Promise<void>;
-}
-declare function createContext(options: EngineOptions): Promise<PowerlinesEngineContext<unknown>>;
-declare function createEngine<TExecutionAPI extends ReadonlyArray<string>>(options: EngineOptions, apiPath?: string, apiMethods?: TExecutionAPI): Promise<PowerlinesEngine<TExecutionAPI>>;
-//#endregion
-export { PowerlinesEngine, createContext, createEngine };
-//# sourceMappingURL=engine.d.mts.map
+import { n as createContext, r as createEngine, t as PowerlinesEngine } from "./engine-BLp7JcAB.mjs";
+export { PowerlinesEngine, createContext, createEngine };

package/dist/engine.mjs

@@ -1,3 +1,3 @@
-import { n as createContext, r as createEngine, t as PowerlinesEngine } from "./engine-BWwXttY1.mjs";
+import { n as createContext, r as createEngine, t as PowerlinesEngine } from "./engine-CDFOkhKj.mjs";
 
 export { PowerlinesEngine, createContext, createEngine };

package/dist/helpers/{create-execution-host.cjs → create-api.cjs}

@@ -10,17 +10,18 @@ let _stryke_type_checks_is_function = require("@stryke/type-checks/is-function")
 let _stryke_unique_id_uuid = require("@stryke/unique-id/uuid");
 let defu = require("defu");
 
-//#region src/helpers/create-execution-host.ts
+//#region src/helpers/create-api.ts
 /**
-* Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
+* Creates an execution API 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.
+* @param handlers - An object where keys are command 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 command.
+* @returns A function that can be used as an execution API handler, which takes execution parameters and invokes the appropriate command handler with a properly constructed execution context.
 */
-function createExecutionHost(methods, inlineConfig = {}) {
-	return Object.fromEntries(Object.entries(methods).map(([method, fn]) => [method, async (params) => {
-		const { options, port } = params;
+function createApi(handlers, inlineConfig = {}) {
+	return async (params) => {
+		const { command, options, port } = params;
+		if (!handlers[command]) throw new Error(`No handler found for command "${command}". Please ensure that the command is defined in the API handlers provided to \`createApi\`.`);
 		const duplex = new require_helpers_stream.MessagePortDuplex(port);
 		duplex.setEncoding("utf8");
 		duplex.on("data", (chunk) => duplex.write(chunk.toUpperCase()));
@@ -47,12 +48,12 @@ function createExecutionHost(methods, inlineConfig = {}) {
 			...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})`);
+		context.logger.info(`Starting ${(0, _stryke_string_format_title_case.titleCase)(options.framework?.name) || "Powerlines"} - ${(0, _stryke_string_format_title_case.titleCase)(command)} execution (${options.executionId})`);
 		await (0, _powerlines_core_lib_context_helpers.resolvePluginConfig)(context);
-		if (!context.config.input) throw new Error(`No input defined in configuration for ${method} execution. Please ensure that the configuration file defines an input for this execution, or provide an inline configuration with the necessary input.`);
-		await fn(context);
-	}]));
+		if (!context.config.input) throw new Error(`No input defined in configuration for ${command} execution. Please ensure that the configuration file defines an input for this execution, or provide an inline configuration with the necessary input.`);
+		await handlers[command](context);
+	};
 }
 
 //#endregion
-exports.createExecutionHost = createExecutionHost;
+exports.createApi = createApi;

package/dist/helpers/create-api.d.cts

@@ -0,0 +1,18 @@
+import { r as EngineResolvedConfig } from "../config-DKEmqMrh.cjs";
+import { r as EngineSystemContext } from "../context-D0_a0kRO.cjs";
+import { n as ExecutionApiParams } from "../api-D1r7WAQA.cjs";
+import { ExecutionContext, InlineConfig } from "@powerlines/core";
+import { DeepPartial, MaybePromise } from "@stryke/types/base";
+
+//#region src/helpers/create-api.d.ts
+/**
+ * Creates an execution API with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
+ *
+ * @param handlers - An object where keys are command 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 command.
+ * @returns A function that can be used as an execution API handler, which takes execution parameters and invokes the appropriate command handler with a properly constructed execution context.
+ */
+declare function createApi<TContext extends ExecutionContext<EngineResolvedConfig, EngineSystemContext> = ExecutionContext<EngineResolvedConfig, EngineSystemContext>>(handlers: Record<string, (context: TContext) => Promise<void>>, inlineConfig?: DeepPartial<InlineConfig> | ((prev: InlineConfig) => MaybePromise<InlineConfig>)): (params: ExecutionApiParams) => Promise<void>;
+//#endregion
+export { createApi };
+//# sourceMappingURL=create-api.d.cts.map

package/dist/helpers/create-api.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-api.d.cts","names":[],"sources":["../../src/helpers/create-api.ts"],"mappings":";;;;;;;;;AA8CA;;;;;iBAAgB,SAAA,kBACG,gBAAA,CAAiB,oBAAA,EAAsB,mBAAA,IACtD,gBAAA,CAAiB,oBAAA,EAAsB,mBAAA,EAAA,CAEzC,QAAA,EAAU,MAAA,UAAgB,OAAA,EAAS,QAAA,KAAa,OAAA,SAChD,YAAA,GACI,WAAA,CAAY,YAAA,MACV,IAAA,EAAM,YAAA,KAAiB,YAAA,CAAa,YAAA,MAE5B,MAAA,EAAQ,kBAAA,KAAkB,OAAA"}

package/dist/helpers/create-api.d.mts

@@ -0,0 +1,18 @@
+import { r as EngineResolvedConfig } from "../config-ByLyzMI0.mjs";
+import { r as EngineSystemContext } from "../context-DcXV6_GL.mjs";
+import { n as ExecutionApiParams } from "../api-DRcC7Ry-.mjs";
+import { ExecutionContext, InlineConfig } from "@powerlines/core";
+import { DeepPartial, MaybePromise } from "@stryke/types/base";
+
+//#region src/helpers/create-api.d.ts
+/**
+ * Creates an execution API with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
+ *
+ * @param handlers - An object where keys are command 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 command.
+ * @returns A function that can be used as an execution API handler, which takes execution parameters and invokes the appropriate command handler with a properly constructed execution context.
+ */
+declare function createApi<TContext extends ExecutionContext<EngineResolvedConfig, EngineSystemContext> = ExecutionContext<EngineResolvedConfig, EngineSystemContext>>(handlers: Record<string, (context: TContext) => Promise<void>>, inlineConfig?: DeepPartial<InlineConfig> | ((prev: InlineConfig) => MaybePromise<InlineConfig>)): (params: ExecutionApiParams) => Promise<void>;
+//#endregion
+export { createApi };
+//# sourceMappingURL=create-api.d.mts.map

package/dist/helpers/create-api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-api.d.mts","names":[],"sources":["../../src/helpers/create-api.ts"],"mappings":";;;;;;;;;AA8CA;;;;;iBAAgB,SAAA,kBACG,gBAAA,CAAiB,oBAAA,EAAsB,mBAAA,IACtD,gBAAA,CAAiB,oBAAA,EAAsB,mBAAA,EAAA,CAEzC,QAAA,EAAU,MAAA,UAAgB,OAAA,EAAS,QAAA,KAAa,OAAA,SAChD,YAAA,GACI,WAAA,CAAY,YAAA,MACV,IAAA,EAAM,YAAA,KAAiB,YAAA,CAAa,YAAA,MAE5B,MAAA,EAAQ,kBAAA,KAAkB,OAAA"}

package/dist/helpers/{create-execution-host.mjs → create-api.mjs}

@@ -9,17 +9,18 @@ import { isFunction } from "@stryke/type-checks/is-function";
 import { uuid } from "@stryke/unique-id/uuid";
 import { defu } from "defu";
 
-//#region src/helpers/create-execution-host.ts
+//#region src/helpers/create-api.ts
 /**
-* Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
+* Creates an execution API 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.
+* @param handlers - An object where keys are command 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 command.
+* @returns A function that can be used as an execution API handler, which takes execution parameters and invokes the appropriate command handler with a properly constructed execution context.
 */
-function createExecutionHost(methods, inlineConfig = {}) {
-	return Object.fromEntries(Object.entries(methods).map(([method, fn]) => [method, async (params) => {
-		const { options, port } = params;
+function createApi(handlers, inlineConfig = {}) {
+	return async (params) => {
+		const { command, options, port } = params;
+		if (!handlers[command]) throw new Error(`No handler found for command "${command}". Please ensure that the command is defined in the API handlers provided to \`createApi\`.`);
 		const duplex = new MessagePortDuplex(port);
 		duplex.setEncoding("utf8");
 		duplex.on("data", (chunk) => duplex.write(chunk.toUpperCase()));
@@ -46,13 +47,13 @@ function createExecutionHost(methods, inlineConfig = {}) {
 			...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})`);
+		context.logger.info(`Starting ${titleCase(options.framework?.name) || "Powerlines"} - ${titleCase(command)} execution (${options.executionId})`);
 		await resolvePluginConfig(context);
-		if (!context.config.input) throw new Error(`No input defined in configuration for ${method} execution. Please ensure that the configuration file defines an input for this execution, or provide an inline configuration with the necessary input.`);
-		await fn(context);
-	}]));
+		if (!context.config.input) throw new Error(`No input defined in configuration for ${command} execution. Please ensure that the configuration file defines an input for this execution, or provide an inline configuration with the necessary input.`);
+		await handlers[command](context);
+	};
 }
 
 //#endregion
-export { createExecutionHost };
-//# sourceMappingURL=create-execution-host.mjs.map
+export { createApi };
+//# sourceMappingURL=create-api.mjs.map

package/dist/helpers/create-api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-api.mjs","names":[],"sources":["../../src/helpers/create-api.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  ExecutionContext,\n  InlineConfig,\n  LogFnMeta\n} 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 type { DeepPartial, MaybePromise } from \"@stryke/types/base\";\nimport { uuid } from \"@stryke/unique-id/uuid\";\nimport { defu } from \"defu\";\nimport type { RpcClient } from \"../types\";\nimport type { ExecutionApiParams } from \"../types/api\";\nimport type { EngineResolvedConfig } from \"../types/config\";\nimport type { EngineSystemContext } from \"../types/context\";\nimport { createRpcClient } from \"./rpc\";\nimport { MessagePortDuplex } from \"./stream\";\n\n/**\n * Creates an execution API with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.\n *\n * @param handlers - An object where keys are command 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 command.\n * @returns A function that can be used as an execution API handler, which takes execution parameters and invokes the appropriate command handler with a properly constructed execution context.\n */\nexport function createApi<\n  TContext extends ExecutionContext<EngineResolvedConfig, EngineSystemContext> =\n    ExecutionContext<EngineResolvedConfig, EngineSystemContext>\n>(\n  handlers: Record<string, (context: TContext) => Promise<void>>,\n  inlineConfig:\n    | DeepPartial<InlineConfig>\n    | ((prev: InlineConfig) => MaybePromise<InlineConfig>) = {}\n) {\n  return async (params: ExecutionApiParams) => {\n    const { command, options, port } = params;\n\n    if (!handlers[command]) {\n      throw new Error(\n        `No handler found for command \"${\n          command\n        }\". Please ensure that the command is defined in the API handlers provided to \\`createApi\\`.`\n      );\n    }\n\n    const duplex = new MessagePortDuplex(port);\n    duplex.setEncoding(\"utf8\");\n    duplex.on(\"data\", (chunk: string) => duplex.write(chunk.toUpperCase()));\n    duplex.on(\"end\", () => {\n      duplex.end();\n    });\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(command)} execution (${options.executionId})`\n    );\n\n    await resolvePluginConfig<EngineResolvedConfig, EngineSystemContext>(\n      context\n    );\n\n    if (!context.config.input) {\n      throw new Error(\n        `No input defined in configuration for ${\n          command\n        } execution. Please ensure that the configuration file defines an input for this execution, or provide an inline configuration with the necessary input.`\n      );\n    }\n\n    await handlers[command](context);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA8CA,SAAgB,UAId,UACA,eAE2D,CAAC,GAC5D;CACA,OAAO,OAAO,WAA+B;EAC3C,MAAM,EAAE,SAAS,SAAS,SAAS;EAEnC,IAAI,CAAC,SAAS,UACZ,MAAM,IAAI,MACR,iCACE,QACD,4FACH;EAGF,MAAM,SAAS,IAAI,kBAAkB,IAAI;EACzC,OAAO,YAAY,MAAM;EACzB,OAAO,GAAG,SAAS,UAAkB,OAAO,MAAM,MAAM,YAAY,CAAC,CAAC;EACtE,OAAO,GAAG,aAAa;GACrB,OAAO,IAAI;EACb,CAAC;EAED,IAAI;EACJ,IAAI,QAAQ,WAAW,QAAQ,YAC7B,MAAM,gBAAgB,OAAO;OAE7B,MAAM,IAAI,MACR,uDACE,CAAC,QAAQ,UACL,UAAU,QAAQ,aAAa,gCAAgC,OAC/D,aACL,4BACH;EAGF,MAAM,SAAS,MAAiB,YAAoB;GAClD,cAAc,MAAM,OAAO;GAC3B,IAAI,KACF,AAAK,IAAI,UAAU,kBAAkB;IACnC,MAAM;KACJ,UAAU;KACV,GAAG;KACH,GAAI,YAAY,IAAI,IAAI,OAAO,EAAE,MAAM,KAAK;KAC5C,OAAO,KAAK;KACZ,WAAW,KAAK,IAAI;IACtB;IACA;GACF,CAAC;EAEL;EAEA,MAAM,UAAW,MAAM,2BAA2B,KAIhD;GAAE,GAAG;GAAS;EAAM,GACpB,WAAW,YAAY,IACnB,MAAM,QAAQ,QAAQ,aAAa,OAAO,gBAAgB,CAAC,CAAC,CAAC,IAC5D,KAAK,cAAc,OAAO,gBAAgB,CAAC,CAAC,GACjD,EACE,IACF,CACF;EAEA,QAAQ,OAAO,KACb,YACE,UAAU,QAAQ,WAAW,IAAI,KAAK,aACvC,KAAK,UAAU,OAAO,EAAE,cAAc,QAAQ,YAAY,EAC7D;EAEA,MAAM,oBACJ,OACF;EAEA,IAAI,CAAC,QAAQ,OAAO,OAClB,MAAM,IAAI,MACR,yCACE,QACD,wJACH;EAGF,MAAM,SAAS,SAAS,OAAO;CACjC;AACF"}

package/dist/helpers/index.cjs

@@ -1,12 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_helpers_rpc = require('./rpc.cjs');
 const require_helpers_stream = require('./stream.cjs');
-const require_helpers_create_execution_host = require('./create-execution-host.cjs');
+const require_helpers_create_api = require('./create-api.cjs');
 const require_helpers_finalize = require('./finalize.cjs');
 
 exports.MessagePortDuplex = require_helpers_stream.MessagePortDuplex;
 exports.MessagePortReadable = require_helpers_stream.MessagePortReadable;
 exports.MessagePortWritable = require_helpers_stream.MessagePortWritable;
-exports.createExecutionHost = require_helpers_create_execution_host.createExecutionHost;
+exports.createApi = require_helpers_create_api.createApi;
 exports.createRpcClient = require_helpers_rpc.createRpcClient;
 exports.finalize = require_helpers_finalize.finalize;

package/dist/helpers/index.d.cts

@@ -1,5 +1,5 @@
-import { createExecutionHost } from "./create-execution-host.cjs";
+import { createApi } from "./create-api.cjs";
 import { finalize } from "./finalize.cjs";
 import { createRpcClient } from "./rpc.cjs";
 import { MessagePortDuplex, MessagePortDuplexOptions, MessagePortReadable, MessagePortWritable } from "./stream.cjs";
-export { MessagePortDuplex, MessagePortDuplexOptions, MessagePortReadable, MessagePortWritable, createExecutionHost, createRpcClient, finalize };
+export { MessagePortDuplex, MessagePortDuplexOptions, MessagePortReadable, MessagePortWritable, createApi, createRpcClient, finalize };

package/dist/helpers/index.d.mts

@@ -1,5 +1,5 @@
-import { createExecutionHost } from "./create-execution-host.mjs";
+import { createApi } from "./create-api.mjs";
 import { finalize } from "./finalize.mjs";
 import { createRpcClient } from "./rpc.mjs";
 import { MessagePortDuplex, MessagePortDuplexOptions, MessagePortReadable, MessagePortWritable } from "./stream.mjs";
-export { MessagePortDuplex, MessagePortDuplexOptions, MessagePortReadable, MessagePortWritable, createExecutionHost, createRpcClient, finalize };
+export { MessagePortDuplex, MessagePortDuplexOptions, MessagePortReadable, MessagePortWritable, createApi, createRpcClient, finalize };

package/dist/helpers/index.mjs

@@ -1,6 +1,6 @@
 import { createRpcClient } from "./rpc.mjs";
 import { MessagePortDuplex, MessagePortReadable, MessagePortWritable } from "./stream.mjs";
-import { createExecutionHost } from "./create-execution-host.mjs";
+import { createApi } from "./create-api.mjs";
 import { finalize } from "./finalize.mjs";
 
-export { MessagePortDuplex, MessagePortReadable, MessagePortWritable, createExecutionHost, createRpcClient, finalize };
+export { MessagePortDuplex, MessagePortReadable, MessagePortWritable, createApi, createRpcClient, finalize };

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_engine = require('./engine-CYesECu-.cjs');
+const require_engine = require('./engine-DlOFwFgt.cjs');
 const require_context_engine_context = require('./context/engine-context.cjs');
 require('./context/index.cjs');
 

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { C as RpcServerFunctions, D as WrappedRpcFunctions, E as WrappedRpcFunction, S as RpcPayloadMetadata, T as WrapRpcFunctions, _ as RpcClientRemoteFunctions, a as ExtractRpcFunction, b as RpcFunctions, c as InputRpcFunctions, d as RpcClientCall, f as RpcClientCallEvent, g as RpcClientHost, h as RpcClientFunctions, i as RpcClientOptions, l as LogPayload, m as RpcClientEvents, n as EngineOptions, o as ExtractRpcFunctions, p as RpcClientCallOptional, r as EngineResolvedConfig, s as InputRpcFunction, t as EngineExecutionOptions, u as RpcClient, v as RpcContext, w as WrapRpcFunction, x as RpcPayloadEnvelop, y as RpcFunction } from "./config-DKEmqMrh.cjs";
 import { a as ExecutionHookScopeState, c as ExecutionScopeType, i as ExecutionCommandScopeState, l as ExecutionState, n as EngineExecutionItem, o as ExecutionPluginScopeState, r as EngineSystemContext, s as ExecutionScopeState, t as EngineContext } from "./context-D0_a0kRO.cjs";
-import { a as PowerlinesExecutionHost, i as ExecutionInterface, n as ExecutionHost, o as Worker, r as ExecutionHostParams, t as Engine } from "./api-DcHfCjQK.cjs";
+import { i as ExecutionInterface, n as ExecutionApiParams, r as ExecutionApiWorkerInterface, t as Engine } from "./api-D1r7WAQA.cjs";
 import { t as PowerlinesEngineContext } from "./engine-context-B8K6Jtkk.cjs";
-import { PowerlinesEngine, createContext, createEngine } from "./engine.cjs";
-export { type Engine, type EngineContext, type EngineExecutionItem, type EngineExecutionOptions, type EngineOptions, type EngineResolvedConfig, type EngineSystemContext, type ExecutionCommandScopeState, type ExecutionHookScopeState, type ExecutionHost, type ExecutionHostParams, type ExecutionInterface, type ExecutionPluginScopeState, type ExecutionScopeState, type ExecutionScopeType, type ExecutionState, type ExtractRpcFunction, type ExtractRpcFunctions, type InputRpcFunction, type InputRpcFunctions, type LogPayload, PowerlinesEngine, PowerlinesEngineContext, type PowerlinesExecutionHost, type RpcClient, type RpcClientCall, type RpcClientCallEvent, type RpcClientCallOptional, type RpcClientEvents, type RpcClientFunctions, type RpcClientHost, type RpcClientOptions, type RpcClientRemoteFunctions, type RpcContext, type RpcFunction, type RpcFunctions, type RpcPayloadEnvelop, type RpcPayloadMetadata, type RpcServerFunctions, type Worker, type WrapRpcFunction, type WrapRpcFunctions, type WrappedRpcFunction, type WrappedRpcFunctions, createContext, createEngine };
+import { n as createContext, r as createEngine, t as PowerlinesEngine } from "./engine-DFKgU8-G.cjs";
+export { type Engine, type EngineContext, type EngineExecutionItem, type EngineExecutionOptions, type EngineOptions, type EngineResolvedConfig, type EngineSystemContext, type ExecutionApiParams, type ExecutionApiWorkerInterface, type ExecutionCommandScopeState, type ExecutionHookScopeState, type ExecutionInterface, type ExecutionPluginScopeState, type ExecutionScopeState, type ExecutionScopeType, type ExecutionState, type ExtractRpcFunction, type ExtractRpcFunctions, type InputRpcFunction, type InputRpcFunctions, type LogPayload, PowerlinesEngine, PowerlinesEngineContext, type RpcClient, type RpcClientCall, type RpcClientCallEvent, type RpcClientCallOptional, type RpcClientEvents, type RpcClientFunctions, type RpcClientHost, type RpcClientOptions, type RpcClientRemoteFunctions, type RpcContext, type RpcFunction, type RpcFunctions, type RpcPayloadEnvelop, type RpcPayloadMetadata, type RpcServerFunctions, type WrapRpcFunction, type WrapRpcFunctions, type WrappedRpcFunction, type WrappedRpcFunctions, createContext, createEngine };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { C as RpcServerFunctions, D as WrappedRpcFunctions, E as WrappedRpcFunction, S as RpcPayloadMetadata, T as WrapRpcFunctions, _ as RpcClientRemoteFunctions, a as ExtractRpcFunction, b as RpcFunctions, c as InputRpcFunctions, d as RpcClientCall, f as RpcClientCallEvent, g as RpcClientHost, h as RpcClientFunctions, i as RpcClientOptions, l as LogPayload, m as RpcClientEvents, n as EngineOptions, o as ExtractRpcFunctions, p as RpcClientCallOptional, r as EngineResolvedConfig, s as InputRpcFunction, t as EngineExecutionOptions, u as RpcClient, v as RpcContext, w as WrapRpcFunction, x as RpcPayloadEnvelop, y as RpcFunction } from "./config-ByLyzMI0.mjs";
 import { a as ExecutionHookScopeState, c as ExecutionScopeType, i as ExecutionCommandScopeState, l as ExecutionState, n as EngineExecutionItem, o as ExecutionPluginScopeState, r as EngineSystemContext, s as ExecutionScopeState, t as EngineContext } from "./context-DcXV6_GL.mjs";
-import { a as PowerlinesExecutionHost, i as ExecutionInterface, n as ExecutionHost, o as Worker, r as ExecutionHostParams, t as Engine } from "./api-BgyEi2hF.mjs";
+import { i as ExecutionInterface, n as ExecutionApiParams, r as ExecutionApiWorkerInterface, t as Engine } from "./api-DRcC7Ry-.mjs";
 import { t as PowerlinesEngineContext } from "./engine-context-DKlA5Pgu.mjs";
-import { PowerlinesEngine, createContext, createEngine } from "./engine.mjs";
-export { type Engine, type EngineContext, type EngineExecutionItem, type EngineExecutionOptions, type EngineOptions, type EngineResolvedConfig, type EngineSystemContext, type ExecutionCommandScopeState, type ExecutionHookScopeState, type ExecutionHost, type ExecutionHostParams, type ExecutionInterface, type ExecutionPluginScopeState, type ExecutionScopeState, type ExecutionScopeType, type ExecutionState, type ExtractRpcFunction, type ExtractRpcFunctions, type InputRpcFunction, type InputRpcFunctions, type LogPayload, PowerlinesEngine, PowerlinesEngineContext, type PowerlinesExecutionHost, type RpcClient, type RpcClientCall, type RpcClientCallEvent, type RpcClientCallOptional, type RpcClientEvents, type RpcClientFunctions, type RpcClientHost, type RpcClientOptions, type RpcClientRemoteFunctions, type RpcContext, type RpcFunction, type RpcFunctions, type RpcPayloadEnvelop, type RpcPayloadMetadata, type RpcServerFunctions, type Worker, type WrapRpcFunction, type WrapRpcFunctions, type WrappedRpcFunction, type WrappedRpcFunctions, createContext, createEngine };
+import { n as createContext, r as createEngine, t as PowerlinesEngine } from "./engine-BLp7JcAB.mjs";
+export { type Engine, type EngineContext, type EngineExecutionItem, type EngineExecutionOptions, type EngineOptions, type EngineResolvedConfig, type EngineSystemContext, type ExecutionApiParams, type ExecutionApiWorkerInterface, type ExecutionCommandScopeState, type ExecutionHookScopeState, type ExecutionInterface, type ExecutionPluginScopeState, type ExecutionScopeState, type ExecutionScopeType, type ExecutionState, type ExtractRpcFunction, type ExtractRpcFunctions, type InputRpcFunction, type InputRpcFunctions, type LogPayload, PowerlinesEngine, PowerlinesEngineContext, type RpcClient, type RpcClientCall, type RpcClientCallEvent, type RpcClientCallOptional, type RpcClientEvents, type RpcClientFunctions, type RpcClientHost, type RpcClientOptions, type RpcClientRemoteFunctions, type RpcContext, type RpcFunction, type RpcFunctions, type RpcPayloadEnvelop, type RpcPayloadMetadata, type RpcServerFunctions, type WrapRpcFunction, type WrapRpcFunctions, type WrappedRpcFunction, type WrappedRpcFunctions, createContext, createEngine };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { n as createContext, r as createEngine, t as PowerlinesEngine } from "./engine-BWwXttY1.mjs";
+import { n as createContext, r as createEngine, t as PowerlinesEngine } from "./engine-CDFOkhKj.mjs";
 import { PowerlinesEngineContext } from "./context/engine-context.mjs";
 import "./context/index.mjs";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/engine",
-  "version": "0.49.13",
+  "version": "0.49.14",
   "private": false,
   "description": "An internal package containing the core engine modules for Powerlines.",
   "homepage": "https://stormsoftware.com",
@@ -93,9 +93,9 @@
       "import": "./dist/helpers/index.mjs",
       "require": "./dist/helpers/index.cjs"
     },
-    "./helpers/create-execution-host": {
-      "import": "./dist/helpers/create-execution-host.mjs",
-      "require": "./dist/helpers/create-execution-host.cjs"
+    "./helpers/create-api": {
+      "import": "./dist/helpers/create-api.mjs",
+      "require": "./dist/helpers/create-api.cjs"
     },
     "./helpers/finalize": {
       "import": "./dist/helpers/finalize.mjs",
@@ -116,22 +116,22 @@
   "types": "./dist/index.d.cts",
   "files": ["dist"],
   "dependencies": {
-    "@powerlines/core": "^0.48.12",
-    "@storm-software/config": "^1.137.61",
-    "@storm-software/config-tools": "^1.190.29",
-    "@stryke/async": "^0.1.5",
-    "@stryke/convert": "^0.7.7",
-    "@stryke/env": "^0.20.93",
-    "@stryke/fs": "^0.33.76",
-    "@stryke/hash": "^0.13.29",
-    "@stryke/helpers": "^0.10.16",
-    "@stryke/http": "^0.12.66",
-    "@stryke/json": "^0.15.0",
-    "@stryke/path": "^0.29.3",
-    "@stryke/string-format": "^0.17.18",
-    "@stryke/type-checks": "^0.6.9",
-    "@stryke/unique-id": "^0.3.87",
-    "@stryke/url": "^0.4.27",
+    "@powerlines/core": "^0.48.13",
+    "@storm-software/config": "^1.137.62",
+    "@storm-software/config-tools": "^1.190.30",
+    "@stryke/async": "^0.1.6",
+    "@stryke/convert": "^0.7.8",
+    "@stryke/env": "^0.20.94",
+    "@stryke/fs": "^0.33.77",
+    "@stryke/hash": "^0.13.30",
+    "@stryke/helpers": "^0.10.17",
+    "@stryke/http": "^0.12.67",
+    "@stryke/json": "^0.15.1",
+    "@stryke/path": "^0.29.4",
+    "@stryke/string-format": "^0.17.19",
+    "@stryke/type-checks": "^0.6.10",
+    "@stryke/unique-id": "^0.3.88",
+    "@stryke/url": "^0.4.28",
     "birpc": "^4.0.0",
     "defu": "^6.1.7",
     "devframe": "^0.1.22",
@@ -148,10 +148,10 @@
     "unplugin": "^3.0.0"
   },
   "devDependencies": {
-    "@storm-software/testing-tools": "^1.119.182",
-    "@stryke/types": "^0.12.4",
+    "@storm-software/testing-tools": "^1.119.183",
+    "@stryke/types": "^0.12.5",
     "@types/node": "^25.9.1",
     "typescript": "^6.0.3"
   },
-  "gitHead": "d1cb895dd09bf1aeda996e4dd924c9c756c85a6d"
+  "gitHead": "13e79048aad1c58b576aa5454b7ab3cb76783731"
 }