chore: Tighten Id specifiers in json schema

Make sure we specify the correct Id ranges for messages.

buttplug/buttplug-schema/schema/buttplug-schema.json

···
   "version": 3,
   "description": "The JSON Protocol format for the Buttplug Protocol.",
   "components": {
-    "Id": {
+    "ClientId": {
+      "description": "User-set id for the message. 0 denotes system message and is reserved.",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 4294967295
+    },
+    "ServerId": {
       "description": "User-set id for the message. 0 denotes system message and is reserved.",
       "type": "integer",
       "minimum": 0,
···
       "type": "integer",
       "minimum": 0
     },
-    "IdMessage": {
+    "ClientIdMessage": {
       "description": "Message types that are expected to have an Id and nothing else.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" }
+        "Id": { "$ref": "#/components/ClientId" }
+      },
+      "additionalProperties": false,
+      "minProperties": 1,
+      "maxProperties": 1,
+      "required": [
+        "Id"
+      ]
+    },
+    "ServerIdMessage": {
+      "description": "Message types that are expected to have an Id and nothing else, from the server side, which may be either a reply or an event (id 0).",
+      "properties": {
+        "Id": { "$ref": "#/components/ServerId" }
       },
       "additionalProperties": false,
       "minProperties": 1,
···
         "Id"
       ]
     },
-    "DeviceIndexMessage": {
+    "SystemIdDeviceIndexMessage": {
+      "properties": {
+        "Id": { "$ref": "#/components/SystemId" },
+        "DeviceIndex": { "$ref": "#/components/DeviceIndex" }
+      },
+      "additionalProperties": false,
+      "required": [
+        "Id",
+        "DeviceIndex"
+      ]
+    },    
+    "ClientIdDeviceIndexMessage": {
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" }
       },
       "additionalProperties": false,
···
         },
         "FeatureCount": { "$ref": "#/components/FeatureCount" },
         "StepCount": { "$ref": "#/components/StepCount" },
-        "ActuatorType": { 
+        "ActuatorType": {
           "description": "Denotes type of actuator (Vibrator, Linear, Oscillator, etc...)",
           "type": "string"
         }
···
         "FeatureDescriptor",
         "SensorRange"
       ]
-    },    
+    },
     "DeviceMessagesEx": {
       "description": "A list of the messages a device will accept on this server implementation.",
       "type": "object",
···
             "minItems": 1
         },
         "VibrateCmd": { "$ref": "#/components/GenericMessageAttributes" },
