@readerseye2/cr_type 1.0.111 → 1.0.112

package/dist/socket/index.js

@@ -21,4 +21,4 @@ __exportStar(require("./socket-serverToClientEvents.type"), exports);
 __exportStar(require("./socket-message.types"), exports);
 __exportStar(require("./reading-section.types"), exports);
 __exportStar(require("./connected-user.types"), exports);
-__exportStar(require("./recording.types"), exports);
+__exportStar(require("./unified-session.types"), exports);

package/dist/socket/reading-section.types.d.ts

@@ -26,19 +26,6 @@ export interface SessionStats {
     scrollDistance?: number;
     interactionCount?: number;
 }
-/** 섹션 읽기 시작 페이로드 */
-export interface SessionStartPayload {
-    bookIdx: number;
-    sectionId: string;
-    snapshot: ViewerSnapshot;
-    meta?: SessionMeta;
-}
-/** 섹션 읽기 종료 페이로드 */
-export interface SessionEndPayload {
-    durationMs?: number;
-    finalSnapshot?: ViewerSnapshot;
-    stats?: SessionStats;
-}
 /** 진행 상황 업데이트 페이로드 */
 export interface SessionProgressPayload {
     snapshot: ViewerSnapshot;
@@ -47,120 +34,7 @@ export interface SessionProgressPayload {
 export interface SessionEventPayload {
     events: ViewerEvent[];
 }
-/** 세션 구독 페이로드 (Admin용) */
+/** 세션 구독 페이로드 */
 export interface SessionSubscribePayload {
     sessionId: string;
 }
-/** 읽기 세션 정보 (서버 응답) */
-export interface ReadingSessionInfo {
-    sessionId: string;
-    userId: number;
-    userType: 'parent' | 'child';
-    userName?: string;
-    bookIdx: number;
-    bookTitle?: string;
-    sectionId: string;
-    sectionTitle?: string;
-    sectionOrder?: number;
-    totalSections?: number;
-    startedAt: string;
-    snapshot: ViewerSnapshot;
-    lastEventAt?: string;
-}
-/** 세션 시작 응답 */
-export interface SessionStartedResponse {
-    session: ReadingSessionInfo;
-}
-/** 세션 종료 응답 */
-export interface SessionEndedResponse {
-    sessionId: string;
-    durationMs?: number;
-    stats?: SessionStats;
-}
-/** 세션 진행 상황 응답 */
-export interface SessionProgressResponse {
-    sessionId: string;
-    snapshot: ViewerSnapshot;
-}
-/** 세션 이벤트 응답 */
-export interface SessionEventsResponse {
-    sessionId: string;
-    events: ViewerEvent[];
-}
-/** 세션 목록 응답 */
-export interface SessionListResponse {
-    sessions: ReadingSessionInfo[];
-}
-/** 세션 구독 성공 응답 */
-export interface SessionSubscribedResponse {
-    sessionId: string;
-    snapshot: ViewerSnapshot;
-}
-/** S3에 저장된 읽기 세션 청크 */
-export interface ReadingSessionChunk {
-    chunkIndex: number;
-    startTimestamp: number;
-    endTimestamp: number;
-    snapshot: ViewerSnapshot | null;
-    events: ViewerEvent[];
-}
-/** S3에 저장된 읽기 세션 기록 */
-export interface ReadingSessionRecord {
-    sessionId: string;
-    userId: number;
-    userType: 'parent' | 'child';
-    userName: string;
-    familyId: number;
-    bookIdx: number;
-    bookTitle: string;
-    sectionId: string;
-    sectionTitle: string;
-    startedAt: string;
-    endedAt: string;
-    durationMs: number;
-    initialSnapshot?: ViewerSnapshot;
-    finalSnapshot?: ViewerSnapshot;
-    stats?: SessionStats;
-    /** 세션 동안의 모든 이벤트 (단일파일 저장 - deprecated, 하위 호환용) */
-    events?: ViewerEvent[];
-    /** 청크 단위 이벤트 (재생용, get 시에만 포함) */
-    chunks?: ReadingSessionChunk[];
-    /** 총 이벤트 수 */
-    totalEvents?: number;
-    /** S3 key (목록 조회 시 제공) */
-    s3Key?: string;
-}
-/** 읽기 세션 기록 목록 조회 요청 (Admin → Server) */
-export interface ReadingSessionsListPayload {
-    familyId?: number;
-    userId?: number;
-    date?: string;
-    limit?: number;
-    offset?: number;
-}
-/** 읽기 세션 기록 목록 조회 결과 (Server → Admin) */
-export interface ReadingSessionsListResultPayload {
-    sessions: ReadingSessionRecord[];
-    total: number;
-    hasMore: boolean;
-}
-/** 읽기 세션 기록 상세 조회 요청 (Admin → Server) */
-export interface ReadingSessionGetPayload {
-    sessionId: string;
-    /** S3 key (목록 조회 시 제공됨) */
-    s3Key?: string;
-}
-/** 읽기 세션 기록 상세 조회 결과 (Server → Admin) */
-export interface ReadingSessionGetResultPayload {
-    session: ReadingSessionRecord;
-}
-/** 읽기 세션 기록 삭제 요청 (Admin → Server) */
-export interface ReadingSessionDeletePayload {
-    sessionId: string;
-    s3Key?: string;
-}
-/** 읽기 세션 기록 삭제 결과 (Server → Admin) */
-export interface ReadingSessionDeleteResultPayload {
-    sessionId: string;
-    success: boolean;
-}

package/dist/socket/reading-section.types.js

@@ -1,5 +1,5 @@
 "use strict";
 // src/socket/reading-section.types.ts
-// 읽기 섹션 모니터링용 데이터 타입 정의
+// 읽기 세션 기본 타입 정의
 // 뷰어 이벤트 상세 타입은 viewer-events.types.ts에서 정의
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/socket/socket-clientToServerEvents.type.d.ts

@@ -1,14 +1,24 @@
 import { ChatMessageReadRequest, ChatMessageRefreshRequest, MessageRequest } from "./socket-message.types";
-import { SessionStartPayload, SessionEndPayload, SessionProgressPayload, SessionEventPayload, SessionSubscribePayload, ReadingSessionsListPayload, ReadingSessionGetPayload, ReadingSessionDeletePayload } from "./reading-section.types";
-import { RecordingStartPayload, RecordingStopPayload, RecordingListPayload, RecordingGetPayload, SegmentGetPayload, ChunksGetPayload } from "./recording.types";
+import { SessionProgressPayload, SessionEventPayload, SessionSubscribePayload } from "./reading-section.types";
+import { ViewerOpenPayload, ViewerClosePayload, GazeDataPayload, SessionHistoryListPayload, SessionHistoryGetPayload, SessionHistoryDeletePayload, UnifiedChunksGetPayload, UnifiedSegmentGetPayload } from "./unified-session.types";
 export interface ClientToServerEvents {
     'chat-message:send': (msg: MessageRequest) => void;
     'chat-message:refresh': (msg: ChatMessageRefreshRequest) => void;
     'chat-message:read': (payload: ChatMessageReadRequest) => void;
-    'reading-section:start': (payload: SessionStartPayload) => void;
-    'reading-section:end': (payload: SessionEndPayload) => void;
-    'reading-section:progress': (payload: SessionProgressPayload) => void;
-    'reading-section:event': (payload: SessionEventPayload) => void;
+    /** 뷰어 열림 (세션 시작 또는 섹션 변경) */
+    'session:open': (payload: ViewerOpenPayload) => void;
+    /** 뷰어 닫힘 (세션 종료) */
+    'session:close': (payload: ViewerClosePayload) => void;
+    /** 진행 상황 (스냅샷 업데이트) */
+    'session:progress': (payload: SessionProgressPayload) => void;
+    /** 이벤트 배치 전송 */
+    'session:event': (payload: SessionEventPayload) => void;
+    /** 시선 데이터 전송 (~1초 간격) */
+    'session:gaze': (payload: GazeDataPayload) => void;
+    /** 세션 구독 (Parent가 자녀 세션 모니터링) */
+    'session:subscribe': (payload: SessionSubscribePayload) => void;
+    /** 세션 구독 해제 */
+    'session:unsubscribe': (payload: SessionSubscribePayload) => void;
 }
 export interface NoticeToServerEvents {
     'notice-message:send': (msg: MessageRequest) => void;
@@ -17,26 +27,24 @@ export interface NoticeToServerEvents {
 export interface UserAdminToServerEvents {
     'user:list': () => void;
 }
-/** 읽기 섹션 관리 이벤트 (Admin용 - 활성 세션 목록 조회/구독) */
-export interface ReadingAdminToServerEvents {
-    'reading-section:list': () => void;
-    'reading-section:subscribe': (payload: SessionSubscribePayload) => void;
-    'reading-section:unsubscribe': (payload: SessionSubscribePayload) => void;
-    /** S3 읽기 세션 기록 목록 조회 */
-    'reading-sessions:list': (payload: ReadingSessionsListPayload) => void;
-    /** S3 읽기 세션 기록 상세 조회 (이벤트 포함) */
-    'reading-sessions:get': (payload: ReadingSessionGetPayload) => void;
-    /** S3 읽기 세션 기록 삭제 */
-    'reading-sessions:delete': (payload: ReadingSessionDeletePayload) => void;
+/** 통합 세션 관리 이벤트 (Admin/Parent용) */
+export interface SessionAdminToServerEvents {
+    /** 활성 세션 목록 조회 */
+    'session:list': () => void;
+    /** 세션 구독 (실시간 모니터링) */
+    'session:subscribe': (payload: SessionSubscribePayload) => void;
+    /** 세션 구독 해제 */
+    'session:unsubscribe': (payload: SessionSubscribePayload) => void;
+    /** 세션 이력 목록 조회 (S3) */
+    'session:list-history': (payload: SessionHistoryListPayload) => void;
+    /** 세션 이력 상세 조회 (S3) */
+    'session:get-history': (payload: SessionHistoryGetPayload) => void;
+    /** 세션 이력 삭제 (S3) */
+    'session:delete-history': (payload: SessionHistoryDeletePayload) => void;
+    /** 청크 조회 (seek/재생용) */
+    'session:get-chunks': (payload: UnifiedChunksGetPayload) => void;
+    /** 세그먼트 상세 조회 */
+    'session:get-segment': (payload: UnifiedSegmentGetPayload) => void;
 }
-/** 녹화 이벤트 (Admin/Parent → Server) - P2.2 Recording System */
-export interface RecordingAdminToServerEvents {
-    'recording:start': (payload: RecordingStartPayload) => void;
-    'recording:stop': (payload: RecordingStopPayload) => void;
-    'recording:list': (payload: RecordingListPayload) => void;
-    'recording:get': (payload: RecordingGetPayload) => void;
-    'recording:get-segment': (payload: SegmentGetPayload) => void;
-    'recording:get-chunks': (payload: ChunksGetPayload) => void;
-}
-export interface AdminClientToServerEvents extends ClientToServerEvents, NoticeToServerEvents, UserAdminToServerEvents, ReadingAdminToServerEvents, RecordingAdminToServerEvents {
+export interface AdminClientToServerEvents extends ClientToServerEvents, NoticeToServerEvents, UserAdminToServerEvents, SessionAdminToServerEvents {
 }

package/dist/socket/socket-serverToClientEvents.type.d.ts

@@ -1,8 +1,8 @@
 import { MessageReadResponse, MessageResponse, NoticeMessageResult } from "./socket-message.types";
-import { ReadingSessionInfo, ViewerSnapshot, ReadingSessionsListResultPayload, ReadingSessionGetResultPayload, ReadingSessionDeleteResultPayload } from "./reading-section.types";
+import { ViewerSnapshot } from "./reading-section.types";
 import { ViewerEvent } from "./viewer-events.types";
 import { ConnectedUser, ConnectedUsersGrouped } from "./connected-user.types";
-import { RecordingStartedPayload, RecordingStoppedPayload, RecordingChunkPayload, RecordingLiveEventsPayload, SegmentStartedPayload, SegmentEndedPayload, RecordingListResultPayload, RecordingManifestPayload, SegmentMetaPayload, ChunksResultPayload } from "./recording.types";
+import { UnifiedSessionInfo, SessionSegmentChangedPayload, UnifiedChunkFile, SessionHistoryListResult, SessionHistoryGetResult, UnifiedChunksResult, UnifiedSegmentResult, SessionHistoryDeleteResult } from "./unified-session.types";
 export interface ServerToClientEvents {
     connect: () => void;
     disconnect: () => void;
@@ -15,47 +15,93 @@ export interface ServerToClientEvents {
     }) => void;
     'chat-message:read-peer': (payload: MessageReadResponse) => void;
     'chat-message:read-self': (payload: MessageReadResponse) => void;
-    'reading-section:started': (payload: {
-        session: ReadingSessionInfo;
+    /** 세션 시작됨 (서버 확인) */
+    'session:started': (payload: {
+        session: UnifiedSessionInfo;
     }) => void;
-    'reading-section:ended': (payload: {
+    /** 세션 종료됨 (서버 확인) */
+    'session:ended': (payload: {
         sessionId: string;
+        durationMs?: number;
+    }) => void;
+    /** 구독 성공 (Parent가 자녀 세션 구독 시) */
+    'session:subscribed': (payload: {
+        sessionId: string;
+        snapshot: ViewerSnapshot | null;
+    }) => void;
+    /** 구독 중인 세션의 진행 상황 */
+    'session:progress': (payload: {
+        sessionId: string;
+        snapshot: ViewerSnapshot;
+    }) => void;
+    /** 구독 중인 세션의 이벤트 */
+    'session:events': (payload: {
+        sessionId: string;
+        events: ViewerEvent[];
+    }) => void;
+    /** 구독 중인 세션의 세그먼트 변경 (섹션 변경) */
+    'session:segment-changed': (payload: SessionSegmentChangedPayload) => void;
+    /** 구독 중인 세션의 청크 (10초 간격) */
+    'session:chunk': (payload: {
+        sessionId: string;
+        segmentIndex: number;
+        chunk: UnifiedChunkFile;
+    }) => void;
+    /** 세션 에러 */
+    'session:error': (payload: {
+        message: string;
     }) => void;
 }
 export interface NoticeToClientEvents {
     'notice-message:result': (payload: NoticeMessageResult) => void;
 }
-/** 읽기 섹션 모니터링 이벤트 (Admin에게 전송) */
-export interface ReadingServerToClientEvents {
-    'reading-section:list': (payload: {
-        sessions: ReadingSessionInfo[];
+/** 통합 세션 모니터링 이벤트 (Admin/Parent에게 전송) */
+export interface SessionServerToClientEvents {
+    /** 활성 세션 목록 */
+    'session:list': (payload: {
+        sessions: UnifiedSessionInfo[];
+    }) => void;
+    /** 새 세션 시작됨 */
+    'session:started': (payload: {
+        session: UnifiedSessionInfo;
+    }) => void;
+    /** 세션 종료됨 */
+    'session:ended': (payload: {
+        sessionId: string;
+        durationMs?: number;
     }) => void;
-    'reading-section:subscribed': (payload: {
+    /** 구독 성공 */
+    'session:subscribed': (payload: {
         sessionId: string;
         snapshot: ViewerSnapshot | null;
     }) => void;
-    'reading-section:progress': (payload: {
+    /** 구독 중인 세션 진행 상황 */
+    'session:progress': (payload: {
         sessionId: string;
         snapshot: ViewerSnapshot;
     }) => void;
-    'reading-section:events': (payload: {
+    /** 구독 중인 세션 이벤트 */
+    'session:events': (payload: {
         sessionId: string;
         events: ViewerEvent[];
     }) => void;
-    /** 섹션 변경 시 구독자에게 전송 (구독 자동 이전됨) */
-    'reading-section:section-changed': (payload: {
-        oldSessionId: string;
-        newSession: ReadingSessionInfo;
+    /** 세그먼트 변경 (섹션 변경) */
+    'session:segment-changed': (payload: SessionSegmentChangedPayload) => void;
+    /** 실시간 청크 (10초 간격, 구독자에게) */
+    'session:chunk': (payload: {
+        sessionId: string;
+        segmentIndex: number;
+        chunk: UnifiedChunkFile;
     }) => void;
-    'reading-section:error': (payload: {
+    /** 에러 */
+    'session:error': (payload: {
         message: string;
     }) => void;
-    /** S3 읽기 세션 기록 목록 */
-    'reading-sessions:list-result': (payload: ReadingSessionsListResultPayload) => void;
-    /** S3 읽기 세션 기록 상세 (이벤트 포함) */
-    'reading-sessions:get-result': (payload: ReadingSessionGetResultPayload) => void;
-    /** S3 읽기 세션 기록 삭제 결과 */
-    'reading-sessions:delete-result': (payload: ReadingSessionDeleteResultPayload) => void;
+    'session:list-history-result': (payload: SessionHistoryListResult) => void;
+    'session:get-history-result': (payload: SessionHistoryGetResult) => void;
+    'session:get-chunks-result': (payload: UnifiedChunksResult) => void;
+    'session:get-segment-result': (payload: UnifiedSegmentResult) => void;
+    'session:delete-history-result': (payload: SessionHistoryDeleteResult) => void;
 }
 /** 연결된 사용자 모니터링 이벤트 (Admin에게 전송) */
 export interface UserServerToClientEvents {
@@ -77,21 +123,5 @@ export interface UserServerToClientEvents {
         readingSessionId: string | null;
     }) => void;
 }
-/** 녹화 이벤트 (Admin/Parent에게 전송) - P2.2 Recording System */
-export interface RecordingServerToClientEvents {
-    'recording:started': (payload: RecordingStartedPayload) => void;
-    'recording:stopped': (payload: RecordingStoppedPayload) => void;
-    'recording:chunk': (payload: RecordingChunkPayload) => void;
-    'recording:live-events': (payload: RecordingLiveEventsPayload) => void;
-    'recording:segment-started': (payload: SegmentStartedPayload) => void;
-    'recording:segment-ended': (payload: SegmentEndedPayload) => void;
-    'recording:error': (payload: {
-        message: string;
-    }) => void;
-    'recording:list-result': (payload: RecordingListResultPayload) => void;
-    'recording:manifest': (payload: RecordingManifestPayload) => void;
-    'recording:segment': (payload: SegmentMetaPayload) => void;
-    'recording:chunks': (payload: ChunksResultPayload) => void;
-}
-export interface AdminServerToClientEvents extends ServerToClientEvents, NoticeToClientEvents, ReadingServerToClientEvents, UserServerToClientEvents, RecordingServerToClientEvents {
+export interface AdminServerToClientEvents extends ServerToClientEvents, NoticeToClientEvents, SessionServerToClientEvents, UserServerToClientEvents {
 }

package/dist/socket/socket-serverToClientEvents.type.js

@@ -1,3 +1,2 @@
 "use strict";
-// import type { MessageResponse } from '@/types/socket/socket-message.types';
 Object.defineProperty(exports, "__esModule", { value: true });