@powerlines/plugin-env 0.16.56 → 0.16.58

package/dist/helpers/load.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.mjs","names":[],"sources":["../../src/helpers/load.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 {\n  loadEnv as loadEnvBase,\n  loadEnvFile as loadEnvFileBase\n} from \"@stryke/env/load-env\";\nimport type { DotenvParseOutput } from \"@stryke/env/types\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type { PackageJson } from \"@stryke/types/package-json\";\nimport { loadConfig } from \"c12\";\nimport defu from \"defu\";\nimport { WorkspaceConfig } from \"powerlines\";\nimport { DEFAULT_ENVIRONMENT } from \"powerlines/utils\";\nimport { EnvPluginContext, EnvPluginOptions } from \"../types/plugin\";\nimport { removeEnvPrefix } from \"./source-file-env\";\n\nasync function loadEnvFiles<TEnv extends DotenvParseOutput = DotenvParseOutput>(\n  options: EnvPluginOptions,\n  mode: string,\n  cwd: string\n): Promise<TEnv> {\n  let env = await loadEnvBase(cwd, mode);\n  if (options.additionalFiles && options.additionalFiles?.length > 0) {\n    const additionalEnvFiles = await Promise.all(\n      options.additionalFiles.map(async additionalEnvFile =>\n        loadEnvFileBase(additionalEnvFile, cwd)\n      )\n    );\n\n    for (const additionalEnvFile of additionalEnvFiles) {\n      env = defu(additionalEnvFile, env);\n    }\n  }\n\n  return removeEnvPrefix(env) as TEnv;\n}\n\nasync function loadEnvDirectory<\n  TEnv extends DotenvParseOutput = DotenvParseOutput\n>(\n  options: EnvPluginOptions,\n  directory: string,\n  mode: string,\n  cacheDir: string,\n  packageJson: PackageJson,\n  workspaceConfig: WorkspaceConfig\n): Promise<TEnv> {\n  const [envResult, c12Result] = await Promise.all([\n    loadEnvFiles<TEnv>(options, mode, directory),\n    loadConfig({\n      cwd: directory,\n      name: \"storm\",\n      envName: mode,\n      defaults: {\n        NAME: packageJson.name?.replace(`@${workspaceConfig.namespace}/`, \"\"),\n        MODE: mode,\n        ORG: workspaceConfig.organization\n      },\n      globalRc: true,\n      packageJson: true,\n      dotenv: true,\n      jitiOptions: {\n        fsCache: joinPaths(cacheDir, \"jiti\"),\n        moduleCache: true\n      }\n    })\n  ]);\n\n  return defu(envResult as any, c12Result.config, workspaceConfig) as TEnv;\n}\n\n/**\n * Retrieves various dotenv configuration parameters from the context.\n *\n * @param context - The context to retrieve the dotenv configuration from.\n * @param parsed - The parsed dotenv configuration.\n * @returns An object containing the dotenv configuration.\n */\nexport function loadEnvFromContext(\n  context: EnvPluginContext,\n  parsed: DotenvParseOutput\n) {\n  return defu(\n    {\n      APP_NAME: kebabCase(\n        context.config.name ||\n          context.packageJson.name?.replace(\n            `/${context.workspaceConfig.namespace}`,\n            \"\"\n          )\n      ),\n      APP_VERSION: context.packageJson.version,\n      BUILD_ID: context.meta.buildId,\n      BUILD_TIMESTAMP: new Date(context.meta.timestamp).toISOString(),\n      BUILD_CHECKSUM: context.meta.checksum,\n      RELEASE_ID: context.meta.releaseId,\n      RELEASE_TAG: `${kebabCase(context.config.name)}@${context.packageJson.version}`,\n      DEFAULT_LOCALE: context.workspaceConfig.locale,\n      DEFAULT_TIMEZONE: context.workspaceConfig.timezone,\n      LOG_LEVEL:\n        context.config.logLevel === \"trace\" ? \"debug\" : context.config.logLevel,\n      ERROR_URL: context.workspaceConfig.error?.url,\n      ORGANIZATION:\n        context.config.organization ||\n        (isSetObject(context.workspaceConfig.organization)\n          ? context.workspaceConfig.organization.name\n          : context.workspaceConfig.organization),\n      PLATFORM: context.config.platform,\n      MODE: context.config.mode,\n      TEST: context.config.mode === \"test\",\n      DEBUG: context.config.mode === \"development\",\n      STACKTRACE: context.config.mode !== \"production\",\n      ENVIRONMENT:\n        !context.environment.name ||\n        context.environment.name === DEFAULT_ENVIRONMENT\n          ? context.config.mode\n          : context.environment.name\n    },\n    isSetObject(context?.env?.types?.env)\n      ? context.env.types.env?.getProperties().reduce(\n          (ret, prop) => {\n            ret[prop.name] = parsed[prop.name] ?? prop.getDefaultValue();\n            return ret;\n          },\n          {} as Record<string, any>\n        )\n      : {}\n  );\n}\n\nexport async function loadEnv<\n  TEnv extends DotenvParseOutput = DotenvParseOutput\n>(context: EnvPluginContext, options: EnvPluginOptions): Promise<TEnv> {\n  const [project, workspace, config] = await Promise.all([\n    loadEnvDirectory<TEnv>(\n      options,\n      context.config.root,\n      context.config.mode,\n      context.cachePath,\n      context.packageJson,\n      context.workspaceConfig\n    ),\n    loadEnvDirectory<TEnv>(\n      options,\n      context.workspaceConfig.workspaceRoot,\n      context.config.mode,\n      context.cachePath,\n      context.packageJson,\n      context.workspaceConfig\n    ),\n    loadEnvDirectory<TEnv>(\n      options,\n      context.envPaths.config,\n      context.config.mode,\n      context.cachePath,\n      context.packageJson,\n      context.workspaceConfig\n    )\n  ]);\n\n  return defu(\n    loadEnvFromContext(context, process.env),\n    project,\n    workspace,\n    config\n  ) as TEnv;\n}\n"],"mappings":"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"}

package/dist/helpers/persistence.d.cts