-        "LinearCmd": { 
+        "LinearCmd": {
           "type": "array",
           "items": {
             "$ref": "#/components/GenericMessageAttributes",
             "minItems": 1
           }
         },
-        "RotateCmd": { 
+        "RotateCmd": {
           "type": "array",
           "items": {
             "$ref": "#/components/GenericMessageAttributes",
···
         "FleshlightLaunchFW12Cmd": { "$ref": "#/components/NullMessageAttributes" },
         "BatteryLevelCmd": { "$ref": "#/components/NullMessageAttributes" },
         "RSSILevelCmd": { "$ref": "#/components/NullMessageAttributes" },
-        "SensorReadCmd": { 
+        "SensorReadCmd": {
           "type": "array",
           "items": {
             "$ref": "#/components/SensorMessageAttributes",
             "minItems": 1
           }
         },
-        "SensorSubscribeCmd": { 
+        "SensorSubscribeCmd": {
           "type": "array",
           "items": {
             "$ref": "#/components/SensorMessageAttributes",
···
     "Ok": {
       "type": "object",
       "description": "Signifies successful processing of the message indicated by the id.",
-      "anyOf": [ { "$ref": "#/components/IdMessage" } ]
+      "anyOf": [ { "$ref": "#/components/ClientIdMessage" } ]
     },
     "Ping": {
       "type": "object",
       "description": "Connection keep-alive message.",
-      "anyOf": [ { "$ref": "#/components/IdMessage" } ]
+      "anyOf": [ { "$ref": "#/components/ClientIdMessage" } ]
     },
     "Error": {
       "type": "object",
       "description": "Signifies the server encountered an error while processing the message indicated by the id.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ServerId" },
         "ErrorMessage": {
           "type": "string"
         },
···
       "type": "object",
       "description": "Used for connection/application testing. Causes server to echo back the string sent. Sending string of 'Error' will result in a server error. ",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "TestString": {
           "description": "String to be echo'd back from server. Setting this to 'Error' will cause an error to be thrown.",
           "type": "string"
···
       "type": "object",
       "description": "List of all available devices known to the system.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "Devices": {
           "description": "Array of device ids and names.",
           "type": "array",
···
     "DeviceRemoved": {
       "type": "object",
       "description": "Notifies client that a device of a certain type has been removed from the server.",
-      "anyOf": [ { "$ref": "#/components/DeviceIndexMessage" } ]
+      "anyOf": [ { "$ref": "#/components/SystemIdDeviceIndexMessage" } ]
     },
     "RequestDeviceList": {
       "type": "object",
       "description": "Request for the server to send a list of devices to the client.",
-      "anyOf": [ { "$ref": "#/components/IdMessage" } ]
+      "anyOf": [ { "$ref": "#/components/ClientIdMessage" } ]
     },
     "StartScanning": {
       "type": "object",
       "description": "Request for the server to start scanning for new devices.",
-      "anyOf": [ { "$ref": "#/components/IdMessage" } ]
+      "anyOf": [ { "$ref": "#/components/ClientIdMessage" } ]
     },
     "StopScanning": {
       "type": "object",
       "description": "Request for the server to stop scanning for new devices.",
-      "anyOf": [ { "$ref": "#/components/IdMessage" } ]
+      "anyOf": [ { "$ref": "#/components/ClientIdMessage" } ]
     },
     "ScanningFinished": {
       "type": "object",
···
       "type": "object",
       "description": "Request for server to stream log messages of a certain level to client.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "LogLevel": {
           "description": "Maximum level of log message to receive.",
           "enum": [ "Off", "Fatal", "Error", "Warn", "Info", "Debug", "Trace" ]
···
       "type": "object",
       "description": "Request server version, and relay client name.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "ClientName": {
           "description": "Name of the client software.",
           "type": "string"
···
       "type": "object",
       "description": "Server version information, in Major.Minor.Build format.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "ServerName": {
           "description": "Name of the server. Can be 0-length.",
           "type": "string"
···
       "type": "object",
       "description": "Sends speed and position command to the Fleshlight Launch Device denoted by the device index.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Speed": {
           "description": "Speed at which to move to designated position.",
···
       "type": "object",
       "description": "Sends a command string to a Lovense device. Command string will be verified by sender.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Command": {
           "description": "Command to send to Lovense device.",
···
       "type": "object",
       "description": "Sends a vibrate command to a device that supports vibration.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Speed": {
           "description": "Device vibration speed (floating point, 0 < x < 1), stepping will be device specific.",
···
       "type": "object",
       "description": "Sends a raw byte array to a device. Should only be used for testing/development.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Endpoint": {
           "type": "string",
···
       "type": "object",
       "description": "Request a raw byte array from a device. Should only be used for testing/development.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Endpoint": {
           "type": "string",
···
       "type": "object",
       "description": "Subscribe to an endpoint on a device to receive raw info back.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Endpoint": {
           "type": "string",
···
       "type": "object",
       "description": "Unsubscribe to an endpoint on a device.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Endpoint": {
           "type": "string",
···
       "type": "object",
       "description": "Raw byte array received from a device. Should only be used for testing/development.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ServerId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Endpoint": {
           "type": "string",
···
       "type": "object",
       "description": "Sends a raw byte string to a Kiiroo Onyx/Pearl device.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Command": {
           "description": "Command to send to Kiiroo device.",
···
       "type": "object",
       "description": "Requests that a BatteryLevel be retreived.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" }
       },
       "additionalProperties": false,
···
       "type": "object",
       "description": "Returns a BatteryLevel read from a device.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "BatteryLevel": {
           "description": "Battery Level",
···
       "type": "object",
       "description": "Requests that a RSSI level be retreived.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" }
       },
       "additionalProperties": false,
···
       "type": "object",
       "description": "Returns a BatteryLevel read from a device.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "RSSILevel": {
           "description": "RSSI Level",
···
       "type": "object",
       "description": "Sends a raw byte string to a Kiiroo Onyx/Pearl device.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Speed": {
           "description": "Rotation speed command for the Cyclone.",
···
       "type": "object",
       "description": "Stops the all actions currently being taken by a device.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" }
       },
       "additionalProperties": false,
···
     "StopAllDevices": {
       "type": "object",
       "description": "Stops all actions currently being taken by all connected devices.",
-      "anyOf": [ { "$ref": "#/components/IdMessage" } ]
+      "anyOf": [ { "$ref": "#/components/ClientIdMessage" } ]
     },
     "VibrateCmd": {
       "type": "object",
       "description": "Sends a vibrate command to a device that supports vibration.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Speeds": {
           "description": "Device vibration speeds (floating point, 0 < x < 1) keyed on vibrator number, stepping will be device specific.",
···
       "type": "object",
       "description": "Sends a generic scalar command to a device.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Scalars": {
           "description": "Device actution scalar (floating point, range can vary) keyed on acutator index, stepping will be device specific.",
···
               "ActuatorType": {
                 "description": "Actuator type that is expected to be controlled with this subcommand.",
                 "type": "string"
-              }              
+              }
             },
             "additionalProperties": false,
             "required": [
···
       "type": "object",
       "description": "Sends a rotate command to a device that supports rotation.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Rotations": {
           "description": "Device rotation speeds (floating point, 0 < x < 1) keyed on rotator number, stepping will be device specific.",
···
       "type": "object",
       "description": "Sends a linear movement command to a device that supports linear movements.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "Vectors": {
           "description": "Device linear movement times (milliseconds) and positions (floating point, 0 < x < 1) keyed on linear actuator number, stepping will be device specific.",
···
       "type": "object",
       "description": "Sends a request to read a sensor value.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "SensorIndex": { "type": "integer" },
         "SensorType": { "type": "string" }
···
         "DeviceIndex",
         "SensorIndex",
         "SensorType"
-      ]      
+      ]
     },
     "SensorReading": {
       "type": "object",
       "description": "Returns from either a sensor read request or a subscribed sensor event.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ServerId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "SensorIndex": { "type": "integer" },
         "SensorType": { "type": "string" },
-        "Data": { 
+        "Data": {
           "type": "array",
           "items": {
             "type": "integer",
···
         "SensorIndex",
         "SensorType",
         "Data"
-      ]      
+      ]
     },
     "SensorSubscribeCmd": {
       "type": "object",
       "description": "Sends a request to subscribe for updates to a sensor value.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "SensorIndex": { "type": "integer" },
         "SensorType": { "type": "string" }
···
         "DeviceIndex",
         "SensorIndex",
         "SensorType"
-      ]      
+      ]
     },
     "SensorUnsubscribeCmd": {
       "type": "object",
       "description": "Sends a request to subscribe for updates to a sensor value.",
       "properties": {
-        "Id": { "$ref": "#/components/Id" },
+        "Id": { "$ref": "#/components/ClientId" },
         "DeviceIndex": { "$ref": "#/components/DeviceIndex" },
         "SensorIndex": { "type": "integer" },
         "SensorType": { "type": "string" }
···
         "DeviceIndex",
         "SensorIndex",
         "SensorType"
-      ]      
-    }    
+      ]
+    }
   },
-  "type": "array",
-  "items": {
-    "title": "Messages",
-    "type": "object",
-    "description": "One or more messages validated by the Buttplug Message schema list.",
-    "properties": {
-      "BatteryLevelCmd": { "$ref": "#/messages/BatteryLevelCmd" },
-      "BatteryLevelReading": { "$ref": "#/messages/BatteryLevelReading" },
-      "DeviceList": { "$ref": "#/messages/DeviceList" },
-      "DeviceAdded": { "$ref": "#/messages/DeviceAdded" },
-      "DeviceRemoved": { "$ref": "#/messages/DeviceRemoved" },
-      "Error": { "$ref": "#/messages/Error" },
-      "FleshlightLaunchFW12Cmd": { "$ref": "#/messages/FleshlightLaunchFW12Cmd" },
-      "KiirooCmd": { "$ref": "#/messages/KiirooCmd" },
-      "ScalarCmd": { "$ref": "#/messages/ScalarCmd" },
-      "LinearCmd": { "$ref": "#/messages/LinearCmd" },
-      "Log": { "$ref": "#/messages/Log" },
-      "LovenseCmd": { "$ref": "#/messages/LovenseCmd" },
-      "Ok": { "$ref": "#/messages/Ok" },
-      "Ping": { "$ref": "#/messages/Ping" },
-      "RawReadCmd": { "$ref": "#/messages/RawReadCmd" },
-      "RawReading": { "$ref": "#/messages/RawReading" },
-      "RawWriteCmd": { "$ref": "#/messages/RawWriteCmd" },
-      "RawSubscribeCmd": { "$ref": "#/messages/RawSubscribeCmd" },
-      "RawUnsubscribeCmd": { "$ref": "#/messages/RawUnsubscribeCmd" },
-      "RequestDeviceList": { "$ref": "#/messages/RequestDeviceList" },
-      "RequestLog": { "$ref": "#/messages/RequestLog" },
-      "RequestServerInfo": { "$ref": "#/messages/RequestServerInfo" },
-      "RotateCmd": { "$ref": "#/messages/RotateCmd" },
-      "RSSILevelCmd": { "$ref": "#/messages/RSSILevelCmd" },
-      "RSSILevelReading": { "$ref": "#/messages/RSSILevelReading" },
-      "ScanningFinished": { "$ref": "#/messages/ScanningFinished" },
-      "SensorReadCmd": { "$ref": "#/messages/SensorReadCmd" },
-      "SensorReading": { "$ref": "#/messages/SensorReading" },
-      "SensorSubscribeCmd": { "$ref": "#/messages/SensorSubscribeCmd" },
-      "SensorUnsubscribeCmd": { "$ref": "#/messages/SensorUnsubscribeCmd" },
-      "ServerInfo": { "$ref": "#/messages/ServerInfo" },
-      "SingleMotorVibrateCmd": { "$ref": "#/messages/SingleMotorVibrateCmd" },
-      "StartScanning": { "$ref": "#/messages/StartScanning" },
-      "StopAllDevices": { "$ref": "#/messages/StopAllDevices" },
-      "StopDeviceCmd": { "$ref": "#/messages/StopDeviceCmd" },
-      "StopScanning": { "$ref": "#/messages/StopScanning" },
-      "Test": { "$ref": "#/messages/Test" },
-      "VibrateCmd": { "$ref": "#/messages/VibrateCmd" },
-      "VorzeA10CycloneCmd": { "$ref": "#/messages/VorzeA10CycloneCmd" }
+  "specs": {
+    "MessageSpecV3": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "All messages valid in Buttplug Spec v3",
+        "properties": {
+          "DeviceList": { "$ref": "#/messages/DeviceList" },
+          "DeviceAdded": { "$ref": "#/messages/DeviceAdded" },
+          "DeviceRemoved": { "$ref": "#/messages/DeviceRemoved" },
+          "Error": { "$ref": "#/messages/Error" },
+          "ScalarCmd": { "$ref": "#/messages/ScalarCmd" },
+          "LinearCmd": { "$ref": "#/messages/LinearCmd" },
+          "Ok": { "$ref": "#/messages/Ok" },
+          "Ping": { "$ref": "#/messages/Ping" },
+          "RawReadCmd": { "$ref": "#/messages/RawReadCmd" },
+          "RawReading": { "$ref": "#/messages/RawReading" },
+          "RawWriteCmd": { "$ref": "#/messages/RawWriteCmd" },
+          "RawSubscribeCmd": { "$ref": "#/messages/RawSubscribeCmd" },
+          "RawUnsubscribeCmd": { "$ref": "#/messages/RawUnsubscribeCmd" },
+          "RequestDeviceList": { "$ref": "#/messages/RequestDeviceList" },
+          "RequestServerInfo": { "$ref": "#/messages/RequestServerInfo" },
+          "RotateCmd": { "$ref": "#/messages/RotateCmd" },
+          "ScanningFinished": { "$ref": "#/messages/ScanningFinished" },
+          "SensorReadCmd": { "$ref": "#/messages/SensorReadCmd" },
+          "SensorReading": { "$ref": "#/messages/SensorReading" },
+          "SensorSubscribeCmd": { "$ref": "#/messages/SensorSubscribeCmd" },
+          "SensorUnsubscribeCmd": { "$ref": "#/messages/SensorUnsubscribeCmd" },
+          "ServerInfo": { "$ref": "#/messages/ServerInfo" },
+          "StartScanning": { "$ref": "#/messages/StartScanning" },
+          "StopAllDevices": { "$ref": "#/messages/StopAllDevices" },
+          "StopDeviceCmd": { "$ref": "#/messages/StopDeviceCmd" },
+          "StopScanning": { "$ref": "#/messages/StopScanning" }
+        },
+        "additionalProperties": false,
+        "minProperties": 1,
+        "maxProperties": 1
+      },
+      "minItems": 1
     },
-    "additionalProperties": false,
-    "minProperties": 1,
-    "maxProperties": 1
+    "MessageSpecV2": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "All messages valid in Buttplug Spec v2.",
+        "properties": {
+          "BatteryLevelCmd": { "$ref": "#/messages/BatteryLevelCmd" },
+          "BatteryLevelReading": { "$ref": "#/messages/BatteryLevelReading" },
+          "DeviceList": { "$ref": "#/messages/DeviceList" },
+          "DeviceAdded": { "$ref": "#/messages/DeviceAdded" },
+          "DeviceRemoved": { "$ref": "#/messages/DeviceRemoved" },
+          "Error": { "$ref": "#/messages/Error" },
+          "LinearCmd": { "$ref": "#/messages/LinearCmd" },
+          "Ok": { "$ref": "#/messages/Ok" },
+          "Ping": { "$ref": "#/messages/Ping" },
+          "RawReadCmd": { "$ref": "#/messages/RawReadCmd" },
+          "RawReading": { "$ref": "#/messages/RawReading" },
+          "RawWriteCmd": { "$ref": "#/messages/RawWriteCmd" },
+          "RawSubscribeCmd": { "$ref": "#/messages/RawSubscribeCmd" },
+          "RawUnsubscribeCmd": { "$ref": "#/messages/RawUnsubscribeCmd" },
+          "RequestDeviceList": { "$ref": "#/messages/RequestDeviceList" },
+          "RequestLog": { "$ref": "#/messages/RequestLog" },
+          "RequestServerInfo": { "$ref": "#/messages/RequestServerInfo" },
+          "RotateCmd": { "$ref": "#/messages/RotateCmd" },
+          "RSSILevelCmd": { "$ref": "#/messages/RSSILevelCmd" },
+          "RSSILevelReading": { "$ref": "#/messages/RSSILevelReading" },
+          "ScanningFinished": { "$ref": "#/messages/ScanningFinished" },
+          "ServerInfo": { "$ref": "#/messages/ServerInfo" },
+          "StartScanning": { "$ref": "#/messages/StartScanning" },
+          "StopAllDevices": { "$ref": "#/messages/StopAllDevices" },
+          "StopDeviceCmd": { "$ref": "#/messages/StopDeviceCmd" },
+          "StopScanning": { "$ref": "#/messages/StopScanning" },
+          "VibrateCmd": { "$ref": "#/messages/VibrateCmd" }
+        },
+        "additionalProperties": false,
+        "minProperties": 1,
+        "maxProperties": 1
+      },
+      "minItems": 1
+    },
+    "MessageSpecV1": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "One or more messages validated by the Buttplug Message schema list.",
+        "properties": {
+          "DeviceList": { "$ref": "#/messages/DeviceList" },
+          "DeviceAdded": { "$ref": "#/messages/DeviceAdded" },
+          "DeviceRemoved": { "$ref": "#/messages/DeviceRemoved" },
+          "Error": { "$ref": "#/messages/Error" },
+          "FleshlightLaunchFW12Cmd": { "$ref": "#/messages/FleshlightLaunchFW12Cmd" },
+          "KiirooCmd": { "$ref": "#/messages/KiirooCmd" },
+          "LinearCmd": { "$ref": "#/messages/LinearCmd" },
+          "Log": { "$ref": "#/messages/Log" },
+          "Ok": { "$ref": "#/messages/Ok" },
+          "Ping": { "$ref": "#/messages/Ping" },
+          "RequestDeviceList": { "$ref": "#/messages/RequestDeviceList" },
+          "RequestLog": { "$ref": "#/messages/RequestLog" },
+          "RequestServerInfo": { "$ref": "#/messages/RequestServerInfo" },
+          "RotateCmd": { "$ref": "#/messages/RotateCmd" },
+          "ServerInfo": { "$ref": "#/messages/ServerInfo" },
+          "StartScanning": { "$ref": "#/messages/StartScanning" },
+          "StopAllDevices": { "$ref": "#/messages/StopAllDevices" },
+          "StopDeviceCmd": { "$ref": "#/messages/StopDeviceCmd" },
+          "StopScanning": { "$ref": "#/messages/StopScanning" },
+          "Test": { "$ref": "#/messages/Test" },
+          "VibrateCmd": { "$ref": "#/messages/VibrateCmd" },
+          "VorzeA10CycloneCmd": { "$ref": "#/messages/VorzeA10CycloneCmd" }
+        },
+        "additionalProperties": false,
+        "minProperties": 1,
+        "maxProperties": 1
+      },
+      "minItems": 1
+    },
+    "MessageSpecV0": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "One or more messages validated by the Buttplug Message schema list.",
+        "properties": {
+          "DeviceList": { "$ref": "#/messages/DeviceList" },
+          "DeviceAdded": { "$ref": "#/messages/DeviceAdded" },
+          "DeviceRemoved": { "$ref": "#/messages/DeviceRemoved" },
+          "Error": { "$ref": "#/messages/Error" },
+          "FleshlightLaunchFW12Cmd": { "$ref": "#/messages/FleshlightLaunchFW12Cmd" },
+          "KiirooCmd": { "$ref": "#/messages/KiirooCmd" },
+          "Log": { "$ref": "#/messages/Log" },
+          "Ok": { "$ref": "#/messages/Ok" },
+          "Ping": { "$ref": "#/messages/Ping" },
+          "RequestDeviceList": { "$ref": "#/messages/RequestDeviceList" },
+          "RequestLog": { "$ref": "#/messages/RequestLog" },
+          "RequestServerInfo": { "$ref": "#/messages/RequestServerInfo" },
+          "ServerInfo": { "$ref": "#/messages/ServerInfo" },
+          "SingleMotorVibrateCmd": { "$ref": "#/messages/SingleMotorVibrateCmd" },
+          "StartScanning": { "$ref": "#/messages/StartScanning" },
+          "StopAllDevices": { "$ref": "#/messages/StopAllDevices" },
+          "StopDeviceCmd": { "$ref": "#/messages/StopDeviceCmd" },
+          "StopScanning": { "$ref": "#/messages/StopScanning" },
+          "Test": { "$ref": "#/messages/Test" },
+          "VorzeA10CycloneCmd": { "$ref": "#/messages/VorzeA10CycloneCmd" }
+        },
+        "additionalProperties": false,
+        "minProperties": 1,
+        "maxProperties": 1
+      },
+      "minItems": 1
+    }
   },
-  "minItems": 1,
-  "additionalProperties": false
+  "anyOf": [ 
+    { "$ref": "#/specs/MessageSpecV3" }, 
+    { "$ref": "#/specs/MessageSpecV2" },
+    { "$ref": "#/specs/MessageSpecV1" }, 
+    { "$ref": "#/specs/MessageSpecV0" }
+  ]
 }

buttplug/src/core/messages/serializer/json_serializer.rs

···
       // Valid json and message type but not an array.
       "{\"Ok\":{\"Id\":0}}",
       // Valid json and message type but not an array.
-      // TODO This should fail (Ok can't have an Id of 0), but currently doesn't.
-      // "[{\"Ok\":{\"Id\":0}}]",
+      "[{\"Ok\":{\"Id\":0}}]",
       // Valid json and message type but with extra content
       "[{\"Ok\":{\"NotAField\":\"NotAValue\",\"Id\":1}}]",
     ];
···
     .into()]);
     for msg in incorrect_incoming_messages {
       let res = serializer.deserialize(ButtplugSerializedMessage::Text(msg.to_owned()));
-      assert!(res.is_err());
+      assert!(res.is_err(), "{} should be an error", msg);
       if let Err(ButtplugSerializerError::MessageSpecVersionNotReceived) = res {
         assert!(false, "Wrong error!");
       }