nestjs

새로운 프로젝트를 준비하면서, 이전에는 JWT를 사용해 유저 인증과 상태 관리를 했지만, 이번에는 Redis를 활용한 세션 방식으로 전환하기로 결정했다. 이와 같은 방식은 유저 상태를 서버에서 직접 관리할 수 있어 보안과 세션 무효화 측면에서 더 유리하다. Redis를 도입한 김에, 인증 외의 일부 기능에도 캐싱을 적용해보자는 이야기가 나왔다.두 기능이 하나의 방식으로 처리될 것이라 예상했지만, 실제로 구현에 들어가 보니 세션 관리와 캐싱은 Redis를 사용한다는 점만 같을 뿐, 접근 방식과 구조가 꽤나 달랐다. 세션 관리는 주로 사용자별 데이터를 일정 시간 유지하고, 주기적으로 갱신하거나 만료시키는 로직이 중심이 되는 반면, 캐싱은 특정 요청에 대한 응답을 빠르게 반환하기 위한 키 기반의 저장 및 조회..

Nest.js에서 컨트롤러와 각각의 프로바이더는 특정한 책임을 갖는다. 하지만 이에 대해 깊게 생각하지 않은 채 서버를 개발을 하다보니 자꾸만 서로의 책임을 침범하는 코드를 작성하게 되는 것 같다. 그래서 지나가는 부록 느낌으로 한 번 정리해보려고 한다. 이 포스트에서 다루는 범위는 컨트롤러 ∙ 레졸버 ∙ 서비스 ∙ 헬퍼 ∙ 유틸리티 ∙ 레포지토리 클래스이며 미들웨어를 비롯한 요청 생명주기 관련 클래스는 [ 미들웨어와 토큰 재발급 ] 포스트에서 확인할 수 있다. 엔드포인트 클래스GraphQL을 처리하는 레졸버의 경우 프로바이더로 취급되며, 드물지만 다른 컴포넌트에 주입해서 사용할 수 있다. 여러 레졸버가 서로 관련된 작업을 처리하거나, 컨트롤러와 레졸버가 동일한 비즈니스 로직을 공유해야 하는 경우 등이 ..

Jest는 Facebook에서 개발한 JavaScript 테스트 프레임워크로써 간단하고 직관적인 API와 강력한 기능을 제공한다. Nest.js는 테스트 도구로서 Jest를 기본 제공하고 있고, React나 Next.js에서는 testing-library를 사용해 Jest 테스트를 수행할 수 있다.Jest의 가장 큰 장점 중 하나는 설정이 거의 필요 없다는 점이다. 다른 테스트 프레임워크들은 종종 복잡한 설정이나 외부 라이브러리의 설치가 요구되지만, Jest는 기본적으로 거의 모든 기능을 내장하고 있어 별다른 준비 없이 바로 사용할 수 있다. 또한, 자동화된 테스트 실행과 빠른 피드백을 제공하여 개발 과정에서 코드 변경 시마다 수동으로 테스트를 실행하는 불편함을 줄여준다.  기본 문법Jest는 test ..

GraphQL은 페이스북에서 개발한 데이터 쿼리 언어이자 런타임으로, REST API의 단점을 보완하기 위해 만들어졌다. 전통적인 REST API는 각 엔드포인트마다 특정 데이터 구조가 고정되어있고, http method를 사용하여 동일한 엔드포인트에 대해 다른 작업을 수행하도록 했다. 하지만 GraphQL은 단 하나의 엔드포인트를 사용하고, 클라이언트가 필요한 데이터를 요청하면 서버가 그에 맞춰 응답한다. 덕분에 불필요한 데이터 전송이 줄어들며, 한 번의 요청으로 여러 자원에 대한 데이터를 가져올 수 있기에 REST API에 비해 효율적으로 네트워크를 사용할 수 있다.표준 GraphQL 요청은 post method만을 사용하며, application/json으로 바디에 쿼리를 실어보낸다.   Graph..

현대 웹 어플리케이션에서는 간단한 회원가입을 통한 사용자 편의성 및 유저 증가를 위해 소셜 로그인 기능이 거의 필수가 되어가고 있다. 소설 로그인을 통해 사용자는 복잡한 가입 절차 없이 구글이나 카카오 등 익숙한 플랫폼 계정을 사용해 간단히 로그인할 수 있다. 이 포스트에서는 OpenID Connect 및 이를 활용하여 소셜 로그인을 구현하는 방법에 대해 알아보고자 한다. OpenID Connect일반적으로 소셜 로그인 기능에 대해 이야기할 때 OAuth 2.0 프로토콜이라고들 하지만, 실제로 사용되는 것은 OpenID Connect이다. OAuth 2.0은 주로 권한 부여에 초점을 두고, 어플리케이션이 사용자 데이터에 안전하게 접근할 수 있도록 액세스 토큰을 발급받아 다른 서비스의 API를 호출하는 데..

댓글 기능의 모든 것을 재귀적으로 구현했던 이 포스트에서 이어집니다 lexical order 혹은 lexicographic order라고도 부르는 사전적 정렬은 ─ 다른 언어에서는 어떤지 모르겠지만 적어도 자바스크립트에서는 ─ 유니코드를 기준으로 오름차순으로 정렬하는 행위를 말한다. 배열을 정렬하는 sort 메소드의 경우 콜백 함수를 지정하지 않으면 사전적 정렬을 수행한다. 사전적 정렬에 따르면 acquaintance는 언제나 b보다 앞서며, 이러한 사전적 정렬의 특성을 활용하면 아주 간단하게 무한한 깊이의 대댓글을 구현할 수 있다.미리 남겨놓지만 lexical order를 활용하는 것이 모든 문제를 해결하는 만능의 도구는 아니다. 재귀적으로 구현하는 방식이 그 구조에 따른 문제점을 내포하고 있었던 것처..

