@powerlines/plugin-crypto 0.10.673 → 0.10.675

package/dist/components/crypto-builtin.cjs

@@ -0,0 +1,258 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let _alloy_js_typescript = require("@alloy-js/typescript");
+let _power_plant_alloy_js_core_components_spacing = require("@power-plant/alloy-js/core/components/spacing");
+let _power_plant_alloy_js_typescript_components_tsdoc = require("@power-plant/alloy-js/typescript/components/tsdoc");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let _powerlines_plugin_alloy_typescript_components_builtin_file = require("@powerlines/plugin-alloy/typescript/components/builtin-file");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu, 1);
+
+//#region src/components/crypto-builtin.tsx
+/**
+* Generates the cryptography builtin module for the Powerlines project.
+*/
+function CryptoBuiltin(props) {
+	const [{ children, imports }, rest] = (0, _alloy_js_core.splitProps)(props, ["children", "imports"]);
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	const encryptionKey = context.config.crypto.encryptionKey;
+	const salt = context.config.crypto.salt;
+	const saltHex = salt || "nonce";
+	const hashKeyExpr = salt ? `hexToBytes("${salt}")` : `new TextEncoder().encode("powerlines")`;
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_builtin_file.BuiltinFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({
+		id: "crypto",
+		description: "The cryptography module provides custom helper functions to support encrypting and decrypting data."
+	}, rest, {
+		get imports() {
+			return (0, defu.default)({
+				"@noble/ciphers/chacha.js": [{ name: "xchacha20poly1305" }, { name: "chacha20poly1305" }],
+				"@noble/ciphers/utils.js": [{ name: "randomBytes" }, { name: "hexToBytes" }],
+				"@noble/hashes/scrypt.js": [{ name: "scrypt" }],
+				"@noble/hashes/blake3.js": [{ name: "blake3" }]
+			}, imports ?? {});
+		},
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+					get when() {
+						return Boolean(encryptionKey);
+					},
+					get children() {
+						return [
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+								"const": true,
+								name: "nonce",
+								initializer: _alloy_js_core.code`randomBytes(24)`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+								"const": true,
+								name: "chacha",
+								initializer: _alloy_js_core.code`xchacha20poly1305(hexToBytes("${encryptionKey}"), nonce)`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDoc, {
+								heading: "Symmetrically encrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher.",
+								get children() {
+									return [
+										(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocLink, { children: `https://en.wikipedia.org/wiki/ChaCha20-Poly1305` }),
+										(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocParam, {
+											name: "plaintext",
+											children: `The data to encrypt.`
+										}),
+										(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocReturns, { children: `The encrypted data.` })
+									];
+								}
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+								name: "encrypt",
+								"export": true,
+								parameters: [{
+									name: "plaintext",
+									type: "string"
+								}],
+								returnType: "string",
+								children: _alloy_js_core.code`return chacha.encrypt(
+    nonce,
+    new TextEncoder().encode(plaintext),
+    null
+  );`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDoc, {
+								heading: "Symmetrically decrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher.",
+								get children() {
+									return [
+										(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocLink, { children: `https://en.wikipedia.org/wiki/ChaCha20-Poly1305` }),
+										(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocParam, {
+											name: "encrypted",
+											children: `The encrypted data to decrypt.`
+										}),
+										(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocReturns, { children: `The decrypted data.` })
+									];
+								}
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+								name: "decrypt",
+								"export": true,
+								parameters: [{
+									name: "encrypted",
+									type: "string"
+								}],
+								returnType: "string",
+								children: _alloy_js_core.code`const decrypted = chacha.decrypt(
+    nonce,
+    encrypted,
+    null
+  );
+
+  return new TextDecoder().decode(decrypted);`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {})
+						];
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDoc, {
+					heading: "Symmetrically encrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher with a password.",
+					get children() {
+						return [
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocLink, { children: `https://en.wikipedia.org/wiki/ChaCha20-Poly1305` }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocParam, {
+								name: "password",
+								children: `The password used to derive the encryption key.`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocParam, {
+								name: "plaintext",
+								children: `The data to encrypt.`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocReturns, { children: `The encrypted data.` })
+						];
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "encryptWithPassword",
+					"export": true,
+					parameters: [{
+						name: "password",
+						type: "string"
+					}, {
+						name: "plaintext",
+						type: "string"
+					}],
+					returnType: "string",
+					children: _alloy_js_core.code`const key = scrypt(
+    new TextEncoder().encode(password),
+    hexToBytes("${saltHex}"),
+    1048576, // requires 1GB of RAM to calculate
+    8,
+    1,
+    32
+  );
+
+  return chacha20poly1305(key).encrypt(
+    nonce,
+    new TextEncoder().encode(plaintext),
+    null
+  );`
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDoc, {
+					heading: "Symmetrically decrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher with a password.",
+					get children() {
+						return [
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocLink, { children: `https://en.wikipedia.org/wiki/ChaCha20-Poly1305` }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocParam, {
+								name: "password",
+								children: `The password used to derive the decryption key.`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocParam, {
+								name: "encrypted",
+								children: `The encrypted data to decrypt.`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocReturns, { children: `The decrypted data.` })
+						];
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "decryptWithPassword",
+					"export": true,
+					parameters: [{
+						name: "password",
+						type: "string"
+					}, {
+						name: "encrypted",
+						type: "string"
+					}],
+					returnType: "string",
+					children: _alloy_js_core.code`const key = scrypt(
+    new TextEncoder().encode(password),
+    hexToBytes("${saltHex}"),
+    1048576, // requires 1GB of RAM to calculate
+    8,
+    1,
+    32
+  );
+
+  const decrypted = chacha20poly1305(key).decrypt(
+    nonce,
+    encrypted,
+    null
+  );
+
+  return new TextDecoder().decode(decrypted);`
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDoc, {
+					heading: "Hashes data using the [BLAKE3](https://en.wikipedia.org/wiki/BLAKE_(hash_function)#BLAKE3) hash function.",
+					get children() {
+						return [
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocLink, { children: `https://en.wikipedia.org/wiki/BLAKE_(hash_function)#BLAKE3` }),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocParam, {
+								name: "data",
+								children: `The data to hash.`
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript_components_tsdoc.TSDocReturns, { children: `The hashed data.` })
+						];
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					name: "hash",
+					"export": true,
+					parameters: [{
+						name: "data",
+						type: "string"
+					}],
+					returnType: "string",
+					children: _alloy_js_core.code`return Buffer.from(
+    blake3(new TextEncoder().encode(data), {
+      key: ${hashKeyExpr}
+    })
+  ).toString("hex");`
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_core_components_spacing.Spacing, {}),
+				_alloy_js_core.code`
+// Export noble cipher and hash functions for advanced usage
+
+export * from "@noble/ciphers/chacha.js";
+export * from "@noble/ciphers/aes.js";
+export * from "@noble/ciphers/utils.js";
+export * from "@noble/hashes/blake3.js";
+export * from "@noble/hashes/pbkdf2.js";
+export * from "@noble/hashes/scrypt.js";
+export * from "@noble/hashes/utils.js";
+`,
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+					get when() {
+						return Boolean(children);
+					},
+					children
+				})
+			];
+		}
+	}));
+}
+
+//#endregion
+exports.CryptoBuiltin = CryptoBuiltin;

package/dist/components/crypto-builtin.d.cts

@@ -0,0 +1,10 @@
+import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
+//#region src/components/crypto-builtin.d.ts
+type CryptoBuiltinProps = Omit<BuiltinFileProps, "id">;
+/**
+ * Generates the cryptography builtin module for the Powerlines project.
+ */
+declare function CryptoBuiltin(props: CryptoBuiltinProps): import("@alloy-js/core").Children;
+//#endregion
+export { CryptoBuiltin, CryptoBuiltinProps };
+//# sourceMappingURL=crypto-builtin.d.cts.map

package/dist/components/crypto-builtin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-builtin.d.cts","names":[],"sources":["../../src/components/crypto-builtin.tsx"],"mappings":";;KAmCY,qBAAqB,KAAK;;;;iBAKtB,cAAc,OAAO,8CAAkB"}

package/dist/components/crypto-builtin.d.mts

@@ -0,0 +1,10 @@
+import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
+//#region src/components/crypto-builtin.d.ts
+type CryptoBuiltinProps = Omit<BuiltinFileProps, "id">;
+/**
+ * Generates the cryptography builtin module for the Powerlines project.
+ */
+declare function CryptoBuiltin(props: CryptoBuiltinProps): import("@alloy-js/core").Children;
+//#endregion
+export { CryptoBuiltin, CryptoBuiltinProps };
+//# sourceMappingURL=crypto-builtin.d.mts.map

package/dist/components/crypto-builtin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-builtin.d.mts","names":[],"sources":["../../src/components/crypto-builtin.tsx"],"mappings":""}

package/dist/components/crypto-builtin.mjs

@@ -0,0 +1,256 @@
+import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { Show, code, splitProps } from "@alloy-js/core";
+import { FunctionDeclaration, VarDeclaration } from "@alloy-js/typescript";
+import { Spacing } from "@power-plant/alloy-js/core/components/spacing";
+import { TSDoc, TSDocLink, TSDocParam, TSDocReturns } from "@power-plant/alloy-js/typescript/components/tsdoc";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
+import defu from "defu";
+
+//#region src/components/crypto-builtin.tsx
+/**
+* Generates the cryptography builtin module for the Powerlines project.
+*/
+function CryptoBuiltin(props) {
+	const [{ children, imports }, rest] = splitProps(props, ["children", "imports"]);
+	const context = usePowerlines();
+	const encryptionKey = context.config.crypto.encryptionKey;
+	const salt = context.config.crypto.salt;
+	const saltHex = salt || "nonce";
+	const hashKeyExpr = salt ? `hexToBytes("${salt}")` : `new TextEncoder().encode("powerlines")`;
+	return createComponent(BuiltinFile, mergeProps({
+		id: "crypto",
+		description: "The cryptography module provides custom helper functions to support encrypting and decrypting data."
+	}, rest, {
+		get imports() {
+			return defu({
+				"@noble/ciphers/chacha.js": [{ name: "xchacha20poly1305" }, { name: "chacha20poly1305" }],
+				"@noble/ciphers/utils.js": [{ name: "randomBytes" }, { name: "hexToBytes" }],
+				"@noble/hashes/scrypt.js": [{ name: "scrypt" }],
+				"@noble/hashes/blake3.js": [{ name: "blake3" }]
+			}, imports ?? {});
+		},
+		get children() {
+			return [
+				createComponent(Show, {
+					get when() {
+						return Boolean(encryptionKey);
+					},
+					get children() {
+						return [
+							createComponent(VarDeclaration, {
+								"const": true,
+								name: "nonce",
+								initializer: code`randomBytes(24)`
+							}),
+							createComponent(Spacing, {}),
+							createComponent(VarDeclaration, {
+								"const": true,
+								name: "chacha",
+								initializer: code`xchacha20poly1305(hexToBytes("${encryptionKey}"), nonce)`
+							}),
+							createComponent(Spacing, {}),
+							createComponent(TSDoc, {
+								heading: "Symmetrically encrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher.",
+								get children() {
+									return [
+										createComponent(TSDocLink, { children: `https://en.wikipedia.org/wiki/ChaCha20-Poly1305` }),
+										createComponent(TSDocParam, {
+											name: "plaintext",
+											children: `The data to encrypt.`
+										}),
+										createComponent(TSDocReturns, { children: `The encrypted data.` })
+									];
+								}
+							}),
+							createComponent(FunctionDeclaration, {
+								name: "encrypt",
+								"export": true,
+								parameters: [{
+									name: "plaintext",
+									type: "string"
+								}],
+								returnType: "string",
+								children: code`return chacha.encrypt(
+    nonce,
+    new TextEncoder().encode(plaintext),
+    null
+  );`
+							}),
+							createComponent(Spacing, {}),
+							createComponent(TSDoc, {
+								heading: "Symmetrically decrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher.",
+								get children() {
+									return [
+										createComponent(TSDocLink, { children: `https://en.wikipedia.org/wiki/ChaCha20-Poly1305` }),
+										createComponent(TSDocParam, {
+											name: "encrypted",
+											children: `The encrypted data to decrypt.`
+										}),
+										createComponent(TSDocReturns, { children: `The decrypted data.` })
+									];
+								}
+							}),
+							createComponent(FunctionDeclaration, {
+								name: "decrypt",
+								"export": true,
+								parameters: [{
+									name: "encrypted",
+									type: "string"
+								}],
+								returnType: "string",
+								children: code`const decrypted = chacha.decrypt(
+    nonce,
+    encrypted,
+    null
+  );
+
+  return new TextDecoder().decode(decrypted);`
+							}),
+							createComponent(Spacing, {})
+						];
+					}
+				}),
+				createComponent(TSDoc, {
+					heading: "Symmetrically encrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher with a password.",
+					get children() {
+						return [
+							createComponent(TSDocLink, { children: `https://en.wikipedia.org/wiki/ChaCha20-Poly1305` }),
+							createComponent(TSDocParam, {
+								name: "password",
+								children: `The password used to derive the encryption key.`
+							}),
+							createComponent(TSDocParam, {
+								name: "plaintext",
+								children: `The data to encrypt.`
+							}),
+							createComponent(TSDocReturns, { children: `The encrypted data.` })
+						];
+					}
+				}),
+				createComponent(FunctionDeclaration, {
+					name: "encryptWithPassword",
+					"export": true,
+					parameters: [{
+						name: "password",
+						type: "string"
+					}, {
+						name: "plaintext",
+						type: "string"
+					}],
+					returnType: "string",
+					children: code`const key = scrypt(
+    new TextEncoder().encode(password),
+    hexToBytes("${saltHex}"),
+    1048576, // requires 1GB of RAM to calculate
+    8,
+    1,
+    32
+  );
+
+  return chacha20poly1305(key).encrypt(
+    nonce,
+    new TextEncoder().encode(plaintext),
+    null
+  );`
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, {
+					heading: "Symmetrically decrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher with a password.",
+					get children() {
+						return [
+							createComponent(TSDocLink, { children: `https://en.wikipedia.org/wiki/ChaCha20-Poly1305` }),
+							createComponent(TSDocParam, {
+								name: "password",
+								children: `The password used to derive the decryption key.`
+							}),
+							createComponent(TSDocParam, {
+								name: "encrypted",
+								children: `The encrypted data to decrypt.`
+							}),
+							createComponent(TSDocReturns, { children: `The decrypted data.` })
+						];
+					}
+				}),
+				createComponent(FunctionDeclaration, {
+					name: "decryptWithPassword",
+					"export": true,
+					parameters: [{
+						name: "password",
+						type: "string"
+					}, {
+						name: "encrypted",
+						type: "string"
+					}],
+					returnType: "string",
+					children: code`const key = scrypt(
+    new TextEncoder().encode(password),
+    hexToBytes("${saltHex}"),
+    1048576, // requires 1GB of RAM to calculate
+    8,
+    1,
+    32
+  );
+
+  const decrypted = chacha20poly1305(key).decrypt(
+    nonce,
+    encrypted,
+    null
+  );
+
+  return new TextDecoder().decode(decrypted);`
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, {
+					heading: "Hashes data using the [BLAKE3](https://en.wikipedia.org/wiki/BLAKE_(hash_function)#BLAKE3) hash function.",
+					get children() {
+						return [
+							createComponent(TSDocLink, { children: `https://en.wikipedia.org/wiki/BLAKE_(hash_function)#BLAKE3` }),
+							createComponent(TSDocParam, {
+								name: "data",
+								children: `The data to hash.`
+							}),
+							createComponent(TSDocReturns, { children: `The hashed data.` })
+						];
+					}
+				}),
+				createComponent(FunctionDeclaration, {
+					name: "hash",
+					"export": true,
+					parameters: [{
+						name: "data",
+						type: "string"
+					}],
+					returnType: "string",
+					children: code`return Buffer.from(
+    blake3(new TextEncoder().encode(data), {
+      key: ${hashKeyExpr}
+    })
+  ).toString("hex");`
+				}),
+				createComponent(Spacing, {}),
+				code`
+// Export noble cipher and hash functions for advanced usage
+
+export * from "@noble/ciphers/chacha.js";
+export * from "@noble/ciphers/aes.js";
+export * from "@noble/ciphers/utils.js";
+export * from "@noble/hashes/blake3.js";
+export * from "@noble/hashes/pbkdf2.js";
+export * from "@noble/hashes/scrypt.js";
+export * from "@noble/hashes/utils.js";
+`,
+				createComponent(Show, {
+					get when() {
+						return Boolean(children);
+					},
+					children
+				})
+			];
+		}
+	}));
+}
+
+//#endregion
+export { CryptoBuiltin };
+//# sourceMappingURL=crypto-builtin.mjs.map

package/dist/components/crypto-builtin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-builtin.mjs","names":[],"sources":[],"mappings":""}

package/dist/components/index.cjs

@@ -1,3 +1,4 @@
-const require_crypto = require('./crypto.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_components_crypto_builtin = require('./crypto-builtin.cjs');
 
-exports.cryptoModule = require_crypto.cryptoModule;
+exports.CryptoBuiltin = require_components_crypto_builtin.CryptoBuiltin;

package/dist/components/index.d.cts

@@ -1,2 +1,2 @@
-import { cryptoModule } from "./crypto.cjs";
-export { cryptoModule };
+import { CryptoBuiltin, CryptoBuiltinProps } from "./crypto-builtin.cjs";
+export { CryptoBuiltin, CryptoBuiltinProps };

package/dist/components/index.d.mts

@@ -1,2 +1,2 @@
-import { cryptoModule } from "./crypto.mjs";
-export { cryptoModule };
+import { CryptoBuiltin, CryptoBuiltinProps } from "./crypto-builtin.mjs";
+export { CryptoBuiltin, CryptoBuiltinProps };

package/dist/components/index.mjs

@@ -1,3 +1,3 @@
-import { cryptoModule } from "./crypto.mjs";
+import { CryptoBuiltin } from "./crypto-builtin.mjs";
 
-export { cryptoModule };
+export { CryptoBuiltin };

package/dist/index.cjs

@@ -1,14 +1,16 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
-const require_crypto = require('./components/crypto.cjs');
+const require_components_crypto_builtin = require('./components/crypto-builtin.cjs');
 require('./components/index.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu, 1);
 let _noble_ciphers_utils_js = require("@noble/ciphers/utils.js");
+let _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
 let _powerlines_plugin_env = require("@powerlines/plugin-env");
 _powerlines_plugin_env = require_runtime.__toESM(_powerlines_plugin_env, 1);
-let defu = require("defu");
-defu = require_runtime.__toESM(defu, 1);
 
-//#region src/index.ts
+//#region src/index.tsx
 /**
 * A Powerlines plugin to assist in developing other Powerlines plugins.
 */
@@ -34,12 +36,12 @@ function plugin(options = {}) {
 		},
 		async prepare() {
 			this.debug(`Preparing the Crypto runtime artifacts for the Powerlines project.`);
-			await this.emitBuiltin(await Promise.resolve(require_crypto.cryptoModule(this)), "crypto");
+			return (0, _powerlines_plugin_alloy_render.render)(this, (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_crypto_builtin.CryptoBuiltin, {}));
 		}
 	}];
 }
 
 //#endregion
-exports.cryptoModule = require_crypto.cryptoModule;
+exports.CryptoBuiltin = require_components_crypto_builtin.CryptoBuiltin;
 exports.default = plugin;
 exports.plugin = plugin;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { CryptoPluginContext, CryptoPluginOptions, CryptoPluginResolvedConfig, CryptoPluginUserConfig } from "./types/plugin.cjs";
-import { cryptoModule } from "./components/crypto.cjs";
+import { CryptoBuiltin, CryptoBuiltinProps } from "./components/crypto-builtin.cjs";
 import "./components/index.cjs";
+import { CryptoPluginContext, CryptoPluginOptions, CryptoPluginResolvedConfig, CryptoPluginUserConfig } from "./types/plugin.cjs";
 import "./types/index.cjs";
 import { Plugin } from "powerlines";
 //#region src/index.d.ts
@@ -14,5 +14,5 @@ declare module "powerlines" {
  */
 declare function plugin<TContext extends CryptoPluginContext = CryptoPluginContext>(options?: CryptoPluginOptions): Plugin<TContext>[];
 //#endregion
-export { CryptoPluginContext, CryptoPluginOptions, CryptoPluginResolvedConfig, CryptoPluginUserConfig, cryptoModule, plugin as default, plugin };
+export { CryptoBuiltin, CryptoBuiltinProps, CryptoPluginContext, CryptoPluginOptions, CryptoPluginResolvedConfig, CryptoPluginUserConfig, plugin as default, plugin };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;YA6BY;IACR,SAAS;;;;;;iBAOG,OACd,iBAAiB,sBAAsB,qBACvC,UAAS,sBA6CJ,OAAO"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;;YA8BY;IACR,SAAS;;;;;;iBAOG,OACd,iBAAiB,sBAAsB,qBACvC,UAAS,sBA0CJ,OAAO"}

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { CryptoPluginContext, CryptoPluginOptions, CryptoPluginResolvedConfig, CryptoPluginUserConfig } from "./types/plugin.mjs";
-import { cryptoModule } from "./components/crypto.mjs";
+import { CryptoBuiltin, CryptoBuiltinProps } from "./components/crypto-builtin.mjs";
 import "./components/index.mjs";
+import { CryptoPluginContext, CryptoPluginOptions, CryptoPluginResolvedConfig, CryptoPluginUserConfig } from "./types/plugin.mjs";
 import "./types/index.mjs";
 import { Plugin } from "powerlines";
 //#region src/index.d.ts
@@ -14,5 +14,5 @@ declare module "powerlines" {
  */
 declare function plugin<TContext extends CryptoPluginContext = CryptoPluginContext>(options?: CryptoPluginOptions): Plugin<TContext>[];
 //#endregion
-export { CryptoPluginContext, CryptoPluginOptions, CryptoPluginResolvedConfig, CryptoPluginUserConfig, cryptoModule, plugin as default, plugin };
+export { CryptoBuiltin, CryptoBuiltinProps, CryptoPluginContext, CryptoPluginOptions, CryptoPluginResolvedConfig, CryptoPluginUserConfig, plugin as default, plugin };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":""}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":""}

package/dist/index.mjs

@@ -1,10 +1,12 @@
-import { cryptoModule } from "./components/crypto.mjs";
+import { CryptoBuiltin } from "./components/crypto-builtin.mjs";
 import "./components/index.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import defu from "defu";
 import { bytesToHex, randomBytes } from "@noble/ciphers/utils.js";
+import { render } from "@powerlines/plugin-alloy/render";
 import env from "@powerlines/plugin-env";
-import defu from "defu";
 
-//#region src/index.ts
+//#region src/index.tsx
 /**
 * A Powerlines plugin to assist in developing other Powerlines plugins.
 */
@@ -30,11 +32,11 @@ function plugin(options = {}) {
 		},
 		async prepare() {
 			this.debug(`Preparing the Crypto runtime artifacts for the Powerlines project.`);
-			await this.emitBuiltin(await Promise.resolve(cryptoModule(this)), "crypto");
+			return render(this, createComponent(CryptoBuiltin, {}));
 		}
 	}];
 }
 
 //#endregion
-export { cryptoModule, plugin as default, plugin };
+export { CryptoBuiltin, plugin as default, plugin };
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-crypto",
-  "version": "0.10.673",
+  "version": "0.10.675",
   "type": "module",
   "description": "A Powerlines plugin that provides unique identifier generation capabilities at runtime by adding the `id` builtin module.",
   "repository": {
@@ -53,6 +53,34 @@
         "default": "./dist/index.mjs"
       }
     },
