@powerlines/plugin-env 0.14.21 → 0.14.22

package/dist/_virtual/rolldown_runtime.cjs

@@ -1 +1,37 @@
-var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(e,n,r,i)=>{i&&(t(e,Symbol.toStringTag,{value:`Module`}),r&&t(r,Symbol.toStringTag,{value:`Module`})),o(e,n,`default`),r&&o(r,n,`default`)},c=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));exports.__reExport=s,exports.__toESM=c;
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget, symbols) => {
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+		secondTarget && __defProp(secondTarget, Symbol.toStringTag, { value: "Module" });
+	}
+	__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default");
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__reExport = __reExport;
+exports.__toESM = __toESM;

package/dist/_virtual/rolldown_runtime.mjs

@@ -1 +1,29 @@
-var e=Object.defineProperty,t=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyNames,r=Object.prototype.hasOwnProperty,i=(i,a,o,s)=>{if(a&&typeof a==`object`||typeof a==`function`)for(var c=n(a),l=0,u=c.length,d;l<u;l++)d=c[l],!r.call(i,d)&&d!==o&&e(i,d,{get:(e=>a[e]).bind(null,d),enumerable:!(s=t(a,d))||s.enumerable});return i},a=(t,n,r,a)=>{a&&(e(t,Symbol.toStringTag,{value:`Module`}),r&&e(r,Symbol.toStringTag,{value:`Module`})),i(t,n,`default`),r&&i(r,n,`default`)};export{a as __reExport};
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget, symbols) => {
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+		secondTarget && __defProp(secondTarget, Symbol.toStringTag, { value: "Module" });
+	}
+	__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default");
+};
+
+//#endregion
+export { __reExport };

package/dist/babel/index.cjs

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

package/dist/babel/index.mjs

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

package/dist/babel/plugin.cjs

