# SuiteLink Integration Tests

These tests are intentionally safe by default and run only when explicitly enabled.

## Enable

Set:

- `SUITELINK_IT_ENABLED=true`

Required connection variables:

- `SUITELINK_IT_HOST`
- `SUITELINK_IT_APPLICATION`
- `SUITELINK_IT_TOPIC`
- `SUITELINK_IT_CLIENT_NAME`
- `SUITELINK_IT_CLIENT_NODE`
- `SUITELINK_IT_USER_NAME`
- `SUITELINK_IT_SERVER_NODE`

Optional connection variables:

- `SUITELINK_IT_PORT` (default `5413`)
- `SUITELINK_IT_TIMEZONE` (defaults to `UTC` via `SuiteLinkConnectionOptions`)

Optional tag variables (tests run only for the tags provided):

- `SUITELINK_IT_BOOL_TAG`
- `SUITELINK_IT_INT_TAG`
- `SUITELINK_IT_FLOAT_TAG`
- `SUITELINK_IT_STRING_TAG`

## Notes

- If integration settings are missing, tests return immediately and do not perform network calls.
- These tests are intended as a live harness, not deterministic CI tests.
- The client runtime now uses a background receive loop with automatic reconnect, durable subscription replay, and optional best-effort latest-value catch-up replay after reconnect.
- Reconnect timing is policy-based and jittered by default.
- These live tests still need validation against a real AVEVA server that allows legacy or mixed-mode SuiteLink traffic.
- Writes are intentionally rejected while the client is in `Reconnecting`.