Method handleJsonMessage

app/src/API/Server.cpp:888–938

* @brief Dispatches a validated JSON message to the appropriate handler. */

 * @brief Dispatches a validated JSON message to the appropriate handler.
 */
void API::Server::handleJsonMessage(QTcpSocket* socket,
                                    ConnectionState& state,
                                    const QByteArray& jsonBytes)
{
  Q_ASSERT(socket);
  Q_ASSERT(!jsonBytes.isEmpty());

  if (!validateJsonMessage(socket, state, jsonBytes))
    return;

  if (MCP::isMCPMessage(jsonBytes)) {
    auto& mcpHandler    = API::MCPHandler::instance();
    const auto response = mcpHandler.processMessage(jsonBytes, state.sessionId);

    if (!response.isEmpty())
      sendResponseToSocket(socket, response);

    return;
  }

  QString type;
  QJsonObject json;
  try {
    if (!API::parseMessage(jsonBytes, type, json)) {
      sendResponseToSocket(
        socket,
        CommandResponse::makeError(
          QString(), ErrorCode::InvalidJson, QStringLiteral("Failed to parse JSON message"))
          .toJsonBytes());
      return;
    }
  } catch (...) {
    qWarning() << "[API] JSON parsing exception:" << state.peerAddress << ":" << state.peerPort
               << "- Message size:" << jsonBytes.size()
               << "- Disconnecting client (malformed or too deep JSON)";

    disconnectClient(socket,
                     state,
                     ErrorCode::InvalidJson,
                     QStringLiteral("JSON parsing failed (malformed or too deep)"));
    return;
  }

  if (type == MessageType::Raw) {
    processRawJsonCommand(socket, state, json);
    return;
  }

  auto& cmdHandler = API::CommandHandler::instance();
  sendResponseToSocket(socket, cmdHandler.processMessage(jsonBytes, CommandOrigin::Remote));
}

/**
 * @brief Processes a JSON "raw" command that forwards base64 data to the device.