@@ -0,0 +1,85 @@
+import { EnvPluginContext, EnvPluginResolvedConfig, EnvType } from "../types/plugin.cjs";
+import { Context, UnresolvedContext } from "powerlines";
+import { TypeDefinition } from "@stryke/types/configuration";
+import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
+
+//#region src/helpers/persistence.d.ts
+
+/**
+ * Resolves the runtime type definition file for the environment variables.
+ *
+ * @param context - The plugin context.
+ * @returns The runtime type definition file for the environment variables.
+ */
+declare function resolveRuntimeTypeFile(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<string>;
+/**
+ * Gets the default type definition for the environment variables.
+ *
+ * @param context - The plugin context.
+ * @returns The default type definition for the environment variables.
+ */
+declare function getEnvDefaultTypeDefinition(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<TypeDefinition>;
+/** Gets the default type definition for the environment secrets.
+ *
+ * @param context - The plugin context.
+ * @returns The default type definition for the environment secrets.
+ */
+declare function getSecretsDefaultTypeDefinition(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<TypeDefinition>;
+/**
+ * Gets the path to the environment type reflections.
+ *
+ * @param context - The plugin context.
+ * @param name - The name of the type reflections.
+ * @returns The path to the environment type reflections.
+ */
+declare function getEnvTypeReflectionsPath(context: Context<EnvPluginResolvedConfig>, name?: EnvType): string;
+/**
+ * Reads the environment type reflection from the file system.
+ *
+ * @param context - The plugin context.
+ * @param name - The name of the type reflections.
+ * @returns The environment type reflection.
+ */
+declare function readEnvTypeReflection(context: EnvPluginContext, name?: EnvType): Promise<ReflectionClass<any>>;
+/**
+ * Writes the environment type reflection to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The environment type reflection to write.
+ * @param name - The name of the type reflections.
+ */
+declare function writeEnvTypeReflection(context: EnvPluginContext, reflection: ReflectionClass<any>, name?: EnvType): Promise<void>;
+declare function getEnvReflectionsPath(context: EnvPluginContext, name: EnvType): string;
+/**
+ * Reads the environment reflection data from the file system.
+ *
+ * @param context - The plugin context.
+ * @returns The environment reflection data.
+ */
+declare function readEnvReflection(context: EnvPluginContext): Promise<ReflectionClass<any>>;
+/**
+ * Reads the secret environment reflection data from the file system.
+ *
+ * @param context - The plugin context.
+ * @returns The environment reflection data.
+ */
+declare function readSecretsReflection(context: EnvPluginContext): Promise<ReflectionClass<any>>;
+/**
+ * Writes the environment reflection data to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The reflection data to write.
+ * @param name - The name of the reflection (either "env" or "secrets").
+ */
+declare function writeEnvReflection(context: EnvPluginContext, reflection: ReflectionClass<any>, name?: EnvType): Promise<void>;
+/**
+ * Writes the environment reflection data to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The reflection data to write.
+ * @param name - The name of the reflection (either "env" or "secrets").
+ */
+declare function writeEnvReflectionSync(context: EnvPluginContext, reflection: ReflectionClass<any>, name?: EnvType): void;
+//#endregion
+export { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };
+//# sourceMappingURL=persistence.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.cts","names":[],"sources":["../../src/helpers/persistence.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAoDA;;;;AAEU,iBAFY,sBAAA,CAEZ,OAAA,EADC,iBACD,CADmB,uBACnB,CAAA,CAAA,EAAP,OAAO,CAAA,MAAA,CAAA;AAmBV;;;;;;AAcsB,iBAdA,2BAAA,CAc+B,OAAA,EAb1C,iBAa0C,CAbxB,uBAawB,CAAA,CAAA,EAZlD,OAYkD,CAZ1C,cAY0C,CAAA;;;;;;AAgBrC,iBAhBM,+BAAA,CAgBmB,OAAA,EAf9B,iBAe8B,CAfZ,uBAeY,CAAA,CAAA,EAdtC,OAcsC,CAd9B,cAc8B,CAAA;;;;;AAczC;;;AAGW,iBAjBK,yBAAA,CAiBL,OAAA,EAhBA,OAgBA,CAhBQ,uBAgBR,CAAA,EAAA,IAAA,CAAA,EAfH,OAeG,CAAA,EAAA,MAAA;;;AAuCX;;;;;AAGuB,iBA7CD,qBAAA,CA6CC,OAAA,EA5CZ,gBA4CY,EAAA,IAAA,CAAA,EA3Cf,OA2Ce,CAAA,EA1CpB,OA0CoB,CA1CZ,eA0CY,CAAA,GAAA,CAAA,CAAA;AAevB;AAaA;;;;;AAyDA;AACW,iBAzFW,sBAAA,CAyFX,OAAA,EAxFA,gBAwFA,EAAA,UAAA,EAvFG,eAuFH,CAAA,GAAA,CAAA,EAAA,IAAA,CAAA,EAtFH,OAsFG,CAAA,EAtFY,OAsFZ,CAAA,IAAA,CAAA;AACA,iBAxEK,qBAAA,CAwEL,OAAA,EAvEA,gBAuEA,EAAA,IAAA,EAtEH,OAsEG,CAAA,EAAA,MAAA;;;AA2DX;;;;AAGuB,iBAzHD,iBAAA,CAyHC,OAAA,EAxHZ,gBAwHY,CAAA,EAvHpB,OAuHoB,CAvHZ,eAuHY,CAAA,GAAA,CAAA,CAAA;;AAsBvB;;;;;iBAtFsB,qBAAA,UACX,mBACR,QAAQ;;;;;;;;iBA2DW,kBAAA,UACX,8BACG,6BACN,UAAe;;;;;;;;iBAsBP,sBAAA,UACL,8BACG,6BACN"}

package/dist/helpers/persistence.d.mts

@@ -0,0 +1,85 @@
+import { EnvPluginContext, EnvPluginResolvedConfig, EnvType } from "../types/plugin.mjs";
+import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
+import { Context, UnresolvedContext } from "powerlines";
+import { TypeDefinition } from "@stryke/types/configuration";
+
+//#region src/helpers/persistence.d.ts
+
+/**
+ * Resolves the runtime type definition file for the environment variables.
+ *
+ * @param context - The plugin context.
+ * @returns The runtime type definition file for the environment variables.
+ */
+declare function resolveRuntimeTypeFile(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<string>;
+/**
+ * Gets the default type definition for the environment variables.
+ *
+ * @param context - The plugin context.
+ * @returns The default type definition for the environment variables.
+ */
+declare function getEnvDefaultTypeDefinition(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<TypeDefinition>;
+/** Gets the default type definition for the environment secrets.
+ *
+ * @param context - The plugin context.
+ * @returns The default type definition for the environment secrets.
+ */
+declare function getSecretsDefaultTypeDefinition(context: UnresolvedContext<EnvPluginResolvedConfig>): Promise<TypeDefinition>;
+/**
+ * Gets the path to the environment type reflections.
+ *
+ * @param context - The plugin context.
+ * @param name - The name of the type reflections.
+ * @returns The path to the environment type reflections.
+ */
+declare function getEnvTypeReflectionsPath(context: Context<EnvPluginResolvedConfig>, name?: EnvType): string;
+/**
+ * Reads the environment type reflection from the file system.
+ *
+ * @param context - The plugin context.
+ * @param name - The name of the type reflections.
+ * @returns The environment type reflection.
+ */
+declare function readEnvTypeReflection(context: EnvPluginContext, name?: EnvType): Promise<ReflectionClass<any>>;
+/**
+ * Writes the environment type reflection to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The environment type reflection to write.
+ * @param name - The name of the type reflections.
+ */
+declare function writeEnvTypeReflection(context: EnvPluginContext, reflection: ReflectionClass<any>, name?: EnvType): Promise<void>;
+declare function getEnvReflectionsPath(context: EnvPluginContext, name: EnvType): string;
+/**
+ * Reads the environment reflection data from the file system.
+ *
+ * @param context - The plugin context.
+ * @returns The environment reflection data.
+ */
+declare function readEnvReflection(context: EnvPluginContext): Promise<ReflectionClass<any>>;
+/**
+ * Reads the secret environment reflection data from the file system.
+ *
+ * @param context - The plugin context.
+ * @returns The environment reflection data.
+ */
+declare function readSecretsReflection(context: EnvPluginContext): Promise<ReflectionClass<any>>;
+/**
+ * Writes the environment reflection data to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The reflection data to write.
+ * @param name - The name of the reflection (either "env" or "secrets").
+ */
+declare function writeEnvReflection(context: EnvPluginContext, reflection: ReflectionClass<any>, name?: EnvType): Promise<void>;
+/**
+ * Writes the environment reflection data to the file system.
+ *
+ * @param context - The plugin context.
+ * @param reflection - The reflection data to write.
+ * @param name - The name of the reflection (either "env" or "secrets").
+ */
+declare function writeEnvReflectionSync(context: EnvPluginContext, reflection: ReflectionClass<any>, name?: EnvType): void;
+//#endregion
+export { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };
+//# sourceMappingURL=persistence.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.mts","names":[],"sources":["../../src/helpers/persistence.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAoDA;;;;AAEU,iBAFY,sBAAA,CAEZ,OAAA,EADC,iBACD,CADmB,uBACnB,CAAA,CAAA,EAAP,OAAO,CAAA,MAAA,CAAA;AAmBV;;;;;;AAcsB,iBAdA,2BAAA,CAc+B,OAAA,EAb1C,iBAa0C,CAbxB,uBAawB,CAAA,CAAA,EAZlD,OAYkD,CAZ1C,cAY0C,CAAA;;;;;;AAgBrC,iBAhBM,+BAAA,CAgBmB,OAAA,EAf9B,iBAe8B,CAfZ,uBAeY,CAAA,CAAA,EAdtC,OAcsC,CAd9B,cAc8B,CAAA;;;;;AAczC;;;AAGW,iBAjBK,yBAAA,CAiBL,OAAA,EAhBA,OAgBA,CAhBQ,uBAgBR,CAAA,EAAA,IAAA,CAAA,EAfH,OAeG,CAAA,EAAA,MAAA;;;AAuCX;;;;;AAGuB,iBA7CD,qBAAA,CA6CC,OAAA,EA5CZ,gBA4CY,EAAA,IAAA,CAAA,EA3Cf,OA2Ce,CAAA,EA1CpB,OA0CoB,CA1CZ,eA0CY,CAAA,GAAA,CAAA,CAAA;AAevB;AAaA;;;;;AAyDA;AACW,iBAzFW,sBAAA,CAyFX,OAAA,EAxFA,gBAwFA,EAAA,UAAA,EAvFG,eAuFH,CAAA,GAAA,CAAA,EAAA,IAAA,CAAA,EAtFH,OAsFG,CAAA,EAtFY,OAsFZ,CAAA,IAAA,CAAA;AACA,iBAxEK,qBAAA,CAwEL,OAAA,EAvEA,gBAuEA,EAAA,IAAA,EAtEH,OAsEG,CAAA,EAAA,MAAA;;;AA2DX;;;;AAGuB,iBAzHD,iBAAA,CAyHC,OAAA,EAxHZ,gBAwHY,CAAA,EAvHpB,OAuHoB,CAvHZ,eAuHY,CAAA,GAAA,CAAA,CAAA;;AAsBvB;;;;;iBAtFsB,qBAAA,UACX,mBACR,QAAQ;;;;;;;;iBA2DW,kBAAA,UACX,8BACG,6BACN,UAAe;;;;;;;;iBAsBP,sBAAA,UACL,8BACG,6BACN"}

package/dist/helpers/persistence.mjs

@@ -307,4 +307,5 @@ writeEnvReflectionSync.__type = [
 ];
 
 //#endregion
-export { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };
+export { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };
+//# sourceMappingURL=persistence.mjs.map

package/dist/helpers/persistence.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.mjs","names":[],"sources":["../../src/helpers/persistence.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 { convertFromCapnp, convertToCapnp } from \"@powerlines/deepkit/capnp\";\nimport { getReflectionsPath } from \"@powerlines/deepkit/resolve-reflections\";\nimport { SerializedTypes } from \"@powerlines/deepkit/schemas/reflection\";\nimport { Reflection } from \"@powerlines/deepkit/types\";\nimport {\n  deserializeType,\n  ReflectionClass,\n  ReflectionKind,\n  resolveClassType\n} from \"@powerlines/deepkit/vendor/type\";\nimport * as capnp from \"@stryke/capnp\";\nimport {\n  readFileBuffer,\n  writeFileBuffer,\n  writeFileBufferSync\n} from \"@stryke/fs/buffer\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { isEmptyObject } from \"@stryke/type-checks/is-empty-object\";\nimport type { TypeDefinition } from \"@stryke/types/configuration\";\nimport { existsSync } from \"node:fs\";\nimport { Context, UnresolvedContext } from \"powerlines\";\nimport {\n  EnvPluginContext,\n  EnvPluginResolvedConfig,\n  EnvType\n} from \"../types/plugin\";\nimport { createEnvReflection } from \"./reflect\";\n\n/**\n * Resolves the runtime type definition file for the environment variables.\n *\n * @param context - The plugin context.\n * @returns The runtime type definition file for the environment variables.\n */\nexport async function resolveRuntimeTypeFile(\n  context: UnresolvedContext<EnvPluginResolvedConfig>\n): Promise<string> {\n  const resolved = await context.fs.resolve(\n    \"@powerlines/plugin-env/types/runtime\"\n  );\n  if (!resolved) {\n    throw new Error(\n      `Failed to resolve the runtime type definition file for the environment variables. Please ensure that the \"@powerlines/plugin-env\" package is installed.`\n    );\n  }\n\n  return resolved;\n}\n\n/**\n * Gets the default type definition for the environment variables.\n *\n * @param context - The plugin context.\n * @returns The default type definition for the environment variables.\n */\nexport async function getEnvDefaultTypeDefinition(\n  context: UnresolvedContext<EnvPluginResolvedConfig>\n): Promise<TypeDefinition> {\n  return {\n    file: await resolveRuntimeTypeFile(context),\n    name: \"EnvInterface\"\n  };\n}\n\n/** Gets the default type definition for the environment secrets.\n *\n * @param context - The plugin context.\n * @returns The default type definition for the environment secrets.\n */\nexport async function getSecretsDefaultTypeDefinition(\n  context: UnresolvedContext<EnvPluginResolvedConfig>\n): Promise<TypeDefinition> {\n  return {\n    file: await resolveRuntimeTypeFile(context),\n    name: \"SecretsInterface\"\n  };\n}\n\n/**\n * Gets the path to the environment type reflections.\n *\n * @param context - The plugin context.\n * @param name - The name of the type reflections.\n * @returns The path to the environment type reflections.\n */\nexport function getEnvTypeReflectionsPath(\n  context: Context<EnvPluginResolvedConfig>,\n  name: EnvType = \"env\"\n): string {\n  return joinPaths(getReflectionsPath(context), \"env\", `${name}-types.bin`);\n}\n\n/**\n * Reads the environment type reflection from the file system.\n *\n * @param context - The plugin context.\n * @param name - The name of the type reflections.\n * @returns The environment type reflection.\n */\nexport async function readEnvTypeReflection(\n  context: EnvPluginContext,\n  name: EnvType = \"env\"\n): Promise<ReflectionClass<any>> {\n  const filePath = getEnvTypeReflectionsPath(context, name);\n  if (!existsSync(filePath)) {\n    if (!context.env.types.env || isEmptyObject(context.env.types.env)) {\n      const reflection = createEnvReflection(context) as Reflection;\n\n      const message = new capnp.Message();\n      reflection.messageRoot = message.initRoot(SerializedTypes);\n      reflection.dataBuffer = message.toArrayBuffer();\n\n      context.env.types.env = reflection;\n      await writeEnvTypeReflection(context, context.env.types.env, name);\n    }\n\n    return context.env.types.env;\n  }\n\n  const buffer = await readFileBuffer(filePath);\n  const message = new capnp.Message(buffer, false);\n  const messageRoot = message.getRoot(SerializedTypes);\n\n  const reflection = resolveClassType(\n    deserializeType(convertFromCapnp(messageRoot.types))\n  );\n\n  context.env.types[name] = reflection;\n  context.env.types[name].messageRoot = messageRoot;\n  context.env.types[name].dataBuffer = buffer;\n\n  return reflection;\n}\n\n/**\n * Writes the environment type reflection to the file system.\n *\n * @param context - The plugin context.\n * @param reflection - The environment type reflection to write.\n * @param name - The name of the type reflections.\n */\nexport async function writeEnvTypeReflection(\n  context: EnvPluginContext,\n  reflection: ReflectionClass<any>,\n  name: EnvType = \"env\"\n) {\n  const serialized = reflection.serializeType();\n\n  const message = new capnp.Message();\n  const root = message.initRoot(SerializedTypes);\n\n  convertToCapnp(serialized, root._initTypes(serialized.length));\n\n  await writeFileBuffer(\n    getEnvTypeReflectionsPath(context, name),\n    message.toArrayBuffer()\n  );\n}\n\nexport function getEnvReflectionsPath(\n  context: EnvPluginContext,\n  name: EnvType\n): string {\n  return joinPaths(getReflectionsPath(context), \"env\", `${name}.bin`);\n}\n\n/**\n * Reads the environment reflection data from the file system.\n *\n * @param context - The plugin context.\n * @returns The environment reflection data.\n */\nexport async function readEnvReflection(\n  context: EnvPluginContext\n): Promise<ReflectionClass<any>> {\n  const filePath = getEnvReflectionsPath(context, \"env\");\n  if (!existsSync(filePath)) {\n    if (!context.env.types.env) {\n      context.env.types.env = await readEnvTypeReflection(context, \"env\");\n    }\n\n    if (!context.env.used.env || isEmptyObject(context.env.used.env)) {\n      const reflection = createEnvReflection(context, {\n        type: {\n          kind: ReflectionKind.objectLiteral,\n          typeName: \"Env\",\n          description: `An object containing the environment configuration parameters that are used (at least once) by the ${\n            context.config.name\n              ? `${context.config.name} application`\n              : \"application\"\n          }.`,\n          types: []\n        },\n        superReflection: context.env.types.env\n      }) as Reflection;\n      reflection.name = \"Env\";\n\n      const message = new capnp.Message();\n      reflection.messageRoot = message.initRoot(SerializedTypes);\n      reflection.dataBuffer = message.toArrayBuffer();\n\n      context.env.used.env = reflection;\n      await writeEnvReflection(context, context.env.used.env, \"env\");\n    }\n\n    return context.env.used.env;\n  }\n\n  const buffer = await readFileBuffer(filePath);\n  const message = new capnp.Message(buffer, false);\n  const messageRoot = message.getRoot(SerializedTypes);\n\n  const reflection = resolveClassType(\n    deserializeType(convertFromCapnp(messageRoot.types))\n  );\n\n  context.env.used.env = reflection;\n  context.env.used.env.messageRoot = messageRoot;\n  context.env.used.env.dataBuffer = buffer;\n\n  return reflection;\n}\n\n/**\n * Reads the secret environment reflection data from the file system.\n *\n * @param context - The plugin context.\n * @returns The environment reflection data.\n */\nexport async function readSecretsReflection(\n  context: EnvPluginContext\n): Promise<ReflectionClass<any>> {\n  const filePath = getEnvReflectionsPath(context, \"secrets\");\n  if (!existsSync(filePath)) {\n    if (!context.env.types.secrets) {\n      context.env.types.secrets = await readEnvTypeReflection(\n        context,\n        \"secrets\"\n      );\n    }\n\n    if (!context.env.used.secrets || isEmptyObject(context.env.used.secrets)) {\n      const reflection = createEnvReflection(context, {\n        type: {\n          kind: ReflectionKind.objectLiteral,\n          typeName: \"Secrets\",\n          description: `An object containing the secret configuration parameters that are used (at least once) by the ${\n            context.config.name\n              ? `${context.config.name} application`\n              : \"application\"\n          }.`,\n          types: []\n        },\n        superReflection: context.env.types.secrets\n      }) as Reflection;\n      reflection.name = \"Secrets\";\n\n      const message = new capnp.Message();\n      reflection.messageRoot = message.initRoot(SerializedTypes);\n      reflection.dataBuffer = message.toArrayBuffer();\n\n      context.env.used.secrets = reflection;\n      await writeEnvReflection(context, context.env.used.secrets, \"secrets\");\n    }\n\n    return context.env.used.secrets;\n  }\n\n  const buffer = await readFileBuffer(filePath);\n  const message = new capnp.Message(buffer, false);\n  const messageRoot = message.getRoot(SerializedTypes);\n\n  const reflection = resolveClassType(\n    deserializeType(convertFromCapnp(messageRoot.types))\n  );\n\n  context.env.used.secrets = reflection;\n  context.env.used.secrets.messageRoot = messageRoot;\n  context.env.used.secrets.dataBuffer = buffer;\n\n  return reflection;\n}\n\n/**\n * Writes the environment reflection data to the file system.\n *\n * @param context - The plugin context.\n * @param reflection - The reflection data to write.\n * @param name - The name of the reflection (either \"env\" or \"secrets\").\n */\nexport async function writeEnvReflection(\n  context: EnvPluginContext,\n  reflection: ReflectionClass<any>,\n  name: EnvType = \"env\"\n) {\n  const serialized = reflection.serializeType();\n\n  const message = new capnp.Message();\n  const root = message.initRoot(SerializedTypes);\n\n  convertToCapnp(serialized, root._initTypes(serialized.length));\n\n  await writeFileBuffer(\n    getEnvReflectionsPath(context, name),\n    message.toArrayBuffer()\n  );\n}\n\n/**\n * Writes the environment reflection data to the file system.\n *\n * @param context - The plugin context.\n * @param reflection - The reflection data to write.\n * @param name - The name of the reflection (either \"env\" or \"secrets\").\n */\nexport function writeEnvReflectionSync(\n  context: EnvPluginContext,\n  reflection: ReflectionClass<any>,\n  name: EnvType = \"env\"\n) {\n  const serialized = reflection.serializeType();\n\n  const message = new capnp.Message();\n  const root = message.initRoot(SerializedTypes);\n\n  convertToCapnp(serialized, root._initTypes(serialized.length));\n\n  writeFileBufferSync(\n    getEnvReflectionsPath(context, name),\n    message.toArrayBuffer()\n  );\n}\n"],"mappings":"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"}

package/dist/helpers/reflect.d.cts

@@ -0,0 +1,69 @@
+import { EnvInterface, SecretsInterface } from "../types/runtime.cjs";
+import { EnvPluginContext } from "../types/plugin.cjs";
+import { ReflectionClass, TypeClass, TypeObjectLiteral } from "@powerlines/deepkit/vendor/type";
+
+//#region src/helpers/reflect.d.ts
+declare function mergeEnvReflections(context: EnvPluginContext, reflections: ReflectionClass<any>[]): ReflectionClass<any>;
+declare function mergeSecretsReflections(context: EnvPluginContext, reflections: ReflectionClass<any>[]): ReflectionClass<any>;
+interface CreateEnvReflectionOptions {
+  type?: TypeObjectLiteral | TypeClass;
+  superReflection?: ReflectionClass<any>;
+}
+declare class BaseEnv implements EnvInterface {
+  APP_NAME: string;
+  APP_VERSION: string;
+  BUILD_ID: string;
+  BUILD_TIMESTAMP: string;
+  BUILD_CHECKSUM: string;
+  RELEASE_ID: string;
+  RELEASE_TAG: string;
+  ORGANIZATION: string;
+  PLATFORM: "node" | "browser" | "neutral";
+  MODE: "development" | "test" | "production";
+  ENVIRONMENT: string;
+  DEBUG: boolean;
+  TEST: boolean;
+  MINIMAL: boolean;
+  NO_COLOR: boolean;
+  FORCE_COLOR: number | boolean;
+  FORCE_HYPERLINK: number | boolean;
+  STACKTRACE: boolean;
+  INCLUDE_ERROR_DATA: boolean;
+  ERROR_URL: string;
+  DEFAULT_TIMEZONE: string;
+  DEFAULT_LOCALE: string;
+  CI: boolean;
+}
+declare class BaseSecrets implements SecretsInterface {
+  ENCRYPTION_KEY: string;
+}
+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
+export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, __ΩCreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets };
+//# sourceMappingURL=reflect.d.cts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,69 @@
+import { EnvInterface, SecretsInterface } from "../types/runtime.mjs";
+import { EnvPluginContext } from "../types/plugin.mjs";
+import { ReflectionClass, TypeClass, TypeObjectLiteral } from "@powerlines/deepkit/vendor/type";
+
+//#region src/helpers/reflect.d.ts
+declare function mergeEnvReflections(context: EnvPluginContext, reflections: ReflectionClass<any>[]): ReflectionClass<any>;
+declare function mergeSecretsReflections(context: EnvPluginContext, reflections: ReflectionClass<any>[]): ReflectionClass<any>;
+interface CreateEnvReflectionOptions {
+  type?: TypeObjectLiteral | TypeClass;
+  superReflection?: ReflectionClass<any>;
+}
+declare class BaseEnv implements EnvInterface {
+  APP_NAME: string;
+  APP_VERSION: string;
+  BUILD_ID: string;
+  BUILD_TIMESTAMP: string;
+  BUILD_CHECKSUM: string;
+  RELEASE_ID: string;
+  RELEASE_TAG: string;
+  ORGANIZATION: string;
+  PLATFORM: "node" | "browser" | "neutral";
+  MODE: "development" | "test" | "production";
+  ENVIRONMENT: string;
+  DEBUG: boolean;
+  TEST: boolean;
+  MINIMAL: boolean;
+  NO_COLOR: boolean;
+  FORCE_COLOR: number | boolean;
+  FORCE_HYPERLINK: number | boolean;
+  STACKTRACE: boolean;
+  INCLUDE_ERROR_DATA: boolean;
+  ERROR_URL: string;
+  DEFAULT_TIMEZONE: string;
+  DEFAULT_LOCALE: string;
+  CI: boolean;
+}
+declare class BaseSecrets implements SecretsInterface {
+  ENCRYPTION_KEY: string;
+}
+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
+export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, __ΩCreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets };
+//# sourceMappingURL=reflect.d.mts.map

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

@@ -0,0 +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;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

@@ -273,4 +273,5 @@ reflectSecrets.__type = [
 ];
 
 //#endregion
-export { BaseEnv, BaseSecrets, __ΩCreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets };
+export { BaseEnv, BaseSecrets, __ΩCreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets };
+//# sourceMappingURL=reflect.mjs.map

package/dist/helpers/reflect.mjs.map

@@ -0,0 +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\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":";;;;;;;;;;AAUA,SAAS,aAAa,IAAI,MAAM;AAC5B,IAAG,SAAS;AACZ,QAAO;;AAyBX,SAAgB,oBAAM,SAAA,aAAA;AAIlB,uCAFI,MAAM,MAAM,YAAY,IAAG,cAAA,eAAA,WAAA,MAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,EAC9B,CAAC;;AAGN,oBAAoB,SAAS;OAAO;CAAc;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;AAClD,SAAgB,wBAAwB,SAAS,aAAa;AAI9D,QAHI,wBAAA,SAAA;;;;OAEC,CAAC;;AAGN,wBAAwB,SAAS;OAAM;CAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;AACvC,MAAM,gCAAqB;OAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;AAE3B,IAAa,UAAb,MAAqB;CASjB,WAAW;CACX,OAAO;;CAGP,OAAO;CACP,UAAU;;CAEV,cAAc;;CAEd,aAAa;;;CAMb,OAAO,SAAS;EAAC;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA,WAAA;AAAA,UAAA;;EAAA;EAAA;EAAA;EAAA;EAAA,WAAA;AAAA,UAAA;;EAAA;EAAA;EAAA,WAAA;AAAA,UAAA;;EAAA;EAAA,WAAA;AAAA,UAAA;;EAAA;EAAA,WAAA;AAAA,UAAA;;EAAA;EAAA,WAAA;AAAA,UAAA;;EAAA;EAAA,WAAA;AAAA,UAAA;;EAAA;EAAA,WAAA;AAAA,UAAA;;EAAA;EAAA,WAAA;AAAA,UAAA;;EAAA;EAAA,WAAA;AAAA,UAAA;;EAAA;EAAA;EAAA;EAAA;EAAA,WAAA;AAAA,UAAA;;QAAA;EAAA;EAAA;EAAA;;AAErB,IAAa,cAAb,MAAsB;CAElB,OAAO,SAAS;EAAC;QAAE;EAAA;EAAA;EAAA;;AAEvB,SAAgB,oBAAoB,SAAS,UAAS,EAAA,EAAA;2CAE9C,IAAI,gBAAgB;;EAEhB,aAAU,yDAAA,UAAA,QAAA,OAAA,KAAA,CAAA;;EAEV,OAAO,EAAE;eAEL;;GAEI,UAAM;;GAEN,OAAO,EAAA;;;AAIvB,QAAO,OAAO;;EAEV,MAAM,eAAe;;EAErB,aAAa,2FAAgB,QAAA,OAAA,yDAEvB,cAAM;;EAEf,EAAE,OAAO;;AAEV,QAAO;;AAEX,oBAAoB,SAAC;OAAA;CAAA;OAAA;CAAA;QAAA,EAAA;OAAA;CAAA;CAAA;CAAA;AACrB,SAAA,wBAAA,SAAA,UAAA,EAAA,EAAA;2CAEQ,IAAI,gBAAgB;EAChB,MAAM,eAAO;EACzB,aAAA,qDAAA,UAAA,QAAA,OAAA,KAAA,CAAA;;EAEY,OAAO,EAAE;EACT,YAAY,CACR;GACI,MAAI,eAAA;GACT,UAAA;GACK,aAAS,0DAAA,UAAA,QAAA,OAAA,KAAA,CAAA;GACT,OAAI,EAAA;GACP,CAAA;EAER,CAAC;AACN,QAAO,OAAO;CACd,MAAM,SAAS,IAAI,gBAAC,QAAA,QAAA;EAChB,MAAM,eAAC;EACP,UAAU;EACV,aAAA,yFAAA,QAAA,OAAA,OACM,GAAG,UAAU,QAAQ,OAAO,KAAE,CAAA,gBAC9B,cAAa;EACnB,OAAO,EAAA;EACV,EAAE,OAAO;AACV,QAAO,OAAO;AACd,QAAO;;AAEX,wBAAM,SAAA;OAAA;CAAA;OAAA;CAAA;QAAA,EAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;AAYN,eAAS,WAAA,SAAA,MAAA,MAAA;CACL,IAAI;AACJ,KAAC,gCACI,MAAA,YAAA,SAAA;EACN,MAAA,CAAA,aAAA,MAAA,QAAA,gBAAA,cAAA,GACe,UAAG,QAAA,gBAAA,eAAA,KAAA;EAET;EACZ,CAAA;AAGI,QAAO,oBAAgB,SAAA;EACnB,MAAM,sBAAsB,SAAK,MAAA;EACjC;EACA,iBAAO,MAAA,YAAA,SAAA,MAAA,4BAAA,QAAA,CAAA,CAAA;EACV,CAAC,OAAO,QAAQ,CAAC;;AAEtB,WAAW,SAAS;OAAO;CAAK;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;AAYhC,eAAsB,eAAA,SAAA,MAAA,MAAA;CAClB,IAAI;AACJ,KAAI,KAOA,UAAS,iBANX,MAAA,YAAA,SAAA;EACA,MAAA,CAAA,aAAA,MAAA,QAAA,gBAAA,cAAA,GACY,UAAO,QAAA,gBAAA,eAAA,KAAA;EAEb;EACH,CAAC,CAC8B;AAEpC,QAAO,wBAAwB,SAAS;EACpC,MAAM,sBAAY,QAAA;EAClB;EACA,iBAAgB,MAAA,YAAA,SAAA,MAAA,gCAAA,QAAA,CAAA,CAAA;EACnB,CAAC,OAAG,QAAA,CAAA;;AAET,eAAK,SAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/helpers/source-file-env.d.cts

@@ -0,0 +1,9 @@
+import { DotenvParseOutput } from "@stryke/env/types";
+
+//#region src/helpers/source-file-env.d.ts
+type TReturned<TEnv> = TEnv extends string ? string : DotenvParseOutput;
+declare function removeEnvPrefix<TEnv extends DotenvParseOutput | string>(env: TEnv): TReturned<TEnv>;
+declare function formatEnvField(key: string): string;
+//#endregion
+export { formatEnvField, removeEnvPrefix };
+//# sourceMappingURL=source-file-env.d.cts.map

package/dist/helpers/source-file-env.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file-env.d.cts","names":[],"sources":["../../src/helpers/source-file-env.ts"],"sourcesContent":[],"mappings":";;;KAuBK,kBAAkB,+BAA+B;iBAEtC,6BAA6B,iCACtC,OACJ,UAAU;AAJR,iBA+BW,cAAA,CA/BsC,GAAA,EAAA,MAAA,CAAA,EAAA,MAAiB"}

package/dist/helpers/source-file-env.d.mts

@@ -0,0 +1,9 @@
+import { DotenvParseOutput } from "@stryke/env/types";
+
+//#region src/helpers/source-file-env.d.ts
+type TReturned<TEnv> = TEnv extends string ? string : DotenvParseOutput;
+declare function removeEnvPrefix<TEnv extends DotenvParseOutput | string>(env: TEnv): TReturned<TEnv>;
+declare function formatEnvField(key: string): string;
+//#endregion
+export { formatEnvField, removeEnvPrefix };
+//# sourceMappingURL=source-file-env.d.mts.map

package/dist/helpers/source-file-env.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file-env.d.mts","names":[],"sources":["../../src/helpers/source-file-env.ts"],"sourcesContent":[],"mappings":";;;KAuBK,kBAAkB,+BAA+B;iBAEtC,6BAA6B,iCACtC,OACJ,UAAU;AAJR,iBA+BW,cAAA,CA/BsC,GAAA,EAAA,MAAA,CAAA,EAAA,MAAiB"}

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

@@ -53,4 +53,5 @@ formatEnvField.__type = [
 ];
 
 //#endregion
-export { formatEnvField, removeEnvPrefix };
+export { formatEnvField, removeEnvPrefix };
+//# sourceMappingURL=source-file-env.mjs.map

package/dist/helpers/source-file-env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file-env.mjs","names":[],"sources":["../../src/helpers/source-file-env.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 type { DotenvParseOutput } from \"@stryke/env/types\";\nimport { ENV_PREFIXES } from \"@stryke/env/types\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { isString } from \"@stryke/type-checks/is-string\";\n\ntype TReturned<TEnv> = TEnv extends string ? string : DotenvParseOutput;\n\nexport function removeEnvPrefix<TEnv extends DotenvParseOutput | string>(\n  env: TEnv\n): TReturned<TEnv> {\n  if (isString(env)) {\n    let name: string = ENV_PREFIXES.reduce((ret, prefix) => {\n      if (ret.startsWith(prefix)) {\n        ret = ret.slice(prefix.length);\n      }\n\n      return ret;\n    }, env.toUpperCase());\n\n    while (name.startsWith(\"_\")) {\n      name = name.slice(1);\n    }\n\n    return name as TReturned<TEnv>;\n  }\n\n  return Object.keys(env).reduce((ret, key) => {\n    const name = removeEnvPrefix(key);\n    if (name) {\n      (ret as DotenvParseOutput)[name] = env[key];\n    }\n\n    return ret;\n  }, {} as TReturned<TEnv>);\n}\n\nexport function formatEnvField(key: string): string {\n  return camelCase(removeEnvPrefix(key));\n}\n"],"mappings":";;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;AAKX,MAAM,eAAe;CAAC;CAAQ;CAAa;CAAiC;;AAExE,KAAI,SAAS,IAAI,EAAE;EACf,IAAI,OAAO,aAAa,OAAO,cAAc,KAAK,WAAW;AACzD,OAAI,IAAI,WAAW,OAAO,CACtB,OAAM,IAAI,MAAM,OAAO,OAAO;AAElC,UAAO;;;;;;;AAEX,SAAO,KAAK,WAAW,IAAI;AAG3B,SAAO;;AAEX,QAAO,OAAO,KAAK,IAAI,CAAC,OAAO,cAAc,KAAK,QAAE;;AAEhD,MAAI;AAGJ,SAAE;IACH;EAAC;EAAO;EAAI;EAAA;EAAA,CAAA,EAAA,EAAA,CAAA;;AAEnB,gBAAgB,SAAS;CAAC;OAAa;CAAc;CAAO;CAAA;AAC5D,SAAgB,eAAe,KAAG;AAC9B,QAAO,UAAU,gBAAgB,IAAC,CAAA"}

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

