Method projectBatch

app/src/API/Handlers/ProjectHandler.cpp:5426–5487

* @brief Runs an array of project mutations under a single suspended-autosave window. */

 * @brief Runs an array of project mutations under a single suspended-autosave window.
 */
API::CommandResponse API::Handlers::ProjectHandler::projectBatch(const QString& id,
                                                                 const QJsonObject& params)
{
  QJsonArray ops;
  if (const auto invalid = validateBatchOps(id, params, ops); invalid)
    return *invalid;

  const bool stopOnError = params.value(QStringLiteral("stopOnError")).toBool(false);
  const bool isDryRun    = params.value(QStringLiteral("dryRun")).toBool(false);

  if (isDryRun) {
    if (const auto invalid = ensureBatchDryRunCompatible(id, ops); invalid)
      return *invalid;
  }

  auto& project = DataModel::ProjectModel::instance();
  if (!isDryRun)
    project.setAutoSaveSuspended(true);

  QJsonArray results;
  int successCount = 0;
  int failureCount = 0;
  bool aborted     = false;

  for (int i = 0; i < ops.size(); ++i) {
    bool opSucceeded  = false;
    QJsonObject entry = executeBatchOp(i, ops.at(i).toObject(), isDryRun, opSucceeded);
    results.append(entry);
    if (opSucceeded)
      ++successCount;
    else
      ++failureCount;

    if (!opSucceeded && stopOnError) {
      aborted = true;
      break;
    }
  }

  if (!isDryRun) {
    project.setAutoSaveSuspended(false);
    project.flushAutoSave();
  }

  QJsonObject result;
  if (isDryRun)
    result[QStringLiteral("dryRun")] = true;

  result[QStringLiteral("results")]   = results;
  result[QStringLiteral("total")]     = ops.size();
  result[QStringLiteral("succeeded")] = successCount;
  result[QStringLiteral("failed")]    = failureCount;
  result[QStringLiteral("aborted")]   = aborted;
  result[QStringLiteral("autoSaveMode")] =
    isDryRun ? QStringLiteral("none") : QStringLiteral("flushed");
  if (isDryRun)
    result[QStringLiteral("warning")] =
      QStringLiteral("DRY RUN: no ops were committed. Each op's per-result still carries the "