@lerianstudio/sindarian-server 1.0.0-beta.9 → 1.1.0

package/README.md

@@ -4,15 +4,16 @@ A lightweight, NestJS-inspired framework designed specifically for Next.js appli
 
 ## ( Features
 
-- =� **NestJS-like API** - Familiar decorators and patterns
-- � **Next.js Optimized** - Built for serverless environments
-- =� **Dependency Injection** - Powered by Inversify
-- =� **Decorator-based Routing** - Clean, declarative route definitions
-- =' **Middleware Support** - Interceptors and exception filters
-- =� **TypeScript First** - Full type safety out of the box
-- <� **Lightweight** - Minimal overhead for fast cold starts
+- =� **NestJS-like API** - Familiar decorators and patterns
+- � **Next.js Optimized** - Built for serverless environments
+- =� **Dependency Injection** - Powered by Inversify
+- =� **Decorator-based Routing** - Clean, declarative route definitions
+- =' **Middleware Support** - Guards, interceptors, pipes, and exception filters
+- ✅ **Zod Validation** - Built-in schema validation with Zod
+- =� **TypeScript First** - Full type safety out of the box
+- <� **Lightweight** - Minimal overhead for fast cold starts
 
-## =� Quick Start
+## =� Quick Start
 
 ### Installation
 
@@ -119,7 +120,7 @@ export async function PATCH(request: NextRequest, context: any) {
 }
 ```
 
-## =� Core Concepts
+## =� Core Concepts
 
 ### Controllers
 
@@ -212,24 +213,41 @@ Create custom exception filters:
 export class ValidationFilter implements ExceptionFilter {
   async catch(exception: ValidationError, host: ArgumentsHost) {
     return NextResponse.json(
-      { 
+      {
         message: 'Validation failed',
-        errors: exception.errors 
+        errors: exception.errors
       },
       { status: 400 }
     )
   }
 }
 
-// Apply globally
+// Apply globally via app
 app.useGlobalFilters(new ValidationFilter())
 
+// Or register via module providers (supports multiple filters)
+@Module({
+  providers: [
+    {
+      provide: APP_FILTER,
+      useClass: ValidationFilter
+    },
+    {
+      provide: APP_FILTER,
+      useClass: DatabaseErrorFilter
+    }
+  ]
+})
+export class AppModule {}
+
 // Or on specific controllers
 @Controller('/users')
 @UseFilters(ValidationFilter)
 export class UserController extends BaseController {}
 ```
 
+**Note**: When registering multiple filters via `APP_FILTER`, they execute in reverse order (last registered runs first), allowing more specific filters to handle exceptions before general ones.
+
 ### Interceptors
 
 Add cross-cutting concerns with interceptors:
@@ -240,22 +258,251 @@ export class LoggingInterceptor implements Interceptor {
     const start = Date.now()
     const result = await next.handle()
     const duration = Date.now() - start
-    
+
     console.log(`${context.getClass().name}.${context.getHandler().name} - ${duration}ms`)
     return result
   }
 }
 
-// Apply globally
+// Apply globally via app
 app.useGlobalInterceptors(new LoggingInterceptor())
 
