@hazeljs/core 0.2.0-beta.8 → 0.2.0-beta.80

package/dist/decorators.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HazelApp = exports.Module = exports.HazelModule = void 0;
+exports.HazelApp = exports.SkipAuth = exports.Module = exports.HazelModule = exports.CUSTOM_METADATA_PREFIX = void 0;
 exports.Controller = Controller;
 exports.Injectable = Injectable;
 exports.Get = Get;
@@ -27,8 +27,21 @@ exports.HttpCode = HttpCode;
 exports.Header = Header;
 exports.Redirect = Redirect;
 exports.Res = Res;
+exports.Ip = Ip;
+exports.Host = Host;
+exports.Public = Public;
+exports.Timeout = Timeout;
+exports.Optional = Optional;
+exports.Session = Session;
+exports.Retry = Retry;
+exports.ApiTags = ApiTags;
+exports.ApiOperation = ApiOperation;
+exports.SetMetadata = SetMetadata;
+exports.getMetadata = getMetadata;
+exports.createParamDecorator = createParamDecorator;
 require("reflect-metadata");
 const logger_1 = __importDefault(require("./logger"));
+const interceptor_1 = require("./interceptors/interceptor");
 const hazel_app_1 = require("./hazel-app");
 Object.defineProperty(exports, "HazelApp", { enumerable: true, get: function () { return hazel_app_1.HazelApp; } });
 const CONTROLLER_METADATA_KEY = 'hazel:controller';
@@ -42,6 +55,13 @@ const CLASS_INTERCEPTOR_METADATA_KEY = 'hazel:class-interceptors';
 const HTTP_CODE_METADATA_KEY = 'hazel:http-code';
 const HEADER_METADATA_KEY = 'hazel:headers';
 const REDIRECT_METADATA_KEY = 'hazel:redirect';
+const PUBLIC_METADATA_KEY = 'hazel:public';
+const TIMEOUT_METADATA_KEY = 'hazel:timeout';
+const OPTIONAL_INDICES_METADATA_KEY = 'hazel:optional-indices';
+const RETRY_METADATA_KEY = 'hazel:retry';
+const API_TAGS_METADATA_KEY = 'hazel:api:tags';
+const API_OPERATION_METADATA_KEY = 'hazel:api:operation';
+exports.CUSTOM_METADATA_PREFIX = 'hazel:meta:';
 // Re-export from hazel-module for backward compatibility
 var hazel_module_1 = require("./hazel-module");
 Object.defineProperty(exports, "HazelModule", { enumerable: true, get: function () { return hazel_module_1.HazelModule; } });
@@ -313,6 +333,181 @@ function Res() {
         logger_1.default.debug('Updated injections:', JSON.stringify(injections, null, 2));
     };
 }
