Skip to content
GuidesDocs 1.3.x

Protocol Extensions

The protocols array registers capabilities that share the server transport but are not application service routes. Connectum ships operational protocols for health and reflection; advanced consumers can implement the same registration contract for a custom gRPC service or HTTP fallback handler.

typescript
const server = createServer({
  services: [routes],
  protocols: [
    Healthcheck({ httpEnabled: true }),
    Reflection(),
  ],
});

Operational protocols

  • Health checks own readiness/liveness state and platform probes.
  • Server reflection owns schema discovery, tool usage, and the production exposure warning.

Advanced extension point

Creating a custom protocol owns ProtocolRegistration, ProtocolContext, HTTP handler behavior, registration timing, and examples. Add protocols before server.start(); this is an explicit server extension boundary, not general request middleware.

Exact core types remain in ProtocolRegistration and the generated core API. Package setup belongs to the @connectum/healthcheck and @connectum/reflection module hubs.