ADR-0019: Supabase 채팅 공용 로직을 @howmuchhome-web/chat-core 패키지로 둔다
- Status: Accepted
- Date: 2026-10-08
- 관련: HMH-9801 (WS3-a) · 상위 HMH-9772 (WS3) · 에픽 HMH-9765 · 데이터모델 ADR-0018 · Sendbird 탈출
Context
Sendbird→Supabase 채팅 이관(에픽 HMH-9765)에서 클라이언트 채팅 로직이 이원화돼 있다.
- DM:
apps/native-app/src/features/dm/*— 이미 Supabase 네이티브 구현(토큰 콜백·postgres_changes재구독·react-query). 단, native 앱 안에만 있다. - 그룹:
@howmuchhome-web/chat(Sendbird SDK 래핑) +@howmuchhome-web/chat-react(UI) — 공용 패키지이고 web(apps/app)·dashboard(apps/dashboard)·native 세 앱이 공유한다(각 앱 커뮤니티 채팅 수십 파일이 import).
WS3는 이 둘을 하나의 Supabase 채팅 레이어로 통합한다([ADR-0018] 통합 모델 channel/channel_member/message). 그런데 그룹 채팅은 지금도 web·dashboard가 Sendbird 패키지를 통해 쓰므로, Sendbird를 대체할 Supabase 구현도 세 앱이 공유하는 공용 패키지여야 한다. native 앱 안(features/)에만 두면 web·dashboard가 재사용할 수 없다.
제약: 공용 패키지는 RN·Next 양쪽에서 안전해야 한다(native·web·dashboard 공용). 그런데 연결 수명주기에는 플랫폼 전용 API가 섞인다 — native는 AppState(포그라운드 복귀 재구독), web은 visibilitychange. 그리고 Supabase 클라이언트 생성에 필요한 env(URL/ANON_KEY)·커스텀 JWT 발급 경로도 앱마다 다르다.
검토한 대안
| 대안 | 채택 안 한 이유 |
|---|---|
A. native features/chat/ 에만 공용 모듈로 승격 | web·dashboard가 재사용 불가 — 그룹 채팅은 이 세 앱이 모두 쓰는데 native-only 위치는 이원화를 그대로 둔다 |
B. 기존 @howmuchhome-web/chat(Sendbird) 패키지를 Supabase로 개조 | 전환기 동안 Sendbird 구현과 Supabase 구현이 공존해야 하는데 같은 패키지명이면 동거 불가. Sendbird 제거(WS3-d) 전까지 web·dashboard는 기존 패키지를 계속 써야 한다 |
C. 신규 패키지 @howmuchhome-web/chat-core (채택) | 전환기 동안 Sendbird 패키지와 공존 가능, 세 앱이 동일 구현 공유 |
Decision
플랫폼 중립 채팅 코어를 신규 공용 패키지 @howmuchhome-web/chat-core에 둔다. 플랫폼·env 전용 글루는 패키지 밖(각 앱)에 남기고 주입한다.
패키지(packages/chat-core/, 플랫폼 중립 — react + @supabase/supabase-js 타입만 의존):
types.ts— 통합 모델 행 타입(ChannelRow,ChannelMessageRow).channels.ts— 데이터 액세스(listMyChannels/getChannel/listChannelMessages/sendChannelMessage). 모든 함수는 호출자가 만든SupabaseClient를 받는다(클라이언트 생성·토큰은 앱 글루 담당).mergeMessages.ts—mergeMessagesById(fetch 스냅샷과 realtime 선행 수신 병합).useRealtimeChannel.ts— 유니크 채널명·postgres_changes구독·지수 백오프 재구독·cleanup 을 캡슐화한 훅. 리스너 등록은attach콜백으로 호출자가 주입(DM 의 read-receipt 채널 등 채널별 차이 수용).
앱 글루(패키지 밖에 남김):
- Supabase 클라이언트 생성 + 커스텀 JWT 토큰 수명주기 + 플랫폼 전용 재구독 트리거(native
AppState/ webvisibilitychange). native 현재 위치:apps/native-app/src/features/dm/의supabaseClient.ts·useCommunityV2Supabase.ts.
첫 소비자: native 그룹 슬라이스(features/chat/ChatSlice*Screen.tsx)가 @howmuchhome-web/chat-core를 import 해 검증. web·dashboard 는 Sendbird 탈출 시점(WS3-d 이후)에 채택. native DM(cv2_dm_*)은 WS6 통합모델 이관 때 합류.
Consequences
좋아지는 것
- 그룹 채팅 Supabase 로직을 세 앱(native·web·dashboard)이 단일 구현으로 공유 — Sendbird
@howmuchhome-web/chat가 하던 역할을 그대로 승계. - 데이터 액세스·realtime·병합이
SupabaseClient주입식이라 플랫폼·테스트 중립.
감수하는 것
- 연결 수명주기(토큰·
AppState/visibilitychange·env)는 앱별 글루로 중복된다(패키지가 흡수하지 않음). 플랫폼 API가 갈리므로 의도한 경계다. - 전환기 동안
@howmuchhome-web/chat(Sendbird)와@howmuchhome-web/chat-core(Supabase)가 공존 — 두 채팅 스택이 잠시 같이 산다.
이 결정을 다시 열어야 할 때
- 연결 글루(토큰·재구독)를
.native/.web분리로 패키지가 흡수하는 게 중복보다 이득이 커지면(소비처가 늘어 글루 중복이 부담되면) 경계를 패키지 쪽으로 옮긴다. - Sendbird 완전 제거(WS7) 후
chat-core가 유일 채팅 패키지가 되면, 이름을chat으로 되돌릴지(단순화) vs 유지(rename churn 회피)를 재검토.