cf-keys 1.1.0 → 1.1.2

package/README.md

@@ -4,7 +4,7 @@
 
 # `cf-keys`
 
-**Security & Utility Suite for Systems Engineering** <i>Modular toolkit for security, credential generation, and token automation in Node.js.</i>
+**Security & Utility Suite for Systems Engineering** <i>Modular toolkit for security, credential generation, and token automation in Node.js</i>
 
 <br/>
 
@@ -80,17 +80,23 @@ npm install cf-keys
 
 After global installation, you can access the suite using the `cf-keys` command. If run without arguments, it displays a professional dashboard with the status and version.
 
-### Common Commands & Examples:
+### ⚡ CLI Usage
 
-| Command    | Description               | Example                         |
-| ---------- | ------------------------- | ------------------------------- |
-| `jwt sign` | Interactive JWT signing   | `cf-keys jwt sign`              |
-| `password` | Generate a secure string  | `cf-keys password 32`           |
-| `youtube`  | Get YouTube bypass tokens | `cf-keys youtube`               |
-| `hash`     | Calculate file/text hash  | `cf-keys hash -a sha256 MyData` |
-| `utils`    | Base64/URL Encoding       | `cf-keys utils encode "hello"`  |
+After global installation, you can access the suite using the `cf-keys` command. If run without arguments, it displays a professional dashboard.
 
-**Pro Tip:** Use `cf-keys --help` to see all available flags and options for each module.
+| Command    | Description                               | Example                         |
+| ---------- | ----------------------------------------- | ------------------------------- |
+| `jwt sign` | **Interactive** or flag-based JWT signing | `cf-keys jwt sign`              |
+| `password` | Generate secure string (accepts length)   | `cf-keys password 32`           |
+| `youtube`  | Get YouTube `poToken` & `visitorData`     | `cf-keys youtube`               |
+| `hash`     | Calculate file/text integrity (SHA/MD5)   | `cf-keys hash -a sha256 MyData` |
+| `utils`    | Instant Base64/URL Encoding & Decoding    | `cf-keys utils encode "hello"`  |
+
+#### 💡 Pro Tips:
+
+- **Interactive JWT**: Running `cf-keys jwt sign` without flags triggers a guided wizard to safely collect your payload and secret key.
+- **Direct Arguments**: The `password` command now supports direct numeric values for faster credential generation.
+- **Help Menu**: Use `cf-keys --help` to explore all available flags and options for each specific module.
 
 ---
 

package/dist/Commands/jwt.js

@@ -8,9 +8,9 @@ const commander_1 = require("commander");
 const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
+const node_readline_1 = __importDefault(require("node:readline"));
 /**
  * Core logic to sign JWT tokens.
- * Can be imported directly into other projects for bot authentication.
  */
 const signJWT = (payload, secret, expires = "24h") => {
     const options = {
@@ -19,49 +19,74 @@ const signJWT = (payload, secret, expires = "24h") => {
     return jsonwebtoken_1.default.sign(payload, secret, options);
 };
 exports.signJWT = signJWT;
+const askQuestion = (query) => {
+    const rl = node_readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => rl.question(query, (ans) => {
+        rl.close();
+        resolve(ans);
+    }));
+};
 exports.jwtCmd = new commander_1.Command("jwt")
     .description("Generate and sign a JSON Web Token (JWT)")
     .option("-p, --payload <json>", "Token payload in JSON string format")
     .option("-f, --file <path>", "Path to a .json file containing the payload")
     .option("-a, --args <pairs...>", "Key-value pairs (e.g., user=admin role=dev)")
-    .requiredOption("-s, --secret <key>", "Secret key to sign")
+    .option("-s, --secret <key>", "Secret key to sign") // Cambiado a .option para manejar flujo manual
     .option("-e, --expires <time>", 'Expiration time (e.g., "1h", "7d")', "24h")
-    .action((options) => {
+    .action(async (options) => {
     try {
         let payloadObj = {};
-        if (options.file) {
-            const filePath = node_path_1.default.resolve(options.file);
-            if (!node_fs_1.default.existsSync(filePath)) {
-                throw new Error(`The file does not exist at: ${filePath}`);
-            }
-            payloadObj = JSON.parse(node_fs_1.default.readFileSync(filePath, "utf8"));
-        }
-        else if (options.payload) {
-            payloadObj = JSON.parse(options.payload);
-        }
-        else if (options.args) {
-            options.args.forEach((pair) => {
-                const [key, value] = pair.split("=");
-                if (key && value) {
-                    if (value === "true")
-                        payloadObj[key] = true;
-                    else if (value === "false")
-                        payloadObj[key] = false;
-                    else if (!isNaN(Number(value)))
-                        payloadObj[key] = Number(value);
-                    else
-                        payloadObj[key] = value;
-                }
-            });
+        let secret = options.secret;
+        if (!options.payload &&
+            !options.file &&
+            !options.args &&
+            !options.secret) {
+            console.log("🛠️  Interactive JWT Signing Mode");
+            const rawPayload = await askQuestion('Enter JSON payload (e.g. {"id":1}): ');
+            payloadObj = JSON.parse(rawPayload);
+            secret = await askQuestion("Enter secret key: ");
+            if (!secret)
+                throw new Error("Secret is required");
         }
         else {
-            throw new Error("You must provide a payload using -p, -f, or -a");
+            if (!secret)
+                throw new Error("Required option '-s, --secret <key>' not specified");
+            if (options.file) {
+                const filePath = node_path_1.default.resolve(options.file);
+                if (!node_fs_1.default.existsSync(filePath))
+                    throw new Error(`File not found: ${filePath}`);
+                payloadObj = JSON.parse(node_fs_1.default.readFileSync(filePath, "utf8"));
+            }
+            else if (options.payload) {
+                payloadObj = JSON.parse(options.payload);
+            }
+            else if (options.args) {
+                options.args.forEach((pair) => {
+                    const [key, value] = pair.split("=");
+                    if (key && value) {
+                        if (value === "true")
+                            payloadObj[key] = true;
+                        else if (value === "false")
+                            payloadObj[key] = false;
+                        else if (!isNaN(Number(value)))
+                            payloadObj[key] = Number(value);
+                        else
+                            payloadObj[key] = value;
+                    }
+                });
+            }
+            else {
+                throw new Error("You must provide a payload using -p, -f, or -a");
+            }
         }
-        const token = (0, exports.signJWT)(payloadObj, options.secret, options.expires);
+        const token = (0, exports.signJWT)(payloadObj, secret, options.expires);
         console.info(JSON.stringify({
+            status: "success",
             type: "jwt",
             token,
-            source: options.args ? "args" : options.file ? "file" : "payload",
             expiresIn: options.expires,
             decodedPayload: payloadObj,
         }, null, 2));

package/dist/Commands/password.js

@@ -24,26 +24,42 @@ const generateSecurePassword = (length = 16, includeNumbers = true, includeSymbo
     return password;
 };
 exports.generateSecurePassword = generateSecurePassword;
+/**
+ * CLI Command definition for password generation.
+ * Supports: cf-keys password [length] OR cf-keys password -l [length]
+ */
 exports.passwordCmd = new commander_1.Command("password")
     .description("Generates a cryptographically secure password")
-    .option("-l, --length <numero>", "Password length", "16")
+    .argument("[length]", "Password length (default: 16)")
+    .option("-l, --length <number>", "Password length (alternative option)")
     .option("--no-symbols", "Exclude special characters")
     .option("--no-numbers", "Exclude numbers")
-    .action((options) => {
+    .action((argLength, options) => {
     try {
-        const length = parseInt(options.length, 10);
-        const password = (0, exports.generateSecurePassword)(length, options.numbers, options.symbols);
+        const rawLength = argLength || options.length || "16";
+        const length = parseInt(rawLength, 10);
+        if (isNaN(length) || length <= 0) {
+            throw new Error("Invalid length. Please provide a positive number.");
+        }
+        const useNumbers = options.numbers !== false;
+        const useSymbols = options.symbols !== false;
+        const password = (0, exports.generateSecurePassword)(length, useNumbers, useSymbols);
         console.info(JSON.stringify({
+            status: "success",
             type: "password",
             value: password,
             length: length,
             config: {
-                symbols: options.symbols,
-                numbers: options.numbers,
+                symbols: useSymbols,
+                numbers: useNumbers,
             },
         }, null, 2));
     }
     catch (error) {
-        console.error(JSON.stringify({ status: "error", details: error.message }, null, 2));
+        console.error(JSON.stringify({
+            status: "error",
+            message: "Failed to generate password",
+            details: error.message,
+        }, null, 2));
     }
 });

package/dist/index.js

@@ -59,9 +59,11 @@ program
     .action(() => {
     showWelcomeBanner();
 });
+const jwtGroup = new commander_1.Command("jwt").description("JWT Management & Signing");
+jwtGroup.addCommand(jwt_1.jwtCmd.name("sign"));
 program.addCommand(password_1.passwordCmd);
 program.addCommand(youtube_1.youtubeCmd);
-program.addCommand(jwt_1.jwtCmd);
+program.addCommand(jwtGroup);
 program.addCommand(hash_1.hashCmd);
 program.addCommand(utils_1.utilsCmd);
 program.parse(node_process_1.default.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cf-keys",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Suite global de generación de claves y credenciales",
   "main": "dist/lib.js",
   "types": "dist/lib.d.ts",