@powerlines/plugin-env 0.16.183 → 0.16.185

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;YAiEY,MAAA;IACR,GAAA,GAAM,gBAAA;EAAA;AAAA;;;;cAOG,MAAA,oBAA2B,gBAAA,GAAmB,gBAAA,EACzD,OAAA,GAAS,gBAAA,KAgeJ,MAAA,CAAO,QAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;YAiEY,MAAA;IACR,GAAA,GAAM,gBAAA;EAAA;AAAA;;;;cAOG,MAAA,oBAA2B,gBAAA,GAAmB,gBAAA,EACzD,OAAA,GAAS,gBAAA,KA8dJ,MAAA,CAAO,QAAA"}

package/dist/index.mjs

@@ -1,8 +1,293 @@
-import{__ΩEnvPluginContext as e,__ΩEnvPluginOptions as t,__ΩEnvPluginResolvedConfig as n,__ΩEnvPluginUserConfig as r,__ΩEnvType as i}from"./types/plugin.mjs";import{__ΩEnvInterface as a,__ΩSecretsInterface as o}from"./types/env.mjs";import{reflectEnv as s,reflectSecrets as c}from"./helpers/reflect.mjs";import{getEnvDefaultTypeDefinition as l,getEnvReflectionsPath as u,getEnvTypeReflectionsPath as d,getSecretsDefaultTypeDefinition as f,readEnvReflection as p,readEnvTypeReflection as m,readSecretsReflection as h,writeEnvReflection as g,writeEnvTypeReflection as _}from"./helpers/persistence.mjs";import{loadEnv as v}from"./helpers/load.mjs";import{env as y}from"./helpers/automd-generator.mjs";import{EnvDocsFile as b}from"./components/docs.mjs";import{EnvBuiltin as x}from"./components/env-builtin.mjs";import{envBabelPlugin as S}from"./babel/plugin.mjs";import{ReflectionClass as C,ReflectionKind as w}from"@powerlines/deepkit/vendor/type";import T from"defu";import{VIRTUAL_MODULE_PREFIX as E}from"powerlines/constants";import{getDocsOutputPath as D}from"powerlines/plugin-utils";import{createComponent as O}from"@alloy-js/core/jsx-runtime";import{joinPaths as k}from"@stryke/path/join";import{getUnique as A}from"@stryke/helpers/get-unique";import{render as j}from"@powerlines/plugin-alloy/render";import M from"@powerlines/plugin-automd";import N from"@powerlines/plugin-babel";import P from"@powerlines/plugin-deepkit";import{parseTypeDefinition as F}from"@stryke/convert/parse-type-definition";import{toArray as I}from"@stryke/convert/to-array";import{existsSync as L}from"@stryke/fs/exists";import{constantCase as R}from"@stryke/string-format/constant-case";import{isSetString as z}from"@stryke/type-checks/is-set-string";function B(e,t){return e.__type=t,e}const V=B((t={})=>[P(t.deepkit),N(t.babel),{name:`env`,async config(){this.debug("Providing default configuration for the Powerlines `env` build plugin.");let e={env:T(t,{types:{},validate:!1,inject:!1,prefix:[]}),babel:{plugins:[S]},deepkit:{reflection:`default`,level:`all`},tsc:{}};if(z(e.env.types)||e.env.types&&z(e.env.types.file)){e.env.types=F(e.env.types);let t=await this.fs.resolve(e.env.types.file);t&&(e.env.types.file=t)}else{this.warn("The `env.types` configuration parameter was not provided. Please ensure this is expected.");let t=await l(this),n=await this.fs.resolve(t.file);n&&(e.env.types=F(`${n}#${t.name}`))}if(z(e.env.secrets)||e.env.secrets&&z(e.env.secrets.file)){e.env.secrets=F(e.env.secrets);let t=await this.fs.resolve(e.env.secrets.file);t&&(e.env.secrets.file=t)}else{let t=await f(this),n=await this.fs.resolve(t.file);n&&(e.env.secrets=F(`${n}#${t.name}`))}return(e.env.types||e.env.secrets)&&(e.tsc.filter={id:[RegExp(`^(${E})?${k(this.builtinsPath,`env.ts`).replace(/\\/g,`\\\\`).replace(/\//g,`\\/`).replace(/\./g,`\\.`).replace(/\$/g,`\\$`)}$`)]}),e.env.prefix=I(e.env.prefix??[]).reduce(B((e,t)=>{let n=R(t);return e.includes(n)||e.push(n),e},[`ret`,`prefix`,``,`P&F2!&2""/#`]),[`POWERLINES_`,this.config.framework&&this.config.framework!==`powerlines`&&`${R(this.config.framework)}_`].filter(Boolean)),e.env.prefix=A(I(e.env.prefix).reduce(B((e,t)=>(e.includes(t.replace(/_$/g,``))||e.push(t.replace(/_$/g,``)),e),[`ret`,`prefix`,``,`P"2!"2""/#`]),[])),this.info({meta:{category:`env`},message:`Environment configuration definition file: ${e.env.types.file}${e.env.types.name?`#${e.env.types.name}`:``}${e.env.secrets?`\nSecrets configuration definition file: ${e.env.secrets?.file}${e.env.secrets?.name?`#${e.env.secrets?.name}`:``}`:``}\nEnvironment variable Prefixes: ${e.env.prefix.join(`, `)}\nShould inject values: ${e.env.inject?`Yes`:`No`}\nShould validate configuration: ${e.env.validate?`Yes`:`No`}`}),e},async configResolved(){if(this.debug(`Environment plugin configuration has been resolved for the Powerlines project.`),this.env=T({parsed:await v(this,this.config.env)},this.env??{},{types:{env:{}},used:{env:{},secrets:{}},parsed:{},injected:{}}),this.config.command!==`prepare`&&!this.config.skipCache&&this.persistedMeta?.checksum===this.meta.checksum&&L(d(this,`env`)))this.debug(`Skipping reflection initialization as the meta checksum has not changed.`),this.env.types.env=await m(this,`env`),this.debug({meta:{category:`env`},message:`Found the following environment configuration parameter definitions: \n${this.env.types.env.getProperties().map(B(e=>`- ${e.getNameAsString()}${e.getAlias().length>0?` (aliases: ${e.getAlias().join(`, `)})`:``}`,[`prop`,``,`P"2!"/"`])).join(`
-`)}`}),L(u(this,`env`))&&(this.env.used.env=await p(this),this.debug({meta:{category:`env`},message:`Found the following environment configuration parameters used in project: \n${this.env.used.env.getProperties().map(B(e=>`- ${e.getNameAsString()}${e.getAlias().length>0?` (aliases: ${e.getAlias().join(`, `)})`:``}`,[`prop`,``,`P"2!"/"`])).join(`
-`)}`})),L(d(this,`secrets`))&&(this.env.types.secrets=await m(this,`secrets`),this.env.types.secrets.getProperties().length>0&&this.debug({meta:{category:`env`},message:`Found the following secret configuration parameter definitions: \n${this.env.types.secrets.getProperties().map(B(e=>`- ${e.getNameAsString()} (aliases: ${e.getAlias().join(`, `)})`,[`prop`,``,`P"2!"/"`])).join(`
-`)}`})),L(u(this,`secrets`))&&(this.env.used.secrets=await h(this),this.env.used.secrets.getProperties().length>0&&this.debug({meta:{category:`env`},message:`Found the following secret configuration parameters used in project: \n${this.env.used.secrets.getProperties().map(B(e=>`- ${e.getNameAsString()} (aliases: ${e.getAlias().join(`, `)})`,[`prop`,``,`P"2!"/"`])).join(`
-`)}`}));else{if(this.debug(`Starting environment configuration reflection initialization.`),this.env.types.env=await s(this,this.config.env.types?.file,this.config.env.types?.name),!this.env.types.env)throw Error(`Failed to find the environment configuration type reflection in the context.`);if(this.debug({meta:{category:`env`},message:`Found the following environment configuration parameter definitions: \n${this.env.types.env.getProperties().map(B(e=>`- ${e.getNameAsString()} (aliases: ${e.getAlias().join(`, `)})`,[`prop`,``,`P"2!"/"`])).join(`
-`)}`}),await _(this,this.env.types.env,`env`),this.env.types.secrets=await c(this,this.config.env.secrets?.file,this.config.env.secrets?.name),!this.env.types.secrets)throw Error(`Failed to find the secrets configuration type reflection in the context.`);this.env.types.secrets.getProperties().length>0&&this.debug({meta:{category:`env`},message:`Found the following secret configuration parameter definitions: \n${this.env.types.secrets.getProperties().map(B(e=>`- ${e.getNameAsString()} (aliases: ${e.getAlias().join(`, `)})`,[`prop`,``,`P"2!"/"`])).join(`
-`)}`}),await _(this,this.env.types.secrets,`secrets`),this.info({meta:{category:`env`},message:`Resolved ${this.env.types.env.getProperties().length??0} environment configuration parameters and ${this.env.types.secrets?.getProperties().length??0} secret configuration parameters`});let e=this.env.types.env.getProperties().filter(B(e=>e.getAlias().length>0,[`prop`,``,`P"2!"/"`]));Object.entries(await v(this,this.config.env)).forEach(B(([t,n])=>{let r=this.config.env.prefix.reduce(B((e,n)=>t.replace(/_$/g,``).startsWith(n)?t.replace(/_$/g,``).slice(n.length):e,[`ret`,`prefix`,``,`P"2!"2""/#`]),t),i=e.find(B(e=>e?.getAlias().reverse().includes(r),[`prop`,``,`P"2!"/"`]));(this.env.types.env?.hasProperty(r)||i)&&this.env.types.env.getProperty(r).setDefaultValue(n)},[`param0`,``,`P"2!"/"`])),this.env.used.env=new C({kind:w.objectLiteral,typeName:`Env`,description:`An object containing the environment configuration parameters used by the ${this.config.name?`${this.config.name} application`:`application`}.`,types:[]},this.env.types.env),await g(this,this.env.used.env,`env`),this.env.types.secrets&&(await _(this,this.env.types.secrets,`secrets`),this.env.used.secrets=new C({kind:w.objectLiteral,typeName:`Secrets`,description:`An object containing the secret configuration parameters used by the ${this.config.name?`${this.config.name} application`:`application`}.`,types:[]},this.env.types.secrets),await g(this,this.env.used.secrets,`secrets`))}},prepare:B(async function(){let e=this;this.debug(`Preparing the Environment runtime artifacts for the Powerlines project.`);let t=await m(this,`env`);return j(this,O(x,{get defaultConfig(){return e.config.env.defaultConfig},reflection:t}))},[`prepare`,`P"/!`]),transform:{order:`post`,handler:B(async function(){this.env.used.env.getProperties().length>0&&(this.trace(`Persisting used environment configuration reflections to ${u(this,`env`)}.`),await g(this,this.env.used.env,`env`)),this.env.used.secrets.getProperties().length>0&&(this.trace(`Persisting used secret configuration reflections to ${u(this,`secrets`)}.`),await g(this,this.env.used.secrets,`secrets`))},[`handler`,`P"/!`])},docs:B(async function(){this.debug(`Documenting environment variables configuration values in "${k(D(this.config.root),`env.md`)}"`);let e=await m(this,`env`);return j(this,O(b,{levelOffset:0,reflection:e}))},[`docs`,`P"/!`]),buildEnd:B(async function(){let e=u(this,`env`);this.debug(`Writing env reflection types to ${e}.`),await g(this,this.env.used.env,`env`)},[`buildEnd`,`P"/!`])},{name:`env:automd-generator`,config:B(function(){return{automd:T(t.automd??{},{generators:{env:y(this)}})}},[`config`,`P"/!`])},{name:`env:vite`,vite:{configResolved:B(function(){return{envPrefix:this.config?.env?.prefix}},[()=>e,`this`,`configResolved`,`Pn!2""/#`])}},M(t.automd)],[()=>t,`options`,()=>({}),``,`Pn!2">#"/$`]);export{a as __ΩEnvInterface,e as __ΩEnvPluginContext,t as __ΩEnvPluginOptions,n as __ΩEnvPluginResolvedConfig,r as __ΩEnvPluginUserConfig,i as __ΩEnvType,o as __ΩSecretsInterface,V as default,V as plugin};
+import { __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType } from "./types/plugin.mjs";
+import { __ΩEnvInterface, __ΩSecretsInterface } from "./types/env.mjs";
+import { reflectEnv, reflectSecrets } from "./helpers/reflect.mjs";
+import { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, writeEnvReflection, writeEnvTypeReflection } from "./helpers/persistence.mjs";
+import { loadEnv } from "./helpers/load.mjs";
+import { env } from "./helpers/automd-generator.mjs";
+import { EnvDocsFile } from "./components/docs.mjs";
+import { EnvBuiltin } from "./components/env-builtin.mjs";
+import { envBabelPlugin } from "./babel/plugin.mjs";
+import { ReflectionClass, ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import defu from "defu";
+import { VIRTUAL_MODULE_PREFIX } from "powerlines/constants";
+import { getDocsOutputPath } from "powerlines/plugin-utils";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { joinPaths } from "@stryke/path/join";
+import { getUnique } from "@stryke/helpers/get-unique";
+import { render } from "@powerlines/plugin-alloy/render";
+import automd from "@powerlines/plugin-automd";
+import babel from "@powerlines/plugin-babel";
+import deepkit from "@powerlines/plugin-deepkit";
+import { parseTypeDefinition } from "@stryke/convert/parse-type-definition";
+import { toArray } from "@stryke/convert/to-array";
+import { existsSync } from "@stryke/fs/exists";
+import { constantCase } from "@stryke/string-format/constant-case";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+
+//#region src/index.tsx
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* A Powerlines plugin to inject environment variables into the source code.
+*/
+const plugin = __assignType((options = {}) => {
+	return [
+		deepkit(options.deepkit),
+		babel(options.babel),
+		{
+			name: "env",
+			async config() {
+				this.debug("Providing default configuration for the Powerlines `env` build plugin.");
+				const config = {
+					env: defu(options, {
+						types: {},
+						validate: false,
+						inject: false,
+						prefix: []
+					}),
+					babel: { plugins: [envBabelPlugin] },
+					deepkit: {
+						reflection: "default",
+						level: "all"
+					},
+					tsc: {}
+				};
+				if (!isSetString(config.env.types) && !isSetString(config.env.types?.file)) {
+					this.warn("The `env.types` configuration parameter was not provided. Please ensure this is expected.");
+					config.env.types = await getEnvDefaultTypeDefinition(this);
+				}
+				if (!isSetString(config.env.secrets) && !isSetString(config.env.secrets?.file)) config.env.secrets = await getSecretsDefaultTypeDefinition(this);
+				if (config.env.types || config.env.secrets) config.tsc.filter = { id: [new RegExp(`^(${VIRTUAL_MODULE_PREFIX})?${joinPaths(this.builtinsPath, "env.ts").replace(/\\/g, "\\\\").replace(/\//g, "\\/").replace(/\./g, "\\.").replace(/\$/g, "\\$")}$`)] };
+				config.env.prefix = toArray(config.env.prefix ?? []).reduce(__assignType((ret, prefix) => {
+					const formattedPrefix = constantCase(prefix);
+					if (!ret.includes(formattedPrefix)) ret.push(formattedPrefix);
+					return ret;
+				}, [
+					"ret",
+					"prefix",
+					"",
+					"P&F2!&2\"\"/#"
+				]), ["POWERLINES_", this.config.framework && this.config.framework !== "powerlines" && `${constantCase(this.config.framework)}_`].filter(Boolean));
+				config.env.prefix = getUnique(toArray(config.env.prefix).reduce(__assignType((ret, prefix) => {
+					if (!ret.includes(prefix.replace(/_$/g, ""))) ret.push(prefix.replace(/_$/g, ""));
+					return ret;
+				}, [
+					"ret",
+					"prefix",
+					"",
+					"P\"2!\"2\"\"/#"
+				]), []));
+				return config;
+			},
+			async configResolved() {
+				this.debug(`Environment plugin configuration has been resolved for the Powerlines project.`);
+				this.env = defu({ parsed: await loadEnv(this, this.config.env) }, this.env ?? {}, {
+					types: { env: {} },
+					used: {
+						env: {},
+						secrets: {}
+					},
+					parsed: {},
+					injected: {}
+				});
+				if (isSetString(this.config.env.types) || this.config.env.types && isSetString(this.config.env.types.file)) {
+					this.config.env.types = parseTypeDefinition(this.config.env.types);
+					const file = await this.fs.resolve(this.config.env.types.file);
+					if (file) this.config.env.types.file = file;
+				}
+				if (isSetString(this.config.env.secrets) || this.config.env.secrets && isSetString(this.config.env.secrets.file)) {
+					this.config.env.secrets = parseTypeDefinition(this.config.env.secrets);
+					const file = await this.fs.resolve(this.config.env.secrets.file);
+					if (file) this.config.env.secrets.file = file;
+				}
+				this.info({
+					meta: { category: "env" },
+					message: `Environment configuration definition file: ${this.config.env.types.file}${this.config.env.types.name ? `#${this.config.env.types.name}` : ""}${this.config.env.secrets ? `\nSecrets configuration definition file: ${this.config.env.secrets?.file}${this.config.env.secrets?.name ? `#${this.config.env.secrets?.name}` : ""}` : ""}\nEnvironment variable Prefixes: ${this.config.env.prefix.join(", ")}\nShould inject values: ${this.config.env.inject ? "Yes" : "No"}\nShould validate configuration: ${this.config.env.validate ? "Yes" : "No"}`
+				});
+				if (this.config.command !== "prepare" && !this.config.skipCache && this.persistedMeta?.checksum === this.meta.checksum && existsSync(getEnvTypeReflectionsPath(this, "env"))) {
+					this.debug(`Skipping reflection initialization as the meta checksum has not changed.`);
+					this.env.types.env = await readEnvTypeReflection(this, "env");
+					this.debug({
+						meta: { category: "env" },
+						message: `Found the following environment configuration parameter definitions: \n${this.env.types.env.getProperties().map(__assignType((prop) => `- ${prop.getNameAsString()}${prop.getAlias().length > 0 ? ` (aliases: ${prop.getAlias().join(", ")})` : ""}`, [
+							"prop",
+							"",
+							"P\"2!\"/\""
+						])).join("\n")}`
+					});
+					if (existsSync(getEnvReflectionsPath(this, "env"))) {
+						this.env.used.env = await readEnvReflection(this);
+						this.debug({
+							meta: { category: "env" },
+							message: `Found the following environment configuration parameters used in project: \n${this.env.used.env.getProperties().map(__assignType((prop) => `- ${prop.getNameAsString()}${prop.getAlias().length > 0 ? ` (aliases: ${prop.getAlias().join(", ")})` : ""}`, [
+								"prop",
+								"",
+								"P\"2!\"/\""
+							])).join("\n")}`
+						});
+					}
+					if (existsSync(getEnvTypeReflectionsPath(this, "secrets"))) {
+						this.env.types.secrets = await readEnvTypeReflection(this, "secrets");
+						if (this.env.types.secrets.getProperties().length > 0) this.debug({
+							meta: { category: "env" },
+							message: `Found the following secret configuration parameter definitions: \n${this.env.types.secrets.getProperties().map(__assignType((prop) => `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(", ")})`, [
+								"prop",
+								"",
+								"P\"2!\"/\""
+							])).join("\n")}`
+						});
+					}
+					if (existsSync(getEnvReflectionsPath(this, "secrets"))) {
+						this.env.used.secrets = await readSecretsReflection(this);
+						if (this.env.used.secrets.getProperties().length > 0) this.debug({
+							meta: { category: "env" },
+							message: `Found the following secret configuration parameters used in project: \n${this.env.used.secrets.getProperties().map(__assignType((prop) => `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(", ")})`, [
+								"prop",
+								"",
+								"P\"2!\"/\""
+							])).join("\n")}`
+						});
+					}
+				} else {
+					this.debug(`Starting environment configuration reflection initialization.`);
+					this.env.types.env = await reflectEnv(this, this.config.env.types?.file, this.config.env.types?.name);
+					if (!this.env.types.env) throw new Error("Failed to find the environment configuration type reflection in the context.");
+					this.debug({
+						meta: { category: "env" },
+						message: `Found the following environment configuration parameter definitions: \n${this.env.types.env.getProperties().map(__assignType((prop) => `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(", ")})`, [
+							"prop",
+							"",
+							"P\"2!\"/\""
+						])).join("\n")}`
+					});
+					await writeEnvTypeReflection(this, this.env.types.env, "env");
+					this.env.types.secrets = await reflectSecrets(this, this.config.env.secrets?.file, this.config.env.secrets?.name);
+					if (!this.env.types.secrets) throw new Error("Failed to find the secrets configuration type reflection in the context.");
+					if (this.env.types.secrets.getProperties().length > 0) this.debug({
+						meta: { category: "env" },
+						message: `Found the following secret configuration parameter definitions: \n${this.env.types.secrets.getProperties().map(__assignType((prop) => `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(", ")})`, [
+							"prop",
+							"",
+							"P\"2!\"/\""
+						])).join("\n")}`
+					});
+					await writeEnvTypeReflection(this, this.env.types.secrets, "secrets");
+					this.info({
+						meta: { category: "env" },
+						message: `Resolved ${this.env.types.env.getProperties().length ?? 0} environment configuration parameters and ${this.env.types.secrets?.getProperties().length ?? 0} secret configuration parameters`
+					});
+					const envWithAlias = this.env.types.env.getProperties().filter(__assignType((prop) => prop.getAlias().length > 0, [
+						"prop",
+						"",
+						"P\"2!\"/\""
+					]));
+					Object.entries(await loadEnv(this, this.config.env)).forEach(__assignType(([key, value]) => {
+						const unprefixedKey = this.config.env.prefix.reduce(__assignType((ret, prefix) => {
+							if (key.replace(/_$/g, "").startsWith(prefix)) return key.replace(/_$/g, "").slice(prefix.length);
+							return ret;
+						}, [
+							"ret",
+							"prefix",
+							"",
+							"P\"2!\"2\"\"/#"
+						]), key);
+						const aliasKey = envWithAlias.find(__assignType((prop) => prop?.getAlias().reverse().includes(unprefixedKey), [
+							"prop",
+							"",
+							"P\"2!\"/\""
+						]));
+						if (this.env.types.env?.hasProperty(unprefixedKey) || aliasKey) this.env.types.env.getProperty(unprefixedKey).setDefaultValue(value);
+					}, [
+						"param0",
+						"",
+						"P\"2!\"/\""
+					]));
+					this.env.used.env = new ReflectionClass({
+						kind: ReflectionKind.objectLiteral,
+						typeName: "Env",
+						description: `An object containing the environment configuration parameters used by the ${this.config.name ? `${this.config.name} application` : "application"}.`,
+						types: []
+					}, this.env.types.env);
+					await writeEnvReflection(this, this.env.used.env, "env");
+					if (this.env.types.secrets) {
+						await writeEnvTypeReflection(this, this.env.types.secrets, "secrets");
+						this.env.used.secrets = new ReflectionClass({
+							kind: ReflectionKind.objectLiteral,
+							typeName: "Secrets",
+							description: `An object containing the secret configuration parameters used by the ${this.config.name ? `${this.config.name} application` : "application"}.`,
+							types: []
+						}, this.env.types.secrets);
+						await writeEnvReflection(this, this.env.used.secrets, "secrets");
+					}
+				}
+			},
+			prepare: __assignType(async function prepare() {
+				const _self$ = this;
+				this.debug(`Preparing the Environment runtime artifacts for the Powerlines project.`);
+				const result = await readEnvTypeReflection(this, "env");
+				return render(this, createComponent(EnvBuiltin, {
+					get defaultConfig() {
+						return _self$.config.env.defaultConfig;
+					},
+					reflection: result
+				}));
+			}, ["prepare", "P\"/!"]),
+			transform: {
+				order: "post",
+				handler: __assignType(async function handler() {
+					if (this.env.used.env.getProperties().length > 0) {
+						this.trace(`Persisting used environment configuration reflections to ${getEnvReflectionsPath(this, "env")}.`);
+						await writeEnvReflection(this, this.env.used.env, "env");
+					}
+					if (this.env.used.secrets.getProperties().length > 0) {
+						this.trace(`Persisting used secret configuration reflections to ${getEnvReflectionsPath(this, "secrets")}.`);
+						await writeEnvReflection(this, this.env.used.secrets, "secrets");
+					}
+				}, ["handler", "P\"/!"])
+			},
+			docs: __assignType(async function docs() {
+				this.debug(`Documenting environment variables configuration values in "${joinPaths(getDocsOutputPath(this.config.root), "env.md")}"`);
+				const result = await readEnvTypeReflection(this, "env");
+				return render(this, createComponent(EnvDocsFile, {
+					levelOffset: 0,
+					reflection: result
+				}));
+			}, ["docs", "P\"/!"]),
+			buildEnd: __assignType(async function buildEnd() {
+				const reflectionPath = getEnvReflectionsPath(this, "env");
+				this.debug(`Writing env reflection types to ${reflectionPath}.`);
+				await writeEnvReflection(this, this.env.used.env, "env");
+			}, ["buildEnd", "P\"/!"])
+		},
+		{
+			name: "env:automd-generator",
+			config: __assignType(function config() {
+				return { automd: defu(options.automd ?? {}, { generators: { env: env(this) } }) };
+			}, ["config", "P\"/!"])
+		},
+		{
+			name: "env:vite",
+			vite: { configResolved: __assignType(function configResolved() {
+				return { envPrefix: this.config?.env?.prefix };
+			}, [
+				() => __ΩEnvPluginContext,
+				"this",
+				"configResolved",
+				"Pn!2\"\"/#"
+			]) }
+		},
+		automd(options.automd)
+	];
+}, [
+	() => __ΩEnvPluginOptions,
+	"options",
+	() => ({}),
+	"",
+	"Pn!2\">#\"/$"
+]);
+
+//#endregion
+export { __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, plugin as default, plugin };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  ReflectionClass,\n  ReflectionKind\n} from \"@powerlines/deepkit/vendor/type\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport babel from \"@powerlines/plugin-babel\";\nimport deepkit from \"@powerlines/plugin-deepkit\";\nimport { TypeScriptCompilerPluginUserConfig } from \"@powerlines/plugin-tsc\";\nimport { parseTypeDefinition } from \"@stryke/convert/parse-type-definition\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { existsSync } from \"@stryke/fs/exists\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport {\n  TypeDefinition,\n  TypeDefinitionParameter\n} from \"@stryke/types/configuration\";\nimport defu from \"defu\";\nimport { Plugin } from \"powerlines\";\nimport { VIRTUAL_MODULE_PREFIX } from \"powerlines/constants\";\nimport { getDocsOutputPath } from \"powerlines/plugin-utils\";\nimport type { UserConfig as ViteUserConfig } from \"vite\";\nimport { envBabelPlugin } from \"./babel/plugin\";\nimport { EnvDocsFile } from \"./components/docs\";\nimport { EnvBuiltin } from \"./components/env-builtin\";\nimport { env } from \"./helpers/automd-generator\";\nimport { loadEnv } from \"./helpers/load\";\nimport {\n  getEnvDefaultTypeDefinition,\n  getEnvReflectionsPath,\n  getEnvTypeReflectionsPath,\n  getSecretsDefaultTypeDefinition,\n  readEnvReflection,\n  readEnvTypeReflection,\n  readSecretsReflection,\n  writeEnvReflection,\n  writeEnvTypeReflection\n} from \"./helpers/persistence\";\nimport { reflectEnv, reflectSecrets } from \"./helpers/reflect\";\nimport { EnvPluginContext, EnvPluginOptions } from \"./types/plugin\";\n\nexport * from \"./types\";\n\ndeclare module \"powerlines\" {\n  interface Config {\n    env?: EnvPluginOptions;\n  }\n}\n\n/**\n * A Powerlines plugin to inject environment variables into the source code.\n */\nexport const plugin = <TContext extends EnvPluginContext = EnvPluginContext>(\n  options: EnvPluginOptions = {}\n) => {\n  return [\n    deepkit(options.deepkit),\n    babel(options.babel),\n    {\n      name: \"env\",\n      async config() {\n        this.debug(\n          \"Providing default configuration for the Powerlines `env` build plugin.\"\n        );\n\n        const config = {\n          env: defu(options, {\n            types: {} as TypeDefinitionParameter,\n            validate: false,\n            inject: false,\n            prefix: []\n          }),\n          babel: {\n            plugins: [envBabelPlugin]\n          },\n          deepkit: {\n            reflection: \"default\",\n            level: \"all\"\n          },\n          tsc: {} as TypeScriptCompilerPluginUserConfig[\"tsc\"]\n        };\n\n        if (\n          isSetString(config.env.types) ||\n          (config.env.types && isSetString(config.env.types.file))\n        ) {\n          config.env.types = parseTypeDefinition(\n            config.env.types\n          ) as TypeDefinition;\n\n          const file = await this.fs.resolve(config.env.types.file);\n          if (file) {\n            config.env.types.file = file;\n          }\n        } else {\n          this.warn(\n            \"The `env.types` configuration parameter was not provided. Please ensure this is expected.\"\n          );\n\n          const envDefaultTypeDefinition =\n            await getEnvDefaultTypeDefinition(this);\n\n          const file = await this.fs.resolve(envDefaultTypeDefinition.file);\n          if (file) {\n            config.env.types = parseTypeDefinition(\n              `${file}#${envDefaultTypeDefinition.name}`\n            ) as TypeDefinition;\n          }\n        }\n\n        if (\n          isSetString(config.env.secrets) ||\n          (config.env.secrets && isSetString(config.env.secrets.file))\n        ) {\n          config.env.secrets = parseTypeDefinition(config.env.secrets);\n\n          const file = await this.fs.resolve(config.env.secrets!.file);\n          if (file) {\n            config.env.secrets!.file = file;\n          }\n        } else {\n          const secretsDefaultTypeDefinition =\n            await getSecretsDefaultTypeDefinition(this);\n\n          const file = await this.fs.resolve(secretsDefaultTypeDefinition.file);\n          if (file) {\n            config.env.secrets = parseTypeDefinition(\n              `${file}#${secretsDefaultTypeDefinition.name}`\n            );\n          }\n        }\n\n        if (config.env.types || config.env.secrets) {\n          config.tsc.filter = {\n            id: [\n              new RegExp(\n                `^(${VIRTUAL_MODULE_PREFIX})?${joinPaths(\n                  this.builtinsPath,\n                  \"env.ts\"\n                )\n                  .replace(/\\\\/g, \"\\\\\\\\\")\n                  .replace(/\\//g, \"\\\\/\")\n                  .replace(/\\./g, \"\\\\.\")\n                  .replace(/\\$/g, \"\\\\$\")}$`\n              )\n            ]\n          };\n        }\n\n        config.env.prefix = toArray(\n          (config.env.prefix ?? []) as string[]\n        ).reduce(\n          (ret: string[], prefix: string) => {\n            const formattedPrefix = constantCase(prefix);\n            if (!ret.includes(formattedPrefix)) {\n              ret.push(formattedPrefix);\n            }\n\n            return ret;\n          },\n          [\n            \"POWERLINES_\",\n            this.config.framework &&\n              this.config.framework !== \"powerlines\" &&\n              `${constantCase(this.config.framework)}_`\n          ].filter(Boolean) as string[]\n        );\n\n        config.env.prefix = getUnique(\n          toArray(config.env.prefix).reduce((ret, prefix) => {\n            if (!ret.includes(prefix.replace(/_$/g, \"\"))) {\n              ret.push(prefix.replace(/_$/g, \"\"));\n            }\n            return ret;\n          }, [] as string[])\n        );\n\n        this.info({\n          meta: {\n            category: \"env\"\n          },\n          message: `Environment configuration definition file: ${\n            config.env.types.file\n          }${config.env.types.name ? `#${config.env.types.name}` : \"\"}${\n            config.env.secrets\n              ? `\\nSecrets configuration definition file: ${config.env.secrets?.file}${\n                  config.env.secrets?.name ? `#${config.env.secrets?.name}` : \"\"\n                }`\n              : \"\"\n          }\\nEnvironment variable Prefixes: ${config.env.prefix.join(\", \")}\\nShould inject values: ${\n            config.env.inject ? \"Yes\" : \"No\"\n          }\\nShould validate configuration: ${\n            config.env.validate ? \"Yes\" : \"No\"\n          }`\n        });\n\n        return config;\n      },\n      async configResolved() {\n        this.debug(\n          `Environment plugin configuration has been resolved for the Powerlines project.`\n        );\n\n        this.env = defu(\n          {\n            parsed: await loadEnv(this, this.config.env)\n          },\n          this.env ?? {},\n          {\n            types: {\n              env: {}\n            },\n            used: {\n              env: {},\n              secrets: {}\n            },\n            parsed: {},\n            injected: {}\n          }\n        );\n\n        if (\n          this.config.command !== \"prepare\" &&\n          !this.config.skipCache &&\n          this.persistedMeta?.checksum === this.meta.checksum &&\n          existsSync(getEnvTypeReflectionsPath(this, \"env\"))\n        ) {\n          this.debug(\n            `Skipping reflection initialization as the meta checksum has not changed.`\n          );\n\n          this.env.types.env = await readEnvTypeReflection(this, \"env\");\n\n          this.debug({\n            meta: {\n              category: \"env\"\n            },\n            message: `Found the following environment configuration parameter definitions: \\n${this.env.types.env\n              .getProperties()\n              .map(\n                prop =>\n                  `- ${prop.getNameAsString()}${\n                    prop.getAlias().length > 0\n                      ? ` (aliases: ${prop.getAlias().join(\", \")})`\n                      : \"\"\n                  }`\n              )\n              .join(\"\\n\")}`\n          });\n\n          if (existsSync(getEnvReflectionsPath(this, \"env\"))) {\n            this.env.used.env = await readEnvReflection(this);\n\n            this.debug({\n              meta: {\n                category: \"env\"\n              },\n              message: `Found the following environment configuration parameters used in project: \\n${this.env.used.env\n                .getProperties()\n                .map(\n                  prop =>\n                    `- ${prop.getNameAsString()}${\n                      prop.getAlias().length > 0\n                        ? ` (aliases: ${prop.getAlias().join(\", \")})`\n                        : \"\"\n                    }`\n                )\n                .join(\"\\n\")}`\n            });\n          }\n\n          if (existsSync(getEnvTypeReflectionsPath(this, \"secrets\"))) {\n            this.env.types.secrets = await readEnvTypeReflection(\n              this,\n              \"secrets\"\n            );\n\n            if (this.env.types.secrets.getProperties().length > 0) {\n              this.debug({\n                meta: {\n                  category: \"env\"\n                },\n                message: `Found the following secret configuration parameter definitions: \\n${this.env.types.secrets\n                  .getProperties()\n                  .map(\n                    prop =>\n                      `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(\", \")})`\n                  )\n                  .join(\"\\n\")}`\n              });\n            }\n          }\n\n          if (existsSync(getEnvReflectionsPath(this, \"secrets\"))) {\n            this.env.used.secrets = await readSecretsReflection(this);\n\n            if (this.env.used.secrets.getProperties().length > 0) {\n              this.debug({\n                meta: {\n                  category: \"env\"\n                },\n                message: `Found the following secret configuration parameters used in project: \\n${this.env.used.secrets\n                  .getProperties()\n                  .map(\n                    prop =>\n                      `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(\", \")})`\n                  )\n                  .join(\"\\n\")}`\n              });\n            }\n          }\n        } else {\n          this.debug(\n            `Starting environment configuration reflection initialization.`\n          );\n\n          this.env.types.env = await reflectEnv(\n            this,\n            this.config.env.types?.file,\n            this.config.env.types?.name\n          );\n          if (!this.env.types.env) {\n            throw new Error(\n              \"Failed to find the environment configuration type reflection in the context.\"\n            );\n          }\n\n          this.debug({\n            meta: {\n              category: \"env\"\n            },\n            message: `Found the following environment configuration parameter definitions: \\n${this.env.types.env\n              .getProperties()\n              .map(\n                prop =>\n                  `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(\", \")})`\n              )\n              .join(\"\\n\")}`\n          });\n\n          await writeEnvTypeReflection(this, this.env.types.env, \"env\");\n\n          this.env.types.secrets = await reflectSecrets(\n            this,\n            this.config.env.secrets?.file,\n            this.config.env.secrets?.name\n          );\n          if (!this.env.types.secrets) {\n            throw new Error(\n              \"Failed to find the secrets configuration type reflection in the context.\"\n            );\n          }\n\n          if (this.env.types.secrets.getProperties().length > 0) {\n            this.debug({\n              meta: {\n                category: \"env\"\n              },\n              message: `Found the following secret configuration parameter definitions: \\n${this.env.types.secrets\n                .getProperties()\n                .map(\n                  prop =>\n                    `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(\", \")})`\n                )\n                .join(\"\\n\")}`\n            });\n          }\n\n          await writeEnvTypeReflection(this, this.env.types.secrets, \"secrets\");\n\n          this.info({\n            meta: {\n              category: \"env\"\n            },\n            message: `Resolved ${\n              this.env.types.env.getProperties().length ?? 0\n            } environment configuration parameters and ${\n              this.env.types.secrets?.getProperties().length ?? 0\n            } secret configuration parameters`\n          });\n\n          const envWithAlias = this.env.types.env\n            .getProperties()\n            .filter(prop => prop.getAlias().length > 0);\n\n          Object.entries(await loadEnv(this, this.config.env)).forEach(\n            ([key, value]) => {\n              const unprefixedKey = this.config.env.prefix.reduce(\n                (ret, prefix) => {\n                  if (key.replace(/_$/g, \"\").startsWith(prefix)) {\n                    return key.replace(/_$/g, \"\").slice(prefix.length);\n                  }\n                  return ret;\n                },\n                key\n              );\n\n              const aliasKey = envWithAlias.find(prop =>\n                prop?.getAlias().reverse().includes(unprefixedKey)\n              );\n              if (this.env.types.env?.hasProperty(unprefixedKey) || aliasKey) {\n                this.env.types.env\n                  .getProperty(unprefixedKey)\n                  .setDefaultValue(value);\n              }\n            }\n          );\n\n          this.env.used.env = new ReflectionClass(\n            {\n              kind: ReflectionKind.objectLiteral,\n              typeName: \"Env\",\n              description: `An object containing the environment configuration parameters used by the ${\n                this.config.name\n                  ? `${this.config.name} application`\n                  : \"application\"\n              }.`,\n              types: []\n            },\n            this.env.types.env\n          );\n\n          await writeEnvReflection(this, this.env.used.env, \"env\");\n\n          if (this.env.types.secrets) {\n            await writeEnvTypeReflection(\n              this,\n              this.env.types.secrets,\n              \"secrets\"\n            );\n\n            this.env.used.secrets = new ReflectionClass(\n              {\n                kind: ReflectionKind.objectLiteral,\n                typeName: \"Secrets\",\n                description: `An object containing the secret configuration parameters used by the ${\n                  this.config.name\n                    ? `${this.config.name} application`\n                    : \"application\"\n                }.`,\n                types: []\n              },\n              this.env.types.secrets\n            );\n            await writeEnvReflection(this, this.env.used.secrets, \"secrets\");\n          }\n        }\n      },\n      async prepare() {\n        this.debug(\n          `Preparing the Environment runtime artifacts for the Powerlines project.`\n        );\n\n        const result = await readEnvTypeReflection(this, \"env\");\n\n        return render(\n          this,\n          <EnvBuiltin\n            defaultConfig={this.config.env.defaultConfig}\n            reflection={result}\n          />\n        );\n      },\n      transform: {\n        order: \"post\",\n        async handler() {\n          if (this.env.used.env.getProperties().length > 0) {\n            this.trace(\n              `Persisting used environment configuration reflections to ${getEnvReflectionsPath(\n                this,\n                \"env\"\n              )}.`\n            );\n            await writeEnvReflection(this, this.env.used.env, \"env\");\n          }\n\n          if (this.env.used.secrets.getProperties().length > 0) {\n            this.trace(\n              `Persisting used secret configuration reflections to ${getEnvReflectionsPath(\n                this,\n                \"secrets\"\n              )}.`\n            );\n            await writeEnvReflection(this, this.env.used.secrets, \"secrets\");\n          }\n        }\n      },\n      async docs() {\n        this.debug(\n          `Documenting environment variables configuration values in \"${joinPaths(\n            getDocsOutputPath(this.config.root),\n            \"env.md\"\n          )}\"`\n        );\n\n        const result = await readEnvTypeReflection(this, \"env\");\n\n        return render(\n          this,\n          <EnvDocsFile levelOffset={0} reflection={result} />\n        );\n      },\n      async buildEnd() {\n        const reflectionPath = getEnvReflectionsPath(this, \"env\");\n\n        this.debug(`Writing env reflection types to ${reflectionPath}.`);\n\n        await writeEnvReflection(this, this.env.used.env, \"env\");\n      }\n    },\n    {\n      name: \"env:automd-generator\",\n      config() {\n        return {\n          automd: defu(options.automd ?? {}, {\n            generators: {\n              env: env(this)\n            }\n          })\n        };\n      }\n    },\n    {\n      name: \"env:vite\",\n      vite: {\n        configResolved(this: TContext) {\n          return {\n            envPrefix: this.config?.env?.prefix\n          } as ViteUserConfig;\n        }\n      }\n    },\n    automd(options.automd)\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  ReflectionClass,\n  ReflectionKind\n} from \"@powerlines/deepkit/vendor/type\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport babel from \"@powerlines/plugin-babel\";\nimport deepkit from \"@powerlines/plugin-deepkit\";\nimport { TypeScriptCompilerPluginUserConfig } from \"@powerlines/plugin-tsc\";\nimport { parseTypeDefinition } from \"@stryke/convert/parse-type-definition\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { existsSync } from \"@stryke/fs/exists\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport {\n  TypeDefinition,\n  TypeDefinitionParameter\n} from \"@stryke/types/configuration\";\nimport defu from \"defu\";\nimport { Plugin } from \"powerlines\";\nimport { VIRTUAL_MODULE_PREFIX } from \"powerlines/constants\";\nimport { getDocsOutputPath } from \"powerlines/plugin-utils\";\nimport type { UserConfig as ViteUserConfig } from \"vite\";\nimport { envBabelPlugin } from \"./babel/plugin\";\nimport { EnvDocsFile } from \"./components/docs\";\nimport { EnvBuiltin } from \"./components/env-builtin\";\nimport { env } from \"./helpers/automd-generator\";\nimport { loadEnv } from \"./helpers/load\";\nimport {\n  getEnvDefaultTypeDefinition,\n  getEnvReflectionsPath,\n  getEnvTypeReflectionsPath,\n  getSecretsDefaultTypeDefinition,\n  readEnvReflection,\n  readEnvTypeReflection,\n  readSecretsReflection,\n  writeEnvReflection,\n  writeEnvTypeReflection\n} from \"./helpers/persistence\";\nimport { reflectEnv, reflectSecrets } from \"./helpers/reflect\";\nimport { EnvPluginContext, EnvPluginOptions } from \"./types/plugin\";\n\nexport * from \"./types\";\n\ndeclare module \"powerlines\" {\n  interface Config {\n    env?: EnvPluginOptions;\n  }\n}\n\n/**\n * A Powerlines plugin to inject environment variables into the source code.\n */\nexport const plugin = <TContext extends EnvPluginContext = EnvPluginContext>(\n  options: EnvPluginOptions = {}\n) => {\n  return [\n    deepkit(options.deepkit),\n    babel(options.babel),\n    {\n      name: \"env\",\n      async config() {\n        this.debug(\n          \"Providing default configuration for the Powerlines `env` build plugin.\"\n        );\n\n        const config = {\n          env: defu(options, {\n            types: {} as TypeDefinitionParameter,\n            validate: false,\n            inject: false,\n            prefix: []\n          }),\n          babel: {\n            plugins: [envBabelPlugin]\n          },\n          deepkit: {\n            reflection: \"default\",\n            level: \"all\"\n          },\n          tsc: {} as TypeScriptCompilerPluginUserConfig[\"tsc\"]\n        };\n\n        if (\n          !isSetString(config.env.types) &&\n          !isSetString(config.env.types?.file)\n        ) {\n          this.warn(\n            \"The `env.types` configuration parameter was not provided. Please ensure this is expected.\"\n          );\n\n          config.env.types = await getEnvDefaultTypeDefinition(this);\n        }\n\n        if (\n          !isSetString(config.env.secrets) &&\n          !isSetString(config.env.secrets?.file)\n        ) {\n          config.env.secrets = await getSecretsDefaultTypeDefinition(this);\n        }\n\n        if (config.env.types || config.env.secrets) {\n          config.tsc.filter = {\n            id: [\n              new RegExp(\n                `^(${VIRTUAL_MODULE_PREFIX})?${joinPaths(\n                  this.builtinsPath,\n                  \"env.ts\"\n                )\n                  .replace(/\\\\/g, \"\\\\\\\\\")\n                  .replace(/\\//g, \"\\\\/\")\n                  .replace(/\\./g, \"\\\\.\")\n                  .replace(/\\$/g, \"\\\\$\")}$`\n              )\n            ]\n          };\n        }\n\n        config.env.prefix = toArray(\n          (config.env.prefix ?? []) as string[]\n        ).reduce(\n          (ret: string[], prefix: string) => {\n            const formattedPrefix = constantCase(prefix);\n            if (!ret.includes(formattedPrefix)) {\n              ret.push(formattedPrefix);\n            }\n\n            return ret;\n          },\n          [\n            \"POWERLINES_\",\n            this.config.framework &&\n              this.config.framework !== \"powerlines\" &&\n              `${constantCase(this.config.framework)}_`\n          ].filter(Boolean) as string[]\n        );\n\n        config.env.prefix = getUnique(\n          toArray(config.env.prefix).reduce((ret, prefix) => {\n            if (!ret.includes(prefix.replace(/_$/g, \"\"))) {\n              ret.push(prefix.replace(/_$/g, \"\"));\n            }\n            return ret;\n          }, [] as string[])\n        );\n\n        return config;\n      },\n      async configResolved() {\n        this.debug(\n          `Environment plugin configuration has been resolved for the Powerlines project.`\n        );\n\n        this.env = defu(\n          {\n            parsed: await loadEnv(this, this.config.env)\n          },\n          this.env ?? {},\n          {\n            types: {\n              env: {}\n            },\n            used: {\n              env: {},\n              secrets: {}\n            },\n            parsed: {},\n            injected: {}\n          }\n        );\n\n        if (\n          isSetString(this.config.env.types) ||\n          (this.config.env.types && isSetString(this.config.env.types.file))\n        ) {\n          this.config.env.types = parseTypeDefinition(\n            this.config.env.types\n          ) as TypeDefinition;\n\n          const file = await this.fs.resolve(this.config.env.types.file);\n          if (file) {\n            this.config.env.types.file = file;\n          }\n        }\n\n        if (\n          isSetString(this.config.env.secrets) ||\n          (this.config.env.secrets && isSetString(this.config.env.secrets.file))\n        ) {\n          this.config.env.secrets = parseTypeDefinition(\n            this.config.env.secrets\n          )!;\n\n          const file = await this.fs.resolve(this.config.env.secrets.file);\n          if (file) {\n            this.config.env.secrets.file = file;\n          }\n        }\n\n        this.info({\n          meta: {\n            category: \"env\"\n          },\n          message: `Environment configuration definition file: ${\n            this.config.env.types.file\n          }${this.config.env.types.name ? `#${this.config.env.types.name}` : \"\"}${\n            this.config.env.secrets\n              ? `\\nSecrets configuration definition file: ${this.config.env.secrets?.file}${\n                  this.config.env.secrets?.name\n                    ? `#${this.config.env.secrets?.name}`\n                    : \"\"\n                }`\n              : \"\"\n          }\\nEnvironment variable Prefixes: ${this.config.env.prefix.join(\", \")}\\nShould inject values: ${\n            this.config.env.inject ? \"Yes\" : \"No\"\n          }\\nShould validate configuration: ${\n            this.config.env.validate ? \"Yes\" : \"No\"\n          }`\n        });\n\n        if (\n          this.config.command !== \"prepare\" &&\n          !this.config.skipCache &&\n          this.persistedMeta?.checksum === this.meta.checksum &&\n          existsSync(getEnvTypeReflectionsPath(this, \"env\"))\n        ) {\n          this.debug(\n            `Skipping reflection initialization as the meta checksum has not changed.`\n          );\n\n          this.env.types.env = await readEnvTypeReflection(this, \"env\");\n\n          this.debug({\n            meta: {\n              category: \"env\"\n            },\n            message: `Found the following environment configuration parameter definitions: \\n${this.env.types.env\n              .getProperties()\n              .map(\n                prop =>\n                  `- ${prop.getNameAsString()}${\n                    prop.getAlias().length > 0\n                      ? ` (aliases: ${prop.getAlias().join(\", \")})`\n                      : \"\"\n                  }`\n              )\n              .join(\"\\n\")}`\n          });\n\n          if (existsSync(getEnvReflectionsPath(this, \"env\"))) {\n            this.env.used.env = await readEnvReflection(this);\n\n            this.debug({\n              meta: {\n                category: \"env\"\n              },\n              message: `Found the following environment configuration parameters used in project: \\n${this.env.used.env\n                .getProperties()\n                .map(\n                  prop =>\n                    `- ${prop.getNameAsString()}${\n                      prop.getAlias().length > 0\n                        ? ` (aliases: ${prop.getAlias().join(\", \")})`\n                        : \"\"\n                    }`\n                )\n                .join(\"\\n\")}`\n            });\n          }\n\n          if (existsSync(getEnvTypeReflectionsPath(this, \"secrets\"))) {\n            this.env.types.secrets = await readEnvTypeReflection(\n              this,\n              \"secrets\"\n            );\n\n            if (this.env.types.secrets.getProperties().length > 0) {\n              this.debug({\n                meta: {\n                  category: \"env\"\n                },\n                message: `Found the following secret configuration parameter definitions: \\n${this.env.types.secrets\n                  .getProperties()\n                  .map(\n                    prop =>\n                      `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(\", \")})`\n                  )\n                  .join(\"\\n\")}`\n              });\n            }\n          }\n\n          if (existsSync(getEnvReflectionsPath(this, \"secrets\"))) {\n            this.env.used.secrets = await readSecretsReflection(this);\n\n            if (this.env.used.secrets.getProperties().length > 0) {\n              this.debug({\n                meta: {\n                  category: \"env\"\n                },\n                message: `Found the following secret configuration parameters used in project: \\n${this.env.used.secrets\n                  .getProperties()\n                  .map(\n                    prop =>\n                      `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(\", \")})`\n                  )\n                  .join(\"\\n\")}`\n              });\n            }\n          }\n        } else {\n          this.debug(\n            `Starting environment configuration reflection initialization.`\n          );\n\n          this.env.types.env = await reflectEnv(\n            this,\n            this.config.env.types?.file,\n            this.config.env.types?.name\n          );\n          if (!this.env.types.env) {\n            throw new Error(\n              \"Failed to find the environment configuration type reflection in the context.\"\n            );\n          }\n\n          this.debug({\n            meta: {\n              category: \"env\"\n            },\n            message: `Found the following environment configuration parameter definitions: \\n${this.env.types.env\n              .getProperties()\n              .map(\n                prop =>\n                  `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(\", \")})`\n              )\n              .join(\"\\n\")}`\n          });\n\n          await writeEnvTypeReflection(this, this.env.types.env, \"env\");\n\n          this.env.types.secrets = await reflectSecrets(\n            this,\n            this.config.env.secrets?.file,\n            this.config.env.secrets?.name\n          );\n          if (!this.env.types.secrets) {\n            throw new Error(\n              \"Failed to find the secrets configuration type reflection in the context.\"\n            );\n          }\n\n          if (this.env.types.secrets.getProperties().length > 0) {\n            this.debug({\n              meta: {\n                category: \"env\"\n              },\n              message: `Found the following secret configuration parameter definitions: \\n${this.env.types.secrets\n                .getProperties()\n                .map(\n                  prop =>\n                    `- ${prop.getNameAsString()} (aliases: ${prop.getAlias().join(\", \")})`\n                )\n                .join(\"\\n\")}`\n            });\n          }\n\n          await writeEnvTypeReflection(this, this.env.types.secrets, \"secrets\");\n\n          this.info({\n            meta: {\n              category: \"env\"\n            },\n            message: `Resolved ${\n              this.env.types.env.getProperties().length ?? 0\n            } environment configuration parameters and ${\n              this.env.types.secrets?.getProperties().length ?? 0\n            } secret configuration parameters`\n          });\n\n          const envWithAlias = this.env.types.env\n            .getProperties()\n            .filter(prop => prop.getAlias().length > 0);\n\n          Object.entries(await loadEnv(this, this.config.env)).forEach(\n            ([key, value]) => {\n              const unprefixedKey = this.config.env.prefix.reduce(\n                (ret, prefix) => {\n                  if (key.replace(/_$/g, \"\").startsWith(prefix)) {\n                    return key.replace(/_$/g, \"\").slice(prefix.length);\n                  }\n                  return ret;\n                },\n                key\n              );\n\n              const aliasKey = envWithAlias.find(prop =>\n                prop?.getAlias().reverse().includes(unprefixedKey)\n              );\n              if (this.env.types.env?.hasProperty(unprefixedKey) || aliasKey) {\n                this.env.types.env\n                  .getProperty(unprefixedKey)\n                  .setDefaultValue(value);\n              }\n            }\n          );\n\n          this.env.used.env = new ReflectionClass(\n            {\n              kind: ReflectionKind.objectLiteral,\n              typeName: \"Env\",\n              description: `An object containing the environment configuration parameters used by the ${\n                this.config.name\n                  ? `${this.config.name} application`\n                  : \"application\"\n              }.`,\n              types: []\n            },\n            this.env.types.env\n          );\n\n          await writeEnvReflection(this, this.env.used.env, \"env\");\n\n          if (this.env.types.secrets) {\n            await writeEnvTypeReflection(\n              this,\n              this.env.types.secrets,\n              \"secrets\"\n            );\n\n            this.env.used.secrets = new ReflectionClass(\n              {\n                kind: ReflectionKind.objectLiteral,\n                typeName: \"Secrets\",\n                description: `An object containing the secret configuration parameters used by the ${\n                  this.config.name\n                    ? `${this.config.name} application`\n                    : \"application\"\n                }.`,\n                types: []\n              },\n              this.env.types.secrets\n            );\n            await writeEnvReflection(this, this.env.used.secrets, \"secrets\");\n          }\n        }\n      },\n      async prepare() {\n        this.debug(\n          `Preparing the Environment runtime artifacts for the Powerlines project.`\n        );\n\n        const result = await readEnvTypeReflection(this, \"env\");\n\n        return render(\n          this,\n          <EnvBuiltin\n            defaultConfig={this.config.env.defaultConfig}\n            reflection={result}\n          />\n        );\n      },\n      transform: {\n        order: \"post\",\n        async handler() {\n          if (this.env.used.env.getProperties().length > 0) {\n            this.trace(\n              `Persisting used environment configuration reflections to ${getEnvReflectionsPath(\n                this,\n                \"env\"\n              )}.`\n            );\n            await writeEnvReflection(this, this.env.used.env, \"env\");\n          }\n\n          if (this.env.used.secrets.getProperties().length > 0) {\n            this.trace(\n              `Persisting used secret configuration reflections to ${getEnvReflectionsPath(\n                this,\n                \"secrets\"\n              )}.`\n            );\n            await writeEnvReflection(this, this.env.used.secrets, \"secrets\");\n          }\n        }\n      },\n      async docs() {\n        this.debug(\n          `Documenting environment variables configuration values in \"${joinPaths(\n            getDocsOutputPath(this.config.root),\n            \"env.md\"\n          )}\"`\n        );\n\n        const result = await readEnvTypeReflection(this, \"env\");\n\n        return render(\n          this,\n          <EnvDocsFile levelOffset={0} reflection={result} />\n        );\n      },\n      async buildEnd() {\n        const reflectionPath = getEnvReflectionsPath(this, \"env\");\n\n        this.debug(`Writing env reflection types to ${reflectionPath}.`);\n\n        await writeEnvReflection(this, this.env.used.env, \"env\");\n      }\n    },\n    {\n      name: \"env:automd-generator\",\n      config() {\n        return {\n          automd: defu(options.automd ?? {}, {\n            generators: {\n              env: env(this)\n            }\n          })\n        };\n      }\n    },\n    {\n      name: \"env:vite\",\n      vite: {\n        configResolved(this: TContext) {\n          return {\n            envPrefix: this.config?.env?.prefix\n          } as ViteUserConfig;\n        }\n      }\n    },\n    automd(options.automd)\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":"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"}