Merge branch 'main' of https://github.com/RlxChap2/malwareSniffer

Author: RlxChap2

README.md

@@ -1,3 +1,4 @@
+<<<<<<< HEAD
 # 🕵️♂️ Malware Sniffer · [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 _A cybersecurity companion that sniffs out suspicious URLs with style_ 🔍✨
@@ -102,3 +103,109 @@ MIT Licensed - Go build something secure! 🛡️
 ---
 
 Made with ❤️ by [0xGrayy] · [Report Issue](https://github.com/0xGrayy/malwareSniffer/issues)
+=======
+# 🕵️♂️ Malware Sniffer · [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+_A cybersecurity companion that sniffs out suspicious URLs with style_ 🔍✨
+
+<div align="center">
+  <img src="./assets/demo.gif" alt="Animated demo showing scanning process" width="800">
+  <p><em>Watch Malware Sniffer in action – from scanning to detailed report</em></p>
+</div>
+
+## 🌟 Why Malware Sniffer?
+
+In today's digital jungle, every click matters. Malware Sniffer is your trusty sidekick that:
+
+✅ **Instant Safety Check**: Scan any URL against 70+ security engines in real-time  
+✅ **Beautiful Reports**: Get clear, color-coded results with emoji storytelling  
+✅ **Developer Friendly**: Perfect for integrating into your security workflows  
+✅ **Zero Hassle**: Set up in 2 minutes with automatic progress tracking
+
+## 🚀 Getting Started
+
+### 📦 Installation
+
+```bash
+git clone https://github.com/0xGrayy/malwareSniffer.git
+cd malwareSniffer
+npm install
+```
+
+### 🔐 Configuration
+
+1. Get your free API key from [VirusTotal](https://www.virustotal.com)
+2. Create `.env` file:
+
+```env
+VIRUSTOTAL_API_KEY=your_actual_key_here
+```
+
+### 🕹️ Quick Start
+
+```typescript
+import { scanUrl } from "./virusTotal";
+
+// Be the cybersecurity hero your app needs 🦸
+scanUrl("https://your-url-here.com");
+```
+
+## 📊 What You'll See
+
+![Sample Scan Output](./assets/image-2.png)
+_Real scan results showing safety breakdown and detection details_
+
+## 🛠️ Tech Stack
+
+- **`axios`** → Smooth API communication
+- **`chalk`** → Terminal colors
+- **`cli-progress`** → That satisfying progress bar
+- **`figlet`** → Fancy ASCII art headers
+- **`moment`** → Precision timing metrics
+
+## 🖌️ Feature Highlights
+
+### 🎨 Visual Progress Tracking
+
+![Progress Bar Demo](./assets/image-1.png)
+_Watch the scan unfold with live ETA updates_
+
+### 🔍 Deep Analysis
+
+```markdown
+📌 Google Safebrowsing → 🛑 Malicious (blacklist)  
+📌 CRDF → ⚠️ Suspicious (heuristic)  
+📌 Quttera → ✅ Harmless (signature)
+```
+
+### 📈 Safety at a Glance
+
+```
+Safety Score: 92% 🟩🟩🟩🟩🟩🟩🟩🟩🟩🟥
+```
+
+## 🤝 Join the Security Squad
+
+We welcome contributors! Here's how to help:
+
+1. 🐛 **Report bugs** – Help us squash them!
+2. 💡 **Suggest features** – What's missing?
+3. 📖 **Improve docs** – Make things clearer
+4. 🧪 **Write tests** – Keep things reliable
+
+**First time contributing?** Check our [contribution guide](CONTRIBUTING.md)!
+
+## ⚠️ Important Notes
+
+- This tool **doesn't guarantee 100% safety** – always practice defense-in-depth
+- API rate limits apply – be kind to VirusTotal's servers
+- Keep your API key secret – treat it like your WiFi password 🔑
+
+## 📜 License
+
+MIT Licensed - Go build something secure! 🛡️
+
+---
+
+Made with ❤️ by [0xGrayy] · [Report Issue](https://github.com/0xGrayy/malwareSniffer/issues)
+>>>>>>> 913bfbc0c48e5bdbb30449cbd1df4b0c0c1ecd09

package.json

@@ -7,9 +7,13 @@
     "build": "npx tsc",
     "start": "node dist/index.js",
     "autobuild": "npx tsc -w",
+<<<<<<< HEAD
     "autostart": "cls && npx tsc && node dist/index.js",
     "push": "git add . && git commit -m \"V1.1.5\" && git push",
     "changelog": "git log --pretty=format:\"1. [**%s - `%h`**](https://github.com/0xGrayy/malwareSniffer/commit/%H)\" > CHANGELOG.md"
+=======
+    "autostart": "cls && npx tsc && node dist/index.js"
+>>>>>>> 913bfbc0c48e5bdbb30449cbd1df4b0c0c1ecd09
   },
   "keywords": [],
   "author": "",

src/global.d.ts

@@ -1,2 +1,7 @@
+<<<<<<< HEAD
 declare module "cli-progress";
 declare module "figlet";
+=======
+declare module "cli-progress";
+declare module "figlet";
+>>>>>>> 913bfbc0c48e5bdbb30449cbd1df4b0c0c1ecd09

src/index.ts

@@ -1,4 +1,11 @@
+<<<<<<< HEAD
 import { scanUrl } from "./virusTotal";
 
 // Example: Scan a URL
 scanUrl("https://youtube.com/");
+=======
+import { scanUrl } from "./virusTotal";
+
+// Example: Scan a URL
+scanUrl("https://youtube.com/");
+>>>>>>> 913bfbc0c48e5bdbb30449cbd1df4b0c0c1ecd09

src/virusTotal.ts

@@ -1,3 +1,4 @@
+<<<<<<< HEAD
 import axios from "axios";
 import * as dotenv from "dotenv";
 import chalk from "chalk";
@@ -125,3 +126,132 @@ export async function scanUrl(url: string): Promise<void> {
     console.error(chalk.red.bold("❌ Error:"), err.response?.data || err.message);
   }
 }
+=======
+import axios from "axios";
+import * as dotenv from "dotenv";
+import chalk from "chalk";
+import cliProgress from "cli-progress";
+import figlet from "figlet";
+import moment from "moment"; 
+
+dotenv.config();
+
+const VIRUSTOTAL_API_KEY = process.env.VIRUSTOTAL_API_KEY;
+
+if (!VIRUSTOTAL_API_KEY) {
+  throw new Error(chalk.red.bold("❌ Missing VirusTotal API Key in .env file!"));
+}
+
+export async function scanUrl(url: string): Promise<void> {
+  try {
+    console.log(chalk.blue.bold(figlet.textSync("Malware Sniffer", { horizontalLayout: "full" })));
+    console.log(chalk.blue.bold(`\n🚀 Starting URL Scan: ${chalk.underline(url)}\n`));
+
+    const startTime = moment();
+
+    const response = await axios.post(
+      "https://www.virustotal.com/api/v3/urls",
+      new URLSearchParams({ url }),
+      {
+        headers: {
+          "x-apikey": VIRUSTOTAL_API_KEY,
+          "Content-Type": "application/x-www-form-urlencoded",
+        },
+      }
+    );
+
+    const scanId = response.data.data.id;
+    console.log(chalk.yellow.bold(`🔍 Scanning in progress...`));
+    console.log(chalk.cyan.bold(`📌 Scan ID: ${scanId}`));
+
+    const progressBar = new cliProgress.SingleBar(
+      {
+        format: `⏳ Progress: [{bar}] {percentage}% | ETA: {eta}s`,
+        barCompleteChar: "█",
+        barIncompleteChar: "░",
+      },
+      cliProgress.Presets.shades_classic
+    );
+
+    progressBar.start(100, 0);
+    let status = "queued";
+    let scanResults: any;
+    let elapsedTime = 0;
+
+    while (status === "queued") {
+      await new Promise((resolve) => setTimeout(resolve, 5000));
+
+      elapsedTime += 5;
+      progressBar.update((elapsedTime / 30) * 100);
+
+      const result = await axios.get(
+        `https://www.virustotal.com/api/v3/analyses/${scanId}`,
+        {
+          headers: { "x-apikey": VIRUSTOTAL_API_KEY },
+        }
+      );
+
+      scanResults = result.data.data.attributes;
+      status = scanResults.status;
+
+      if (status === "queued") {
+        console.log(chalk.gray("⏳ Still processing... Waiting..."));
+      }
+    }
+
+    progressBar.stop();
+
+    const engines = scanResults.results;
+    const detectedEngines = Object.values(engines).filter((res: any) => res.category === "malicious").length;
+    const totalEngines = Object.keys(engines).length;
+    const safeScore = ((totalEngines - detectedEngines) / totalEngines) * 100;
+
+    const endTime = moment();
+    const duration = moment.duration(endTime.diff(startTime)).seconds();
+
+    console.log("\n📊 " + chalk.bold.underline("Scan Results Summary:"));
+    console.log(chalk.gray(`🕒 Scan Duration: ${duration} seconds`));
+    console.log(chalk.green.bold(`🔹 Total Engines Checked: ${totalEngines}`));
+    console.log(chalk.red.bold(`🔸 Malicious Detections: ${detectedEngines}`));
+    console.log(chalk.yellow.bold(`🟡 Suspicious Engines: ${Object.values(engines).filter((res: any) => res.category === "suspicious").length}`));
+    console.log(chalk.green.bold(`✅ Safe Score: ${safeScore.toFixed(2)}%`));
+
+    console.log("\n📈 " + chalk.bold("Detection Chart:"));
+    console.log(chalk.green("🟩".repeat(Math.round(safeScore / 10))) + chalk.red("🟥".repeat(Math.round((100 - safeScore) / 10))));
+    console.log(chalk.green.bold(`Safe: ${safeScore.toFixed(2)}%`));
+    console.log(chalk.red.bold(`Malicious: ${(100 - safeScore).toFixed(2)}%\n`));
+
+    console.log(chalk.bold("🔍 Detailed Results:"));
+    Object.entries(engines).forEach(([engine, data]: any) => {
+      let categoryColor;
+      switch (data.category) {
+        case "malicious":
+          categoryColor = chalk.red.bold("🛑 Malicious");
+          break;
+          case "harmless":
+            categoryColor = chalk.green.bold("✅ Harmless");
+            break;
+        case "suspicious":
+          categoryColor = chalk.yellow.bold("⚠️ Suspicious");
+          break;
+        default:
+          categoryColor = chalk.gray(data.category);
+      }
+
+      console.log(
+        chalk.cyan(`📌 ${engine}:`) +
+          ` ${categoryColor} | ` +
+          chalk.gray(`Method: ${data.method}`)
+      );
+    });
+
+    if (detectedEngines > 0) {
+      console.log(chalk.red.bold("\n⚠️ WARNING: This URL is potentially unsafe!"));
+    } else {
+      console.log(chalk.green.bold("\n✅ This URL appears safe!"));
+    }
+  } catch (err: any) {
+    console.error(chalk.red.bold("❌ Error:"), err.response?.data || err.message);
+  }
+}
+>>>>>>> 913bfbc0c48e5bdbb30449cbd1df4b0c0c1ecd09

tsconfig.json

@@ -1,3 +1,4 @@
+<<<<<<< HEAD
 {
   "compilerOptions": {
     "outDir": "./dist",
@@ -8,3 +9,15 @@
     "esModuleInterop": true
   }
 }
+=======
+{
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "module": "CommonJS",
+    "target": "ESNext",
+    "strict": true,
+    "esModuleInterop": true
+  }
+}
+>>>>>>> 913bfbc0c48e5bdbb30449cbd1df4b0c0c1ecd09