nest-rest-test

Writes the REST API tests of a use case (UC-XXX) in a NestJS application with Vitest and Supertest: status codes, Location headers, the JSON contract, the error bodies, and — as the integration layer of a REST service or behind a client-side UI such as Next.js — every business rule's allowed and rejected request at the boundary, booting the whole application against a real PostgreSQL database in Testcontainers, nothing mocked. Checks the Vitest transformer that decorator metadata needs, and that the test application has the ValidationPipe and exception filter the real one has. Files are test/UC-XXX-<slug>.e2e-spec.ts with describe('UC-XXX: …'). Use when the user asks to "test the REST API", "test the controller", "test the endpoint", "write API tests", "write an e2e test", "check the status codes", or mentions Supertest, Testcontainers, or NestJS API tests. Normally run by /use-case-test as the integration layer; it can also be run directly. Browser tests are the E2E layer.