/nestjs-transport

name: nestjs-transport
description: Configure gRPC, RabbitMQ, and monorepo contract patterns for NestJS microservices. Use when setting up gRPC service-to-service calls, RabbitMQ event-driven messaging, shared contract libraries, or microservice exception handling in NestJS.
metadata:
  triggers:
    files:
    - 'main.ts'
    - '**/*.controller.ts'
    - 'Transport.GRPC'
    - 'Transport.RMQ'
    keywords:
    - MicroserviceOptions

Microservices & Transport Standards

**Priority: P0 (CRITICAL)**

• **Synchronous (RPC)**: Use **gRPC** for low-latency, internal service-to-service calls (10x faster than REST/JSON).
• **Asynchronous (Events)**: Use **RabbitMQ** or **Kafka** for decoupling domains via fire-and-forget (`emit()`).

gRPC Setup

See [implementation examples](references/example.md)

RabbitMQ Setup

See [implementation examples](references/example.md)

Monorepo Contracts

• Store all DTOs, `.proto` files, and Interfaces in `libs/contracts`.
• Services never import from sibling services — only from `contracts`.
• Semantic versioning of messages mandatory. Never change field type; add new field.

Exception Handling

Standard `HttpException` lost over RPC/TCP. Use `RpcException` with global filters:

See [implementation examples](references/example.md)

Serialization

• Apply `useGlobalPipes(new ValidationPipe({ transform: true }))` in `MicroserviceOptions` setup, not HTTP.

Anti-Patterns

• **No cross-service imports**: Services must import only from `libs/contracts`, never from sibling services.
• **No HttpException in RPC**: Use `RpcException` with global `RpcExceptionFilter` for microservice errors.
• **No unversioned message schema**: Add new fields; never change existing field types — consumers will break.