+    "./components": {
+      "require": {
+        "types": "./dist/components/index.d.cts",
+        "default": "./dist/components/index.cjs"
+      },
+      "import": {
+        "types": "./dist/components/index.d.mts",
+        "default": "./dist/components/index.mjs"
+      },
+      "default": {
+        "types": "./dist/components/index.d.mts",
+        "default": "./dist/components/index.mjs"
+      }
+    },
+    "./components/crypto-builtin": {
+      "require": {
+        "types": "./dist/components/crypto-builtin.d.cts",
+        "default": "./dist/components/crypto-builtin.cjs"
+      },
+      "import": {
+        "types": "./dist/components/crypto-builtin.d.mts",
+        "default": "./dist/components/crypto-builtin.mjs"
+      },
+      "default": {
+        "types": "./dist/components/crypto-builtin.d.mts",
+        "default": "./dist/components/crypto-builtin.mjs"
+      }
+    },
     "./package.json": "./package.json",
     "./types": {
       "require": {
@@ -83,23 +111,29 @@
       }
     }
   },
-  "files": ["dist/**/*"],
+  "files": ["dist"],
   "keywords": ["powerlines", "storm-software", "powerlines-plugin"],
   "dependencies": {
+    "@alloy-js/core": "^0.24.1",
+    "@alloy-js/json": "^0.24.0",
+    "@alloy-js/markdown": "^0.24.0",
+    "@alloy-js/typescript": "^0.24.0",
     "@noble/ciphers": "^2.2.0",
-    "@powerlines/plugin-env": "^0.16.364",
+    "@power-plant/alloy-js": "^0.0.39",
+    "@powerlines/plugin-alloy": "^0.26.255",
+    "@powerlines/plugin-env": "^0.16.366",
     "@storm-software/config-tools": "^1.190.109",
     "@stryke/path": "^0.29.25",
     "defu": "^6.1.7",
-    "powerlines": "^0.47.160"
+    "powerlines": "^0.47.162"
   },
   "devDependencies": {
-    "@powerlines/plugin-plugin": "^0.12.572",
+    "@powerlines/plugin-plugin": "^0.12.574",
     "@types/node": "^25.9.5"
   },
   "publishConfig": { "access": "public" },
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.cts",
-  "gitHead": "de2000d03a08aa0992aefe09286a1ec1aad8fd9f"
+  "gitHead": "9d7a99095d9907e5751917b9f00e98e9f3ffac53"
 }

