@powerlines/core 0.48.32 → 0.48.34

package/dist/lib/meta.mjs

@@ -3,6 +3,7 @@ import "../constants/index.mjs";
 import { existsSync } from "@stryke/fs/exists";
 import { readJsonFile } from "@stryke/fs/json";
 import { joinPaths } from "@stryke/path/join-paths";
+import { replacePath } from "@stryke/path/replace";
 import { kebabCase } from "@stryke/string-format/kebab-case";
 import { removeFile } from "@stryke/fs/remove-file";
 
@@ -45,7 +46,7 @@ async function getPersistedMeta(context) {
 */
 async function writeMetaFile(context) {
 	const metaFilePath = joinPaths(context.dataPath, "meta.json");
-	context.debug(`Writing runtime metadata to ${metaFilePath}`);
+	context.debug(`Writing runtime metadata to ${replacePath(metaFilePath, context.config.cwd)}`);
 	await context.fs.write(metaFilePath, JSON.stringify(context.meta, null, 2));
 }
 

package/dist/lib/meta.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"meta.mjs","names":[],"sources":["../../src/lib/meta.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 { existsSync } from \"@stryke/fs/exists\";\nimport { readJsonFile } from \"@stryke/fs/json\";\nimport { removeFile } from \"@stryke/fs/remove-file\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { ROOT_HASH_LENGTH } from \"../constants\";\nimport type { Context, MetaInfo } from \"../types\";\n\nexport interface CreateContextOptions {\n  name?: string;\n}\n\n/**\n * Generates a prefixed project root hash object.\n *\n * @remarks\n * This function returns a string where the project root hash is prefixed with the project name plus a hyphen. If the total length of this string combination exceeds 45 characters, it will truncate the hash.\n *\n * @param name - The name of the project.\n * @param rootHash - The hash of the project root.\n * @returns An object containing the name and project root hash.\n */\nexport function getPrefixedRootHash(name: string, rootHash: string): string {\n  const combined = `${kebabCase(name)}_${rootHash}`;\n\n  return combined.length > ROOT_HASH_LENGTH\n    ? combined.slice(0, ROOT_HASH_LENGTH)\n    : combined;\n}\n\n/**\n * Retrieves the persisted meta information from the context's data path.\n *\n * @param context - The build context.\n * @returns A promise that resolves to the persisted meta information, or undefined if not found.\n */\nexport async function getPersistedMeta(\n  context: Context\n): Promise<MetaInfo | undefined> {\n  const metaFilePath = joinPaths(context.dataPath, \"meta.json\");\n  if (existsSync(metaFilePath)) {\n    try {\n      return await readJsonFile<MetaInfo>(metaFilePath);\n    } catch {\n      context.warn(\n        `Failed to read meta file at ${metaFilePath}. It may be corrupted.`\n      );\n      await removeFile(metaFilePath);\n\n      context.persistedMeta = undefined;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Writes the meta file for the context.\n *\n * @param context - The context to write the meta file for.\n * @returns A promise that resolves when the meta file has been written.\n */\nexport async function writeMetaFile(context: Context): Promise<void> {\n  const metaFilePath = joinPaths(context.dataPath, \"meta.json\");\n\n  context.debug(`Writing runtime metadata to ${metaFilePath}`);\n\n  await context.fs.write(metaFilePath, JSON.stringify(context.meta, null, 2));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwCA,SAAgB,oBAAoB,MAAc,UAA0B;CAC1E,MAAM,WAAW,GAAG,UAAU,IAAI,EAAE,GAAG;CAEvC,OAAO,SAAS,cACZ,SAAS,MAAM,KAAmB,IAClC;AACN;;;;;;;AAQA,eAAsB,iBACpB,SAC+B;CAC/B,MAAM,eAAe,UAAU,QAAQ,UAAU,WAAW;CAC5D,IAAI,WAAW,YAAY,GACzB,IAAI;EACF,OAAO,MAAM,aAAuB,YAAY;CAClD,QAAQ;EACN,QAAQ,KACN,+BAA+B,aAAa,uBAC9C;EACA,MAAM,WAAW,YAAY;EAE7B,QAAQ,gBAAgB;CAC1B;AAIJ;;;;;;;AAQA,eAAsB,cAAc,SAAiC;CACnE,MAAM,eAAe,UAAU,QAAQ,UAAU,WAAW;CAE5D,QAAQ,MAAM,+BAA+B,cAAc;CAE3D,MAAM,QAAQ,GAAG,MAAM,cAAc,KAAK,UAAU,QAAQ,MAAM,MAAM,CAAC,CAAC;AAC5E"}
+{"version":3,"file":"meta.mjs","names":[],"sources":["../../src/lib/meta.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 { existsSync } from \"@stryke/fs/exists\";\nimport { readJsonFile } from \"@stryke/fs/json\";\nimport { removeFile } from \"@stryke/fs/remove-file\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { ROOT_HASH_LENGTH } from \"../constants\";\nimport type { Context, MetaInfo } from \"../types\";\n\nexport interface CreateContextOptions {\n  name?: string;\n}\n\n/**\n * Generates a prefixed project root hash object.\n *\n * @remarks\n * This function returns a string where the project root hash is prefixed with the project name plus a hyphen. If the total length of this string combination exceeds 45 characters, it will truncate the hash.\n *\n * @param name - The name of the project.\n * @param rootHash - The hash of the project root.\n * @returns An object containing the name and project root hash.\n */\nexport function getPrefixedRootHash(name: string, rootHash: string): string {\n  const combined = `${kebabCase(name)}_${rootHash}`;\n\n  return combined.length > ROOT_HASH_LENGTH\n    ? combined.slice(0, ROOT_HASH_LENGTH)\n    : combined;\n}\n\n/**\n * Retrieves the persisted meta information from the context's data path.\n *\n * @param context - The build context.\n * @returns A promise that resolves to the persisted meta information, or undefined if not found.\n */\nexport async function getPersistedMeta(\n  context: Context\n): Promise<MetaInfo | undefined> {\n  const metaFilePath = joinPaths(context.dataPath, \"meta.json\");\n  if (existsSync(metaFilePath)) {\n    try {\n      return await readJsonFile<MetaInfo>(metaFilePath);\n    } catch {\n      context.warn(\n        `Failed to read meta file at ${metaFilePath}. It may be corrupted.`\n      );\n      await removeFile(metaFilePath);\n\n      context.persistedMeta = undefined;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Writes the meta file for the context.\n *\n * @param context - The context to write the meta file for.\n * @returns A promise that resolves when the meta file has been written.\n */\nexport async function writeMetaFile(context: Context): Promise<void> {\n  const metaFilePath = joinPaths(context.dataPath, \"meta.json\");\n\n  context.debug(\n    `Writing runtime metadata to ${replacePath(\n      metaFilePath,\n      context.config.cwd\n    )}`\n  );\n\n  await context.fs.write(metaFilePath, JSON.stringify(context.meta, null, 2));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,oBAAoB,MAAc,UAA0B;CAC1E,MAAM,WAAW,GAAG,UAAU,IAAI,EAAE,GAAG;CAEvC,OAAO,SAAS,cACZ,SAAS,MAAM,KAAmB,IAClC;AACN;;;;;;;AAQA,eAAsB,iBACpB,SAC+B;CAC/B,MAAM,eAAe,UAAU,QAAQ,UAAU,WAAW;CAC5D,IAAI,WAAW,YAAY,GACzB,IAAI;EACF,OAAO,MAAM,aAAuB,YAAY;CAClD,QAAQ;EACN,QAAQ,KACN,+BAA+B,aAAa,uBAC9C;EACA,MAAM,WAAW,YAAY;EAE7B,QAAQ,gBAAgB;CAC1B;AAIJ;;;;;;;AAQA,eAAsB,cAAc,SAAiC;CACnE,MAAM,eAAe,UAAU,QAAQ,UAAU,WAAW;CAE5D,QAAQ,MACN,+BAA+B,YAC7B,cACA,QAAQ,OAAO,GACjB,GACF;CAEA,MAAM,QAAQ,GAAG,MAAM,cAAc,KAAK,UAAU,QAAQ,MAAM,MAAM,CAAC,CAAC;AAC5E"}

package/dist/lib/plugins.cjs

@@ -1,12 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../chunk-C_NdSu1c.cjs');
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_plugin_utils_helpers = require('../plugin-utils/helpers.cjs');
 require('../plugin-utils/index.cjs');
 let _stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
 let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 let _stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
 let chalk = require("chalk");
-chalk = require_chunk.__toESM(chalk, 1);
+chalk = require_runtime.__toESM(chalk, 1);
 let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_path_join = require("@stryke/path/join");
 let _stryke_fs_install = require("@stryke/fs/install");
@@ -134,7 +134,7 @@ async function resolvePlugins(context, config, options = {}) {
 	if (config) {
 		const result = await initPlugin(context, config);
 		if (result) for (const plugin of result) {
-			if (!skipLogging) context.debug({
+			if (!skipLogging) context.trace({
 				meta: { category: "plugins" },
 				message: `Successfully initialized the ${chalk.default.bold.cyanBright(plugin.name)} plugin`
 			});

package/dist/lib/plugins.d.cts

@@ -1,2 +1,39 @@
-import { i as resolvePlugins, n as initPlugin, r as resolvePlugin, t as ResolvePluginsOptions } from "../plugins-DfL1fBZi.cjs";
-export { ResolvePluginsOptions, initPlugin, resolvePlugin, resolvePlugins };
+import { Plugin } from "../types/plugin.cjs";
+import { EnvironmentContext, ExecutionContext, PluginContext } from "../types/context.cjs";
+import { PluginConfig, ResolvedConfig } from "../types/config.cjs";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region src/lib/plugins.d.ts
+/**
+ * Resolve a plugin module based on the provided plugin path. This function checks if the plugin package is installed, attempts to import the plugin module, and handles various error cases such as missing packages or invalid module exports. It supports both direct plugin exports and plugins exported from a "plugin" subdirectory within the package.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param pluginPath - The path to the plugin module. This can be a package name, a scoped package name, or a path to a local module.
+ * @returns A promise that resolves to the plugin module, which can be a plugin instance, a factory function that returns a plugin, or an array of plugins.
+ */
+declare function resolvePlugin<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, pluginPath: string): Promise<Plugin<TPluginContext> | Plugin<TPluginContext>[] | ((options?: any) => MaybePromise<Plugin<TPluginContext> | Plugin<TPluginContext>[]>)>;
+/**
+ * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, factory functions, string paths to plugins, and arrays of plugins or plugin configurations. It validates the plugin configuration, resolves any plugin paths, and returns an array of initialized plugins.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param config - The plugin configuration, which can be in various forms such as a direct plugin instance, a string path to a plugin, a factory function that returns a plugin, or an array of plugins or plugin configurations. This configuration will be processed and validated to initialize the appropriate plugins.
+ * @returns A promise that resolves to an array of initialized plugins based on the provided configuration. If the configuration is invalid, an error will be thrown with details about the issue.
+ */
+declare function initPlugin<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, config: PluginConfig<TPluginContext>, options?: ResolvePluginsOptions): Promise<Plugin<TPluginContext>[] | null>;
+interface ResolvePluginsOptions {
+  /**
+   * If true, the plugin resolution process will skip logging messages about the plugin initialization. This can be useful in scenarios where you want to suppress plugin-related logs, such as when running in a non-interactive environment or when you want to reduce log verbosity. By default, this option is false, and plugin initialization messages will be logged using the context's logger.
+   */
+  skipLogging?: boolean;
+}
+/**
+ * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, plugin names, factory functions, and arrays of plugins. It validates the configuration, resolves plugin modules if necessary, and returns an array of initialized plugins ready to be added to the execution context.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param config - The plugin configuration, which can be in various forms such as a plugin instance, a plugin name string, a factory function that returns a plugin or an array of plugins, or an array of plugin configurations. The function will handle the resolution and initialization of the plugin(s) based on the provided configuration.
+ * @returns A promise that resolves to an array of initialized plugins that can be added to the execution context, or null if the configuration is invalid or results in no plugins being initialized.
+ */
+declare function resolvePlugins<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, config: PluginConfig<TPluginContext>, options?: ResolvePluginsOptions): Promise<Plugin<TPluginContext>[]>;
+//#endregion
+export { ResolvePluginsOptions, initPlugin, resolvePlugin, resolvePlugins };
+//# sourceMappingURL=plugins.d.cts.map

package/dist/lib/plugins.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.cts","names":[],"sources":["../../src/lib/plugins.ts"],"mappings":";;;;;;;;;;;AAwDA;;iBAAsB,aAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,GAEjC,OAAA,EAAS,QAAA,EACT,UAAA,WACC,OAAA,CACC,MAAA,CAAO,cAAA,IACP,MAAA,CAAO,cAAA,QAEL,OAAA,WACG,YAAA,CAAa,MAAA,CAAO,cAAA,IAAkB,MAAA,CAAO,cAAA;;;;;;;;iBAsGhC,UAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,GAEjC,OAAA,EAAS,QAAA,EACT,MAAA,EAAQ,YAAA,CAAa,cAAA,GACrB,OAAA,GAAS,qBAAA,GACR,OAAA,CAAQ,MAAA,CAAO,cAAA;AAAA,UAwJD,qBAAA;EAxRX;;;EA4RJ,WAAW;AAAA;;;;;;;;iBAUS,cAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,GAEjC,OAAA,EAAS,QAAA,EACT,MAAA,EAAQ,YAAA,CAAa,cAAA,GACrB,OAAA,GAAS,qBAAA,GAA0B,OAAA,CAAA,MAAA,CAAA,cAAA"}

package/dist/lib/plugins.d.mts

@@ -1,2 +1,39 @@
-import { i as resolvePlugins, n as initPlugin, r as resolvePlugin, t as ResolvePluginsOptions } from "../plugins-zG2X2LA8.mjs";
-export { ResolvePluginsOptions, initPlugin, resolvePlugin, resolvePlugins };
+import { Plugin } from "../types/plugin.mjs";
+import { EnvironmentContext, ExecutionContext, PluginContext } from "../types/context.mjs";
+import { PluginConfig, ResolvedConfig } from "../types/config.mjs";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region src/lib/plugins.d.ts
+/**
+ * Resolve a plugin module based on the provided plugin path. This function checks if the plugin package is installed, attempts to import the plugin module, and handles various error cases such as missing packages or invalid module exports. It supports both direct plugin exports and plugins exported from a "plugin" subdirectory within the package.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param pluginPath - The path to the plugin module. This can be a package name, a scoped package name, or a path to a local module.
+ * @returns A promise that resolves to the plugin module, which can be a plugin instance, a factory function that returns a plugin, or an array of plugins.
+ */
+declare function resolvePlugin<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, pluginPath: string): Promise<Plugin<TPluginContext> | Plugin<TPluginContext>[] | ((options?: any) => MaybePromise<Plugin<TPluginContext> | Plugin<TPluginContext>[]>)>;
+/**
+ * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, factory functions, string paths to plugins, and arrays of plugins or plugin configurations. It validates the plugin configuration, resolves any plugin paths, and returns an array of initialized plugins.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param config - The plugin configuration, which can be in various forms such as a direct plugin instance, a string path to a plugin, a factory function that returns a plugin, or an array of plugins or plugin configurations. This configuration will be processed and validated to initialize the appropriate plugins.
+ * @returns A promise that resolves to an array of initialized plugins based on the provided configuration. If the configuration is invalid, an error will be thrown with details about the issue.
+ */
+declare function initPlugin<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, config: PluginConfig<TPluginContext>, options?: ResolvePluginsOptions): Promise<Plugin<TPluginContext>[] | null>;
+interface ResolvePluginsOptions {
+  /**
+   * If true, the plugin resolution process will skip logging messages about the plugin initialization. This can be useful in scenarios where you want to suppress plugin-related logs, such as when running in a non-interactive environment or when you want to reduce log verbosity. By default, this option is false, and plugin initialization messages will be logged using the context's logger.
+   */
+  skipLogging?: boolean;
+}
+/**
+ * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, plugin names, factory functions, and arrays of plugins. It validates the configuration, resolves plugin modules if necessary, and returns an array of initialized plugins ready to be added to the execution context.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param config - The plugin configuration, which can be in various forms such as a plugin instance, a plugin name string, a factory function that returns a plugin or an array of plugins, or an array of plugin configurations. The function will handle the resolution and initialization of the plugin(s) based on the provided configuration.
+ * @returns A promise that resolves to an array of initialized plugins that can be added to the execution context, or null if the configuration is invalid or results in no plugins being initialized.
+ */
+declare function resolvePlugins<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, config: PluginConfig<TPluginContext>, options?: ResolvePluginsOptions): Promise<Plugin<TPluginContext>[]>;
+//#endregion
+export { ResolvePluginsOptions, initPlugin, resolvePlugin, resolvePlugins };
+//# sourceMappingURL=plugins.d.mts.map

package/dist/lib/plugins.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.mts","names":[],"sources":["../../src/lib/plugins.ts"],"mappings":";;;;;;;;;;;AAwDA;;iBAAsB,aAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,GAEjC,OAAA,EAAS,QAAA,EACT,UAAA,WACC,OAAA,CACC,MAAA,CAAO,cAAA,IACP,MAAA,CAAO,cAAA,QAEL,OAAA,WACG,YAAA,CAAa,MAAA,CAAO,cAAA,IAAkB,MAAA,CAAO,cAAA;;;;;;;;iBAsGhC,UAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,GAEjC,OAAA,EAAS,QAAA,EACT,MAAA,EAAQ,YAAA,CAAa,cAAA,GACrB,OAAA,GAAS,qBAAA,GACR,OAAA,CAAQ,MAAA,CAAO,cAAA;AAAA,UAwJD,qBAAA;EAxRX;;;EA4RJ,WAAW;AAAA;;;;;;;;iBAUS,cAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,GAEjC,OAAA,EAAS,QAAA,EACT,MAAA,EAAQ,YAAA,CAAa,cAAA,GACrB,OAAA,GAAS,qBAAA,GAA0B,OAAA,CAAA,MAAA,CAAA,cAAA"}

package/dist/lib/plugins.mjs

@@ -131,7 +131,7 @@ async function resolvePlugins(context, config, options = {}) {
 	if (config) {
 		const result = await initPlugin(context, config);
 		if (result) for (const plugin of result) {
-			if (!skipLogging) context.debug({
+			if (!skipLogging) context.trace({
 				meta: { category: "plugins" },
 				message: `Successfully initialized the ${chalk.bold.cyanBright(plugin.name)} plugin`
 			});

package/dist/lib/plugins.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.mjs","names":[],"sources":["../../src/lib/plugins.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 { toArray } from \"@stryke/convert/to-array\";\nimport { install } from \"@stryke/fs/install\";\nimport { isPackageExists } from \"@stryke/fs/package-fns\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { isError } from \"@stryke/type-checks/is-error\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isPromiseLike } from \"@stryke/type-checks/is-promise\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { MaybePromise } from \"@stryke/types/base\";\nimport chalk from \"chalk\";\nimport {\n  findInvalidPluginConfig,\n  isDuplicate,\n  isPlugin,\n  isPluginConfig,\n  isPluginConfigObject,\n  isPluginConfigTuple\n} from \"../plugin-utils\";\nimport type {\n  EnvironmentContext,\n  ExecutionContext,\n  Plugin,\n  PluginConfig,\n  PluginConfigTuple,\n  PluginContext,\n  PluginFactory,\n  ResolvedConfig\n} from \"../types\";\n\n/**\n * Resolve a plugin module based on the provided plugin path. This function checks if the plugin package is installed, attempts to import the plugin module, and handles various error cases such as missing packages or invalid module exports. It supports both direct plugin exports and plugins exported from a \"plugin\" subdirectory within the package.\n *\n * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.\n * @param pluginPath - The path to the plugin module. This can be a package name, a scoped package name, or a path to a local module.\n * @returns A promise that resolves to the plugin module, which can be a plugin instance, a factory function that returns a plugin, or an array of plugins.\n */\nexport async function resolvePlugin<\n  TResolvedConfig extends ResolvedConfig,\n  TSystemContext,\n  TContext extends\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext> =\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext>,\n  TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> =\n    PluginContext<TResolvedConfig, TSystemContext>\n>(\n  context: TContext,\n  pluginPath: string\n): Promise<\n  | Plugin<TPluginContext>\n  | Plugin<TPluginContext>[]\n  | ((\n      options?: any\n    ) => MaybePromise<Plugin<TPluginContext> | Plugin<TPluginContext>[]>)\n> {\n  if (\n    pluginPath.startsWith(\"@\") &&\n    pluginPath.split(\"/\").filter(Boolean).length > 2\n  ) {\n    const splits = pluginPath.split(\"/\").filter(Boolean);\n    pluginPath = `${splits[0]}/${splits[1]}`;\n  }\n\n  const isInstalled = isPackageExists(pluginPath, {\n    paths: [context.config.cwd, context.config.root]\n  });\n  if (!isInstalled && context.config.autoInstall) {\n    context.warn(\n      `The plugin package \"${\n        pluginPath\n      }\" is not installed. It will be installed automatically.`\n    );\n\n    const result = await install(pluginPath, {\n      cwd: context.config.root\n    });\n    if (isNumber(result.exitCode) && result.exitCode > 0) {\n      context.error(result.stderr);\n\n      throw new Error(\n        `An error occurred while installing the build plugin package \"${\n          pluginPath\n        }\" `\n      );\n    }\n  }\n\n  try {\n    // First check if the package has a \"plugin\" subdirectory - @scope/package/plugin\n    const module = await context.resolver.plugin.import<{\n      plugin?:\n        | Plugin<TPluginContext>\n        | ((options?: any) => MaybePromise<Plugin<TPluginContext>>);\n      default?:\n        | Plugin<TPluginContext>\n        | ((options?: any) => MaybePromise<Plugin<TPluginContext>>);\n    }>(context.resolver.plugin.esmResolve(joinPaths(pluginPath, \"plugin\")));\n\n    const result = module.plugin ?? module.default;\n    if (!result) {\n      throw new Error(\n        `The plugin package \"${pluginPath}\" does not export a valid module.`\n      );\n    }\n\n    return result;\n  } catch (error) {\n    try {\n      const module = await context.resolver.plugin.import<{\n        plugin?:\n          | Plugin<TPluginContext>\n          | ((options?: any) => MaybePromise<Plugin<TPluginContext>>);\n        default?:\n          | Plugin<TPluginContext>\n          | ((options?: any) => MaybePromise<Plugin<TPluginContext>>);\n      }>(context.resolver.plugin.esmResolve(pluginPath));\n\n      const result = module.plugin ?? module.default;\n      if (!result) {\n        throw new Error(\n          `The plugin package \"${pluginPath}\" does not export a valid module.`\n        );\n      }\n\n      return result;\n    } catch {\n      if (!isInstalled) {\n        throw new Error(\n          `The plugin package \"${\n            pluginPath\n          }\" is not installed. Please install the package using the command: \"npm install ${\n            pluginPath\n          } --save-dev\"`\n        );\n      } else {\n        throw new Error(\n          `An error occurred while importing the build plugin package \"${\n            pluginPath\n          }\":\n${isError(error) ? error.message : String(error)}\n\nNote: Please ensure the plugin package's default export is a class that extends \\`Plugin\\` with a constructor that excepts a single arguments of type \\`PluginOptions\\`.`\n        );\n      }\n    }\n  }\n}\n\n/**\n * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, factory functions, string paths to plugins, and arrays of plugins or plugin configurations. It validates the plugin configuration, resolves any plugin paths, and returns an array of initialized plugins.\n *\n * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.\n * @param config - The plugin configuration, which can be in various forms such as a direct plugin instance, a string path to a plugin, a factory function that returns a plugin, or an array of plugins or plugin configurations. This configuration will be processed and validated to initialize the appropriate plugins.\n * @returns A promise that resolves to an array of initialized plugins based on the provided configuration. If the configuration is invalid, an error will be thrown with details about the issue.\n */\nexport async function initPlugin<\n  TResolvedConfig extends ResolvedConfig,\n  TSystemContext,\n  TContext extends\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext> =\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext>,\n  TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> =\n    PluginContext<TResolvedConfig, TSystemContext>\n>(\n  context: TContext,\n  config: PluginConfig<TPluginContext>,\n  options: ResolvePluginsOptions = {}\n): Promise<Plugin<TPluginContext>[] | null> {\n  const { skipLogging = false } = options;\n\n  let awaited = config;\n  if (isPromiseLike(config)) {\n    awaited = (await Promise.resolve(\n      config as Promise<any>\n    )) as PluginConfig<TPluginContext>;\n  }\n\n  if (!isPluginConfig<TPluginContext>(awaited)) {\n    const invalid = findInvalidPluginConfig(awaited);\n\n    throw new Error(\n      `Invalid ${\n        invalid && invalid.length > 1 ? \"plugins\" : \"plugin\"\n      } specified in the configuration - ${\n        invalid && invalid.length > 0\n          ? JSON.stringify(awaited)\n          : invalid?.join(\"\\n\\n\")\n      } \\n\\nPlease ensure the value is one of the following: \\n - an instance of \\`Plugin\\` \\n - a plugin name \\n - an object with the \\`plugin\\` and \\`options\\` properties \\n - a tuple array with the plugin and options \\n - a factory function that returns a plugin or array of plugins \\n - an array of plugins or plugin configurations`\n    );\n  }\n\n  let plugins!: Plugin<TPluginContext>[];\n  if (isPlugin<TPluginContext>(awaited)) {\n    plugins = [awaited];\n  } else if (isFunction(awaited)) {\n    plugins = toArray(await Promise.resolve(awaited()));\n  } else if (isString(awaited)) {\n    const resolved = await resolvePlugin<\n      TResolvedConfig,\n      TSystemContext,\n      TContext\n    >(context, awaited);\n    if (isFunction(resolved)) {\n      plugins = toArray(await Promise.resolve(resolved()));\n    } else {\n      plugins = toArray(resolved);\n    }\n  } else if (\n    Array.isArray(awaited) &&\n    (awaited as TPluginContext[]).every(isPlugin<TPluginContext>)\n  ) {\n    plugins = awaited as Plugin<TPluginContext>[];\n  } else if (\n    Array.isArray(awaited) &&\n    (awaited as PluginConfig<TPluginContext>[]).every(\n      isPluginConfig<TPluginContext>\n    )\n  ) {\n    plugins = [];\n    for (const pluginConfig of awaited as PluginConfig<TPluginContext>[]) {\n      const initialized = await initPlugin<\n        TResolvedConfig,\n        TSystemContext,\n        TContext,\n        TPluginContext\n      >(context, pluginConfig);\n      if (initialized) {\n        plugins.push(...initialized);\n      }\n    }\n  } else if (\n    isPluginConfigTuple<TPluginContext>(awaited) ||\n    isPluginConfigObject<TPluginContext>(awaited)\n  ) {\n    let pluginConfig!:\n      | string\n      | PluginFactory<TPluginContext>\n      | Plugin<TPluginContext>;\n    let pluginOptions: any;\n\n    if (isPluginConfigTuple<TPluginContext>(awaited)) {\n      pluginConfig = awaited[0] as Plugin<TPluginContext>;\n      pluginOptions =\n        (awaited as PluginConfigTuple)?.length === 2 ? awaited[1] : undefined;\n    } else {\n      pluginConfig = awaited.plugin as Plugin<TPluginContext>;\n      pluginOptions = awaited.options;\n    }\n\n    if (isSetString(pluginConfig)) {\n      const resolved = await resolvePlugin<\n        TResolvedConfig,\n        TSystemContext,\n        TContext,\n        TPluginContext\n      >(context, pluginConfig);\n      if (isFunction(resolved)) {\n        plugins = toArray(\n          await Promise.resolve(\n            pluginOptions ? resolved(pluginOptions) : resolved()\n          )\n        );\n      } else {\n        plugins = toArray(resolved);\n      }\n    } else if (isFunction(pluginConfig)) {\n      plugins = toArray(await Promise.resolve(pluginConfig(pluginOptions)));\n    } else if (\n      Array.isArray(pluginConfig) &&\n      pluginConfig.every(isPlugin<TPluginContext>)\n    ) {\n      plugins = pluginConfig;\n    } else if (isPlugin<TPluginContext>(pluginConfig)) {\n      plugins = toArray(pluginConfig);\n    }\n  }\n\n  if (!plugins) {\n    throw new Error(\n      `The plugin configuration ${JSON.stringify(awaited)} is invalid. This configuration must point to a valid Powerlines plugin module.`\n    );\n  }\n\n  if (plugins.length > 0 && !plugins.every(isPlugin<TPluginContext>)) {\n    throw new Error(\n      `The plugin option ${JSON.stringify(plugins)} does not export a valid module. This configuration must point to a valid Powerlines plugin module.`\n    );\n  }\n\n  const result = [] as Plugin<TPluginContext>[];\n  for (const plugin of plugins) {\n    if (isDuplicate<TPluginContext>(plugin, context.plugins)) {\n      if (!skipLogging) {\n        context.trace({\n          meta: {\n            category: \"plugins\"\n          },\n          message: `Duplicate ${chalk.bold.cyanBright(\n            plugin.name\n          )} plugin dependency detected - Skipping initialization.`\n        });\n      }\n    } else {\n      result.push(plugin);\n\n      if (!skipLogging) {\n        context.trace({\n          meta: {\n            category: \"plugins\"\n          },\n          message: `Initializing the ${chalk.bold.cyanBright(plugin.name)} plugin...`\n        });\n      }\n    }\n  }\n\n  return result;\n}\n\nexport interface ResolvePluginsOptions {\n  /**\n   * If true, the plugin resolution process will skip logging messages about the plugin initialization. This can be useful in scenarios where you want to suppress plugin-related logs, such as when running in a non-interactive environment or when you want to reduce log verbosity. By default, this option is false, and plugin initialization messages will be logged using the context's logger.\n   */\n  skipLogging?: boolean;\n}\n\n/**\n * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, plugin names, factory functions, and arrays of plugins. It validates the configuration, resolves plugin modules if necessary, and returns an array of initialized plugins ready to be added to the execution context.\n *\n * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.\n * @param config - The plugin configuration, which can be in various forms such as a plugin instance, a plugin name string, a factory function that returns a plugin or an array of plugins, or an array of plugin configurations. The function will handle the resolution and initialization of the plugin(s) based on the provided configuration.\n * @returns A promise that resolves to an array of initialized plugins that can be added to the execution context, or null if the configuration is invalid or results in no plugins being initialized.\n */\nexport async function resolvePlugins<\n  TResolvedConfig extends ResolvedConfig,\n  TSystemContext,\n  TContext extends\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext> =\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext>,\n  TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> =\n    PluginContext<TResolvedConfig, TSystemContext>\n>(\n  context: TContext,\n  config: PluginConfig<TPluginContext>,\n  options: ResolvePluginsOptions = {}\n) {\n  const { skipLogging = false } = options;\n\n  const plugins = [] as Plugin<TPluginContext>[];\n  if (config) {\n    const result = await initPlugin<\n      TResolvedConfig,\n      TSystemContext,\n      TContext,\n      TPluginContext\n    >(context, config);\n    if (result) {\n      for (const plugin of result) {\n        if (!skipLogging) {\n          context.debug({\n            meta: {\n              category: \"plugins\"\n            },\n            message: `Successfully initialized the ${chalk.bold.cyanBright(\n              plugin.name\n            )} plugin`\n          });\n        }\n\n        plugins.push(plugin);\n      }\n    }\n  }\n\n  return plugins;\n}\n"],"mappings":"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"}
+{"version":3,"file":"plugins.mjs","names":[],"sources":["../../src/lib/plugins.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 { toArray } from \"@stryke/convert/to-array\";\nimport { install } from \"@stryke/fs/install\";\nimport { isPackageExists } from \"@stryke/fs/package-fns\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { isError } from \"@stryke/type-checks/is-error\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isPromiseLike } from \"@stryke/type-checks/is-promise\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { MaybePromise } from \"@stryke/types/base\";\nimport chalk from \"chalk\";\nimport {\n  findInvalidPluginConfig,\n  isDuplicate,\n  isPlugin,\n  isPluginConfig,\n  isPluginConfigObject,\n  isPluginConfigTuple\n} from \"../plugin-utils\";\nimport type {\n  EnvironmentContext,\n  ExecutionContext,\n  Plugin,\n  PluginConfig,\n  PluginConfigTuple,\n  PluginContext,\n  PluginFactory,\n  ResolvedConfig\n} from \"../types\";\n\n/**\n * Resolve a plugin module based on the provided plugin path. This function checks if the plugin package is installed, attempts to import the plugin module, and handles various error cases such as missing packages or invalid module exports. It supports both direct plugin exports and plugins exported from a \"plugin\" subdirectory within the package.\n *\n * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.\n * @param pluginPath - The path to the plugin module. This can be a package name, a scoped package name, or a path to a local module.\n * @returns A promise that resolves to the plugin module, which can be a plugin instance, a factory function that returns a plugin, or an array of plugins.\n */\nexport async function resolvePlugin<\n  TResolvedConfig extends ResolvedConfig,\n  TSystemContext,\n  TContext extends\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext> =\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext>,\n  TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> =\n    PluginContext<TResolvedConfig, TSystemContext>\n>(\n  context: TContext,\n  pluginPath: string\n): Promise<\n  | Plugin<TPluginContext>\n  | Plugin<TPluginContext>[]\n  | ((\n      options?: any\n    ) => MaybePromise<Plugin<TPluginContext> | Plugin<TPluginContext>[]>)\n> {\n  if (\n    pluginPath.startsWith(\"@\") &&\n    pluginPath.split(\"/\").filter(Boolean).length > 2\n  ) {\n    const splits = pluginPath.split(\"/\").filter(Boolean);\n    pluginPath = `${splits[0]}/${splits[1]}`;\n  }\n\n  const isInstalled = isPackageExists(pluginPath, {\n    paths: [context.config.cwd, context.config.root]\n  });\n  if (!isInstalled && context.config.autoInstall) {\n    context.warn(\n      `The plugin package \"${\n        pluginPath\n      }\" is not installed. It will be installed automatically.`\n    );\n\n    const result = await install(pluginPath, {\n      cwd: context.config.root\n    });\n    if (isNumber(result.exitCode) && result.exitCode > 0) {\n      context.error(result.stderr);\n\n      throw new Error(\n        `An error occurred while installing the build plugin package \"${\n          pluginPath\n        }\" `\n      );\n    }\n  }\n\n  try {\n    // First check if the package has a \"plugin\" subdirectory - @scope/package/plugin\n    const module = await context.resolver.plugin.import<{\n      plugin?:\n        | Plugin<TPluginContext>\n        | ((options?: any) => MaybePromise<Plugin<TPluginContext>>);\n      default?:\n        | Plugin<TPluginContext>\n        | ((options?: any) => MaybePromise<Plugin<TPluginContext>>);\n    }>(context.resolver.plugin.esmResolve(joinPaths(pluginPath, \"plugin\")));\n\n    const result = module.plugin ?? module.default;\n    if (!result) {\n      throw new Error(\n        `The plugin package \"${pluginPath}\" does not export a valid module.`\n      );\n    }\n\n    return result;\n  } catch (error) {\n    try {\n      const module = await context.resolver.plugin.import<{\n        plugin?:\n          | Plugin<TPluginContext>\n          | ((options?: any) => MaybePromise<Plugin<TPluginContext>>);\n        default?:\n          | Plugin<TPluginContext>\n          | ((options?: any) => MaybePromise<Plugin<TPluginContext>>);\n      }>(context.resolver.plugin.esmResolve(pluginPath));\n\n      const result = module.plugin ?? module.default;\n      if (!result) {\n        throw new Error(\n          `The plugin package \"${pluginPath}\" does not export a valid module.`\n        );\n      }\n\n      return result;\n    } catch {\n      if (!isInstalled) {\n        throw new Error(\n          `The plugin package \"${\n            pluginPath\n          }\" is not installed. Please install the package using the command: \"npm install ${\n            pluginPath\n          } --save-dev\"`\n        );\n      } else {\n        throw new Error(\n          `An error occurred while importing the build plugin package \"${\n            pluginPath\n          }\":\n${isError(error) ? error.message : String(error)}\n\nNote: Please ensure the plugin package's default export is a class that extends \\`Plugin\\` with a constructor that excepts a single arguments of type \\`PluginOptions\\`.`\n        );\n      }\n    }\n  }\n}\n\n/**\n * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, factory functions, string paths to plugins, and arrays of plugins or plugin configurations. It validates the plugin configuration, resolves any plugin paths, and returns an array of initialized plugins.\n *\n * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.\n * @param config - The plugin configuration, which can be in various forms such as a direct plugin instance, a string path to a plugin, a factory function that returns a plugin, or an array of plugins or plugin configurations. This configuration will be processed and validated to initialize the appropriate plugins.\n * @returns A promise that resolves to an array of initialized plugins based on the provided configuration. If the configuration is invalid, an error will be thrown with details about the issue.\n */\nexport async function initPlugin<\n  TResolvedConfig extends ResolvedConfig,\n  TSystemContext,\n  TContext extends\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext> =\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext>,\n  TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> =\n    PluginContext<TResolvedConfig, TSystemContext>\n>(\n  context: TContext,\n  config: PluginConfig<TPluginContext>,\n  options: ResolvePluginsOptions = {}\n): Promise<Plugin<TPluginContext>[] | null> {\n  const { skipLogging = false } = options;\n\n  let awaited = config;\n  if (isPromiseLike(config)) {\n    awaited = (await Promise.resolve(\n      config as Promise<any>\n    )) as PluginConfig<TPluginContext>;\n  }\n\n  if (!isPluginConfig<TPluginContext>(awaited)) {\n    const invalid = findInvalidPluginConfig(awaited);\n\n    throw new Error(\n      `Invalid ${\n        invalid && invalid.length > 1 ? \"plugins\" : \"plugin\"\n      } specified in the configuration - ${\n        invalid && invalid.length > 0\n          ? JSON.stringify(awaited)\n          : invalid?.join(\"\\n\\n\")\n      } \\n\\nPlease ensure the value is one of the following: \\n - an instance of \\`Plugin\\` \\n - a plugin name \\n - an object with the \\`plugin\\` and \\`options\\` properties \\n - a tuple array with the plugin and options \\n - a factory function that returns a plugin or array of plugins \\n - an array of plugins or plugin configurations`\n    );\n  }\n\n  let plugins!: Plugin<TPluginContext>[];\n  if (isPlugin<TPluginContext>(awaited)) {\n    plugins = [awaited];\n  } else if (isFunction(awaited)) {\n    plugins = toArray(await Promise.resolve(awaited()));\n  } else if (isString(awaited)) {\n    const resolved = await resolvePlugin<\n      TResolvedConfig,\n      TSystemContext,\n      TContext\n    >(context, awaited);\n    if (isFunction(resolved)) {\n      plugins = toArray(await Promise.resolve(resolved()));\n    } else {\n      plugins = toArray(resolved);\n    }\n  } else if (\n    Array.isArray(awaited) &&\n    (awaited as TPluginContext[]).every(isPlugin<TPluginContext>)\n  ) {\n    plugins = awaited as Plugin<TPluginContext>[];\n  } else if (\n    Array.isArray(awaited) &&\n    (awaited as PluginConfig<TPluginContext>[]).every(\n      isPluginConfig<TPluginContext>\n    )\n  ) {\n    plugins = [];\n    for (const pluginConfig of awaited as PluginConfig<TPluginContext>[]) {\n      const initialized = await initPlugin<\n        TResolvedConfig,\n        TSystemContext,\n        TContext,\n        TPluginContext\n      >(context, pluginConfig);\n      if (initialized) {\n        plugins.push(...initialized);\n      }\n    }\n  } else if (\n    isPluginConfigTuple<TPluginContext>(awaited) ||\n    isPluginConfigObject<TPluginContext>(awaited)\n  ) {\n    let pluginConfig!:\n      | string\n      | PluginFactory<TPluginContext>\n      | Plugin<TPluginContext>;\n    let pluginOptions: any;\n\n    if (isPluginConfigTuple<TPluginContext>(awaited)) {\n      pluginConfig = awaited[0] as Plugin<TPluginContext>;\n      pluginOptions =\n        (awaited as PluginConfigTuple)?.length === 2 ? awaited[1] : undefined;\n    } else {\n      pluginConfig = awaited.plugin as Plugin<TPluginContext>;\n      pluginOptions = awaited.options;\n    }\n\n    if (isSetString(pluginConfig)) {\n      const resolved = await resolvePlugin<\n        TResolvedConfig,\n        TSystemContext,\n        TContext,\n        TPluginContext\n      >(context, pluginConfig);\n      if (isFunction(resolved)) {\n        plugins = toArray(\n          await Promise.resolve(\n            pluginOptions ? resolved(pluginOptions) : resolved()\n          )\n        );\n      } else {\n        plugins = toArray(resolved);\n      }\n    } else if (isFunction(pluginConfig)) {\n      plugins = toArray(await Promise.resolve(pluginConfig(pluginOptions)));\n    } else if (\n      Array.isArray(pluginConfig) &&\n      pluginConfig.every(isPlugin<TPluginContext>)\n    ) {\n      plugins = pluginConfig;\n    } else if (isPlugin<TPluginContext>(pluginConfig)) {\n      plugins = toArray(pluginConfig);\n    }\n  }\n\n  if (!plugins) {\n    throw new Error(\n      `The plugin configuration ${JSON.stringify(awaited)} is invalid. This configuration must point to a valid Powerlines plugin module.`\n    );\n  }\n\n  if (plugins.length > 0 && !plugins.every(isPlugin<TPluginContext>)) {\n    throw new Error(\n      `The plugin option ${JSON.stringify(plugins)} does not export a valid module. This configuration must point to a valid Powerlines plugin module.`\n    );\n  }\n\n  const result = [] as Plugin<TPluginContext>[];\n  for (const plugin of plugins) {\n    if (isDuplicate<TPluginContext>(plugin, context.plugins)) {\n      if (!skipLogging) {\n        context.trace({\n          meta: {\n            category: \"plugins\"\n          },\n          message: `Duplicate ${chalk.bold.cyanBright(\n            plugin.name\n          )} plugin dependency detected - Skipping initialization.`\n        });\n      }\n    } else {\n      result.push(plugin);\n\n      if (!skipLogging) {\n        context.trace({\n          meta: {\n            category: \"plugins\"\n          },\n          message: `Initializing the ${chalk.bold.cyanBright(plugin.name)} plugin...`\n        });\n      }\n    }\n  }\n\n  return result;\n}\n\nexport interface ResolvePluginsOptions {\n  /**\n   * If true, the plugin resolution process will skip logging messages about the plugin initialization. This can be useful in scenarios where you want to suppress plugin-related logs, such as when running in a non-interactive environment or when you want to reduce log verbosity. By default, this option is false, and plugin initialization messages will be logged using the context's logger.\n   */\n  skipLogging?: boolean;\n}\n\n/**\n * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, plugin names, factory functions, and arrays of plugins. It validates the configuration, resolves plugin modules if necessary, and returns an array of initialized plugins ready to be added to the execution context.\n *\n * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.\n * @param config - The plugin configuration, which can be in various forms such as a plugin instance, a plugin name string, a factory function that returns a plugin or an array of plugins, or an array of plugin configurations. The function will handle the resolution and initialization of the plugin(s) based on the provided configuration.\n * @returns A promise that resolves to an array of initialized plugins that can be added to the execution context, or null if the configuration is invalid or results in no plugins being initialized.\n */\nexport async function resolvePlugins<\n  TResolvedConfig extends ResolvedConfig,\n  TSystemContext,\n  TContext extends\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext> =\n    | EnvironmentContext<TResolvedConfig, TSystemContext>\n    | ExecutionContext<TResolvedConfig, TSystemContext>,\n  TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> =\n    PluginContext<TResolvedConfig, TSystemContext>\n>(\n  context: TContext,\n  config: PluginConfig<TPluginContext>,\n  options: ResolvePluginsOptions = {}\n) {\n  const { skipLogging = false } = options;\n\n  const plugins = [] as Plugin<TPluginContext>[];\n  if (config) {\n    const result = await initPlugin<\n      TResolvedConfig,\n      TSystemContext,\n      TContext,\n      TPluginContext\n    >(context, config);\n    if (result) {\n      for (const plugin of result) {\n        if (!skipLogging) {\n          context.trace({\n            meta: {\n              category: \"plugins\"\n            },\n            message: `Successfully initialized the ${chalk.bold.cyanBright(\n              plugin.name\n            )} plugin`\n          });\n        }\n\n        plugins.push(plugin);\n      }\n    }\n  }\n\n  return plugins;\n}\n"],"mappings":"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"}

package/dist/lib/resolver.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../chunk-C_NdSu1c.cjs');
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 let _stryke_path_join_paths = require("@stryke/path/join-paths");
 let defu = require("defu");
-defu = require_chunk.__toESM(defu, 1);
+defu = require_runtime.__toESM(defu, 1);
 let jiti = require("jiti");
 
 //#region src/lib/resolver.ts

package/dist/lib/resolver.d.cts

@@ -1,2 +1,20 @@
-import { n as createResolver, t as CreateResolverOptions } from "../resolver-CfCl--Eh.cjs";
-export { CreateResolverOptions, createResolver };
+import { Resolver } from "../types/context.cjs";
+import { ResolvedConfig } from "../types/config.cjs";
+import { JitiOptions } from "jiti";
+
+//#region src/lib/resolver.d.ts
+type CreateResolverOptions = Omit<JitiOptions, "fsCache" | "moduleCache" | "interopDefault"> & Partial<Pick<ResolvedConfig, "mode" | "skipCache">> & {
+  cwd: string;
+  root: string;
+  cacheDir: string;
+};
+/**
+ * Create a Jiti resolver for the given workspace and project root.
+ *
+ * @param options - The options for creating the resolver.
+ * @returns A Jiti instance configured for the specified workspace and project root.
+ */
+declare function createResolver(options: CreateResolverOptions): Resolver;
+//#endregion
+export { CreateResolverOptions, createResolver };
+//# sourceMappingURL=resolver.d.cts.map

package/dist/lib/resolver.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.cts","names":[],"sources":["../../src/lib/resolver.ts"],"mappings":";;;;;KAwBY,qBAAA,GAAwB,IAAA,CAClC,WAAA,kDAGA,OAAA,CAAQ,IAAA,CAAK,cAAA;EACX,GAAA;EACA,IAAA;EACA,QAAA;AAAA;;;;;;;iBA0BY,cAAA,CAAe,OAAA,EAAS,qBAAA,GAAwB,QAAQ"}

package/dist/lib/resolver.d.mts

@@ -1,2 +1,20 @@
-import { n as createResolver, t as CreateResolverOptions } from "../resolver-CdBAh8dA.mjs";
-export { CreateResolverOptions, createResolver };
+import { Resolver } from "../types/context.mjs";
+import { ResolvedConfig } from "../types/config.mjs";
+import { JitiOptions } from "jiti";
+
+//#region src/lib/resolver.d.ts
+type CreateResolverOptions = Omit<JitiOptions, "fsCache" | "moduleCache" | "interopDefault"> & Partial<Pick<ResolvedConfig, "mode" | "skipCache">> & {
+  cwd: string;
+  root: string;
+  cacheDir: string;
+};
+/**
+ * Create a Jiti resolver for the given workspace and project root.
+ *
+ * @param options - The options for creating the resolver.
+ * @returns A Jiti instance configured for the specified workspace and project root.
+ */
+declare function createResolver(options: CreateResolverOptions): Resolver;
+//#endregion
+export { CreateResolverOptions, createResolver };
+//# sourceMappingURL=resolver.d.mts.map

package/dist/lib/resolver.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.mts","names":[],"sources":["../../src/lib/resolver.ts"],"mappings":";;;;;KAwBY,qBAAA,GAAwB,IAAA,CAClC,WAAA,kDAGA,OAAA,CAAQ,IAAA,CAAK,cAAA;EACX,GAAA;EACA,IAAA;EACA,QAAA;AAAA;;;;;;;iBA0BY,cAAA,CAAe,OAAA,EAAS,qBAAA,GAAwB,QAAQ"}

package/dist/lib/schemas.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_fs = require('../fs-C2lru696.cjs');
+const require_fs = require('../schemas/fs.cjs');
 
 exports.FileId = require_fs.FileId;
 exports.FileMetadata = require_fs.FileMetadata;

package/dist/lib/schemas.d.cts

@@ -1,2 +1,2 @@
-import { a as FileSystem, i as FileStorage, n as FileMetadata, o as _capnpFileId, r as FileMetadata_KeyValuePair, t as FileId } from "../schemas-Zvqwdrw_.cjs";
+import { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, _capnpFileId } from "../schemas/fs.cjs";
 export { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, _capnpFileId };

package/dist/lib/schemas.d.mts

@@ -1,2 +1,2 @@
-import { a as FileSystem, i as FileStorage, n as FileMetadata, o as _capnpFileId, r as FileMetadata_KeyValuePair, t as FileId } from "../schemas-Zvqwdrw_.mjs";
+import { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, _capnpFileId } from "../schemas/fs.mjs";
 export { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, _capnpFileId };

package/dist/lib/schemas.mjs

@@ -1,3 +1,3 @@
-import { a as FileSystem, i as FileStorage, n as FileMetadata, o as _capnpFileId, r as FileMetadata_KeyValuePair, t as FileId } from "../fs-DqLn15uU.mjs";
+import { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, _capnpFileId } from "../schemas/fs.mjs";
 
 export { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, _capnpFileId };

package/dist/lib/streaming-channel.d.cts

@@ -1,2 +1,126 @@
-import { a as StreamReader, c as createStreamReader, i as StreamErrorPayload, l as createStreamSink, n as CreateStreamReaderOptions, o as StreamSink, r as CreateStreamSinkOptions, s as StreamSinkEvents, t as BufferedChunk } from "../streaming-channel-CiyFd_6l.cjs";
-export { BufferedChunk, CreateStreamReaderOptions, CreateStreamSinkOptions, StreamErrorPayload, StreamReader, StreamSink, StreamSinkEvents, createStreamReader, createStreamSink };
+import { EventEmitter } from "devframe/types";
+
+//#region src/lib/streaming-channel.d.ts
+/**
+ * Serialized error shape sent over the wire when a stream ends with a failure.
+ * Stays JSON-safe so the strict-JSON encoder can carry it without coercion.
+ */
+interface StreamErrorPayload {
+  name: string;
+  message: string;
+}
+/**
+ * Single buffered chunk in the server-side ring buffer.
+ *
+ * Sequence numbers start at 1 and increment per write. Subscribers track
+ * `lastSeenSeq` and ask for `afterSeq` on resubscribe so the server can
+ * replay any chunks the client missed during a brief disconnect.
+ */
+interface BufferedChunk<T> {
+  seq: number;
+  chunk: T;
+}
+interface StreamSinkEvents<T> {
+  /** Fired for each `write()`. The RPC layer subscribes and broadcasts. */
+  chunk: (seq: number, chunk: T) => void;
+  /** Terminal — fired exactly once per sink lifetime. */
+  end: (error?: StreamErrorPayload) => void;
+}
+interface CreateStreamSinkOptions {
+  id?: string;
+  /**
+   * Size of the per-stream ring buffer kept for replay-on-resubscribe.
+   * `0` (default) disables replay.
+   */
+  replayWindow?: number;
+}
+/**
+ * Server-side producer handle. Two equivalent surfaces share one piece of
+ * state: the imperative `write/error/close` triple, and a `WritableStream<T>`
+ * for `pipeTo`-style consumption.
+ */
+interface StreamSink<T> {
+  /** Stable id used by clients to subscribe. */
+  readonly id: string;
+  /**
+   * Aborts when the consumer cancels (server-side) or when the transport
+   * loses every subscriber. Producers should poll `signal.aborted` and exit
+   * cleanly.
+   */
+  readonly signal: AbortSignal;
+  /** `true` after `close()` / `error()`. Further writes throw. */
+  readonly closed: boolean;
+  /** Last allocated sequence number. `0` until the first write. */
+  readonly lastSeq: number;
+  write: (chunk: T) => void;
+  error: (reason: unknown) => void;
+  close: () => void;
+  /** External-cancel path. Aborts the signal so handlers can short-circuit. */
+  abort: (reason?: unknown) => void;
+  /** `WritableStream<T>` adapter — same in-memory state as the imperative API. */
+  readonly writable: WritableStream<T>;
+  /**
+   * Internal — RPC layer subscribes to receive chunk/end notifications.
+   * Not part of the public contract; do not call directly.
+   *
+   * @internal
+   */
+  readonly events: EventEmitter<StreamSinkEvents<T>>;
+  /**
+   * Internal — replay buffer. RPC layer reads on (re)subscribe to feed
+   * missed chunks before going live.
+   *
+   * @internal
+   */
+  readonly buffer: ReadonlyArray<BufferedChunk<T>>;
+}
+interface CreateStreamReaderOptions {
+  id?: string;
+  /**
+   * Maximum number of buffered chunks held client-side while the consumer
+   * isn't draining. On overflow, the oldest chunk is dropped.
+   */
+  highWaterMark?: number;
+  /**
+   * Called when the chunk queue overflows the high-water mark. The RPC
+   * layer wires this to a coded warning; the primitive itself is
+   * RPC-agnostic.
+   */
+  onOverflow?: (dropped: number) => void;
+  /** Called when the consumer cancels — the RPC layer sends `:cancel` upstream. */
+  onCancel?: () => void;
+}
+/**
+ * Client-side consumer handle. Both an `AsyncIterable<T>` (for `for await`)
+ * and exposes `readable: ReadableStream<T>` (for `pipeTo`). Pick one — they
+ * share a single internal queue, so concurrent draining will race.
+ */
+interface StreamReader<T> extends AsyncIterable<T> {
+  readonly id: string;
+  readonly cancelled: boolean;
+  readonly done: boolean;
+  /** Highest `seq` observed. Used for replay on reconnect. */
+  readonly lastSeenSeq: number;
+  /** `ReadableStream<T>` adapter for `pipeTo`-style consumption. */
+  readonly readable: ReadableStream<T>;
+  cancel: () => void;
+  /** @internal */
+  _push: (seq: number, chunk: T) => void;
+  /** @internal */
+  _end: (error?: StreamErrorPayload) => void;
+}
+/**
+ * Build a server-side stream sink. RPC-agnostic — the RPC host wires
+ * `events.on('chunk' | 'end')` to broadcast, and reads `buffer` to replay
+ * for late or reconnecting subscribers.
+ */
+declare function createStreamSink<T>(options?: CreateStreamSinkOptions): StreamSink<T>;
+/**
+ * Build a client-side stream reader. RPC-agnostic — the RPC host calls
+ * `_push(seq, chunk)` on each incoming chunk and `_end(error?)` on the
+ * terminal frame. Consumers iterate with `for await` or pipe `readable`.
+ */
+declare function createStreamReader<T>(options?: CreateStreamReaderOptions): StreamReader<T>;
+//#endregion
+export { BufferedChunk, CreateStreamReaderOptions, CreateStreamSinkOptions, StreamErrorPayload, StreamReader, StreamSink, StreamSinkEvents, createStreamReader, createStreamSink };
+//# sourceMappingURL=streaming-channel.d.cts.map

package/dist/lib/streaming-channel.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-channel.d.cts","names":[],"sources":["../../src/lib/streaming-channel.ts"],"mappings":";;;;;AA0BA;;UAAiB,kBAAA;EACf,IAAA;EACA,OAAO;AAAA;;;;;;;;UAUQ,aAAA;EACf,GAAA;EACA,KAAA,EAAO,CAAC;AAAA;AAAA,UAGO,gBAAA;EAIiB;EAFhC,KAAA,GAAQ,GAAA,UAAa,KAAA,EAAO,CAAA;EAA5B;EAEA,GAAA,GAAM,KAAA,GAAQ,kBAAkB;AAAA;AAAA,UAGjB,uBAAA;EACf,EAAA;EAJc;;;AAAkB;EAShC,YAAY;AAAA;;;AAAA;AAQd;;UAAiB,UAAA;EAQE;EAAA,SANR,EAAA;EAmByB;;;;;EAAA,SAbzB,MAAA,EAAQ,WAAA;EA6Bc;EAAA,SA3BtB,MAAA;EA2BqB;EAAA,SAzBrB,OAAA;EAET,KAAA,GAAQ,KAAA,EAAO,CAAA;EACf,KAAA,GAAQ,MAAA;EACR,KAAA;EARiB;EAUjB,KAAA,GAAQ,MAAA;EANC;EAAA,SASA,QAAA,EAAU,cAAA,CAAe,CAAA;EAPnB;;;;;;EAAA,SAeN,MAAA,EAAQ,YAAA,CAAa,gBAAA,CAAiB,CAAA;EARtC;;;;;;EAAA,SAgBA,MAAA,EAAQ,aAAA,CAAc,aAAA,CAAc,CAAA;AAAA;AAAA,UAG9B,yBAAA;EACf,EAAA;EAJ6C;;AAAC;AAGhD;EAME,aAAA;;;;;;EAMA,UAAA,IAAc,OAAA;EAEd;EAAA,QAAA;AAAA;AAQF;;;;;AAAA,UAAiB,YAAA,YAAwB,aAAA,CAAc,CAAA;EAAA,SAC5C,EAAA;EAAA,SACA,SAAA;EAAA,SACA,IAAA;EAH2C;EAAA,SAK3C,WAAA;EALmB;EAAA,SAOnB,QAAA,EAAU,cAAA,CAAe,CAAA;EAElC,MAAA;EARS;EAWT,KAAA,GAAQ,GAAA,UAAa,KAAA,EAAO,CAAA;EATnB;EAWT,IAAA,GAAO,KAAA,GAAQ,kBAAA;AAAA;;;;;;iBAcD,gBAAA,IACd,OAAA,GAAS,uBAAA,GACR,UAAA,CAAW,CAAA;;;;;;iBA+EE,kBAAA,IACd,OAAA,GAAS,yBAAA,GACR,YAAA,CAAa,CAAA"}