feat(auth): Sign In, Sign Up, Reset Password

.eslintrc.json

@@ -3,9 +3,22 @@
   "ignorePatterns": ["**/*"],
   "plugins": ["@nx"],
   "overrides": [
+    {
+      "files": ["*.ts", "*.js"],
+      "extends": ["plugin:@darraghor/nestjs-typed/recommended"],
+      "parser": "@typescript-eslint/parser",
+      "parserOptions": {
+        "project": ["./tsconfig.base.json"]
+      },
+      "plugins": ["@darraghor/nestjs-typed"],
+      "rules": {
+        "@darraghor/nestjs-typed/injectable-should-be-provided": "off"
+      }
+    },
     {
       "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
       "rules": {
+        "indent": ["error", 2],
         "@nx/enforce-module-boundaries": [
           "error",
           {

.github/workflows/ci.yml

@@ -11,29 +11,58 @@ permissions:
   contents: read
 
 jobs:
-  main:
+  lint:
+    environment: staging
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 20
+          cache: 'yarn'
+      - run: yarn install --frozen-lockfile
+      - run: yarn nx affected -t lint
 
-      # Connect your workspace on nx.app and uncomment this to enable task distribution.
-      # The "--stop-agents-after" is optional, but allows idle agents to shut down once the "build" targets have been requested
-      # - run: pnpm exec nx-cloud start-ci-run --distribute-on="5 linux-medium-js" --stop-agents-after="build"
-
-      - uses: pnpm/action-setup@v2
+  test:
+    environment: staging
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
         with:
-          version: 8
-      # Cache node_modules
+          fetch-depth: 0
       - uses: actions/setup-node@v3
         with:
           node-version: 20
-          cache: 'pnpm'
-      - run: pnpm install --frozen-lockfile
-      - uses: nrwl/nx-set-shas@v4
+          cache: 'yarn'
+      - run: yarn install --frozen-lockfile
+      - run: yarn nx affected -t test
 
-      - run: git branch --track main origin/main
-        if: ${{ github.event_name == 'pull_request' }}
+  build:
+    environment: staging
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 20
+          cache: 'yarn'
+      - run: yarn install --frozen-lockfile
+      - run: yarn nx affected -t build
 
-      - run: pnpm exec nx affected -t lint test builde e2e
+  e2e:
+    environment: staging
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 20
+          cache: 'yarn'
+      - run: yarn install --frozen-lockfile
+      - run: yarn nx affected -t e2e

.gitignore

@@ -40,3 +40,7 @@ Thumbs.db
 
 .nx/cache
 .env.local.development
+.env.*
+.env
+.vercel
+infra/postgres

apps/api-e2e/.eslintrc.json

@@ -1,6 +1,6 @@
 {
   "extends": ["../../.eslintrc.json"],
-  "ignorePatterns": ["!**/*"],
+  "ignorePatterns": ["**/webpack.*.json", "**/node_modules/", "!**/*"],
   "overrides": [
     {
       "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],

apps/api-e2e/src/api/auth.spec.ts

@@ -0,0 +1,92 @@
+import { USERS_REPOSITORY } from '@goran/users';
+import { INestApplication, ValidationPipe } from '@nestjs/common';
+import { Test } from '@nestjs/testing';
+
+/* eslint-disable @nx/enforce-module-boundaries */
+import { AppModule } from 'apps/api/src/app/app.module';
+import { MockUsersRepository } from 'libs/domain/users/src/repositories/user-mock.repository';
+/* eslint-enable @nx/enforce-module-boundaries */
+
+import request from 'supertest';
+
+const user = {
+    email: 'rogan@goran.com',
+    username: 'rogan',
+    fullname: 'Joe Rogan',
+    password: 'JoeR0gan',
+};
+
+describe('Authentication /api/auth', () => {
+    let app: INestApplication;
+
+    beforeAll(async () => {
+        const moduleRef = await Test.createTestingModule({
+            imports: [AppModule],
+        })
+            .overrideProvider(USERS_REPOSITORY)
+            .useClass(MockUsersRepository)
+            .compile();
+        app = moduleRef.createNestApplication();
+        app.useGlobalPipes(new ValidationPipe());
+        await app.init();
+    });
+
+    test(`User registeration`, async () => {
+        const res = await request(app.getHttpServer())
+            .post('/auth/signup')
+            .send(user);
+        expect(res.body.data.tokens).toBeDefined();
+        expect(res.body.data.user.email).toEqual(user.email);
+        expect(res.body.data.user.username).toEqual(user.username);
+        expect(res.body.data.user.password).not.toBeDefined();
+        expect(res.status).toEqual(201);
+    });
+
+    it(`should not signup user with weak password`, async () => {
+        const res = await request(app.getHttpServer())
+            .post('/auth/signup')
+            .send({ ...user, password: 'weakpass' });
+        expect(res.body.error).toMatch('Bad Request');
+        expect(res.body.message).toEqual([
+            'Password must contain at least one lowercase letter, one uppercase letter, and one digit',
+        ]);
+        expect(res.body.statusCode).toEqual(400);
+    });
+
+    it(`login using email`, async () => {
+        const res = await request(app.getHttpServer())
+            .post('/auth/signin')
+            .send({ email: user.email, password: user.password });
+        expect(res.body.data.tokens).toBeDefined();
+        expect(res.body.data.user.email).toEqual(user.email);
+        expect(res.body.data.user.username).toEqual(user.username);
+        expect(res.body.data.user.password).not.toBeDefined();
+        expect(res.status).toEqual(201);
+    });
+
+    it(`login using username`, async () => {
+        const res = await request(app.getHttpServer())
+            .post('/auth/signin')
+            .send({ username: user.username, password: user.password });
+        expect(res.body.data.tokens).toBeDefined();
+        expect(res.body.data.user.email).toEqual(user.email);
+        expect(res.body.data.user.username).toEqual(user.username);
+        expect(res.body.data.user.password).not.toBeDefined();
+        expect(res.status).toEqual(201);
+    });
+
+    it(`should not login with invalid password`, async () => {
+        const res = await request(app.getHttpServer())
+            .post('/auth/signin')
+            .send({ email: user.email, password: user.password + 'invalid' });
+        expect(res.body.error).toBeDefined();
+        expect(res.body.message).toEqual(
+            'User not found or the provided credential is invalid.'
+        );
+        expect(res.status).toEqual(400);
+    });
+
+    afterAll(async () => {
+        await app.close();
+    });
+});

apps/api/src/app/app.controller.ts

@@ -1,15 +1,19 @@
 import { Controller, Get } from '@nestjs/common';
-
 import { AppService } from './app.service';
+import { ApiOkResponse, ApiTags } from '@nestjs/swagger';
 
+@ApiTags()
 @Controller()
 export class AppController {
   constructor(private readonly appService: AppService) { }
 
+  @ApiOkResponse()
   @Get('health')
   getHealth() {
     return this.appService.getHealthStatus();
   }
+
+  @ApiOkResponse()
   @Get()
   getData() {
     return this.appService.getData();

apps/api/src/app/app.module.ts

@@ -1,11 +1,34 @@
 import { Module } from '@nestjs/common';
-
+import { ConfigModule, ConfigService } from '@nestjs/config';
 import { AppController } from './app.controller';
 import { AppService } from './app.service';
+import { CONFIG_APP, configSchema } from '@goran/config';
+import { UsersModule } from '@goran/users';
+import { AuthenticationModule } from '@goran/security';
+import { DatabaseModule } from '@goran/drizzle-data-access';
 
 @Module({
-  imports: [],
+  imports: [
+    DatabaseModule.forRootAsync({
+      imports: [ConfigModule],
+      inject: [ConfigService],
+      useFactory: (configService: ConfigService) => ({
+        host: configService.get(CONFIG_APP.DB_HOST),
+        port: configService.get(CONFIG_APP.DB_PORT),
+        user: configService.get(CONFIG_APP.DB_USER),
+        password: configService.get(CONFIG_APP.DB_PASSWORD),
+        database: configService.get(CONFIG_APP.DB_DATABASE),
+      }),
+    }),
+    ConfigModule.forRoot({
+      isGlobal: true,
+      envFilePath: ['.env', '.env.local'],
+      validationSchema: configSchema,
+    }),
+    UsersModule,
+    AuthenticationModule,
+  ],
   controllers: [AppController],
   providers: [AppService],
 })
-export class AppModule {}
+export class AppModule { }

apps/api/src/globals.ts

@@ -0,0 +1,21 @@
+import {
+    ClassSerializerInterceptor,
+    INestApplication,
+    ValidationPipe,
+} from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+
+/**
+ * Registers global pipes and interceptors, plus server conifguration
+ *
+ * @param app - Nestjs application object
+ * @returns Modified and configured nestjs application object and certain parameters
+ */
+export async function registerGlobals(app: INestApplication) {
+    const globalPrefix = 'api';
+    app.setGlobalPrefix(globalPrefix);
+    app.useGlobalPipes(new ValidationPipe());
+    app.useGlobalInterceptors(new ClassSerializerInterceptor(app.get(Reflector)));
+
+    return { app, globalPrefix };
+}

apps/api/src/main.ts

@@ -1,17 +1,28 @@
 import { Logger } from '@nestjs/common';
 import { NestFactory } from '@nestjs/core';
-
+import { CONFIG_APP } from '@goran/config';
 import { AppModule } from './app/app.module';
+import { registerGlobals } from './globals';
+import { setupSwagger } from './swagger';
+import { goranBanner } from '@goran/utils';
 
 async function bootstrap() {
   const app = await NestFactory.create(AppModule);
-  const globalPrefix = 'api';
-  app.setGlobalPrefix(globalPrefix);
-  const port = process.env.PORT || 3000;
-  await app.listen(port);
-  Logger.log(
-    `🚀 Application is running on: http://localhost:${port}/${globalPrefix}`
+  const logger = new Logger('BOOTSTRAP');
+  const port = process.env[CONFIG_APP.SERVER_PORT] || 3000;
+
+  const { globalPrefix } = await registerGlobals(app);
+  setupSwagger(app);
+
+  logger.log(goranBanner);
+  logger.log(
+    `  Application is running on: http://localhost:${port}/${globalPrefix}`
   );
+  logger.log(
+    `  Documentation is running on: http://localhost:${port}/${globalPrefix}/docs`
+  );
+
+  await app.listen(port);
 }
 
 bootstrap();

apps/api/src/swagger.ts

@@ -0,0 +1,12 @@
+import { INestApplication } from '@nestjs/common';
+import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
+
+export function setupSwagger(app: INestApplication) {
+  const config = new DocumentBuilder()
+    .setTitle('Goran API')
+    .setDescription('Goran REST-API')
+    .setVersion('1.0')
+    .build();
+  const document = SwaggerModule.createDocument(app, config);
+  SwaggerModule.setup('docs', app, document);
+}

apps/api/webpack.config.js

@@ -2,18 +2,18 @@ const { NxWebpackPlugin } = require('@nx/webpack');
 const { join } = require('path');
 
 module.exports = {
-  output: {
-    path: join(__dirname, '../../dist/apps/api'),
-  },
-  plugins: [
-    new NxWebpackPlugin({
-      target: 'node',
-      compiler: 'tsc',
-      main: './src/main.ts',
-      tsConfig: './tsconfig.app.json',
-      assets: ['./src/assets'],
-      optimization: false,
-      outputHashing: 'none',
-    }),
-  ],
+    output: {
+        path: join(__dirname, '../../dist/apps/api'),
+    },
+    plugins: [
+        new NxWebpackPlugin({
+            target: 'node',
+            compiler: 'tsc',
+            main: './src/main.ts',
+            tsConfig: './tsconfig.app.json',
+            assets: ['./src/assets'],
+            optimization: false,
+            outputHashing: 'none',
+        }),
+    ],
 };

libs/core/config/.eslintrc.json

@@ -0,0 +1,18 @@
+{
+  "extends": ["../../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    }
+  ]
+}

libs/core/config/project.json

@@ -0,0 +1,9 @@
+{
+  "name": "config",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/core/config/src",
+  "projectType": "library",
+  "tags": [],
+  "// targets": "to see all targets run: nx show project config --web",
+  "targets": {}
+}

libs/core/config/src/index.ts

@@ -0,0 +1 @@
+export * from './schema';