@powerlines/core 0.15.0 → 0.15.2

package/dist/constants/log-level.d.mts

@@ -0,0 +1,63 @@
+//#region src/constants/log-level.d.ts
+declare const LogLevels: {
+  readonly SILENT: "silent";
+  readonly ERROR: "error";
+  readonly WARN: "warn";
+  readonly INFO: "info";
+  readonly DEBUG: "debug";
+  readonly TRACE: "trace";
+};
+declare const LOG_LEVELS: readonly ["silent", "error", "warn", "info", "debug", "trace"];
+declare const LogCategories: {
+  readonly GENERAL: "general";
+  readonly FS: "fs";
+  readonly PERFORMANCE: "performance";
+  readonly CONFIG: "config";
+  readonly PLUGINS: "plugins";
+  readonly HOOKS: "hooks";
+  readonly ENV: "env";
+  readonly RPC: "rpc";
+  readonly BABEL: "babel";
+  readonly COMMUNICATION: "communication";
+};
+declare const LOG_CATEGORIES_ARRAY: ("plugins" | "general" | "fs" | "performance" | "config" | "hooks" | "env" | "rpc" | "babel" | "communication")[];
+declare const LOG_CATEGORIES: readonly ["general", "fs", "performance", "config", "plugins", "hooks", "env", "rpc", "communication", "babel"];
+declare const DEFAULT_DEVELOPMENT_LOG_LEVEL: {
+  readonly general: "debug";
+  readonly fs: "info";
+  readonly config: "warn";
+  readonly plugins: "debug";
+  readonly hooks: "debug";
+  readonly performance: "debug";
+  readonly env: "info";
+  readonly rpc: "info";
+  readonly communication: "debug";
+  readonly babel: "debug";
+};
+declare const DEFAULT_TEST_LOG_LEVEL: {
+  readonly general: "info";
+  readonly fs: "warn";
+  readonly config: "warn";
+  readonly plugins: "warn";
+  readonly hooks: "warn";
+  readonly performance: "info";
+  readonly env: "warn";
+  readonly rpc: "warn";
+  readonly communication: "warn";
+  readonly babel: "warn";
+};
+declare const DEFAULT_PRODUCTION_LOG_LEVEL: {
+  readonly general: "warn";
+  readonly fs: "error";
+  readonly config: "error";
+  readonly plugins: "warn";
+  readonly hooks: "warn";
+  readonly performance: "info";
+  readonly env: "error";
+  readonly rpc: "error";
+  readonly communication: "error";
+  readonly babel: "warn";
+};
+//#endregion
+export { DEFAULT_DEVELOPMENT_LOG_LEVEL, DEFAULT_PRODUCTION_LOG_LEVEL, DEFAULT_TEST_LOG_LEVEL, LOG_CATEGORIES, LOG_CATEGORIES_ARRAY, LOG_LEVELS, LogCategories, LogLevels };
+//# sourceMappingURL=log-level.d.mts.map

package/dist/constants/log-level.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level.d.mts","names":[],"sources":["../../src/constants/log-level.ts"],"mappings":";cAkBa,SAAA;EAAA;;;;;;;cASA,UAAA;AAAA,cASA,aAAA;EAAA;;;;;;;;;;;cAaA,oBAAA;AAAA,cAEA,cAAA;AAAA,cAaA,6BAAA;EAAA;;;;;;;;;;;cAaA,sBAAA;EAAA;;;;;;;;;;;cAaA,4BAAA;EAAA"}

package/dist/constants/log-level.mjs

@@ -0,0 +1,82 @@
+//#region src/constants/log-level.ts
+const LogLevels = {
+	SILENT: "silent",
+	ERROR: "error",
+	WARN: "warn",
+	INFO: "info",
+	DEBUG: "debug",
+	TRACE: "trace"
+};
+const LOG_LEVELS = [
+	LogLevels.SILENT,
+	LogLevels.ERROR,
+	LogLevels.WARN,
+	LogLevels.INFO,
+	LogLevels.DEBUG,
+	LogLevels.TRACE
+];
+const LogCategories = {
+	GENERAL: "general",
+	FS: "fs",
+	PERFORMANCE: "performance",
+	CONFIG: "config",
+	PLUGINS: "plugins",
+	HOOKS: "hooks",
+	ENV: "env",
+	RPC: "rpc",
+	BABEL: "babel",
+	COMMUNICATION: "communication"
+};
+const LOG_CATEGORIES_ARRAY = Object.values(LogCategories);
+const LOG_CATEGORIES = [
+	LogCategories.GENERAL,
+	LogCategories.FS,
+	LogCategories.PERFORMANCE,
+	LogCategories.CONFIG,
+	LogCategories.PLUGINS,
+	LogCategories.HOOKS,
+	LogCategories.ENV,
+	LogCategories.RPC,
+	LogCategories.COMMUNICATION,
+	LogCategories.BABEL
+];
+const DEFAULT_DEVELOPMENT_LOG_LEVEL = {
+	general: "debug",
+	fs: "info",
+	config: "warn",
+	plugins: "debug",
+	hooks: "debug",
+	performance: "debug",
+	env: "info",
+	rpc: "info",
+	communication: "debug",
+	babel: "debug"
+};
+const DEFAULT_TEST_LOG_LEVEL = {
+	general: "info",
+	fs: "warn",
+	config: "warn",
+	plugins: "warn",
+	hooks: "warn",
+	performance: "info",
+	env: "warn",
+	rpc: "warn",
+	communication: "warn",
+	babel: "warn"
+};
+const DEFAULT_PRODUCTION_LOG_LEVEL = {
+	general: "warn",
+	fs: "error",
+	config: "error",
+	plugins: "warn",
+	hooks: "warn",
+	performance: "info",
+	env: "error",
+	rpc: "error",
+	communication: "error",
+	babel: "warn"
+};
+
+//#endregion
+export { DEFAULT_DEVELOPMENT_LOG_LEVEL, DEFAULT_PRODUCTION_LOG_LEVEL, DEFAULT_TEST_LOG_LEVEL, LOG_CATEGORIES, LOG_CATEGORIES_ARRAY, LOG_LEVELS, LogCategories, LogLevels };
+//# sourceMappingURL=log-level.mjs.map

