nestjs · sjones6 · Jul 19, 2020 · sjones6 · Jul 19, 2020 · cojack
diff --git a/integration/hello-world/e2e/mvc.express.spec.ts b/integration/hello-world/e2e/mvc.express.spec.ts
@@ -0,0 +1,54 @@
+import { join } from 'path';
+import { INestApplication } from '@nestjs/common';
+import { ExpressAdapter } from '@nestjs/platform-express';
+import { Test } from '@nestjs/testing';
+import * as express from 'express';
+import * as request from 'supertest';
+import * as nunjucks from 'nunjucks';
+import { ApplicationModule } from '../src/app.module';
+
+interface IExpressNestApplication extends INestApplication {
+  setBaseViewsDir(string): IExpressNestApplication
+  setViewEngine(string): IExpressNestApplication
+}
+
+describe('Hello world MVC', () => {
+  let server;
+  let app: IExpressNestApplication;
+
+  beforeEach(async () => {
+    const module = await Test.createTestingModule({
+      imports: [ApplicationModule],
+    }).compile();
+
+    const expressApp = express();
+    nunjucks.configure(join(__dirname, '..', 'src', 'views'), {
+      autoescape: true,
+      express: expressApp
+    });
+
+    app = module.createNestApplication<IExpressNestApplication>(new ExpressAdapter(expressApp));
+    app.setViewEngine('njk')
+    server = app.getHttpServer();
+    await app.init();
+  });
+
+  it(`/GET`, () => {
+    return request(server)
+      .get('/hello/mvc')
+      .expect(200)
+      .expect(/href="\/hello\/mvc/)
+  });
+
+  it(`/GET/:id`, () => {
+    const id = 5;
+    return request(server)
+      .get(`/hello/mvc/${id}`)
+      .expect(200)
+      .expect(new RegExp(`href="/hello/mvc/${id}`))
+  });
+
+  afterEach(async () => {
+    await app.close();
+  });
+});
diff --git a/integration/hello-world/src/hello/hello.controller.ts b/integration/hello-world/src/hello/hello.controller.ts
@@ -1,4 +1,4 @@
-import { Controller, Get, Header, Param } from '@nestjs/common';
+import { Controller, Get, Header, Param, Render, WithAlias } from '@nestjs/common';
 import { Observable, of } from 'rxjs';
 import { HelloService } from './hello.service';
 import { UserByIdPipe } from './users/user-by-id.pipe';
@@ -30,4 +30,24 @@ export class HelloController {
   ): any {
     return user;
   }
+
+  @Get('mvc')
+  @Render('mvc')
+  mvc() {
+    return { message: 'Hello World!' }
+  }
+
+  @Get('mvc-alias')
+  @WithAlias('mvc')
+  @Render('mvc')
+  mvcAliased() {
+    return { message: 'Hello World!' }
+  }
+
+  @Get('mvc/:id')
+  @WithAlias('mvc-id')
+  @Render('mvc-id')
+  mvcAliasedWithId(@Param('id') id) {
+    return { message: 'Hello World!', id }
+  }
 }
diff --git a/integration/hello-world/src/views/mvc-id.njk b/integration/hello-world/src/views/mvc-id.njk
@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+  <meta charset="utf-8">
+  <title>App</title>
+</head>
+
+<body>
+  <h1>{{ message }}</h1>
+  <div>
+    <a href="{{ getUrl('mvc-id', { id: id }) }}">Aliased 'mvc-id' With ID: {{ getUrl('mvc-id', { id: id }) }}</a>
+  </div>
+</body>
+
+</html>
diff --git a/integration/hello-world/src/views/mvc.njk b/integration/hello-world/src/views/mvc.njk
@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+  <meta charset="utf-8">
+  <title>App</title>
+</head>
+
+<body>
+  <h1>{{ message }}</h1>
+  <div>
+    <a href="{{ getUrl('mvc') }}">Aliased 'mvc' to {{ getUrl('mvc') }}</a>
+  </div>
+</body>
+
+</html>
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -147,6 +147,7 @@
     "mysql": "2.18.1",
     "nats": "1.4.9",
     "nodemon": "2.0.4",
+    "nunjucks": "^3.2.1",
     "nyc": "15.1.0",
     "prettier": "2.0.5",
     "redis": "3.0.2",

diff --git a/packages/common/constants.ts b/packages/common/constants.ts
@@ -26,3 +26,4 @@ export const HTTP_CODE_METADATA = '__httpCode__';
 export const MODULE_PATH = '__module_path__';
 export const HEADERS_METADATA = '__headers__';
 export const REDIRECT_METADATA = '__redirect__';
+export const ROUTE_ALIAS_METADATA = '__route_alias__';
diff --git a/packages/common/decorators/http/index.ts b/packages/common/decorators/http/index.ts
@@ -5,3 +5,4 @@ export * from './create-route-param-metadata.decorator';
 export * from './render.decorator';
 export * from './header.decorator';
 export * from './redirect.decorator';
+export * from './route-alias.decorator';
diff --git a/packages/common/decorators/http/route-alias.decorator.ts b/packages/common/decorators/http/route-alias.decorator.ts
@@ -0,0 +1,23 @@
+import { ROUTE_ALIAS_METADATA } from '../../constants';
+
+/**
+ * Alias for the route, which can be resolved to the full route path
+ *
+ * For example: `@WithAlias('alias')`
+ *
+ * @param routeAlias alias for the route
+ *
+ * @see [Model-View-Controller](https://docs.nestjs.com/techniques.mvc)
+ *
+ * @publicApi
+ */
+export function WithAlias(routeAlias: string | Symbol): MethodDecorator {
+  return (
+    target: object,
+    key: string | symbol,
+    descriptor: TypedPropertyDescriptor<any>,
+  ) => {
+    Reflect.defineMetadata(ROUTE_ALIAS_METADATA, routeAlias, descriptor.value);
+    return descriptor;
+  };
+}
diff --git a/packages/common/test/decorators/route-alias.decorator.spec.ts b/packages/common/test/decorators/route-alias.decorator.spec.ts
@@ -0,0 +1,17 @@
+import { expect } from 'chai';
+import { WithAlias } from '../../decorators/http/route-alias.decorator';
+import { ROUTE_ALIAS_METADATA } from '../../constants';
+
+describe('@WithAlias', () => {
+  const alias = 'alias';
+
+  class Test {
+    @WithAlias(alias)
+    public static test() {}
+  }
+
+  it('should enhance method with expected alias string', () => {
+    const metadata = Reflect.getMetadata(ROUTE_ALIAS_METADATA, Test.test);
+    expect(metadata).to.be.eql(alias);
+  });
+});