Testing Guide

Running Tests

Unit Tests

Run all unit tests (default):

go test ./...

Integration Tests

Integration tests require external services (NATS, Redis) and use the -tags=integration build tag.

Prerequisites:

• NATS running (Docker: docker compose up -d nats)
• Redis running (Docker: docker compose up -d redis)

Run all integration tests:

go test -tags=integration ./...

Run specific package:

# ECDSA tests (requires environment variables)
op run --env-file=internal/support/ecdsa/test.env -- go test -tags=integration ./internal/support/ecdsa

# Consumer API tests
go test -tags=integration ./services/consumer/api

# OMS (Object Management System) tests
go test ./internal/domain/oms

Test Status

✅ Passing Tests

• Unit Tests: internal/domain/oms, internal/domain/*, internal/support/geoip, internal/support/jwt, internal/support/locks, internal/infra/store, internal/domain/txnlib
• Integration Tests: services/consumer/api, internal/support/ecdsa (with env vars)

🔧 Requires Environment Setup

• internal/support/ecdsa - requires ST8_PRIVATE_KEY and ST8_PUBLIC_KEY env vars
• services/consumer/api - requires NATS running

CI/CD

Tests work out-of-the-box in CI environments:

# Start required services (for integration tests)
docker compose up -d nats redis

# Run all tests
go test ./...

# Run integration tests only
go test -tags=integration ./...