package/dist/constants/log-level.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level.mjs","names":[],"sources":["../../src/constants/log-level.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\nexport const LogLevels = {\n  SILENT: \"silent\",\n  ERROR: \"error\",\n  WARN: \"warn\",\n  INFO: \"info\",\n  DEBUG: \"debug\",\n  TRACE: \"trace\"\n} as const;\n\nexport const LOG_LEVELS = [\n  LogLevels.SILENT,\n  LogLevels.ERROR,\n  LogLevels.WARN,\n  LogLevels.INFO,\n  LogLevels.DEBUG,\n  LogLevels.TRACE\n] as const;\n\nexport const LogCategories = {\n  GENERAL: \"general\",\n  FS: \"fs\",\n  PERFORMANCE: \"performance\",\n  CONFIG: \"config\",\n  PLUGINS: \"plugins\",\n  HOOKS: \"hooks\",\n  ENV: \"env\",\n  RPC: \"rpc\",\n  BABEL: \"babel\",\n  COMMUNICATION: \"communication\"\n} as const;\n\nexport const LOG_CATEGORIES_ARRAY = Object.values(LogCategories);\n\nexport const LOG_CATEGORIES = [\n  LogCategories.GENERAL,\n  LogCategories.FS,\n  LogCategories.PERFORMANCE,\n  LogCategories.CONFIG,\n  LogCategories.PLUGINS,\n  LogCategories.HOOKS,\n  LogCategories.ENV,\n  LogCategories.RPC,\n  LogCategories.COMMUNICATION,\n  LogCategories.BABEL\n] as const;\n\nexport const DEFAULT_DEVELOPMENT_LOG_LEVEL = {\n  general: \"debug\",\n  fs: \"info\",\n  config: \"warn\",\n  plugins: \"debug\",\n  hooks: \"debug\",\n  performance: \"debug\",\n  env: \"info\",\n  rpc: \"info\",\n  communication: \"debug\",\n  babel: \"debug\"\n} as const;\n\nexport const DEFAULT_TEST_LOG_LEVEL = {\n  general: \"info\",\n  fs: \"warn\",\n  config: \"warn\",\n  plugins: \"warn\",\n  hooks: \"warn\",\n  performance: \"info\",\n  env: \"warn\",\n  rpc: \"warn\",\n  communication: \"warn\",\n  babel: \"warn\"\n} as const;\n\nexport const DEFAULT_PRODUCTION_LOG_LEVEL = {\n  general: \"warn\",\n  fs: \"error\",\n  config: \"error\",\n  plugins: \"warn\",\n  hooks: \"warn\",\n  performance: \"info\",\n  env: \"error\",\n  rpc: \"error\",\n  communication: \"error\",\n  babel: \"warn\"\n} as const;\n"],"mappings":";AAkBA,MAAa,YAAY;CACvB,QAAQ;CACR,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACR;AAED,MAAa,aAAa;CACxB,UAAU;CACV,UAAU;CACV,UAAU;CACV,UAAU;CACV,UAAU;CACV,UAAU;CACX;AAED,MAAa,gBAAgB;CAC3B,SAAS;CACT,IAAI;CACJ,aAAa;CACb,QAAQ;CACR,SAAS;CACT,OAAO;CACP,KAAK;CACL,KAAK;CACL,OAAO;CACP,eAAe;CAChB;AAED,MAAa,uBAAuB,OAAO,OAAO,cAAc;AAEhE,MAAa,iBAAiB;CAC5B,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACf;AAED,MAAa,gCAAgC;CAC3C,SAAS;CACT,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,OAAO;CACP,aAAa;CACb,KAAK;CACL,KAAK;CACL,eAAe;CACf,OAAO;CACR;AAED,MAAa,yBAAyB;CACpC,SAAS;CACT,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,OAAO;CACP,aAAa;CACb,KAAK;CACL,KAAK;CACL,eAAe;CACf,OAAO;CACR;AAED,MAAa,+BAA+B;CAC1C,SAAS;CACT,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,OAAO;CACP,aAAa;CACb,KAAK;CACL,KAAK;CACL,eAAe;CACf,OAAO;CACR"}

