@powerlines/plugin-env 0.15.205 → 0.16.1

package/dist/babel/plugin.cjs

@@ -63,7 +63,7 @@ const envBabelPlugin = (__powerlines_plugin_babel_helpers_create_plugin.createBa
 					if (envProperty.isValueRequired() && value === void 0) throw new Error(`Environment variable \`${name}\` is not defined in the .env configuration files`);
 					return (0, __powerlines_deepkit_utilities.stringifyDefaultValue)(envProperty, value);
 				}
-			} else throw new Error(`The "${name}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${pass.filename ? pass.filename : "unknown"}.
+			} else if (context.config.env.validate) throw new Error(`The "${name}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${pass.filename ? pass.filename : "unknown"}.
 
           The following environment configuration names are defined in the \`env\` type definition: \n${context.env.types.env?.getPropertyNames().sort(__assignType((a, b) => String(a).localeCompare(String(b)), [
 				"a",

package/dist/babel/plugin.mjs

@@ -62,7 +62,7 @@ const envBabelPlugin = (createBabelPlugin.Ω = [[() => __ΩEnvPluginContext, "n!
 					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"}.
+			} else if (context.config.env.validate) throw new Error(`The "${name}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${pass.filename ? pass.filename : "unknown"}.
 
           The following environment configuration names are defined in the \`env\` type definition: \n${context.env.types.env?.getPropertyNames().sort(__assignType((a, b) => String(a).localeCompare(String(b)), [
 				"a",

package/dist/babel/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/babel/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { NodePath } from \"@babel/core\";\nimport * as t from \"@babel/types\";\nimport { stringifyDefaultValue } from \"@powerlines/deepkit/utilities\";\n\nimport { createBabelPlugin } from \"@powerlines/plugin-babel/helpers/create-plugin\";\nimport { addImport } from \"@powerlines/plugin-babel/helpers/module-helpers\";\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { BabelPluginPass } from \"powerlines/types/babel\";\nimport { EnvPluginContext } from \"../types/plugin\";\n\n/*\n * The Powerlines - Environment Configuration Babel Plugin\n *\n * @param babel - The Babel core module\n * @returns The Babel plugin object\n */\nexport const envBabelPlugin = createBabelPlugin<EnvPluginContext>(\n  \"env\",\n  ({ log, context }) => {\n    function extractEnv(\n      node: t.Identifier,\n      pass: BabelPluginPass,\n      isInjectable = false\n    ) {\n      const envTypesAliasProperties = context.env.types.env\n        ?.getProperties()\n        .filter(prop => prop.getAlias().length > 0);\n\n      if (node.name) {\n        const prefix = context.config.env.prefix.find(\n          pre =>\n            node.name &&\n            node.name.startsWith(pre) &&\n            (context.env.types.env?.hasProperty(\n              node.name.replace(`${pre}_`, \"\")\n            ) ||\n              envTypesAliasProperties.some(prop =>\n                prop.getAlias().includes(node.name.replace(`${pre}_`, \"\"))\n              ))\n        );\n\n        let name = node.name;\n        if (prefix) {\n          name = node.name.replace(`${prefix}_`, \"\");\n        }\n\n        log(\n          LogLevelLabel.TRACE,\n          `Environment variable ${name} found in ${\n            pass.filename || \"unknown file\"\n          }.`\n        );\n\n        if (\n          context.env.types.env?.hasProperty(name) ||\n          envTypesAliasProperties.some(prop => prop.getAlias().includes(name))\n        ) {\n          const envProperty = context.env.types.env.hasProperty(name)\n            ? context.env.types.env.getProperty(name)\n            : envTypesAliasProperties.find(prop =>\n                prop.getAlias().includes(name)\n              );\n          if (!envProperty || envProperty.isIgnored()) {\n            return;\n          }\n\n          if (!context.env.used.env.hasProperty(name)) {\n            log(\n              LogLevelLabel.DEBUG,\n              `Adding \"${name}\" environment variables found in \"${\n                pass.filename || \"unknown file\"\n              }\" to used environment configuration reflection object.`\n            );\n\n            context.env.used.env.addProperty(envProperty.property);\n          }\n\n          if (context.config.env.inject && isInjectable) {\n            let value = context.env.parsed?.[name];\n            if (value === undefined) {\n              const prefix = context.config.env.prefix.find(pre => {\n                return context.env.parsed[`${pre.replace(/_$/g, \"\")}_${name}`];\n              });\n              if (prefix) {\n                value =\n                  context.env.parsed[`${prefix.replace(/_$/g, \"\")}_${name}`];\n              }\n            }\n\n            value ??= envProperty.getDefaultValue();\n\n            if (envProperty.isValueRequired() && value === undefined) {\n              throw new Error(\n                `Environment variable \\`${name}\\` is not defined in the .env configuration files`\n              );\n            }\n\n            return stringifyDefaultValue(envProperty, value);\n          }\n        } else {\n          throw new Error(\n            `The \"${name}\" environment variable is not defined in the \\`env\\` type definition, but is used in the source code file ${\n              pass.filename ? pass.filename : \"unknown\"\n            }.\n\n          The following environment configuration names are defined in the \\`env\\` type definition: \\n${context.env.types.env\n            ?.getPropertyNames()\n            .sort((a, b) => String(a).localeCompare(String(b)))\n            .map(\n              typeDef =>\n                ` - ${String(typeDef)} ${\n                  envTypesAliasProperties.some(\n                    prop =>\n                      prop.getNameAsString() === String(typeDef) &&\n                      prop.getAlias().length > 0\n                  )\n                    ? `(Alias: ${envTypesAliasProperties\n                        ?.find(\n                          prop => prop.getNameAsString() === String(typeDef)\n                        )\n                        ?.getAlias()\n                        .join(\", \")})`\n                    : \"\"\n                }`\n            )\n            .join(\n              \"\\n\"\n            )} \\n\\nUsing the following env prefix: \\n${context.config.env.prefix\n            .map(prefix => ` - ${prefix}`)\n            .join(\n              \"\\n\"\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`\n          );\n        }\n      }\n\n      return undefined;\n    }\n\n    return {\n      visitor: {\n        MemberExpression(\n          path: NodePath<t.MemberExpression>,\n          pass: BabelPluginPass\n        ) {\n          if (\n            path\n              .get(\"object\")\n              ?.get(\"property\")\n              ?.isIdentifier({ name: \"env\" }) &&\n            path\n              .get(\"object\")\n              ?.get(\"object\")\n              ?.isIdentifier({ name: \"process\" }) &&\n            path.get(\"property\")?.isIdentifier()\n          ) {\n            // process.env.CONFIG_NAME\n\n            const identifier = path.get(\"property\")?.node as t.Identifier;\n            if (!identifier.name) {\n              return;\n            }\n\n            extractEnv(identifier, pass, false);\n\n            path.replaceWithSourceString(`env.${identifier.name}`);\n            addImport(path, {\n              module: `${context.config.framework || \"powerlines\"}:env`,\n              name: \"env\",\n              imported: \"env\"\n            });\n          } else if (\n            path\n              .get(\"object\")\n              ?.get(\"property\")\n              ?.isIdentifier({ name: \"env\" }) &&\n            path.get(\"object\")?.get(\"object\")?.isMetaProperty() &&\n            path.get(\"property\")?.isIdentifier()\n          ) {\n            // import.meta.env.CONFIG_NAME\n\n            const identifier = path.get(\"property\")?.node as t.Identifier;\n            if (!identifier.name) {\n              return;\n            }\n\n            extractEnv(identifier, pass, false);\n\n            path.replaceWithSourceString(`env.${identifier.name}`);\n            addImport(path, {\n              module: `${context.config.framework || \"powerlines\"}:env`,\n              name: \"env\",\n              imported: \"env\"\n            });\n          } else if (\n            path.get(\"object\")?.isIdentifier({ name: \"env\" }) &&\n            path.get(\"property\")?.isIdentifier()\n          ) {\n            // env.CONFIG_NAME\n\n            const identifier = path.get(\"property\")?.node as t.Identifier;\n            if (!identifier.name) {\n              return;\n            }\n\n            extractEnv(identifier, pass, false);\n          }\n        }\n      }\n    };\n  }\n);\n"],"mappings":"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"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/babel/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { NodePath } from \"@babel/core\";\nimport * as t from \"@babel/types\";\nimport { stringifyDefaultValue } from \"@powerlines/deepkit/utilities\";\n\nimport { createBabelPlugin } from \"@powerlines/plugin-babel/helpers/create-plugin\";\nimport { addImport } from \"@powerlines/plugin-babel/helpers/module-helpers\";\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { BabelPluginPass } from \"powerlines/types/babel\";\nimport { EnvPluginContext } from \"../types/plugin\";\n\n/*\n * The Powerlines - Environment Configuration Babel Plugin\n *\n * @param babel - The Babel core module\n * @returns The Babel plugin object\n */\nexport const envBabelPlugin = createBabelPlugin<EnvPluginContext>(\n  \"env\",\n  ({ log, context }) => {\n    function extractEnv(\n      node: t.Identifier,\n      pass: BabelPluginPass,\n      isInjectable = false\n    ) {\n      const envTypesAliasProperties = context.env.types.env\n        ?.getProperties()\n        .filter(prop => prop.getAlias().length > 0);\n\n      if (node.name) {\n        const prefix = context.config.env.prefix.find(\n          pre =>\n            node.name &&\n            node.name.startsWith(pre) &&\n            (context.env.types.env?.hasProperty(\n              node.name.replace(`${pre}_`, \"\")\n            ) ||\n              envTypesAliasProperties.some(prop =>\n                prop.getAlias().includes(node.name.replace(`${pre}_`, \"\"))\n              ))\n        );\n\n        let name = node.name;\n        if (prefix) {\n          name = node.name.replace(`${prefix}_`, \"\");\n        }\n\n        log(\n          LogLevelLabel.TRACE,\n          `Environment variable ${name} found in ${\n            pass.filename || \"unknown file\"\n          }.`\n        );\n\n        if (\n          context.env.types.env?.hasProperty(name) ||\n          envTypesAliasProperties.some(prop => prop.getAlias().includes(name))\n        ) {\n          const envProperty = context.env.types.env.hasProperty(name)\n            ? context.env.types.env.getProperty(name)\n            : envTypesAliasProperties.find(prop =>\n                prop.getAlias().includes(name)\n              );\n          if (!envProperty || envProperty.isIgnored()) {\n            return;\n          }\n\n          if (!context.env.used.env.hasProperty(name)) {\n            log(\n              LogLevelLabel.DEBUG,\n              `Adding \"${name}\" environment variables found in \"${\n                pass.filename || \"unknown file\"\n              }\" to used environment configuration reflection object.`\n            );\n\n            context.env.used.env.addProperty(envProperty.property);\n          }\n\n          if (context.config.env.inject && isInjectable) {\n            let value = context.env.parsed?.[name];\n            if (value === undefined) {\n              const prefix = context.config.env.prefix.find(pre => {\n                return context.env.parsed[`${pre.replace(/_$/g, \"\")}_${name}`];\n              });\n              if (prefix) {\n                value =\n                  context.env.parsed[`${prefix.replace(/_$/g, \"\")}_${name}`];\n              }\n            }\n\n            value ??= envProperty.getDefaultValue();\n\n            if (envProperty.isValueRequired() && value === undefined) {\n              throw new Error(\n                `Environment variable \\`${name}\\` is not defined in the .env configuration files`\n              );\n            }\n\n            return stringifyDefaultValue(envProperty, value);\n          }\n        } else if (context.config.env.validate) {\n          throw new Error(\n            `The \"${name}\" environment variable is not defined in the \\`env\\` type definition, but is used in the source code file ${\n              pass.filename ? pass.filename : \"unknown\"\n            }.\n\n          The following environment configuration names are defined in the \\`env\\` type definition: \\n${context.env.types.env\n            ?.getPropertyNames()\n            .sort((a, b) => String(a).localeCompare(String(b)))\n            .map(\n              typeDef =>\n                ` - ${String(typeDef)} ${\n                  envTypesAliasProperties.some(\n                    prop =>\n                      prop.getNameAsString() === String(typeDef) &&\n                      prop.getAlias().length > 0\n                  )\n                    ? `(Alias: ${envTypesAliasProperties\n                        ?.find(\n                          prop => prop.getNameAsString() === String(typeDef)\n                        )\n                        ?.getAlias()\n                        .join(\", \")})`\n                    : \"\"\n                }`\n            )\n            .join(\n              \"\\n\"\n            )} \\n\\nUsing the following env prefix: \\n${context.config.env.prefix\n            .map(prefix => ` - ${prefix}`)\n            .join(\n              \"\\n\"\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`\n          );\n        }\n      }\n\n      return undefined;\n    }\n\n    return {\n      visitor: {\n        MemberExpression(\n          path: NodePath<t.MemberExpression>,\n          pass: BabelPluginPass\n        ) {\n          if (\n            path\n              .get(\"object\")\n              ?.get(\"property\")\n              ?.isIdentifier({ name: \"env\" }) &&\n            path\n              .get(\"object\")\n              ?.get(\"object\")\n              ?.isIdentifier({ name: \"process\" }) &&\n            path.get(\"property\")?.isIdentifier()\n          ) {\n            // process.env.CONFIG_NAME\n\n            const identifier = path.get(\"property\")?.node as t.Identifier;\n            if (!identifier.name) {\n              return;\n            }\n\n            extractEnv(identifier, pass, false);\n\n            path.replaceWithSourceString(`env.${identifier.name}`);\n            addImport(path, {\n              module: `${context.config.framework || \"powerlines\"}:env`,\n              name: \"env\",\n              imported: \"env\"\n            });\n          } else if (\n            path\n              .get(\"object\")\n              ?.get(\"property\")\n              ?.isIdentifier({ name: \"env\" }) &&\n            path.get(\"object\")?.get(\"object\")?.isMetaProperty() &&\n            path.get(\"property\")?.isIdentifier()\n          ) {\n            // import.meta.env.CONFIG_NAME\n\n            const identifier = path.get(\"property\")?.node as t.Identifier;\n            if (!identifier.name) {\n              return;\n            }\n\n            extractEnv(identifier, pass, false);\n\n            path.replaceWithSourceString(`env.${identifier.name}`);\n            addImport(path, {\n              module: `${context.config.framework || \"powerlines\"}:env`,\n              name: \"env\",\n              imported: \"env\"\n            });\n          } else if (\n            path.get(\"object\")?.isIdentifier({ name: \"env\" }) &&\n            path.get(\"property\")?.isIdentifier()\n          ) {\n            // env.CONFIG_NAME\n\n            const identifier = path.get(\"property\")?.node as t.Identifier;\n            if (!identifier.name) {\n              return;\n            }\n\n            extractEnv(identifier, pass, false);\n          }\n        }\n      }\n    };\n  }\n);\n"],"mappings":"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"}

