@powerlines/engine 0.0.25 → 0.9.1

package/dist/worker/execution-host.mjs

@@ -0,0 +1,382 @@
+import { formatFolder } from "@powerlines/core";
+import { executeEnvironments } from "@powerlines/core/lib/environment";
+import { copyFiles } from "@stryke/fs/copy-file";
+import { appendPath } from "@stryke/path/append";
+import { relativePath } from "@stryke/path/file-path-fns";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { joinPaths } from "@stryke/path/join-paths";
+import { replacePath } from "@stryke/path/replace";
+import chalk from "chalk";
+import { existsSync } from "node:fs";
+import { handleTypes } from "@powerlines/core/lib/generate-types";
+import { installDependencies } from "@powerlines/core/lib/install-dependencies";
+import { writeMetaFile } from "@powerlines/core/lib/meta";
+import { initializeTsconfig, resolveTsconfig } from "@powerlines/core/lib/typescript/tsconfig";
+import { format, formatFolder as formatFolder$1 } from "@powerlines/core/lib/utilities/format";
+import { formatConfig } from "@powerlines/core/plugin-utils";
+import { toArray } from "@stryke/convert/to-array";
+import { createDirectory } from "@stryke/fs/helpers";
+import { isObject } from "@stryke/type-checks/is-object";
+import { joinPaths as joinPaths$1 } from "@stryke/path/join";
+import { listFiles } from "@stryke/fs/list-files";
+import Handlebars from "handlebars";
+import { formatLogMessage } from "@storm-software/config-tools/logger";
+import { omit } from "@stryke/helpers/omit";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { PowerlinesExecutionContext } from "@powerlines/core/context/execution-context";
+import { resolvePluginConfig } from "@powerlines/core/lib/context-helpers";
+
+//#region src/api/prepare.ts
+/**
+* Prepare the project
+*
+* @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.
+*/
+async function prepare$1(context, skipTypes = false) {
+	const timer = context.timer("Preparation");
+	await executeEnvironments(context, async (env) => {
+		env.debug(`Initializing the processing options for the Powerlines project.`);
+		await context.callHook("configResolved", {
+			environment: env,
+			order: "pre"
+		});
+		await initializeTsconfig(env);
+		await context.callHook("configResolved", {
+			environment: env,
+			order: "normal"
+		});
+		if (env.entry.length > 0) env.debug(`The configuration provided ${isObject(env.config.input) ? Object.keys(env.config.input).length : toArray(env.config.input).length} entry point(s), Powerlines has found ${env.entry.length} entry files(s) for the ${env.config.title} project${env.entry.length > 0 && env.entry.length < 10 ? `: \n${env.entry.map((entry) => `- ${entry.file}${entry.output ? ` -> ${entry.output}` : ""}`).join(" \n")}` : ""}`);
+		else env.warn(`No entry files were found for the ${env.config.title} project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`);
+		await resolveTsconfig(env);
+		await installDependencies(env);
+		await context.callHook("configResolved", {
+			environment: env,
+			order: "post"
+		});
+		env.trace({
+			meta: { category: "config" },
+			message: `Powerlines configuration after configResolved hook: \n${formatConfig(env.config)}`
+		});
+		if (!env.fs.existsSync(env.cachePath)) await createDirectory(env.cachePath);
+		if (!env.fs.existsSync(env.dataPath)) await createDirectory(env.dataPath);
+		await context.callHook("prepare", {
+			environment: env,
+			order: "pre"
+		});
+		await context.callHook("prepare", {
+			environment: env,
+			order: "normal"
+		});
+		await context.callHook("prepare", {
+			environment: env,
+			order: "post"
+		});
+		if (!skipTypes && env.config.output.types !== false) await handleTypes(context, env);
+		context.debug("Formatting files generated during the prepare step.");
+		await Promise.all([formatFolder$1(env, env.builtinsPath), formatFolder$1(env, env.entryPath)]);
+		await writeMetaFile(env);
+		env.persistedMeta = env.meta;
+	});
+	timer();
+}
+
+//#endregion
+//#region src/api/build.ts
+async function handleBuild(context, env) {
+	await context.callHook("build", {
+		environment: env,
+		order: "pre"
+	});
+	env.debug("Formatting the generated entry files before the build process starts.");
+	await formatFolder(env, env.entryPath);
+	await context.callHook("build", {
+		environment: env,
+		order: "normal"
+	});
+	if (env.config.output.copy) {
+		env.debug("Copying project's files from build output directory.");
+		const destinationPath = isParentPath(appendPath(env.config.output.path, env.config.cwd), appendPath(env.config.root, env.config.cwd)) ? joinPaths(env.config.output.copy.path, relativePath(appendPath(env.config.root, env.config.cwd), appendPath(env.config.output.path, env.config.cwd))) : joinPaths(env.config.output.copy.path, "dist");
+		const sourcePath = env.config.output.path;
+		if (existsSync(sourcePath) && sourcePath !== destinationPath) {
+			env.debug(`Copying files from project's build output directory (${env.config.output.path}) to the project's copy/publish directory (${destinationPath}).`);
+			await copyFiles(sourcePath, destinationPath);
+		} else env.warn(`The source path for the copy operation ${!existsSync(sourcePath) ? "does not exist" : "is the same as the destination path"}. Source: ${sourcePath}, Destination: ${destinationPath}. Skipping copying of build output files.`);
+		if (env.config.output.copy.assets && Array.isArray(env.config.output.copy.assets)) await Promise.all(env.config.output.copy.assets.map(async (asset) => {
+			env.trace(`Copying asset(s): ${chalk.redBright(env.config.cwd === asset.input ? asset.glob : appendPath(asset.glob, replacePath(asset.input, env.config.cwd)))} -> ${chalk.greenBright(appendPath(asset.glob, replacePath(asset.output, env.config.cwd)))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk.yellowBright(i)).join(", ")})` : ""}`);
+			await env.fs.copy(asset, asset.output);
+		}));
+	} else env.debug("No copy configuration found for the project output. Skipping the copying of build output files.");
+	await context.callHook("build", {
+		environment: env,
+		order: "post"
+	});
+}
+/**
+* Build the project
+*
+* @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.
+*/
+async function build$1(context) {
+	const timer = context.timer("Building");
+	await context.generateChecksum();
+	if (context.meta.checksum !== context.persistedMeta?.checksum || context.config.skipCache) {
+		context.info(!context.persistedMeta?.checksum ? "No previous build cache found. Preparing the project for the initial build." : context.meta.checksum !== context.persistedMeta.checksum ? "The project has been modified since the last time `prepare` was ran. Re-preparing the project." : "The project is configured to skip cache. Re-preparing the project.");
+		await prepare$1(context);
+	}
+	if (context.config.singleBuild) await handleBuild(context, await context.toEnvironment());
+	else await executeEnvironments(context, async (env) => {
+		await handleBuild(context, env);
+	});
+	timer();
+}
+
+//#endregion
+//#region src/api/clean.ts
+/**
+* Clean any previously prepared artifacts
+*
+* @param context - The execution context for the clean process, which provides access to the project configuration, environment, and utility functions for performing the clean operation. The context is used to manage the state and behavior of the clean process, allowing for hooks to be called at different stages of the clean and for environment-specific configurations to be applied.
+*/
+async function clean$1(context) {
+	const timer = context.timer("Cleaning");
+	await prepare$1(context, true);
+	await executeEnvironments(context, async (env) => {
+		env.debug("Cleaning the project's dist and artifacts directories.");
+		await env.fs.remove(joinPaths$1(env.config.cwd, env.config.output.path));
+		await env.fs.remove(joinPaths$1(env.config.cwd, env.config.root, env.config.output.artifactsPath));
+		await context.callHook("clean", {
+			environment: env,
+			sequential: false
+		});
+	});
+	timer();
+}
+
+//#endregion
+//#region src/api/create.ts
+/**
+* Create a new Powerlines project
+*
+* @param context - The execution context for the create process, which provides access to the project configuration, environment, and utility functions for performing the create operation. The context is used to manage the state and behavior of the create process, allowing for hooks to be called at different stages of the create and for environment-specific configurations to be applied.
+*/
+async function create$1(context) {
+	const timer = context.timer("Create a New Project Generation");
+	await prepare$1(context, true);
+	await executeEnvironments(context, async (env) => {
+		env.debug("Initializing the processing options for the project.");
+		await context.callHook("create", {
+			environment: env,
+			order: "pre"
+		});
+		const files = await listFiles(joinPaths$1(env.powerlinesPath, "files/common/**/*.hbs"));
+		for (const file of files) {
+			env.trace(`Adding template file to project: ${file}`);
+			const template = Handlebars.compile(file);
+			await env.fs.write(joinPaths$1(env.config.root, file.replace(".hbs", "")), template(env));
+		}
+		await context.callHook("create", {
+			environment: env,
+			order: "normal"
+		});
+		if (env.config.projectType === "application") {
+			const appFiles = await listFiles(joinPaths$1(env.powerlinesPath, "files/application/**/*.hbs"));
+			for (const file of appFiles) {
+				env.trace(`Adding application template file: ${file}`);
+				const template = Handlebars.compile(file);
+				await env.fs.write(joinPaths$1(env.config.root, file.replace(".hbs", "")), template(env));
+			}
+		} else {
+			const libFiles = await listFiles(joinPaths$1(env.powerlinesPath, "files/library/**/*.hbs"));
+			for (const file of libFiles) {
+				env.trace(`Adding library template file: ${file}`);
+				const template = Handlebars.compile(file);
+				await env.fs.write(joinPaths$1(env.config.root, file.replace(".hbs", "")), template(env));
+			}
+		}
+		await context.callHook("create", {
+			environment: env,
+			order: "post"
+		});
+	});
+	timer();
+}
+
+//#endregion
+//#region src/api/deploy.ts
+/**
+* Deploy the project's source files to the target environment.
+*
+* @remarks
+* This function serves as the main entry point for the deployment process, orchestrating the execution of deployment hooks across different environments defined in the project configuration. It ensures that all relevant deployment operations are performed in a structured manner, allowing for pre-deployment, main deployment, and post-deployment hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the deployment operation, providing insights into the performance of the deployment process.
+*
+* @param context - The execution context for the deploy process, which provides access to the project configuration, environment, and utility functions for performing the deploy operation. The context is used to manage the state and behavior of the deploy process, allowing for hooks to be called at different stages of the deploy and for environment-specific configurations to be applied.
+*/
+async function deploy$1(context) {
+	const timer = context.timer("Deployment");
+	await prepare$1(context);
+	await executeEnvironments(context, async (env) => {
+		await context.callHook("deploy", { environment: env });
+	});
+	timer();
+}
+
+//#endregion
+//#region src/api/docs.ts
+/**
+* Generate the project's documentation.
+*
+* @remarks
+* This function serves as the main entry point for the documentation generation process, orchestrating the execution of documentation hooks across different environments defined in the project configuration. It ensures that all relevant documentation operations are performed in a structured manner, allowing for pre-documentation, main documentation, and post-documentation hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the documentation operation, providing insights into the performance of the documentation process.
+*
+* @param context - The execution context for the documentation process, which provides access to the project configuration, environment, and utility functions for performing the documentation operation. The context is used to manage the state and behavior of the documentation process, allowing for hooks to be called at different stages of the documentation and for environment-specific configurations to be applied.
+*/
+async function docs$1(context) {
+	const timer = context.timer("Documentation");
+	await prepare$1(context);
+	await executeEnvironments(context, async (env) => {
+		await context.callHook("docs", { environment: env });
+	});
+	timer();
+}
+
+//#endregion
+//#region src/api/lint.ts
+/**
+* Lint the project's source files and report any issues found.
+*
+* @remarks
+* This function serves as the main entry point for the linting process, orchestrating the execution of linting hooks across different environments defined in the project configuration. It ensures that all relevant linting operations are performed in a structured manner, allowing for pre-linting, main linting, and post-linting hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the linting operation, providing insights into the performance of the linting process.
+*
+* @param context - The execution context for the lint process, which provides access to the project configuration, environment, and utility functions for performing the lint operation. The context is used to manage the state and behavior of the lint process, allowing for hooks to be called at different stages of the lint and for environment-specific configurations to be applied.
+*/
+async function lint$1(context) {
+	const timer = context.timer("Linting");
+	await prepare$1(context);
+	await executeEnvironments(context, async (env) => {
+		await context.callHook("lint", {
+			environment: env,
+			sequential: false
+		});
+	});
+	timer();
+}
+
+//#endregion
+//#region src/api/test.ts
+/**
+* Test the project's source files and report any issues found.
+*
+* @remarks
+* This function serves as the main entry point for the testing process, orchestrating the execution of testing hooks across different environments defined in the project configuration. It ensures that all relevant testing operations are performed in a structured manner, allowing for pre-testing, main testing, and post-testing hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the testing operation, providing insights into the performance of the testing process.
+*
+* @param context - The execution context for the test process, which provides access to the project configuration, environment, and utility functions for performing the test operation. The context is used to manage the state and behavior of the test process, allowing for hooks to be called at different stages of the test and for environment-specific configurations to be applied.
+*/
+async function test$1(context) {
+	const timer = context.timer("Testing");
+	await prepare$1(context);
+	await executeEnvironments(context, async (env) => {
+		await context.callHook("test", {
+			environment: env,
+			sequential: false
+		});
+	});
+	timer();
+}
+
+//#endregion
+//#region src/api/types.ts
+/**
+* Generate runtime types for the Powerlines project.
+*
+* @remarks
+* 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.
+*
+* @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.
+*/
+async function types$1(context) {
+	const timer = context.timer("Type Generation");
+	context.debug(" Aggregating configuration options for the Powerlines project");
+	await executeEnvironments(context, async (env) => {
+		env.debug(`Initializing the processing options for the Powerlines project.`);
+		await context.callHook("configResolved", {
+			environment: env,
+			order: "pre"
+		});
+		await initializeTsconfig(env);
+		await context.callHook("configResolved", {
+			environment: env,
+			order: "normal"
+		});
+		if (env.entry.length > 0) env.debug(`The configuration provided ${isObject(env.config.input) ? Object.keys(env.config.input).length : toArray(env.config.input).length} entry point(s), Powerlines has found ${env.entry.length} entry files(s) for the ${env.config.title} project${env.entry.length > 0 && env.entry.length < 10 ? `: \n${env.entry.map((entry) => `- ${entry.file}${entry.output ? ` -> ${entry.output}` : ""}`).join(" \n")}` : ""}`);
+		else env.warn(`No entry files were found for the ${env.config.title} project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`);
+		await resolveTsconfig(env);
+		await installDependencies(env);
+		await context.callHook("configResolved", {
+			environment: env,
+			order: "post"
+		});
+		context.trace(`Powerlines configuration has been resolved: \n\n${formatLogMessage({
+			...env.config,
+			userConfig: isSetObject(env.config.userConfig) ? omit(env.config.userConfig, ["plugins"]) : void 0,
+			inlineConfig: isSetObject(env.config.inlineConfig) ? env.config.inlineConfig : void 0,
+			plugins: env.plugins.map((plugin) => plugin.name)
+		})}`);
+		if (!env.fs.existsSync(env.cachePath)) await createDirectory(env.cachePath);
+		if (!env.fs.existsSync(env.dataPath)) await createDirectory(env.dataPath);
+		if (env.config.skipCache === true || env.persistedMeta?.checksum !== env.meta.checksum) env.debug(`Using previously prepared files as the meta checksum has not changed.`);
+		else {
+			env.info(`Running \`prepare\` command as the meta checksum has changed since the last run.`);
+			await prepare$1(context, true);
+		}
+		await handleTypes(context, env);
+		context.debug("Formatting files generated during the types step.");
+		await format(env, env.typesPath, await env.fs.read(env.typesPath) ?? "");
+		await writeMetaFile(env);
+		env.persistedMeta = env.meta;
+	});
+	timer();
+}
+
+//#endregion
+//#region src/helpers/create-execution-host.ts
+/**
+* Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.
+*
+* @param methods - An object where keys are method names and values are functions that take an execution context and return a promise.
+* @returns An object with the same keys as the input methods, but each function is wrapped to create an execution context and handle errors.
+*/
+function createExecutionHost(methods) {
+	return Object.fromEntries(Object.entries(methods).map(([method, fn]) => [method, async (params) => {
+		const context = await PowerlinesExecutionContext.from(params.options, params.inlineConfig ?? {});
+		context.logger.info(`Starting ${method} execution (${params.options.executionId})`);
+		await resolvePluginConfig(context);
+		await fn(context);
+	}]));
+}
+
+//#endregion
+//#region src/execution-host.ts
+const executionHost = createExecutionHost({
+	types: types$1,
+	prepare: prepare$1,
+	create: create$1,
+	clean: clean$1,
+	lint: lint$1,
+	test: test$1,
+	build: build$1,
+	docs: docs$1,
+	deploy: deploy$1
+});
+const types = executionHost.types;
+const prepare = executionHost.prepare;
+const create = executionHost.create;
+const clean = executionHost.clean;
+const lint = executionHost.lint;
+const test = executionHost.test;
+const build = executionHost.build;
+const docs = executionHost.docs;
+const deploy = executionHost.deploy;
+
+//#endregion
+export { build, clean, create, deploy, docs, lint, prepare, test, types };
+//# sourceMappingURL=execution-host.mjs.map

