keycipher
is a utility package for encrypting and decrypting text using AES-GCM with a secret key. It leverages the WebCrypto API to provide secure encryption and decryption functionalities.
To install the package, run the following command:
npm install keycipher
Here’s a brief guide on how to use the keycipher
package.
const { encryptData, decryptData } = require('keycipher');
To encrypt a piece of text, use the encryptData
function. You need to provide the plaintext and a key string.
const { encryptData } = require('keycipher');
(async () => {
try {
const keyString = 'your-secret-key'; // Replace with your key
const plainText = 'This is a secret message'; // Replace with your text
const encryptedData = await encryptData(plainText, keyString);
console.log('Encrypted Data:', encryptedData);
} catch (error) {
console.error('Encryption Error:', error);
}
})();
To decrypt data, use the decryptData
function. You need to provide the encrypted data and the same key string used for encryption.
const { decryptData } = require('keycipher');
(async () => {
try {
const keyString = 'your-secret-key'; // Replace with your key
const encryptedData = {
iv: '...your IV...',
cipherText: '...your cipherText...',
tag: '...your tag...'
}; // Replace with your generated encryption object
const decryptedText = await decryptData(encryptedData, keyString);
console.log('Decrypted Text:', decryptedText);
} catch (error) {
console.error('Decryption Error:', error);
}
})();
Encrypts the given plaintext using the provided key string.
-
Arguments:
plainText
(String): The text to be encrypted.key
(String): The key used for encryption.
-
Returns: An object containing
iv
,cipherText
andtag
.
Decrypts the given encrypted data using the provided key string.
-
Arguments:
encryptedData
(Object): The encrypted data object, which includesiv
,cipherText
andtag
.key
(String): The key used for decryption.
-
Returns: The decrypted text.
keycipher
is created by Parth Dudhatra (imParth), a passionate software engineer, developer advocate, and content creator known for his contributions to the tech community. He is passionate about frontend development, Python programming, open-source software, and sharing knowledge with others.
Parth is active on various social media platforms, where he shares insights, tutorials, and tips related to programming, web development, and software engineering. Parth's dedication to sharing his expertise and fostering a supportive environment for developers has earned him recognition and respect within the tech community.
Connect with Parth Dudhatra on social media:
If you have any questions, feedback, or suggestions, feel free to reach out to me on any platform!
This project is licensed under the ISC License.
Contributions are welcome! Please open an issue or submit a pull request on the GitHub repository.
If you encounter any issues, please report them on the issues page.