Repository navigation
Releases
Relay v1.4.0 - relay-cli Complete
Relay v1.4.0 - relay-cli Complete
Relay v1.4.0 introduces the complete relay-cli, making it easier to manage endpoints, publish events, inspect delivery history, replay events, and forward webhooks to local development environments.
This release also includes reliability improvements, SDK updates, health monitoring, and documentation improvements.
What's New
relay-cli
The new Relay CLI provides a terminal interface for interacting with your Relay instance.
Features
- API key authentication with
relay-cli login - Create, list, update, and delete endpoints
- Send events directly from the terminal
- List event history
- Replay previously accepted events
- Listen for incoming webhook deliveries locally
- Forward webhook requests to a local development server
- HMAC signature generation for forwarded webhook requests
Quick Start
relay-cli login --api-key <your-api-key>
relay-cli endpoints list
relay-cli events send \
--source my-app \
--type user.created \
--data '{"user_id":"u_1"}'
relay-cli listen \
--forward-to http://localhost:3000/webhook \
--secret whsec_...Cross-platform binaries
Prebuilt CLI binaries are available for:
| Platform | Architecture | Binary |
|---|---|---|
| Linux | AMD64 | relay-cli-linux-amd64 |
| Linux | ARM64 | relay-cli-linux-arm64 |
| macOS | AMD64 | relay-cli-darwin-amd64 |
| macOS | ARM64 | relay-cli-darwin-arm64 |
| Windows | AMD64 | relay-cli-windows-amd64.exe |
Download the appropriate binary from the v1.4.0 release page.
SHA256 checksums are included in checksums.txt.
Reliability and delivery improvements
- Improved delivery worker reliability.
- Improved cancellation handling and test coverage.
- Fixed a data race in concurrent execution.
- Improved delivery health reporting.
- Added delivery latency percentile monitoring.
- Improved endpoint lifecycle handling.
SDK and documentation
- Added
DeleteEndpointsupport to the Go SDK. - Improved SDK documentation.
- Expanded CLI documentation.
- Added shell completion documentation for Bash, Zsh, Fish, and PowerShell.
- Updated project documentation and contributor guidance.
Health and observability
- Improved service-level health reporting.
- Extended worker health visibility.
- Continued improvements to delivery observability.
Installation
Download the binary for your platform from:
https://github.com/rajputomsingh/Relay/releases/tag/v1.4.0
For Windows, rename the downloaded executable to relay-cli.exe if desired, then run:
.\relay-cli.exe --helpFor Linux and macOS:
chmod +x relay-cli-*
./relay-cli-linux-amd64 --helpValidation
The release was validated with:
go test ./...
go vet ./...
go build ./...
golangci-lint run --config=.golangci.yml ./...The CLI was also manually tested through the complete delivery flow:
- Authenticate using the CLI.
- Create and configure an endpoint.
- Submit an event.
- Process the event through the delivery worker.
- Forward the webhook to a local receiver.
- Verify the HMAC signature and delivery response.
Cross-platform release binaries and SHA256 checksums were generated.
Known Limitations
- Relay currently operates with a single-tenant architecture.
- Endpoint deletion is implemented as a soft delete.
- A web dashboard is not yet available.
- Timestamp-based HMAC replay protection remains planned.
See the multi-tenant architecture RFC.
What's Next
The next development priorities include:
- Multi-tenant architecture and tenant isolation.
- Dashboard and endpoint management UI.
- Timestamp-based HMAC replay protection.
- Further SDK improvements and automated releases.
- Continued improvements to delivery observability and reliability.
Contributors
Thanks to everyone who contributed to this release, reported issues, reviewed changes, and helped improve Relay.
Special thanks to:
Links
Relay v1.4.0 is now available.
Built for reliable webhook delivery.
v1.2.1 - CI Migration
What's Changed
- ci: configure CircleCI as primary CI by @rajputomsingh in #106
- feat(sdk-go): add endpoint health retrieval by @sinbumu in #107
- chore(gitignore): ignore session scratch files by @rajputomsingh in #110
- ci: add GitHub Actions workflow as primary CI by @rajputomsingh in #111
- ci: remove CircleCI config by @rajputomsingh in #112
- ci: add emojis and production improvements by @rajputomsingh in #113
- docs: remove CircleCI fork setup section by @rajputomsingh in #114
New Contributors
Full Changelog: v1.2.0...v1.2.1
v1.2.0 - Developer Experience
What's Changed
ci: configure CircleCI as primary CI by @rajputomsingh in #106
feat(sdk-go): add endpoint health retrieval by @sinbumu in #107
chore(gitignore): ignore session scratch files by @rajputomsingh in #110
ci: add GitHub Actions workflow as primary CI by @rajputomsingh in #111
ci: remove CircleCI config by @rajputomsingh in #112
ci: add emojis and production improvements by @rajputomsingh in #113
docs: remove CircleCI fork setup section by @rajputomsingh in #114
New Contributors
@sinbumu made their first contribution in #107
Full Changelog: v0.4.0...v1.2.0
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
Phase 6 - Production Hardening
SSRF defense, signing freshness, index verification. PR #93.
Phase 5 - Failure-Oriented Tests
Failure-oriented integration coverage. PR #92.
Phase 4 - Replay Requeue
Failed delivery requeue with attempt history preservation. PR #91.
Phase 3 - Event Lifecycle Aggregation
Parent-status aggregator for event lifecycle. PR #90.
Phase 2 - Fan-out Recovery
Fan-out status recording and incomplete fan-out recovery. PR #89.
Relay v0.4.0 - Multi-Endpoint Delivery
Highlights
- Added multi-endpoint delivery support.
- Extended Relay's delivery pipeline to support multiple configured endpoints.
- Built on the existing event persistence and delivery infrastructure.
Compatibility
This release extends Relay's existing event ingestion and webhook delivery workflow.
Validation
See the checks associated with the release commit for verified build and test results.