@alteriom/mqtt-schema 0.2.0 → 0.2.1

package/dist/cjs/schemas/sensor_data.schema.json

@@ -1,33 +1,33 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_data.schema.json",
-  "title": "Sensor Data Message v1",
-  "allOf": [{"$ref": "envelope.schema.json"}],
-  "type": "object",
-  "required": ["sensors"],
-  "properties": {
-    "sensors": {
-      "type": "object",
-      "minProperties": 1,
-      "additionalProperties": {
-        "type": "object",
-        "required": ["value"],
-        "properties": {
-          "value": {"type": ["number", "integer"]},
-          "unit": {"type": "string"},
-          "raw_value": {"type": ["number", "integer"]},
-          "calibrated_value": {"type": ["number", "integer"]},
-          "quality_score": {"type": "number", "minimum": 0, "maximum": 1},
-          "name": {"type": "string"},
-          "location": {"type": "string"},
-          "additional_data": {"type": "object"}
-        },
-        "additionalProperties": false
-      }
-    },
-    "battery_level": {"type": "integer", "minimum": 0, "maximum": 100},
-    "signal_strength": {"type": "integer", "minimum": -200, "maximum": 0},
-    "additional": {"type": "object"}
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_data.schema.json",
+  "title": "Sensor Data Message v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "required": ["sensors"],
+  "properties": {
+    "sensors": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": ["value"],
+        "properties": {
+          "value": {"type": ["number", "integer"]},
+          "unit": {"type": "string"},
+          "raw_value": {"type": ["number", "integer"]},
+          "calibrated_value": {"type": ["number", "integer"]},
+          "quality_score": {"type": "number", "minimum": 0, "maximum": 1},
+          "name": {"type": "string"},
+          "location": {"type": "string"},
+          "additional_data": {"type": "object"}
+        },
+        "additionalProperties": false
+      }
+    },
+    "battery_level": {"type": "integer", "minimum": 0, "maximum": 100},
+    "signal_strength": {"type": "integer", "minimum": -200, "maximum": 0},
+    "additional": {"type": "object"}
+  },
+  "additionalProperties": true
+}

package/dist/cjs/schemas/sensor_heartbeat.schema.json

@@ -1,14 +1,14 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_heartbeat.schema.json",
-  "title": "Sensor Heartbeat v1",
-  "type": "object",
-  "required": ["schema_version", "device_id", "device_type", "timestamp"],
-  "properties": {
-    "schema_version": {"type": "integer", "const": 1},
-    "device_id": {"type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"},
-    "device_type": {"type": "string", "enum": ["sensor", "gateway"]},
-    "timestamp": {"type": "string", "format": "date-time"}
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_heartbeat.schema.json",
+  "title": "Sensor Heartbeat v1",
+  "type": "object",
+  "required": ["schema_version", "device_id", "device_type", "timestamp"],
+  "properties": {
+    "schema_version": {"type": "integer", "const": 1},
+    "device_id": {"type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"},
+    "device_type": {"type": "string", "enum": ["sensor", "gateway"]},
+    "timestamp": {"type": "string", "format": "date-time"}
+  },
+  "additionalProperties": true
+}

package/dist/cjs/schemas/sensor_status.schema.json

@@ -1,14 +1,14 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_status.schema.json",
-  "title": "Sensor Status v1",
-  "allOf": [{"$ref": "envelope.schema.json"}],
-  "type": "object",
-  "required": ["status"],
-  "properties": {
-    "status": {"type": "string", "enum": ["online", "offline", "updating", "error"]},
-    "battery_level": {"type": "integer", "minimum": 0, "maximum": 100},
-    "signal_strength": {"type": "integer", "minimum": -200, "maximum": 0}
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_status.schema.json",
+  "title": "Sensor Status v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "required": ["status"],
+  "properties": {
+    "status": {"type": "string", "enum": ["online", "offline", "updating", "error"]},
+    "battery_level": {"type": "integer", "minimum": 0, "maximum": 100},
+    "signal_strength": {"type": "integer", "minimum": -200, "maximum": 0}
+  },
+  "additionalProperties": true
+}

