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

package/dist/__tests__/router.test.js

@@ -676,5 +676,508 @@ describe('Router', () => {
                 }));
             }
         });
+        // -----------------------------------------------------------------------
+        // Parameter injection — extended types
+        // -----------------------------------------------------------------------
+        it('should inject named header via { type: "headers", name }', async () => {
+            class TestController {
+                getHeader(authHeader) {
+                    return { auth: authHeader };
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/header-named', propertyKey: 'getHeader' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [{ type: 'headers', name: 'authorization' }], TestController, 'getHeader');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: { authorization: 'Bearer token123' },
+                method: 'GET',
+                url: '/test/header-named',
+            };
+            const route = await router.match('GET', '/test/header-named', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.json).toHaveBeenCalledWith({ auth: 'Bearer token123' });
+            }
+        });
+        it('should inject all headers when { type: "headers" } has no name', async () => {
+            class TestController {
+                getAllHeaders(headers) {
+                    return headers;
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/headers-all', propertyKey: 'getAllHeaders' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [{ type: 'headers' }], TestController, 'getAllHeaders');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: { 'x-custom': 'value' },
+                method: 'GET',
+                url: '/test/headers-all',
+            };
+            const route = await router.match('GET', '/test/headers-all', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.json).toHaveBeenCalledWith(expect.objectContaining({ 'x-custom': 'value' }));
+            }
+        });
+        it('should inject user object via { type: "user" } without field', async () => {
+            class TestController {
+                whoAmI(user) {
+                    return user;
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/me', propertyKey: 'whoAmI' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [{ type: 'user' }], TestController, 'whoAmI');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/me',
+            };
+            const reqWithUser = { ...mockReq, user: { sub: 'u1', role: 'admin' } };
+            const route = await router.match('GET', '/test/me', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(reqWithUser, mockRes, context);
+                expect(mockRes.json).toHaveBeenCalledWith({ sub: 'u1', role: 'admin' });
+            }
+        });
+        it('should inject specific user field via { type: "user", field }', async () => {
+            class TestController {
+                getRole(role) {
+                    return { role };
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/role', propertyKey: 'getRole' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [{ type: 'user', field: 'role' }], TestController, 'getRole');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/role',
+            };
+            const reqWithUser = { ...mockReq, user: { sub: 'u1', role: 'manager' } };
+            const route = await router.match('GET', '/test/role', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(reqWithUser, mockRes, context);
+                expect(mockRes.json).toHaveBeenCalledWith({ role: 'manager' });
+            }
+        });
+        it('should invoke a custom resolver via { type: "custom", resolve }', async () => {
+            const resolvedValue = { custom: 'injected' };
+            const resolveFn = jest.fn().mockReturnValue(resolvedValue);
+            class TestController {
+                getCustom(val) {
+                    return val;
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/custom', propertyKey: 'getCustom' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [{ type: 'custom', resolve: resolveFn }], TestController, 'getCustom');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/custom',
+            };
+            const route = await router.match('GET', '/test/custom', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(resolveFn).toHaveBeenCalled();
+                expect(mockRes.json).toHaveBeenCalledWith(resolvedValue);
+            }
+        });
+        it('should auto-inject RequestContext for undecorated parameters', async () => {
+            class TestController {
+                contextReceiver(ctx) {
+                    return { url: ctx.url };
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/ctx', propertyKey: 'contextReceiver' }], TestController);
+            // No injection metadata — relies on design:paramtypes auto-inject
+            Reflect.defineMetadata('hazel:inject', [], TestController, 'contextReceiver');
+            Reflect.defineMetadata('design:paramtypes', [Object], // one undecorated parameter
+            TestController.prototype, 'contextReceiver');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/ctx',
+            };
+            const route = await router.match('GET', '/test/ctx', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.json).toHaveBeenCalledWith({ url: '/test/ctx' });
+            }
+        });
+        // -----------------------------------------------------------------------
+        // @Redirect metadata
+        // -----------------------------------------------------------------------
+        it('should send a redirect response when @Redirect metadata is set', async () => {
+            class TestController {
+                goHome() {
+                    return undefined;
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/redirect', propertyKey: 'goHome' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [], TestController, 'goHome');
+            // Simulate @Redirect('/home', 301) on the prototype
+            Reflect.defineMetadata('hazel:redirect', { url: '/home', statusCode: 301 }, TestController.prototype, 'goHome');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/redirect',
+            };
+            const route = await router.match('GET', '/test/redirect', context);
+            expect(route).toBeDefined();
+            if (route) {
+                mockRes.setHeader = jest.fn();
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.status).toHaveBeenCalledWith(301);
+                expect(mockRes.setHeader).toHaveBeenCalledWith('Location', '/home');
+            }
+        });
+        // -----------------------------------------------------------------------
+        // @Header metadata (custom response headers)
+        // -----------------------------------------------------------------------
+        it('should set custom response headers when @Header metadata is set', async () => {
+            class TestController {
+                headered() {
+                    return { ok: true };
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/headered', propertyKey: 'headered' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [], TestController, 'headered');
+            Reflect.defineMetadata('hazel:headers', [{ name: 'X-Custom', value: 'hello' }], TestController.prototype, 'headered');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/headered',
+            };
+            const route = await router.match('GET', '/test/headered', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.setHeader).toHaveBeenCalledWith('X-Custom', 'hello');
+                expect(mockRes.json).toHaveBeenCalledWith({ ok: true });
+            }
+        });
+        // -----------------------------------------------------------------------
+        // @HttpCode metadata
+        // -----------------------------------------------------------------------
+        it('should use custom HTTP status code from @HttpCode when result is defined', async () => {
+            class TestController {
+                create() {
+                    return { created: true };
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'POST', path: '/http-code', propertyKey: 'create' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [], TestController, 'create');
+            Reflect.defineMetadata('hazel:http-code', 201, TestController.prototype, 'create');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'POST',
+                url: '/test/http-code',
+            };
+            const route = await router.match('POST', '/test/http-code', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.status).toHaveBeenCalledWith(201);
+                expect(mockRes.json).toHaveBeenCalledWith({ created: true });
+            }
+        });
+        it('should use custom HTTP status code from @HttpCode when result is undefined', async () => {
+            class TestController {
+                noContent() {
+                    return undefined;
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'DELETE', path: '/no-content', propertyKey: 'noContent' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [], TestController, 'noContent');
+            Reflect.defineMetadata('hazel:http-code', 204, TestController.prototype, 'noContent');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'DELETE',
+                url: '/test/no-content',
+            };
+            const route = await router.match('DELETE', '/test/no-content', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.status).toHaveBeenCalledWith(204);
+                expect(mockRes.end).toHaveBeenCalled();
+            }
+        });
+        // -----------------------------------------------------------------------
+        // Guard execution
+        // -----------------------------------------------------------------------
+        it('should throw UnauthorizedError when guard canActivate returns false', async () => {
+            class DenyGuard {
+                canActivate() {
+                    return false;
+                }
+            }
+            container.register(DenyGuard, new DenyGuard());
+            class TestController {
+                secret() {
+                    return { secret: true };
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/secret', propertyKey: 'secret' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [], TestController, 'secret');
+            Reflect.defineMetadata('hazel:guards', [DenyGuard], TestController);
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/secret',
+            };
+            const route = await router.match('GET', '/test/secret', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.status).toHaveBeenCalledWith(401);
+            }
+        });
+        it('should propagate req.user to context.user after guards pass', async () => {
+            class AllowGuard {
+                canActivate() {
+                    return true;
+                }
+            }
+            container.register(AllowGuard, new AllowGuard());
+            class TestController {
+                whoAmI(user) {
+                    return user;
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/user-propagate', propertyKey: 'whoAmI' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [{ type: 'user' }], TestController, 'whoAmI');
+            Reflect.defineMetadata('hazel:guards', [AllowGuard], TestController);
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/user-propagate',
+            };
+            const reqWithUser = { ...mockReq, user: { sub: 'u99' } };
+            const route = await router.match('GET', '/test/user-propagate', context);
+            expect(route).toBeDefined();
+            if (route) {
+                await route.handler(reqWithUser, mockRes, context);
+                expect(mockRes.json).toHaveBeenCalledWith({ sub: 'u99' });
+            }
+        });
+        // -----------------------------------------------------------------------
+        // Legacy string-based injection
+        // -----------------------------------------------------------------------
+        it('should handle legacy string injection "body"', async () => {
+            class TestController {
+                legacyBody(body) {
+                    return body;
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'POST', path: '/legacy-body', propertyKey: 'legacyBody' }], TestController);
+            Reflect.defineMetadata('hazel:inject', ['body'], TestController, 'legacyBody');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: { name: 'legacy' },
+                headers: {},
+                method: 'POST',
+                url: '/test/legacy-body',
+            };
+            const route = await router.match('POST', '/test/legacy-body', context);
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.json).toHaveBeenCalledWith({ name: 'legacy' });
+            }
+        });
+        it('should handle legacy string injection "param"', async () => {
+            class TestController {
+                legacyParam(params) {
+                    return params;
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/legacy-param/:id', propertyKey: 'legacyParam' }], TestController);
+            Reflect.defineMetadata('hazel:inject', ['param'], TestController, 'legacyParam');
+            router.registerController(TestController);
+            const context = {
+                params: { id: '42' },
+                query: {},
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/legacy-param/42',
+            };
+            const route = await router.match('GET', '/test/legacy-param/42', context);
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.json).toHaveBeenCalledWith({ id: '42' });
+            }
+        });
+        it('should handle legacy string injection "query"', async () => {
+            class TestController {
+                legacyQuery(query) {
+                    return query;
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/legacy-query', propertyKey: 'legacyQuery' }], TestController);
+            Reflect.defineMetadata('hazel:inject', ['query'], TestController, 'legacyQuery');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: { filter: 'active' },
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/legacy-query',
+            };
+            const route = await router.match('GET', '/test/legacy-query', context);
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.json).toHaveBeenCalledWith({ filter: 'active' });
+            }
+        });
+        it('should handle legacy string injection "headers"', async () => {
+            class TestController {
+                legacyHeaders(headers) {
+                    return headers;
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/legacy-headers', propertyKey: 'legacyHeaders' }], TestController);
+            Reflect.defineMetadata('hazel:inject', ['headers'], TestController, 'legacyHeaders');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: { 'x-trace': 'abc' },
+                method: 'GET',
+                url: '/test/legacy-headers',
+            };
+            const route = await router.match('GET', '/test/legacy-headers', context);
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.json).toHaveBeenCalledWith(expect.objectContaining({ 'x-trace': 'abc' }));
+            }
+        });
+        // -----------------------------------------------------------------------
+        // handleRequest edge cases
+        // -----------------------------------------------------------------------
+        it('should return "Internal Server Error" when a non-Error is thrown in handleRequest', async () => {
+            jest.spyOn(router, 'match').mockRejectedValue('string-error');
+            mockReq.method = 'GET';
+            mockReq.url = '/test';
+            await router.handleRequest(mockReq, mockRes);
+            expect(mockRes.status).toHaveBeenCalledWith(500);
+            expect(mockRes.json).toHaveBeenCalledWith({ error: 'Internal Server Error' });
+        });
+        it('should use production error message when NODE_ENV is production', async () => {
+            const originalEnv = process.env.NODE_ENV;
+            process.env.NODE_ENV = 'production';
+            class TestController {
+                throwInProd() {
+                    throw new Error('Sensitive internal details');
+                }
+            }
+            container.register(TestController, new TestController());
+            Reflect.defineMetadata('hazel:controller', { path: '/test' }, TestController);
+            Reflect.defineMetadata('hazel:routes', [{ method: 'GET', path: '/prod-error', propertyKey: 'throwInProd' }], TestController);
+            Reflect.defineMetadata('hazel:inject', [], TestController, 'throwInProd');
+            router.registerController(TestController);
+            const context = {
+                params: {},
+                query: {},
+                body: {},
+                headers: {},
+                method: 'GET',
+                url: '/test/prod-error',
+            };
+            const route = await router.match('GET', '/test/prod-error', context);
+            if (route) {
+                await route.handler(mockReq, mockRes, context);
+                expect(mockRes.status).toHaveBeenCalledWith(500);
+                expect(mockRes.json).toHaveBeenCalledWith(expect.objectContaining({ message: 'Internal server error' }));
+            }
+            process.env.NODE_ENV = originalEnv;
+        });
     });
 });

