@alteriom/mqtt-schema 0.3.1 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alteriom/mqtt-schema",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Alteriom MQTT v1 schemas, TypeScript types, and validation helpers for web integration",
   "license": "MIT",
   "author": "Alteriom Development Team",
@@ -87,25 +87,31 @@
     "node": ">=16.0.0"
   },
   "scripts": {
+    "// Build Scripts": "====================",
     "prebuild": "npm run clean && node scripts/copy-schemas.cjs",
     "build:cjs": "tsc -p tsconfig.json",
     "build:esm": "tsc -p tsconfig.esm.json && node scripts/post-esm.cjs",
     "build": "npm run build:cjs && npm run build:esm && node scripts/copy-schemas.cjs",
     "clean": "rimraf dist schemas",
     "prepare": "npm run build",
-    "lint": "echo 'No linter configured'",
+    "// Testing & Validation": "====================",
+    "lint": "echo 'No linter configured - consider adding ESLint for future releases'",
     "test": "node test/validate-fixtures.cjs",
+    "test:ota": "node scripts/validate-ota-manifest.js",
     "verify:schemas": "node scripts/check-schema-sync.cjs",
     "verify:release": "node scripts/check-release-integrity.cjs",
     "verify": "npm run verify:schemas && npm run verify:release && npm test",
     "verify:all": "node scripts/verify_all.cjs",
+    "// Release Management": "====================",
     "release:prepare": "node scripts/release-prepare.cjs",
     "wiki:generate": "node scripts/generate-wiki.cjs",
+    "// Repository Metadata": "====================",
     "metadata:report": "alteriom-metadata report --org-tag alteriom || echo 'metadata report failed'",
     "metadata:validate": "alteriom-metadata validate --org-tag alteriom || echo 'metadata validate failed'",
     "metadata:apply": "alteriom-metadata apply --org-tag alteriom",
     "metadata:apply:dry": "alteriom-metadata dry-run --org-tag alteriom",
-    "validate:ota": "node scripts/validate-ota-manifest.js"
+    "// Legacy Aliases": "====================",
+    "validate:ota": "npm run test:ota"
   },
   "keywords": [
     "alteriom",

package/schemas/mesh_alert.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/mesh_alert.schema.json",
+  "title": "Mesh Network Alert v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "required": ["alerts"],
+  "properties": {
+    "alerts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["alert_type", "severity", "message"],
+        "properties": {
+          "alert_type": {
+            "type": "string",
+            "enum": [
+              "low_memory",
+              "node_offline",
+              "connection_lost",
+              "high_latency",
+              "packet_loss",
+              "firmware_mismatch",
+              "configuration_error",
+              "security_warning",
+              "other"
+            ],
+            "description": "Type of alert"
+          },
+          "severity": {
+            "type": "string",
+            "enum": ["critical", "warning", "info"],
+            "description": "Alert severity level"
+          },
+          "message": {
+            "type": "string",
+            "description": "Human-readable alert message"
+          },
+          "node_id": {
+            "type": "string",
+            "description": "Related node ID (if applicable)"
+          },
+          "metric_value": {
+            "type": "number",
+            "description": "Related metric value (if applicable)"
+          },
+          "threshold": {
+            "type": "number",
+            "description": "Threshold that triggered alert"
+          },
+          "alert_id": {
+            "type": "string",
+            "description": "Unique alert identifier"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "alert_count": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total number of active alerts"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/mesh_node_list.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/mesh_node_list.schema.json",
+  "title": "Mesh Node List v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "required": ["nodes"],
+  "properties": {
+    "nodes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["node_id"],
+        "properties": {
+          "node_id": {
+            "type": "string",
+            "description": "Unique node identifier"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["online", "offline", "unreachable"],
+            "description": "Current node status"
+          },
+          "last_seen": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Last communication timestamp"
+          },
+          "signal_strength": {
+            "type": "integer",
+            "minimum": -200,
+            "maximum": 0,
+            "description": "Signal strength in dBm"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "node_count": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total number of nodes"
+    },
+    "mesh_id": {
+      "type": "string",
+      "description": "Mesh network identifier"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/mesh_topology.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/mesh_topology.schema.json",
+  "title": "Mesh Network Topology v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "required": ["connections"],
+  "properties": {
+    "connections": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["from_node", "to_node"],
+        "properties": {
+          "from_node": {
+            "type": "string",
+            "description": "Source node ID"
+          },
+          "to_node": {
+            "type": "string",
+            "description": "Destination node ID"
+          },
+          "link_quality": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Link quality score (0-1)"
+          },
+          "latency_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Link latency in milliseconds"
+          },
+          "hop_count": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Number of hops in path"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "root_node": {
+      "type": "string",
+      "description": "Root node ID (gateway/bridge)"
+    },
+    "total_connections": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total number of connections"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/mqtt_v1_bundle.json

@@ -9,6 +9,9 @@
     "gateway_info": "gateway_info.schema.json",
     "gateway_metrics": "gateway_metrics.schema.json",
     "firmware_status": "firmware_status.schema.json",
-    "control_response": "control_response.schema.json"
+    "control_response": "control_response.schema.json",
+    "mesh_node_list": "mesh_node_list.schema.json",
+    "mesh_topology": "mesh_topology.schema.json",
+    "mesh_alert": "mesh_alert.schema.json"
   }
 }