@powerlines/engine 0.49.30 → 0.49.31

package/dist/api/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../src/api/types.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 { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { handleTypes } from \"@powerlines/core/lib/generate-types\";\nimport { installDependencies } from \"@powerlines/core/lib/install-dependencies\";\nimport { writeMetaFile } from \"@powerlines/core/lib/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"@powerlines/core/lib/typescript/tsconfig\";\nimport { format } from \"@powerlines/core/lib/utilities/format\";\nimport { ExecutionContext } from \"@powerlines/core/types/context\";\nimport { formatLogMessage } from \"@storm-software/config-tools/logger\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate runtime types for the Powerlines project.\n *\n * @remarks\n * This function is responsible for generating TypeScript declaration files based on the project's configuration and environment. It executes hooks at various stages of the type generation process, allowing for customization and extension by plugins. The generated types are formatted and written to the appropriate location in the project's file system, ensuring that they are available for use by other parts of the Powerlines system and by end-users of the project.\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function types<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Type Generation\");\n  context.debug(\n    \" Aggregating configuration options for the Powerlines project\"\n  );\n\n  await executeEnvironments(context, async env => {\n    env.debug(\n      `Initializing the processing options for the Powerlines project.`\n    );\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    await initializeTsconfig<TResolvedConfig, TSystemContext>(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.entry.length > 0) {\n      const entriesLength = isObject(env.config.input)\n        ? Object.keys(env.config.input).length\n        : toArray(env.config.input).length;\n      env.debug(\n        `The configuration provided ${entriesLength} entry point${\n          entriesLength !== 1 ? \"s\" : \"\"\n        }, Powerlines has found ${env.entry.length} entry file${\n          env.entry.length !== 1 ? \"s\" : \"\"\n        } for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${replacePath(entry.file, context.config.root)}${\n                      entry.output\n                        ? ` -> ${replacePath(\n                            entry.output,\n                            context.config.root\n                          )}`\n                        : \"\"\n                    }`\n                )\n                .join(\" \\n\")}`\n            : \"\"\n        }`\n      );\n    } else {\n      env.warn(\n        `No entry files were found for the ${\n          env.config.title\n        } project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`\n      );\n    }\n\n    await resolveTsconfig<TResolvedConfig, TSystemContext>(env);\n    await installDependencies(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    context.trace(\n      `Powerlines configuration has been resolved: \\n\\n${formatLogMessage({\n        ...env.config,\n        userConfig: isSetObject(env.config.userConfig)\n          ? omit(env.config.userConfig, [\"plugins\"])\n          : undefined,\n        inlineConfig: isSetObject(env.config.inlineConfig)\n          ? env.config.inlineConfig\n          : undefined,\n        plugins: env.plugins.map(plugin => plugin.name)\n      })}`\n    );\n\n    if (!env.fs.existsSync(env.cachePath)) {\n      await createDirectory(env.cachePath);\n    }\n\n    if (!env.fs.existsSync(env.dataPath)) {\n      await createDirectory(env.dataPath);\n    }\n\n    if (\n      env.config.skipCache === true ||\n      env.persistedMeta?.checksum !== env.meta.checksum\n    ) {\n      env.debug(\n        `Using previously prepared files as the meta checksum has not changed.`\n      );\n    } else {\n      env.info(\n        `Running \\`prepare\\` command as the meta checksum has changed since the last run.`\n      );\n\n      await prepare(context, true);\n    }\n\n    await handleTypes(context, env);\n\n    context.debug(\"Formatting files generated during the types step.\");\n\n    await format(env, env.typesPath, (await env.fs.read(env.typesPath)) ?? \"\");\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,eAAsB,MAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,iBAAiB;CAC7C,QAAQ,MACN,+DACF;CAEA,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,IAAI,MACF,iEACF;EAEA,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,MAAM,mBAAoD,GAAG;EAE7D,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,IAAI,IAAI,MAAM,SAAS,GAAG;GACxB,MAAM,gBAAgB,SAAS,IAAI,OAAO,KAAK,IAC3C,OAAO,KAAK,IAAI,OAAO,KAAK,EAAE,SAC9B,QAAQ,IAAI,OAAO,KAAK,EAAE;GAC9B,IAAI,MACF,8BAA8B,cAAc,cAC1C,kBAAkB,IAAI,MAAM,GAC7B,yBAAyB,IAAI,MAAM,OAAO,aACzC,IAAI,MAAM,WAAW,IAAI,MAAM,GAChC,WAAW,IAAI,OAAO,MAAM,UAC3B,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,KACvC,OAAO,IAAI,MACR,KACC,UACE,KAAK,YAAY,MAAM,MAAM,QAAQ,OAAO,IAAI,IAC9C,MAAM,SACF,OAAO,YACL,MAAM,QACN,QAAQ,OAAO,IACjB,MACA,IAEV,EACC,KAAK,KAAK,MACb,IAER;EACF,OACE,IAAI,KACF,qCACE,IAAI,OAAO,MACZ,6HACH;EAGF,MAAM,gBAAiD,GAAG;EAC1D,MAAM,oBAAoB,GAAG;EAE7B,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,QAAQ,MACN,mDAAmD,iBAAiB;GAClE,GAAG,IAAI;GACP,YAAY,YAAY,IAAI,OAAO,UAAU,IACzC,KAAK,IAAI,OAAO,YAAY,CAAC,SAAS,CAAC,IACvC;GACJ,cAAc,YAAY,IAAI,OAAO,YAAY,IAC7C,IAAI,OAAO,eACX;GACJ,SAAS,IAAI,QAAQ,KAAI,WAAU,OAAO,IAAI;EAChD,CAAC,GACH;EAEA,IAAI,CAAC,IAAI,GAAG,WAAW,IAAI,SAAS,GAClC,MAAM,gBAAgB,IAAI,SAAS;EAGrC,IAAI,CAAC,IAAI,GAAG,WAAW,IAAI,QAAQ,GACjC,MAAM,gBAAgB,IAAI,QAAQ;EAGpC,IACE,IAAI,OAAO,cAAc,QACzB,IAAI,eAAe,aAAa,IAAI,KAAK,UAEzC,IAAI,MACF,uEACF;OACK;GACL,IAAI,KACF,kFACF;GAEA,MAAM,QAAQ,SAAS,IAAI;EAC7B;EAEA,MAAM,YAAY,SAAS,GAAG;EAE9B,QAAQ,MAAM,mDAAmD;EAEjE,MAAM,OAAO,KAAK,IAAI,WAAY,MAAM,IAAI,GAAG,KAAK,IAAI,SAAS,KAAM,EAAE;EAEzE,MAAM,cAAc,GAAG;EACvB,IAAI,gBAAgB,IAAI;CAC1B,CAAC;CAED,MAAM;AACR"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/api/types.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 { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { handleTypes } from \"@powerlines/core/lib/generate-types\";\nimport { installDependencies } from \"@powerlines/core/lib/install-dependencies\";\nimport { writeMetaFile } from \"@powerlines/core/lib/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"@powerlines/core/lib/typescript/tsconfig\";\nimport { format } from \"@powerlines/core/lib/utilities/format\";\nimport { ExecutionContext } from \"@powerlines/core/types/context\";\nimport { formatLogMessage } from \"@storm-software/config-tools/logger\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate runtime types for the Powerlines project.\n *\n * @remarks\n * This function is responsible for generating TypeScript declaration files based on the project's configuration and environment. It executes hooks at various stages of the type generation process, allowing for customization and extension by plugins. The generated types are formatted and written to the appropriate location in the project's file system, ensuring that they are available for use by other parts of the Powerlines system and by end-users of the project.\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function types<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Type Generation\");\n  context.debug(\n    \" Aggregating configuration options for the Powerlines project\"\n  );\n\n  await executeEnvironments(context, async env => {\n    env.debug(\n      `Initializing the processing options for the Powerlines project.`\n    );\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    await initializeTsconfig<TResolvedConfig, TSystemContext>(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.entry.length > 0) {\n      const entriesLength = isObject(env.config.input)\n        ? Object.keys(env.config.input).length\n        : toArray(env.config.input).length;\n      env.debug(\n        `The configuration provided ${entriesLength} entry point${\n          entriesLength !== 1 ? \"s\" : \"\"\n        }, Powerlines has found ${env.entry.length} entry file${\n          env.entry.length !== 1 ? \"s\" : \"\"\n        } for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${replacePath(entry.file, context.config.root)}${\n                      entry.output\n                        ? ` -> ${replacePath(\n                            entry.output,\n                            context.config.root\n                          )}`\n                        : \"\"\n                    }`\n                )\n                .join(\" \\n\")}`\n            : \"\"\n        }`\n      );\n    } else {\n      env.warn(\n        `No entry files were found for the ${\n          env.config.title\n        } project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`\n      );\n    }\n\n    await resolveTsconfig<TResolvedConfig, TSystemContext>(env);\n    await installDependencies(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    context.trace(\n      `Powerlines configuration has been resolved: \\n\\n${formatLogMessage({\n        ...env.config,\n        userConfig: isSetObject(env.config.userConfig)\n          ? omit(env.config.userConfig, [\"plugins\"])\n          : undefined,\n        inlineConfig: isSetObject(env.config.inlineConfig)\n          ? env.config.inlineConfig\n          : undefined,\n        plugins: env.plugins.map(plugin => plugin.name)\n      })}`\n    );\n\n    if (!env.fs.existsSync(env.cachePath)) {\n      await createDirectory(env.cachePath);\n    }\n\n    if (!env.fs.existsSync(env.dataPath)) {\n      await createDirectory(env.dataPath);\n    }\n\n    if (\n      env.config.skipCache === true ||\n      env.persistedMeta?.checksum !== env.meta.checksum\n    ) {\n      env.debug(\n        `Using previously prepared files as the meta checksum has not changed.`\n      );\n    } else {\n      env.info(\n        `Running \\`prepare\\` command as the meta checksum has changed since the last run.`\n      );\n\n      await prepare(context, true);\n    }\n\n    await handleTypes(context, env);\n\n    context.debug(\"Formatting files generated during the types step.\");\n\n    await format(env, env.typesPath, (await env.fs.read(env.typesPath)) ?? \"\");\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA+CA,eAAsB,MAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,iBAAiB;CAC7C,QAAQ,MACN,+DACF;CAEA,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,IAAI,MACF,iEACF;EAEA,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,MAAM,mBAAoD,GAAG;EAE7D,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,IAAI,IAAI,MAAM,SAAS,GAAG;GACxB,MAAM,gBAAgB,SAAS,IAAI,OAAO,KAAK,IAC3C,OAAO,KAAK,IAAI,OAAO,KAAK,EAAE,SAC9B,QAAQ,IAAI,OAAO,KAAK,EAAE;GAC9B,IAAI,MACF,8BAA8B,cAAc,cAC1C,kBAAkB,IAAI,MAAM,GAC7B,yBAAyB,IAAI,MAAM,OAAO,aACzC,IAAI,MAAM,WAAW,IAAI,MAAM,GAChC,WAAW,IAAI,OAAO,MAAM,UAC3B,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,KACvC,OAAO,IAAI,MACR,KACC,UACE,KAAK,YAAY,MAAM,MAAM,QAAQ,OAAO,IAAI,IAC9C,MAAM,SACF,OAAO,YACL,MAAM,QACN,QAAQ,OAAO,IACjB,MACA,IAEV,EACC,KAAK,KAAK,MACb,IAER;EACF,OACE,IAAI,KACF,qCACE,IAAI,OAAO,MACZ,6HACH;EAGF,MAAM,gBAAiD,GAAG;EAC1D,MAAM,oBAAoB,GAAG;EAE7B,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,QAAQ,MACN,mDAAmD,iBAAiB;GAClE,GAAG,IAAI;GACP,YAAY,YAAY,IAAI,OAAO,UAAU,IACzC,KAAK,IAAI,OAAO,YAAY,CAAC,SAAS,CAAC,IACvC;GACJ,cAAc,YAAY,IAAI,OAAO,YAAY,IAC7C,IAAI,OAAO,eACX;GACJ,SAAS,IAAI,QAAQ,KAAI,WAAU,OAAO,IAAI;EAChD,CAAC,GACH;EAEA,IAAI,CAAC,IAAI,GAAG,WAAW,IAAI,SAAS,GAClC,MAAM,gBAAgB,IAAI,SAAS;EAGrC,IAAI,CAAC,IAAI,GAAG,WAAW,IAAI,QAAQ,GACjC,MAAM,gBAAgB,IAAI,QAAQ;EAGpC,IACE,IAAI,OAAO,cAAc,QACzB,IAAI,eAAe,aAAa,IAAI,KAAK,UAEzC,IAAI,MACF,uEACF;OACK;GACL,IAAI,KACF,kFACF;GAEA,MAAM,QAAQ,SAAS,IAAI;EAC7B;EAEA,MAAM,YAAY,SAAS,GAAG;EAE9B,QAAQ,MAAM,mDAAmD;EAEjE,MAAM,OAAO,KAAK,IAAI,WAAY,MAAM,IAAI,GAAG,KAAK,IAAI,SAAS,KAAM,EAAE;EAEzE,MAAM,cAAc,GAAG;EACvB,IAAI,gBAAgB,IAAI;CAC1B,CAAC;CAED,MAAM;AACR"}

package/dist/api.cjs

@@ -1,5 +1,3 @@
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
-const require_chunk = require('./chunk-CEeaYzDW.cjs');
 const require_api_prepare = require('./api/prepare.cjs');
 const require_api_build = require('./api/build.cjs');
 const require_api_clean = require('./api/clean.cjs');
@@ -12,7 +10,6 @@ const require_api_types = require('./api/types.cjs');
 const require_helpers_create_api = require('./helpers/create-api.cjs');
 
 //#region src/api.ts
-var api_exports = /* @__PURE__ */ require_chunk.__exportAll({ default: () => api_default });
 var api_default = require_helpers_create_api.createApi({
 	types: require_api_types.types,
 	prepare: require_api_prepare.prepare,
@@ -26,10 +23,4 @@ var api_default = require_helpers_create_api.createApi({
 });
 
 //#endregion
-Object.defineProperty(exports, 'api_exports', {
-  enumerable: true,
-  get: function () {
-    return api_exports;
-  }
-});
-exports.default = api_default;
+module.exports = api_default;

package/dist/api.mjs

@@ -1,4 +1,3 @@
-import { t as __exportAll } from "./chunk-w6R9maHv.mjs";
 import { prepare } from "./api/prepare.mjs";
 import { build } from "./api/build.mjs";
 import { clean } from "./api/clean.mjs";
@@ -11,7 +10,6 @@ import { types } from "./api/types.mjs";
 import { createApi } from "./helpers/create-api.mjs";
 
 //#region src/api.ts
-var api_exports = /* @__PURE__ */ __exportAll({ default: () => api_default });
 var api_default = createApi({
 	types,
 	prepare,
@@ -25,5 +23,5 @@ var api_default = createApi({
 });
 
 //#endregion
-export { api_default as default, api_exports as t };
+export { api_default as default };
 //# sourceMappingURL=api.mjs.map

package/dist/api.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"api.mjs","names":[],"sources":["../src/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 { ExecutionContext, ExecutionOptions } from \"@powerlines/core\";\nimport { build } from \"./api/build\";\nimport { clean } from \"./api/clean\";\nimport { create } from \"./api/create\";\nimport { deploy } from \"./api/deploy\";\nimport { docs } from \"./api/docs\";\nimport { lint } from \"./api/lint\";\nimport { prepare } from \"./api/prepare\";\nimport { test } from \"./api/test\";\nimport { types } from \"./api/types\";\nimport { createApi } from \"./helpers/create-api\";\nimport { EngineResolvedConfig, EngineSystemContext } from \"./types\";\n\nexport default createApi<\n  ExecutionContext<EngineResolvedConfig, EngineSystemContext>,\n  ExecutionOptions\n>({\n  types,\n  prepare,\n  create,\n  clean,\n  lint,\n  test,\n  build,\n  docs,\n  deploy\n});\n"],"mappings":";;;;;;;;;;;;;;AA+BA,kBAAe,UAGb;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC"}
+{"version":3,"file":"api.mjs","names":[],"sources":["../src/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 { ExecutionContext, ExecutionOptions } from \"@powerlines/core\";\nimport { build } from \"./api/build\";\nimport { clean } from \"./api/clean\";\nimport { create } from \"./api/create\";\nimport { deploy } from \"./api/deploy\";\nimport { docs } from \"./api/docs\";\nimport { lint } from \"./api/lint\";\nimport { prepare } from \"./api/prepare\";\nimport { test } from \"./api/test\";\nimport { types } from \"./api/types\";\nimport { createApi } from \"./helpers/create-api\";\nimport { EngineResolvedConfig, EngineSystemContext } from \"./types\";\n\nexport default createApi<\n  ExecutionContext<EngineResolvedConfig, EngineSystemContext>,\n  ExecutionOptions\n>({\n  types,\n  prepare,\n  create,\n  clean,\n  lint,\n  test,\n  build,\n  docs,\n  deploy\n});\n"],"mappings":";;;;;;;;;;;;AA+BA,kBAAe,UAGb;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC"}

package/dist/{chunk-CEeaYzDW.cjs → chunk-C_NdSu1c.cjs}

@@ -5,19 +5,6 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) {
-		__defProp(target, name, {
-			get: all[name],
-			enumerable: true
-		});
-	}
-	if (!no_symbols) {
-		__defProp(target, Symbol.toStringTag, { value: "Module" });
-	}
-	return target;
-};
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") {
 		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
@@ -39,12 +26,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 //#endregion
 
-Object.defineProperty(exports, '__exportAll', {
-  enumerable: true,
-  get: function () {
-    return __exportAll;
-  }
-});
 Object.defineProperty(exports, '__toESM', {
   enumerable: true,
   get: function () {

package/dist/context/engine-context.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../chunk-CEeaYzDW.cjs');
+const require_chunk = require('../chunk-C_NdSu1c.cjs');
 let _powerlines_core_plugin_utils = require("@powerlines/core/plugin-utils");
 let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_unique_id_uuid = require("@stryke/unique-id/uuid");
@@ -12,7 +12,6 @@ let valibot = require("valibot");
 valibot = require_chunk.__toESM(valibot, 1);
 
 //#region src/context/engine-context.ts
-var engine_context_exports = /* @__PURE__ */ require_chunk.__exportAll({ PowerlinesEngineContext: () => PowerlinesEngineContext });
 var PowerlinesEngineContext = class PowerlinesEngineContext extends _powerlines_core_context_base_context.PowerlinesBaseContext {
 	options;
 	connection;
@@ -175,10 +174,4 @@ var PowerlinesEngineContext = class PowerlinesEngineContext extends _powerlines_
 };
 
 //#endregion
-exports.PowerlinesEngineContext = PowerlinesEngineContext;
-Object.defineProperty(exports, 'engine_context_exports', {
-  enumerable: true,
-  get: function () {
-    return engine_context_exports;
-  }
-});
+exports.PowerlinesEngineContext = PowerlinesEngineContext;

package/dist/context/engine-context.mjs

@@ -1,4 +1,3 @@
-import { t as __exportAll } from "../chunk-w6R9maHv.mjs";
 import { createLogger, formatConfig, formatExecutionId, resolveLogLevel, withCustomLogger } from "@powerlines/core/plugin-utils";
 import { toArray } from "@stryke/convert/to-array";
 import { uuid } from "@stryke/unique-id/uuid";
@@ -10,7 +9,6 @@ import { kebabCase } from "@stryke/string-format/kebab-case";
 import * as v from "valibot";
 
 //#region src/context/engine-context.ts
-var engine_context_exports = /* @__PURE__ */ __exportAll({ PowerlinesEngineContext: () => PowerlinesEngineContext });
 var PowerlinesEngineContext = class PowerlinesEngineContext extends PowerlinesBaseContext {
 	options;
 	connection;
@@ -173,5 +171,5 @@ var PowerlinesEngineContext = class PowerlinesEngineContext extends PowerlinesBa
 };
 
 //#endregion
-export { PowerlinesEngineContext, engine_context_exports as t };
+export { PowerlinesEngineContext };
 //# sourceMappingURL=engine-context.mjs.map

package/dist/context/engine-context.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"engine-context.mjs","names":["#devtools","#logLevel","#executions"],"sources":["../../src/context/engine-context.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  FrameworkOptions,\n  InlineConfig,\n  LogFn,\n  LoggerOptions,\n  LogLevelResolvedConfig\n} from \"@powerlines/core\";\nimport { PowerlinesBaseContext } from \"@powerlines/core/context/base-context\";\nimport {\n  getDefaultLogLevel,\n  loadParsedConfig,\n  resolveRoot\n} from \"@powerlines/core/lib/config\";\nimport {\n  createLogger,\n  formatConfig,\n  formatExecutionId,\n  resolveLogLevel,\n  withCustomLogger\n} from \"@powerlines/core/plugin-utils\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { EnvPaths, getEnvPaths } from \"@stryke/env/get-env-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { uuid } from \"@stryke/unique-id/uuid\";\nimport { createHostContext } from \"devframe/node\";\nimport {\n  ConnectionMeta,\n  DevToolsHost,\n  DevToolsNodeContext\n} from \"devframe/types\";\nimport * as v from \"valibot\";\nimport { EngineOptions } from \"../types/config\";\nimport { EngineContext, EngineExecutionItem } from \"../types/context\";\n\nexport class PowerlinesEngineContext<TSystemContext = unknown>\n  extends PowerlinesBaseContext<TSystemContext>\n  implements EngineContext<TSystemContext>\n{\n  #executions: EngineExecutionItem[] = [];\n\n  #devtools!: DevToolsNodeContext;\n\n  #logLevel!: LogLevelResolvedConfig;\n\n  /**\n   * Creates a new instance of the PowerlinesEngineContext class.\n   *\n   * @param options - The options to initialize the context with.\n   * @returns A promise that resolves to an instance of the PowerlinesEngineContext class.\n   */\n  public static async from<TSystemContext = unknown>(\n    options: EngineOptions,\n    host: DevToolsHost,\n    connection: ConnectionMeta\n  ): Promise<PowerlinesEngineContext<TSystemContext>> {\n    const context = new PowerlinesEngineContext<TSystemContext>(\n      options,\n      connection\n    );\n\n    context.#devtools = await createHostContext({\n      cwd: context.cwd,\n      mode: \"dev\",\n      host\n    });\n    await options.setup?.(context.#devtools);\n\n    context.#devtools.rpc.register({\n      name: \"powerlines:log\",\n      type: \"event\",\n      args: [\n        v.object({\n          meta: v.object({\n            category: v.string(),\n            name: v.string(),\n            command: v.string(),\n            hook: v.string(),\n            plugin: v.string(),\n            source: v.string()\n          }),\n          message: v.string()\n        })\n      ],\n      setup: _ => ({\n        handler: payload => {\n          switch (payload.meta.type) {\n            case \"error\":\n              context.error(payload);\n              break;\n            case \"warn\":\n              context.warn(payload);\n              break;\n            case \"info\":\n              context.info(payload);\n              break;\n            case \"debug\":\n              context.debug(payload);\n              break;\n            case \"trace\":\n              context.trace(payload);\n              break;\n            default:\n              context.info(payload);\n              break;\n          }\n        }\n      })\n    });\n\n    context.#logLevel = options.logLevel\n      ? resolveLogLevel(options.logLevel)\n      : await getDefaultLogLevel(context.cwd);\n\n    return context;\n  }\n\n  public override createLogger(options: LoggerOptions = {}, logFn?: LogFn) {\n    let logger = createLogger(\n      \"engine\",\n      {\n        logLevel: this.#logLevel,\n        ...options\n      },\n      logFn\n    );\n    if (this.options.customLogger) {\n      logger = withCustomLogger(logger, this.options.customLogger);\n    }\n    return logger;\n  }\n\n  public get executions(): EngineExecutionItem[] {\n    return this.#executions;\n  }\n\n  public get devtools(): DevToolsNodeContext {\n    return this.#devtools;\n  }\n\n  public get envPaths(): EnvPaths {\n    return getEnvPaths({\n      orgId: kebabCase(this.orgId),\n      appId: kebabCase(this.framework.name),\n      workspaceRoot: this.cwd\n    });\n  }\n\n  public get framework(): FrameworkOptions {\n    return {\n      name: \"powerlines\",\n      orgId: \"storm-software\",\n      ...this.options.framework\n    };\n  }\n\n  public get orgId(): string {\n    return this.framework.orgId;\n  }\n\n  /**\n   * Creates a new Context instance.\n   *\n   * @param options - The options to use for creating the context, including the resolved configuration and workspace settings.\n   * @param connection - The connection metadata for the dev server.\n   */\n  protected constructor(\n    public override options: EngineOptions,\n    public connection: ConnectionMeta\n  ) {\n    super(options);\n  }\n\n  /**\n   * Initialize the context with the provided configuration options\n   *\n   * @remarks\n   * This method will set up the resolver and load the user configuration file based on the provided options. It is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup.\n   *\n   * @param command - 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   */\n  public async loadExecutions(\n    command: string,\n    inlineConfig: InlineConfig\n  ): Promise<EngineExecutionItem[]> {\n    const root = resolveRoot(\n      this.cwd,\n      inlineConfig.root,\n      inlineConfig.configFile\n    );\n\n    const config = await loadParsedConfig(\n      this.cwd,\n      root,\n      this.framework?.name,\n      this.orgId,\n      inlineConfig\n    );\n    if (!config) {\n      throw new Error(\"Failed to load configuration\");\n    }\n\n    const invocationId = uuid();\n    const executions = await Promise.all(\n      toArray(config.config).map(async (_, configIndex) => {\n        const executionId = formatExecutionId(\n          config.config.name || inlineConfig.name || root,\n          command,\n          configIndex\n        );\n\n        const options = {\n          cwd: this.cwd,\n          root,\n          framework: this.framework,\n          orgId: this.orgId,\n          ...this.options,\n          command,\n          baseURL: this.#devtools.host.resolveOrigin(),\n          connection: this.connection,\n          configFile: config.configFile!,\n          executionId,\n          configIndex\n        };\n\n        this.logger.debug({\n          meta: { category: \"config\" },\n          message: `Invoking ${command} with the following execution parameters: \\n --- Options --- \\n${formatConfig(\n            options\n          )}\\n --- Inline Config --- \\n${formatConfig(inlineConfig)}`\n        });\n\n        return {\n          invocationId,\n          command,\n          configFile: config,\n          options,\n          state: {\n            command: null,\n            hook: null,\n            plugin: null\n          }\n        };\n      })\n    );\n\n    this.#executions = this.#executions.concat(executions);\n\n    return executions;\n  }\n\n  /**\n   * Complete an execution by removing it from the list of active executions based on the provided invocation ID and execution ID. This method is typically called when an execution has finished or has been terminated, allowing the context to clean up any resources associated with that execution and update its internal state accordingly.\n   *\n   * @param invocationId - The unique identifier for the invocation of the execution to be completed.\n   * @param executionId - The unique identifier for the specific execution to be completed.\n   */\n  public completeExecution(invocationId: string, executionId: string) {\n    this.#executions = this.#executions.filter(\n      execution =>\n        execution.options.executionId !== executionId ||\n        execution.invocationId !== invocationId\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"engine-context.mjs","names":["#devtools","#logLevel","#executions"],"sources":["../../src/context/engine-context.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  FrameworkOptions,\n  InlineConfig,\n  LogFn,\n  LoggerOptions,\n  LogLevelResolvedConfig\n} from \"@powerlines/core\";\nimport { PowerlinesBaseContext } from \"@powerlines/core/context/base-context\";\nimport {\n  getDefaultLogLevel,\n  loadParsedConfig,\n  resolveRoot\n} from \"@powerlines/core/lib/config\";\nimport {\n  createLogger,\n  formatConfig,\n  formatExecutionId,\n  resolveLogLevel,\n  withCustomLogger\n} from \"@powerlines/core/plugin-utils\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { EnvPaths, getEnvPaths } from \"@stryke/env/get-env-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { uuid } from \"@stryke/unique-id/uuid\";\nimport { createHostContext } from \"devframe/node\";\nimport {\n  ConnectionMeta,\n  DevToolsHost,\n  DevToolsNodeContext\n} from \"devframe/types\";\nimport * as v from \"valibot\";\nimport { EngineOptions } from \"../types/config\";\nimport { EngineContext, EngineExecutionItem } from \"../types/context\";\n\nexport class PowerlinesEngineContext<TSystemContext = unknown>\n  extends PowerlinesBaseContext<TSystemContext>\n  implements EngineContext<TSystemContext>\n{\n  #executions: EngineExecutionItem[] = [];\n\n  #devtools!: DevToolsNodeContext;\n\n  #logLevel!: LogLevelResolvedConfig;\n\n  /**\n   * Creates a new instance of the PowerlinesEngineContext class.\n   *\n   * @param options - The options to initialize the context with.\n   * @returns A promise that resolves to an instance of the PowerlinesEngineContext class.\n   */\n  public static async from<TSystemContext = unknown>(\n    options: EngineOptions,\n    host: DevToolsHost,\n    connection: ConnectionMeta\n  ): Promise<PowerlinesEngineContext<TSystemContext>> {\n    const context = new PowerlinesEngineContext<TSystemContext>(\n      options,\n      connection\n    );\n\n    context.#devtools = await createHostContext({\n      cwd: context.cwd,\n      mode: \"dev\",\n      host\n    });\n    await options.setup?.(context.#devtools);\n\n    context.#devtools.rpc.register({\n      name: \"powerlines:log\",\n      type: \"event\",\n      args: [\n        v.object({\n          meta: v.object({\n            category: v.string(),\n            name: v.string(),\n            command: v.string(),\n            hook: v.string(),\n            plugin: v.string(),\n            source: v.string()\n          }),\n          message: v.string()\n        })\n      ],\n      setup: _ => ({\n        handler: payload => {\n          switch (payload.meta.type) {\n            case \"error\":\n              context.error(payload);\n              break;\n            case \"warn\":\n              context.warn(payload);\n              break;\n            case \"info\":\n              context.info(payload);\n              break;\n            case \"debug\":\n              context.debug(payload);\n              break;\n            case \"trace\":\n              context.trace(payload);\n              break;\n            default:\n              context.info(payload);\n              break;\n          }\n        }\n      })\n    });\n\n    context.#logLevel = options.logLevel\n      ? resolveLogLevel(options.logLevel)\n      : await getDefaultLogLevel(context.cwd);\n\n    return context;\n  }\n\n  public override createLogger(options: LoggerOptions = {}, logFn?: LogFn) {\n    let logger = createLogger(\n      \"engine\",\n      {\n        logLevel: this.#logLevel,\n        ...options\n      },\n      logFn\n    );\n    if (this.options.customLogger) {\n      logger = withCustomLogger(logger, this.options.customLogger);\n    }\n    return logger;\n  }\n\n  public get executions(): EngineExecutionItem[] {\n    return this.#executions;\n  }\n\n  public get devtools(): DevToolsNodeContext {\n    return this.#devtools;\n  }\n\n  public get envPaths(): EnvPaths {\n    return getEnvPaths({\n      orgId: kebabCase(this.orgId),\n      appId: kebabCase(this.framework.name),\n      workspaceRoot: this.cwd\n    });\n  }\n\n  public get framework(): FrameworkOptions {\n    return {\n      name: \"powerlines\",\n      orgId: \"storm-software\",\n      ...this.options.framework\n    };\n  }\n\n  public get orgId(): string {\n    return this.framework.orgId;\n  }\n\n  /**\n   * Creates a new Context instance.\n   *\n   * @param options - The options to use for creating the context, including the resolved configuration and workspace settings.\n   * @param connection - The connection metadata for the dev server.\n   */\n  protected constructor(\n    public override options: EngineOptions,\n    public connection: ConnectionMeta\n  ) {\n    super(options);\n  }\n\n  /**\n   * Initialize the context with the provided configuration options\n   *\n   * @remarks\n   * This method will set up the resolver and load the user configuration file based on the provided options. It is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup.\n   *\n   * @param command - 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   */\n  public async loadExecutions(\n    command: string,\n    inlineConfig: InlineConfig\n  ): Promise<EngineExecutionItem[]> {\n    const root = resolveRoot(\n      this.cwd,\n      inlineConfig.root,\n      inlineConfig.configFile\n    );\n\n    const config = await loadParsedConfig(\n      this.cwd,\n      root,\n      this.framework?.name,\n      this.orgId,\n      inlineConfig\n    );\n    if (!config) {\n      throw new Error(\"Failed to load configuration\");\n    }\n\n    const invocationId = uuid();\n    const executions = await Promise.all(\n      toArray(config.config).map(async (_, configIndex) => {\n        const executionId = formatExecutionId(\n          config.config.name || inlineConfig.name || root,\n          command,\n          configIndex\n        );\n\n        const options = {\n          cwd: this.cwd,\n          root,\n          framework: this.framework,\n          orgId: this.orgId,\n          ...this.options,\n          command,\n          baseURL: this.#devtools.host.resolveOrigin(),\n          connection: this.connection,\n          configFile: config.configFile!,\n          executionId,\n          configIndex\n        };\n\n        this.logger.debug({\n          meta: { category: \"config\" },\n          message: `Invoking ${command} with the following execution parameters: \\n --- Options --- \\n${formatConfig(\n            options\n          )}\\n --- Inline Config --- \\n${formatConfig(inlineConfig)}`\n        });\n\n        return {\n          invocationId,\n          command,\n          configFile: config,\n          options,\n          state: {\n            command: null,\n            hook: null,\n            plugin: null\n          }\n        };\n      })\n    );\n\n    this.#executions = this.#executions.concat(executions);\n\n    return executions;\n  }\n\n  /**\n   * Complete an execution by removing it from the list of active executions based on the provided invocation ID and execution ID. This method is typically called when an execution has finished or has been terminated, allowing the context to clean up any resources associated with that execution and update its internal state accordingly.\n   *\n   * @param invocationId - The unique identifier for the invocation of the execution to be completed.\n   * @param executionId - The unique identifier for the specific execution to be completed.\n   */\n  public completeExecution(invocationId: string, executionId: string) {\n    this.#executions = this.#executions.filter(\n      execution =>\n        execution.options.executionId !== executionId ||\n        execution.invocationId !== invocationId\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/{engine-D_B_s_Ai.cjs → engine-BKEDCOCb.cjs}

@@ -1,4 +1,4 @@
-const require_chunk = require('./chunk-CEeaYzDW.cjs');
+const require_chunk = require('./chunk-C_NdSu1c.cjs');
 const require_helpers_stream = require('./helpers/stream.cjs');
 const require_context_engine_context = require('./context/engine-context.cjs');
 let _stryke_path_append = require("@stryke/path/append");
@@ -318,11 +318,6 @@ var ExecutionApiWorker = class ExecutionApiWorker {
 
 //#endregion
 //#region src/engine.ts
-var engine_exports = /* @__PURE__ */ require_chunk.__exportAll({
-	PowerlinesEngine: () => PowerlinesEngine,
-	createContext: () => createContext,
-	createEngine: () => createEngine
-});
 /**
 * The Powerlines process' orchestration and coordination API.
 *
@@ -588,10 +583,4 @@ Object.defineProperty(exports, 'createEngine', {
   get: function () {
     return createEngine;
   }
-});
-Object.defineProperty(exports, 'engine_exports', {
-  enumerable: true,
-  get: function () {
-    return engine_exports;
-  }
 });

package/dist/{engine-CQbIlCXR.mjs → engine-DRAFIm5M.mjs}

@@ -1,4 +1,3 @@
-import { t as __exportAll } from "./chunk-w6R9maHv.mjs";
 import { MessagePortDuplex } from "./helpers/stream.mjs";
 import { PowerlinesEngineContext } from "./context/engine-context.mjs";
 import { appendPath } from "@stryke/path/append";
@@ -316,11 +315,6 @@ var ExecutionApiWorker = class ExecutionApiWorker {
 
 //#endregion
 //#region src/engine.ts
-var engine_exports = /* @__PURE__ */ __exportAll({
-	PowerlinesEngine: () => PowerlinesEngine,
-	createContext: () => createContext,
-	createEngine: () => createEngine
-});
 /**
 * The Powerlines process' orchestration and coordination API.
 *
@@ -569,5 +563,5 @@ async function createEngine(options, apiPath = "@powerlines/engine/api") {
 }
 
 //#endregion
-export { engine_exports as i, createContext as n, createEngine as r, PowerlinesEngine as t };
-//# sourceMappingURL=engine-CQbIlCXR.mjs.map
+export { createContext as n, createEngine as r, PowerlinesEngine as t };
+//# sourceMappingURL=engine-DRAFIm5M.mjs.map

package/dist/{engine-CQbIlCXR.mjs.map → engine-DRAFIm5M.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"engine-CQbIlCXR.mjs","names":["#restartPromise","#resolveRestartPromise","#logger","#worker","#createWorker","#activeTasks","#hangingTimer","#context","#api"],"sources":["../src/_internal/execution-api-worker.ts","../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 { InlineConfig, Logger, Mode } from \"@powerlines/core\";\nimport { getDefaultMode } from \"@powerlines/core/lib/config\";\nimport { isDebug } from \"@stryke/env/environment-checks\";\nimport { resolve } from \"@stryke/fs/resolve\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { formatDuration } from \"date-fns/formatDuration\";\nimport { pipeline } from \"node:stream\";\nimport { parseArgs } from \"node:util\";\nimport {\n  MessageChannel,\n  StructuredSerializeOptions\n} from \"node:worker_threads\";\nimport Tinypool from \"tinypool\";\nimport { MessagePortDuplex } from \"../helpers/stream\";\nimport { ExecutionApiWorkerInterface } from \"../types\";\nimport { EngineExecutionOptions } from \"../types/config\";\nimport { EngineContext } from \"../types/context\";\n\nconst RESTARTED = Symbol(\"powerlines-worker:restarted\");\n\n/**\n * The debug address is in the form of `[host:]port`. The host is optional.\n */\ninterface DebugAddress {\n  host?: string;\n  port: number;\n}\n\n/**\n * Formats the debug address into a string.\n */\nconst formatDebugAddress = ({ host, port }: DebugAddress): string => {\n  return host ? `${host}:${port}` : `${port}`;\n};\n\nexport type NodeOptions = Record<string, string | boolean | undefined>;\n\n/**\n * Get's the debug address from the `NODE_OPTIONS` environment variable. If the\n * address is not found, it returns the default host (`undefined`) and port\n * (`9229`).\n *\n * @returns An object with the host and port of the debug address.\n */\nconst getParsedDebugAddress = (\n  address: string | boolean | undefined\n): DebugAddress => {\n  if (!address || !isString(address)) {\n    return { host: undefined, port: 9229 };\n  }\n\n  // The address is in the form of `[host:]port`. Let's parse the address.\n  if (address.includes(\":\")) {\n    const [host, port] = address.split(\":\");\n    if (!host || !port) {\n      throw new Error(`Invalid debug address: ${address}`);\n    }\n\n    return { host, port: Number.parseInt(port, 10) };\n  }\n\n  return { host: undefined, port: Number.parseInt(address, 10) };\n};\n\ntype NodeInspectType = \"inspect\" | \"inspect-brk\" | undefined;\n\n/**\n * Get the debug type from the `NODE_OPTIONS` environment variable.\n */\nfunction getNodeDebugType(nodeOptions: NodeOptions): NodeInspectType {\n  if (nodeOptions.inspect) {\n    return \"inspect\";\n  }\n  if (nodeOptions[\"inspect-brk\"] || nodeOptions.inspect_brk) {\n    return \"inspect-brk\";\n  }\n\n  return undefined;\n}\n\nexport interface ExecutionApiWorkerOptions {\n  // /**\n  //  * `-1` if not inspectable\n  //  */\n  // debuggerPortOffset?: number;\n\n  // /**\n  //  * Whether to enable source maps support in the worker, which can improve the quality of stack traces at the cost of increased memory usage and slower performance. Defaults to `false`.\n  //  */\n  // enableSourceMaps?: boolean;\n\n  /**\n   * The maximum time in milliseconds a worker can run before being terminated.\n   *\n   * @defaultValue 900000 (15 minutes)\n   */\n  timeout?: number;\n\n  /**\n   * True if `--max-old-space-size` should not be forwarded to the worker.\n   */\n  isolatedMemory?: boolean;\n\n  /**\n   * The mode to run the worker in, which can affect how the worker is initialized and how it behaves. This is determined based on the resolved configuration of the engine, and can be used to optimize the worker for different environments (e.g., development, production, etc.).\n   */\n  mode?: Mode;\n\n  /**\n   * An optional root to resolve the execution host path from, which can be used to specify a custom root directory for the worker to use when resolving paths and loading configuration files. If this option is not provided, the worker will use the current working directory as the root directory by default.\n   */\n  root?: string;\n\n  /**\n   * The context of the {@link @powerlines/engine#Engine | Engine instance}, which can be used to access the engine's state and services within the worker.\n   */\n  context: EngineContext;\n}\n\nexport class ExecutionApiWorker implements ExecutionApiWorkerInterface {\n  #worker: Tinypool | undefined;\n\n  #logger: Logger;\n\n  #activeTasks = 0;\n\n  #restartPromise: Promise<typeof RESTARTED> | null = null;\n\n  #resolveRestartPromise: ((arg: typeof RESTARTED) => void) | null = null;\n\n  #hangingTimer: NodeJS.Timeout | false = false;\n\n  #createWorker: () => void;\n\n  protected get restartPromise() {\n    if (!this.#restartPromise) {\n      this.#restartPromise = new Promise(resolve => {\n        this.#resolveRestartPromise = resolve;\n      });\n    }\n    return this.#restartPromise;\n  }\n\n  protected resolveRestartPromise() {\n    if (this.#resolveRestartPromise) {\n      this.#resolveRestartPromise(RESTARTED);\n      this.#restartPromise = null;\n      this.#resolveRestartPromise = null;\n    }\n  }\n\n  /**\n   * Creates a new instance of the Execution API Worker class, which manages a worker process for executing tasks related to the Powerlines Engine. The worker is initialized with the specified options and can be used to run tasks in an isolated environment, with support for automatic restarts and activity monitoring.\n   *\n   * @param apiPath - The path to the Execution API file.\n   * @param options - The options for configuring the worker, including the execution context, exposed methods, timeout, and mode.\n   * @returns A promise that resolves to an instance of the ExecutionApiWorker class.\n   */\n  public static async from(\n    apiPath: string,\n    options: ExecutionApiWorkerOptions\n  ) {\n    const mode = await getDefaultMode(options.context.cwd);\n\n    const resolvedPath = await resolve(apiPath, {\n      paths: [\n        options.context.cwd,\n        options.root ? appendPath(options.root, options.context.cwd) : undefined\n      ].filter(Boolean) as string[]\n    });\n    if (!resolvedPath) {\n      throw new Error(\n        `Could not resolve the provided Execution API path: \\`${apiPath}\\`.`\n      );\n    }\n\n    return new ExecutionApiWorker(resolvedPath, {\n      mode,\n      ...options\n    });\n  }\n\n  /**\n   * Create a new API worker instance.\n   *\n   * @param executionApiPath - The path to the worker file.\n   * @param options - The options for the worker, including exposed commands, timeout, and hooks for activity and restart.\n   */\n  protected constructor(\n    protected executionApiPath: string,\n    protected options: ExecutionApiWorkerOptions\n  ) {\n    const {\n      isolatedMemory = false,\n      mode = \"production\",\n      context\n    } = this.options;\n\n    this.options.timeout ??= 900_000;\n\n    this.#logger = context.extendLogger({ category: \"communication\" });\n    this.#worker = undefined;\n\n    // ensure we end workers if they weren't before exit\n    process.on(\"exit\", () => {\n      void this.finalize();\n    });\n\n    let nodeOptions = {} as {\n      [longOption: string]: string | boolean | undefined;\n    };\n\n    const args: string[] = [...process.execArgv];\n    if (process.env.NODE_OPTIONS) {\n      let isInString = false;\n      let willStartNewArg = true;\n\n      const stringifiedNodeOptions = process.env.NODE_OPTIONS.split(\" \").filter(\n        part =>\n          ((part.startsWith('\"') && part.endsWith('\"')) ||\n            (part.startsWith(\"'\") && part.endsWith(\"'\"))) &&\n          part\n            .replace(/^['\"]|['\"]$/g, \"\")\n            .split(\" \")\n            .filter(isSetString).length > 0 &&\n          part\n            .replace(/^['\"]|['\"]$/g, \"\")\n            .split(\" \")\n            .filter(isSetString)\n            .every(p => p.startsWith(\"--\"))\n      );\n      args.push(\n        ...stringifiedNodeOptions.map(part => part.replace(/^['\"]|['\"]$/g, \"\"))\n      );\n\n      const inputNodeModules = stringifiedNodeOptions.reduce((acc, part) => {\n        return acc.replace(part, \"\").trim();\n      }, process.env.NODE_OPTIONS);\n      for (let i = 0; i < inputNodeModules.length; i++) {\n        let char = inputNodeModules[i];\n        if (char) {\n          // Skip any escaped characters in strings.\n          if (char === \"\\\\\" && isInString) {\n            // Ensure we don't have an escape character at the end.\n            if (inputNodeModules.length === i + 1) {\n              throw new Error(\"Invalid escape character at the end.\");\n            }\n\n            // Skip the next character.\n            char = inputNodeModules[++i];\n            if (!char) {\n              continue;\n            }\n          }\n          // If we find a space outside of a string, we should start a new argument.\n          else if (char === \" \" && !isInString) {\n            willStartNewArg = true;\n            continue;\n          }\n\n          // If we find a quote, we should toggle the string flag.\n          else if (char === '\"') {\n            isInString = !isInString;\n            continue;\n          }\n\n          // If we're starting a new argument, we should add it to the array.\n          if (willStartNewArg) {\n            args.push(char);\n            willStartNewArg = false;\n          }\n          // Otherwise, add it to the last argument.\n          else {\n            args[args.length - 1] += char;\n          }\n        }\n      }\n\n      if (isInString) {\n        throw new Error(\"Unterminated string\");\n      }\n    }\n\n    if (args.length > 0) {\n      const { values, tokens } = parseArgs({\n        args,\n        strict: false,\n        tokens: true\n      });\n      nodeOptions = values;\n\n      // For the `NODE_OPTIONS`, we support arguments with values without the `=`\n      // sign. We need to parse them manually.\n      let orphan = null;\n      for (let i = 0; i < tokens.length; i++) {\n        const token = tokens[i];\n        if (!token) continue;\n\n        if (token.kind === \"option-terminator\") {\n          break;\n        }\n\n        // When we encounter an option, if it's value is undefined, we should check\n        // to see if the following tokens are positional parameters. If they are,\n        // then the option is orphaned, and we can assign it.\n        if (token.kind === \"option\") {\n          orphan = !isSet(token.value) ? token : null;\n          continue;\n        }\n\n        // If the token isn't a positional one, then we can't assign it to the found\n        // orphaned option.\n        if (token.kind !== \"positional\") {\n          orphan = null;\n          continue;\n        }\n\n        // If we don't have an orphan, then we can skip this token.\n        if (!orphan) {\n          continue;\n        }\n\n        // If the token is a positional one, and it has a value, so add it to the\n        // values object. If it already exists, append it with a space.\n        if (orphan.name in nodeOptions && isString(nodeOptions[orphan.name])) {\n          nodeOptions[orphan.name] += ` ${token.value}`;\n        } else {\n          nodeOptions[orphan.name] = token.value;\n        }\n      }\n    }\n\n    const originalOptions = { ...nodeOptions };\n\n    delete nodeOptions.inspect;\n    delete nodeOptions[\"inspect-brk\"];\n    delete nodeOptions.inspect_brk;\n\n    if (isDebug) {\n      const nodeDebugType = getNodeDebugType(originalOptions);\n      if (nodeDebugType) {\n        const debuggerAddress = getParsedDebugAddress(\n          originalOptions[nodeDebugType]\n        );\n        const address: DebugAddress = {\n          host: debuggerAddress.host,\n          // current process runs on `address.port`\n          port: debuggerAddress.port === 0 ? 0 : debuggerAddress.port + 1 + 1\n        };\n        nodeOptions[nodeDebugType] = formatDebugAddress(address);\n\n        this.#logger.info(\n          `Node.js debugger listening on ${nodeOptions[nodeDebugType]}`\n        );\n      }\n\n      nodeOptions[\"enable-source-maps\"] = true;\n    }\n\n    if (isolatedMemory) {\n      delete nodeOptions[\"max-old-space-size\"];\n      delete nodeOptions.max_old_space_size;\n    }\n\n    const execArgv: string[] = [];\n    const nodeOptionsParts: string[] = [];\n    for (const [key, value] of Object.entries(nodeOptions)) {\n      let formatted: string | null = null;\n      if (value === true) {\n        formatted = `--${key}`;\n      } else if (value) {\n        formatted = `--${key}=${\n          // Values with spaces need to be quoted. We use JSON.stringify to\n          // also escape any nested quotes.\n          value.includes(\" \") && !value.startsWith('\"')\n            ? JSON.stringify(value)\n            : value\n        }`;\n      }\n\n      if (formatted === null) {\n        continue;\n      }\n\n      if (\n        [\n          \"experimental-network-inspection\",\n          \"experimental-storage-inspection\",\n          \"experimental-worker-inspection\",\n          \"experimental-inspector-network-resource\"\n        ].includes(key)\n      ) {\n        execArgv.push(formatted);\n      } else {\n        nodeOptionsParts.push(formatted);\n      }\n    }\n\n    // // Issue: https://github.com/nodejs/node/issues/59706\n    // if (!nodeOptionsParts.includes(\"--no-experimental-strip-types\")) {\n    //   nodeOptionsParts.push(\"--no-experimental-strip-types\");\n    // }\n\n    this.#createWorker = () => {\n      const env: Record<string, string> = {\n        ...process.env,\n        NODE_ENV: mode,\n        NODE_OPTIONS: nodeOptionsParts.join(\" \"),\n        POWERLINES_EXECUTION_WORKER: \"true\"\n      };\n\n      // Mirror the enablement heuristic from picocolors (see https://github.com/vercel/next.js/blob/6a40da0345939fe4f7b1ae519b296a86dd103432/packages/next/src/lib/picocolors.ts#L21-L24).\n      // Picocolors snapshots `process.env`/`stdout.isTTY` at module load time, so when the worker\n      // process bootstraps with piped stdio its own check would disable colors. Re-evaluating the\n      // same conditions here lets us opt the worker into color output only when the parent would\n      // have seen colors, while still respecting explicit opt-outs like NO_COLOR.\n      if (\n        env.FORCE_COLOR === undefined &&\n        !env.NO_COLOR &&\n        !env.CI &&\n        env.TERM !== \"dumb\" &&\n        (process.stdout.isTTY || process.stderr?.isTTY)\n      ) {\n        env.FORCE_COLOR = \"1\";\n      }\n\n      this.#logger.debug(\n        `Creating worker from file ${\n          executionApiPath\n        } with execution arguments: ${JSON.stringify(execArgv, null, 2)}`\n      );\n\n      this.#worker = new Tinypool({\n        terminateTimeout: 5000,\n        filename: executionApiPath,\n        execArgv,\n        env\n      });\n\n      this.#restartPromise = new Promise(resolve => {\n        this.#resolveRestartPromise = resolve;\n      });\n\n      this.#worker.on(\"exit\", (code, signal) => {\n        this.#logger.debug(\n          `Worker process exited with code ${code} and signal ${signal}`\n        );\n\n        if ((code || (signal && signal !== \"SIGINT\")) && this.#worker) {\n          const error = new Error(\n            `Execution Host Worker exited unexpectedly with code ${\n              code\n            } and signal ${signal}`\n          );\n          this.#logger.error(error);\n\n          void this.finalize().then(() => {\n            throw error;\n          });\n        }\n      });\n\n      this.#worker.on(\"error\", error => {\n        this.#logger.error({\n          meta: { category: \"communication\" },\n          message: `Worker process emitted an error: ${error.message}`,\n          error\n        });\n      });\n\n      // if a child process emits a particular message, we track that as activity\n      // so the parent process can keep track of progress\n      this.#worker.on(\"message\", data => {\n        this.onActivity();\n\n        if (Array.isArray(data) && data.length > 1 && isNumber(data[0])) {\n          if (data[0] === 0) {\n            this.#logger.trace(\n              `Received message from worker: ${JSON.stringify(data.slice(1), null, 2)}`\n            );\n          } else {\n            this.#logger.debug(\n              `Received error message from worker: ${JSON.stringify(\n                data.slice(1),\n                null,\n                2\n              )}`\n            );\n          }\n        }\n\n        this.#logger.trace(\n          `Received message from worker: ${JSON.stringify(data, null, 2)}`\n        );\n      });\n    };\n\n    this.#createWorker();\n  }\n\n  public async execute(\n    command: string,\n    options: Omit<EngineExecutionOptions, \"channel\">,\n    inlineConfig: InlineConfig\n  ) {\n    if (this.options.timeout) {\n      this.#activeTasks++;\n      try {\n        let attempts = 0;\n        for (;;) {\n          this.onActivity();\n\n          const result = await Promise.race([\n            this.innerExecute(command, options, inlineConfig),\n            this.#restartPromise\n          ]);\n          if (result !== RESTARTED) {\n            return;\n          }\n\n          this.#logger.warn(\n            `Execution Host Worker was restarted while calling method \"${\n              command\n            }\" (attempt ${attempts++}). Retrying the call...`\n          );\n        }\n      } finally {\n        this.#activeTasks--;\n        this.onActivity();\n      }\n    } else {\n      await this.innerExecute(command, options, inlineConfig);\n    }\n  }\n\n  /**\n   * Closes the worker process, terminating it if it's still running. This method should be called when the worker is no longer needed, to free up system resources and ensure a clean shutdown. If the worker has already been terminated, this method will have no effect.\n   */\n  public async finalize(): Promise<void> {\n    const worker = this.#worker;\n    if (!worker) {\n      return;\n    }\n\n    await worker.destroy();\n    this.#worker = undefined;\n  }\n\n  protected onHanging() {\n    if (!this.#worker) {\n      return;\n    }\n\n    this.#createWorker();\n\n    this.#logger.warn(\n      `Sending SIGTERM signal to worker due to timeout${\n        this.options.timeout\n          ? ` of ${formatDuration({ seconds: this.options.timeout / 1000 })}`\n          : \"\"\n      }. Subsequent errors may be a result of the worker exiting.`\n    );\n\n    void this.finalize().then(() => {\n      this.#resolveRestartPromise?.(RESTARTED);\n    });\n  }\n\n  protected onActivity() {\n    if (this.#hangingTimer) {\n      clearTimeout(this.#hangingTimer);\n    }\n\n    this.#hangingTimer =\n      this.#activeTasks > 0 &&\n      setTimeout(() => this.onHanging(), this.options.timeout);\n  }\n\n  protected async innerExecute(\n    command: string,\n    options: Omit<EngineExecutionOptions, \"channel\">,\n    inlineConfig: InlineConfig\n  ) {\n    if (!this.#worker) {\n      throw new Error(\"Execution Host Worker is not initialized\");\n    }\n\n    const { port1, port2 } = new MessageChannel();\n    const promise = this.#worker.run(\n      { command, options: { ...options, channel: port2 }, inlineConfig },\n      {\n        transferList: [port2] as StructuredSerializeOptions\n      }\n    );\n\n    let aborted = false;\n    const onActivityAbort = () => {\n      if (!aborted) {\n        aborted = true;\n      }\n    };\n    const duplex = new MessagePortDuplex(port1, { onActivityAbort });\n\n    pipeline(duplex, process.stdout, (err: NodeJS.ErrnoException | null) => {\n      if (err) {\n        this.#logger.debug(\n          `Received exception message from worker: ${JSON.stringify(\n            err,\n            null,\n            2\n          )}`\n        );\n\n        throw err;\n      }\n    });\n\n    await promise;\n  }\n}\n","/* -------------------------------------------------------------------\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 { 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 { ExecutionApiWorker } from \"./_internal/execution-api-worker\";\nimport { PowerlinesEngineContext } from \"./context/engine-context\";\nimport { Engine } 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 implements Engine, AsyncDisposable {\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  #api: ExecutionApiWorker;\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 api(): ExecutionApiWorker {\n    return this.#api;\n  }\n\n  /**\n   * Create a new Powerlines Engine instance\n   *\n   * @param context - The Powerlines context\n   * @param api - The API host for the execution workers\n   * @returns A new instance of the Powerlines Engine\n   */\n  public constructor(context: EngineContext, api: ExecutionApiWorker) {\n    this.#context = context;\n    this.#api = api;\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.api.finalize();\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 command - 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(command: string, inlineConfig: InlineConfig) {\n    await Promise.all(\n      (await this.context.loadExecutions(command, inlineConfig)).map(\n        async execution => {\n          try {\n            await this.api.execute(command, execution.options, inlineConfig);\n          } catch (error) {\n            this.context.error(\n              `Execution of method \"${command}\" 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(\n  options: EngineOptions,\n  apiPath = \"@powerlines/engine/api\"\n) {\n  EventEmitter.setMaxListeners(Infinity);\n\n  const context = await createContext(options);\n  const host = await ExecutionApiWorker.from(apiPath, {\n    root: options.root,\n    context\n  });\n\n  return new PowerlinesEngine(context, host);\n}\n"],"mappings":"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"}
+{"version":3,"file":"engine-DRAFIm5M.mjs","names":["#restartPromise","#resolveRestartPromise","#logger","#worker","#createWorker","#activeTasks","#hangingTimer","#context","#api"],"sources":["../src/_internal/execution-api-worker.ts","../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 { InlineConfig, Logger, Mode } from \"@powerlines/core\";\nimport { getDefaultMode } from \"@powerlines/core/lib/config\";\nimport { isDebug } from \"@stryke/env/environment-checks\";\nimport { resolve } from \"@stryke/fs/resolve\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { formatDuration } from \"date-fns/formatDuration\";\nimport { pipeline } from \"node:stream\";\nimport { parseArgs } from \"node:util\";\nimport {\n  MessageChannel,\n  StructuredSerializeOptions\n} from \"node:worker_threads\";\nimport Tinypool from \"tinypool\";\nimport { MessagePortDuplex } from \"../helpers/stream\";\nimport { ExecutionApiWorkerInterface } from \"../types\";\nimport { EngineExecutionOptions } from \"../types/config\";\nimport { EngineContext } from \"../types/context\";\n\nconst RESTARTED = Symbol(\"powerlines-worker:restarted\");\n\n/**\n * The debug address is in the form of `[host:]port`. The host is optional.\n */\ninterface DebugAddress {\n  host?: string;\n  port: number;\n}\n\n/**\n * Formats the debug address into a string.\n */\nconst formatDebugAddress = ({ host, port }: DebugAddress): string => {\n  return host ? `${host}:${port}` : `${port}`;\n};\n\nexport type NodeOptions = Record<string, string | boolean | undefined>;\n\n/**\n * Get's the debug address from the `NODE_OPTIONS` environment variable. If the\n * address is not found, it returns the default host (`undefined`) and port\n * (`9229`).\n *\n * @returns An object with the host and port of the debug address.\n */\nconst getParsedDebugAddress = (\n  address: string | boolean | undefined\n): DebugAddress => {\n  if (!address || !isString(address)) {\n    return { host: undefined, port: 9229 };\n  }\n\n  // The address is in the form of `[host:]port`. Let's parse the address.\n  if (address.includes(\":\")) {\n    const [host, port] = address.split(\":\");\n    if (!host || !port) {\n      throw new Error(`Invalid debug address: ${address}`);\n    }\n\n    return { host, port: Number.parseInt(port, 10) };\n  }\n\n  return { host: undefined, port: Number.parseInt(address, 10) };\n};\n\ntype NodeInspectType = \"inspect\" | \"inspect-brk\" | undefined;\n\n/**\n * Get the debug type from the `NODE_OPTIONS` environment variable.\n */\nfunction getNodeDebugType(nodeOptions: NodeOptions): NodeInspectType {\n  if (nodeOptions.inspect) {\n    return \"inspect\";\n  }\n  if (nodeOptions[\"inspect-brk\"] || nodeOptions.inspect_brk) {\n    return \"inspect-brk\";\n  }\n\n  return undefined;\n}\n\nexport interface ExecutionApiWorkerOptions {\n  // /**\n  //  * `-1` if not inspectable\n  //  */\n  // debuggerPortOffset?: number;\n\n  // /**\n  //  * Whether to enable source maps support in the worker, which can improve the quality of stack traces at the cost of increased memory usage and slower performance. Defaults to `false`.\n  //  */\n  // enableSourceMaps?: boolean;\n\n  /**\n   * The maximum time in milliseconds a worker can run before being terminated.\n   *\n   * @defaultValue 900000 (15 minutes)\n   */\n  timeout?: number;\n\n  /**\n   * True if `--max-old-space-size` should not be forwarded to the worker.\n   */\n  isolatedMemory?: boolean;\n\n  /**\n   * The mode to run the worker in, which can affect how the worker is initialized and how it behaves. This is determined based on the resolved configuration of the engine, and can be used to optimize the worker for different environments (e.g., development, production, etc.).\n   */\n  mode?: Mode;\n\n  /**\n   * An optional root to resolve the execution host path from, which can be used to specify a custom root directory for the worker to use when resolving paths and loading configuration files. If this option is not provided, the worker will use the current working directory as the root directory by default.\n   */\n  root?: string;\n\n  /**\n   * The context of the {@link @powerlines/engine#Engine | Engine instance}, which can be used to access the engine's state and services within the worker.\n   */\n  context: EngineContext;\n}\n\nexport class ExecutionApiWorker implements ExecutionApiWorkerInterface {\n  #worker: Tinypool | undefined;\n\n  #logger: Logger;\n\n  #activeTasks = 0;\n\n  #restartPromise: Promise<typeof RESTARTED> | null = null;\n\n  #resolveRestartPromise: ((arg: typeof RESTARTED) => void) | null = null;\n\n  #hangingTimer: NodeJS.Timeout | false = false;\n\n  #createWorker: () => void;\n\n  protected get restartPromise() {\n    if (!this.#restartPromise) {\n      this.#restartPromise = new Promise(resolve => {\n        this.#resolveRestartPromise = resolve;\n      });\n    }\n    return this.#restartPromise;\n  }\n\n  protected resolveRestartPromise() {\n    if (this.#resolveRestartPromise) {\n      this.#resolveRestartPromise(RESTARTED);\n      this.#restartPromise = null;\n      this.#resolveRestartPromise = null;\n    }\n  }\n\n  /**\n   * Creates a new instance of the Execution API Worker class, which manages a worker process for executing tasks related to the Powerlines Engine. The worker is initialized with the specified options and can be used to run tasks in an isolated environment, with support for automatic restarts and activity monitoring.\n   *\n   * @param apiPath - The path to the Execution API file.\n   * @param options - The options for configuring the worker, including the execution context, exposed methods, timeout, and mode.\n   * @returns A promise that resolves to an instance of the ExecutionApiWorker class.\n   */\n  public static async from(\n    apiPath: string,\n    options: ExecutionApiWorkerOptions\n  ) {\n    const mode = await getDefaultMode(options.context.cwd);\n\n    const resolvedPath = await resolve(apiPath, {\n      paths: [\n        options.context.cwd,\n        options.root ? appendPath(options.root, options.context.cwd) : undefined\n      ].filter(Boolean) as string[]\n    });\n    if (!resolvedPath) {\n      throw new Error(\n        `Could not resolve the provided Execution API path: \\`${apiPath}\\`.`\n      );\n    }\n\n    return new ExecutionApiWorker(resolvedPath, {\n      mode,\n      ...options\n    });\n  }\n\n  /**\n   * Create a new API worker instance.\n   *\n   * @param executionApiPath - The path to the worker file.\n   * @param options - The options for the worker, including exposed commands, timeout, and hooks for activity and restart.\n   */\n  protected constructor(\n    protected executionApiPath: string,\n    protected options: ExecutionApiWorkerOptions\n  ) {\n    const {\n      isolatedMemory = false,\n      mode = \"production\",\n      context\n    } = this.options;\n\n    this.options.timeout ??= 900_000;\n\n    this.#logger = context.extendLogger({ category: \"communication\" });\n    this.#worker = undefined;\n\n    // ensure we end workers if they weren't before exit\n    process.on(\"exit\", () => {\n      void this.finalize();\n    });\n\n    let nodeOptions = {} as {\n      [longOption: string]: string | boolean | undefined;\n    };\n\n    const args: string[] = [...process.execArgv];\n    if (process.env.NODE_OPTIONS) {\n      let isInString = false;\n      let willStartNewArg = true;\n\n      const stringifiedNodeOptions = process.env.NODE_OPTIONS.split(\" \").filter(\n        part =>\n          ((part.startsWith('\"') && part.endsWith('\"')) ||\n            (part.startsWith(\"'\") && part.endsWith(\"'\"))) &&\n          part\n            .replace(/^['\"]|['\"]$/g, \"\")\n            .split(\" \")\n            .filter(isSetString).length > 0 &&\n          part\n            .replace(/^['\"]|['\"]$/g, \"\")\n            .split(\" \")\n            .filter(isSetString)\n            .every(p => p.startsWith(\"--\"))\n      );\n      args.push(\n        ...stringifiedNodeOptions.map(part => part.replace(/^['\"]|['\"]$/g, \"\"))\n      );\n\n      const inputNodeModules = stringifiedNodeOptions.reduce((acc, part) => {\n        return acc.replace(part, \"\").trim();\n      }, process.env.NODE_OPTIONS);\n      for (let i = 0; i < inputNodeModules.length; i++) {\n        let char = inputNodeModules[i];\n        if (char) {\n          // Skip any escaped characters in strings.\n          if (char === \"\\\\\" && isInString) {\n            // Ensure we don't have an escape character at the end.\n            if (inputNodeModules.length === i + 1) {\n              throw new Error(\"Invalid escape character at the end.\");\n            }\n\n            // Skip the next character.\n            char = inputNodeModules[++i];\n            if (!char) {\n              continue;\n            }\n          }\n          // If we find a space outside of a string, we should start a new argument.\n          else if (char === \" \" && !isInString) {\n            willStartNewArg = true;\n            continue;\n          }\n\n          // If we find a quote, we should toggle the string flag.\n          else if (char === '\"') {\n            isInString = !isInString;\n            continue;\n          }\n\n          // If we're starting a new argument, we should add it to the array.\n          if (willStartNewArg) {\n            args.push(char);\n            willStartNewArg = false;\n          }\n          // Otherwise, add it to the last argument.\n          else {\n            args[args.length - 1] += char;\n          }\n        }\n      }\n\n      if (isInString) {\n        throw new Error(\"Unterminated string\");\n      }\n    }\n\n    if (args.length > 0) {\n      const { values, tokens } = parseArgs({\n        args,\n        strict: false,\n        tokens: true\n      });\n      nodeOptions = values;\n\n      // For the `NODE_OPTIONS`, we support arguments with values without the `=`\n      // sign. We need to parse them manually.\n      let orphan = null;\n      for (let i = 0; i < tokens.length; i++) {\n        const token = tokens[i];\n        if (!token) continue;\n\n        if (token.kind === \"option-terminator\") {\n          break;\n        }\n\n        // When we encounter an option, if it's value is undefined, we should check\n        // to see if the following tokens are positional parameters. If they are,\n        // then the option is orphaned, and we can assign it.\n        if (token.kind === \"option\") {\n          orphan = !isSet(token.value) ? token : null;\n          continue;\n        }\n\n        // If the token isn't a positional one, then we can't assign it to the found\n        // orphaned option.\n        if (token.kind !== \"positional\") {\n          orphan = null;\n          continue;\n        }\n\n        // If we don't have an orphan, then we can skip this token.\n        if (!orphan) {\n          continue;\n        }\n\n        // If the token is a positional one, and it has a value, so add it to the\n        // values object. If it already exists, append it with a space.\n        if (orphan.name in nodeOptions && isString(nodeOptions[orphan.name])) {\n          nodeOptions[orphan.name] += ` ${token.value}`;\n        } else {\n          nodeOptions[orphan.name] = token.value;\n        }\n      }\n    }\n\n    const originalOptions = { ...nodeOptions };\n\n    delete nodeOptions.inspect;\n    delete nodeOptions[\"inspect-brk\"];\n    delete nodeOptions.inspect_brk;\n\n    if (isDebug) {\n      const nodeDebugType = getNodeDebugType(originalOptions);\n      if (nodeDebugType) {\n        const debuggerAddress = getParsedDebugAddress(\n          originalOptions[nodeDebugType]\n        );\n        const address: DebugAddress = {\n          host: debuggerAddress.host,\n          // current process runs on `address.port`\n          port: debuggerAddress.port === 0 ? 0 : debuggerAddress.port + 1 + 1\n        };\n        nodeOptions[nodeDebugType] = formatDebugAddress(address);\n\n        this.#logger.info(\n          `Node.js debugger listening on ${nodeOptions[nodeDebugType]}`\n        );\n      }\n\n      nodeOptions[\"enable-source-maps\"] = true;\n    }\n\n    if (isolatedMemory) {\n      delete nodeOptions[\"max-old-space-size\"];\n      delete nodeOptions.max_old_space_size;\n    }\n\n    const execArgv: string[] = [];\n    const nodeOptionsParts: string[] = [];\n    for (const [key, value] of Object.entries(nodeOptions)) {\n      let formatted: string | null = null;\n      if (value === true) {\n        formatted = `--${key}`;\n      } else if (value) {\n        formatted = `--${key}=${\n          // Values with spaces need to be quoted. We use JSON.stringify to\n          // also escape any nested quotes.\n          value.includes(\" \") && !value.startsWith('\"')\n            ? JSON.stringify(value)\n            : value\n        }`;\n      }\n\n      if (formatted === null) {\n        continue;\n      }\n\n      if (\n        [\n          \"experimental-network-inspection\",\n          \"experimental-storage-inspection\",\n          \"experimental-worker-inspection\",\n          \"experimental-inspector-network-resource\"\n        ].includes(key)\n      ) {\n        execArgv.push(formatted);\n      } else {\n        nodeOptionsParts.push(formatted);\n      }\n    }\n\n    // // Issue: https://github.com/nodejs/node/issues/59706\n    // if (!nodeOptionsParts.includes(\"--no-experimental-strip-types\")) {\n    //   nodeOptionsParts.push(\"--no-experimental-strip-types\");\n    // }\n\n    this.#createWorker = () => {\n      const env: Record<string, string> = {\n        ...process.env,\n        NODE_ENV: mode,\n        NODE_OPTIONS: nodeOptionsParts.join(\" \"),\n        POWERLINES_EXECUTION_WORKER: \"true\"\n      };\n\n      // Mirror the enablement heuristic from picocolors (see https://github.com/vercel/next.js/blob/6a40da0345939fe4f7b1ae519b296a86dd103432/packages/next/src/lib/picocolors.ts#L21-L24).\n      // Picocolors snapshots `process.env`/`stdout.isTTY` at module load time, so when the worker\n      // process bootstraps with piped stdio its own check would disable colors. Re-evaluating the\n      // same conditions here lets us opt the worker into color output only when the parent would\n      // have seen colors, while still respecting explicit opt-outs like NO_COLOR.\n      if (\n        env.FORCE_COLOR === undefined &&\n        !env.NO_COLOR &&\n        !env.CI &&\n        env.TERM !== \"dumb\" &&\n        (process.stdout.isTTY || process.stderr?.isTTY)\n      ) {\n        env.FORCE_COLOR = \"1\";\n      }\n\n      this.#logger.debug(\n        `Creating worker from file ${\n          executionApiPath\n        } with execution arguments: ${JSON.stringify(execArgv, null, 2)}`\n      );\n\n      this.#worker = new Tinypool({\n        terminateTimeout: 5000,\n        filename: executionApiPath,\n        execArgv,\n        env\n      });\n\n      this.#restartPromise = new Promise(resolve => {\n        this.#resolveRestartPromise = resolve;\n      });\n\n      this.#worker.on(\"exit\", (code, signal) => {\n        this.#logger.debug(\n          `Worker process exited with code ${code} and signal ${signal}`\n        );\n\n        if ((code || (signal && signal !== \"SIGINT\")) && this.#worker) {\n          const error = new Error(\n            `Execution Host Worker exited unexpectedly with code ${\n              code\n            } and signal ${signal}`\n          );\n          this.#logger.error(error);\n\n          void this.finalize().then(() => {\n            throw error;\n          });\n        }\n      });\n\n      this.#worker.on(\"error\", error => {\n        this.#logger.error({\n          meta: { category: \"communication\" },\n          message: `Worker process emitted an error: ${error.message}`,\n          error\n        });\n      });\n\n      // if a child process emits a particular message, we track that as activity\n      // so the parent process can keep track of progress\n      this.#worker.on(\"message\", data => {\n        this.onActivity();\n\n        if (Array.isArray(data) && data.length > 1 && isNumber(data[0])) {\n          if (data[0] === 0) {\n            this.#logger.trace(\n              `Received message from worker: ${JSON.stringify(data.slice(1), null, 2)}`\n            );\n          } else {\n            this.#logger.debug(\n              `Received error message from worker: ${JSON.stringify(\n                data.slice(1),\n                null,\n                2\n              )}`\n            );\n          }\n        }\n\n        this.#logger.trace(\n          `Received message from worker: ${JSON.stringify(data, null, 2)}`\n        );\n      });\n    };\n\n    this.#createWorker();\n  }\n\n  public async execute(\n    command: string,\n    options: Omit<EngineExecutionOptions, \"channel\">,\n    inlineConfig: InlineConfig\n  ) {\n    if (this.options.timeout) {\n      this.#activeTasks++;\n      try {\n        let attempts = 0;\n        for (;;) {\n          this.onActivity();\n\n          const result = await Promise.race([\n            this.innerExecute(command, options, inlineConfig),\n            this.#restartPromise\n          ]);\n          if (result !== RESTARTED) {\n            return;\n          }\n\n          this.#logger.warn(\n            `Execution Host Worker was restarted while calling method \"${\n              command\n            }\" (attempt ${attempts++}). Retrying the call...`\n          );\n        }\n      } finally {\n        this.#activeTasks--;\n        this.onActivity();\n      }\n    } else {\n      await this.innerExecute(command, options, inlineConfig);\n    }\n  }\n\n  /**\n   * Closes the worker process, terminating it if it's still running. This method should be called when the worker is no longer needed, to free up system resources and ensure a clean shutdown. If the worker has already been terminated, this method will have no effect.\n   */\n  public async finalize(): Promise<void> {\n    const worker = this.#worker;\n    if (!worker) {\n      return;\n    }\n\n    await worker.destroy();\n    this.#worker = undefined;\n  }\n\n  protected onHanging() {\n    if (!this.#worker) {\n      return;\n    }\n\n    this.#createWorker();\n\n    this.#logger.warn(\n      `Sending SIGTERM signal to worker due to timeout${\n        this.options.timeout\n          ? ` of ${formatDuration({ seconds: this.options.timeout / 1000 })}`\n          : \"\"\n      }. Subsequent errors may be a result of the worker exiting.`\n    );\n\n    void this.finalize().then(() => {\n      this.#resolveRestartPromise?.(RESTARTED);\n    });\n  }\n\n  protected onActivity() {\n    if (this.#hangingTimer) {\n      clearTimeout(this.#hangingTimer);\n    }\n\n    this.#hangingTimer =\n      this.#activeTasks > 0 &&\n      setTimeout(() => this.onHanging(), this.options.timeout);\n  }\n\n  protected async innerExecute(\n    command: string,\n    options: Omit<EngineExecutionOptions, \"channel\">,\n    inlineConfig: InlineConfig\n  ) {\n    if (!this.#worker) {\n      throw new Error(\"Execution Host Worker is not initialized\");\n    }\n\n    const { port1, port2 } = new MessageChannel();\n    const promise = this.#worker.run(\n      { command, options: { ...options, channel: port2 }, inlineConfig },\n      {\n        transferList: [port2] as StructuredSerializeOptions\n      }\n    );\n\n    let aborted = false;\n    const onActivityAbort = () => {\n      if (!aborted) {\n        aborted = true;\n      }\n    };\n    const duplex = new MessagePortDuplex(port1, { onActivityAbort });\n\n    pipeline(duplex, process.stdout, (err: NodeJS.ErrnoException | null) => {\n      if (err) {\n        this.#logger.debug(\n          `Received exception message from worker: ${JSON.stringify(\n            err,\n            null,\n            2\n          )}`\n        );\n\n        throw err;\n      }\n    });\n\n    await promise;\n  }\n}\n","/* -------------------------------------------------------------------\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 { 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 { ExecutionApiWorker } from \"./_internal/execution-api-worker\";\nimport { PowerlinesEngineContext } from \"./context/engine-context\";\nimport { Engine } 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 implements Engine, AsyncDisposable {\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  #api: ExecutionApiWorker;\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 api(): ExecutionApiWorker {\n    return this.#api;\n  }\n\n  /**\n   * Create a new Powerlines Engine instance\n   *\n   * @param context - The Powerlines context\n   * @param api - The API host for the execution workers\n   * @returns A new instance of the Powerlines Engine\n   */\n  public constructor(context: EngineContext, api: ExecutionApiWorker) {\n    this.#context = context;\n    this.#api = api;\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.api.finalize();\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 command - 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(command: string, inlineConfig: InlineConfig) {\n    await Promise.all(\n      (await this.context.loadExecutions(command, inlineConfig)).map(\n        async execution => {\n          try {\n            await this.api.execute(command, execution.options, inlineConfig);\n          } catch (error) {\n            this.context.error(\n              `Execution of method \"${command}\" 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(\n  options: EngineOptions,\n  apiPath = \"@powerlines/engine/api\"\n) {\n  EventEmitter.setMaxListeners(Infinity);\n\n  const context = await createContext(options);\n  const host = await ExecutionApiWorker.from(apiPath, {\n    root: options.root,\n    context\n  });\n\n  return new PowerlinesEngine(context, host);\n}\n"],"mappings":"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"}

package/dist/engine.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_engine = require('./engine-D_B_s_Ai.cjs');
+const require_engine = require('./engine-BKEDCOCb.cjs');
 
 exports.PowerlinesEngine = require_engine.PowerlinesEngine;
 exports.createContext = require_engine.createContext;

package/dist/engine.mjs

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

package/dist/helpers/create-api.cjs

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../chunk-CEeaYzDW.cjs');
 const require_helpers_rpc = require('./rpc.cjs');
 const require_helpers_stream = require('./stream.cjs');
 const require_helpers_type_checks = require('./type-checks.cjs');
@@ -14,7 +13,6 @@ let _stryke_unique_id_uuid = require("@stryke/unique-id/uuid");
 let defu = require("defu");
 
 //#region src/helpers/create-api.ts
-var create_api_exports = /* @__PURE__ */ require_chunk.__exportAll({ createApi: () => createApi });
 /**
 * Creates an execution API with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
 *
@@ -64,10 +62,4 @@ function createApi(handlers, inlineConfig = {}) {
 }
 
 //#endregion
-exports.createApi = createApi;
-Object.defineProperty(exports, 'create_api_exports', {
-  enumerable: true,
-  get: function () {
-    return create_api_exports;
-  }
-});
+exports.createApi = createApi;

package/dist/helpers/create-api.mjs

@@ -1,4 +1,3 @@
-import { t as __exportAll } from "../chunk-w6R9maHv.mjs";
 import { createRpcClient } from "./rpc.mjs";
 import { MessagePortDuplex } from "./stream.mjs";
 import { isEngineExecutionOptions } from "./type-checks.mjs";
@@ -13,7 +12,6 @@ import { uuid } from "@stryke/unique-id/uuid";
 import { defu } from "defu";
 
 //#region src/helpers/create-api.ts
-var create_api_exports = /* @__PURE__ */ __exportAll({ createApi: () => createApi });
 /**
 * Creates an execution API with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
 *
@@ -63,5 +61,5 @@ function createApi(handlers, inlineConfig = {}) {
 }
 
 //#endregion
-export { createApi, create_api_exports as t };
+export { createApi };
 //# sourceMappingURL=create-api.mjs.map

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

@@ -1 +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  ExecutionOptions,\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 {\n  consoleLogger,\n  formatExecutionId\n} from \"@powerlines/core/plugin-utils\";\nimport { list } from \"@stryke/string-format/list\";\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\";\nimport { isEngineExecutionOptions } from \"./type-checks\";\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  TOptions extends ExecutionOptions = ExecutionOptions,\n  THandlers extends Record<string, (context: TContext) => Promise<void>> =\n    Record<string, (context: TContext) => Promise<void>>\n>(\n  handlers: THandlers,\n  inlineConfig:\n    | DeepPartial<InlineConfig>\n    | ((prev: InlineConfig) => MaybePromise<InlineConfig>) = {}\n): (\n  params: ExecutionApiParams<TOptions, keyof THandlers & string>\n) => Promise<void> {\n  return async (\n    params: ExecutionApiParams<TOptions, keyof THandlers & string>\n  ) => {\n    const { command, options } = params;\n\n    if (!handlers[command]) {\n      throw new Error(\n        `No API handler function could be found for the command \"${\n          command\n        }\". Please ensure that a handler function for this command is defined in the \\`handlers\\` parameter provided to \\`createApi\\`. The commands available with the current \\`handlers\\` include: ${list(\n          Object.keys(handlers)\n        )}.`\n      );\n    }\n\n    options.configIndex ??= 0;\n    options.executionId ??= formatExecutionId(\n      params.inlineConfig.name || options.root,\n      command,\n      options.configIndex\n    );\n\n    let rpc: RpcClient | undefined;\n    if (isEngineExecutionOptions(options) && options.channel) {\n      const duplex = new MessagePortDuplex(options.channel);\n      duplex.setEncoding(\"utf8\");\n      duplex.on(\"data\", (chunk: string) => duplex.write(chunk.toUpperCase()));\n      duplex.on(\"end\", () => {\n        duplex.end();\n      });\n\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\n    const logFn = (meta: LogFnMeta, message: string) => {\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      } else {\n        consoleLogger(meta, message);\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: 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":";;;;;;;;;;;;;;;;;;;;;;;AAoDA,SAAgB,UAOd,UACA,eAE2D,CAAC,GAG3C;CACjB,OAAO,OACL,WACG;EACH,MAAM,EAAE,SAAS,YAAY;EAE7B,IAAI,CAAC,SAAS,UACZ,MAAM,IAAI,MACR,2DACE,QACD,8LAA8L,KAC7L,OAAO,KAAK,QAAQ,CACtB,EAAE,EACJ;EAGF,QAAQ,gBAAgB;EACxB,QAAQ,gBAAgB,kBACtB,OAAO,aAAa,QAAQ,QAAQ,MACpC,SACA,QAAQ,WACV;EAEA,IAAI;EACJ,IAAI,yBAAyB,OAAO,KAAK,QAAQ,SAAS;GACxD,MAAM,SAAS,IAAI,kBAAkB,QAAQ,OAAO;GACpD,OAAO,YAAY,MAAM;GACzB,OAAO,GAAG,SAAS,UAAkB,OAAO,MAAM,MAAM,YAAY,CAAC,CAAC;GACtE,OAAO,GAAG,aAAa;IACrB,OAAO,IAAI;GACb,CAAC;GAED,IAAI,QAAQ,WAAW,QAAQ,YAC7B,MAAM,gBAAgB,OAAO;QAE7B,MAAM,IAAI,MACR,uDACE,CAAC,QAAQ,UACL,UAAU,QAAQ,aAAa,gCAAgC,OAC/D,aACL,4BACH;EAEJ;EAEA,MAAM,SAAS,MAAiB,YAAoB;GAClD,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;QAED,cAAc,MAAM,OAAO;EAE/B;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,EACO,IACP,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"}
+{"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  ExecutionOptions,\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 {\n  consoleLogger,\n  formatExecutionId\n} from \"@powerlines/core/plugin-utils\";\nimport { list } from \"@stryke/string-format/list\";\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\";\nimport { isEngineExecutionOptions } from \"./type-checks\";\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  TOptions extends ExecutionOptions = ExecutionOptions,\n  THandlers extends Record<string, (context: TContext) => Promise<void>> =\n    Record<string, (context: TContext) => Promise<void>>\n>(\n  handlers: THandlers,\n  inlineConfig:\n    | DeepPartial<InlineConfig>\n    | ((prev: InlineConfig) => MaybePromise<InlineConfig>) = {}\n): (\n  params: ExecutionApiParams<TOptions, keyof THandlers & string>\n) => Promise<void> {\n  return async (\n    params: ExecutionApiParams<TOptions, keyof THandlers & string>\n  ) => {\n    const { command, options } = params;\n\n    if (!handlers[command]) {\n      throw new Error(\n        `No API handler function could be found for the command \"${\n          command\n        }\". Please ensure that a handler function for this command is defined in the \\`handlers\\` parameter provided to \\`createApi\\`. The commands available with the current \\`handlers\\` include: ${list(\n          Object.keys(handlers)\n        )}.`\n      );\n    }\n\n    options.configIndex ??= 0;\n    options.executionId ??= formatExecutionId(\n      params.inlineConfig.name || options.root,\n      command,\n      options.configIndex\n    );\n\n    let rpc: RpcClient | undefined;\n    if (isEngineExecutionOptions(options) && options.channel) {\n      const duplex = new MessagePortDuplex(options.channel);\n      duplex.setEncoding(\"utf8\");\n      duplex.on(\"data\", (chunk: string) => duplex.write(chunk.toUpperCase()));\n      duplex.on(\"end\", () => {\n        duplex.end();\n      });\n\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\n    const logFn = (meta: LogFnMeta, message: string) => {\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      } else {\n        consoleLogger(meta, message);\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: 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":";;;;;;;;;;;;;;;;;;;;;AAoDA,SAAgB,UAOd,UACA,eAE2D,CAAC,GAG3C;CACjB,OAAO,OACL,WACG;EACH,MAAM,EAAE,SAAS,YAAY;EAE7B,IAAI,CAAC,SAAS,UACZ,MAAM,IAAI,MACR,2DACE,QACD,8LAA8L,KAC7L,OAAO,KAAK,QAAQ,CACtB,EAAE,EACJ;EAGF,QAAQ,gBAAgB;EACxB,QAAQ,gBAAgB,kBACtB,OAAO,aAAa,QAAQ,QAAQ,MACpC,SACA,QAAQ,WACV;EAEA,IAAI;EACJ,IAAI,yBAAyB,OAAO,KAAK,QAAQ,SAAS;GACxD,MAAM,SAAS,IAAI,kBAAkB,QAAQ,OAAO;GACpD,OAAO,YAAY,MAAM;GACzB,OAAO,GAAG,SAAS,UAAkB,OAAO,MAAM,MAAM,YAAY,CAAC,CAAC;GACtE,OAAO,GAAG,aAAa;IACrB,OAAO,IAAI;GACb,CAAC;GAED,IAAI,QAAQ,WAAW,QAAQ,YAC7B,MAAM,gBAAgB,OAAO;QAE7B,MAAM,IAAI,MACR,uDACE,CAAC,QAAQ,UACL,UAAU,QAAQ,aAAa,gCAAgC,OAC/D,aACL,4BACH;EAEJ;EAEA,MAAM,SAAS,MAAiB,YAAoB;GAClD,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;QAED,cAAc,MAAM,OAAO;EAE/B;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,EACO,IACP,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"}