@riktajs/core 0.2.0 → 0.2.1

package/README.md

@@ -1,324 +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
-- ✅ **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
+---
 
-## 📦 Installation
+## 🤔 Why Rikta?
 
-```bash
-npm install
-```
+Are you tired of **"Module Hell"** in NestJS? Do you miss the simplicity of Express but need the structure of a real framework?
 
-## 🚀 Quick Start
+**Rikta** is designed for developers who want to move fast without breaking things.
 
-```typescript
-import { Rikta, Controller, Injectable, Get, Autowired } from '@rikta/core';
+*   🚀 **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.
 
-@Injectable()
-class GreetingService {
-  getGreeting(): string {
-    return 'Hello from Rikta!';
-  }
-}
+Rikta is nordic for "guide". Let Rikta guide you to build better backends, faster.
 
-@Controller()
-export class AppController {
-  @Autowired()
-  private greetingService!: GreetingService;
+---
 
-  @Get('/')
-  getHello() {
-    return this.greetingService.getGreeting();
-  }
-}
+## ⚡ Quick Start
 
-// No modules - just create and run!
-const app = await Rikta.create({ port: 3000, autowired: [__dirname] });
-await app.listen();
-```
-
-## 📚 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
+### 1. Install
 
 ```bash
-npm run example  # Full-featured CRUD with lifecycle hooks
+npm install @riktajs/core
 ```
 
-## ⚙️ Configuration
+### 2. Create your App
 
-```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: [path.resolve('./src/controllers'), path.resolve('./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],
-});
-```
-
-### Auto-Discovery
-
-Rikta automatically scans and imports files to discover `@Controller` and `@Injectable` classes:
+No complex setup. Just one file is enough to start.
 
 ```typescript
-// Scan specific directories
-await Rikta.create({ 
-  autowired: [path.resolve('./src/controllers')] 
-});
+// main.ts
+import { Rikta, Controller, Injectable, Get, Post, Body, Autowired, z } from '@riktajs/core';
 
-// Default: scans current directory recursively
-await Rikta.create({ port: 3000, autowired: [path.resolve('.')] });
-```
-
-## 🔄 Lifecycle Hooks
+// 1. Define a Service (Auto-discovered!)
+@Injectable()
+class UserService {
+  private users = [{ id: 1, name: 'Rikta User' }];
 
-```typescript
-@Injectable({ priority: 100 })  // Higher = initialized first
-class DatabaseService implements OnProviderInit, OnProviderDestroy {
-  async onProviderInit() {
-    await this.connect();
-  }
+  findAll() { return this.users; }
   
-  async onProviderDestroy() {
-    await this.disconnect();
-  }
-}
-
-// Or use @On() decorator for events
-@Injectable()
-class MonitoringService {
-  @On('app:listen')
-  onServerStart({ address }) {
-    console.log(`Server at ${address}`);
+  create(name: string) {
+    const user = { id: this.users.length + 1, name };
+    this.users.push(user);
+    return user;
   }
 }
-```
 
-See [Lifecycle Documentation](./src/core/lifecycle/README.md) for full details.
-
-## 🛡️ Exception Handling
-
-```typescript
-import { 
-  NotFoundException, 
-  BadRequestException,
-  HttpException 
-} from '@rikta/core';
+// 2. Define a Schema (Type-safe!)
+const CreateUserSchema = z.object({
+  name: z.string().min(3)
+});
 
+// 3. Define a Controller (Auto-discovered!)
 @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;
+export class UserController {
+  @Autowired()
+  private userService!: UserService; // Dependency Injection works like magic
+
+  @Get()
+  getUsers() {
+    return this.userService.findAll();
   }
 
   @Post()
-  async create(@Body() data: CreateUserDto) {
-    if (!data.email) {
-      throw new BadRequestException({
-        message: 'Validation failed',
-        details: { email: 'Email is required' }
-      });
-    }
+  createUser(@Body(CreateUserSchema) body: z.infer<typeof CreateUserSchema>) {
+    // 'body' is fully typed here!
+    return this.userService.create(body.name);
   }
 }
-```
 
-**Standard JSON Response:**
-```json
-{
-  "statusCode": 404,
-  "message": "User 123 not found",
-  "error": "Not Found",
-  "timestamp": "2024-01-15T10:30:00.000Z",
-  "path": "/users/123"
-}
+// 4. Run it!
+const app = await Rikta.create({ port: 3000, autowired: [__dirname] });
+await app.listen();
+console.log('🚀 Server running on http://localhost:3000');
 ```
 
-**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.
+## 📚 Documentation
 
-## ✅ Zod Validation
+Everything you need to build production-ready APIs.
 
-Rikta has **native Zod integration** for type-safe request validation. Define schemas once and get both runtime validation and TypeScript type inference automatically.
+| 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. |
 
-### Basic Usage
+---
 
-```typescript
-import { Controller, Post, Body, Query, z } from '@riktajs/core';
+## ✨ Key Features
 
-// 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(),
-});
+### 🚫 No Modules, Just Logic
+Forget about `AppModule`, `UserModule`, `SharedModule`. Rikta scans your code and resolves dependencies automatically.
 
-// 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
+### ✅ Native Zod Validation
+Don't duplicate your types. Define a Zod schema, and Rikta validates the request *and* gives you the TypeScript type.
 
 ```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 };
