@riktajs/core 0.1.0 → 0.2.0

package/README.md

@@ -9,6 +9,7 @@ A modern TypeScript backend framework with zero-config autowiring, powered by Fa
 - 🔌 **Single DI decorator** - `@Autowired()` for everything
 - 🔄 **Hybrid Lifecycle** - Interface hooks + EventBus
 - 🛡️ **Exception Handling** - Built-in filters with standardized JSON responses
+- ✅ **Zod Validation** - Native type-safe validation with automatic type inference
 - ⚡ **Fastify under the hood** - Maximum performance
 - 🔒 **Type-safe** - Full TypeScript support
 - 🪶 **Zero config** - Just decorate and run
@@ -43,7 +44,7 @@ export class AppController {
 }
 
 // No modules - just create and run!
-const app = await Rikta.create({ port: 3000 });
+const app = await Rikta.create({ port: 3000, autowired: [__dirname] });
 await app.listen();
 ```
 
@@ -75,7 +76,7 @@ const app = await Rikta.create({
   prefix: '/api/v1',    // Global prefix
   
   // Auto-discovery paths (default: ['./**'] - scans all files)
-  autowired: ['./src/controllers', './src/services'],
+  autowired: [path.resolve('./src/controllers'), path.resolve('./src/services')],
   
   // Optional: explicit controller list (skips auto-discovery)
   controllers: [UserController, AppController],
@@ -98,16 +99,11 @@ Rikta automatically scans and imports files to discover `@Controller` and `@Inje
 ```typescript
 // Scan specific directories
 await Rikta.create({ 
-  autowired: ['./src/controllers', './src/services'] 
-});
-
-// Scan with glob patterns
-await Rikta.create({ 
-  autowired: ['./src/**/*.controller.ts', './src/**/*.service.ts'] 
+  autowired: [path.resolve('./src/controllers')] 
 });
 
 // Default: scans current directory recursively
-await Rikta.create({ port: 3000 });
+await Rikta.create({ port: 3000, autowired: [path.resolve('.')] });
 ```
 
 ## 🔄 Lifecycle Hooks
