@powerlines/plugin-env 0.16.84 → 0.16.86

package/dist/helpers/load.mjs

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

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/constants\";\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.cjs

@@ -0,0 +1,323 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_types_plugin = require('../types/plugin.cjs');
+const require_helpers_reflect = require('./reflect.cjs');
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let powerlines = require("powerlines");
+let _powerlines_deepkit_capnp = require("@powerlines/deepkit/capnp");
+let _powerlines_deepkit_resolve_reflections = require("@powerlines/deepkit/resolve-reflections");
+let _powerlines_deepkit_schemas_reflection = require("@powerlines/deepkit/schemas/reflection");
+let _stryke_capnp = require("@stryke/capnp");
+_stryke_capnp = require_runtime.__toESM(_stryke_capnp);
+let _stryke_fs_buffer = require("@stryke/fs/buffer");
+let _stryke_path_join_paths = require("@stryke/path/join-paths");
+let _stryke_type_checks_is_empty_object = require("@stryke/type-checks/is-empty-object");
+let node_fs = require("node:fs");
+
+//#region src/helpers/persistence.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.
+*/
+async function resolveRuntimeTypeFile(context) {
+	const resolved = await context.fs.resolve("@powerlines/plugin-env/types/runtime");
+	if (!resolved) throw new Error(`Failed to resolve the runtime type definition file for the environment variables. Please ensure that the "@powerlines/plugin-env" package is installed.`);
+	return resolved;
+}
+resolveRuntimeTypeFile.__type = [
+	() => powerlines.__ΩUnresolvedContext,
+	() => require_types_plugin.__ΩEnvPluginResolvedConfig,
+	"context",
+	"resolveRuntimeTypeFile",
+	"Resolves the runtime type definition file for the environment variables.",
+	"Pn\"o!\"2#&`/$?%"
+];
+/**
+* Gets the default type definition for the environment variables.
+*
+* @param context - The plugin context.
+* @returns The default type definition for the environment variables.
+*/
+async function getEnvDefaultTypeDefinition(context) {
+	return {
+		file: await resolveRuntimeTypeFile(context),
+		name: "EnvInterface"
+	};
+}
+getEnvDefaultTypeDefinition.__type = [
+	() => powerlines.__ΩUnresolvedContext,
+	() => require_types_plugin.__ΩEnvPluginResolvedConfig,
+	"context",
+	"getEnvDefaultTypeDefinition",
+	"Gets the default type definition for the environment variables.",
+	"Pn\"o!\"2#!`/$?%"
+];
+/** Gets the default type definition for the environment secrets.
+*
+* @param context - The plugin context.
+* @returns The default type definition for the environment secrets.
+*/
+async function getSecretsDefaultTypeDefinition(context) {
+	return {
+		file: await resolveRuntimeTypeFile(context),
+		name: "SecretsInterface"
+	};
+}
+getSecretsDefaultTypeDefinition.__type = [
+	() => powerlines.__ΩUnresolvedContext,
+	() => require_types_plugin.__ΩEnvPluginResolvedConfig,
+	"context",
+	"getSecretsDefaultTypeDefinition",
+	"Pn\"o!\"2#!`/$"
+];
+/**
+* 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.
+*/
+function getEnvTypeReflectionsPath(context, name = "env") {
+	return (0, _stryke_path_join_paths.joinPaths)((0, _powerlines_deepkit_resolve_reflections.getReflectionsPath)(context), "env", `${name}-types.bin`);
+}
+getEnvTypeReflectionsPath.__type = [
+	() => powerlines.__ΩContext,
+	() => require_types_plugin.__ΩEnvPluginResolvedConfig,
+	"context",
+	() => require_types_plugin.__ΩEnvType,
+	"name",
+	() => "env",
+	"getEnvTypeReflectionsPath",
+	"Gets the path to the environment type reflections.",
+	"Pn\"o!\"2#n$2%>&&/'?("
+];
+/**
+* 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.
+*/
+async function readEnvTypeReflection(context, name = "env") {
+	const filePath = getEnvTypeReflectionsPath(context, name);
+	if (!(0, node_fs.existsSync)(filePath)) {
+		if (!context.env.types.env || (0, _stryke_type_checks_is_empty_object.isEmptyObject)(context.env.types.env)) {
+			const reflection = require_helpers_reflect.createEnvReflection(context);
+			const message = new _stryke_capnp.Message();
+			reflection.messageRoot = message.initRoot(_powerlines_deepkit_schemas_reflection.SerializedTypes);
+			reflection.dataBuffer = message.toArrayBuffer();
+			context.env.types.env = reflection;
+			await writeEnvTypeReflection(context, context.env.types.env, name);
+		}
+		return context.env.types.env;
+	}
+	const buffer = await (0, _stryke_fs_buffer.readFileBuffer)(filePath);
+	const messageRoot = new _stryke_capnp.Message(buffer, false).getRoot(_powerlines_deepkit_schemas_reflection.SerializedTypes);
+	const reflection = (0, _powerlines_deepkit_vendor_type.resolveClassType)((0, _powerlines_deepkit_vendor_type.deserializeType)((0, _powerlines_deepkit_capnp.convertFromCapnp)(messageRoot.types)));
+	context.env.types[name] = reflection;
+	context.env.types[name].messageRoot = messageRoot;
+	context.env.types[name].dataBuffer = buffer;
+	return reflection;
+}
+readEnvTypeReflection.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => require_types_plugin.__ΩEnvType,
+	"name",
+	() => "env",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"readEnvTypeReflection",
+	"Reads the environment type reflection from the file system.",
+	"Pn!2\"n#2$>%P\"7&`/'?("
+];
+/**
+* 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.
+*/
+async function writeEnvTypeReflection(context, reflection, name = "env") {
+	const serialized = reflection.serializeType();
+	const message = new _stryke_capnp.Message();
+	(0, _powerlines_deepkit_capnp.convertToCapnp)(serialized, message.initRoot(_powerlines_deepkit_schemas_reflection.SerializedTypes)._initTypes(serialized.length));
+	await (0, _stryke_fs_buffer.writeFileBuffer)(getEnvTypeReflectionsPath(context, name), message.toArrayBuffer());
+}
+writeEnvTypeReflection.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"reflection",
+	() => require_types_plugin.__ΩEnvType,
+	"name",
+	() => "env",
+	"writeEnvTypeReflection",
+	"Writes the environment type reflection to the file system.",
+	"Pn!2\"P\"7#2$n%2&>'\"/(?)"
+];
+function getEnvReflectionsPath(context, name) {
+	return (0, _stryke_path_join_paths.joinPaths)((0, _powerlines_deepkit_resolve_reflections.getReflectionsPath)(context), "env", `${name}.bin`);
+}
+getEnvReflectionsPath.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => require_types_plugin.__ΩEnvType,
+	"name",
+	"getEnvReflectionsPath",
+	"Pn!2\"n#2$&/%"
+];
+/**
+* Reads the environment reflection data from the file system.
+*
+* @param context - The plugin context.
+* @returns The environment reflection data.
+*/
+async function readEnvReflection(context) {
+	const filePath = getEnvReflectionsPath(context, "env");
+	if (!(0, node_fs.existsSync)(filePath)) {
+		if (!context.env.types.env) context.env.types.env = await readEnvTypeReflection(context, "env");
+		if (!context.env.used.env || (0, _stryke_type_checks_is_empty_object.isEmptyObject)(context.env.used.env)) {
+			const reflection = require_helpers_reflect.createEnvReflection(context, {
+				type: {
+					kind: _powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
+					typeName: "Env",
+					description: `An object containing the environment configuration parameters that are used (at least once) by the ${context.config.name ? `${context.config.name} application` : "application"}.`,
+					types: []
+				},
+				superReflection: context.env.types.env
+			});
+			reflection.name = "Env";
+			const message = new _stryke_capnp.Message();
+			reflection.messageRoot = message.initRoot(_powerlines_deepkit_schemas_reflection.SerializedTypes);
+			reflection.dataBuffer = message.toArrayBuffer();
+			context.env.used.env = reflection;
+			await writeEnvReflection(context, context.env.used.env, "env");
+		}
+		return context.env.used.env;
+	}
+	const buffer = await (0, _stryke_fs_buffer.readFileBuffer)(filePath);
+	const messageRoot = new _stryke_capnp.Message(buffer, false).getRoot(_powerlines_deepkit_schemas_reflection.SerializedTypes);
+	const reflection = (0, _powerlines_deepkit_vendor_type.resolveClassType)((0, _powerlines_deepkit_vendor_type.deserializeType)((0, _powerlines_deepkit_capnp.convertFromCapnp)(messageRoot.types)));
+	context.env.used.env = reflection;
+	context.env.used.env.messageRoot = messageRoot;
+	context.env.used.env.dataBuffer = buffer;
+	return reflection;
+}
+readEnvReflection.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"readEnvReflection",
+	"Reads the environment reflection data from the file system.",
+	"Pn!2\"P\"7#`/$?%"
+];
+/**
+* Reads the secret environment reflection data from the file system.
+*
+* @param context - The plugin context.
+* @returns The environment reflection data.
+*/
+async function readSecretsReflection(context) {
+	const filePath = getEnvReflectionsPath(context, "secrets");
+	if (!(0, node_fs.existsSync)(filePath)) {
+		if (!context.env.types.secrets) context.env.types.secrets = await readEnvTypeReflection(context, "secrets");
+		if (!context.env.used.secrets || (0, _stryke_type_checks_is_empty_object.isEmptyObject)(context.env.used.secrets)) {
+			const reflection = require_helpers_reflect.createEnvReflection(context, {
+				type: {
+					kind: _powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
+					typeName: "Secrets",
+					description: `An object containing the secret configuration parameters that are used (at least once) by the ${context.config.name ? `${context.config.name} application` : "application"}.`,
+					types: []
+				},
+				superReflection: context.env.types.secrets
+			});
+			reflection.name = "Secrets";
+			const message = new _stryke_capnp.Message();
+			reflection.messageRoot = message.initRoot(_powerlines_deepkit_schemas_reflection.SerializedTypes);
+			reflection.dataBuffer = message.toArrayBuffer();
+			context.env.used.secrets = reflection;
+			await writeEnvReflection(context, context.env.used.secrets, "secrets");
+		}
+		return context.env.used.secrets;
+	}
+	const buffer = await (0, _stryke_fs_buffer.readFileBuffer)(filePath);
+	const messageRoot = new _stryke_capnp.Message(buffer, false).getRoot(_powerlines_deepkit_schemas_reflection.SerializedTypes);
+	const reflection = (0, _powerlines_deepkit_vendor_type.resolveClassType)((0, _powerlines_deepkit_vendor_type.deserializeType)((0, _powerlines_deepkit_capnp.convertFromCapnp)(messageRoot.types)));
+	context.env.used.secrets = reflection;
+	context.env.used.secrets.messageRoot = messageRoot;
+	context.env.used.secrets.dataBuffer = buffer;
+	return reflection;
+}
+readSecretsReflection.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"readSecretsReflection",
+	"Reads the secret environment reflection data from the file system.",
+	"Pn!2\"P\"7#`/$?%"
+];
+/**
+* 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").
+*/
+async function writeEnvReflection(context, reflection, name = "env") {
+	const serialized = reflection.serializeType();
+	const message = new _stryke_capnp.Message();
+	(0, _powerlines_deepkit_capnp.convertToCapnp)(serialized, message.initRoot(_powerlines_deepkit_schemas_reflection.SerializedTypes)._initTypes(serialized.length));
+	await (0, _stryke_fs_buffer.writeFileBuffer)(getEnvReflectionsPath(context, name), message.toArrayBuffer());
+}
+writeEnvReflection.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"reflection",
+	() => require_types_plugin.__ΩEnvType,
+	"name",
+	() => "env",
+	"writeEnvReflection",
+	"Writes the environment reflection data to the file system.",
+	"Pn!2\"P\"7#2$n%2&>'\"/(?)"
+];
+/**
+* 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").
+*/
+function writeEnvReflectionSync(context, reflection, name = "env") {
+	const serialized = reflection.serializeType();
+	const message = new _stryke_capnp.Message();
+	(0, _powerlines_deepkit_capnp.convertToCapnp)(serialized, message.initRoot(_powerlines_deepkit_schemas_reflection.SerializedTypes)._initTypes(serialized.length));
+	(0, _stryke_fs_buffer.writeFileBufferSync)(getEnvReflectionsPath(context, name), message.toArrayBuffer());
+}
+writeEnvReflectionSync.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"reflection",
+	() => require_types_plugin.__ΩEnvType,
+	"name",
+	() => "env",
+	"writeEnvReflectionSync",
+	"Writes the environment reflection data to the file system.",
+	"Pn!2\"P\"7#2$n%2&>'\"/(?)"
+];
+
+//#endregion
+exports.getEnvDefaultTypeDefinition = getEnvDefaultTypeDefinition;
+exports.getEnvReflectionsPath = getEnvReflectionsPath;
+exports.getEnvTypeReflectionsPath = getEnvTypeReflectionsPath;
+exports.getSecretsDefaultTypeDefinition = getSecretsDefaultTypeDefinition;
+exports.readEnvReflection = readEnvReflection;
+exports.readEnvTypeReflection = readEnvTypeReflection;
+exports.readSecretsReflection = readSecretsReflection;
+exports.resolveRuntimeTypeFile = resolveRuntimeTypeFile;
+exports.writeEnvReflection = writeEnvReflection;
+exports.writeEnvReflectionSync = writeEnvReflectionSync;
+exports.writeEnvTypeReflection = writeEnvTypeReflection;

