@powerlines/engine 0.9.2 → 0.9.4

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

@@ -1,76 +0,0 @@
-import { ExecutionOptions, InlineConfig, LogMeta } from "@powerlines/core";
-import { RpcCacheManager, RpcCacheOptions } from "devframe/rpc";
-import { WsRpcChannelOptions } from "devframe/rpc/transports/ws-client";
-import { BirpcOptions } from "birpc";
-import { ConnectionMeta, DevToolsRpcClientFunctions, DevToolsRpcServerFunctions } from "devframe/types";
-//#region src/types/rpc.d.ts
-/**
- * Payload for write log Rpc messages.
- */
-interface LogPayload {
-  /**
-   * Metadata associated with the log message, excluding fields that are automatically added by the engine such as executionId, configIndex, environment, and timestamp. This can include custom fields relevant to the log entry, such as category, name, command, hook, plugin, and source.
-   */
-  meta: LogMeta;
-  /**
-   * The log message content, which can be a string or an array of strings representing the log entry. This field is required and should contain the actual message to be logged.
-   */
-  message: string;
-}
-interface RpcServerFunctions extends DevToolsRpcServerFunctions {
-  "powerlines:log": (payload: LogPayload) => void;
-}
-interface RpcClientFunctions extends DevToolsRpcClientFunctions {}
-//#endregion
-//#region src/types/config.d.ts
-interface EngineExecutionOptions extends ExecutionOptions {
-  /**
-   * The base URL for the dev server, which can be used by plugins to construct URLs for assets or API endpoints during development. This value is only relevant in "dev" mode and will be `undefined` in "build" mode.
-   */
-  baseURL: string;
-  /**
-   * Metadata for the connection used by the dev server, including the backend type and websocket configuration.
-   */
-  connection: ConnectionMeta;
-  /**
-   * Options for configuring the WebSocket RPC channel used for communication between the dev server and the client, which can be used by plugins to customize the behavior of the WebSocket connection, such as setting custom timeouts, retry strategies, or other options.
-   */
-  wsOptions?: Partial<WsRpcChannelOptions>;
-  /**
-   * Options for configuring the RPC client used for communication between the dev server and the client, which can be used by plugins to customize the behavior of the RPC client, such as setting custom timeouts, retry strategies, or other options.
-   */
-  rpcOptions?: Partial<BirpcOptions<RpcServerFunctions, RpcClientFunctions, boolean>>;
-  /**
-   * Options for configuring the RPC cache used for caching RPC responses between the dev server and the client, which can be used by plugins to customize the behavior of the RPC cache, such as setting custom cache keys, expiration times, or other options.
-   *
-   * @remarks
-   * This option can be set to `true` to enable caching with default options, or it can be set to a configuration object that allows for fine-grained control over the caching behavior.
-   */
-  cacheOptions?: boolean | Partial<RpcCacheOptions>;
-}
-//#endregion
-//#region src/types/api.d.ts
-interface ExecutionHostParams {
-  /**
-   * The execution options for the current execution instance
-   */
-  options: EngineExecutionOptions;
-  /**
-   * The inline configuration for the current execution instance, which is the result of merging the user configuration with any configuration provided by plugins during the "config" hook.
-   */
-  inlineConfig: InlineConfig;
-}
-//#endregion
-//#region src/execution-host.d.ts
-declare const types: ((params: ExecutionHostParams) => Promise<void>) | undefined;
-declare const prepare: ((params: ExecutionHostParams) => Promise<void>) | undefined;
-declare const create: ((params: ExecutionHostParams) => Promise<void>) | undefined;
-declare const clean: ((params: ExecutionHostParams) => Promise<void>) | undefined;
-declare const lint: ((params: ExecutionHostParams) => Promise<void>) | undefined;
-declare const test: ((params: ExecutionHostParams) => Promise<void>) | undefined;
-declare const build: ((params: ExecutionHostParams) => Promise<void>) | undefined;
-declare const docs: ((params: ExecutionHostParams) => Promise<void>) | undefined;
-declare const deploy: ((params: ExecutionHostParams) => Promise<void>) | undefined;
-//#endregion
-export { build, clean, create, deploy, docs, lint, prepare, test, types };
-//# sourceMappingURL=execution-host.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"execution-host.d.mts","names":[],"sources":["../../src/types/rpc.ts","../../src/types/config.ts","../../src/types/api.ts","../../src/execution-host.ts"],"mappings":";;;;;;;;;UAqGiB,UAAA;ECtBK;;;ED0BpB,IAAA,EAAM,OAAA;ECpBS;;;EDyBf,OAAA;AAAA;AAAA,UAGe,kBAAA,SAA2B,0BAAA;EAE1C,gBAAA,GAAmB,OAAA,EAAS,UAAA;AAAA;AAAA,UAGb,kBAAA,SAA2B,0BAAA;;;UCrD3B,sBAAA,SAA+B,gBAAA;;;;EAI9C,OAAA;;;AAJF;EASE,UAAA,EAAY,cAAA;;;;EAKZ,SAAA,GAAY,OAAA,CAAQ,mBAAA;EAML;;;EADf,UAAA,GAAa,OAAA,CACX,YAAA,CAAa,kBAAA,EAAoB,kBAAA;EASF;;;;;;EAAjC,YAAA,aAAyB,OAAA,CAAQ,eAAA;AAAA;;;UC8ClB,mBAAA;EClGG;;;EDsGlB,OAAA,EAAS,sBAAA;ECrG+B;;;ED0GxC,YAAA,EAAc,YAAA;AAAA;;;cC5GH,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,OAAA,IAAO,MAAA,EAAwB,mBAAA,KAAxB,OAAA;AAAA,cACP,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA;AAAA,cACN,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA"}

