@engjts/nexus 0.1.7 → 0.1.9

package/dist/core/context.d.ts

@@ -5,28 +5,115 @@
 import { IncomingMessage, ServerResponse } from 'http';
 import { Context, Headers, Cookies, ResponseBuilder, Response, HTTPMethod } from './types';
 import { ContextStore, StoreConstructor, StoreRegistry, RequestStore, RequestStoreConstructor, RequestStoreRegistry } from './store';
+import { SerializerFunction } from './serializer';
 /**
  * Context implementation
  */
 export declare class ContextImpl implements Context {
     method: HTTPMethod;
     path: string;
-    url: URL;
+    private _url;
+    private _host;
     params: Record<string, string>;
-    query: Record<string, any>;
-    body: any;
+    private _query;
+    private _queryString;
     headers: Headers;
-    cookies: Cookies;
+    private _cookieHeader;
+    private _cookies;
     raw: {
         req: IncomingMessage;
         res: ServerResponse;
     };
     response: ResponseBuilder;
+    private _parsedBody;
+    private _bodyPromise;
+    private _bodyParsed;
     private _storeRegistry?;
     private _requestStoreRegistry;
     private _data;
     private _debug;
     constructor(req: IncomingMessage, res: ServerResponse);
+    /**
+     * Lazy URL getter - only create URL object when accessed
+     * Most handlers don't need the full URL object
+     */
+    get url(): URL;
+    set url(value: URL);
+    /**
+     * Lazy query getter - only parse query string when accessed
+     * Most simple endpoints like /json don't need query parsing
+     * Inline fast-querystring for minimal overhead
+     */
+    get query(): Record<string, any>;
+    set query(value: Record<string, any>);
+    /**
+     * Lazy cookies getter - only parse cookies when accessed
+     */
+    get cookies(): Cookies;
+    set cookies(value: Cookies);
+    /**
+     * Reinitialize context for pooling (avoids new object creation)
+     */
+    reinitialize(req: IncomingMessage, res: ServerResponse): void;
+    /**
+     * Lazy body getter - parses body on first access
+     * This is the KEY optimization that fixes POST performance!
+     */
+    get body(): any;
+    /**
+     * Set body directly (for backwards compatibility)
+     */
+    set body(value: any);
+    /**
+     * Check if body is ready for sync access (no await needed)
+     */
+    get isBodyReady(): boolean;
+    /**
+     * Wait for body to be parsed
+     * Use this if you need to ensure body is available for sync access
+     * @example
+     * ```typescript
+     * app.post('/data', async (ctx) => {
+     *   await ctx.waitForBody();
+     *   console.log(ctx.body); // Now safe to access synchronously
+     * });
+     * ```
+     */
+    waitForBody(): Promise<any>;
+    /**
+     * Async body getter - use this in handlers for POST/PUT/PATCH
+     * @example
+     * ```typescript
+     * app.post('/data', async (ctx) => {
+     *   const body = await ctx.getBody();
+     *   return { received: body };
+     * });
+     * ```
+     */
+    getBody<T = any>(): Promise<T>;
+    /**
+     * Ultra-optimized body parser inspired by Fastify's approach
+     * Key optimizations:
+     * 1. Pre-check content-type before reading data
+     * 2. Use direct string concatenation with setEncoding
+     * 3. Minimal closure allocation
+     * 4. Fast-path for JSON (most common case)
+     */
+    private parseBodyOptimized;
+    /**
+     * Internal body parser - optimized for performance
+     * Uses string accumulation instead of Buffer.concat for better perf
+     * @deprecated Use parseBodyOptimized instead
+     */
+    private parseBodyInternal;
+    /**
+     * Parse body based on content type
+     */
+    private parseContentType;
+    /**
+     * Clear body state (for pooling)
+     */
+    clearBody(): void;
     json<T>(data: T, status?: number): Response;
     html(content: string, status?: number): Response;
     text(content: string, status?: number): Response;
@@ -48,6 +135,14 @@ export declare class ContextImpl implements Context {
      * ```
      */
     store<T extends ContextStore<any>>(StoreClass: StoreConstructor<T>): T;
+    /**
+     * Lazy getter for request store registry
+     */
+    private getOrCreateRequestStoreRegistry;
+    /**
+     * Lazy getter for request data map
+     */
+    private getOrCreateData;
     /**
      * Access a request-scoped store by its class
      * Store only exists for this request, disposed after response
@@ -133,7 +228,14 @@ export declare class ContextImpl implements Context {
      */
     setParams(params: Record<string, string>): void;
     /**
-     * Set request body (called after parsing)
+     * Set response serializers for fast JSON serialization
+     * Called by router when route has response schema
+     * @internal
+     */
+    setSerializers(serializers: Map<number | string, SerializerFunction>): void;
+    /**
+     * Set request body (called after parsing or by middleware)
+     * @deprecated Use ctx.getBody() for async body access
      */
     setBody(body: any): void;
     /**
@@ -143,6 +245,7 @@ export declare class ContextImpl implements Context {
 }
 /**
  * Parse request body based on Content-Type
+ * @deprecated Use ctx.getBody() instead for lazy parsing
  */
 export declare function parseBody(req: IncomingMessage): Promise<any>;
 //# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

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