개발하는 엄무키

개요 회사에서 진행하는 프로젝트의 궁극적인 목표가 SDK로 정해졌고 개발을 하면서 항상 라이브러리를 꼭 한 번 만들어서 배포하고 싶은 꿈을 가지고 있었는데 이번 기회에 npm에 라이브러리를 등록해보면서 시야를 넓혀보려고 한다. Semantic Versioning npm에 등록되어 있는 라이브러리를 보면 아래의 예시처럼 버전 번호가 붙는데 이건 전 세계 개발자들이 합의한 규칙 이다. 이걸 Semantic Versioning 이라고 부른다. 이 규칙을 지키면 사용자는 버전 번호만 보고도 "이거 업데이트해도 내 코드 안 깨지겠네" 또는 "이건 조심해야겠다"를 판단할 수 있다. PATCH (1.0.0 → 1.0.1) "고쳤어요, 쓰던 대로 쓰면 됩니다" 버그 수정 내부 로직 개선 성능 최적화 기존 API 변경 없음 이 버전 업데이트는 사용자 입장에서는 아무것도 안 바꿔도 된다. 그냥 업데이트하면 버그가 고쳐진다. MINOR (1.0.0 → 1.1.0) "새 기능 추가했어요, 기존 거 그대로 써도 됩니다" 새로운 함수/컴포넌트 추가 기존 함수에 선택적 파라미터 추가 하위 호환성 유지

들어가며 : 왜 Stack Auth인가? 인증 시스템을 직접 구현하는 것은 MVP 개발에서 가장 큰 시간 낭비 중 하나다. 비밀번호 해싱, OAuth 플로우, 세션 관리, 토큰 리프레시... 이 모든 것을 직접 제대로 구현하려면 최소 2-3주는 필요하다. ( 물론 깊이있는 이해와 보안적인 이슈를 생각하면 정말 제대로 구현하는게 맞지만 ) 이번 포스팅은 MVP 개발 프로젝트에 맞춰서 정리하고 stack auth 기반의 시스템을 이해하며 앞으로 더욱 유연한 기능 사용을 위한 시작점으로 정리하려고한다. Stack Auth를 선택한다면 가질 수 있는 이점: 오픈소스 셀프호스팅 가능 빠르게 설정 가능 Teams, RBAC, Permissions 기본 제공 Next.js App router 완벽 지원 ( but pages router 지원 X ) 1. Stack Auth 핵심 기능 1.1 인증 방식 (Authentication Methods) Stack Auth가 지원하는 인증 방식: 📧 Email/Password - 기본 인증 🔗 Magic Link - 비밀번호 없는 이메일 인증 🌐 OAuth Providers - Google, GitHub, Facebook 등 📱 OTP - 이메일/SMS 일회용 비밀번호 🔑 Passkeys - WebAuthn 기반 생체인증 🏢 SAML SSO - 엔터프라이즈 SSO 1.2 사용자 관리 (User Management) 1.3 Teams & Organizations (B2B 필수)