wynkjs 1.0.3 → 1.0.6

package/dist/decorators/exception.decorators.js

@@ -13,7 +13,7 @@ import "reflect-metadata";
  * export class HttpWynkExceptionFilter implements WynkExceptionFilter {}
  *
  * @Catch() // Catches all exceptions
- * export class AllExceptionsFilter implements WynkExceptionFilter {}
+ * export class AllExceptions implements WynkExceptionFilter {}
  */
 export function Catch(...exceptions) {
     return (target) => {
@@ -63,6 +63,9 @@ export class HttpException extends Error {
         this.error = error;
         this.name = "HttpException";
     }
+    get status() {
+        return this.statusCode;
+    }
     getStatus() {
         return this.statusCode;
     }
@@ -179,13 +182,27 @@ export async function executeExceptionFilters(filters, exception, context) {
         // Check if filter handles this exception type
         const catchTypes = Reflect.getMetadata("catch:exceptions", filterInstance.constructor);
         if (!catchTypes || catchTypes.length === 0) {
-            // Catches all exceptions
-            return filterInstance.catch(exception, context);
+            // Catches all exceptions - try it
+            try {
+                return await filterInstance.catch(exception, context);
+            }
+            catch (err) {
+                // Filter didn't handle it, try next filter
+                exception = err;
+                continue;
+            }
         }
         // Check if exception matches any of the catch types
         for (const catchType of catchTypes) {
             if (exception instanceof catchType) {
-                return filterInstance.catch(exception, context);
+                try {
+                    return await filterInstance.catch(exception, context);
+                }
+                catch (err) {
+                    // Filter didn't handle it, try next filter
+                    exception = err;
+                    continue;
+                }
             }
         }
     }
@@ -216,7 +233,7 @@ export { HttpWynkExceptionFilter };
 /**
  * All exceptions filter - catches everything
  */
-let AllExceptionsFilter = class AllExceptionsFilter {
+let AllExceptions = class AllExceptions {
     catch(exception, context) {
         const response = context.getResponse();
         if (exception instanceof HttpException) {
@@ -236,7 +253,122 @@ let AllExceptionsFilter = class AllExceptionsFilter {
         };
     }
 };
-AllExceptionsFilter = __decorate([
+AllExceptions = __decorate([
     Catch()
-], AllExceptionsFilter);
-export { AllExceptionsFilter };
+], AllExceptions);
+export { AllExceptions };
+/**
+ * Authentication Exception Filter - Handles auth errors
+ *
+ * ⚠️ IMPORTANT: This catches ALL UnauthorizedException instances!
+ * Use on specific routes/controllers, not globally.
+ *
+ * @example
+ * // ✅ GOOD: Use on auth-protected controller
+ * @UseFilters(AuthenticationExceptionFilter)
+ * @Controller('/auth')
+ * export class AuthController {
+ *   @Post('/login')
+ *   async login() {
+ *     throw new UnauthorizedException('Invalid credentials');
+ *   }
+ * }
+ */
+export class AuthenticationException {
+    catch(exception, context) {
+        const response = context.getResponse();
+        const request = context.getRequest();
+        return {
+            statusCode: exception.statusCode,
+            error: "Authentication Failed",
+            message: exception.message || "Invalid credentials",
+            timestamp: new Date().toISOString(),
+            path: request.url,
+            hint: "Please check your authentication token or credentials",
+        };
+    }
+}
+/**
+ * Authorization Exception Filter - Handles permission errors
+ *
+ * ⚠️ IMPORTANT: This catches ALL ForbiddenException instances!
+ * Use on specific routes/controllers, not globally.
+ *
+ * @example
+ * // ✅ GOOD: Use on admin-only controller
+ * @UseFilters(AuthorizationExceptionFilter)
+ * @Controller('/admin')
+ * export class AdminController {
+ *   @Get('/users')
+ *   async getAllUsers() {
+ *     throw new ForbiddenException('Admin access required');
+ *   }
+ * }
+ */
+export class AuthorizationException {
+    catch(exception, context) {
+        const response = context.getResponse();
+        const request = context.getRequest();
+        return {
+            statusCode: exception.statusCode,
+            error: "Authorization Failed",
+            message: exception.message ||
+                "You don't have permission to access this resource",
+            timestamp: new Date().toISOString(),
+            path: request.url,
+            requiredPermissions: exception.requiredPermissions || [],
+        };
+    }
+}
+/**
+ * Rate Limit Exception Filter - Handles rate limit errors
+ * @example
+ * @UseFilters(RateLimitExceptionFilter)
+ * @Post()
+ * async create() {}
+ */
+export class RateLimitException {
+    catch(exception, context) {
+        const response = context.getResponse();
+        const request = context.getRequest();
+        // Don't catch HttpException or its subclasses
+        if (exception instanceof HttpException) {
+            throw exception;
+        }
+        return {
+            statusCode: 429,
+            error: "Too Many Requests",
+            message: exception.message || "Rate limit exceeded",
+            timestamp: new Date().toISOString(),
+            path: request.url,
+            retryAfter: exception.retryAfter || 60,
+            hint: "Please wait before making another request",
+        };
+    }
+}
+/**
+ * Business Logic Exception Filter - Handles business rule violations
+ * @example
+ * @UseFilters(BusinessLogicExceptionFilter)
+ * @Post('/transfer')
+ * async transfer(@Body() data: any) {}
+ */
+export class BusinessLogicException {
+    catch(exception, context) {
+        const response = context.getResponse();
+        const request = context.getRequest();
+        // Don't catch HttpException or its subclasses
+        if (exception instanceof HttpException) {
+            throw exception;
+        }
+        return {
+            statusCode: exception.statusCode || 422,
+            error: "Business Rule Violation",
+            message: exception.message || "Business logic constraint violated",
+            timestamp: new Date().toISOString(),
+            path: request.url,
+            rule: exception.rule || "unknown",
+            details: exception.details || {},
+        };
+    }
+}

package/dist/decorators/formatter.decorators.d.ts

@@ -0,0 +1,93 @@
+import "reflect-metadata";
+/**
+ * Error Formatter Interface
+ * Used by WynkFactory to format validation errors
+ *
+ * IMPORTANT: These formatters are passed to WynkFactory.create(), NOT to useGlobalFilters()!
+ *
+ * @example
+ * // CORRECT usage:
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ *   validationErrorFormatter: new FormatErrorFormatter(), // ✅ Pass here
+ * });
+ *
+ * // WRONG usage:
+ * app.useGlobalFilters(
+ *   new FormatErrorFormatter() // ❌ This is not a filter!
+ * );
+ */
+export interface ErrorFormatter {
+    format(validationError: any): any;
+}
+/**
+ * FormatErrorFormatter - Formats as { field: [messages] } object structure
+ *
+ * Output example:
+ * {
+ *   "statusCode": 400,
+ *   "message": "Validation failed",
+ *   "errors": {
+ *     "email": ["Invalid email address"],
+ *     "age": ["Must be at least 18"]
+ *   }
+ * }
+ *
+ * @example
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ *   validationErrorFormatter: new FormatErrorFormatter(),
+ * });
+ */
+export declare class FormatErrorFormatter implements ErrorFormatter {
+    format(error: any): any;
+}
+/**
+ * SimpleErrorFormatter - Formats as simple array of messages
+ *
+ * Output example:
+ * {
+ *   "statusCode": 400,
+ *   "message": "Validation failed",
+ *   "errors": [
+ *     "Invalid email address",
+ *     "Must be at least 18"
+ *   ]
+ * }
+ *
+ * @example
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ *   validationErrorFormatter: new SimpleErrorFormatter(),
+ * });
+ */
+export declare class SimpleErrorFormatter implements ErrorFormatter {
+    format(error: any): any;
+}
+/**
+ * DetailedErrorFormatter - Formats with detailed field info
+ *
+ * Output example:
+ * {
+ *   "statusCode": 400,
+ *   "message": "Validation failed",
+ *   "errors": [
+ *     {
+ *       "field": "email",
+ *       "message": "Invalid email address",
+ *       "value": "invalid-email",
+ *       "expected": {...schema...}
+ *     }
+ *   ]
+ * }
+ *
+ * @example
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ *   validationErrorFormatter: new DetailedErrorFormatter(),
+ * });
+ */
+export declare class DetailedErrorFormatter implements ErrorFormatter {
+    format(error: any): any;
+}
+//# sourceMappingURL=formatter.decorators.d.ts.map

package/dist/decorators/formatter.decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.decorators.d.ts","sourceRoot":"","sources":["../../core/decorators/formatter.decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,eAAe,EAAE,GAAG,GAAG,GAAG,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;CAsBxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;CAiBxB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;CAgCxB"}

package/dist/decorators/formatter.decorators.js

@@ -0,0 +1,131 @@
+import "reflect-metadata";
+/**
+ * FormatErrorFormatter - Formats as { field: [messages] } object structure
+ *
+ * Output example:
+ * {
+ *   "statusCode": 400,
+ *   "message": "Validation failed",
+ *   "errors": {
+ *     "email": ["Invalid email address"],
+ *     "age": ["Must be at least 18"]
+ *   }
+ * }
+ *
+ * @example
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ *   validationErrorFormatter: new FormatErrorFormatter(),
+ * });
+ */
+export class FormatErrorFormatter {
+    format(error) {
+        const formattedErrors = {};
+        if (error.errors && error.errors.length > 0) {
+            error.errors.forEach((err) => {
+                const field = err.path?.replace(/^\//, "") || "unknown";
+                if (!formattedErrors[field]) {
+                    formattedErrors[field] = [];
+                }
+                formattedErrors[field].push(err.summary || err.message);
+            });
+        }
+        else {
+            const field = error.property?.replace(/^\//, "") || "unknown";
+            formattedErrors[field] = [error.summary || error.message];
+        }
+        return {
+            statusCode: 400,
+            message: "Validation failed",
+            errors: formattedErrors,
+        };
+    }
+}
+/**
+ * SimpleErrorFormatter - Formats as simple array of messages
+ *
+ * Output example:
+ * {
+ *   "statusCode": 400,
+ *   "message": "Validation failed",
+ *   "errors": [
+ *     "Invalid email address",
+ *     "Must be at least 18"
+ *   ]
+ * }
+ *
+ * @example
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ *   validationErrorFormatter: new SimpleErrorFormatter(),
+ * });
+ */
+export class SimpleErrorFormatter {
+    format(error) {
+        const messages = [];
+        if (error.errors && error.errors.length > 0) {
+            error.errors.forEach((err) => {
+                messages.push(err.summary || err.message);
+            });
+        }
+        else {
+            messages.push(error.summary || error.message);
+        }
+        return {
+            statusCode: 400,
+            message: "Validation failed",
+            errors: messages,
+        };
+    }
+}
+/**
+ * DetailedErrorFormatter - Formats with detailed field info
+ *
+ * Output example:
+ * {
+ *   "statusCode": 400,
+ *   "message": "Validation failed",
+ *   "errors": [
+ *     {
+ *       "field": "email",
+ *       "message": "Invalid email address",
+ *       "value": "invalid-email",
+ *       "expected": {...schema...}
+ *     }
+ *   ]
+ * }
+ *
+ * @example
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ *   validationErrorFormatter: new DetailedErrorFormatter(),
+ * });
+ */
+export class DetailedErrorFormatter {
+    format(error) {
+        const errors = [];
+        if (error.errors && error.errors.length > 0) {
+            error.errors.forEach((err) => {
+                errors.push({
+                    field: err.path?.replace(/^\//, "") || "unknown",
+                    message: err.summary || err.message,
+                    value: err.value,
+                    expected: err.schema,
+                });
+            });
+        }
+        else {
+            errors.push({
+                field: error.property?.replace(/^\//, "") || "unknown",
+                message: error.summary || error.message,
+                value: error.found,
+                expected: error.expected,
+            });
+        }
+        return {
+            statusCode: 400,
+            message: "Validation failed",
+            errors,
+        };
+    }
+}

package/dist/decorators/guard.decorators.d.ts

@@ -1,7 +1,7 @@
 import "reflect-metadata";
 /**
- * Guard Decorators and Interfaces for ElysiaJS Framework
- * Similar to NestJS guards for route protection
+ * Guard Decorators and Interfaces for WynkJS Framework
+ * Guards for route protection and authorization
  */
 /**
  * Execution context interface - provides access to request details

package/dist/decorators/guard.decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guard.decorators.d.ts","sourceRoot":"","sources":["../../core/decorators/guard.decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IACzB,WAAW,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IAC1B,UAAU,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IACzB,UAAU,IAAI,QAAQ,CAAC;IACvB,QAAQ,IAAI,GAAG,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,GAAG,MAAM,EAAE,CAAC,QAAQ,GAAG,WAAW,CAAC,EAAE,GACpC,eAAe,GAAG,cAAc,CAwBlC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,QAAQ,EACjB,eAAe,EAAE,GAAG,GACnB,gBAAgB,CAQlB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,CAAC,QAAQ,GAAG,WAAW,CAAC,EAAE,EAClC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,OAAO,CAAC,CAyBlB"}
+{"version":3,"file":"guard.decorators.d.ts","sourceRoot":"","sources":["../../core/decorators/guard.decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IACzB,WAAW,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IAC1B,UAAU,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IACzB,UAAU,IAAI,QAAQ,CAAC;IACvB,QAAQ,IAAI,GAAG,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,GAAG,MAAM,EAAE,CAAC,QAAQ,GAAG,WAAW,CAAC,EAAE,GACpC,eAAe,GAAG,cAAc,CAwBlC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,QAAQ,EACjB,eAAe,EAAE,GAAG,GACnB,gBAAgB,CAQlB;AAOD;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,CAAC,QAAQ,GAAG,WAAW,CAAC,EAAE,EAClC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,OAAO,CAAC,CA8BlB"}

package/dist/decorators/guard.decorators.js

@@ -39,6 +39,10 @@ export function createExecutionContext(ctx, handler, controllerClass) {
         getClass: () => controllerClass,
     };
 }
+/**
+ * Guard instance cache for singleton pattern
+ */
+const guardInstanceCache = new Map();
 /**
  * Helper function to execute guards
  */
@@ -46,14 +50,16 @@ export async function executeGuards(guards, context) {
     for (const guard of guards) {
         let result;
         if (typeof guard === "function") {
-            // Guard is a class, instantiate it
-            const guardInstance = new guard();
-            if (guardInstance.canActivate) {
-                result = await guardInstance.canActivate(context);
+            // Guard is a class, get or create singleton instance
+            let guardInstance = guardInstanceCache.get(guard);
+            if (!guardInstance) {
+                guardInstance = new guard();
+                guardInstanceCache.set(guard, guardInstance);
             }
-            else {
+            if (!guardInstance.canActivate) {
                 throw new Error(`Guard ${guard.name} must implement CanActivate interface`);
             }
+            result = await guardInstance.canActivate(context);
         }
         else {
             // Guard is already an instance

package/dist/decorators/http.decorators.d.ts

@@ -1,7 +1,8 @@
 import "reflect-metadata";
 /**
- * HTTP Method Decorators for ElysiaJS Framework
- * Inspired by NestJS but optimized for Elysia's performance
+ * HTTP Method Decorators for WynkJS Framework
+ * RESTful route handlers with TypeScript decorators
+ * Optimized for WynkJS's performance on Bun runtime
  */
 export interface RouteOptions {
     path?: string;
@@ -13,12 +14,17 @@ export interface RouteOptions {
 }
 /**
  * Controller decorator - Defines a controller with a base path
- * @param path Base path for all routes in this controller
+ * @param pathOrOptions Base path string or options object with path
  * @example
  * @Controller('/users')
  * export class UserController {}
+ *
+ * @Controller({ path: '/users' })
+ * export class UserController {}
  */
-export declare function Controller(path?: string): ClassDecorator;
+export declare function Controller(pathOrOptions?: string | {
+    path?: string;
+}): ClassDecorator;
 /**
  * HTTP GET decorator
  * @param pathOrOptions Route path or options with DTO

package/dist/decorators/http.decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.decorators.d.ts","sourceRoot":"","sources":["../../core/decorators/http.decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAW,GAAG,cAAc,CAK5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,GAAG,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,GAAG,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM7E;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GACpC,eAAe,CAMjB;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM3E;AAmDD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAStD;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAYnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAAY,GACvB,eAAe,CAcjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,GAAG,cAAc,GAAG,eAAe,CAuB3E"}
+{"version":3,"file":"http.decorators.d.ts","sourceRoot":"","sources":["../../core/decorators/http.decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,aAAa,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,cAAc,CAWhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,GAAG,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,GAAG,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM7E;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GACpC,eAAe,CAMjB;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAM3E;AAmDD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAStD;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAYnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAAY,GACvB,eAAe,CAcjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,GAAG,cAAc,GAAG,eAAe,CAuB3E"}

package/dist/decorators/http.decorators.js

@@ -1,13 +1,20 @@
 import "reflect-metadata";
 /**
  * Controller decorator - Defines a controller with a base path
- * @param path Base path for all routes in this controller
+ * @param pathOrOptions Base path string or options object with path
  * @example
  * @Controller('/users')
  * export class UserController {}
+ *
+ * @Controller({ path: '/users' })
+ * export class UserController {}
  */
-export function Controller(path = "") {
+export function Controller(pathOrOptions) {
     return (target) => {
+        // Handle both string and object formats
+        const path = typeof pathOrOptions === "string"
+            ? pathOrOptions
+            : pathOrOptions?.path || "";
         Reflect.defineMetadata("basePath", path, target);
         Reflect.defineMetadata("routes", [], target);
     };

package/dist/decorators/interceptor.advanced.d.ts

@@ -1,6 +1,6 @@
 import "reflect-metadata";
-import { WynkInterceptor, CallHandler } from "./interceptor.decorators";
-import { ExecutionContext } from "./guard.decorators";
+import { WynkInterceptor } from "./interceptor.decorators";
+import { InterceptorContext } from "../interfaces/interceptor.interface";
 /**
  * Advanced Interceptors for WynkJS Framework
  * Additional interceptors for common use cases
@@ -13,7 +13,7 @@ import { ExecutionContext } from "./guard.decorators";
  * export class ApiController {}
  */
 export declare class ResponseInterceptor implements WynkInterceptor {
-    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+    intercept(context: InterceptorContext, next: () => Promise<any>): Promise<any>;
 }
 /**
  * Error Handling Interceptor - Catches and transforms errors
@@ -23,7 +23,7 @@ export declare class ResponseInterceptor implements WynkInterceptor {
  * async getData() {}
  */
 export declare class ErrorHandlingInterceptor implements WynkInterceptor {
-    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+    intercept(context: InterceptorContext, next: () => Promise<any>): Promise<any>;
 }
 /**
  * Compression Interceptor - Simulates response compression metadata
@@ -35,7 +35,7 @@ export declare class ErrorHandlingInterceptor implements WynkInterceptor {
 export declare class CompressionInterceptor implements WynkInterceptor {
     private threshold;
     constructor(threshold?: number);
-    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+    intercept(context: InterceptorContext, next: () => Promise<any>): Promise<any>;
 }
 /**
  * Rate Limit Interceptor - Basic rate limiting
@@ -49,7 +49,7 @@ export declare class RateLimitInterceptor implements WynkInterceptor {
     private windowMs;
     private requests;
     constructor(maxRequests?: number, windowMs?: number);
-    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+    intercept(context: InterceptorContext, next: () => Promise<any>): Promise<any>;
 }
 /**
  * CORS Interceptor - Add CORS headers to responses
@@ -65,7 +65,7 @@ export declare class CorsInterceptor implements WynkInterceptor {
         methods?: string[];
         credentials?: boolean;
     });
-    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+    intercept(context: InterceptorContext, next: () => Promise<any>): Promise<any>;
 }
 /**
  * Sanitize Interceptor - Sanitizes response data
@@ -77,7 +77,7 @@ export declare class CorsInterceptor implements WynkInterceptor {
 export declare class SanitizeInterceptor implements WynkInterceptor {
     private fieldsToRemove;
     constructor(fieldsToRemove?: string[]);
-    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+    intercept(context: InterceptorContext, next: () => Promise<any>): Promise<any>;
     private sanitize;
 }
 /**
@@ -88,6 +88,6 @@ export declare class SanitizeInterceptor implements WynkInterceptor {
  * async getUsers(@Query('page') page: number, @Query('limit') limit: number) {}
  */
 export declare class PaginationInterceptor implements WynkInterceptor {
-    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+    intercept(context: InterceptorContext, next: () => Promise<any>): Promise<any>;
 }
 //# sourceMappingURL=interceptor.advanced.d.ts.map

package/dist/decorators/interceptor.advanced.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.advanced.d.ts","sourceRoot":"","sources":["../../core/decorators/interceptor.advanced.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AAEH;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACnD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;CAsC5E;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,eAAe;IACxD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;CAkB5E;AAED;;;;;;GAMG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAChD,OAAO,CAAC,SAAS;gBAAT,SAAS,GAAE,MAAa;IAEtC,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;CAa5E;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAIxD,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,QAAQ;IAJlB,OAAO,CAAC,QAAQ,CAAoC;gBAG1C,WAAW,GAAE,MAAY,EACzB,QAAQ,GAAE,MAAc;IAG5B,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;CA0B5E;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,eAAe;IAEnD,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE;QACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;KAClB;IAGF,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;CA8B5E;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,cAAc,CAAW;gBAErB,cAAc,GAAE,MAAM,EAAoC;IAIhE,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAK3E,OAAO,CAAC,QAAQ;CAmBjB;AAED;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IACrD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;CA2B5E"}
+{"version":3,"file":"interceptor.advanced.d.ts","sourceRoot":"","sources":["../../core/decorators/interceptor.advanced.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE;;;GAGG;AAEH;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACnD,SAAS,CACb,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,GAAG,CAAC;CAsChB;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,eAAe;IACxD,SAAS,CACb,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,GAAG,CAAC;CAoBhB;AAED;;;;;;GAMG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAChD,OAAO,CAAC,SAAS;gBAAT,SAAS,GAAE,MAAa;IAEtC,SAAS,CACb,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,GAAG,CAAC;CAahB;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAIxD,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,QAAQ;IAJlB,OAAO,CAAC,QAAQ,CAAoC;gBAG1C,WAAW,GAAE,MAAY,EACzB,QAAQ,GAAE,MAAc;IAG5B,SAAS,CACb,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,GAAG,CAAC;CA0BhB;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,eAAe;IAEnD,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE;QACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;KAClB;IAGF,SAAS,CACb,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,GAAG,CAAC;CA8BhB;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,cAAc,CAAW;gBAErB,cAAc,GAAE,MAAM,EAAoC;IAIhE,SAAS,CACb,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,GAAG,CAAC;IAKf,OAAO,CAAC,QAAQ;CAmBjB;AAED;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IACrD,SAAS,CACb,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,GAAG,CAAC;CA2BhB"}

package/dist/decorators/interceptor.advanced.js

@@ -15,7 +15,7 @@ export class ResponseInterceptor {
         const request = context.getRequest();
         const startTime = Date.now();
         try {
-            const data = await next.handle();
+            const data = await next();
             const duration = Date.now() - startTime;
             return {
                 success: true,
@@ -58,7 +58,7 @@ export class ResponseInterceptor {
 export class ErrorHandlingInterceptor {
     async intercept(context, next) {
         try {
-            return await next.handle();
+            return await next();
         }
         catch (error) {
             console.error(`❌ Error in ${context.getRequest().method} ${context.getRequest().url}:`, error);
@@ -85,7 +85,7 @@ export class CompressionInterceptor {
         this.threshold = threshold;
     }
     async intercept(context, next) {
-        const data = await next.handle();
+        const data = await next();
         const dataSize = JSON.stringify(data).length;
         if (dataSize > this.threshold) {
             // In a real implementation, you'd compress the data here
@@ -128,7 +128,7 @@ export class RateLimitInterceptor {
         // Add current request
         history.push(now);
         this.requests.set(clientIp, history);
-        return next.handle();
+        return next();
     }
 }
 /**
@@ -162,7 +162,7 @@ export class CorsInterceptor {
                 response.headers.set("Access-Control-Allow-Credentials", "true");
             }
         }
-        return next.handle();
+        return next();
     }
 }
 /**
@@ -178,7 +178,7 @@ export class SanitizeInterceptor {
         this.fieldsToRemove = fieldsToRemove;
     }
     async intercept(context, next) {
-        const data = await next.handle();
+        const data = await next();
         return this.sanitize(data);
     }
     sanitize(data) {
@@ -210,7 +210,7 @@ export class PaginationInterceptor {
         const url = new URL(request.url, `http://${request.headers?.get?.("host")}`);
         const page = parseInt(url.searchParams.get("page") || "1");
         const limit = parseInt(url.searchParams.get("limit") || "10");
-        const data = await next.handle();
+        const data = await next();
         // If data is an array, add pagination
         if (Array.isArray(data)) {
             return {