내가 쓸 목적으로 만든 독후감 기록 및 공유 서비스가 하나 있다. 이름은 onef인데, 홍보에 그렇게 열중하지 않았더니 쓰는 사람이 나랑 내 후배들 정도 뿐이다. 하지만 상관 없다. 구현해보고 싶은 기능을 부담 없이 해볼 수 있는 테스트베드로서의 기능은 충분히 만족하고 있으니까. 이 서비스의 프론트와 백엔드는 모두 내가 구현했는데, 각각 NextJS와 NestJS를 사용했다. 데이터베이스는 postgreSQL을 썼는데, SQL을 모르는 관계로 ORM인 Prisma를 사용했다. 재귀적 관계 테이블댓글 기능을 추가하는 건 간단하다. 그런데 대댓글은 어떻게 구현해야 할까. 이에 대해 찾아보다가 RDB에는 재귀적 관계라는 게 있다는 걸 알게되었다. 풀어서 쓰면 자기 자신을 참조하는 모델 연결이라고 해야겠다. P..

Express에서 openAPI를 사용해 한땀한땀 swagger를 설정해나가던 것과는 달리, NestJs에서는 @nestjs/swagger 라이브러리의 힘으로 아주 간단하게 swagger ui를 구현할 수 있다.import { SwaggerModule } from '@nestjs/swagger/dist/swagger-module';import { DocumentBuilder } from '@nestjs/swagger/dist/document-builder';// main.tsasync function bootstrap() { const app = await NestFactory.create(AppModule); // Swagger 설정 const config = new DocumentBuilde..

─미들웨어에 대해 알아보기 전에 한 가지 짚고 넘어가야 할 부분이 있다. NestJs 서버로 들어온 요청은 앞서 살펴본 가드나 파이프 외에도 미들웨어나 인터셉터 등을 거쳐 컨트롤러로 들어간다. 그리고 컨트롤러에 의해 처리된 요청은 인터셉터와 예외 필터를 거쳐 클라이언트에게 전달된다. 이러한 일련의 절차를 요청 생명주기(request lifecycle)라고 부른다.NextJs에서 요청은 [ 미들웨어 ➠ 가드 ➠ 인터셉터 ➠ 파이프 ➠ 컨트롤러 ➠ 인터셉터 ➠ 예외 필터 ]의 순으로 처리된다. 이 중 컨트롤러 앞에서 요청을 처리하는 컴포넌트는 [ 전역 ➠ 컨트롤러 ➠ 라우터 ] 순서로 동작하고, 컨트롤러 뒤에서 응답을 처리하는 컴포넌트는 그 반대의 순서로 동작한다. 이를 도식화하면 아래와 같다. 미들웨어토큰..

NestJs의 가드(Guard)는 요청이 특정 조건을 만족하는지 확인하여 요청을 처리할지 여부를 결정하는 데 사용된다. 이를 통해 인증/인가 및 기타 요청 전 조건을 쉽게 설정할 수 있다. 가드는 미들웨어와 유사하지만 실행 컨텍스트 인스턴스에 접근할 수 있어 더 세밀한 컨트롤을 제공한다.// 글로벌 가드async function bootstrap() { const app = await NestFactory.create(AppModule); app.useGlobalGuards(new AuthGuard()); await app.listen(3000);}// 컨트롤러 가드@Controller('')@UseGuards(AuthGuard)export class Controller { @Get() find..

유저 기능을 구현하는 방식에는 여러가지가 있지만, 그 중에서도 나는 JWT 토큰을 만들어 쿠키로 구워주는 방식을 선호한다. 이유야 여럿 있겠다만, 가장 큰 이유 중 하나로는 클라이언트 측에서 따로 뭘 해줄 필요가 없다는 점을 꼽을 수 있겠다. 물론 이 방식에 단점이 없는 것은 아니지만 백엔드가 모든 것을 통제하는 상황은 나열할 수 있는 여타 단점들을 모두 상쇄하지 않나 싶다. NestJs에서는 @nestjs/jwt 패키지를 사용해 토큰을 발급하고 사용한다. 이 패키지는 JwtModule과 JwtService를 제공하며, 이를 통해 다양한 기능에 쉽고 편하게 접근할 수 있다. JwtModule는 동적 모듈이기에 register 메소드를 호출하여 생성한다. 메소드에 옵션 객체를 제공하여 이것저것 설정할 수 ..

PipesNestJs에서 파이프는 데이터의 유효성 검사 및 변환을 위해 사용된다. 주로 요청(request) 데이터를 처리하는 데 사용되며, 컨트롤러에 도달하기 전에 데이터를 변환(transformation)하거나 유효성을 검증(validation)하는 역할을 한다.커스텀 파이프를 생성할 수도 있지만, Nest에서 제공하는 9가지 빌트인 파이프를 가져다 쓸 수도 있다. 이 빌트인 파이프에는 타입을 변환하는 7개의 파이프와 타입을 검증하는 ValidationPipe, 그리고 기본 값을 부여하는 DefaultValuePipe가 있다. 데코레이터가 사용하는 위치에 따라 조금씩 다른 것처럼, 파이프도 사용하는 위치에 따라 글로벌∙핸들러∙파라미터 파이프로 구분된다.// 글로벌 파이프async function bo..