Method frameParserDryCompile

app/src/API/Handlers/ProjectHandler.cpp:6007–6056

* @brief Compile-only check for a frame parser; surfaces syntax errors without running. */

 * @brief Compile-only check for a frame parser; surfaces syntax errors without running.
 */
API::CommandResponse API::Handlers::ProjectHandler::frameParserDryCompile(const QString& id,
                                                                          const QJsonObject& params)
{
  if (!params.contains(QStringLiteral("code")))
    return CommandResponse::makeError(
      id, ErrorCode::MissingParam, QStringLiteral("Missing required parameter: code"));

  if (!params.contains(QStringLiteral("language")))
    return CommandResponse::makeError(
      id, ErrorCode::MissingParam, QStringLiteral("Missing required parameter: language"));

  const auto code     = params.value(QStringLiteral("code")).toString();
  const auto language = params.value(QStringLiteral("language")).toInt();

  if (language != SerialStudio::JavaScript && language != SerialStudio::Lua
      && language != SerialStudio::Native)
    return CommandResponse::makeError(
      id,
      ErrorCode::InvalidParam,
      QStringLiteral("Invalid language: must be 0 (JavaScript), 1 (Lua) or 2 (Built-In)"));

  auto engine   = makeScriptEngine(language);
  const bool ok = engine->loadScript(code, 0, false);

  QJsonObject result;
  result[QStringLiteral("ok")] = ok;
  if (language == SerialStudio::Native)
    result[QStringLiteral("language")] = QStringLiteral("native");
  else
    result[QStringLiteral("language")] =
      (language == SerialStudio::Lua ? QStringLiteral("lua") : QStringLiteral("javascript"));

  if (!ok) {
    if (language == SerialStudio::Native)
      result[QStringLiteral("error")] = QStringLiteral(
        "Invalid native parser descriptor: expected {\"template\": id, \"params\": {...}} "
        "with a known template id and valid params.");
    else
      result[QStringLiteral("error")] =
        QStringLiteral("Compile failed or parse(frame) is not defined.");

    if (language != SerialStudio::Native) {
      const auto warning = detectLanguageMismatch(code, language);
      if (!warning.isEmpty())
        result[QStringLiteral("warning")] = warning;
    }
  }

  return CommandResponse::makeSuccess(id, result);
}

/**
 * @brief Transform dry-run: compile + apply transform() to a list of values.