@powerlines/plugin-nodejs 0.1.115 → 0.1.117

package/dist/plugin-babel/src/index.mjs

@@ -0,0 +1,83 @@
+import { getPluginName, isDuplicatePlugin } from "./helpers/filters.mjs";
+import { resolveBabelPlugin, resolvePluginFunction } from "./helpers/options.mjs";
+import { createBabelPlugin } from "./helpers/create-plugin.mjs";
+import { addImport, addImportsToProgram } from "./helpers/module-helpers.mjs";
+import "./helpers/index.mjs";
+import { transformAsync } from "@babel/core";
+import { findFileExtension, findFileExtensionSafe } from "@stryke/path/file-path-fns";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import defu from "defu";
+
+//#region ../plugin-babel/src/index.ts
+/**
+* Babel plugin for Powerlines.
+*
+* @param options - The Babel plugin user configuration options.
+* @returns A Powerlines plugin that integrates Babel transformations.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "babel",
+		config() {
+			if (!isSetObject(options)) return;
+			return { transform: { babel: options } };
+		},
+		configResolved: {
+			order: "pre",
+			handler() {
+				this.config.transform.babel = defu(this.config.transform.babel ?? {}, {
+					plugins: [],
+					presets: []
+				});
+			}
+		},
+		async transform(code, id) {
+			if (isParentPath(id, this.powerlinesPath) || code.includes("/* @powerlines-ignore */") || code.includes("/* @powerlines-disable */")) {
+				this.trace(`Skipping Babel transformation for: ${id}`);
+				return {
+					code,
+					id
+				};
+			}
+			const plugins = this.config.transform.babel.plugins.map((plugin$1) => resolveBabelPlugin(this, code, id, plugin$1)).filter((plugin$1, _, arr) => plugin$1 && !isDuplicatePlugin(arr, plugin$1));
+			const presets = this.config.transform.babel.presets.map((preset) => resolveBabelPlugin(this, code, id, preset)).filter((preset, _, arr) => preset && !isDuplicatePlugin(arr, preset));
+			if (Array.isArray(plugins) && plugins.length === 0 && Array.isArray(presets) && presets.length === 0) return {
+				code,
+				id
+			};
+			if (/^(?:m|c)?tsx?$/.test(findFileExtensionSafe(id, { fullExtension: true })) && !isDuplicatePlugin(plugins, "@babel/plugin-syntax-typescript") && !isDuplicatePlugin(presets, "@babel/preset-typescript")) plugins.unshift(["@babel/plugin-syntax-typescript", { isTSX: findFileExtension(id) === "tsx" }]);
+			this.trace(`Running babel transformations with ${plugins.length} plugins and ${presets.length} presets for file: ${id}`);
+			const result = await transformAsync(code, {
+				highlightCode: true,
+				code: true,
+				ast: false,
+				cloneInputAst: false,
+				comments: true,
+				sourceType: "module",
+				configFile: false,
+				babelrc: false,
+				envName: this.config.mode,
+				caller: { name: this.config.framework },
+				...this.config.transform.babel ?? {},
+				filename: id,
+				plugins: plugins.map((plugin$1) => {
+					return Array.isArray(plugin$1) && plugin$1.length >= 2 ? [plugin$1[0], defu(plugin$1.length > 1 && plugin$1[1] ? plugin$1[1] : {}, { options })] : plugin$1;
+				}).filter(Boolean),
+				presets: presets.map((preset) => {
+					return Array.isArray(preset) && preset.length >= 2 ? [preset[0], defu(preset.length > 1 && preset[1] ? preset[1] : {}, { options })] : preset;
+				}).filter(Boolean)
+			});
+			if (!result?.code) throw new Error(`Powerlines - Babel plugin failed to compile ${id}`);
+			this.trace(`Completed babel transformations for file: ${id}`);
+			return {
+				code: result.code,
+				id
+			};
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+export { src_default as default };