-  }
+@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.
 }
 ```
 
-### Zod Transformations
-
-Zod's transform feature works seamlessly:
+### 🔌 Powerful Dependency Injection
+Support for Singleton (default) and Transient scopes, factory providers, and value tokens.
 
 ```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[]
+@Injectable()
+class AuthService {
+  constructor(
+    @Autowired(DB_CONFIG) private config: Config,
+    @Autowired() private logger: LoggerService
+  ) {}
 }
 ```
 
-### 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) { ... }
+## 🤝 Contributing
 
-@Get()
-list(@Query('page') page: string) { ... }
-```
-
-## 📁 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/guards/can-activate.interface.d.ts

@@ -0,0 +1,77 @@
+import type { ExecutionContext } from './execution-context';
+/**
+ * CanActivate Interface
+ *
+ * Guards implementing this interface determine whether a given
+ * request is allowed to be handled by the route handler.
+ *
+ * Guards are executed BEFORE the route handler. If any guard
+ * returns `false`, the request is rejected with a 403 Forbidden.
+ *
+ * @example Basic authentication guard
+ * ```typescript
+ * import { Injectable } from '@riktajs/core';
+ * import type { CanActivate, ExecutionContext } from '@riktajs/core';
+ *
+ * @Injectable()
+ * export class AuthGuard implements CanActivate {
+ *   canActivate(context: ExecutionContext): boolean {
+ *     const request = context.getRequest();
+ *     return !!request.headers.authorization;
+ *   }
+ * }
+ * ```
+ *
+ * @example Async guard with service injection
+ * ```typescript
+ * @Injectable()
+ * export class JwtGuard implements CanActivate {
+ *   constructor(private authService: AuthService) {}
+ *
+ *   async canActivate(context: ExecutionContext): Promise<boolean> {
+ *     const request = context.getRequest();
+ *     const token = request.headers.authorization?.replace('Bearer ', '');
+ *
+ *     if (!token) return false;
+ *
+ *     try {
+ *       const user = await this.authService.verifyToken(token);
+ *       request.user = user;
+ *       return true;
+ *     } catch {
+ *       return false;
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example Role-based guard
+ * ```typescript
+ * @Injectable()
+ * export class RolesGuard implements CanActivate {
+ *   canActivate(context: ExecutionContext): boolean {
+ *     const request = context.getRequest();
+ *     const user = request.user;
+ *     const requiredRoles = context.getMetadata<string[]>('roles');
+ *
+ *     if (!requiredRoles || requiredRoles.length === 0) {
+ *       return true;
+ *     }
+ *
+ *     return requiredRoles.some(role => user?.roles?.includes(role));
+ *   }
+ * }
+ * ```
+ */
+export interface CanActivate {
+    /**
+     * Determines whether the request can proceed to the handler.
+     *
+     * @param context - The execution context containing request/reply
+     * @returns `true` to allow access, `false` to deny (throws 403)
+     *
+     * Can be synchronous or return a Promise for async operations.
+     */
+    canActivate(context: ExecutionContext): boolean | Promise<boolean>;
+}
+//# sourceMappingURL=can-activate.interface.d.ts.map

