What problem does it solve?
relay-core centralizes contract schema, validation, envelope models, and security primitives so teams can safely ingest, route, and deliver webhook events without runtime surprises or silent failures.
Core Features & Use Cases
- Shared contract schema with deny_unknown_fields to prevent misconfiguration and drift across serve, relay, smash, and runtime components.
- Active-profile fail-closed validation that rejects unsupported active adapters, enforces required adapter keys, and verifies transport references.
- Envelope and metadata compatibility helpers, HMAC signature verification, payload sanitization with injection detection, timestamp replay protection, and Kafka core configuration loading and validation.
- Use Case: Validate a contract.toml in CI to catch missing adapters, unknown keys, or security-critical misconfigurations before deployment.
Quick Start
Run validation and tests for the relay-core library to ensure contract schema, adapter schemas, signature checks, and sanitization behavior are correct.