package/dist/plugin-babel/src/types/index.d.mts

@@ -0,0 +1 @@
+import { BabelPluginContext, BabelPluginOptions, BabelPluginResolvedConfig, BabelPluginUserConfig } from "./plugin.mjs";

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

@@ -0,0 +1 @@
+const require_plugin = require('./plugin.cjs');

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

@@ -0,0 +1,3 @@
+import { envBabelPlugin } from "./plugin.mjs";
+
+export {  };

package/dist/plugin-env/src/babel/plugin.cjs

@@ -0,0 +1,70 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_create_plugin = require('../../../plugin-babel/src/helpers/create-plugin.cjs');
+const require_module_helpers = require('../../../plugin-babel/src/helpers/module-helpers.cjs');
+const require_utilities = require('../../../deepkit/src/utilities.cjs');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+
+//#region ../plugin-env/src/babel/plugin.ts
+const envBabelPlugin = require_create_plugin.createBabelPlugin("env", ({ log, context }) => {
+	function extractEnv(node, pass, isInjectable = false) {
+		const envTypesAliasProperties = context.env.types.env?.getProperties().filter((prop) => prop.getAlias().length > 0);
+		if (node.name) {
+			const prefix = context.config.env.prefix.find((pre) => node.name && node.name.startsWith(pre) && (context.env.types.env?.hasProperty(node.name.replace(`${pre}_`, "")) || envTypesAliasProperties.some((prop) => prop.getAlias().includes(node.name.replace(`${pre}_`, "")))));
+			let name = node.name;
+			if (prefix) name = node.name.replace(`${prefix}_`, "");
+			log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Environment variable ${name} found in ${pass.filename || "unknown file"}.`);
+			if (context.env.types.env?.hasProperty(name) || envTypesAliasProperties.some((prop) => prop.getAlias().includes(name))) {
+				const envProperty = context.env.types.env.hasProperty(name) ? context.env.types.env.getProperty(name) : envTypesAliasProperties.find((prop) => prop.getAlias().includes(name));
+				if (!envProperty || envProperty.isIgnored()) return;
+				if (!context.env.used.env.hasProperty(name)) {
+					log(__storm_software_config_tools_types.LogLevelLabel.DEBUG, `Adding "${name}" environment variables found in "${pass.filename || "unknown file"}" to used environment configuration reflection object.`);
+					context.env.used.env.addProperty(envProperty.property);
+				}
+				if (context.config.env.inject && isInjectable) {
+					let value = context.env.parsed?.[name];
+					if (value === void 0) {
+						const prefix$1 = context.config.env.prefix.find((pre) => {
+							return context.env.parsed[`${pre.replace(/_$/g, "")}_${name}`];
+						});
+						if (prefix$1) value = context.env.parsed[`${prefix$1.replace(/_$/g, "")}_${name}`];
+					}
+					value ??= envProperty.getDefaultValue();
+					if (envProperty.isValueRequired() && value === void 0) throw new Error(`Environment variable \`${name}\` is not defined in the .env configuration files`);
+					return require_utilities.stringifyDefaultValue(envProperty, value);
+				}
+			} else throw new Error(`The "${name}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${pass.filename ? pass.filename : "unknown"}.
+
+          The following environment configuration names are defined in the \`env\` type definition: \n${context.env.types.env?.getPropertyNames().sort((a, b) => String(a).localeCompare(String(b))).map((typeDef) => ` - ${String(typeDef)} ${envTypesAliasProperties.some((prop) => prop.getNameAsString() === String(typeDef) && prop.getAlias().length > 0) ? `(Alias: ${envTypesAliasProperties?.find((prop) => prop.getNameAsString() === String(typeDef))?.getAlias().join(", ")})` : ""}`).join("\n")} \n\nUsing the following env prefix: \n${context.config.env.prefix.map((prefix$1) => ` - ${prefix$1}`).join("\n")} \n\nPlease check your \`env\` configuration option. If you are using a custom dotenv type definition, please make sure that the configuration names match the ones in the code. \n\n`);
+		}
+	}
+	return { visitor: { MemberExpression(path, pass) {
+		if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isIdentifier({ name: "process" }) && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+			path.replaceWithSourceString(`env.${identifier.name}`);
+			require_module_helpers.addImport(path, {
+				module: `${context.config.framework || "powerlines"}:env`,
+				name: "env",
+				imported: "env"
+			});
+		} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isMetaProperty() && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+			path.replaceWithSourceString(`env.${identifier.name}`);
+			require_module_helpers.addImport(path, {
+				module: `${context.config.framework || "powerlines"}:env`,
+				name: "env",
+				imported: "env"
+			});
+		} else if (path.get("object")?.isIdentifier({ name: "env" }) && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+		}
+	} } };
+});
+
+//#endregion
+exports.envBabelPlugin = envBabelPlugin;

