@powerlines/plugin-env 0.15.140 → 0.15.142

package/dist/persistence-DrKQZNCv.d.mts

@@ -0,0 +1,85 @@
+import { a as EnvType, r as EnvPluginResolvedConfig, t as EnvPluginContext } from "./plugin-DMbVjdcQ.mjs";
+import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
+import { Context, UnresolvedContext } from "powerlines/types/context";
+import { TypeDefinition } from "@stryke/types/configuration";
+
+//#region src/helpers/persistence.d.ts
+
+/**
+ * Resolves the runtime type definition file for the environment variables.
+ *
+ * @param context - The plugin context.
+ * @returns The runtime type definition file for the environment variables.
+ */
+declare function resolveRuntimeTypeFile(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<string>;
+/**
+ * Gets the default type definition for the environment variables.
+ *
+ * @param context - The plugin context.
+ * @returns The default type definition for the environment variables.
+ */
+declare function getEnvDefaultTypeDefinition(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<TypeDefinition>;
+/** Gets the default type definition for the environment secrets.
+ *
+ * @param context - The plugin context.
+ * @returns The default type definition for the environment secrets.
+ */
+declare function getSecretsDefaultTypeDefinition(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<TypeDefinition>;
+/**
+ * Gets the path to the environment type reflections.
+ *
+ * @param context - The plugin context.
+ * @param name - The name of the type reflections.
+ * @returns The path to the environment type reflections.
+ */
+declare function getEnvTypeReflectionsPath(context: Context<EnvPluginResolvedConfig>, name?: EnvType): string;
+/**
+ * Reads the environment type reflection from the file system.
+ *
+ * @param context - The plugin context.
+ * @param name - The name of the type reflections.
+ * @returns The environment type reflection.
+ */
+declare function readEnvTypeReflection(context: EnvPluginContext, name?: EnvType): Promise<ReflectionClass<any>>;
+/**
+ * Writes the environment type reflection to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The environment type reflection to write.
+ * @param name - The name of the type reflections.
+ */
+declare function writeEnvTypeReflection(context: EnvPluginContext, reflection: ReflectionClass<any>, name?: EnvType): Promise<void>;
+declare function getEnvReflectionsPath(context: EnvPluginContext, name: EnvType): string;
+/**
+ * Reads the environment reflection data from the file system.
+ *
+ * @param context - The plugin context.
+ * @returns The environment reflection data.
+ */
+declare function readEnvReflection(context: EnvPluginContext): Promise<ReflectionClass<any>>;
+/**
+ * Reads the secret environment reflection data from the file system.
+ *
+ * @param context - The plugin context.
+ * @returns The environment reflection data.
+ */
+declare function readSecretsReflection(context: EnvPluginContext): Promise<ReflectionClass<any>>;
+/**
+ * Writes the environment reflection data to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The reflection data to write.
+ * @param name - The name of the reflection (either "env" or "secrets").
+ */
+declare function writeEnvReflection(context: EnvPluginContext, reflection: ReflectionClass<any>, name?: EnvType): Promise<void>;
+/**
+ * Writes the environment reflection data to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The reflection data to write.
+ * @param name - The name of the reflection (either "env" or "secrets").
+ */
+declare function writeEnvReflectionSync(context: EnvPluginContext, reflection: ReflectionClass<any>, name?: EnvType): void;
+//#endregion
+export { readEnvReflection as a, resolveRuntimeTypeFile as c, writeEnvTypeReflection as d, getSecretsDefaultTypeDefinition as i, writeEnvReflection as l, getEnvReflectionsPath as n, readEnvTypeReflection as o, getEnvTypeReflectionsPath as r, readSecretsReflection as s, getEnvDefaultTypeDefinition as t, writeEnvReflectionSync as u };
+//# sourceMappingURL=persistence-DrKQZNCv.d.mts.map

package/dist/persistence-DrKQZNCv.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-DrKQZNCv.d.mts","names":[],"sources":["../src/helpers/persistence.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAoDA;;;;AAEU,iBAFY,sBAAA,CAEZ,OAAA,EADC,iBACD,CADmB,uBACnB,CAAA,CAAA,EAAP,OAAO,CAAA,MAAA,CAAA;AAmBV;;;;;;AAcsB,iBAdA,2BAAA,CAc+B,OAAA,EAb1C,iBAa0C,CAbxB,uBAawB,CAAA,CAAA,EAZlD,OAYkD,CAZ1C,cAY0C,CAAA;;;;;;AAgBrC,iBAhBM,+BAAA,CAgBmB,OAAA,EAf9B,iBAe8B,CAfZ,uBAeY,CAAA,CAAA,EAdtC,OAcsC,CAd9B,cAc8B,CAAA;;;;;AAczC;;;AAGW,iBAjBK,yBAAA,CAiBL,OAAA,EAhBA,OAgBA,CAhBQ,uBAgBR,CAAA,EAAA,IAAA,CAAA,EAfH,OAeG,CAAA,EAAA,MAAA;;;AAuCX;;;;;AAGuB,iBA7CD,qBAAA,CA6CC,OAAA,EA5CZ,gBA4CY,EAAA,IAAA,CAAA,EA3Cf,OA2Ce,CAAA,EA1CpB,OA0CoB,CA1CZ,eA0CY,CAAA,GAAA,CAAA,CAAA;AAevB;AAaA;;;;;AAyDA;AACW,iBAzFW,sBAAA,CAyFX,OAAA,EAxFA,gBAwFA,EAAA,UAAA,EAvFG,eAuFH,CAAA,GAAA,CAAA,EAAA,IAAA,CAAA,EAtFH,OAsFG,CAAA,EAtFY,OAsFZ,CAAA,IAAA,CAAA;AACA,iBAxEK,qBAAA,CAwEL,OAAA,EAvEA,gBAuEA,EAAA,IAAA,EAtEH,OAsEG,CAAA,EAAA,MAAA;;;AA2DX;;;;AAGuB,iBAzHD,iBAAA,CAyHC,OAAA,EAxHZ,gBAwHY,CAAA,EAvHpB,OAuHoB,CAvHZ,eAuHY,CAAA,GAAA,CAAA,CAAA;;AAsBvB;;;;;iBAtFsB,qBAAA,UACX,mBACR,QAAQ;;;;;;;;iBA2DW,kBAAA,UACX,8BACG,6BACN,UAAe;;;;;;;;iBAsBP,sBAAA,UACL,8BACG,6BACN"}

package/dist/plugin-CM1TSv1B.cjs

@@ -0,0 +1,159 @@
+const require_chunk = require('./chunk-CNVrAnJR.cjs');
+const require_runtime = require('./runtime-g0TEIoZK.cjs');
+let __powerlines_plugin_babel_types = require("@powerlines/plugin-babel/types");
+let __powerlines_plugin_automd_types_plugin = require("@powerlines/plugin-automd/types/plugin");
+let __powerlines_plugin_alloy_types = require("@powerlines/plugin-alloy/types");
+let __powerlines_deepkit_types = require("@powerlines/deepkit/types");
+
+//#region src/types/plugin.ts
+const __ΩOmit = [
+	"T",
+	"K",
+	() => __ΩPick,
+	() => __ΩExclude,
+	"Omit",
+	"b!b\"e!!e!!ge!\"o$#o##w%y"
+];
+const __ΩRequired = [
+	"T",
+	"Required",
+	"l+e#!e\"!fRb!Pde\"!gN##w\"y"
+];
+const __ΩPick = [
+	"T",
+	"K",
+	"Pick",
+	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
+];
+const __ΩExclude = [
+	"T",
+	"U",
+	"Exclude",
+	"l6!Re$!RPe#!e$\"qk#%QRb!b\"Pde\"!p)w#y"
+];
+const __ΩEnvType = [
+	"env",
+	"secrets",
+	"EnvType",
+	"P.!.\"Jw#y"
+];
+const __ΩEnvPluginOptions = [
+	() => __ΩOmit,
+	"types",
+	"types",
+	"A path to the type definition for the expected env configuration parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigConfiguration\"`.",
+	"secrets",
+	"A path to the type definition for the expected env secret parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigSecrets\"`.",
+	"prefix",
+	"An additional prefix (or list of additional prefixes) to apply to the environment variables",
+	"inject",
+	true,
+	"Should the plugin inject the env variables in the source code with their values?",
+	"Children",
+	"defaultConfig",
+	"The default configuration to use when loading environment variables.",
+	() => __powerlines_plugin_babel_types.__ΩBabelPluginOptions,
+	"babel",
+	"Babel configuration options to use when injecting environment variables into the source code.",
+	() => __powerlines_plugin_automd_types_plugin.__ΩAutoMDPluginOptions,
+	"automd",
+	"AutoMD configuration options to allow injecting environment variables documentation into a markdown file such as a README.md.",
+	() => __powerlines_plugin_alloy_types.__ΩAlloyPluginOptions,
+	"alloy",
+	"Alloy configuration options to use when injecting environment variables into the source code.",
+	"EnvPluginOptions",
+	"P!.\"o!#P!4#8?$!4%8?&P&&FJ4'8?()4)8>*?+\"w,4-8?.n/408?1n2438?4n5468?7MKw8y"
+];
+const __ΩEnvPluginUserConfig = [
+	() => __powerlines_plugin_babel_types.__ΩBabelPluginUserConfig,
+	() => __powerlines_plugin_alloy_types.__ΩAlloyPluginUserConfig,
+	() => __ΩEnvPluginOptions,
+	"env",
+	"EnvPluginUserConfig",
+	"Pn!n\"Pn#4$MKw%y"
+];
+const __ΩEnvPluginResolvedConfig = [
+	() => __powerlines_plugin_babel_types.__ΩBabelPluginResolvedConfig,
+	() => __powerlines_plugin_alloy_types.__ΩAlloyPluginResolvedConfig,
+	() => __ΩRequired,
+	() => __ΩPick,
+	"additionalFiles",
+	() => __ΩRequired,
+	() => __ΩPick,
+	() => __ΩEnvPluginOptions,
+	"defaultConfig",
+	"types",
+	"The type definition for the expected env variable parameters",
+	"secrets",
+	"The type definition for the expected env secret parameters",
+	() => __ΩEnvPluginOptions,
+	"inject",
+	"inject",
+	"Should the plugin inject the env variables in the source code with their values?",
+	"prefix",
+	"The prefix used for environment variables",
+	"env",
+	"EnvPluginResolvedConfig",
+	"Pn!n\"PP!.%o$#o#\"n(.)o'#o&\"P!4*?+!4,?-n../f40?1&F42?3MK44MKw5y"
+];
+const __ΩEnvPluginContext = [
+	() => __ΩEnvPluginResolvedConfig,
+	"TResolvedConfig",
+	() => __powerlines_plugin_babel_types.__ΩBabelPluginContext,
+	() => __powerlines_plugin_alloy_types.__ΩAlloyPluginContext,
+	() => __powerlines_deepkit_types.__ΩReflection,
+	"env",
+	"The type definitions for the expected env variables",
+	() => __powerlines_deepkit_types.__ΩReflection,
+	"secrets",
+	"The type definitions for the expected env secrets",
+	"The type definitions reflection for the env variables and secrets",
+	"types",
+	() => __powerlines_deepkit_types.__ΩReflection,
+	() => require_runtime.__ΩEnvInterface,
+	"The current env variables reflection",
+	() => __powerlines_deepkit_types.__ΩReflection,
+	() => require_runtime.__ΩSecretsInterface,
+	"The current env secrets reflection",
+	"The current **used** environment variables and secrets reflection",
+	"used",
+	"parsed",
+	"The parsed .env configuration object",
+	() => __powerlines_deepkit_types.__ΩReflection,
+	"injected",
+	"The injected environment variables and secrets reflection",
+	"EnvPluginContext",
+	"n!c\"Pe\"!o#\"e\"!o$\"PPn%4&?'n(4)?*M?+4,?+Pn.o-\"4&?/n1o0\"4)?2M?344?3!45?6n748?9M4&Mw:y"
+];
+
+//#endregion
+Object.defineProperty(exports, '__ΩEnvPluginContext', {
+  enumerable: true,
+  get: function () {
+    return __ΩEnvPluginContext;
+  }
+});
+Object.defineProperty(exports, '__ΩEnvPluginOptions', {
+  enumerable: true,
+  get: function () {
+    return __ΩEnvPluginOptions;
+  }
+});
+Object.defineProperty(exports, '__ΩEnvPluginResolvedConfig', {
+  enumerable: true,
+  get: function () {
+    return __ΩEnvPluginResolvedConfig;
+  }
+});
+Object.defineProperty(exports, '__ΩEnvPluginUserConfig', {
+  enumerable: true,
+  get: function () {
+    return __ΩEnvPluginUserConfig;
+  }
+});
+Object.defineProperty(exports, '__ΩEnvType', {
+  enumerable: true,
+  get: function () {
+    return __ΩEnvType;
+  }
+});

package/dist/plugin-CSVnrdpE.cjs

@@ -0,0 +1,146 @@
+const require_chunk = require('./chunk-CNVrAnJR.cjs');
+const require_plugin = require('./plugin-CM1TSv1B.cjs');
+let powerlines_types_babel = require("powerlines/types/babel");
+let __babel_core = require("@babel/core");
+let __powerlines_deepkit_utilities = require("@powerlines/deepkit/utilities");
+let __powerlines_plugin_babel_helpers_create_plugin = require("@powerlines/plugin-babel/helpers/create-plugin");
+let __powerlines_plugin_babel_helpers_module_helpers = require("@powerlines/plugin-babel/helpers/module-helpers");
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+
+//#region src/babel/plugin.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+const envBabelPlugin = (__powerlines_plugin_babel_helpers_create_plugin.createBabelPlugin.Ω = [[() => require_plugin.__ΩEnvPluginContext, "n!"]], (0, __powerlines_plugin_babel_helpers_create_plugin.createBabelPlugin)("env", __assignType(({ log, context }) => {
+	function extractEnv(node, pass, isInjectable = false) {
+		const envTypesAliasProperties = context.env.types.env?.getProperties().filter(__assignType((prop) => prop.getAlias().length > 0, [
+			"prop",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (node.name) {
+			const prefix = context.config.env.prefix.find(__assignType((pre) => node.name && node.name.startsWith(pre) && (context.env.types.env?.hasProperty(node.name.replace(`${pre}_`, "")) || envTypesAliasProperties.some(__assignType((prop) => prop.getAlias().includes(node.name.replace(`${pre}_`, "")), [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			]))), [
+				"pre",
+				"",
+				"P\"2!\"/\""
+			]));
+			let name = node.name;
+			if (prefix) name = node.name.replace(`${prefix}_`, "");
+			log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Environment variable ${name} found in ${pass.filename || "unknown file"}.`);
+			if (context.env.types.env?.hasProperty(name) || envTypesAliasProperties.some(__assignType((prop) => prop.getAlias().includes(name), [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			]))) {
+				const envProperty = context.env.types.env.hasProperty(name) ? context.env.types.env.getProperty(name) : envTypesAliasProperties.find(__assignType((prop) => prop.getAlias().includes(name), [
+					"prop",
+					"",
+					"P\"2!\"/\""
+				]));
+				if (!envProperty || envProperty.isIgnored()) return;
+				if (!context.env.used.env.hasProperty(name)) {
+					log(__storm_software_config_tools_types.LogLevelLabel.DEBUG, `Adding "${name}" environment variables found in "${pass.filename || "unknown file"}" to used environment configuration reflection object.`);
+					context.env.used.env.addProperty(envProperty.property);
+				}
+				if (context.config.env.inject && isInjectable) {
+					let value = context.env.parsed?.[name];
+					if (value === void 0) {
+						const prefix$1 = context.config.env.prefix.find(__assignType((pre) => {
+							return context.env.parsed[`${pre.replace(/_$/g, "")}_${name}`];
+						}, [
+							"pre",
+							"",
+							"P\"2!\"/\""
+						]));
+						if (prefix$1) value = context.env.parsed[`${prefix$1.replace(/_$/g, "")}_${name}`];
+					}
+					value ??= envProperty.getDefaultValue();
+					if (envProperty.isValueRequired() && value === void 0) throw new Error(`Environment variable \`${name}\` is not defined in the .env configuration files`);
+					return (0, __powerlines_deepkit_utilities.stringifyDefaultValue)(envProperty, value);
+				}
+			} else throw new Error(`The "${name}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${pass.filename ? pass.filename : "unknown"}.
+
+          The following environment configuration names are defined in the \`env\` type definition: \n${context.env.types.env?.getPropertyNames().sort(__assignType((a, b) => String(a).localeCompare(String(b)), [
+				"a",
+				"b",
+				"",
+				"P\"2!\"2\"\"/#"
+			])).map(__assignType((typeDef) => ` - ${String(typeDef)} ${envTypesAliasProperties.some(__assignType((prop) => prop.getNameAsString() === String(typeDef) && prop.getAlias().length > 0, [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			])) ? `(Alias: ${envTypesAliasProperties?.find(__assignType((prop) => prop.getNameAsString() === String(typeDef), [
+				"prop",
+				"",
+				"P\"2!\"/\""
+			]))?.getAlias().join(", ")})` : ""}`, [
+				"typeDef",
+				"",
+				"P\"2!\"/\""
+			])).join("\n")} \n\nUsing the following env prefix: \n${context.config.env.prefix.map(__assignType((prefix$1) => ` - ${prefix$1}`, [
+				"prefix",
+				"",
+				"P\"2!\"/\""
+			])).join("\n")} \n\nPlease check your \`env\` configuration option. If you are using a custom dotenv type definition, please make sure that the configuration names match the ones in the code. \n\n`);
+		}
+	}
+	extractEnv.__type = [
+		"node",
+		() => powerlines_types_babel.__ΩBabelPluginPass,
+		"pass",
+		"isInjectable",
+		"extractEnv",
+		"P!2!n\"2#\"2$\"/%"
+	];
+	return { visitor: { MemberExpression: __assignType(function MemberExpression(path, pass) {
+		if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isIdentifier({ name: "process" }) && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+			path.replaceWithSourceString(`env.${identifier.name}`);
+			(0, __powerlines_plugin_babel_helpers_module_helpers.addImport)(path, {
+				module: `${context.config.framework || "powerlines"}:env`,
+				name: "env",
+				imported: "env"
+			});
+		} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isMetaProperty() && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+			path.replaceWithSourceString(`env.${identifier.name}`);
+			(0, __powerlines_plugin_babel_helpers_module_helpers.addImport)(path, {
+				module: `${context.config.framework || "powerlines"}:env`,
+				name: "env",
+				imported: "env"
+			});
+		} else if (path.get("object")?.isIdentifier({ name: "env" }) && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+		}
+	}, [
+		() => __babel_core.NodePath,
+		"path",
+		() => powerlines_types_babel.__ΩBabelPluginPass,
+		"pass",
+		"MemberExpression",
+		"PP!7!2\"n#2$\"/%"
+	]) } };
+}, [
+	"param0",
+	"",
+	"P\"2!\"/\""
+])));
+
+//#endregion
+Object.defineProperty(exports, 'envBabelPlugin', {
+  enumerable: true,
+  get: function () {
+    return envBabelPlugin;
+  }
+});

