wynkjs 1.0.0

package/dist/decorators/guard.decorators.js

@@ -0,0 +1,67 @@
+import "reflect-metadata";
+/**
+ * @UseGuards decorator - Apply guards to routes or controllers
+ * @param guards Guard classes to apply
+ * @example
+ * @Controller('/admin')
+ * @UseGuards(AuthGuard, RolesGuard)
+ * export class AdminController {}
+ *
+ * @Get('/profile')
+ * @UseGuards(AuthGuard)
+ * getProfile() {}
+ */
+export function UseGuards(...guards) {
+    return (target, propertyKey, descriptor) => {
+        if (propertyKey && descriptor) {
+            // Method decorator
+            const existingGuards = Reflect.getMetadata("guards", target, propertyKey) || [];
+            Reflect.defineMetadata("guards", [...existingGuards, ...guards], target, propertyKey);
+            return descriptor;
+        }
+        else {
+            // Class decorator
+            const existingGuards = Reflect.getMetadata("guards", target) || [];
+            Reflect.defineMetadata("guards", [...existingGuards, ...guards], target);
+            return target;
+        }
+    };
+}
+/**
+ * Helper function to create execution context
+ */
+export function createExecutionContext(ctx, handler, controllerClass) {
+    return {
+        getRequest: () => ctx.request || ctx,
+        getResponse: () => ctx.response || ctx.set,
+        getContext: () => ctx,
+        getHandler: () => handler,
+        getClass: () => controllerClass,
+    };
+}
+/**
+ * Helper function to execute guards
+ */
+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);
+            }
+            else {
+                throw new Error(`Guard ${guard.name} must implement CanActivate interface`);
+            }
+        }
+        else {
+            // Guard is already an instance
+            result = await guard.canActivate(context);
+        }
+        if (!result) {
+            return false;
+        }
+    }
+    return true;
+}

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

@@ -0,0 +1,130 @@
+import "reflect-metadata";
+/**
+ * HTTP Method Decorators for ElysiaJS Framework
+ * Inspired by NestJS but optimized for Elysia's performance
+ */
+export interface RouteOptions {
+    path?: string;
+    body?: any;
+    params?: any;
+    query?: any;
+    headers?: any;
+    response?: any;
+}
+/**
+ * Controller decorator - Defines a controller with a base path
+ * @param path Base path for all routes in this controller
+ * @example
+ * @Controller('/users')
+ * export class UserController {}
+ */
+export declare function Controller(path?: string): ClassDecorator;
+/**
+ * HTTP GET decorator
+ * @param path Route path
+ * @param options Route configuration options
+ * @example
+ * @Get('/profile')
+ * async getProfile() {}
+ */
+export declare function Get(path?: string, options?: RouteOptions): MethodDecorator;
+/**
+ * @Post decorator - Define a POST route
+ * @param pathOrOptions Optional route path or options with DTO
+ * @example
+ * @Post()
+ * create(@Body() data: any) {}
+ *
+ * @Post('/new')
+ * createNew(@Body() data: any) {}
+ *
+ * @Post({ path: '/users', body: UserDTO })
+ * createUser(@Body() data: any) {}
+ */
+export declare function Post(pathOrOptions?: string | RouteOptions): MethodDecorator;
+/**
+ * HTTP PUT decorator
+ * @param pathOrOptions Route path or options with DTO
+ * @example
+ * @Put('/:id')
+ * async update(@Param('id') id: string, @Body() dto: UpdateDto) {}
+ *
+ * @Put({ path: '/:id', body: UpdateUserDTO })
+ * async update(@Param('id') id: string, @Body() dto: any) {}
+ */
+export declare function Put(pathOrOptions?: string | RouteOptions): MethodDecorator;
+/**
+ * HTTP PATCH decorator
+ * @param pathOrOptions Route path or options with DTO
+ * @example
+ * @Patch('/:id')
+ * async partialUpdate(@Param('id') id: string, @Body() dto: PartialDto) {}
+ *
+ * @Patch({ path: '/:id', body: PatchUserDTO })
+ * async patch(@Param('id') id: string, @Body() dto: any) {}
+ */
+export declare function Patch(pathOrOptions?: string | RouteOptions): MethodDecorator;
+/**
+ * HTTP DELETE decorator
+ * @param path Route path
+ * @param options Route configuration options
+ * @example
+ * @Delete('/:id')
+ * async remove(@Param('id') id: string) {}
+ */
+export declare function Delete(path?: string, options?: RouteOptions): MethodDecorator;
+/**
+ * HTTP OPTIONS decorator
+ * @param path Route path
+ * @param options Route configuration options
+ */
+export declare function Options(path?: string, options?: RouteOptions): MethodDecorator;
+/**
+ * HTTP HEAD decorator
+ * @param path Route path
+ * @param options Route configuration options
+ */
+export declare function Head(path?: string, options?: RouteOptions): MethodDecorator;
+/**
+ * Set custom HTTP status code for a route
+ * @param code HTTP status code
+ * @example
+ * @Post()
+ * @HttpCode(201)
+ * async create() {}
+ */
+export declare function HttpCode(code: number): MethodDecorator;
+/**
+ * Set custom headers for a route response
+ * @param headers Headers object
+ * @example
+ * @Get()
+ * @Header('Cache-Control', 'max-age=3600')
+ * async getData() {}
+ */
+export declare function Header(name: string, value: string): MethodDecorator;
+/**
+ * Redirect to a URL
+ * @param url URL to redirect to
+ * @param statusCode Redirect status code (default: 302)
+ * @example
+ * @Get('/old-url')
+ * @Redirect('/new-url', 301)
+ * redirect() {}
+ */
+export declare function Redirect(url: string, statusCode?: number): MethodDecorator;
+/**
+ * Use decorator - Apply middleware to controller or method
+ * Simple middleware pattern like your working code
+ * @param middlewares Middleware functions to apply
+ * @example
+ * @Controller('/users')
+ * @Use(authMiddleware, loggingMiddleware)
+ * export class UserController {}
+ *
+ * @Get('/')
+ * @Use(cacheMiddleware)
+ * async findAll() {}
+ */
+export declare function Use(...middlewares: any[]): ClassDecorator & MethodDecorator;
+//# sourceMappingURL=http.decorators.d.ts.map

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

