@powerlines/plugin-nodejs 0.1.0 → 0.1.2

package/dist/plugin-env/src/helpers/create-reflection-resource.mjs

@@ -0,0 +1,54 @@
+import { readEnvTypeReflection } from "./persistence.mjs";
+import { loadEnvFromContext } from "./load.mjs";
+import { titleCase } from "@stryke/string-format/title-case";
+import { ReflectionClass, ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { computed, createResource } from "@alloy-js/core";
+
+//#region ../plugin-env/src/helpers/create-reflection-resource.ts
+/**
+* Creates a reflection resource for the environment configuration.
+*
+* @param context - The environment plugin context.
+* @returns A resource that provides the reflection of the environment configuration.
+*/
+function createReflectionResource(context) {
+	const defaultValue = computed(() => context && loadEnvFromContext(context, process.env));
+	return createResource(async () => {
+		if (!context) return new ReflectionClass({
+			kind: ReflectionKind.objectLiteral,
+			description: `The initial environment configuration state for the Powerlines project.`,
+			types: []
+		});
+		const result = await readEnvTypeReflection(context, "env");
+		result.getProperties().forEach((prop) => {
+			prop.getAlias().filter(Boolean).forEach((alias) => {
+				result.addProperty({
+					name: alias,
+					optional: prop.isOptional() ? true : void 0,
+					readonly: prop.isReadonly() ? true : void 0,
+					description: prop.getDescription(),
+					visibility: prop.getVisibility(),
+					type: prop.getType(),
+					default: prop.getDefaultValue(),
+					tags: {
+						hidden: prop.isHidden(),
+						ignore: prop.isIgnored(),
+						internal: prop.isInternal(),
+						alias: prop.getAlias().filter((a) => a !== alias).concat(prop.name),
+						title: prop.getTitle() || titleCase(prop.name),
+						readonly: prop.isReadonly(),
+						permission: prop.getPermission(),
+						domain: prop.getDomain()
+					}
+				});
+			});
+		});
+		result.getProperties().forEach((prop) => {
+			prop.setDefaultValue(defaultValue.value?.[prop.getNameAsString()] ?? prop.getAlias().reduce((ret, alias) => ret ?? defaultValue.value?.[alias], void 0) ?? prop.getDefaultValue());
+		});
+		return result;
+	});
+}
+
+//#endregion
+export { createReflectionResource };

package/dist/plugin-env/src/helpers/index.cjs

@@ -0,0 +1,6 @@
+const require_reflect = require('./reflect.cjs');
+const require_persistence = require('./persistence.cjs');
+const require_source_file_env = require('./source-file-env.cjs');
+const require_load = require('./load.cjs');
+const require_create_reflection_resource = require('./create-reflection-resource.cjs');
+require('./template-helpers.cjs');

package/dist/plugin-env/src/helpers/index.mjs

@@ -0,0 +1,8 @@
+import { BaseEnv, BaseSecrets, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets } from "./reflect.mjs";
+import { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvTypeReflection } from "./persistence.mjs";
+import { removeEnvPrefix } from "./source-file-env.mjs";
+import { loadEnv, loadEnvFromContext } from "./load.mjs";
+import { createReflectionResource } from "./create-reflection-resource.mjs";
+import "./template-helpers.mjs";
+
+export {  };

package/dist/plugin-env/src/helpers/load.cjs

@@ -0,0 +1,83 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_source_file_env = require('./source-file-env.cjs');
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let __stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let c12 = require("c12");
+let __stryke_env_load_env = require("@stryke/env/load-env");
+
+//#region ../plugin-env/src/helpers/load.ts
+async function loadEnvFiles(options, mode, cwd) {
+	let env = await (0, __stryke_env_load_env.loadEnv)(cwd, mode);
+	if (options.additionalFiles && options.additionalFiles?.length > 0) {
+		const additionalEnvFiles = await Promise.all(options.additionalFiles.map(async (additionalEnvFile) => (0, __stryke_env_load_env.loadEnvFile)(additionalEnvFile, cwd)));
+		for (const additionalEnvFile of additionalEnvFiles) env = (0, defu.default)(additionalEnvFile, env);
+	}
+	return require_source_file_env.removeEnvPrefix(env);
+}
+async function loadEnvDirectory(options, directory, mode, cacheDir, packageJson, workspaceConfig) {
+	const [envResult, c12Result] = await Promise.all([loadEnvFiles(options, mode, directory), (0, c12.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: (0, __stryke_path_join_paths.joinPaths)(cacheDir, "jiti"),
+			moduleCache: true
+		}
+	})]);
+	return (0, defu.default)(envResult, c12Result.config, workspaceConfig);
+}
+/**
+* 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 (0, defu.default)({
+		APP_NAME: (0, __stryke_string_format_kebab_case.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: `${(0, __stryke_string_format_kebab_case.kebabCase)(context.config.name)}@${context.packageJson.version}`,
+		DEFAULT_LOCALE: context.workspaceConfig.locale,
+		DEFAULT_TIMEZONE: context.workspaceConfig.timezone,
+		LOG_LEVEL: context.config.logLevel,
+		ERROR_URL: context.workspaceConfig.error?.url,
+		ORGANIZATION: (0, __stryke_type_checks_is_set_string.isSetString)(context.workspaceConfig.organization) ? context.workspaceConfig.organization : context.workspaceConfig.organization?.name,
+		PLATFORM: context.config.build.platform,
+		MODE: context.workspaceConfig.mode,
+		DEBUG: context.workspaceConfig.mode === "development",
+		STACKTRACE: context.workspaceConfig.mode === "development",
+		ENVIRONMENT: context.environment
+	}, (0, __stryke_type_checks_is_set_object.isSetObject)(context?.env?.types?.env) ? context.env.types.env?.getProperties().reduce((ret, prop) => {
+		ret[prop.name] = parsed[prop.name] ?? prop.getDefaultValue();
+		return ret;
+	}, {}) : {});
+}
+async function loadEnv(context, options) {
+	const [project, workspace, config] = await Promise.all([
+		loadEnvDirectory(options, context.config.projectRoot, context.config.mode, context.cachePath, context.packageJson, context.workspaceConfig),
+		loadEnvDirectory(options, context.workspaceConfig.workspaceRoot, context.config.mode, context.cachePath, context.packageJson, context.workspaceConfig),
+		loadEnvDirectory(options, context.envPaths.config, context.config.mode, context.cachePath, context.packageJson, context.workspaceConfig)
+	]);
+	return (0, defu.default)(loadEnvFromContext(context, process.env), project, workspace, config);
+}
+
+//#endregion
+exports.loadEnv = loadEnv;
+exports.loadEnvFromContext = loadEnvFromContext;

package/dist/plugin-env/src/helpers/load.mjs

@@ -0,0 +1,80 @@
+import { removeEnvPrefix } from "./source-file-env.mjs";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import defu from "defu";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { kebabCase } from "@stryke/string-format/kebab-case";
+import { joinPaths } from "@stryke/path/join-paths";
+import { loadConfig } from "c12";
+import { loadEnv, loadEnvFile } from "@stryke/env/load-env";
+
+//#region ../plugin-env/src/helpers/load.ts
+async function loadEnvFiles(options, mode, cwd) {
+	let env = await loadEnv(cwd, mode);
+	if (options.additionalFiles && options.additionalFiles?.length > 0) {
+		const additionalEnvFiles = await Promise.all(options.additionalFiles.map(async (additionalEnvFile) => loadEnvFile(additionalEnvFile, cwd)));
+		for (const additionalEnvFile of additionalEnvFiles) env = defu(additionalEnvFile, env);
+	}
+	return removeEnvPrefix(env);
+}
+async function loadEnvDirectory(options, directory, mode, cacheDir, packageJson, workspaceConfig) {
+	const [envResult, c12Result] = await Promise.all([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);
+}
+/**
+* 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,
+		ERROR_URL: context.workspaceConfig.error?.url,
+		ORGANIZATION: isSetString(context.workspaceConfig.organization) ? context.workspaceConfig.organization : context.workspaceConfig.organization?.name,
+		PLATFORM: context.config.build.platform,
+		MODE: context.workspaceConfig.mode,
+		DEBUG: context.workspaceConfig.mode === "development",
+		STACKTRACE: context.workspaceConfig.mode === "development",
+		ENVIRONMENT: context.environment
+	}, isSetObject(context?.env?.types?.env) ? context.env.types.env?.getProperties().reduce((ret, prop) => {
+		ret[prop.name] = parsed[prop.name] ?? prop.getDefaultValue();
+		return ret;
+	}, {}) : {});
+}
+async function loadEnv$1(context, options) {
+	const [project, workspace, config] = await Promise.all([
+		loadEnvDirectory(options, context.config.projectRoot, context.config.mode, context.cachePath, context.packageJson, context.workspaceConfig),
+		loadEnvDirectory(options, context.workspaceConfig.workspaceRoot, context.config.mode, context.cachePath, context.packageJson, context.workspaceConfig),
+		loadEnvDirectory(options, context.envPaths.config, context.config.mode, context.cachePath, context.packageJson, context.workspaceConfig)
+	]);
+	return defu(loadEnvFromContext(context, process.env), project, workspace, config);
+}
+
+//#endregion
+export { loadEnv$1 as loadEnv, loadEnvFromContext };

package/dist/plugin-env/src/helpers/persistence.cjs

@@ -0,0 +1,199 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_capnp = require('../../../deepkit/src/capnp.cjs');
+const require_reflection = require('../../../deepkit/schemas/reflection2.cjs');
+const require_resolve_reflections = require('../../../deepkit/src/resolve-reflections.cjs');
+const require_reflect = require('./reflect.cjs');
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let __stryke_capnp = require("@stryke/capnp");
+__stryke_capnp = require_rolldown_runtime.__toESM(__stryke_capnp);
+let __stryke_fs_buffer = require("@stryke/fs/buffer");
+let node_fs = require("node:fs");
+let __stryke_type_checks_is_empty_object = require("@stryke/type-checks/is-empty-object");
+
+//#region ../plugin-env/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) {
+	return context.resolver.esmResolve("@powerlines/plugin-env/types/runtime");
+}
+/**
+* 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"
+	};
+}
+/** 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"
+	};
+}
+/**
+* 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)(require_resolve_reflections.getReflectionsPath(context), "env", `${name}-types.bin`);
+}
+/**
+* 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$1 = require_reflect.createEnvReflection(context);
+			const message = new __stryke_capnp.Message();
+			reflection$1.messageRoot = message.initRoot(require_reflection.SerializedTypes);
+			reflection$1.dataBuffer = message.toArrayBuffer();
+			context.env.types.env = reflection$1;
+			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(require_reflection.SerializedTypes);
+	const reflection = (0, __powerlines_deepkit_vendor_type.resolveClassType)((0, __powerlines_deepkit_vendor_type.deserializeType)(require_capnp.convertFromCapnp(messageRoot.types)));
+	context.env.types[name] = reflection;
+	context.env.types[name].messageRoot = messageRoot;
+	context.env.types[name].dataBuffer = buffer;
+	return reflection;
+}
+/**
+* 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();
+	require_capnp.convertToCapnp(serialized, message.initRoot(require_reflection.SerializedTypes)._initTypes(serialized.length));
+	await (0, __stryke_fs_buffer.writeFileBuffer)(getEnvTypeReflectionsPath(context, name), message.toArrayBuffer());
+}
+function getEnvReflectionsPath(context, name) {
+	return (0, __stryke_path_join_paths.joinPaths)(require_resolve_reflections.getReflectionsPath(context), "env", `${name}.bin`);
+}
+/**
+* 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$1 = require_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$1.name = "Env";
+			const message = new __stryke_capnp.Message();
+			reflection$1.messageRoot = message.initRoot(require_reflection.SerializedTypes);
+			reflection$1.dataBuffer = message.toArrayBuffer();
+			context.env.used.env = reflection$1;
+			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(require_reflection.SerializedTypes);
+	const reflection = (0, __powerlines_deepkit_vendor_type.resolveClassType)((0, __powerlines_deepkit_vendor_type.deserializeType)(require_capnp.convertFromCapnp(messageRoot.types)));
+	context.env.used.env = reflection;
+	context.env.used.env.messageRoot = messageRoot;
+	context.env.used.env.dataBuffer = buffer;
+	return reflection;
+}
+/**
+* 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$1 = require_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$1.name = "Secrets";
+			const message = new __stryke_capnp.Message();
+			reflection$1.messageRoot = message.initRoot(require_reflection.SerializedTypes);
+			reflection$1.dataBuffer = message.toArrayBuffer();
+			context.env.used.secrets = reflection$1;
+			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(require_reflection.SerializedTypes);
+	const reflection = (0, __powerlines_deepkit_vendor_type.resolveClassType)((0, __powerlines_deepkit_vendor_type.deserializeType)(require_capnp.convertFromCapnp(messageRoot.types)));
+	context.env.used.secrets = reflection;
+	context.env.used.secrets.messageRoot = messageRoot;
+	context.env.used.secrets.dataBuffer = buffer;
+	return reflection;
+}
+/**
+* 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();
+	require_capnp.convertToCapnp(serialized, message.initRoot(require_reflection.SerializedTypes)._initTypes(serialized.length));
+	await (0, __stryke_fs_buffer.writeFileBuffer)(getEnvReflectionsPath(context, name), message.toArrayBuffer());
+}
+
+//#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.writeEnvTypeReflection = writeEnvTypeReflection;

package/dist/plugin-env/src/helpers/persistence.mjs

@@ -0,0 +1,188 @@
+import { convertFromCapnp, convertToCapnp } from "../../../deepkit/src/capnp.mjs";
+import { SerializedTypes } from "../../../deepkit/schemas/reflection2.mjs";
+import { getReflectionsPath } from "../../../deepkit/src/resolve-reflections.mjs";
+import { createEnvReflection } from "./reflect.mjs";
+import { ReflectionKind, deserializeType, resolveClassType } from "@powerlines/deepkit/vendor/type";
+import { joinPaths } from "@stryke/path/join-paths";
+import * as capnp from "@stryke/capnp";
+import { readFileBuffer, writeFileBuffer } from "@stryke/fs/buffer";
+import { existsSync } from "node:fs";
+import { isEmptyObject } from "@stryke/type-checks/is-empty-object";
+
+//#region ../plugin-env/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) {
+	return context.resolver.esmResolve("@powerlines/plugin-env/types/runtime");
+}
+/**
+* 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"
+	};
+}
+/** 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"
+	};
+}
+/**
+* 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 joinPaths(getReflectionsPath(context), "env", `${name}-types.bin`);
+}
+/**
+* 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 (!existsSync(filePath)) {
+		if (!context.env.types.env || isEmptyObject(context.env.types.env)) {
+			const reflection$1 = createEnvReflection(context);
+			const message = new capnp.Message();
+			reflection$1.messageRoot = message.initRoot(SerializedTypes);
+			reflection$1.dataBuffer = message.toArrayBuffer();
+			context.env.types.env = reflection$1;
+			await writeEnvTypeReflection(context, context.env.types.env, name);
+		}
+		return context.env.types.env;
+	}
+	const buffer = await readFileBuffer(filePath);
+	const messageRoot = new capnp.Message(buffer, false).getRoot(SerializedTypes);
+	const reflection = resolveClassType(deserializeType(convertFromCapnp(messageRoot.types)));
+	context.env.types[name] = reflection;
+	context.env.types[name].messageRoot = messageRoot;
+	context.env.types[name].dataBuffer = buffer;
+	return reflection;
+}
+/**
+* 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 capnp.Message();
+	convertToCapnp(serialized, message.initRoot(SerializedTypes)._initTypes(serialized.length));
+	await writeFileBuffer(getEnvTypeReflectionsPath(context, name), message.toArrayBuffer());
+}
+function getEnvReflectionsPath(context, name) {
+	return joinPaths(getReflectionsPath(context), "env", `${name}.bin`);
+}
+/**
+* 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 (!existsSync(filePath)) {
+		if (!context.env.types.env) context.env.types.env = await readEnvTypeReflection(context, "env");
+		if (!context.env.used.env || isEmptyObject(context.env.used.env)) {
+			const reflection$1 = createEnvReflection(context, {
+				type: {
+					kind: 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$1.name = "Env";
+			const message = new capnp.Message();
+			reflection$1.messageRoot = message.initRoot(SerializedTypes);
+			reflection$1.dataBuffer = message.toArrayBuffer();
+			context.env.used.env = reflection$1;
+			await writeEnvReflection(context, context.env.used.env, "env");
+		}
+		return context.env.used.env;
+	}
+	const buffer = await readFileBuffer(filePath);
+	const messageRoot = new capnp.Message(buffer, false).getRoot(SerializedTypes);
+	const reflection = resolveClassType(deserializeType(convertFromCapnp(messageRoot.types)));
+	context.env.used.env = reflection;
+	context.env.used.env.messageRoot = messageRoot;
+	context.env.used.env.dataBuffer = buffer;
+	return reflection;
+}
+/**
+* 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 (!existsSync(filePath)) {
+		if (!context.env.types.secrets) context.env.types.secrets = await readEnvTypeReflection(context, "secrets");
+		if (!context.env.used.secrets || isEmptyObject(context.env.used.secrets)) {
+			const reflection$1 = createEnvReflection(context, {
+				type: {
+					kind: 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$1.name = "Secrets";
+			const message = new capnp.Message();
+			reflection$1.messageRoot = message.initRoot(SerializedTypes);
+			reflection$1.dataBuffer = message.toArrayBuffer();
+			context.env.used.secrets = reflection$1;
+			await writeEnvReflection(context, context.env.used.secrets, "secrets");
+		}
+		return context.env.used.secrets;
+	}
+	const buffer = await readFileBuffer(filePath);
+	const messageRoot = new capnp.Message(buffer, false).getRoot(SerializedTypes);
+	const reflection = resolveClassType(deserializeType(convertFromCapnp(messageRoot.types)));
+	context.env.used.secrets = reflection;
+	context.env.used.secrets.messageRoot = messageRoot;
+	context.env.used.secrets.dataBuffer = buffer;
+	return reflection;
+}
+/**
+* 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 capnp.Message();
+	convertToCapnp(serialized, message.initRoot(SerializedTypes)._initTypes(serialized.length));
+	await writeFileBuffer(getEnvReflectionsPath(context, name), message.toArrayBuffer());
+}
+
+//#endregion
+export { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvTypeReflection };