cf-keys 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [Tu Nombre Real o Usuario]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,116 @@
+<div align="center">
+  <br />
+ <p align="center">
+  <img src="https://raw.githubusercontent.com/choco-latito29/choco-latito29/main/Assets/cf-keys.png" width="150" alt="cf-keys-logo">
+</p>
+  
+  <h1><code>cf-keys</code></h1>
+  
+  <p align="center">
+    <strong>Security & Utility Suite for Systems Engineering</strong>
+    <br />
+    <i>Una navaja suiza modular para la gestión de credenciales, seguridad JWT y automatización de tokens.</i>
+  </p>
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/cf-keys?style=for-the-badge&logo=npm&logoColor=white" alt="npm version" />
+  <img src="https://img.shields.io/npm/dt/cf-keys?style=for-the-badge&logo=npm&logoColor=white" alt="npm downloads" />
+  <img src="https://img.shields.io/github/license/tu-usuario/cf-keys?style=for-the-badge&logo=github&logoColor=white" alt="license" />
+  <img src="https://img.shields.io/badge/Node.js-18+-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node.js" />
+  <img src="https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript" />
+</p>
+
+  <p align="center">
+    <a href="#-características">Características</a> •
+    <a href="#-instalación">Instalación</a> •
+    <a href="#-uso-programático">Uso Programático</a> •
+    <a href="#-licencia">Licencia</a>
+  </p>
+</div>
+
+<hr />
+
+## ✨ Características Principales
+
+<table width="100%">
+  <tr>
+    <td width="50%" style="border: none; vertical-align: top;">
+      <h3>🔐 Módulos de Seguridad</h3>
+      <ul>
+        <li><strong>JWT Engine:</strong> Firma tokens con algoritmos industriales para bots y dashboards.</li>
+        <li><strong>Secure Passwords:</strong> Generación aleatoria con alta entropía mediante <code>node:crypto</code>.</li>
+        <li><strong>Hash Integrity:</strong> Verificación de archivos vía MD5, SHA-256 y SHA-512.</li>
+      </ul>
+    </td>
+    <td width="50%" style="border: none; vertical-align: top;">
+      <h3>🛠️ Utilidades de Infraestructura</h3>
+      <ul>
+        <li><strong>YouTube Auth:</strong> Extracción automática de <code>poToken</code> y <code>visitorData</code> para bots de música.</li>
+        <li><strong>Data Utils:</strong> Encoding y Decoding instantáneo para Base64 y URL.</li>
+        <li><strong>Hybrid Architecture:</strong> Funciona como comando CLI global y como SDK para Node.js.</li>
+      </ul>
+    </td>
+  </tr>
+</table>
+
+## 🚀 Instalación
+
+### Uso Global (Terminal)
+
+Ideal para tareas rápidas de administración de servidores o cualquier parte del mundo:
+
+```bash
+npm install -g cf-keys
+
+```
+
+### Como Dependencia (Bots/Backend)
+
+Instala `cf-keys` en tus proyectos de **Discord.js**:
+
+```bash
+npm install cf-keys
+
+```
+
+## 💻 Uso Programático (SDK)
+
+Gracias a su arquitectura de entrada dual, puedes importar la lógica pura directamente en tu código de **TypeScript** o **JavaScript**:
+
+```typescript
+import { signJWT, getYoutubeTokens, generateSecurePassword } from "cf-keys";
+
+async function setupBot() {
+  // Generar tokens para bypass de YouTube
+  const tokens = await getYoutubeTokens();
+
+  // Firmar acceso para el dashboard de ChocoFactory.dev
+  const token = signJWT({ bot: "KiwiChan" }, "tu_secreto_secreta");
+
+  // Generar credenciales de base de datos
+  const dbPass = generateSecurePassword(32);
+
+  console.log({ tokens, token, dbPass });
+}
+```
+
+## 🛠️ Stack Tecnológico
+
+<div align="left">
+  <img src="https://img.shields.io/badge/Node.js-339933?style=flat-square&logo=nodedotjs&logoColor=white" alt="Node.js Badge" />
+  <img src="https://img.shields.io/badge/TypeScript-007ACC?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript Badge" />
+  <img src="https://img.shields.io/badge/Commander.js-FFD700?style=flat-square&logo=commanderdotjs&logoColor=black" alt="Commander.js Badge" />
+  <img src="https://img.shields.io/badge/JSONWebToken-black?style=flat-square&logo=jsonwebtokens&logoColor=white" alt="JWT Badge" />
+</div>
+
+## 📄 Licencia
+
+Este proyecto está bajo la **Licencia MIT**. Esto significa que puedes usarlo libremente en tus proyectos personales o comerciales siempre que mantengas la atribución original.
+
+---
+
+<div align="center">
+
+<a href="https://www.google.com/search?q=https://chocofactory.dev"><strong>Visitar ChocoFactory.dev</strong></a>
+
+</div>

package/dist/Commands/hash.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashCmd = exports.generateHash = void 0;
+const commander_1 = require("commander");
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Core logic for generating hashes.
+ * Can be imported directly into other projects.
+ */
+const generateHash = (data, algo = "sha256") => {
+    return node_crypto_1.default.createHash(algo).update(data).digest("hex");
+};
+exports.generateHash = generateHash;
+exports.hashCmd = new commander_1.Command("hash")
+    .description("Generate a cryptographic hash for text or files")
+    .argument("<data>", "The text or file path to hash")
+    .option("-a, --algo <algorithm>", "Hash algorithm (sha256, sha512, md5)", "sha256")
+    .option("-f, --file", "Treat data as a file path")
+    .action((data, options) => {
+    try {
+        let content = data;
+        if (options.file) {
+            const filePath = node_path_1.default.resolve(data);
+            if (!node_fs_1.default.existsSync(filePath))
+                throw new Error("File not found");
+            content = node_fs_1.default.readFileSync(filePath);
+        }
+        const hash = (0, exports.generateHash)(content, options.algo);
+        console.info(JSON.stringify({
+            type: "hash",
+            algorithm: options.algo,
+            input: options.file ? "file" : "text",
+            result: hash,
+        }, null, 2));
+    }
+    catch (error) {
+        console.error(JSON.stringify({ status: "error", details: error.message }, null, 2));
+    }
+});

package/dist/Commands/jwt.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jwtCmd = exports.signJWT = void 0;
+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"));
+/**
+ * Core logic to sign JWT tokens.
+ * Can be imported directly into other projects for bot authentication.
+ */
+const signJWT = (payload, secret, expires = "24h") => {
+    const options = {
+        expiresIn: expires,
+    };
+    return jsonwebtoken_1.default.sign(payload, secret, options);
+};
+exports.signJWT = signJWT;
+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("-e, --expires <time>", 'Expiration time (e.g., "1h", "7d")', "24h")
+    .action((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;
+                }
+            });
+        }
+        else {
+            throw new Error("You must provide a payload using -p, -f, or -a");
+        }
+        const token = (0, exports.signJWT)(payloadObj, options.secret, options.expires);
+        console.info(JSON.stringify({
+            type: "jwt",
+            token,
+            source: options.args ? "args" : options.file ? "file" : "payload",
+            expiresIn: options.expires,
+            decodedPayload: payloadObj,
+        }, null, 2));
+    }
+    catch (error) {
+        console.error(JSON.stringify({
+            status: "error",
+            message: "Error in JWT generation",
+            details: error.message,
+        }, null, 2));
+    }
+});

package/dist/Commands/password.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.passwordCmd = exports.generateSecurePassword = void 0;
+const commander_1 = require("commander");
+const node_crypto_1 = __importDefault(require("node:crypto"));
+/**
+ * Core logic for secure password generation.
+ * This can be imported by your Discord bots or backend services.
+ */
+const generateSecurePassword = (length = 16, includeNumbers = true, includeSymbols = true) => {
+    let charset = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+    if (includeNumbers)
+        charset += "0123456789";
+    if (includeSymbols)
+        charset += "!@#$%^&*()_+~`|}{[]:;?><,./-=";
+    let password = "";
+    for (let i = 0; i < length; i++) {
+        const randomIndex = node_crypto_1.default.randomInt(0, charset.length);
+        password += charset[randomIndex];
+    }
+    return password;
+};
+exports.generateSecurePassword = generateSecurePassword;
+exports.passwordCmd = new commander_1.Command("password")
+    .description("Generates a cryptographically secure password")
+    .option("-l, --length <numero>", "Password length", "16")
+    .option("--no-symbols", "Exclude special characters")
+    .option("--no-numbers", "Exclude numbers")
+    .action((options) => {
+    try {
+        const length = parseInt(options.length, 10);
+        const password = (0, exports.generateSecurePassword)(length, options.numbers, options.symbols);
+        console.info(JSON.stringify({
+            type: "password",
+            value: password,
+            length: length,
+            config: {
+                symbols: options.symbols,
+                numbers: options.numbers,
+            },
+        }, null, 2));
+    }
+    catch (error) {
+        console.error(JSON.stringify({ status: "error", details: error.message }, null, 2));
+    }
+});

package/dist/Commands/utils.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.utilsCmd = exports.decodeData = exports.encodeData = void 0;
+const commander_1 = require("commander");
+/**
+ * Core logic for encoding data.
+ * Useful for Cloudflare API integrations or bot metadata.
+ */
+const encodeData = (text, isUrl = false) => {
+    return isUrl
+        ? encodeURIComponent(text)
+        : Buffer.from(text).toString("base64");
+};
+exports.encodeData = encodeData;
+/**
+ * Core logic for decoding data.
+ */
+const decodeData = (data, isUrl = false) => {
+    return isUrl
+        ? decodeURIComponent(data)
+        : Buffer.from(data, "base64").toString("utf8");
+};
+exports.decodeData = decodeData;
+exports.utilsCmd = new commander_1.Command("utils").description("Data encoding and decoding utilities");
+exports.utilsCmd
+    .command("encode")
+    .description("Encode text to Base64 or URL format")
+    .argument("<text>", "Text to encode")
+    .option("-u, --url", "Use URL encoding instead of Base64")
+    .action((text, options) => {
+    const result = (0, exports.encodeData)(text, options.url);
+    console.log(JSON.stringify({ action: "encode", result }, null, 2));
+});
+exports.utilsCmd
+    .command("decode")
+    .description("Decode Base64 or URL formatted text")
+    .argument("<data>", "Data to decode")
+    .option("-u, --url", "Use URL decoding instead of Base64")
+    .action((data, options) => {
+    try {
+        const result = (0, exports.decodeData)(data, options.url);
+        console.log(JSON.stringify({ action: "decode", result }, null, 2));
+    }
+    catch (error) {
+        console.error(JSON.stringify({ status: "error", details: "Invalid input" }, null, 2));
+    }
+});

package/dist/Commands/youtube.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.youtubeCmd = exports.getYoutubeTokens = void 0;
+const commander_1 = require("commander");
+const youtube_po_token_generator_1 = require("youtube-po-token-generator");
+/**
+ * Core logic to generate YouTube tokens.
+ * Essential for bypass systems in Music Bots like Kiwi Chan.
+ */
+const getYoutubeTokens = async () => {
+    return await (0, youtube_po_token_generator_1.generate)();
+};
+exports.getYoutubeTokens = getYoutubeTokens;
+exports.youtubeCmd = new commander_1.Command("youtube")
+    .description("Generate a valid token and visitor data from YouTube.")
+    .action(async () => {
+    try {
+        const tokens = await (0, exports.getYoutubeTokens)();
+        console.info(JSON.stringify({
+            type: "youtube_tokens",
+            visitorData: tokens.visitorData,
+            poToken: tokens.poToken,
+            timestamp: new Date().toISOString(),
+        }, null, 2));
+    }
+    catch (error) {
+        console.error(JSON.stringify({
+            status: "error",
+            message: "Failed to generate YouTube tokens.",
+            details: error.message,
+        }, null, 2));
+    }
+});

package/dist/index.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const password_1 = require("./Commands/password");
+const youtube_1 = require("./Commands/youtube");
+const jwt_1 = require("./Commands/jwt");
+const hash_1 = require("./Commands/hash");
+const utils_1 = require("./Commands/utils");
+const node_process_1 = __importDefault(require("node:process"));
+const boxen_1 = __importDefault(require("boxen"));
+const chalk_1 = __importDefault(require("chalk"));
+const program = new commander_1.Command();
+const logo = chalk_1.default.cyan.bold(`
+   ______ ______     __  __ ______ __     __  _____
+  / ____// ____/    / / / // ____/ \\ \\   / / / ___/
+ / /    / /__      / /_/ // __/     \\ \\_/ /  \\__ \\ 
+/ /___ / ___/     / __  // /___      \\   /  ___/ / 
+\\____//_/        /_/ /_//_____/       /_/  /____/  
+`);
+const welcomeBanner = (0, boxen_1.default)(`${logo}\n` +
+    chalk_1.default.blueBright.bold(" ➔ Security & Utility Suite for Systems Engineering ") +
+    "\n" +
+    chalk_1.default.dim("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━") +
+    "\n" +
+    chalk_1.default.white(" Author: ") +
+    chalk_1.default.cyan("@tu_usuario") +
+    chalk_1.default.gray(" | ") +
+    chalk_1.default.white("Version: ") +
+    chalk_1.default.green("1.0.0"), {
+    padding: 1,
+    margin: { top: 1, bottom: 1, right: 0, left: 0 },
+    borderStyle: "round",
+    borderColor: "cyan",
+    backgroundColor: "#1e1e1e",
+});
+program
+    .name("cf-keys")
+    .description("A CLI tool to manage Cloudflare API keys and security tokens")
+    .version("1.0.0")
+    .action(() => {
+    console.clear();
+    console.log(welcomeBanner);
+    program.help();
+});
+program
+    .command("ping")
+    .description("Ping the Cloudflare API to check connectivity")
+    .action(() => {
+    console.info(JSON.stringify({
+        status: "success",
+        message: "Pong! Cloudflare API is reachable.",
+    }, null, 2));
+});
+program.addCommand(password_1.passwordCmd);
+program.addCommand(youtube_1.youtubeCmd);
+program.addCommand(jwt_1.jwtCmd);
+program.addCommand(hash_1.hashCmd);
+program.addCommand(utils_1.utilsCmd);
+program.parse(node_process_1.default.argv);

package/dist/lib.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeData = exports.encodeData = exports.generateSecurePassword = exports.getYoutubeTokens = exports.signJWT = exports.generateHash = void 0;
+var hash_1 = require("./Commands/hash");
+Object.defineProperty(exports, "generateHash", { enumerable: true, get: function () { return hash_1.generateHash; } });
+var jwt_1 = require("./Commands/jwt");
+Object.defineProperty(exports, "signJWT", { enumerable: true, get: function () { return jwt_1.signJWT; } });
+var youtube_1 = require("./Commands/youtube");
+Object.defineProperty(exports, "getYoutubeTokens", { enumerable: true, get: function () { return youtube_1.getYoutubeTokens; } });
+var password_1 = require("./Commands/password");
+Object.defineProperty(exports, "generateSecurePassword", { enumerable: true, get: function () { return password_1.generateSecurePassword; } });
+var utils_1 = require("./Commands/utils");
+Object.defineProperty(exports, "encodeData", { enumerable: true, get: function () { return utils_1.encodeData; } });
+Object.defineProperty(exports, "decodeData", { enumerable: true, get: function () { return utils_1.decodeData; } });

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "cf-keys",
+  "version": "1.0.0",
+  "description": "Suite global de generación de claves y credenciales",
+  "main": "dist/lib.js",
+  "types": "dist/lib.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "security",
+    "cloudflare",
+    "jwt",
+    "youtube-token",
+    "systems-engineering"
+  ],
+  "author": "",
+  "license": "MIT",
+  "module": "CommonJS",
+  "bin": {
+    "cf-keys": "dist/index.js"
+  },
+  "dependencies": {
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "commander": "^14.0.3",
+    "jsonwebtoken": "^9.0.3",
+    "youtube-po-token-generator": "^0.6.0"
+  },
+  "devDependencies": {
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^25.3.0",
+    "typescript": "^5.9.3"
+  }
+}