7. Валидация ответов

{
  "id": "123",
  "age": 12,
  "status": "active"
}

package api_test

import (
    "regexp"
    "testing"

    "github.com/stretchr/testify/require"
)

// Компилируем конечные автоматы ровно один раз при инициализации тестового пакета
var (
    uuidV4Regex = regexp.MustCompile(`^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$`)
    emailRegex  = regexp.MustCompile(`^[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,}$`)
)

type UserResponse struct {
    ID    string `json:"id"`
    Email string `json:"email"`
    Age   int    `json:"age"`
}

func assertValidResponseFormat(t *testing.T, resp UserResponse) {
    t.Helper()

    // Валидируем структурное соответствие контракту
    require.Regexp(t, uuidV4Regex, resp.ID, "Идентификатор ID обязан соответствовать стандарту UUID v4")
    require.Regexp(t, emailRegex, resp.Email, "Поле Email содержит некорректный адрес электронной почты")
}

type Transaction struct {
    ID        string    `json:"id"`
    Amount    float64   `json:"amount"`
    CreatedAt time.Time `json:"created_at"`
}

// assertSortedByDateDesc проверяет строгую сортировку по убыванию
func assertSortedByDateDesc(t *testing.T, items []Transaction) {
    t.Helper()
    for i := 1; i < len(items); i++ {
        prev := items[i-1].CreatedAt
        curr := items[i].CreatedAt

        // Предыдущая запись обязана быть новее или равна текущей
        require.Truef(t, prev.After(curr) || prev.Equal(curr),
            "Нарушена сортировка: элемент [%d] (%v) старее элемента [%d] (%v)",
            i-1, prev, i, curr)
    }
}

func assertValidAgeRule(t *testing.T, resp UserResponse) {
    t.Helper()
    require.GreaterOrEqual(t, resp.Age, 18, "Сервис нарушил бизнес-правило: пользователь моложе 18 лет")
    require.Less(t, resp.Age, 130, "Зафиксировано аномальное значение возраста")
}

func assertRecentTimestamp(t *testing.T, actual time.Time) {
    t.Helper()

    now := time.Now().UTC() // Все проверки времени выполняются строго в UTC!

    // 1. Проверяем, что метка времени не пришла из будущего (с запасом на сетевой рассинхрон)
    require.True(t, actual.Before(now.Add(2*time.Second)),
        "Временная метка created_at опережает текущее время сервера")

    // 2. Проверяем, что событие произошло недавно (в пределах последних 5 секунд)
    require.WithinDuration(t, now, actual, 5*time.Second,
        "Временная метка created_at устарела относительно момента вызова")
}

package api_test

import (
    "encoding/json"
    "testing"

    "github.com/santhosh-tekuri/jsonschema/v5"
    "github.com/stretchr/testify/require"
)

// Компилируем JSON-схему однократно при старте пакета
var userResponseSchema = jsonschema.MustCompileString("user_schema.json", `{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": ["id", "email", "status", "age"],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "status": {
      "type": "string",
      "enum": ["active", "pending", "banned"]
    },
    "age": {
      "type": "integer",
      "minimum": 18,
      "maximum": 120
    }
  }
}`)

func TestAPI_CreateUser_JSONSchema(t *testing.T) {
    t.Parallel()

    // Получаем сырые байты ответа от HTTP-рекордера
    bodyBytes := []byte(`{
        "id": "e4eaaaf2-d142-11e1-b3e4-080027620cdd",
        "email": "invalid-email-address",
        "status": "active",
        "age": 16
    }`)

    // Десериализуем в нетипизированный интерфейс для анализатора схемы
    var parsedResponse any
    err := json.Unmarshal(bodyBytes, &parsedResponse)
    require.NoError(t, err)

    // Валидируем документ против скомпилированной схемы
    err = userResponseSchema.Validate(parsedResponse)

    // При нарушении контракта валидатор выдаст исчерпывающий отчет:
    // - "email" is not a valid email address
    // - "age" must be greater than or equal to 18
    require.NoError(t, err, "Полезная нагрузка ответа нарушает утвержденную JSON-схему")
}