package/dist/plugin-CSe5f2cD.d.cts

@@ -0,0 +1,155 @@
+import { n as SecretsInterface, t as EnvInterface } from "./runtime-BDzzR4wH.cjs";
+import { Children } from "@alloy-js/core";
+import { Reflection } from "@powerlines/deepkit/types";
+import { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig } from "@powerlines/plugin-alloy/types";
+import { AutoMDPluginOptions } from "@powerlines/plugin-automd/types/plugin";
+import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "@powerlines/plugin-babel/types";
+import { DotenvParseOutput } from "@stryke/env/types";
+import { DotenvConfiguration, TypeDefinition, TypeDefinitionParameter } from "@stryke/types/configuration";
+
+//#region src/types/plugin.d.ts
+type EnvType = "env" | "secrets";
+type EnvPluginOptions = Omit<DotenvConfiguration, "types"> & {
+  /**
+   * A path to the type definition for the expected env configuration parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `":"` or `"#"` character. For example: `"./src/types/env.ts#ConfigConfiguration"`.
+   */
+  types?: TypeDefinitionParameter;
+  /**
+   * A path to the type definition for the expected env secret parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `":"` or `"#"` character. For example: `"./src/types/env.ts#ConfigSecrets"`.
+   */
+  secrets?: TypeDefinitionParameter;
+  /**
+   * An additional prefix (or list of additional prefixes) to apply to the environment variables
+   *
+   * @remarks
+   * By default, the plugin will use the `POWERLINES_` prefix. This option is useful for avoiding conflicts with other environment variables.
+   */
+  prefix?: string | string[];
+  /**
+   * Should the plugin inject the env variables in the source code with their values?
+   *
+   * @defaultValue false
+   */
+  inject?: boolean;
+  /**
+   * The default configuration to use when loading environment variables.
+   *
+   * @remarks
+   * This configuration is used as the base configuration when loading environment variables, and will be overridden by any values found in the `.env` file or the process environment.
+   */
+  defaultConfig?: Children;
+  /**
+   * Babel configuration options to use when injecting environment variables into the source code.
+   *
+   * @remarks
+   * This option allows you to customize the Babel transformation process used to inject environment variables into the source code. If not provided, the plugin will use default Babel settings.
+   */
+  babel?: BabelPluginOptions;
+  /**
+   * AutoMD configuration options to allow injecting environment variables documentation into a markdown file such as a README.md.
+   *
+   * @remarks
+   * The README.md file should contain the `<!-- automd:env --><!-- /automd -->` comment block where the documentation will be injected.
+   */
+  automd?: AutoMDPluginOptions;
+  /**
+   * Alloy configuration options to use when injecting environment variables into the source code.
+   *
+   * @remarks
+   * This option allows you to customize the Alloy transformation process used to inject environment variables into the source code. If not provided, the plugin will use default Alloy settings.
+   */
+  alloy?: AlloyPluginOptions;
+};
+type EnvPluginUserConfig = BabelPluginUserConfig & AlloyPluginUserConfig & {
+  env: EnvPluginOptions;
+};
+type EnvPluginResolvedConfig = BabelPluginResolvedConfig & AlloyPluginResolvedConfig & {
+  env: Required<Pick<DotenvConfiguration, "additionalFiles">> & Required<Pick<EnvPluginOptions, "defaultConfig">> & {
+    /**
+     * The type definition for the expected env variable parameters
+     *
+     * @remarks
+     * This value is parsed from the {@link EnvPluginOptions.types} option.
+     */
+    types: TypeDefinition;
+    /**
+     * The type definition for the expected env secret parameters
+     *
+     * @remarks
+     * This value is parsed from the {@link EnvPluginOptions.secrets} option.
+     */
+    secrets: TypeDefinition;
+    /**
+     * Should the plugin inject the env variables in the source code with their values?
+     *
+     * @remarks
+     * This value is the result of reflecting the {@link EnvPluginOptions.inject} option.
+     */
+    inject: EnvPluginOptions["inject"];
+    /**
+     * The prefix used for environment variables
+     *
+     * @remarks
+     * This value is used to filter environment variables that are loaded from the .env file and the process environment.
+     */
+    prefix: string[];
+  };
+};
+interface EnvPluginContext<TResolvedConfig extends EnvPluginResolvedConfig = EnvPluginResolvedConfig> extends BabelPluginContext<TResolvedConfig>, AlloyPluginContext<TResolvedConfig> {
+  env: {
+    /**
+     * The type definitions reflection for the env variables and secrets
+     *
+     * @remarks
+     * These reflections contains the structure of the expected environment variables and secrets as defined by the type definitions provided in the plugin configuration.
+     */
+    types: {
+      /**
+       * The type definitions for the expected env variables
+       */
+      env: Reflection;
+      /**
+       * The type definitions for the expected env secrets
+       */
+      secrets: Reflection;
+    };
+    /**
+     * The current **used** environment variables and secrets reflection
+     *
+     * @remarks
+     * This reflection contains the structure of the current environment variables and secrets as defined during the plugin initialization by extracting the values from the source code.
+     */
+    used: {
+      /**
+       * The current env variables reflection
+       */
+      env: Reflection<EnvInterface>;
+      /**
+       * The current env secrets reflection
+       */
+      secrets: Reflection<SecretsInterface>;
+    };
+    /**
+     * The parsed .env configuration object
+     *
+     * @remarks
+     * This value is the result of loading the .env configuration file found in the project root directory and merging it with the values provided at {@link EnvPluginOptions.values}
+     */
+    parsed: DotenvParseOutput;
+    /**
+     * The injected environment variables and secrets reflection
+     *
+     * @remarks
+     * This reflection contains the structure of the injected environment variables and secrets that were injected into the source code during the build process.
+     */
+    injected: Reflection;
+  };
+}
+declare type __ΩEnvType = any[];
+declare type __ΩEnvPluginOptions = any[];
+declare type __ΩEnvPluginUserConfig = any[];
+declare type __ΩEnvPluginResolvedConfig = any[];
+declare type __ΩEnvPluginContext = any[];
+//#endregion
+export { EnvType as a, __ΩEnvPluginResolvedConfig as c, EnvPluginUserConfig as i, __ΩEnvPluginUserConfig as l, EnvPluginOptions as n, __ΩEnvPluginContext as o, EnvPluginResolvedConfig as r, __ΩEnvPluginOptions as s, EnvPluginContext as t, __ΩEnvType as u };
+//# sourceMappingURL=plugin-CSe5f2cD.d.cts.map