+// Or register via module providers (supports multiple interceptors)
+@Module({
+  providers: [
+    {
+      provide: APP_INTERCEPTOR,
+      useClass: LoggingInterceptor
+    },
+    {
+      provide: APP_INTERCEPTOR,
+      useClass: TransformInterceptor
+    }
+  ]
+})
+export class AppModule {}
+
 // Or on specific controllers
 @Controller('/users')
 @UseInterceptors(LoggingInterceptor)
 export class UserController extends BaseController {}
 ```
 
-## <� Parameter Decorators
+**Note**: Multiple `APP_INTERCEPTOR` and `APP_PIPE` providers are supported and execute in reverse registration order (last registered runs first).
+
+### Guards
+
+Guards determine whether a request should be handled by the route handler. They're commonly used for authentication and authorization:
+
+```typescript
+import { CanActivate, ExecutionContext, UseGuards } from '@lerianstudio/sindarian-server'
+import { injectable } from 'inversify'
+
+@injectable()
+export class AuthGuard implements CanActivate {
+  async canActivate(context: ExecutionContext): Promise<boolean> {
+    const request = context.switchToHttp().getRequest()
+    const token = request.headers.get('authorization')
+
+    if (!token) {
+      return false // Will throw ForbiddenApiException
+    }
+
+    // Validate token...
+    return true
+  }
+}
+
+// Apply to controller
+@Controller('/admin')
+@UseGuards(AuthGuard)
+export class AdminController extends BaseController {
+  @Get()
+  async dashboard() {
+    return { message: 'Welcome to admin' }
+  }
+}
+
+// Or apply to specific methods
+@Controller('/users')
+export class UserController extends BaseController {
+  @Get()
+  async findAll() {
+    return { users: [] } // Public route
+  }
+
+  @Delete(':id')
+  @UseGuards(AuthGuard)
+  async remove(@Param('id') id: string) {
+    return { deleted: id } // Protected route
+  }
+}
+```
+
+Register global guards via module providers:
+
+```typescript
+@Module({
+  providers: [
+    {
+      provide: APP_GUARD,
+      useClass: AuthGuard
+    }
+  ]
+})
+export class AppModule {}
+
+// Or globally via app
+app.useGlobalGuards(new AuthGuard())
+```
+
+**Note**: Guards execute before interceptors and pipes. If a guard returns `false`, a `ForbiddenApiException` is thrown.
+
+### Pipes
+
+Transform and validate input data with pipes:
+
+```typescript
+import { PipeTransform, ArgumentMetadata, UsePipes } from '@lerianstudio/sindarian-server'
+
+@injectable()
+export class ParseIntPipe implements PipeTransform {
+  transform(value: any, metadata: ArgumentMetadata): number {
+    const val = parseInt(value, 10)
+    if (isNaN(val)) {
+      throw new Error('Validation failed: not a number')
+    }
+    return val
+  }
+}
+
+// Apply to controller or method
+@Controller('/items')
+@UsePipes(ParseIntPipe)
+export class ItemController extends BaseController {
+  @Get(':id')
+  async findOne(@Param('id') id: number) {
+    return this.itemService.findById(id)
+  }
+}
+```
+
+Register global pipes via module providers:
+
+```typescript
+@Module({
+  providers: [
+    {
+      provide: APP_PIPE,
+      useClass: ValidationPipe
+    }
+  ]
+})
+export class AppModule {}
+```
+
+### Validation with Zod
+
+Built-in Zod integration for schema validation:
+
+```typescript
+import { createZodDto, ZodValidationPipe, UsePipes } from '@lerianstudio/sindarian-server'
+import { z } from 'zod'
+
+// Define your schema
+const CreateUserSchema = z.object({
+  name: z.string().min(2),
+  email: z.string().email(),
+  age: z.number().min(18).optional()
+})
+
+// Create a DTO class from the schema
+const CreateUserDto = createZodDto(CreateUserSchema)
+
+// Use in your controller with the validation pipe
+@Controller('/users')
+@UsePipes(ZodValidationPipe)
+export class UserController extends BaseController {
+  @Post()
+  async create(@Body() userData: typeof CreateUserDto) {
+    // userData is validated and typed
+    return this.userService.create(userData)
+  }
+}
+```
+
+The `ZodValidationPipe` automatically validates incoming data against Zod schemas and throws a `ValidationApiException` on validation errors.
+
+### Logger Service
+
+Use the built-in logger for consistent application logging:
+
+```typescript
+import { ConsoleLogger, LoggerService } from '@lerianstudio/sindarian-server'
+
+// Use the default ConsoleLogger
+const logger = new ConsoleLogger({ prefix: 'MyApp' })
+logger.log('Application started')
+logger.error('Something went wrong')
+logger.warn('This is a warning')
+logger.debug('Debug information')
+
+// Or inject as a service
+@injectable()
+export class MyService {
+  constructor(private logger: ConsoleLogger) {}
+
+  doSomething() {
+    this.logger.log('Doing something...')
+  }
+}
+```
+
+Available log levels: `verbose`, `debug`, `log`, `warn`, `error`, `fatal`
+
+### HttpService
+
+Abstract base class for building API client services with built-in error handling:
+
+```typescript
+import { HttpService, FetchModuleOptions } from '@lerianstudio/sindarian-server'
+import { injectable } from 'inversify'
+
+@injectable()
+export class MyApiService extends HttpService {
+  protected async createDefaults(): Promise<FetchModuleOptions> {
+    return {
+      baseUrl: 'https://api.example.com',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${this.getToken()}`
+      }
+    }
+  }
+
+  async getUsers() {
+    return this.get<User[]>('/users')
+  }
+
+  async createUser(data: CreateUserDto) {
+    return this.post<User>('/users', {
+      body: JSON.stringify(data)
+    })
+  }
+
+  async uploadFile(data: { file: File; name: string }) {
+    return this.postFormData<UploadResponse>('/upload', data)
+  }
+}
+```
+
+The `HttpService` provides:
+- HTTP methods: `get`, `post`, `put`, `patch`, `delete`, `head`
+- FormData support: `postFormData`, `patchFormData`
+- Automatic error handling with typed exceptions
+- Lifecycle hooks: `onBeforeFetch`, `onAfterFetch`, `catch`
+
+## <� Parameter Decorators
 
 Extract data from requests with decorators:
 
@@ -333,7 +580,7 @@ export class AuthService {
 }
 ```
 
-## =� Documentation
+## =� Documentation
 
 - **[Technical Guide](./TECHNICAL.md)** - Deep dive into the framework's architecture and implementation details
 - **[API Reference](./docs/api.md)** - Complete API documentation
@@ -343,7 +590,7 @@ export class AuthService {
 
 Contributions are welcome! Please read our [Contributing Guide](./CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
 
-## =� License
+## =� License
 
 This project is licensed under the ISC License - see the [LICENSE](./LICENSE) file for details.
 
@@ -353,10 +600,10 @@ This project is licensed under the ISC License - see the [LICENSE](./LICENSE) fi
 - Built on [Inversify](https://inversify.io/) - A powerful IoC container for TypeScript
 - Designed for [Next.js](https://nextjs.org/) - The React framework for production
 
-## =� What's Next?
+## =� What's Next?
 
-- [ ] Validation pipes with Zod integration
-- [ ] Built-in authentication guards
+- [x] Validation pipes with Zod integration
+- [x] Guards system for authentication/authorization
 - [ ] WebSocket support
 - [ ] GraphQL integration
 - [ ] CLI tools for scaffolding
@@ -364,4 +611,4 @@ This project is licensed under the ISC License - see the [LICENSE](./LICENSE) fi
 
 ---
 
-**Sindarian Server** - Building the future of Next.js APIs, one decorator at a time. =�
+**Sindarian Server** - Building the future of Next.js APIs, one decorator at a time. =�

package/dist/constants/keys.d.ts

@@ -1,9 +1,12 @@
 export declare const INJECTABLE_KEY: unique symbol;
+export declare const CLASS_NAME_KEY: unique symbol;
 export declare const MODULE_KEY: unique symbol;
 export declare const CONTROLLER_KEY: unique symbol;
 export declare const CATCH_KEY: unique symbol;
 export declare const FILTER_KEY: unique symbol;
 export declare const INTERCEPTOR_KEY: unique symbol;
+export declare const PIPE_KEY: unique symbol;
+export declare const GUARD_KEY: unique symbol;
 export declare const ROUTE_KEY: unique symbol;
 export declare const GET_KEY: unique symbol;
 export declare const POST_KEY: unique symbol;

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

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/constants/keys.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,eAAuB,CAAA;AAElD,eAAO,MAAM,UAAU,eAAmB,CAAA;AAC1C,eAAO,MAAM,cAAc,eAAuB,CAAA;AAClD,eAAO,MAAM,SAAS,eAAkB,CAAA;AACxC,eAAO,MAAM,UAAU,eAAmB,CAAA;AAC1C,eAAO,MAAM,eAAe,eAAwB,CAAA;AAEpD,eAAO,MAAM,SAAS,eAAkB,CAAA;AACxC,eAAO,MAAM,OAAO,eAAgB,CAAA;AACpC,eAAO,MAAM,QAAQ,eAAiB,CAAA;AACtC,eAAO,MAAM,OAAO,eAAgB,CAAA;AACpC,eAAO,MAAM,SAAS,eAAkB,CAAA;AACxC,eAAO,MAAM,UAAU,eAAmB,CAAA;AAE1C,eAAO,MAAM,QAAQ,eAAiB,CAAA;AACtC,eAAO,MAAM,WAAW,eAAoB,CAAA;AAC5C,eAAO,MAAM,SAAS,eAAkB,CAAA;AACxC,eAAO,MAAM,SAAS,eAAkB,CAAA;AAExC,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAC7C,eAAO,MAAM,eAAe,eAAe,CAAA;AAC3C,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AACjD,eAAO,MAAM,oBAAoB,oBAAoB,CAAA"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/constants/keys.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,eAAuB,CAAA;AAClD,eAAO,MAAM,cAAc,eAAuB,CAAA;AAElD,eAAO,MAAM,UAAU,eAAmB,CAAA;AAC1C,eAAO,MAAM,cAAc,eAAuB,CAAA;AAClD,eAAO,MAAM,SAAS,eAAkB,CAAA;AACxC,eAAO,MAAM,UAAU,eAAmB,CAAA;AAC1C,eAAO,MAAM,eAAe,eAAwB,CAAA;AACpD,eAAO,MAAM,QAAQ,eAAiB,CAAA;AACtC,eAAO,MAAM,SAAS,eAAkB,CAAA;AAExC,eAAO,MAAM,SAAS,eAAkB,CAAA;AACxC,eAAO,MAAM,OAAO,eAAgB,CAAA;AACpC,eAAO,MAAM,QAAQ,eAAiB,CAAA;AACtC,eAAO,MAAM,OAAO,eAAgB,CAAA;AACpC,eAAO,MAAM,SAAS,eAAkB,CAAA;AACxC,eAAO,MAAM,UAAU,eAAmB,CAAA;AAE1C,eAAO,MAAM,QAAQ,eAAiB,CAAA;AACtC,eAAO,MAAM,WAAW,eAAoB,CAAA;AAC5C,eAAO,MAAM,SAAS,eAAkB,CAAA;AACxC,eAAO,MAAM,SAAS,eAAkB,CAAA;AAExC,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAC7C,eAAO,MAAM,eAAe,eAAe,CAAA;AAC3C,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AACjD,eAAO,MAAM,oBAAoB,oBAAoB,CAAA"}

package/dist/constants/keys.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTROLLERS_PROPERTY = exports.PROVIDERS_PROPERTY = exports.MODULE_PROPERTY = exports.IMPORTS_PROPERTY = exports.QUERY_KEY = exports.PARAM_KEY = exports.REQUEST_KEY = exports.BODY_KEY = exports.DELETE_KEY = exports.PATCH_KEY = exports.PUT_KEY = exports.POST_KEY = exports.GET_KEY = exports.ROUTE_KEY = exports.INTERCEPTOR_KEY = exports.FILTER_KEY = exports.CATCH_KEY = exports.CONTROLLER_KEY = exports.MODULE_KEY = exports.INJECTABLE_KEY = void 0;
+exports.CONTROLLERS_PROPERTY = exports.PROVIDERS_PROPERTY = exports.MODULE_PROPERTY = exports.IMPORTS_PROPERTY = exports.QUERY_KEY = exports.PARAM_KEY = exports.REQUEST_KEY = exports.BODY_KEY = exports.DELETE_KEY = exports.PATCH_KEY = exports.PUT_KEY = exports.POST_KEY = exports.GET_KEY = exports.ROUTE_KEY = exports.GUARD_KEY = exports.PIPE_KEY = exports.INTERCEPTOR_KEY = exports.FILTER_KEY = exports.CATCH_KEY = exports.CONTROLLER_KEY = exports.MODULE_KEY = exports.CLASS_NAME_KEY = exports.INJECTABLE_KEY = void 0;
 exports.INJECTABLE_KEY = Symbol('injectable');
+exports.CLASS_NAME_KEY = Symbol('class_name');
 exports.MODULE_KEY = Symbol('module');
 exports.CONTROLLER_KEY = Symbol('controller');
 exports.CATCH_KEY = Symbol('catch');
 exports.FILTER_KEY = Symbol('filter');
 exports.INTERCEPTOR_KEY = Symbol('interceptor');
+exports.PIPE_KEY = Symbol('pipe');
+exports.GUARD_KEY = Symbol('guard');
 exports.ROUTE_KEY = Symbol('route');
 exports.GET_KEY = Symbol('get');
 exports.POST_KEY = Symbol('post');

package/dist/constants/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/constants/keys.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;AAErC,QAAA,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AAC7B,QAAA,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;AACrC,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAC3B,QAAA,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AAC7B,QAAA,eAAe,GAAG,MAAM,CAAC,aAAa,CAAC,CAAA;AAEvC,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAC3B,QAAA,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;AACvB,QAAA,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;AACzB,QAAA,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;AACvB,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAC3B,QAAA,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AAE7B,QAAA,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;AACzB,QAAA,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;AAC/B,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAC3B,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAE3B,QAAA,gBAAgB,GAAG,aAAa,CAAA;AAChC,QAAA,eAAe,GAAG,YAAY,CAAA;AAC9B,QAAA,kBAAkB,GAAG,eAAe,CAAA;AACpC,QAAA,oBAAoB,GAAG,iBAAiB,CAAA"}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/constants/keys.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;AACrC,QAAA,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;AAErC,QAAA,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AAC7B,QAAA,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;AACrC,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAC3B,QAAA,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AAC7B,QAAA,eAAe,GAAG,MAAM,CAAC,aAAa,CAAC,CAAA;AACvC,QAAA,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;AACzB,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAE3B,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAC3B,QAAA,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;AACvB,QAAA,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;AACzB,QAAA,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;AACvB,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAC3B,QAAA,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AAE7B,QAAA,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;AACzB,QAAA,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;AAC/B,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAC3B,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;AAE3B,QAAA,gBAAgB,GAAG,aAAa,CAAA;AAChC,QAAA,eAAe,GAAG,YAAY,CAAA;AAC9B,QAAA,kBAAkB,GAAG,eAAe,CAAA;AACpC,QAAA,oBAAoB,GAAG,iBAAiB,CAAA"}

package/dist/controllers/decorators/body-decorator.d.ts

@@ -1,24 +1,20 @@
 export type BodyMetadata = {
-    propertyIndex: number;
-    schema?: () => any;
-};
-/**
- * Handler to validate the body of the request.
- *
- * @param target - The target object.
- * @param propertyKey - The property key.
- * @param args - The arguments.
- * @returns The parameter and parameter index.
- */
-export declare function bodyDecoratorHandler(target: object, propertyKey: string | symbol, args: any[]): Promise<{
-    parameter: any;
     parameterIndex: number;
-} | null>;
+};
+export declare class BodyHandler {
+    private static bodyCache;
+    static getMetadata(target: object, propertyKey: string | symbol): BodyMetadata | undefined;
+    static handle(target: object, propertyKey: string | symbol, args: any[]): Promise<{
+        type: string;
+        parameter: any;
+        parameterIndex: number;
+        paramType: any;
+    } | null>;
+}
 /**
  * Decorator to validate the body of the request.
  *
- * @param schema - The Zod schema to validate the body against.
  * @returns A decorator function that can be used to decorate a controller method.
  */
-export declare function Body(schema?: any): (target: object, propertyKey: string | symbol, propertyIndex: number) => void;
+export declare function Body(): (target: object, propertyKey: string | symbol, propertyIndex: number) => void;
 //# sourceMappingURL=body-decorator.d.ts.map

package/dist/controllers/decorators/body-decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"body-decorator.d.ts","sourceRoot":"","sources":["../../../src/controllers/decorators/body-decorator.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,CAAA;CACnB,CAAA;AAKD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,IAAI,EAAE,GAAG,EAAE;;;UA6DZ;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,IAE7B,QAAQ,MAAM,EACd,aAAa,MAAM,GAAG,MAAM,EAC5B,eAAe,MAAM,UAQxB"}
+{"version":3,"file":"body-decorator.d.ts","sourceRoot":"","sources":["../../../src/controllers/decorators/body-decorator.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG;IACzB,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,qBAAa,WAAW;IAEtB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAkC;IAE1D,MAAM,CAAC,WAAW,CAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,YAAY,GAAG,SAAS;WAmBd,MAAM,CACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,IAAI,EAAE,GAAG,EAAE;;;;;;CAqDd;AAED;;;;GAIG;AACH,wBAAgB,IAAI,KAEhB,QAAQ,MAAM,EACd,aAAa,MAAM,GAAG,MAAM,EAC5B,eAAe,MAAM,UAWxB"}

package/dist/controllers/decorators/body-decorator.js

@@ -1,83 +1,77 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bodyDecoratorHandler = bodyDecoratorHandler;
+exports.BodyHandler = void 0;
 exports.Body = Body;
 const keys_1 = require("../../constants/keys");
 const get_next_arguments_1 = require("../../utils/nextjs/get-next-arguments");
 const api_exception_1 = require("../../exceptions/api-exception");
 const get_form_data_1 = require("../../utils/form-data/get-form-data");
-// Cache to store parsed body to avoid reading it multiple times
-const bodyCache = new WeakMap();
-/**
- * Handler to validate the body of the request.
- *
- * @param target - The target object.
- * @param propertyKey - The property key.
- * @param args - The arguments.
- * @returns The parameter and parameter index.
- */
-async function bodyDecoratorHandler(target, propertyKey, args) {
-    const metadata = Reflect.getOwnMetadata(keys_1.BODY_KEY, target, propertyKey);
-    // If the metadata is not found, return null.
-    if (metadata) {
-        const request = (0, get_next_arguments_1.getNextRequestArgument)(args);
-        // Check if body is already cached
-        let body = bodyCache.get(request);
-        if (!body) {
-            const contentType = request.headers.get('Content-Type');
-            try {
-                if (contentType?.includes('multipart/form-data')) {
-                    body = (0, get_form_data_1.getFormData)(await request.formData());
-                }
-                else if (contentType?.includes('application/json')) {
-                    body = await request.json();
+class BodyHandler {
+    static getMetadata(target, propertyKey) {
+        let metadata = Reflect.getOwnMetadata(keys_1.BODY_KEY, target, propertyKey);
+        // If not found on instance, try constructor prototype
+        if (!metadata && target.constructor) {
+            metadata = Reflect.getOwnMetadata(keys_1.BODY_KEY, target.constructor.prototype, propertyKey);
+        }
+        return metadata;
+    }
+    static async handle(target, propertyKey, args) {
+        const metadata = this.getMetadata(target, propertyKey);
+        // If the metadata is not found, return null.
+        if (metadata) {
+            // Get the route metadata to access paramTypes (check both target and prototype)
+            let routeMetadata = Reflect.getOwnMetadata(keys_1.ROUTE_KEY, target, propertyKey);
+            if (!routeMetadata && target.constructor) {
+                routeMetadata = Reflect.getOwnMetadata(keys_1.ROUTE_KEY, target.constructor.prototype, propertyKey);
+            }
+            const paramTypes = routeMetadata?.paramTypes || [];
+            const request = (0, get_next_arguments_1.getNextRequestArgument)(args);
+            // Check if body is already cached
+            let body = this.bodyCache.get(request);
+            if (!body) {
+                const contentType = request.headers.get('Content-Type');
+                try {
+                    if (contentType?.includes('multipart/form-data')) {
+                        body = (0, get_form_data_1.getFormData)(await request.formData());
+                    }
+                    else if (contentType?.includes('application/json')) {
+                        body = await request.json();
+                    }
+                    else {
+                        body = await request.text();
+                    }
+                    // Cache the parsed body
+                    this.bodyCache.set(request, body);
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
                 }
-                else {
-                    body = await request.text();
+                catch (error) {
+                    // Handle missing or invalid body
+                    throw new api_exception_1.ValidationApiException('Missing or invalid request body');
                 }
-                // Cache the parsed body
-                bodyCache.set(request, body);
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            }
-            catch (error) {
-                // Handle missing or invalid body
-                throw new api_exception_1.ValidationApiException('Missing or invalid request body');
             }
-        }
-        // If the schema is not provided, return the body.
-        if (!metadata.schema) {
             return {
+                type: 'body',
                 parameter: body,
-                parameterIndex: metadata.propertyIndex
+                parameterIndex: metadata.parameterIndex,
+                paramType: paramTypes[metadata.parameterIndex]
             };
         }
-        // Parse the body using the schema.
-        const resolvedSchema = metadata.schema?.();
-        const parsedBody = resolvedSchema?.safeParse(body);
-        // If the body is not valid, throw a validation error.
-        if (parsedBody && !parsedBody.success) {
-            throw new api_exception_1.ValidationApiException(`Invalid body: ${JSON.stringify(parsedBody.error.flatten().fieldErrors)}`);
-        }
-        return {
-            parameter: body,
-            parameterIndex: metadata.propertyIndex
-        };
+        return null;
     }
-    return null;
 }
+exports.BodyHandler = BodyHandler;
+// Cache to store parsed body to avoid reading it multiple times
+BodyHandler.bodyCache = new WeakMap();
 /**
  * Decorator to validate the body of the request.
  *
- * @param schema - The Zod schema to validate the body against.
  * @returns A decorator function that can be used to decorate a controller method.
  */
-function Body(schema) {
+function Body() {
     return function (target, propertyKey, propertyIndex) {
-        const metadata = {
-            propertyIndex,
-            schema: schema ? () => schema : undefined
-        };
-        Reflect.defineMetadata(keys_1.BODY_KEY, metadata, target, propertyKey);
+        Reflect.defineMetadata(keys_1.BODY_KEY, {
+            parameterIndex: propertyIndex
+        }, target, propertyKey);
     };
 }
 //# sourceMappingURL=body-decorator.js.map

package/dist/controllers/decorators/body-decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"body-decorator.js","sourceRoot":"","sources":["../../../src/controllers/decorators/body-decorator.ts"],"names":[],"mappings":";;AAsBA,oDAgEC;AAQD,oBAYC;AA1GD,2CAA2C;AAC3C,0EAA0E;AAC1E,8DAAmE;AAEnE,mEAA6D;AAO7D,gEAAgE;AAChE,MAAM,SAAS,GAAG,IAAI,OAAO,EAAoB,CAAA;AAEjD;;;;;;;GAOG;AACI,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,WAA4B,EAC5B,IAAW;IAEX,MAAM,QAAQ,GAAiB,OAAO,CAAC,cAAc,CACnD,eAAQ,EACR,MAAM,EACN,WAAW,CACZ,CAAA;IAED,6CAA6C;IAC7C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,OAAO,GAAgB,IAAA,2CAAsB,EAAC,IAAI,CAAC,CAAA;QAEzD,kCAAkC;QAClC,IAAI,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAEjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;YACvD,IAAI,CAAC;gBACH,IAAI,WAAW,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;oBACjD,IAAI,GAAG,IAAA,2BAAW,EAAC,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;gBAC9C,CAAC;qBAAM,IAAI,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBACrD,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;gBAC7B,CAAC;qBAAM,CAAC;oBACN,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;gBAC7B,CAAC;gBAED,wBAAwB;gBACxB,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;gBAC5B,6DAA6D;YAC/D,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,iCAAiC;gBACjC,MAAM,IAAI,sCAAsB,CAAC,iCAAiC,CAAC,CAAA;YACrE,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,cAAc,EAAE,QAAQ,CAAC,aAAa;aACvC,CAAA;QACH,CAAC;QAED,mCAAmC;QACnC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAA;QAC1C,MAAM,UAAU,GAAG,cAAc,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;QAElD,sDAAsD;QACtD,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,IAAI,sCAAsB,CAC9B,iBAAiB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAC1E,CAAA;QACH,CAAC;QAED,OAAO;YACL,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,QAAQ,CAAC,aAAa;SACvC,CAAA;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,IAAI,CAAC,MAAY;IAC/B,OAAO,UACL,MAAc,EACd,WAA4B,EAC5B,aAAqB;QAErB,MAAM,QAAQ,GAAiB;YAC7B,aAAa;YACb,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC1C,CAAA;QACD,OAAO,CAAC,cAAc,CAAC,eAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;IACjE,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"body-decorator.js","sourceRoot":"","sources":["../../../src/controllers/decorators/body-decorator.ts"],"names":[],"mappings":"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"}

package/dist/controllers/decorators/controller-decorator.d.ts

@@ -1,10 +1,11 @@
-import { HttpMethods } from '../../constants/http-methods';
+import { RouteMetadata } from './route-decorator';
 export type ControllerMetadata = {
-    methodName: string;
-    method: HttpMethods;
     path: string;
 };
-export declare function controllerHandler(target: Function): ControllerMetadata[];
+export declare class ControllerHandler {
+    static getMetadata(target: object): ControllerMetadata | undefined;
+    static getRoutes(target: Function): RouteMetadata[];
+}
 /**
  * A class decorator that wraps all methods in the class with error handling.
  *

package/dist/controllers/decorators/controller-decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller-decorator.d.ts","sourceRoot":"","sources":["../../../src/controllers/decorators/controller-decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAOtD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,WAAW,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,wBA+BjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAIvD"}
+{"version":3,"file":"controller-decorator.d.ts","sourceRoot":"","sources":["../../../src/controllers/decorators/controller-decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAK/D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIlE,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,aAAa,EAAE;CAiCpD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAIvD"}