@powerlines/engine 0.9.1 → 0.9.2

package/dist/worker/execution-host.cjs

@@ -55,6 +55,19 @@ let _stryke_helpers_omit = require("@stryke/helpers/omit");
 let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let _powerlines_core_context_execution_context = require("@powerlines/core/context/execution-context");
 let _powerlines_core_lib_context_helpers = require("@powerlines/core/lib/context-helpers");
+let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let _stryke_unique_id_uuid = require("@stryke/unique-id/uuid");
+let _powerlines_core_lib_events = require("@powerlines/core/lib/events");
+let _stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
+let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
+let _stryke_url = require("@stryke/url");
+let devframe_client = require("devframe/client");
+let devframe_rpc = require("devframe/rpc");
+let devframe_rpc_client = require("devframe/rpc/client");
+let devframe_rpc_transports_ws_client = require("devframe/rpc/transports/ws-client");
+let devframe_utils_promise = require("devframe/utils/promise");
+let human_id = require("human-id");
+let node_events = require("node:events");
 
 //#region src/api/prepare.ts
 /**
@@ -367,6 +380,131 @@ async function types$1(context) {
 	timer();
 }
 
+//#endregion
+//#region src/helpers/rpc.ts
+function createWsRpcClientMode(baseURL, connectionMeta, events, clientRpc, authToken = (0, human_id.humanId)({
+	separator: "-",
+	capitalize: false
+}), rpcOptions = {}, wsOptions = {}) {
+	let isTrusted = false;
+	const trustedPromise = (0, devframe_utils_promise.promiseWithResolver)();
+	const url = (0, _stryke_type_checks_is_number.isNumber)(connectionMeta.websocket) || (0, _stryke_type_checks_is_set.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 = (0, devframe_rpc_client.createRpcClient)(clientRpc.functions, {
+		channel: (0, devframe_rpc_transports_ws_client.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(options) {
+	const baseURL = new _stryke_url.StormURL(options.baseURL);
+	const cacheManager = new devframe_rpc.RpcCacheManager({
+		functions: [],
+		...typeof options.cacheOptions === "object" ? options.cacheOptions : {}
+	});
+	const context = { rpc: void 0 };
+	const clientRpc = new devframe_rpc.RpcFunctionsCollectorBase(context);
+	node_events.EventEmitter.setMaxListeners(100);
+	const events = (0, _powerlines_core_lib_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 = (0, devframe_client.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
 /**
@@ -377,8 +515,28 @@ async function types$1(context) {
 */
 function createExecutionHost(methods) {
 	return Object.fromEntries(Object.entries(methods).map(([method, fn]) => [method, async (params) => {
-		const context = await _powerlines_core_context_execution_context.PowerlinesExecutionContext.from(params.options, params.inlineConfig ?? {});
-		context.logger.info(`Starting ${method} execution (${params.options.executionId})`);
+		const { options, inlineConfig } = params;
+		let rpc;
+		if (options.baseURL && options.connection) rpc = createRpcClient(options);
+		else throw new Error(`Execution RPC client could not be created - Missing ${!options.baseURL ? `baseURL${options.connection ? ` and connection information` : ""}` : "connection"} or connection information.`);
+		const logFn = (meta, message) => {
+			(0, _powerlines_core_plugin_utils.consoleLogger)(meta, message);
+			if (rpc) rpc.callEvent("powerlines:log", {
+				meta: {
+					category: "general",
+					...options,
+					...(0, _stryke_type_checks_is_set_object.isSetObject)(meta) ? meta : { type: meta },
+					logId: (0, _stryke_unique_id_uuid.uuid)(),
+					timestamp: Date.now()
+				},
+				message
+			});
+		};
+		const context = await _powerlines_core_context_execution_context.PowerlinesExecutionContext.from({
+			...options,
+			logFn
+		}, inlineConfig ?? {}, { rpc });
+		context.logger.info(`Starting ${(0, _stryke_string_format_title_case.titleCase)(options.framework?.name) || "Powerlines"} - ${(0, _stryke_string_format_title_case.titleCase)(method)} execution (${options.executionId})`);
 		await (0, _powerlines_core_lib_context_helpers.resolvePluginConfig)(context);
 		await fn(context);
 	}]));

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

@@ -1,10 +1,60 @@
-import { ExecutionOptions, InlineConfig } from "@powerlines/core";
+import { ExecutionOptions, InlineConfig, LogMeta } from "@powerlines/core";
+import { BirpcOptions } from "birpc";
+import { RpcCacheOptions } from "devframe/rpc";
+import { WsRpcChannelOptions } from "devframe/rpc/transports/ws-client";
+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: ExecutionOptions;
+  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.
    */

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

@@ -1 +1 @@
-{"version":3,"file":"execution-host.d.cts","names":[],"sources":["../../src/types/api.ts","../../src/execution-host.ts"],"mappings":";;UA4IiB,mBAAA;EC3FE;;;ED+FjB,OAAA,EAAS,gBAAA;EC/FQ;;;EDoGjB,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"}
+{"version":3,"file":"execution-host.d.cts","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.d.mts

@@ -1,10 +1,60 @@
-import { ExecutionOptions, InlineConfig } from "@powerlines/core";
+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: ExecutionOptions;
+  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.
    */

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

@@ -1 +1 @@
-{"version":3,"file":"execution-host.d.mts","names":[],"sources":["../../src/types/api.ts","../../src/execution-host.ts"],"mappings":";;UA4IiB,mBAAA;EC3FE;;;ED+FjB,OAAA,EAAS,gBAAA;EC/FQ;;;EDoGjB,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"}
+{"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

@@ -13,7 +13,7 @@ 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 { 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";
@@ -25,6 +25,19 @@ 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
 /**
@@ -337,6 +350,131 @@ async function types$1(context) {
 	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
 /**
@@ -347,8 +485,28 @@ async function types$1(context) {
 */
 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})`);
+		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);
 	}]));