@@ -0,0 +1,16 @@
+import { EnvPluginContext, EnvType } from "../types/plugin.cjs";
+import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
+
+//#region src/helpers/template-helpers.d.ts
+
+/**
+ * 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>>;
+//#endregion
+export { createTemplateReflection };
+//# sourceMappingURL=template-helpers.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template-helpers.d.cts","names":[],"sources":["../../src/helpers/template-helpers.ts"],"sourcesContent":[],"mappings":";;;;;;;AA8BA;;;;;AAGU,iBAHY,wBAAA,CAGZ,OAAA,EAFC,gBAED,EAAA,IAAA,CAAA,EADD,OACC,CAAA,EAAP,OAAO,CAAC,eAAD,CAAA,GAAA,CAAA,CAAA"}

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

@@ -0,0 +1,16 @@
+import { EnvPluginContext, EnvType } from "../types/plugin.mjs";
+import { ReflectionClass } from "@powerlines/deepkit/vendor/type";
+
+//#region src/helpers/template-helpers.d.ts
+
+/**
+ * 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>>;
+//#endregion
+export { createTemplateReflection };
+//# sourceMappingURL=template-helpers.d.mts.map

package/dist/helpers/template-helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-helpers.d.mts","names":[],"sources":["../../src/helpers/template-helpers.ts"],"sourcesContent":[],"mappings":";;;;;;;AA8BA;;;;;AAGU,iBAHY,wBAAA,CAGZ,OAAA,EAFC,gBAED,EAAA,IAAA,CAAA,EADD,OACC,CAAA,EAAP,OAAO,CAAC,eAAD,CAAA,GAAA,CAAA,CAAA"}

package/dist/helpers/template-helpers.mjs

@@ -66,4 +66,5 @@ createTemplateReflection.__type = [
 ];
 
 //#endregion
-export { createTemplateReflection };
+export { createTemplateReflection };
+//# sourceMappingURL=template-helpers.mjs.map

package/dist/helpers/template-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-helpers.mjs","names":[],"sources":["../../src/helpers/template-helpers.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 { ReflectionClass } from \"@powerlines/deepkit/vendor/type\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { EnvPluginContext, EnvType } from \"../types/plugin\";\nimport { readEnvTypeReflection } from \"./persistence\";\n\n/**\n * Creates the reflection data used when generating runtime template files.\n *\n * @param context - The context for the configuration plugin.\n * @param name - The name of the configuration template.\n * @returns The reflection for the specified configuration template.\n */\nexport async function createTemplateReflection(\n  context: EnvPluginContext,\n  name?: EnvType\n): Promise<ReflectionClass<any>> {\n  const reflection = await readEnvTypeReflection(context, name);\n\n  reflection.getProperties().forEach(prop => {\n    const aliases = prop.getAlias();\n    aliases.filter(Boolean).forEach(alias => {\n      reflection.addProperty({\n        name: alias,\n        optional: prop.isOptional() ? true : undefined,\n        readonly: prop.isReadonly() ? true : undefined,\n        description: prop.getDescription(),\n        visibility: prop.getVisibility(),\n        type: prop.getType(),\n        default: prop.getDefaultValue(),\n        tags: {\n          hidden: prop.isHidden(),\n          ignore: prop.isIgnored(),\n          internal: prop.isInternal(),\n          alias: prop\n            .getAlias()\n            .filter(a => a !== alias)\n            .concat(prop.name),\n          title: prop.getTitle() || titleCase(prop.name),\n          readonly: prop.isReadonly(),\n          permission: prop.getPermission(),\n          domain: prop.getDomain()\n        }\n      });\n    });\n  });\n\n  return reflection;\n}\n"],"mappings":";;;;;;AAIA,SAAS,aAAa,IAAI,MAAM;AAC5B,IAAG,SAAS;AACZ,QAAO;;;;;;;;;;CA8BP,MAAM,aAAa,MAAM,sBAAgB,SAAA,KAAA;AACzC,YAAW,eAAe,CAAC,QAAI,cAAA,SAAA;AAE3B,EADgB,KAAK,UAAU,CACvB,OAAO,QAAM,CAAA,QAAA,cAAA,UAAA;AACjB,cAAO,YAAA;IACH,MAAM;IACN,UAAU,KAAK,YAAY,GAAG,OAAO;IACrC,UAAU,KAAK,YAAW,GAAA,OAAA;IAC1B,aAAa,KAAK,gBAAM;IACxB,YAAY,KAAA,eAAA;IACZ,MAAM,KAAK,SAAS;IACtB,SAAA,KAAA,iBAAA;IACE,MAAM;KACF,QAAQ,KAAK,UAAC;KACd,QAAQ,KAAK,WAAI;KACjB,UAAA,KAAA,YAAA;KACA,OAAE,KACG,UAAU,CACV,OAAK,cAAA,MAAA,MAAA,OAAA;MAAA;MAAA;MAAA;MAAA,CAAA,CAAA,CACL,OAAO,KAAK,KAAK;KACtB,OAAO,KAAK,UAAK,IAAA,UAAA,KAAA,KAAA;KACjB,UAAU,KAAK,YAAO;KACtB,YAAY,KAAC,eAAA;KACzB,QAAA,KAAA,WAAA;KACA;IACF,CAAA;KACF;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;;;;;;AAEA,QAAO"}

