@powerlines/plugin-env 0.16.237 → 0.16.238

package/dist/helpers/schema.d.mts

@@ -34,6 +34,20 @@ declare function getDefaultSecretsTypeDefinition<TContext extends UnresolvedCont
  * @returns A promise that resolves when the schema has been extracted and stored in the plugin context.
  */
 declare function extractEnvSchema<TContext extends EnvPluginContext>(context: TContext, options?: EnvPluginOptions): Promise<void>;
+/**
+ * Reads the active environment variables and secrets from the plugin context's cache and stores them in the plugin context for use during the build process. This function should be called during the plugin's `buildStart` hook to ensure that the active environment variables and secrets are available before the build process begins.
+ *
+ * @param context - The plugin context
+ * @returns A promise that resolves when the active environment variables and secrets have been read and stored in the plugin context.
+ */
+declare function readActiveEnv<TContext extends EnvPluginContext>(context: TContext): Promise<void>;
+/**
+ * Writes the active environment variables and secrets from the plugin context to the plugin context's cache for use during the build process. This function should be called whenever the active environment variables and secrets are updated in the plugin context to ensure that the latest values are available during the build process.
+ *
+ * @param context - The plugin context
+ * @returns A promise that resolves when the active environment variables and secrets have been written to the plugin context's cache.
+ */
+declare function writeActiveEnv<TContext extends EnvPluginContext>(context: TContext): Promise<void[]>;
 //#endregion
-export { extractEnvSchema, getDefaultSecretsTypeDefinition, getDefaultVarsTypeDefinition, resolveRuntimeTypeFile };
+export { extractEnvSchema, getDefaultSecretsTypeDefinition, getDefaultVarsTypeDefinition, readActiveEnv, resolveRuntimeTypeFile, writeActiveEnv };
 //# sourceMappingURL=schema.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.mts","names":[],"sources":["../../src/helpers/schema.ts"],"mappings":";;;;;;;AAwCA;;;;iBAAsB,sBAAA,kBACH,iBAAA,CAAA,CACjB,OAAA,EAAS,QAAA,GAAW,OAAA;;;;;;;iBAiBA,4BAAA,kBACH,iBAAA,CAAA,CACjB,OAAA,EAAS,QAAA,GAAW,OAAA,CAAQ,cAAA;;;AAnBD;AAiB7B;;iBAcsB,+BAAA,kBACH,iBAAA,CAAA,CACjB,OAAA,EAAS,QAAA,GAAW,OAAA,CAAQ,cAAA;;;;;;;;;;;iBAiBR,gBAAA,kBAAkC,gBAAA,CAAA,CACtD,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,gBAAA,GACR,OAAA"}
+{"version":3,"file":"schema.d.mts","names":[],"sources":["../../src/helpers/schema.ts"],"mappings":";;;;;;;AAqCA;;;;iBAAsB,sBAAA,kBACH,iBAAA,CAAA,CACjB,OAAA,EAAS,QAAA,GAAW,OAAA;;;;;;;iBAiBA,4BAAA,kBACH,iBAAA,CAAA,CACjB,OAAA,EAAS,QAAA,GAAW,OAAA,CAAQ,cAAA;;;AAnBD;AAiB7B;;iBAcsB,+BAAA,kBACH,iBAAA,CAAA,CACjB,OAAA,EAAS,QAAA,GAAW,OAAA,CAAQ,cAAA;;;;;;;;;;;iBAiBR,gBAAA,kBAAkC,gBAAA,CAAA,CACtD,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,gBAAA,GACR,OAAA;;;AAlCyC;AAY5C;;;iBA8LsB,aAAA,kBAA+B,gBAAA,CAAA,CACnD,OAAA,EAAS,QAAA,GAAQ,OAAA;;;;;;;iBAqCG,cAAA,kBAAgC,gBAAA,CAAA,CACpD,OAAA,EAAS,QAAA,GAAQ,OAAA"}

package/dist/helpers/schema.mjs

@@ -1,8 +1,10 @@
 import { __ΩEnvPluginOptions } from "../types/plugin.mjs";
 import { loadEnv } from "./load.mjs";
 import { isString } from "@stryke/type-checks/is-string";
+import { getCacheDirectory } from "@powerlines/schema";
 import { extract } from "@powerlines/schema/extract";
-import { getProperties, mergeSchemas } from "@powerlines/schema/helpers";
+import { getProperties as getProperties$1, mergeSchemas } from "@powerlines/schema/helpers";
+import { joinPaths } from "@stryke/path/join";
 import { isSetArray } from "@stryke/type-checks/is-set-array";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import defu from "defu";
@@ -88,10 +90,11 @@ async function extractEnvSchema(context, options = {}) {
 		parsed: {},
 		injected: []
 	});