package/dist/cjs/schemas/validation_rules.md

@@ -1,44 +1,44 @@
-# Validation Rules (Operational Layer)
-
-This file captures dynamic / contextual validation that is OUTSIDE pure structural JSON Schema constraints.
-
-## Timing & Rate
-- Future timestamp drift: reject if > 5s ahead of server reference.
-- Heartbeat interval recommended 30s; backend may rate-limit <10s.
-- Sensor data soft min 30s unless negotiated high-frequency mode.
-
-## Heartbeat Firmware Version Exception
-- Only heartbeat topic may omit `firmware_version` when unchanged.
-- All other topics require the field.
-
-## Forbidden / Drop Conditions
-| Reason | Condition |
-|--------|----------|
-| missing_fields | Required base fields absent (heartbeat firmware exception applied). |
-| invalid_timestamp | Non-ISO 8601 / unparseable timestamp. |
-| deprecated_keys | Usage of forbidden alias keys (f, fw, ver, version, u, up, rssi). |
-| invalid_sensor_entry | Sensor object missing `value` key. |
-| future_drift | Timestamp too far in future (>5s). |
-| out_of_range | battery_level not 0-100 OR quality_score not 0-1. |
-| invalid_numeric | Non-numeric where numeric expected. |
-| spec_violation | Generic fallback after failed internal validation. |
-
-## Sensor Object Semantics
-- `value` REQUIRED.
-- `unit`, `raw_value`, `calibrated_value`, `quality_score`, `name`, `location`, `additional_data` OPTIONAL.
-- If `quality_score` present must be 0.0–1.0 inclusive.
-
-## Metrics Constraints
-- Gateway metrics MUST appear under `metrics` (never at top-level).
-- Required minimal metric: `uptime_s`.
-
-## Firmware Update Status
-- `status` must be one of: pending, downloading, flashing, verifying, rebooting, completed, failed.
-- `progress_pct` (if present) must be 0–100.
-
-## Extensibility
-- Unknown top-level keys tolerated (future evolution) except if they collide with any deprecated alias or reserved future keys announced in CHANGELOG.
-
-## Versioning
-- Current `schema_version`: 1
-- Additions remain optional; breaking changes introduce new schema set.
+# Validation Rules (Operational Layer)
+
+This file captures dynamic / contextual validation that is OUTSIDE pure structural JSON Schema constraints.
+
+## Timing & Rate
+- Future timestamp drift: reject if > 5s ahead of server reference.
+- Heartbeat interval recommended 30s; backend may rate-limit <10s.
+- Sensor data soft min 30s unless negotiated high-frequency mode.
+
+## Heartbeat Firmware Version Exception
+- Only heartbeat topic may omit `firmware_version` when unchanged.
+- All other topics require the field.
+
+## Forbidden / Drop Conditions
+| Reason | Condition |
+|--------|----------|
+| missing_fields | Required base fields absent (heartbeat firmware exception applied). |
+| invalid_timestamp | Non-ISO 8601 / unparseable timestamp. |
+| deprecated_keys | Usage of forbidden alias keys (f, fw, ver, version, u, up, rssi). |
+| invalid_sensor_entry | Sensor object missing `value` key. |
+| future_drift | Timestamp too far in future (>5s). |
+| out_of_range | battery_level not 0-100 OR quality_score not 0-1. |
+| invalid_numeric | Non-numeric where numeric expected. |
+| spec_violation | Generic fallback after failed internal validation. |
+
+## Sensor Object Semantics
+- `value` REQUIRED.
+- `unit`, `raw_value`, `calibrated_value`, `quality_score`, `name`, `location`, `additional_data` OPTIONAL.
+- If `quality_score` present must be 0.0–1.0 inclusive.
+
+## Metrics Constraints
+- Gateway metrics MUST appear under `metrics` (never at top-level).
+- Required minimal metric: `uptime_s`.
+
+## Firmware Update Status
+- `status` must be one of: pending, downloading, flashing, verifying, rebooting, completed, failed.
+- `progress_pct` (if present) must be 0–100.
+
+## Extensibility
+- Unknown top-level keys tolerated (future evolution) except if they collide with any deprecated alias or reserved future keys announced in CHANGELOG.
+
+## Versioning
+- Current `schema_version`: 1
+- Additions remain optional; breaking changes introduce new schema set.