+function Ip() {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey) {
+            throw new Error('Ip decorator must be used on a method parameter');
+        }
+        const constructor = target
+            .constructor;
+        const injections = Reflect.getMetadata(INJECT_METADATA_KEY, constructor, propertyKey) || [];
+        injections[parameterIndex] = { type: 'ip' };
+        Reflect.defineMetadata(INJECT_METADATA_KEY, injections, constructor, propertyKey);
+    };
+}
+function Host() {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey) {
+            throw new Error('Host decorator must be used on a method parameter');
+        }
+        const constructor = target
+            .constructor;
+        const injections = Reflect.getMetadata(INJECT_METADATA_KEY, constructor, propertyKey) || [];
+        injections[parameterIndex] = { type: 'host' };
+        Reflect.defineMetadata(INJECT_METADATA_KEY, injections, constructor, propertyKey);
+    };
+}
+/**
+ * Marks a controller or route as public (no auth required).
+ * Guards should check Reflect.getMetadata(PUBLIC_METADATA_KEY, target, propertyKey)
+ * or Reflect.getMetadata(PUBLIC_METADATA_KEY, target) and allow the request when true.
+ */
+function Public() {
+    const setPublic = (target, propertyKey) => {
+        if (propertyKey === undefined) {
+            Reflect.defineMetadata(PUBLIC_METADATA_KEY, true, target);
+        }
+        else {
+            Reflect.defineMetadata(PUBLIC_METADATA_KEY, true, target, propertyKey);
+        }
+    };
+    const decorator = (target, propertyKey, descriptor) => {
+        if (propertyKey !== undefined && descriptor !== undefined) {
+            setPublic(target, propertyKey);
+            return descriptor;
+        }
+        setPublic(target);
+    };
+    return decorator;
+}
+/** Alias for @Public(). Use when you want to skip auth for specific routes. */
+exports.SkipAuth = Public;
+function Timeout(ms) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(TIMEOUT_METADATA_KEY, ms, target, propertyKey);
+        return descriptor;
+    };
+}
+function Optional() {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey) {
+            throw new Error('Optional decorator must be used on a method parameter');
+        }
+        const constructor = target
+            .constructor;
+        const indices = Reflect.getMetadata(OPTIONAL_INDICES_METADATA_KEY, constructor, propertyKey) || [];
+        if (!indices.includes(parameterIndex)) {
+            indices.push(parameterIndex);
+        }
+        Reflect.defineMetadata(OPTIONAL_INDICES_METADATA_KEY, indices, constructor, propertyKey);
+    };
+}
+function Session() {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey) {
+            throw new Error('Session decorator must be used on a method parameter');
+        }
+        const constructor = target
+            .constructor;
+        const injections = Reflect.getMetadata(INJECT_METADATA_KEY, constructor, propertyKey) || [];
+        injections[parameterIndex] = { type: 'session' };
+        Reflect.defineMetadata(INJECT_METADATA_KEY, injections, constructor, propertyKey);
+    };
+}
+function Retry(options) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(RETRY_METADATA_KEY, options, target, propertyKey);
+        const routes = Reflect.getMetadata(ROUTE_METADATA_KEY, target.constructor) || [];
+        const route = routes.find((r) => r.propertyKey === propertyKey);
+        if (route) {
+            route.interceptors = route.interceptors || [];
+            route.interceptors.unshift({ type: interceptor_1.RetryInterceptor, options });
+            Reflect.defineMetadata(ROUTE_METADATA_KEY, routes, target.constructor);
+        }
+        return descriptor;
+    };
+}
+function ApiTags(...tags) {
+    const setTags = (target, propertyKey) => {
+        if (propertyKey === undefined) {
+            Reflect.defineMetadata(API_TAGS_METADATA_KEY, tags, target);
+        }
+        else {
+            Reflect.defineMetadata(API_TAGS_METADATA_KEY, tags, target, propertyKey);
+        }
+    };
+    const decorator = (target, propertyKey, descriptor) => {
+        if (propertyKey !== undefined && descriptor !== undefined) {
+            setTags(target, propertyKey);
+            return descriptor;
+        }
+        setTags(target);
+    };
+    return decorator;
+}
+function ApiOperation(options) {
+    const opts = typeof options === 'string' ? { summary: options } : options;
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(API_OPERATION_METADATA_KEY, opts, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Sets arbitrary metadata on a class or method.
+ * Guards, interceptors, and other components can read it via getMetadata(key, target, propertyKey?).
+ *
+ * @param key - Metadata key (stored under hazel:meta:<key> to avoid collisions)
+ * @param value - Value to store (any serializable or object)
+ * @example
+ * SetMetadata('roles', ['admin'])(MyController)
+ * SetMetadata('roles', ['user'])(MyController.prototype, 'getProfile')
+ */
+function SetMetadata(key, value) {
+    const metaKey = `${exports.CUSTOM_METADATA_PREFIX}${key}`;
+    const decorator = (target, propertyKey, descriptor) => {
+        if (propertyKey !== undefined && descriptor !== undefined) {
+            Reflect.defineMetadata(metaKey, value, target, propertyKey);
+            return descriptor;
+        }
+        Reflect.defineMetadata(metaKey, value, target);
+    };
+    return decorator;
+}
+/**
+ * Reads custom metadata set with SetMetadata.
+ *
+ * @param key - Key passed to SetMetadata(key, value)
+ * @param target - Class or prototype
+ * @param propertyKey - Optional method name (for method-level metadata)
+ */
+function getMetadata(key, target, propertyKey) {
+    const metaKey = `${exports.CUSTOM_METADATA_PREFIX}${key}`;
+    if (propertyKey !== undefined) {
+        return Reflect.getMetadata(metaKey, target, propertyKey);
+    }
+    return Reflect.getMetadata(metaKey, target);
+}
+/**
+ * Creates a custom parameter decorator that injects a value computed from the request.
+ * The resolver receives the raw request, parsed request context, and the DI container.
+ * Return value can be a Promise for async resolution (e.g. loading the current user from DB).
+ *
+ * @param resolve - Function (req, context, container) => value | Promise<value>
+ * @example
+ * const CurrentUser = createParamDecorator(async (req, ctx, container) => ctx.user ?? req.user);
+ * // In controller: getProfile(@CurrentUser() user: User) { ... }
+ */
+function createParamDecorator(resolve) {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey) {
+            throw new Error('createParamDecorator must be used on a method parameter');
+        }
+        const constructor = target.constructor;
+        const injections = Reflect.getMetadata(INJECT_METADATA_KEY, constructor, propertyKey) || [];
+        injections[parameterIndex] = { type: 'custom', resolve };
+        Reflect.defineMetadata(INJECT_METADATA_KEY, injections, constructor, propertyKey);
+    };
+}
 function createRouteDecorator(method, options) {
     return (target, propertyKey, descriptor) => {
         logger_1.default.debug(`Registering ${method} route: ${String(propertyKey)}`);

package/dist/errors/http.error.d.ts

@@ -18,6 +18,9 @@ export declare class NotFoundError extends HttpError {
 export declare class ConflictError extends HttpError {
     constructor(message: string);
 }
+export declare class RequestTimeoutError extends HttpError {
+    constructor(message?: string);
+}
 export declare class InternalServerError extends HttpError {
     constructor(message?: string);
 }

package/dist/errors/http.error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.error.d.ts","sourceRoot":"","sources":["../../src/errors/http.error.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;aAEhB,UAAU,EAAE,MAAM;aAElB,MAAM,CAAC,EAAE,MAAM,EAAE;gBAFjB,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAA;CAKpC;AAED,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE;CAI/C;AAED,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,OAAO,GAAE,MAAuB;CAI7C;AAED,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,OAAO,GAAE,MAAoB;CAI1C;AAED,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,GAAE,MAAoB;CAI1C;AAED,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,GAAE,MAAgC;CAItD;AAGD,eAAO,MAAM,aAAa,kBAAY,CAAC;AACvC,eAAO,MAAM,mBAAmB,wBAAkB,CAAC;AACnD,eAAO,MAAM,qBAAqB,0BAAoB,CAAC;AACvD,eAAO,MAAM,kBAAkB,uBAAiB,CAAC;AACjD,eAAO,MAAM,iBAAiB,sBAAgB,CAAC;AAC/C,eAAO,MAAM,iBAAiB,sBAAgB,CAAC;AAC/C,eAAO,MAAM,4BAA4B,4BAAsB,CAAC"}
+{"version":3,"file":"http.error.d.ts","sourceRoot":"","sources":["../../src/errors/http.error.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;aAEhB,UAAU,EAAE,MAAM;aAElB,MAAM,CAAC,EAAE,MAAM,EAAE;gBAFjB,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAA;CAKpC;AAED,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE;CAI/C;AAED,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,OAAO,GAAE,MAAuB;CAI7C;AAED,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,OAAO,GAAE,MAAoB;CAI1C;AAED,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,GAAE,MAAoB;CAI1C;AAED,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,GAAE,MAA0B;CAIhD;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,GAAE,MAAgC;CAItD;AAGD,eAAO,MAAM,aAAa,kBAAY,CAAC;AACvC,eAAO,MAAM,mBAAmB,wBAAkB,CAAC;AACnD,eAAO,MAAM,qBAAqB,0BAAoB,CAAC;AACvD,eAAO,MAAM,kBAAkB,uBAAiB,CAAC;AACjD,eAAO,MAAM,iBAAiB,sBAAgB,CAAC;AAC/C,eAAO,MAAM,iBAAiB,sBAAgB,CAAC;AAC/C,eAAO,MAAM,4BAA4B,4BAAsB,CAAC"}

package/dist/errors/http.error.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InternalServerErrorException = exports.ConflictException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.HttpException = exports.InternalServerError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.BadRequestError = exports.HttpError = void 0;
+exports.InternalServerErrorException = exports.ConflictException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.HttpException = exports.InternalServerError = exports.RequestTimeoutError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.BadRequestError = exports.HttpError = void 0;
 class HttpError extends Error {
     constructor(statusCode, message, errors) {
         super(message);
@@ -45,6 +45,13 @@ class ConflictError extends HttpError {
     }
 }
 exports.ConflictError = ConflictError;
+class RequestTimeoutError extends HttpError {
+    constructor(message = 'Request Timeout') {
+        super(408, message);
+        this.name = 'RequestTimeoutError';
+    }
+}
+exports.RequestTimeoutError = RequestTimeoutError;
 class InternalServerError extends HttpError {
     constructor(message = 'Internal Server Error') {
         super(500, message);

package/dist/hazel-app.d.ts

@@ -1,12 +1,17 @@
 import { Type } from './types';
 import { Container } from './container';
 import { Router } from './router';
+import { IncomingMessage, ServerResponse } from 'http';
 import 'reflect-metadata';
-import { Request, Response } from './types';
+import { Request, Response, RequestContext } from './types';
 import { ShutdownManager } from './shutdown';
 import { HealthCheckManager } from './health';
 import { TimeoutOptions } from './middleware/timeout.middleware';
 import { CorsOptions } from './middleware/cors.middleware';
+/** Early HTTP handler (e.g. for GraphQL) - receives raw req/res before body parsing */
+export type EarlyHttpHandler = (req: IncomingMessage, res: ServerResponse) => void | Promise<void>;
+/** Proxy handler - runs after body parsing, receives (req, res, context). Returns true if handled. */
+export type ProxyHandler = (req: IncomingMessage, res: ServerResponse, context: RequestContext) => Promise<boolean>;
 export declare class HazelApp {
     private readonly moduleType;
     private container;
@@ -20,6 +25,8 @@ export declare class HazelApp {
     private corsEnabled;
     private corsOptions?;
     private timeoutMiddleware?;
+    private earlyHandlers;
+    private proxyHandlers;
     constructor(moduleType: Type<unknown>);
     private initialize;
     private collectControllers;
@@ -74,5 +81,14 @@ export declare class HazelApp {
     getShutdownManager(): ShutdownManager;
     getContainer(): Container;
     getRouter(): Router;
+    /**
+     * Add an early HTTP handler (runs before body parsing, for GraphQL etc.)
+     */
+    addEarlyHandler(path: string, handler: EarlyHttpHandler): void;
+    /**
+     * Add a proxy handler (runs after body parsing, before router).
+     * Use with @hazeljs/gateway: app.addProxyHandler('/api', createGatewayHandler(gateway))
+     */
+    addProxyHandler(pathPrefix: string, handler: ProxyHandler): void;
 }
 //# sourceMappingURL=hazel-app.d.ts.map

package/dist/hazel-app.d.ts.map

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

package/dist/hazel-app.js

@@ -55,6 +55,13 @@ class HttpResponse {
             this.headers[name] = value;
         }
     }
+    redirect(url, statusCode = 302) {
+        if (this.headersSent)
+            return;
+        this.headersSent = true;
+        this.res.writeHead(statusCode, { ...this.headers, Location: url });
+        this.res.end();
+    }
 }
 class HazelApp {
     constructor(moduleType) {
@@ -62,8 +69,11 @@ class HazelApp {
         this.server = null;
         this.requestTimeout = 30000; // 30 seconds default
         this.corsEnabled = false;
-        logger_1.default.info('Initializing HazelApp');
+        this.earlyHandlers = [];
+        this.proxyHandlers = [];
+        logger_1.default.debug('Initializing HazelApp');
         this.container = container_1.Container.getInstance();
+        this.container.register(HazelApp, this);
         this.router = new router_1.Router(this.container);
         this.requestParser = new request_parser_1.RequestParser();
         this.module = new hazel_module_1.HazelModuleInstance(this.moduleType);
@@ -75,14 +85,14 @@ class HazelApp {
         this.initialize();
     }
     initialize() {
-        logger_1.default.info('Initializing module:', { moduleName: this.moduleType.name });
+        logger_1.default.debug('Initializing module:', { moduleName: this.moduleType.name });
         const metadata = Reflect.getMetadata(MODULE_METADATA_KEY, this.moduleType) || {};
         logger_1.default.debug('Module metadata:', metadata);
         // Collect all controllers from the module tree (root + imports, recursively)
         const allControllers = this.collectControllers(this.moduleType);
         // Register all controllers with the router
         if (allControllers.length > 0) {
-            logger_1.default.info('Registering controllers:', {
+            logger_1.default.debug('Registering controllers:', {
                 controllers: allControllers.map((c) => c.name),
             });
             allControllers.forEach((controller) => {
@@ -90,11 +100,11 @@ class HazelApp {
             });
         }
     }
-    collectControllers(moduleType, visited = new Set()) {
-        if (visited.has(moduleType))
+    collectControllers(moduleRef, visited = new Set()) {
+        if (visited.has(moduleRef))
             return [];
-        visited.add(moduleType);
-        const metadata = Reflect.getMetadata(MODULE_METADATA_KEY, moduleType) || {};
+        visited.add(moduleRef);
+        const metadata = (0, hazel_module_1.getModuleMetadata)(moduleRef) || {};
         const controllers = [];
         // Collect from imported modules first
         if (metadata.imports) {
@@ -132,6 +142,18 @@ class HazelApp {
     async listen(port) {
         return new Promise((resolve) => {
             this.server = new http_1.Server(async (req, res) => {
+                const startTime = Date.now();
+                const method = req.method || 'GET';
+                const url = req.url || '/';
+                const path = url.split('?')[0];
+                res.once('finish', () => {
+                    if (process.env.LOG_HTTP === 'false')
+                        return;
+                    const duration = Date.now() - startTime;
+                    const status = res.statusCode || 0;
+                    const statusColor = status >= 500 ? chalk_1.default.red : status >= 400 ? chalk_1.default.yellow : chalk_1.default.green;
+                    logger_1.default.info(`${chalk_1.default.bold(method)} ${path} ${statusColor(String(status))} ${chalk_1.default.gray(duration + 'ms')}`);
+                });
                 try {
                     if (!req.url) {
                         logger_1.default.warn('Invalid URL received');
@@ -159,8 +181,16 @@ class HazelApp {
                         res.end(JSON.stringify(startup));
                         return;
                     }
+                    // Early handlers (e.g. GraphQL) - must run before body parsing
+                    for (const { path, handler } of this.earlyHandlers) {
+                        const pathname = req.url?.split('?')[0] ?? '';
+                        if (pathname === path || pathname.startsWith(path + '/')) {
+                            await handler(req, res);
+                            return;
+                        }
+                    }
                     const { method, url, headers } = req;
-                    logger_1.default.info('Incoming request:', { method, url, headers });
+                    logger_1.default.debug('Incoming request:', { method, url, headers });
                     // Handle CORS
                     if (this.corsEnabled) {
                         const origin = headers['origin'] || '*';
@@ -183,9 +213,12 @@ class HazelApp {
                             return;
                         }
                     }
-                    // Parse request body for POST/PUT/PATCH requests
+                    // Parse request body for POST/PUT/PATCH requests (skip multipart - let route handle it)
                     let body = undefined;
-                    if (method === 'POST' || method === 'PUT' || method === 'PATCH') {
+                    let rawBody = '';
+                    const contentType = headers['content-type'] || '';
+                    const isMultipart = contentType.includes('multipart/form-data');
+                    if ((method === 'POST' || method === 'PUT' || method === 'PATCH') && !isMultipart) {
                         try {
                             const chunks = [];
                             req.on('data', (chunk) => chunks.push(chunk));
@@ -193,8 +226,8 @@ class HazelApp {
                                 req.on('end', () => {
                                     try {
                                         const bodyStr = Buffer.concat(chunks).toString();
+                                        rawBody = bodyStr;
                                         if (bodyStr) {
-                                            const contentType = headers['content-type'] || '';
                                             if (contentType.includes('application/json')) {
                                                 body = JSON.parse(bodyStr);
                                             }
@@ -216,15 +249,27 @@ class HazelApp {
                             });
                         }
                         catch (error) {
+                            const err = error;
+                            const msg = err?.message ?? (err && typeof err.message === 'string' ? err.message : '');
+                            const isClientAbort = err?.code === 'ECONNRESET' ||
+                                err?.code === 'EPIPE' ||
+                                (typeof msg === 'string' && (msg === 'aborted' || msg.includes('aborted')));
+                            if (isClientAbort) {
+                                logger_1.default.debug('Client disconnected while sending request body');
+                                return;
+                            }
                             logger_1.default.error('Error parsing request body:', error);
-                            res.writeHead(400);
-                            res.end(JSON.stringify({ error: 'Invalid request body' }));
+                            if (!res.writableEnded) {
+                                res.writeHead(400);
+                                res.end(JSON.stringify({ error: 'Invalid request body' }));
+                            }
                             return;
                         }
                     }
                     // Extend the original request object
                     Object.assign(req, {
                         body,
+                        rawBody: rawBody || undefined,
                         params: {},
                         query: {},
                     });
@@ -249,6 +294,15 @@ class HazelApp {
                         }
                         throw error;
                     }
+                    // Proxy handlers (e.g. API gateway) - run before router
+                    const pathname = (req.url || '/').split('?')[0];
+                    for (const { pathPrefix, handler } of this.proxyHandlers) {
+                        if (pathname === pathPrefix || pathname.startsWith(pathPrefix + '/')) {
+                            const handled = await handler(req, res, context);
+                            if (handled)
+                                return;
+                        }
+                    }
                     // Apply timeout middleware if configured
                     if (this.timeoutMiddleware) {
                         const timeoutPromise = new Promise((_, reject) => {
@@ -300,9 +354,9 @@ class HazelApp {
                 this.shutdownManager.registerHandler({
                     name: 'http-server',
                     handler: async () => {
-                        logger_1.default.info('Closing HTTP server...');
+                        logger_1.default.debug('Closing HTTP server...');
                         await this.close();
-                        logger_1.default.info('HTTP server closed');
+                        logger_1.default.debug('HTTP server closed');
                     },
                     timeout: 10000,
                 });
@@ -325,9 +379,8 @@ class HazelApp {
         }
         catch (error) {
             const httpError = error;
-            logger_1.default.error(`[${req.method}] ${req.url} - Route matching error: ${httpError.message} (status: ${httpError.statusCode || 404})`);
             if (process.env.NODE_ENV === 'development' && httpError.stack) {
-                logger_1.default.debug(httpError.stack);
+                logger_1.default.debug(`Route not found: ${req.method} ${req.url}`, httpError.stack);
             }
             const status = httpError.statusCode || 404;
             res.writeHead(status, { 'Content-Type': 'application/json' });
@@ -337,11 +390,6 @@ class HazelApp {
             }));
             return;
         }
-        logger_1.default.info('Matched route:', {
-            method: req.method,
-            url: req.url,
-            params: context.params,
-        });
         try {
             const response = new HttpResponse(res);
             const result = await route.handler(req, response);
@@ -402,7 +450,7 @@ class HazelApp {
     setRequestTimeout(timeout, options) {
         this.requestTimeout = timeout;
         this.timeoutMiddleware = new timeout_middleware_1.TimeoutMiddleware({ ...options, timeout });
-        logger_1.default.info(`Request timeout set to ${timeout}ms`);
+        logger_1.default.debug(`Request timeout set to ${timeout}ms`);
     }
     /**
      * Enable CORS
@@ -410,7 +458,7 @@ class HazelApp {
     enableCors(options) {
         this.corsEnabled = true;
         this.corsOptions = options;
-        logger_1.default.info('CORS enabled', options);
+        logger_1.default.debug('CORS enabled', options);
     }
     /**
      * Disable CORS
@@ -418,7 +466,7 @@ class HazelApp {
     disableCors() {
         this.corsEnabled = false;
         this.corsOptions = undefined;
-        logger_1.default.info('CORS disabled');
+        logger_1.default.debug('CORS disabled');
     }
     /**
      * Get health check manager
@@ -438,6 +486,21 @@ class HazelApp {
     getRouter() {
         return this.router;
     }
+    /**
+     * Add an early HTTP handler (runs before body parsing, for GraphQL etc.)
+     */
+    addEarlyHandler(path, handler) {
+        this.earlyHandlers.push({ path, handler });
+        logger_1.default.debug('Early handler registered', { path });
+    }
+    /**
+     * Add a proxy handler (runs after body parsing, before router).
+     * Use with @hazeljs/gateway: app.addProxyHandler('/api', createGatewayHandler(gateway))
+     */
+    addProxyHandler(pathPrefix, handler) {
+        this.proxyHandlers.push({ pathPrefix, handler });
+        logger_1.default.debug('Proxy handler registered', { pathPrefix });
+    }
 }
 exports.HazelApp = HazelApp;
 function getLocalIp() {

package/dist/hazel-module.d.ts

@@ -1,8 +1,17 @@
 import 'reflect-metadata';
 import { Type } from './types';
 import { Container } from './container';
+/** Dynamic module returned by forRoot() / forRootAsync() */
+export interface DynamicModule {
+    module: Type<unknown>;
+    providers?: unknown[];
+    controllers?: Type<unknown>[];
+    imports?: (Type<unknown> | DynamicModule)[];
+    exports?: unknown[];
+    global?: boolean;
+}
 export interface ModuleOptions {
-    imports?: Type<unknown>[];
+    imports?: (Type<unknown> | DynamicModule)[];
     controllers?: Type<unknown>[];
     providers?: Type<unknown>[];
     exports?: Type<unknown>[];
@@ -13,7 +22,7 @@ export declare function getModuleMetadata(target: object): ModuleOptions | undef
 export declare class HazelModuleInstance {
     private readonly moduleType;
     private container;
-    constructor(moduleType: Type<unknown>);
+    constructor(moduleType: Type<unknown> | DynamicModule);
     private initialize;
     getContainer(): Container;
 }

package/dist/hazel-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hazel-module.d.ts","sourceRoot":"","sources":["../src/hazel-module.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAS,MAAM,aAAa,CAAC;AAM/C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3B;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAIlE;AAGD,eAAO,MAAM,MAAM,oBAAc,CAAC;AAElC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE3E;AAED,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAFvC,OAAO,CAAC,SAAS,CAAY;gBAEA,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC;IAMtD,OAAO,CAAC,UAAU;IA8FlB,YAAY,IAAI,SAAS;CAG1B"}
+{"version":3,"file":"hazel-module.d.ts","sourceRoot":"","sources":["../src/hazel-module.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAS,MAAM,aAAa,CAAC;AAM/C,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,EAAE,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,EAAE,CAAC;IAC5C,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3B;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAIlE;AAGD,eAAO,MAAM,MAAM,oBAAc,CAAC;AAElC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAa3E;AAED,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAFvC,OAAO,CAAC,SAAS,CAAY;gBAEA,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,aAAa;IAOtE,OAAO,CAAC,UAAU;IA6GlB,YAAY,IAAI,SAAS;CAG1B"}