package/dist/index.d.cts

@@ -0,0 +1,18 @@
+import { EnvInterface, SecretsInterface, __ΩEnvInterface, __ΩSecretsInterface } from "./types/runtime.cjs";
+import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType } from "./types/plugin.cjs";
+import "./types/index.cjs";
+import { Plugin } from "powerlines";
+
+//#region src/index.d.ts
+declare module "powerlines" {
+  interface Config {
+    env?: EnvPluginOptions;
+  }
+}
+/**
+ * A Powerlines plugin to inject environment variables into the source code.
+ */
+declare const plugin: <TContext extends EnvPluginContext = EnvPluginContext>(options?: EnvPluginOptions) => Plugin<TContext>[];
+//#endregion
+export { EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, SecretsInterface, __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, plugin as default, plugin };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;UAgEU;EAJmB;;;;;AAWhB,cAAA,MA6VZ,EAAA,CAAA,iBA7VuC,gBA6VvC,GA7V0D,gBA6V1D,CAAA,CAAA,OAAA,CAAA,EA5VU,gBA4VV,EAAA,GADM,MACN,CADa,QACb,CAAA,EAAA"}

package/dist/index.d.mts

@@ -0,0 +1,18 @@
+import { EnvInterface, SecretsInterface, __ΩEnvInterface, __ΩSecretsInterface } from "./types/runtime.mjs";
+import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType } from "./types/plugin.mjs";
+import "./types/index.mjs";
+import { Plugin } from "powerlines";
+
+//#region src/index.d.ts
+declare module "powerlines" {
+  interface Config {
+    env?: EnvPluginOptions;
+  }
+}
+/**
+ * A Powerlines plugin to inject environment variables into the source code.
+ */
+declare const plugin: <TContext extends EnvPluginContext = EnvPluginContext>(options?: EnvPluginOptions) => Plugin<TContext>[];
+//#endregion
+export { EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvType, SecretsInterface, __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvType, __ΩSecretsInterface, plugin as default, plugin };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;UAgEU;EAJmB;;;;;AAWhB,cAAA,MA6VZ,EAAA,CAAA,iBA7VuC,gBA6VvC,GA7V0D,gBA6V1D,CAAA,CAAA,OAAA,CAAA,EA5VU,gBA4VV,EAAA,GADM,MACN,CADa,QACb,CAAA,EAAA"}

package/dist/index.mjs

@@ -186,4 +186,5 @@ const plugin = (options = {}) => {
 var src_default = plugin;
 
 //#endregion
-export { src_default as default, plugin };
+export { src_default as default, plugin };
+//# sourceMappingURL=index.mjs.map