wynkjs 1.0.4 → 1.0.6

package/dist/decorators/param.decorators.d.ts

@@ -1,6 +1,6 @@
 import "reflect-metadata";
 /**
- * Parameter Decorators for ElysiaJS Framework
+ * Parameter Decorators for WynkJS Framework
  * Extract data from request context
  */
 export type ParamType = "body" | "param" | "query" | "headers" | "request" | "response" | "context" | "user" | "file" | "files";
@@ -80,7 +80,7 @@ export declare function Res(): ParameterDecorator;
  */
 export declare const Response: typeof Res;
 /**
- * @Context decorator - Injects full Elysia context
+ * @Context decorator - Injects full WynkJS context
  * @example
  * @Get()
  * getData(@Context() ctx: any) {}

package/dist/decorators/param.decorators.js

@@ -98,7 +98,7 @@ export function Res() {
  */
 export const Response = Res;
 /**
- * @Context decorator - Injects full Elysia context
+ * @Context decorator - Injects full WynkJS context
  * @example
  * @Get()
  * getData(@Context() ctx: any) {}

package/dist/decorators/pipe.decorators.d.ts

@@ -66,12 +66,12 @@ export declare class ValidationPipe implements WynkPipeTransform {
     });
     transform(value: any, metadata: ArgumentMetadata): Promise<any>;
     /**
-     * Format Elysia validation error
+     * Format WynkJS validation error
      * Called by ValidationExceptionFilter
      */
     formatError(exception: any): any;
     /**
-     * Parse validation error from Elysia exception
+     * Parse validation error from WynkJS exception
      */
     private parseValidationError;
     /**

package/dist/decorators/pipe.decorators.js

@@ -92,7 +92,7 @@ export class ValidationPipe {
         return value;
     }
     /**
-     * Format Elysia validation error
+     * Format WynkJS validation error
      * Called by ValidationExceptionFilter
      */
     formatError(exception) {
@@ -105,7 +105,7 @@ export class ValidationPipe {
         return this.defaultFormatError(validationError);
     }
     /**
-     * Parse validation error from Elysia exception
+     * Parse validation error from WynkJS exception
      */
     parseValidationError(exception) {
         let validationData;

package/dist/factory.d.ts

@@ -1,31 +1,43 @@
 import { Elysia } from "elysia";
 import "reflect-metadata";
 import { ErrorFormatter } from "./decorators/formatter.decorators";
+import { CorsOptions } from "./cors";
 /**
  * Application Factory for WynkJS Framework
  * Creates and configures Elysia app with all decorators support
  */
 export interface ApplicationOptions {
-    cors?: boolean | any;
+    cors?: boolean | CorsOptions;
     globalPrefix?: string;
     logger?: boolean;
     validationErrorFormatter?: ErrorFormatter;
+    providers?: any[];
 }
 export declare class WynkFramework {
     private app;
     private controllers;
+    private providers;
     private globalGuards;
     private globalInterceptors;
     private globalPipes;
     private globalFilters;
     private validationFormatter?;
+    private shutdownHandlersRegistered;
+    private globalPrefix?;
+    private isBuilt;
     constructor(options?: ApplicationOptions);
     /**
      * Static convenience creator to align with documentation examples
      */
     static create(options?: ApplicationOptions & {
         controllers?: any[];
+        providers?: any[];
     }): WynkFramework;
+    /**
+     * Register providers with the application
+     * Providers are singleton services that are initialized when the app starts
+     */
+    registerProviders(...providers: any[]): this;
     /**
      * Register controllers with the application
      */
@@ -46,10 +58,20 @@ export declare class WynkFramework {
      * Register global exception filters
      */
     useGlobalFilters(...filters: any[]): this;
+    /**
+     * Initialize all registered providers
+     * Providers with onModuleInit() method will be called
+     */
+    private initializeProviders;
     /**
      * Build the application - register all routes
      */
     build(): Promise<Elysia>;
+    /**
+     * Cleanup all providers when app shuts down
+     * Providers with onModuleDestroy() method will be called
+     */
+    private destroyProviders;
     /**
      * Start listening on a port
      */
@@ -58,6 +80,11 @@ export declare class WynkFramework {
      * Get the underlying Elysia instance
      */
     getApp(): Elysia;
+    /**
+     * Handle an HTTP request
+     * Automatically builds the app if not already built
+     */
+    handle(request: Request): Promise<Response>;
     /**
      * Register a single controller
      */
@@ -73,6 +100,7 @@ export declare function createApp(options?: ApplicationOptions): WynkFramework;
 export declare class WynkFactory {
     static create(options?: ApplicationOptions & {
         controllers?: any[];
+        providers?: any[];
     }): WynkFramework;
 }
 export { WynkFramework as ElysiaFramework };

package/dist/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../core/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,kBAAkB,CAAC;AAc1B,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGnE;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,GAAG,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wBAAwB,CAAC,EAAE,cAAc,CAAC;CAC3C;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,mBAAmB,CAAC,CAAiB;gBAEjC,OAAO,GAAE,kBAAuB;IAgL5C;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,OAAO,GAAE,kBAAkB,GAAG;QAAE,WAAW,CAAC,EAAE,GAAG,EAAE,CAAA;KAAO,GACzD,aAAa;IAQhB;;OAEG;IACH,mBAAmB,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI;IAKhD;;OAEG;IACH,eAAe,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI;IAKvC;;OAEG;IACH,qBAAqB,CAAC,GAAG,YAAY,EAAE,GAAG,EAAE,GAAG,IAAI;IAKnD;;OAEG;IACH,cAAc,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI;IAKrC;;OAEG;IACH,gBAAgB,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI;IAKzC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAkD9B;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB;;OAEG;YACW,kBAAkB;CAuWjC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa,CAEzE;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,MAAM,CAAC,MAAM,CACX,OAAO,GAAE,kBAAkB,GAAG;QAAE,WAAW,CAAC,EAAE,GAAG,EAAE,CAAA;KAAO,GACzD,aAAa;CASjB;AAGD,OAAO,EAAE,aAAa,IAAI,eAAe,EAAE,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../core/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,kBAAkB,CAAC;AAc1B,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAa,MAAM,QAAQ,CAAC;AAOhD;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wBAAwB,CAAC,EAAE,cAAc,CAAC;IAC1C,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,mBAAmB,CAAC,CAAiB;IAC7C,OAAO,CAAC,0BAA0B,CAAS;IAC3C,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,kBAAuB;IA2L5C;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,OAAO,GAAE,kBAAkB,GAAG;QAC5B,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;QACpB,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;KACd,GACL,aAAa;IAahB;;;OAGG;IACH,iBAAiB,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI;IAK5C;;OAEG;IACH,mBAAmB,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI;IAKhD;;OAEG;IACH,eAAe,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI;IAKvC;;OAEG;IACH,qBAAqB,CAAC,GAAG,YAAY,EAAE,GAAG,EAAE,GAAG,IAAI;IAKnD;;OAEG;IACH,cAAc,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI;IAKrC;;OAEG;IACH,gBAAgB,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI;IAKzC;;;OAGG;YACW,mBAAmB;IAkCjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAwD9B;;;OAGG;YACW,gBAAgB;IA0B9B;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCzC;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOjD;;OAEG;YACW,kBAAkB;CAwLjC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa,CAEzE;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,MAAM,CAAC,MAAM,CACX,OAAO,GAAE,kBAAkB,GAAG;QAC5B,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;QACpB,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;KACd,GACL,aAAa;CAYjB;AAGD,OAAO,EAAE,aAAa,IAAI,eAAe,EAAE,CAAC"}

package/dist/factory.js

@@ -2,22 +2,38 @@ import { Elysia } from "elysia";
 import "reflect-metadata";
 import { container } from "tsyringe";
 import { Value } from "@sinclair/typebox/value";
-import { createExecutionContext, executeGuards, } from "./decorators/guard.decorators";
-import { executeInterceptors } from "./decorators/interceptor.decorators";
-import { executePipes } from "./decorators/pipe.decorators";
-import { executeExceptionFilters, HttpException, } from "./decorators/exception.decorators";
+import { executeExceptionFilters, } from "./decorators/exception.decorators";
 import { schemaRegistry } from "./schema-registry";
+import { setupCors } from "./cors";
+import { normalizePrefixPath } from "./global-prefix";
+import { buildUltraOptimizedHandler, buildMiddlewareChain, } from "./ultra-optimized-handler";
 export class WynkFramework {
     app;
     controllers = [];
+    providers = []; // Store registered providers
     globalGuards = [];
     globalInterceptors = [];
     globalPipes = [];
     globalFilters = [];
     validationFormatter;
+    shutdownHandlersRegistered = false; // Prevent duplicate signal handlers
+    globalPrefix; // Store global prefix for route registration
+    isBuilt = false; // Track if build() has been called
     constructor(options = {}) {
         this.app = new Elysia();
         this.validationFormatter = options.validationErrorFormatter;
+        // Store global prefix for later use
+        if (options.globalPrefix) {
+            this.globalPrefix = normalizePrefixPath(options.globalPrefix);
+        }
+        // Register providers if provided
+        if (options.providers && options.providers.length > 0) {
+            this.providers.push(...options.providers);
+        }
+        // Apply CORS configuration
+        if (options.cors) {
+            setupCors(this.app, options.cors);
+        }
         // Configure Elysia's error handling for validation errors
         this.app.onError(({ code, error, set, request }) => {
             // Handle ValidationError from Elysia
@@ -137,13 +153,10 @@ export class WynkFramework {
                 error: err.name || "Error",
             };
         });
-        // Apply CORS if enabled
-        if (options.cors) {
-            // CORS configuration would go here
-        }
         // Apply global prefix if specified
         if (options.globalPrefix) {
-            // Global prefix handling
+            // Global prefix is handled during route registration
+            console.log(`✅ Global prefix configured: ${this.globalPrefix}`);
         }
         return this;
     }
@@ -152,11 +165,21 @@ export class WynkFramework {
      */
     static create(options = {}) {
         const app = new WynkFramework(options);
+        // Don't re-register providers/controllers if they were already added in constructor
+        // The constructor already handles options.providers
         if (options.controllers && options.controllers.length) {
             app.registerControllers(...options.controllers);
         }
         return app;
     }
+    /**
+     * Register providers with the application
+     * Providers are singleton services that are initialized when the app starts
+     */
+    registerProviders(...providers) {
+        this.providers.push(...providers);
+        return this;
+    }
     /**
      * Register controllers with the application
      */
@@ -192,10 +215,42 @@ export class WynkFramework {
         this.globalFilters.push(...filters);
         return this;
     }
+    /**
+     * Initialize all registered providers
+     * Providers with onModuleInit() method will be called
+     */
+    async initializeProviders() {
+        console.log(`🔧 Initializing ${this.providers.length} providers...`);
+        for (const ProviderClass of this.providers) {
+            try {
+                console.log(`  ⚙️  Initializing provider: ${ProviderClass.name}`);
+                // Resolve provider instance from DI container
+                const instance = container.resolve(ProviderClass);
+                // Check if provider has onModuleInit lifecycle hook
+                if (typeof instance.onModuleInit === "function") {
+                    await instance.onModuleInit();
+                    console.log(`  ✅ ${ProviderClass.name} initialized successfully`);
+                }
+                else {
+                    // Just register in container for injection
+                    console.log(`  ✅ ${ProviderClass.name} registered in container`);
+                }
+            }
+            catch (error) {
+                console.error(`  ❌ Failed to initialize provider ${ProviderClass.name}:`, error);
+                throw new Error(`Provider initialization failed for ${ProviderClass.name}: ${error.message}`);
+            }
+        }
+        console.log(`✅ All providers initialized successfully\n`);
+    }
     /**
      * Build the application - register all routes
      */
     async build() {
+        // Initialize providers first (database connections, etc.)
+        if (this.providers.length > 0) {
+            await this.initializeProviders();
+        }
         // Register global error handler if filters exist
         if (this.globalFilters.length > 0) {
             this.app.onError(async ({ error, set, request }) => {
@@ -234,8 +289,33 @@ export class WynkFramework {
         for (const ControllerClass of this.controllers) {
             await this.registerController(ControllerClass);
         }
+        this.isBuilt = true;
         return this.app;
     }
+    /**
+     * Cleanup all providers when app shuts down
+     * Providers with onModuleDestroy() method will be called
+     */
+    async destroyProviders() {
+        console.log(`\n🔧 Cleaning up ${this.providers.length} providers...`);
+        for (const ProviderClass of this.providers) {
+            try {
+                // Resolve provider instance from DI container
+                const instance = container.resolve(ProviderClass);
+                // Check if provider has onModuleDestroy lifecycle hook
+                if (typeof instance.onModuleDestroy === "function") {
+                    console.log(`  🧹 Destroying provider: ${ProviderClass.name}`);
+                    await instance.onModuleDestroy();
+                    console.log(`  ✅ ${ProviderClass.name} destroyed successfully`);
+                }
+            }
+            catch (error) {
+                console.error(`  ❌ Failed to destroy provider ${ProviderClass.name}:`, error);
+                // Continue cleanup even if one provider fails
+            }
+        }
+        console.log(`✅ All providers cleaned up\n`);
+    }
     /**
      * Start listening on a port
      */
@@ -243,6 +323,29 @@ export class WynkFramework {
         await this.build();
         this.app.listen(port);
         console.log(`🚀 Application is running on http://localhost:${port}`);
+        // Register signal handlers only once to prevent memory leaks
+        if (!this.shutdownHandlersRegistered) {
+            this.shutdownHandlersRegistered = true;
+            // Setup graceful shutdown handlers
+            const gracefulShutdown = async (signal) => {
+                console.log(`\n📡 Received ${signal}, shutting down gracefully...`);
+                try {
+                    // Cleanup providers (close database connections, etc.)
+                    await this.destroyProviders();
+                    // Stop the Elysia server
+                    await this.app.stop();
+                    console.log("👋 Application shut down successfully");
+                    process.exit(0);
+                }
+                catch (error) {
+                    console.error("❌ Error during shutdown:", error);
+                    process.exit(1);
+                }
+            };
+            // Register signal handlers (only once)
+            process.once("SIGTERM", () => gracefulShutdown("SIGTERM"));
+            process.once("SIGINT", () => gracefulShutdown("SIGINT"));
+        }
     }
     /**
      * Get the underlying Elysia instance
@@ -250,6 +353,16 @@ export class WynkFramework {
     getApp() {
         return this.app;
     }
+    /**
+     * Handle an HTTP request
+     * Automatically builds the app if not already built
+     */
+    async handle(request) {
+        if (!this.isBuilt) {
+            await this.build();
+        }
+        return this.app.handle(request);
+    }
     /**
      * Register a single controller
      */
@@ -273,7 +386,11 @@ export class WynkFramework {
         // Get @Use() middleware (simple pattern like user's working code)
         const controllerUses = Reflect.getMetadata("uses", ControllerClass) || [];
         for (const route of routes) {
-            const fullPath = basePath + route.path;
+            // Apply global prefix to route path
+            let fullPath = basePath + route.path;
+            if (this.globalPrefix) {
+                fullPath = this.globalPrefix + fullPath;
+            }
             const method = route.method.toLowerCase();
             const methodName = route.methodName;
             // Get method-specific metadata
@@ -284,19 +401,24 @@ export class WynkFramework {
             // Get @Use() middleware for this method
             const methodUses = Reflect.getMetadata("uses", instance, methodName) || [];
             const params = Reflect.getMetadata("params", instance, methodName) || [];
+            // Sort params once during registration, not on every request
+            if (params.length > 0) {
+                params.sort((a, b) => a.index - b.index);
+            }
             const httpCode = Reflect.getMetadata("route:httpCode", instance, methodName);
             const headers = Reflect.getMetadata("route:headers", instance, methodName);
             const redirect = Reflect.getMetadata("route:redirect", instance, methodName);
-            // Combine guards, interceptors, pipes, filters (global -> controller -> method)
+            // Combine guards, interceptors, pipes, filters
+            // Order: method -> controller -> global (method is innermost/closest to handler)
             const allGuards = [
                 ...this.globalGuards,
                 ...controllerGuards,
                 ...methodGuards,
             ];
             const allInterceptors = [
-                ...this.globalInterceptors,
-                ...controllerInterceptors,
                 ...methodInterceptors,
+                ...controllerInterceptors,
+                ...this.globalInterceptors,
             ];
             const allPipes = [
                 ...this.globalPipes,
@@ -314,178 +436,29 @@ export class WynkFramework {
             if (bodySchema && !routeOptions.body) {
                 routeOptions.body = bodySchema;
             }
-            // Create route handler
-            const handler = async (ctx) => {
-                try {
-                    // Create execution context
-                    const executionContext = createExecutionContext(ctx, instance[methodName], ControllerClass);
-                    // Execute guards
-                    if (allGuards.length > 0) {
-                        const canActivate = await executeGuards(allGuards, executionContext);
-                        if (!canActivate) {
-                            throw new HttpException("Forbidden", 403, "Access denied");
-                        }
-                    }
-                    // Prepare handler with parameters and pipes
-                    const executeHandler = async () => {
-                        // Build arguments for the controller method
-                        const args = [];
-                        if (params.length === 0) {
-                            // No parameter decorators, pass full context
-                            args.push(ctx);
-                        }
-                        else {
-                            // Sort params by index
-                            params.sort((a, b) => a.index - b.index);
-                            for (const param of params) {
-                                let value;
-                                // Extract value based on type
-                                switch (param.type) {
-                                    case "body":
-                                        value = param.data ? ctx.body?.[param.data] : ctx.body;
-                                        break;
-                                    case "param":
-                                        value = param.data ? ctx.params?.[param.data] : ctx.params;
-                                        break;
-                                    case "query":
-                                        value = param.data ? ctx.query?.[param.data] : ctx.query;
-                                        break;
-                                    case "headers":
-                                        value = param.data
-                                            ? ctx.headers?.get?.(param.data) ||
-                                                ctx.request?.headers?.get?.(param.data)
-                                            : ctx.headers || ctx.request?.headers;
-                                        break;
-                                    case "request":
-                                        value = ctx.request || ctx;
-                                        break;
-                                    case "response":
-                                        value = ctx.set || ctx.response;
-                                        break;
-                                    case "context":
-                                        if (param.data) {
-                                            // Access nested property like "session.userId"
-                                            const keys = param.data.split(".");
-                                            value = keys.reduce((obj, key) => obj?.[key], ctx);
-                                        }
-                                        else {
-                                            value = ctx;
-                                        }
-                                        break;
-                                    case "user":
-                                        value = param.data ? ctx.user?.[param.data] : ctx.user;
-                                        break;
-                                    case "file":
-                                        value = ctx.body?.file || ctx.file;
-                                        break;
-                                    case "files":
-                                        value = ctx.body?.files || ctx.files;
-                                        break;
-                                }
-                                // Apply pipes if any
-                                if (param.pipes && param.pipes.length > 0) {
-                                    const metadata = {
-                                        type: param.type,
-                                        data: param.data,
-                                    };
-                                    value = await executePipes(param.pipes, value, metadata);
-                                }
-                                // Apply global/controller/method pipes
-                                if (allPipes.length > 0) {
-                                    const metadata = {
-                                        type: param.type,
-                                        data: param.data,
-                                    };
-                                    value = await executePipes(allPipes, value, metadata);
-                                }
-                                args[param.index] = value;
-                            }
-                        }
-                        // Call controller method
-                        return await instance[methodName].apply(instance, args);
-                    };
-                    // Execute interceptors
-                    let result;
-                    if (allInterceptors.length > 0) {
-                        result = await executeInterceptors(allInterceptors, executionContext, executeHandler);
-                    }
-                    else {
-                        result = await executeHandler();
-                    }
-                    // Handle redirect
-                    if (redirect) {
-                        ctx.set.redirect = redirect.url;
-                        ctx.set.status = redirect.statusCode;
-                        return;
-                    }
-                    // Set custom HTTP code
-                    if (httpCode) {
-                        ctx.set.status = httpCode;
-                    }
-                    // Set custom headers
-                    if (headers) {
-                        Object.entries(headers).forEach(([key, value]) => {
-                            ctx.set.headers[key] = value;
-                        });
-                    }
-                    return result;
-                }
-                catch (error) {
-                    console.log("🔴 ERROR CAUGHT IN FACTORY");
-                    console.log("allFilters.length:", allFilters.length);
-                    console.log("Error:", error?.message);
-                    // Execute exception filters
-                    if (allFilters.length > 0) {
-                        console.log("✅ Executing exception filters...");
-                        const executionContext = createExecutionContext(ctx, instance[methodName], ControllerClass);
-                        try {
-                            const result = await executeExceptionFilters(allFilters, error, executionContext);
-                            if (result) {
-                                if (result.statusCode) {
-                                    ctx.set.status = result.statusCode;
-                                }
-                                return result;
-                            }
-                        }
-                        catch (filterError) {
-                            // If filter doesn't handle it, continue to default error handling
-                            error = filterError;
-                        }
-                    }
-                    else {
-                        console.log("❌ No filters registered for this route");
-                    }
-                    // Default error handling
-                    if (error instanceof HttpException) {
-                        ctx.set.status = error.getStatus();
-                        return error.getResponse();
-                    }
-                    // Unknown error
-                    ctx.set.status = 500;
-                    return {
-                        statusCode: 500,
-                        message: error.message || "Internal server error",
-                        error: "Internal Server Error",
-                    };
-                }
-            };
+            // ⚡ ULTRA-OPTIMIZED HANDLER - Use specialized builder
+            // This eliminates nested async/await and IIFEs for maximum performance
+            const handler = buildUltraOptimizedHandler({
+                instance,
+                methodName,
+                ControllerClass,
+                params,
+                allGuards,
+                allInterceptors,
+                allPipes,
+                allFilters,
+                httpCode,
+                headers,
+                redirect,
+                routePath: route.path,
+                routeMethod: method.toUpperCase(),
+            });
             // Wrap handler with @Use() middleware if present
             // Combine controller and method middleware
             const allUses = [...controllerUses, ...methodUses];
             let finalHandler = handler;
             if (allUses.length > 0) {
-                console.log(`🔗 Building middleware chain for ${method} ${fullPath}:`);
-                console.log(`   Middleware count: ${allUses.length}`);
-                allUses.forEach((m, i) => console.log(`   [${i}] ${m.name || "anonymous"}`));
-                // Build middleware chain using reduce (O(n) complexity)
-                // Builds from right to left: handler <- middleware[n-1] <- ... <- middleware[0]
-                // Executes left to right: middleware[0] -> ... -> middleware[n-1] -> handler
-                finalHandler = allUses.reduceRight((next, middleware, index) => {
-                    return async (ctx) => {
-                        console.log(`▶️ Executing middleware [${index}]: ${middleware.name || "anonymous"}`);
-                        return await middleware(ctx, () => next(ctx));
-                    };
-                }, handler);
+                finalHandler = buildMiddlewareChain(handler, allUses);
             }
             // Register route with Elysia
             const elysiaOptions = {};
@@ -536,6 +509,8 @@ export function createApp(options = {}) {
 export class WynkFactory {
     static create(options = {}) {
         const app = new WynkFramework(options);
+        // Don't re-register providers if they were already added in constructor
+        // The constructor already handles options.providers
         if (options.controllers) {
             app.registerControllers(...options.controllers);
         }

package/dist/global-prefix.d.ts

@@ -0,0 +1,49 @@
+import { Elysia } from "elysia";
+/**
+ * Global Prefix Module for WynkJS Framework
+ * Adds a prefix to all routes in the application
+ * Separated from factory.ts for better maintainability
+ */
+export interface GlobalPrefixOptions {
+    prefix: string;
+    exclude?: string[];
+}
+/**
+ * Apply global prefix to all routes
+ * @param app - Elysia instance
+ * @param prefix - Prefix string (e.g., '/api', '/v1')
+ * @param options - Additional options like route exclusions
+ * @returns Modified Elysia instance
+ */
+export declare function applyGlobalPrefix(app: Elysia, prefix: string | GlobalPrefixOptions): any;
+/**
+ * Normalize prefix path
+ * - Ensures it starts with /
+ * - Removes trailing /
+ * - Validates format
+ * @param prefix - Raw prefix string
+ * @returns Normalized prefix
+ */
+export declare function normalizePrefixPath(prefix: string): string;
+/**
+ * Check if a route should be excluded from global prefix
+ * @param path - Route path
+ * @param excludedRoutes - List of routes to exclude
+ * @returns true if route should be excluded
+ */
+export declare function isRouteExcluded(path: string, excludedRoutes: string[]): boolean;
+/**
+ * Apply global prefix to an existing Elysia app by wrapping it
+ * This is useful when you want to add prefix to already configured app
+ * @param app - Existing Elysia instance
+ * @param prefix - Prefix to apply
+ * @returns New Elysia instance with prefix
+ */
+export declare function wrapWithPrefix(app: Elysia, prefix: string | GlobalPrefixOptions): any;
+/**
+ * Validate global prefix configuration
+ * @param prefix - Prefix configuration
+ * @returns true if valid, throws error if invalid
+ */
+export declare function validateGlobalPrefix(prefix: string | GlobalPrefixOptions): boolean;
+//# sourceMappingURL=global-prefix.d.ts.map

package/dist/global-prefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-prefix.d.ts","sourceRoot":"","sources":["../core/global-prefix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,mBAAmB,GACnC,GAAG,CAkCL;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0B1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAuBT;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,mBAAmB,GACnC,GAAG,CA0BL;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,GAAG,mBAAmB,GACnC,OAAO,CA2CT"}