@@ -1,5 +1,121 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`),t=require(`../deepkit/src/vendor/type.cjs`),n=require(`../plugin-babel/src/helpers/create-plugin.cjs`),r=require(`../plugin-babel/src/helpers/module-helpers.cjs`),i=require(`../deepkit/src/capnp.cjs`),a=require(`../deepkit/schemas/reflection2.cjs`),o=require(`../deepkit/src/utilities.cjs`),s=require(`../helpers/persistence.cjs`);let c=require(`@storm-software/config-tools/types`),l=require(`@stryke/capnp`);l=e.__toESM(l);let u=require(`@stryke/fs/buffer`),d=require(`node:fs`);const f=n.createBabelPlugin(`env`,({log:e,context:n})=>{function f(t,r,i=!1){let a=n.env.types.env?.getProperties().filter(e=>e.getAlias().length>0);if(t.name){let s=n.config.env.prefix.find(e=>t.name&&t.name.startsWith(e)&&(n.env.types.env?.hasProperty(t.name.replace(`${e}_`,``))||a.some(n=>n.getAlias().includes(t.name.replace(`${e}_`,``))))),l=t.name;if(s&&(l=t.name.replace(`${s}_`,``)),e(c.LogLevelLabel.TRACE,`Environment variable ${l} found in ${r.filename||`unknown file`}.`),n.env.types.env?.hasProperty(l)||a.some(e=>e.getAlias().includes(l))){let e=n.env.types.env.hasProperty(l)?n.env.types.env.getProperty(l):a.find(e=>e.getAlias().includes(l));if(!e||e.isIgnored())return;if(n.env.used.env.hasProperty(l)||n.env.used.env.addProperty(e.property),n.config.env.inject&&i){let t=n.env.parsed?.[l];if(t===void 0){let e=n.config.env.prefix.find(e=>n.env.parsed[`${e.replace(/_$/g,``)}_${l}`]);e&&(t=n.env.parsed[`${e.replace(/_$/g,``)}_${l}`])}if(t??=e.getDefaultValue(),e.isValueRequired()&&t===void 0)throw Error(`Environment variable \`${l}\` is not defined in the .env configuration files`);return o.stringifyDefaultValue(e,t)}}else throw Error(`The "${l}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${r.filename?r.filename:`unknown`}.
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_type = require('../deepkit/src/vendor/type.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 __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");
 
-          The following environment configuration names are defined in the \`env\` type definition: \n${n.env.types.env?.getPropertyNames().sort((e,t)=>String(e).localeCompare(String(t))).map(e=>` - ${String(e)} ${a.some(t=>t.getNameAsString()===String(e)&&t.getAlias().length>0)?`(Alias: ${a?.find(t=>t.getNameAsString()===String(e))?.getAlias().join(`, `)})`:``}`).join(`
-`)} \n\nUsing the following env prefix: \n${n.config.env.prefix.map(e=>` - ${e}`).join(`
-`)} \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(e,t){if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isIdentifier({name:`$storm`})&&e.get(`property`)?.isIdentifier()){let n=e.get(`property`)?.node;f(n,t,!1),e.replaceWithSourceString(`env.${n.name}`),r.addImport(e,{module:`storm:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isCallExpression({callee:{name:`useStorm`,type:`Identifier`}})&&e.get(`property`)?.isIdentifier()){let n=e.get(`property`)?.node;f(n,t,!1),e.replaceWithSourceString(`env.${n.name}`),r.addImport(e,{module:`storm:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isIdentifier({name:`process`})&&e.get(`property`)?.isIdentifier()){let n=e.get(`property`)?.node;if(!n.name)return;f(n,t,!1),e.replaceWithSourceString(`env.${n.name}`),r.addImport(e,{module:`storm:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isMetaProperty()&&e.get(`property`)?.isIdentifier()){let n=e.get(`property`)?.node;if(!n.name)return;f(n,t,!1),e.replaceWithSourceString(`env.${n.name}`),r.addImport(e,{module:`storm:env`,name:`env`,imported:`env`})}}},post(){e(c.LogLevelLabel.TRACE,`Adding environment variables from ${this.filename||`unknown file`} to env.json.`);let r=t.type_exports.ReflectionClass.from({kind:t.type_exports.ReflectionKind.objectLiteral,description:`An object containing the environment variables used by the application.`,types:[]}),o=s.getEnvReflectionsPath(n,`env`);o&&(0,d.existsSync)(o)&&(e(c.LogLevelLabel.TRACE,`Environment reflection file found at ${o}, reading existing reflection.`),r=(0,t.type_exports.resolveClassType)((0,t.type_exports.deserializeType)(i.convertFromCapnp(new l.Message((0,u.readFileBufferSync)(o),!1).getRoot(a.SerializedTypes).types)))),e(c.LogLevelLabel.TRACE,`Adding new variables to env reflection at ${o}.`),r.getProperties().filter(e=>e.getNameAsString()&&!n.env.used.env.hasProperty(e.getNameAsString())).forEach(e=>{n.env.used.env.addProperty({...e,name:e.getNameAsString(),description:e.getDescription()??`The ${e.getNameAsString()} variable.`,default:e.getDefaultValue(),optional:e.isOptional()?!0:void 0,readonly:e.isReadonly()?!0:void 0,visibility:e.getVisibility(),type:e.getType(),tags:e.getTags()})})}}});exports.envBabelPlugin=f;
+//#region 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 = require_type.type_exports.ReflectionClass.from({
+				kind: require_type.type_exports.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, require_type.type_exports.resolveClassType)((0, require_type.type_exports.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/babel/plugin.d.cts

@@ -1,8 +1,7 @@
+import { DeclareBabelTransformPluginReturn } from "../powerlines/src/types/babel.cjs";
 import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.cjs";
-import "../index.cjs";
-import * as powerlines0 from "powerlines";
 
 //#region src/babel/plugin.d.ts
-declare const envBabelPlugin: powerlines0.DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
+declare const envBabelPlugin: DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
 //#endregion
 export { envBabelPlugin };

package/dist/babel/plugin.d.mts

@@ -1,8 +1,9 @@
+import { DeclareBabelTransformPluginReturn } from "../powerlines/src/types/babel.mjs";
+import "../powerlines/src/index.mjs";
 import { EnvPluginContext, EnvPluginResolvedConfig } from "../types/plugin.mjs";
 import "../index.mjs";
-import * as powerlines0 from "powerlines";
 
 //#region src/babel/plugin.d.ts
-declare const envBabelPlugin: powerlines0.DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
+declare const envBabelPlugin: DeclareBabelTransformPluginReturn<EnvPluginContext<EnvPluginResolvedConfig>, Record<string, any>>;
 //#endregion
 export { envBabelPlugin };

package/dist/babel/plugin.mjs

@@ -1,5 +1,119 @@
-import{type_exports as e}from"../deepkit/src/vendor/type.mjs";import{createBabelPlugin as t}from"../plugin-babel/src/helpers/create-plugin.mjs";import{addImport as n}from"../plugin-babel/src/helpers/module-helpers.mjs";import{convertFromCapnp as r}from"../deepkit/src/capnp.mjs";import{SerializedTypes as i}from"../deepkit/schemas/reflection2.mjs";import{stringifyDefaultValue as a}from"../deepkit/src/utilities.mjs";import{getEnvReflectionsPath as o}from"../helpers/persistence.mjs";import{LogLevelLabel as s}from"@storm-software/config-tools/types";import*as c from"@stryke/capnp";import{readFileBufferSync as l}from"@stryke/fs/buffer";import{existsSync as u}from"node:fs";const d=t(`env`,({log:t,context:d})=>{function f(e,n,r=!1){let i=d.env.types.env?.getProperties().filter(e=>e.getAlias().length>0);if(e.name){let o=d.config.env.prefix.find(t=>e.name&&e.name.startsWith(t)&&(d.env.types.env?.hasProperty(e.name.replace(`${t}_`,``))||i.some(n=>n.getAlias().includes(e.name.replace(`${t}_`,``))))),c=e.name;if(o&&(c=e.name.replace(`${o}_`,``)),t(s.TRACE,`Environment variable ${c} found in ${n.filename||`unknown file`}.`),d.env.types.env?.hasProperty(c)||i.some(e=>e.getAlias().includes(c))){let e=d.env.types.env.hasProperty(c)?d.env.types.env.getProperty(c):i.find(e=>e.getAlias().includes(c));if(!e||e.isIgnored())return;if(d.env.used.env.hasProperty(c)||d.env.used.env.addProperty(e.property),d.config.env.inject&&r){let t=d.env.parsed?.[c];if(t===void 0){let e=d.config.env.prefix.find(e=>d.env.parsed[`${e.replace(/_$/g,``)}_${c}`]);e&&(t=d.env.parsed[`${e.replace(/_$/g,``)}_${c}`])}if(t??=e.getDefaultValue(),e.isValueRequired()&&t===void 0)throw Error(`Environment variable \`${c}\` is not defined in the .env configuration files`);return a(e,t)}}else throw Error(`The "${c}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${n.filename?n.filename:`unknown`}.
+import { type_exports } from "../deepkit/src/vendor/type.mjs";
+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 * as capnp from "@stryke/capnp";
+import { readFileBufferSync } from "@stryke/fs/buffer";
+import { existsSync } from "node:fs";
 
-          The following environment configuration names are defined in the \`env\` type definition: \n${d.env.types.env?.getPropertyNames().sort((e,t)=>String(e).localeCompare(String(t))).map(e=>` - ${String(e)} ${i.some(t=>t.getNameAsString()===String(e)&&t.getAlias().length>0)?`(Alias: ${i?.find(t=>t.getNameAsString()===String(e))?.getAlias().join(`, `)})`:``}`).join(`
-`)} \n\nUsing the following env prefix: \n${d.config.env.prefix.map(e=>` - ${e}`).join(`
-`)} \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(e,t){if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isIdentifier({name:`$storm`})&&e.get(`property`)?.isIdentifier()){let r=e.get(`property`)?.node;f(r,t,!1),e.replaceWithSourceString(`env.${r.name}`),n(e,{module:`storm:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isCallExpression({callee:{name:`useStorm`,type:`Identifier`}})&&e.get(`property`)?.isIdentifier()){let r=e.get(`property`)?.node;f(r,t,!1),e.replaceWithSourceString(`env.${r.name}`),n(e,{module:`storm:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isIdentifier({name:`process`})&&e.get(`property`)?.isIdentifier()){let r=e.get(`property`)?.node;if(!r.name)return;f(r,t,!1),e.replaceWithSourceString(`env.${r.name}`),n(e,{module:`storm:env`,name:`env`,imported:`env`})}else if(e.get(`object`)?.get(`property`)?.isIdentifier({name:`env`})&&e.get(`object`)?.get(`object`)?.isMetaProperty()&&e.get(`property`)?.isIdentifier()){let r=e.get(`property`)?.node;if(!r.name)return;f(r,t,!1),e.replaceWithSourceString(`env.${r.name}`),n(e,{module:`storm:env`,name:`env`,imported:`env`})}}},post(){t(s.TRACE,`Adding environment variables from ${this.filename||`unknown file`} to env.json.`);let n=e.ReflectionClass.from({kind:e.ReflectionKind.objectLiteral,description:`An object containing the environment variables used by the application.`,types:[]}),a=o(d,`env`);a&&u(a)&&(t(s.TRACE,`Environment reflection file found at ${a}, reading existing reflection.`),n=(0,e.resolveClassType)((0,e.deserializeType)(r(new c.Message(l(a),!1).getRoot(i).types)))),t(s.TRACE,`Adding new variables to env reflection at ${a}.`),n.getProperties().filter(e=>e.getNameAsString()&&!d.env.used.env.hasProperty(e.getNameAsString())).forEach(e=>{d.env.used.env.addProperty({...e,name:e.getNameAsString(),description:e.getDescription()??`The ${e.getNameAsString()} variable.`,default:e.getDefaultValue(),optional:e.isOptional()?!0:void 0,readonly:e.isReadonly()?!0:void 0,visibility:e.getVisibility(),type:e.getType(),tags:e.getTags()})})}}});export{d as envBabelPlugin};
+//#region 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 = type_exports.ReflectionClass.from({
+				kind: type_exports.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 = (0, type_exports.resolveClassType)((0, type_exports.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/components/docs.cjs

@@ -1 +1,71 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`),t=require(`../deepkit/src/vendor/type.cjs`),n=require(`../helpers/create-reflection-resource.cjs`);let r=require(`@alloy-js/core/jsx-runtime`),i=require(`@alloy-js/core`),a=require(`@stryke/path/join`),o=require(`@powerlines/alloy/core/contexts/context`),s=require(`@alloy-js/markdown`),c=require(`@powerlines/alloy/markdown/components/markdown-file`),l=require(`@powerlines/alloy/markdown/components/markdown-table`);function u(){let e=(0,o.usePowerlines)();if(!e)return null;let u=n.createReflectionResource(e);return(0,r.createComponent)(c.MarkdownFile,{get path(){return(0,a.joinPaths)(e.config.projectRoot,`docs`,`generated`,`env.md`)},get children(){return[(0,r.createComponent)(s.Heading,{level:1,children:`Environment Configuration`}),i.code`Below is a list of environment variables used by the`,(0,r.createComponent)(i.Show,{get when(){return!!e?.packageJson.name},get children(){return(0,r.createComponent)(s.Link,{get href(){return`https://www.npmjs.com/package/${e?.packageJson.name}`},get title(){return e.packageJson.name}})}}),i.code`package. These values can be updated in the \`.env\` file in the root of the project.`,(0,r.createIntrinsic)(`hbr`,{}),(0,r.createComponent)(s.Heading,{level:2,children:`Environment Variables`}),i.code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,(0,r.createIntrinsic)(`hbr`,{}),(0,r.createComponent)(l.MarkdownTable,{get data(){return u.data?.getProperties().filter(e=>e.getNameAsString()!==`__STORM_INJECTED__`).sort((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString())).map(e=>({name:e.getNameAsString().trim(),description:(e.getDescription()??``).trim(),type:(0,t.type_exports.stringifyType)(e.getType()).trim().replaceAll(` | `,`, or `),defaultValue:e.hasDefault()?String(e.getDefaultValue())?.includes(`"`)?e.getDefaultValue():`\`${e.getDefaultValue()}\``:``,required:e.isValueRequired()?``:`✔`}))??[]}})]}})}exports.EnvDocs=u;
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_type = require('../deepkit/src/vendor/type.cjs');
+const require_create_reflection_resource = require('../helpers/create-reflection-resource.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_path_join = require("@stryke/path/join");
+let __powerlines_alloy_core_contexts_context = require("@powerlines/alloy/core/contexts/context");
+let __alloy_js_markdown = require("@alloy-js/markdown");
+let __powerlines_alloy_markdown_components_markdown_file = require("@powerlines/alloy/markdown/components/markdown-file");
+let __powerlines_alloy_markdown_components_markdown_table = require("@powerlines/alloy/markdown/components/markdown-table");
+
+//#region src/components/docs.tsx
+/**
+* Generates the environment configuration markdown documentation for the Powerlines project.
+*/
+function EnvDocs() {
+	const context = (0, __powerlines_alloy_core_contexts_context.usePowerlines)();
+	if (!context) return null;
+	const reflection = require_create_reflection_resource.createReflectionResource(context);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_markdown_components_markdown_file.MarkdownFile, {
+		get path() {
+			return (0, __stryke_path_join.joinPaths)(context.config.projectRoot, "docs", "generated", "env.md");
+		},
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
+					level: 1,
+					children: "Environment Configuration"
+				}),
+				__alloy_js_core.code`Below is a list of environment variables used by the`,
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+					get when() {
+						return !!context?.packageJson.name;
+					},
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Link, {
+							get href() {
+								return `https://www.npmjs.com/package/${context?.packageJson.name}`;
+							},
+							get title() {
+								return context.packageJson.name;
+							}
+						});
+					}
+				}),
+				__alloy_js_core.code`package. These values can be updated in the \`.env\` file in the root of the project.`,
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
+					level: 2,
+					children: "Environment Variables"
+				}),
+				__alloy_js_core.code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
+					return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
+						return {
+							name: reflectionProperty.getNameAsString().trim(),
+							description: (reflectionProperty.getDescription() ?? "").trim(),
+							type: (0, require_type.type_exports.stringifyType)(reflectionProperty.getType()).trim().replaceAll(" | ", ", or "),
+							defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
+							required: reflectionProperty.isValueRequired() ? "" : "✔"
+						};
+					}) ?? [];
+				} })
+			];
+		}
+	});
+}
+
+//#endregion
+exports.EnvDocs = EnvDocs;