package/dist/components/crypto.cjs

@@ -1,147 +0,0 @@
-let powerlines_utils = require("powerlines/utils");
-
-//#region src/components/crypto.ts
-/**
-* Generates the crypto module content.
-*
-* @param context - The build context containing runtime information.
-* @returns A string representing the crypto module code.
-*/
-function cryptoModule(context) {
-	return `
-/**
- * The cryptography module provides custom helper functions to support encrypting and decrypting data.
- *
- * @module ${context.config.framework?.name || "powerlines"}:crypto
- */
-
-${(0, powerlines_utils.getFileHeader)(context)}
-
-import { xchacha20poly1305, chacha20poly1305 } from "@noble/ciphers/chacha.js";
-import { randomBytes, managedNonce, hexToBytes } from "@noble/ciphers/utils.js";
-import { scrypt } from "@noble/hashes/scrypt.js";
-import { blake3 } from "@noble/hashes/blake3.js";
-
-${context.config.crypto.encryptionKey ? `const nonce = randomBytes(24);
-const chacha = xchacha20poly1305(hexToBytes("${context.config.crypto.encryptionKey}"), nonce);
-
-/**
- * Symmetrically encrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher.
- *
- * @see https://en.wikipedia.org/wiki/ChaCha20-Poly1305
- *
- * @param plaintext - The data to encrypt.
- * @returns The encrypted data.
- */
-export function encrypt(plaintext: string): string {
-  return chacha.encrypt(
-    nonce,
-    new TextEncoder().encode(plaintext),
-    null
-  );
-}
-
-/**
- * Symmetrically decrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher.
- *
- * @see https://en.wikipedia.org/wiki/ChaCha20-Poly1305
- *
- * @param encrypted - The encrypted data to decrypt.
- * @returns The decrypted data.
- */
-export function decrypt(encrypted: string): string {
-  const decrypted = chacha.decrypt(
-    nonce,
-    encrypted,
-    null
-  );
-
-  return new TextDecoder().decode(decrypted);
-}
-` : ""}
-
-/**
- * Symmetrically encrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher with a password.
- *
- * @see https://en.wikipedia.org/wiki/ChaCha20-Poly1305
- *
- * @param password - The password used to derive the encryption key.
- * @param plaintext - The data to encrypt.
- * @returns The encrypted data.
- */
-export function encryptWithPassword(password: string, plaintext: string): string {
-  const key = scrypt(
-    new TextEncoder().encode(password),
-    hexToBytes("${context.config.crypto.salt ? context.config.crypto.salt : "nonce"}"),
-    1048576, // requires 1GB of RAM to calculate
-    8,
-    1,
-    32
-  );
-
-  return chacha20poly1305(key).encrypt(
-    nonce,
-    new TextEncoder().encode(plaintext),
-    null
-  );
-}
-
-/**
- * Symmetrically decrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher with a password.
- *
- * @see https://en.wikipedia.org/wiki/ChaCha20-Poly1305
- *
- * @param password - The password used to derive the decryption key.
- * @param encrypted - The encrypted data to decrypt.
- * @returns The decrypted data.
- */
-export function decryptWithPassword(password: string, encrypted: string): string {
-  const key = scrypt(
-    new TextEncoder().encode(password),
-    hexToBytes("${context.config.crypto.salt ? context.config.crypto.salt : "nonce"}"),
-    1048576, // requires 1GB of RAM to calculate
-    8,
-    1,
-    32
-  );
-
-  const decrypted = chacha20poly1305(key).decrypt(
-    nonce,
-    encrypted,
-    null
-  );
-
-  return new TextDecoder().decode(decrypted);
-}
-
-/**
- * Hashes data using the [BLAKE3](https://en.wikipedia.org/wiki/BLAKE_(hash_function)#BLAKE3) hash function.
- *
- * @see https://en.wikipedia.org/wiki/BLAKE_(hash_function)#BLAKE3
- *
- * @param data - The data to hash.
- * @returns The hashed data.
- */
-export function hash(data: string): string {
-  return Buffer.from(
-    blake3(new TextEncoder().encode(data), {
-      key: ${context.config.crypto.salt ? `hexToBytes("${context.config.crypto.salt}")` : "new TextEncoder().encode(\"powerlines\")"})
-    })
-  ).toString("hex");
-}
-
-// Export noble cipher and hash functions for advanced usage
-
-export * from "@noble/ciphers/chacha.js";
-export * from "@noble/ciphers/aes.js";
-export * from "@noble/ciphers/utils.js";
-export * from '@noble/hashes/blake3.js';
-export * from '@noble/hashes/pbkdf2.js';
-export * from '@noble/hashes/scrypt.js';
-export * from '@noble/hashes/utils.js';
-
-`;
-}
-
-//#endregion
-exports.cryptoModule = cryptoModule;

