🌱️ Node Utils

{
  "private": false,
  "publishConfig": {
    "access": "public"
  },
}

📖 개요

node-utils 패키지는 Node.js 환경에서 사용할 수 있는 다양한 유틸리티 함수들을 제공하는 패키지예요.

🎯 주요 목표

Node.js 환경에서 동작하는 새 패키지를 추가하고 싶을 때, 이 패키지를 복사하여 개발의 시작점으로 삼을 수 있도록, 아래와 같은 목적들을 가지고 작성되었어요:

• os, fs, process 등 Node.js 환경에서 제공되는 API 들을 활용할 수 있도록 기본적인 빌드 설정
• 코드 스플리팅 및 트리 쉐이킹을 지원하기 위한 Vite 기반 빌드 설정
• TypeScript 선언 파일 제공을 위한 설정
• npm 공개 배포 시 필요한 각종 package.json 관련 설정

📦 제공 기능

• fs: 파일 시스템 관련 유틸리티 함수들을 제공해요.
• msw: API 목업을 위한 MSW 관련 유틸리티 함수들을 제공해요.
• misc: 기타 유용한 유틸리티 함수들을 제공해요.

🛠️ 빌드 방식 및 주요 설정

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

package.json

• exports: 각 기능별 엔트리(./fs, ./msw, ./misc)를 분리해 타입 선언(.d.ts), ES 모듈, CJS 모듈을 모두 제공합니다.
• publishConfig: "access": "public"으로 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 타입을 지원하도록 설정되어 있습니다.
• 엄격 모드: 타입 검사 및 린트 관련 옵션이 엄격하게 적용되어 있습니다.
• 경로 별칭: tsconfig.json에서 정의된 경로 별칭을 사용하여 코드 가독성을 높입니다.