wynkjs 1.0.6 → 1.0.8

package/README.md

@@ -19,7 +19,7 @@ _10x faster than Express/NestJs, built for modern TypeScript development for Bun
 
 ## About
 
-WynkJS is a modern, TypeScript-first web framework alternative to NestJs that brings Elegant Decorator-Based Architecture to the blazing-fast Elysia runtime built for **Bun**. It features familiar concepts—**Controllers, Dependency Injection, Guards, Pipes, Interceptors, and Exception Filters**—designed for building high‑performance REST APIs and backends on **Bun**. WynkJS embraces ESM, ships first-class types, and keeps things simple so you can move fast without the bloat.
+WynkJS is a modern, TypeScript-first web framework alternative to NestJs that brings Elegant Decorator-Based Architecture to the blazing-fast Elysia runtime built for **Bun**. It features familiar concepts—**Controllers, Dependency Injection, Guards, Pipes, Interceptors, Plugins, and Exception Filters**—designed for building high‑performance REST APIs and backends on **Bun**. WynkJS embraces ESM, ships first-class types, and keeps things simple so you can move fast without the bloat.
 
 Keywords: Bun framework, Fast web server, TypeScript decorators, dependency injection (DI), guards, pipes, interceptors, exception filters, fast web framework, REST API, backend, modern TypeScript.
 
@@ -34,7 +34,8 @@ WynkJS combines the **speed of Elysia** with an **Elegant Decorator-Based Archit
 - 💉 **Dependency Injection** - Built-in DI (no need to import reflect-metadata!)
 - 🔒 **TypeScript First** - TypeScript is mandatory, not optional. Full type safety and IntelliSense support
 - 🎯 **Simple & Clean** - Easy to learn, powerful to use
-- 🔌 **Middleware Support** - Guards, interceptors, pipes, filters
+- 🔌 **Plugin System** - Compression, custom middleware via app.use()
+- 🛡️ **Middleware Support** - Guards, interceptors, pipes, filters
 - ⚡ **Bun Only** - Built exclusively for Bun runtime (not Node.js)
 - 📦 **Single Import** - Everything from `wynkjs` (Injectable, Controller, Get, etc.)
 
