Repository navigation
Relay v1.3.0 - SDK Contract Alignment
Relay v1.3.0 Phase 1–7: Reliability Refactor Complete
All phases of the Reliability Refactor, merged today (2026-11-10), plus the SDK contract alignment.
What's in this release
This release bundles everything merged today:
| PR | Phase | Title |
|---|---|---|
| #86 | Phase 0–1 | chore(relay): improve delivery configuration and monitoring security |
| #87 | Phase 1 | docs(reliability): freeze event-delivery lifecycle contract and record baseline |
| #88 | Phase 1 | fix(reconciler): atomic lease recovery and correct orphan timestamp |
| #89 | Phase 2 | fix(fanout): record fanout status and recover incomplete fan-out |
| #90 | Phase 3 | refactor(lifecycle): introduce parent-status aggregator (§5) |
| #91 | Phase 4 | fix(replay): requeue failed deliveries and preserve attempt history (§8) |
| #92 | Phase 5 | test(reliability): failure-oriented integration coverage (§10) |
| #93 | Phase 6 | security(production): SSRF defense, signing freshness, index verification (§13) |
| #94 | Phase 7 | feat(sdk): align Go, Node, and Python SDKs with server contract (§13) |
| #85 | — | docs(deployment): add Docker Compose troubleshooting guide |
Phase 7 — SDK Contract Alignment
All three SDKs aligned with the server's actual API contract.
| SDK | Previous | New | Highlights |
|---|---|---|---|
| Go | 0.1.0 | 0.2.0 | Event inspection, listing, replay, delivery tracking, endpoint management, health checks, webhook signature utilities |
| Node.js | 1.0.0 | 2.0.0 | TypeScript models, API error handling, full endpoint coverage, native HMAC-SHA256 signing |
| Python | 0.1.2 | 0.2.0 | Corrected models, serialization fixes, signature utilities with timestamp-freshness validation |
OpenAPI
All 14 endpoints documented. swagger.json, swagger.yaml, docs.go regenerated.
CI
New sdk-integration job runs Go, Node, and Python SDK test suites against a live Relay server backed by MongoDB. pnpm pinned to 10.34.9 via packageManager in sdk-node/package.json and in the CI step.
Breaking changes
- Idempotency keys now required for event ingestion
- Response models in all SDKs match server contract
- Endpoint creation requires
name
What's Changed
- feat(sdk): align Go, Node, and Python SDKs with server contract (§13) by @rajputomsingh in #94
- security(production): SSRF defense, signing freshness, index verification (§13) by @rajputomsingh in #93
- test(reliability): failure-oriented integration coverage (§10) by @rajputomsingh in #92
- fix(replay): requeue failed deliveries and preserve attempt history (§8) by @rajputomsingh in #91
- refactor(lifecycle): introduce parent-status aggregator (§5) by @rajputomsingh in #90
- fix(fanout): record fanout status and recover incomplete fan-out by @rajputomsingh in #89
- fix(reconciler): atomic lease recovery and correct orphan timestamp by @rajputomsingh in #88
- docs(reliability): freeze event-delivery lifecycle contract and record baseline by @rajputomsingh in #87
- chore(relay): improve delivery configuration and monitoring security by @rajputomsingh in #86
- docs(deployment): add Docker Compose troubleshooting guide by @sospeter-57 in #85
Full Changelog: v0.4.0...v1.3.0