package/dist/components/docs.mjs

@@ -1 +1,70 @@
-import{type_exports as e}from"../deepkit/src/vendor/type.mjs";import{createReflectionResource as t}from"../helpers/create-reflection-resource.mjs";import{createComponent as n,createIntrinsic as r}from"@alloy-js/core/jsx-runtime";import{Show as i,code as a}from"@alloy-js/core";import{joinPaths as o}from"@stryke/path/join";import{usePowerlines as s}from"@powerlines/alloy/core/contexts/context";import{Heading as c,Link as l}from"@alloy-js/markdown";import{MarkdownFile as u}from"@powerlines/alloy/markdown/components/markdown-file";import{MarkdownTable as d}from"@powerlines/alloy/markdown/components/markdown-table";function f(){let f=s();if(!f)return null;let p=t(f);return n(u,{get path(){return o(f.config.projectRoot,`docs`,`generated`,`env.md`)},get children(){return[n(c,{level:1,children:`Environment Configuration`}),a`Below is a list of environment variables used by the`,n(i,{get when(){return!!f?.packageJson.name},get children(){return n(l,{get href(){return`https://www.npmjs.com/package/${f?.packageJson.name}`},get title(){return f.packageJson.name}})}}),a`package. These values can be updated in the \`.env\` file in the root of the project.`,r(`hbr`,{}),n(c,{level:2,children:`Environment Variables`}),a`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,r(`hbr`,{}),n(d,{get data(){return p.data?.getProperties().filter(e=>e.getNameAsString()!==`__STORM_INJECTED__`).sort((e,t)=>e.getNameAsString().localeCompare(t.getNameAsString())).map(t=>({name:t.getNameAsString().trim(),description:(t.getDescription()??``).trim(),type:(0,e.stringifyType)(t.getType()).trim().replaceAll(` | `,`, or `),defaultValue:t.hasDefault()?String(t.getDefaultValue())?.includes(`"`)?t.getDefaultValue():`\`${t.getDefaultValue()}\``:``,required:t.isValueRequired()?``:`✔`}))??[]}})]}})}export{f as EnvDocs};
+import { type_exports } from "../deepkit/src/vendor/type.mjs";
+import { createReflectionResource } from "../helpers/create-reflection-resource.mjs";
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { Show, code } from "@alloy-js/core";
+import { joinPaths } from "@stryke/path/join";
+import { usePowerlines } from "@powerlines/alloy/core/contexts/context";
+import { Heading, Link } from "@alloy-js/markdown";
+import { MarkdownFile } from "@powerlines/alloy/markdown/components/markdown-file";
+import { MarkdownTable } from "@powerlines/alloy/markdown/components/markdown-table";
+
+//#region src/components/docs.tsx
+/**
+* Generates the environment configuration markdown documentation for the Powerlines project.
+*/
+function EnvDocs() {
+	const context = usePowerlines();
+	if (!context) return null;
+	const reflection = createReflectionResource(context);
+	return createComponent(MarkdownFile, {
+		get path() {
+			return joinPaths(context.config.projectRoot, "docs", "generated", "env.md");
+		},
+		get children() {
+			return [
+				createComponent(Heading, {
+					level: 1,
+					children: "Environment Configuration"
+				}),
+				code`Below is a list of environment variables used by the`,
+				createComponent(Show, {
+					get when() {
+						return !!context?.packageJson.name;
+					},
+					get children() {
+						return createComponent(Link, {
+							get href() {
+								return `https://www.npmjs.com/package/${context?.packageJson.name}`;
+							},
+							get title() {
+								return context.packageJson.name;
+							}
+						});
+					}
+				}),
+				code`package. These values can be updated in the \`.env\` file in the root of the project.`,
+				createIntrinsic("hbr", {}),
+				createComponent(Heading, {
+					level: 2,
+					children: "Environment Variables"
+				}),
+				code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
+				createIntrinsic("hbr", {}),
+				createComponent(MarkdownTable, { get data() {
+					return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
+						return {
+							name: reflectionProperty.getNameAsString().trim(),
+							description: (reflectionProperty.getDescription() ?? "").trim(),
+							type: (0, type_exports.stringifyType)(reflectionProperty.getType()).trim().replaceAll(" | ", ", or "),
+							defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
+							required: reflectionProperty.isValueRequired() ? "" : "✔"
+						};
+					}) ?? [];
+				} })
+			];
+		}
+	});
+}
+
+//#endregion
+export { EnvDocs };