Skip to content

Releases

Relay v1.4.0 - relay-cli Complete

Choose a tag to compare

@github-actions github-actions released this 16 Nov 17:33
eb98d4a

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 DeleteEndpoint support 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 --help

For Linux and macOS:

chmod +x relay-cli-*
./relay-cli-linux-amd64 --help

Validation

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:

  1. Authenticate using the CLI.
  2. Create and configure an endpoint.
  3. Submit an event.
  4. Process the event through the delivery worker.
  5. Forward the webhook to a local receiver.
  6. 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

Choose a tag to compare

@rajputomsingh rajputomsingh released this 13 Nov 14:10
88dccb1

What's Changed

New Contributors

Full Changelog: v1.2.0...v1.2.1

v1.2.0 - Developer Experience

Choose a tag to compare

@rajputomsingh rajputomsingh released this 13 Nov 05:07
542f59d

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

Choose a tag to compare

@rajputomsingh rajputomsingh released this 10 Nov 15:41
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

Phase 6 - Production Hardening

Choose a tag to compare

@rajputomsingh rajputomsingh released this 10 Nov 15:38
8e17a60

SSRF defense, signing freshness, index verification. PR #93.

Phase 5 - Failure-Oriented Tests

Choose a tag to compare

@rajputomsingh rajputomsingh released this 10 Nov 15:38
bd710ed

Failure-oriented integration coverage. PR #92.

Phase 4 - Replay Requeue

Choose a tag to compare

@rajputomsingh rajputomsingh released this 10 Nov 15:38
951bba1

Failed delivery requeue with attempt history preservation. PR #91.

Phase 3 - Event Lifecycle Aggregation

Choose a tag to compare

@rajputomsingh rajputomsingh released this 10 Nov 15:38
9cc112c

Parent-status aggregator for event lifecycle. PR #90.

Phase 2 - Fan-out Recovery

Choose a tag to compare

@rajputomsingh rajputomsingh released this 10 Nov 15:38
4447ff7

Fan-out status recording and incomplete fan-out recovery. PR #89.

Relay v0.4.0 - Multi-Endpoint Delivery

Choose a tag to compare

@rajputomsingh rajputomsingh released this 14 Oct 12:32
85262b2

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.