[deploy] release v1.1.0

[maylh]

🛰️ 관련 이슈

• 없음

✨ 주요 변경 사항

2026.01.31 v1.1.0 배포

Summary by CodeRabbit

릴리스 노트

• 새로운 기능

  • 채팅 시스템 개선으로 더 통합된 사용자 경험 제공
  • 채팅 방의 참여자 수 실시간 추적 기능 추가

• 개선 사항

  • 플레이어 에러 처리 강화로 안정성 향상
  • 셔플 플레이리스트 API 엔드포인트 업데이트

• Chores

  • 버전 업데이트: 1.0.4 → 1.1.0
  • 내부 상태 관리 구조 개선

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

📝 Walkthrough

Walkthrough

버전을 1.0.4에서 1.1.0으로 업데이트하고, 채팅 제공자 컨텍스트, 재생 목록 API 타입 통일, 토큰 기반 채팅 인증, 플레이어 오류 처리, 그리고 여러 페이지 및 위젯 컴포넌트를 함께 리팩토링했습니다.

Changes

코호트 / 파일	요약
버전 업데이트 package.json	루트 레벨 버전을 1.0.4에서 1.1.0으로 변경.
채팅 제공자 인프라 src/app/providers/ChatProvider.tsx, src/app/providers/index.ts	새로운 ChatProvider, ChatContext, useChat 훅을 도입하여 소켓 상태를 중앙에서 관리.
채팅 API 및 타입 src/features/chat/api/chat.ts, src/features/chat/types/chat.ts, src/features/chat/model/sendMessage.ts	ChatMessage 타입 재구성, ListenerNumResponse 추가, 토큰 기반 STOMP 인증 도입, sendMessage 서명 단순화, getListenerCount API 추가.
재생 목록 타입 통일 src/entities/playlist/types/playlist.ts, src/entities/playlist/api/playlist.ts	PlaylistDetailResponse를 PlaylistDetail로 통합, PlaylistResponse.content를 PlaylistInfo[]에서 number[]로 변경, PlaylistParams 커서 타입 변경, getMyPlaylistDetail 추가.
재생 목록 훅 리팩토링 src/entities/playlist/model/usePlaylists.ts	useMyPlaylistDetail, usePlaylistDetails 추가, useShufflePlaylists 페이지네이션 타입을 Cursor에서 number로 변경, enabled 게이팅 추가.
플레이어 오류 처리 src/app/providers/PlayerProvider.tsx	handlePlayerError 콜백 추가, currentPlaylist 타입을 PlaylistInfo에서 PlaylistDetail로 변경.
제너릭 카로셀 컴포넌트 src/features/swipe/ui/SwipeCarousel.tsx	SwipeCarousel을 제너릭 컴포넌트로 변경하여 playlistId 속성이 있는 모든 타입 지원.
라이브 정보 컴포넌트 리팩토링 src/shared/ui/LiveInfo.tsx	useChat 훅 사용으로 props 기반 설계에서 전환, participantCount 자동 파생.
재생 목록 위젯 업데이트 src/widgets/playlist/...	PlaylistLayout과 PlaylistInfo를 PlaylistDetail 타입으로 업데이트, YoutubePlayer에 onError 속성 추가, currentPlaylist로 모든 렌더링 통합.
페이지 레벨 리팩토링 src/pages/discover/..., src/pages/mycd/..., src/pages/home/..., src/pages/mypage/...	ChatProvider 래핑, usePlaylistDetails로 데이터 페칭 통합, 플레이리스트 초기화 로직 단순화, LiveInfo 제거 및 컨텍스트 기반 접근.
채팅 위젯 업데이트 src/widgets/chat/ChatBottomSheet.tsx	useChatSocket(roomId)을 useChat()으로 변경, sendMessage 서명 단순화.
네비게이션 바 src/widgets/layout/NavBar.tsx	firstPlaylistId 추출 로직 변경으로 content 배열 항목 직접 사용.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Poem

