This project provides a simple utility for encrypting and zipping the contents of a folder using AES-GCM encryption. It is designed to securely store or transfer folder contents by combining compression and encryption into a single step.
The tool accepts a folder as input, compresses its contents into a ZIP file, and then encrypts the file using AES-256-GCM. You can choose to either save the encrypted file to disk or return it as a memory buffer.
- Folder Compression: Compresses an entire folder into a single ZIP archive.
- AES-256-GCM Encryption: Utilizes modern cryptography standards for secure encryption.
- Flexible Output: Allows encrypted content to be saved as a file or used directly in memory.
- Error Handling: Provides feedback on errors related to input validation and processing.
The @fnet/zip-and-encrypt utility is a straightforward solution for those needing to compress and encrypt folder contents quickly and securely. It's useful for protecting sensitive data during storage or transmission without unnecessary complexity.
The @fnet/zip-and-encrypt
library provides a straightforward way to compress and encrypt directories using AES-GCM encryption. By taking a specified directory and a private key, the library can create a secure, encrypted zip file. This is ideal for securely archiving data that needs to be kept confidential.
You can install the library using either npm or yarn:
npm install @fnet/zip-and-encrypt
or
yarn add @fnet/zip-and-encrypt
The main functionality is provided through a single function encryptAndZip
, which zips the contents of a specified directory and encrypts the result. This function can be used to either return the encrypted data as a buffer or save it directly to disk.
Here's a basic example demonstrating how to use the encryptAndZip
function:
import encryptAndZip from '@fnet/zip-and-encrypt';
// Define input parameters
const privateKey = 'yourhexencodedprivatekeyhere';
const inputDirectoryPath = './path/to/your/directory';
const outputPath = './path/to/your/output/encrypted.zip';
// Using the encryptAndZip function
encryptAndZip({ privateKey, input: inputDirectoryPath, output: outputPath })
.then((result) => {
console.log('Encrypted file successfully created:', result);
})
.catch((error) => {
console.error('An error occurred:', error);
});
In this example, the function takes a private key, an input directory, and an optional output path. If an output path is specified, the encrypted zip is saved to disk. If not, the encrypted content is returned as a Buffer.
If you prefer to handle the encrypted content directly in memory instead of saving it to disk, you can omit the output
parameter:
encryptAndZip({ privateKey, input: inputDirectoryPath })
.then((encryptedBuffer) => {
console.log('Encrypted content as Buffer:', encryptedBuffer);
})
.catch((error) => {
console.error('An error occurred:', error);
});
encryptAndZip({
privateKey: 'yourhexencodedprivatekeyhere',
input: './path/to/directory',
output: './encrypted/file.zip'
}).then((outputPath) => {
console.log('File saved to:', outputPath);
}).catch(console.error);
encryptAndZip({
privateKey: 'yourhexencodedprivatekeyhere',
input: './path/to/directory'
}).then((buffer) => {
// Use the encrypted buffer as needed
console.log('Encrypted buffer:', buffer);
}).catch(console.error);
This project relies on powerful tools such as Node.js' built-in crypto
module and archiver
for handling compression functionalities. These underpin the core features of @fnet/zip-and-encrypt
, providing reliable encryption and zipping capabilities.
$schema: https://json-schema.org/draft/2020-12/schema
title: EncryptAndZipArguments
type: object
properties:
privateKey:
type: string
description: The private key used for encryption (hex encoded).
input:
type: string
description: The folder whose contents will be zipped and encrypted.
output:
type: string
description: The output file path where the encrypted content will be saved. If
not provided, returns the encrypted content as a Buffer.
required:
- privateKey
- input