package/dist/plugin-env/src/babel/plugin.mjs

@@ -0,0 +1,69 @@
+import { createBabelPlugin } from "../../../plugin-babel/src/helpers/create-plugin.mjs";
+import { addImport } from "../../../plugin-babel/src/helpers/module-helpers.mjs";
+import { stringifyDefaultValue } from "../../../deepkit/src/utilities.mjs";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+
+//#region ../plugin-env/src/babel/plugin.ts
+const envBabelPlugin = createBabelPlugin("env", ({ log, context }) => {
+	function extractEnv(node, pass, isInjectable = false) {
+		const envTypesAliasProperties = context.env.types.env?.getProperties().filter((prop) => prop.getAlias().length > 0);
+		if (node.name) {
+			const prefix = context.config.env.prefix.find((pre) => node.name && node.name.startsWith(pre) && (context.env.types.env?.hasProperty(node.name.replace(`${pre}_`, "")) || envTypesAliasProperties.some((prop) => prop.getAlias().includes(node.name.replace(`${pre}_`, "")))));
+			let name = node.name;
+			if (prefix) name = node.name.replace(`${prefix}_`, "");
+			log(LogLevelLabel.TRACE, `Environment variable ${name} found in ${pass.filename || "unknown file"}.`);
+			if (context.env.types.env?.hasProperty(name) || envTypesAliasProperties.some((prop) => prop.getAlias().includes(name))) {
+				const envProperty = context.env.types.env.hasProperty(name) ? context.env.types.env.getProperty(name) : envTypesAliasProperties.find((prop) => prop.getAlias().includes(name));
+				if (!envProperty || envProperty.isIgnored()) return;
+				if (!context.env.used.env.hasProperty(name)) {
+					log(LogLevelLabel.DEBUG, `Adding "${name}" environment variables found in "${pass.filename || "unknown file"}" to used environment configuration reflection object.`);
+					context.env.used.env.addProperty(envProperty.property);
+				}
+				if (context.config.env.inject && isInjectable) {
+					let value = context.env.parsed?.[name];
+					if (value === void 0) {
+						const prefix$1 = context.config.env.prefix.find((pre) => {
+							return context.env.parsed[`${pre.replace(/_$/g, "")}_${name}`];
+						});
+						if (prefix$1) value = context.env.parsed[`${prefix$1.replace(/_$/g, "")}_${name}`];
+					}
+					value ??= envProperty.getDefaultValue();
+					if (envProperty.isValueRequired() && value === void 0) throw new Error(`Environment variable \`${name}\` is not defined in the .env configuration files`);
+					return stringifyDefaultValue(envProperty, value);
+				}
+			} else throw new Error(`The "${name}" environment variable is not defined in the \`env\` type definition, but is used in the source code file ${pass.filename ? pass.filename : "unknown"}.
+
+          The following environment configuration names are defined in the \`env\` type definition: \n${context.env.types.env?.getPropertyNames().sort((a, b) => String(a).localeCompare(String(b))).map((typeDef) => ` - ${String(typeDef)} ${envTypesAliasProperties.some((prop) => prop.getNameAsString() === String(typeDef) && prop.getAlias().length > 0) ? `(Alias: ${envTypesAliasProperties?.find((prop) => prop.getNameAsString() === String(typeDef))?.getAlias().join(", ")})` : ""}`).join("\n")} \n\nUsing the following env prefix: \n${context.config.env.prefix.map((prefix$1) => ` - ${prefix$1}`).join("\n")} \n\nPlease check your \`env\` configuration option. If you are using a custom dotenv type definition, please make sure that the configuration names match the ones in the code. \n\n`);
+		}
+	}
+	return { visitor: { MemberExpression(path, pass) {
+		if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isIdentifier({ name: "process" }) && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+			path.replaceWithSourceString(`env.${identifier.name}`);
+			addImport(path, {
+				module: `${context.config.framework || "powerlines"}:env`,
+				name: "env",
+				imported: "env"
+			});
+		} else if (path.get("object")?.get("property")?.isIdentifier({ name: "env" }) && path.get("object")?.get("object")?.isMetaProperty() && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+			path.replaceWithSourceString(`env.${identifier.name}`);
+			addImport(path, {
+				module: `${context.config.framework || "powerlines"}:env`,
+				name: "env",
+				imported: "env"
+			});
+		} else if (path.get("object")?.isIdentifier({ name: "env" }) && path.get("property")?.isIdentifier()) {
+			const identifier = path.get("property")?.node;
+			if (!identifier.name) return;
+			extractEnv(identifier, pass, false);
+		}
+	} } };
+});
+
+//#endregion
+export { envBabelPlugin };