package/dist/core/guards/can-activate.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"can-activate.interface.d.ts","sourceRoot":"","sources":["../../../src/core/guards/can-activate.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;OAOG;IACH,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE"}

package/dist/core/guards/can-activate.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=can-activate.interface.js.map

package/dist/core/guards/can-activate.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"can-activate.interface.js","sourceRoot":"","sources":["../../../src/core/guards/can-activate.interface.ts"],"names":[],"mappings":""}

package/dist/core/guards/execution-context.d.ts

@@ -0,0 +1,72 @@
+import type { FastifyRequest, FastifyReply } from 'fastify';
+import type { Constructor } from '../types';
+/**
+ * ExecutionContext Interface
+ *
+ * Provides access to the current request context, including
+ * request/reply objects and handler metadata. Used by guards
+ * to make authorization decisions.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class AuthGuard implements CanActivate {
+ *   async canActivate(context: ExecutionContext): Promise<boolean> {
+ *     const request = context.getRequest();
+ *     const authHeader = request.headers.authorization;
+ *     return !!authHeader;
+ *   }
+ * }
+ * ```
+ */
+export interface ExecutionContext {
+    /**
+     * Get the Fastify request object
+     *
+     * @returns The current request instance
+     */
+    getRequest<T = FastifyRequest>(): T;
+    /**
+     * Get the Fastify reply object
+     *
+     * @returns The current reply instance
+     */
+    getReply<T = FastifyReply>(): T;
+    /**
+     * Get the controller class that handles the route
+     *
+     * @returns The controller constructor
+     */
+    getClass(): Constructor;
+    /**
+     * Get the handler method name
+     *
+     * @returns The method name being invoked
+     */
+    getHandler(): string | symbol;
+    /**
+     * Get handler metadata by key
+     *
+     * @param key - Metadata key to retrieve
+     * @returns The metadata value if found
+     */
+    getMetadata<T = unknown>(key: string | symbol): T | undefined;
+}
+/**
+ * Default ExecutionContext implementation
+ *
+ * @internal
+ */
+export declare class ExecutionContextImpl implements ExecutionContext {
+    private readonly request;
+    private readonly reply;
+    private readonly controllerClass;
+    private readonly handlerName;
+    constructor(request: FastifyRequest, reply: FastifyReply, controllerClass: Constructor, handlerName: string | symbol);
+    getRequest<T = FastifyRequest>(): T;
+    getReply<T = FastifyReply>(): T;
+    getClass(): Constructor;
+    getHandler(): string | symbol;
+    getMetadata<T = unknown>(key: string | symbol): T | undefined;
+}
+//# sourceMappingURL=execution-context.d.ts.map

package/dist/core/guards/execution-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../../src/core/guards/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,UAAU,CAAC,CAAC,GAAG,cAAc,KAAK,CAAC,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,IAAI,WAAW,CAAC;IAExB;;;;OAIG;IACH,UAAU,IAAI,MAAM,GAAG,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAC/D;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAEzD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAHX,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,WAAW,EAC5B,WAAW,EAAE,MAAM,GAAG,MAAM;IAG/C,UAAU,CAAC,CAAC,GAAG,cAAc,KAAK,CAAC;IAInC,QAAQ,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;IAI/B,QAAQ,IAAI,WAAW;IAIvB,UAAU,IAAI,MAAM,GAAG,MAAM;IAI7B,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS;CAG9D"}