package/dist/helpers/persistence.d.cts

@@ -0,0 +1,84 @@
+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"],"mappings":";;;;;;;;AAoDA;;;;iBAAsB,sBAAA,CACpB,OAAA,EAAS,iBAAA,CAAkB,uBAAA,IAC1B,OAAA;;;;;;;iBAmBmB,2BAAA,CACpB,OAAA,EAAS,iBAAA,CAAkB,uBAAA,IAC1B,OAAA,CAAQ,cAAA;;;AAFX;;;iBAcsB,+BAAA,CACpB,OAAA,EAAS,iBAAA,CAAkB,uBAAA,IAC1B,OAAA,CAAQ,cAAA;;;;;;;;iBAcK,yBAAA,CACd,OAAA,EAAS,OAAA,CAAQ,uBAAA,GACjB,IAAA,GAAM,OAAA;;;;;AAlBR;;;iBA8BsB,qBAAA,CACpB,OAAA,EAAS,gBAAA,EACT,IAAA,GAAM,OAAA,GACL,OAAA,CAAQ,eAAA;;;;;;;;iBAuCW,sBAAA,CACpB,OAAA,EAAS,gBAAA,EACT,UAAA,EAAY,eAAA,OACZ,IAAA,GAAM,OAAA,GAAe,OAAA;AAAA,iBAeP,qBAAA,CACd,OAAA,EAAS,gBAAA,EACT,IAAA,EAAM,OAAA;;;;AA5ER;;;iBAuFsB,iBAAA,CACpB,OAAA,EAAS,gBAAA,GACR,OAAA,CAAQ,eAAA;;;;;;;iBAuDW,qBAAA,CACpB,OAAA,EAAS,gBAAA,GACR,OAAA,CAAQ,eAAA;;;;;AApIX;;;iBA+LsB,kBAAA,CACpB,OAAA,EAAS,gBAAA,EACT,UAAA,EAAY,eAAA,OACZ,IAAA,GAAM,OAAA,GAAe,OAAA;;;;;;;;iBAsBP,sBAAA,CACd,OAAA,EAAS,gBAAA,EACT,UAAA,EAAY,eAAA,OACZ,IAAA,GAAM,OAAA"}

