@opra/nestjs 1.0.0-alpha.3 → 1.0.0-alpha.30

package/cjs/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPRA_HTTP_MODULE_OPTIONS = exports.IS_PUBLIC_KEY = void 0;
+exports.IS_PUBLIC_KEY = 'opra:isPublic';
+exports.OPRA_HTTP_MODULE_OPTIONS = 'OPRA_HTTP_MODULE_OPTIONS';

package/cjs/decorators/public.decorator.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Public = void 0;
+const common_1 = require("@nestjs/common");
+const constants_js_1 = require("../constants.js");
+const Public = () => (0, common_1.SetMetadata)(constants_js_1.IS_PUBLIC_KEY, true);
+exports.Public = Public;

package/cjs/index.js

@@ -3,5 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 require("reflect-metadata");
 require("./augmentation/nestjs.augmentation.js");
+tslib_1.__exportStar(require("./constants.js"), exports);
+tslib_1.__exportStar(require("./decorators/public.decorator.js"), exports);
 tslib_1.__exportStar(require("./opra-http.module.js"), exports);
 tslib_1.__exportStar(require("./opra-nestjs-adapter.js"), exports);

package/cjs/opra-http-core.module.js

@@ -3,40 +3,70 @@ var OpraHttpCoreModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpraHttpCoreModule = void 0;
 const tslib_1 = require("tslib");
-const ts_gems_1 = require("ts-gems");
 const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
 const common_2 = require("@opra/common");
+const ts_gems_1 = require("ts-gems");
+const constants_1 = require("./constants");
 const opra_nestjs_adapter_js_1 = require("./opra-nestjs-adapter.js");
