@powerlines/plugin-env 0.13.4 → 0.13.6

package/dist/helpers/source-file-env.js

@@ -0,0 +1,7 @@
+import {a}from'../chunk-UCUR73HG.js';import {ENV_PREFIXES}from'@stryke/env/types';import {camelCase}from'@stryke/string-format/camel-case';import {isString}from'@stryke/type-checks/is-string';/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+function i(r){if(isString(r)){let t=ENV_PREFIXES.reduce((e,n)=>(e.startsWith(n)&&(e=e.slice(n.length)),e),r.toUpperCase());for(;t.startsWith("_");)t=t.slice(1);return t}return Object.keys(r).reduce((t,e)=>{const n=i(e);return n&&(t[n]=r[e]),t},{})}a(i,"removeEnvPrefix");function f(r){return camelCase(i(r))}a(f,"formatEnvField");export{f as formatEnvField,i as removeEnvPrefix};

package/dist/helpers/template-helpers.cjs

@@ -0,0 +1,7 @@
+'use strict';var chunkFBBMZ4NC_cjs=require('../chunk-FBBMZ4NC.cjs'),titleCase=require('@stryke/string-format/title-case'),persistence=require('./persistence');/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+async function P(a,l){const i=await persistence.readEnvTypeReflection(a,l);return i.getProperties().forEach(e=>{e.getAlias().filter(Boolean).forEach(t=>{i.addProperty({name:t,optional:e.isOptional()?true:void 0,readonly:e.isReadonly()?true:void 0,description:e.getDescription(),visibility:e.getVisibility(),type:e.getType(),default:e.getDefaultValue(),tags:{hidden:e.isHidden(),ignore:e.isIgnored(),internal:e.isInternal(),alias:e.getAlias().filter(s=>s!==t).concat(e.name),title:e.getTitle()||titleCase.titleCase(e.name),readonly:e.isReadonly(),permission:e.getPermission(),domain:e.getDomain()}});});}),i}chunkFBBMZ4NC_cjs.a(P,"createTemplateReflection");exports.createTemplateReflection=P;

package/dist/helpers/template-helpers.d.cts

@@ -0,0 +1,40 @@
+import { ReflectionClass } from '@deepkit/type';
+import { EnvPluginContext, EnvType } from '../types/plugin.cjs';
+import '@alloy-js/core/jsx-runtime';
+import '@stryke/capnp';
+import '../runtime-DEhb6gxi.cjs';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jiti';
+import 'oxc-parser';
+import 'semver';
+import 'unplugin';
+import '@babel/core';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'vite';
+import '@babel/helper-plugin-utils';
+import '@stryke/types/array';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import '../vfs-Bl84Hw2V.cjs';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+import '@stryke/env/types';
+
+/**
+ * Creates the reflection data used when generating runtime template files.
+ *
+ * @param context - The context for the configuration plugin.
+ * @param name - The name of the configuration template.
+ * @returns The reflection for the specified configuration template.
+ */
+declare function createTemplateReflection(context: EnvPluginContext, name?: EnvType): Promise<ReflectionClass<any>>;
+
+export { createTemplateReflection };

package/dist/helpers/template-helpers.d.ts

@@ -0,0 +1,40 @@
+import { ReflectionClass } from '@deepkit/type';
+import { EnvPluginContext, EnvType } from '../types/plugin.js';
+import '@alloy-js/core/jsx-runtime';
+import '@stryke/capnp';
+import '../runtime-CUeIsMV9.js';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jiti';
+import 'oxc-parser';
+import 'semver';
+import 'unplugin';
+import '@babel/core';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'vite';
+import '@babel/helper-plugin-utils';
+import '@stryke/types/array';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import '../vfs-Bl84Hw2V.js';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+import '@stryke/env/types';
+
+/**
+ * Creates the reflection data used when generating runtime template files.
+ *
+ * @param context - The context for the configuration plugin.
+ * @param name - The name of the configuration template.
+ * @returns The reflection for the specified configuration template.
+ */
+declare function createTemplateReflection(context: EnvPluginContext, name?: EnvType): Promise<ReflectionClass<any>>;
+
+export { createTemplateReflection };