package/dist/worker/execution-host.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-host.mjs","names":["prepare","formatFolder","build","prepare","clean","prepare","joinPaths","create","prepare","joinPaths","deploy","prepare","docs","prepare","lint","prepare","test","prepare","types","prepare","executeTypes","executePrepare","executeCreate","executeClean","executeLint","executeTest","executeBuild","executeDocs","executeDeploy"],"sources":["../../src/api/prepare.ts","../../src/api/build.ts","../../src/api/clean.ts","../../src/api/create.ts","../../src/api/deploy.ts","../../src/api/docs.ts","../../src/api/lint.ts","../../src/api/test.ts","../../src/api/types.ts","../../src/helpers/create-execution-host.ts","../../src/execution-host.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ExecutionContext } from \"@powerlines/core\";\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 { formatFolder } from \"@powerlines/core/lib/utilities/format\";\nimport { formatConfig } from \"@powerlines/core/plugin-utils\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\n\n/**\n * Prepare 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 prepare<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  skipTypes = false\n) {\n  const timer = context.timer(\"Preparation\");\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      env.debug(\n        `The configuration provided ${\n          isObject(env.config.input)\n            ? Object.keys(env.config.input).length\n            : toArray(env.config.input).length\n        } entry point(s), Powerlines has found ${\n          env.entry.length\n        } entry files(s) for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${entry.file}${\n                      entry.output ? ` -> ${entry.output}` : \"\"\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    env.trace({\n      meta: {\n        category: \"config\"\n      },\n      message: `Powerlines configuration after configResolved hook: \\n${formatConfig(\n        env.config\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    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"pre\"\n    });\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    if (!skipTypes && env.config.output.types !== false) {\n      await handleTypes(context, env);\n    }\n\n    context.debug(\"Formatting files generated during the prepare step.\");\n\n    await Promise.all([\n      formatFolder(env, env.builtinsPath),\n      formatFolder(env, env.entryPath)\n    ]);\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\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 {\n  EnvironmentContext,\n  ExecutionContext,\n  formatFolder\n} from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { copyFiles } from \"@stryke/fs/copy-file\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport chalk from \"chalk\";\nimport { existsSync } from \"node:fs\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\nasync function handleBuild<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  env: EnvironmentContext<TResolvedConfig, TSystemContext>\n) {\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"pre\"\n  });\n\n  env.debug(\n    \"Formatting the generated entry files before the build process starts.\"\n  );\n  await formatFolder(env, env.entryPath);\n\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"normal\"\n  });\n\n  if (env.config.output.copy) {\n    env.debug(\"Copying project's files from build output directory.\");\n\n    const destinationPath = isParentPath(\n      appendPath(env.config.output.path, env.config.cwd),\n      appendPath(env.config.root, env.config.cwd)\n    )\n      ? joinPaths(\n          env.config.output.copy.path,\n          relativePath(\n            appendPath(env.config.root, env.config.cwd),\n            appendPath(env.config.output.path, env.config.cwd)\n          )\n        )\n      : joinPaths(env.config.output.copy.path, \"dist\");\n    const sourcePath = env.config.output.path;\n\n    if (existsSync(sourcePath) && sourcePath !== destinationPath) {\n      env.debug(\n        `Copying files from project's build output directory (${\n          env.config.output.path\n        }) to the project's copy/publish directory (${destinationPath}).`\n      );\n\n      await copyFiles(sourcePath, destinationPath);\n    } else {\n      env.warn(\n        `The source path for the copy operation ${\n          !existsSync(sourcePath)\n            ? \"does not exist\"\n            : \"is the same as the destination path\"\n        }. Source: ${sourcePath}, Destination: ${\n          destinationPath\n        }. Skipping copying of build output files.`\n      );\n    }\n\n    if (\n      env.config.output.copy.assets &&\n      Array.isArray(env.config.output.copy.assets)\n    ) {\n      await Promise.all(\n        env.config.output.copy.assets.map(async asset => {\n          env.trace(\n            `Copying asset(s): ${chalk.redBright(\n              env.config.cwd === asset.input\n                ? asset.glob\n                : appendPath(\n                    asset.glob,\n                    replacePath(asset.input, env.config.cwd)\n                  )\n            )} -> ${chalk.greenBright(\n              appendPath(asset.glob, replacePath(asset.output, env.config.cwd))\n            )} ${\n              Array.isArray(asset.ignore) && asset.ignore.length > 0\n                ? ` (ignoring: ${asset.ignore\n                    .map(i => chalk.yellowBright(i))\n                    .join(\", \")})`\n                : \"\"\n            }`\n          );\n\n          await env.fs.copy(asset, asset.output);\n        })\n      );\n    }\n  } else {\n    env.debug(\n      \"No copy configuration found for the project output. Skipping the copying of build output files.\"\n    );\n  }\n\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"post\"\n  });\n}\n\n/**\n * Build 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 build<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Building\");\n\n  await context.generateChecksum();\n  if (\n    context.meta.checksum !== context.persistedMeta?.checksum ||\n    context.config.skipCache\n  ) {\n    context.info(\n      !context.persistedMeta?.checksum\n        ? \"No previous build cache found. Preparing the project for the initial build.\"\n        : context.meta.checksum !== context.persistedMeta.checksum\n          ? \"The project has been modified since the last time `prepare` was ran. Re-preparing the project.\"\n          : \"The project is configured to skip cache. Re-preparing the project.\"\n    );\n\n    await prepare<TResolvedConfig, TSystemContext>(context);\n  }\n\n  if (context.config.singleBuild) {\n    await handleBuild<TResolvedConfig, TSystemContext>(\n      context,\n      await context.toEnvironment()\n    );\n  } else {\n    await executeEnvironments(context, async env => {\n      await handleBuild<TResolvedConfig, TSystemContext>(context, env);\n    });\n  }\n\n  timer();\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Clean any previously prepared artifacts\n *\n * @param context - The execution context for the clean process, which provides access to the project configuration, environment, and utility functions for performing the clean operation. The context is used to manage the state and behavior of the clean process, allowing for hooks to be called at different stages of the clean and for environment-specific configurations to be applied.\n */\nexport async function clean<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Cleaning\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context, true);\n  await executeEnvironments(context, async env => {\n    env.debug(\"Cleaning the project's dist and artifacts directories.\");\n\n    await env.fs.remove(joinPaths(env.config.cwd, env.config.output.path));\n    await env.fs.remove(\n      joinPaths(\n        env.config.cwd,\n        env.config.root,\n        env.config.output.artifactsPath\n      )\n    );\n\n    await context.callHook(\"clean\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { listFiles } from \"@stryke/fs/list-files\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport Handlebars from \"handlebars\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Create a new Powerlines project\n *\n * @param context - The execution context for the create process, which provides access to the project configuration, environment, and utility functions for performing the create operation. The context is used to manage the state and behavior of the create process, allowing for hooks to be called at different stages of the create and for environment-specific configurations to be applied.\n */\nexport async function create<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Create a New Project Generation\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context, true);\n  await executeEnvironments(context, async env => {\n    env.debug(\"Initializing the processing options for the project.\");\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    const files = await listFiles(\n      joinPaths(env.powerlinesPath, \"files/common/**/*.hbs\")\n    );\n    for (const file of files) {\n      env.trace(`Adding template file to project: ${file}`);\n\n      const template = Handlebars.compile(file);\n      await env.fs.write(\n        joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n        template(env)\n      );\n    }\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.config.projectType === \"application\") {\n      const appFiles = await listFiles(\n        joinPaths(env.powerlinesPath, \"files/application/**/*.hbs\")\n      );\n      for (const file of appFiles) {\n        env.trace(`Adding application template file: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await env.fs.write(\n          joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n          template(env)\n        );\n      }\n    } else {\n      const libFiles = await listFiles(\n        joinPaths(env.powerlinesPath, \"files/library/**/*.hbs\")\n      );\n      for (const file of libFiles) {\n        env.trace(`Adding library template file: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await env.fs.write(\n          joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n          template(env)\n        );\n      }\n    }\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"post\"\n    });\n  });\n\n  timer();\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Deploy the project's source files to the target environment.\n *\n * @remarks\n * This function serves as the main entry point for the deployment process, orchestrating the execution of deployment hooks across different environments defined in the project configuration. It ensures that all relevant deployment operations are performed in a structured manner, allowing for pre-deployment, main deployment, and post-deployment hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the deployment operation, providing insights into the performance of the deployment process.\n *\n * @param context - The execution context for the deploy process, which provides access to the project configuration, environment, and utility functions for performing the deploy operation. The context is used to manage the state and behavior of the deploy process, allowing for hooks to be called at different stages of the deploy and for environment-specific configurations to be applied.\n */\nexport async function deploy<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Deployment\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"deploy\", {\n      environment: env\n    });\n  });\n\n  timer();\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate the project's documentation.\n *\n * @remarks\n * This function serves as the main entry point for the documentation generation process, orchestrating the execution of documentation hooks across different environments defined in the project configuration. It ensures that all relevant documentation operations are performed in a structured manner, allowing for pre-documentation, main documentation, and post-documentation hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the documentation operation, providing insights into the performance of the documentation process.\n *\n * @param context - The execution context for the documentation process, which provides access to the project configuration, environment, and utility functions for performing the documentation operation. The context is used to manage the state and behavior of the documentation process, allowing for hooks to be called at different stages of the documentation and for environment-specific configurations to be applied.\n */\nexport async function docs<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Documentation\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"docs\", {\n      environment: env\n    });\n  });\n\n  timer();\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Lint the project's source files and report any issues found.\n *\n * @remarks\n * This function serves as the main entry point for the linting process, orchestrating the execution of linting hooks across different environments defined in the project configuration. It ensures that all relevant linting operations are performed in a structured manner, allowing for pre-linting, main linting, and post-linting hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the linting operation, providing insights into the performance of the linting process.\n *\n * @param context - The execution context for the lint process, which provides access to the project configuration, environment, and utility functions for performing the lint operation. The context is used to manage the state and behavior of the lint process, allowing for hooks to be called at different stages of the lint and for environment-specific configurations to be applied.\n */\nexport async function lint<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Linting\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"lint\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Test the project's source files and report any issues found.\n *\n * @remarks\n * This function serves as the main entry point for the testing process, orchestrating the execution of testing hooks across different environments defined in the project configuration. It ensures that all relevant testing operations are performed in a structured manner, allowing for pre-testing, main testing, and post-testing hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the testing operation, providing insights into the performance of the testing process.\n *\n * @param context - The execution context for the test process, which provides access to the project configuration, environment, and utility functions for performing the test operation. The context is used to manage the state and behavior of the test process, allowing for hooks to be called at different stages of the test and for environment-specific configurations to be applied.\n */\nexport async function test<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Testing\");\n\n  await prepare(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"test\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\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 { 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 { 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      env.debug(\n        `The configuration provided ${\n          isObject(env.config.input)\n            ? Object.keys(env.config.input).length\n            : toArray(env.config.input).length\n        } entry point(s), Powerlines has found ${\n          env.entry.length\n        } entry files(s) for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${entry.file}${\n                      entry.output ? ` -> ${entry.output}` : \"\"\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","/* -------------------------------------------------------------------\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 { PowerlinesExecutionContext } from \"@powerlines/core/context/execution-context\";\nimport { resolvePluginConfig } from \"@powerlines/core/lib/context-helpers\";\nimport { ExecutionHostParams } from \"../types/api\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\n\n/**\n * Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.\n *\n * @param methods - An object where keys are method names and values are functions that take an execution context and return a promise.\n * @returns An object with the same keys as the input methods, but each function is wrapped to create an execution context and handle errors.\n */\nexport function createExecutionHost<\n  TContext extends PowerlinesExecutionContext<\n    EngineResolvedConfig,\n    EngineSystemContext\n  > = PowerlinesExecutionContext<EngineResolvedConfig, EngineSystemContext>\n>(methods: Record<string, (context: TContext) => Promise<void>>) {\n  return Object.fromEntries(\n    Object.entries(methods).map(([method, fn]) => [\n      method,\n      async (params: ExecutionHostParams) => {\n        const context = (await PowerlinesExecutionContext.from(\n          params.options,\n          params.inlineConfig ?? {}\n        )) as TContext;\n        context.logger.info(\n          `Starting ${method} execution (${params.options.executionId})`\n        );\n\n        await resolvePluginConfig(context as PowerlinesExecutionContext<any>);\n\n        await fn(context);\n      }\n    ])\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 { build as executeBuild } from \"./api/build\";\nimport { clean as executeClean } from \"./api/clean\";\nimport { create as executeCreate } from \"./api/create\";\nimport { deploy as executeDeploy } from \"./api/deploy\";\nimport { docs as executeDocs } from \"./api/docs\";\nimport { lint as executeLint } from \"./api/lint\";\nimport { prepare as executePrepare } from \"./api/prepare\";\nimport { test as executeTest } from \"./api/test\";\nimport { types as executeTypes } from \"./api/types\";\nimport { createExecutionHost } from \"./helpers/create-execution-host\";\n\nconst executionHost = createExecutionHost({\n  types: executeTypes,\n  prepare: executePrepare,\n  create: executeCreate,\n  clean: executeClean,\n  lint: executeLint,\n  test: executeTest,\n  build: executeBuild,\n  docs: executeDocs,\n  deploy: executeDeploy\n});\n\nexport const types = executionHost.types;\nexport const prepare = executionHost.prepare;\nexport const create = executionHost.create;\nexport const clean = executionHost.clean;\nexport const lint = executionHost.lint;\nexport const test = executionHost.test;\nexport const build = executionHost.build;\nexport const docs = executionHost.docs;\nexport const deploy = executionHost.deploy;\n"],"mappings":"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"}