package/dist/esm/schemas/control_response.schema.json

@@ -1,15 +1,15 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/control_response.schema.json",
-  "title": "Control / Command Response v1",
-  "allOf": [{"$ref": "envelope.schema.json"}],
-  "type": "object",
-  "required": ["status"],
-  "properties": {
-    "command": {"type": "string"},
-    "status": {"type": "string", "enum": ["ok", "error"]},
-    "message": {"type": "string"},
-    "result": {"type": ["object", "array", "string", "number", "boolean", "null"]}
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/control_response.schema.json",
+  "title": "Control / Command Response v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "required": ["status"],
+  "properties": {
+    "command": {"type": "string"},
+    "status": {"type": "string", "enum": ["ok", "error"]},
+    "message": {"type": "string"},
+    "result": {"type": ["object", "array", "string", "number", "boolean", "null"]}
+  },
+  "additionalProperties": true
+}

package/dist/esm/schemas/envelope.schema.json

@@ -1,16 +1,16 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/envelope.schema.json",
-  "title": "Alteriom MQTT Base Envelope v1",
-  "type": "object",
-  "required": ["schema_version", "device_id", "device_type", "timestamp", "firmware_version"],
-  "properties": {
-    "schema_version": {"type": "integer", "const": 1},
-    "device_id": {"type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"},
-    "device_type": {"type": "string", "enum": ["sensor", "gateway"]},
-    "timestamp": {"type": "string", "format": "date-time"},
-    "firmware_version": {"type": "string", "minLength": 1, "maxLength": 40},
-    "hardware_version": {"type": "string", "maxLength": 80}
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/envelope.schema.json",
+  "title": "Alteriom MQTT Base Envelope v1",
+  "type": "object",
+  "required": ["schema_version", "device_id", "device_type", "timestamp", "firmware_version"],
+  "properties": {
+    "schema_version": {"type": "integer", "const": 1},
+    "device_id": {"type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"},
+    "device_type": {"type": "string", "enum": ["sensor", "gateway"]},
+    "timestamp": {"type": "string", "format": "date-time"},
+    "firmware_version": {"type": "string", "minLength": 1, "maxLength": 40},
+    "hardware_version": {"type": "string", "maxLength": 80}
+  },
+  "additionalProperties": true
+}

package/dist/esm/schemas/firmware_status.schema.json

@@ -1,17 +1,17 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/firmware_status.schema.json",
-  "title": "Firmware Update Status v1",
-  "allOf": [{"$ref": "envelope.schema.json"}],
-  "type": "object",
-  "required": ["status"],
-  "properties": {
-    "event": {"type": "string"},
-    "from_version": {"type": "string"},
-    "to_version": {"type": "string"},
-    "status": {"type": "string", "enum": ["pending", "downloading", "flashing", "verifying", "rebooting", "completed", "failed"]},
-    "progress_pct": {"type": "number", "minimum": 0, "maximum": 100},
-    "error": {"type": ["string", "null"]}
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/firmware_status.schema.json",
+  "title": "Firmware Update Status v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "required": ["status"],
+  "properties": {
+    "event": {"type": "string"},
+    "from_version": {"type": "string"},
+    "to_version": {"type": "string"},
+    "status": {"type": "string", "enum": ["pending", "downloading", "flashing", "verifying", "rebooting", "completed", "failed"]},
+    "progress_pct": {"type": "number", "minimum": 0, "maximum": 100},
+    "error": {"type": ["string", "null"]}
+  },
+  "additionalProperties": true
+}

package/dist/esm/schemas/gateway_info.schema.json

