random-password-toolkit v1.0.1

Random Password Toolkit

Random Password Toolkit is a robust package for generating and managing random passwords with advanced functionalities such as encryption, decryption, strength checking, and customizable options. This toolkit is perfect for developers looking for a secure and feature-rich solution to handle password-related tasks in their applications.

Features

• Random Password Generation: Generate strong and secure passwords.
• Generate Multiple Passwords: Create multiple passwords in bulk.
• Pronounceable Passwords: Generate passwords that are easier to read and pronounce.
• Custom Password Generation: Create passwords using a custom pool of characters.
• Password Strength Checker: Evaluate the strength of passwords with actionable feedback.
• Password Encryption: Secure passwords with AES-256 encryption.
• Password Decryption: Decrypt encrypted passwords safely.
• Customizable Options: Fully customizable password generation settings.

Benefits

• Security: Generate highly secure passwords to protect sensitive data.
• Flexibility: Customize password generation to suit any application.
• Ease of Use: Simple and intuitive API.
• Compatibility: Works seamlessly with JavaScript and TypeScript projects.
• Encryption & Decryption: Securely store and retrieve passwords.

Installation

This is a Node.js module available through the npm registry.

Before installing, download and install Node.js. Node.js 0.10 or higher is required.

If this is a brand new project, make sure to create a package.json first with the npm init command.

Installation is done using the npm install command:

Install the package using npm/yarn:

npm install random-password-toolkit

or

yarn add random-password-toolkit

Options

The following options can be used with the password generation functions:

Usage

Importing the Package

const {
  generate,
  generateMultiple,
  generatePronounceablePassword,
  generateWithCustomPool,
  checkPasswordStrength,
  encryptPassword,
  decryptPassword
} = require('random-password-toolkit');

1. Generate a Random Password

Generate a single random password with customizable options:

const passwords = generate(5);
console.log(passwords);
// Output: yKsmtgtDsJ

const password = generate({
  length: 12,
  numbers: true,
  symbols: true,
  uppercase: true,
  strict: true
});
console.log(password);
// Output: @D8cP#9Zr2&f

2. Generate Multiple Passwords

Generate multiple passwords at once:

const passwords = generateMultiple(5);
console.log(passwords);
// Output: ['g8sFwLp4Rx', 'pR2zT9qMf7', ...]

const password = generateMultiple({
  length: 12,
  numbers: true,
  symbols: true,
  uppercase: true,
  strict: true
});
console.log(password);
// Output: ['Fi:G+D1oTU','jec*<KSP:3','Z@ie>^]n7Q','6&J4O12}e?','K$9J|xDv|Y']

3. Generate Pronounceable Passwords

Create passwords that are easier to pronounce:

const pronounceablePassword = generatePronounceablePassword(8);
console.log(pronounceablePassword);
// Output: bolozuna

4. Generate Password with Custom Pool

Generate passwords using a specific set of characters:

const customPassword = generateWithCustomPool(8, 'abcd');
console.log(customPassword);
// Output: 2c1ea3fb

5. Check Password Strength

Evaluate the strength of a password:

const strength = checkPasswordStrength('MyP@ssword123');
console.log(strength);
// Output: Very Strong

6. Encrypt a Password**

Securely encrypt a password:

const encryptedData = encryptPassword('MySecurePassword');
console.log('Encrypted Password:', encryptedData.encryptedPassword);
console.log('IV:', encryptedData.iv);
/* Output:
Encrypted Password: 7de8fc05ab01ed48605fa1983c830e98e13716f507b59bbf1203f7f1361ee497
IV: dc23c48d84eed6b07d89c479af6c5845*/

7. Decrypt a Password

Decrypt an encrypted password:

// Decrypt the password using the returned IV
const decryptedPassword = decryptPassword(encryptedData.encryptedPassword, encryptedData.iv);
console.log('Decrypted Password:', decryptedPassword);
// Output: MySecurePassword

8. Test generating zero secrets

Test generating zero secrets

try {
    console.log(generateMultiple(0));
  } catch (error) {
    console.error(error.message); // Expected: 'Amount must be greater than 0.'
  }

Community and Ecosystem

By using Random Password Toolkit, you are joining a growing community of developers who are passionate about secure passwords and encryption. We encourage you to share your experiences, ideas, and feedback on GitHub Discussions or any community platform of your choice.

• GitHub Discussions: Share use cases, report bugs, and suggest features.

We'd love to hear from you and see how you're using Random Password Toolkit in your projects!

Issues and Feedback

For issues, feedback, and feature requests, please open an issue on our GitHub Issues page. We actively monitor and respond to community feedback.

License

This project is licensed under the MIT License. See the LICENSE file for details.