package/dist/container.js

@@ -17,7 +17,7 @@ class Container {
     constructor() {
         this.providers = new Map();
         this.requestScopedProviders = new Map();
-        logger_1.default.info('Container initialized');
+        logger_1.default.debug('Container initialized');
     }
     static getInstance() {
         if (!Container.instance) {
@@ -36,7 +36,7 @@ class Container {
      */
     register(token, provider, scope = Scope.SINGLETON) {
         const tokenName = this.getTokenName(token);
-        logger_1.default.info(`Registering provider: ${tokenName} with scope: ${scope}`);
+        logger_1.default.debug(`Registering provider: ${tokenName} with scope: ${scope}`);
         if (this.isProvider(provider)) {
             this.registerProvider(provider);
         }
@@ -216,7 +216,7 @@ class Container {
         // Create instance with dependencies
         const instance = new token(...dependencies);
         if (logger_1.default.isDebugEnabled()) {
-            logger_1.default.info(`Created instance of: ${this.getTokenName(token)}`);
+            logger_1.default.debug(`Created instance of: ${this.getTokenName(token)}`);
         }
         return instance;
     }
@@ -233,7 +233,7 @@ class Container {
      * Clear all providers
      */
     clear() {
-        logger_1.default.info('Clearing container');
+        logger_1.default.debug('Clearing container');
         this.providers.clear();
         this.requestScopedProviders.clear();
     }

package/dist/decorators.d.ts

@@ -1,8 +1,10 @@
 import 'reflect-metadata';
-import { Type } from './types';
+import { Type, RequestContext, Request } from './types';
 import { PipeTransform, PipeMetadata } from './pipes/pipe';
 import { Interceptor, InterceptorMetadata } from './interceptors/interceptor';
 import { HazelApp } from './hazel-app';
+import type { Container } from './container';
+export declare const CUSTOM_METADATA_PREFIX = "hazel:meta:";
 export interface ControllerMetadata {
     path: string;
     interceptors?: InterceptorMetadata[];
@@ -32,6 +34,7 @@ export interface InjectableOptions {
 }
 export interface RepositoryOptions {
     model: string;
+    scope?: 'singleton' | 'transient' | 'request';
 }
 export interface OnModuleInit {
     onModuleInit(): Promise<void>;
@@ -43,6 +46,12 @@ export interface ExecutionContext {
     switchToHttp(): {
         getRequest(): unknown;
         getResponse(): unknown;
+        /**
+         * Returns the fully parsed RequestContext for this request.
+         * Gives guards access to `params`, `query`, `headers`, `user`, and `body`
+         * without having to re-parse the raw Node.js IncomingMessage.
+         */
+        getContext(): RequestContext;
     };
 }
 export interface CanActivate {
@@ -88,5 +97,70 @@ export declare function HttpCode(statusCode: number): MethodDecorator;
 export declare function Header(name: string, value: string): MethodDecorator;
 export declare function Redirect(url: string, statusCode?: number): MethodDecorator;
 export declare function Res(): ParameterDecorator;
+export declare function Ip(): ParameterDecorator;
+export declare function Host(): ParameterDecorator;
+/**
+ * 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.
+ */
+export declare function Public(): ClassDecorator & MethodDecorator;
+/** Alias for @Public(). Use when you want to skip auth for specific routes. */
+export declare const SkipAuth: typeof Public;
+export declare function Timeout(ms: number): MethodDecorator;
+export declare function Optional(): ParameterDecorator;
+export declare function Session(): ParameterDecorator;
+export interface RetryDecoratorOptions {
+    count: number;
+    delay?: number;
+    retryIf?: (err: Error) => boolean;
+}
+export declare function Retry(options: RetryDecoratorOptions): MethodDecorator;
+export declare function ApiTags(...tags: string[]): ClassDecorator & MethodDecorator;
+export interface ApiOperationOptions {
+    summary?: string;
+    description?: string;
+    operationId?: string;
+}
+export declare function ApiOperation(options: ApiOperationOptions | string): MethodDecorator;
+/**
+ * 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')
+ */
+export declare function SetMetadata(key: string, value: unknown): ClassDecorator & MethodDecorator;
+/**
+ * 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)
+ */
+export declare function getMetadata<T = unknown>(key: string, target: object, propertyKey?: string | symbol): T | undefined;
+/**
+ * Context passed to custom parameter decorator resolvers.
+ * The router calls the resolver with (req, context, container) when invoking the handler.
+ */
+export interface ParamDecoratorContext {
+    req: Request;
+    context: RequestContext;
+    container: Container;
+}
+/**
+ * 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) { ... }
+ */
+export declare function createParamDecorator<T = unknown>(resolve: (req: Request, context: RequestContext, container: Container) => T | Promise<T>): ParameterDecorator;
 export { HazelApp };
 //# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAoB,MAAM,4BAA4B,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAmB7C,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACtC;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,IAAI;QACd,UAAU,IAAI,OAAO,CAAC;QACtB,WAAW,IAAI,OAAO,CAAC;QACvB;;;;WAIG;QACH,UAAU,IAAI,cAAc,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACpE;AAGD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAErD,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,cAAc,CAQ9E;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAS1E;AAED,wBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,eAAe,CAGzE;AAED,wBAAgB,IAAI,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,eAAe,CAG1E;AAED,wBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,eAAe,CAGzE;AAED,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,eAAe,CAG5E;AAED,wBAAgB,KAAK,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,eAAe,CAG3E;AAED,wBAAgB,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAalF;AAED,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,cAAc,CAyBpE;AAED,wBAAgB,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,kBAAkB,CA6BhE;AAED,wBAAgB,OAAO,IAAI,kBAAkB,CAgB5C;AAED,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,kBAAkB,CAuBvF;AAED,wBAAgB,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,kBAAkB,CAuBxF;AAED,wBAAgB,QAAQ,CACtB,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC,EAAE,GAC/C,cAAc,GAAG,eAAe,CAgClC;AAED,wBAAgB,eAAe,CAC7B,GAAG,YAAY,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,mBAAmB,CAAC,EAAE,GAC3D,cAAc,GAAG,eAAe,CA4BlC;AAED,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,GAAG,cAAc,GAAG,eAAe,CAmB1F;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,eAAe,CASlB;AAED,wBAAgB,GAAG,IAAI,kBAAkB,CAgBxC;AAED,wBAAgB,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAgB/D;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAS5D;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAYnE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,eAAe,CAS/E;AAED,wBAAgB,GAAG,IAAI,kBAAkB,CAyBxC;AAED,wBAAgB,EAAE,IAAI,kBAAkB,CAevC;AAED,wBAAgB,IAAI,IAAI,kBAAkB,CAezC;AAED;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,cAAc,GAAG,eAAe,CAoBzD;AAED,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,eAAS,CAAC;AAE/B,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,CASnD;AAED,wBAAgB,QAAQ,IAAI,kBAAkB,CAiB7C;AAED,wBAAgB,OAAO,IAAI,kBAAkB,CAe5C;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC;CACnC;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,qBAAqB,GAAG,eAAe,CAgBrE;AAED,wBAAgB,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,GAAG,eAAe,CAoB3E;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,GAAG,eAAe,CAUnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,eAAe,CAczF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAC5B,CAAC,GAAG,SAAS,CAMf;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAC9C,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvF,kBAAkB,CAcpB;AA8CD,OAAO,EAAE,QAAQ,EAAE,CAAC"}