ClientsideNetworkControl

ALL RIGHTS RESERVED

As per GitHub

“However, without a license, the default copyright laws apply, meaning that you retain all rights to your source code and no one may reproduce, distribute, or create derivative works from your work.”

© 2024, 2025, 2026 - Chris Singendonk All Rights Reserved.

This work is NOT LICENSED for public or private use, modification, distribution, reproduction, or creation of derivative works without explicit written approval from the author. By default, you may not use, modify, or distribute any part of this work unless you have received direct permission from the copyright holder.

Note: Any API or code not defined within this project is assumed to be part of a standard web API, which is typically documented in official web development resources. The scripts rely on base web APIs, each subject to its respective owner’s copyright and/or licensing conditions.
Any breach of contract, law, or other official restrictions, regulations, stipulations, or similar legalities arising from the use of this work is entirely upon the user.

---

Architecture

Standalone

• No External Dependencies: The entire project is self-contained in a single file without external libraries or build processes.
• Modular Structure: Despite being a single file, it is divided into distinct “modules”:
  • Locally Global Configuration & State
  • Internal Utility & Helper Functions
  • Interceptor Modules
  • UI Modules:
  • Global Utility & Helper Functions
  • API Initialization & Exposure

---

UI Components

Toaster

• Used for linking and displaying customizable toasts locally.

LogPanel

• A custom HTML element that provides:
  • A versatile header for repositioning, collapsing, minimizing, maximizing, hiding, or removing the panel.
  • Options for setting colour themes and managing log entries (export, import, persist, clear).
  • Floating behavior that adapts dynamically to ensure clear rendering without affecting external CSS/HTML.

---

Usage & Integration

Manual Usage

• Embed: Include the single script via a <script> tag.
• Auto-Initialization: The IIFE auto-initializes upon loading.
• Dynamic UI: The Toaster and LogPanel elements are appended at runtime.
• API: Use the exposed DOMLogger API for programmatic interaction.

Extension Usage

1. Download: Get the .crx file from the repository’s release.
2. Convert: Change the file extension from .crx to .zip.
3. Load: Navigate to chrome://extensions in Chrome, enable Developer Mode, and drag & drop the .zip file into the browser.

Note: The manifest and injection logic in the zip use Chrome Manifest V3. The script is injected directly into the page’s DOM (not in a sandboxed content script) to access the page’s internal scope. The public API can be used by the extension’s background, content, or popup scopes via emissions, messages, and workers, and can also access extension APIs via content scripts.

View core.js on GitHub
View initLogs.js on GitHub

---

ZERO DATA COLLECTION

NO COOKIES, TRACKERS, OR DATA COLLECTION

• The script is fully static and works offline—though it can be served from anywhere.
• Privacy by Default: No data is logged, stored, or transmitted externally.
• Local Storage: Can be disabled entirely (note: logs won’t persist between sessions or tabs).
• Optional Remote Sync: You may set up remote syncing and exporting if desired.

See Release 1 for a demo.

---

BASE BLOCKING FUNCTIONALITY (< 5000 CHARS)

• Included: XHR, BGSW, WS, HTTP.

---

UI, CSS, HTML, AND JS MODULES IN ONE FILE

• The entire project is under 3000 lines of code.

---

HONORING COPYRIGHT & RESTRICTIONS IN COLLABORATIONS

Unauthorized usage, reproduction, modification, or distribution of unlicensed original works—whether in whole or in part—violates copyright.

Consider:

Imagine spending countless hours designing and building a car. Collaboration is vital, but what if others take your blueprint, improve it behind closed doors, and leave you out? You miss out on valuable learning and see no benefit for your effort. They lose out on your contributions to further the work.This is why permission and attribution matter.

---

CONTACT FOR APPROVAL

To use, modify, or build upon this work, you must first obtain explicit written permission from the author. Collaboration is welcome when mutual understanding and respect are upheld.

Contact: https://github.com/csingendonk
If in doubt—ask first.

OBSOLETE DRAFT

This is a draft copy of the complete code from a previous point in time and state.