package/dist/helpers/reflect.cjs

@@ -208,17 +208,27 @@ createSecretsReflection.__type = [
 	"createSecretsReflection",
 	"Pn!2\"n#2$>%P\"7&/'"
 ];
+/**
+* Reflects the environment configuration type definition from the provided file and name, and merges it with the default environment configuration reflection and the currently used environment configuration reflection.
+*
+* @remarks
+* The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.
+*
+* @param context - The plugin context
+* @param file - The file path to reflect the environment configuration type definition from
+* @param name - The name of the type definition to reflect the environment configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.
+* @returns A reflection of the environment configuration type definition, merged with the default environment configuration reflection and the currently used environment configuration reflection. The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.
+*/
 async function reflectEnv(context, file, name) {
 	let config;
 	if (file) config = (0, __powerlines_deepkit_vendor_type.resolveClassType)(await (0, __powerlines_deepkit_reflect_type.reflectType)(context, {
 		file: !require_is_parent_path.isParentPath(file, context.workspaceConfig.workspaceRoot) ? require_join_paths.joinPaths(context.workspaceConfig.workspaceRoot, file) : file,
 		name
 	}));
-	const defaultConfigType = await (0, __powerlines_deepkit_reflect_type.reflectType)(context, await require_helpers_persistence.getEnvDefaultTypeDefinition(context));
 	return mergeEnvReflections(context, [
 		await require_helpers_persistence.readEnvTypeReflection(context, "env"),
 		config,
-		(0, __powerlines_deepkit_vendor_type.resolveClassType)(defaultConfigType)
+		(0, __powerlines_deepkit_vendor_type.resolveClassType)(await (0, __powerlines_deepkit_reflect_type.reflectType)(context, await require_helpers_persistence.getEnvDefaultTypeDefinition(context)))
 	].filter(Boolean));
 }
 reflectEnv.__type = [
@@ -227,19 +237,30 @@ reflectEnv.__type = [
 	"file",
 	"name",
 	"reflectEnv",
-	"Pn!2\"&2#8&2$8\"/%"
+	"Reflects the environment configuration type definition from the provided file and name, and merges it with the default environment configuration reflection and the currently used environment configuration reflection.",
+	"Pn!2\"&2#8&2$8\"/%?&"
 ];
+/**
+* Reflects the secrets configuration type definition from the provided file and name, and merges it with the default secrets configuration reflection and the currently used secrets configuration reflection.
+*
+* @remarks
+* The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.
+*
+* @param context - The plugin context
+* @param file - The file path to reflect the secrets configuration type definition from
+* @param name - The name of the type definition to reflect the secrets configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.
+* @returns A reflection of the secrets configuration type definition, merged with the default secrets configuration reflection and the currently used secrets configuration reflection. The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.
+*/
 async function reflectSecrets(context, file, name) {
 	let config;
 	if (file) config = (0, __powerlines_deepkit_vendor_type.resolveClassType)(await (0, __powerlines_deepkit_reflect_type.reflectType)(context, {
 		file: !require_is_parent_path.isParentPath(file, context.workspaceConfig.workspaceRoot) ? require_join_paths.joinPaths(context.workspaceConfig.workspaceRoot, file) : file,
 		name
 	}));
-	const defaultSecretsType = await (0, __powerlines_deepkit_reflect_type.reflectType)(context, await require_helpers_persistence.getSecretsDefaultTypeDefinition(context));
 	return mergeSecretsReflections(context, [
 		await require_helpers_persistence.readSecretsReflection(context),
 		config,
-		(0, __powerlines_deepkit_vendor_type.resolveClassType)(defaultSecretsType)
+		(0, __powerlines_deepkit_vendor_type.resolveClassType)(await (0, __powerlines_deepkit_reflect_type.reflectType)(context, await require_helpers_persistence.getSecretsDefaultTypeDefinition(context)))
 	].filter(Boolean));
 }
 reflectSecrets.__type = [
@@ -248,7 +269,8 @@ reflectSecrets.__type = [
 	"file",
 	"name",
 	"reflectSecrets",
-	"Pn!2\"&2#8&2$8\"/%"
+	"Reflects the secrets configuration type definition from the provided file and name, and merges it with the default secrets configuration reflection and the currently used secrets configuration reflection.",
+	"Pn!2\"&2#8&2$8\"/%?&"
 ];
 
 //#endregion

package/dist/helpers/reflect.d.cts

@@ -39,7 +39,29 @@ declare class BaseSecrets implements SecretsInterface {
 }
 declare function createEnvReflection(context: EnvPluginContext, options?: CreateEnvReflectionOptions): ReflectionClass<any>;
 declare function createSecretsReflection(context: EnvPluginContext, options?: CreateEnvReflectionOptions): ReflectionClass<any>;
+/**
+ * Reflects the environment configuration type definition from the provided file and name, and merges it with the default environment configuration reflection and the currently used environment configuration reflection.
+ *
+ * @remarks
+ * The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.
+ *
+ * @param context - The plugin context
+ * @param file - The file path to reflect the environment configuration type definition from
+ * @param name - The name of the type definition to reflect the environment configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.
+ * @returns A reflection of the environment configuration type definition, merged with the default environment configuration reflection and the currently used environment configuration reflection. The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.
+ */
 declare function reflectEnv(context: EnvPluginContext, file?: string, name?: string): Promise<ReflectionClass<any>>;
+/**
+ * Reflects the secrets configuration type definition from the provided file and name, and merges it with the default secrets configuration reflection and the currently used secrets configuration reflection.
+ *
+ * @remarks
+ * The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.
+ *
+ * @param context - The plugin context
+ * @param file - The file path to reflect the secrets configuration type definition from
+ * @param name - The name of the type definition to reflect the secrets configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.
+ * @returns A reflection of the secrets configuration type definition, merged with the default secrets configuration reflection and the currently used secrets configuration reflection. The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.
+ */
 declare function reflectSecrets(context: EnvPluginContext, file?: string, name?: string): Promise<ReflectionClass<any>>;
 declare type __ΩCreateEnvReflectionOptions = any[];
 //#endregion

package/dist/helpers/reflect.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"reflect.d.cts","names":[],"sources":["../../src/helpers/reflect.ts"],"sourcesContent":[],"mappings":";;;;;iBAuCgB,mBAAA,UACL,+BACI,yBACZ;iBAQa,uBAAA,UACL,+BACI,yBACZ;AAda,UAsBC,0BAAA,CAtBkB;EACxB,IAAA,CAAA,EAsBF,iBAtBE,GAsBkB,SAtBlB;EACI,eAAA,CAAA,EAsBK,eAtBL,CAAA,GAAA,CAAA;;AACG,cAwBL,OAAA,YAAmB,YAxBd,CAAA;EAQF,QAAA,EAAA,MAAA;EACL,WAAA,EAAA,MAAA;EACI,QAAA,EAAA,MAAA;EACZ,eAAA,EAAA,MAAA;EAAe,cAAA,EAAA,MAAA;EAQD,UAAA,EAAA,MAAA;EACR,WAAA,EAAA,MAAA;EAAoB,YAAA,EAAA,MAAA;EACT,QAAA,EAAA,MAAA,GAAA,SAAA,GAAA,SAAA;EAAe,IAAA,EAAA,aAAA,GAAA,MAAA,GAAA,YAAA;EAGtB,WAAQ,EAAA,MAAA;EAgDR,KAAA,EAAA,OAAY;EAIT,IAAA,EAAA,OAAA;EACL,OAAA,EAAA,OAAA;EACA,QAAA,EAAA,OAAA;EACR,WAAA,EAAA,MAAA,GAAA,OAAA;EAAe,eAAA,EAAA,MAAA,GAAA,OAAA;EAyCF,UAAA,EAAA,OAAA;EACL,kBAAA,EAAA,OAAA;EACA,SAAA,EAAA,MAAA;EACR,gBAAA,EAAA,MAAA;EAAe,cAAA,EAAA,MAAA;EAyCI,EAAA,EAAA,OAAA;;AAGP,cA/FF,WAAA,YAAuB,gBA+FrB,CAAA;EAAA,cAAA,EAAA,MAAA;;AAwCO,iBAnIN,mBAAA,CAmIoB,OAAA,EAlIzB,gBAkIyB,EAAA,OAAA,CAAA,EAjIzB,0BAiIyB,CAAA,EAhIjC,eAgIiC,CAAA,GAAA,CAAA;AACzB,iBAxFK,uBAAA,CAwFL,OAAA,EAvFA,gBAuFA,EAAA,OAAA,CAAA,EAtFA,0BAsFA,CAAA,EArFR,eAqFQ,CAAA,GAAA,CAAA;AAEI,iBA9CO,UAAA,CA8CP,OAAA,EA7CJ,gBA6CI,EAAA,IAAA,CAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,MAAA,CAAA,EA3CA,OA2CA,CA3CA,eA2CA,CAAA,GAAA,CAAA,CAAA;AAAA,iBAHO,cAAA,CAGP,OAAA,EAFJ,gBAEI,EAAA,IAAA,CAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,MAAA,CAAA,EAAA,OAAA,CAAA,eAAA,CAAA,GAAA,CAAA,CAAA;AAAA,6CAAA,GAAA,EAAA"}
+{"version":3,"file":"reflect.d.cts","names":[],"sources":["../../src/helpers/reflect.ts"],"sourcesContent":[],"mappings":";;;;;iBAuCgB,mBAAA,UACL,+BACI,yBACZ;iBAQa,uBAAA,UACL,+BACI,yBACZ;AAda,UAsBC,0BAAA,CAtBkB;EACxB,IAAA,CAAA,EAsBF,iBAtBE,GAsBkB,SAtBlB;EACI,eAAA,CAAA,EAsBK,eAtBL,CAAA,GAAA,CAAA;;AACG,cAwBL,OAAA,YAAmB,YAxBd,CAAA;EAQF,QAAA,EAAA,MAAA;EACL,WAAA,EAAA,MAAA;EACI,QAAA,EAAA,MAAA;EACZ,eAAA,EAAA,MAAA;EAAe,cAAA,EAAA,MAAA;EAQD,UAAA,EAAA,MAAA;EACR,WAAA,EAAA,MAAA;EAAoB,YAAA,EAAA,MAAA;EACT,QAAA,EAAA,MAAA,GAAA,SAAA,GAAA,SAAA;EAAe,IAAA,EAAA,aAAA,GAAA,MAAA,GAAA,YAAA;EAGtB,WAAQ,EAAA,MAAA;EAgDR,KAAA,EAAA,OAAY;EAIT,IAAA,EAAA,OAAA;EACL,OAAA,EAAA,OAAA;EACA,QAAA,EAAA,OAAA;EACR,WAAA,EAAA,MAAA,GAAA,OAAA;EAAe,eAAA,EAAA,MAAA,GAAA,OAAA;EAyCF,UAAA,EAAA,OAAA;EACL,kBAAA,EAAA,OAAA;EACA,SAAA,EAAA,MAAA;EACR,gBAAA,EAAA,MAAA;EAAe,cAAA,EAAA,MAAA;EAoDI,EAAA,EAAA,OAAA;;AAGP,cA1GF,WAAA,YAAuB,gBA0GrB,CAAA;EAAA,cAAA,EAAA,MAAA;;AAqCO,iBA3IN,mBAAA,CA2IoB,OAAA,EA1IzB,gBA0IyB,EAAA,OAAA,CAAA,EAzIzB,0BAyIyB,CAAA,EAxIjC,eAwIiC,CAAA,GAAA,CAAA;AACzB,iBAhGK,uBAAA,CAgGL,OAAA,EA/FA,gBA+FA,EAAA,OAAA,CAAA,EA9FA,0BA8FA,CAAA,EA7FR,eA6FQ,CAAA,GAAA,CAAA;;;;;;;;;;;;iBAzCW,UAAA,UACX,iDAEI,QAAA;;;;;;;;;;;;iBAqCO,cAAA,UACX,iDAEI,QAAA"}

package/dist/helpers/reflect.d.mts

@@ -39,7 +39,29 @@ declare class BaseSecrets implements SecretsInterface {
 }
 declare function createEnvReflection(context: EnvPluginContext, options?: CreateEnvReflectionOptions): ReflectionClass<any>;
 declare function createSecretsReflection(context: EnvPluginContext, options?: CreateEnvReflectionOptions): ReflectionClass<any>;
+/**
+ * Reflects the environment configuration type definition from the provided file and name, and merges it with the default environment configuration reflection and the currently used environment configuration reflection.
+ *
+ * @remarks
+ * The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.
+ *
+ * @param context - The plugin context
+ * @param file - The file path to reflect the environment configuration type definition from
+ * @param name - The name of the type definition to reflect the environment configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.
+ * @returns A reflection of the environment configuration type definition, merged with the default environment configuration reflection and the currently used environment configuration reflection. The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.
+ */
 declare function reflectEnv(context: EnvPluginContext, file?: string, name?: string): Promise<ReflectionClass<any>>;
+/**
+ * Reflects the secrets configuration type definition from the provided file and name, and merges it with the default secrets configuration reflection and the currently used secrets configuration reflection.
+ *
+ * @remarks
+ * The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.
+ *
+ * @param context - The plugin context
+ * @param file - The file path to reflect the secrets configuration type definition from
+ * @param name - The name of the type definition to reflect the secrets configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.
+ * @returns A reflection of the secrets configuration type definition, merged with the default secrets configuration reflection and the currently used secrets configuration reflection. The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.
+ */
 declare function reflectSecrets(context: EnvPluginContext, file?: string, name?: string): Promise<ReflectionClass<any>>;
 declare type __ΩCreateEnvReflectionOptions = any[];
 //#endregion

package/dist/helpers/reflect.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"reflect.d.mts","names":[],"sources":["../../src/helpers/reflect.ts"],"sourcesContent":[],"mappings":";;;;;iBAuCgB,mBAAA,UACL,+BACI,yBACZ;iBAQa,uBAAA,UACL,+BACI,yBACZ;AAda,UAsBC,0BAAA,CAtBkB;EACxB,IAAA,CAAA,EAsBF,iBAtBE,GAsBkB,SAtBlB;EACI,eAAA,CAAA,EAsBK,eAtBL,CAAA,GAAA,CAAA;;AACG,cAwBL,OAAA,YAAmB,YAxBd,CAAA;EAQF,QAAA,EAAA,MAAA;EACL,WAAA,EAAA,MAAA;EACI,QAAA,EAAA,MAAA;EACZ,eAAA,EAAA,MAAA;EAAe,cAAA,EAAA,MAAA;EAQD,UAAA,EAAA,MAAA;EACR,WAAA,EAAA,MAAA;EAAoB,YAAA,EAAA,MAAA;EACT,QAAA,EAAA,MAAA,GAAA,SAAA,GAAA,SAAA;EAAe,IAAA,EAAA,aAAA,GAAA,MAAA,GAAA,YAAA;EAGtB,WAAQ,EAAA,MAAA;EAgDR,KAAA,EAAA,OAAY;EAIT,IAAA,EAAA,OAAA;EACL,OAAA,EAAA,OAAA;EACA,QAAA,EAAA,OAAA;EACR,WAAA,EAAA,MAAA,GAAA,OAAA;EAAe,eAAA,EAAA,MAAA,GAAA,OAAA;EAyCF,UAAA,EAAA,OAAA;EACL,kBAAA,EAAA,OAAA;EACA,SAAA,EAAA,MAAA;EACR,gBAAA,EAAA,MAAA;EAAe,cAAA,EAAA,MAAA;EAyCI,EAAA,EAAA,OAAA;;AAGP,cA/FF,WAAA,YAAuB,gBA+FrB,CAAA;EAAA,cAAA,EAAA,MAAA;;AAwCO,iBAnIN,mBAAA,CAmIoB,OAAA,EAlIzB,gBAkIyB,EAAA,OAAA,CAAA,EAjIzB,0BAiIyB,CAAA,EAhIjC,eAgIiC,CAAA,GAAA,CAAA;AACzB,iBAxFK,uBAAA,CAwFL,OAAA,EAvFA,gBAuFA,EAAA,OAAA,CAAA,EAtFA,0BAsFA,CAAA,EArFR,eAqFQ,CAAA,GAAA,CAAA;AAEI,iBA9CO,UAAA,CA8CP,OAAA,EA7CJ,gBA6CI,EAAA,IAAA,CAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,MAAA,CAAA,EA3CA,OA2CA,CA3CA,eA2CA,CAAA,GAAA,CAAA,CAAA;AAAA,iBAHO,cAAA,CAGP,OAAA,EAFJ,gBAEI,EAAA,IAAA,CAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,MAAA,CAAA,EAAA,OAAA,CAAA,eAAA,CAAA,GAAA,CAAA,CAAA;AAAA,6CAAA,GAAA,EAAA"}
+{"version":3,"file":"reflect.d.mts","names":[],"sources":["../../src/helpers/reflect.ts"],"sourcesContent":[],"mappings":";;;;;iBAuCgB,mBAAA,UACL,+BACI,yBACZ;iBAQa,uBAAA,UACL,+BACI,yBACZ;AAda,UAsBC,0BAAA,CAtBkB;EACxB,IAAA,CAAA,EAsBF,iBAtBE,GAsBkB,SAtBlB;EACI,eAAA,CAAA,EAsBK,eAtBL,CAAA,GAAA,CAAA;;AACG,cAwBL,OAAA,YAAmB,YAxBd,CAAA;EAQF,QAAA,EAAA,MAAA;EACL,WAAA,EAAA,MAAA;EACI,QAAA,EAAA,MAAA;EACZ,eAAA,EAAA,MAAA;EAAe,cAAA,EAAA,MAAA;EAQD,UAAA,EAAA,MAAA;EACR,WAAA,EAAA,MAAA;EAAoB,YAAA,EAAA,MAAA;EACT,QAAA,EAAA,MAAA,GAAA,SAAA,GAAA,SAAA;EAAe,IAAA,EAAA,aAAA,GAAA,MAAA,GAAA,YAAA;EAGtB,WAAQ,EAAA,MAAA;EAgDR,KAAA,EAAA,OAAY;EAIT,IAAA,EAAA,OAAA;EACL,OAAA,EAAA,OAAA;EACA,QAAA,EAAA,OAAA;EACR,WAAA,EAAA,MAAA,GAAA,OAAA;EAAe,eAAA,EAAA,MAAA,GAAA,OAAA;EAyCF,UAAA,EAAA,OAAA;EACL,kBAAA,EAAA,OAAA;EACA,SAAA,EAAA,MAAA;EACR,gBAAA,EAAA,MAAA;EAAe,cAAA,EAAA,MAAA;EAoDI,EAAA,EAAA,OAAA;;AAGP,cA1GF,WAAA,YAAuB,gBA0GrB,CAAA;EAAA,cAAA,EAAA,MAAA;;AAqCO,iBA3IN,mBAAA,CA2IoB,OAAA,EA1IzB,gBA0IyB,EAAA,OAAA,CAAA,EAzIzB,0BAyIyB,CAAA,EAxIjC,eAwIiC,CAAA,GAAA,CAAA;AACzB,iBAhGK,uBAAA,CAgGL,OAAA,EA/FA,gBA+FA,EAAA,OAAA,CAAA,EA9FA,0BA8FA,CAAA,EA7FR,eA6FQ,CAAA,GAAA,CAAA;;;;;;;;;;;;iBAzCW,UAAA,UACX,iDAEI,QAAA;;;;;;;;;;;;iBAqCO,cAAA,UACX,iDAEI,QAAA"}

