@powerlines/plugin-nodejs 0.1.0 → 0.1.2

package/dist/plugin-babel/src/helpers/options.mjs

@@ -0,0 +1,47 @@
+import { getPluginName } from "./filters.mjs";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { isFunction } from "@stryke/type-checks/is-function";
+import chalk from "chalk";
+
+//#region ../plugin-babel/src/helpers/options.ts
+function resolvePluginFunction(context, plugin) {
+	try {
+		return Array.isArray(plugin) && plugin.length > 0 && plugin[0] ? isFunction(plugin[0]) ? plugin[0](context) : plugin[0] : isFunction(plugin) ? plugin(context) : plugin;
+	} catch {
+		return plugin[0];
+	}
+}
+/**
+* Resolve the [Babel](https://babeljs.io/) plugin.
+*
+* @param context - The context for the transformation.
+* @param code - The code to be transformed.
+* @param id - The ID of the source file.
+* @param plugin - The Babel plugin to resolve.
+* @returns The resolved Babel plugin options, or undefined if the plugin is filtered out.
+*/
+function resolveBabelPlugin(context, code, id, plugin) {
+	if (Array.isArray(plugin) && plugin.length > 0 && plugin[0]) {
+		if (plugin.length > 2 && plugin[2] && isFunction(plugin[2]) && !plugin[2](code, id)) {
+			context.log(LogLevelLabel.TRACE, `Skipping filtered Babel plugin ${chalk.bold.cyanBright(getPluginName(plugin) || "unnamed")} for ${id}`);
+			return;
+		}
+		return plugin.length > 2 ? [
+			resolvePluginFunction(context, plugin),
+			plugin[1],
+			plugin[2]
+		] : [
+			resolvePluginFunction(context, plugin),
+			plugin[1],
+			null
+		];
+	}
+	return [
+		resolvePluginFunction(context, plugin),
+		{},
+		null
+	];
+}
+
+//#endregion
+export { resolveBabelPlugin, resolvePluginFunction };

package/dist/plugin-babel/src/index.cjs

@@ -0,0 +1,91 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_filters = require('./helpers/filters.cjs');
+const require_options = require('./helpers/options.cjs');
+const require_create_plugin = require('./helpers/create-plugin.cjs');
+const require_module_helpers = require('./helpers/module-helpers.cjs');
+require('./helpers/index.cjs');
+let __babel_core = require("@babel/core");
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let __stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+
+//#region ../plugin-babel/src/index.ts
+/**
+* Babel plugin for Powerlines.
+*
+* @param options - The Babel plugin user configuration options.
+* @returns A Powerlines plugin that integrates Babel transformations.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "babel",
+		config() {
+			if (!(0, __stryke_type_checks_is_set_object.isSetObject)(options)) return;
+			return { transform: { babel: options } };
+		},
+		configResolved: {
+			order: "pre",
+			handler() {
+				this.devDependencies["@babel/core"] = "^7.28.4";
+				this.config.transform.babel = (0, defu.default)(this.config.transform.babel ?? {}, {
+					plugins: [],
+					presets: []
+				});
+			}
+		},
+		async transform(code, id) {
+			if ((0, __stryke_path_is_parent_path.isParentPath)(id, this.powerlinesPath) || code.includes("/* @storm-ignore */") || code.includes("/* @storm-disable */")) {
+				this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Skipping Babel transformation for: ${id}`);
+				return {
+					code,
+					id
+				};
+			}
+			this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Babel transforming file: ${id}`);
+			const plugins = this.config.transform.babel.plugins.map((plugin$1) => require_options.resolveBabelPlugin(this, code, id, plugin$1)).filter((plugin$1, _, arr) => plugin$1 && !require_filters.isDuplicatePlugin(arr, plugin$1));
+			const presets = this.config.transform.babel.presets.map((preset) => require_options.resolveBabelPlugin(this, code, id, preset)).filter((preset, _, arr) => preset && !require_filters.isDuplicatePlugin(arr, preset));
+			if (Array.isArray(plugins) && plugins.length === 0 && Array.isArray(presets) && presets.length === 0) return {
+				code,
+				id
+			};
+			if ([
+				"ts",
+				"cts",
+				"mts",
+				"tsx"
+			].includes((0, __stryke_path_file_path_fns.findFileExtensionSafe)(id)) && !require_filters.isDuplicatePlugin(plugins, "@babel/plugin-syntax-typescript") && !require_filters.isDuplicatePlugin(presets, "@babel/preset-typescript")) plugins.unshift(["@babel/plugin-syntax-typescript", { isTSX: (0, __stryke_path_file_path_fns.findFileExtension)(id) === ".tsx" }]);
+			const result = await (0, __babel_core.transformAsync)(code, {
+				highlightCode: true,
+				code: true,
+				ast: false,
+				cloneInputAst: false,
+				comments: true,
+				sourceType: "module",
+				configFile: false,
+				babelrc: false,
+				envName: this.config.mode,
+				caller: { name: this.config.framework },
+				...this.config.transform.babel ?? {},
+				filename: id,
+				plugins: plugins.map((plugin$1) => {
+					return Array.isArray(plugin$1) && plugin$1.length >= 2 ? [plugin$1[0], (0, defu.default)(plugin$1.length > 1 && plugin$1[1] ? plugin$1[1] : {}, { options })] : plugin$1;
+				}).filter(Boolean),
+				presets: presets.map((preset) => {
+					return Array.isArray(preset) && preset.length >= 2 ? [preset[0], (0, defu.default)(preset.length > 1 && preset[1] ? preset[1] : {}, { options })] : preset;
+				}).filter(Boolean)
+			});
+			if (!result?.code) throw new Error(`Powerlines - Babel plugin failed to compile ${id}`);
+			return {
+				code: result.code,
+				id
+			};
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+exports.default = src_default;

