본문으로 건너뛰기

ApiHelper

@churchapps/apihelper 패키지는 모든 ChurchApps Express.js API를 위한 서버 측 유틸리티를 제공합니다. 기본 컨트롤러 클래스, JWT 인증 미들웨어, 데이터베이스 유틸리티, AWS 통합을 포함하며 모든 API 프로젝트가 의존합니다.

시작하기 전에

포함 내용

  • CustomBaseController -- API 컨트롤러의 기본 클래스
  • 인증 미들웨어 -- CustomAuthProvider를 통한 JWT 인증
  • 데이터베이스 유틸리티 -- MySQL 연결 관리를 위한 DB.query, EnhancedPoolHelper
  • AWS 통합 -- S3, SSM 매개변수 저장소, 기타 AWS 서비스용 헬퍼
  • Inversify DI 설정 -- 의존성 주입 컨테이너 구성

로컬 개발을 위한 설정

  1. 저장소 복제:

    git clone https://github.com/ChurchApps/ApiHelper.git
  2. 의존성 설치:

    cd ApiHelper && npm install
  3. 패키지 빌드 (TypeScript를 dist/로 컴파일):

    npm run build
  4. 로컬 링킹 가능하게 만들기:

    npm link

주요 명령

명령설명
npm run buildTypeScript를 dist/로 컴파일
npm run lintESLint 실행
npm run lint:fix자동 수정과 함께 ESLint 실행
npm run formatPrettier로 코드 포맷
정보

이 패키지는 모든 ChurchApps API의 의존성입니다. 변경을 한 후 게시하기 전에 npm link를 사용하여 API에 대해 테스트하세요.

관련 문서

  • Helpers -- 이 패키지가 의존하는 기본 유틸리티 패키지
  • 모듈 구조 -- 컨트롤러 및 인증 미들웨어가 API 모듈에서 어떻게 사용되는지
  • 로컬 API 설정 -- 로컬 개발용 API 설정