package/dist/helpers/persistence.d.mts

@@ -0,0 +1,84 @@
+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"],"mappings":";;;;;;;;AAoDA;;;;iBAAsB,sBAAA,CACpB,OAAA,EAAS,iBAAA,CAAkB,uBAAA,IAC1B,OAAA;;;;;;;iBAmBmB,2BAAA,CACpB,OAAA,EAAS,iBAAA,CAAkB,uBAAA,IAC1B,OAAA,CAAQ,cAAA;;;AAFX;;;iBAcsB,+BAAA,CACpB,OAAA,EAAS,iBAAA,CAAkB,uBAAA,IAC1B,OAAA,CAAQ,cAAA;;;;;;;;iBAcK,yBAAA,CACd,OAAA,EAAS,OAAA,CAAQ,uBAAA,GACjB,IAAA,GAAM,OAAA;;;;;AAlBR;;;iBA8BsB,qBAAA,CACpB,OAAA,EAAS,gBAAA,EACT,IAAA,GAAM,OAAA,GACL,OAAA,CAAQ,eAAA;;;;;;;;iBAuCW,sBAAA,CACpB,OAAA,EAAS,gBAAA,EACT,UAAA,EAAY,eAAA,OACZ,IAAA,GAAM,OAAA,GAAe,OAAA;AAAA,iBAeP,qBAAA,CACd,OAAA,EAAS,gBAAA,EACT,IAAA,EAAM,OAAA;;;;AA5ER;;;iBAuFsB,iBAAA,CACpB,OAAA,EAAS,gBAAA,GACR,OAAA,CAAQ,eAAA;;;;;;;iBAuDW,qBAAA,CACpB,OAAA,EAAS,gBAAA,GACR,OAAA,CAAQ,eAAA;;;;;AApIX;;;iBA+LsB,kBAAA,CACpB,OAAA,EAAS,gBAAA,EACT,UAAA,EAAY,eAAA,OACZ,IAAA,GAAM,OAAA,GAAe,OAAA;;;;;;;;iBAsBP,sBAAA,CACd,OAAA,EAAS,gBAAA,EACT,UAAA,EAAY,eAAA,OACZ,IAAA,GAAM,OAAA"}