package/dist/plugin-babel/src/index.mjs

@@ -0,0 +1,89 @@
+import { getPluginName, isDuplicatePlugin } from "./helpers/filters.mjs";
+import { resolveBabelPlugin, resolvePluginFunction } from "./helpers/options.mjs";
+import { createBabelPlugin } from "./helpers/create-plugin.mjs";
+import { addImport, addImportsToProgram } from "./helpers/module-helpers.mjs";
+import "./helpers/index.mjs";
+import { transformAsync } from "@babel/core";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { findFileExtension, findFileExtensionSafe } from "@stryke/path/file-path-fns";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import defu from "defu";
+
+//#region ../plugin-babel/src/index.ts
+/**
+* Babel plugin for Powerlines.
+*
+* @param options - The Babel plugin user configuration options.
+* @returns A Powerlines plugin that integrates Babel transformations.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "babel",
+		config() {
+			if (!isSetObject(options)) return;
+			return { transform: { babel: options } };
+		},
+		configResolved: {
+			order: "pre",
+			handler() {
+				this.devDependencies["@babel/core"] = "^7.28.4";
+				this.config.transform.babel = defu(this.config.transform.babel ?? {}, {
+					plugins: [],
+					presets: []
+				});
+			}
+		},
+		async transform(code, id) {
+			if (isParentPath(id, this.powerlinesPath) || code.includes("/* @storm-ignore */") || code.includes("/* @storm-disable */")) {
+				this.log(LogLevelLabel.TRACE, `Skipping Babel transformation for: ${id}`);
+				return {
+					code,
+					id
+				};
+			}
+			this.log(LogLevelLabel.TRACE, `Babel transforming file: ${id}`);
+			const plugins = this.config.transform.babel.plugins.map((plugin$1) => resolveBabelPlugin(this, code, id, plugin$1)).filter((plugin$1, _, arr) => plugin$1 && !isDuplicatePlugin(arr, plugin$1));
+			const presets = this.config.transform.babel.presets.map((preset) => resolveBabelPlugin(this, code, id, preset)).filter((preset, _, arr) => preset && !isDuplicatePlugin(arr, preset));
+			if (Array.isArray(plugins) && plugins.length === 0 && Array.isArray(presets) && presets.length === 0) return {
+				code,
+				id
+			};
+			if ([
+				"ts",
+				"cts",
+				"mts",
+				"tsx"
+			].includes(findFileExtensionSafe(id)) && !isDuplicatePlugin(plugins, "@babel/plugin-syntax-typescript") && !isDuplicatePlugin(presets, "@babel/preset-typescript")) plugins.unshift(["@babel/plugin-syntax-typescript", { isTSX: findFileExtension(id) === ".tsx" }]);
+			const result = await transformAsync(code, {
+				highlightCode: true,
+				code: true,
+				ast: false,
+				cloneInputAst: false,
+				comments: true,
+				sourceType: "module",
+				configFile: false,
+				babelrc: false,
+				envName: this.config.mode,
+				caller: { name: this.config.framework },
+				...this.config.transform.babel ?? {},
+				filename: id,
+				plugins: plugins.map((plugin$1) => {
+					return Array.isArray(plugin$1) && plugin$1.length >= 2 ? [plugin$1[0], defu(plugin$1.length > 1 && plugin$1[1] ? plugin$1[1] : {}, { options })] : plugin$1;
+				}).filter(Boolean),
+				presets: presets.map((preset) => {
+					return Array.isArray(preset) && preset.length >= 2 ? [preset[0], defu(preset.length > 1 && preset[1] ? preset[1] : {}, { options })] : preset;
+				}).filter(Boolean)
+			});
+			if (!result?.code) throw new Error(`Powerlines - Babel plugin failed to compile ${id}`);
+			return {
+				code: result.code,
+				id
+			};
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+export { src_default as default };

