🔐 pass-utils

Secure, customizable password generator for Node.js — supports complexity rules, exclusions, and bulk generation.

Features

• ✅ Fully customizable password composition
• ✅ Specify minimum requirements (uppercase, lowercase, numbers, symbols)
• ✅ Exclude similar or specific characters
• ✅ Generate one or multiple passwords
• ✅ Uses crypto.getRandomValues() for secure randomness
• ✅ Zero dependencies

---

Installation

npm install pass-utils

Usage

const { generatePassword } = require("pass-utils");

const password = generatePassword(16, {
  uppercase: true,
  lowercase: true,
  numbers: true,
  symbols: true,
  similar: false,
  exclude: "aeiou",
}, {
  minUpper: 2,
  minLower: 4,
  minNumbers: 2,
  minSymbols: 2,
});

console.log(password); // Output: "Kf#7gR!cP2xMbL9q"

Generating multiple passwords

const { generateMultiplePasswords } = require("pass-utils");

const passwords = generateMultiplePasswords(5, 12, {
  symbols: false,
  similar: true,
}, {
  minUpper: 1,
  minLower: 3,
  minNumbers: 2,
});

console.log(passwords);
/*
Output:
[
  'gZ0rWx8BkpAf',
  'uzhB3yDA0wkd',
  'MkwbpZ08uhxy',
  '2WyuDfR6vhga',
  '3bHJw96zFqmt'
]
*/

API

generatePassword(length, options?, requirements?)

Parameter	Type	Description
length	number	Length of the generated password
options	object	Optional settings for character types and exclusions (default: all enabled)
requirements	object	Optional requirements for minimum characters per type

Options object

Parameter	Type	Default	Description
uppercase	boolean	true	Include uppercase letters
lowercase	boolean	true	Include lowercase letters
numbers	boolean	true	Include numbers
symbols	boolean	true	Include special characters
similar	boolean	true	Allow similar-looking characters (like O, 0, l, 1)
exclude	string	""	Custom string of characters to exclude

Requirements object

Key	Type	Default	Description
minUpper	number	0	Minimum number of uppercase characters
minLower	number	0	Minimum number of lowercase characters
minNumbers	number	0	Minimum number of numeric characters
minSymbols	number	0	Minimum number of special characters