password-genie-cli 2.0.0

package/PUBLISH.md

@@ -0,0 +1,68 @@
+# Publishing Guide
+
+## Prerequisites
+
+- Node.js 14+
+- npm account ([sign up](https://www.npmjs.com/signup))
+
+## Steps
+
+### 1. Log in to npm
+
+```sh
+npm login
+```
+
+Enter your username, password, and email when prompted.
+
+### 2. Update the version (optional)
+
+```sh
+# Patch (bug fixes) — 1.0.0 → 1.0.1
+npm version patch
+
+# Minor (new features, backward-compatible) — 1.0.0 → 1.1.0
+npm version minor
+
+# Major (breaking changes) — 1.0.0 → 2.0.0
+npm version major
+```
+
+### 3. Publish
+
+```sh
+npm publish
+```
+
+### 4. Verify
+
+Visit `https://www.npmjs.com/package/password-genie` or run:
+
+```sh
+npm view password-genie
+```
+
+## Updating
+
+Make changes, bump the version, then publish again:
+
+```sh
+npm version patch
+npm publish
+```
+
+## Scoped packages (optional)
+
+If you want to publish under your username scope (e.g. `@yourusername/password-genie`):
+
+1. Change `name` in `package.json` to `@yourusername/password-genie`
+2. Run `npm publish --access public`
+
+## Useful commands
+
+| Command                        | Description                |
+| ------------------------------ | -------------------------- |
+| `npm whoami`                   | Check logged-in user       |
+| `npm logout`                   | Log out                    |
+| `npm unpublish <pkg>@<ver>`    | Remove a specific version  |
+| `npm deprecate <pkg>@<ver> <msg>` | Deprecate a version    |

package/README.md

@@ -0,0 +1,52 @@
+# password-genie
+
+A simple and secure password generator that creates random, unique passwords based on user-defined length and complexity requirements.
+
+## Install
+
+```sh
+npm install password-genie
+```
+
+## Usage
+
+```js
+const passwordGenie = require('password-genie');
+
+// Generate a password of length 12 with default complexity (lowercase only)
+const password = passwordGenie.generate(12);
+console.log(password); // e.g. "kqxjwmfobqje"
+
+// Generate a password of length 16 with custom complexity
+const complexPassword = passwordGenie.generate(16, {
+  uppercase: true,
+  numbers: true,
+  specialChars: true,
+});
+console.log(complexPassword); // e.g. "Y7$hL2#pQ9!mZ4&x"
+```
+
+## API
+
+### `generate(length, options)`
+
+| Param     | Type   | Default | Description                       |
+| --------- | ------ | ------- | --------------------------------- |
+| `length`  | number | —       | Length of the password to generate |
+| `options` | object | `{}`    | Complexity options (see below)    |
+
+**Options**
+
+| Property       | Type    | Default | Description                |
+| -------------- | ------- | ------- | -------------------------- |
+| `uppercase`    | boolean | `false` | Include uppercase letters  |
+| `numbers`      | boolean | `false` | Include numbers            |
+| `specialChars` | boolean | `false` | Include special characters |
+
+## Security
+
+Uses Node.js `crypto.randomInt` — a cryptographically secure pseudo-random number generator (CSPRNG). No modulo bias.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,39 @@
+const crypto = require('crypto');
+
+const LOWERCASE = 'abcdefghijklmnopqrstuvwxyz';
+const UPPERCASE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+const DIGITS = '0123456789';
+const SPECIAL = '!@#$%^&*()_+~`|}{[]:;?><,./-=';
+
+function getRandomChar(charSet) {
+  const index = crypto.randomInt(charSet.length);
+  return charSet[index];
+}
+
+function generate(length, options = {}) {
+  let charSet = LOWERCASE;
+  let password = '';
+
+  if (options.uppercase) {
+    password += getRandomChar(UPPERCASE);
+    charSet += UPPERCASE;
+  }
+
+  if (options.numbers) {
+    password += getRandomChar(DIGITS);
+    charSet += DIGITS;
+  }
+
+  if (options.specialChars) {
+    password += getRandomChar(SPECIAL);
+    charSet += SPECIAL;
+  }
+
+  for (let i = password.length; i < length; i++) {
+    password += getRandomChar(charSet);
+  }
+
+  return password;
+}
+
+module.exports = { generate };

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "password-genie-cli",
+  "version": "2.0.0",
+  "description": "A simple and secure password generator that creates random, unique passwords based on user-defined length and complexity requirements.",
+  "main": "index.js",
+  "scripts": {
+    "test": "jest"
+  },
+  "keywords": [
+    "password",
+    "generator",
+    "security",
+    "crypto"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "jest": "^29.0.0"
+  }
+}

package/test.js

@@ -0,0 +1,35 @@
+const passwordGenie = require('./index');
+
+describe('passwordGenie', () => {
+  it('generates a password of the specified length', () => {
+    const password = passwordGenie.generate(12);
+    expect(password.length).toBe(12);
+  });
+
+  it('includes uppercase letters when requested', () => {
+    const password = passwordGenie.generate(12, { uppercase: true });
+    expect(password).toEqual(expect.stringMatching(/[A-Z]/));
+  });
+
+  it('includes numbers when requested', () => {
+    const password = passwordGenie.generate(12, { numbers: true });
+    expect(password).toEqual(expect.stringMatching(/[0-9]/));
+  });
+
+  it('includes special characters when requested', () => {
+    const password = passwordGenie.generate(12, { specialChars: true });
+    expect(password).toEqual(expect.stringMatching(/[^a-zA-Z0-9]/));
+  });
+
+  it('includes all character types when all options enabled', () => {
+    const password = passwordGenie.generate(20, {
+      uppercase: true,
+      numbers: true,
+      specialChars: true,
+    });
+    expect(password.length).toBe(20);
+    expect(password).toEqual(expect.stringMatching(/[A-Z]/));
+    expect(password).toEqual(expect.stringMatching(/[0-9]/));
+    expect(password).toEqual(expect.stringMatching(/[^a-zA-Z0-9]/));
+  });
+});