rkeygen 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, Gideon Onyegbula
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# random_key_generator
+
+`random_key_generator` is a small Node.js CLI for generating random values for local development, secrets, and quick one-off copies to the clipboard.
+
+## Features
+
+- Generate random hexadecimal strings.
+- Generate UUIDs.
+- Generate passwords with a configurable length.
+- Print a ready-to-use environment variable block.
+- Copy generated values directly to the clipboard.
+
+## Installation
+
+Install the package locally:
+
+```bash
+npm install
+```
+
+If you want to use the CLI globally during development, link it:
+
+```bash
+npm link
+```
+
+## Usage
+
+The CLI is exposed as `rk`.
+
+```bash
+rk
+```
+
+Generate a hex string of a specific length:
+
+```bash
+rk 32
+```
+
+Generate a UUID:
+
+```bash
+rk uuid
+```
+
+Generate a password:
+
+```bash
+rk pass
+rk pass 24
+```
+
+Print a sample environment block:
+
+```bash
+rk env
+```
+
+Copy a generated value to the clipboard:
+
+```bash
+rk copy
+rk copy pass
+rk copy uuid
+```
+
+## Command Reference
+
+| Command | Description |
+| --- | --- |
+| `rk` | Prints a random hexadecimal string with the default length. |
+| `rk <number>` | Prints a hexadecimal string with the requested length. |
+| `rk uuid` | Prints a random UUID. |
+| `rk pass` | Prints a random password with the default length. |
+| `rk pass <number>` | Prints a password with the requested length. |
+| `rk env` | Prints a sample set of environment variables for app setup. |
+| `rk copy` | Copies a default hex string to the clipboard. |
+| `rk copy pass` | Copies a generated password to the clipboard. |
+| `rk copy uuid` | Copies a generated UUID to the clipboard. |
+
+## Examples
+
+```bash
+$ rk
+488c319f0dca10ab0989447a021eb8b82dff76c6ecc4718448fbeda381d78f67
+```
+
+```bash
+$ rk pass 12
+Mq91c6cl6sP*
+```
+
+```bash
+$ rk env
+PORT=3000
+JWT_SECRET=...
+DB_PASSWORD=...
+DB_NAME=mydatabase
+SESSION_SECRET=...
+COOKIE_SECRET=...
+PASSWORD=...
+```
+
+## Project Structure
+
+```text
+package.json
+bin/rk.js
+```
+
+## Notes
+
+- The CLI uses Node's built-in `crypto` module for randomness.
+- Clipboard support is provided by `clipboardy`.

package/bin/rk.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+
+import crypto from "crypto";
+import clipboard from "clipboardy";
+const arg = process.argv[2];
+const option = process.argv[3];
+
+
+
+function randomHex(length = 64) {
+	return crypto
+		.randomBytes(Math.ceil(length / 2))
+		.toString("hex")
+		.slice(0, length);
+}
+function randomPassword(length = 16) {
+	const chars =
+		"ABCDEFGHIJKLMNOPQRSTUVWXYZ" +
+		"abcdefghijklmnopqrstuvwxyz" +
+		"0123456789" +
+		"!@#$%^&*";
+
+	let password = "";
+
+	for (let i = 0; i < length; i++) {
+		const index = crypto.randomInt(0, chars.length);
+		password += chars[index];
+	}
+	return password;
+}
+
+
+
+
+if (!arg) {
+	console.log(randomHex());
+	process.exit(0);
+}
+if (arg === "env") {
+    console.log(`PORT=3000`);
+	console.log(`JWT_SECRET=${randomHex(64)}`);
+    console.log(`DB_PASSWORD=${randomPassword(16)}`);
+    console.log(`DB_NAME=mydatabase`);
+	console.log(`SESSION_SECRET=${randomHex(64)}`);
+	console.log(`COOKIE_SECRET=${randomHex(64)}`);
+	console.log(`PASSWORD=${randomPassword(16)}`);
+	process.exit(0);
+}
+const length = Number(arg);
+if (!Number.isNaN(length)) {
+	console.log(randomHex(length));
+	process.exit(0);
+}
+if (arg === "uuid") {
+	console.log(crypto.randomUUID());
+	process.exit(0);
+}
+if (arg === "pass" && option) {
+    const length = Number(option) || 16;
+	console.log(randomPassword(length));
+	process.exit(0);
+}
+if (arg === "pass") {
+    console.log(randomPassword());
+    process.exit(0);
+}
+if (arg === "copy") {
+	const target = process.argv[3];
+
+	let value;
+
+	switch (target) {
+		case "pass":
+			value = randomPassword();
+			break;
+
+		case "uuid":
+			value = crypto.randomUUID();
+			break;
+
+		default:
+			value = randomHex();
+	}
+
+	await clipboard.write(value);
+
+	console.log("Copied to clipboard");
+	process.exit(0);
+}
+
+
+console.error("Invalid argument");
+process.exit(1);

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "rkeygen",
+  "version": "1.0.0",
+  "description": "a simple random key generator built with nodejs",
+  "bin": {
+    "rk": "./bin/rk.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": ["random", "key", "generator", "password", "uuid", "nodejs", "cli", "clipboard"],
+  "author": "GFrosh",
+  "license": "ISC",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GFrosh/Key-Generator.git"
+  },
+  "homepage": "https://github.com/GFrosh/Key-Generator#readme",
+  "bugs": {
+    "url": "https://github.com/GFrosh/Key-Generator/issues"
+  },
+  "dependencies": {
+    "clipboardy": "^5.3.1"
+  }
+}