Skip to Content
DecisionsADR-0019: Supabase 채팅 공용 로직을 @howmuchhome-web/chat-core 패키지로 둔다

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 / web visibilitychange). 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 회피)를 재검토.
Last updated on