gateway-controller

What problem does it solve?

This Skill automates the creation of API Gateway features that connect HTTP REST endpoints to downstream gRPC microservices, removing boilerplate and ensuring consistent, production-ready integrations across the gateway.

Core Features & Use Cases

• Proto & Interface Generation: Creates proto3 interface files and service definitions following official proto3 conventions and pagination/common message patterns.
• NestJS Gateway Boilerplate: Generates controller, service, and module files wired with ClientsModule.registerAsync, grpc client injection, lastValueFrom calls, metadata enrichment, Swagger decorators, and permission guards.
• Integration & Compliance: Enforces best practices such as snake_case proto fields, optional nullable fields, ParseUUIDPipe for UUID params, and operationId uniqueness to avoid runtime integration issues.
• Use Case: When adding a new domain endpoint to the API gateway, use this Skill to produce the proto contracts and gateway layer scaffolding ready for codegen and registration in the gateway routing.

Quick Start

Scaffold a new tenant Invoice gateway feature that exposes REST endpoints and forwards requests to the tenant Invoice gRPC service.