🐰 채팅 제공자가 들어와서, 타입들이 정렬되고,
플레이어 오류는 이제 처리되고, 재생 목록은 통합되네!
제너릭 카로셀이 춤을 추고, 라이브 정보는 흐르듯이,
모든 페이지가 새로운 구조로 함께 움직여요. 🎵✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	PR 설명은 템플릿 구조를 따르지만 주요 변경 사항 섹션이 '2026.01.31 v1.1.0 배포'로만 기술되어 있어 실제 구현된 다양한 기능(ChatProvider, 타입 통일, API 변경 등)에 대한 구체적인 설명이 부족합니다.	주요 변경 사항 섹션에서 Chat 기능, 타입 통일, API 엔드포인트 변경 등 주요 구현 내용을 구체적으로 설명하고, 테스트 방법과 리뷰 포인트도 추가해주세요.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	PR 제목은 '[deploy] release v1.1.0'으로 package.json의 버전 업데이트(1.0.4 → 1.1.0)와 모든 주요 변경 사항을 반영한 배포 버전을 명확하게 나타냅니다.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch develop

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[gemini-code-assist]

Summary of Changes

Hello @maylh, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request marks the release of version 1.1.0, bringing significant improvements to the application's playlist and chat functionalities. It includes a comprehensive refactoring of playlist data structures and API calls, streamlining how playlist information is fetched and managed. A new ChatProvider has been introduced to centralize chat socket logic, making real-time chat features more robust and easier to integrate. Additionally, the YouTube player now includes error handling, improving playback reliability. These changes aim to enhance the overall stability, performance, and user experience of the application.

Highlights

• Version Update: The application version has been updated to "v1.1.0" in package.json, signifying a new release.
• Playlist Data Refactoring: Significant refactoring of playlist data types and API interactions has been implemented, standardizing "PlaylistDetail" across the application and simplifying "PlaylistResponse" to return playlist IDs for improved efficiency.
• Centralized Chat Management: A new "ChatProvider" and "useChat" hook have been introduced to centralize chat socket logic, making real-time chat features more robust and accessible throughout the application.
• YouTube Player Error Handling: The "YoutubePlayer" component now includes an "onError" prop and "handlePlayerError" callback in "PlayerProvider", which automatically advances to the next track upon encountering a playback error.
• Simplified Playlist Pagination: The pagination logic for shuffled playlists has been updated to use a simpler numerical "cursorId" instead of complex "cursorPosition" and "cursorCardId" parameters.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

v1.1.0 릴리즈를 위한 대규모 리팩토링 및 기능 추가 PR이네요. 고생 많으셨습니다! 전반적으로 플레이리스트 데이터 로딩 방식을 최적화하고, ChatProvider를 도입하여 채팅 관련 로직을 깔끔하게 분리한 점이 인상적입니다. 코드의 재사용성과 유지보수성이 크게 향상된 것 같습니다. 몇 가지 추가 개선점에 대한 의견을 아래 코멘트로 남겼으니 확인 부탁드립니다.

[coderabbitai]

Actionable comments posted: 5

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)

src/widgets/playlist/YoutubePlayer.tsx (1)

74-79: ⚠️ Potential issue | 🟡 Minor

onError가 useEffect 의존성 배열에 누락됨

onError 콜백이 플레이어 생성 시 사용되지만 의존성 배열에 포함되어 있지 않습니다. onError 콜백이 변경될 경우 새로운 콜백이 반영되지 않을 수 있습니다.

🔧 의존성 배열에 onError 추가 제안

-  }, [apiReady, videoId, isMobile, onReady, onStateChange, setIsMuted])
+  }, [apiReady, videoId, isMobile, onReady, onStateChange, onError, setIsMuted])

src/widgets/chat/ChatBottomSheet.tsx (1)

76-81: ⚠️ Potential issue | 🔴 Critical