@@ -1,21 +1,21 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/gateway_info.schema.json",
-  "title": "Gateway Info v1",
-  "allOf": [{"$ref": "envelope.schema.json"}],
-  "type": "object",
-  "properties": {
-    "mac_address": {"type": "string", "pattern": "^[0-9A-Fa-f:]{17}$"},
-    "ip_address": {"type": "string", "format": "ipv4"},
-    "capabilities": {
-      "type": "object",
-      "properties": {
-        "max_nodes": {"type": "integer", "minimum": 0},
-        "supports_mesh": {"type": "boolean"},
-        "firmware_update": {"type": "boolean"}
-      },
-      "additionalProperties": true
-    }
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/gateway_info.schema.json",
+  "title": "Gateway Info v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "properties": {
+    "mac_address": {"type": "string", "pattern": "^[0-9A-Fa-f:]{17}$"},
+    "ip_address": {"type": "string", "format": "ipv4"},
+    "capabilities": {
+      "type": "object",
+      "properties": {
+        "max_nodes": {"type": "integer", "minimum": 0},
+        "supports_mesh": {"type": "boolean"},
+        "firmware_update": {"type": "boolean"}
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/dist/esm/schemas/gateway_metrics.schema.json

@@ -1,26 +1,26 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/gateway_metrics.schema.json",
-  "title": "Gateway Metrics v1",
-  "allOf": [{"$ref": "envelope.schema.json"}],
-  "type": "object",
-  "required": ["metrics"],
-  "properties": {
-    "metrics": {
-      "type": "object",
-      "required": ["uptime_s"],
-      "properties": {
-        "uptime_s": {"type": "integer", "minimum": 0},
-        "cpu_usage_pct": {"type": "number", "minimum": 0, "maximum": 100},
-        "memory_usage_pct": {"type": "number", "minimum": 0, "maximum": 100},
-        "temperature_c": {"type": "number"},
-        "connected_devices": {"type": "integer", "minimum": 0},
-        "mesh_nodes": {"type": "integer", "minimum": 0},
-        "packet_loss_pct": {"type": "number", "minimum": 0, "maximum": 100},
-        "data_throughput_kbps": {"type": "number", "minimum": 0}
-      },
-      "additionalProperties": true
-    }
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/gateway_metrics.schema.json",
+  "title": "Gateway Metrics v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "required": ["metrics"],
+  "properties": {
+    "metrics": {
+      "type": "object",
+      "required": ["uptime_s"],
+      "properties": {
+        "uptime_s": {"type": "integer", "minimum": 0},
+        "cpu_usage_pct": {"type": "number", "minimum": 0, "maximum": 100},
+        "memory_usage_pct": {"type": "number", "minimum": 0, "maximum": 100},
+        "temperature_c": {"type": "number"},
+        "connected_devices": {"type": "integer", "minimum": 0},
+        "mesh_nodes": {"type": "integer", "minimum": 0},
+        "packet_loss_pct": {"type": "number", "minimum": 0, "maximum": 100},
+        "data_throughput_kbps": {"type": "number", "minimum": 0}
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/dist/esm/schemas/mqtt_v1_bundle.json

@@ -1,14 +1,14 @@
-{
-  "$comment": "Convenience bundle referencing all v1 schema artifact filenames for tooling discovery.",
-  "version": 1,
-  "schemas": {
-    "envelope": "envelope.schema.json",
-    "sensor_data": "sensor_data.schema.json",
-    "sensor_heartbeat": "sensor_heartbeat.schema.json",
-    "sensor_status": "sensor_status.schema.json",
-    "gateway_info": "gateway_info.schema.json",
-    "gateway_metrics": "gateway_metrics.schema.json",
-    "firmware_status": "firmware_status.schema.json",
-    "control_response": "control_response.schema.json"
-  }
-}
+{
+  "$comment": "Convenience bundle referencing all v1 schema artifact filenames for tooling discovery.",
+  "version": 1,
+  "schemas": {
+    "envelope": "envelope.schema.json",
+    "sensor_data": "sensor_data.schema.json",
+    "sensor_heartbeat": "sensor_heartbeat.schema.json",
+    "sensor_status": "sensor_status.schema.json",
+    "gateway_info": "gateway_info.schema.json",
+    "gateway_metrics": "gateway_metrics.schema.json",
+    "firmware_status": "firmware_status.schema.json",
+    "control_response": "control_response.schema.json"
+  }
+}

package/dist/esm/schemas/sensor_data.schema.json

@@ -1,33 +1,33 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_data.schema.json",
-  "title": "Sensor Data Message v1",
-  "allOf": [{"$ref": "envelope.schema.json"}],
-  "type": "object",
-  "required": ["sensors"],
-  "properties": {
-    "sensors": {
-      "type": "object",
-      "minProperties": 1,
-      "additionalProperties": {
-        "type": "object",
-        "required": ["value"],
-        "properties": {
-          "value": {"type": ["number", "integer"]},
-          "unit": {"type": "string"},
-          "raw_value": {"type": ["number", "integer"]},
-          "calibrated_value": {"type": ["number", "integer"]},
-          "quality_score": {"type": "number", "minimum": 0, "maximum": 1},
-          "name": {"type": "string"},
-          "location": {"type": "string"},
-          "additional_data": {"type": "object"}
-        },
-        "additionalProperties": false
-      }
-    },
-    "battery_level": {"type": "integer", "minimum": 0, "maximum": 100},
-    "signal_strength": {"type": "integer", "minimum": -200, "maximum": 0},
-    "additional": {"type": "object"}
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_data.schema.json",
+  "title": "Sensor Data Message v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "required": ["sensors"],
+  "properties": {
+    "sensors": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": ["value"],
+        "properties": {
+          "value": {"type": ["number", "integer"]},
+          "unit": {"type": "string"},
+          "raw_value": {"type": ["number", "integer"]},
+          "calibrated_value": {"type": ["number", "integer"]},
+          "quality_score": {"type": "number", "minimum": 0, "maximum": 1},
+          "name": {"type": "string"},
+          "location": {"type": "string"},
+          "additional_data": {"type": "object"}
+        },
+        "additionalProperties": false
+      }
+    },
+    "battery_level": {"type": "integer", "minimum": 0, "maximum": 100},
+    "signal_strength": {"type": "integer", "minimum": -200, "maximum": 0},
+    "additional": {"type": "object"}
+  },
+  "additionalProperties": true
+}

package/dist/esm/schemas/sensor_heartbeat.schema.json

@@ -1,14 +1,14 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_heartbeat.schema.json",
-  "title": "Sensor Heartbeat v1",
-  "type": "object",
-  "required": ["schema_version", "device_id", "device_type", "timestamp"],
-  "properties": {
-    "schema_version": {"type": "integer", "const": 1},
-    "device_id": {"type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"},
-    "device_type": {"type": "string", "enum": ["sensor", "gateway"]},
-    "timestamp": {"type": "string", "format": "date-time"}
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_heartbeat.schema.json",
+  "title": "Sensor Heartbeat v1",
+  "type": "object",
+  "required": ["schema_version", "device_id", "device_type", "timestamp"],
+  "properties": {
+    "schema_version": {"type": "integer", "const": 1},
+    "device_id": {"type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z0-9_-]+$"},
+    "device_type": {"type": "string", "enum": ["sensor", "gateway"]},
+    "timestamp": {"type": "string", "format": "date-time"}
+  },
+  "additionalProperties": true
+}

package/dist/esm/schemas/sensor_status.schema.json

@@ -1,14 +1,14 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_status.schema.json",
-  "title": "Sensor Status v1",
-  "allOf": [{"$ref": "envelope.schema.json"}],
-  "type": "object",
-  "required": ["status"],
-  "properties": {
-    "status": {"type": "string", "enum": ["online", "offline", "updating", "error"]},
-    "battery_level": {"type": "integer", "minimum": 0, "maximum": 100},
-    "signal_strength": {"type": "integer", "minimum": -200, "maximum": 0}
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.alteriom.io/mqtt/v1/sensor_status.schema.json",
+  "title": "Sensor Status v1",
+  "allOf": [{"$ref": "envelope.schema.json"}],
+  "type": "object",
+  "required": ["status"],
+  "properties": {
+    "status": {"type": "string", "enum": ["online", "offline", "updating", "error"]},
+    "battery_level": {"type": "integer", "minimum": 0, "maximum": 100},
+    "signal_strength": {"type": "integer", "minimum": -200, "maximum": 0}
+  },
+  "additionalProperties": true
+}