package/dist/components/crypto.d.cts

@@ -1,12 +0,0 @@
-import { CryptoPluginContext } from "../types/plugin.cjs";
-//#region src/components/crypto.d.ts
-/**
- * Generates the crypto module content.
- *
- * @param context - The build context containing runtime information.
- * @returns A string representing the crypto module code.
- */
-declare function cryptoModule(context: CryptoPluginContext): string;
-//#endregion
-export { cryptoModule };
-//# sourceMappingURL=crypto.d.cts.map

package/dist/components/crypto.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"crypto.d.cts","names":[],"sources":["../../src/components/crypto.ts"],"mappings":";;;;;;;;iBA2BgB,aAAa,SAAS"}

package/dist/components/crypto.d.mts

@@ -1,12 +0,0 @@
-import { CryptoPluginContext } from "../types/plugin.mjs";
-//#region src/components/crypto.d.ts
-/**
- * Generates the crypto module content.
- *
- * @param context - The build context containing runtime information.
- * @returns A string representing the crypto module code.
- */
-declare function cryptoModule(context: CryptoPluginContext): string;
-//#endregion
-export { cryptoModule };
-//# sourceMappingURL=crypto.d.mts.map

package/dist/components/crypto.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"crypto.d.mts","names":[],"sources":["../../src/components/crypto.ts"],"mappings":""}