package/dist/helpers/reflect.mjs

@@ -207,17 +207,27 @@ createSecretsReflection.__type = [
 	"createSecretsReflection",
 	"Pn!2\"n#2$>%P\"7&/'"
 ];
+/**
+* Reflects the environment configuration type definition from the provided file and name, and merges it with the default environment configuration reflection and the currently used environment configuration reflection.
+*
+* @remarks
+* The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.
+*
+* @param context - The plugin context
+* @param file - The file path to reflect the environment configuration type definition from
+* @param name - The name of the type definition to reflect the environment configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.
+* @returns A reflection of the environment configuration type definition, merged with the default environment configuration reflection and the currently used environment configuration reflection. The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.
+*/
 async function reflectEnv(context, file, name) {
 	let config;
 	if (file) config = resolveClassType(await reflectType(context, {
 		file: !isParentPath(file, context.workspaceConfig.workspaceRoot) ? joinPaths(context.workspaceConfig.workspaceRoot, file) : file,
 		name
 	}));
-	const defaultConfigType = await reflectType(context, await getEnvDefaultTypeDefinition(context));
 	return mergeEnvReflections(context, [
 		await readEnvTypeReflection(context, "env"),
 		config,
-		resolveClassType(defaultConfigType)
+		resolveClassType(await reflectType(context, await getEnvDefaultTypeDefinition(context)))
 	].filter(Boolean));
 }
 reflectEnv.__type = [
@@ -226,19 +236,30 @@ reflectEnv.__type = [
 	"file",
 	"name",
 	"reflectEnv",
-	"Pn!2\"&2#8&2$8\"/%"
+	"Reflects the environment configuration type definition from the provided file and name, and merges it with the default environment configuration reflection and the currently used environment configuration reflection.",
+	"Pn!2\"&2#8&2$8\"/%?&"
 ];
+/**
+* Reflects the secrets configuration type definition from the provided file and name, and merges it with the default secrets configuration reflection and the currently used secrets configuration reflection.
+*
+* @remarks
+* The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.
+*
+* @param context - The plugin context
+* @param file - The file path to reflect the secrets configuration type definition from
+* @param name - The name of the type definition to reflect the secrets configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.
+* @returns A reflection of the secrets configuration type definition, merged with the default secrets configuration reflection and the currently used secrets configuration reflection. The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.
+*/
 async function reflectSecrets(context, file, name) {
 	let config;
 	if (file) config = resolveClassType(await reflectType(context, {
 		file: !isParentPath(file, context.workspaceConfig.workspaceRoot) ? joinPaths(context.workspaceConfig.workspaceRoot, file) : file,
 		name
 	}));
-	const defaultSecretsType = await reflectType(context, await getSecretsDefaultTypeDefinition(context));
 	return mergeSecretsReflections(context, [
 		await readSecretsReflection(context),
 		config,
-		resolveClassType(defaultSecretsType)
+		resolveClassType(await reflectType(context, await getSecretsDefaultTypeDefinition(context)))
 	].filter(Boolean));
 }
 reflectSecrets.__type = [
@@ -247,7 +268,8 @@ reflectSecrets.__type = [
 	"file",
 	"name",
 	"reflectSecrets",
-	"Pn!2\"&2#8&2$8\"/%"
+	"Reflects the secrets configuration type definition from the provided file and name, and merges it with the default secrets configuration reflection and the currently used secrets configuration reflection.",
+	"Pn!2\"&2#8&2$8\"/%?&"
 ];
 
 //#endregion

package/dist/helpers/reflect.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reflect.mjs","names":[],"sources":["../../src/helpers/reflect.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { reflectType } from \"@powerlines/deepkit/reflect-type\";\nimport {\n  merge,\n  ReflectionClass,\n  ReflectionKind,\n  resolveClassType,\n  TypeClass,\n  TypeObjectLiteral\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { EnvPluginContext } from \"../types/plugin\";\nimport { EnvInterface, SecretsInterface } from \"../types/runtime\";\nimport {\n  getEnvDefaultTypeDefinition,\n  getSecretsDefaultTypeDefinition,\n  readEnvTypeReflection,\n  readSecretsReflection\n} from \"./persistence\";\n\nexport function mergeEnvReflections(\n  context: EnvPluginContext,\n  reflections: ReflectionClass<any>[]\n): ReflectionClass<any> {\n  const reflection = createEnvReflection(context, {\n    type: merge(reflections.map(reflection => reflection.type))\n  });\n\n  return reflection;\n}\n\nexport function mergeSecretsReflections(\n  context: EnvPluginContext,\n  reflections: ReflectionClass<any>[]\n): ReflectionClass<any> {\n  const reflection = createSecretsReflection(context, {\n    type: merge(reflections.map(reflection => reflection.type))\n  });\n\n  return reflection;\n}\n\nexport interface CreateEnvReflectionOptions {\n  type?: TypeObjectLiteral | TypeClass;\n  superReflection?: ReflectionClass<any>;\n}\n\nexport class BaseEnv implements EnvInterface {\n  APP_NAME!: string;\n\n  APP_VERSION!: string;\n\n  BUILD_ID!: string;\n\n  BUILD_TIMESTAMP!: string;\n\n  BUILD_CHECKSUM!: string;\n\n  RELEASE_ID!: string;\n\n  RELEASE_TAG!: string;\n\n  ORGANIZATION!: string;\n\n  PLATFORM: \"node\" | \"browser\" | \"neutral\" = \"neutral\";\n\n  MODE: \"development\" | \"test\" | \"production\" = \"production\";\n\n  ENVIRONMENT!: string;\n\n  DEBUG: boolean = false;\n\n  TEST: boolean = false;\n\n  MINIMAL: boolean = false;\n\n  NO_COLOR: boolean = false;\n\n  FORCE_COLOR: number | boolean = false;\n\n  FORCE_HYPERLINK: number | boolean = false;\n\n  STACKTRACE: boolean = false;\n\n  INCLUDE_ERROR_DATA: boolean = false;\n\n  ERROR_URL!: string;\n\n  DEFAULT_TIMEZONE!: string;\n\n  DEFAULT_LOCALE!: string;\n\n  CI: boolean = false;\n}\n\nexport class BaseSecrets implements SecretsInterface {\n  ENCRYPTION_KEY!: string;\n}\n\nexport function createEnvReflection(\n  context: EnvPluginContext,\n  options: CreateEnvReflectionOptions = {}\n): ReflectionClass<any> {\n  const parent =\n    options.superReflection ??\n    new ReflectionClass({\n      kind: ReflectionKind.class,\n      description: `The base environment configuration definition for the ${titleCase(\n        context.config.name\n      )} project.`,\n      classType: BaseEnv,\n      types: [],\n      implements: [\n        {\n          kind: ReflectionKind.objectLiteral,\n          typeName: \"EnvInterface\",\n          description: `The environment configuration interface definition for the ${titleCase(\n            context.config.name\n          )} project.`,\n          types: []\n        }\n      ]\n    });\n  parent.name = \"Env\";\n\n  const result = new ReflectionClass(\n    options.type ?? {\n      kind: ReflectionKind.objectLiteral,\n      typeName: \"Env\",\n      description: `A schema describing the list of available environment variables that can be used by the ${\n        context.config.name\n          ? `${titleCase(context.config.name)} application`\n          : \"application\"\n      }.`,\n      types: []\n    },\n    parent\n  );\n  result.name = \"Env\";\n\n  return result;\n}\n\nexport function createSecretsReflection(\n  context: EnvPluginContext,\n  options: CreateEnvReflectionOptions = {}\n): ReflectionClass<any> {\n  const parent =\n    options.superReflection ??\n    new ReflectionClass({\n      kind: ReflectionKind.class,\n      description: `The base secrets configuration definition for the ${titleCase(\n        context.config.name\n      )} project.`,\n      classType: BaseSecrets,\n      types: [],\n      implements: [\n        {\n          kind: ReflectionKind.objectLiteral,\n          typeName: \"SecretsInterface\",\n          description: `The secrets configuration interface definition for the ${titleCase(\n            context.config.name\n          )} project.`,\n          types: []\n        }\n      ]\n    });\n  parent.name = \"Secrets\";\n\n  const result = new ReflectionClass(\n    options.type ?? {\n      kind: ReflectionKind.objectLiteral,\n      typeName: \"Secrets\",\n      description: `A schema describing the list of available environment secrets that can be used by the ${\n        context.config.name\n          ? `${titleCase(context.config.name)} application`\n          : \"application\"\n      }.`,\n      types: []\n    },\n    parent\n  );\n  result.name = \"Secrets\";\n\n  return result;\n}\n\nexport async function reflectEnv(\n  context: EnvPluginContext,\n  file?: string,\n  name?: string\n) {\n  let config: ReflectionClass<any> | undefined;\n  if (file) {\n    const configType = await reflectType(context, {\n      file: !isParentPath(file, context.workspaceConfig.workspaceRoot)\n        ? joinPaths(context.workspaceConfig.workspaceRoot, file)\n        : file,\n      name\n    });\n\n    config = resolveClassType(configType);\n  }\n\n  const defaultConfigType = await reflectType(\n    context,\n    await getEnvDefaultTypeDefinition(context)\n  );\n\n  const reflection = await readEnvTypeReflection(context, \"env\");\n\n  // const defaultConfig = resolveClassType(defaultConfigType);\n  // if (config) {\n  //   defaultConfig.getProperties().forEach(prop => {\n  //     if (!config!.hasProperty(prop.getName())) {\n  //       config!.addProperty(prop.property);\n  //     }\n  //   });\n  // } else {\n  //   config = defaultConfig;\n  // }\n\n  return mergeEnvReflections(\n    context,\n    [reflection, config, resolveClassType(defaultConfigType)].filter(\n      Boolean\n    ) as ReflectionClass<any>[]\n  );\n}\n\nexport async function reflectSecrets(\n  context: EnvPluginContext,\n  file?: string,\n  name?: string\n) {\n  let config: ReflectionClass<any> | undefined;\n  if (file) {\n    const configType = await reflectType(context, {\n      file: !isParentPath(file, context.workspaceConfig.workspaceRoot)\n        ? joinPaths(context.workspaceConfig.workspaceRoot, file)\n        : file,\n      name\n    });\n\n    config = resolveClassType(configType);\n  }\n\n  const defaultSecretsType = await reflectType(\n    context,\n    await getSecretsDefaultTypeDefinition(context)\n  );\n\n  const reflection = await readSecretsReflection(context);\n\n  // const defaultConfig = resolveClassType(defaultConfigType);\n  // if (config) {\n  //   defaultConfig.getProperties().forEach(prop => {\n  //     if (!config!.hasProperty(prop.getName())) {\n  //       config!.addProperty(prop.property);\n  //     }\n  //   });\n  // } else {\n  //   config = defaultConfig;\n  // }\n\n  return mergeSecretsReflections(\n    context,\n    [reflection, config, resolveClassType(defaultSecretsType)].filter(\n      Boolean\n    ) as ReflectionClass<any>[]\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"reflect.mjs","names":[],"sources":["../../src/helpers/reflect.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { reflectType } from \"@powerlines/deepkit/reflect-type\";\nimport {\n  merge,\n  ReflectionClass,\n  ReflectionKind,\n  resolveClassType,\n  TypeClass,\n  TypeObjectLiteral\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { EnvPluginContext } from \"../types/plugin\";\nimport { EnvInterface, SecretsInterface } from \"../types/runtime\";\nimport {\n  getEnvDefaultTypeDefinition,\n  getSecretsDefaultTypeDefinition,\n  readEnvTypeReflection,\n  readSecretsReflection\n} from \"./persistence\";\n\nexport function mergeEnvReflections(\n  context: EnvPluginContext,\n  reflections: ReflectionClass<any>[]\n): ReflectionClass<any> {\n  const reflection = createEnvReflection(context, {\n    type: merge(reflections.map(reflection => reflection.type))\n  });\n\n  return reflection;\n}\n\nexport function mergeSecretsReflections(\n  context: EnvPluginContext,\n  reflections: ReflectionClass<any>[]\n): ReflectionClass<any> {\n  const reflection = createSecretsReflection(context, {\n    type: merge(reflections.map(reflection => reflection.type))\n  });\n\n  return reflection;\n}\n\nexport interface CreateEnvReflectionOptions {\n  type?: TypeObjectLiteral | TypeClass;\n  superReflection?: ReflectionClass<any>;\n}\n\nexport class BaseEnv implements EnvInterface {\n  APP_NAME!: string;\n\n  APP_VERSION!: string;\n\n  BUILD_ID!: string;\n\n  BUILD_TIMESTAMP!: string;\n\n  BUILD_CHECKSUM!: string;\n\n  RELEASE_ID!: string;\n\n  RELEASE_TAG!: string;\n\n  ORGANIZATION!: string;\n\n  PLATFORM: \"node\" | \"browser\" | \"neutral\" = \"neutral\";\n\n  MODE: \"development\" | \"test\" | \"production\" = \"production\";\n\n  ENVIRONMENT!: string;\n\n  DEBUG: boolean = false;\n\n  TEST: boolean = false;\n\n  MINIMAL: boolean = false;\n\n  NO_COLOR: boolean = false;\n\n  FORCE_COLOR: number | boolean = false;\n\n  FORCE_HYPERLINK: number | boolean = false;\n\n  STACKTRACE: boolean = false;\n\n  INCLUDE_ERROR_DATA: boolean = false;\n\n  ERROR_URL!: string;\n\n  DEFAULT_TIMEZONE!: string;\n\n  DEFAULT_LOCALE!: string;\n\n  CI: boolean = false;\n}\n\nexport class BaseSecrets implements SecretsInterface {\n  ENCRYPTION_KEY!: string;\n}\n\nexport function createEnvReflection(\n  context: EnvPluginContext,\n  options: CreateEnvReflectionOptions = {}\n): ReflectionClass<any> {\n  const parent =\n    options.superReflection ??\n    new ReflectionClass({\n      kind: ReflectionKind.class,\n      description: `The base environment configuration definition for the ${titleCase(\n        context.config.name\n      )} project.`,\n      classType: BaseEnv,\n      types: [],\n      implements: [\n        {\n          kind: ReflectionKind.objectLiteral,\n          typeName: \"EnvInterface\",\n          description: `The environment configuration interface definition for the ${titleCase(\n            context.config.name\n          )} project.`,\n          types: []\n        }\n      ]\n    });\n  parent.name = \"Env\";\n\n  const result = new ReflectionClass(\n    options.type ?? {\n      kind: ReflectionKind.objectLiteral,\n      typeName: \"Env\",\n      description: `A schema describing the list of available environment variables that can be used by the ${\n        context.config.name\n          ? `${titleCase(context.config.name)} application`\n          : \"application\"\n      }.`,\n      types: []\n    },\n    parent\n  );\n  result.name = \"Env\";\n\n  return result;\n}\n\nexport function createSecretsReflection(\n  context: EnvPluginContext,\n  options: CreateEnvReflectionOptions = {}\n): ReflectionClass<any> {\n  const parent =\n    options.superReflection ??\n    new ReflectionClass({\n      kind: ReflectionKind.class,\n      description: `The base secrets configuration definition for the ${titleCase(\n        context.config.name\n      )} project.`,\n      classType: BaseSecrets,\n      types: [],\n      implements: [\n        {\n          kind: ReflectionKind.objectLiteral,\n          typeName: \"SecretsInterface\",\n          description: `The secrets configuration interface definition for the ${titleCase(\n            context.config.name\n          )} project.`,\n          types: []\n        }\n      ]\n    });\n  parent.name = \"Secrets\";\n\n  const result = new ReflectionClass(\n    options.type ?? {\n      kind: ReflectionKind.objectLiteral,\n      typeName: \"Secrets\",\n      description: `A schema describing the list of available environment secrets that can be used by the ${\n        context.config.name\n          ? `${titleCase(context.config.name)} application`\n          : \"application\"\n      }.`,\n      types: []\n    },\n    parent\n  );\n  result.name = \"Secrets\";\n\n  return result;\n}\n\n/**\n * Reflects the environment configuration type definition from the provided file and name, and merges it with the default environment configuration reflection and the currently used environment configuration reflection.\n *\n * @remarks\n * The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.\n *\n * @param context - The plugin context\n * @param file - The file path to reflect the environment configuration type definition from\n * @param name - The name of the type definition to reflect the environment configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.\n * @returns A reflection of the environment configuration type definition, merged with the default environment configuration reflection and the currently used environment configuration reflection. The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.\n */\nexport async function reflectEnv(\n  context: EnvPluginContext,\n  file?: string,\n  name?: string\n) {\n  let config: ReflectionClass<any> | undefined;\n  if (file) {\n    const configType = await reflectType(context, {\n      file: !isParentPath(file, context.workspaceConfig.workspaceRoot)\n        ? joinPaths(context.workspaceConfig.workspaceRoot, file)\n        : file,\n      name\n    });\n\n    config = resolveClassType(configType);\n  }\n\n  return mergeEnvReflections(\n    context,\n    [\n      await readEnvTypeReflection(context, \"env\"),\n      config,\n      resolveClassType(\n        await reflectType(context, await getEnvDefaultTypeDefinition(context))\n      )\n    ].filter(Boolean) as ReflectionClass<any>[]\n  );\n}\n\n/**\n * Reflects the secrets configuration type definition from the provided file and name, and merges it with the default secrets configuration reflection and the currently used secrets configuration reflection.\n *\n * @remarks\n * The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.\n *\n * @param context - The plugin context\n * @param file - The file path to reflect the secrets configuration type definition from\n * @param name - The name of the type definition to reflect the secrets configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.\n * @returns A reflection of the secrets configuration type definition, merged with the default secrets configuration reflection and the currently used secrets configuration reflection. The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.\n */\nexport async function reflectSecrets(\n  context: EnvPluginContext,\n  file?: string,\n  name?: string\n) {\n  let config: ReflectionClass<any> | undefined;\n  if (file) {\n    const configType = await reflectType(context, {\n      file: !isParentPath(file, context.workspaceConfig.workspaceRoot)\n        ? joinPaths(context.workspaceConfig.workspaceRoot, file)\n        : file,\n      name\n    });\n\n    config = resolveClassType(configType);\n  }\n\n  return mergeSecretsReflections(\n    context,\n    [\n      await readSecretsReflection(context),\n      config,\n      resolveClassType(\n        await reflectType(\n          context,\n          await getSecretsDefaultTypeDefinition(context)\n        )\n      )\n    ].filter(Boolean) as ReflectionClass<any>[]\n  );\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -4,7 +4,6 @@ const require_types_runtime = require('./types/runtime.cjs');
 const require_types_plugin = require('./types/plugin.cjs');
 require('./types/index.cjs');
 const require_join_paths = require('./node_modules/.pnpm/@stryke_path@0.26.6/node_modules/@stryke/path/dist/join-paths.cjs');
-const require_is_parent_path = require('./node_modules/.pnpm/@stryke_path@0.26.6/node_modules/@stryke/path/dist/is-parent-path.cjs');
 const require_helpers_reflect = require('./helpers/reflect.cjs');
 const require_helpers_persistence = require('./helpers/persistence.cjs');
 const require_helpers_template_helpers = require('./helpers/template-helpers.cjs');
@@ -50,6 +49,8 @@ const plugin = (options = {}) => {
 				const config = {
 					env: require_defu.defu(options, {
 						types: {},
+						validate: false,
+						inject: false,
 						prefix: []
 					}),
 					transform: { babel: { plugins: [require_babel_plugin.envBabelPlugin] } }
@@ -58,12 +59,14 @@ const plugin = (options = {}) => {
 				else {
 					this.warn("The `env.types` configuration parameter was not provided. Please ensure this is expected.");
 					const envDefaultTypeDefinition = await require_helpers_persistence.getEnvDefaultTypeDefinition(this);
-					config.env.types = require_parse_type_definition.parseTypeDefinition(`${envDefaultTypeDefinition.file}#${envDefaultTypeDefinition.name}`);
+					const file = await this.fs.resolve(envDefaultTypeDefinition.file);
+					if (file) config.env.types = require_parse_type_definition.parseTypeDefinition(`${file}#${envDefaultTypeDefinition.name}`);
 				}
 				if (config.env.secrets) config.env.secrets = require_parse_type_definition.parseTypeDefinition(config.env.secrets);
 				else {
 					const secretsDefaultTypeDefinition = await require_helpers_persistence.getSecretsDefaultTypeDefinition(this);
-					config.env.secrets = require_parse_type_definition.parseTypeDefinition(`${secretsDefaultTypeDefinition.file}#${secretsDefaultTypeDefinition.name}`);
+					const file = await this.fs.resolve(secretsDefaultTypeDefinition.file);
+					if (file) config.env.secrets = require_parse_type_definition.parseTypeDefinition(`${file}#${secretsDefaultTypeDefinition.name}`);
 				}
 				config.env.prefix = require_to_array.toArray(config.env.prefix ?? []).reduce((ret, prefix) => {
 					const formattedPrefix = (0, __stryke_string_format_constant_case.constantCase)(prefix);
@@ -82,7 +85,11 @@ const plugin = (options = {}) => {
 			},
 			async configResolved() {
 				this.debug(`Environment plugin configuration has been resolved for the Powerlines project.`);
-				this.env = require_defu.defu({ parsed: await require_helpers_load.loadEnv(this, this.config.env) }, this.env ?? {}, {
+				this.env = require_defu.defu({
+					parsed: await require_helpers_load.loadEnv(this, this.config.env),
+					validate: !!this.config.env.validate,
+					inject: !!this.config.env.inject
+				}, this.env ?? {}, {
 					types: { env: {} },
 					used: {
 						env: {},
@@ -99,10 +106,10 @@ const plugin = (options = {}) => {
 					if ((0, __stryke_fs_exists.existsSync)(require_helpers_persistence.getEnvReflectionsPath(this, "secrets"))) this.env.used.secrets = await require_helpers_persistence.readSecretsReflection(this);
 				} else {
 					this.debug(`Starting environment configuration reflection initialization.`);
-					this.env.types.env = await require_helpers_reflect.reflectEnv(this, this.config.env.types?.file ? require_is_parent_path.isParentPath(this.config.env.types?.file, this.workspaceConfig.workspaceRoot) ? this.config.env.types?.file : require_join_paths.joinPaths(this.config.projectRoot, this.config.env.types?.file) : void 0, this.config.env.types?.name);
+					this.env.types.env = await require_helpers_reflect.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.");
 					await require_helpers_persistence.writeEnvTypeReflection(this, this.env.types.env, "env");
-					this.env.types.secrets = await require_helpers_reflect.reflectSecrets(this, this.config.env.secrets?.file ? require_is_parent_path.isParentPath(this.config.env.secrets?.file, this.workspaceConfig.workspaceRoot) ? this.config.env.secrets?.file : require_join_paths.joinPaths(this.config.projectRoot, this.config.env.secrets?.file) : void 0, this.config.env.secrets?.name);
+					this.env.types.secrets = await require_helpers_reflect.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.");
 					await require_helpers_persistence.writeEnvTypeReflection(this, this.env.types.secrets, "secrets");
 					this.debug(`Resolved ${this.env.types.env.getProperties().length ?? 0} environment configuration parameters and ${this.env.types.secrets?.getProperties().length ?? 0} secret configuration parameters`);

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;cAoEa,0BAA2B,mBAAmB,4BAChD,qBAuVJ,OAAO"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;cAmEa,0BAA2B,mBAAmB,4BAChD,qBA6UJ,OAAO"}

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;cAoEa,0BAA2B,mBAAmB,4BAChD,qBAuVJ,OAAO"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;cAmEa,0BAA2B,mBAAmB,4BAChD,qBA6UJ,OAAO"}

package/dist/index.mjs

@@ -2,7 +2,6 @@ import { __ΩEnvInterface, __ΩSecretsInterface } from "./types/runtime.mjs";
 import { __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType } from "./types/plugin.mjs";
 import "./types/index.mjs";
 import { joinPaths } from "./node_modules/.pnpm/@stryke_path@0.26.6/node_modules/@stryke/path/dist/join-paths.mjs";
-import { isParentPath } from "./node_modules/.pnpm/@stryke_path@0.26.6/node_modules/@stryke/path/dist/is-parent-path.mjs";
 import { BaseEnv, BaseSecrets, __ΩCreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets } from "./helpers/reflect.mjs";
 import { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection } from "./helpers/persistence.mjs";
 import { createTemplateReflection } from "./helpers/template-helpers.mjs";
@@ -45,6 +44,8 @@ const plugin = (options = {}) => {
 				const config = {
 					env: defu(options, {
 						types: {},
+						validate: false,
+						inject: false,
 						prefix: []
 					}),
 					transform: { babel: { plugins: [envBabelPlugin] } }
@@ -53,12 +54,14 @@ const plugin = (options = {}) => {
 				else {
 					this.warn("The `env.types` configuration parameter was not provided. Please ensure this is expected.");
 					const envDefaultTypeDefinition = await getEnvDefaultTypeDefinition(this);
-					config.env.types = parseTypeDefinition(`${envDefaultTypeDefinition.file}#${envDefaultTypeDefinition.name}`);
+					const file = await this.fs.resolve(envDefaultTypeDefinition.file);
+					if (file) config.env.types = parseTypeDefinition(`${file}#${envDefaultTypeDefinition.name}`);
 				}
 				if (config.env.secrets) config.env.secrets = parseTypeDefinition(config.env.secrets);
 				else {
 					const secretsDefaultTypeDefinition = await getSecretsDefaultTypeDefinition(this);
-					config.env.secrets = parseTypeDefinition(`${secretsDefaultTypeDefinition.file}#${secretsDefaultTypeDefinition.name}`);
+					const file = await this.fs.resolve(secretsDefaultTypeDefinition.file);
+					if (file) config.env.secrets = parseTypeDefinition(`${file}#${secretsDefaultTypeDefinition.name}`);
 				}
 				config.env.prefix = toArray(config.env.prefix ?? []).reduce((ret, prefix) => {
 					const formattedPrefix = constantCase(prefix);
@@ -77,7 +80,11 @@ const plugin = (options = {}) => {
 			},
 			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 ?? {}, {
+				this.env = defu({
+					parsed: await loadEnv(this, this.config.env),
+					validate: !!this.config.env.validate,
+					inject: !!this.config.env.inject
+				}, this.env ?? {}, {
 					types: { env: {} },
 					used: {
 						env: {},
@@ -94,10 +101,10 @@ const plugin = (options = {}) => {
 					if (existsSync(getEnvReflectionsPath(this, "secrets"))) this.env.used.secrets = await readSecretsReflection(this);
 				} else {
 					this.debug(`Starting environment configuration reflection initialization.`);
-					this.env.types.env = await reflectEnv(this, this.config.env.types?.file ? isParentPath(this.config.env.types?.file, this.workspaceConfig.workspaceRoot) ? this.config.env.types?.file : joinPaths(this.config.projectRoot, this.config.env.types?.file) : void 0, this.config.env.types?.name);
+					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.");
 					await writeEnvTypeReflection(this, this.env.types.env, "env");
-					this.env.types.secrets = await reflectSecrets(this, this.config.env.secrets?.file ? isParentPath(this.config.env.secrets?.file, this.workspaceConfig.workspaceRoot) ? this.config.env.secrets?.file : joinPaths(this.config.projectRoot, this.config.env.secrets?.file) : void 0, this.config.env.secrets?.name);
+					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.");
 					await writeEnvTypeReflection(this, this.env.types.secrets, "secrets");
 					this.debug(`Resolved ${this.env.types.env.getProperties().length ?? 0} environment configuration parameters and ${this.env.types.secrets?.getProperties().length ?? 0} secret configuration parameters`);

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["ReflectionClass","ReflectionKind","alloy","render","automd","babel","parseTypeDefinition","toArray","ENV_PREFIXES","existsSync","isParentPath","joinPaths","constantCase","defu","envBabelPlugin","EnvDocsFile","EnvBuiltin","env","getDocsOutputPath","loadEnv","getEnvDefaultTypeDefinition","getEnvReflectionsPath","getEnvTypeReflectionsPath","getSecretsDefaultTypeDefinition","readEnvReflection","readEnvTypeReflection","readSecretsReflection","writeEnvReflection","writeEnvTypeReflection","reflectEnv","reflectSecrets","plugin","options","name","config","debug","types","prefix","transform","plugins","warn","envDefaultTypeDefinition","file","secrets","secretsDefaultTypeDefinition","reduce","ret","formattedPrefix","includes","push","framework","filter","Boolean","replace","configResolved","parsed","used","injected","command","skipCache","persistedMeta","checksum","meta","workspaceConfig","workspaceRoot","projectRoot","undefined","Error","getProperties","length","envWithAlias","prop","getAlias","Object","entries","forEach","key","value","unprefixedKey","startsWith","slice","aliasKey","find","reverse","hasProperty","getProperty","setDefaultValue","kind","objectLiteral","typeName","description","prepare","_self$","result","_$createComponent","defaultConfig","reflection","order","handler","trace","docs","levelOffset","buildEnd","reflectionPath","generators","vite","envPrefix"],"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 alloy from \"@powerlines/plugin-alloy\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport babel from \"@powerlines/plugin-babel\";\nimport { parseTypeDefinition } from \"@stryke/convert/parse-type-definition\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { ENV_PREFIXES } from \"@stryke/env/types\";\nimport { existsSync } from \"@stryke/fs/exists\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport {\n  TypeDefinition,\n  TypeDefinitionParameter\n} from \"@stryke/types/configuration\";\nimport defu from \"defu\";\nimport { Plugin } from \"powerlines/types/plugin\";\nimport type { UserConfig as ViteUserConfig } from \"vite\";\nimport { envBabelPlugin } from \"./babel/plugin\";\nimport { EnvDocsFile } from \"./components/docs\";\nimport { EnvBuiltin } from \"./components/env\";\nimport { env } from \"./helpers/automd-generator\";\nimport { getDocsOutputPath } from \"./helpers/docs-helper\";\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 \"./babel\";\nexport * from \"./components\";\nexport * from \"./helpers\";\nexport * from \"./types\";\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    alloy(options.alloy),\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            prefix: []\n          }),\n          transform: {\n            babel: {\n              plugins: [envBabelPlugin]\n            }\n          }\n        };\n\n        if (config.env.types) {\n          config.env.types = parseTypeDefinition(\n            config.env.types\n          ) as TypeDefinition;\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          config.env.types = parseTypeDefinition(\n            `${envDefaultTypeDefinition.file}#${envDefaultTypeDefinition.name}`\n          ) as TypeDefinition;\n        }\n\n        if (config.env.secrets) {\n          config.env.secrets = parseTypeDefinition(\n            config.env.secrets\n          ) as TypeDefinition;\n        } else {\n          const secretsDefaultTypeDefinition =\n            await getSecretsDefaultTypeDefinition(this);\n          config.env.secrets = parseTypeDefinition(\n            `${secretsDefaultTypeDefinition.file}#${\n              secretsDefaultTypeDefinition.name\n            }`\n          ) as TypeDefinition;\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            ...ENV_PREFIXES,\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 = 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        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        ) as EnvPluginContext[\"env\"];\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          if (existsSync(getEnvReflectionsPath(this, \"env\"))) {\n            this.env.used.env = await readEnvReflection(this);\n          }\n\n          if (existsSync(getEnvTypeReflectionsPath(this, \"secrets\"))) {\n            this.env.types.secrets = await readEnvTypeReflection(\n              this,\n              \"secrets\"\n            );\n          }\n\n          if (existsSync(getEnvReflectionsPath(this, \"secrets\"))) {\n            this.env.used.secrets = await readSecretsReflection(this);\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              ? isParentPath(\n                  this.config.env.types?.file,\n                  this.workspaceConfig.workspaceRoot\n                )\n                ? this.config.env.types?.file\n                : joinPaths(\n                    this.config.projectRoot,\n                    this.config.env.types?.file\n                  )\n              : undefined,\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          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              ? isParentPath(\n                  this.config.env.secrets?.file,\n                  this.workspaceConfig.workspaceRoot\n                )\n                ? this.config.env.secrets?.file\n                : joinPaths(\n                    this.config.projectRoot,\n                    this.config.env.secrets?.file\n                  )\n              : undefined,\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          await writeEnvTypeReflection(this, this.env.types.secrets, \"secrets\");\n\n          this.debug(\n            `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),\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":["ReflectionClass","ReflectionKind","alloy","render","automd","babel","parseTypeDefinition","toArray","ENV_PREFIXES","existsSync","joinPaths","constantCase","defu","envBabelPlugin","EnvDocsFile","EnvBuiltin","env","getDocsOutputPath","loadEnv","getEnvDefaultTypeDefinition","getEnvReflectionsPath","getEnvTypeReflectionsPath","getSecretsDefaultTypeDefinition","readEnvReflection","readEnvTypeReflection","readSecretsReflection","writeEnvReflection","writeEnvTypeReflection","reflectEnv","reflectSecrets","plugin","options","name","config","debug","types","validate","inject","prefix","transform","plugins","warn","envDefaultTypeDefinition","file","fs","resolve","secrets","secretsDefaultTypeDefinition","reduce","ret","formattedPrefix","includes","push","framework","filter","Boolean","replace","configResolved","parsed","used","injected","command","skipCache","persistedMeta","checksum","meta","Error","getProperties","length","envWithAlias","prop","getAlias","Object","entries","forEach","key","value","unprefixedKey","startsWith","slice","aliasKey","find","reverse","hasProperty","getProperty","setDefaultValue","kind","objectLiteral","typeName","description","prepare","_self$","result","_$createComponent","defaultConfig","reflection","order","handler","trace","docs","levelOffset","buildEnd","reflectionPath","generators","vite","envPrefix"],"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 alloy from \"@powerlines/plugin-alloy\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport babel from \"@powerlines/plugin-babel\";\nimport { parseTypeDefinition } from \"@stryke/convert/parse-type-definition\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { ENV_PREFIXES } from \"@stryke/env/types\";\nimport { existsSync } from \"@stryke/fs/exists\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport {\n  TypeDefinition,\n  TypeDefinitionParameter\n} from \"@stryke/types/configuration\";\nimport defu from \"defu\";\nimport { Plugin } from \"powerlines/types/plugin\";\nimport type { UserConfig as ViteUserConfig } from \"vite\";\nimport { envBabelPlugin } from \"./babel/plugin\";\nimport { EnvDocsFile } from \"./components/docs\";\nimport { EnvBuiltin } from \"./components/env\";\nimport { env } from \"./helpers/automd-generator\";\nimport { getDocsOutputPath } from \"./helpers/docs-helper\";\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 \"./babel\";\nexport * from \"./components\";\nexport * from \"./helpers\";\nexport * from \"./types\";\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    alloy(options.alloy),\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          transform: {\n            babel: {\n              plugins: [envBabelPlugin]\n            }\n          }\n        };\n\n        if (config.env.types) {\n          config.env.types = parseTypeDefinition(\n            config.env.types\n          ) as TypeDefinition;\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 (config.env.secrets) {\n          config.env.secrets = parseTypeDefinition(\n            config.env.secrets\n          ) as TypeDefinition;\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            ) as TypeDefinition;\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            ...ENV_PREFIXES,\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 = 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        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            validate: !!this.config.env.validate,\n            inject: !!this.config.env.inject\n          },\n          this.env ?? {},\n          {\n            types: {\n              env: {}\n            },\n            used: {\n              env: {},\n              secrets: {}\n            },\n            parsed: {},\n            injected: {}\n          }\n        ) as EnvPluginContext[\"env\"];\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          if (existsSync(getEnvReflectionsPath(this, \"env\"))) {\n            this.env.used.env = await readEnvReflection(this);\n          }\n\n          if (existsSync(getEnvTypeReflectionsPath(this, \"secrets\"))) {\n            this.env.types.secrets = await readEnvTypeReflection(\n              this,\n              \"secrets\"\n            );\n          }\n\n          if (existsSync(getEnvReflectionsPath(this, \"secrets\"))) {\n            this.env.used.secrets = await readSecretsReflection(this);\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          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          await writeEnvTypeReflection(this, this.env.types.secrets, \"secrets\");\n\n          this.debug(\n            `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),\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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"}

package/dist/types/plugin.cjs

@@ -49,6 +49,8 @@ const __ΩEnvPluginOptions = [
 	"inject",
 	true,
 	"Should the plugin inject the env variables in the source code with their values?",
+	"validate",
+	"Should the plugin validate the loaded environment variables against the provided type definitions?",
 	"Children",
 	"defaultConfig",
 	"The default configuration to use when loading environment variables.",
@@ -62,7 +64,7 @@ const __ΩEnvPluginOptions = [
 	"alloy",
 	"Alloy configuration options to use when injecting environment variables into the source code.",
 	"EnvPluginOptions",
-	"P!.\"o!#P!4#8?$!4%8?&P&&FJ4'8?()4)8>*?+\"w,4-8?.n/408?1n2438?4n5468?7MKw8y"
+	"P!.\"o!#P!4#8?$!4%8?&P&&FJ4'8?()4)8>*?+)4,8>*?-\"w.4/8?0n1428?3n4458?6n7488?9MKw:y"
 ];
 const __ΩEnvPluginUserConfig = [
 	() => __powerlines_plugin_babel_types.__ΩBabelPluginUserConfig,
@@ -90,11 +92,15 @@ const __ΩEnvPluginResolvedConfig = [
 	"inject",
 	"inject",
 	"Should the plugin inject the env variables in the source code with their values?",
+	() => __ΩEnvPluginOptions,
+	"validate",
+	"validate",
+	"Should the plugin validate the loaded environment variables against the provided type definitions?",
 	"prefix",
 	"The prefix used for environment variables",
 	"env",
 	"EnvPluginResolvedConfig",
-	"Pn!n\"PP!.%o$#o#\"n(.)o'#o&\"P!4*?+!4,?-n../f40?1&F42?3MK44MKw5y"
+	"Pn!n\"PP!.%o$#o#\"n(.)o'#o&\"P!4*?+!4,?-n../f40?1n2.3f44?5&F46?7MK48MKw9y"
 ];
 const __ΩEnvPluginContext = [
 	() => __ΩEnvPluginResolvedConfig,

package/dist/types/plugin.d.cts

@@ -31,6 +31,12 @@ type EnvPluginOptions = Omit<DotenvConfiguration, "types"> & {
    * @defaultValue false
    */
   inject?: boolean;
+  /**
+   * Should the plugin validate the loaded environment variables against the provided type definitions?
+   *
+   * @defaultValue false
+   */
+  validate?: boolean;
   /**
    * The default configuration to use when loading environment variables.
    *
@@ -86,6 +92,13 @@ type EnvPluginResolvedConfig = BabelPluginResolvedConfig & AlloyPluginResolvedCo
      * This value is the result of reflecting the {@link EnvPluginOptions.inject} option.
      */
     inject: EnvPluginOptions["inject"];
+    /**
+     * Should the plugin validate the loaded environment variables against the provided type definitions?
+     *
+     * @remarks
+     * This value is the result of reflecting the {@link EnvPluginOptions.validate} option.
+     */
+    validate: EnvPluginOptions["validate"];
     /**
      * The prefix used for environment variables
      *

package/dist/types/plugin.d.cts.map

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

package/dist/types/plugin.d.mts

@@ -31,6 +31,12 @@ type EnvPluginOptions = Omit<DotenvConfiguration, "types"> & {
    * @defaultValue false
    */
   inject?: boolean;
+  /**
+   * Should the plugin validate the loaded environment variables against the provided type definitions?
+   *
+   * @defaultValue false
+   */
+  validate?: boolean;
   /**
    * The default configuration to use when loading environment variables.
    *
@@ -86,6 +92,13 @@ type EnvPluginResolvedConfig = BabelPluginResolvedConfig & AlloyPluginResolvedCo
      * This value is the result of reflecting the {@link EnvPluginOptions.inject} option.
      */
     inject: EnvPluginOptions["inject"];
+    /**
+     * Should the plugin validate the loaded environment variables against the provided type definitions?
+     *
+     * @remarks
+     * This value is the result of reflecting the {@link EnvPluginOptions.validate} option.
+     */
+    validate: EnvPluginOptions["validate"];
     /**
      * The prefix used for environment variables
      *

package/dist/types/plugin.d.mts.map

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

package/dist/types/plugin.mjs

@@ -48,6 +48,8 @@ const __ΩEnvPluginOptions = [
 	"inject",
 	true,
 	"Should the plugin inject the env variables in the source code with their values?",
+	"validate",
+	"Should the plugin validate the loaded environment variables against the provided type definitions?",
 	"Children",
 	"defaultConfig",
 	"The default configuration to use when loading environment variables.",
@@ -61,7 +63,7 @@ const __ΩEnvPluginOptions = [
 	"alloy",
 	"Alloy configuration options to use when injecting environment variables into the source code.",
 	"EnvPluginOptions",
-	"P!.\"o!#P!4#8?$!4%8?&P&&FJ4'8?()4)8>*?+\"w,4-8?.n/408?1n2438?4n5468?7MKw8y"
+	"P!.\"o!#P!4#8?$!4%8?&P&&FJ4'8?()4)8>*?+)4,8>*?-\"w.4/8?0n1428?3n4458?6n7488?9MKw:y"
 ];
 const __ΩEnvPluginUserConfig = [
 	() => __ΩBabelPluginUserConfig,
@@ -89,11 +91,15 @@ const __ΩEnvPluginResolvedConfig = [
 	"inject",
 	"inject",
 	"Should the plugin inject the env variables in the source code with their values?",
+	() => __ΩEnvPluginOptions,
+	"validate",
+	"validate",
+	"Should the plugin validate the loaded environment variables against the provided type definitions?",
 	"prefix",
 	"The prefix used for environment variables",
 	"env",
 	"EnvPluginResolvedConfig",
-	"Pn!n\"PP!.%o$#o#\"n(.)o'#o&\"P!4*?+!4,?-n../f40?1&F42?3MK44MKw5y"
+	"Pn!n\"PP!.%o$#o#\"n(.)o'#o&\"P!4*?+!4,?-n../f40?1n2.3f44?5&F46?7MK48MKw9y"
 ];
 const __ΩEnvPluginContext = [
 	() => __ΩEnvPluginResolvedConfig,

package/dist/types/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Children } from \"@alloy-js/core\";\nimport { Reflection } from \"@powerlines/deepkit/types\";\nimport {\n  AlloyPluginContext,\n  AlloyPluginOptions,\n  AlloyPluginResolvedConfig,\n  AlloyPluginUserConfig\n} from \"@powerlines/plugin-alloy/types\";\nimport { AutoMDPluginOptions } from \"@powerlines/plugin-automd/types/plugin\";\nimport {\n  BabelPluginContext,\n  BabelPluginOptions,\n  BabelPluginResolvedConfig,\n  BabelPluginUserConfig\n} from \"@powerlines/plugin-babel/types\";\nimport type { DotenvParseOutput } from \"@stryke/env/types\";\nimport {\n  DotenvConfiguration,\n  TypeDefinition,\n  TypeDefinitionParameter\n} from \"@stryke/types/configuration\";\nimport { EnvInterface, SecretsInterface } from \"./runtime\";\n\nexport type EnvType = \"env\" | \"secrets\";\n\nexport type EnvPluginOptions = Omit<DotenvConfiguration, \"types\"> & {\n  /**\n   * A path to the type definition for the expected env configuration parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigConfiguration\"`.\n   */\n  types?: TypeDefinitionParameter;\n\n  /**\n   * A path to the type definition for the expected env secret parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigSecrets\"`.\n   */\n  secrets?: TypeDefinitionParameter;\n\n  /**\n   * An additional prefix (or list of additional prefixes) to apply to the environment variables\n   *\n   * @remarks\n   * By default, the plugin will use the `POWERLINES_` prefix. This option is useful for avoiding conflicts with other environment variables.\n   */\n  prefix?: string | string[];\n\n  /**\n   * Should the plugin inject the env variables in the source code with their values?\n   *\n   * @defaultValue false\n   */\n  inject?: boolean;\n\n  /**\n   * The default configuration to use when loading environment variables.\n   *\n   * @remarks\n   * This configuration is used as the base configuration when loading environment variables, and will be overridden by any values found in the `.env` file or the process environment.\n   */\n  defaultConfig?: Children;\n\n  /**\n   * Babel configuration options to use when injecting environment variables into the source code.\n   *\n   * @remarks\n   * This option allows you to customize the Babel transformation process used to inject environment variables into the source code. If not provided, the plugin will use default Babel settings.\n   */\n  babel?: BabelPluginOptions;\n\n  /**\n   * AutoMD configuration options to allow injecting environment variables documentation into a markdown file such as a README.md.\n   *\n   * @remarks\n   * The README.md file should contain the `<!-- automd:env --><!-- /automd -->` comment block where the documentation will be injected.\n   */\n  automd?: AutoMDPluginOptions;\n\n  /**\n   * Alloy configuration options to use when injecting environment variables into the source code.\n   *\n   * @remarks\n   * This option allows you to customize the Alloy transformation process used to inject environment variables into the source code. If not provided, the plugin will use default Alloy settings.\n   */\n  alloy?: AlloyPluginOptions;\n};\n\nexport type EnvPluginUserConfig = BabelPluginUserConfig &\n  AlloyPluginUserConfig & {\n    env: EnvPluginOptions;\n  };\n\nexport type EnvPluginResolvedConfig = BabelPluginResolvedConfig &\n  AlloyPluginResolvedConfig & {\n    env: Required<Pick<DotenvConfiguration, \"additionalFiles\">> &\n      Required<Pick<EnvPluginOptions, \"defaultConfig\">> & {\n        /**\n         * The type definition for the expected env variable parameters\n         *\n         * @remarks\n         * This value is parsed from the {@link EnvPluginOptions.types} option.\n         */\n        types: TypeDefinition;\n\n        /**\n         * The type definition for the expected env secret parameters\n         *\n         * @remarks\n         * This value is parsed from the {@link EnvPluginOptions.secrets} option.\n         */\n        secrets: TypeDefinition;\n\n        /**\n         * Should the plugin inject the env variables in the source code with their values?\n         *\n         * @remarks\n         * This value is the result of reflecting the {@link EnvPluginOptions.inject} option.\n         */\n        inject: EnvPluginOptions[\"inject\"];\n\n        /**\n         * The prefix used for environment variables\n         *\n         * @remarks\n         * This value is used to filter environment variables that are loaded from the .env file and the process environment.\n         */\n        prefix: string[];\n      };\n  };\n\nexport interface EnvPluginContext<\n  TResolvedConfig extends EnvPluginResolvedConfig = EnvPluginResolvedConfig\n>\n  extends\n    BabelPluginContext<TResolvedConfig>,\n    AlloyPluginContext<TResolvedConfig> {\n  env: {\n    /**\n     * The type definitions reflection for the env variables and secrets\n     *\n     * @remarks\n     * These reflections contains the structure of the expected environment variables and secrets as defined by the type definitions provided in the plugin configuration.\n     */\n    types: {\n      /**\n       * The type definitions for the expected env variables\n       */\n      env: Reflection;\n\n      /**\n       * The type definitions for the expected env secrets\n       */\n      secrets: Reflection;\n    };\n\n    /**\n     * The current **used** environment variables and secrets reflection\n     *\n     * @remarks\n     * This reflection contains the structure of the current environment variables and secrets as defined during the plugin initialization by extracting the values from the source code.\n     */\n    used: {\n      /**\n       * The current env variables reflection\n       */\n      env: Reflection<EnvInterface>;\n\n      /**\n       * The current env secrets reflection\n       */\n      secrets: Reflection<SecretsInterface>;\n    };\n\n    /**\n     * The parsed .env configuration object\n     *\n     * @remarks\n     * This value is the result of loading the .env configuration file found in the project root directory and merging it with the values provided at {@link EnvPluginOptions.values}\n     */\n    parsed: DotenvParseOutput;\n\n    /**\n     * The injected environment variables and secrets reflection\n     *\n     * @remarks\n     * This reflection contains the structure of the injected environment variables and secrets that were injected into the source code during the build process.\n     */\n    injected: Reflection;\n  };\n}\n"],"mappings":";;;;;;;AAAA,MAAM,UAAU;CAAC;CAAK;OAAW;OAAe;CAAY;CAAQ;CAAC;;;;;;AAErE,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAAY;;;;;;;AA0B/C,MAAM,aAAa;CAAC;CAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,sBAAqB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAE3B,MAAM,yBAAyB;OAAO;OAAC;OAAA;CAAA;CAAA;CAAA;CAAA;AAEvC,MAAM,6BAAC;OAAA;OAAA;OAAA;OAAA;CAAA;OAAA;OAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEP,MAAM,sBAAU;OAAA;CAAA;OAAA;OAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;OAAA;OAAA;CAAA;OAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Children } from \"@alloy-js/core\";\nimport { Reflection } from \"@powerlines/deepkit/types\";\nimport {\n  AlloyPluginContext,\n  AlloyPluginOptions,\n  AlloyPluginResolvedConfig,\n  AlloyPluginUserConfig\n} from \"@powerlines/plugin-alloy/types\";\nimport { AutoMDPluginOptions } from \"@powerlines/plugin-automd/types/plugin\";\nimport {\n  BabelPluginContext,\n  BabelPluginOptions,\n  BabelPluginResolvedConfig,\n  BabelPluginUserConfig\n} from \"@powerlines/plugin-babel/types\";\nimport type { DotenvParseOutput } from \"@stryke/env/types\";\nimport {\n  DotenvConfiguration,\n  TypeDefinition,\n  TypeDefinitionParameter\n} from \"@stryke/types/configuration\";\nimport { EnvInterface, SecretsInterface } from \"./runtime\";\n\nexport type EnvType = \"env\" | \"secrets\";\n\nexport type EnvPluginOptions = Omit<DotenvConfiguration, \"types\"> & {\n  /**\n   * A path to the type definition for the expected env configuration parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigConfiguration\"`.\n   */\n  types?: TypeDefinitionParameter;\n\n  /**\n   * A path to the type definition for the expected env secret parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigSecrets\"`.\n   */\n  secrets?: TypeDefinitionParameter;\n\n  /**\n   * An additional prefix (or list of additional prefixes) to apply to the environment variables\n   *\n   * @remarks\n   * By default, the plugin will use the `POWERLINES_` prefix. This option is useful for avoiding conflicts with other environment variables.\n   */\n  prefix?: string | string[];\n\n  /**\n   * Should the plugin inject the env variables in the source code with their values?\n   *\n   * @defaultValue false\n   */\n  inject?: boolean;\n\n  /**\n   * Should the plugin validate the loaded environment variables against the provided type definitions?\n   *\n   * @defaultValue false\n   */\n  validate?: boolean;\n\n  /**\n   * The default configuration to use when loading environment variables.\n   *\n   * @remarks\n   * This configuration is used as the base configuration when loading environment variables, and will be overridden by any values found in the `.env` file or the process environment.\n   */\n  defaultConfig?: Children;\n\n  /**\n   * Babel configuration options to use when injecting environment variables into the source code.\n   *\n   * @remarks\n   * This option allows you to customize the Babel transformation process used to inject environment variables into the source code. If not provided, the plugin will use default Babel settings.\n   */\n  babel?: BabelPluginOptions;\n\n  /**\n   * AutoMD configuration options to allow injecting environment variables documentation into a markdown file such as a README.md.\n   *\n   * @remarks\n   * The README.md file should contain the `<!-- automd:env --><!-- /automd -->` comment block where the documentation will be injected.\n   */\n  automd?: AutoMDPluginOptions;\n\n  /**\n   * Alloy configuration options to use when injecting environment variables into the source code.\n   *\n   * @remarks\n   * This option allows you to customize the Alloy transformation process used to inject environment variables into the source code. If not provided, the plugin will use default Alloy settings.\n   */\n  alloy?: AlloyPluginOptions;\n};\n\nexport type EnvPluginUserConfig = BabelPluginUserConfig &\n  AlloyPluginUserConfig & {\n    env: EnvPluginOptions;\n  };\n\nexport type EnvPluginResolvedConfig = BabelPluginResolvedConfig &\n  AlloyPluginResolvedConfig & {\n    env: Required<Pick<DotenvConfiguration, \"additionalFiles\">> &\n      Required<Pick<EnvPluginOptions, \"defaultConfig\">> & {\n        /**\n         * The type definition for the expected env variable parameters\n         *\n         * @remarks\n         * This value is parsed from the {@link EnvPluginOptions.types} option.\n         */\n        types: TypeDefinition;\n\n        /**\n         * The type definition for the expected env secret parameters\n         *\n         * @remarks\n         * This value is parsed from the {@link EnvPluginOptions.secrets} option.\n         */\n        secrets: TypeDefinition;\n\n        /**\n         * Should the plugin inject the env variables in the source code with their values?\n         *\n         * @remarks\n         * This value is the result of reflecting the {@link EnvPluginOptions.inject} option.\n         */\n        inject: EnvPluginOptions[\"inject\"];\n\n        /**\n         * Should the plugin validate the loaded environment variables against the provided type definitions?\n         *\n         * @remarks\n         * This value is the result of reflecting the {@link EnvPluginOptions.validate} option.\n         */\n        validate: EnvPluginOptions[\"validate\"];\n\n        /**\n         * The prefix used for environment variables\n         *\n         * @remarks\n         * This value is used to filter environment variables that are loaded from the .env file and the process environment.\n         */\n        prefix: string[];\n      };\n  };\n\nexport interface EnvPluginContext<\n  TResolvedConfig extends EnvPluginResolvedConfig = EnvPluginResolvedConfig\n>\n  extends\n    BabelPluginContext<TResolvedConfig>,\n    AlloyPluginContext<TResolvedConfig> {\n  env: {\n    /**\n     * The type definitions reflection for the env variables and secrets\n     *\n     * @remarks\n     * These reflections contains the structure of the expected environment variables and secrets as defined by the type definitions provided in the plugin configuration.\n     */\n    types: {\n      /**\n       * The type definitions for the expected env variables\n       */\n      env: Reflection;\n\n      /**\n       * The type definitions for the expected env secrets\n       */\n      secrets: Reflection;\n    };\n\n    /**\n     * The current **used** environment variables and secrets reflection\n     *\n     * @remarks\n     * This reflection contains the structure of the current environment variables and secrets as defined during the plugin initialization by extracting the values from the source code.\n     */\n    used: {\n      /**\n       * The current env variables reflection\n       */\n      env: Reflection<EnvInterface>;\n\n      /**\n       * The current env secrets reflection\n       */\n      secrets: Reflection<SecretsInterface>;\n    };\n\n    /**\n     * The parsed .env configuration object\n     *\n     * @remarks\n     * This value is the result of loading the .env configuration file found in the project root directory and merging it with the values provided at {@link EnvPluginOptions.values}\n     */\n    parsed: DotenvParseOutput;\n\n    /**\n     * The injected environment variables and secrets reflection\n     *\n     * @remarks\n     * This reflection contains the structure of the injected environment variables and secrets that were injected into the source code during the build process.\n     */\n    injected: Reflection;\n  };\n}\n"],"mappings":";;;;;;;AAAA,MAAM,UAAU;CAAC;CAAK;OAAW;OAAe;CAAY;CAAQ;CAAC;;;;;;AAErE,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAAY;;;;;;;AA0B/C,MAAM,aAAa;CAAC;CAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,sBAAqB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAE3B,MAAM,yBAAyB;OAAO;OAAC;OAAA;CAAA;CAAA;CAAA;CAAA;AAEvC,MAAM,6BAAC;OAAA;OAAA;OAAA;OAAA;CAAA;OAAA;OAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEP,MAAM,sBAAU;OAAA;CAAA;OAAA;OAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;OAAA;OAAA;CAAA;OAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-env",
-  "version": "0.15.205",
+  "version": "0.16.1",
   "type": "module",
   "description": "A package containing a Powerlines plugin for injecting static .env configuration values to the code so that they're accessible at runtime.",
   "repository": {
@@ -309,7 +309,7 @@
     "@powerlines/plugin-automd": "^0.1.286",
     "@powerlines/plugin-babel": "^0.12.295",
     "@powerlines/plugin-plugin": "^0.12.237",
-    "@storm-software/config-tools": "^1.189.5",
+    "@storm-software/config-tools": "^1.189.6",
     "@stryke/capnp": "^0.12.68",
     "@stryke/env": "^0.20.60",
     "@stryke/fs": "^0.33.43",
@@ -328,5 +328,5 @@
   },
   "publishConfig": { "access": "public" },
   "types": "./dist/index.d.cts",
-  "gitHead": "05b0ca82045a4e7e1c4032aa3cf40295dcb50ae1"
+  "gitHead": "554a70aaf64cca56e3d8c077d50fa6944b3b96d3"
 }