feat: Add Nestjs options to turn off request validations (#362)

* start add options to turn off request validation

* remove: option validateRequestParam & add tests

* docs(nestjs): add section about request validation

* add: turn off request validation params for @TsRest()

* fix: docs

* add changeset

* Update stale-games-draw.md

* Update nest.mdx

---------

Co-authored-by: Michael Angelo Rivera <55844504+michaelangeloio@users.noreply.github.com>

Author: qWici

.changeset/stale-games-draw.md

@@ -0,0 +1,6 @@
+---
+'@ts-rest/nest': minor
+---
+
+- feat: Add option to disable request validation
+  - This is useful when a user wants to perform validation or handle validation errors themselves 

apps/docs/docs/nest/nest.mdx

@@ -199,6 +199,69 @@ export class MyController {
 }
 ```
 
+### Request Validation
+By default, `ts-rest` validates all request components - body, headers and query parameters.
+In case of validation errors, the server responds with a `ZodError` object in the response body and a status code of 400.
+You can disable the validation of these components if you wish to perform the validation manually or handle the error differently.
+
+Using the `@TsRest()` decorator, you can configure request validation parameters for the entire controller:
+```typescript
+import { TsRest } from '@ts-rest/nest';
+
+@Controller()
+@TsRest({
+  validateRequestBody: false,
+  validateRequestQuery: false,
+  validateRequestHeaders: false
+})
+class MyController {}
+```
+
+You can also override controller decorator values for a specific route:
+
+```typescript
+import { TsRest } from '@ts-rest/nest';
+
+@Controller()
+@TsRest({
+  validateRequestBody: false,
+})
+class MyController {
+  @TsRest(contract.create, {
+    validateRequestBody: true
+  })
+  async create(@TsRestRequest() { body }) {
+    // body validated
+  }
+}
+```
+
+Or finally, using `@TsRestHandler()` for specific route:
+
+```typescript
+import { TsRestHandler, tsRestHandler } from '@ts-rest/nest';
+
+@Controller()
+export class MyController {
+  constructor() {}
+
+  @TsRestHandler(c.getPost, {
+    validateRequestBody: false,
+    validateRequestQuery: false,
+    validateRequestHeaders: false
+  })
+  async getPost() {
+    return tsRestHandler(c.getPost, async ({ query, body }) => {
+      const isQueryValid = querySchema.safeParse(query);
+      console.log(isQueryValid) // => { success: false; error: ZodError }
+
+      const isBodyValid = bodySchema.safeParse(body);
+      console.log(isBodyValid) // => { success: true; data: {...} }
+    });
+  }
+}
+```
+
 ### Response Validation
 
 You can enable response validation by passing the `validateResponses` option to the `@TsRest()` decorator.

libs/ts-rest/nest/src/lib/constants.ts

@@ -1,3 +1,12 @@
 export const TsRestAppRouteMetadataKey = Symbol('ts-rest-app-route');
 export const JsonQuerySymbol = Symbol('ts-rest-json-query');
 export const ValidateResponsesSymbol = Symbol('ts-rest-validate-responses');
+export const ValidateRequestHeadersSymbol = Symbol(
+  'ts-rest-validate-request-headers'
+);
+export const ValidateRequestQuerySymbol = Symbol(
+  'ts-rest-validate-request-query'
+);
+export const ValidateRequestBodySymbol = Symbol(
+  'ts-rest-validate-request-body'
+);