package/dist/helpers/template-helpers.js

@@ -0,0 +1,7 @@
+import {a}from'../chunk-UCUR73HG.js';import {titleCase}from'@stryke/string-format/title-case';import {readEnvTypeReflection}from'./persistence';/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+async function R(a,l){const i=await readEnvTypeReflection(a,l);return i.getProperties().forEach(e=>{e.getAlias().filter(Boolean).forEach(t=>{i.addProperty({name:t,optional:e.isOptional()?true:void 0,readonly:e.isReadonly()?true:void 0,description:e.getDescription(),visibility:e.getVisibility(),type:e.getType(),default:e.getDefaultValue(),tags:{hidden:e.isHidden(),ignore:e.isIgnored(),internal:e.isInternal(),alias:e.getAlias().filter(s=>s!==t).concat(e.name),title:e.getTitle()||titleCase(e.name),readonly:e.isReadonly(),permission:e.getPermission(),domain:e.getDomain()}});});}),i}a(R,"createTemplateReflection");export{R as createTemplateReflection};

package/dist/index.cjs

@@ -0,0 +1,22 @@
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});require('./chunk-FBBMZ4NC.cjs');var jsxRuntime=require('@alloy-js/core/jsx-runtime'),createPlugin=require('@powerlines/alloy/create-plugin'),type=require('@powerlines/deepkit/vendor/type'),A=require('@powerlines/plugin-babel'),types$1=require('@storm-software/config-tools/types'),parseTypeDefinition=require('@stryke/convert/parse-type-definition'),toArray=require('@stryke/convert/to-array'),types$2=require('@stryke/env/types'),exists=require('@stryke/fs/exists'),helpers$1=require('@stryke/fs/helpers'),isParentPath=require('@stryke/path/is-parent-path'),join=require('@stryke/path/join'),constantCase=require('@stryke/string-format/constant-case'),y=require('defu'),writeFile=require('powerlines/lib/utilities/write-file'),plugin=require('./babel/plugin'),env=require('./components/env'),load=require('./helpers/load'),persistence=require('./helpers/persistence'),reflect=require('./helpers/reflect'),babel=require('./babel'),components=require('./components'),helpers=require('./helpers'),types=require('./types');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var A__default=/*#__PURE__*/_interopDefault(A);var y__default=/*#__PURE__*/_interopDefault(y);/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+const O=createPlugin.createAlloyPlugin(R=>({name:"env",dependsOn:[A__default.default()],async config(){this.log(types$1.LogLevelLabel.TRACE,"Providing default configuration for the Powerlines `env` build plugin.");const e={env:y__default.default(R,{types:{},prefix:[]}),transform:{babel:{plugins:[plugin.envBabelPlugin]}}};if(e.env.types)e.env.types=parseTypeDefinition.parseTypeDefinition(e.env.types);else {this.log(types$1.LogLevelLabel.WARN,"The `env.types` configuration parameter was not provided. Please ensure this is expected.");const t=await persistence.getEnvDefaultTypeDefinition(this);e.env.types=parseTypeDefinition.parseTypeDefinition(`${t.file}#${t.name}`);}if(e.env.secrets)e.env.secrets=parseTypeDefinition.parseTypeDefinition(e.env.secrets);else {const t=await persistence.getSecretsDefaultTypeDefinition(this);e.env.secrets=parseTypeDefinition.parseTypeDefinition(`${t.file}#${t.name}`);}return e.env.prefix=toArray.toArray(e.env.prefix??[]).reduce((t,n)=>{const i=constantCase.constantCase(n);return t.includes(i)||t.push(i),t},[...types$2.ENV_PREFIXES,"POWERLINES_"]),e.env.prefix=e.env.prefix.reduce((t,n)=>(t.includes(n.replace(/_$/g,""))||t.push(n.replace(/_$/g,"")),t),[]),e},async configResolved(){if(this.log(types$1.LogLevelLabel.TRACE,"Environment plugin configuration has been resolved for the Powerlines project."),this.config.env.inject??=this.config.projectType==="application",this.env=y__default.default({parsed:await load.loadEnv(this,this.config.env)},this.env??{},{types:{env:{}},used:{env:{},secrets:{}},parsed:{},injected:{}}),this.config.command!=="prepare"&&this.persistedMeta?.checksum===this.meta.checksum&&exists.existsSync(persistence.getEnvTypeReflectionsPath(this,"env")))this.log(types$1.LogLevelLabel.TRACE,"Skipping reflection initialization as the meta checksum has not changed."),this.env.types.env=await persistence.readEnvTypeReflection(this,"env"),exists.existsSync(persistence.getEnvReflectionsPath(this,"env"))&&(this.env.used.env=await persistence.readEnvReflection(this)),exists.existsSync(persistence.getEnvTypeReflectionsPath(this,"secrets"))&&(this.env.types.secrets=await persistence.readEnvTypeReflection(this,"secrets")),exists.existsSync(persistence.getEnvReflectionsPath(this,"secrets"))&&(this.env.used.secrets=await persistence.readSecretsReflection(this));else {if(this.env.types.env=await reflect.reflectEnv(this,this.config.env.types?.file?isParentPath.isParentPath(this.config.env.types?.file,this.workspaceConfig.workspaceRoot)?this.config.env.types?.file:join.joinPaths(this.config.projectRoot,this.config.env.types?.file):void 0,this.config.env.types?.name),!this.env.types.env)throw new Error("Failed to find the environment configuration type reflection in the context.");if(await persistence.writeEnvTypeReflection(this,this.env.types.env,"env"),this.env.types.secrets=await reflect.reflectSecrets(this,this.config.env.secrets?.file?isParentPath.isParentPath(this.config.env.secrets?.file,this.workspaceConfig.workspaceRoot)?this.config.env.secrets?.file:join.joinPaths(this.config.projectRoot,this.config.env.secrets?.file):void 0,this.config.env.secrets?.name),!this.env.types.secrets)throw new Error("Failed to find the secrets configuration type reflection in the context.");await persistence.writeEnvTypeReflection(this,this.env.types.secrets,"secrets"),this.log(types$1.LogLevelLabel.TRACE,`Resolved ${this.env.types.env.getProperties().length??0} environment configuration parameters and ${this.env.types.secrets?.getProperties().length??0} secret configuration parameters`);const e=this.env.types.env.getProperties().filter(t=>t.getAlias().length>0);Object.entries(await load.loadEnv(this,this.config.env)).forEach(([t,n])=>{const i=this.config.env.prefix.reduce((p,g)=>t.replace(/_$/g,"").startsWith(g)?t.replace(/_$/g,"").slice(g.length):p,t),c=e.find(p=>p?.getAlias().reverse().includes(i));(this.env.types.env?.hasProperty(i)||c)&&this.env.types.env.getProperty(i).setDefaultValue(n);}),this.env.used.env=new type.ReflectionClass({kind:type.ReflectionKind.objectLiteral,typeName:"Env",description:`An object containing the environment configuration parameters used by the ${this.config.name?`${this.config.name} application`:"application"}.`,types:[]},this.env.types.env),await persistence.writeEnvReflection(this,this.env.used.env,"env"),this.env.types.secrets&&(await persistence.writeEnvTypeReflection(this,this.env.types.secrets,"secrets"),this.env.used.secrets=new type.ReflectionClass({kind:type.ReflectionKind.objectLiteral,typeName:"Secrets",description:`An object containing the secret configuration parameters used by the ${this.config.name?`${this.config.name} application`:"application"}.`,types:[]},this.env.types.secrets),await persistence.writeEnvReflection(this,this.env.used.secrets,"secrets"));}},render(){const e=this;return this.log(types$1.LogLevelLabel.TRACE,"Preparing the Environment runtime artifacts for the Powerlines project."),jsxRuntime.createComponent(env.EnvBuiltin,{get defaultConfig(){return e.config.env.defaultConfig}})},async docs(){this.log(types$1.LogLevelLabel.TRACE,"Writing Environment documentation for the Powerlines project artifacts.");const e=join.joinPaths(this.config.projectRoot,"docs","generated");exists.existsSync(e)||await helpers$1.createDirectory(e);const t=await persistence.readEnvTypeReflection(this,"env"),n=join.joinPaths(e,"env.md");this.log(types$1.LogLevelLabel.TRACE,`Documenting environment variables configuration in "${n}"`),await writeFile.writeFile(this.log,n,`<!-- Generated by Powerlines -->
+
+      # Environment variables configuration
+
+      Below is a list of environment variables used by the [${this.packageJson.name}](https://www.npmjs.com/package/${this.packageJson.name}) package. These values can be updated in the \`.env\` file in the root of the project.
+
+      ## Environment Configuration
+
+      The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.
+
+      | Name | Description | Type | Default Value | Required |
+      | ---- | ----------- | ---- | ------------- | :------: |
+      ${t.getProperties().filter(i=>i.getNameAsString()!=="__STORM_INJECTED__").sort((i,c)=>i.getNameAsString().localeCompare(c.getNameAsString())).map(i=>`| ${i.getNameAsString().trim()} | ${(i.getDescription()?.replaceAll("\r","")?.replaceAll(`
+`,"")??"").trim()} | ${type.stringifyType(i.getType()).trim().replaceAll(" | ",", or ")} | ${i.hasDefault()?String(i.getDefaultValue())?.includes('"')?i.getDefaultValue():`\`${i.getDefaultValue()}\``:""} | ${i.isValueRequired()?"":"\u2714"} |`).join(`
+`)}
+      `);},async buildEnd(){const e=persistence.getEnvReflectionsPath(this,"env");this.log(types$1.LogLevelLabel.TRACE,`Writing env reflection types to ${e}.`),await persistence.writeEnvReflection(this,this.env.used.env,"env");}}));var ae=O;exports.default=ae;exports.plugin=O;Object.keys(babel).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return babel[k]}})});Object.keys(components).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return components[k]}})});Object.keys(helpers).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return helpers[k]}})});Object.keys(types).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return types[k]}})});