-	const properties = getProperties(context.env.vars);
+	await readActiveEnv(context);
+	const properties = getProperties$1(context.env.vars);
 	context.info({
 		meta: { category: "env" },
-		message: `Environment Variables configuration: ${options.vars ? "" : "Defaulted "}${context.env.vars.variant === "reflection" ? "Deepkit type definition" : context.env.vars.variant === "json-schema" ? "JSON Schema" : context.env.vars.variant === "standard-schema" ? "Standard Schema" : context.env.vars.variant === "zod3" ? "Zod v3 schema" : "Typescript exported type"}${options.vars ? " from plugin options" : ""} provided ${Object.keys(properties).length} parameters\nEnvironment Secret configuration: ${options.secrets ? "" : "Defaulted "}${context.env.secrets.variant === "reflection" ? "Deepkit type definition" : context.env.secrets.variant === "json-schema" ? "JSON Schema" : context.env.secrets.variant === "standard-schema" ? "Standard Schema" : context.env.secrets.variant === "zod3" ? "Zod v3 schema" : "Typescript exported type"}${options.secrets ? " from plugin options" : ""} provided ${context.env.secrets?.schema ? Object.keys(getProperties(context.env.secrets)).length : "0"} parameters\nEnvironment variable Prefixes: ${context.config.env.prefix.join(", ")}\nShould inject values: ${context.config.env.inject ? "Yes" : "No"}\nShould validate configuration: ${context.config.env.validate ? "Yes" : "No"}`
+		message: `Environment Variables configuration: ${options.vars ? "" : "Defaulted "}${context.env.vars.variant === "reflection" ? "Deepkit type definition" : context.env.vars.variant === "json-schema" ? "JSON Schema" : context.env.vars.variant === "standard-schema" ? "Standard Schema" : context.env.vars.variant === "zod3" ? "Zod v3 schema" : "Typescript exported type"}${options.vars ? " from plugin options" : ""} provided ${Object.keys(properties).length} parameters\nEnvironment Secret configuration: ${options.secrets ? "" : "Defaulted "}${context.env.secrets.variant === "reflection" ? "Deepkit type definition" : context.env.secrets.variant === "json-schema" ? "JSON Schema" : context.env.secrets.variant === "standard-schema" ? "Standard Schema" : context.env.secrets.variant === "zod3" ? "Zod v3 schema" : "Typescript exported type"}${options.secrets ? " from plugin options" : ""} provided ${context.env.secrets?.schema ? Object.keys(getProperties$1(context.env.secrets)).length : "0"} parameters\nEnvironment variable Prefixes: ${context.config.env.prefix.join(", ")}\nShould inject values: ${context.config.env.inject ? "Yes" : "No"}\nShould validate configuration: ${context.config.env.validate ? "Yes" : "No"}`
 	});
 	const aliases = Object.fromEntries(Object.entries(properties).flatMap(__assignType(([key, prop]) => isSetArray(prop.metadata?.alias) ? prop.metadata?.alias?.map(__assignType((alias) => [alias, {
 		...prop,
@@ -151,7 +154,46 @@ extractEnvSchema.__type = [
 	"Extracts the environment variables and secrets schema from the provided type definitions in the plugin options, merges them with the default environment variables and secrets schema, and stores the resulting schema in the plugin context for later use during the build process.",
 	"P\"2!n\"2#>$$`/%?&"
 ];
+/**
+* Reads the active environment variables and secrets from the plugin context's cache and stores them in the plugin context for use during the build process. This function should be called during the plugin's `buildStart` hook to ensure that the active environment variables and secrets are available before the build process begins.
+*
+* @param context - The plugin context
+* @returns A promise that resolves when the active environment variables and secrets have been read and stored in the plugin context.
+*/
+async function readActiveEnv(context) {
+	context.env.vars.active ??= [];
+	if (context.fs.existsSync(joinPaths(getCacheDirectory(context), "env", "vars.json"))) {
+		const content = await context.fs.read(joinPaths(getCacheDirectory(context), "env", "vars.json"));
+		if (content) context.env.vars.active = JSON.parse(content)?.elements ?? [];
+	}
+	context.env.secrets.active ??= [];
+	if (context.fs.existsSync(joinPaths(getCacheDirectory(context), "env", "secrets.json"))) {
+		const content = await context.fs.read(joinPaths(getCacheDirectory(context), "env", "secrets.json"));
+		if (content) context.env.secrets.active = JSON.parse(content)?.elements ?? [];
+	}
+}
+readActiveEnv.__type = [
+	"context",
+	"readActiveEnv",
+	"Reads the active environment variables and secrets from the plugin context's cache and stores them in the plugin context for use during the build process. This function should be called during the plugin's `buildStart` hook to ensure that the active environment variables and secrets are available before the build process begins.",
+	"P\"2!\"/\"?#"
+];
+/**
+* Writes the active environment variables and secrets from the plugin context to the plugin context's cache for use during the build process. This function should be called whenever the active environment variables and secrets are updated in the plugin context to ensure that the latest values are available during the build process.
+*
+* @param context - The plugin context
+* @returns A promise that resolves when the active environment variables and secrets have been written to the plugin context's cache.
+*/
+async function writeActiveEnv(context) {
+	return Promise.all([isSetArray(context.env.vars.active) ? context.fs.write(joinPaths(getCacheDirectory(context), "env", "vars.json"), JSON.stringify({ elements: context.env.vars.active })) : void 0, isSetArray(context.env.secrets.active) ? context.fs.write(joinPaths(getCacheDirectory(context), "env", "secrets.json"), JSON.stringify({ elements: context.env.secrets.active })) : void 0].filter(Boolean));
+}
+writeActiveEnv.__type = [
+	"context",
+	"writeActiveEnv",
+	"Writes the active environment variables and secrets from the plugin context to the plugin context's cache for use during the build process. This function should be called whenever the active environment variables and secrets are updated in the plugin context to ensure that the latest values are available during the build process.",
+	"P\"2!\"/\"?#"
+];
 
 //#endregion
-export { extractEnvSchema, getDefaultSecretsTypeDefinition, getDefaultVarsTypeDefinition, resolveRuntimeTypeFile };
+export { extractEnvSchema, getDefaultSecretsTypeDefinition, getDefaultVarsTypeDefinition, readActiveEnv, resolveRuntimeTypeFile, writeActiveEnv };
 //# sourceMappingURL=schema.mjs.map

package/dist/helpers/schema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema.mjs","names":[],"sources":["../../src/helpers/schema.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 { ObjectSchema } from \"@powerlines/schema\";\nimport { extract } from \"@powerlines/schema/extract\";\nimport { getProperties, mergeSchemas } from \"@powerlines/schema/helpers\";\nimport { isSetArray } from \"@stryke/type-checks/is-set-array\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport type { TypeDefinition } from \"@stryke/types/configuration\";\nimport defu from \"defu\";\nimport { UnresolvedContext } from \"powerlines\";\nimport {\n  EnvPluginContext,\n  EnvPluginOptions,\n  EnvSchemaMetadata\n} from \"../types/plugin\";\nimport { loadEnv } from \"./load\";\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  TContext extends UnresolvedContext\n>(context: TContext): Promise<string> {\n  const resolved = await context.fs.resolve(\"@powerlines/plugin-env/types/env\");\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 getDefaultVarsTypeDefinition<\n  TContext extends UnresolvedContext\n>(context: TContext): 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 getDefaultSecretsTypeDefinition<\n  TContext extends UnresolvedContext\n>(context: TContext): Promise<TypeDefinition> {\n  return {\n    file: await resolveRuntimeTypeFile(context),\n    name: \"SecretsInterface\"\n  };\n}\n\n/**\n * Extracts the environment variables and secrets schema from the provided type definitions in the plugin options, merges them with the default environment variables and secrets schema, and stores the resulting schema in the plugin context for later use during the build process.\n *\n * @remarks\n * This function should be called during the plugin's `config` hook to ensure that the environment variables and secrets schema is available in the plugin context before the build process begins. The resulting schema will be used to validate the loaded environment variables and secrets, as well as to provide type information for the injected environment variables and secrets during the build process.\n *\n * @param context - The plugin context\n * @param options - The plugin options containing the environment variables and secrets type definitions to extract the schema from. If not provided, the default type definitions will be used.\n * @returns A promise that resolves when the schema has been extracted and stored in the plugin context.\n */\nexport async function extractEnvSchema<TContext extends EnvPluginContext>(\n  context: TContext,\n  options: EnvPluginOptions = {}\n): Promise<void> {\n  const defaultVarsTypeDefinition = await getDefaultVarsTypeDefinition(context);\n  const defaultSecretsTypeDefinition =\n    await getDefaultSecretsTypeDefinition(context);\n\n  const vars = (await extract(\n    context,\n    context.config.env.vars\n  )) as ObjectSchema<EnvSchemaMetadata>;\n  if (\n    (isString(context.config.env.vars) &&\n      context.config.env.vars !==\n        `${defaultVarsTypeDefinition.file}#${\n          defaultVarsTypeDefinition.name\n        }`) ||\n    (isSetObject(context.config.env.vars) &&\n      ((context.config.env.vars as TypeDefinition).file !==\n        defaultVarsTypeDefinition.file ||\n        (context.config.env.vars as TypeDefinition).name !==\n          defaultVarsTypeDefinition.name))\n  ) {\n    vars.schema = mergeSchemas(\n      vars,\n      (await extract(\n        context,\n        defaultVarsTypeDefinition\n      )) as ObjectSchema<EnvSchemaMetadata>\n    );\n  }\n\n  const secrets = (await extract(\n    context,\n    context.config.env.secrets\n  )) as ObjectSchema<EnvSchemaMetadata>;\n  if (\n    (isString(context.config.env.secrets) &&\n      context.config.env.secrets !==\n        `${defaultSecretsTypeDefinition.file}#${\n          defaultSecretsTypeDefinition.name\n        }`) ||\n    (isSetObject(context.config.env.secrets) &&\n      ((context.config.env.secrets as TypeDefinition).file !==\n        defaultSecretsTypeDefinition.file ||\n        (context.config.env.secrets as TypeDefinition).name !==\n          defaultSecretsTypeDefinition.name))\n  ) {\n    secrets.schema = mergeSchemas(\n      secrets,\n      (await extract(\n        context,\n        defaultSecretsTypeDefinition\n      )) as ObjectSchema<EnvSchemaMetadata>\n    );\n  }\n\n  context.env = defu(\n    {\n      vars,\n      secrets,\n      parsed: await loadEnv(context, context.config.env)\n    },\n    context.env ?? {},\n    {\n      parsed: {},\n      injected: []\n    }\n  );\n\n  const properties = getProperties(context.env.vars);\n  context.info({\n    meta: {\n      category: \"env\"\n    },\n    message: `Environment Variables configuration: ${\n      options.vars ? \"\" : \"Defaulted \"\n    }${\n      context.env.vars.variant === \"reflection\"\n        ? \"Deepkit type definition\"\n        : context.env.vars.variant === \"json-schema\"\n          ? \"JSON Schema\"\n          : context.env.vars.variant === \"standard-schema\"\n            ? \"Standard Schema\"\n            : context.env.vars.variant === \"zod3\"\n              ? \"Zod v3 schema\"\n              : \"Typescript exported type\"\n    }${options.vars ? \" from plugin options\" : \"\"} provided ${\n      Object.keys(properties).length\n    } parameters\\nEnvironment Secret configuration: ${\n      options.secrets ? \"\" : \"Defaulted \"\n    }${\n      context.env.secrets.variant === \"reflection\"\n        ? \"Deepkit type definition\"\n        : context.env.secrets.variant === \"json-schema\"\n          ? \"JSON Schema\"\n          : context.env.secrets.variant === \"standard-schema\"\n            ? \"Standard Schema\"\n            : context.env.secrets.variant === \"zod3\"\n              ? \"Zod v3 schema\"\n              : \"Typescript exported type\"\n    }${options.secrets ? \" from plugin options\" : \"\"} provided ${\n      context.env.secrets?.schema\n        ? Object.keys(getProperties(context.env.secrets)).length\n        : \"0\"\n    } parameters\\nEnvironment variable Prefixes: ${context.config.env.prefix.join(\n      \", \"\n    )}\\nShould inject values: ${\n      context.config.env.inject ? \"Yes\" : \"No\"\n    }\\nShould validate configuration: ${\n      context.config.env.validate ? \"Yes\" : \"No\"\n    }`\n  });\n\n  const aliases = Object.fromEntries(\n    Object.entries(properties).flatMap(\n      ([key, prop]) =>\n        (isSetArray(prop.metadata?.alias)\n          ? prop.metadata?.alias?.map(alias => [\n              alias,\n              { ...prop, metadata: { ...prop.metadata, alias: [key] } }\n            ])\n          : []) as [string, typeof prop][]\n    )\n  );\n\n  for (const [key, value] of Object.entries(\n    await loadEnv(context, context.config.env)\n  )) {\n    const unprefixedKey = context.config.env.prefix.reduce((ret, prefix) => {\n      if (key.replace(/_$/g, \"\").startsWith(prefix)) {\n        return key.replace(/_$/g, \"\").slice(prefix.length);\n      }\n      return ret;\n    }, key);\n    if (properties[unprefixedKey]) {\n      if (!properties[unprefixedKey].metadata?.isRuntime) {\n        if (\n          properties[unprefixedKey].optional &&\n          context.env.vars.schema.optionalProperties?.[unprefixedKey]\n        ) {\n          context.env.vars.schema.optionalProperties[unprefixedKey].metadata ??=\n            {} as EnvSchemaMetadata;\n          context.env.vars.schema.optionalProperties[\n            unprefixedKey\n          ].metadata.default = value;\n        } else if (context.env.vars.schema.properties?.[unprefixedKey]) {\n          context.env.vars.schema.properties[unprefixedKey].metadata ??=\n            {} as EnvSchemaMetadata;\n          context.env.vars.schema.properties[unprefixedKey].metadata.default =\n            value;\n        }\n      }\n    } else if (aliases[unprefixedKey]) {\n      if (!aliases[unprefixedKey].metadata?.isRuntime) {\n        const alias =\n          aliases[unprefixedKey].metadata?.alias?.[0] ?? unprefixedKey;\n        if (\n          aliases[unprefixedKey].optional &&\n          context.env.vars.schema.optionalProperties?.[alias]\n        ) {\n          context.env.vars.schema.optionalProperties[alias].metadata ??=\n            {} as EnvSchemaMetadata;\n          context.env.vars.schema.optionalProperties[alias].metadata.default =\n            value;\n        } else if (context.env.vars.schema.properties?.[alias]) {\n          context.env.vars.schema.properties[alias].metadata ??=\n            {} as EnvSchemaMetadata;\n          context.env.vars.schema.properties[alias].metadata.default = value;\n        }\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"schema.mjs","names":[],"sources":["../../src/helpers/schema.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 { getCacheDirectory } from \"@powerlines/schema\";\nimport { extract } from \"@powerlines/schema/extract\";\nimport { getProperties, mergeSchemas } from \"@powerlines/schema/helpers\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { isSetArray } from \"@stryke/type-checks/is-set-array\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport type { TypeDefinition } from \"@stryke/types/configuration\";\nimport defu from \"defu\";\nimport { UnresolvedContext } from \"powerlines\";\nimport { EnvPluginContext, EnvPluginOptions, EnvSchema } from \"../types/plugin\";\nimport { loadEnv } from \"./load\";\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  TContext extends UnresolvedContext\n>(context: TContext): Promise<string> {\n  const resolved = await context.fs.resolve(\"@powerlines/plugin-env/types/env\");\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 getDefaultVarsTypeDefinition<\n  TContext extends UnresolvedContext\n>(context: TContext): 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 getDefaultSecretsTypeDefinition<\n  TContext extends UnresolvedContext\n>(context: TContext): Promise<TypeDefinition> {\n  return {\n    file: await resolveRuntimeTypeFile(context),\n    name: \"SecretsInterface\"\n  };\n}\n\n/**\n * Extracts the environment variables and secrets schema from the provided type definitions in the plugin options, merges them with the default environment variables and secrets schema, and stores the resulting schema in the plugin context for later use during the build process.\n *\n * @remarks\n * This function should be called during the plugin's `config` hook to ensure that the environment variables and secrets schema is available in the plugin context before the build process begins. The resulting schema will be used to validate the loaded environment variables and secrets, as well as to provide type information for the injected environment variables and secrets during the build process.\n *\n * @param context - The plugin context\n * @param options - The plugin options containing the environment variables and secrets type definitions to extract the schema from. If not provided, the default type definitions will be used.\n * @returns A promise that resolves when the schema has been extracted and stored in the plugin context.\n */\nexport async function extractEnvSchema<TContext extends EnvPluginContext>(\n  context: TContext,\n  options: EnvPluginOptions = {}\n): Promise<void> {\n  const defaultVarsTypeDefinition = await getDefaultVarsTypeDefinition(context);\n  const defaultSecretsTypeDefinition =\n    await getDefaultSecretsTypeDefinition(context);\n\n  const vars = (await extract(context, context.config.env.vars)) as EnvSchema;\n  if (\n    (isString(context.config.env.vars) &&\n      context.config.env.vars !==\n        `${defaultVarsTypeDefinition.file}#${\n          defaultVarsTypeDefinition.name\n        }`) ||\n    (isSetObject(context.config.env.vars) &&\n      ((context.config.env.vars as TypeDefinition).file !==\n        defaultVarsTypeDefinition.file ||\n        (context.config.env.vars as TypeDefinition).name !==\n          defaultVarsTypeDefinition.name))\n  ) {\n    vars.schema = mergeSchemas(\n      vars,\n      (await extract(context, defaultVarsTypeDefinition)) as EnvSchema\n    );\n  }\n\n  const secrets = (await extract(\n    context,\n    context.config.env.secrets\n  )) as EnvSchema;\n  if (\n    (isString(context.config.env.secrets) &&\n      context.config.env.secrets !==\n        `${defaultSecretsTypeDefinition.file}#${\n          defaultSecretsTypeDefinition.name\n        }`) ||\n    (isSetObject(context.config.env.secrets) &&\n      ((context.config.env.secrets as TypeDefinition).file !==\n        defaultSecretsTypeDefinition.file ||\n        (context.config.env.secrets as TypeDefinition).name !==\n          defaultSecretsTypeDefinition.name))\n  ) {\n    secrets.schema = mergeSchemas(\n      secrets,\n      (await extract(context, defaultSecretsTypeDefinition)) as EnvSchema\n    );\n  }\n\n  context.env = defu(\n    {\n      vars,\n      secrets,\n      parsed: await loadEnv(context, context.config.env)\n    },\n    context.env ?? {},\n    {\n      parsed: {},\n      injected: []\n    }\n  );\n  await readActiveEnv(context);\n\n  const properties = getProperties(context.env.vars);\n  context.info({\n    meta: {\n      category: \"env\"\n    },\n    message: `Environment Variables configuration: ${\n      options.vars ? \"\" : \"Defaulted \"\n    }${\n      context.env.vars.variant === \"reflection\"\n        ? \"Deepkit type definition\"\n        : context.env.vars.variant === \"json-schema\"\n          ? \"JSON Schema\"\n          : context.env.vars.variant === \"standard-schema\"\n            ? \"Standard Schema\"\n            : context.env.vars.variant === \"zod3\"\n              ? \"Zod v3 schema\"\n              : \"Typescript exported type\"\n    }${options.vars ? \" from plugin options\" : \"\"} provided ${\n      Object.keys(properties).length\n    } parameters\\nEnvironment Secret configuration: ${\n      options.secrets ? \"\" : \"Defaulted \"\n    }${\n      context.env.secrets.variant === \"reflection\"\n        ? \"Deepkit type definition\"\n        : context.env.secrets.variant === \"json-schema\"\n          ? \"JSON Schema\"\n          : context.env.secrets.variant === \"standard-schema\"\n            ? \"Standard Schema\"\n            : context.env.secrets.variant === \"zod3\"\n              ? \"Zod v3 schema\"\n              : \"Typescript exported type\"\n    }${options.secrets ? \" from plugin options\" : \"\"} provided ${\n      context.env.secrets?.schema\n        ? Object.keys(getProperties(context.env.secrets)).length\n        : \"0\"\n    } parameters\\nEnvironment variable Prefixes: ${context.config.env.prefix.join(\n      \", \"\n    )}\\nShould inject values: ${\n      context.config.env.inject ? \"Yes\" : \"No\"\n    }\\nShould validate configuration: ${\n      context.config.env.validate ? \"Yes\" : \"No\"\n    }`\n  });\n\n  const aliases = Object.fromEntries(\n    Object.entries(properties).flatMap(\n      ([key, prop]) =>\n        (isSetArray(prop.metadata?.alias)\n          ? prop.metadata?.alias?.map(alias => [\n              alias,\n              { ...prop, metadata: { ...prop.metadata, alias: [key] } }\n            ])\n          : []) as [string, typeof prop][]\n    )\n  );\n\n  for (const [key, value] of Object.entries(\n    await loadEnv(context, context.config.env)\n  )) {\n    const unprefixedKey = context.config.env.prefix.reduce((ret, prefix) => {\n      if (key.replace(/_$/g, \"\").startsWith(prefix)) {\n        return key.replace(/_$/g, \"\").slice(prefix.length);\n      }\n      return ret;\n    }, key);\n    if (properties[unprefixedKey]) {\n      if (!properties[unprefixedKey].metadata?.isRuntime) {\n        if (\n          properties[unprefixedKey].optional &&\n          context.env.vars.schema.optionalProperties?.[unprefixedKey]\n        ) {\n          context.env.vars.schema.optionalProperties[unprefixedKey].metadata ??=\n            {};\n          context.env.vars.schema.optionalProperties[\n            unprefixedKey\n          ].metadata.default = value;\n        } else if (context.env.vars.schema.properties?.[unprefixedKey]) {\n          context.env.vars.schema.properties[unprefixedKey].metadata ??= {};\n          context.env.vars.schema.properties[unprefixedKey].metadata.default =\n            value;\n        }\n      }\n    } else if (aliases[unprefixedKey]) {\n      if (!aliases[unprefixedKey].metadata?.isRuntime) {\n        const alias =\n          aliases[unprefixedKey].metadata?.alias?.[0] ?? unprefixedKey;\n        if (\n          aliases[unprefixedKey].optional &&\n          context.env.vars.schema.optionalProperties?.[alias]\n        ) {\n          context.env.vars.schema.optionalProperties[alias].metadata ??= {};\n          context.env.vars.schema.optionalProperties[alias].metadata.default =\n            value;\n        } else if (context.env.vars.schema.properties?.[alias]) {\n          context.env.vars.schema.properties[alias].metadata ??= {};\n          context.env.vars.schema.properties[alias].metadata.default = value;\n        }\n      }\n    }\n  }\n}\n\n/**\n * Reads the active environment variables and secrets from the plugin context's cache and stores them in the plugin context for use during the build process. This function should be called during the plugin's `buildStart` hook to ensure that the active environment variables and secrets are available before the build process begins.\n *\n * @param context - The plugin context\n * @returns A promise that resolves when the active environment variables and secrets have been read and stored in the plugin context.\n */\nexport async function readActiveEnv<TContext extends EnvPluginContext>(\n  context: TContext\n) {\n  context.env.vars.active ??= [];\n  if (\n    context.fs.existsSync(\n      joinPaths(getCacheDirectory(context), \"env\", \"vars.json\")\n    )\n  ) {\n    const content = await context.fs.read(\n      joinPaths(getCacheDirectory(context), \"env\", \"vars.json\")\n    );\n    if (content) {\n      context.env.vars.active = JSON.parse(content)?.elements ?? [];\n    }\n  }\n\n  context.env.secrets.active ??= [];\n  if (\n    context.fs.existsSync(\n      joinPaths(getCacheDirectory(context), \"env\", \"secrets.json\")\n    )\n  ) {\n    const content = await context.fs.read(\n      joinPaths(getCacheDirectory(context), \"env\", \"secrets.json\")\n    );\n    if (content) {\n      context.env.secrets.active = JSON.parse(content)?.elements ?? [];\n    }\n  }\n}\n\n/**\n * Writes the active environment variables and secrets from the plugin context to the plugin context's cache for use during the build process. This function should be called whenever the active environment variables and secrets are updated in the plugin context to ensure that the latest values are available during the build process.\n *\n * @param context - The plugin context\n * @returns A promise that resolves when the active environment variables and secrets have been written to the plugin context's cache.\n */\nexport async function writeActiveEnv<TContext extends EnvPluginContext>(\n  context: TContext\n) {\n  return Promise.all(\n    [\n      isSetArray(context.env.vars.active)\n        ? context.fs.write(\n            joinPaths(getCacheDirectory(context), \"env\", \"vars.json\"),\n            JSON.stringify({\n              elements: context.env.vars.active\n            })\n          )\n        : undefined,\n      isSetArray(context.env.secrets.active)\n        ? context.fs.write(\n            joinPaths(getCacheDirectory(context), \"env\", \"secrets.json\"),\n            JSON.stringify({\n              elements: context.env.secrets.active\n            })\n          )\n        : undefined\n    ].filter(Boolean) as Promise<void>[]\n  );\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -7,11 +7,11 @@ const require_helpers_automd_generator = require('./helpers/automd-generator.cjs
 const require_components_docs = require('./components/docs.cjs');
 const require_components_env_builtin = require('./components/env-builtin.cjs');
 const require_babel_plugin = require('./babel/plugin.cjs');
+let _stryke_path_join = require("@stryke/path/join");
 let defu = require("defu");
 defu = require_runtime.__toESM(defu);
 let powerlines_plugin_utils = require("powerlines/plugin-utils");
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
-let _stryke_path_join = require("@stryke/path/join");
 let _stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
 let _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
 let _powerlines_plugin_automd = require("@powerlines/plugin-automd");
@@ -128,7 +128,7 @@ exports.__ΩEnvPluginContext = require_types_plugin.__ΩEnvPluginContext;
 exports.__ΩEnvPluginOptions = require_types_plugin.__ΩEnvPluginOptions;
 exports.__ΩEnvPluginResolvedConfig = require_types_plugin.__ΩEnvPluginResolvedConfig;
 exports.__ΩEnvPluginUserConfig = require_types_plugin.__ΩEnvPluginUserConfig;
-exports.__ΩEnvSchemaMetadata = require_types_plugin.__ΩEnvSchemaMetadata;
+exports.__ΩEnvSchema = require_types_plugin.__ΩEnvSchema;
 exports.__ΩEnvType = require_types_plugin.__ΩEnvType;
 exports.__ΩSecretsInterface = require_types_env.__ΩSecretsInterface;
 exports.default = plugin;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType } from "./types/plugin.cjs";
+import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType } from "./types/plugin.cjs";
 import { EnvInterface, SecretsInterface } from "./types/env.cjs";
 import { Plugin } from "powerlines";
 
@@ -13,5 +13,5 @@ declare module "powerlines" {
  */
 declare const plugin: <TContext extends EnvPluginContext = EnvPluginContext>(options?: EnvPluginOptions) => Plugin<TContext>[];
 //#endregion
-export { EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType, SecretsInterface, plugin as default, plugin };
+export { EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType, SecretsInterface, plugin as default, plugin };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType } from "./types/plugin.mjs";
+import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType } from "./types/plugin.mjs";
 import { EnvInterface, SecretsInterface } from "./types/env.mjs";
 import { Plugin } from "powerlines";
 
@@ -13,5 +13,5 @@ declare module "powerlines" {
  */
 declare const plugin: <TContext extends EnvPluginContext = EnvPluginContext>(options?: EnvPluginOptions) => Plugin<TContext>[];
 //#endregion
-export { EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType, SecretsInterface, plugin as default, plugin };
+export { EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType, SecretsInterface, plugin as default, plugin };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,14 +1,14 @@
-import { __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchemaMetadata, __ΩEnvType } from "./types/plugin.mjs";
+import { __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchema, __ΩEnvType } from "./types/plugin.mjs";
 import { __ΩEnvInterface, __ΩSecretsInterface } from "./types/env.mjs";
 import { extractEnvSchema, getDefaultSecretsTypeDefinition, getDefaultVarsTypeDefinition } from "./helpers/schema.mjs";
 import { env } from "./helpers/automd-generator.mjs";
 import { EnvDocsFile } from "./components/docs.mjs";
 import { EnvBuiltin } from "./components/env-builtin.mjs";
 import { envBabelPlugin } from "./babel/plugin.mjs";
+import { joinPaths } from "@stryke/path/join";
 import defu from "defu";
 import { getDocsOutputPath } from "powerlines/plugin-utils";
 import { createComponent } from "@alloy-js/core/jsx-runtime";
-import { joinPaths } from "@stryke/path/join";
 import { getUnique } from "@stryke/helpers/get-unique";
 import { render } from "@powerlines/plugin-alloy/render";
 import automd from "@powerlines/plugin-automd";
@@ -118,5 +118,5 @@ const plugin = __assignType((options = {}) => {
 ]);
 
 //#endregion
-export { __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchemaMetadata, __ΩEnvType, __ΩSecretsInterface, plugin as default, plugin };
+export { __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchema, __ΩEnvType, __ΩSecretsInterface, plugin as default, plugin };
 //# sourceMappingURL=index.mjs.map

package/dist/types/index.cjs

@@ -7,6 +7,6 @@ exports.__ΩEnvPluginContext = require_types_plugin.__ΩEnvPluginContext;
 exports.__ΩEnvPluginOptions = require_types_plugin.__ΩEnvPluginOptions;
 exports.__ΩEnvPluginResolvedConfig = require_types_plugin.__ΩEnvPluginResolvedConfig;
 exports.__ΩEnvPluginUserConfig = require_types_plugin.__ΩEnvPluginUserConfig;
-exports.__ΩEnvSchemaMetadata = require_types_plugin.__ΩEnvSchemaMetadata;
+exports.__ΩEnvSchema = require_types_plugin.__ΩEnvSchema;
 exports.__ΩEnvType = require_types_plugin.__ΩEnvType;
 exports.__ΩSecretsInterface = require_types_env.__ΩSecretsInterface;

package/dist/types/index.d.cts

@@ -1,3 +1,3 @@
-import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType } from "./plugin.cjs";
+import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType } from "./plugin.cjs";
 import { EnvInterface, SecretsInterface } from "./env.cjs";
-export { EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType, SecretsInterface };
+export { EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType, SecretsInterface };

package/dist/types/index.d.mts

@@ -1,3 +1,3 @@
-import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType } from "./plugin.mjs";
+import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType } from "./plugin.mjs";
 import { EnvInterface, SecretsInterface } from "./env.mjs";
-export { EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType, SecretsInterface };
+export { EnvInterface, EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType, SecretsInterface };

package/dist/types/index.mjs

@@ -1,4 +1,4 @@
-import { __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchemaMetadata, __ΩEnvType } from "./plugin.mjs";
+import { __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchema, __ΩEnvType } from "./plugin.mjs";
 import { __ΩEnvInterface, __ΩSecretsInterface } from "./env.mjs";
 
-export { __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchemaMetadata, __ΩEnvType, __ΩSecretsInterface };
+export { __ΩEnvInterface, __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchema, __ΩEnvType, __ΩSecretsInterface };

package/dist/types/plugin.cjs

@@ -20,6 +20,11 @@ const __ΩPick = [
 	"Pick",
 	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
 ];
+const __ΩPartial = [
+	"T",
+	"Partial",
+	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
+];
 const __ΩExclude = [
 	"T",
 	"U",
@@ -76,17 +81,22 @@ const __ΩEnvPluginResolvedConfig = [
 	"EnvPluginResolvedConfig",
 	"P!PP!.#o\"#o!\"!P)4$?%)4&?'&F4(?)MK4*MKw+y"
 ];
-const __ΩEnvSchemaMetadata = [
+const __ΩEnvSchema = [
+	() => __ΩPartial,
+	"TMetadata",
 	"active",
 	"The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).",
-	"EnvSchemaMetadata",
-	"P!&F4!?\"Mw#y"
+	"The schema for the environment variables or secrets used by the project and expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true). This schema extends the base {@link ObjectSchema} with additional metadata specific to environment variables, including an `active` property that lists the environment variables or secrets that are currently active and should be injected during the build process.",
+	"EnvSchema",
+	"!o!\"c\"P!&F4#?$M?%w&y"
 ];
 const __ΩEnvPluginContext = [
 	() => __ΩEnvPluginResolvedConfig,
 	"TResolvedConfig",
+	() => __ΩEnvSchema,
 	"vars",
 	"The type definition for the expected env variable parameters",
+	() => __ΩEnvSchema,
 	"secrets",
 	"The type definition for the expected env secret parameters",
 	"parsed",
@@ -95,7 +105,7 @@ const __ΩEnvPluginContext = [
 	"The injected environment variables and secrets reflection",
 	"env",
 	"EnvPluginContext",
-	"n!c\"P!P!4#?$!4%?&!4'?(&F4)?*M4+Mw,y"
+	"n!c\"P!Pn#4$?%n&4'?(!4)?*&F4+?,M4-Mw.y"
 ];
 
 //#endregion
@@ -103,5 +113,5 @@ exports.__ΩEnvPluginContext = __ΩEnvPluginContext;
 exports.__ΩEnvPluginOptions = __ΩEnvPluginOptions;
 exports.__ΩEnvPluginResolvedConfig = __ΩEnvPluginResolvedConfig;
 exports.__ΩEnvPluginUserConfig = __ΩEnvPluginUserConfig;
-exports.__ΩEnvSchemaMetadata = __ΩEnvSchemaMetadata;
+exports.__ΩEnvSchema = __ΩEnvSchema;
 exports.__ΩEnvType = __ΩEnvType;

package/dist/types/plugin.d.cts

@@ -86,7 +86,10 @@ type EnvPluginResolvedConfig = BabelPluginResolvedConfig & {
     prefix: string[];
   };
 };
-interface EnvSchemaMetadata extends SchemaMetadata {
+/**
+ * The schema for the environment variables or secrets used by the project and expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true). This schema extends the base {@link ObjectSchema} with additional metadata specific to environment variables, including an `active` property that lists the environment variables or secrets that are currently active and should be injected during the build process.
+ */
+interface EnvSchema<TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>> extends ObjectSchema<TMetadata> {
   /**
    * The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).
    */
@@ -100,14 +103,14 @@ interface EnvPluginContext<TResolvedConfig extends EnvPluginResolvedConfig = Env
      * @remarks
      * This value is parsed from the {@link EnvPluginOptions.vars} option.
      */
-    vars: ObjectSchema<EnvSchemaMetadata>;
+    vars: EnvSchema;
     /**
      * The type definition for the expected env secret parameters
      *
      * @remarks
      * This value is parsed from the {@link EnvPluginOptions.secrets} option.
      */
-    secrets: ObjectSchema<EnvSchemaMetadata>;
+    secrets: EnvSchema;
     /**
      * The parsed .env configuration object
      *
@@ -125,5 +128,5 @@ interface EnvPluginContext<TResolvedConfig extends EnvPluginResolvedConfig = Env
   };
 }
 //#endregion
-export { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType };
+export { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType };
 //# sourceMappingURL=plugin.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;KAmCY,OAAA;AAAA,KAEA,gBAAA,GAAmB,IAAA,CAAK,mBAAA;EAFxB;;;EAMV,IAAA,GAAO,WAAA;EANU;AAEnB;;EASE,OAAA,GAAU,WAAA;EATwB;;;;;;EAiBlC,MAAA;EAsC4B;;;;;EA/B5B,MAAA;EAfA;;;;;EAsBA,QAAA;EAQgB;;;;;;EAAhB,aAAA,GAAgB,QAAA;EAmBN;;;;;;EAXV,KAAA,GAAQ,kBAAA;EAYa;AAAA;AAGvB;;;;EAPE,MAAA,GAAS,mBAAA;AAAA;AAAA,KAGC,mBAAA,GAAsB,qBAAA;EAChC,GAAA,EAAK,gBAAgB;AAAA;AAAA,KAGX,uBAAA,GAA0B,yBAAA;EACpC,GAAA,EAAK,QAAA,CAAS,IAAA,CAAK,mBAAA,wBACjB,YAAA,CAAa,gBAAA;IAFqB;;;;;;IAShC,MAAA;IAAA;;;;AAgBM;AAIZ;IAZM,QAAA;IAYqC;;AAInC;AAGR;;;IAXM,MAAA;EAAA;AAAA;AAAA,UAIW,iBAAA,SAA0B,cAAc;EAiB/C;;;EAbR,MAAM;AAAA;AAAA,UAGS,gBAAA,yBACS,uBAAA,GAA0B,uBAAA,UAC1C,kBAAA,CAAmB,eAAA;EAC3B,GAAA;IAFA;;;;;;IASE,IAAA,EAAM,YAAA,CAAa,iBAAA;IAAb;;;;;;IAQN,OAAA,EAAS,YAAA,CAAa,iBAAA;IAgBtB;;AAAQ;;;;IARR,MAAA,EAAQ,iBAAA;;;;;;;IAQR,QAAA;EAAA;AAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;KAmCY,OAAA;AAAA,KAEA,gBAAA,GAAmB,IAAA,CAAK,mBAAA;EAFxB;;;EAMV,IAAA,GAAO,WAAA;EANU;AAEnB;;EASE,OAAA,GAAU,WAAA;EATwB;;;;;;EAiBlC,MAAA;EAsC4B;;;;;EA/B5B,MAAA;EAfA;;;;;EAsBA,QAAA;EAQgB;;;;;;EAAhB,aAAA,GAAgB,QAAA;EAmBN;;;;;;EAXV,KAAA,GAAQ,kBAAA;EAYa;AAAA;AAGvB;;;;EAPE,MAAA,GAAS,mBAAA;AAAA;AAAA,KAGC,mBAAA,GAAsB,qBAAA;EAChC,GAAA,EAAK,gBAAgB;AAAA;AAAA,KAGX,uBAAA,GAA0B,yBAAA;EACpC,GAAA,EAAK,QAAA,CAAS,IAAA,CAAK,mBAAA,wBACjB,YAAA,CAAa,gBAAA;IAFqB;;;;;;IAShC,MAAA;IAAA;;;;AAgBM;AAOZ;IAfM,QAAA;IAeoB;;;;;;IAPpB,MAAA;EAAA;AAAA;;;;UAOW,SAAA,mBACG,OAAA,CAAQ,cAAA,IAAkB,OAAA,CAAQ,cAAA,WAC5C,YAAA,CAAa,SAAA;EAD+B;;;EAKpD,MAAA;AAAA;AAAA,UAGe,gBAAA,yBACS,uBAAA,GAA0B,uBAAA,UAC1C,kBAAA,CAAmB,eAAA;EAC3B,GAAA;IAH+B;;;;;;IAU7B,IAAA,EAAM,SAAA;IAgBE;;;;;;IARR,OAAA,EAAS,SAAA;IAhBH;;;;;;IAwBN,MAAA,EAAQ,iBAAA;IAAR;;;;AAQQ;;IAAR,QAAA;EAAA;AAAA"}

package/dist/types/plugin.d.mts

@@ -1,6 +1,6 @@
 import { DotenvParseOutput } from "@stryke/env/types";
-import { Children } from "@alloy-js/core";
 import { ObjectSchema, SchemaInput, SchemaMetadata } from "@powerlines/schema";
+import { Children } from "@alloy-js/core";
 import { AutoMDPluginOptions } from "@powerlines/plugin-automd/types/plugin";
 import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "@powerlines/plugin-babel/types";
 import { RequiredKeys } from "@stryke/types";
@@ -86,7 +86,10 @@ type EnvPluginResolvedConfig = BabelPluginResolvedConfig & {
     prefix: string[];
   };
 };
-interface EnvSchemaMetadata extends SchemaMetadata {
+/**
+ * The schema for the environment variables or secrets used by the project and expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true). This schema extends the base {@link ObjectSchema} with additional metadata specific to environment variables, including an `active` property that lists the environment variables or secrets that are currently active and should be injected during the build process.
+ */
+interface EnvSchema<TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>> extends ObjectSchema<TMetadata> {
   /**
    * The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).
    */
@@ -100,14 +103,14 @@ interface EnvPluginContext<TResolvedConfig extends EnvPluginResolvedConfig = Env
      * @remarks
      * This value is parsed from the {@link EnvPluginOptions.vars} option.
      */
-    vars: ObjectSchema<EnvSchemaMetadata>;
+    vars: EnvSchema;
     /**
      * The type definition for the expected env secret parameters
      *
      * @remarks
      * This value is parsed from the {@link EnvPluginOptions.secrets} option.
      */
-    secrets: ObjectSchema<EnvSchemaMetadata>;
+    secrets: EnvSchema;
     /**
      * The parsed .env configuration object
      *
@@ -125,5 +128,5 @@ interface EnvPluginContext<TResolvedConfig extends EnvPluginResolvedConfig = Env
   };
 }
 //#endregion
-export { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchemaMetadata, EnvType };
+export { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig, EnvSchema, EnvType };
 //# sourceMappingURL=plugin.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;KAmCY,OAAA;AAAA,KAEA,gBAAA,GAAmB,IAAA,CAAK,mBAAA;EAFxB;;;EAMV,IAAA,GAAO,WAAA;EANU;AAEnB;;EASE,OAAA,GAAU,WAAA;EATwB;;;;;;EAiBlC,MAAA;EAsC4B;;;;;EA/B5B,MAAA;EAfA;;;;;EAsBA,QAAA;EAQgB;;;;;;EAAhB,aAAA,GAAgB,QAAA;EAmBN;;;;;;EAXV,KAAA,GAAQ,kBAAA;EAYa;AAAA;AAGvB;;;;EAPE,MAAA,GAAS,mBAAA;AAAA;AAAA,KAGC,mBAAA,GAAsB,qBAAA;EAChC,GAAA,EAAK,gBAAgB;AAAA;AAAA,KAGX,uBAAA,GAA0B,yBAAA;EACpC,GAAA,EAAK,QAAA,CAAS,IAAA,CAAK,mBAAA,wBACjB,YAAA,CAAa,gBAAA;IAFqB;;;;;;IAShC,MAAA;IAAA;;;;AAgBM;AAIZ;IAZM,QAAA;IAYqC;;AAInC;AAGR;;;IAXM,MAAA;EAAA;AAAA;AAAA,UAIW,iBAAA,SAA0B,cAAc;EAiB/C;;;EAbR,MAAM;AAAA;AAAA,UAGS,gBAAA,yBACS,uBAAA,GAA0B,uBAAA,UAC1C,kBAAA,CAAmB,eAAA;EAC3B,GAAA;IAFA;;;;;;IASE,IAAA,EAAM,YAAA,CAAa,iBAAA;IAAb;;;;;;IAQN,OAAA,EAAS,YAAA,CAAa,iBAAA;IAgBtB;;AAAQ;;;;IARR,MAAA,EAAQ,iBAAA;;;;;;;IAQR,QAAA;EAAA;AAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;KAmCY,OAAA;AAAA,KAEA,gBAAA,GAAmB,IAAA,CAAK,mBAAA;EAFxB;;;EAMV,IAAA,GAAO,WAAA;EANU;AAEnB;;EASE,OAAA,GAAU,WAAA;EATwB;;;;;;EAiBlC,MAAA;EAsC4B;;;;;EA/B5B,MAAA;EAfA;;;;;EAsBA,QAAA;EAQgB;;;;;;EAAhB,aAAA,GAAgB,QAAA;EAmBN;;;;;;EAXV,KAAA,GAAQ,kBAAA;EAYa;AAAA;AAGvB;;;;EAPE,MAAA,GAAS,mBAAA;AAAA;AAAA,KAGC,mBAAA,GAAsB,qBAAA;EAChC,GAAA,EAAK,gBAAgB;AAAA;AAAA,KAGX,uBAAA,GAA0B,yBAAA;EACpC,GAAA,EAAK,QAAA,CAAS,IAAA,CAAK,mBAAA,wBACjB,YAAA,CAAa,gBAAA;IAFqB;;;;;;IAShC,MAAA;IAAA;;;;AAgBM;AAOZ;IAfM,QAAA;IAeoB;;;;;;IAPpB,MAAA;EAAA;AAAA;;;;UAOW,SAAA,mBACG,OAAA,CAAQ,cAAA,IAAkB,OAAA,CAAQ,cAAA,WAC5C,YAAA,CAAa,SAAA;EAD+B;;;EAKpD,MAAA;AAAA;AAAA,UAGe,gBAAA,yBACS,uBAAA,GAA0B,uBAAA,UAC1C,kBAAA,CAAmB,eAAA;EAC3B,GAAA;IAH+B;;;;;;IAU7B,IAAA,EAAM,SAAA;IAgBE;;;;;;IARR,OAAA,EAAS,SAAA;IAhBH;;;;;;IAwBN,MAAA,EAAQ,iBAAA;IAAR;;;;AAQQ;;IAAR,QAAA;EAAA;AAAA"}

package/dist/types/plugin.mjs

@@ -18,6 +18,11 @@ const __ΩPick = [
 	"Pick",
 	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
 ];
+const __ΩPartial = [
+	"T",
+	"Partial",
+	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
+];
 const __ΩExclude = [
 	"T",
 	"U",
@@ -74,17 +79,22 @@ const __ΩEnvPluginResolvedConfig = [
 	"EnvPluginResolvedConfig",
 	"P!PP!.#o\"#o!\"!P)4$?%)4&?'&F4(?)MK4*MKw+y"
 ];
-const __ΩEnvSchemaMetadata = [
+const __ΩEnvSchema = [
+	() => __ΩPartial,
+	"TMetadata",
 	"active",
 	"The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).",
-	"EnvSchemaMetadata",
-	"P!&F4!?\"Mw#y"
+	"The schema for the environment variables or secrets used by the project and expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true). This schema extends the base {@link ObjectSchema} with additional metadata specific to environment variables, including an `active` property that lists the environment variables or secrets that are currently active and should be injected during the build process.",
+	"EnvSchema",
+	"!o!\"c\"P!&F4#?$M?%w&y"
 ];
 const __ΩEnvPluginContext = [
 	() => __ΩEnvPluginResolvedConfig,
 	"TResolvedConfig",
+	() => __ΩEnvSchema,
 	"vars",
 	"The type definition for the expected env variable parameters",
+	() => __ΩEnvSchema,
 	"secrets",
 	"The type definition for the expected env secret parameters",
 	"parsed",
@@ -93,9 +103,9 @@ const __ΩEnvPluginContext = [
 	"The injected environment variables and secrets reflection",
 	"env",
 	"EnvPluginContext",
-	"n!c\"P!P!4#?$!4%?&!4'?(&F4)?*M4+Mw,y"
+	"n!c\"P!Pn#4$?%n&4'?(!4)?*&F4+?,M4-Mw.y"
 ];
 
 //#endregion
-export { __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchemaMetadata, __ΩEnvType };
+export { __ΩEnvPluginContext, __ΩEnvPluginOptions, __ΩEnvPluginResolvedConfig, __ΩEnvPluginUserConfig, __ΩEnvSchema, __ΩEnvType };
 //# sourceMappingURL=plugin.mjs.map

package/dist/types/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Children } from \"@alloy-js/core\";\nimport { AutoMDPluginOptions } from \"@powerlines/plugin-automd/types/plugin\";\nimport {\n  BabelPluginContext,\n  BabelPluginOptions,\n  BabelPluginResolvedConfig,\n  BabelPluginUserConfig\n} from \"@powerlines/plugin-babel/types\";\nimport type {\n  ObjectSchema,\n  SchemaInput,\n  SchemaMetadata\n} from \"@powerlines/schema\";\nimport type { DotenvParseOutput } from \"@stryke/env/types\";\nimport { RequiredKeys } from \"@stryke/types\";\nimport { DotenvConfiguration } from \"@stryke/types/configuration\";\n\nexport type EnvType = \"env\" | \"secrets\";\n\nexport type EnvPluginOptions = Omit<DotenvConfiguration, \"types\"> & {\n  /**\n   * A path to the type definition for the expected env configuration parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigConfiguration\"`.\n   */\n  vars?: SchemaInput;\n\n  /**\n   * A path to the type definition for the expected env secret parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigSecrets\"`.\n   */\n  secrets?: SchemaInput;\n\n  /**\n   * An additional prefix (or list of additional prefixes) to apply to the environment variables\n   *\n   * @remarks\n   * By default, the plugin will use the `POWERLINES_` prefix. This option is useful for avoiding conflicts with other environment variables.\n   */\n  prefix?: string | string[];\n\n  /**\n   * Should the plugin inject the env variables in the source code with their values?\n   *\n   * @defaultValue false\n   */\n  inject?: boolean;\n\n  /**\n   * Should the plugin validate the loaded environment variables against the provided type definitions?\n   *\n   * @defaultValue false\n   */\n  validate?: boolean;\n\n  /**\n   * The default configuration to use when loading environment variables.\n   *\n   * @remarks\n   * This configuration is used as the base configuration when loading environment variables, and will be overridden by any values found in the `.env` file or the process environment.\n   */\n  defaultConfig?: Children;\n\n  /**\n   * Babel configuration options to use when injecting environment variables into the source code.\n   *\n   * @remarks\n   * This option allows you to customize the Babel transformation process used to inject environment variables into the source code. If not provided, the plugin will use default Babel settings.\n   */\n  babel?: BabelPluginOptions;\n\n  /**\n   * AutoMD configuration options to allow injecting environment variables documentation into a markdown file such as a README.md.\n   *\n   * @remarks\n   * The README.md file should contain the `<!-- automd:env --><!-- /automd -->` comment block where the documentation will be injected.\n   */\n  automd?: AutoMDPluginOptions;\n};\n\nexport type EnvPluginUserConfig = BabelPluginUserConfig & {\n  env: EnvPluginOptions;\n};\n\nexport type EnvPluginResolvedConfig = BabelPluginResolvedConfig & {\n  env: Required<Pick<DotenvConfiguration, \"additionalFiles\">> &\n    RequiredKeys<EnvPluginOptions, \"vars\" | \"secrets\" | \"defaultConfig\"> & {\n      /**\n       * Should the plugin inject the env variables in the source code with their values?\n       *\n       * @remarks\n       * This value is the result of reflecting the {@link EnvPluginOptions.inject} option.\n       */\n      inject: boolean;\n\n      /**\n       * Should the plugin validate the loaded environment variables against the provided type definitions?\n       *\n       * @remarks\n       * This value is the result of reflecting the {@link EnvPluginOptions.validate} option.\n       */\n      validate: boolean;\n\n      /**\n       * The prefix used for environment variables\n       *\n       * @remarks\n       * This value is used to filter environment variables that are loaded from the .env file and the process environment.\n       */\n      prefix: string[];\n    };\n};\n\nexport interface EnvSchemaMetadata extends SchemaMetadata {\n  /**\n   * The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).\n   */\n  active: string[];\n}\n\nexport interface EnvPluginContext<\n  TResolvedConfig extends EnvPluginResolvedConfig = EnvPluginResolvedConfig\n> extends BabelPluginContext<TResolvedConfig> {\n  env: {\n    /**\n     * The type definition for the expected env variable parameters\n     *\n     * @remarks\n     * This value is parsed from the {@link EnvPluginOptions.vars} option.\n     */\n    vars: ObjectSchema<EnvSchemaMetadata>;\n\n    /**\n     * The type definition for the expected env secret parameters\n     *\n     * @remarks\n     * This value is parsed from the {@link EnvPluginOptions.secrets} option.\n     */\n    secrets: ObjectSchema<EnvSchemaMetadata>;\n\n    /**\n     * The parsed .env configuration object\n     *\n     * @remarks\n     * This value is the result of loading the .env configuration file found in the project root directory and merging it with the values provided at {@link EnvPluginOptions.values}\n     */\n    parsed: DotenvParseOutput;\n\n    /**\n     * The injected environment variables and secrets reflection\n     *\n     * @remarks\n     * This reflection contains the structure of the injected environment variables and secrets that were injected into the source code during the build process.\n     */\n    injected: string[];\n  };\n}\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAK;OAAW;OAAe;CAAY;CAAQ;AAAC;;;;;;AAErE,MAAM,UAAU;CAAC;CAAI;CAAM;CAAQ;AAAG;;;;;;;AAEtC,MAAM,aAAS;CAAA;CAAY;CAAW;CAAW;AAAU;AAE3D,MAAM,sBAAmB;OAAQ;CAAS;CAAK;CAAa;CAAO;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA;;;;;;;AAInE,MAAC,6BAAkC;OAAO;OAAmB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA;AAE7D,MAAC,uBAA0B;CAAA;CAAQ;CAAkB;CAAA;AAAA;AAErD,MAAM,sBAAqB;OAAQ;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Children } from \"@alloy-js/core\";\nimport { AutoMDPluginOptions } from \"@powerlines/plugin-automd/types/plugin\";\nimport {\n  BabelPluginContext,\n  BabelPluginOptions,\n  BabelPluginResolvedConfig,\n  BabelPluginUserConfig\n} from \"@powerlines/plugin-babel/types\";\nimport type {\n  ObjectSchema,\n  SchemaInput,\n  SchemaMetadata\n} from \"@powerlines/schema\";\nimport type { DotenvParseOutput } from \"@stryke/env/types\";\nimport { RequiredKeys } from \"@stryke/types\";\nimport { DotenvConfiguration } from \"@stryke/types/configuration\";\n\nexport type EnvType = \"env\" | \"secrets\";\n\nexport type EnvPluginOptions = Omit<DotenvConfiguration, \"types\"> & {\n  /**\n   * A path to the type definition for the expected env configuration parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigConfiguration\"`.\n   */\n  vars?: SchemaInput;\n\n  /**\n   * A path to the type definition for the expected env secret parameters. This value can include both a path to the typescript file and the name of the type definition to use separated by a `\":\"` or `\"#\"` character. For example: `\"./src/types/env.ts#ConfigSecrets\"`.\n   */\n  secrets?: SchemaInput;\n\n  /**\n   * An additional prefix (or list of additional prefixes) to apply to the environment variables\n   *\n   * @remarks\n   * By default, the plugin will use the `POWERLINES_` prefix. This option is useful for avoiding conflicts with other environment variables.\n   */\n  prefix?: string | string[];\n\n  /**\n   * Should the plugin inject the env variables in the source code with their values?\n   *\n   * @defaultValue false\n   */\n  inject?: boolean;\n\n  /**\n   * Should the plugin validate the loaded environment variables against the provided type definitions?\n   *\n   * @defaultValue false\n   */\n  validate?: boolean;\n\n  /**\n   * The default configuration to use when loading environment variables.\n   *\n   * @remarks\n   * This configuration is used as the base configuration when loading environment variables, and will be overridden by any values found in the `.env` file or the process environment.\n   */\n  defaultConfig?: Children;\n\n  /**\n   * Babel configuration options to use when injecting environment variables into the source code.\n   *\n   * @remarks\n   * This option allows you to customize the Babel transformation process used to inject environment variables into the source code. If not provided, the plugin will use default Babel settings.\n   */\n  babel?: BabelPluginOptions;\n\n  /**\n   * AutoMD configuration options to allow injecting environment variables documentation into a markdown file such as a README.md.\n   *\n   * @remarks\n   * The README.md file should contain the `<!-- automd:env --><!-- /automd -->` comment block where the documentation will be injected.\n   */\n  automd?: AutoMDPluginOptions;\n};\n\nexport type EnvPluginUserConfig = BabelPluginUserConfig & {\n  env: EnvPluginOptions;\n};\n\nexport type EnvPluginResolvedConfig = BabelPluginResolvedConfig & {\n  env: Required<Pick<DotenvConfiguration, \"additionalFiles\">> &\n    RequiredKeys<EnvPluginOptions, \"vars\" | \"secrets\" | \"defaultConfig\"> & {\n      /**\n       * Should the plugin inject the env variables in the source code with their values?\n       *\n       * @remarks\n       * This value is the result of reflecting the {@link EnvPluginOptions.inject} option.\n       */\n      inject: boolean;\n\n      /**\n       * Should the plugin validate the loaded environment variables against the provided type definitions?\n       *\n       * @remarks\n       * This value is the result of reflecting the {@link EnvPluginOptions.validate} option.\n       */\n      validate: boolean;\n\n      /**\n       * The prefix used for environment variables\n       *\n       * @remarks\n       * This value is used to filter environment variables that are loaded from the .env file and the process environment.\n       */\n      prefix: string[];\n    };\n};\n\n/**\n * The schema for the environment variables or secrets used by the project and expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true). This schema extends the base {@link ObjectSchema} with additional metadata specific to environment variables, including an `active` property that lists the environment variables or secrets that are currently active and should be injected during the build process.\n */\nexport interface EnvSchema<\n  TMetadata extends Partial<SchemaMetadata> = Partial<SchemaMetadata>\n> extends ObjectSchema<TMetadata> {\n  /**\n   * The active environment variables or secrets that are used by the project and are expected to be injected into the source code (if {@link EnvPluginOptions.inject} is true).\n   */\n  active: string[];\n}\n\nexport interface EnvPluginContext<\n  TResolvedConfig extends EnvPluginResolvedConfig = EnvPluginResolvedConfig\n> extends BabelPluginContext<TResolvedConfig> {\n  env: {\n    /**\n     * The type definition for the expected env variable parameters\n     *\n     * @remarks\n     * This value is parsed from the {@link EnvPluginOptions.vars} option.\n     */\n    vars: EnvSchema;\n\n    /**\n     * The type definition for the expected env secret parameters\n     *\n     * @remarks\n     * This value is parsed from the {@link EnvPluginOptions.secrets} option.\n     */\n    secrets: EnvSchema;\n\n    /**\n     * The parsed .env configuration object\n     *\n     * @remarks\n     * This value is the result of loading the .env configuration file found in the project root directory and merging it with the values provided at {@link EnvPluginOptions.values}\n     */\n    parsed: DotenvParseOutput;\n\n    /**\n     * The injected environment variables and secrets reflection\n     *\n     * @remarks\n     * This reflection contains the structure of the injected environment variables and secrets that were injected into the source code during the build process.\n     */\n    injected: string[];\n  };\n}\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAK;OAAW;OAAe;CAAY;CAAQ;AAAC;;;;;;AAErE,MAAM,UAAU;CAAC;CAAI;CAAM;CAAQ;AAAG;;;;;;AAEtC,MAAM,aAAS;CAAA;CAAS;CAAG;CAAY;AAAoB;AAC3D,MAAI,aAAc;CAAA;CAAM;CAAc;CAAW;AAAK;AAEtD,MAAK,sBAAuB;OAAG;CAAa;CAAK;CAAS;CAAmB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA;AAE7E,MAAC,yBAA0B;OAAQ;CAAc;CAAA;CAAA;AAAA;AAEjD,MAAC,6BAAkC;OAAK;OAAkB;CAAS;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-env",
-  "version": "0.16.237",
+  "version": "0.16.238",
   "private": false,
   "description": "A package containing a Powerlines plugin for injecting static .env configuration values to the code so that they're accessible at runtime.",
   "keywords": ["dotenv", "powerlines", "storm-software", "powerlines-plugin"],
@@ -108,11 +108,11 @@
     "@babel/core": "8.0.0-rc.5",
     "@babel/types": "8.0.0-rc.5",
     "@powerlines/core": "^0.15.22",
-    "@powerlines/plugin-alloy": "^0.26.129",
+    "@powerlines/plugin-alloy": "^0.26.130",
     "@powerlines/plugin-automd": "^0.1.506",
     "@powerlines/plugin-babel": "^0.13.41",
     "@powerlines/plugin-plugin": "^0.12.457",
-    "@powerlines/schema": "^0.11.24",
+    "@powerlines/schema": "^0.11.25",
     "@storm-software/config-tools": "^1.190.20",
     "@stryke/capnp": "^0.12.102",
     "@stryke/convert": "^0.7.7",
@@ -131,5 +131,5 @@
   },
   "devDependencies": { "@types/node": "^25.9.0", "vite": "^8.0.13" },
   "publishConfig": { "access": "public" },
-  "gitHead": "7fb37a42aa27f6cbc6b7412e259d0f7a79bac8ed"
+  "gitHead": "ff6d22768ebad99001bfa73846017aaa9c1b3dab"
 }