🌐 HTTP Clients

📖 개요

http-clients 패키지는 HTTP 요청을 처리하기 위한 유틸리티와 클라이언트 코드를 제공하기 위한 내부 패키지입니다.

🎯 주요 목표

이 패키지는 다음과 같은 주요 목표들을 가지고 작성되었어요:

• HTTP 클라이언트 인스턴스(self, iamhoonse.dev)를 제공하여 일관된 요청 처리
• 웹 브라우저와 Node.js 환경에서 모두 사용할 수 있는 HTTP 클라이언트 제공
• 코드 스플리팅 및 트리 쉐이킹을 지원하기 위한 Vite 기반 빌드 설정
• TypeScript 선언 파일 제공을 위한 설정

📦 제공 기능

• Instances: self 및 iamhoonse.dev와 같은 HTTP 클라이언트 인스턴스를 제공해요.
• Mocks: self 및 iamhoonse.dev와 관련된 요청 핸들러를 MSW(Mock Service Worker)와 함께 사용할 수 있도록 제공해요.
• Types: HTTP 요청 및 응답과 관련된 타입을 정의해요.

🛠️ 빌드 방식 및 주요 설정

이 패키지는 Vite와 TypeScript를 기반으로 멀티 엔트리 라이브러리 형태로 빌드됩니다.
각 기능별로 별도의 엔트리(instances, mocks, types)를 제공하며, 빌드 산출물은 dist 폴더에 ES 모듈(.es.js)과 CommonJS(.cjs.js) 형식으로 생성됩니다.

package.json

• exports: 각 기능별 엔트리(./instances, ./mocks, ./types)를 분리해 타입 선언(.d.ts), ES 모듈, CJS 모듈을 모두 제공합니다.
• private: "private": true로 npm 공개 배포를 하지 않도록 설정되어 있습니다.
• files: 빌드 산출물(dist)만 패키지에 포함되도록 지정합니다.
• scripts: Vite와 TypeScript를 활용한 빌드, 타입 체크, 테스트 등 다양한 개발 스크립트가 정의되어 있습니다.

vite.config.ts

• 멀티 엔트리 빌드: shared/helpers 에서 제공하는 runWithGlob 유틸을 활용해 src 폴더 내의 각 엔트리 파일을 자동으로 감지하여 빌드 엔트리로 등록합니다.
• 라이브러리 모드: Vite의 라이브러리 모드를 사용해 ES/CJS 포맷으로 각각 빌드합니다.
• 타입 선언: vite-plugin-dts로 각 엔트리별 타입 선언 파일을 자동 생성합니다.
• 경로 별칭: vite-tsconfig-paths로 TypeScript 경로 별칭을 지원합니다.

tsconfig.json

• 모듈 해석: "moduleResolution": "bundler"로 번들러 친화적인 모듈 해석을 사용합니다.
• 타입 지원: 최신 ECMAScript, Node.js, DOM 관련 타입을 지원하도록 설정되어 있습니다.
• 엄격 모드: 타입 검사 및 린트 관련 옵션이 엄격하게 적용되어 있습니다.
• 경로 별칭: tsconfig.json에서 정의된 경로 별칭을 사용하여 코드 가독성을 높입니다.