feat: 초대링크 생성 구현

Author: summersummerwhy

apps/backend/src/auth/token/token.service.ts

@@ -3,6 +3,7 @@ import { JwtService } from '@nestjs/jwt';
 import { Response } from 'express';
 
 const HOUR = 60 * 60;
+const DAY = 24 * 60 * 60;
 const FIVE_MONTHS = 5 * 30 * 24 * 60 * 60;
 const MS_HALF_YEAR = 6 * 30 * 24 * 60 * 60 * 1000;
 
@@ -22,6 +23,15 @@ export class TokenService {
     });
   }
 
+  generateInviteToken(workspaceId: number, role: string): string {
+    // 초대용 JWT 토큰 생성
+    const payload = { workspaceId, role };
+    return this.jwtService.sign(payload, {
+      expiresIn: DAY, // 초대 유효 기간: 1일
+      secret: process.env.JWT_SECRET,
+    });
+  }
+
   // 후에 DB 로직 (지금은 refreshToken이 DB로 관리 X)
   // 추가될 때를 위해 일단 비동기 선언
   async refreshAccessToken(refreshToken: string): Promise<string> {

apps/backend/src/workspace/dtos/createWorkspaceInviteUrl.dto.ts

@@ -0,0 +1,18 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString } from 'class-validator';
+
+export class CreateWorkspaceInviteUrlDto {
+  @ApiProperty({
+    example: 'OO 생성에 성공했습니다.',
+    description: 'api 요청 결과 메시지',
+  })
+  @IsString()
+  message: string;
+
+  @ApiProperty({
+    example: 'https://octodocs.local/api/workspace/join?token=12345',
+    description: '워크스페이스 초대용 링크입니다.',
+  })
+  @IsString()
+  inviteUrl: string;
+}

apps/backend/src/workspace/workspace.controller.spec.ts

@@ -6,6 +6,7 @@ import { CreateWorkspaceDto } from './dtos/createWorkspace.dto';
 import { WorkspaceResponseMessage } from './workspace.controller';
 import { NotWorkspaceOwnerException } from '../exception/workspace-auth.exception';
 import { UserWorkspaceDto } from './dtos/userWorkspace.dto';
+import { TokenService } from '../auth/token/token.service';
 
 describe('WorkspaceController', () => {
   let controller: WorkspaceController;
@@ -23,6 +24,10 @@ describe('WorkspaceController', () => {
             getUserWorkspaces: jest.fn(),
           },
         },
+        {
+          provide: TokenService,
+          useValue: {},
+        },
       ],
     })
       .overrideGuard(JwtAuthGuard)
@@ -116,14 +121,19 @@ describe('WorkspaceController', () => {
         },
       ] as UserWorkspaceDto[];
 
+      const expectedResult = {
+        message: WorkspaceResponseMessage.WORKSPACES_RETURNED,
+        workspaces: mockWorkspaces,
+      };
+
       jest
         .spyOn(service, 'getUserWorkspaces')
         .mockResolvedValue(mockWorkspaces);
 
       const result = await controller.getUserWorkspaces(req);
 
       expect(service.getUserWorkspaces).toHaveBeenCalledWith(req.user.sub);
-      expect(result).toEqual(mockWorkspaces);
+      expect(result).toEqual(expectedResult);
     });
   });
 });

apps/backend/src/workspace/workspace.controller.ts

@@ -15,9 +15,9 @@ import { WorkspaceService } from './workspace.service';
 import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard';
 import { MessageResponseDto } from './dtos/messageResponse.dto';
 import { CreateWorkspaceDto } from './dtos/createWorkspace.dto';
-import { UserWorkspaceDto } from './dtos/userWorkspace.dto';
 import { CreateWorkspaceResponseDto } from './dtos/createWorkspaceResponse.dto';
 import { GetUserWorkspacesResponseDto } from './dtos/getUserWorkspacesResponse.dto';
