@riktajs/core 0.1.0 → 0.2.1

package/README.md

@@ -1,205 +1,140 @@
-# 🔧 Rikta Framework
+# 🧭 Rikta
 
-A modern TypeScript backend framework with zero-config autowiring, powered by Fastify.
+> **The Zero-Config TypeScript Framework for Modern Backends.**
+ 
+Build scalable APIs with the power of Fastify and the elegance of decorators. No modules. No boilerplate. Just code.
 
-## ✨ Features
+[![NPM Version](https://img.shields.io/npm/v/@riktajs/core)](https://www.npmjs.com/package/@riktajs/core)
+[![License](https://img.shields.io/npm/l/@riktajs/core)](LICENSE)
 
-- 🎯 **Decorator-based routing** - `@Controller`, `@Get`, `@Post`, etc.
-- 💉 **Full Autowiring** - No modules needed, everything is auto-discovered
-- 🔌 **Single DI decorator** - `@Autowired()` for everything
-- 🔄 **Hybrid Lifecycle** - Interface hooks + EventBus
-- 🛡️ **Exception Handling** - Built-in filters with standardized JSON responses
-- ⚡ **Fastify under the hood** - Maximum performance
-- 🔒 **Type-safe** - Full TypeScript support
-- 🪶 **Zero config** - Just decorate and run
+---
 
-## 📦 Installation
+## 🤔 Why Rikta?
+
+Are you tired of **"Module Hell"** in NestJS? Do you miss the simplicity of Express but need the structure of a real framework?
+
+**Rikta** is designed for developers who want to move fast without breaking things.
+
+*   🚀 **Zero-Config Autowiring:** No `imports: []`, `exports: []`, or `providers: []` arrays. Just decorate your class, and it works.
+*   ⚡ **Fastify Powered:** Built on top of Fastify for maximum performance and low overhead.
+*   🛡️ **Type-Safe by Default:** Native Zod integration for validation that infers your TypeScript types automatically.
+*   🔄 **Hybrid Lifecycle:** Powerful hooks and an event bus for complex application flows.
+
+Rikta is nordic for "guide". Let Rikta guide you to build better backends, faster.
+
+---
+
+## ⚡ Quick Start
+
+### 1. Install
 
 ```bash
-npm install
+npm install @riktajs/core
 ```
 
-## 🚀 Quick Start
+### 2. Create your App
+
+No complex setup. Just one file is enough to start.
 
 ```typescript
-import { Rikta, Controller, Injectable, Get, Autowired } from '@rikta/core';
+// main.ts
+import { Rikta, Controller, Injectable, Get, Post, Body, Autowired, z } from '@riktajs/core';
 
+// 1. Define a Service (Auto-discovered!)
 @Injectable()
-class GreetingService {
-  getGreeting(): string {
-    return 'Hello from Rikta!';
+class UserService {
+  private users = [{ id: 1, name: 'Rikta User' }];
+
+  findAll() { return this.users; }
+  
+  create(name: string) {
+    const user = { id: this.users.length + 1, name };
+    this.users.push(user);
+    return user;
   }
 }
 
-@Controller()
-export class AppController {
+// 2. Define a Schema (Type-safe!)
+const CreateUserSchema = z.object({
+  name: z.string().min(3)
+});
+
+// 3. Define a Controller (Auto-discovered!)
+@Controller('/users')
+export class UserController {
   @Autowired()
-  private greetingService!: GreetingService;
+  private userService!: UserService; // Dependency Injection works like magic
 
-  @Get('/')
-  getHello() {
-    return this.greetingService.getGreeting();
+  @Get()
+  getUsers() {
+    return this.userService.findAll();
+  }
+
+  @Post()
+  createUser(@Body(CreateUserSchema) body: z.infer<typeof CreateUserSchema>) {
+    // 'body' is fully typed here!
+    return this.userService.create(body.name);
   }
 }
 
-// No modules - just create and run!
-const app = await Rikta.create({ port: 3000 });
+// 4. Run it!
+const app = await Rikta.create({ port: 3000, autowired: [__dirname] });
 await app.listen();
+console.log('🚀 Server running on http://localhost:3000');
 ```
 
-## 📚 Documentation
-
-| Section | Description |
-|---------|-------------|
-| [Core Architecture](./src/core/README.md) | Framework internals |
-| [Dependency Injection](./src/core/container/README.md) | DI, tokens, autowiring |
-| [Lifecycle](./src/core/lifecycle/README.md) | Hooks, events, priority |
-| [Exception Handling](./src/core/exceptions/README.md) | Errors, filters, responses |
-| [Decorators](./src/core/decorators/README.md) | All decorators reference |
-| [Router](./src/core/router/README.md) | Routing and requests |
-| [Example](./example/README.md) | Working code example |
-
-## 🏃 Running Example
-
-```bash
-npm run example  # Full-featured CRUD with lifecycle hooks
-```
-
-## ⚙️ Configuration
+---
 
-```typescript
-const app = await Rikta.create({
-  port: 3000,           // Server port
-  host: '0.0.0.0',      // Server host
-  logger: true,         // Fastify logging
-  prefix: '/api/v1',    // Global prefix
-  
-  // Auto-discovery paths (default: ['./**'] - scans all files)
-  autowired: ['./src/controllers', './src/services'],
-  
-  // Optional: explicit controller list (skips auto-discovery)
-  controllers: [UserController, AppController],
-  
-  // Exception handling configuration
-  exceptionFilter: {
-    includeStack: process.env.NODE_ENV !== 'production',
-    logErrors: true,
-  },
-  
-  // Custom exception filters
-  exceptionFilters: [ValidationExceptionFilter],
-});
-```
+## 📚 Documentation
 
-### Auto-Discovery
+Everything you need to build production-ready APIs.
 
-Rikta automatically scans and imports files to discover `@Controller` and `@Injectable` classes:
+| Guide | Description |
+|-------|-------------|
+| [**Architecture**](./docs/guide/architecture.md) | How Rikta's auto-discovery works under the hood. |
+| [**Dependency Injection**](./docs/guide/dependency-injection.md) | Using `@Autowired`, tokens, and scopes. |
+| [**Routing**](./docs/guide/routing.md) | Controllers, methods, and parameter handling. |
+| [**Validation**](./docs/guide/validation.md) | **New!** Type-safe validation with Zod. |
+| [**Lifecycle**](./docs/guide/lifecycle.md) | Hooks (`OnProviderInit`) and the Event Bus. |
+| [**Error Handling**](./docs/guide/error-handling.md) | Exception filters and standard JSON responses. |
 
-```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'] 
-});
+## ✨ Key Features
 
-// Default: scans current directory recursively
-await Rikta.create({ port: 3000 });
-```
+### 🚫 No Modules, Just Logic
+Forget about `AppModule`, `UserModule`, `SharedModule`. Rikta scans your code and resolves dependencies automatically.
 
-## 🔄 Lifecycle Hooks
+### ✅ Native Zod Validation
+Don't duplicate your types. Define a Zod schema, and Rikta validates the request *and* gives you the TypeScript type.
 
 ```typescript
-@Injectable({ priority: 100 })  // Higher = initialized first
-class DatabaseService implements OnProviderInit, OnProviderDestroy {
-  async onProviderInit() {
-    await this.connect();
-  }
-  
-  async onProviderDestroy() {
-    await this.disconnect();
-  }
-}
-
-// Or use @On() decorator for events
-@Injectable()
-class MonitoringService {
-  @On('app:listen')
-  onServerStart({ address }) {
-    console.log(`Server at ${address}`);
-  }
+@Post()
+create(@Body(UserSchema) user: z.infer<typeof UserSchema>) {
+  // If we get here, 'user' is valid and typed.
+  // If not, Rikta returns a 400 Bad Request automatically.
 }
 ```
 
-See [Lifecycle Documentation](./src/core/lifecycle/README.md) for full details.
-
-## 🛡️ Exception Handling
+### 🔌 Powerful Dependency Injection
+Support for Singleton (default) and Transient scopes, factory providers, and value tokens.
 
 ```typescript
-import { 
-  NotFoundException, 
-  BadRequestException,
-  HttpException 
-} from '@rikta/core';
-
-@Controller('/users')
-class UserController {
-  @Get('/:id')
-  async getUser(@Param('id') id: string) {
-    const user = await this.userService.findById(id);
-    
-    if (!user) {
-      throw new NotFoundException(`User ${id} not found`);
-    }
-    
-    return user;
-  }
-
-  @Post()
-  async create(@Body() data: CreateUserDto) {
-    if (!data.email) {
-      throw new BadRequestException({
-        message: 'Validation failed',
-        details: { email: 'Email is required' }
-      });
-    }
-  }
-}
-```
-
-**Standard JSON Response:**
-```json
-{
-  "statusCode": 404,
-  "message": "User 123 not found",
-  "error": "Not Found",
-  "timestamp": "2024-01-15T10:30:00.000Z",
-  "path": "/users/123"
+@Injectable()
+class AuthService {
+  constructor(
+    @Autowired(DB_CONFIG) private config: Config,
+    @Autowired() private logger: LoggerService
+  ) {}
 }
 ```
 
-**Available Exceptions:** `BadRequestException`, `UnauthorizedException`, `ForbiddenException`, `NotFoundException`, `ConflictException`, `UnprocessableEntityException`, `TooManyRequestsException`, `InternalServerErrorException`, `ServiceUnavailableException`, and more.
+---
 
-See [Exception Handling Documentation](./src/core/exceptions/README.md) for full details.
+## 🤝 Contributing
 
-## 📁 Project Structure
-
-```
-rikta/
-├── src/core/
-│   ├── container/      # Dependency Injection
-│   ├── decorators/     # All decorators
-│   ├── exceptions/     # Error handling & filters
-│   ├── lifecycle/      # Hooks & EventBus
-│   ├── router/         # Route handling
-│   ├── registry.ts     # Auto-discovery registry
-│   └── application.ts  # Bootstrap
-└── example/            # Full-featured example
-```
+We love contributions! Please check our [Contributing Guide](CONTRIBUTING.md) (Coming Soon) and join our community.
 
-## 📜 License
+## 📄 License
 
-MIT
+Rikta is [MIT licensed](LICENSE).

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"}