Function executeBatchOp

app/src/API/Handlers/ProjectHandler.cpp:5288–5348

* @brief Validates and executes a single project.batch op; returns the per-op result entry. */

 * @brief Validates and executes a single project.batch op; returns the per-op result entry.
 */
static QJsonObject executeBatchOp(int index, const QJsonObject& op, bool dryRun, bool& success)
{
  success = false;

  if (op.isEmpty()) {
    return buildBatchErrorEntry(
      index,
      QString(),
      API::ErrorCode::InvalidParam,
      QStringLiteral("ops[%1] must be an object of shape {command: string, params: object}")
        .arg(index),
      buildBatchSchemaHint());
  }

  const auto command = op.value(QStringLiteral("command")).toString();
  auto opParams      = op.value(QStringLiteral("params")).toObject();

  if (command.isEmpty()) {
    return buildBatchErrorEntry(index,
                                QString(),
                                API::ErrorCode::MissingParam,
                                QStringLiteral("ops[%1].command is required (each op is "
                                               "{command: '<registered name>', params: {...}})")
                                  .arg(index),
                                buildBatchSchemaHint());
  }

  if (command == QStringLiteral("project.batch")) {
    return buildBatchErrorEntry(index,
                                command,
                                API::ErrorCode::InvalidParam,
                                QStringLiteral("project.batch cannot be nested"),
                                QJsonObject());
  }

  if (dryRun)
    opParams.insert(QStringLiteral("dryRun"), true);

  const auto response =
    API::CommandRegistry::instance().execute(command, QString::number(index), opParams);

  QJsonObject entry;
  entry[QStringLiteral("index")]   = index;
  entry[QStringLiteral("command")] = command;
  entry[QStringLiteral("success")] = response.success;
  if (response.success) {
    if (!response.result.isEmpty())
      entry[QStringLiteral("result")] = response.result;

    success = true;
  } else {
    QJsonObject err;
    err[QStringLiteral("code")]    = response.errorCode;
    err[QStringLiteral("message")] = response.errorMessage;
    if (!response.errorData.isEmpty())
      err[QStringLiteral("data")] = response.errorData;

    entry[QStringLiteral("error")] = err;