SDK Surface and Language Clients

Language-specific client guidance for consuming Aegis APIs consistently across web, backend, and CLI integrations.

Go

Use Go services for backend consumption and run integration tests.

go run ./services/api/cmd/server
go test ./services/api/...

TypeScript

Use TypeScript clients in web apps and validate with lint and E2E.

pnpm --filter @aegis/web lint
pnpm --filter @aegis/web test:e2e

Bash / CLI

Use direct HTTP calls for diagnostics and smoke checks in CI scripts.

curl -X POST "$API_BASE/aegis.v1.BrokerService/MintUserApiToken" \
  -H "Authorization: Bearer $FIREBASE_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -d @mint-user-token.json

Release Discipline

Pin SDK revisions to tagged releases.
Run compatibility tests on every API schema update.
Publish migration notes for removed or renamed fields.

Open Versioning Policy