wynkjs 1.0.7 → 1.0.8

package/README.md

@@ -573,6 +573,82 @@ export function myPlugin(options = {}) {
 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

package/dist/index.d.ts

@@ -21,6 +21,13 @@ 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";

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,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"}
+{"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,6 +40,9 @@ 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

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"}

package/dist/request.js

@@ -0,0 +1,213 @@
+/**
+ * Request Wrapper for WynkJS Framework
+ * Provides a clean API for accessing request data and adding custom properties
+ */
+/**
+ * Request class - wraps Elysia context for request operations
+ * Allows middleware to add custom properties that persist through the request lifecycle
+ */
+export class Request {
+    ctx;
+    customData = new Map();
+    originalRequest;
+    constructor(ctx) {
+        this.ctx = ctx;
+        // Store reference to original request object before it gets overwritten
+        this.originalRequest = ctx.request;
+    }
+    /**
+     * Get request body
+     */
+    get body() {
+        return this.ctx.body;
+    }
+    /**
+     * Get route parameters
+     */
+    get params() {
+        return this.ctx.params;
+    }
+    /**
+     * Get query parameters
+     */
+    get query() {
+        return this.ctx.query;
+    }
+    /**
+     * Get request headers
+     */
+    get headers() {
+        // Get headers from ctx or from the original Elysia request object
+        const headers = this.ctx.headers || this.originalRequest?.headers;
+        if (!headers)
+            return {};
+        // If headers is a plain object, wrap it to provide get() method
+        if (typeof headers === 'object' && !headers.get) {
+            return {
+                ...headers,
+                get(name) {
+                    return headers[name] || headers[name.toLowerCase()];
+                },
+                has(name) {
+                    return name in headers || name.toLowerCase() in headers;
+                }
+            };
+        }
+        return headers;
+    }
+    /**
+     * Get request method (GET, POST, etc.)
+     */
+    get method() {
+        return this.originalRequest?.method || this.ctx.method || "GET";
+    }
+    /**
+     * Get request URL
+     */
+    get url() {
+        return this.originalRequest?.url || this.ctx.url || "";
+    }
+    /**
+     * Get request path
+     */
+    get path() {
+        return this.ctx.path || new URL(this.url).pathname;
+    }
+    /**
+     * Get client IP address
+     */
+    get ip() {
+        return (this.headers.get?.("x-forwarded-for") ||
+            this.headers.get?.("x-real-ip") ||
+            this.originalRequest?.ip);
+    }
+    /**
+     * Get cookies from request
+     */
+    get cookies() {
+        const cookieHeader = this.headers.get?.("cookie");
+        if (!cookieHeader)
+            return {};
+        const cookies = {};
+        cookieHeader.split(";").forEach((cookie) => {
+            const [name, ...rest] = cookie.split("=");
+            if (name && rest.length > 0) {
+                cookies[name.trim()] = rest.join("=").trim();
+            }
+        });
+        return cookies;
+    }
+    /**
+     * Get a specific cookie value
+     */
+    getCookie(name) {
+        return this.cookies[name];
+    }
+    /**
+     * Get user object (set by authentication middleware)
+     */
+    get user() {
+        return this.ctx.user;
+    }
+    /**
+     * Set user object (typically used by authentication middleware)
+     */
+    set user(value) {
+        this.ctx.user = value;
+    }
+    /**
+     * Get the raw Elysia context
+     */
+    get raw() {
+        return this.ctx;
+    }
+    /**
+     * Get the Response wrapper instance
+     */
+    getResponse() {
+        return this.ctx.response;
+    }
+    /**
+     * 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, value) {
+        this.customData.set(key, value);
+        // Also set on ctx for backward compatibility
+        if (!this.ctx.customData) {
+            this.ctx.customData = {};
+        }
+        this.ctx.customData[key] = value;
+        return this;
+    }
+    /**
+     * Get custom data set by middleware
+     */
+    get(key) {
+        return this.customData.get(key) || this.ctx.customData?.[key];
+    }
+    /**
+     * Check if custom data exists
+     */
+    has(key) {
+        return this.customData.has(key) || (this.ctx.customData && key in this.ctx.customData);
+    }
+    /**
+     * Delete custom data
+     */
+    delete(key) {
+        const deleted = this.customData.delete(key);
+        if (this.ctx.customData && key in this.ctx.customData) {
+            delete this.ctx.customData[key];
+        }
+        return deleted;
+    }
+    /**
+     * Get all custom data
+     */
+    getAllCustomData() {
+        const data = {};
+        this.customData.forEach((value, key) => {
+            data[key] = value;
+        });
+        return { ...data, ...this.ctx.customData };
+    }
+    /**
+     * Check if request accepts a certain content type
+     */
+    accepts(type) {
+        const acceptHeader = this.headers.get?.("accept") || "";
+        return acceptHeader.includes(type);
+    }
+    /**
+     * Check if request is JSON
+     */
+    isJson() {
+        const contentType = this.headers.get?.("content-type") || "";
+        return contentType.includes("application/json");
+    }
+    /**
+     * Check if request is form data
+     */
+    isFormData() {
+        const contentType = this.headers.get?.("content-type") || "";
+        return contentType.includes("multipart/form-data") || contentType.includes("application/x-www-form-urlencoded");
+    }
+    /**
+     * Get bearer token from Authorization header
+     */
+    getBearerToken() {
+        const authHeader = this.headers.get?.("authorization");
+        if (!authHeader || !authHeader.startsWith("Bearer ")) {
+            return undefined;
+        }
+        return authHeader.substring(7);
+    }
+}

package/dist/response.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Response Wrapper for WynkJS Framework
+ * Provides a clean API for setting cookies, headers, status codes, and sending responses
+ */
+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;
+}
+/**
+ * Response class - wraps Elysia context for response operations
+ * Provides methods to set cookies, headers, status codes, and control response behavior
+ */
+export declare class Response {
+    private ctx;
+    private _headers;
+    private _cookies;
+    private _status?;
+    constructor(ctx: any);
+    /**
+     * Set HTTP status code
+     */
+    status(code: number): this;
+    /**
+     * Get current status code
+     */
+    getStatus(): number;
+    /**
+     * Set a response header
+     */
+    header(name: string, value: string): this;
+    /**
+     * Set multiple headers at once
+     */
+    headers(headers: Record<string, string>): this;
+    /**
+     * Get a response header
+     */
+    getHeader(name: string): string | undefined;
+    /**
+     * Remove a response header
+     */
+    removeHeader(name: string): this;
+    /**
+     * Set a cookie
+     *
+     * @example
+     * response.cookie('sessionId', '12345', {
+     *   httpOnly: true,
+     *   secure: true,
+     *   maxAge: 3600,
+     *   sameSite: 'strict'
+     * });
+     */
+    cookie(name: string, value: string, options?: CookieOptions): this;
+    /**
+     * Clear a cookie by setting it to expire immediately
+     */
+    clearCookie(name: string, options?: Pick<CookieOptions, "domain" | "path">): this;
+    /**
+     * Get all cookies that have been set
+     */
+    getCookies(): Map<string, {
+        value: string;
+        options?: CookieOptions;
+    }>;
+    /**
+     * Send JSON response
+     */
+    json(data: any): any;
+    /**
+     * Send HTML response
+     */
+    html(content: string): string;
+    /**
+     * Send plain text response
+     */
+    text(content: string): string;
+    /**
+     * Redirect to a different URL
+     */
+    redirect(url: string, statusCode?: number): void;
+    /**
+     * Set content type
+     */
+    type(contentType: string): this;
+    /**
+     * Set cache control
+     */
+    cache(maxAge: number, options?: {
+        private?: boolean;
+        noCache?: boolean;
+        noStore?: boolean;
+    }): this;
+    /**
+     * Disable caching
+     */
+    noCache(): this;
+    /**
+     * Set CORS headers
+     */
+    cors(options?: {
+        origin?: string;
+        methods?: string[];
+        headers?: string[];
+        credentials?: boolean;
+        maxAge?: number;
+    }): this;
+    /**
+     * Get the raw Elysia set object
+     */
+    get raw(): any;
+    /**
+     * Send a file download
+     */
+    download(filename: string): this;
+    /**
+     * Send response with custom status code
+     */
+    send(data: any, statusCode?: number): any;
+}
+export type WynkResponse = Response;
+//# sourceMappingURL=response.d.ts.map

package/dist/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../core/response.ts"],"names":[],"mappings":"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"}

package/dist/response.js

@@ -0,0 +1,260 @@
+/**
+ * Response Wrapper for WynkJS Framework
+ * Provides a clean API for setting cookies, headers, status codes, and sending responses
+ */
+/**
+ * Response class - wraps Elysia context for response operations
+ * Provides methods to set cookies, headers, status codes, and control response behavior
+ */
+export class Response {
+    ctx;
+    _headers = new Map();
+    _cookies = new Map();
+    _status;
+    constructor(ctx) {
+        this.ctx = ctx;
+        // Initialize Elysia's set object if it doesn't exist
+        if (!this.ctx.set) {
+            this.ctx.set = {
+                headers: {},
+                status: 200,
+            };
+        }
+        if (!this.ctx.set.headers) {
+            this.ctx.set.headers = {};
+        }
+    }
+    /**
+     * Set HTTP status code
+     */
+    status(code) {
+        this._status = code;
+        this.ctx.set.status = code;
+        return this;
+    }
+    /**
+     * Get current status code
+     */
+    getStatus() {
+        return this._status || this.ctx.set.status || 200;
+    }
+    /**
+     * Set a response header
+     */
+    header(name, value) {
+        this._headers.set(name, value);
+        this.ctx.set.headers[name] = value;
+        return this;
+    }
+    /**
+     * Set multiple headers at once
+     */
+    headers(headers) {
+        Object.entries(headers).forEach(([name, value]) => {
+            this.header(name, value);
+        });
+        return this;
+    }
+    /**
+     * Get a response header
+     */
+    getHeader(name) {
+        return this._headers.get(name) || this.ctx.set.headers[name];
+    }
+    /**
+     * Remove a response header
+     */
+    removeHeader(name) {
+        this._headers.delete(name);
+        delete this.ctx.set.headers[name];
+        return this;
+    }
+    /**
+     * Set a cookie
+     *
+     * @example
+     * response.cookie('sessionId', '12345', {
+     *   httpOnly: true,
+     *   secure: true,
+     *   maxAge: 3600,
+     *   sameSite: 'strict'
+     * });
+     */
+    cookie(name, value, options) {
+        this._cookies.set(name, { value, options });
+        // Build cookie string
+        let cookieString = `${name}=${value}`;
+        if (options) {
+            if (options.domain) {
+                cookieString += `; Domain=${options.domain}`;
+            }
+            if (options.expires) {
+                cookieString += `; Expires=${options.expires.toUTCString()}`;
+            }
+            if (options.httpOnly) {
+                cookieString += "; HttpOnly";
+            }
+            if (options.maxAge !== undefined) {
+                cookieString += `; Max-Age=${options.maxAge}`;
+            }
+            if (options.path) {
+                cookieString += `; Path=${options.path}`;
+            }
+            else {
+                cookieString += "; Path=/"; // Default path
+            }
+            if (options.sameSite) {
+                const sameSiteValue = typeof options.sameSite === "boolean"
+                    ? "Strict"
+                    : options.sameSite.charAt(0).toUpperCase() + options.sameSite.slice(1);
+                cookieString += `; SameSite=${sameSiteValue}`;
+            }
+            if (options.secure) {
+                cookieString += "; Secure";
+            }
+            if (options.priority) {
+                cookieString += `; Priority=${options.priority.charAt(0).toUpperCase() + options.priority.slice(1)}`;
+            }
+            if (options.partitioned) {
+                cookieString += "; Partitioned";
+            }
+        }
+        else {
+            cookieString += "; Path=/"; // Default path if no options
+        }
+        // Append to Set-Cookie header (can have multiple)
+        const existingSetCookie = this.ctx.set.headers["Set-Cookie"];
+        if (existingSetCookie) {
+            if (Array.isArray(existingSetCookie)) {
+                this.ctx.set.headers["Set-Cookie"] = [...existingSetCookie, cookieString];
+            }
+            else {
+                this.ctx.set.headers["Set-Cookie"] = [existingSetCookie, cookieString];
+            }
+        }
+        else {
+            this.ctx.set.headers["Set-Cookie"] = cookieString;
+        }
+        return this;
+    }
+    /**
+     * Clear a cookie by setting it to expire immediately
+     */
+    clearCookie(name, options) {
+        return this.cookie(name, "", {
+            ...options,
+            expires: new Date(0),
+            maxAge: 0,
+        });
+    }
+    /**
+     * Get all cookies that have been set
+     */
+    getCookies() {
+        return this._cookies;
+    }
+    /**
+     * Send JSON response
+     */
+    json(data) {
+        this.header("Content-Type", "application/json");
+        return data;
+    }
+    /**
+     * Send HTML response
+     */
+    html(content) {
+        this.header("Content-Type", "text/html");
+        return content;
+    }
+    /**
+     * Send plain text response
+     */
+    text(content) {
+        this.header("Content-Type", "text/plain");
+        return content;
+    }
+    /**
+     * Redirect to a different URL
+     */
+    redirect(url, statusCode = 302) {
+        this.ctx.set.redirect = url;
+        this.ctx.set.status = statusCode;
+    }
+    /**
+     * Set content type
+     */
+    type(contentType) {
+        return this.header("Content-Type", contentType);
+    }
+    /**
+     * Set cache control
+     */
+    cache(maxAge, options) {
+        let cacheControl = "";
+        if (options?.private) {
+            cacheControl = "private";
+        }
+        else {
+            cacheControl = "public";
+        }
+        if (options?.noCache) {
+            cacheControl += ", no-cache";
+        }
+        if (options?.noStore) {
+            cacheControl += ", no-store";
+        }
+        if (maxAge > 0) {
+            cacheControl += `, max-age=${maxAge}`;
+        }
+        return this.header("Cache-Control", cacheControl);
+    }
+    /**
+     * Disable caching
+     */
+    noCache() {
+        return this.header("Cache-Control", "no-store, no-cache, must-revalidate, proxy-revalidate")
+            .header("Pragma", "no-cache")
+            .header("Expires", "0");
+    }
+    /**
+     * Set CORS headers
+     */
+    cors(options) {
+        this.header("Access-Control-Allow-Origin", options?.origin || "*");
+        if (options?.methods) {
+            this.header("Access-Control-Allow-Methods", options.methods.join(", "));
+        }
+        if (options?.headers) {
+            this.header("Access-Control-Allow-Headers", options.headers.join(", "));
+        }
+        if (options?.credentials) {
+            this.header("Access-Control-Allow-Credentials", "true");
+        }
+        if (options?.maxAge !== undefined) {
+            this.header("Access-Control-Max-Age", options.maxAge.toString());
+        }
+        return this;
+    }
+    /**
+     * Get the raw Elysia set object
+     */
+    get raw() {
+        return this.ctx.set;
+    }
+    /**
+     * Send a file download
+     */
+    download(filename) {
+        return this.header("Content-Disposition", `attachment; filename="${filename}"`);
+    }
+    /**
+     * Send response with custom status code
+     */
+    send(data, statusCode) {
+        if (statusCode) {
+            this.status(statusCode);
+        }
+        return data;
+    }
+}

package/dist/ultra-optimized-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ultra-optimized-handler.d.ts","sourceRoot":"","sources":["../core/ultra-optimized-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAYH,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,GAAG,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,SAAS,EAAE,GAAG,EAAE,CAAC;IACjB,eAAe,EAAE,GAAG,EAAE,CAAC;IACvB,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,mBAAmB,GAC3B,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAiU5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EACnC,WAAW,EAAE,GAAG,EAAE,GACjB,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAU5B"}
+{"version":3,"file":"ultra-optimized-handler.d.ts","sourceRoot":"","sources":["../core/ultra-optimized-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAcH,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,GAAG,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,SAAS,EAAE,GAAG,EAAE,CAAC;IACjB,eAAe,EAAE,GAAG,EAAE,CAAC;IACvB,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,mBAAmB,GAC3B,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAgV5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EACnC,WAAW,EAAE,GAAG,EAAE,GACjB,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAqB5B"}

package/dist/ultra-optimized-handler.js

@@ -23,6 +23,8 @@
 import { createExecutionContext, executeGuards, } from "./decorators/guard.decorators";
 import { executeInterceptors } from "./decorators/interceptor.decorators";
 import { executePipes } from "./decorators/pipe.decorators";
+import { Request } from "./request";
+import { Response } from "./response";
 import { executeExceptionFilters, HttpException, } from "./decorators/exception.decorators";
 /**
  * Ultra-optimized handler builder
@@ -52,6 +54,11 @@ export function buildUltraOptimizedHandler(options) {
         !hasResponseModifiers) {
         // Direct call - zero overhead!
         return async (ctx) => {
+            if (!ctx.__wynk_wrapped__) {
+                ctx.request = new Request(ctx);
+                ctx.response = new Response(ctx);
+                ctx.__wynk_wrapped__ = true;
+            }
             return await instance[methodName](ctx);
         };
     }
@@ -62,6 +69,11 @@ export function buildUltraOptimizedHandler(options) {
         !hasResponseModifiers &&
         hasParams) {
         return async (ctx) => {
+            if (!ctx.__wynk_wrapped__) {
+                ctx.request = new Request(ctx);
+                ctx.response = new Response(ctx);
+                ctx.__wynk_wrapped__ = true;
+            }
             const args = new Array(params.length);
             for (const param of params) {
                 let value;
@@ -129,6 +141,11 @@ export function buildUltraOptimizedHandler(options) {
     // CASE 3: Full-featured handler (has guards/interceptors/filters)
     // This is where we MUST use try-catch, but still avoid nested async
     return async (ctx) => {
+        if (!ctx.__wynk_wrapped__) {
+            ctx.request = new Request(ctx);
+            ctx.response = new Response(ctx);
+            ctx.__wynk_wrapped__ = true;
+        }
         try {
             // Guards
             if (hasGuards) {
@@ -294,9 +311,19 @@ export function buildMiddlewareChain(handler, middlewares) {
     if (middlewares.length === 0) {
         return handler;
     }
-    return middlewares.reduceRight((next, middleware) => {
+    // Build chain without wrapping in each layer
+    const chain = middlewares.reduceRight((next, middleware) => {
         return async (ctx) => {
             return await middleware(ctx, () => next(ctx));
         };
     }, handler);
+    // Wrap ONCE at the top level
+    return async (ctx) => {
+        if (!ctx.__wynk_wrapped__) {
+            ctx.request = new Request(ctx);
+            ctx.response = new Response(ctx);
+            ctx.__wynk_wrapped__ = true;
+        }
+        return await chain(ctx);
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wynkjs",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "A high-performance TypeScript framework built on Elysia for Bun with elegant decorator-based architecture, built-in compression, and plugin system - 10x faster than Express/NestJS",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -51,7 +51,9 @@
     "test:all": "bun test tests/",
     "test:core": "bash tests/test-core.sh",
     "test:watch": "bun test tests/ --watch",
-    "test:coverage": "bun test tests/ --coverage"
+    "test:coverage": "bun test tests/ --coverage",
+    "test:ci": "bun test tests/ --coverage",
+    "ci": "bun test tests/ --coverage"
   },
   "peerDependencies": {},
   "devDependencies": {
@@ -73,9 +75,10 @@
     "LICENSE"
   ],
   "dependencies": {
+    "@elysiajs/cors": "^1.4.0",
+    "@elysiajs/swagger": "^1.3.1",
     "elysia": "^1.0.0",
     "reflect-metadata": "^0.2.2",
-    "@elysiajs/cors": "^1.4.0",
     "tsyringe": "^4.10.0"
   }
 }