package/dist/plugin-env/src/components/docs.cjs

@@ -0,0 +1,70 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_context = require('../../../plugin-alloy/src/core/contexts/context.cjs');
+const require_markdown_file = require('../../../plugin-alloy/src/markdown/components/markdown-file.cjs');
+const require_markdown_table = require('../../../plugin-alloy/src/markdown/components/markdown-table.cjs');
+const require_create_reflection_resource = require('../helpers/create-reflection-resource.cjs');
+const require_docs_helper = require('../helpers/docs-helper.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_path_join = require("@stryke/path/join");
+let __alloy_js_markdown = require("@alloy-js/markdown");
+
+//#region ../plugin-env/src/components/docs.tsx
+/**
+* Generates the environment configuration markdown documentation for the Powerlines project.
+*/
+function EnvDocsFile(props) {
+	const { levelOffset = 0, ...rest } = props;
+	const context = require_context.usePowerlinesSafe();
+	if (!context) return null;
+	const reflection = require_create_reflection_resource.createReflectionResource(context);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(require_markdown_file.MarkdownFile, (0, __alloy_js_core_jsx_runtime.mergeProps)({ get path() {
+		return (0, __stryke_path_join.joinPaths)(require_docs_helper.getDocsOutputPath(context), "env.md");
+	} }, rest, { get children() {
+		return [
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
+				level: 1 + levelOffset,
+				children: "Environment Configuration"
+			}),
+			__alloy_js_core.code`Below is a list of environment variables used by the`,
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+				get when() {
+					return !!context?.packageJson.name;
+				},
+				get children() {
+					return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Link, {
+						get href() {
+							return `https://www.npmjs.com/package/${context?.packageJson.name}`;
+						},
+						get title() {
+							return context.packageJson.name;
+						}
+					});
+				}
+			}),
+			__alloy_js_core.code`package. These values can be updated in the \`.env\` file in the root of the project.`,
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+			(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_markdown.Heading, {
+				level: 2 + levelOffset,
+				children: "Environment Variables"
+			}),
+			__alloy_js_core.code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
+			(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+			(0, __alloy_js_core_jsx_runtime.createComponent)(require_markdown_table.MarkdownTable, { get data() {
+				return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
+					return {
+						name: reflectionProperty.getNameAsString().trim(),
+						description: (reflectionProperty.getDescription() ?? "").trim(),
+						type: (0, __powerlines_deepkit_vendor_type.stringifyType)(reflectionProperty.getType()).trim().replaceAll(" | ", ", or "),
+						defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
+						required: reflectionProperty.isValueRequired() ? "" : "✔"
+					};
+				}) ?? [];
+			} })
+		];
+	} }));
+}
+
+//#endregion
+exports.EnvDocsFile = EnvDocsFile;

