Skip to content

Relay v1.3.0 - SDK Contract Alignment

Choose a tag to compare

@rajputomsingh rajputomsingh released this 10 Nov 15:41
· 58 commits to main since this release
6192547

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