npm - @alteriom/painlessmesh - Versions diffs - 1.8.15 → 1.9.0 - Mend

@alteriom/painlessmesh 1.8.15 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (208) hide show

package/BRIDGE_TO_INTERNET.md +229 -0
package/CHANGELOG.md +61 -1
package/CONTRIBUTING.md +79 -0
package/README.md +69 -144
package/docs/README.md +1 -0
package/docs/api/shared-gateway.md +1207 -0
package/examples/bridge_failover/README.md +81 -0
package/examples/bridge_failover/bridge_failover.ino +35 -4
package/examples/sharedGateway/README.md +235 -0
package/examples/{meshCommandNode → sharedGateway}/platformio.ini +3 -2
package/examples/sharedGateway/sharedGateway.ino +303 -0
package/library.json +3 -22
package/library.properties +1 -1
package/package.json +3 -6
package/src/arduino/wifi.hpp +342 -4
package/src/painlessmesh/gateway.hpp +2120 -0
package/src/painlessmesh/mesh.hpp +1034 -6
package/src/painlessmesh/message_tracker.hpp +311 -0
package/src/painlessmesh/protocol.hpp +6 -0
package/DOCUMENTATION_INDEX.md +0 -146
package/RELEASE_NOTES_1.8.15.md +0 -160
package/RELEASE_READINESS_PLAN.md +0 -323
package/TESTING_WITH_SIMULATOR.md +0 -259
package/docs/API_DESIGN_GUIDELINES.md +0 -414
package/docs/ARDUINO_LIBRARY_MANAGER_SUBMISSION.md +0 -331
package/docs/BOOLEAN_NAMING_CONVENTION.md +0 -235
package/docs/BRIDGE_FAILOVER.md +0 -512
package/docs/BRIDGE_HEALTH_MONITORING.md +0 -293
package/docs/BRIDGE_INITIALIZATION_FALLBACK.md +0 -357
package/docs/CHANNEL_SYNCHRONIZATION.md +0 -209
package/docs/CREATE_MISSING_RELEASES.md +0 -321
package/docs/DOCUMENTATION_MIGRATION_PLAN.md +0 -176
package/docs/FAQ_VERSION_NUMBERS.md +0 -152
package/docs/IMPLEMENTATION_PLAN_MESH_TOPOLOGY.md +0 -1062
package/docs/MESH_TOPOLOGY_GUIDE.md +0 -992
package/docs/MESH_TOPOLOGY_PROGRESS.md +0 -422
package/docs/MQTT_BRIDGE_COMMANDS.md +0 -894
package/docs/MQTT_BRIDGE_IMPLEMENTATION_SUMMARY.md +0 -324
package/docs/MQTT_COMMAND_SCHEMA_PROPOSAL.md +0 -576
package/docs/MQTT_SCHEMA_COMPLIANCE.md +0 -340
package/docs/MQTT_SCHEMA_PROPOSALS.md +0 -446
package/docs/MQTT_SCHEMA_REVIEW.md +0 -690
package/docs/OTA_COMMANDS_REFERENCE.md +0 -554
package/docs/PHASE1_GUIDE.md +0 -349
package/docs/PHASE2_GUIDE.md +0 -543
package/docs/QUICK_REFERENCE_VERSIONING.md +0 -127
package/docs/RELEASE_AGENT_SUMMARY.md +0 -386
package/docs/SCHEMA_VALIDATION_CHECKLIST.md +0 -222
package/docs/SIMULATOR_TESTING.md +0 -408
package/docs/VERSION_MANAGEMENT.md +0 -213
package/docs/archive/DOCUSAURUS_DEPLOYMENT.md +0 -166
package/docs/archive/FEATURE_PROPOSALS.md +0 -337
package/docs/archive/LIBRARY_JSON_FIX.md +0 -98
package/docs/archive/LIBRARY_STRUCTURE_FIX.md +0 -215
package/docs/archive/PHASE1_IMPLEMENTATION.md +0 -325
package/docs/archive/PHASE2_IMPLEMENTATION.md +0 -567
package/docs/archive/RELEASE_SUMMARY.md +0 -173
package/docs/archive/SCONS_BUILD_FIX.md +0 -313
package/docs/archive/TRIGGER_RELEASE.md +0 -280
package/docs/archive/VECTOR_INCLUDE_FIX.md +0 -129
package/docs/archive/ota-and-status-enhancements.md +0 -911
package/docs/archive/ota-status-architecture-diagrams.md +0 -658
package/docs/archive/ota-status-quick-reference.md +0 -284
package/docs/design/.gitkeep +0 -1
package/docs/design/STATION_CREDENTIALS_DESIGN.md +0 -182
package/docs/development/ARDUINO_COMPLIANCE_SUMMARY.md +0 -71
package/docs/development/CODE_REFACTORING_RECOMMENDATIONS.md +0 -1011
package/docs/development/DOCKER_TESTING.md +0 -196
package/docs/development/PLATFORMIO_USAGE.md +0 -180
package/docs/development/TESTING_SUMMARY.md +0 -126
package/docs/development/contributing.md +0 -301
package/docs/development/documentation.md +0 -583
package/docs/features/DIAGNOSTICS_API.md +0 -534
package/docs/implementation/BRIDGE_ARCHITECTURE_IMPLEMENTATION.md +0 -340
package/docs/implementation/BRIDGE_HEALTH_MONITORING_IMPLEMENTATION.md +0 -213
package/docs/implementation/BRIDGE_STATUS_FEATURE.md +0 -635
package/docs/implementation/DIAGNOSTICS_API_IMPLEMENTATION.md +0 -232
package/docs/implementation/IMPLEMENTATION_COMPLETE.md +0 -228
package/docs/implementation/IMPLEMENTATION_NTP_TIME_SYNC.md +0 -325
package/docs/implementation/IMPLEMENTATION_SUMMARY.md +0 -316
package/docs/implementation/MESSAGE_QUEUE_IMPLEMENTATION.md +0 -405
package/docs/implementation/MULTI_BRIDGE_IMPLEMENTATION.md +0 -520
package/docs/implementation/NTP_TIME_SYNC_FEATURE.md +0 -392
package/docs/improvements/FUTURE_PROPOSALS.md +0 -1016
package/docs/improvements/IMPLEMENTATION_HISTORY.md +0 -1091
package/docs/improvements/OTA_STATUS_ENHANCEMENTS.md +0 -709
package/docs/improvements/README.md +0 -212
package/docs/internal/CUSTOM_AGENT_ANALYSIS.md +0 -391
package/docs/internal/ISSUE_65_VERIFICATION.md +0 -947
package/docs/internal/ISSUE_66_CLOSURE.md +0 -249
package/docs/internal/ISSUE_66_STATUS.md +0 -316
package/docs/internal/PR_SUMMARY.md +0 -315
package/docs/internal/REVIEW_SUMMARY.md +0 -332
package/docs/multi-bridge-setup.md +0 -1025
package/docs/platformio-publishing.md +0 -255
package/docs/platformio-setup-summary.md +0 -121
package/docs/releases/ANNOUNCEMENT_v1.8.6.md +0 -63
package/docs/releases/ANNOUNCEMENT_v1.8.7.md +0 -113
package/docs/releases/BRIDGE_STATUS_SELF_REGISTRATION_FIX.md +0 -221
package/docs/releases/FEATURE_HISTORY.md +0 -543
package/docs/releases/GITHUB_RELEASE_v1.8.6.md +0 -71
package/docs/releases/GITHUB_RELEASE_v1.8.7.md +0 -90
package/docs/releases/PATCH_v1.7.2.md +0 -262
package/docs/releases/PATCH_v1.7.3.md +0 -262
package/docs/releases/PATCH_v1.7.4.md +0 -219
package/docs/releases/PHASE1_SUMMARY.md +0 -246
package/docs/releases/PHASE2_SUMMARY.md +0 -499
package/docs/releases/PUBLISH_v1.8.0_INSTRUCTIONS.md +0 -163
package/docs/releases/QUICK_START_RELEASES.md +0 -113
package/docs/releases/RELEASE_CHECKLIST_1.8.10.md +0 -331
package/docs/releases/RELEASE_CHECKLIST_1.8.9.md +0 -207
package/docs/releases/RELEASE_CHECKLIST_v1.7.4.md +0 -253
package/docs/releases/RELEASE_CHECKLIST_v1.7.5.md +0 -315
package/docs/releases/RELEASE_CHECKLIST_v1.7.6.md +0 -389
package/docs/releases/RELEASE_CHECKLIST_v1.8.0.md +0 -331
package/docs/releases/RELEASE_CHECKLIST_v1.8.2.md +0 -309
package/docs/releases/RELEASE_NOTES_1.7.0.md +0 -539
package/docs/releases/RELEASE_NOTES_1.8.10.md +0 -239
package/docs/releases/RELEASE_NOTES_1.8.9.md +0 -213
package/docs/releases/RELEASE_NOTES_v1.8.0.md +0 -685
package/docs/releases/RELEASE_NOTES_v1.8.1.md +0 -221
package/docs/releases/RELEASE_NOTES_v1.8.2.md +0 -421
package/docs/releases/RELEASE_NOTES_v1.8.3.md +0 -292
package/docs/releases/RELEASE_NOTES_v1.8.4.md +0 -277
package/docs/releases/RELEASE_NOTES_v1.8.6.md +0 -205
package/docs/releases/RELEASE_NOTES_v1.8.7.md +0 -184
package/docs/releases/RELEASE_PLAN_v1.7.6.md +0 -816
package/docs/releases/RELEASE_SUMMARY_1.8.10.md +0 -193
package/docs/releases/RELEASE_SUMMARY_v1.7.4.md +0 -276
package/docs/releases/RELEASE_SUMMARY_v1.7.5.md +0 -322
package/docs/releases/RELEASE_SUMMARY_v1.7.6.md +0 -436
package/docs/releases/RELEASE_SUMMARY_v1.7.7.md +0 -391
package/docs/releases/RELEASE_SUMMARY_v1.7.8.md +0 -523
package/docs/releases/RELEASE_SUMMARY_v1.7.9.md +0 -542
package/docs/troubleshooting/ARDUINO_IDE_VERSION_FIX_SUMMARY.md +0 -229
package/docs/troubleshooting/ARDUINO_LIBRARY_NAME_FIX.md +0 -197
package/docs/troubleshooting/CRASH_QUICK_REF.md +0 -93
package/docs/troubleshooting/ESP32_C6_COMPATIBILITY.md +0 -157
package/docs/troubleshooting/FREERTOS_ASSERTION_FAILURE.md +0 -288
package/docs/troubleshooting/FREERTOS_FIX_IMPLEMENTATION.md +0 -267
package/docs/troubleshooting/NPM_PUBLISHING_ISSUE_SUMMARY.md +0 -110
package/docs/troubleshooting/PAINLESSMESH_V1.7.4_COMPILATION_ISSUES.md +0 -547
package/docs/troubleshooting/QUICK_FIX_FREERTOS.md +0 -164
package/docs/troubleshooting/SENSOR_NODE_CONNECTION_CRASH.md +0 -264
package/docs/troubleshooting/common-architecture-mistakes.md +0 -438
package/docs/troubleshooting/internet-access-faq.md +0 -299
package/docs/troubleshooting/station-reconnection-issues.md +0 -172
package/docs/v1.7.7_MQTT_IMPROVEMENTS.md +0 -794
package/docs/wiki/API-Reference.md +0 -246
package/docs/wiki/Complete-Documentation.md +0 -123
package/examples/alteriomImproved/alteriom_sensor_package.hpp +0 -224
package/examples/alteriomImproved/improved_sensor_node.ino +0 -248
package/examples/alteriomImproved/platformio.ini +0 -32
package/examples/alteriomMetricsHealth/alteriom_sensor_package.hpp +0 -796
package/examples/alteriomMetricsHealth/metrics_health_node.ino +0 -429
package/examples/alteriomMetricsHealth/platformio.ini +0 -26
package/examples/alteriomPhase1/alteriom_sensor_package.hpp +0 -224
package/examples/alteriomPhase1/phase1_features.ino +0 -242
package/examples/alteriomPhase1/platformio.ini +0 -26
package/examples/alteriomPhase2/alteriom_sensor_package.hpp +0 -224
package/examples/alteriomPhase2/phase2_features.ino +0 -186
package/examples/alteriomPhase2/platformio.ini +0 -26
package/examples/alteriomSensorNode/alteriom_sensor_node.ino +0 -186
package/examples/alteriomSensorNode/alteriom_sensor_package.hpp +0 -1227
package/examples/alteriomSensorNode/platformio.ini +0 -26
package/examples/bridge/alteriom_sensor_package.hpp +0 -1170
package/examples/bridge/bridge_health_monitoring_example.ino +0 -188
package/examples/bridge/enhanced_mqtt_bridge.hpp +0 -610
package/examples/bridge/enhanced_mqtt_bridge_example.ino +0 -226
package/examples/bridge/mesh_event_publisher.hpp +0 -253
package/examples/bridge/mesh_topology_reporter.hpp +0 -303
package/examples/bridge/mqtt_command_bridge.hpp +0 -459
package/examples/bridge/mqtt_status_bridge.hpp +0 -519
package/examples/bridgeAwareSensorNode/alteriom_sensor_package.hpp +0 -1227
package/examples/bridgeAwareSensorNode/bridgeAwareSensorNode.ino +0 -342
package/examples/bridgeAwareSensorNode/platformio.ini +0 -26
package/examples/diagnosticsExample/diagnosticsExample.ino +0 -171
package/examples/diagnosticsExample/platformio.ini +0 -26
package/examples/echoNode/echoNode.ino +0 -33
package/examples/echoNode/platformio.ini +0 -26
package/examples/meshCommandNode/alteriom_sensor_package.hpp +0 -235
package/examples/meshCommandNode/meshCommandNode.ino +0 -265
package/examples/mqttCommandBridge/alteriom_sensor_package.hpp +0 -235
package/examples/mqttCommandBridge/mesh_event_publisher.hpp +0 -253
package/examples/mqttCommandBridge/mesh_topology_reporter.hpp +0 -303
package/examples/mqttCommandBridge/mqttCommandBridge.ino +0 -254
package/examples/mqttCommandBridge/mqtt_command_bridge.hpp +0 -462
package/examples/mqttCommandBridge/platformio.ini +0 -27
package/examples/mqttStatusBridge/mqttStatusBridge.ino +0 -218
package/examples/mqttStatusBridge/mqtt_status_bridge.hpp +0 -522
package/examples/mqttStatusBridge/platformio.ini +0 -27
package/examples/mqttTopologyTest/README.md +0 -467
package/examples/mqttTopologyTest/mqttTopologyTest.ino +0 -754
package/examples/mqttTopologyTest/platformio.ini +0 -27
package/examples/multi_bridge/README.md +0 -346
package/examples/multi_bridge/primary_bridge.ino +0 -108
package/examples/multi_bridge/regular_node.ino +0 -141
package/examples/multi_bridge/secondary_bridge.ino +0 -123
package/examples/ntpTimeSyncBridge/alteriom_sensor_package.hpp +0 -1383
package/examples/ntpTimeSyncBridge/ntpTimeSyncBridge.ino +0 -86
package/examples/ntpTimeSyncNode/alteriom_sensor_package.hpp +0 -1383
package/examples/ntpTimeSyncNode/ntpTimeSyncNode.ino +0 -109
package/examples/queued_alarms/README.md +0 -390
package/examples/queued_alarms/queued_alarms.ino +0 -265
package/examples/routing_demo/README.md +0 -172
package/examples/routing_demo/routing_demo.ino +0 -102
package/examples/rtcIntegration/README.md +0 -294
package/examples/rtcIntegration/rtcIntegration.ino +0 -210

package/docs/MESH_TOPOLOGY_GUIDE.md DELETED Viewed

@@ -1,992 +0,0 @@
-# Mesh Topology Visualization Guide
-**Version:** 1.0.0
-**Date:** October 14, 2025
-**Schema:** @alteriom/mqtt-schema v0.5.0
-A comprehensive guide for building web dashboards and monitoring tools to visualize painlessMesh network topology using MQTT.
----
-## Table of Contents
-1. [Quick Start](#quick-start)
-2. [D3.js Force-Directed Graph](#d3js-force-directed-graph)
-3. [Cytoscape.js Network View](#cytoscapejs-network-view)
-4. [Real-Time Dashboard](#real-time-dashboard)
-5. [Python Monitoring](#python-monitoring)
-6. [Node-RED Flows](#node-red-flows)
-7. [Troubleshooting](#troubleshooting)
-8. [Performance Considerations](#performance-considerations)
----
-## Quick Start
-### Prerequisites
-- MQTT broker (Mosquitto, HiveMQ, etc.)
-- painlessMesh gateway publishing topology
-- Modern web browser (Chrome, Firefox, Edge)
-- Basic JavaScript/HTML knowledge
-### Test Your Setup
-```bash
-# Subscribe to topology messages
-mosquitto_sub -h localhost -t "alteriom/mesh/+/topology" -v
-# You should see messages like:
-# alteriom/mesh/MESH-001/topology {"event":"mesh_topology",...}
-```
----
-## D3.js Force-Directed Graph
-### Complete HTML Example
-Save as `mesh-viewer-d3.html`:
-```html
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Alteriom Mesh Viewer - D3.js</title>
-    <script src="https://d3js.org/d3.v7.min.js"></script>
-    <script src="https://unpkg.com/mqtt/dist/mqtt.min.js"></script>
-    <style>
-        body {
-            margin: 0;
-            font-family: Arial, sans-serif;
-            background: #1a1a2e;
-            color: #eee;
-        }
-        #container {
-            display: flex;
-            height: 100vh;
-        }
-        #graph {
-            flex: 1;
-            background: #16213e;
-        }
-        #sidebar {
-            width: 300px;
-            background: #0f3460;
-            padding: 20px;
-            overflow-y: auto;
-        }
-        .node {
-            cursor: pointer;
-        }
-        .node-gateway { fill: #00d4ff; }
-        .node-sensor { fill: #4ecca3; }
-        .node-repeater { fill: #f39c12; }
-        .node-offline { fill: #e74c3c; }
-        .link { stroke: #555; stroke-opacity: 0.6; }
-        .link-excellent { stroke: #4ecca3; }
-        .link-good { stroke: #f39c12; }
-        .link-poor { stroke: #e74c3c; }
-        .node-label {
-            font-size: 10px;
-            fill: #eee;
-            pointer-events: none;
-        }
-        #stats {
-            background: #16213e;
-            padding: 15px;
-            margin-bottom: 15px;
-            border-radius: 5px;
-        }
-        .stat-item {
-            display: flex;
-            justify-content: space-between;
-            margin: 5px 0;
-        }
-        #event-log {
-            background: #16213e;
-            padding: 15px;
-            border-radius: 5px;
-            max-height: 300px;
-            overflow-y: auto;
-        }
-        .event {
-            padding: 8px;
-            margin: 5px 0;
-            border-left: 3px solid #00d4ff;
-            background: #0f3460;
-            font-size: 12px;
-        }
-        .event-join { border-left-color: #4ecca3; }
-        .event-leave { border-left-color: #e74c3c; }
-    </style>
-</head>
-<body>
-    <div id="container">
-        <div id="graph"></div>
-        <div id="sidebar">
-            <h2>Mesh Network</h2>
-            <div id="stats">
-                <div class="stat-item">
-                    <span>Total Nodes:</span>
-                    <span id="stat-total">0</span>
-                </div>
-                <div class="stat-item">
-                    <span>Online:</span>
-                    <span id="stat-online">0</span>
-                </div>
-                <div class="stat-item">
-                    <span>Avg Quality:</span>
-                    <span id="stat-quality">0%</span>
-                </div>
-                <div class="stat-item">
-                    <span>Network Diameter:</span>
-                    <span id="stat-diameter">0</span>
-                </div>
-            </div>
-            <h3>Recent Events</h3>
-            <div id="event-log"></div>
-        </div>
-    </div>
-    <script>
-        // Configuration
-        const MQTT_BROKER = 'ws://localhost:9001'; // WebSocket port
-        const MESH_ID = 'MESH-001';
-        // D3 Setup
-        const width = window.innerWidth - 300;
-        const height = window.innerHeight;
-        const svg = d3.select('#graph')
-            .append('svg')
-            .attr('width', width)
-            .attr('height', height);
-        const g = svg.append('g');
-        // Zoom behavior
-        svg.call(d3.zoom()
-            .extent([[0, 0], [width, height]])
-            .scaleExtent([0.1, 8])
-            .on('zoom', (event) => g.attr('transform', event.transform)));
-        // Force simulation
-        const simulation = d3.forceSimulation()
-            .force('link', d3.forceLink().id(d => d.id).distance(150))
-            .force('charge', d3.forceManyBody().strength(-400))
-            .force('center', d3.forceCenter(width / 2, height / 2))
-            .force('collision', d3.forceCollide().radius(50));
-        let link = g.append('g').selectAll('line');
-        let node = g.append('g').selectAll('g');
-        let label = g.append('g').selectAll('text');
-        // MQTT Connection
-        const client = mqtt.connect(MQTT_BROKER);
-        client.on('connect', () => {
-            console.log('✅ Connected to MQTT');
-            client.subscribe(`alteriom/mesh/${MESH_ID}/topology`);
-            client.subscribe(`alteriom/mesh/${MESH_ID}/events`);
-            addEvent('Connected to MQTT broker', 'join');
-        });
-        client.on('message', (topic, message) => {
-            const data = JSON.parse(message.toString());
-            if (data.event === 'mesh_topology') {
-                updateGraph(data);
-            } else if (data.event === 'mesh_event') {
-                handleEvent(data);
-            }
-        });
-        function updateGraph(topology) {
-            // Update statistics
-            if (topology.metrics) {
-                document.getElementById('stat-total').textContent = topology.metrics.total_nodes;
-                document.getElementById('stat-online').textContent = topology.metrics.online_nodes;
-                document.getElementById('stat-quality').textContent =
-                    topology.metrics.avg_connection_quality + '%';
-                document.getElementById('stat-diameter').textContent = topology.metrics.network_diameter;
-            }
-            // Prepare nodes and links
-            const nodes = topology.nodes.map(n => ({
-                id: n.node_id,
-                role: n.role,
-                status: n.status,
-                memory: n.free_memory_kb,
-                connections: n.connection_count
-            }));
-            const links = topology.connections.map(c => ({
-                source: c.from_node,
-                target: c.to_node,
-                quality: c.quality,
-                rssi: c.rssi,
-                latency: c.latency_ms
-            }));
-            // Update D3 visualization
-            link = link.data(links, d => `${d.source}-${d.target}`);
-            link.exit().remove();
-            link = link.enter()
-                .append('line')
-                .attr('class', d => {
-                    if (d.quality > 80) return 'link link-excellent';
-                    if (d.quality > 50) return 'link link-good';
-                    return 'link link-poor';
-                })
-                .attr('stroke-width', d => d.quality / 20)
-                .merge(link);
-            node = node.data(nodes, d => d.id);
-            node.exit().remove();
-            const nodeEnter = node.enter()
-                .append('g')
-                .attr('class', 'node')
-                .call(d3.drag()
-                    .on('start', dragstarted)
-                    .on('drag', dragged)
-                    .on('end', dragended));
-            nodeEnter.append('circle')
-                .attr('r', 20)
-                .attr('class', d => {
-                    if (d.status === 'offline') return 'node-offline';
-                    return `node-${d.role}`;
-                });
-            nodeEnter.append('title')
-                .text(d => `${d.id}\nRole: ${d.role}\nMemory: ${d.memory}KB`);
-            node = nodeEnter.merge(node);
-            // Update labels
-            label = label.data(nodes, d => d.id);
-            label.exit().remove();
-            label = label.enter()
-                .append('text')
-                .attr('class', 'node-label')
-                .attr('text-anchor', 'middle')
-                .attr('dy', 35)
-                .text(d => d.id.substring(4, 10))
-                .merge(label);
-            // Restart simulation
-            simulation.nodes(nodes);
-            simulation.force('link').links(links);
-            simulation.alpha(1).restart();
-            simulation.on('tick', () => {
-                link
-                    .attr('x1', d => d.source.x)
-                    .attr('y1', d => d.source.y)
-                    .attr('x2', d => d.target.x)
-                    .attr('y2', d => d.target.y);
-                node.attr('transform', d => `translate(${d.x},${d.y})`);
-                label.attr('x', d => d.x).attr('y', d => d.y);
-            });
-        }
-        function handleEvent(event) {
-            const type = event.event_type;
-            const nodes = event.affected_nodes.join(', ');
-            let message = '';
-            switch(type) {
-                case 'node_join':
-                    message = `Node ${nodes} joined mesh`;
-                    break;
-                case 'node_leave':
-                    message = `Node ${nodes} left mesh`;
-                    break;
-                default:
-                    message = `Event: ${type}`;
-            }
-            addEvent(message, type);
-        }
-        function addEvent(message, type = '') {
-            const log = document.getElementById('event-log');
-            const event = document.createElement('div');
-            event.className = `event event-${type}`;
-            event.textContent = `${new Date().toLocaleTimeString()}: ${message}`;
-            log.insertBefore(event, log.firstChild);
-            // Keep only last 20 events
-            while (log.children.length > 20) {
-                log.removeChild(log.lastChild);
-            }
-        }
-        function dragstarted(event, d) {
-            if (!event.active) simulation.alphaTarget(0.3).restart();
-            d.fx = d.x;
-            d.fy = d.y;
-        }
-        function dragged(event, d) {
-            d.fx = event.x;
-            d.fy = event.y;
-        }
-        function dragended(event, d) {
-            if (!event.active) simulation.alphaTarget(0);
-            d.fx = null;
-            d.fy = null;
-        }
-    </script>
-</body>
-</html>
-```
-### Usage
-1. **Start MQTT broker with WebSocket support:**
-   ```bash
-   # Mosquitto with WebSocket on port 9001
-   mosquitto -c mosquitto.conf
-   ```
-2. **Configure mosquitto.conf:**
-   ```
-   listener 1883
-   protocol mqtt
-   listener 9001
-   protocol websockets
-   ```
-3. **Open in browser:**
-   ```bash
-   # Simply open the HTML file
-   open mesh-viewer-d3.html
-   ```
----
-## Cytoscape.js Network View
-### Complete HTML Example
-Save as `mesh-viewer-cytoscape.html`:
-```html
-<!DOCTYPE html>
-<html>
-<head>
-    <title>Alteriom Mesh - Cytoscape</title>
-    <script src="https://unpkg.com/cytoscape/dist/cytoscape.min.js"></script>
-    <script src="https://unpkg.com/mqtt/dist/mqtt.min.js"></script>
-    <style>
-        body {
-            margin: 0;
-            font-family: Arial, sans-serif;
-        }
-        #cy {
-            width: 100%;
-            height: 100vh;
-            background: #1a1a2e;
-        }
-        #controls {
-            position: absolute;
-            top: 20px;
-            right: 20px;
-            background: rgba(15, 52, 96, 0.9);
-            padding: 15px;
-            border-radius: 8px;
-            color: white;
-            min-width: 200px;
-        }
-        button {
-            width: 100%;
-            padding: 10px;
-            margin: 5px 0;
-            background: #00d4ff;
-            border: none;
-            border-radius: 5px;
-            color: #1a1a2e;
-            cursor: pointer;
-            font-weight: bold;
-        }
-        button:hover {
-            background: #00a8cc;
-        }
-    </style>
-</head>
-<body>
-    <div id="cy"></div>
-    <div id="controls">
-        <h3>Controls</h3>
-        <button onclick="cy.fit()">Fit to Screen</button>
-        <button onclick="cy.layout({name: 'cose'}).run()">Re-layout</button>
-        <button onclick="highlightGateway()">Highlight Gateway</button>
-    </div>
-    <script>
-        const cy = cytoscape({
-            container: document.getElementById('cy'),
-            style: [
-                {
-                    selector: 'node',
-                    style: {
-                        'background-color': '#00d4ff',
-                        'label': 'data(label)',
-                        'width': 40,
-                        'height': 40,
-                        'font-size': 10,
-                        'color': '#fff',
-                        'text-valign': 'bottom',
-                        'text-halign': 'center',
-                        'text-margin-y': 5
-                    }
-                },
-                {
-                    selector: 'node[role="gateway"]',
-                    style: {
-                        'background-color': '#00d4ff',
-                        'width': 60,
-                        'height': 60,
-                        'border-width': 3,
-                        'border-color': '#fff'
-                    }
-                },
-                {
-                    selector: 'node[role="sensor"]',
-                    style: {
-                        'background-color': '#4ecca3'
-                    }
-                },
-                {
-                    selector: 'node[role="repeater"]',
-                    style: {
-                        'background-color': '#f39c12'
-                    }
-                },
-                {
-                    selector: 'node[status="offline"]',
-                    style: {
-                        'background-color': '#e74c3c',
-                        'opacity': 0.5
-                    }
-                },
-                {
-                    selector: 'edge',
-                    style: {
-                        'width': 'data(width)',
-                        'line-color': 'data(color)',
-                        'target-arrow-shape': 'triangle',
-                        'target-arrow-color': 'data(color)',
-                        'curve-style': 'bezier'
-                    }
-                }
-            ],
-            layout: {
-                name: 'cose',
-                animate: true,
-                animationDuration: 1000
-            }
-        });
-        const client = mqtt.connect('ws://localhost:9001');
-        client.on('connect', () => {
-            console.log('Connected to MQTT');
-            client.subscribe('alteriom/mesh/+/topology');
-        });
-        client.on('message', (topic, message) => {
-            const data = JSON.parse(message.toString());
-            if (data.event === 'mesh_topology') {
-                updateCytoscape(data);
-            }
-        });
-        function updateCytoscape(topology) {
-            cy.elements().remove();
-            // Add nodes
-            topology.nodes.forEach(n => {
-                cy.add({
-                    group: 'nodes',
-                    data: {
-                        id: n.node_id,
-                        label: n.node_id.substring(4, 10),
-                        role: n.role,
-                        status: n.status,
-                        memory: n.free_memory_kb
-                    }
-                });
-            });
-            // Add edges
-            topology.connections.forEach(c => {
-                const color = c.quality > 80 ? '#4ecca3' :
-                             c.quality > 50 ? '#f39c12' : '#e74c3c';
-                const width = Math.max(1, c.quality / 20);
-                cy.add({
-                    group: 'edges',
-                    data: {
-                        source: c.from_node,
-                        target: c.to_node,
-                        width: width,
-                        color: color,
-                        quality: c.quality
-                    }
-                });
-            });
-            cy.layout({name: 'cose', animate: true}).run();
-        }
-        function highlightGateway() {
-            const gateway = cy.nodes('[role="gateway"]');
-            cy.fit(gateway, 50);
-            gateway.flashClass('highlighted', 2000);
-        }
-        // Node click handler
-        cy.on('tap', 'node', function(evt) {
-            const node = evt.target;
-            alert(`Node: ${node.data('id')}\nRole: ${node.data('role')}\nMemory: ${node.data('memory')}KB`);
-        });
-    </script>
-</body>
-</html>
-```
----
-## Real-Time Dashboard
-### Node.js + Express + Socket.IO
-**server.js:**
-```javascript
-const express = require('express');
-const http = require('http');
-const socketIO = require('socket.io');
-const mqtt = require('mqtt');
-const app = express();
-const server = http.createServer(app);
-const io = socketIO(server);
-// MQTT Configuration
-const mqttClient = mqtt.connect('mqtt://localhost:1883');
-mqttClient.on('connect', () => {
-    console.log('✅ Connected to MQTT broker');
-    mqttClient.subscribe('alteriom/mesh/+/topology');
-    mqttClient.subscribe('alteriom/mesh/+/events');
-});
-mqttClient.on('message', (topic, message) => {
-    const data = JSON.parse(message.toString());
-    // Forward to all connected web clients
-    io.emit('mesh-data', {
-        topic: topic,
-        data: data
-    });
-});
-app.use(express.static('public'));
-io.on('connection', (socket) => {
-    console.log('Client connected');
-    socket.on('disconnect', () => {
-        console.log('Client disconnected');
-    });
-});
-const PORT = process.env.PORT || 3000;
-server.listen(PORT, () => {
-    console.log(`🚀 Dashboard running on http://localhost:${PORT}`);
-});
-```
-**public/index.html:**
-```html
-<!DOCTYPE html>
-<html>
-<head>
-    <title>Mesh Dashboard</title>
-    <script src="/socket.io/socket.io.js"></script>
-    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
-</head>
-<body>
-    <h1>Mesh Network Dashboard</h1>
-    <div id="stats"></div>
-    <canvas id="qualityChart" width="400" height="200"></canvas>
-    <script>
-        const socket = io();
-        const ctx = document.getElementById('qualityChart').getContext('2d');
-        const chart = new Chart(ctx, {
-            type: 'line',
-            data: {
-                labels: [],
-                datasets: [{
-                    label: 'Average Quality',
-                    data: [],
-                    borderColor: '#4ecca3',
-                    tension: 0.1
-                }]
-            },
-            options: {
-                scales: {
-                    y: {
-                        beginAtZero: true,
-                        max: 100
-                    }
-                }
-            }
-        });
-        socket.on('mesh-data', (message) => {
-            if (message.data.event === 'mesh_topology') {
-                updateDashboard(message.data);
-            }
-        });
-        function updateDashboard(topology) {
-            document.getElementById('stats').innerHTML = `
-                <p>Nodes: ${topology.metrics.total_nodes}</p>
-                <p>Quality: ${topology.metrics.avg_connection_quality}%</p>
-            `;
-            // Update chart
-            const now = new Date().toLocaleTimeString();
-            chart.data.labels.push(now);
-            chart.data.datasets[0].data.push(topology.metrics.avg_connection_quality);
-            if (chart.data.labels.length > 20) {
-                chart.data.labels.shift();
-                chart.data.datasets[0].data.shift();
-            }
-            chart.update();
-        }
-    </script>
-</body>
-</html>
-```
-**package.json:**
-```json
-{
-  "name": "mesh-dashboard",
-  "version": "1.0.0",
-  "dependencies": {
-    "express": "^4.18.0",
-    "socket.io": "^4.5.0",
-    "mqtt": "^4.3.0"
-  },
-  "scripts": {
-    "start": "node server.js"
-  }
-}
-```
-**Run:**
-```bash
-npm install
-npm start
-```
----
-## Python Monitoring
-### Simple Console Monitor
-```python
-#!/usr/bin/env python3
-"""
-Alteriom Mesh Topology Monitor
-Displays mesh network status in terminal
-"""
-import paho.mqtt.client as mqtt
-import json
-from datetime import datetime
-from rich.console import Console
-from rich.table import Table
-from rich.live import Live
-console = Console()
-# Configuration
-BROKER = "localhost"
-PORT = 1883
-MESH_ID = "MESH-001"
-topology_data = None
-def on_connect(client, userdata, flags, rc):
-    console.print(f"[green]✅ Connected to MQTT broker[/green]")
-    client.subscribe(f"alteriom/mesh/{MESH_ID}/topology")
-    client.subscribe(f"alteriom/mesh/{MESH_ID}/events")
-def on_message(client, userdata, msg):
-    global topology_data
-    data = json.loads(msg.payload.decode())
-    if data.get('event') == 'mesh_topology':
-        topology_data = data
-    elif data.get('event') == 'mesh_event':
-        event_type = data.get('event_type')
-        nodes = ', '.join(data.get('affected_nodes', []))
-        console.print(f"[yellow]🔔 Event: {event_type} - {nodes}[/yellow]")
-def create_table():
-    if not topology_data:
-        return Table(title="Waiting for topology data...")
-    table = Table(title=f"Mesh Network - {datetime.now().strftime('%H:%M:%S')}")
-    table.add_column("Node ID", style="cyan")
-    table.add_column("Role", style="magenta")
-    table.add_column("Status", style="green")
-    table.add_column("Memory", justify="right")
-    table.add_column("Connections", justify="right")
-    for node in topology_data.get('nodes', []):
-        status_color = "green" if node['status'] == 'online' else "red"
-        table.add_row(
-            node['node_id'][-12:],
-            node['role'],
-            f"[{status_color}]{node['status']}[/{status_color}]",
-            f"{node.get('free_memory_kb', 0)} KB",
-            str(node.get('connection_count', 0))
-        )
-    # Add metrics
-    metrics = topology_data.get('metrics', {})
-    table.add_section()
-    table.add_row(
-        "[bold]METRICS[/bold]",
-        f"Quality: {metrics.get('avg_connection_quality', 0)}%",
-        f"Diameter: {metrics.get('network_diameter', 0)}",
-        f"Total: {metrics.get('total_nodes', 0)}",
-        f"Online: {metrics.get('online_nodes', 0)}"
-    )
-    return table
-def main():
-    client = mqtt.Client()
-    client.on_connect = on_connect
-    client.on_message = on_message
-    client.connect(BROKER, PORT, 60)
-    client.loop_start()
-    try:
-        with Live(create_table(), refresh_per_second=1) as live:
-            while True:
-                live.update(create_table())
-    except KeyboardInterrupt:
-        console.print("\n[red]Disconnecting...[/red]")
-        client.loop_stop()
-        client.disconnect()
-if __name__ == "__main__":
-    main()
-```
-**Install dependencies:**
-```bash
-pip install paho-mqtt rich
-python mesh_monitor.py
-```
----
-## Node-RED Flows
-### Import this flow into Node-RED:
-```json
-[
-    {
-        "id": "mqtt-in",
-        "type": "mqtt in",
-        "broker": "mqtt-broker",
-        "topic": "alteriom/mesh/+/topology",
-        "name": "Mesh Topology"
-    },
-    {
-        "id": "parse-json",
-        "type": "json",
-        "name": "Parse JSON"
-    },
-    {
-        "id": "extract-metrics",
-        "type": "function",
-        "name": "Extract Metrics",
-        "func": "msg.payload = {\n    total_nodes: msg.payload.metrics.total_nodes,\n    avg_quality: msg.payload.metrics.avg_connection_quality,\n    online: msg.payload.metrics.online_nodes\n};\nreturn msg;"
-    },
-    {
-        "id": "dashboard-gauge",
-        "type": "ui_gauge",
-        "group": "mesh-stats",
-        "name": "Avg Quality",
-        "min": 0,
-        "max": 100
-    },
-    {
-        "id": "mqtt-broker",
-        "type": "mqtt-broker",
-        "broker": "localhost",
-        "port": "1883"
-    }
-]
-```
----
-## Troubleshooting
-### Problem: No topology messages appearing
-**Symptoms:**
-- Empty graph
-- No MQTT messages received
-- Console shows "Waiting for data..."
-**Solutions:**
-1. **Check MQTT broker:**
-   ```bash
-   mosquitto_sub -h localhost -t "alteriom/mesh/#" -v
-   ```
-2. **Verify WebSocket port:**
-   ```bash
-   # Check if port 9001 is open
-   netstat -an | grep 9001
-   ```
-3. **Check browser console:**
-   - Open DevTools (F12)
-   - Look for connection errors
-   - Verify MQTT connection message
-4. **Test with mosquitto_pub:**
-   ```bash
-   mosquitto_pub -h localhost -t "alteriom/mesh/MESH-001/topology" -m '{"event":"mesh_topology","nodes":[]}'
-   ```
-### Problem: Nodes not appearing in graph
-**Check:**
-- Node ID format is `ALT-XXXXXXXXXXXX`
-- `nodes` array is not empty
-- `status` field is "online"
-- JSON is valid
-### Problem: Quality metrics showing 0
-**Solutions:**
-- Verify `quality` field in connections (0-100)
-- Check `rssi` is negative (-30 to -90)
-- Ensure `latency_ms` is positive
-### Problem: Events not publishing
-**Check:**
-- Subscribed to correct topic: `alteriom/mesh/+/events`
-- Event type is one of: `node_join`, `node_leave`, `node_timeout`
-- `affected_nodes` array contains valid node IDs
----
-## Performance Considerations
-### Message Frequency
-**Recommendations:**
-- Full topology: Every 60 seconds
-- Incremental updates: Every 5 seconds
-- Events: Immediate (on change)
-**For large meshes (50+ nodes):**
-```javascript
-// Throttle updates
-let lastUpdate = 0;
-const UPDATE_INTERVAL = 2000; // 2 seconds
-client.on('message', (topic, message) => {
-    const now = Date.now();
-    if (now - lastUpdate < UPDATE_INTERVAL) return;
-    lastUpdate = now;
-    updateGraph(JSON.parse(message));
-});
-```
-### Buffer Sizes
-**MQTT Client:**
-```javascript
-const client = mqtt.connect('ws://localhost:9001', {
-    clientId: 'mesh-viewer-' + Math.random(),
-    clean: true,
-    reconnectPeriod: 1000,
-    keepalive: 60
-});
-```
-**For ESP32:**
-```cpp
-mqttClient.setBufferSize(2048); // Increase for large topologies
-```
-### QoS Levels
-**Recommended:**
-- Topology messages: QoS 0 (fire and forget)
-- Events: QoS 1 (at least once)
-- Commands: QoS 1 (at least once)
-### Network Scaling
-| Nodes | Update Frequency | Buffer Size | Notes |
-|-------|-----------------|-------------|-------|
-| 1-10  | 1s              | 1KB         | Default |
-| 10-30 | 5s              | 2KB         | Recommended |
-| 30-50 | 10s             | 4KB         | Increase buffer |
-| 50+   | 30s             | 8KB         | Consider incremental only |
----
-## Additional Resources
-- [MQTT Schema Review](./MQTT_SCHEMA_REVIEW.md)
-- [Hardware Test Sketch](../examples/mqttTopologyTest/)
-- [D3.js Documentation](https://d3js.org/)
-- [Cytoscape.js Documentation](https://js.cytoscape.org/)
-- [@alteriom/mqtt-schema Package](https://www.npmjs.com/package/@alteriom/mqtt-schema)
----
-**Created by:** Alteriom Development Team
-**Last Updated:** October 14, 2025
-**License:** MIT