🔒 ncrypt

ncrypt is a high-performance, secure, and lightweight Node.js library designed for binary file encryption, compression, and serialization. By combining the speed of MessagePack serialization, flexible compression algorithms, and authenticated AES-256-GCM encryption, ncrypt provides a robust, tamper-proof solution for handling custom .ncrypt file structures.

✨ Key Features

• 🔐 Authenticated Encryption – Built-in support for industry-standard authenticated encryption schemes (AES-256-GCM, AES-128-GCM, and ChaCha20-Poly1305) ensuring data integrity and detecting tampering or corruption.
• ⚡ Ultra-Fast Serialization – Powered by MessagePack for compact, high-speed binary serialization, eliminating the overhead of traditional JSON.
• 📉 Integrated Compression – Configurable compression levels ranging from 1 (Fastest) to 15 (Maximum Compression).
• 🛡️ Strong Key Derivation – Uses native Node.js scrypt with unique salts to resist dictionary and rainbow table attacks.
• 📦 Developer Friendly – Fully typed, Promise-based API for both TypeScript and JavaScript.
• 🟢 Node.js Native – Built on top of Node's native crypto module with no heavy cryptographic dependencies.

📦 Installation

Install ncrypt via npm:

npm install @nroot_project/ncrypt

🔹 Companion Package

For handling with better performance, we'd used NArchive for archiving and directory and files.

https://github.com/Nima389/NArchive

You can install the NArchive via npm:

npm install @nroot_project/narchive

🚀 Quick Start

import { NCrypt } from "@nroot_project/ncrypt";

async function main() {
  const secretData = {
    user: "alice",
    role: "admin",
    sensitiveInfo: [10, 20, 30],
  };

  const password = "SuperSecretPassword123!";

  // Encrypt & Compress
  const encryptedBuffer = await NCrypt.encrypt(secretData, password, {
    algorithm: "aes-256-gcm",
    compressionLevel: 6,
  });

  // Decrypt
  const decryptedData = await NCrypt.decrypt(encryptedBuffer, password);

  console.log(decryptedData);
}

main();

Output

{
  user: "alice",
  role: "admin",
  sensitiveInfo: [10, 20, 30]
}

⚙️ Supported Algorithms

👥 About the Project

ncrypt is actively developed and maintained by the nroot_project organization. Our goal is to build ultra-fast, developer-first tools for secure data handling in Node.js.

Ecosystem

For high-performance directory bundling and archiving, check out NArchive, which integrates seamlessly with ncrypt.

npm install @nroot_project/narchive

Contributing

Issues, feature requests, and Pull Requests are always welcome!

📄 License

MIT © nroot_project