package/dist/components/crypto.mjs

@@ -1,148 +0,0 @@
-import { getFileHeader } from "powerlines/utils";
-
-//#region src/components/crypto.ts
-/**
-* Generates the crypto module content.
-*
-* @param context - The build context containing runtime information.
-* @returns A string representing the crypto module code.
-*/
-function cryptoModule(context) {
-	return `
-/**
- * The cryptography module provides custom helper functions to support encrypting and decrypting data.
- *
- * @module ${context.config.framework?.name || "powerlines"}:crypto
- */
-
-${getFileHeader(context)}
-
-import { xchacha20poly1305, chacha20poly1305 } from "@noble/ciphers/chacha.js";
-import { randomBytes, managedNonce, hexToBytes } from "@noble/ciphers/utils.js";
-import { scrypt } from "@noble/hashes/scrypt.js";
-import { blake3 } from "@noble/hashes/blake3.js";
-
-${context.config.crypto.encryptionKey ? `const nonce = randomBytes(24);
-const chacha = xchacha20poly1305(hexToBytes("${context.config.crypto.encryptionKey}"), nonce);
-
-/**
- * Symmetrically encrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher.
- *
- * @see https://en.wikipedia.org/wiki/ChaCha20-Poly1305
- *
- * @param plaintext - The data to encrypt.
- * @returns The encrypted data.
- */
-export function encrypt(plaintext: string): string {
-  return chacha.encrypt(
-    nonce,
-    new TextEncoder().encode(plaintext),
-    null
-  );
-}
-
-/**
- * Symmetrically decrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher.
- *
- * @see https://en.wikipedia.org/wiki/ChaCha20-Poly1305
- *
- * @param encrypted - The encrypted data to decrypt.
- * @returns The decrypted data.
- */
-export function decrypt(encrypted: string): string {
-  const decrypted = chacha.decrypt(
-    nonce,
-    encrypted,
-    null
-  );
-
-  return new TextDecoder().decode(decrypted);
-}
-` : ""}
-
-/**
- * Symmetrically encrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher with a password.
- *
- * @see https://en.wikipedia.org/wiki/ChaCha20-Poly1305
- *
- * @param password - The password used to derive the encryption key.
- * @param plaintext - The data to encrypt.
- * @returns The encrypted data.
- */
-export function encryptWithPassword(password: string, plaintext: string): string {
-  const key = scrypt(
-    new TextEncoder().encode(password),
-    hexToBytes("${context.config.crypto.salt ? context.config.crypto.salt : "nonce"}"),
-    1048576, // requires 1GB of RAM to calculate
-    8,
-    1,
-    32
-  );
-
-  return chacha20poly1305(key).encrypt(
-    nonce,
-    new TextEncoder().encode(plaintext),
-    null
-  );
-}
-
-/**
- * Symmetrically decrypts data using the [ChaCha20-Poly1305](https://en.wikipedia.org/wiki/ChaCha20-Poly1305) cipher with a password.
- *
- * @see https://en.wikipedia.org/wiki/ChaCha20-Poly1305
- *
- * @param password - The password used to derive the decryption key.
- * @param encrypted - The encrypted data to decrypt.
- * @returns The decrypted data.
- */
-export function decryptWithPassword(password: string, encrypted: string): string {
-  const key = scrypt(
-    new TextEncoder().encode(password),
-    hexToBytes("${context.config.crypto.salt ? context.config.crypto.salt : "nonce"}"),
-    1048576, // requires 1GB of RAM to calculate
-    8,
-    1,
-    32
-  );
-
-  const decrypted = chacha20poly1305(key).decrypt(
-    nonce,
-    encrypted,
-    null
-  );
-
-  return new TextDecoder().decode(decrypted);
-}
-
-/**
- * Hashes data using the [BLAKE3](https://en.wikipedia.org/wiki/BLAKE_(hash_function)#BLAKE3) hash function.
- *
- * @see https://en.wikipedia.org/wiki/BLAKE_(hash_function)#BLAKE3
- *
- * @param data - The data to hash.
- * @returns The hashed data.
- */
-export function hash(data: string): string {
-  return Buffer.from(
-    blake3(new TextEncoder().encode(data), {
-      key: ${context.config.crypto.salt ? `hexToBytes("${context.config.crypto.salt}")` : "new TextEncoder().encode(\"powerlines\")"})
-    })
-  ).toString("hex");
-}
-
-// Export noble cipher and hash functions for advanced usage
-
-export * from "@noble/ciphers/chacha.js";
-export * from "@noble/ciphers/aes.js";
-export * from "@noble/ciphers/utils.js";
-export * from '@noble/hashes/blake3.js';
-export * from '@noble/hashes/pbkdf2.js';
-export * from '@noble/hashes/scrypt.js';
-export * from '@noble/hashes/utils.js';
-
-`;
-}
-
-//#endregion
-export { cryptoModule };
-//# sourceMappingURL=crypto.mjs.map

package/dist/components/crypto.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"crypto.mjs","names":[],"sources":[],"mappings":""}