@powerlines/plugin-env 0.16.84 → 0.16.86

package/dist/helpers/persistence.mjs

@@ -0,0 +1,311 @@
+import { __ΩEnvPluginContext, __ΩEnvPluginResolvedConfig, __ΩEnvType } from "../types/plugin.mjs";
+import { createEnvReflection } from "./reflect.mjs";
+import { ReflectionClass, ReflectionKind, deserializeType, resolveClassType } from "@powerlines/deepkit/vendor/type";
+import { __ΩContext, __ΩUnresolvedContext } from "powerlines";
+import { convertFromCapnp, convertToCapnp } from "@powerlines/deepkit/capnp";
+import { getReflectionsPath } from "@powerlines/deepkit/resolve-reflections";
+import { SerializedTypes } from "@powerlines/deepkit/schemas/reflection";
+import * as capnp from "@stryke/capnp";
+import { readFileBuffer, writeFileBuffer, writeFileBufferSync } from "@stryke/fs/buffer";
+import { joinPaths } from "@stryke/path/join-paths";
+import { isEmptyObject } from "@stryke/type-checks/is-empty-object";
+import { existsSync } from "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 = [
+	() => __ΩUnresolvedContext,
+	() => __Ω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 = [
+	() => __ΩUnresolvedContext,
+	() => __Ω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 = [
+	() => __ΩUnresolvedContext,
+	() => __Ω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 joinPaths(getReflectionsPath(context), "env", `${name}-types.bin`);
+}
+getEnvTypeReflectionsPath.__type = [
+	() => __ΩContext,
+	() => __ΩEnvPluginResolvedConfig,
+	"context",
+	() => __Ω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 (!existsSync(filePath)) {
+		if (!context.env.types.env || isEmptyObject(context.env.types.env)) {
+			const reflection = createEnvReflection(context);
+			const message = new capnp.Message();
+			reflection.messageRoot = message.initRoot(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 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;
+}
+readEnvTypeReflection.__type = [
+	() => __ΩEnvPluginContext,
+	"context",
+	() => __ΩEnvType,
+	"name",
+	() => "env",
+	() => 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 capnp.Message();
+	convertToCapnp(serialized, message.initRoot(SerializedTypes)._initTypes(serialized.length));
+	await writeFileBuffer(getEnvTypeReflectionsPath(context, name), message.toArrayBuffer());
+}
+writeEnvTypeReflection.__type = [
+	() => __ΩEnvPluginContext,
+	"context",
+	() => ReflectionClass,
+	"reflection",
+	() => __Ω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 joinPaths(getReflectionsPath(context), "env", `${name}.bin`);
+}
+getEnvReflectionsPath.__type = [
+	() => __ΩEnvPluginContext,
+	"context",
+	() => __Ω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 (!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 = 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.name = "Env";
+			const message = new capnp.Message();
+			reflection.messageRoot = message.initRoot(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 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;
+}
+readEnvReflection.__type = [
+	() => __ΩEnvPluginContext,
+	"context",
+	() => 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 (!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 = 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.name = "Secrets";
+			const message = new capnp.Message();
+			reflection.messageRoot = message.initRoot(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 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;
+}
+readSecretsReflection.__type = [
+	() => __ΩEnvPluginContext,
+	"context",
+	() => 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 capnp.Message();
+	convertToCapnp(serialized, message.initRoot(SerializedTypes)._initTypes(serialized.length));
+	await writeFileBuffer(getEnvReflectionsPath(context, name), message.toArrayBuffer());
+}
+writeEnvReflection.__type = [
+	() => __ΩEnvPluginContext,
+	"context",
+	() => ReflectionClass,
+	"reflection",
+	() => __Ω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 capnp.Message();
+	convertToCapnp(serialized, message.initRoot(SerializedTypes)._initTypes(serialized.length));
+	writeFileBufferSync(getEnvReflectionsPath(context, name), message.toArrayBuffer());
+}
+writeEnvReflectionSync.__type = [
+	() => __ΩEnvPluginContext,
+	"context",
+	() => ReflectionClass,
+	"reflection",
+	() => __ΩEnvType,
+	"name",
+	() => "env",
+	"writeEnvReflectionSync",
+	"Writes the environment reflection data to the file system.",
+	"Pn!2\"P\"7#2$n%2&>'\"/(?)"
+];
+
+//#endregion
+export { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectionsPath, getSecretsDefaultTypeDefinition, readEnvReflection, readEnvTypeReflection, readSecretsReflection, resolveRuntimeTypeFile, writeEnvReflection, writeEnvReflectionSync, writeEnvTypeReflection };
+//# sourceMappingURL=persistence.mjs.map

package/dist/helpers/persistence.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.mjs","names":[],"sources":["../../src/helpers/persistence.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { convertFromCapnp, convertToCapnp } from \"@powerlines/deepkit/capnp\";\nimport { getReflectionsPath } from \"@powerlines/deepkit/resolve-reflections\";\nimport { SerializedTypes } from \"@powerlines/deepkit/schemas/reflection\";\nimport { Reflection } from \"@powerlines/deepkit/types\";\nimport {\n  deserializeType,\n  ReflectionClass,\n  ReflectionKind,\n  resolveClassType\n} from \"@powerlines/deepkit/vendor/type\";\nimport * as capnp from \"@stryke/capnp\";\nimport {\n  readFileBuffer,\n  writeFileBuffer,\n  writeFileBufferSync\n} from \"@stryke/fs/buffer\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { isEmptyObject } from \"@stryke/type-checks/is-empty-object\";\nimport type { TypeDefinition } from \"@stryke/types/configuration\";\nimport { existsSync } from \"node:fs\";\nimport { Context, UnresolvedContext } from \"powerlines\";\nimport {\n  EnvPluginContext,\n  EnvPluginResolvedConfig,\n  EnvType\n} from \"../types/plugin\";\nimport { createEnvReflection } from \"./reflect\";\n\n/**\n * Resolves the runtime type definition file for the environment variables.\n *\n * @param context - The plugin context.\n * @returns The runtime type definition file for the environment variables.\n */\nexport async function resolveRuntimeTypeFile(\n  context: UnresolvedContext<EnvPluginResolvedConfig>\n): Promise<string> {\n  const resolved = await context.fs.resolve(\n    \"@powerlines/plugin-env/types/runtime\"\n  );\n  if (!resolved) {\n    throw new Error(\n      `Failed to resolve the runtime type definition file for the environment variables. Please ensure that the \"@powerlines/plugin-env\" package is installed.`\n    );\n  }\n\n  return resolved;\n}\n\n/**\n * Gets the default type definition for the environment variables.\n *\n * @param context - The plugin context.\n * @returns The default type definition for the environment variables.\n */\nexport async function getEnvDefaultTypeDefinition(\n  context: UnresolvedContext<EnvPluginResolvedConfig>\n): Promise<TypeDefinition> {\n  return {\n    file: await resolveRuntimeTypeFile(context),\n    name: \"EnvInterface\"\n  };\n}\n\n/** Gets the default type definition for the environment secrets.\n *\n * @param context - The plugin context.\n * @returns The default type definition for the environment secrets.\n */\nexport async function getSecretsDefaultTypeDefinition(\n  context: UnresolvedContext<EnvPluginResolvedConfig>\n): Promise<TypeDefinition> {\n  return {\n    file: await resolveRuntimeTypeFile(context),\n    name: \"SecretsInterface\"\n  };\n}\n\n/**\n * Gets the path to the environment type reflections.\n *\n * @param context - The plugin context.\n * @param name - The name of the type reflections.\n * @returns The path to the environment type reflections.\n */\nexport function getEnvTypeReflectionsPath(\n  context: Context<EnvPluginResolvedConfig>,\n  name: EnvType = \"env\"\n): string {\n  return joinPaths(getReflectionsPath(context), \"env\", `${name}-types.bin`);\n}\n\n/**\n * Reads the environment type reflection from the file system.\n *\n * @param context - The plugin context.\n * @param name - The name of the type reflections.\n * @returns The environment type reflection.\n */\nexport async function readEnvTypeReflection(\n  context: EnvPluginContext,\n  name: EnvType = \"env\"\n): Promise<ReflectionClass<any>> {\n  const filePath = getEnvTypeReflectionsPath(context, name);\n  if (!existsSync(filePath)) {\n    if (!context.env.types.env || isEmptyObject(context.env.types.env)) {\n      const reflection = createEnvReflection(context) as Reflection;\n\n      const message = new capnp.Message();\n      reflection.messageRoot = message.initRoot(SerializedTypes);\n      reflection.dataBuffer = message.toArrayBuffer();\n\n      context.env.types.env = reflection;\n      await writeEnvTypeReflection(context, context.env.types.env, name);\n    }\n\n    return context.env.types.env;\n  }\n\n  const buffer = await readFileBuffer(filePath);\n  const message = new capnp.Message(buffer, false);\n  const messageRoot = message.getRoot(SerializedTypes);\n\n  const reflection = resolveClassType(\n    deserializeType(convertFromCapnp(messageRoot.types))\n  );\n\n  context.env.types[name] = reflection;\n  context.env.types[name].messageRoot = messageRoot;\n  context.env.types[name].dataBuffer = buffer;\n\n  return reflection;\n}\n\n/**\n * Writes the environment type reflection to the file system.\n *\n * @param context - The plugin context.\n * @param reflection - The environment type reflection to write.\n * @param name - The name of the type reflections.\n */\nexport async function writeEnvTypeReflection(\n  context: EnvPluginContext,\n  reflection: ReflectionClass<any>,\n  name: EnvType = \"env\"\n) {\n  const serialized = reflection.serializeType();\n\n  const message = new capnp.Message();\n  const root = message.initRoot(SerializedTypes);\n\n  convertToCapnp(serialized, root._initTypes(serialized.length));\n\n  await writeFileBuffer(\n    getEnvTypeReflectionsPath(context, name),\n    message.toArrayBuffer()\n  );\n}\n\nexport function getEnvReflectionsPath(\n  context: EnvPluginContext,\n  name: EnvType\n): string {\n  return joinPaths(getReflectionsPath(context), \"env\", `${name}.bin`);\n}\n\n/**\n * Reads the environment reflection data from the file system.\n *\n * @param context - The plugin context.\n * @returns The environment reflection data.\n */\nexport async function readEnvReflection(\n  context: EnvPluginContext\n): Promise<ReflectionClass<any>> {\n  const filePath = getEnvReflectionsPath(context, \"env\");\n  if (!existsSync(filePath)) {\n    if (!context.env.types.env) {\n      context.env.types.env = await readEnvTypeReflection(context, \"env\");\n    }\n\n    if (!context.env.used.env || isEmptyObject(context.env.used.env)) {\n      const reflection = createEnvReflection(context, {\n        type: {\n          kind: ReflectionKind.objectLiteral,\n          typeName: \"Env\",\n          description: `An object containing the environment configuration parameters that are used (at least once) by the ${\n            context.config.name\n              ? `${context.config.name} application`\n              : \"application\"\n          }.`,\n          types: []\n        },\n        superReflection: context.env.types.env\n      }) as Reflection;\n      reflection.name = \"Env\";\n\n      const message = new capnp.Message();\n      reflection.messageRoot = message.initRoot(SerializedTypes);\n      reflection.dataBuffer = message.toArrayBuffer();\n\n      context.env.used.env = reflection;\n      await writeEnvReflection(context, context.env.used.env, \"env\");\n    }\n\n    return context.env.used.env;\n  }\n\n  const buffer = await readFileBuffer(filePath);\n  const message = new capnp.Message(buffer, false);\n  const messageRoot = message.getRoot(SerializedTypes);\n\n  const reflection = resolveClassType(\n    deserializeType(convertFromCapnp(messageRoot.types))\n  );\n\n  context.env.used.env = reflection;\n  context.env.used.env.messageRoot = messageRoot;\n  context.env.used.env.dataBuffer = buffer;\n\n  return reflection;\n}\n\n/**\n * Reads the secret environment reflection data from the file system.\n *\n * @param context - The plugin context.\n * @returns The environment reflection data.\n */\nexport async function readSecretsReflection(\n  context: EnvPluginContext\n): Promise<ReflectionClass<any>> {\n  const filePath = getEnvReflectionsPath(context, \"secrets\");\n  if (!existsSync(filePath)) {\n    if (!context.env.types.secrets) {\n      context.env.types.secrets = await readEnvTypeReflection(\n        context,\n        \"secrets\"\n      );\n    }\n\n    if (!context.env.used.secrets || isEmptyObject(context.env.used.secrets)) {\n      const reflection = createEnvReflection(context, {\n        type: {\n          kind: ReflectionKind.objectLiteral,\n          typeName: \"Secrets\",\n          description: `An object containing the secret configuration parameters that are used (at least once) by the ${\n            context.config.name\n              ? `${context.config.name} application`\n              : \"application\"\n          }.`,\n          types: []\n        },\n        superReflection: context.env.types.secrets\n      }) as Reflection;\n      reflection.name = \"Secrets\";\n\n      const message = new capnp.Message();\n      reflection.messageRoot = message.initRoot(SerializedTypes);\n      reflection.dataBuffer = message.toArrayBuffer();\n\n      context.env.used.secrets = reflection;\n      await writeEnvReflection(context, context.env.used.secrets, \"secrets\");\n    }\n\n    return context.env.used.secrets;\n  }\n\n  const buffer = await readFileBuffer(filePath);\n  const message = new capnp.Message(buffer, false);\n  const messageRoot = message.getRoot(SerializedTypes);\n\n  const reflection = resolveClassType(\n    deserializeType(convertFromCapnp(messageRoot.types))\n  );\n\n  context.env.used.secrets = reflection;\n  context.env.used.secrets.messageRoot = messageRoot;\n  context.env.used.secrets.dataBuffer = buffer;\n\n  return reflection;\n}\n\n/**\n * Writes the environment reflection data to the file system.\n *\n * @param context - The plugin context.\n * @param reflection - The reflection data to write.\n * @param name - The name of the reflection (either \"env\" or \"secrets\").\n */\nexport async function writeEnvReflection(\n  context: EnvPluginContext,\n  reflection: ReflectionClass<any>,\n  name: EnvType = \"env\"\n) {\n  const serialized = reflection.serializeType();\n\n  const message = new capnp.Message();\n  const root = message.initRoot(SerializedTypes);\n\n  convertToCapnp(serialized, root._initTypes(serialized.length));\n\n  await writeFileBuffer(\n    getEnvReflectionsPath(context, name),\n    message.toArrayBuffer()\n  );\n}\n\n/**\n * Writes the environment reflection data to the file system.\n *\n * @param context - The plugin context.\n * @param reflection - The reflection data to write.\n * @param name - The name of the reflection (either \"env\" or \"secrets\").\n */\nexport function writeEnvReflectionSync(\n  context: EnvPluginContext,\n  reflection: ReflectionClass<any>,\n  name: EnvType = \"env\"\n) {\n  const serialized = reflection.serializeType();\n\n  const message = new capnp.Message();\n  const root = message.initRoot(SerializedTypes);\n\n  convertToCapnp(serialized, root._initTypes(serialized.length));\n\n  writeFileBufferSync(\n    getEnvReflectionsPath(context, name),\n    message.toArrayBuffer()\n  );\n}\n"],"mappings":"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"}

package/dist/helpers/reflect.cjs

@@ -0,0 +1,299 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_types_runtime = require('../types/runtime.cjs');
+const require_types_plugin = require('../types/plugin.cjs');
+const require_helpers_persistence = require('./persistence.cjs');
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
+let _stryke_path_join_paths = require("@stryke/path/join-paths");
+let _powerlines_deepkit_reflect_type = require("@powerlines/deepkit/reflect-type");
+let _stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
+
+//#region src/helpers/reflect.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+function mergeEnvReflections(context, reflections) {
+	return createEnvReflection(context, { type: (0, _powerlines_deepkit_vendor_type.merge)(reflections.map(__assignType((reflection) => reflection.type, [
+		"reflection",
+		"",
+		"P\"2!\"/\""
+	]))) });
+}
+mergeEnvReflections.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"reflections",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"mergeEnvReflections",
+	"Pn!2\"P\"7#F2$P\"7%/&"
+];
+function mergeSecretsReflections(context, reflections) {
+	return createSecretsReflection(context, { type: (0, _powerlines_deepkit_vendor_type.merge)(reflections.map(__assignType((reflection) => reflection.type, [
+		"reflection",
+		"",
+		"P\"2!\"/\""
+	]))) });
+}
+mergeSecretsReflections.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"reflections",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"mergeSecretsReflections",
+	"Pn!2\"P\"7#F2$P\"7%/&"
+];
+const __ΩCreateEnvReflectionOptions = [
+	() => _powerlines_deepkit_vendor_type.__ΩTypeObjectLiteral,
+	() => _powerlines_deepkit_vendor_type.__ΩTypeClass,
+	"type",
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"superReflection",
+	"CreateEnvReflectionOptions",
+	"PPn!n\"J4#8P\"7$4%8Mw&y"
+];
+var BaseEnv = class {
+	APP_NAME;
+	APP_VERSION;
+	BUILD_ID;
+	BUILD_TIMESTAMP;
+	BUILD_CHECKSUM;
+	RELEASE_ID;
+	RELEASE_TAG;
+	ORGANIZATION;
+	PLATFORM = "neutral";
+	MODE = "production";
+	ENVIRONMENT;
+	DEBUG = false;
+	TEST = false;
+	MINIMAL = false;
+	NO_COLOR = false;
+	FORCE_COLOR = false;
+	FORCE_HYPERLINK = false;
+	STACKTRACE = false;
+	INCLUDE_ERROR_DATA = false;
+	ERROR_URL;
+	DEFAULT_TIMEZONE;
+	DEFAULT_LOCALE;
+	CI = false;
+	static __type = [
+		"APP_NAME",
+		"APP_VERSION",
+		"BUILD_ID",
+		"BUILD_TIMESTAMP",
+		"BUILD_CHECKSUM",
+		"RELEASE_ID",
+		"RELEASE_TAG",
+		"ORGANIZATION",
+		"node",
+		"browser",
+		"neutral",
+		"PLATFORM",
+		function() {
+			return "neutral";
+		},
+		"development",
+		"test",
+		"production",
+		"MODE",
+		function() {
+			return "production";
+		},
+		"ENVIRONMENT",
+		"DEBUG",
+		function() {
+			return false;
+		},
+		"TEST",
+		function() {
+			return false;
+		},
+		"MINIMAL",
+		function() {
+			return false;
+		},
+		"NO_COLOR",
+		function() {
+			return false;
+		},
+		"FORCE_COLOR",
+		function() {
+			return false;
+		},
+		"FORCE_HYPERLINK",
+		function() {
+			return false;
+		},
+		"STACKTRACE",
+		function() {
+			return false;
+		},
+		"INCLUDE_ERROR_DATA",
+		function() {
+			return false;
+		},
+		"ERROR_URL",
+		"DEFAULT_TIMEZONE",
+		"DEFAULT_LOCALE",
+		"CI",
+		function() {
+			return false;
+		},
+		() => require_types_runtime.__ΩEnvInterface,
+		"BaseEnv",
+		"&3!&3\"&3#&3$&3%&3&&3'&3(P.).*.+J3,>-P.../.0J31>2&33)34>5)36>7)38>9)3:>;P')J3<>=P')J3>>?)3@>A)3B>C&3D&3E&3F)3G>H5nIx\"wJ"
+	];
+};
+var BaseSecrets = class {
+	ENCRYPTION_KEY;
+	static __type = [
+		"ENCRYPTION_KEY",
+		() => require_types_runtime.__ΩSecretsInterface,
+		"BaseSecrets",
+		"&3!5n\"x\"w#"
+	];
+};
+function createEnvReflection(context, options = {}) {
+	const parent = options.superReflection ?? new _powerlines_deepkit_vendor_type.ReflectionClass({
+		kind: _powerlines_deepkit_vendor_type.ReflectionKind.class,
+		description: `The base environment configuration definition for the ${(0, _stryke_string_format_title_case.titleCase)(context.config.name)} project.`,
+		classType: BaseEnv,
+		types: [],
+		implements: [{
+			kind: _powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
+			typeName: "EnvInterface",
+			description: `The environment configuration interface definition for the ${(0, _stryke_string_format_title_case.titleCase)(context.config.name)} project.`,
+			types: []
+		}]
+	});
+	parent.name = "Env";
+	const result = new _powerlines_deepkit_vendor_type.ReflectionClass(options.type ?? {
+		kind: _powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
+		typeName: "Env",
+		description: `A schema describing the list of available environment variables that can be used by the ${context.config.name ? `${(0, _stryke_string_format_title_case.titleCase)(context.config.name)} application` : "application"}.`,
+		types: []
+	}, parent);
+	result.name = "Env";
+	return result;
+}
+createEnvReflection.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => __ΩCreateEnvReflectionOptions,
+	"options",
+	() => ({}),
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"createEnvReflection",
+	"Pn!2\"n#2$>%P\"7&/'"
+];
+function createSecretsReflection(context, options = {}) {
+	const parent = options.superReflection ?? new _powerlines_deepkit_vendor_type.ReflectionClass({
+		kind: _powerlines_deepkit_vendor_type.ReflectionKind.class,
+		description: `The base secrets configuration definition for the ${(0, _stryke_string_format_title_case.titleCase)(context.config.name)} project.`,
+		classType: BaseSecrets,
+		types: [],
+		implements: [{
+			kind: _powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
+			typeName: "SecretsInterface",
+			description: `The secrets configuration interface definition for the ${(0, _stryke_string_format_title_case.titleCase)(context.config.name)} project.`,
+			types: []
+		}]
+	});
+	parent.name = "Secrets";
+	const result = new _powerlines_deepkit_vendor_type.ReflectionClass(options.type ?? {
+		kind: _powerlines_deepkit_vendor_type.ReflectionKind.objectLiteral,
+		typeName: "Secrets",
+		description: `A schema describing the list of available environment secrets that can be used by the ${context.config.name ? `${(0, _stryke_string_format_title_case.titleCase)(context.config.name)} application` : "application"}.`,
+		types: []
+	}, parent);
+	result.name = "Secrets";
+	return result;
+}
+createSecretsReflection.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	() => __ΩCreateEnvReflectionOptions,
+	"options",
+	() => ({}),
+	() => _powerlines_deepkit_vendor_type.ReflectionClass,
+	"createSecretsReflection",
+	"Pn!2\"n#2$>%P\"7&/'"
+];
+/**
+* Reflects the environment configuration type definition from the provided file and name, and merges it with the default environment configuration reflection and the currently used environment configuration reflection.
+*
+* @remarks
+* The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.
+*
+* @param context - The plugin context
+* @param file - The file path to reflect the environment configuration type definition from
+* @param name - The name of the type definition to reflect the environment configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.
+* @returns A reflection of the environment configuration type definition, merged with the default environment configuration reflection and the currently used environment configuration reflection. The resulting reflection will contain the structure of the expected environment variables as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default environment configuration reflection.
+*/
+async function reflectEnv(context, file, name) {
+	let config;
+	if (file) config = (0, _powerlines_deepkit_vendor_type.resolveClassType)(await (0, _powerlines_deepkit_reflect_type.reflectType)(context, {
+		file: !(0, _stryke_path_is_parent_path.isParentPath)(file, context.workspaceConfig.workspaceRoot) ? (0, _stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, file) : file,
+		name
+	}));
+	return mergeEnvReflections(context, [
+		await require_helpers_persistence.readEnvTypeReflection(context, "env"),
+		config,
+		(0, _powerlines_deepkit_vendor_type.resolveClassType)(await (0, _powerlines_deepkit_reflect_type.reflectType)(context, await require_helpers_persistence.getEnvDefaultTypeDefinition(context)))
+	].filter(Boolean));
+}
+reflectEnv.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	"file",
+	"name",
+	"reflectEnv",
+	"Reflects the environment configuration type definition from the provided file and name, and merges it with the default environment configuration reflection and the currently used environment configuration reflection.",
+	"Pn!2\"&2#8&2$8\"/%?&"
+];
+/**
+* Reflects the secrets configuration type definition from the provided file and name, and merges it with the default secrets configuration reflection and the currently used secrets configuration reflection.
+*
+* @remarks
+* The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.
+*
+* @param context - The plugin context
+* @param file - The file path to reflect the secrets configuration type definition from
+* @param name - The name of the type definition to reflect the secrets configuration from, if the file contains multiple type definitions. If not provided, the first type definition found in the file will be used.
+* @returns A reflection of the secrets configuration type definition, merged with the default secrets configuration reflection and the currently used secrets configuration reflection. The resulting reflection will contain the structure of the expected environment secrets as defined by the type definitions provided in the plugin configuration, as well as any additional properties that are currently used in the source code and defined in the default secrets configuration reflection.
+*/
+async function reflectSecrets(context, file, name) {
+	let config;
+	if (file) config = (0, _powerlines_deepkit_vendor_type.resolveClassType)(await (0, _powerlines_deepkit_reflect_type.reflectType)(context, {
+		file: !(0, _stryke_path_is_parent_path.isParentPath)(file, context.workspaceConfig.workspaceRoot) ? (0, _stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, file) : file,
+		name
+	}));
+	return mergeSecretsReflections(context, [
+		await require_helpers_persistence.readSecretsReflection(context),
+		config,
+		(0, _powerlines_deepkit_vendor_type.resolveClassType)(await (0, _powerlines_deepkit_reflect_type.reflectType)(context, await require_helpers_persistence.getSecretsDefaultTypeDefinition(context)))
+	].filter(Boolean));
+}
+reflectSecrets.__type = [
+	() => require_types_plugin.__ΩEnvPluginContext,
+	"context",
+	"file",
+	"name",
+	"reflectSecrets",
+	"Reflects the secrets configuration type definition from the provided file and name, and merges it with the default secrets configuration reflection and the currently used secrets configuration reflection.",
+	"Pn!2\"&2#8&2$8\"/%?&"
+];
+
+//#endregion
+exports.BaseEnv = BaseEnv;
+exports.BaseSecrets = BaseSecrets;
+exports.__ΩCreateEnvReflectionOptions = __ΩCreateEnvReflectionOptions;
+exports.createEnvReflection = createEnvReflection;
+exports.createSecretsReflection = createSecretsReflection;
+exports.mergeEnvReflections = mergeEnvReflections;
+exports.mergeSecretsReflections = mergeSecretsReflections;
+exports.reflectEnv = reflectEnv;
+exports.reflectSecrets = reflectSecrets;