@robinpath/encrypt

AES-256-GCM and RSA encryption/decryption with key generation, password-based key derivation, and hashing

Why use this module?

The encrypt module lets you:

• Encrypt text with AES using a password (auto-generates salt/IV)
• Decrypt AES-encrypted data using a password
• Encrypt text with a raw hex key (for advanced use)
• Generate a cryptographically secure random key
• Generate an RSA key pair

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/encrypt

Quick Start

No credentials needed — start using it right away:

encrypt.aesDecrypt $encryptedData "my-password"

Available Functions

Function	Description
encrypt.aesEncrypt	Encrypt text with AES using a password (auto-generates salt/IV)
encrypt.aesDecrypt	Decrypt AES-encrypted data using a password
encrypt.aesEncryptRaw	Encrypt text with a raw hex key (for advanced use)
encrypt.generateKey	Generate a cryptographically secure random key
encrypt.rsaGenerateKeys	Generate an RSA key pair
encrypt.rsaEncrypt	Encrypt text with an RSA public key
encrypt.rsaDecrypt	Decrypt RSA-encrypted text with a private key
encrypt.hash	Hash a string (sha256, sha512, md5, etc.)
encrypt.deriveKey	Derive an encryption key from a password using scrypt
encrypt.randomIv	Generate a random initialization vector

Examples

Decrypt AES-encrypted data using a password

encrypt.aesDecrypt $encryptedData "my-password"

Encrypt text with a raw hex key (for advanced use)

encrypt.aesEncryptRaw "data" $hexKey

Generate a cryptographically secure random key

encrypt.generateKey 256

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/encrypt";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  encrypt.aesDecrypt $encryptedData "my-password"
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT