Merge pull request #32 from shekohex/resolve-path

 feat(RouterModule): add `reolvePath` method to get controller full path.

package.json

@@ -25,6 +25,7 @@
   "devDependencies": {
     "@nestjs/common": "^5.0.0",
     "@nestjs/core": "^5.0.0",
+    "@nestjs/testing": "^5.3.11",
     "@types/jest": "^23.0.0",
     "@types/node": "^10.0.3",
     "coveralls": "^3.0.2",

src/router.module.ts

@@ -1,5 +1,8 @@
 import { Module, DynamicModule } from '@nestjs/common';
-import { MODULE_PATH } from '@nestjs/common/constants';
+import { MODULE_PATH, PATH_METADATA } from '@nestjs/common/constants';
+import { ModulesContainer } from '@nestjs/core/injector/modules-container';
+import { Controller, Type } from '@nestjs/common/interfaces';
+import { UnknownElementException } from '@nestjs/core/errors/exceptions/unknown-element.exception';
 import { validatePath } from './utils/validate-path.util';
 import { flatRoutes } from './utils/flat-routes.util';
 import { Routes } from './routes.interface';
@@ -10,6 +13,17 @@ import { Routes } from './routes.interface';
  */
 @Module({})
 export class RouterModule {
+  private static readonly routesContainer: Map<string, string> = new Map();
+  constructor(readonly modulesContainer: ModulesContainer) {
+    const modules = [...modulesContainer.values()];
+    for (const nestModule of modules) {
+      const modulePath: string = Reflect.getMetadata(MODULE_PATH, nestModule.metatype);
+      for (const route of nestModule.routes.values()) {
+        RouterModule.routesContainer.set(route.name, validatePath(modulePath));
+      }
+    }
+  }
+
   /**
    * takes an array of modules and organize them in hierarchy way
    * @param {Routes} routes Array of Routes
@@ -20,6 +34,21 @@ export class RouterModule {
       module: RouterModule,
     };
   }
+
+  /**
+   * get the controller full route path eg: (controller's module prefix + controller's path).
+   * @param {Type<Controller>} controller the controller you need to get it's full path
+   */
+  public static resolvePath(controller: Type<Controller>): string {
+    const controllerPath: string = Reflect.getMetadata(PATH_METADATA, controller);
+    const modulePath = RouterModule.routesContainer.get(controller.name);
+    if (modulePath && controllerPath) {
+      return validatePath(modulePath + controllerPath);
+    } else {
+      throw new UnknownElementException();
+    }
+  }
+
   private static buildPathMap(routes: Routes) {
     const flattenRoutes = flatRoutes(routes);
     flattenRoutes.forEach(route => {

src/test/router.module.spec.ts

@@ -1,12 +1,23 @@
 import { RouterModule } from '../router.module';
-import { Route, Routes } from '../routes.interface';
-import { Module } from '@nestjs/common';
+import { Routes } from '../routes.interface';
+import { Module, Controller } from '@nestjs/common';
+import { MODULE_PATH } from '@nestjs/common/constants';
+import { Test } from '@nestjs/testing';
+import { INestApplication } from '@nestjs/common';
+
 describe('RouterModule', () => {
-  const MODULE_PATH = '__module_path__';
+  let app: INestApplication;
 
-  @Module({})
+  @Controller('/parent-controller')
+  class ParentController {}
+  @Controller('/child-controller')
+  class ChildController {}
+
+  class UnknownController {}
+  @Module({ controllers: [ParentController] })
   class ParentModule {}
-  @Module({})
+
+  @Module({ controllers: [ChildController] })
   class ChildModule {}
 
   @Module({})
@@ -47,4 +58,29 @@ describe('RouterModule', () => {
     expect(authPath).toEqual('/v1');
     expect(paymentPath).toEqual('/v1');
   });
+
+  describe('Full Running App', async () => {
+    beforeAll(async () => {
+      const module = await Test.createTestingModule({
+        imports: [MainModule, AppModule],
+      }).compile();
+      app = module.createNestApplication();
+      await app.init();
+    });
+
+    it('should Resolve Controllers path with its Module Path if any', async () => {
+      expect(RouterModule.resolvePath(ParentController)).toEqual('/parent/parent-controller');
+      expect(RouterModule.resolvePath(ChildController)).toEqual('/parent/child/child-controller');
+    });
+
+    it('should throw error when we cannot find the controller', async () => {
+      expect(() => RouterModule.resolvePath(UnknownController)).toThrowError(
+        'Nest cannot find given element (it does not exist in current context)',
+      );
+    });
+
+    afterAll(async () => {
+      await app.close();
+    });
+  });
 });

tslint.json

@@ -1,5 +1,5 @@
 {
-  "defaultSeverity": "error",
+  "defaultSeverity": "warn",
   "extends": ["tslint:recommended"],
   "jsRules": {
     "no-unused-expression": true