@@ -510,7 +511,145 @@ const corsOptions: CorsOptions = {
 
 See [CORS.md](./CORS.md) for complete documentation.
 
-### 🔒 Authentication with Guards
+### � Plugins & Middleware
+
+WynkJS provides a flexible plugin system to extend your application. Add compression, rate limiting, caching, and more using the `app.use()` API.
+
+#### Compression Plugin (Built-in)
+
+Automatically compress HTTP responses with Brotli, Gzip, or Deflate:
+
+```typescript
+import { WynkFactory, compression } from "wynkjs";
+
+const app = WynkFactory.create({
+  controllers: [UserController],
+});
+
+// Add compression middleware
+app.use(
+  compression({
+    threshold: 1024, // Compress responses > 1KB
+    encodings: ["br", "gzip", "deflate"], // Prefer brotli, then gzip
+  })
+);
+
+await app.listen(3000);
+```
+
+**Real-world performance:**
+
+- Brotli: 58KB → 2.9KB (95% reduction) ⚡
+- Gzip: 58KB → 7.7KB (87% reduction)
+
+**Features:**
+
+- Smart compression (only compresses if it reduces size)
+- Auto-detects client support
+- Configurable threshold and compression levels
+- No external dependencies
+
+See [Plugins README](./core/plugins/README.md) for full documentation and options.
+
+#### Custom Plugins
+
+Create your own plugins:
+
+```typescript
+export function myPlugin(options = {}) {
+  return (app: Elysia) => {
+    return app
+      .onBeforeHandle(async (context) => {
+        // Before request
+      })
+      .onAfterHandle(async (context) => {
+        // After request
+        return context.response;
+      });
+  };
+}
+
+// Use it
+app.use(myPlugin({ option: "value" }));
+```
+
+#### Swagger / OpenAPI Documentation
+
+**✨ New Feature**: WynkJS can use Elysia's Swagger plugin for automatic API documentation!
+
+Since WynkJS is built on top of Elysia, you can use the official `@elysiajs/swagger` plugin to generate interactive API documentation from your WynkJS decorators.
+
+```bash
+bun add @elysiajs/swagger
+```
+
+```typescript
+import { WynkFactory } from "wynkjs";
+import { swagger } from "@elysiajs/swagger";
+
+const app = WynkFactory.create({
+  controllers: [UserController, ProductController],
+});
+
+const server = await app.build();
+
+// Add Swagger documentation
+server.use(
+  swagger({
+    documentation: {
+      info: {
+        title: "My API Documentation",
+        version: "1.0.0",
+        description: "Auto-generated from WynkJS decorators",
+      },
+      tags: [
+        { name: "users", description: "User management" },
+        { name: "products", description: "Product catalog" },
+      ],
+    },
+    path: "/docs",
+  })
+);
+
+server.listen(3000);
+// 📚 Visit: http://localhost:3000/docs
+```
+
+**What gets auto-documented:**
+
+✅ All HTTP routes (@Get, @Post, etc.)  
+✅ Query parameters (from DTOs)  
+✅ Request body schemas (from DTOs)  
+✅ Path parameters (from DTOs)  
+✅ Validation rules (min, max, format)  
+✅ JWT Authentication support
+
+**With JWT Authentication:**
+
+```typescript
+server.use(
+  swagger({
+    documentation: {
+      info: { title: "Secure API", version: "1.0.0" },
+      components: {
+        securitySchemes: {
+          bearerAuth: {
+            type: "http",
+            scheme: "bearer",
+            bearerFormat: "JWT",
+          },
+        },
+      },
+      security: [{ bearerAuth: [] }],
+    },
+    path: "/docs",
+  })
+);
+```
+
+📚 See [Swagger Integration Guide](./docs/SWAGGER_INTEGRATION.md) for complete examples and best practices.
+
+### �🔒 Authentication with Guards
 
 ```typescript
 import { Controller, Get, Use } from "wynkjs";

package/dist/factory.d.ts

@@ -72,6 +72,39 @@ export declare class WynkFramework {
      * Providers with onModuleDestroy() method will be called
      */
     private destroyProviders;
+    /**
+     * Use an Elysia plugin or middleware (fully compatible with Elysia.js ecosystem)
+     *
+     * This method directly proxies to Elysia's use() method, making all Elysia plugins
+     * and middleware work seamlessly with WynkJS.
+     *
+     * @param plugin - Any Elysia plugin or instance
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * import { WynkFactory } from "wynkjs";
+     * import { compression } from "wynkjs";
+     * import { cors } from "@elysiajs/cors";
+     * import { swagger } from "@elysiajs/swagger";
+     * import { jwt } from "@elysiajs/jwt";
+     *
+     * const app = WynkFactory.create({
+     *   controllers: [UserController],
+     * });
+     *
+     * // Use WynkJS built-in plugins
+     * app.use(compression({ threshold: 1024 }));
+     *
+     * // Use any Elysia plugin from npm
+     * app.use(cors());
+     * app.use(swagger());
+     * app.use(jwt({ name: 'jwt', secret: 'secret' }));
+     *
+     * await app.listen(3000);
+     * ```
+     */
+    use(...plugins: any[]): this;
     /**
      * Start listening on a port
      */

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;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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI;IAK5B;;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

@@ -316,6 +316,42 @@ export class WynkFramework {
         }
         console.log(`✅ All providers cleaned up\n`);
     }
+    /**
+     * Use an Elysia plugin or middleware (fully compatible with Elysia.js ecosystem)
+     *
+     * This method directly proxies to Elysia's use() method, making all Elysia plugins
+     * and middleware work seamlessly with WynkJS.
+     *
+     * @param plugin - Any Elysia plugin or instance
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * import { WynkFactory } from "wynkjs";
+     * import { compression } from "wynkjs";
+     * import { cors } from "@elysiajs/cors";
+     * import { swagger } from "@elysiajs/swagger";
+     * import { jwt } from "@elysiajs/jwt";
+     *
+     * const app = WynkFactory.create({
+     *   controllers: [UserController],
+     * });
+     *
+     * // Use WynkJS built-in plugins
+     * app.use(compression({ threshold: 1024 }));
+     *
+     * // Use any Elysia plugin from npm
+     * app.use(cors());
+     * app.use(swagger());
+     * app.use(jwt({ name: 'jwt', secret: 'secret' }));
+     *
+     * await app.listen(3000);
+     * ```
+     */
+    use(...plugins) {
+        this.app.use(...plugins);
+        return this;
+    }
     /**
      * Start listening on a port
      */

package/dist/index.d.ts

@@ -21,12 +21,21 @@ export * from "./decorators/formatter.decorators";
 export * from "./filters/exception.filters";
 export * from "./decorators/database.decorators";
 export * from "./dto";
+export { Request } from "./request";
+export { Response } from "./response";
+export type { WynkRequest } from "./request";
+export type { WynkResponse } from "./response";
+export type { CookieOptions } from "./response";
+export type { Request as RequestType } from "./request";
+export type { Response as ResponseType } from "./response";
 export { schemaRegistry } from "./schema-registry";
 export * from "./factory";
 export type { CorsOptions } from "./cors";
 export { setupCors, validateCorsOptions } from "./cors";
 export type { GlobalPrefixOptions } from "./global-prefix";
 export { applyGlobalPrefix, normalizePrefixPath, validateGlobalPrefix, wrapWithPrefix, } from "./global-prefix";
+export { compression } from "./plugins/compression";
+export type { CompressionOptions } from "./plugins/compression";
 export * from "./testing";
 /**
  * Framework version

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EACL,UAAU,EACV,MAAM,EACN,SAAS,EACT,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,EACL,UAAU,IAAI,UAAU,EACxB,MAAM,IAAI,MAAM,EAChB,SAAS,IAAI,SAAS,EACtB,cAAc,IAAI,cAAc,EAChC,QAAQ,IAAI,QAAQ,EACpB,SAAS,IAAI,SAAS,GACvB,MAAM,UAAU,CAAC;AAGlB,cAAc,8BAA8B,CAAC;AAG7C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAI3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAI5C,cAAc,kCAAkC,CAAC;AASjD,cAAc,OAAO,CAAC;AAGtB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,cAAc,WAAW,CAAC;AAG1B,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAGxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,cAAc,WAAW,CAAC;AAE1B;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EACL,UAAU,EACV,MAAM,EACN,SAAS,EACT,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,EACL,UAAU,IAAI,UAAU,EACxB,MAAM,IAAI,MAAM,EAChB,SAAS,IAAI,SAAS,EACtB,cAAc,IAAI,cAAc,EAChC,QAAQ,IAAI,QAAQ,EACpB,SAAS,IAAI,SAAS,GACvB,MAAM,UAAU,CAAC;AAGlB,cAAc,8BAA8B,CAAC;AAG7C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAI3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAI5C,cAAc,kCAAkC,CAAC;AASjD,cAAc,OAAO,CAAC;AAGtB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,cAAc,WAAW,CAAC;AAG1B,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAGxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,cAAc,WAAW,CAAC;AAE1B;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -40,12 +40,17 @@ export * from "./decorators/database.decorators";
 // See: plugins/drizzle and plugins/mongoose
 // DTO Utilities
 export * from "./dto";
+// Request and Response wrappers
+export { Request } from "./request";
+export { Response } from "./response";
 // Schema Registry for custom error messages
 export { schemaRegistry } from "./schema-registry";
 // Application Factory
 export * from "./factory";
 export { setupCors, validateCorsOptions } from "./cors";
 export { applyGlobalPrefix, normalizePrefixPath, validateGlobalPrefix, wrapWithPrefix, } from "./global-prefix";
+// Plugins
+export { compression } from "./plugins/compression";
 // Testing Module
 export * from "./testing";
 /**

package/dist/plugins/compression.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Compression Plugin Options
+ */
+export interface CompressionOptions {
+    /**
+     * Minimum byte size for compression
+     * @default 1024
+     */
+    threshold?: number;
+    /**
+     * Preferred encoding order (first match will be used)
+     * @default ["br", "gzip", "deflate"]
+     */
+    encodings?: ("br" | "gzip" | "deflate")[];
+    /**
+     * Brotli compression options
+     */
+    brotliOptions?: {
+        params?: Record<number, number>;
+    };
+    /**
+     * Zlib (gzip/deflate) compression options
+     */
+    zlibOptions?: {
+        level?: number;
+        memLevel?: number;
+        strategy?: number;
+    };
+}
+/**
+ * Compression Plugin for WynkJS
+ *
+ * @example
+ * ```typescript
+ * import { WynkFactory } from "wynkjs";
+ * import { compression } from "wynkjs/plugins/compression";
+ *
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ * });
+ *
+ * // Add compression middleware
+ * app.use(compression({
+ *   threshold: 1024,
+ *   encodings: ["br", "gzip", "deflate"]
+ * }));
+ *
+ * await app.listen(3000);
+ * ```
+ */
+/**
+ * Compression Plugin for WynkJS
+ *
+ * Simple compression middleware using Elysia's onAfterHandle hook
+ * Supports Brotli, Gzip, and Deflate compression
+ *
+ * @example
+ * ```typescript
+ * import { WynkFactory, compression } from "wynkjs";
+ *
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ * });
+ *
+ * // Add compression middleware
+ * app.use(compression({
+ *   threshold: 1024,
+ *   encodings: ["gzip", "br"]
+ * }));
+ *
+ * await app.listen(3000);
+ * ```
+ */
+export declare function compression(options?: CompressionOptions): (app: any) => any;
+//# sourceMappingURL=compression.d.ts.map

package/dist/plugins/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../core/plugins/compression.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAE1C;;OAEG;IACH,aAAa,CAAC,EAAE;QACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;IAEF;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CACzB,OAAO,GAAE,kBAAuB,GAC/B,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CA4FnB"}

package/dist/plugins/compression.js

@@ -0,0 +1,125 @@
+/**
+ * Compression Plugin for WynkJS
+ *
+ * @example
+ * ```typescript
+ * import { WynkFactory } from "wynkjs";
+ * import { compression } from "wynkjs/plugins/compression";
+ *
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ * });
+ *
+ * // Add compression middleware
+ * app.use(compression({
+ *   threshold: 1024,
+ *   encodings: ["br", "gzip", "deflate"]
+ * }));
+ *
+ * await app.listen(3000);
+ * ```
+ */
+/**
+ * Compression Plugin for WynkJS
+ *
+ * Simple compression middleware using Elysia's onAfterHandle hook
+ * Supports Brotli, Gzip, and Deflate compression
+ *
+ * @example
+ * ```typescript
+ * import { WynkFactory, compression } from "wynkjs";
+ *
+ * const app = WynkFactory.create({
+ *   controllers: [UserController],
+ * });
+ *
+ * // Add compression middleware
+ * app.use(compression({
+ *   threshold: 1024,
+ *   encodings: ["gzip", "br"]
+ * }));
+ *
+ * await app.listen(3000);
+ * ```
+ */
+export function compression(options = {}) {
+    const config = {
+        threshold: options.threshold ?? 1024,
+        encodings: options.encodings ?? ["gzip", "br", "deflate"],
+        brotliOptions: options.brotliOptions ?? {},
+        zlibOptions: options.zlibOptions ?? {},
+    };
+    return (app) => {
+        return app.onAfterHandle(async function compressionHandler(context) {
+            const { response, request, set } = context;
+            // Skip if no response
+            if (!response)
+                return;
+            // Skip if already compressed
+            if (set.headers?.["content-encoding"])
+                return;
+            // Get client's accepted encodings
+            const acceptEncoding = (request.headers.get("accept-encoding") || "").toLowerCase();
+            // Find best compression match
+            let encoding = null;
+            for (const enc of config.encodings) {
+                if (acceptEncoding.includes(enc)) {
+                    encoding = enc;
+                    break;
+                }
+            }
+            if (!encoding)
+                return; // No supported encoding
+            // Convert response to buffer
+            let body;
+            if (Buffer.isBuffer(response)) {
+                body = response;
+            }
+            else if (typeof response === "string") {
+                body = Buffer.from(response);
+            }
+            else if (typeof response === "object") {
+                body = Buffer.from(JSON.stringify(response));
+                set.headers["content-type"] =
+                    set.headers["content-type"] || "application/json";
+            }
+            else {
+                body = Buffer.from(String(response));
+            }
+            // Check size threshold
+            if (body.length < config.threshold)
+                return;
+            // Compress
+            try {
+                const zlib = await import("node:zlib");
+                const { promisify } = await import("node:util");
+                let compressed;
+                switch (encoding) {
+                    case "br":
+                        compressed = await promisify(zlib.brotliCompress)(body, config.brotliOptions);
+                        break;
+                    case "gzip":
+                        compressed = await promisify(zlib.gzip)(body, config.zlibOptions);
+                        break;
+                    case "deflate":
+                        compressed = await promisify(zlib.deflate)(body, config.zlibOptions);
+                        break;
+                    default:
+                        return;
+                }
+                // Only use if smaller
+                if (compressed.length >= body.length)
+                    return;
+                // Set headers and return compressed body
+                set.headers["content-encoding"] = encoding;
+                set.headers["vary"] = "Accept-Encoding";
+                delete set.headers["content-length"]; // Let Elysia set this
+                return compressed;
+            }
+            catch (error) {
+                console.error("[Compression Error]:", error);
+                return; // Return original on error
+            }
+        });
+    };
+}

package/dist/request.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Request Wrapper for WynkJS Framework
+ * Provides a clean API for accessing request data and adding custom properties
+ */
+export interface CookieOptions {
+    domain?: string;
+    expires?: Date;
+    httpOnly?: boolean;
+    maxAge?: number;
+    path?: string;
+    sameSite?: boolean | "lax" | "strict" | "none";
+    secure?: boolean;
+    priority?: "low" | "medium" | "high";
+    partitioned?: boolean;
+}
+/**
+ * Request class - wraps Elysia context for request operations
+ * Allows middleware to add custom properties that persist through the request lifecycle
+ */
+export declare class Request {
+    private ctx;
+    private customData;
+    private originalRequest;
+    constructor(ctx: any);
+    /**
+     * Get request body
+     */
+    get body(): any;
+    /**
+     * Get route parameters
+     */
+    get params(): any;
+    /**
+     * Get query parameters
+     */
+    get query(): any;
+    /**
+     * Get request headers
+     */
+    get headers(): any;
+    /**
+     * Get request method (GET, POST, etc.)
+     */
+    get method(): string;
+    /**
+     * Get request URL
+     */
+    get url(): string;
+    /**
+     * Get request path
+     */
+    get path(): string;
+    /**
+     * Get client IP address
+     */
+    get ip(): string | undefined;
+    /**
+     * Get cookies from request
+     */
+    get cookies(): Record<string, string>;
+    /**
+     * Get a specific cookie value
+     */
+    getCookie(name: string): string | undefined;
+    /**
+     * Get user object (set by authentication middleware)
+     */
+    get user(): any;
+    /**
+     * Set user object (typically used by authentication middleware)
+     */
+    set user(value: any);
+    /**
+     * Get the raw Elysia context
+     */
+    get raw(): any;
+    /**
+     * Get the Response wrapper instance
+     */
+    getResponse(): any;
+    /**
+     * Set custom data that persists through request lifecycle
+     * Useful for middleware to pass data to handlers
+     *
+     * @example
+     * // In middleware
+     * request.set('startTime', Date.now());
+     *
+     * // In handler
+     * const startTime = request.get('startTime');
+     */
+    set(key: string, value: any): this;
+    /**
+     * Get custom data set by middleware
+     */
+    get(key: string): any;
+    /**
+     * Check if custom data exists
+     */
+    has(key: string): boolean;
+    /**
+     * Delete custom data
+     */
+    delete(key: string): boolean;
+    /**
+     * Get all custom data
+     */
+    getAllCustomData(): Record<string, any>;
+    /**
+     * Check if request accepts a certain content type
+     */
+    accepts(type: string): boolean;
+    /**
+     * Check if request is JSON
+     */
+    isJson(): boolean;
+    /**
+     * Check if request is form data
+     */
+    isFormData(): boolean;
+    /**
+     * Get bearer token from Authorization header
+     */
+    getBearerToken(): string | undefined;
+}
+export type WynkRequest = Request;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../core/request.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,eAAe,CAAM;gBAEjB,GAAG,EAAE,GAAG;IAMpB;;OAEG;IACH,IAAI,IAAI,IAAI,GAAG,CAEd;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,GAAG,CAEhB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,GAAG,CAEf;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,GAAG,CAoBjB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,GAAG,SAAS,CAM3B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAapC;IAED;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C;;OAEG;IACH,IAAI,IAAI,IAAI,GAAG,CAEd;IAED;;OAEG;IACH,IAAI,IAAI,CAAC,KAAK,EAAE,GAAG,EAElB;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,GAAG,CAEb;IAED;;OAEG;IACH,WAAW,IAAI,GAAG;IAIlB;;;;;;;;;;OAUG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAUlC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAIrB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B;;OAEG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAQvC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK9B;;OAEG;IACH,MAAM,IAAI,OAAO;IAKjB;;OAEG;IACH,UAAU,IAAI,OAAO;IAKrB;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,SAAS;CAOrC;AAGD,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC"}