sendMessage 호출의 에러 처리 로직이 작동하지 않음

useChatSocket의 sendMessage는 Promise를 반환하지 않는 동기 함수입니다(void 반환). 따라서 await를 사용해도 아무 효과가 없으며, 낙관적 업데이트 롤백을 위한 try-catch 블록도 작동하지 않습니다.

추가로 sendMessage는 연결이 끊겼거나 내용이 비어있을 때 에러를 던지지 않고 조용히 반환하므로, 실제로 메시지 전송이 실패해도 catch 블록이 실행되지 않습니다. 낙관적으로 증가시킨 chat-count가 원래대로 롤백되지 않는 문제가 발생합니다.

개선안:

• sendMessage를 비동기 함수로 변경하여 실제 전송 결과(성공/실패)를 Promise로 반환하거나
• sendMessage 호출 전에 connected 상태를 먼저 검증한 후 proceed하거나
• Promise 기반 메시지 전송 API 사용 검토

🤖 Fix all issues with AI agents

In `@src/features/chat/model/sendMessage.ts`:
- Line 41: Replace the inline debug logger that currently uses console.log in
the sendMessage.ts STOMP client config (the debug: (str) =>
console.log('[STOMP]', str) entry) with a call to console.warn or a
conditional/no-op logger for production; update the debug function to use
console.warn('[STOMP]', str) or gate logging by an environment flag so static
analysis rules are satisfied and production logging can be disabled.

In `@src/pages/discover/index.tsx`:
- Around line 36-49: The bug is that urlPlaylistId is stored in urlIdRef
(useRef) so route changes don't update startId, and shufflePlaylistIds is
re-created every render causing unnecessary useMemo invalidation; fix by
memoizing shufflePlaylistIds from data using useMemo (e.g., compute
shufflePlaylistIds = useMemo(() => data?.pages.flatMap(p => p.content) ?? [],
[data])), remove urlIdRef and compute startId inside the finalPlaylistIds
useMemo from Number(urlPlaylistId) (guarding against NaN), and make
finalPlaylistIds useMemo depend on [urlPlaylistId, shufflePlaylistIds] to return
either shufflePlaylistIds or [startId, ...filtered].

In `@src/shared/ui/LiveInfo.tsx`:
- Around line 6-14: The Storybook story still uses the old props interface
(isOnAir, listenerCount) but LiveInfo now reads participantCount from useChat
and must be rendered inside ChatProvider; update the LiveInfo story
(LiveInfo.stories.tsx) to wrap LiveInfo with ChatProvider or mock the useChat
context so participantCount is provided, and remove/replace the prop-based
knobs/examples with a context-based variant (or a decorator that injects
participantCount) so the story reflects the current LiveInfo implementation and
shows ON AIR when participantCount > 0.

In `@src/widgets/playlist/PlaylistInfo.tsx`:
- Line 10: Imported UI "Error" component in PlaylistInfo.tsx conflicts with the
global Error type; alias the import (e.g., import { Error as UiError, Header,
Link, Loading, SvgButton } from '@/shared/ui') and then rename all usages of the
component inside the PlaylistInfo React component (replace Error → UiError) so
the global Error type is not shadowed and TypeScript/Biome linting errors are
resolved.

In `@src/widgets/playlist/PlaylistLayout.tsx`:
- Around line 80-86: 현재 코드가 currentPlaylist가 없을 때 playlistId에 0을 넘기고 있어 로딩 중 클릭
시 잘못된 요청이 발생할 수 있습니다; ActionBarContainer/ActionBar를 렌더링하기 전에 currentPlaylist
존재여부로 가드하거나 ActionBar에 playlistId를 optional로 전달하도록 변경하세요 (즉, PlaylistLayout에서
currentPlaylist가 falsy면 ActionBarContainer/ActionBar를 생략하거나 disabled 상태로 렌더링하고,
ActionBar 컴포넌트는 playlistId?: number 형태를 받아 null/undefined를 안전하게 처리하도록 수정).
Ensure you reference the ActionBarContainer/ActionBar render block and the props
playlistId, creatorId, stickers, and type when applying the guard.