package/dist/plugin-CSe5f2cD.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-CSe5f2cD.d.cts","names":[],"sources":["../src/types/plugin.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;KAyCY,OAAA;KAEA,gBAAA,GAAmB,KAAK;EAFxB;AAEZ;;EAA+B,KAAA,CAAA,EAIrB,uBAJqB;EAIrB;;;EAoCA,OAAA,CAAA,EA/BE,uBA+BF;EAQC;;;AAWX;;;EAES,MAAA,CAAA,EAAA,MAAA,GAAA,MAAA,EAAA;EAAgB;AAGzB;;;;EAEkB,MAAA,CAAA,EAAA,OAAA;EAAT;;;;;;EAwBO,aAAA,CAAA,EA1DE,QA0DF;EAAgB;AAYhC;;;;;EAiBW,KAAA,CAAA,EA/ED,kBA+EC;EAKI;;;;;;EAmCD,MAAA,CAAA,EA/GH,mBA+GG;EArDV;;;;;;UAlDM;;KAGE,mBAAA,GAAsB,wBAChC;OACO;;KAGG,uBAAA,GAA0B,4BACpC;OACO,SAAS,KAAK,2CACjB,SAAS,KAAK;;;;;;;WAOL;;;;;;;aAQE;;;;;;;YAQD;;;;;;;;;;UAYC,yCACS,0BAA0B,iCAGhD,mBAAmB,kBACnB,mBAAmB;;;;;;;;;;;;WAYZ;;;;eAKI;;;;;;;;;;;;WAaJ,WAAW;;;;eAKP,WAAW;;;;;;;;YASd;;;;;;;cAQE"}