@asenajs/ergenecore 3.2.1 → 5.0.0

package/README.md

@@ -1,6 +1,6 @@
 # Asena Ergenecore Adapter
 
-[![Version](https://img.shields.io/badge/version-3.2.1-blue.svg)](https://asena.sh)
+[![Version](https://img.shields.io/npm/v/@asenajs/ergenecore.svg)](https://asena.sh)
 [![Bun Version](https://img.shields.io/badge/Bun-1.4%2B-blueviolet)](https://bun.sh)
 
 **Blazing-fast** native Bun adapter for [Asena.js](https://github.com/asenajs/asena) - Built exclusively with Bun's native APIs for maximum performance.
@@ -40,7 +40,7 @@ Ergenecore is the **fastest** Asena adapter because it:
 ## Requirements
 
 - [Bun](https://bun.sh) v1.4 or higher
-- [@asenajs/asena](https://github.com/AsenaJs/Asena) v0.10.1 or higher (peer dependency)
+- [@asenajs/asena](https://github.com/AsenaJs/Asena) v0.12.0 or higher (peer dependency)
 - [Zod](https://zod.dev) v4.3.6 or higher (peer dependency)
 - TypeScript v5.9.3 or higher (peer dependency)
 
@@ -92,7 +92,7 @@ import type { Context } from '@asenajs/ergenecore/types';
 export class UserController {
   @Get({ path: '/' })
   async list(context: Context) {
-    const page = context.getQuery('page') || '1';
+    const page = (await context.getQuery('page')) ?? '1';
     return context.send({ users: [], page });
   }
 
@@ -208,8 +208,8 @@ import type { Context } from '@asenajs/ergenecore/types';
 // Get route parameters
 const id = context.getParam('id');
 
-// Get query parameters
-const page = context.getQuery('page');
+// Get query parameters (undefined when absent, '' when present but empty, e.g. "?page=")
+const page = await context.getQuery('page');
 
 // Get request body
 const body = await context.getBody();
@@ -226,6 +226,13 @@ return context.send({ success: true });
 // Send with custom status
 return context.send({ error: 'Not found' }, 404);
 
+// Set a response header (replaces any value already set for that header)
+context.setResponseHeader('X-Request-Id', 'abc');
+
+// Append to a response header, keeping existing values - for multi-valued
+// headers such as Vary and Link (Set-Cookie is not supported here; use setCookie)
+context.appendResponseHeader('Vary', 'Origin');
+
 // Set cookies
 context.setCookie('session', 'abc123', {
   httpOnly: true,

package/dist/lib/Ergenecore.d.ts

@@ -54,6 +54,7 @@ export declare class Ergenecore extends AsenaAdapter<Context, ValidationSchemaWi
      * Handler for requests that matched no route
      */
     private notFoundHandler?;
+    private readonly staticFileReader;
     /**
      * Whether the adapter logs errors before handing them to the application.
      * Set false when your own handler already logs with a correlation id.
@@ -413,6 +414,10 @@ export declare class Ergenecore extends AsenaAdapter<Context, ValidationSchemaWi
      * @returns Bun-compatible route handler
      */
     private createRouteHandler;
+    private runRouteHandler;
+    private settleRoute;
+    private finishRoute;
+    private failRoute;
     /**
      * Type guard to check if validation schema has hook format
      *
@@ -432,6 +437,9 @@ export declare class Ergenecore extends AsenaAdapter<Context, ValidationSchemaWi
      * ```
      */
     private isValidationSchemaWithHook;
+    /** Prepare each legacy validator target once for this route, preserving method order. */
+    private prepareValidationSteps;
+    private unwrapValidationSchema;
     /**
      * Validates request data using Zod schemas
      *
@@ -455,7 +463,7 @@ export declare class Ergenecore extends AsenaAdapter<Context, ValidationSchemaWi
      * @param target - Validation target (body, query, param, header, form)
      * @returns Data to be validated
      */
-    private extractValidationData;
+    private createValidationExtractor;
     /**
      * Serves static files using Bun.file() API
      *
@@ -482,6 +490,9 @@ export declare class Ergenecore extends AsenaAdapter<Context, ValidationSchemaWi
      * ```
      */
     private serveStaticFile;
+    private statFileResponse;
+    private serveResolvedStaticFile;
+    private withStaticExtras;
     /**
      * Builds response headers for static file serving
      *