package/dist/worker/execution-host.mjs

@@ -1,540 +0,0 @@
-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 { consoleLogger, 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";
-import { titleCase } from "@stryke/string-format/title-case";
-import { uuid } from "@stryke/unique-id/uuid";
-import { createEventEmitter } from "@powerlines/core/lib/events";
-import { isNumber } from "@stryke/type-checks/is-number";
-import { isSet } from "@stryke/type-checks/is-set";
-import { StormURL } from "@stryke/url";
-import { createRpcStreamingClientHost } from "devframe/client";
-import { RpcCacheManager, RpcFunctionsCollectorBase } from "devframe/rpc";
-import { createRpcClient } from "devframe/rpc/client";
-import { createWsRpcChannel } from "devframe/rpc/transports/ws-client";
-import { promiseWithResolver } from "devframe/utils/promise";
-import { humanId } from "human-id";
-import { EventEmitter } from "node:events";
-
-//#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/rpc.ts
-function createWsRpcClientMode(baseURL, connectionMeta, events, clientRpc, authToken = humanId({
-	separator: "-",
-	capitalize: false
-}), rpcOptions = {}, wsOptions = {}) {
-	let isTrusted = false;
-	const trustedPromise = promiseWithResolver();
-	const url = isNumber(connectionMeta.websocket) || isSet(connectionMeta.websocket) && `${+connectionMeta.websocket}` === `${connectionMeta.websocket}` ? `${baseURL.protocol.replace("http", "ws")}//${baseURL.hostname}:${connectionMeta.websocket}` : connectionMeta.websocket;
-	const definitions = /* @__PURE__ */ new Map();
-	for (const name of connectionMeta.jsonSerializableMethods ?? []) definitions.set(name, { jsonSerializable: true });
-	const serverRpc = createRpcClient(clientRpc.functions, {
-		channel: createWsRpcChannel({
-			url,
-			authToken,
-			definitions,
-			...wsOptions
-		}),
-		rpcOptions
-	});
-	clientRpc.register({
-		name: "devframe:auth:revoked",
-		type: "event",
-		handler: () => {
-			isTrusted = false;
-			events.emit("rpc:is-trusted:updated", false);
-		}
-	});
-	let currentAuthToken = authToken;
-	async function requestTrustWithToken(token) {
-		currentAuthToken = token;
-		return true;
-	}
-	async function requestTrust() {
-		if (isTrusted) return true;
-		return requestTrustWithToken(currentAuthToken);
-	}
-	async function ensureTrusted(timeout = 6e4) {
-		if (isTrusted) trustedPromise.resolve(true);
-		if (timeout <= 0) return trustedPromise.promise;
-		let clear = () => {};
-		await Promise.race([trustedPromise.promise.then(clear), new Promise((resolve, reject) => {
-			const id = setTimeout(() => {
-				reject(/* @__PURE__ */ new Error("Timeout waiting for rpc to be trusted"));
-			}, timeout);
-			clear = () => clearTimeout(id);
-		})]);
-		return isTrusted;
-	}
-	return {
-		get isTrusted() {
-			return isTrusted;
-		},
-		requestTrust,
-		requestTrustWithToken,
-		ensureTrusted,
-		call: (...args) => {
-			return serverRpc.$call(...args);
-		},
-		callEvent: (...args) => {
-			return serverRpc.$callEvent(...args);
-		},
-		callOptional: (...args) => {
-			return serverRpc.$callOptional(...args);
-		}
-	};
-}
-const CONNECTION_AUTH_TOKEN_KEY = "__DEVTOOLS_CONNECTION_AUTH_TOKEN__";
-function createRpcClient$1(options) {
-	const baseURL = new StormURL(options.baseURL);
-	const cacheManager = new RpcCacheManager({
-		functions: [],
-		...typeof options.cacheOptions === "object" ? options.cacheOptions : {}
-	});
-	const context = { rpc: void 0 };
-	const clientRpc = new RpcFunctionsCollectorBase(context);
-	EventEmitter.setMaxListeners(100);
-	const events = createEventEmitter();
-	const mode = createWsRpcClientMode(baseURL, options.connection, events, clientRpc, void 0, {
-		...options.rpcOptions,
-		async onRequest(req, next, resolve) {
-			await options.rpcOptions?.onRequest?.call(this, req, next, resolve);
-			if (options.cacheOptions && cacheManager?.validate(req.m)) {
-				const cached = cacheManager.cached(req.m, req.a);
-				if (cached) return resolve(cached);
-				else {
-					const res = await next(req);
-					cacheManager?.apply(req, res);
-				}
-			} else await next(req);
-		}
-	}, options.wsOptions);
-	const rpc = {
-		events,
-		get isTrusted() {
-			return mode.isTrusted;
-		},
-		connectionMeta: options.connection,
-		ensureTrusted: mode.ensureTrusted,
-		requestTrust: mode.requestTrust,
-		requestTrustWithToken: async (token) => {
-			localStorage.setItem(CONNECTION_AUTH_TOKEN_KEY, token);
-			globalThis[CONNECTION_AUTH_TOKEN_KEY] = token;
-			return mode.requestTrustWithToken(token);
-		},
-		call: mode.call,
-		callEvent: mode.callEvent,
-		callOptional: mode.callOptional,
-		client: clientRpc,
-		sharedState: void 0,
-		streaming: void 0,
-		cacheManager
-	};
-	rpc.streaming = createRpcStreamingClientHost(rpc);
-	context.rpc = rpc;
-	mode.requestTrust();
-	try {
-		const bc = new BroadcastChannel("vite-devtools-auth");
-		bc.onmessage = (event) => {
-			if (event.data?.type === "auth-update" && event.data.authToken) rpc.requestTrustWithToken(event.data.authToken);
-		};
-	} catch {}
-	return rpc;
-}
-
-//#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 { options, inlineConfig } = params;
-		let rpc;
-		if (options.baseURL && options.connection) rpc = createRpcClient$1(options);
-		else throw new Error(`Execution RPC client could not be created - Missing ${!options.baseURL ? `baseURL${options.connection ? ` and connection information` : ""}` : "connection"} or connection information.`);
-		const logFn = (meta, message) => {
-			consoleLogger(meta, message);
-			if (rpc) rpc.callEvent("powerlines:log", {
-				meta: {
-					category: "general",
-					...options,
-					...isSetObject(meta) ? meta : { type: meta },
-					logId: uuid(),
-					timestamp: Date.now()
-				},
-				message
-			});
-		};
-		const context = await PowerlinesExecutionContext.from({
-			...options,
-			logFn
-		}, inlineConfig ?? {}, { rpc });
-		context.logger.info(`Starting ${titleCase(options.framework?.name) || "Powerlines"} - ${titleCase(method)} execution (${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