Connectum provides modular packages for gRPC and ConnectRPC services. Published packages contain compiled JavaScript; running an application's TypeScript source directly has separate runtime requirements. See Runtime Compatibility.
This README documents the 1.3 release line. Installing from npm resolves the latest published package versions, which may predate changes on the main branch of this repository.
Packages
| Package | What's inside |
|---|
@connectum/core | createServer(), server lifecycle, TLS, protocol plugin system |
@connectum/auth | JWT, gateway, session authentication; declarative RBAC; proto-based authorization |
@connectum/interceptors | createDefaultInterceptors() — error handling, retry, circuit breaker, timeout, bulkhead, fallback, validation, logger |
@connectum/healthcheck | Healthcheck() — gRPC Health Check protocol + HTTP /healthz, healthcheckManager |
@connectum/reflection | Reflection() — gRPC Server Reflection v1/v1alpha, collectFileProtos() |
@connectum/otel | initProvider() — OpenTelemetry tracing, metrics, logging; traced(), getTracer(), getMeter() |
@connectum/cli | Scaffold projects, add services, and sync proto types from a running server |
@connectum/events | createEventBus() — proto-first pub/sub with middleware (retry, DLQ), MemoryAdapter |
@connectum/events-nats | NATS JetStream adapter for EventBus |
@connectum/events-kafka | Apache Kafka / Redpanda adapter for EventBus |
@connectum/events-redis | Redis Streams / Valkey adapter for EventBus |
@connectum/events-amqp | AMQP / RabbitMQ adapter for EventBus |
@connectum/protoc-gen-catalog | Buf plugin generating the typed service catalog (ctx.call / ctx.stream) |
@connectum/testing | createTestServer(), mockResolver(), createMockContext() — testing utilities |
@connectum/test-fixtures | Transport-free mock requests, descriptors, streams, and assertion helpers |
Documentation
connectum.dev — Quickstart · Interceptors · Health Checks · Events · Observability · API Testing · ADR
Contributing
git clone https://github.com/Connectum-Framework/connectum.git && cd connectum
pnpm install && pnpm test
Contributing Guide · Development Setup · Code of Conduct
License
Apache License 2.0 · Built by Highload.Zone
