[DripTide CI check] #239 Add Zod validation pipe and DTO transformer for uniform request parsing

src/common/controllers/example-zod.controller.ts

@@ -0,0 +1,14 @@
+import { Controller, Post, Body } from '@nestjs/common';
+import { ZodValidationPipe } from '../pipes/zod-validation.pipe';
+import { ExampleZodSchema, ExampleZodDto } from '../dto/example-zod.dto';
+
+@Controller('example-zod')
+export class ExampleZodController {
+  @Post()
+  create(@Body(new ZodValidationPipe(ExampleZodSchema)) dto: ExampleZodDto) {
+    return {
+      success: true,
+      data: dto,
+    };
+  }
+}

src/common/decorators/zod-body.decorator.ts

@@ -0,0 +1,11 @@
+import { createParamDecorator, ExecutionContext } from '@nestjs/common';
+import { ZodTypeAny } from 'zod';
+import { ZodValidationPipe } from '../pipes/zod-validation.pipe';
+
+export function ZodBody(schema: ZodTypeAny) {
+  return createParamDecorator((_data: unknown, ctx: ExecutionContext) => {
+    const request = ctx.switchToHttp().getRequest();
+    const pipe = new ZodValidationPipe(schema);
+    return pipe.transform(request.body, { type: 'body' });
+  })();
+}

src/common/dto/example-zod.dto.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+
+export const ExampleZodSchema = z.object({
+  title: z.string().min(1, 'Title is required'),
+  description: z.string().optional(),
+  tags: z.array(z.string()).default([]),
+});
+
+export type ExampleZodDto = z.infer<typeof ExampleZodSchema>;

src/common/pipes/zod-validation.pipe.spec.ts

@@ -177,4 +177,4 @@ describe('ZodValidationPipe', () => {
       expect(details[0].message).toContain('Localized:');
     }
   });
-});
+});

src/common/pipes/zod-validation.pipe.ts

@@ -11,7 +11,7 @@ export interface ZodValidationPipeOptions {
 
 /**
  * A pipe that validates and parses an incoming payload against a Zod schema.
- * Instantiated per-schema, e.g. `@Body(new ZodValidationPipe(createAgentSchema))`.
+ * Instantiated per-schema, e.g. `@Body(new ZodValidationPipe(createAgentSchema)) کیا۔
  * Rejects unknown/invalid data with a structured VALIDATION_ERROR whose
  * `details` use the canonical {@link formatZodError} shape, supporting localized error message overrides.
  */