@@ -185,6 +181,129 @@ class UserController {
 
 See [Exception Handling Documentation](./src/core/exceptions/README.md) for full details.
 
+## ✅ Zod Validation
+
+Rikta has **native Zod integration** for type-safe request validation. Define schemas once and get both runtime validation and TypeScript type inference automatically.
+
+### Basic Usage
+
+```typescript
+import { Controller, Post, Body, Query, z } from '@riktajs/core';
+
+// Define your schema
+const CreateUserSchema = z.object({
+  name: z.string().min(1, 'Name is required'),
+  email: z.string().email('Invalid email format'),
+  age: z.number().int().positive().optional(),
+});
+
+// Type is automatically inferred!
+type CreateUser = z.infer<typeof CreateUserSchema>;
+
+@Controller('/users')
+class UserController {
+  @Post()
+  create(@Body(CreateUserSchema) data: CreateUser) {
+    // data is fully typed as { name: string; email: string; age?: number }
+    // Validation happens automatically before this method is called
+    return { success: true, user: data };
+  }
+}
+```
+
+### Validation Error Response
+
+When validation fails, Rikta automatically returns a structured 400 response:
+
+```json
+{
+  "statusCode": 400,
+  "message": "Validation failed for body",
+  "error": "Validation Error",
+  "timestamp": "2024-01-15T10:30:00.000Z",
+  "path": "/users",
+  "details": {
+    "errors": [
+      { "path": ["email"], "message": "Invalid email format", "code": "invalid_string" },
+      { "path": ["name"], "message": "Name is required", "code": "too_small" }
+    ],
+    "errorCount": 2
+  }
+}
+```
+
+### All Decorators Support Zod
+
+```typescript
+import { z, Controller, Get, Post, Body, Query, Param, Headers } from '@riktajs/core';
+
+// Query validation with coercion
+const PaginationSchema = z.object({
+  page: z.coerce.number().int().positive().default(1),
+  limit: z.coerce.number().int().max(100).default(10),
+});
+
+// Route params validation
+const IdSchema = z.object({
+  id: z.string().uuid('Invalid UUID format'),
+});
+
+// Headers validation
+const AuthSchema = z.object({
+  authorization: z.string().startsWith('Bearer '),
+});
+
+@Controller('/items')
+class ItemController {
+  @Get()
+  list(@Query(PaginationSchema) query: z.infer<typeof PaginationSchema>) {
+    // query.page and query.limit are numbers (coerced from string)
+    return { page: query.page, limit: query.limit };
+  }
+
+  @Get('/:id')
+  findOne(
+    @Param(IdSchema) params: z.infer<typeof IdSchema>,
+    @Headers(AuthSchema) headers: z.infer<typeof AuthSchema>
+  ) {
+    return { id: params.id };
+  }
+}
+```
+
+### Zod Transformations
+
+Zod's transform feature works seamlessly:
+
+```typescript
+const DateSchema = z.object({
+  date: z.string().transform(val => new Date(val)),
+  tags: z.string().transform(val => val.split(',')),
+});
+
+@Post('/events')
+create(@Body(DateSchema) data: z.infer<typeof DateSchema>) {
+  // data.date is a Date object
+  // data.tags is string[]
+}
+```
+
+### Backward Compatibility
+
+Existing code without Zod schemas continues to work:
+
+```typescript
+// These still work as before
+@Get('/:id')
+findOne(@Param('id') id: string) { ... }
+
+@Post()
+create(@Body() data: unknown) { ... }
+
+@Get()
+list(@Query('page') page: string) { ... }
+```
+
 ## 📁 Project Structure
 
 ```

package/dist/core/constants.d.ts

@@ -38,6 +38,10 @@ export declare const HEADERS_METADATA: unique symbol;
  * Key for storing @Inject() metadata on constructor parameters
  */
 export declare const INJECT_METADATA: unique symbol;
+/**
+ * Key for storing Zod validation schema on parameters
+ */
+export declare const ZOD_SCHEMA_METADATA: unique symbol;
 /**
  * Key for storing @Autowired() property injection metadata
  */

package/dist/core/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAE7D;;GAEG;AACH,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAE7D;;GAEG;AACH,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC"}

package/dist/core/constants.js

@@ -3,7 +3,7 @@
 // Metadata Keys for Reflect API
 // ============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_CONFIG = exports.ParamType = exports.PROVIDER_METADATA = exports.AUTOWIRED_METADATA = exports.INJECT_METADATA = exports.HEADERS_METADATA = exports.HTTP_CODE_METADATA = exports.MIDDLEWARE_METADATA = exports.INTERCEPTORS_METADATA = exports.GUARDS_METADATA = exports.PARAM_METADATA = exports.INJECTABLE_METADATA = exports.ROUTES_METADATA = exports.CONTROLLER_METADATA = void 0;
+exports.DEFAULT_CONFIG = exports.ParamType = exports.PROVIDER_METADATA = exports.AUTOWIRED_METADATA = exports.ZOD_SCHEMA_METADATA = exports.INJECT_METADATA = exports.HEADERS_METADATA = exports.HTTP_CODE_METADATA = exports.MIDDLEWARE_METADATA = exports.INTERCEPTORS_METADATA = exports.GUARDS_METADATA = exports.PARAM_METADATA = exports.INJECTABLE_METADATA = exports.ROUTES_METADATA = exports.CONTROLLER_METADATA = void 0;
 /**
  * Key for storing controller metadata (prefix, routes)
  */
@@ -44,6 +44,10 @@ exports.HEADERS_METADATA = Symbol('headers:metadata');
  * Key for storing @Inject() metadata on constructor parameters
  */
 exports.INJECT_METADATA = Symbol('inject:metadata');
+/**
+ * Key for storing Zod validation schema on parameters
+ */
+exports.ZOD_SCHEMA_METADATA = Symbol('zod:schema:metadata');
 /**
  * Key for storing @Autowired() property injection metadata
  */

package/dist/core/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;;;AAE/E;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEvD;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;GAEG;AACU,QAAA,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAErE;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAE3D;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;GAEG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE7D;;GAEG;AACH,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,0BAAa,CAAA;IACb,4BAAe,CAAA;IACf,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,4BAAe,CAAA;IACf,gCAAmB,CAAA;AACrB,CAAC,EARW,SAAS,yBAAT,SAAS,QAQpB;AAED;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,EAAE;CACF,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;;;AAE/E;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEvD;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;GAEG;AACU,QAAA,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAErE;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAE3D;;GAEG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;GAEG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE7D;;GAEG;AACH,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,0BAAa,CAAA;IACb,4BAAe,CAAA;IACf,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,4BAAe,CAAA;IACf,gCAAmB,CAAA;AACrB,CAAC,EARW,SAAS,yBAAT,SAAS,QAQpB;AAED;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,EAAE;CACF,CAAC"}

package/dist/core/decorators/controller.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/controller.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAK1B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,cAAc,CAuBvF"}
+{"version":3,"file":"controller.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/controller.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAK1B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,cAAc,CAwBvF"}

package/dist/core/decorators/controller.decorator.js

@@ -42,6 +42,7 @@ function Controller(prefixOrOptions) {
         // Mark as injectable
         Reflect.defineMetadata(constants_1.INJECTABLE_METADATA, { scope: 'singleton' }, target);
         // Register in DI container
+        console.log(`� Controller registered: ${target.name} (prefix: '${normalizedPrefix}')`);
         container_1.container.register(target, { scope: 'singleton' });
         // Auto-register in global registry for discovery
         registry_1.registry.registerController(target);

package/dist/core/decorators/controller.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"controller.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/controller.decorator.ts"],"names":[],"mappings":";;AAoCA,gCAuBC;AA3DD,4BAA0B;AAC1B,4CAAwE;AACxE,sDAAmD;AACnD,0CAAuC;AAUvC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,UAAU,CAAC,eAA4C;IACrE,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,OAAO,eAAe,KAAK,QAAQ;YAChD,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,eAAe,EAAE,MAAM,IAAI,EAAE,CAAC;QAElC,0DAA0D;QAC1D,MAAM,gBAAgB,GAAG,MAAM;YAC7B,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;QAEP,4BAA4B;QAC5B,OAAO,CAAC,cAAc,CAAC,+BAAmB,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;QAElF,qBAAqB;QACrB,OAAO,CAAC,cAAc,CAAC,+BAAmB,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;QAE5E,2BAA2B;QAC3B,qBAAS,CAAC,QAAQ,CAAC,MAA6C,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;QAE1F,iDAAiD;QACjD,mBAAQ,CAAC,kBAAkB,CAAC,MAA6C,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"controller.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/controller.decorator.ts"],"names":[],"mappings":";;AAoCA,gCAwBC;AA5DD,4BAA0B;AAC1B,4CAAwE;AACxE,sDAAmD;AACnD,0CAAuC;AAUvC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,UAAU,CAAC,eAA4C;IACrE,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,OAAO,eAAe,KAAK,QAAQ;YAChD,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,eAAe,EAAE,MAAM,IAAI,EAAE,CAAC;QAElC,0DAA0D;QAC1D,MAAM,gBAAgB,GAAG,MAAM;YAC7B,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;QAEP,4BAA4B;QAC5B,OAAO,CAAC,cAAc,CAAC,+BAAmB,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;QAElF,qBAAqB;QACrB,OAAO,CAAC,cAAc,CAAC,+BAAmB,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;QAE5E,2BAA2B;QAC3B,OAAO,CAAC,GAAG,CAAC,4BAA4B,MAAM,CAAC,IAAI,cAAc,gBAAgB,IAAI,CAAC,CAAC;QACvF,qBAAS,CAAC,QAAQ,CAAC,MAA6C,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;QAE1F,iDAAiD;QACjD,mBAAQ,CAAC,kBAAkB,CAAC,MAA6C,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/decorators/param.decorator.d.ts

@@ -1,4 +1,5 @@
 import 'reflect-metadata';
+import type { ZodType } from 'zod';
 import { ParamType } from '../constants';
 /**
  * Parameter metadata structure
@@ -7,66 +8,165 @@ export interface ParamMetadata {
     index: number;
     type: ParamType;
     key?: string;
+    /** Optional Zod schema for validation and type inference */
+    zodSchema?: ZodType<unknown>;
 }
 /**
  * @Body() decorator - Injects the request body
  *
+ * Supports three modes:
+ * 1. `@Body()` - Inject the entire request body
+ * 2. `@Body('propertyName')` - Inject a specific property from the body
+ * 3. `@Body(zodSchema)` - Validate and inject with type inference
+ *
  * @example
  * ```typescript
+ * // Inject entire body (untyped)
  * @Post('/users')
- * createUser(@Body({ schema: CreateUserDto }) data) { return data; }
+ * createUser(@Body() data: unknown) { return data; }
  *
+ * // Inject specific property
  * @Post('/users')
  * createUser(@Body('name') name: string) { return { name }; }
+ *
+ * // Validate with Zod schema (type-safe!)
+ * const CreateUserSchema = z.object({ name: z.string(), email: z.string().email() });
+ * @Post('/users')
+ * createUser(@Body(CreateUserSchema) data: z.infer<typeof CreateUserSchema>) {
+ *   // data is fully typed as { name: string; email: string }
+ *   return data;
+ * }
  * ```
  */
-export declare const Body: (key?: string) => ParameterDecorator;
+export declare const Body: {
+    (): ParameterDecorator;
+    (key: string): ParameterDecorator;
+    <T>(schema: ZodType<T>): ParameterDecorator;
+};
 /**
  * @Query() decorator - Injects query parameters
  *
+ * Supports three modes:
+ * 1. `@Query()` - Inject all query parameters
+ * 2. `@Query('paramName')` - Inject a specific query parameter
+ * 3. `@Query(zodSchema)` - Validate and inject with type inference
+ *
  * @example
  * ```typescript
+ * // Inject specific query param
  * @Get('/users')
  * getUsers(@Query('page') page: string) { return { page }; }
  *
+ * // Inject all query params
  * @Get('/users')
  * getUsers(@Query() query: Record<string, unknown>) { return query; }
+ *
+ * // Validate with Zod schema
+ * const PaginationSchema = z.object({ page: z.coerce.number(), limit: z.coerce.number() });
+ * @Get('/users')
+ * getUsers(@Query(PaginationSchema) query: z.infer<typeof PaginationSchema>) {
+ *   // query is { page: number; limit: number }
+ *   return query;
+ * }
  * ```
  */
-export declare const Query: (key?: string) => ParameterDecorator;
+export declare const Query: {
+    (): ParameterDecorator;
+    (key: string): ParameterDecorator;
+    <T>(schema: ZodType<T>): ParameterDecorator;
+};
 /**
  * @Param() decorator - Injects route parameters
  *
+ * Supports three modes:
+ * 1. `@Param()` - Inject all route parameters
+ * 2. `@Param('paramName')` - Inject a specific route parameter
+ * 3. `@Param(zodSchema)` - Validate and inject with type inference
+ *
  * @example
  * ```typescript
+ * // Inject specific param
  * @Get('/users/:id')
  * getUser(@Param('id') id: string) { return { id }; }
+ *
+ * // Validate with Zod schema
+ * const IdSchema = z.object({ id: z.string().uuid() });
+ * @Get('/users/:id')
+ * getUser(@Param(IdSchema) params: z.infer<typeof IdSchema>) {
+ *   // params.id is validated as UUID
+ *   return params;
+ * }
  * ```
  */
-export declare const Param: (key?: string) => ParameterDecorator;
+export declare const Param: {
+    (): ParameterDecorator;
+    (key: string): ParameterDecorator;
+    <T>(schema: ZodType<T>): ParameterDecorator;
+};
 /**
  * @Headers() decorator - Injects request headers
  *
+ * Supports three modes:
+ * 1. `@Headers()` - Inject all headers
+ * 2. `@Headers('headerName')` - Inject a specific header
+ * 3. `@Headers(zodSchema)` - Validate and inject with type inference
+ *
  * @example
  * ```typescript
+ * // Inject specific header
  * @Get('/protected')
  * getData(@Headers('authorization') auth: string) { return { auth }; }
+ *
+ * // Validate with Zod schema
+ * const AuthHeadersSchema = z.object({ authorization: z.string().startsWith('Bearer ') });
+ * @Get('/protected')
+ * getData(@Headers(AuthHeadersSchema) headers: z.infer<typeof AuthHeadersSchema>) {
+ *   return headers;
+ * }
  * ```
  */
-export declare const Headers: (key?: string) => ParameterDecorator;
+export declare const Headers: {
+    (): ParameterDecorator;
+    (key: string): ParameterDecorator;
+    <T>(schema: ZodType<T>): ParameterDecorator;
+};
 /**
  * @Req() decorator - Injects the raw Fastify request object
  */
-export declare const Req: (key?: string) => ParameterDecorator;
-export declare const Request: (key?: string) => ParameterDecorator;
+export declare const Req: {
+    (): ParameterDecorator;
+    (key: string): ParameterDecorator;
+    <T>(schema: ZodType<T>): ParameterDecorator;
+};
+export declare const Request: {
+    (): ParameterDecorator;
+    (key: string): ParameterDecorator;
+    <T>(schema: ZodType<T>): ParameterDecorator;
+};
 /**
  * @Res() decorator - Injects the raw Fastify reply object
  */
-export declare const Res: (key?: string) => ParameterDecorator;
-export declare const Reply: (key?: string) => ParameterDecorator;
+export declare const Res: {
+    (): ParameterDecorator;
+    (key: string): ParameterDecorator;
+    <T>(schema: ZodType<T>): ParameterDecorator;
+};
+export declare const Reply: {
+    (): ParameterDecorator;
+    (key: string): ParameterDecorator;
+    <T>(schema: ZodType<T>): ParameterDecorator;
+};
 /**
  * @Ctx() decorator - Injects the full route context
  */
-export declare const Ctx: (key?: string) => ParameterDecorator;
-export declare const Context: (key?: string) => ParameterDecorator;
+export declare const Ctx: {
+    (): ParameterDecorator;
+    (key: string): ParameterDecorator;
+    <T>(schema: ZodType<T>): ParameterDecorator;
+};
+export declare const Context: {
+    (): ParameterDecorator;
+    (key: string): ParameterDecorator;
+    <T>(schema: ZodType<T>): ParameterDecorator;
+};
 //# sourceMappingURL=param.decorator.d.ts.map

package/dist/core/decorators/param.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"param.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/param.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAkB,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA2BD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,IAAI,SAjCD,MAAM,KAAG,kBAiC+B,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,SA/CF,MAAM,KAAG,kBA+CiC,CAAC;AAE3D;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,SA1DF,MAAM,KAAG,kBA0DiC,CAAC;AAE3D;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,SArEJ,MAAM,KAAG,kBAqEqC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,GAAG,SA1EA,MAAM,KAAG,kBA0EiC,CAAC;AAC3D,eAAO,MAAM,OAAO,SA3EJ,MAAM,KAAG,kBA2EC,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,GAAG,SAhFA,MAAM,KAAG,kBAgF+B,CAAC;AACzD,eAAO,MAAM,KAAK,SAjFF,MAAM,KAAG,kBAiFD,CAAC;AAEzB;;GAEG;AACH,eAAO,MAAM,GAAG,SAtFA,MAAM,KAAG,kBAsFiC,CAAC;AAC3D,eAAO,MAAM,OAAO,SAvFJ,MAAM,KAAG,kBAuFC,CAAC"}
+{"version":3,"file":"param.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/param.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,EAAkB,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B;AA2DD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,IAAI;QA5DO,kBAAkB;UAChB,MAAM,GAAG,kBAAkB;KAChC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,kBAAkB;CA0DP,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,KAAK;QAzFM,kBAAkB;UAChB,MAAM,GAAG,kBAAkB;KAChC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,kBAAkB;CAuFL,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,KAAK;QAlHM,kBAAkB;UAChB,MAAM,GAAG,kBAAkB;KAChC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,kBAAkB;CAgHL,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,OAAO;QA1II,kBAAkB;UAChB,MAAM,GAAG,kBAAkB;KAChC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,kBAAkB;CAwID,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,GAAG;QA/IQ,kBAAkB;UAChB,MAAM,GAAG,kBAAkB;KAChC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,kBAAkB;CA6IL,CAAC;AAC3D,eAAO,MAAM,OAAO;QAhJI,kBAAkB;UAChB,MAAM,GAAG,kBAAkB;KAChC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,kBAAkB;CA8IrC,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,GAAG;QArJQ,kBAAkB;UAChB,MAAM,GAAG,kBAAkB;KAChC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,kBAAkB;CAmJP,CAAC;AACzD,eAAO,MAAM,KAAK;QAtJM,kBAAkB;UAChB,MAAM,GAAG,kBAAkB;KAChC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,kBAAkB;CAoJvC,CAAC;AAEzB;;GAEG;AACH,eAAO,MAAM,GAAG;QA3JQ,kBAAkB;UAChB,MAAM,GAAG,kBAAkB;KAChC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,kBAAkB;CAyJL,CAAC;AAC3D,eAAO,MAAM,OAAO;QA5JI,kBAAkB;UAChB,MAAM,GAAG,kBAAkB;KAChC,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,GAAG,kBAAkB;CA0JrC,CAAC"}

package/dist/core/decorators/param.decorator.js

@@ -4,69 +4,148 @@ exports.Context = exports.Ctx = exports.Reply = exports.Res = exports.Request =
 require("reflect-metadata");
 const constants_1 = require("../constants");
 /**
- * Creates a parameter decorator
+ * Type guard to check if a value is a Zod schema
+ * Uses duck typing to detect Zod schemas without importing the full library
+ */
+function isZodType(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        '_def' in value &&
+        'safeParse' in value &&
+        typeof value.safeParse === 'function');
+}
+/**
+ * Creates a type-safe parameter decorator factory with Zod schema support
+ *
+ * Supports three overloads:
+ * 1. @Decorator() - Inject the full value
+ * 2. @Decorator('key') - Inject a specific property by key
+ * 3. @Decorator(zodSchema) - Inject with validation and type inference
  */
 function createParamDecorator(type) {
-    return (key) => {
+    function decorator(keyOrSchema) {
         return (target, propertyKey, parameterIndex) => {
             if (propertyKey === undefined)
                 return;
             // Get existing params or initialize empty array
             const existingParams = Reflect.getMetadata(constants_1.PARAM_METADATA, target.constructor, propertyKey) ?? [];
-            // Add this param
-            existingParams.push({
+            // Determine if we have a key string or a Zod schema
+            const isSchema = isZodType(keyOrSchema);
+            // Build metadata object
+            const metadata = {
                 index: parameterIndex,
                 type,
-                key,
-            });
+                key: isSchema ? undefined : keyOrSchema,
+                zodSchema: isSchema ? keyOrSchema : undefined,
+            };
+            // Add this param
+            existingParams.push(metadata);
             // Store updated params
             Reflect.defineMetadata(constants_1.PARAM_METADATA, existingParams, target.constructor, propertyKey);
         };
-    };
+    }
+    return decorator;
 }
 /**
  * @Body() decorator - Injects the request body
  *
+ * Supports three modes:
+ * 1. `@Body()` - Inject the entire request body
+ * 2. `@Body('propertyName')` - Inject a specific property from the body
+ * 3. `@Body(zodSchema)` - Validate and inject with type inference
+ *
  * @example
  * ```typescript
+ * // Inject entire body (untyped)
  * @Post('/users')
- * createUser(@Body({ schema: CreateUserDto }) data) { return data; }
+ * createUser(@Body() data: unknown) { return data; }
  *
+ * // Inject specific property
  * @Post('/users')
  * createUser(@Body('name') name: string) { return { name }; }
+ *
+ * // Validate with Zod schema (type-safe!)
+ * const CreateUserSchema = z.object({ name: z.string(), email: z.string().email() });
+ * @Post('/users')
+ * createUser(@Body(CreateUserSchema) data: z.infer<typeof CreateUserSchema>) {
+ *   // data is fully typed as { name: string; email: string }
+ *   return data;
+ * }
  * ```
  */
 exports.Body = createParamDecorator(constants_1.ParamType.BODY);
 /**
  * @Query() decorator - Injects query parameters
  *
+ * Supports three modes:
+ * 1. `@Query()` - Inject all query parameters
+ * 2. `@Query('paramName')` - Inject a specific query parameter
+ * 3. `@Query(zodSchema)` - Validate and inject with type inference
+ *
  * @example
  * ```typescript
+ * // Inject specific query param
  * @Get('/users')
  * getUsers(@Query('page') page: string) { return { page }; }
  *
+ * // Inject all query params
  * @Get('/users')
  * getUsers(@Query() query: Record<string, unknown>) { return query; }
+ *
+ * // Validate with Zod schema
+ * const PaginationSchema = z.object({ page: z.coerce.number(), limit: z.coerce.number() });
+ * @Get('/users')
+ * getUsers(@Query(PaginationSchema) query: z.infer<typeof PaginationSchema>) {
+ *   // query is { page: number; limit: number }
+ *   return query;
+ * }
  * ```
  */
 exports.Query = createParamDecorator(constants_1.ParamType.QUERY);
 /**
  * @Param() decorator - Injects route parameters
  *
+ * Supports three modes:
+ * 1. `@Param()` - Inject all route parameters
+ * 2. `@Param('paramName')` - Inject a specific route parameter
+ * 3. `@Param(zodSchema)` - Validate and inject with type inference
+ *
  * @example
  * ```typescript
+ * // Inject specific param
  * @Get('/users/:id')
  * getUser(@Param('id') id: string) { return { id }; }
+ *
+ * // Validate with Zod schema
+ * const IdSchema = z.object({ id: z.string().uuid() });
+ * @Get('/users/:id')
+ * getUser(@Param(IdSchema) params: z.infer<typeof IdSchema>) {
+ *   // params.id is validated as UUID
+ *   return params;
+ * }
  * ```
  */
 exports.Param = createParamDecorator(constants_1.ParamType.PARAM);
 /**
  * @Headers() decorator - Injects request headers
  *
+ * Supports three modes:
+ * 1. `@Headers()` - Inject all headers
+ * 2. `@Headers('headerName')` - Inject a specific header
+ * 3. `@Headers(zodSchema)` - Validate and inject with type inference
+ *
  * @example
  * ```typescript
+ * // Inject specific header
  * @Get('/protected')
  * getData(@Headers('authorization') auth: string) { return { auth }; }
+ *
+ * // Validate with Zod schema
+ * const AuthHeadersSchema = z.object({ authorization: z.string().startsWith('Bearer ') });
+ * @Get('/protected')
+ * getData(@Headers(AuthHeadersSchema) headers: z.infer<typeof AuthHeadersSchema>) {
+ *   return headers;
+ * }
  * ```
  */
 exports.Headers = createParamDecorator(constants_1.ParamType.HEADERS);

package/dist/core/decorators/param.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"param.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/param.decorator.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAC1B,4CAAyD;AAWzD;;GAEG;AACH,SAAS,oBAAoB,CAAC,IAAe;IAC3C,OAAO,CAAC,GAAY,EAAsB,EAAE;QAC1C,OAAO,CAAC,MAAc,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;YAC1F,IAAI,WAAW,KAAK,SAAS;gBAAE,OAAO;YAEtC,gDAAgD;YAChD,MAAM,cAAc,GAClB,OAAO,CAAC,WAAW,CAAC,0BAAc,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;YAE7E,iBAAiB;YACjB,cAAc,CAAC,IAAI,CAAC;gBAClB,KAAK,EAAE,cAAc;gBACrB,IAAI;gBACJ,GAAG;aACJ,CAAC,CAAC;YAEH,uBAAuB;YACvB,OAAO,CAAC,cAAc,CAAC,0BAAc,EAAE,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC1F,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACU,QAAA,IAAI,GAAG,oBAAoB,CAAC,qBAAS,CAAC,IAAI,CAAC,CAAC;AAEzD;;;;;;;;;;;GAWG;AACU,QAAA,KAAK,GAAG,oBAAoB,CAAC,qBAAS,CAAC,KAAK,CAAC,CAAC;AAE3D;;;;;;;;GAQG;AACU,QAAA,KAAK,GAAG,oBAAoB,CAAC,qBAAS,CAAC,KAAK,CAAC,CAAC;AAE3D;;;;;;;;GAQG;AACU,QAAA,OAAO,GAAG,oBAAoB,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC;AAC9C,QAAA,OAAO,GAAG,WAAG,CAAC;AAE3B;;GAEG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,qBAAS,CAAC,KAAK,CAAC,CAAC;AAC5C,QAAA,KAAK,GAAG,WAAG,CAAC;AAEzB;;GAEG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC;AAC9C,QAAA,OAAO,GAAG,WAAG,CAAC"}
+{"version":3,"file":"param.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/param.decorator.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAE1B,4CAAyD;AAazD;;;GAGG;AACH,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,IAAI,KAAK;QACf,WAAW,IAAI,KAAK;QACpB,OAAQ,KAAgC,CAAC,SAAS,KAAK,UAAU,CAClE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAAC,IAAe;IAK3C,SAAS,SAAS,CAAI,WAAiC;QACrD,OAAO,CAAC,MAAc,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;YAC1F,IAAI,WAAW,KAAK,SAAS;gBAAE,OAAO;YAEtC,gDAAgD;YAChD,MAAM,cAAc,GAClB,OAAO,CAAC,WAAW,CAAC,0BAAc,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;YAE7E,oDAAoD;YACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;YAExC,wBAAwB;YACxB,MAAM,QAAQ,GAAkB;gBAC9B,KAAK,EAAE,cAAc;gBACrB,IAAI;gBACJ,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;gBACvC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;aAC9C,CAAC;YAEF,iBAAiB;YACjB,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAE9B,uBAAuB;YACvB,OAAO,CAAC,cAAc,CAAC,0BAAc,EAAE,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC1F,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACU,QAAA,IAAI,GAAG,oBAAoB,CAAC,qBAAS,CAAC,IAAI,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACU,QAAA,KAAK,GAAG,oBAAoB,CAAC,qBAAS,CAAC,KAAK,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACU,QAAA,KAAK,GAAG,oBAAoB,CAAC,qBAAS,CAAC,KAAK,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACU,QAAA,OAAO,GAAG,oBAAoB,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC;AAC9C,QAAA,OAAO,GAAG,WAAG,CAAC;AAE3B;;GAEG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,qBAAS,CAAC,KAAK,CAAC,CAAC;AAC5C,QAAA,KAAK,GAAG,WAAG,CAAC;AAEzB;;GAEG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,qBAAS,CAAC,OAAO,CAAC,CAAC;AAC9C,QAAA,OAAO,GAAG,WAAG,CAAC"}

package/dist/core/exceptions/index.d.ts

@@ -1,4 +1,5 @@
 export { HttpException, HttpExceptionBody, HttpExceptionResponse } from './http-exception';
+export { ValidationException, ValidationErrorDetails } from './validation.exception';
 export { BadRequestException, UnauthorizedException, ForbiddenException, NotFoundException, MethodNotAllowedException, NotAcceptableException, RequestTimeoutException, ConflictException, GoneException, PayloadTooLargeException, UnsupportedMediaTypeException, UnprocessableEntityException, TooManyRequestsException, InternalServerErrorException, NotImplementedException, BadGatewayException, ServiceUnavailableException, GatewayTimeoutException, } from './exceptions';
 export { ExceptionFilter, ExceptionContext, ErrorResponse, GlobalExceptionFilter, GlobalExceptionFilterOptions, createExceptionHandler, } from './exception-filter';
 export { Catch, CatchMetadata, CATCH_METADATA, getCatchMetadata } from './catch.decorator';

package/dist/core/exceptions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG3F,OAAO,EAEL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EAExB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG3F,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGrF,OAAO,EAEL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EAExB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/exceptions/index.js

@@ -1,9 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCatchMetadata = exports.CATCH_METADATA = exports.Catch = exports.createExceptionHandler = exports.GlobalExceptionFilter = exports.GatewayTimeoutException = exports.ServiceUnavailableException = exports.BadGatewayException = exports.NotImplementedException = exports.InternalServerErrorException = exports.TooManyRequestsException = exports.UnprocessableEntityException = exports.UnsupportedMediaTypeException = exports.PayloadTooLargeException = exports.GoneException = exports.ConflictException = exports.RequestTimeoutException = exports.NotAcceptableException = exports.MethodNotAllowedException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.HttpException = void 0;
+exports.getCatchMetadata = exports.CATCH_METADATA = exports.Catch = exports.createExceptionHandler = exports.GlobalExceptionFilter = exports.GatewayTimeoutException = exports.ServiceUnavailableException = exports.BadGatewayException = exports.NotImplementedException = exports.InternalServerErrorException = exports.TooManyRequestsException = exports.UnprocessableEntityException = exports.UnsupportedMediaTypeException = exports.PayloadTooLargeException = exports.GoneException = exports.ConflictException = exports.RequestTimeoutException = exports.NotAcceptableException = exports.MethodNotAllowedException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.ValidationException = exports.HttpException = void 0;
 // HTTP Exception
 var http_exception_1 = require("./http-exception");
 Object.defineProperty(exports, "HttpException", { enumerable: true, get: function () { return http_exception_1.HttpException; } });
+// Validation Exception (Zod)
+var validation_exception_1 = require("./validation.exception");
+Object.defineProperty(exports, "ValidationException", { enumerable: true, get: function () { return validation_exception_1.ValidationException; } });
 // Specific Exceptions
 var exceptions_1 = require("./exceptions");
 // 4xx Client Errors

package/dist/core/exceptions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/exceptions/index.ts"],"names":[],"mappings":";;;AAAA,iBAAiB;AACjB,mDAA2F;AAAlF,+GAAA,aAAa,OAAA;AAEtB,sBAAsB;AACtB,2CAqBsB;AApBpB,oBAAoB;AACpB,iHAAA,mBAAmB,OAAA;AACnB,mHAAA,qBAAqB,OAAA;AACrB,gHAAA,kBAAkB,OAAA;AAClB,+GAAA,iBAAiB,OAAA;AACjB,uHAAA,yBAAyB,OAAA;AACzB,oHAAA,sBAAsB,OAAA;AACtB,qHAAA,uBAAuB,OAAA;AACvB,+GAAA,iBAAiB,OAAA;AACjB,2GAAA,aAAa,OAAA;AACb,sHAAA,wBAAwB,OAAA;AACxB,2HAAA,6BAA6B,OAAA;AAC7B,0HAAA,4BAA4B,OAAA;AAC5B,sHAAA,wBAAwB,OAAA;AACxB,oBAAoB;AACpB,0HAAA,4BAA4B,OAAA;AAC5B,qHAAA,uBAAuB,OAAA;AACvB,iHAAA,mBAAmB,OAAA;AACnB,yHAAA,2BAA2B,OAAA;AAC3B,qHAAA,uBAAuB,OAAA;AAGzB,mBAAmB;AACnB,uDAO4B;AAH1B,yHAAA,qBAAqB,OAAA;AAErB,0HAAA,sBAAsB,OAAA;AAGxB,kBAAkB;AAClB,qDAA2F;AAAlF,wGAAA,KAAK,OAAA;AAAiB,iHAAA,cAAc,OAAA;AAAE,mHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/exceptions/index.ts"],"names":[],"mappings":";;;AAAA,iBAAiB;AACjB,mDAA2F;AAAlF,+GAAA,aAAa,OAAA;AAEtB,6BAA6B;AAC7B,+DAAqF;AAA5E,2HAAA,mBAAmB,OAAA;AAE5B,sBAAsB;AACtB,2CAqBsB;AApBpB,oBAAoB;AACpB,iHAAA,mBAAmB,OAAA;AACnB,mHAAA,qBAAqB,OAAA;AACrB,gHAAA,kBAAkB,OAAA;AAClB,+GAAA,iBAAiB,OAAA;AACjB,uHAAA,yBAAyB,OAAA;AACzB,oHAAA,sBAAsB,OAAA;AACtB,qHAAA,uBAAuB,OAAA;AACvB,+GAAA,iBAAiB,OAAA;AACjB,2GAAA,aAAa,OAAA;AACb,sHAAA,wBAAwB,OAAA;AACxB,2HAAA,6BAA6B,OAAA;AAC7B,0HAAA,4BAA4B,OAAA;AAC5B,sHAAA,wBAAwB,OAAA;AACxB,oBAAoB;AACpB,0HAAA,4BAA4B,OAAA;AAC5B,qHAAA,uBAAuB,OAAA;AACvB,iHAAA,mBAAmB,OAAA;AACnB,yHAAA,2BAA2B,OAAA;AAC3B,qHAAA,uBAAuB,OAAA;AAGzB,mBAAmB;AACnB,uDAO4B;AAH1B,yHAAA,qBAAqB,OAAA;AAErB,0HAAA,sBAAsB,OAAA;AAGxB,kBAAkB;AAClB,qDAA2F;AAAlF,wGAAA,KAAK,OAAA;AAAiB,iHAAA,cAAc,OAAA;AAAE,mHAAA,gBAAgB,OAAA"}

package/dist/core/exceptions/validation.exception.d.ts

@@ -0,0 +1,60 @@
+import type { ZodError } from 'zod';
+import { HttpException } from './http-exception';
+/**
+ * Structured validation error details
+ */
+export interface ValidationErrorDetails {
+    /** The field path where the error occurred */
+    path: (string | number)[];
+    /** Human-readable error message */
+    message: string;
+    /** Zod error code */
+    code: string;
+    /** Expected type/value (if applicable) */
+    expected?: string;
+    /** Received type/value (if applicable) */
+    received?: string;
+}
+/**
+ * Validation Exception
+ *
+ * Thrown when request validation fails using Zod schemas.
+ * Provides detailed error information for each validation issue.
+ *
+ * @example
+ * ```typescript
+ * // The framework throws this automatically when @Body(schema) validation fails
+ * // But you can also throw it manually:
+ *
+ * const result = MySchema.safeParse(data);
+ * if (!result.success) {
+ *   throw new ValidationException(result.error);
+ * }
+ * ```
+ */
+export declare class ValidationException extends HttpException {
+    /**
+     * The original Zod error object
+     */
+    readonly zodError: ZodError;
+    /**
+     * Structured validation error details
+     */
+    readonly errors: ValidationErrorDetails[];
+    constructor(zodError: ZodError, message?: string);
+    /**
+     * Get formatted errors for client response
+     */
+    getValidationErrors(): ValidationErrorDetails[];
+    /**
+     * Get the flattened Zod error format
+     */
+    getFlattenedErrors(): import("zod").typeToFlattenedError<any, string>;
+    /**
+     * Get the formatted Zod error
+     */
+    getFormattedErrors(): {
+        _errors: string[];
+    };
+}
+//# sourceMappingURL=validation.exception.d.ts.map

package/dist/core/exceptions/validation.exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.exception.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/validation.exception.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,KAAK,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC;gBAE9B,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,MAA4B;IA0BrE;;OAEG;IACH,mBAAmB,IAAI,sBAAsB,EAAE;IAI/C;;OAEG;IACH,kBAAkB;IAIlB;;OAEG;IACH,kBAAkB;;;CAGnB"}

package/dist/core/exceptions/validation.exception.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationException = void 0;
+const http_exception_1 = require("./http-exception");
+/**
+ * Validation Exception
+ *
+ * Thrown when request validation fails using Zod schemas.
+ * Provides detailed error information for each validation issue.
+ *
+ * @example
+ * ```typescript
+ * // The framework throws this automatically when @Body(schema) validation fails
+ * // But you can also throw it manually:
+ *
+ * const result = MySchema.safeParse(data);
+ * if (!result.success) {
+ *   throw new ValidationException(result.error);
+ * }
+ * ```
+ */
+class ValidationException extends http_exception_1.HttpException {
+    /**
+     * The original Zod error object
+     */
+    zodError;
+    /**
+     * Structured validation error details
+     */
+    errors;
+    constructor(zodError, message = 'Validation failed') {
+        // Transform Zod issues to structured format
+        const errors = zodError.issues.map((issue) => ({
+            path: issue.path,
+            message: issue.message,
+            code: issue.code,
+            ...(('expected' in issue) ? { expected: String(issue.expected) } : {}),
+            ...(('received' in issue) ? { received: String(issue.received) } : {}),
+        }));
+        super({
+            message,
+            error: 'Validation Error',
+            details: {
+                errors,
+                errorCount: errors.length,
+            },
+        }, 400);
+        this.zodError = zodError;
+        this.errors = errors;
+    }
+    /**
+     * Get formatted errors for client response
+     */
+    getValidationErrors() {
+        return this.errors;
+    }
+    /**
+     * Get the flattened Zod error format
+     */
+    getFlattenedErrors() {
+        return this.zodError.flatten();
+    }
+    /**
+     * Get the formatted Zod error
+     */
+    getFormattedErrors() {
+        return this.zodError.format();
+    }
+}
+exports.ValidationException = ValidationException;
+//# sourceMappingURL=validation.exception.js.map

package/dist/core/exceptions/validation.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.exception.js","sourceRoot":"","sources":["../../../src/core/exceptions/validation.exception.ts"],"names":[],"mappings":";;;AACA,qDAAiD;AAkBjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,mBAAoB,SAAQ,8BAAa;IACpD;;OAEG;IACM,QAAQ,CAAW;IAE5B;;OAEG;IACM,MAAM,CAA2B;IAE1C,YAAY,QAAkB,EAAE,UAAkB,mBAAmB;QACnE,4CAA4C;QAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAe,EAA0B,EAAE,CAAC,CAAC;YAC/E,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvE,CAAC,CAAC,CAAC;QAEJ,KAAK,CACH;YACE,OAAO;YACP,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE;gBACP,MAAM;gBACN,UAAU,EAAE,MAAM,CAAC,MAAM;aAC1B;SACF,EACD,GAAG,CACJ,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;CACF;AAzDD,kDAyDC"}

package/dist/core/index.d.ts

@@ -8,4 +8,6 @@ export * from './router/router';
 export * from './application';
 export * from './decorators';
 export * from './exceptions';
+export { z } from 'zod';
+export type { ZodType, ZodSchema, ZodError, ZodIssue, infer as ZodInfer } from 'zod';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAK7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,KAAK,CAAC"}

package/dist/core/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.z = void 0;
 // Core exports
 __exportStar(require("./types"), exports);
 __exportStar(require("./constants"), exports);
@@ -25,4 +26,9 @@ __exportStar(require("./router/router"), exports);
 __exportStar(require("./application"), exports);
 __exportStar(require("./decorators"), exports);
 __exportStar(require("./exceptions"), exports);
+// Re-export Zod for convenience
+// This allows users to import everything from '@riktajs/core':
+// import { z, Body, Controller } from '@riktajs/core';
+var zod_1 = require("zod");
+Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,eAAe;AACf,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAC5B,6CAA2B;AAC3B,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B;AAC9B,+CAA6B;AAC7B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,eAAe;AACf,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAC5B,6CAA2B;AAC3B,8CAA4B;AAC5B,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B;AAC9B,+CAA6B;AAC7B,+CAA6B;AAE7B,gCAAgC;AAChC,+DAA+D;AAC/D,uDAAuD;AACvD,2BAAwB;AAAf,wFAAA,CAAC,OAAA"}

package/dist/core/router/router.d.ts

@@ -32,7 +32,7 @@ export declare class Router {
      */
     private resolveParams;
     /**
-     * Resolve a single parameter
+     * Resolve a single parameter with optional Zod validation
      */
     private resolveParam;
 }

package/dist/core/router/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/core/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAQnD,OAAO,EAAE,WAAW,EAAiC,MAAM,UAAU,CAAC;AAGtE;;;;;;;GAOG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFZ,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,SAAS,EACpB,YAAY,GAAE,MAAW;IAG5C;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,WAAW,GAAG,IAAI;IAuBtD;;OAEG;IACH,OAAO,CAAC,aAAa;IA+DrB;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,OAAO,CAAC,YAAY;CAmCrB"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/core/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAQnD,OAAO,EAAE,WAAW,EAAiC,MAAM,UAAU,CAAC;AAItE;;;;;;;GAOG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFZ,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,SAAS,EACpB,YAAY,GAAE,MAAW;IAG5C;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,WAAW,GAAG,IAAI;IAuBtD;;OAEG;IACH,OAAO,CAAC,aAAa;IA+DrB;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,OAAO,CAAC,YAAY;CA6DrB"}

package/dist/core/router/router.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Router = void 0;
 require("reflect-metadata");
 const constants_1 = require("../constants");
+const validation_exception_1 = require("../exceptions/validation.exception");
 /**
  * Router class
  *
@@ -115,26 +116,32 @@ class Router {
         return args;
     }
     /**
-     * Resolve a single parameter
+     * Resolve a single parameter with optional Zod validation
      */
     resolveParam(param, context) {
+        // Get raw value based on parameter type
+        let rawValue;
         switch (param.type) {
             case constants_1.ParamType.BODY:
-                return param.key
+                rawValue = param.key
                     ? context.body?.[param.key]
                     : context.body;
+                break;
             case constants_1.ParamType.QUERY:
-                return param.key
+                rawValue = param.key
                     ? context.query[param.key]
                     : context.query;
+                break;
             case constants_1.ParamType.PARAM:
-                return param.key
+                rawValue = param.key
                     ? context.params[param.key]
                     : context.params;
+                break;
             case constants_1.ParamType.HEADERS:
-                return param.key
+                rawValue = param.key
                     ? context.request.headers[param.key.toLowerCase()]
                     : context.request.headers;
+                break;
             case constants_1.ParamType.REQUEST:
                 return context.request;
             case constants_1.ParamType.REPLY:
@@ -144,6 +151,18 @@ class Router {
             default:
                 return undefined;
         }
+        // If a Zod schema is provided, validate the raw value
+        if (param.zodSchema) {
+            const result = param.zodSchema.safeParse(rawValue);
+            if (!result.success) {
+                // Throw ValidationException with Zod error details
+                throw new validation_exception_1.ValidationException(result.error, `Validation failed for ${param.type}${param.key ? ` (${param.key})` : ''}`);
+            }
+            // Return the validated and transformed data
+            return result.data;
+        }
+        // No schema provided, return raw value (backward compatible)
+        return rawValue;
     }
 }
 exports.Router = Router;

package/dist/core/router/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/core/router/router.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/core/router/router.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riktajs/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A fast and modern TypeScript backend framework with zero-config autowiring, powered by Fastify",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,7 +31,8 @@
   "dependencies": {
     "fast-glob": "^3.3.2",
     "fastify": "^5.1.0",
-    "reflect-metadata": "^0.2.2"
+    "reflect-metadata": "^0.2.2",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",