+import { CreateWorkspaceInviteUrlDto } from './dtos/createWorkspaceInviteUrl.dto';
 
 export enum WorkspaceResponseMessage {
   WORKSPACE_CREATED = '워크스페이스를 생성했습니다.',
@@ -84,26 +84,26 @@ export class WorkspaceController {
   @HttpCode(HttpStatus.OK)
   async getUserWorkspaces(@Request() req) {
     const userId = req.user.sub; // 인증된 사용자의 ID
-    const workspaces = this.workspaceService.getUserWorkspaces(userId);
+    const workspaces = await this.workspaceService.getUserWorkspaces(userId);
     return {
       message: WorkspaceResponseMessage.WORKSPACES_RETURNED,
       workspaces,
     };
   }
 
-  // TODO: 후에 역할 나눠서 초대링크 만들 수 있게 확장
+  @ApiResponse({
+    type: CreateWorkspaceInviteUrlDto,
+  })
+  @ApiOperation({
+    summary: '사용자가 워크스페이스의 초대 링크를 생성합니다.',
+  })
   @Post('/:id/invite')
   @UseGuards(JwtAuthGuard) // 로그인 인증
   @HttpCode(HttpStatus.CREATED)
-  async generateInviteLink(
-    @Request() req,
-    @Param('workspaceId') workspaceId: string,
-  ) {
+  async generateInviteLink(@Request() req, @Param('id') id: string) {
+    // TODO: 나중에 guest말도 다른 역할 초대 링크로도 확장
     const userId = req.user.sub; // 인증된 사용자 ID
-    const inviteUrl = await this.workspaceService.generateInviteToken(
-      userId,
-      id,
-    );
+    const inviteUrl = await this.workspaceService.generateInviteUrl(userId, id);
 
     return {
       message: '초대 URL이 생성되었습니다.',

apps/backend/src/workspace/workspace.module.ts

@@ -7,22 +7,16 @@ import { WorkspaceRepository } from './workspace.repository';
 import { UserModule } from '../user/user.module';
 import { RoleModule } from '../role/role.module';
 import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard';
-import { JwtModule } from '@nestjs/jwt';
-import { ConfigModule, ConfigService } from '@nestjs/config';
+import { TokenModule } from '../auth/token/token.module';
 import { TokenService } from '../auth/token/token.service';
+import { JwtService } from '@nestjs/jwt';
 
 @Module({
   imports: [
     TypeOrmModule.forFeature([Workspace]),
     UserModule,
     RoleModule,
-    JwtModule.registerAsync({
-      imports: [ConfigModule],
-      inject: [ConfigService],
-      useFactory: async (configService: ConfigService) => ({
-        secret: configService.get<string>('JWT_SECRET'),
-      }),
-    }),
+    TokenModule,
   ],
   controllers: [WorkspaceController],
   providers: [

apps/backend/src/workspace/workspace.service.spec.ts

@@ -10,6 +10,7 @@ import { CreateWorkspaceDto } from './dtos/createWorkspace.dto';
 import { Workspace } from './workspace.entity';
 import { Role } from '../role/role.entity';
 import { User } from '../user/user.entity';
+import { TokenModule } from '../auth/token/token.module';
 
 describe('WorkspaceService', () => {
   let service: WorkspaceService;
@@ -19,6 +20,7 @@ describe('WorkspaceService', () => {
 
   beforeEach(async () => {
     const module: TestingModule = await Test.createTestingModule({
+      imports: [TokenModule],
       providers: [
         WorkspaceService,
         {

apps/backend/src/workspace/workspace.service.ts

@@ -8,13 +8,15 @@ import { UserNotFoundException } from '../exception/user.exception';
 import { Workspace } from './workspace.entity';
 import { WorkspaceNotFoundException } from '../exception/workspace.exception';
 import { NotWorkspaceOwnerException } from '../exception/workspace-auth.exception';
+import { TokenService } from '../auth/token/token.service';
 
 @Injectable()
 export class WorkspaceService {
   constructor(
     private readonly workspaceRepository: WorkspaceRepository,
     private readonly userRepository: UserRepository,
     private readonly roleRepository: RoleRepository,
+    private readonly tokenService: TokenService,
   ) {}
 
   async createWorkspace(
@@ -57,7 +59,6 @@ export class WorkspaceService {
       throw new WorkspaceNotFoundException();
     }
 
-    // Role Repository에서 해당 workspace의 owner이 userId인지 확인
     // Role Repository에서 해당 workspace의 owner인지 확인
     const role = await this.roleRepository.findOneBy({
       workspaceId: workspace.id,
@@ -89,4 +90,35 @@ export class WorkspaceService {
       role: role.role as 'owner' | 'guest',
     }));
   }
+
+  async generateInviteUrl(
+    userId: number,
+    workspaceId: string,
+  ): Promise<string> {
+    // 워크스페이스가 존재하는지 확인
+    const workspace = await this.workspaceRepository.findOneBy({
+      snowflakeId: workspaceId,
+    });
+
+    if (!workspace) {
+      throw new WorkspaceNotFoundException();
+    }
+
+    // Role Repository에서 해당 사용자가 소유자인지 확인
+    const role = await this.roleRepository.findOneBy({
+      userId,
+      workspaceId: workspace.id,
+      role: 'owner',
+    });
+
+    if (!role) {
+      throw new NotWorkspaceOwnerException();
+    }
+
+    // 게스트용 초대용 토큰 생성
+    const token = this.tokenService.generateInviteToken(workspace.id, 'guest');
+
+    // TODO: 하드코딩 -> 바꿔야할듯?
+    return `https://octodocs.local/api/workspace/join?token=${token}`;
+  }
 }