@@ -0,0 +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;;;;;;;GAOG;AACH,wBAAgB,GAAG,CACjB,IAAI,GAAE,MAAW,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,eAAe,CAEjB;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;;;;;;;GAOG;AACH,wBAAgB,MAAM,CACpB,IAAI,GAAE,MAAW,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,eAAe,CAEjB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,IAAI,GAAE,MAAW,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,eAAe,CAEjB;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAClB,IAAI,GAAE,MAAW,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,eAAe,CAEjB;AAiDD;;;;;;;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

@@ -0,0 +1,209 @@
+import "reflect-metadata";
+/**
+ * Controller decorator - Defines a controller with a base path
+ * @param path Base path for all routes in this controller
+ * @example
+ * @Controller('/users')
+ * export class UserController {}
+ */
+export function Controller(path = "") {
+    return (target) => {
+        Reflect.defineMetadata("basePath", path, target);
+        Reflect.defineMetadata("routes", [], target);
+    };
+}
+/**
+ * HTTP GET decorator
+ * @param path Route path
+ * @param options Route configuration options
+ * @example
+ * @Get('/profile')
+ * async getProfile() {}
+ */
+export function Get(path = "", options) {
+    return createRouteDecorator("GET", path, options);
+}
+/**
+ * @Post decorator - Define a POST route
+ * @param pathOrOptions Optional route path or options with DTO
+ * @example
+ * @Post()
+ * create(@Body() data: any) {}
+ *
+ * @Post('/new')
+ * createNew(@Body() data: any) {}
+ *
+ * @Post({ path: '/users', body: UserDTO })
+ * createUser(@Body() data: any) {}
+ */
+export function Post(pathOrOptions) {
+    if (typeof pathOrOptions === "string") {
+        return createRouteDecorator("POST", pathOrOptions);
+    }
+    const options = pathOrOptions || {};
+    return createRouteDecorator("POST", options.path || "", options);
+}
+/**
+ * HTTP PUT decorator
+ * @param pathOrOptions Route path or options with DTO
+ * @example
+ * @Put('/:id')
+ * async update(@Param('id') id: string, @Body() dto: UpdateDto) {}
+ *
+ * @Put({ path: '/:id', body: UpdateUserDTO })
+ * async update(@Param('id') id: string, @Body() dto: any) {}
+ */
+export function Put(pathOrOptions) {
+    if (typeof pathOrOptions === "string") {
+        return createRouteDecorator("PUT", pathOrOptions);
+    }
+    const options = pathOrOptions || {};
+    return createRouteDecorator("PUT", options.path || "", options);
+}
+/**
+ * HTTP PATCH decorator
+ * @param pathOrOptions Route path or options with DTO
+ * @example
+ * @Patch('/:id')
+ * async partialUpdate(@Param('id') id: string, @Body() dto: PartialDto) {}
+ *
+ * @Patch({ path: '/:id', body: PatchUserDTO })
+ * async patch(@Param('id') id: string, @Body() dto: any) {}
+ */
+export function Patch(pathOrOptions) {
+    if (typeof pathOrOptions === "string") {
+        return createRouteDecorator("PATCH", pathOrOptions);
+    }
+    const options = pathOrOptions || {};
+    return createRouteDecorator("PATCH", options.path || "", options);
+}
+/**
+ * HTTP DELETE decorator
+ * @param path Route path
+ * @param options Route configuration options
+ * @example
+ * @Delete('/:id')
+ * async remove(@Param('id') id: string) {}
+ */
+export function Delete(path = "", options) {
+    return createRouteDecorator("DELETE", path, options);
+}
+/**
+ * HTTP OPTIONS decorator
+ * @param path Route path
+ * @param options Route configuration options
+ */
+export function Options(path = "", options) {
+    return createRouteDecorator("OPTIONS", path, options);
+}
+/**
+ * HTTP HEAD decorator
+ * @param path Route path
+ * @param options Route configuration options
+ */
+export function Head(path = "", options) {
+    return createRouteDecorator("HEAD", path, options);
+}
+/**
+ * Helper function to create route decorators
+ */
+function createRouteDecorator(method, path, options) {
+    return (target, propertyKey, descriptor) => {
+        // Store route metadata on the prototype
+        const constructor = target.constructor;
+        const routes = Reflect.getMetadata("routes", constructor.prototype) || [];
+        routes.push({
+            method,
+            path,
+            methodName: propertyKey,
+            options,
+        });
+        console.log(`🔹 Storing route: ${method} ${path} on ${constructor.name}.${String(propertyKey)} (routes: ${routes.length})`);
+        Reflect.defineMetadata("routes", routes, constructor.prototype);
+        // Also store on constructor for compatibility
+        Reflect.defineMetadata("routes", routes, constructor);
+        // Verify it was stored
+        const verify = Reflect.getMetadata("routes", constructor.prototype) || [];
+        console.log(`✅ Verified ${verify.length} routes stored on ${constructor.name}.prototype`);
+        // Store method-specific metadata
+        Reflect.defineMetadata("route:method", method, target, propertyKey);
+        Reflect.defineMetadata("route:path", path, target, propertyKey);
+        if (options) {
+            Reflect.defineMetadata("route:options", options, target, propertyKey);
+        }
+        return descriptor;
+    };
+}
+/**
+ * Set custom HTTP status code for a route
+ * @param code HTTP status code
+ * @example
+ * @Post()
+ * @HttpCode(201)
+ * async create() {}
+ */
+export function HttpCode(code) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata("route:httpCode", code, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Set custom headers for a route response
+ * @param headers Headers object
+ * @example
+ * @Get()
+ * @Header('Cache-Control', 'max-age=3600')
+ * async getData() {}
+ */
+export function Header(name, value) {
+    return (target, propertyKey, descriptor) => {
+        const headers = Reflect.getMetadata("route:headers", target, propertyKey) || {};
+        headers[name] = value;
+        Reflect.defineMetadata("route:headers", headers, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Redirect to a URL
+ * @param url URL to redirect to
+ * @param statusCode Redirect status code (default: 302)
+ * @example
+ * @Get('/old-url')
+ * @Redirect('/new-url', 301)
+ * redirect() {}
+ */
+export function Redirect(url, statusCode = 302) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata("route:redirect", { url, statusCode }, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Use decorator - Apply middleware to controller or method
+ * Simple middleware pattern like your working code
+ * @param middlewares Middleware functions to apply
+ * @example
+ * @Controller('/users')
+ * @Use(authMiddleware, loggingMiddleware)
+ * export class UserController {}
+ *
+ * @Get('/')
+ * @Use(cacheMiddleware)
+ * async findAll() {}
+ */
+export function Use(...middlewares) {
+    return (target, propertyKey, descriptor) => {
+        if (propertyKey) {
+            // Method decorator
+            const existingUses = Reflect.getMetadata("uses", target, propertyKey) || [];
+            Reflect.defineMetadata("uses", [...existingUses, ...middlewares], target, propertyKey);
+        }
+        else {
+            // Class decorator
+            const existingUses = Reflect.getMetadata("uses", target) || [];
+            Reflect.defineMetadata("uses", [...existingUses, ...middlewares], target);
+        }
+        return descriptor;
+    };
+}

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

@@ -0,0 +1,93 @@
+import "reflect-metadata";
+import { WynkInterceptor, CallHandler } from "./interceptor.decorators";
+import { ExecutionContext } from "./guard.decorators";
+/**
+ * Advanced Interceptors for WynkJS Framework
+ * Additional interceptors for common use cases
+ */
+/**
+ * Response Interceptor - Wraps all responses in a standard format
+ * @example
+ * @UseInterceptors(ResponseInterceptor)
+ * @Controller('/api')
+ * export class ApiController {}
+ */
+export declare class ResponseInterceptor implements WynkInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+}
+/**
+ * Error Handling Interceptor - Catches and transforms errors
+ * @example
+ * @UseInterceptors(ErrorHandlingInterceptor)
+ * @Get()
+ * async getData() {}
+ */
+export declare class ErrorHandlingInterceptor implements WynkInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+}
+/**
+ * Compression Interceptor - Simulates response compression metadata
+ * @example
+ * @UseInterceptors(CompressionInterceptor)
+ * @Get()
+ * async getLargeData() {}
+ */
+export declare class CompressionInterceptor implements WynkInterceptor {
+    private threshold;
+    constructor(threshold?: number);
+    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+}
+/**
+ * Rate Limit Interceptor - Basic rate limiting
+ * @example
+ * @UseInterceptors(new RateLimitInterceptor(100, 60000))
+ * @Post()
+ * async create() {}
+ */
+export declare class RateLimitInterceptor implements WynkInterceptor {
+    private maxRequests;
+    private windowMs;
+    private requests;
+    constructor(maxRequests?: number, windowMs?: number);
+    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+}
+/**
+ * CORS Interceptor - Add CORS headers to responses
+ * @example
+ * @UseInterceptors(CorsInterceptor)
+ * @Controller('/api')
+ * export class ApiController {}
+ */
+export declare class CorsInterceptor implements WynkInterceptor {
+    private options;
+    constructor(options?: {
+        origin?: string | string[];
+        methods?: string[];
+        credentials?: boolean;
+    });
+    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+}
+/**
+ * Sanitize Interceptor - Sanitizes response data
+ * @example
+ * @UseInterceptors(SanitizeInterceptor)
+ * @Get('/users')
+ * async getUsers() {}
+ */
+export declare class SanitizeInterceptor implements WynkInterceptor {
+    private fieldsToRemove;
+    constructor(fieldsToRemove?: string[]);
+    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+    private sanitize;
+}
+/**
+ * Pagination Interceptor - Adds pagination metadata
+ * @example
+ * @UseInterceptors(PaginationInterceptor)
+ * @Get('/users')
+ * async getUsers(@Query('page') page: number, @Query('limit') limit: number) {}
+ */
+export declare class PaginationInterceptor implements WynkInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Promise<any>;
+}
+//# sourceMappingURL=interceptor.advanced.d.ts.map

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

@@ -0,0 +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"}