nest-trpc-native: Full NestJS Power + tRPC Type Safety with Zero Runtime Overhead

#nestjs #trpc #typescript #backend

Hey NestJS + tRPC community! 👋

I’m excited to release nest-trpc-native v0.3.0 — a decorator-first, native-feeling tRPC integration for NestJS.

No adapter glue code in your app layer. No compromise on NestJS features.

You write tRPC routers like Nest classes, with full support for dependency injection, guards, interceptors, pipes, filters, request-scoped providers, and end-to-end type safety.

Why this matters

Most tRPC + NestJS approaches push you toward one side:

Keep all NestJS lifecycle features, but lose clean tRPC developer experience, or
Keep pure tRPC style, but lose NestJS enhancers and request-scoped DI.

nest-trpc-native is designed so you can have both.

Core Features

@Router('users') + @Query(), @Mutation(), @Subscription()
Full support for @UseGuards(), @UseInterceptors(), @UsePipes(ValidationPipe), @UseFilters()
@Input() and @TrpcContext() for parameter extraction
Auto-generated router types (autoSchemaFile: 'src/@generated/server.ts')
Works with Express and Fastify
Zod or classic class-validator validation
Zero runtime dependencies in nest-trpc-native itself (host app controls Nest/tRPC peers)
Monorepo-friendly sample layout
Microservice transport pattern demonstrated in a focused sample

Router Example (NestJS style)

@Router('users')
@UseGuards(AuthGuard)
export class UsersRouter {
  constructor(private readonly usersService: UsersService) {}

  @Query({ input: FindOneSchema, output: UserSchema.nullable() })
  @UsePipes(new ValidationPipe({ transform: true }))
  findOne(
    @Input() input: { id: number },
    @TrpcContext('requestId') requestId: string,
  ) {
    return this.usersService.findById(input.id);
  }

  @Mutation({ input: CreateUserSchema, output: UserSchema })
  create(@Input() input: { name: string; email: string }) {
    return this.usersService.create(input);
  }
}

Client side stays fully type-safe:

const user = await trpc.users.findOne.query({ id: 123 });
// autocomplete + compile-time safety

Installation

npm install nest-trpc-native @trpc/server
npm install @nestjs/common @nestjs/core reflect-metadata rxjs
# optional:
npm install zod

Then register the module:

TrpcModule.forRoot({
  path: '/trpc',
  autoSchemaFile: 'src/@generated/server.ts',
})

Samples You Can Run Now

sample/00-showcase: full integration baseline (guards, interceptors, pipes, filters, request scope, Express/Fastify, typed clients, subscriptions)
sample/11-microservice-transport: tRPC edge gateway + Nest microservice transport (TCP)

From repo root: