riao-crypto

A comprehensive TypeScript cryptography library providing secure encryption, hashing, JWT management, and key generation utilities.

Features

• Encryption & Decryption: RSA public-key encryption with OAEP padding and SHA-256 hashing
• Hashing: Secure password and data hashing with bcrypt
• JWT Management: Sign and verify JSON Web Tokens with HS256 and RS256 algorithms
• Key Pair Generation: Generate and manage RSA key pairs
• Secret Management: Flexible secret handling for different cryptographic algorithms
• TypeScript Support: Fully typed API with comprehensive type safety

Installation

npm install @riao/crypto

Getting Started

Read the Getting Started Guide to get started.

Usage

Encryption & Decryption

import { generateKeyPair } from '@riao/crypto';
import { Encryptor, Decryptor } from '@riao/crypto';

const { publicKey, privateKey } = await generateKeyPair();

const encryptor = new Encryptor(publicKey);
const encrypted = encryptor.encrypt('secret message');

const decryptor = new Decryptor(privateKey);
const decrypted = decryptor.decrypt(encrypted);

Hashing

import { hashPassword, comparePassword } from '@riao/crypto';

const hashed = await hashPassword('myPassword');
const isMatch = await comparePassword('myPassword', hashed);

JWT

import { Jwt } from '@riao/crypto';

const jwt = new Jwt({ secret: 'your-secret-key' });
const token = jwt.sign({ userId: 123 }, { expiresIn: '1h' });
const payload = jwt.verify(token);

Key Pair Generation

import { generateKeyPair } from '@riao/crypto';

const { publicKey, privateKey } = await generateKeyPair();

For detailed guides on each module, see:

• Encryption & Decryption Guide
• Hashing Guide
• JWT Guide
• Key Pair Guide
• Crypto Guide

Documentation

• Architecture Overview

Contributing

• Contributing Guide
• Setup Guide
• Development Guide

License

Licensed under the MIT.