{"_id":"@bylickilabs/cyber-guard","_rev":"2-271f72fb8ad46f4672766f07084f1231","name":"@bylickilabs/cyber-guard","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@bylickilabs/cyber-guard","version":"1.0.0","keywords":["security","protection","ai","ddos","monitoring","analytics","performance","client-side","frontend","javascript","threat-detection","anomaly-detection","cybersecurity","web-security","hardening","defense","mitigation","bylickilabs","thorsten bylicki","github","developer"],"author":{"name":"BYLICKILABS"},"license":"MIT","_id":"@bylickilabs/cyber-guard@1.0.0","maintainers":[{"name":"bylickilabs","email":"thorsten.bylicki@web.de"}],"dist":{"shasum":"afbee21373f39dae67258f8bb66adbb9c026e7fc","tarball":"https://registry.npmjs.org/@bylickilabs/cyber-guard/-/cyber-guard-1.0.0.tgz","fileCount":7,"integrity":"sha512-ZwmTgYl71kFVit3y5blED0P0HcdKQtXXP+3x0X1h1X1yivjJsk/GpMW8yfEMQaySik9Hbcd7HLPb1lpVD9KFxA==","signatures":[{"sig":"MEYCIQDWQnYoIEn3XpiS41s3mN+4m4JtoL6WBG9KMMQtovtVowIhAIKpyL7HXd0DB06EWXBL8RTqIsAqMk4r4Qsv3M7WYbFo","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":66383},"main":"ai.js","type":"commonjs","gitHead":"b428776c454a5630514c64d7e80650fe7c669a96","_npmUser":{"name":"bylickilabs","email":"thorsten.bylicki@web.de"},"_npmVersion":"11.6.4","description":"CyberGuard – AI-driven client-side security, protection, DDoS mitigation, monitoring and defensive hardening.","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cyber-guard_1.0.0_1765200002092_0.12396603810351325","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@bylickilabs/cyber-guard","version":"1.0.3","description":"CyberGuard – AI-driven client-side security, protection, DDoS mitigation, monitoring and defensive hardening.","main":"ai.js","keywords":["security","protection","ai","ddos","monitoring","analytics","performance","client-side","frontend","javascript","threat-detection","anomaly-detection","cybersecurity","web-security","hardening","defense","mitigation","bylickilabs","thorsten bylicki","github","developer"],"author":{"name":"BYLICKILABS"},"license":"MIT","type":"commonjs","gitHead":"0e1406f23d35cc8ddb86c0276f3852b3c30af7f2","_id":"@bylickilabs/cyber-guard@1.0.3","_nodeVersion":"25.2.1","_npmVersion":"11.6.4","dist":{"integrity":"sha512-ItOnWvQ47Z93sFZidqZ7zQjLfJd3R/mFUksPnCNQ4Pah7rKXBOg+i/rX6BYekiQLGcnj0SrbwKqnv80b2hg5Rg==","shasum":"c8aba6df7613a65d10802f15a52081b3f0d744d0","tarball":"https://registry.npmjs.org/@bylickilabs/cyber-guard/-/cyber-guard-1.0.3.tgz","fileCount":7,"unpackedSize":47961,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID/bl+27EAuRfsIv7/SedGsBU4dNu2um+NGGrGKdT0DLAiA0p9Q3DNOOo2mGFqYrF3xGXUizqpNKH0gkluU03wU+8w=="}]},"_npmUser":{"name":"bylickilabs","email":"thorsten.bylicki@web.de"},"directories":{},"maintainers":[{"name":"bylickilabs","email":"thorsten.bylicki@web.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cyber-guard_1.0.3_1765530185334_0.07776069570267774"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-08T13:20:01.957Z","modified":"2025-12-12T09:03:05.678Z","1.0.0":"2025-12-08T13:20:02.255Z","1.0.3":"2025-12-12T09:03:05.488Z"},"author":{"name":"BYLICKILABS"},"license":"MIT","keywords":["security","protection","ai","ddos","monitoring","analytics","performance","client-side","frontend","javascript","threat-detection","anomaly-detection","cybersecurity","web-security","hardening","defense","mitigation","bylickilabs","thorsten bylicki","github","developer"],"description":"CyberGuard – AI-driven client-side security, protection, DDoS mitigation, monitoring and defensive hardening.","maintainers":[{"name":"bylickilabs","email":"thorsten.bylicki@web.de"}],"readme":"# 🛡 CyberGuard\n**Version 1.0.1 — Multi-Layer Client-Side Security Protection Suite**\n\n- CyberGuard delivers a modular, multi-layer security system for modern web applications.\n- It consolidates client-side anomaly detection, DDoS-Guard, DOM protection, input shielding, service-worker hardening,\n  - and UI blackout controls into a single, cohesive security package.\n\n> Designed for seamless integration into any HTML-based project.\n  - Performance-optimized. Engineered by BYLICKILABS.\n\n<br>\n\n---\n\n<br>\n\n## 🚀 Included Security Modules\n\n### ✔ AI Monitoring Layer (`ai.js`)\n- Performance tracking  \n- Error & anomaly logging  \n- Network monitoring  \n- FPS measurement  \n- Behavior scoring  \n- Client-side analytics\n\n### ✔ DDoS-Guard (`ddos-guard.js`)\n- Event‑flood detection  \n- Request throttling  \n- Basic bot traffic mitigation  \n- Client-side shield activation\n\n### ✔ DOM Protection (`protect.js` + `protect.css`)\n- Blackout screen  \n- Anti-manipulation guard  \n- Tamper detection  \n- UI shielding  \n\n## ➕ Additional Features in v1.0.1 (Upgrade from v1.0.0)\n\nVersion **v1.0.1** extends the existing feature set with structured telemetry, deeper contextual insight, and professional reporting capabilities. All features from v1.0.0 remain fully intact.\n\n---\n\n### 🔹 Session & Event Telemetry\n- Introduction of a global **Session ID** per page load\n- Sequential **Event IDs** for unique identification of every log entry\n- Consistent event ordering across the entire session\n- Capture of **session start time** for time-based analysis\n\n---\n\n### 🔹 Breadcrumb Tracking (Context History)\n- Recording of relevant pre-events before failures:\n  - User click interactions\n  - JavaScript runtime errors\n  - Unhandled promise rejections\n  - Network & XHR errors\n  - Online / Offline state changes\n- Automatic limitation of breadcrumb history\n- Breadcrumbs embedded into every log entry\n\n---\n\n### 🔹 Per-Event Snapshot Extensions\nEach log entry now includes:\n- **Performance snapshot** (page load time, average FPS, low-FPS frames)\n- **Network snapshot** (request counters, error count, offline state)\n- **Resource snapshot** (failed resource loads)\n- Current breadcrumb context\n\n---\n\n### 🔹 Extended Network Error History\n- Persistent tracking of recent network and XHR failures\n- Storage of:\n  - URL\n  - HTTP status\n  - Request method\n  - Request duration\n- Integrated into incident and session reports\n\n---\n\n### 🔹 Advanced Export & Reporting Capabilities\n- **CSV export** for structured analysis and BI tooling\n- **HTML report** for management, audit, and documentation use\n- **Session-specific export** (logs limited to the active session)\n- Enhanced JSON exports including session and telemetry data\n\n---\n\n### 🔹 UI Overlay Enhancements\n- Additional export controls:\n  - CSV\n  - HTML\n  - Session report\n- Improved button grouping for operational workflows\n- Increased information density without breaking existing behavior\n\n---\n\n### 🔹 Internal Stability & Governance Improvements\n- Event sequence reconstruction from local storage\n- Clean initialization of session state\n- Consistent log structures across all export formats\n- No breaking changes to the existing public API\n\n---\n\n**v1.0.1** elevates the AI Monitoring Layer from basic client-side monitoring to a **fully observability-ready telemetry and incident analysis system**, remaining entirely backend-free and privacy-first.\n\n\n<br>\n\n---\n\n<br>\n\n# 📦 Installation (npm)\n\n```\nnpm i @bylickilabs/cyber-guard\n```\n\n<br>\n\n---\n\n<br>\n\n# 🌐 CDN Integration\n\nInsert into `<head>`:\n\n## jsDelivr\n```\n<script src=\"https://cdn.jsdelivr.net/npm/@bylickilabs/cyber-guard/ai.min.js\" defer></script>\n<script src=\"https://cdn.jsdelivr.net/npm/@bylickilabs/cyber-guard/ddos-guard.min.js\" defer></script>\n<script src=\"https://cdn.jsdelivr.net/npm/@bylickilabs/cyber-guard/protect.min.js\" defer></script>\n\n```\n\n```\n<link rel=\"stylesheet\" href=\"https://cdn.jsdelivr.net/npm/@bylickilabs/cyber-guard/protect.min.css\">\n````\n\n---\n\n## unpkg\n\n```\n<script src=\"https://unpkg.com/@bylickilabs/cyber-guard/ai.min.js\" defer></script>\n<script src=\"https://unpkg.com/@bylickilabs/cyber-guard/ddos-guard.min.js\" defer></script>\n<script src=\"https://unpkg.com/@bylickilabs/cyber-guard/protect.min.js\" defer></script>\n\n```\n\n```\n<link rel=\"stylesheet\" href=\"https://unpkg.com/@bylickilabs/cyber-guard/protect.min.css\">\n```\n\n<br>\n\n---\n\n<br>\n\n\n\n# ⚫ Blackout Layer & Input Shield\n\nInsert into `<body>`:\n\n```\n<!-- BLACKOUT LAYER BEGIN -->\n\n<div id=\"blackout\" class=\"blackout\" aria-hidden=\"true\"></div>\n\n<!-- BLACKOUT LAYER END -->\n\n---\n\n<!-- INPUT SHIELD BEGIN -->\n\n<script language=\"JavaScript1.2\">\nfunction disableselect(e){\nreturn false\n}\nfunction reEnable(){\nreturn true\n}\ndocument.onselectstart=new Function (\"return false\")\nif (window.sidebar){\ndocument.onmousedown=disableselect\ndocument.onclick=reEnable\n}\n</script>\n\n</head>\n<body oncontextmenu=\"return false\">\n<script language=\"JavaScript1.2\">\nfunction disableselect(e){\nreturn false\n}\nfunction reEnable(){\nreturn true\n}\ndocument.onselectstart=new Function (\"return false\")\nif (window.sidebar){\ndocument.onmousedown=disableselect\ndocument.onclick=reEnable\n}\n</script>\n\n<!-- INPUT SHIELD END -->\n```\n\n<br>\n\n---\n\n<br>\n\n# Optional Screenshot Support with html2canvas\n\n> This project can optionally support **in-browser screenshots** of sections of your web application by using the \n[`html2canvas`](https://html2canvas.hertzen.com/) library.\n\n---\n\n## 🔧 1. Integration in the `<head>` Section  \n\n> [!TIP]\n> To enable screenshot functionality, add the following script tag **inside the `<head>` section** of your HTML document:  \n\n```\n    <script src=\"https://html2canvas.hertzen.com/dist/html2canvas.js\"></script>\n```\n\n> [!NOTE]\n> This script is **optional**. If you do not need screenshot or capture functionality, you can omit this dependency and the rest of the framework will continue to work as usual.\n\n---\n\n## ✅ Summary\n\n- Adding `html2canvas.js` to the `<head>` section enables optional screenshot features for your web UI.  \n  - If you do not require this functionality, you can simply leave it out.\n\n---\n\n# 🛡 License  \nMIT © BYLICKILABS\n[LICENSE](LICENSE)\n","readmeFilename":"README.md"}