package/dist/core/guards/execution-context.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionContextImpl = void 0;
+/**
+ * Default ExecutionContext implementation
+ *
+ * @internal
+ */
+class ExecutionContextImpl {
+    request;
+    reply;
+    controllerClass;
+    handlerName;
+    constructor(request, reply, controllerClass, handlerName) {
+        this.request = request;
+        this.reply = reply;
+        this.controllerClass = controllerClass;
+        this.handlerName = handlerName;
+    }
+    getRequest() {
+        return this.request;
+    }
+    getReply() {
+        return this.reply;
+    }
+    getClass() {
+        return this.controllerClass;
+    }
+    getHandler() {
+        return this.handlerName;
+    }
+    getMetadata(key) {
+        return Reflect.getMetadata(key, this.controllerClass, this.handlerName);
+    }
+}
+exports.ExecutionContextImpl = ExecutionContextImpl;
+//# sourceMappingURL=execution-context.js.map

package/dist/core/guards/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../../src/core/guards/execution-context.ts"],"names":[],"mappings":";;;AA4DA;;;;GAIG;AACH,MAAa,oBAAoB;IAEZ;IACA;IACA;IACA;IAJnB,YACmB,OAAuB,EACvB,KAAmB,EACnB,eAA4B,EAC5B,WAA4B;QAH5B,YAAO,GAAP,OAAO,CAAgB;QACvB,UAAK,GAAL,KAAK,CAAc;QACnB,oBAAe,GAAf,eAAe,CAAa;QAC5B,gBAAW,GAAX,WAAW,CAAiB;IAC5C,CAAC;IAEJ,UAAU;QACR,OAAO,IAAI,CAAC,OAAY,CAAC;IAC3B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAU,CAAC;IACzB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,WAAW,CAAc,GAAoB;QAC3C,OAAO,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,WAAqB,CAAkB,CAAC;IACrG,CAAC;CACF;AA3BD,oDA2BC"}

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