package/dist/plugin-babel/src/types/index.d.mts

@@ -0,0 +1 @@
+import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "./plugin.mjs";

package/dist/plugin-babel/src/types/plugin.d.cts

@@ -0,0 +1,15 @@
+import { PluginContext } from "../../../powerlines/src/types/context.cjs";
+import { BabelUserConfig, UserConfig } from "../../../powerlines/src/types/config.cjs";
+import { BabelResolvedConfig, ResolvedConfig } from "../../../powerlines/src/types/resolved.cjs";
+
+//#region ../plugin-babel/src/types/plugin.d.ts
+type BabelPluginOptions = Partial<BabelUserConfig>;
+type BabelPluginUserConfig = UserConfig;
+interface BabelPluginResolvedConfig extends ResolvedConfig {
+  transform: {
+    babel: BabelResolvedConfig;
+  };
+}
+type BabelPluginContext<TResolvedConfig extends BabelPluginResolvedConfig = BabelPluginResolvedConfig> = PluginContext<TResolvedConfig>;
+//#endregion
+export { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig };

package/dist/plugin-babel/src/types/plugin.d.mts

@@ -0,0 +1,15 @@
+import { PluginContext } from "../../../powerlines/src/types/context.mjs";
+import { BabelUserConfig, UserConfig } from "../../../powerlines/src/types/config.mjs";
+import { BabelResolvedConfig, ResolvedConfig } from "../../../powerlines/src/types/resolved.mjs";
+
+//#region ../plugin-babel/src/types/plugin.d.ts
+type BabelPluginOptions = Partial<BabelUserConfig>;
+type BabelPluginUserConfig = UserConfig;
+interface BabelPluginResolvedConfig extends ResolvedConfig {
+  transform: {
+    babel: BabelResolvedConfig;
+  };
+}
+type BabelPluginContext<TResolvedConfig extends BabelPluginResolvedConfig = BabelPluginResolvedConfig> = PluginContext<TResolvedConfig>;
+//#endregion
+export { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig };

package/dist/plugin-env/src/babel/index.cjs

@@ -0,0 +1 @@
+const require_plugin = require('./plugin.cjs');

package/dist/plugin-env/src/babel/index.mjs

@@ -0,0 +1,3 @@
+import { envBabelPlugin } from "./plugin.mjs";
+
+export {  };

package/dist/plugin-env/src/babel/plugin.cjs

