@powerlines/plugin-env 0.16.121 → 0.16.123

package/dist/components/env-builtin.mjs

@@ -1,3 +1,4 @@
+import { __ΩEnvPluginContext } from "../types/plugin.mjs";
 import { loadEnvFromContext } from "../helpers/load.mjs";
 import { titleCase } from "@stryke/string-format/title-case";
 import { ReflectionClass, ReflectionKind } from "@powerlines/deepkit/vendor/type";
@@ -6,24 +7,49 @@ import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/co
 import { For, Show, code, computed, splitProps } from "@alloy-js/core";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { ClassDeclaration, ClassMethod, ElseIfClause, FunctionDeclaration, IfStatement, NewExpression, TypeDeclaration, VarDeclaration } from "@alloy-js/typescript";
+import { ClassDeclaration, ClassMethod, ElseIfClause, FunctionDeclaration, IfStatement, InterfaceDeclaration, InterfaceMember, NewExpression, VarDeclaration } from "@alloy-js/typescript";
 import { refkey } from "@powerlines/plugin-alloy/helpers/refkey";
 import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
-import { InterfaceDeclaration } from "@powerlines/plugin-alloy/typescript/components/interface-declaration";
+import { InterfaceDeclaration as InterfaceDeclaration$1 } from "@powerlines/plugin-alloy/typescript/components/interface-declaration";
 import { ObjectDeclaration } from "@powerlines/plugin-alloy/typescript/components/object-declaration";
 import { TSDoc, TSDocExample, TSDocLink, TSDocParam, TSDocRemarks, TSDocReturns, TSDocThrows } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+import { TSDocReflectionProperty } from "@powerlines/plugin-alloy/typescript/components/tsdoc-reflection";
 import { getUnique } from "@stryke/helpers/get-unique";
 
 //#region src/components/env-builtin.tsx