package/dist/constants/meta.cjs

@@ -1,3 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 //#region src/constants/meta.ts
 const ROOT_HASH_LENGTH = 45;

package/dist/constants/plugin.cjs

@@ -1,4 +1,5 @@
-const require_commands = require('./commands.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_constants_commands = require('./commands.cjs');
 
 //#region src/constants/plugin.ts
 const UNPLUGIN_BUILDER_VARIANTS = [
@@ -26,7 +27,7 @@ const PLUGIN_NON_HOOK_FIELDS = [
 	"applyToEnvironment"
 ];
 const PLUGIN_HOOKS_FIELDS = [
-	...require_commands.SUPPORTED_COMMANDS,
+	...require_constants_commands.SUPPORTED_COMMANDS,
 	"config",
 	"configEnvironment",
 	"configResolved",

package/dist/constants/plugin.d.cts

@@ -2,8 +2,8 @@
 declare const UNPLUGIN_BUILDER_VARIANTS: readonly ["rollup", "webpack", "rspack", "vite", "esbuild", "farm", "unloader", "rolldown", "bun"];
 declare const BUILDER_VARIANTS: readonly ["rollup", "webpack", "rspack", "vite", "esbuild", "farm", "unloader", "rolldown", "bun", "tsup", "tsdown", "unbuild"];
 declare const PLUGIN_NON_HOOK_FIELDS: readonly ["name", "api", "enforce", "dedupe", "applyToEnvironment"];
-declare const PLUGIN_HOOKS_FIELDS: readonly ["types", "new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize", "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle"];
-declare const KNOWN_PLUGIN_FIELDS: readonly ["name", "api", "enforce", "dedupe", "applyToEnvironment", "types", "new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize", "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle", "rollup", "webpack", "rspack", "vite", "esbuild", "farm", "unloader", "rolldown", "bun", "tsup", "tsdown", "unbuild"];
+declare const PLUGIN_HOOKS_FIELDS: readonly [...string[], "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle"];
+declare const KNOWN_PLUGIN_FIELDS: readonly ["name", "api", "enforce", "dedupe", "applyToEnvironment", ...string[], "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle", "rollup", "webpack", "rspack", "vite", "esbuild", "farm", "unloader", "rolldown", "bun", "tsup", "tsdown", "unbuild"];
 //#endregion
 export { BUILDER_VARIANTS, KNOWN_PLUGIN_FIELDS, PLUGIN_HOOKS_FIELDS, PLUGIN_NON_HOOK_FIELDS, UNPLUGIN_BUILDER_VARIANTS };
 //# sourceMappingURL=plugin.d.cts.map

package/dist/constants/plugin.d.mts

@@ -2,8 +2,8 @@
 declare const UNPLUGIN_BUILDER_VARIANTS: readonly ["rollup", "webpack", "rspack", "vite", "esbuild", "farm", "unloader", "rolldown", "bun"];
 declare const BUILDER_VARIANTS: readonly ["rollup", "webpack", "rspack", "vite", "esbuild", "farm", "unloader", "rolldown", "bun", "tsup", "tsdown", "unbuild"];
 declare const PLUGIN_NON_HOOK_FIELDS: readonly ["name", "api", "enforce", "dedupe", "applyToEnvironment"];
-declare const PLUGIN_HOOKS_FIELDS: readonly ["types", "new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize", "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle"];
-declare const KNOWN_PLUGIN_FIELDS: readonly ["name", "api", "enforce", "dedupe", "applyToEnvironment", "types", "new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize", "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle", "rollup", "webpack", "rspack", "vite", "esbuild", "farm", "unloader", "rolldown", "bun", "tsup", "tsdown", "unbuild"];
+declare const PLUGIN_HOOKS_FIELDS: readonly [...string[], "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle"];
+declare const KNOWN_PLUGIN_FIELDS: readonly ["name", "api", "enforce", "dedupe", "applyToEnvironment", ...string[], "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle", "rollup", "webpack", "rspack", "vite", "esbuild", "farm", "unloader", "rolldown", "bun", "tsup", "tsdown", "unbuild"];
 //#endregion
 export { BUILDER_VARIANTS, KNOWN_PLUGIN_FIELDS, PLUGIN_HOOKS_FIELDS, PLUGIN_NON_HOOK_FIELDS, UNPLUGIN_BUILDER_VARIANTS };
 //# sourceMappingURL=plugin.d.mts.map

package/dist/context/base-context.cjs

@@ -0,0 +1,127 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_plugin_utils_logging = require('../plugin-utils/logging.cjs');
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk, 1);
+let _stryke_fs_resolve = require("@stryke/fs/resolve");
+let date_fns_formatDistanceToNowStrict = require("date-fns/formatDistanceToNowStrict");
+
+//#region src/context/base-context.ts
+var PowerlinesBaseContext = class {
+	#timestamp = Date.now();
+	powerlinesPath;
+	system;
+	get logger() {
+		return this.createLogger();
+	}
+	get cwd() {
+		return this.options.cwd || process.cwd();
+	}
+	get timestamp() {
+		return this.#timestamp;
+	}
+	/**
+	* Initialize the context with the provided configuration options and set up the resolver and user configuration file. This method is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup as the original context.
+	*
+	* @param options - The configuration options to initialize the context with, which can include properties such as the project root, mode, log level, and other settings that affect the behavior of the context and its plugins.
+	*/
+	constructor(options) {
+		this.options = options;
+	}
+	extendLogger(options) {
+		return require_plugin_utils_logging.extendLogger(this.logger, options);
+	}
+	/**
+	* A logging function for fatal messages
+	*
+	* @param message - The message to log.
+	*/
+	fatal(message) {
+		this.logger.error(message instanceof Error ? {
+			meta: {},
+			message: message.message,
+			error: message
+		} : message);
+	}
+	/**
+	* A logging function for error messages
+	*
+	* @param message - The message to log.
+	*/
+	error(message) {
+		this.logger.error(message instanceof Error ? {
+			meta: {},
+			message: message.message,
+			error: message
+		} : message);
+	}
+	/**
+	* A logging function for warning messages
+	*
+	* @param message - The message to log.
+	*/
+	warn(message) {
+		this.logger.warn(message);
+	}
+	/**
+	* A logging function for informational messages
+	*
+	* @param message - The message to log.
+	*/
+	info(message) {
+		this.logger.info(message);
+	}
+	/**
+	* A logging function for debug messages
+	*
+	* @param message - The message to log.
+	*/
+	debug(message) {
+		this.logger.debug(message);
+	}
+	/**
+	* A logging function for trace messages
+	*
+	* @param message - The message to log.
+	*/
+	trace(message) {
+		this.logger.trace(message);
+	}
+	/**
+	* A function to create a timer for measuring the duration of asynchronous operations
+	*
+	* @example
+	* ```ts
+	* const stopTimer = context.timer("Your Async Operation");
+	* await performAsyncOperation();
+	* stopTimer(); // "Your Async Operation completed in 123.45 milliseconds"
+	* ```
+	*
+	* @param name - The name of the timer.
+	* @returns A function that, when called, stops the timer and logs the duration.
+	*/
+	timer(name) {
+		const startDate = Date.now();
+		const startDuration = performance.now();
+		return () => {
+			const duration = performance.now() - startDuration;
+			this.logger.info({
+				meta: { category: "performance" },
+				message: `${chalk.default.bold.cyanBright(name)} completed in ${chalk.default.bold.cyanBright(duration < 1e3 ? `${duration.toFixed(2)} milliseconds` : (0, date_fns_formatDistanceToNowStrict.formatDistanceToNowStrict)(startDate))}`
+			});
+		};
+	}
+	/**
+	* Initialize the context with the provided configuration options
+	*/
+	async init() {
+		if (!this.powerlinesPath) {
+			const powerlinesPath = await (0, _stryke_fs_resolve.resolvePackage)("powerlines");
+			if (!powerlinesPath) throw new Error("Could not resolve `powerlines` package location.");
+			this.powerlinesPath = powerlinesPath;
+		}
+	}
+};
+
+//#endregion
+exports.PowerlinesBaseContext = PowerlinesBaseContext;

package/dist/context/base-context.d.cts

@@ -0,0 +1,81 @@
+import { LogFn, LogMessage, Logger, LoggerOptions } from "../types/logging.cjs";
+import { BaseContext } from "../types/context.cjs";
+import { Options } from "../types/config.cjs";
+import { EnvPaths } from "@stryke/env/get-env-paths";
+
+//#region src/context/base-context.d.ts
+declare abstract class PowerlinesBaseContext<TSystemContext = unknown> implements BaseContext<TSystemContext> {
+  #private;
+  options: Options;
+  powerlinesPath: string;
+  system: TSystemContext;
+  abstract get envPaths(): EnvPaths;
+  get logger(): Logger;
+  get cwd(): string;
+  get timestamp(): number;
+  /**
+   * Initialize the context with the provided configuration options and set up the resolver and user configuration file. This method is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup as the original context.
+   *
+   * @param options - The configuration options to initialize the context with, which can include properties such as the project root, mode, log level, and other settings that affect the behavior of the context and its plugins.
+   */
+  protected constructor(options: Options);
+  abstract createLogger(options?: LoggerOptions, logFn?: LogFn): Logger;
+  extendLogger(options: LoggerOptions): Logger;
+  /**
+   * A logging function for fatal messages
+   *
+   * @param message - The message to log.
+   */
+  fatal(message: string | LogMessage | Error): void;
+  /**
+   * A logging function for error messages
+   *
+   * @param message - The message to log.
+   */
+  error(message: string | LogMessage | Error): void;
+  /**
+   * A logging function for warning messages
+   *
+   * @param message - The message to log.
+   */
+  warn(message: string | LogMessage): void;
+  /**
+   * A logging function for informational messages
+   *
+   * @param message - The message to log.
+   */
+  info(message: string | LogMessage): void;
+  /**
+   * A logging function for debug messages
+   *
+   * @param message - The message to log.
+   */
+  debug(message: string | LogMessage): void;
+  /**
+   * A logging function for trace messages
+   *
+   * @param message - The message to log.
+   */
+  trace(message: string | LogMessage): void;
+  /**
+   * A function to create a timer for measuring the duration of asynchronous operations
+   *
+   * @example
+   * ```ts
+   * const stopTimer = context.timer("Your Async Operation");
+   * await performAsyncOperation();
+   * stopTimer(); // "Your Async Operation completed in 123.45 milliseconds"
+   * ```
+   *
+   * @param name - The name of the timer.
+   * @returns A function that, when called, stops the timer and logs the duration.
+   */
+  timer(name: string): () => void;
+  /**
+   * Initialize the context with the provided configuration options
+   */
+  protected init(): Promise<void>;
+}
+//#endregion
+export { PowerlinesBaseContext };
+//# sourceMappingURL=base-context.d.cts.map

package/dist/context/base-context.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-context.d.cts","names":[],"sources":["../../src/context/base-context.ts"],"mappings":";;;;;;uBA2BsB,qBAAA,sCAET,WAAA,CAAY,cAAA;EAAA;EA0BM,OAAA,EAAS,OAAA;EAvB/B,cAAA;EAEA,MAAA,EAAS,cAAA;EAAA,aAEI,QAAA,CAAA,GAAY,QAAA;EAAA,IAErB,MAAA,CAAA,GAAU,MAAA;EAAA,IAIV,GAAA,CAAA;EAAA,IAIA,SAAA,CAAA;EARU;;;;;EAAA,UAiBZ,WAAA,CAAoB,OAAA,EAAS,OAAA;EAAA,SAEtB,YAAA,CAAa,OAAA,GAAU,aAAA,EAAe,KAAA,GAAQ,KAAA,GAAQ,MAAA;EAE/D,YAAA,CAAa,OAAA,EAAS,aAAA,GAAa,MAAA;EASE;;;;;EAArC,KAAA,CAAM,OAAA,WAAkB,UAAA,GAAa,KAAA;EA6Db;;;;;EA5CxB,KAAA,CAAM,OAAA,WAAkB,UAAA,GAAa,KAAA;EAxDjC;;;;;EAyEJ,IAAA,CAAK,OAAA,WAAkB,UAAA;EApEvB;;;;;EA6EA,IAAA,CAAK,OAAA,WAAkB,UAAA;EArEnB;;;;;EA8EJ,KAAA,CAAM,OAAA,WAAkB,UAAA;EA/DQ;;;;;EAwEhC,KAAA,CAAM,OAAA,WAAkB,UAAA;EAtEF;;;;;;;;;;;;;EAuFtB,KAAA,CAAM,IAAA;EAnCN;;;EAAA,UAyDS,IAAA,CAAA,GAAI,OAAA;AAAA"}

package/dist/context/base-context.d.mts

@@ -0,0 +1,81 @@
+import { LogFn, LogMessage, Logger, LoggerOptions } from "../types/logging.mjs";
+import { BaseContext } from "../types/context.mjs";
+import { Options } from "../types/config.mjs";
+import { EnvPaths } from "@stryke/env/get-env-paths";
+
+//#region src/context/base-context.d.ts
+declare abstract class PowerlinesBaseContext<TSystemContext = unknown> implements BaseContext<TSystemContext> {
+  #private;
+  options: Options;
+  powerlinesPath: string;
+  system: TSystemContext;
+  abstract get envPaths(): EnvPaths;
+  get logger(): Logger;
+  get cwd(): string;
+  get timestamp(): number;
+  /**
+   * Initialize the context with the provided configuration options and set up the resolver and user configuration file. This method is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup as the original context.
+   *
+   * @param options - The configuration options to initialize the context with, which can include properties such as the project root, mode, log level, and other settings that affect the behavior of the context and its plugins.
+   */
+  protected constructor(options: Options);
+  abstract createLogger(options?: LoggerOptions, logFn?: LogFn): Logger;
+  extendLogger(options: LoggerOptions): Logger;
+  /**
+   * A logging function for fatal messages
+   *
+   * @param message - The message to log.
+   */
+  fatal(message: string | LogMessage | Error): void;
+  /**
+   * A logging function for error messages
+   *
+   * @param message - The message to log.
+   */
+  error(message: string | LogMessage | Error): void;
+  /**
+   * A logging function for warning messages
+   *
+   * @param message - The message to log.
+   */
+  warn(message: string | LogMessage): void;
+  /**
+   * A logging function for informational messages
+   *
+   * @param message - The message to log.
+   */
+  info(message: string | LogMessage): void;
+  /**
+   * A logging function for debug messages
+   *
+   * @param message - The message to log.
+   */
+  debug(message: string | LogMessage): void;
+  /**
+   * A logging function for trace messages
+   *
+   * @param message - The message to log.
+   */
+  trace(message: string | LogMessage): void;
+  /**
+   * A function to create a timer for measuring the duration of asynchronous operations
+   *
+   * @example
+   * ```ts
+   * const stopTimer = context.timer("Your Async Operation");
+   * await performAsyncOperation();
+   * stopTimer(); // "Your Async Operation completed in 123.45 milliseconds"
+   * ```
+   *
+   * @param name - The name of the timer.
+   * @returns A function that, when called, stops the timer and logs the duration.
+   */
+  timer(name: string): () => void;
+  /**
+   * Initialize the context with the provided configuration options
+   */
+  protected init(): Promise<void>;
+}
+//#endregion
+export { PowerlinesBaseContext };
+//# sourceMappingURL=base-context.d.mts.map

package/dist/context/base-context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-context.d.mts","names":[],"sources":["../../src/context/base-context.ts"],"mappings":";;;;;;uBA2BsB,qBAAA,sCAET,WAAA,CAAY,cAAA;EAAA;EA0BM,OAAA,EAAS,OAAA;EAvB/B,cAAA;EAEA,MAAA,EAAS,cAAA;EAAA,aAEI,QAAA,CAAA,GAAY,QAAA;EAAA,IAErB,MAAA,CAAA,GAAU,MAAA;EAAA,IAIV,GAAA,CAAA;EAAA,IAIA,SAAA,CAAA;EARU;;;;;EAAA,UAiBZ,WAAA,CAAoB,OAAA,EAAS,OAAA;EAAA,SAEtB,YAAA,CAAa,OAAA,GAAU,aAAA,EAAe,KAAA,GAAQ,KAAA,GAAQ,MAAA;EAE/D,YAAA,CAAa,OAAA,EAAS,aAAA,GAAa,MAAA;EASE;;;;;EAArC,KAAA,CAAM,OAAA,WAAkB,UAAA,GAAa,KAAA;EA6Db;;;;;EA5CxB,KAAA,CAAM,OAAA,WAAkB,UAAA,GAAa,KAAA;EAxDjC;;;;;EAyEJ,IAAA,CAAK,OAAA,WAAkB,UAAA;EApEvB;;;;;EA6EA,IAAA,CAAK,OAAA,WAAkB,UAAA;EArEnB;;;;;EA8EJ,KAAA,CAAM,OAAA,WAAkB,UAAA;EA/DQ;;;;;EAwEhC,KAAA,CAAM,OAAA,WAAkB,UAAA;EAtEF;;;;;;;;;;;;;EAuFtB,KAAA,CAAM,IAAA;EAnCN;;;EAAA,UAyDS,IAAA,CAAA,GAAI,OAAA;AAAA"}

package/dist/context/base-context.mjs

@@ -0,0 +1,125 @@
+import { extendLogger } from "../plugin-utils/logging.mjs";
+import chalk from "chalk";
+import { resolvePackage } from "@stryke/fs/resolve";
+import { formatDistanceToNowStrict } from "date-fns/formatDistanceToNowStrict";
+
+//#region src/context/base-context.ts
+var PowerlinesBaseContext = class {
+	#timestamp = Date.now();
+	powerlinesPath;
+	system;
+	get logger() {
+		return this.createLogger();
+	}
+	get cwd() {
+		return this.options.cwd || process.cwd();
+	}
+	get timestamp() {
+		return this.#timestamp;
+	}
+	/**
+	* Initialize the context with the provided configuration options and set up the resolver and user configuration file. This method is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup as the original context.
+	*
+	* @param options - The configuration options to initialize the context with, which can include properties such as the project root, mode, log level, and other settings that affect the behavior of the context and its plugins.
+	*/
+	constructor(options) {
+		this.options = options;
+	}
+	extendLogger(options) {
+		return extendLogger(this.logger, options);
+	}
+	/**
+	* A logging function for fatal messages
+	*
+	* @param message - The message to log.
+	*/
+	fatal(message) {
+		this.logger.error(message instanceof Error ? {
+			meta: {},
+			message: message.message,
+			error: message
+		} : message);
+	}
+	/**
+	* A logging function for error messages
+	*
+	* @param message - The message to log.
+	*/
+	error(message) {
+		this.logger.error(message instanceof Error ? {
+			meta: {},
+			message: message.message,
+			error: message
+		} : message);
+	}
+	/**
+	* A logging function for warning messages
+	*
+	* @param message - The message to log.
+	*/
+	warn(message) {
+		this.logger.warn(message);
+	}
+	/**
+	* A logging function for informational messages
+	*
+	* @param message - The message to log.
+	*/
+	info(message) {
+		this.logger.info(message);
+	}
+	/**
+	* A logging function for debug messages
+	*
+	* @param message - The message to log.
+	*/
+	debug(message) {
+		this.logger.debug(message);
+	}
+	/**
+	* A logging function for trace messages
+	*
+	* @param message - The message to log.
+	*/
+	trace(message) {
+		this.logger.trace(message);
+	}
+	/**
+	* A function to create a timer for measuring the duration of asynchronous operations
+	*
+	* @example
+	* ```ts
+	* const stopTimer = context.timer("Your Async Operation");
+	* await performAsyncOperation();
+	* stopTimer(); // "Your Async Operation completed in 123.45 milliseconds"
+	* ```
+	*
+	* @param name - The name of the timer.
+	* @returns A function that, when called, stops the timer and logs the duration.
+	*/
+	timer(name) {
+		const startDate = Date.now();
+		const startDuration = performance.now();
+		return () => {
+			const duration = performance.now() - startDuration;
+			this.logger.info({
+				meta: { category: "performance" },
+				message: `${chalk.bold.cyanBright(name)} completed in ${chalk.bold.cyanBright(duration < 1e3 ? `${duration.toFixed(2)} milliseconds` : formatDistanceToNowStrict(startDate))}`
+			});
+		};
+	}
+	/**
+	* Initialize the context with the provided configuration options
+	*/
+	async init() {
+		if (!this.powerlinesPath) {
+			const powerlinesPath = await resolvePackage("powerlines");
+			if (!powerlinesPath) throw new Error("Could not resolve `powerlines` package location.");
+			this.powerlinesPath = powerlinesPath;
+		}
+	}
+};
+
+//#endregion
+export { PowerlinesBaseContext };
+//# sourceMappingURL=base-context.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-context.mjs","names":["#timestamp"],"sources":["../../src/context/base-context.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { EnvPaths } from \"@stryke/env/get-env-paths\";\nimport { resolvePackage } from \"@stryke/fs/resolve\";\nimport chalk from \"chalk\";\nimport { formatDistanceToNowStrict } from \"date-fns/formatDistanceToNowStrict\";\nimport { extendLogger } from \"../plugin-utils/logging\";\nimport { Options } from \"../types/config\";\nimport { BaseContext } from \"../types/context\";\nimport { LogFn, Logger, LoggerOptions, LogMessage } from \"../types/logging\";\n\nexport abstract class PowerlinesBaseContext<\n  TSystemContext = unknown\n> implements BaseContext<TSystemContext> {\n  #timestamp: number = Date.now();\n\n  public powerlinesPath!: string;\n\n  public system!: TSystemContext;\n\n  public abstract get envPaths(): EnvPaths;\n\n  public get logger(): Logger {\n    return this.createLogger();\n  }\n\n  public get cwd(): string {\n    return this.options.cwd || process.cwd();\n  }\n\n  public get timestamp(): number {\n    return this.#timestamp;\n  }\n\n  /**\n   * Initialize the context with the provided configuration options and set up the resolver and user configuration file. This method is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup as the original context.\n   *\n   * @param options - The configuration options to initialize the context with, which can include properties such as the project root, mode, log level, and other settings that affect the behavior of the context and its plugins.\n   */\n  protected constructor(public options: Options) {}\n\n  public abstract createLogger(options?: LoggerOptions, logFn?: LogFn): Logger;\n\n  public extendLogger(options: LoggerOptions) {\n    return extendLogger(this.logger, options);\n  }\n\n  /**\n   * A logging function for fatal messages\n   *\n   * @param message - The message to log.\n   */\n  public fatal(message: string | LogMessage | Error) {\n    this.logger.error(\n      message instanceof Error\n        ? {\n            meta: {},\n            message: message.message,\n            error: message\n          }\n        : message\n    );\n  }\n\n  /**\n   * A logging function for error messages\n   *\n   * @param message - The message to log.\n   */\n  public error(message: string | LogMessage | Error) {\n    this.logger.error(\n      message instanceof Error\n        ? {\n            meta: {},\n            message: message.message,\n            error: message\n          }\n        : message\n    );\n  }\n\n  /**\n   * A logging function for warning messages\n   *\n   * @param message - The message to log.\n   */\n  public warn(message: string | LogMessage) {\n    this.logger.warn(message);\n  }\n\n  /**\n   * A logging function for informational messages\n   *\n   * @param message - The message to log.\n   */\n  public info(message: string | LogMessage) {\n    this.logger.info(message);\n  }\n\n  /**\n   * A logging function for debug messages\n   *\n   * @param message - The message to log.\n   */\n  public debug(message: string | LogMessage) {\n    this.logger.debug(message);\n  }\n\n  /**\n   * A logging function for trace messages\n   *\n   * @param message - The message to log.\n   */\n  public trace(message: string | LogMessage) {\n    this.logger.trace(message);\n  }\n\n  /**\n   * A function to create a timer for measuring the duration of asynchronous operations\n   *\n   * @example\n   * ```ts\n   * const stopTimer = context.timer(\"Your Async Operation\");\n   * await performAsyncOperation();\n   * stopTimer(); // \"Your Async Operation completed in 123.45 milliseconds\"\n   * ```\n   *\n   * @param name - The name of the timer.\n   * @returns A function that, when called, stops the timer and logs the duration.\n   */\n  public timer(name: string): () => void {\n    const startDate = Date.now();\n    const startDuration = performance.now();\n\n    return () => {\n      const duration = performance.now() - startDuration;\n      this.logger.info({\n        meta: {\n          category: \"performance\"\n        },\n        message: `${chalk.bold.cyanBright(name)} completed in ${chalk.bold.cyanBright(\n          duration < 1000\n            ? `${duration.toFixed(2)} milliseconds`\n            : formatDistanceToNowStrict(startDate)\n        )}`\n      });\n    };\n  }\n\n  /**\n   * Initialize the context with the provided configuration options\n   */\n  protected async init() {\n    if (!this.powerlinesPath) {\n      const powerlinesPath = await resolvePackage(\"powerlines\");\n      if (!powerlinesPath) {\n        throw new Error(\"Could not resolve `powerlines` package location.\");\n      }\n      this.powerlinesPath = powerlinesPath;\n    }\n  }\n}\n"],"mappings":";;;;;;AA2BA,IAAsB,wBAAtB,MAEyC;CACvC,aAAqB,KAAK,KAAK;CAE/B,AAAO;CAEP,AAAO;CAIP,IAAW,SAAiB;AAC1B,SAAO,KAAK,cAAc;;CAG5B,IAAW,MAAc;AACvB,SAAO,KAAK,QAAQ,OAAO,QAAQ,KAAK;;CAG1C,IAAW,YAAoB;AAC7B,SAAO,MAAKA;;;;;;;CAQd,AAAU,YAAY,AAAO,SAAkB;EAAlB;;CAI7B,AAAO,aAAa,SAAwB;AAC1C,SAAO,aAAa,KAAK,QAAQ,QAAQ;;;;;;;CAQ3C,AAAO,MAAM,SAAsC;AACjD,OAAK,OAAO,MACV,mBAAmB,QACf;GACE,MAAM,EAAE;GACR,SAAS,QAAQ;GACjB,OAAO;GACR,GACD,QACL;;;;;;;CAQH,AAAO,MAAM,SAAsC;AACjD,OAAK,OAAO,MACV,mBAAmB,QACf;GACE,MAAM,EAAE;GACR,SAAS,QAAQ;GACjB,OAAO;GACR,GACD,QACL;;;;;;;CAQH,AAAO,KAAK,SAA8B;AACxC,OAAK,OAAO,KAAK,QAAQ;;;;;;;CAQ3B,AAAO,KAAK,SAA8B;AACxC,OAAK,OAAO,KAAK,QAAQ;;;;;;;CAQ3B,AAAO,MAAM,SAA8B;AACzC,OAAK,OAAO,MAAM,QAAQ;;;;;;;CAQ5B,AAAO,MAAM,SAA8B;AACzC,OAAK,OAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CAgB5B,AAAO,MAAM,MAA0B;EACrC,MAAM,YAAY,KAAK,KAAK;EAC5B,MAAM,gBAAgB,YAAY,KAAK;AAEvC,eAAa;GACX,MAAM,WAAW,YAAY,KAAK,GAAG;AACrC,QAAK,OAAO,KAAK;IACf,MAAM,EACJ,UAAU,eACX;IACD,SAAS,GAAG,MAAM,KAAK,WAAW,KAAK,CAAC,gBAAgB,MAAM,KAAK,WACjE,WAAW,MACP,GAAG,SAAS,QAAQ,EAAE,CAAC,iBACvB,0BAA0B,UAAU,CACzC;IACF,CAAC;;;;;;CAON,MAAgB,OAAO;AACrB,MAAI,CAAC,KAAK,gBAAgB;GACxB,MAAM,iBAAiB,MAAM,eAAe,aAAa;AACzD,OAAI,CAAC,eACH,OAAM,IAAI,MAAM,mDAAmD;AAErE,QAAK,iBAAiB"}