devils-dice 1.0.0

package/README.md

@@ -0,0 +1,22 @@
+# devils-dice 🔐
+
+A cryptographically secure random password generator for Node.js.
+
+Built using Node's `crypto` module and follows modern password security best practices.
+
+---
+
+## Features
+
+- Secure randomness using `crypto.randomInt`
+- Supports ESM and CommonJS
+- Enforces strong password rules
+- Customizable length and character sets
+- Zero dependencies
+
+---
+
+## Installation
+
+```bash
+npm install devils-dice

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "devils-dice",
+  "version": "1.0.0",
+  "description": "Cryptographically secure random password generator",
+  "type": "module",
+  "types": "./src/index.d.ts",
+  "main": "./src/index.cjs",
+  "module": "./src/index.js",
+  "exports": {
+    "import": "./src/index.js",
+    "require": "./src/index.cjs"
+  },
+  "files": [
+    "src"
+  ],
+  "author": "souvik_maji_99",
+  "keywords": [
+    "password",
+    "password-generator",
+    "security",
+    "crypto"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Devil-99/devils-dice.git"
+  }
+}

package/src/index.cjs

@@ -0,0 +1,71 @@
+const crypto = require("crypto");
+
+/**
+ * Generate a secure random password
+ */
+function generatePassword({
+  length = 8,
+  uppercase = true,
+  lowercase = true,
+  numbers = true,
+  symbols = true
+} = {}) {
+  if (length < 8) {
+    throw new Error("Password length must be at least 8 characters");
+  }
+
+  const upper = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+  const lower = "abcdefghijklmnopqrstuvwxyz";
+  const digits = "0123456789";
+  const special = "!@#$%^&*()";
+
+  let allowedChars = "";
+  const requiredChars = [];
+
+  if (uppercase) {
+    allowedChars += upper;
+    requiredChars.push(getRandomChar(upper));
+  }
+
+  if (lowercase) {
+    allowedChars += lower;
+    requiredChars.push(getRandomChar(lower));
+  }
+
+  if (numbers) {
+    allowedChars += digits;
+    requiredChars.push(getRandomChar(digits));
+  }
+
+  if (symbols) {
+    allowedChars += special;
+    requiredChars.push(getRandomChar(special));
+  }
+
+  if (!allowedChars) {
+    throw new Error("At least one character type must be enabled");
+  }
+
+  const remainingLength = length - requiredChars.length;
+  const passwordChars = [...requiredChars];
+
+  for (let i = 0; i < remainingLength; i++) {
+    passwordChars.push(getRandomChar(allowedChars));
+  }
+
+  return shuffleArray(passwordChars).join("");
+}
+
+function getRandomChar(charset) {
+  return charset[crypto.randomInt(0, charset.length)];
+}
+
+function shuffleArray(array) {
+  for (let i = array.length - 1; i > 0; i--) {
+    const j = crypto.randomInt(0, i + 1);
+    [array[i], array[j]] = [array[j], array[i]];
+  }
+  return array;
+}
+
+module.exports = { generatePassword };

package/src/index.d.ts

@@ -0,0 +1,11 @@
+export interface GeneratePasswordOptions {
+  length?: number;
+  uppercase?: boolean;
+  lowercase?: boolean;
+  numbers?: boolean;
+  symbols?: boolean;
+}
+
+export function generatePassword(
+  options?: GeneratePasswordOptions
+): string;

package/src/index.js

@@ -0,0 +1,85 @@
+import crypto from "crypto";
+
+/**
+ * Generate a secure random password
+ * @param {Object} options
+ * @param {number} options.length - Password length (min 8)
+ * @param {boolean} options.uppercase
+ * @param {boolean} options.lowercase
+ * @param {boolean} options.numbers
+ * @param {boolean} options.symbols
+ * @returns {string}
+ */
+
+export function generatePassword({
+  length = 8,
+  uppercase = true,
+  lowercase = true,
+  numbers = true,
+  symbols = true
+} = {}) {
+  if (length < 8) {
+    throw new Error("Password length must be at least 8 characters");
+  }
+
+  const upper = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+  const lower = "abcdefghijklmnopqrstuvwxyz";
+  const digits = "0123456789";
+  const special = "!@#$%^&*()";
+
+  let allowedChars = "";
+  const requiredChars = [];
+
+  if (uppercase) {
+    allowedChars += upper;
+    requiredChars.push(getRandomChar(upper));
+  }
+
+  if (lowercase) {
+    allowedChars += lower;
+    requiredChars.push(getRandomChar(lower));
+  }
+
+  if (numbers) {
+    allowedChars += digits;
+    requiredChars.push(getRandomChar(digits));
+  }
+
+  if (symbols) {
+    allowedChars += special;
+    requiredChars.push(getRandomChar(special));
+  }
+
+  if (!allowedChars) {
+    throw new Error("At least one character type must be enabled");
+  }
+
+  const remainingLength = length - requiredChars.length;
+  const passwordChars = [...requiredChars];
+
+  for (let i = 0; i < remainingLength; i++) {
+    passwordChars.push(getRandomChar(allowedChars));
+  }
+
+  // Shuffle to avoid predictable positions
+  return shuffleArray(passwordChars).join("");
+}
+
+/**
+ * Get a cryptographically secure random character
+ */
+function getRandomChar(charset) {
+  const index = crypto.randomInt(0, charset.length);
+  return charset[index];
+}
+
+/**
+ * Fisher-Yates shuffle using crypto randomness
+ */
+function shuffleArray(array) {
+  for (let i = array.length - 1; i > 0; i--) {
+    const j = crypto.randomInt(0, i + 1);
+    [array[i], array[j]] = [array[j], array[i]];
+  }
+  return array;
+}