@@ -0,0 +1,4 @@
+export { CanActivate } from './can-activate.interface';
+export { ExecutionContext, ExecutionContextImpl } from './execution-context';
+export { UseGuards, getGuardsMetadata } from './use-guards.decorator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/guards/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/core/guards/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGuardsMetadata = exports.UseGuards = exports.ExecutionContextImpl = void 0;
+var execution_context_1 = require("./execution-context");
+Object.defineProperty(exports, "ExecutionContextImpl", { enumerable: true, get: function () { return execution_context_1.ExecutionContextImpl; } });
+// UseGuards decorator
+var use_guards_decorator_1 = require("./use-guards.decorator");
+Object.defineProperty(exports, "UseGuards", { enumerable: true, get: function () { return use_guards_decorator_1.UseGuards; } });
+Object.defineProperty(exports, "getGuardsMetadata", { enumerable: true, get: function () { return use_guards_decorator_1.getGuardsMetadata; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/guards/index.ts"],"names":[],"mappings":";;;AAEA,yDAA6E;AAAlD,yHAAA,oBAAoB,OAAA;AAE/C,sBAAsB;AACtB,+DAAsE;AAA7D,iHAAA,SAAS,OAAA;AAAE,yHAAA,iBAAiB,OAAA"}

package/dist/core/guards/use-guards.decorator.d.ts

@@ -0,0 +1,82 @@
+import 'reflect-metadata';
+import type { Constructor } from '../types';
+import type { CanActivate } from './can-activate.interface';
+/**
+ * Type for guard constructors
+ */
+export type GuardClass = Constructor<CanActivate>;
+/**
+ * @UseGuards() Decorator
+ *
+ * Applies one or more guards to a controller or route handler.
+ * Guards are executed in order before the handler runs.
+ *
+ * Guards are resolved from the DI container, so they can have
+ * injected dependencies. Make sure guards are decorated with @Injectable().
+ *
+ * @param guards - Guard classes to apply
+ *
+ * @example Apply guard to entire controller
+ * ```typescript
+ * @Controller('/admin')
+ * @UseGuards(AuthGuard)
+ * class AdminController {
+ *   @Get('/dashboard')
+ *   getDashboard() {
+ *     return { message: 'Admin dashboard' };
+ *   }
+ * }
+ * ```
+ *
+ * @example Apply guard to specific route
+ * ```typescript
+ * @Controller('/users')
+ * class UserController {
+ *   @Get()
+ *   findAll() {
+ *     return []; // Public route
+ *   }
+ *
+ *   @Post()
+ *   @UseGuards(AuthGuard)
+ *   create() {
+ *     return {}; // Protected route
+ *   }
+ * }
+ * ```
+ *
+ * @example Multiple guards (AND logic - all must pass)
+ * ```typescript
+ * @Controller('/admin')
+ * @UseGuards(AuthGuard, RolesGuard)
+ * class AdminController {
+ *   // User must be authenticated AND have correct role
+ * }
+ * ```
+ *
+ * @example Combined controller and method guards
+ * ```typescript
+ * @Controller('/api')
+ * @UseGuards(AuthGuard)  // Applied to all routes
+ * class ApiController {
+ *   @Get('/public')
+ *   // Only AuthGuard runs
+ *   getPublic() {}
+ *
+ *   @Post('/admin')
+ *   @UseGuards(AdminGuard)  // Additional guard
+ *   // Both AuthGuard AND AdminGuard run
+ *   adminAction() {}
+ * }
+ * ```
+ */
+export declare function UseGuards(...guards: GuardClass[]): ClassDecorator & MethodDecorator;
+/**
+ * Get guards metadata from a controller class and/or method
+ *
+ * @param target - Controller class
+ * @param propertyKey - Method name (optional)
+ * @returns Combined array of guard classes (controller + method)
+ */
+export declare function getGuardsMetadata(target: Constructor, propertyKey?: string | symbol): GuardClass[];
+//# sourceMappingURL=use-guards.decorator.d.ts.map

package/dist/core/guards/use-guards.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-guards.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/guards/use-guards.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,GAAG,eAAe,CA2BnF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAC5B,UAAU,EAAE,CAed"}

package/dist/core/guards/use-guards.decorator.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UseGuards = UseGuards;
+exports.getGuardsMetadata = getGuardsMetadata;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+/**
+ * @UseGuards() Decorator
+ *
+ * Applies one or more guards to a controller or route handler.
+ * Guards are executed in order before the handler runs.
+ *
+ * Guards are resolved from the DI container, so they can have
+ * injected dependencies. Make sure guards are decorated with @Injectable().
+ *
+ * @param guards - Guard classes to apply
+ *
+ * @example Apply guard to entire controller
+ * ```typescript
+ * @Controller('/admin')
+ * @UseGuards(AuthGuard)
+ * class AdminController {
+ *   @Get('/dashboard')
+ *   getDashboard() {
+ *     return { message: 'Admin dashboard' };
+ *   }
+ * }
+ * ```
+ *
+ * @example Apply guard to specific route
+ * ```typescript
+ * @Controller('/users')
+ * class UserController {
+ *   @Get()
+ *   findAll() {
+ *     return []; // Public route
+ *   }
+ *
+ *   @Post()
+ *   @UseGuards(AuthGuard)
+ *   create() {
+ *     return {}; // Protected route
+ *   }
+ * }
+ * ```
+ *
+ * @example Multiple guards (AND logic - all must pass)
+ * ```typescript
+ * @Controller('/admin')
+ * @UseGuards(AuthGuard, RolesGuard)
+ * class AdminController {
+ *   // User must be authenticated AND have correct role
+ * }
+ * ```
+ *
+ * @example Combined controller and method guards
+ * ```typescript
+ * @Controller('/api')
+ * @UseGuards(AuthGuard)  // Applied to all routes
+ * class ApiController {
+ *   @Get('/public')
+ *   // Only AuthGuard runs
+ *   getPublic() {}
+ *
+ *   @Post('/admin')
+ *   @UseGuards(AdminGuard)  // Additional guard
+ *   // Both AuthGuard AND AdminGuard run
+ *   adminAction() {}
+ * }
+ * ```
+ */
+function UseGuards(...guards) {
+    return (target, propertyKey) => {
+        if (propertyKey !== undefined) {
+            // Method decorator - store on the method
+            const existingGuards = Reflect.getMetadata(constants_1.GUARDS_METADATA, target.constructor, propertyKey) ?? [];
+            Reflect.defineMetadata(constants_1.GUARDS_METADATA, [...existingGuards, ...guards], target.constructor, propertyKey);
+        }
+        else {
+            // Class decorator - store on the class
+            const existingGuards = Reflect.getMetadata(constants_1.GUARDS_METADATA, target) ?? [];
+            Reflect.defineMetadata(constants_1.GUARDS_METADATA, [...existingGuards, ...guards], target);
+        }
+    };
+}
+/**
+ * Get guards metadata from a controller class and/or method
+ *
+ * @param target - Controller class
+ * @param propertyKey - Method name (optional)
+ * @returns Combined array of guard classes (controller + method)
+ */
+function getGuardsMetadata(target, propertyKey) {
+    // Get class-level guards
+    const classGuards = Reflect.getMetadata(constants_1.GUARDS_METADATA, target) ?? [];
+    if (!propertyKey) {
+        return classGuards;
+    }
+    // Get method-level guards
+    const methodGuards = Reflect.getMetadata(constants_1.GUARDS_METADATA, target, propertyKey) ?? [];
+    // Combine: class guards run first, then method guards
+    return [...classGuards, ...methodGuards];
+}
+//# sourceMappingURL=use-guards.decorator.js.map

package/dist/core/guards/use-guards.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-guards.decorator.js","sourceRoot":"","sources":["../../../src/core/guards/use-guards.decorator.ts"],"names":[],"mappings":";;AA2EA,8BA2BC;AASD,8CAkBC;AAjID,4BAA0B;AAC1B,4CAA+C;AAS/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,SAAgB,SAAS,CAAC,GAAG,MAAoB;IAC/C,OAAO,CACL,MAAc,EACd,WAA6B,EAEvB,EAAE;QACR,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,yCAAyC;YACzC,MAAM,cAAc,GAClB,OAAO,CAAC,WAAW,CAAC,2BAAe,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;YAC9E,OAAO,CAAC,cAAc,CACpB,2BAAe,EACf,CAAC,GAAG,cAAc,EAAE,GAAG,MAAM,CAAC,EAC9B,MAAM,CAAC,WAAW,EAClB,WAAW,CACZ,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,MAAM,cAAc,GAClB,OAAO,CAAC,WAAW,CAAC,2BAAe,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACrD,OAAO,CAAC,cAAc,CACpB,2BAAe,EACf,CAAC,GAAG,cAAc,EAAE,GAAG,MAAM,CAAC,EAC9B,MAAM,CACP,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,MAAmB,EACnB,WAA6B;IAE7B,yBAAyB;IACzB,MAAM,WAAW,GACf,OAAO,CAAC,WAAW,CAAC,2BAAe,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAErD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,0BAA0B;IAC1B,MAAM,YAAY,GAChB,OAAO,CAAC,WAAW,CAAC,2BAAe,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;IAElE,sDAAsD;IACtD,OAAO,CAAC,GAAG,WAAW,EAAE,GAAG,YAAY,CAAC,CAAC;AAC3C,CAAC"}

package/dist/core/index.d.ts

@@ -8,6 +8,7 @@ export * from './router/router';
 export * from './application';
 export * from './decorators';
 export * from './exceptions';
+export * from './guards';
 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;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"}
+{"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;AAC7B,cAAc,UAAU,CAAC;AAKzB,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

@@ -26,6 +26,7 @@ __exportStar(require("./router/router"), exports);
 __exportStar(require("./application"), exports);
 __exportStar(require("./decorators"), exports);
 __exportStar(require("./exceptions"), exports);
+__exportStar(require("./guards"), exports);
 // Re-export Zod for convenience
 // This allows users to import everything from '@riktajs/core':
 // import { z, Body, Controller } from '@riktajs/core';

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;AAE7B,gCAAgC;AAChC,+DAA+D;AAC/D,uDAAuD;AACvD,2BAAwB;AAAf,wFAAA,CAAC,OAAA"}
+{"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;AAC7B,2CAAyB;AAEzB,gCAAgC;AAChC,+DAA+D;AAC/D,uDAAuD;AACvD,2BAAwB;AAAf,wFAAA,CAAC,OAAA"}

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

@@ -35,5 +35,13 @@ export declare class Router {
      * Resolve a single parameter with optional Zod validation
      */
     private resolveParam;
+    /**
+     * Execute guards for a route
+     * Guards are executed in order (controller-level first, then method-level)
+     * All guards must pass (AND logic)
+     *
+     * @throws ForbiddenException if any guard returns false
+     */
+    private executeGuards;
 }
 //# sourceMappingURL=router.d.ts.map

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;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"}
+{"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;AAQtE;;;;;;;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;IAuErB;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IA8DpB;;;;;;OAMG;YACW,aAAa;CAgD5B"}

package/dist/core/router/router.js

@@ -4,6 +4,9 @@ exports.Router = void 0;
 require("reflect-metadata");
 const constants_1 = require("../constants");
 const validation_exception_1 = require("../exceptions/validation.exception");
+const exceptions_1 = require("../exceptions/exceptions");
+const execution_context_1 = require("../guards/execution-context");
+const use_guards_decorator_1 = require("../guards/use-guards.decorator");
 /**
  * Router class
  *
@@ -55,9 +58,15 @@ class Router {
         const paramsMeta = Reflect.getMetadata(constants_1.PARAM_METADATA, controllerClass, route.handlerName) ?? [];
         // Get HTTP status code if set
         const statusCode = Reflect.getMetadata(constants_1.HTTP_CODE_METADATA, controllerClass, route.handlerName);
+        // Get guards for this route (controller-level + method-level)
+        const guards = (0, use_guards_decorator_1.getGuardsMetadata)(controllerClass, route.handlerName);
         // Create the route handler
         const routeHandler = async (request, reply) => {
             try {
+                // Execute guards before handler
+                if (guards.length > 0) {
+                    await this.executeGuards(guards, request, reply, controllerClass, route.handlerName);
+                }
                 // Build route context
                 const context = {
                     request,
@@ -164,6 +173,41 @@ class Router {
         // No schema provided, return raw value (backward compatible)
         return rawValue;
     }
+    /**
+     * Execute guards for a route
+     * Guards are executed in order (controller-level first, then method-level)
+     * All guards must pass (AND logic)
+     *
+     * @throws ForbiddenException if any guard returns false
+     */
+    async executeGuards(guards, request, reply, controllerClass, handlerName) {
+        // Create execution context
+        const context = new execution_context_1.ExecutionContextImpl(request, reply, controllerClass, handlerName);
+        // Execute each guard sequentially
+        for (const GuardClass of guards) {
+            // Resolve guard instance from DI container
+            let guardInstance;
+            try {
+                guardInstance = this.container.resolve(GuardClass);
+            }
+            catch (error) {
+                throw new Error(`Failed to resolve guard ${GuardClass.name}. ` +
+                    `Make sure it is decorated with @Injectable(). ` +
+                    `Original error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            // Verify the guard has canActivate method
+            if (typeof guardInstance.canActivate !== 'function') {
+                throw new Error(`${GuardClass.name} does not implement CanActivate interface. ` +
+                    `The guard must have a canActivate(context: ExecutionContext) method.`);
+            }
+            // Execute the guard
+            const result = await guardInstance.canActivate(context);
+            // If guard returns false, deny access
+            if (result !== true) {
+                throw new exceptions_1.ForbiddenException(`Access denied by ${GuardClass.name}`);
+            }
+        }
+    }
 }
 exports.Router = Router;
 //# sourceMappingURL=router.js.map

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.2.0",
+  "version": "0.2.1",
   "description": "A fast and modern TypeScript backend framework with zero-config autowiring, powered by Fastify",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",