🧹 Nitpick comments (5)

src/entities/playlist/api/playlist.ts (1)

44-46: getTracklist와 동일 경로라면 재사용으로 중복 제거 고려 가능.
유지보수 목적의 선택 사항입니다.

♻️ 간단한 중복 제거 예시

-export const getMyPlaylistDetail = (cdId: number) => {
-  return api.get<PlaylistDetail>(`/main/playlist/mypage/me/${cdId}`)
-}
+export const getMyPlaylistDetail = getTracklist

src/app/providers/ChatProvider.tsx (1)

10-22: Context와 Hook을 별도 파일로 분리하여 Fast Refresh 최적화를 고려하세요.

프로젝트의 react-refresh/only-export-components ESLint 규칙에 따르면, 컴포넌트 파일은 React 컴포넌트만 export해야 합니다. 현재 ChatProvider.tsx에서 ChatContext, ChatProvider, useChat을 함께 export하는 패턴은 Fast Refresh 경고를 발생시킵니다.

권장 구조:

• chat.context.ts: ChatContext export
• use-chat.ts: useChat hook export
• ChatProvider.tsx: ChatProvider 컴포넌트만 export

src/app/providers/PlayerProvider.tsx (1)

81-89: nextTrack 의존성 배열에 불필요한 isMuted 포함

nextTrack 콜백의 의존성 배열에 isMuted가 포함되어 있지만, 함수 본문에서 사용되지 않습니다. 이는 불필요한 리렌더링을 유발할 수 있습니다.

🔧 의존성 배열에서 isMuted 제거 제안

   const nextTrack = useCallback(() => {
     if (currentPlaylist && currentTrackIndex < currentPlaylist.songs.length - 1) {
       setCurrentTrackIndex((prev) => prev + 1)
       setCurrentTime(0)
       if (playerRef.current) {
         playerRef.current.seekTo(0, true)
       }
     }
-  }, [currentPlaylist, currentTrackIndex, isMuted])
+  }, [currentPlaylist, currentTrackIndex])

src/pages/mycd/index.tsx (1)

131-137: useEffect 의존성 배열에 isMobile 누락

isMobile 값이 setPlaylist 호출 시 사용되지만 의존성 배열에 포함되어 있지 않습니다. 디바이스 타입이 변경될 경우 자동 재생 설정이 올바르게 적용되지 않을 수 있습니다.

🔧 의존성 배열에 isMobile 추가

   useEffect(() => {
     if (playlistDetail && userInfo) {
       if (currentPlaylist?.playlistId === playlistDetail.playlistId) return

       setPlaylist(playlistDetail, 0, 0, !isMobile) // 모바일이면 자동재생 off
     }
-  }, [playlistDetail, userInfo, setPlaylist, currentPlaylist])
+  }, [playlistDetail, userInfo, setPlaylist, currentPlaylist, isMobile])

src/pages/home/ui/FirstSection.tsx (1)

8-28: RandomCdData를 camelCase로 정리하세요.
변수/훅 결과는 camelCase가 컨벤션입니다. RandomCdData → randomCdData로 변경하고 사용처도 함께 수정해주세요.

🔧 제안 수정

-  const { data: RandomCdData } = usePlaylistDetails(playlistIds)
+  const { data: randomCdData } = usePlaylistDetails(playlistIds)

-          <HomeCarousel
-            data={isLogin ? (MyCdData ?? RandomCdData) : RandomCdData}
-            isLogin={isLogin}
-          />
+          <HomeCarousel
+            data={isLogin ? (MyCdData ?? randomCdData) : randomCdData}
+            isLogin={isLogin}
+          />

As per coding guidelines: '유틸리티/훅/변수: camelCase (예: getUserData, useUserInfo)'.