package/dist/index.d.cts

@@ -0,0 +1,70 @@
+import { P as PluginContext, b as Plugin } from './runtime-DEhb6gxi.cjs';
+export { E as EnvInterface, S as SecretsInterface } from './runtime-DEhb6gxi.cjs';
+import { Children } from '@alloy-js/core/jsx-runtime';
+import { PrintTreeOptions } from '@alloy-js/core';
+import { EnvPluginContext, EnvPluginResolvedConfig } from './types/plugin.cjs';
+export { EnvPluginOptions, EnvPluginUserConfig, EnvType } from './types/plugin.cjs';
+export { envBabelPlugin } from './babel/plugin.cjs';
+export { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition } from './components/env.cjs';
+export { loadEnv, loadEnvFromContext } from './helpers/load.cjs';
+export { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection } from './helpers/persistence.cjs';
+export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets } from './helpers/reflect.cjs';
+export { formatEnvField, removeEnvPrefix } from './helpers/source-file-env.cjs';
+export { createTemplateReflection } from './helpers/template-helpers.cjs';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jiti';
+import 'oxc-parser';
+import 'semver';
+import 'unplugin';
+import '@babel/core';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'vite';
+import '@babel/helper-plugin-utils';
+import '@stryke/types/array';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import './vfs-Bl84Hw2V.cjs';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+import '@deepkit/type';
+import '@stryke/capnp';
+import '@stryke/env/types';
+import '@alloy-js/typescript';
+
+type PluginPluginAlloyOptions = Partial<PrintTreeOptions> & {
+    /**
+     * If true, the Alloy framework is used to generate JSON output files.
+     *
+     * @defaultValue false
+     */
+    generatesJson?: boolean;
+    /**
+     * If true, the Alloy framework is used to generate Markdown output files.
+     *
+     * @defaultValue false
+     */
+    generatesMarkdown?: boolean;
+};
+
+interface AlloyPluginOptions {
+    alloy?: PluginPluginAlloyOptions;
+}
+type AlloyPluginBuilderResult<TContext extends PluginContext = PluginContext> = Plugin<TContext> & {
+    render: (this: TContext) => Children;
+};
+type AlloyPluginBuilder<TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => AlloyPluginBuilderResult<TContext>;
+
+/**
+ * A Powerlines plugin to inject environment variables into the source code.
+ */
+declare const plugin: (options: Parameters<AlloyPluginBuilder<EnvPluginContext<EnvPluginResolvedConfig>>>[0] & AlloyPluginOptions) => Plugin<EnvPluginContext<EnvPluginResolvedConfig>>;
+
+export { EnvPluginContext, EnvPluginResolvedConfig, plugin as default, plugin };

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+import { P as PluginContext, b as Plugin } from './runtime-CUeIsMV9.js';
+export { E as EnvInterface, S as SecretsInterface } from './runtime-CUeIsMV9.js';
+import { Children } from '@alloy-js/core/jsx-runtime';
+import { PrintTreeOptions } from '@alloy-js/core';
+import { EnvPluginContext, EnvPluginResolvedConfig } from './types/plugin.js';
+export { EnvPluginOptions, EnvPluginUserConfig, EnvType } from './types/plugin.js';
+export { envBabelPlugin } from './babel/plugin.js';
+export { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition } from './components/env.js';
+export { loadEnv, loadEnvFromContext } from './helpers/load.js';
+export { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection } from './helpers/persistence.js';
+export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets } from './helpers/reflect.js';
+export { formatEnvField, removeEnvPrefix } from './helpers/source-file-env.js';
+export { createTemplateReflection } from './helpers/template-helpers.js';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jiti';
+import 'oxc-parser';
+import 'semver';
+import 'unplugin';
+import '@babel/core';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'vite';
+import '@babel/helper-plugin-utils';
+import '@stryke/types/array';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import './vfs-Bl84Hw2V.js';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+import '@deepkit/type';
+import '@stryke/capnp';
+import '@stryke/env/types';
+import '@alloy-js/typescript';
+
+type PluginPluginAlloyOptions = Partial<PrintTreeOptions> & {
+    /**
+     * If true, the Alloy framework is used to generate JSON output files.
+     *
+     * @defaultValue false
+     */
+    generatesJson?: boolean;
+    /**
+     * If true, the Alloy framework is used to generate Markdown output files.
+     *
+     * @defaultValue false
+     */
+    generatesMarkdown?: boolean;
+};
+
+interface AlloyPluginOptions {
+    alloy?: PluginPluginAlloyOptions;
+}
+type AlloyPluginBuilderResult<TContext extends PluginContext = PluginContext> = Plugin<TContext> & {
+    render: (this: TContext) => Children;
+};
+type AlloyPluginBuilder<TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => AlloyPluginBuilderResult<TContext>;
+
+/**
+ * A Powerlines plugin to inject environment variables into the source code.
+ */
+declare const plugin: (options: Parameters<AlloyPluginBuilder<EnvPluginContext<EnvPluginResolvedConfig>>>[0] & AlloyPluginOptions) => Plugin<EnvPluginContext<EnvPluginResolvedConfig>>;
+
+export { EnvPluginContext, EnvPluginResolvedConfig, plugin as default, plugin };

