@vibexnpm/talkx 2.3.1

package/src/constants.js

@@ -0,0 +1,411 @@
+/**
+ * TalkFlow SDK Constants
+ * 클라이언트 상태, 에러 타입, 시그널 타입 등 상수 정의
+ */
+
+/**
+ * 클라이언트 연결 상태
+ */
+export const ConnectionState = {
+    DISCONNECTED: 'disconnected',
+    CONNECTING: 'connecting',
+    CONNECTED: 'connected',
+    RECONNECTING: 'reconnecting',
+    ERROR: 'error'
+};
+
+/**
+ * 에러 타입
+ */
+export const ErrorTypes = {
+    // Connection errors
+    CONNECTION_FAILED: 'CONNECTION_FAILED',
+    CONNECTION_LOST: 'CONNECTION_LOST',
+    CONNECTION_TIMEOUT: 'CONNECTION_TIMEOUT',
+
+    // Authentication errors
+    JWT_INVALID: 'JWT_INVALID',
+    JWT_EXPIRED: 'JWT_EXPIRED',
+    JWT_PARSE_FAILED: 'JWT_PARSE_FAILED',
+    UNAUTHORIZED: 'UNAUTHORIZED',
+
+    // API errors
+    API_ERROR: 'API_ERROR',
+    API_TIMEOUT: 'API_TIMEOUT',
+
+    // Chat errors
+    CHAT_ROOM_NOT_FOUND: 'CHAT_ROOM_NOT_FOUND',
+    CHAT_MESSAGE_FAILED: 'CHAT_MESSAGE_FAILED',
+    CHAT_SUBSCRIPTION_FAILED: 'CHAT_SUBSCRIPTION_FAILED',
+
+    // WebRTC errors
+    MEDIA_ACCESS_DENIED: 'MEDIA_ACCESS_DENIED',
+    SCREEN_SHARE_DENIED: 'SCREEN_SHARE_DENIED',
+    PEER_CONNECTION_FAILED: 'PEER_CONNECTION_FAILED',
+    ICE_CONNECTION_FAILED: 'ICE_CONNECTION_FAILED',
+    SIGNALING_FAILED: 'SIGNALING_FAILED',
+    DEVICE_SWITCH_FAILED: 'DEVICE_SWITCH_FAILED',
+    ENUMERATE_DEVICES_FAILED: 'ENUMERATE_DEVICES_FAILED',
+    CALL_ROOM_NOT_FOUND: 'CALL_ROOM_NOT_FOUND',
+
+    // General errors
+    INVALID_STATE: 'INVALID_STATE',
+    UNKNOWN_ERROR: 'UNKNOWN_ERROR'
+};
+
+/**
+ * WebRTC 시그널 타입 (서버 WebRTCMessageType과 일치)
+ */
+export const SignalTypes = {
+    // Offer/Answer (WebRTC SDP)
+    CALL_OFFER: 'call_offer',
+    CALL_ANSWER: 'call_answer',
+
+    // ICE
+    ICE_CANDIDATE: 'ice_candidate',
+
+    // Room events
+    JOIN_ROOM: 'join_room',
+    LEAVE_ROOM: 'leave_room',
+    PEER_JOINED: 'peer_joined',
+    PEER_LEFT: 'peer_left',
+
+    // Media state
+    VIDEO_STATE_CHANGED: 'video_state_changed',
+    AUDIO_STATE_CHANGED: 'audio_state_changed',
+    SCREEN_SHARE_STARTED: 'screen_share_started',
+    SCREEN_SHARE_ENDED: 'screen_share_ended',
+
+    // Call events (UI 레벨)
+    CALL_REQUEST: 'call_request',
+    CALL_ACCEPT: 'call_accept',
+    CALL_REJECT: 'call_reject',
+    CALL_CANCEL: 'call_cancel',
+    CALL_END: 'call_end',
+    CALL_INVITATION: 'call_invitation',
+    CALL_BUSY: 'call_busy'
+};
+
+/**
+ * 채팅 메시지 타입
+ */
+export const ChatMessageType = {
+    TEXT: 'TEXT',
+    IMAGE: 'IMAGE',
+    FILE: 'FILE',
+    VIDEO: 'VIDEO',
+    AUDIO: 'AUDIO',
+    SYSTEM: 'SYSTEM'
+};
+
+/**
+ * 메시지 발신자 타입 — 서버 {@code SenderType} 과 일치.
+ *
+ * <ul>
+ *   <li>{@code USER} — 사람 사용자가 보낸 메시지 (기존 모든 메시지의 default)</li>
+ *   <li>{@code ASSISTANT} — AI 어시스턴트 페르소나가 생성한 메시지. {@code userId} 자리는 페르소나 ID</li>
+ * </ul>
+ *
+ * <p>서버 응답에서 {@code senderType} 필드가 없으면 {@code USER} 로 간주 (기존 데이터 graceful).</p>
+ */
+export const SenderType = {
+    USER: 'USER',
+    ASSISTANT: 'ASSISTANT'
+};
+
+/**
+ * 어시스턴트 페르소나 분류 — 서버 {@code PersonaRole} enum 과 일치 (14개).
+ *
+ * <p>{@code PM} 은 PM_BACKSTAGE 방의 단일 PM Front 전용 — 기존 14인 PERSONA_MULTI 라인업과 별개 구성이며
+ * {@code PROJECT_MANAGEMENT}(PM 비서)와도 다르다.</p>
+ */
+export const PersonaRole = {
+    LEGAL_ADVISOR: 'LEGAL_ADVISOR',
+    MARKETING: 'MARKETING',
+    PRODUCT_PLANNING: 'PRODUCT_PLANNING',
+    HR: 'HR',
+    FINANCE: 'FINANCE',
+    CUSTOMER_SUPPORT: 'CUSTOMER_SUPPORT',
+    SALES: 'SALES',
+    ENGINEERING: 'ENGINEERING',
+    DATA_ANALYST: 'DATA_ANALYST',
+    PROJECT_MANAGEMENT: 'PROJECT_MANAGEMENT',
+    RESEARCH: 'RESEARCH',
+    TRANSLATION: 'TRANSLATION',
+    DESIGN: 'DESIGN',
+    // PM_BACKSTAGE 전용 — PM Front 단일 응답 (PERSONA_MULTI 14인과 별개)
+    PM: 'PM'
+};
+
+/**
+ * 채팅 요약 포맷 — 서버 {@code SummarizeFormat} enum 과 일치 (5개).
+ *
+ * <p>{@link ChatClient#summarizeWithAssistant} 의 {@code format} 인자.
+ * 서버가 대소문자 무관하게 매핑하며, 미지정/알 수 없는 값이면 {@code SHORT} 로 처리.</p>
+ *
+ * <ul>
+ *   <li>{@code MINUTES} — 회의록 (참석/안건/핵심 논의/결정사항)</li>
+ *   <li>{@code SHORT} — 짧은 요약 (몇 문장 핵심). 기본값.</li>
+ *   <li>{@code TIMELINE} — 시간순 타임라인</li>
+ *   <li>{@code ACTIONS} — 액션 아이템 (task/owner/기한)</li>
+ *   <li>{@code OPTIONS} — 옵션 비교 (논의된 선택지별 장단점)</li>
+ * </ul>
+ */
+export const SummarizeFormat = {
+    MINUTES: 'MINUTES',
+    SHORT: 'SHORT',
+    TIMELINE: 'TIMELINE',
+    ACTIONS: 'ACTIONS',
+    OPTIONS: 'OPTIONS'
+};
+
+
+/**
+ * 채팅방 타입 (서버 {@code ChatRoomType} enum 과 일치).
+ *
+ * <ul>
+ *   <li>{@code DIRECT} — 1:1 채팅방</li>
+ *   <li>{@code GROUP} — 공개 그룹 채팅방</li>
+ *   <li>{@code PRIVATE_GROUP} — 비밀 그룹 채팅방 (입장 시 비밀번호 필요)</li>
+ *   <li>{@code TEAM} — 팀 채팅방 (초대 전용 — 직접 입장 불가, 멤버는 입장 시점과 무관하게
+ *       방 전체 히스토리 열람. 비참여자에게는 탐색/전체 목록에서도 숨김. 비밀번호 없음)</li>
+ * </ul>
+ */
+export const ChatRoomType = {
+    DIRECT: 'DIRECT',
+    GROUP: 'GROUP',
+    PRIVATE_GROUP: 'PRIVATE_GROUP',
+    TEAM: 'TEAM'
+};
+
+/**
+ * 어시스턴트 참여 모드 (서버 {@code AssistantMode} enum 과 일치).
+ *
+ * <ul>
+ *   <li>{@code GENERAL}: 자동 라우팅 + @mention 모두 활성</li>
+ *   <li>{@code PEOPLE_ONLY}: AI 응답 전면 차단</li>
+ *   <li>{@code CALL_ONLY}: @mention / 명시 호출 시만 응답</li>
+ * </ul>
+ */
+export const AssistantMode = {
+    GENERAL: 'GENERAL',
+    PEOPLE_ONLY: 'PEOPLE_ONLY',
+    CALL_ONLY: 'CALL_ONLY'
+};
+
+/**
+ * 방의 AI 사용 방식 (상위 SSOT) — 서버 {@code RoomAiType} enum 과 일치.
+ *
+ * <p>{@link ChatClient#createGroupRoom} 의 {@code roomAiType} 으로 방 생성 시 의도를 명시한다.
+ * 미지정 시 서버가 API 키 권한(capability) + 첨부 페르소나로 파생한다 (레거시 호환).
+ * <b>단, PERSONA_MULTI 권한이 없는 PM 전용 키는 미지정 시 {@code NONE}(사람 방)으로 파생되므로</b>
+ * {@link ChatClient#getRoomAiMeta} 로 확인 후 고른 타입을 명시 전송할 것.</p>
+ *
+ * <ul>
+ *   <li>{@code NONE}: AI 미사용 (순수 사람 채팅). {@code invitedAssistantPersonaIds}/{@code assistantMode} 동시 지정 불가.</li>
+ *   <li>{@code PERSONA_MULTI}: 다중 페르소나, LLM 이 판단해 호출. {@code assistantMode} 로 세부 제어. (현재 유일 활성)</li>
+ *   <li>{@code PM_BACKSTAGE}: PM + 백스테이지. PM 단일 응답 구현됨 — {@code engagementIntensity} 로 개입 강도 제어. 백스테이지 위임은 후속.</li>
+ * </ul>
+ */
+export const RoomAiType = {
+    NONE: 'NONE',
+    PERSONA_MULTI: 'PERSONA_MULTI',
+    PM_BACKSTAGE: 'PM_BACKSTAGE'
+};
+
+/**
+ * PM_BACKSTAGE 방의 PM 개입 강도 (서버 {@code EngagementIntensity} enum 과 일치).
+ *
+ * <p>{@link ChatClient#createGroupRoom} / {@code updateGroupRoom} 의 {@code engagementIntensity}.
+ * <b>PM_BACKSTAGE 방 전용</b> — 그 외 방 타입에 지정 시 서버가 거절한다. 14인 PERSONA_MULTI 는
+ * 쿨다운 + Planner 자동 판단이라 무관하며, 이 값은 PM 단일 응답의 개입 빈도만 제어한다.</p>
+ *
+ * <ul>
+ *   <li>{@code QUIET}: 보수적 — 명확한 질문/도움 요청에만 PM 응답</li>
+ *   <li>{@code NORMAL}: 기본 — 업무 신호에 응답, 잡담엔 침묵</li>
+ *   <li>{@code ACTIVE}: 적극 — 가벼운 신호에도 응답</li>
+ * </ul>
+ */
+export const EngagementIntensity = {
+    QUIET: 'QUIET',
+    NORMAL: 'NORMAL',
+    ACTIVE: 'ACTIVE'
+};
+
+/**
+ * PM 프롬프트 레이어 차원 — 서버 {@code PmPromptLayerScope} enum 과 일치.
+ *
+ * <p>전역 PM 프롬프트 위에 합성되는 추가 지시문 2종. 합성 순서: 전역 → PROJECT → ROOM.
+ * SDK 가 다루는 것은 ROOM(방 레이어 — {@link ChatClient#getRoomPmPrompt} 등)이며,
+ * PROJECT(회사 레이어)는 어드민 콘솔 영역이다.</p>
+ */
+export const PmPromptLayerScope = {
+    /** 회사(프로젝트) 레이어 — 어드민 콘솔(PROJECT_ADMIN) 관리. */
+    PROJECT: 'PROJECT',
+    /** 방 레이어 — 방 주인(OWNER) 관리. PM_BACKSTAGE 방 전용. */
+    ROOM: 'ROOM'
+};
+
+/**
+ * PM 프롬프트 레이어 수정 주체 (감사 추적) — 서버 {@code PmPromptLayerEditorType} enum 과 일치.
+ */
+export const PmPromptLayerEditorType = {
+    /** 플랫폼 운영자 (대리 수정). */
+    SUPER_ADMIN: 'SUPER_ADMIN',
+    /** 회사 관리자 — PROJECT 레이어. */
+    PROJECT_ADMIN: 'PROJECT_ADMIN',
+    /** 방 주인(OWNER) — ROOM 레이어. */
+    ROOM_OWNER: 'ROOM_OWNER'
+};
+
+/**
+ * 채팅방 리스트 실시간 업데이트 이벤트 타입 (카톡 스타일).
+ *
+ * 서버 RoomListEventType enum 과 일치해야 함.
+ *
+ * @example
+ * client.on('roomListUpdate', (event) => {
+ *   switch (event.eventType) {
+ *     case RoomListEventType.MESSAGE_RECEIVED:
+ *       // 해당 방을 최상단으로, unread +1 (본인 메시지는 제외)
+ *       break;
+ *     case RoomListEventType.ROOM_LEFT:
+ *       // actorId === currentUserId 이면 리스트에서 제거
+ *       break;
+ *   }
+ * });
+ */
+export const RoomListEventType = {
+    /** 새 메시지 수신 → 리스트 최상단 이동, unread 카운트 +1 (본인 메시지 제외). */
+    MESSAGE_RECEIVED: 'MESSAGE_RECEIVED',
+    /** 현재 lastMessage 삭제 → 리스트 preview 갱신, unread 카운트 변경 없음. */
+    MESSAGE_DELETED: 'MESSAGE_DELETED',
+    /** 현재 lastMessage 편집 → 리스트 preview 새 content 로 갱신, unread 카운트 변경 없음. */
+    MESSAGE_UPDATED: 'MESSAGE_UPDATED',
+    /** 방 생성 (Direct/Group) → 참가자 리스트에 신규 item 추가. */
+    ROOM_CREATED: 'ROOM_CREATED',
+    /** 기존 방에 누군가 입장 → 참가자 수 갱신. */
+    ROOM_JOINED: 'ROOM_JOINED',
+    /** 방 퇴장 → 나간 본인 리스트에서는 제거, 남은 참가자는 참가자 수 감소. */
+    ROOM_LEFT: 'ROOM_LEFT',
+    /** 방 정보 변경 (이름, 설명 등). 미래 확장용. */
+    ROOM_UPDATED: 'ROOM_UPDATED',
+    /**
+     * 방장에 의한 단순 추방 → 대상은 리스트에서 방 제거, 남은 참가자는 참가자 수 감소.
+     * 재입장 가능 (ban 아님). actorId 는 추방한 방장, members 에 추방된 사용자 정보.
+     */
+    ROOM_KICKED: 'ROOM_KICKED',
+    /** 방장에 의한 추방 + 영구 차단 → payload 는 ROOM_KICKED 와 동일, 재입장 거부됨. */
+    ROOM_BANNED: 'ROOM_BANNED',
+    /** 메시지 보관 기간 정리 → cutoffTime 이전 메시지를 UI에서 제거. */
+    MESSAGE_RETENTION_CLEANUP: 'MESSAGE_RETENTION_CLEANUP'
+};
+
+/**
+ * WebSocket 경로
+ */
+export const WebSocketPaths = {
+    // Endpoints
+    SOCKJS_ENDPOINT: '/ws-chat',
+    NATIVE_ENDPOINT: '/ws-chat-native',
+
+    // Prefixes
+    APP_PREFIX: '/app',
+    TOPIC_PREFIX: '/topic',
+    QUEUE_PREFIX: '/queue',
+    USER_PREFIX: '/user',
+
+    // Chat destinations
+    getChatDestination: (roomId) => `/topic/chat/${roomId}`,
+    getChatReadDestination: (roomId) => `/topic/chat/${roomId}/read`,
+    getChatTypingDestination: (roomId) => `/topic/chat/${roomId}/typing`,
+
+    // Room list (카톡 스타일 리스트 실시간 업데이트)
+    // 서버가 convertAndSendToUser(userId, "/queue/rooms", event) 로 전송
+    // 클라이언트는 "/user/queue/rooms" 구독 (Spring STOMP 가 세션별 자동 격리)
+    ROOM_LIST_USER_DESTINATION: '/user/queue/rooms',
+
+    // WebRTC destinations
+    getWebRTCDestination: (roomId) => `/topic/webrtc/${roomId}`,
+    getWebRTCUserDestination: () => `/user/queue/webrtc`,
+
+    // Send destinations
+    CHAT_SEND: '/app/chat/send',
+    CHAT_READ: '/app/chat/read',
+    CHAT_TYPING: '/app/chat/typing',
+    WEBRTC_SIGNAL: '/app/webrtc/signal'
+};
+
+/**
+ * 환경 타입
+ */
+export const Environment = {
+    DEVELOPMENT: 'development',
+    STAGING: 'staging',
+    PRODUCTION: 'production'
+};
+
+/**
+ * 환경별 서버 설정
+ */
+export const Endpoints = {
+    [Environment.DEVELOPMENT]: {
+        serverUrl: 'https://dev-chat.apiorbit.net',
+        wsEndpoint: '/ws-chat'
+    },
+    [Environment.STAGING]: {
+        serverUrl: 'https://stg-api.talk-x.app',
+        wsEndpoint: '/ws-chat'
+    },
+    [Environment.PRODUCTION]: {
+        serverUrl: 'https://prod-api.talk-x.app',
+        wsEndpoint: '/ws-chat'
+    }
+};
+
+/**
+ * 기본 설정값
+ */
+export const DefaultConfig = {
+    // 기본 환경 (production)
+    environment: Environment.PRODUCTION,
+
+    // Connection
+    reconnectDelay: 5000,
+    maxReconnectAttempts: 10,
+    heartbeatIncoming: 10000,
+    heartbeatOutgoing: 10000,
+
+    // API
+    apiTimeout: 30000,
+
+    // WebRTC
+    iceServers: [
+        { urls: 'stun:stun.l.google.com:19302' },
+        { urls: 'stun:stun1.l.google.com:19302' }
+    ],
+
+    // Logging
+    logLevel: 2 // WARN
+};
+
+/**
+ * 환경에 따른 서버 URL 반환
+ * @param {string} env - Environment 값
+ * @returns {string} 서버 URL
+ */
+export function getServerUrl(env) {
+    const endpoint = Endpoints[env] || Endpoints[Environment.PRODUCTION];
+    return endpoint.serverUrl;
+}
+
+/**
+ * 로그 레벨
+ */
+export const LogLevel = {
+    DEBUG: 0,
+    INFO: 1,
+    WARN: 2,
+    ERROR: 3,
+    NONE: 4
+};