feat: oauth2 kakao login

apps/server/package.json

@@ -13,6 +13,8 @@
     "private": true,
     "dependencies": {
         "@typegoose/typegoose": "^12.9.0",
+        "@types/jsonwebtoken": "^9.0.7",
+        "axios": "^1.7.9",
         "compression": "^1.7.5",
         "cors": "^2.8.5",
         "cross-env": "^7.0.3",
@@ -22,6 +24,7 @@
         "express-winston": "^4.2.0",
         "helmet": "^8.0.0",
         "hpp": "^0.2.3",
+        "jsonwebtoken": "^9.0.2",
         "mongoose": "^8.8.1",
         "mongoose-paginate-v2": "^1.8.5",
         "winston": "^3.16.0",

apps/server/src/config/index.ts

@@ -2,6 +2,6 @@ import { config } from 'dotenv'
 
 config()
 
-export const { NODE_ENV, DB_URI, DB_NAME } = process.env
+export const { NODE_ENV, DB_URI, DB_NAME, JWT_PRIVATE_KEY } = process.env
 
 export const PORT = Number.parseInt(process.env.PORT) || 5000

apps/server/src/controllers/v1/index.ts

@@ -1,9 +1,11 @@
 import enquiries from './enquiries'
 import events from './events'
 import schedules from './schedules'
+import user from './user'
 
 export default {
     enquiries,
     events,
     schedules,
+    user,
 }

apps/server/src/controllers/v1/user.ts

@@ -0,0 +1,23 @@
+import asyncify from 'express-asyncify'
+import express, { Request, Response } from 'express'
+import { IUserInfo, JWTProvider, Kakao, OAuthPayload } from '@/utils/auth'
+import { User, UserModel } from '@/models/user'
+
+const router = asyncify(express.Router())
+
+router.post('/login', async (req: Request, res: Response) => {
+    const oauthPayload: OAuthPayload = req.body
+
+    // todo: refactor this code blocks after introducing new oauth provider
+    // ==> split the code as service, and adding handler for controller logic
+    if (oauthPayload.provider === 'KAKAO') {
+        const userInfo: IUserInfo = await Kakao.getUserInfo(oauthPayload)
+        const user: User = await UserModel.loadOrCreateUser(userInfo)
+        const jwt = JWTProvider.issueJwt(user)
+        res.status(200).json({
+            accessToken: jwt,
+        })
+    }
+})
+
+export default router

apps/server/src/models/user.ts

@@ -1,6 +1,7 @@
 import mongoose from 'mongoose'
 import { TimeStamps } from '@typegoose/typegoose/lib/defaultClasses'
-import { getModelForClass, prop } from '@typegoose/typegoose'
+import { getModelForClass, prop, ReturnModelType } from '@typegoose/typegoose'
+import { IUserInfo } from '@/utils/auth'
 
 export class User extends TimeStamps {
     public _id: mongoose.Types.ObjectId
@@ -13,6 +14,22 @@ export class User extends TimeStamps {
 
     @prop()
     public providerId: string
+
+    public toJSON() {
+        return {
+            nickname: this.nickname,
+            provider: this.provider,
+            providerId: this.providerId,
+        }
+    }
+
+    public static async loadOrCreateUser(this: ReturnModelType<typeof User>, info: IUserInfo) {
+        let user = await this.findOne({ providerId: info.providerId }).exec()
+        if (!user) {
+            user = await this.create(info)
+        }
+        return user
+    }
 }
 
 export const UserModel = getModelForClass(User)

apps/server/src/server.ts

@@ -36,6 +36,7 @@ export default class Server {
         this.app.use('/v1/enquiries', controllers.v1.enquiries)
         this.app.use('/v1/events', controllers.v1.events)
         this.app.use('/v1/schedules', controllers.v1.schedules)
+        this.app.use('/v1/user', controllers.v1.user)
     }
 
     setPostMiddleware() {

apps/server/src/types/errors/auth.ts

@@ -0,0 +1,9 @@
+import { APIError } from '@/types/errors/error'
+
+export class HttpClientException extends APIError {
+    constructor(cause: Error | string = null) {
+        super(422, 4220, 'auth http client exception', cause)
+        Object.setPrototypeOf(this, HttpClientException.prototype)
+        Error.captureStackTrace(this, HttpClientException)
+    }
+}

apps/server/src/types/errors/index.ts

@@ -1,2 +1,3 @@
 export * from './error'
 export * from './server'
+export * from './auth'

apps/server/src/utils/auth.ts

@@ -0,0 +1,42 @@
+import axios from 'axios'
+import { HttpClientException } from '@/types/errors'
+import { User } from '@/models/user'
+import jwt from 'jsonwebtoken'
+import { JWT_PRIVATE_KEY } from '@/config'
+
+export interface OAuthPayload {
+    accessToken: string
+    provider: string
+}
+
+export interface IUserInfo {
+    nickname: string
+    provider: string
+    providerId: string
+}
+
+export class Kakao {
+    public static async getUserInfo(payload: OAuthPayload) {
+        const { data } = await axios('https://kapi.kakao.com/v2/user/me', {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${payload.accessToken}`,
+                'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8',
+            },
+        }).catch(e => {
+            throw new HttpClientException(e)
+        })
+
+        return {
+            nickname: data.kakao_account.profile.nickname,
+            provider: 'KAKAO',
+            providerId: data.id,
+        }
+    }
+}
+
+export class JWTProvider {
+    public static issueJwt(user: User): string {
+        return jwt.sign({ issuer: 'FIENMEE', user: user }, JWT_PRIVATE_KEY, { expiresIn: '30m' })
+    }
+}