+const __ΩOmit = [
+	"T",
+	"K",
+	() => __ΩPick,
+	() => __ΩExclude,
+	"Omit",
+	"b!b\"e!!e!!ge!\"o$#o##w%y"
+];
+const __ΩPick = [
+	"T",
+	"K",
+	"Pick",
+	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
+];
+const __ΩExclude = [
+	"T",
+	"U",
+	"Exclude",
+	"l6!Re$!RPe#!e$\"qk#%QRb!b\"Pde\"!p)w#y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
 /**
 * Generates the environment configuration typescript definition for the Powerlines project.
 */
 function EnvTypeDefinition(props) {
 	const [{ defaultValue, reflection }] = splitProps(props, ["defaultValue", "reflection"]);
-	const context = usePowerlines();
+	const context = (usePowerlines.Ω = [[() => __ΩEnvPluginContext, "n!"]], usePowerlines());
 	return [
-		createComponent(InterfaceDeclaration, {
-			name: " EnvBase",
+		createComponent(InterfaceDeclaration$1, {
+			name: "UnprefixedEnv",
 			defaultValue,
 			reflection,
 			"export": true
@@ -32,26 +58,104 @@ function EnvTypeDefinition(props) {
 		createComponent(TSDoc, {
 			heading: "The environment configuration object with prefixed keys.",
 			get children() {
-				return createComponent(TSDocRemarks, { children: `The \`Env\` type extends the \`EnvBase\` interface by including additional keys that are prefixed according to the project's configuration. This allows for flexibility in accessing environment variables with different naming conventions.` });
+				return createComponent(TSDocRemarks, { children: `The \`Env\` type extends the \`UnprefixedEnv\` interface by including additional keys that are prefixed according to the project's configuration. This allows for flexibility in accessing environment variables with different naming conventions.` });
 			}
 		}),
-		createComponent(TypeDeclaration, {
+		createComponent(InterfaceDeclaration, {
 			name: "Env",
 			"export": true,
+			"extends": "UnprefixedEnv",
 			get children() {
-				return code` {
-    [Key in keyof EnvBase as Key ${getUnique(context.config.env.prefix.map((prefix) => `| \`${prefix.replace(/_$/g, "")}_\${Key}\``)).join(" ")}]: EnvBase[Key];
-}
-`;
+				return createComponent(For, {
+					get each() {
+						return getUnique(context.config.env.prefix).map(__assignType((prefix) => prefix.replace(/_$/, ""), [
+							"prefix",
+							"",
+							"P\"2!\"/\""
+						]));
+					},
+					doubleHardline: true,
+					get children() {
+						return __assignType((prefix) => createComponent(For, {
+							get each() {
+								return reflection?.getProperties().filter(__assignType((property) => !property.isIgnored(), [
+									"property",
+									"",
+									"P\"2!\"/\""
+								])) ?? [];
+							},
+							doubleHardline: true,
+							get children() {
+								return __assignType((property) => [createComponent(TSDocReflectionProperty, { reflection: property }), createComponent(InterfaceMember, {
+									get name() {
+										return `${prefix}_${property.getNameAsString()}`;
+									},
+									get type() {
+										return `UnprefixedEnv["${property.getNameAsString()}"]`;
+									},
+									get readonly() {
+										return property.isReadonly();
+									}
+								})], [
+									"property",
+									"",
+									"P\"2!\"/\""
+								]);
+							}
+						}), [
+							"prefix",
+							"",
+							"P\"2!\"/\""
+						]);
+					}
+				});
 			}
 		}),
 		createComponent(Spacing, {})
 	];
 }
+EnvTypeDefinition.__type = [
+	() => __ΩOmit,
+	"name",
+	"props",
+	"EnvTypeDefinition",
+	"Generates the environment configuration typescript definition for the Powerlines project.",
+	"P!.\"o!#2#\"/$?%"
+];
+const __ΩConfigPropertyConditionalProps = [
+	() => __ΩEnvPluginContext,
+	"context",
+	"name",
+	"ConfigPropertyConditionalProps",
+	"P!n!4\"&4#Mw$y"
+];
 function ConfigPropertyConditional(props) {
 	const [{ context, name }] = splitProps(props, ["context", "name"]);
-	return code`propertyName === "${name}" || propertyName.replace(/^(${getUnique(context.config.env.prefix.sort((a, b) => a.startsWith(b) ? -1 : b.startsWith(a) ? 1 : a.localeCompare(b)).map((prefix) => `${prefix.replace(/_$/, "")}_`)).join("|")})/g, "").toLowerCase().replace(/[\\s\\-_]+/g, "") === "${name.toLowerCase().replace(/[\s\-_]+/g, "")}"`;
+	return code`propertyName === "${name}" || propertyName.replace(/^(${getUnique(context.config.env.prefix.sort(__assignType((a, b) => a.startsWith(b) ? -1 : b.startsWith(a) ? 1 : a.localeCompare(b), [
+		"a",
+		"b",
+		"",
+		"P\"2!\"2\"\"/#"
+	])).map(__assignType((prefix) => `${prefix.replace(/_$/, "")}_`, [
+		"prefix",
+		"",
+		"P\"2!\"/\""
+	]))).join("|")})/g, "").toLowerCase().replace(/[\\s\\-_]+/g, "") === "${name.toLowerCase().replace(/[\s\-_]+/g, "")}"`;
 }
+ConfigPropertyConditional.__type = [
+	() => __ΩConfigPropertyConditionalProps,
+	"props",
+	"ConfigPropertyConditional",
+	"Pn!2\"\"/#"
+];
+const __ΩConfigPropertyProps = [
+	"index",
+	() => __ΩEnvPluginContext,
+	"context",
+	"property",
+	"ConfigPropertyProps",
+	"P!'4!n\"4#!4$Mw%y"
+];
 function ConfigPropertyGet(props) {
 	const [{ context, property, index }] = splitProps(props, [
 		"context",
@@ -75,10 +179,16 @@ function ConfigPropertyGet(props) {
 							return property.getAlias();
 						},
 						joiner: code` || `,
-						children: (alias) => createComponent(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
+						get children() {
+							return __assignType((alias) => createComponent(ConfigPropertyConditional, {
+								name: alias,
+								context
+							}), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							]);
+						}
 					})];
 				}
 			})];
@@ -103,10 +213,16 @@ function ConfigPropertyGet(props) {
 							return property.getAlias();
 						},
 						joiner: code` || `,
-						children: (alias) => createComponent(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
+						get children() {
+							return __assignType((alias) => createComponent(ConfigPropertyConditional, {
+								name: alias,
+								context
+							}), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							]);
+						}
 					})];
 				}
 			})];
@@ -116,6 +232,12 @@ function ConfigPropertyGet(props) {
 		}
 	})];
 }
+ConfigPropertyGet.__type = [
+	() => __ΩConfigPropertyProps,
+	"props",
+	"ConfigPropertyGet",
+	"Pn!2\"\"/#"
+];
 function ConfigPropertySet(props) {
 	const [{ context, property, index }] = splitProps(props, [
 		"context",
@@ -139,10 +261,16 @@ function ConfigPropertySet(props) {
 							return property.getAlias();
 						},
 						joiner: code` || `,
-						children: (alias) => createComponent(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
+						get children() {
+							return __assignType((alias) => createComponent(ConfigPropertyConditional, {
+								name: alias,
+								context
+							}), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							]);
+						}
 					})];
 				}
 			})];
@@ -170,10 +298,16 @@ function ConfigPropertySet(props) {
 							return property.getAlias();
 						},
 						joiner: code` || `,
-						children: (alias) => createComponent(ConfigPropertyConditional, {
-							name: alias,
-							context
-						})
+						get children() {
+							return __assignType((alias) => createComponent(ConfigPropertyConditional, {
+								name: alias,
+								context
+							}), [
+								"alias",
+								"",
+								"P\"2!\"/\""
+							]);
+						}
 					})];
 				}
 			})];
@@ -186,6 +320,21 @@ function ConfigPropertySet(props) {
 		}
 	})];
 }
+ConfigPropertySet.__type = [
+	() => __ΩConfigPropertyProps,
+	"props",
+	"ConfigPropertySet",
+	"Pn!2\"\"/#"
+];
+const __ΩEnvBuiltinProps = [
+	() => __ΩOmit,
+	"id",
+	"Children",
+	"defaultConfig",
+	"reflection",
+	"EnvBuiltinProps",
+	"P!.\"o!#\"w#4$8!4%Mw&y"
+];
 const createEnvRefkey = refkey("createEnv");
 const envRefkey = refkey("env");
 const envSerializerRefkey = refkey("EnvSerializer");
@@ -198,7 +347,7 @@ function EnvBuiltin(props) {
 		"reflection",
 		"children"
 	]);
-	const context = usePowerlines();
+	const context = (usePowerlines.Ω = [[() => __ΩEnvPluginContext, "n!"]], usePowerlines());
 	const defaultValue = computed(() => context && loadEnvFromContext(context, process.env));
 	const envInstance = computed(() => {
 		const result = new ReflectionClass({
@@ -206,13 +355,39 @@ function EnvBuiltin(props) {
 			description: `The initial environment configuration state for the ${titleCase(context?.config?.name)} project.`,
 			types: []
 		}, reflection);
-		result.getProperties().filter((property) => property.isRuntime() || property.getTags().runtime === true).forEach((property) => {
+		result.getProperties().filter(__assignType((property) => property.isRuntime() || property.getTags().runtime === true, [
+			"property",
+			"",
+			"P\"2!\"/\""
+		])).forEach(__assignType((property) => {
 			result.removeProperty(property.getNameAsString());
-		});
+		}, [
+			"property",
+			"",
+			"P\"2!\"/\""
+		]));
 		return result;
 	});
-	const reflectionGetProperties = computed(() => reflection?.getProperties().filter((property) => !property.isIgnored()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
-	const reflectionSetProperties = computed(() => reflection?.getProperties().filter((property) => !property.isIgnored() && !property.isReadonly()).sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())) ?? []);
+	const reflectionGetProperties = computed(() => reflection?.getProperties().filter(__assignType((property) => !property.isIgnored(), [
+		"property",
+		"",
+		"P\"2!\"/\""
+	])).sort(__assignType((a, b) => a.getNameAsString().localeCompare(b.getNameAsString()), [
+		"a",
+		"b",
+		"",
+		"P\"2!\"2\"\"/#"
+	])) ?? []);
+	const reflectionSetProperties = computed(() => reflection?.getProperties().filter(__assignType((property) => !property.isIgnored() && !property.isReadonly(), [
+		"property",
+		"",
+		"P\"2!\"/\""
+	])).sort(__assignType((a, b) => a.getNameAsString().localeCompare(b.getNameAsString()), [
+		"a",
+		"b",
+		"",
+		"P\"2!\"2\"\"/#"
+	])) ?? []);
 	return createComponent(BuiltinFile, mergeProps({
 		id: "env",
 		description: "The environment configuration module provides an interface to define environment configuration parameters."
@@ -223,6 +398,7 @@ function EnvBuiltin(props) {
 				"deserializeFunction",
 				"ReflectionKind",
 				"Serializer",
+				"NamingStrategy",
 				"TemplateState",
 				"Type",
 				"TypeProperty",
@@ -248,7 +424,7 @@ function EnvBuiltin(props) {
 				}),
 				createComponent(ObjectDeclaration, {
 					name: "initialEnv",
-					type: "Partial<EnvBase>",
+					type: "Partial<Env>",
 					defaultValue,
 					reflection: envInstance,
 					"export": true,
@@ -290,6 +466,32 @@ function EnvBuiltin(props) {
 					}
 				}),
 				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					name: "envNamingStrategy",
+					"const": true,
+					doc: "The environment naming strategy for the runtime.",
+					get initializer() {
+						return code`new class extends NamingStrategy {
+                    constructor() {
+                        super("env");
+                    }
+
+                    getPropertyName(type: TypeProperty | TypePropertySignature, forSerializer: string): string | undefined {
+                      const name = super.getPropertyName(type, forSerializer);
+                      if (!name) {
+                        return name;
+                      }
+
+                      return name.replace(/^(${getUnique(context.config.env.prefix).map(__assignType((prefix) => prefix.replace(/_$/, ""), [
+							"prefix",
+							"",
+							"P\"2!\"/\""
+						])).join("|")})_/, "");
+                    }
+                  }; `;
+					}
+				}),
+				createComponent(Spacing, {}),
 				createComponent(TSDoc, {
 					heading: "A {@link EnvSerializer | environment configuration serializer} instance for the Powerlines application.",
 					get children() {
@@ -302,7 +504,6 @@ function EnvBuiltin(props) {
 				}),
 				createComponent(VarDeclaration, {
 					name: "envSerializer",
-					"export": false,
 					"const": true,
 					get initializer() {
 						return createComponent(NewExpression, {
@@ -312,21 +513,42 @@ function EnvBuiltin(props) {
 					}
 				}),
 				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					name: "_serializeEnv",
+					"const": true,
+					initializer: "serializeFunction<Env>(envSerializer, envNamingStrategy)"
+				}),
+				createComponent(Spacing, {}),
 				createComponent(TSDoc, {
 					heading: "Serialize a environment configuration object to JSON data objects (not a JSON string).",
 					get children() {
 						return [
 							createComponent(TSDocRemarks, { children: `The resulting JSON object can be stringified using \`JSON.stringify()\`.` }),
 							createComponent(TSDocExample, { children: `const json = serializeEnv(env);` }),
+							createComponent(Spacing, {}),
+							createComponent(TSDocParam, {
+								name: "input",
+								children: `The environment configuration object to serialize.`
+							}),
+							createComponent(TSDocReturns, { children: `The serialized environment configuration as JSON data objects.` }),
 							createComponent(TSDocThrows, { children: `ValidationError when serialization or validation fails.` })
 						];
 					}
 				}),
-				createComponent(VarDeclaration, {
+				createComponent(FunctionDeclaration, {
 					name: "serializeEnv",
 					"export": true,
+					parameters: [{
+						name: "input",
+						type: "Env"
+					}],
+					children: code` return _serializeEnv(input, { loosely: true }); `
+				}),
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					name: "_deserializeEnv",
 					"const": true,
-					initializer: "serializeFunction<EnvBase>(envSerializer)"
+					initializer: "deserializeFunction<Env>(envSerializer, envNamingStrategy)"
 				}),
 				createComponent(Spacing, {}),
 				createComponent(TSDoc, {
@@ -339,11 +561,14 @@ function EnvBuiltin(props) {
 						];
 					}
 				}),
-				createComponent(VarDeclaration, {
+				createComponent(FunctionDeclaration, {
 					name: "deserializeEnv",
 					"export": true,
-					"const": true,
-					initializer: "deserializeFunction<EnvBase>(envSerializer)"
+					parameters: [{
+						name: "input",
+						type: "Env"
+					}],
+					children: code` return _deserializeEnv(input, { loosely: true }); `
 				}),
 				createComponent(Spacing, {}),
 				createComponent(TSDoc, {
@@ -383,32 +608,46 @@ function EnvBuiltin(props) {
     deserializeEnv({
       ...initialEnv,
       ...environmentConfig
-    }) as Env,
+    } as Env),
     {
-      get: (target: EnvBase, propertyName: string) => { `,
+      get: (target: UnprefixedEnv, propertyName: string) => { `,
 									createIntrinsic("hbr", {}),
 									createComponent(For, {
 										each: reflectionGetProperties,
-										children: (property, index) => createComponent(ConfigPropertyGet, {
-											index,
-											context,
-											property
-										})
+										get children() {
+											return __assignType((property, index) => createComponent(ConfigPropertyGet, {
+												index,
+												context,
+												property
+											}), [
+												"property",
+												"index",
+												"",
+												"P!2!'2\"\"/#"
+											]);
+										}
 									}),
 									code`
             return undefined;
           }, `,
 									createComponent(Spacing, {}),
-									code` set: (target: EnvBase, propertyName: string, newValue: any) => { `,
+									code` set: (target: UnprefixedEnv, propertyName: string, newValue: any) => { `,
 									createIntrinsic("hbr", {}),
 									createComponent(For, {
 										each: reflectionSetProperties,
 										ender: code` else `,
-										children: (property, index) => createComponent(ConfigPropertySet, {
-											index,
-											context,
-											property
-										})
+										get children() {
+											return __assignType((property, index) => createComponent(ConfigPropertySet, {
+												index,
+												context,
+												property
+											}), [
+												"property",
+												"index",
+												"",
+												"P!2!'2\"\"/#"
+											]);
+										}
 									}),
 									createIntrinsic("hbr", {}),
 									code`return false;
@@ -497,8 +736,7 @@ function EnvBuiltin(props) {
           env.APPCENTER_BUILD_ID ||
           env.CI_XCODE_PROJECT ||
           env.XCS || false
-        );
-        `
+        ); `
 				}),
 				createComponent(Spacing, {}),
 				createComponent(TSDoc, {
@@ -560,7 +798,14 @@ function EnvBuiltin(props) {
 		}
 	}));
 }
+EnvBuiltin.__type = [
+	() => __ΩEnvBuiltinProps,
+	"props",
+	"EnvBuiltin",
+	"Generates the environment configuration module for the Powerlines project.",
+	"Pn!2\"\"/#?$"
+];
 
 //#endregion
-export { EnvBuiltin, EnvTypeDefinition };
+export { EnvBuiltin, EnvTypeDefinition, __ΩEnvBuiltinProps };
 //# sourceMappingURL=env-builtin.mjs.map