package/dist/index.js

@@ -0,0 +1,22 @@
+import'./chunk-UCUR73HG.js';import {createComponent}from'@alloy-js/core/jsx-runtime';import {createAlloyPlugin}from'@powerlines/alloy/create-plugin';import {stringifyType,ReflectionClass,ReflectionKind}from'@powerlines/deepkit/vendor/type';import A from'@powerlines/plugin-babel';import {LogLevelLabel}from'@storm-software/config-tools/types';import {parseTypeDefinition}from'@stryke/convert/parse-type-definition';import {toArray}from'@stryke/convert/to-array';import {ENV_PREFIXES}from'@stryke/env/types';import {existsSync}from'@stryke/fs/exists';import {createDirectory}from'@stryke/fs/helpers';import {isParentPath}from'@stryke/path/is-parent-path';import {joinPaths}from'@stryke/path/join';import {constantCase}from'@stryke/string-format/constant-case';import y from'defu';import {writeFile}from'powerlines/lib/utilities/write-file';import {envBabelPlugin}from'./babel/plugin';import {EnvBuiltin}from'./components/env';import {loadEnv}from'./helpers/load';import {getEnvReflectionsPath,writeEnvReflection,readEnvTypeReflection,getEnvTypeReflectionsPath,readEnvReflection,readSecretsReflection,writeEnvTypeReflection,getEnvDefaultTypeDefinition,getSecretsDefaultTypeDefinition}from'./helpers/persistence';import {reflectEnv,reflectSecrets}from'./helpers/reflect';export*from'./babel';export*from'./components';export*from'./helpers';export*from'./types';/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+const O=createAlloyPlugin(R=>({name:"env",dependsOn:[A()],async config(){this.log(LogLevelLabel.TRACE,"Providing default configuration for the Powerlines `env` build plugin.");const e={env:y(R,{types:{},prefix:[]}),transform:{babel:{plugins:[envBabelPlugin]}}};if(e.env.types)e.env.types=parseTypeDefinition(e.env.types);else {this.log(LogLevelLabel.WARN,"The `env.types` configuration parameter was not provided. Please ensure this is expected.");const t=await getEnvDefaultTypeDefinition(this);e.env.types=parseTypeDefinition(`${t.file}#${t.name}`);}if(e.env.secrets)e.env.secrets=parseTypeDefinition(e.env.secrets);else {const t=await getSecretsDefaultTypeDefinition(this);e.env.secrets=parseTypeDefinition(`${t.file}#${t.name}`);}return e.env.prefix=toArray(e.env.prefix??[]).reduce((t,n)=>{const i=constantCase(n);return t.includes(i)||t.push(i),t},[...ENV_PREFIXES,"POWERLINES_"]),e.env.prefix=e.env.prefix.reduce((t,n)=>(t.includes(n.replace(/_$/g,""))||t.push(n.replace(/_$/g,"")),t),[]),e},async configResolved(){if(this.log(LogLevelLabel.TRACE,"Environment plugin configuration has been resolved for the Powerlines project."),this.config.env.inject??=this.config.projectType==="application",this.env=y({parsed:await loadEnv(this,this.config.env)},this.env??{},{types:{env:{}},used:{env:{},secrets:{}},parsed:{},injected:{}}),this.config.command!=="prepare"&&this.persistedMeta?.checksum===this.meta.checksum&&existsSync(getEnvTypeReflectionsPath(this,"env")))this.log(LogLevelLabel.TRACE,"Skipping reflection initialization as the meta checksum has not changed."),this.env.types.env=await readEnvTypeReflection(this,"env"),existsSync(getEnvReflectionsPath(this,"env"))&&(this.env.used.env=await readEnvReflection(this)),existsSync(getEnvTypeReflectionsPath(this,"secrets"))&&(this.env.types.secrets=await readEnvTypeReflection(this,"secrets")),existsSync(getEnvReflectionsPath(this,"secrets"))&&(this.env.used.secrets=await readSecretsReflection(this));else {if(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)throw new Error("Failed to find the environment configuration type reflection in the context.");if(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)throw new Error("Failed to find the secrets configuration type reflection in the context.");await writeEnvTypeReflection(this,this.env.types.secrets,"secrets"),this.log(LogLevelLabel.TRACE,`Resolved ${this.env.types.env.getProperties().length??0} environment configuration parameters and ${this.env.types.secrets?.getProperties().length??0} secret configuration parameters`);const e=this.env.types.env.getProperties().filter(t=>t.getAlias().length>0);Object.entries(await loadEnv(this,this.config.env)).forEach(([t,n])=>{const i=this.config.env.prefix.reduce((p,g)=>t.replace(/_$/g,"").startsWith(g)?t.replace(/_$/g,"").slice(g.length):p,t),c=e.find(p=>p?.getAlias().reverse().includes(i));(this.env.types.env?.hasProperty(i)||c)&&this.env.types.env.getProperty(i).setDefaultValue(n);}),this.env.used.env=new ReflectionClass({kind:ReflectionKind.objectLiteral,typeName:"Env",description:`An object containing the environment configuration parameters used by the ${this.config.name?`${this.config.name} application`:"application"}.`,types:[]},this.env.types.env),await writeEnvReflection(this,this.env.used.env,"env"),this.env.types.secrets&&(await writeEnvTypeReflection(this,this.env.types.secrets,"secrets"),this.env.used.secrets=new ReflectionClass({kind:ReflectionKind.objectLiteral,typeName:"Secrets",description:`An object containing the secret configuration parameters used by the ${this.config.name?`${this.config.name} application`:"application"}.`,types:[]},this.env.types.secrets),await writeEnvReflection(this,this.env.used.secrets,"secrets"));}},render(){const e=this;return this.log(LogLevelLabel.TRACE,"Preparing the Environment runtime artifacts for the Powerlines project."),createComponent(EnvBuiltin,{get defaultConfig(){return e.config.env.defaultConfig}})},async docs(){this.log(LogLevelLabel.TRACE,"Writing Environment documentation for the Powerlines project artifacts.");const e=joinPaths(this.config.projectRoot,"docs","generated");existsSync(e)||await createDirectory(e);const t=await readEnvTypeReflection(this,"env"),n=joinPaths(e,"env.md");this.log(LogLevelLabel.TRACE,`Documenting environment variables configuration in "${n}"`),await writeFile(this.log,n,`<!-- Generated by Powerlines -->
+
+      # Environment variables configuration
+
+      Below is a list of environment variables used by the [${this.packageJson.name}](https://www.npmjs.com/package/${this.packageJson.name}) package. These values can be updated in the \`.env\` file in the root of the project.
+
+      ## Environment Configuration
+
+      The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.
+
+      | Name | Description | Type | Default Value | Required |
+      | ---- | ----------- | ---- | ------------- | :------: |
+      ${t.getProperties().filter(i=>i.getNameAsString()!=="__STORM_INJECTED__").sort((i,c)=>i.getNameAsString().localeCompare(c.getNameAsString())).map(i=>`| ${i.getNameAsString().trim()} | ${(i.getDescription()?.replaceAll("\r","")?.replaceAll(`
+`,"")??"").trim()} | ${stringifyType(i.getType()).trim().replaceAll(" | ",", or ")} | ${i.hasDefault()?String(i.getDefaultValue())?.includes('"')?i.getDefaultValue():`\`${i.getDefaultValue()}\``:""} | ${i.isValueRequired()?"":"\u2714"} |`).join(`
+`)}
+      `);},async buildEnd(){const e=getEnvReflectionsPath(this,"env");this.log(LogLevelLabel.TRACE,`Writing env reflection types to ${e}.`),await writeEnvReflection(this,this.env.used.env,"env");}}));var ce=O;export{ce as default,O as plugin};