package/dist/plugin-env/src/components/docs.mjs

@@ -0,0 +1,69 @@
+import { usePowerlinesSafe } from "../../../plugin-alloy/src/core/contexts/context.mjs";
+import { MarkdownFile } from "../../../plugin-alloy/src/markdown/components/markdown-file.mjs";
+import { MarkdownTable } from "../../../plugin-alloy/src/markdown/components/markdown-table.mjs";
+import { createReflectionResource } from "../helpers/create-reflection-resource.mjs";
+import { getDocsOutputPath } from "../helpers/docs-helper.mjs";
+import { createComponent, createIntrinsic, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { stringifyType } from "@powerlines/deepkit/vendor/type";
+import { Show, code } from "@alloy-js/core";
+import { joinPaths } from "@stryke/path/join";
+import { Heading, Link } from "@alloy-js/markdown";
+
+//#region ../plugin-env/src/components/docs.tsx
+/**
+* Generates the environment configuration markdown documentation for the Powerlines project.
+*/
+function EnvDocsFile(props) {
+	const { levelOffset = 0, ...rest } = props;
+	const context = usePowerlinesSafe();
+	if (!context) return null;
+	const reflection = createReflectionResource(context);
+	return createComponent(MarkdownFile, mergeProps({ get path() {
+		return joinPaths(getDocsOutputPath(context), "env.md");
+	} }, rest, { get children() {
+		return [
+			createComponent(Heading, {
+				level: 1 + levelOffset,
+				children: "Environment Configuration"
+			}),
+			code`Below is a list of environment variables used by the`,
+			createComponent(Show, {
+				get when() {
+					return !!context?.packageJson.name;
+				},
+				get children() {
+					return createComponent(Link, {
+						get href() {
+							return `https://www.npmjs.com/package/${context?.packageJson.name}`;
+						},
+						get title() {
+							return context.packageJson.name;
+						}
+					});
+				}
+			}),
+			code`package. These values can be updated in the \`.env\` file in the root of the project.`,
+			createIntrinsic("hbr", {}),
+			createComponent(Heading, {
+				level: 2 + levelOffset,
+				children: "Environment Variables"
+			}),
+			code`The below list of environment variables are used as configuration parameters to drive the processing of the application. The data contained in these variables are **not** considered sensitive or confidential. Any values provided in these variables will be available in plain text to the public.`,
+			createIntrinsic("hbr", {}),
+			createComponent(MarkdownTable, { get data() {
+				return reflection.data?.getProperties().filter((property) => property.getNameAsString() !== "__STORM_INJECTED__").sort((a, b) => a.getNameAsString().localeCompare(b.getNameAsString())).map((reflectionProperty) => {
+					return {
+						name: reflectionProperty.getNameAsString().trim(),
+						description: (reflectionProperty.getDescription() ?? "").trim(),
+						type: stringifyType(reflectionProperty.getType()).trim().replaceAll(" | ", ", or "),
+						defaultValue: reflectionProperty.hasDefault() ? String(reflectionProperty.getDefaultValue())?.includes("\"") ? reflectionProperty.getDefaultValue() : `\`${reflectionProperty.getDefaultValue()}\`` : "",
+						required: reflectionProperty.isValueRequired() ? "" : "✔"
+					};
+				}) ?? [];
+			} })
+		];
+	} }));
+}
+
+//#endregion
+export { EnvDocsFile };