@@ -0,0 +1,121 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_create_plugin = require('../../../plugin-babel/src/helpers/create-plugin.cjs');
+const require_module_helpers = require('../../../plugin-babel/src/helpers/module-helpers.cjs');
+const require_capnp = require('../../../deepkit/src/capnp.cjs');
+const require_reflection = require('../../../deepkit/schemas/reflection2.cjs');
+const require_utilities = require('../../../deepkit/src/utilities.cjs');
+const require_persistence = require('../helpers/persistence.cjs');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __stryke_capnp = require("@stryke/capnp");
+__stryke_capnp = require_rolldown_runtime.__toESM(__stryke_capnp);
+let __stryke_fs_buffer = require("@stryke/fs/buffer");
+let node_fs = require("node:fs");
+
+//#region ../plugin-env/src/babel/plugin.ts
+const envBabelPlugin = require_create_plugin.createBabelPlugin("env", ({ log, context }) => {
+	function extractEnv(node, pass, isInjectable = false) {
+		const envTypesAliasProperties = context.env.types.env?.getProperties().filter((prop) => prop.getAlias().length > 0);
+		if (node.name) {
+			const prefix = context.config.env.prefix.find((pre) => node.name && node.name.startsWith(pre) && (context.env.types.env?.hasProperty(node.name.replace(`${pre}_`, "")) || envTypesAliasProperties.some((prop) => prop.getAlias().includes(node.name.replace(`${pre}_`, "")))));
+			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((prop) => prop.getAlias().includes(name))) {
+				const envProperty = context.env.types.env.hasProperty(name) ? context.env.types.env.getProperty(name) : envTypesAliasProperties.find((prop) => prop.getAlias().includes(name));
+				if (!envProperty || envProperty.isIgnored()) return;
+				if (!context.env.used.env.hasProperty(name)) 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((pre) => {
+							return context.env.parsed[`${pre.replace(/_$/g, "")}_${name}`];
+						});
+						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 require_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((a, b) => String(a).localeCompare(String(b))).map((typeDef) => ` - ${String(typeDef)} ${envTypesAliasProperties.some((prop) => prop.getNameAsString() === String(typeDef) && prop.getAlias().length > 0) ? `(Alias: ${envTypesAliasProperties?.find((prop) => prop.getNameAsString() === String(typeDef))?.getAlias().join(", ")})` : ""}`).join("\n")} \n\nUsing the following env prefix: \n${context.config.env.prefix.map((prefix$1) => ` - ${prefix$1}`).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`);
+		}
+	}
+	return {
+		visitor: { MemberExpression(path, pass) {
+			if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isIdentifier({ name: "$storm" }) && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				require_module_helpers.addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isCallExpression({ callee: {
+				name: "useStorm",
+				type: "Identifier"
+			} }) && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				require_module_helpers.addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			} else 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}`);
+				require_module_helpers.addImport(path, {
+					module: "storm: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}`);
+				require_module_helpers.addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			}
+		} },
+		post() {
+			log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Adding environment variables from ${this.filename || "unknown file"} to env.json.`);
+			let persistedEnv = __powerlines_deepkit_vendor_type.ReflectionClass.from({
+				kind: __powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
+				description: `An object containing the environment variables used by the application.`,
+				types: []
+			});
+			const reflectionPath = require_persistence.getEnvReflectionsPath(context, "env");
+			if (reflectionPath && (0, node_fs.existsSync)(reflectionPath)) {
+				log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Environment reflection file found at ${reflectionPath}, reading existing reflection.`);
+				persistedEnv = (0, __powerlines_deepkit_vendor_type.resolveClassType)((0, __powerlines_deepkit_vendor_type.deserializeType)(require_capnp.convertFromCapnp(new __stryke_capnp.Message((0, __stryke_fs_buffer.readFileBufferSync)(reflectionPath), false).getRoot(require_reflection.SerializedTypes).types)));
+			}
+			log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Adding new variables to env reflection at ${reflectionPath}.`);
+			persistedEnv.getProperties().filter((property) => property.getNameAsString() && !context.env.used.env.hasProperty(property.getNameAsString())).forEach((property) => {
+				context.env.used.env.addProperty({
+					...property,
+					name: property.getNameAsString(),
+					description: property.getDescription() ?? `The ${property.getNameAsString()} variable.`,
+					default: property.getDefaultValue(),
+					optional: property.isOptional() ? true : void 0,
+					readonly: property.isReadonly() ? true : void 0,
+					visibility: property.getVisibility(),
+					type: property.getType(),
+					tags: property.getTags()
+				});
+			});
+		}
+	};
+});
+
+//#endregion
+exports.envBabelPlugin = envBabelPlugin;

package/dist/plugin-env/src/babel/plugin.mjs

@@ -0,0 +1,119 @@
+import { createBabelPlugin } from "../../../plugin-babel/src/helpers/create-plugin.mjs";
+import { addImport } from "../../../plugin-babel/src/helpers/module-helpers.mjs";
+import { convertFromCapnp } from "../../../deepkit/src/capnp.mjs";
+import { SerializedTypes } from "../../../deepkit/schemas/reflection2.mjs";
+import { stringifyDefaultValue } from "../../../deepkit/src/utilities.mjs";
+import { getEnvReflectionsPath } from "../helpers/persistence.mjs";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { ReflectionClass, ReflectionKind, deserializeType, resolveClassType } from "@powerlines/deepkit/vendor/type";
+import * as capnp from "@stryke/capnp";
+import { readFileBufferSync } from "@stryke/fs/buffer";
+import { existsSync } from "node:fs";
+
+//#region ../plugin-env/src/babel/plugin.ts
+const envBabelPlugin = createBabelPlugin("env", ({ log, context }) => {
+	function extractEnv(node, pass, isInjectable = false) {
+		const envTypesAliasProperties = context.env.types.env?.getProperties().filter((prop) => prop.getAlias().length > 0);
+		if (node.name) {
+			const prefix = context.config.env.prefix.find((pre) => node.name && node.name.startsWith(pre) && (context.env.types.env?.hasProperty(node.name.replace(`${pre}_`, "")) || envTypesAliasProperties.some((prop) => prop.getAlias().includes(node.name.replace(`${pre}_`, "")))));
+			let name = node.name;
+			if (prefix) name = node.name.replace(`${prefix}_`, "");
+			log(LogLevelLabel.TRACE, `Environment variable ${name} found in ${pass.filename || "unknown file"}.`);
+			if (context.env.types.env?.hasProperty(name) || envTypesAliasProperties.some((prop) => prop.getAlias().includes(name))) {
+				const envProperty = context.env.types.env.hasProperty(name) ? context.env.types.env.getProperty(name) : envTypesAliasProperties.find((prop) => prop.getAlias().includes(name));
+				if (!envProperty || envProperty.isIgnored()) return;
+				if (!context.env.used.env.hasProperty(name)) 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((pre) => {
+							return context.env.parsed[`${pre.replace(/_$/g, "")}_${name}`];
+						});
+						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 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((a, b) => String(a).localeCompare(String(b))).map((typeDef) => ` - ${String(typeDef)} ${envTypesAliasProperties.some((prop) => prop.getNameAsString() === String(typeDef) && prop.getAlias().length > 0) ? `(Alias: ${envTypesAliasProperties?.find((prop) => prop.getNameAsString() === String(typeDef))?.getAlias().join(", ")})` : ""}`).join("\n")} \n\nUsing the following env prefix: \n${context.config.env.prefix.map((prefix$1) => ` - ${prefix$1}`).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`);
+		}
+	}
+	return {
+		visitor: { MemberExpression(path, pass) {
+			if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isIdentifier({ name: "$storm" }) && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isCallExpression({ callee: {
+				name: "useStorm",
+				type: "Identifier"
+			} }) && path.get("property")?.isIdentifier()) {
+				const identifier = path.get("property")?.node;
+				extractEnv(identifier, pass, false);
+				path.replaceWithSourceString(`env.${identifier.name}`);
+				addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			} else 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}`);
+				addImport(path, {
+					module: "storm: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}`);
+				addImport(path, {
+					module: "storm:env",
+					name: "env",
+					imported: "env"
+				});
+			}
+		} },
+		post() {
+			log(LogLevelLabel.TRACE, `Adding environment variables from ${this.filename || "unknown file"} to env.json.`);
+			let persistedEnv = ReflectionClass.from({
+				kind: ReflectionKind.objectLiteral,
+				description: `An object containing the environment variables used by the application.`,
+				types: []
+			});
+			const reflectionPath = getEnvReflectionsPath(context, "env");
+			if (reflectionPath && existsSync(reflectionPath)) {
+				log(LogLevelLabel.TRACE, `Environment reflection file found at ${reflectionPath}, reading existing reflection.`);
+				persistedEnv = resolveClassType(deserializeType(convertFromCapnp(new capnp.Message(readFileBufferSync(reflectionPath), false).getRoot(SerializedTypes).types)));
+			}
+			log(LogLevelLabel.TRACE, `Adding new variables to env reflection at ${reflectionPath}.`);
+			persistedEnv.getProperties().filter((property) => property.getNameAsString() && !context.env.used.env.hasProperty(property.getNameAsString())).forEach((property) => {
+				context.env.used.env.addProperty({
+					...property,
+					name: property.getNameAsString(),
+					description: property.getDescription() ?? `The ${property.getNameAsString()} variable.`,
+					default: property.getDefaultValue(),
+					optional: property.isOptional() ? true : void 0,
+					readonly: property.isReadonly() ? true : void 0,
+					visibility: property.getVisibility(),
+					type: property.getType(),
+					tags: property.getTags()
+				});
+			});
+		}
+	};
+});
+
+//#endregion
+export { envBabelPlugin };

package/dist/plugin-env/src/components/docs.cjs

@@ -0,0 +1,9 @@
+require('../../../plugin-alloy/src/core/contexts/context.cjs');
+require('../helpers/create-reflection-resource.cjs');
+require('../../../plugin-alloy/src/markdown/components/markdown-file.cjs');
+require('../../../plugin-alloy/src/markdown/components/markdown-table.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_path_join = require("@stryke/path/join");
+require("@alloy-js/markdown");

package/dist/plugin-env/src/components/docs.mjs

@@ -0,0 +1,11 @@
+import "../../../plugin-alloy/src/core/contexts/context.mjs";
+import "../helpers/create-reflection-resource.mjs";
+import "../../../plugin-alloy/src/markdown/components/markdown-file.mjs";
+import "../../../plugin-alloy/src/markdown/components/markdown-table.mjs";
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { stringifyType } from "@powerlines/deepkit/vendor/type";
+import { Show, code } from "@alloy-js/core";
+import { joinPaths } from "@stryke/path/join";
+import "@alloy-js/markdown";
+
+export {  };