CHANGELOG.md

Changelog

v1.0.1 - 2024-12-25

개선사항

타입 시스템 완전 재작성 ✨

• OpenAPI 3.0 스펙 완벽 준수: 모든 타입 정의를 OpenAPI 3.0 공식 스펙에 맞춰 재작성
• unknown 타입 제거: 더 구체적인 타입으로 대체
  • JSONValue 타입 도입 (string | number | boolean | null | JSONObject | JSONArray)
  • ExampleValue = JSONValue로 명확한 타입 정의
• 완전한 타입 정의:
  • SchemaObject: JSON Schema 전체 프로퍼티 지원
  • ParameterObject: style, explode 등 모든 OpenAPI 프로퍼티
  • ResponseObject: headers, links 등 완전한 정의
  • ReferenceObject: $ref 처리
  • ComponentsObject: 재사용 가능한 모든 컴포넌트
  • SecuritySchemeObject: 모든 인증 방식 (apiKey, http, oauth2, openIdConnect)
  • MediaTypeObject, EncodingObject, LinkObject, CallbackObject 등 추가
• Type Guards 추가:
  • isReferenceObject(), isSchemaObject(), isParameterObject() 등
  • 안전한 타입 체크 및 타입 narrowing

ESM 모듈 시스템 마이그레이션

• package.json에 "type": "module" 추가
• tsconfig.json 설정 업데이트:
  • module: "ESNext"
  • moduleResolution: "bundler"
• 모든 import 문에 .js 확장자 추가 (ESM 규격 준수)
• top-level await 문제 해결

패키지 관리자 변경

• npm → pnpm 전환
• .npmrc 파일 추가 (shamefully-hoist 설정)
• 모든 문서에서 npm 명령어를 pnpm으로 업데이트

의존성 업데이트

• Ink: v4.4.1 → v6.6.0
• React: v18.2.0 → v19.2.3
• Node.js 요구사항: >=18.0.0 → >=22.0.0
• 모든 devDependencies 최신 버전으로 업데이트

버그 수정

• ParameterObject | ReferenceObject 유니온 타입 처리 개선
• openapi-parser 서비스에서 ReferenceObject 필터링 추가
• validator에서 ReferenceObject 체크 추가
• ParameterForm에서 example 값 렌더링 타입 안정성 개선

기술 부채 해결

• TypeScript strict 모드 준비 (현재는 false로 설정하여 점진적 마이그레이션)
• 타입 안정성 대폭 향상
• OpenAPI 스펙 완벽 준수로 향후 기능 확장 용이

---

v1.0.0 - 2024-12-25

초기 릴리스 🎉

주요 기능

• Swagger 2.0 & OpenAPI 3.x 문서 파싱 지원
• Vim 스타일 키보드 네비게이션 (h, j, k, l)
• 3가지 화면 구성:
  • 목록 화면 (List View)
  • 상세 화면 (Detail View)
  • 결과 화면 (Result View)
• HTTP 메서드별 필터링
• API 요청 실행 및 응답 표시
• 클립보드 복사 기능

기술 스택

• React 18.2.0
• Ink 4.4.1 (Terminal UI)
• TypeScript 5.3.3
• Jest (테스트)
• axios (HTTP 클라이언트)
• swagger-parser (OpenAPI 파서)

디자인

• 네온 그린 테마 (#13ec13)
• 터미널 친화적 UI
• Space Grotesk & JetBrains Mono 폰트