# Integration Test

This directory contains an end-to-end test for publishing to the registry.

## What the Test Covers

1. **Publisher Tool**: Tests the `publisher` CLI that publishes metadata to the registry
2. **Registry API**: Validates that `/v0/publish`, `GET /v0/servers`, and `GET /v0/servers/{serverName}/versions/latest` work correctly
3. **Example Validation**: Ensures all example JSON in `docs/reference/server-json/generic-server-json.md` is valid and can be published
4. **Data Consistency**: Verifies published data matches what's retrieved from the registry

## Test Flow

1. **Build**: Build `publisher` and `registry`
2. **Start Services**: Launch registry and PostgreSQL using Docker Compose with test configuration
3. **Publish Examples**: Extract JSON examples from documentation and run `publisher` to publish each one
4. **Validate Responses**: GET each published server from the registry and compare it to the example JSON
5. **Cleanup**: Stop Docker containers and remove temporary files

## How to Run

### Prerequisites

- Docker and Docker Compose
- Go — see the [prerequisites in the root README](../../README.md#pre-requisites) for the required version
- Make sure you're in the repository root directory

### Run the Tests

```sh
./tests/integration/run.sh
```

**Note**: Integration tests use isolated container names (`registry-integration-test`, `postgres-integration-test`) to prevent conflicts with development containers from `make dev-compose`.