@xemahq/service-registry-nest

NestJS SDK for service registration and typed discovery.

Overview

A NestJS module that registers the host service's descriptor with the service registry at boot, renews its lease on a heartbeat, and removes the entry on shutdown. The @InjectService(name) decorator hands consumers a typed HTTP client whose base URL is resolved from the registry on every call, so callers never hard-code another service's address. The SDK is adapter-agnostic: the backing registry is supplied through a factory, so the same code runs against a local development adapter or a clustered one.

When to use it

• Use it so a service self-registers at boot and discovers its peers by name rather than by configured URL.
• Reach for @InjectService when a service needs a typed client to call another service over HTTP.

Installation

pnpm add @xemahq/service-registry-nest

Usage

import { InjectService, TypedServiceClient } from '@xemahq/service-registry-nest';

@Injectable()
export class UsersGateway {
  constructor(
    @InjectService('identity-api') private readonly identity: TypedServiceClient,
  ) {}

  getUser(id: string) {
    return this.identity.get(`/users/${id}`);
  }
}

Peer requirements

• @nestjs/common, @nestjs/core — host framework.
• reflect-metadata — decorator metadata runtime.

License

Apache-2.0 © Xema — xema.dev