password-presets (JavaScript)

Cryptographically secure, preset-based password generation for Node.js.
Zero dependencies. ESM only. TypeScript types included.

Full documentation (presets, security notes, cross-language parity) lives in the repository README.

Layout

| File | Role | |------|------| | index.js | Public API: generate, inspect, presets | | presets.js | Preset definitions | | generate.js | Character and passphrase generation | | crypto.js | crypto.randomBytes helpers | | wordlist.js | EFF large wordlist | | inspect.js | Preset metadata and entropy helpers | | password-presets.js | CLI (password-presets bin) | | index.d.ts | TypeScript declarations | | index.test.js | Node test runner tests |

Install

From npm:

npm install password-presets

From a clone of this repo (from the repository root):

npm install ./js

Usage

import { generate, inspect, presets } from "password-presets";

generate("human");
inspect("human");
presets();

CLI

npx password-presets
npx password-presets token --count 3
npx password-presets --list

Requirements

• Node.js ≥ 18

Development

cd js
npm test

Publish (maintainers):

cd js
npm publish