+const opra_exception_filter_1 = require("./services/opra-exception-filter");
+const opra_middleware_js_1 = require("./services/opra-middleware.js");
 let OpraHttpCoreModule = OpraHttpCoreModule_1 = class OpraHttpCoreModule {
     constructor(opraAdapter) {
         this.opraAdapter = opraAdapter;
     }
-    static forRoot(options) {
-        const opraAdapter = new opra_nestjs_adapter_js_1.OpraNestAdapter(options);
-        const token = options?.id || opra_nestjs_adapter_js_1.OpraNestAdapter;
+    configure(consumer) {
+        consumer.apply(opra_middleware_js_1.OpraMiddleware).forRoutes({
+            path: '*',
+            method: common_1.RequestMethod.ALL,
+        });
+    }
+    static forRoot(init, options) {
+        const opraAdapter = new opra_nestjs_adapter_js_1.OpraNestAdapter(init, options);
+        const token = init?.id || opra_nestjs_adapter_js_1.OpraNestAdapter;
         const providers = [
-            ...(options?.providers || []),
+            ...(init?.providers || []),
+            {
+                provide: constants_1.OPRA_HTTP_MODULE_OPTIONS,
+                useValue: { ...options },
+            },
             {
                 provide: opra_nestjs_adapter_js_1.OpraNestAdapter,
-                useFactory: async () => {
+                inject: [core_1.ModuleRef],
+                useFactory: async (moduleRef) => {
                     (0, ts_gems_1.asMutable)(opraAdapter).document = await common_2.ApiDocumentFactory.createDocument({
-                        ...options,
-                        api: { protocol: 'http', name: options.name, controllers: opraAdapter.controllers },
+                        ...init,
+                        api: { protocol: 'http', name: init.name, controllers: init.controllers },
+                    });
+                    opraAdapter.interceptors.map(x => {
+                        if ((0, common_2.isConstructor)(x)) {
+                            return (ctx, next) => {
+                                const interceptor = moduleRef.get(x);
+                                if (typeof interceptor.intercept === 'function')
+                                    return interceptor.intercept(ctx, next());
+                            };
+                        }
+                        return x;
                     });
                     return opraAdapter;
                 },
             },
+            {
+                provide: core_1.APP_FILTER,
+                useClass: opra_exception_filter_1.OpraExceptionFilter,
+            },
         ];
-        if (token !== opra_nestjs_adapter_js_1.OpraNestAdapter)
+        if (token !== opra_nestjs_adapter_js_1.OpraNestAdapter) {
             providers.push({
                 provide: token,
                 useValue: opraAdapter,
             });
+        }
         return {
             module: OpraHttpCoreModule_1,
-            controllers: opraAdapter.controllers,
-            imports: [...(options?.imports || [])],
-            exports: [...(options?.exports || []), token],
+            controllers: opraAdapter.nestControllers,
+            imports: [...(init?.imports || [])],
+            exports: [...(init?.exports || []), token],
             providers,
         };
     }

package/cjs/opra-http.module.js

@@ -8,12 +8,13 @@ const opra_http_core_module_js_1 = require("./opra-http-core.module.js");
 let OpraHttpModule = OpraHttpModule_1 = class OpraHttpModule {
     /**
      *
+     * @param init
      * @param options
      */
-    static forRoot(options) {
+    static forRoot(init, options) {
         return {
             module: OpraHttpModule_1,
-            imports: [opra_http_core_module_js_1.OpraHttpCoreModule.forRoot(options)],
+            imports: [opra_http_core_module_js_1.OpraHttpCoreModule.forRoot(init, options)],
         };
     }
 };

package/cjs/opra-nestjs-adapter.js

@@ -1,95 +1,122 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpraNestAdapter = exports.kHandler = void 0;
+exports.OpraNestAdapter = void 0;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
 const common_1 = require("@nestjs/common");
+const constants_1 = require("@nestjs/common/constants");
 const common_2 = require("@opra/common");
 const core_1 = require("@opra/core");
-const opra_exception_filter_js_1 = require("./services/opra-exception-filter.js");
-exports.kHandler = Symbol.for('kHandler');
+const path_1 = tslib_1.__importDefault(require("path"));
+const ts_gems_1 = require("ts-gems");
+const public_decorator_js_1 = require("./decorators/public.decorator.js");
 class OpraNestAdapter extends core_1.HttpAdapter {
-    constructor(options) {
+    constructor(init, options) {
         super((function () {
             const document = new common_2.ApiDocument();
             document.api = new common_2.HttpApi(document);
             return document;
-        })(), options);
-        // protected _platform: string = 'express';
-        this.controllers = [];
-        let basePath = options.basePath || '/';
+        })(), {
+            ...options,
+            interceptors: options?.interceptors,
+        });
+        this.nestControllers = [];
+        this.options = options;
+        let basePath = options?.basePath || '/';
         if (!basePath.startsWith('/'))
             basePath = '/' + basePath;
-        if (options.controllers)
-            options.controllers.forEach(c => this._createNestControllers(c, basePath));
+        this._addRootController(basePath);
+        if (init.controllers)
+            init.controllers.forEach(c => this._addToNestControllers(c, basePath, []));
     }
     async close() {
         //
     }
-    _createNestControllers(source, currentPath) {
-        const metadata = Reflect.getMetadata(common_2.HTTP_CONTROLLER_METADATA, source);
+    _addRootController(basePath) {
+        const _this = this;
+        let RootController = class RootController {
+            schema(_req, next) {
+                _this.handler.sendDocumentSchema(_req.opraContext).catch(() => next());
+            }
+        };
+        tslib_1.__decorate([
+            (0, common_1.Get)('/\\$schema'),
+            tslib_1.__param(0, (0, common_1.Req)()),
+            tslib_1.__param(1, (0, common_1.Next)()),
+            tslib_1.__metadata("design:type", Function),
+            tslib_1.__metadata("design:paramtypes", [Object, Function]),
+            tslib_1.__metadata("design:returntype", void 0)
+        ], RootController.prototype, "schema", null);
+        RootController = tslib_1.__decorate([
+            (0, common_1.Controller)({
+                path: basePath,
+            })
+        ], RootController);
+        if (this.options?.schemaRouteIsPublic) {
+            (0, public_decorator_js_1.Public)()(RootController.prototype, 'schema', Object.getOwnPropertyDescriptor(RootController.prototype, 'schema'));
+        }
+        this.nestControllers.push(RootController);
+    }
+    _addToNestControllers(sourceClass, currentPath, parentTree) {
+        const metadata = Reflect.getMetadata(common_2.HTTP_CONTROLLER_METADATA, sourceClass);
         if (!metadata)
             return;
         const newClass = {
-            [source.name]: class extends source {
+            [sourceClass.name]: class extends sourceClass {
             },
-        }[source.name];
+        }[sourceClass.name];
+        /** Copy metadata keys from source class to new one */
+        let metadataKeys;
+        OpraNestAdapter.copyDecoratorMetadataToChild(newClass, parentTree);
         const newPath = metadata.path ? path_1.default.join(currentPath, metadata.path) : currentPath;
         const adapter = this;
-        /** Inject exception filter */
-        (0, common_1.UseFilters)(new opra_exception_filter_js_1.OpraExceptionFilter(adapter))(newClass);
+        // adapter.logger =
+        /** Disable default error handler. Errors will be handled by OpraExceptionFilter */
+        adapter.handler.onError = (context, error) => {
+            throw error;
+        };
         (0, common_1.Controller)()(newClass);
-        this.controllers.push(newClass);
+        this.nestControllers.push(newClass);
         if (metadata.operations) {
             for (const [k, v] of Object.entries(metadata.operations)) {
-                const operationHandler = source.prototype[k];
+                const operationHandler = sourceClass.prototype[k];
                 Object.defineProperty(newClass.prototype, k, {
                     writable: true,
                     /** NestJS handler method */
                     async value(_req, _res) {
-                        const request = core_1.HttpIncoming.from(_req);
-                        const response = core_1.HttpOutgoing.from(_res);
+                        _res.statusCode = 200;
                         const api = adapter.document.api;
-                        const controller = api.findController(newClass);
+                        const controller = api.findController(sourceClass);
                         const operation = controller?.operations.get(k);
-                        if (!(operation && typeof operationHandler === 'function'))
+                        const context = (0, ts_gems_1.asMutable)(_req.opraContext);
+                        if (!(context && operation && typeof operationHandler === 'function')) {
                             throw new common_2.NotFoundError({
-                                message: `No endpoint found for [${request.method}]${request.baseUrl}`,
+                                message: `No endpoint found for [${_req.method}]${_req.baseUrl}`,
                                 details: {
-                                    path: request.baseUrl,
-                                    method: request.method,
+                                    path: _req.baseUrl,
+                                    method: _req.method,
                                 },
                             });
-                        /** Create the HttpContext */
-                        const context = new core_1.HttpContext({
-                            adapter,
-                            platform: _req.route ? 'express' : 'fastify',
-                            platformArgs: {
-                                request,
-                                response,
-                            },
-                            request,
-                            response,
-                            operation,
-                            controller: operation.owner,
-                            controllerInstance: this,
-                            operationHandler,
-                        });
+                        }
+                        /** Configure the HttpContext */
+                        context.operation = operation;
+                        context.controller = operation.owner;
+                        context.controllerInstance = this;
+                        context.operationHandler = operationHandler;
                         /** Handle request */
-                        await adapter[exports.kHandler].handleRequest(context);
+                        await adapter.handler.handleRequest(context);
                     },
                 });
-                (0, common_1.Req)()(newClass.prototype, k, 0);
-                (0, common_1.Res)()(newClass.prototype, k, 1);
                 /** Copy metadata keys from source function to new one */
-                const metadataKeys = Reflect.getOwnMetadataKeys(operationHandler);
+                metadataKeys = Reflect.getOwnMetadataKeys(operationHandler);
                 const newFn = newClass.prototype[k];
                 for (const key of metadataKeys) {
                     const m = Reflect.getMetadata(key, operationHandler);
                     Reflect.defineMetadata(key, m, newFn);
                 }
+                (0, common_1.Req)()(newClass.prototype, k, 0);
+                (0, common_1.Res)()(newClass.prototype, k, 1);
                 const descriptor = Object.getOwnPropertyDescriptor(newClass.prototype, k);
-                const operationPath = newPath + (v.path || '');
+                const operationPath = v.mergePath ? newPath + (v.path || '') : path_1.default.posix.join(newPath, v.path || '');
                 switch (v.method || 'GET') {
                     case 'DELETE':
                         /** Call @Delete decorator over new property */
@@ -123,6 +150,8 @@ class OpraNestAdapter extends core_1.HttpAdapter {
                         /** Call @Search decorator over new property */
                         (0, common_1.Search)(operationPath)(newClass.prototype, k, descriptor);
                         break;
+                    default:
+                        break;
                 }
             }
         }
@@ -130,7 +159,30 @@ class OpraNestAdapter extends core_1.HttpAdapter {
             for (const child of metadata.controllers) {
                 if (!(0, common_2.isConstructor)(child))
                     throw new TypeError('Controllers should be injectable a class');
-                this._createNestControllers(child, newPath);
+                this._addToNestControllers(child, newPath, [...parentTree, sourceClass]);
+            }
+        }
+    }
+    static copyDecoratorMetadataToChild(target, parentTree) {
+        for (const parent of parentTree) {
+            const metadataKeys = Reflect.getOwnMetadataKeys(parent);
+            for (const key of metadataKeys) {
+                if (typeof key === 'string' && key.startsWith('opra:') && !Reflect.hasOwnMetadata(key, target)) {
+                    const metadata = Reflect.getMetadata(key, parent);
+                    Reflect.defineMetadata(key, metadata, target);
+                    continue;
+                }
+                if (key === constants_1.GUARDS_METADATA || key === constants_1.INTERCEPTORS_METADATA || key === constants_1.EXCEPTION_FILTERS_METADATA) {
+                    const m1 = Reflect.getMetadata(key, target) || [];
+                    const metadata = [...m1];
+                    const m2 = Reflect.getOwnMetadata(key, parent) || [];
+                    m2.forEach((t) => {
+                        if (!metadata.includes(t)) {
+                            metadata.push(t);
+                        }
+                    });
+                    Reflect.defineMetadata(key, metadata, target);
+                }
             }
         }
     }

package/cjs/services/opra-exception-filter.js

@@ -1,18 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpraExceptionFilter = exports.kHandler = void 0;
-const core_1 = require("@opra/core");
-exports.kHandler = Symbol.for('kHandler');
-class OpraExceptionFilter {
-    constructor(adapter) {
-        this.adapter = adapter;
+exports.OpraExceptionFilter = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const opra_nestjs_adapter_js_1 = require("../opra-nestjs-adapter.js");
+let OpraExceptionFilter = class OpraExceptionFilter extends core_1.BaseExceptionFilter {
+    constructor(moduleRef) {
+        super();
+        this.moduleRef = moduleRef;
     }
     catch(exception, host) {
-        const ctx = host.switchToHttp();
-        const _res = ctx.getResponse();
-        const error = (0, core_1.wrapException)(exception);
-        const response = core_1.HttpOutgoing.from(_res);
-        return this.adapter[exports.kHandler].sendErrorResponse(response, [error]);
+        const ctx = host.switchToHttp().getRequest().opraContext;
+        if (ctx) {
+            const adapter = this.moduleRef.get(opra_nestjs_adapter_js_1.OpraNestAdapter);
+            ctx.errors.push(exception);
+            return adapter.handler.sendResponse(ctx);
+        }
     }
-}
+};
 exports.OpraExceptionFilter = OpraExceptionFilter;
+exports.OpraExceptionFilter = OpraExceptionFilter = tslib_1.__decorate([
+    (0, common_1.Catch)(),
+    tslib_1.__metadata("design:paramtypes", [core_1.ModuleRef])
+], OpraExceptionFilter);

package/cjs/services/opra-middleware.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpraMiddleware = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@opra/core");
+const constants_1 = require("../constants");
+const opra_nestjs_adapter_js_1 = require("../opra-nestjs-adapter.js");
+let OpraMiddleware = class OpraMiddleware {
+    constructor(opraAdapter, options) {
+        this.opraAdapter = opraAdapter;
+        this.options = options;
+    }
+    use(req, res, next) {
+        const request = core_1.HttpIncoming.from(req);
+        const response = core_1.HttpOutgoing.from(res);
+        /** Create the HttpContext */
+        const context = new core_1.HttpContext({
+            adapter: this.opraAdapter,
+            platform: req.route ? 'express' : 'fastify',
+            request,
+            response,
+        });
+        req.opraContext = context;
+        this.opraAdapter
+            .emitAsync('createContext', context)
+            .then(() => next())
+            .catch(next);
+    }
+};
+exports.OpraMiddleware = OpraMiddleware;
+exports.OpraMiddleware = OpraMiddleware = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(1, (0, common_1.Inject)(constants_1.OPRA_HTTP_MODULE_OPTIONS)),
+    tslib_1.__metadata("design:paramtypes", [opra_nestjs_adapter_js_1.OpraNestAdapter, Object])
+], OpraMiddleware);

package/esm/constants.js

@@ -0,0 +1,2 @@
+export const IS_PUBLIC_KEY = 'opra:isPublic';
+export const OPRA_HTTP_MODULE_OPTIONS = 'OPRA_HTTP_MODULE_OPTIONS';

package/esm/decorators/public.decorator.js

@@ -0,0 +1,3 @@
+import { SetMetadata } from '@nestjs/common';
+import { IS_PUBLIC_KEY } from '../constants.js';
+export const Public = () => SetMetadata(IS_PUBLIC_KEY, true);

package/esm/index.js

@@ -1,4 +1,6 @@
 import 'reflect-metadata';
 import './augmentation/nestjs.augmentation.js';
+export * from './constants.js';
+export * from './decorators/public.decorator.js';
 export * from './opra-http.module.js';
 export * from './opra-nestjs-adapter.js';

package/esm/opra-http-core.module.js

@@ -1,39 +1,69 @@
 var OpraHttpCoreModule_1;
 import { __decorate, __metadata } from "tslib";
+import { Global, Module, RequestMethod, } from '@nestjs/common';
+import { APP_FILTER, ModuleRef } from '@nestjs/core';
+import { ApiDocumentFactory, isConstructor } from '@opra/common';
 import { asMutable } from 'ts-gems';
-import { Global, Module } from '@nestjs/common';
-import { ApiDocumentFactory } from '@opra/common';
+import { OPRA_HTTP_MODULE_OPTIONS } from './constants';
 import { OpraNestAdapter } from './opra-nestjs-adapter.js';
+import { OpraExceptionFilter } from './services/opra-exception-filter';
+import { OpraMiddleware } from './services/opra-middleware.js';
 let OpraHttpCoreModule = OpraHttpCoreModule_1 = class OpraHttpCoreModule {
     constructor(opraAdapter) {
         this.opraAdapter = opraAdapter;
     }
-    static forRoot(options) {
-        const opraAdapter = new OpraNestAdapter(options);
-        const token = options?.id || OpraNestAdapter;
+    configure(consumer) {
+        consumer.apply(OpraMiddleware).forRoutes({
+            path: '*',
+            method: RequestMethod.ALL,
+        });
+    }
+    static forRoot(init, options) {
+        const opraAdapter = new OpraNestAdapter(init, options);
+        const token = init?.id || OpraNestAdapter;
         const providers = [
-            ...(options?.providers || []),
+            ...(init?.providers || []),
+            {
+                provide: OPRA_HTTP_MODULE_OPTIONS,
+                useValue: { ...options },
+            },
             {
                 provide: OpraNestAdapter,
-                useFactory: async () => {
+                inject: [ModuleRef],
+                useFactory: async (moduleRef) => {
                     asMutable(opraAdapter).document = await ApiDocumentFactory.createDocument({
-                        ...options,
-                        api: { protocol: 'http', name: options.name, controllers: opraAdapter.controllers },
+                        ...init,
+                        api: { protocol: 'http', name: init.name, controllers: init.controllers },
+                    });
+                    opraAdapter.interceptors.map(x => {
+                        if (isConstructor(x)) {
+                            return (ctx, next) => {
+                                const interceptor = moduleRef.get(x);
+                                if (typeof interceptor.intercept === 'function')
+                                    return interceptor.intercept(ctx, next());
+                            };
+                        }
+                        return x;
                     });
                     return opraAdapter;
                 },
             },
+            {
+                provide: APP_FILTER,
+                useClass: OpraExceptionFilter,
+            },
         ];
-        if (token !== OpraNestAdapter)
+        if (token !== OpraNestAdapter) {
             providers.push({
                 provide: token,
                 useValue: opraAdapter,
             });
+        }
         return {
             module: OpraHttpCoreModule_1,
-            controllers: opraAdapter.controllers,
-            imports: [...(options?.imports || [])],
-            exports: [...(options?.exports || []), token],
+            controllers: opraAdapter.nestControllers,
+            imports: [...(init?.imports || [])],
+            exports: [...(init?.exports || []), token],
             providers,
         };
     }

package/esm/opra-http.module.js

@@ -5,12 +5,13 @@ import { OpraHttpCoreModule } from './opra-http-core.module.js';
 let OpraHttpModule = OpraHttpModule_1 = class OpraHttpModule {
     /**
      *
+     * @param init
      * @param options
      */
-    static forRoot(options) {
+    static forRoot(init, options) {
         return {
             module: OpraHttpModule_1,
-            imports: [OpraHttpCoreModule.forRoot(options)],
+            imports: [OpraHttpCoreModule.forRoot(init, options)],
         };
     }
 };

package/esm/opra-nestjs-adapter.js

@@ -1,91 +1,119 @@
-import nodePath from 'path';
-import { Controller, Delete, Get, Head, Options, Patch, Post, Put, Req, Res, Search, UseFilters, } from '@nestjs/common';
+import { __decorate, __metadata, __param } from "tslib";
+import { Controller, Delete, Get, Head, Next, Options, Patch, Post, Put, Req, Res, Search } from '@nestjs/common';
+import { EXCEPTION_FILTERS_METADATA, GUARDS_METADATA, INTERCEPTORS_METADATA } from '@nestjs/common/constants';
 import { ApiDocument, HTTP_CONTROLLER_METADATA, HttpApi, isConstructor, NotFoundError, } from '@opra/common';
-import { HttpAdapter, HttpContext, HttpIncoming, HttpOutgoing } from '@opra/core';
-import { OpraExceptionFilter } from './services/opra-exception-filter.js';
-export const kHandler = Symbol.for('kHandler');
+import { HttpAdapter } from '@opra/core';
+import nodePath from 'path';
+import { asMutable } from 'ts-gems';
+import { Public } from './decorators/public.decorator.js';
 export class OpraNestAdapter extends HttpAdapter {
-    constructor(options) {
+    constructor(init, options) {
         super((function () {
             const document = new ApiDocument();
             document.api = new HttpApi(document);
             return document;
-        })(), options);
-        // protected _platform: string = 'express';
-        this.controllers = [];
-        let basePath = options.basePath || '/';
+        })(), {
+            ...options,
+            interceptors: options?.interceptors,
+        });
+        this.nestControllers = [];
+        this.options = options;
+        let basePath = options?.basePath || '/';
         if (!basePath.startsWith('/'))
             basePath = '/' + basePath;
-        if (options.controllers)
-            options.controllers.forEach(c => this._createNestControllers(c, basePath));
+        this._addRootController(basePath);
+        if (init.controllers)
+            init.controllers.forEach(c => this._addToNestControllers(c, basePath, []));
     }
     async close() {
         //
     }
-    _createNestControllers(source, currentPath) {
-        const metadata = Reflect.getMetadata(HTTP_CONTROLLER_METADATA, source);
+    _addRootController(basePath) {
+        const _this = this;
+        let RootController = class RootController {
+            schema(_req, next) {
+                _this.handler.sendDocumentSchema(_req.opraContext).catch(() => next());
+            }
+        };
+        __decorate([
+            Get('/\\$schema'),
+            __param(0, Req()),
+            __param(1, Next()),
+            __metadata("design:type", Function),
+            __metadata("design:paramtypes", [Object, Function]),
+            __metadata("design:returntype", void 0)
+        ], RootController.prototype, "schema", null);
+        RootController = __decorate([
+            Controller({
+                path: basePath,
+            })
+        ], RootController);
+        if (this.options?.schemaRouteIsPublic) {
+            Public()(RootController.prototype, 'schema', Object.getOwnPropertyDescriptor(RootController.prototype, 'schema'));
+        }
+        this.nestControllers.push(RootController);
+    }
+    _addToNestControllers(sourceClass, currentPath, parentTree) {
+        const metadata = Reflect.getMetadata(HTTP_CONTROLLER_METADATA, sourceClass);
         if (!metadata)
             return;
         const newClass = {
-            [source.name]: class extends source {
+            [sourceClass.name]: class extends sourceClass {
             },
-        }[source.name];
+        }[sourceClass.name];
+        /** Copy metadata keys from source class to new one */
+        let metadataKeys;
+        OpraNestAdapter.copyDecoratorMetadataToChild(newClass, parentTree);
         const newPath = metadata.path ? nodePath.join(currentPath, metadata.path) : currentPath;
         const adapter = this;
-        /** Inject exception filter */
-        UseFilters(new OpraExceptionFilter(adapter))(newClass);
+        // adapter.logger =
+        /** Disable default error handler. Errors will be handled by OpraExceptionFilter */
+        adapter.handler.onError = (context, error) => {
+            throw error;
+        };
         Controller()(newClass);
-        this.controllers.push(newClass);
+        this.nestControllers.push(newClass);
         if (metadata.operations) {
             for (const [k, v] of Object.entries(metadata.operations)) {
-                const operationHandler = source.prototype[k];
+                const operationHandler = sourceClass.prototype[k];
                 Object.defineProperty(newClass.prototype, k, {
                     writable: true,
                     /** NestJS handler method */
                     async value(_req, _res) {
-                        const request = HttpIncoming.from(_req);
-                        const response = HttpOutgoing.from(_res);
+                        _res.statusCode = 200;
                         const api = adapter.document.api;
-                        const controller = api.findController(newClass);
+                        const controller = api.findController(sourceClass);
                         const operation = controller?.operations.get(k);
-                        if (!(operation && typeof operationHandler === 'function'))
+                        const context = asMutable(_req.opraContext);
+                        if (!(context && operation && typeof operationHandler === 'function')) {
                             throw new NotFoundError({
-                                message: `No endpoint found for [${request.method}]${request.baseUrl}`,
+                                message: `No endpoint found for [${_req.method}]${_req.baseUrl}`,
                                 details: {
-                                    path: request.baseUrl,
-                                    method: request.method,
+                                    path: _req.baseUrl,
+                                    method: _req.method,
                                 },
                             });
-                        /** Create the HttpContext */
-                        const context = new HttpContext({
-                            adapter,
-                            platform: _req.route ? 'express' : 'fastify',
-                            platformArgs: {
-                                request,
-                                response,
-                            },
-                            request,
-                            response,
-                            operation,
-                            controller: operation.owner,
-                            controllerInstance: this,
-                            operationHandler,
-                        });
+                        }
+                        /** Configure the HttpContext */
+                        context.operation = operation;
+                        context.controller = operation.owner;
+                        context.controllerInstance = this;
+                        context.operationHandler = operationHandler;
                         /** Handle request */
-                        await adapter[kHandler].handleRequest(context);
+                        await adapter.handler.handleRequest(context);
                     },
                 });
-                Req()(newClass.prototype, k, 0);
-                Res()(newClass.prototype, k, 1);
                 /** Copy metadata keys from source function to new one */
-                const metadataKeys = Reflect.getOwnMetadataKeys(operationHandler);
+                metadataKeys = Reflect.getOwnMetadataKeys(operationHandler);
                 const newFn = newClass.prototype[k];
                 for (const key of metadataKeys) {
                     const m = Reflect.getMetadata(key, operationHandler);
                     Reflect.defineMetadata(key, m, newFn);
                 }
+                Req()(newClass.prototype, k, 0);
+                Res()(newClass.prototype, k, 1);
                 const descriptor = Object.getOwnPropertyDescriptor(newClass.prototype, k);
-                const operationPath = newPath + (v.path || '');
+                const operationPath = v.mergePath ? newPath + (v.path || '') : nodePath.posix.join(newPath, v.path || '');
                 switch (v.method || 'GET') {
                     case 'DELETE':
                         /** Call @Delete decorator over new property */
@@ -119,6 +147,8 @@ export class OpraNestAdapter extends HttpAdapter {
                         /** Call @Search decorator over new property */
                         Search(operationPath)(newClass.prototype, k, descriptor);
                         break;
+                    default:
+                        break;
                 }
             }
         }
@@ -126,7 +156,30 @@ export class OpraNestAdapter extends HttpAdapter {
             for (const child of metadata.controllers) {
                 if (!isConstructor(child))
                     throw new TypeError('Controllers should be injectable a class');
-                this._createNestControllers(child, newPath);
+                this._addToNestControllers(child, newPath, [...parentTree, sourceClass]);
+            }
+        }
+    }
+    static copyDecoratorMetadataToChild(target, parentTree) {
+        for (const parent of parentTree) {
+            const metadataKeys = Reflect.getOwnMetadataKeys(parent);
+            for (const key of metadataKeys) {
+                if (typeof key === 'string' && key.startsWith('opra:') && !Reflect.hasOwnMetadata(key, target)) {
+                    const metadata = Reflect.getMetadata(key, parent);
+                    Reflect.defineMetadata(key, metadata, target);
+                    continue;
+                }
+                if (key === GUARDS_METADATA || key === INTERCEPTORS_METADATA || key === EXCEPTION_FILTERS_METADATA) {
+                    const m1 = Reflect.getMetadata(key, target) || [];
+                    const metadata = [...m1];
+                    const m2 = Reflect.getOwnMetadata(key, parent) || [];
+                    m2.forEach((t) => {
+                        if (!metadata.includes(t)) {
+                            metadata.push(t);
+                        }
+                    });
+                    Reflect.defineMetadata(key, metadata, target);
+                }
             }
         }
     }

package/esm/services/opra-exception-filter.js

@@ -1,14 +1,23 @@
-import { HttpOutgoing, wrapException } from '@opra/core';
-export const kHandler = Symbol.for('kHandler');
-export class OpraExceptionFilter {
-    constructor(adapter) {
-        this.adapter = adapter;
+import { __decorate, __metadata } from "tslib";
+import { Catch } from '@nestjs/common';
+import { BaseExceptionFilter, ModuleRef } from '@nestjs/core';
+import { OpraNestAdapter } from '../opra-nestjs-adapter.js';
+let OpraExceptionFilter = class OpraExceptionFilter extends BaseExceptionFilter {
+    constructor(moduleRef) {
+        super();
+        this.moduleRef = moduleRef;
     }
     catch(exception, host) {
-        const ctx = host.switchToHttp();
-        const _res = ctx.getResponse();
-        const error = wrapException(exception);
-        const response = HttpOutgoing.from(_res);
-        return this.adapter[kHandler].sendErrorResponse(response, [error]);
+        const ctx = host.switchToHttp().getRequest().opraContext;
+        if (ctx) {
+            const adapter = this.moduleRef.get(OpraNestAdapter);
+            ctx.errors.push(exception);
+            return adapter.handler.sendResponse(ctx);
+        }
     }
-}
+};
+OpraExceptionFilter = __decorate([
+    Catch(),
+    __metadata("design:paramtypes", [ModuleRef])
+], OpraExceptionFilter);
+export { OpraExceptionFilter };

package/esm/services/opra-middleware.js

@@ -0,0 +1,33 @@
+import { __decorate, __metadata, __param } from "tslib";
+import { Inject, Injectable } from '@nestjs/common';
+import { HttpContext, HttpIncoming, HttpOutgoing } from '@opra/core';
+import { OPRA_HTTP_MODULE_OPTIONS } from '../constants';
+import { OpraNestAdapter } from '../opra-nestjs-adapter.js';
+let OpraMiddleware = class OpraMiddleware {
+    constructor(opraAdapter, options) {
+        this.opraAdapter = opraAdapter;
+        this.options = options;
+    }
+    use(req, res, next) {
+        const request = HttpIncoming.from(req);
+        const response = HttpOutgoing.from(res);
+        /** Create the HttpContext */
+        const context = new HttpContext({
+            adapter: this.opraAdapter,
+            platform: req.route ? 'express' : 'fastify',
+            request,
+            response,
+        });
+        req.opraContext = context;
+        this.opraAdapter
+            .emitAsync('createContext', context)
+            .then(() => next())
+            .catch(next);
+    }
+};
+OpraMiddleware = __decorate([
+    Injectable(),
+    __param(1, Inject(OPRA_HTTP_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [OpraNestAdapter, Object])
+], OpraMiddleware);
+export { OpraMiddleware };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opra/nestjs",
-  "version": "1.0.0-alpha.3",
+  "version": "1.0.0-alpha.30",
   "description": "Opra NestJS module",
   "author": "Panates",
   "license": "MIT",
@@ -18,8 +18,8 @@
     "postbuild": "cp README.md package.json ../../LICENSE ../../build/nestjs && cp ../../package.cjs.json ../../build/nestjs/cjs/package.json",
     "lint": "eslint . --max-warnings=0",
     "format": "prettier . --write --log-level=warn",
-    "test": "jest",
-    "cover": "jest --collect-coverage",
+    "test": "jest --passWithNoTests",
+    "cover": "jest --passWithNoTests --collect-coverage",
     "clean": "npm run clean:src && npm run clean:test && npm run clean:dist && npm run clean:cover",
     "clean:src": "ts-cleanup -s src --all",
     "clean:test": "ts-cleanup -s test --all",
@@ -27,21 +27,26 @@
     "clean:cover": "rimraf ../../coverage/client"
   },
   "dependencies": {
-    "@opra/common": "^1.0.0-alpha.3",
-    "@opra/core": "^1.0.0-alpha.3",
+    "@opra/common": "^1.0.0-alpha.30",
+    "@opra/core": "^1.0.0-alpha.30",
     "fast-tokenizer": "^1.3.0",
     "lodash.head": "^4.0.1",
-    "reflect-metadata": "^0.2.2"
+    "putil-promisify": "^1.10.1",
+    "reflect-metadata": "^0.2.2",
+    "tslib": "^2.6.3"
   },
   "peerDependencies": {
-    "@nestjs/common": "^10.3.9",
-    "@nestjs/core": "^10.3.9"
+    "@nestjs/common": "^10.3.10",
+    "@nestjs/core": "^10.3.10"
   },
   "devDependencies": {
-    "@nestjs/platform-express": "^10.3.9",
-    "@nestjs/testing": "^10.3.9",
+    "@nestjs/platform-express": "^10.3.10",
+    "@nestjs/testing": "^10.3.10",
     "@types/lodash.head": "^4.0.9",
+    "express": "^4.19.2",
     "filedirname": "^3.4.0",
+    "rxjs": "^7.8.1",
+    "supertest": "^7.0.0",
     "ts-gems": "^3.4.0"
   },
   "type": "module",

package/types/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const IS_PUBLIC_KEY = "opra:isPublic";
+export declare const OPRA_HTTP_MODULE_OPTIONS = "OPRA_HTTP_MODULE_OPTIONS";

package/types/decorators/public.decorator.d.ts

@@ -0,0 +1 @@
+export declare const Public: () => import("@nestjs/common").CustomDecorator<string>;

package/types/index.d.ts

@@ -1,4 +1,6 @@
 import 'reflect-metadata';
 import './augmentation/nestjs.augmentation.js';
+export * from './constants.js';
+export * from './decorators/public.decorator.js';
 export * from './opra-http.module.js';
 export * from './opra-nestjs-adapter.js';

package/types/opra-http-core.module.d.ts

@@ -1,9 +1,10 @@
-import { DynamicModule, OnModuleDestroy } from '@nestjs/common';
-import type { OpraHttpModule } from './opra-http.module';
+import { DynamicModule, MiddlewareConsumer, NestModule, OnModuleDestroy } from '@nestjs/common';
+import type { OpraHttpModule } from './opra-http.module.js';
 import { OpraNestAdapter } from './opra-nestjs-adapter.js';
-export declare class OpraHttpCoreModule implements OnModuleDestroy {
+export declare class OpraHttpCoreModule implements OnModuleDestroy, NestModule {
     protected opraAdapter: OpraNestAdapter;
     constructor(opraAdapter: OpraNestAdapter);
-    static forRoot(options: OpraHttpModule.Options): DynamicModule;
+    configure(consumer: MiddlewareConsumer): void;
+    static forRoot(init: OpraHttpModule.Initiator, options?: OpraHttpModule.Options): DynamicModule;
     onModuleDestroy(): Promise<void>;
 }

package/types/opra-http.module.d.ts

@@ -1,16 +1,22 @@
-import { DynamicModule } from '@nestjs/common';
+import { DynamicModule, Type } from '@nestjs/common';
 import { ApiDocumentFactory } from '@opra/common';
+import { HttpAdapter } from '@opra/core';
 export declare namespace OpraHttpModule {
-    interface Options extends Pick<DynamicModule, 'imports' | 'providers' | 'exports' | 'controllers'>, Pick<ApiDocumentFactory.InitArguments, 'types' | 'references' | 'info'> {
+    interface Initiator extends Pick<DynamicModule, 'imports' | 'providers' | 'exports' | 'controllers'>, Pick<ApiDocumentFactory.InitArguments, 'types' | 'references' | 'info'> {
         id?: any;
         name: string;
+    }
+    interface Options {
         basePath?: string;
+        schemaRouteIsPublic?: boolean;
+        interceptors?: (HttpAdapter.InterceptorFunction | HttpAdapter.IHttpInterceptor | Type<HttpAdapter.IHttpInterceptor>)[];
     }
 }
 export declare class OpraHttpModule {
     /**
      *
+     * @param init
      * @param options
      */
-    static forRoot(options: OpraHttpModule.Options): DynamicModule;
+    static forRoot(init: OpraHttpModule.Initiator, options?: OpraHttpModule.Options): DynamicModule;
 }

package/types/opra-nestjs-adapter.d.ts

@@ -1,10 +1,12 @@
 import { Type } from '@nestjs/common';
 import { HttpAdapter } from '@opra/core';
-import type { OpraHttpModule } from './opra-http.module';
-export declare const kHandler: unique symbol;
+import type { OpraHttpModule } from './opra-http.module.js';
 export declare class OpraNestAdapter extends HttpAdapter {
-    readonly controllers: Type[];
-    constructor(options: OpraHttpModule.Options);
+    readonly nestControllers: Type[];
+    readonly options?: OpraHttpModule.Options;
+    constructor(init: OpraHttpModule.Initiator, options?: OpraHttpModule.Options);
     close(): Promise<void>;
-    protected _createNestControllers(source: Type, currentPath: string): void;
+    protected _addRootController(basePath: string): void;
+    protected _addToNestControllers(sourceClass: Type, currentPath: string, parentTree: Type[]): void;
+    static copyDecoratorMetadataToChild(target: Type, parentTree: Type[]): void;
 }

package/types/services/opra-exception-filter.d.ts

@@ -1,8 +1,7 @@
-import { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
-import { OpraNestAdapter } from '../opra-nestjs-adapter.js';
-export declare const kHandler: unique symbol;
-export declare class OpraExceptionFilter implements ExceptionFilter {
-    readonly adapter: OpraNestAdapter;
-    constructor(adapter: OpraNestAdapter);
-    catch(exception: any, host: ArgumentsHost): Promise<void>;
+import { ArgumentsHost } from '@nestjs/common';
+import { BaseExceptionFilter, ModuleRef } from '@nestjs/core';
+export declare class OpraExceptionFilter extends BaseExceptionFilter {
+    private moduleRef;
+    constructor(moduleRef: ModuleRef);
+    catch(exception: any, host: ArgumentsHost): Promise<void> | undefined;
 }

package/types/services/opra-middleware.d.ts

@@ -0,0 +1,10 @@
+import { NestMiddleware } from '@nestjs/common';
+import type { NextFunction, Request, Response } from 'express';
+import type { OpraHttpModule } from '../opra-http.module.js';
+import { OpraNestAdapter } from '../opra-nestjs-adapter.js';
+export declare class OpraMiddleware implements NestMiddleware {
+    protected opraAdapter: OpraNestAdapter;
+    protected options: OpraHttpModule.Options;
+    constructor(opraAdapter: OpraNestAdapter, options: OpraHttpModule.Options);
+    use(req: Request, res: Response, next: NextFunction): void;
+}