Connectum

---

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