@readerseye2/cr_type 1.0.171 → 1.0.173

package/dist/socket/index.d.ts

@@ -5,3 +5,4 @@ export * from './socket-message.types';
 export * from './reading-section.types';
 export * from './connected-user.types';
 export * from './unified-session.types';
+export * from './result-socket.types';

package/dist/socket/index.js

@@ -22,3 +22,4 @@ __exportStar(require("./socket-message.types"), exports);
 __exportStar(require("./reading-section.types"), exports);
 __exportStar(require("./connected-user.types"), exports);
 __exportStar(require("./unified-session.types"), exports);
+__exportStar(require("./result-socket.types"), exports);

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

@@ -67,7 +67,3 @@ export interface SessionProgressPayload {
 export interface SessionEventPayload {
     events: ViewerEvent[];
 }
-/** 세션 구독 페이로드 */
-export interface SessionSubscribePayload {
-    readingSessionId: string;
-}

package/dist/socket/result-socket.types.d.ts

@@ -0,0 +1,64 @@
+import type { ViewerSnapshot } from './reading-section.types';
+import type { ChunkRef, ChunkReadingScanSummary, UnifiedSessionManifest, UnifiedSegmentMeta, UnifiedChunkFile } from './unified-session.types';
+/** /result 토큰 인증 세션 데이터 */
+export interface ResultSessionData {
+    tokenType: 'live' | 'replay';
+    sessionId: string;
+    permissions: {
+        showGaze: boolean;
+        showChildName: boolean;
+    };
+    expiresAt: number;
+}
+/** CR_result → CR_ws */
+export interface ResultToServerEvents {
+    'session:subscribe': (data: {
+        sessionToken: string;
+    }) => void;
+    'session:unsubscribe': () => void;
+    'history:get-manifest': (data: {
+        shareToken: string;
+    }) => void;
+    'history:get-segment-meta': (data: {
+        shareToken: string;
+        segIdx: number;
+    }) => void;
+    'history:get-chunks': (data: {
+        shareToken: string;
+        segIdx: number;
+        from: number;
+        to: number;
+    }) => void;
+}
+/** CR_ws → CR_result */
+export interface ResultServerToClientEvents {
+    'session:subscribed': (data: {
+        sessionId: string;
+        snapshot: ViewerSnapshot | null;
+        segmentRanges: Array<{
+            start: number;
+            end: number;
+        }>;
+        chunkRefs: ChunkRef[];
+        readingScan?: ChunkReadingScanSummary;
+    }) => void;
+    'chunk:notify': (data: {
+        segmentIndex: number;
+        chunkKey: string;
+        startTs: number;
+        endTs: number;
+        readingScan?: ChunkReadingScanSummary;
+    }) => void;
+    'session:ended': (data: {
+        durationMs: number;
+    }) => void;
+    'session:error': (data: {
+        message: string;
+    }) => void;
+    'history:manifest': (data: UnifiedSessionManifest) => void;
+    'history:segment-meta': (data: UnifiedSegmentMeta) => void;
+    'history:chunks': (data: UnifiedChunkFile[]) => void;
+    'viewer:count': (data: {
+        count: number;
+    }) => void;
+}

package/dist/socket/result-socket.types.js

@@ -0,0 +1,9 @@
+"use strict";
+// ═══════════════════════════════════════════════════════════════════════════
+// /result 네임스페이스 이벤트 타입 (추후 확장용)
+//
+// Phase 5~6에서 CR_result 독립 프로젝트 + CR_ws /result 게이트웨이 구현 시 활성화
+// 관련 plan: CR_docs/plan/cr-result/05-cr-ws-socket-result.md
+//            CR_docs/plan/cr-result/06-cr-result-project.md
+// ═══════════════════════════════════════════════════════════════════════════
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,5 +1,5 @@
 import { ChatMessageReadRequest, ChatMessageRefreshRequest, MessageRequest } from "./socket-message.types";
-import { SessionProgressPayload, SessionEventPayload, SessionSubscribePayload } from "./reading-section.types";
+import { SessionProgressPayload, SessionEventPayload } from "./reading-section.types";
 import { ViewerOpenPayload, ViewerClosePayload, GazeDataPayload, SessionHistoryListPayload, SessionHistoryGetPayload, SessionHistoryDeletePayload, UnifiedChunksGetPayload, UnifiedSegmentGetPayload } from "./unified-session.types";
 import { ReadingProgressReport } from "../book/child-reading-progress.type";
 export interface ClientToServerEvents {
@@ -16,10 +16,14 @@ export interface ClientToServerEvents {
     'session:event': (payload: SessionEventPayload) => void;
     /** 시선 데이터 전송 (~1초 간격) */
     'session:gaze': (payload: GazeDataPayload) => void;
-    /** 세션 구독 (Parent가 자녀 세션 모니터링) */
-    'session:subscribe': (payload: SessionSubscribePayload) => void;
-    /** 세션 구독 해제 */
-    'session:unsubscribe': (payload: SessionSubscribePayload) => void;
+    /** 자녀 세션 live 구독 (부모) */
+    'live:subscribe': (payload: {
+        readingSessionId: string;
+    }) => void;
+    /** 자녀 세션 live 구독 해제 */
+    'live:unsubscribe': (payload: {
+        readingSessionId: string;
+    }) => void;
     /** 읽기 진행 보고 (5초 주기 자동저장) */
     'progress:reading-save': (payload: ReadingProgressReport) => void;
     /** 자녀 읽기 상태 구독 시작 */
@@ -45,10 +49,6 @@ export interface ReadingWatchAdminToServerEvents {
 export interface SessionAdminToServerEvents {
     /** 활성 세션 목록 조회 */
     'session:list': () => void;
-    /** 세션 구독 (실시간 모니터링) */
-    'session:subscribe': (payload: SessionSubscribePayload) => void;
-    /** 세션 구독 해제 */
-    'session:unsubscribe': (payload: SessionSubscribePayload) => void;
     /** 세션 이력 목록 조회 (S3) */
     'session:list-history': (payload: SessionHistoryListPayload) => void;
     /** 세션 이력 상세 조회 (S3) */

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

@@ -1,8 +1,6 @@
 import { MessageReadResponse, MessageResponse, NoticeMessageResult } from "./socket-message.types";
-import { ViewerSnapshot } from "./reading-section.types";
-import { ViewerEvent } from "./viewer-events.types";
 import { ConnectedUser, ConnectedUsersGrouped } from "./connected-user.types";
-import { UnifiedSessionInfo, SessionSegmentChangedPayload, SessionSubscribedPayload, UnifiedChunkFile, GazeDataPayload, SessionHistoryListResult, SessionHistoryGetResult, UnifiedChunksResult, UnifiedSegmentResult, SessionHistoryDeleteResult } from "./unified-session.types";
+import { UnifiedSessionInfo, SessionSegmentChangedPayload, SessionHistoryListResult, SessionHistoryGetResult, UnifiedChunksResult, UnifiedSegmentResult, SessionHistoryDeleteResult } from "./unified-session.types";
 import { LiveReadingState } from "../book/child-reading-progress.type";
 export interface ServerToClientEvents {
     connect: () => void;
@@ -25,34 +23,22 @@ export interface ServerToClientEvents {
         readingSessionId: string;
         durationMs?: number;
     }) => void;
-    /** 구독 성공 (Parent가 자녀 세션 구독 시) */
-    'session:subscribed': (payload: SessionSubscribedPayload) => void;
-    /** 구독 중인 세션의 진행 상황 */
-    'session:progress': (payload: {
-        readingSessionId: string;
-        snapshot: ViewerSnapshot;
-    }) => void;
-    /** 구독 중인 세션의 이벤트 */
-    'session:events': (payload: {
-        readingSessionId: string;
-        events: ViewerEvent[];
-    }) => void;
-    /** 구독 중인 세션의 실시간 시선 데이터 (~1초 간격) */
-    'session:gaze': (payload: {
-        readingSessionId: string;
-        gazeData: GazeDataPayload;
+    /** 세션 에러 */
+    'session:error': (payload: {
+        message: string;
     }) => void;
-    /** 구독 중인 세션의 세그먼트 변경 (섹션 변경) */
-    'session:segment-changed': (payload: SessionSegmentChangedPayload) => void;
-    /** 구독 중인 세션의 청크 (10초 간격) */
-    'session:chunk': (payload: {
+    /** 새 chunk 저장 알림 (5초마다) — 데이터는 기존 API로 fetch */
+    'live:chunk-notify': (payload: {
         readingSessionId: string;
         segmentIndex: number;
-        chunk: UnifiedChunkFile;
+        chunkKey: string;
+        startTs: number;
+        endTs: number;
     }) => void;
-    /** 세션 에러 */
-    'session:error': (payload: {
-        message: string;
+    /** live 구독 중인 세션 종료 */
+    'live:session-ended': (payload: {
+        readingSessionId: string;
+        durationMs: number;
     }) => void;
     /** 자녀 읽기 실시간 상태 (5초 주기) */
     'reading:child-live': (payload: LiveReadingState) => void;
@@ -79,31 +65,8 @@ export interface SessionServerToClientEvents {
         readingSessionId: string;
         durationMs?: number;
     }) => void;
-    /** 구독 성공 */
-    'session:subscribed': (payload: SessionSubscribedPayload) => void;
-    /** 구독 중인 세션 진행 상황 */
-    'session:progress': (payload: {
-        readingSessionId: string;
-        snapshot: ViewerSnapshot;
-    }) => void;
-    /** 구독 중인 세션 이벤트 */
-    'session:events': (payload: {
-        readingSessionId: string;
-        events: ViewerEvent[];
-    }) => void;
-    /** 구독 중인 세션 실시간 시선 데이터 (~1초 간격) */
-    'session:gaze': (payload: {
-        readingSessionId: string;
-        gazeData: GazeDataPayload;
-    }) => void;
     /** 세그먼트 변경 (섹션 변경) */
     'session:segment-changed': (payload: SessionSegmentChangedPayload) => void;
-    /** 실시간 청크 (10초 간격, 구독자에게) */
-    'session:chunk': (payload: {
-        readingSessionId: string;
-        segmentIndex: number;
-        chunk: UnifiedChunkFile;
-    }) => void;
     /** 에러 */
     'session:error': (payload: {
         message: string;

package/dist/socket/unified-session.types.d.ts

@@ -8,13 +8,6 @@ export interface ChunkRef {
     key: string;
     eventCount: number;
 }
-/** session:subscribed 응답 페이로드 */
-export interface SessionSubscribedPayload {
-    readingSessionId: string;
-    snapshot: ViewerSnapshot | null;
-    /** 과거 chunk 참조 목록 (seek용 — 시간범위 + S3 키) */
-    chunkRefs?: ChunkRef[];
-}
 /** 통합 세션 상태 */
 export type UnifiedSessionStatus = 'active' | 'ended';
 /** 통합 세그먼트 상태 */
@@ -38,6 +31,15 @@ export interface GazeBatch {
  * - snapshot: 청크 시작 시점의 뷰어 상태 (Seek 시 초기화용)
  * - gazeData: 시선 추적 배치 데이터 (활성 시에만)
  */
+/** 5초 chunk 종료 시점의 읽기 분석 요약 */
+export interface ChunkReadingScanSummary {
+    readRatio: number;
+    validReadGIs: number;
+    totalReadMs: number;
+    totalAwayMs: number;
+    avgFixationMs: number;
+    metrics?: Record<string, number>;
+}
 export interface UnifiedChunkFile {
     startTimestamp: number;
     endTimestamp: number;
@@ -46,6 +48,8 @@ export interface UnifiedChunkFile {
     snapshot?: ViewerSnapshot;
     /** 시선 추적 데이터 배치 (~30FPS, 활성 시에만 포함) */
     gazeData?: GazeBatch[];
+    /** chunk 시점 읽기 분석 요약 (Phase 4) */
+    readingScanSummary?: ChunkReadingScanSummary;
 }
 /**
  * 통합 세그먼트 메타데이터
@@ -284,7 +288,6 @@ export interface ActiveUnifiedSession {
     currentSegment: ActiveUnifiedSegment | null;
     completedSegments: UnifiedSegmentSummary[];
     totalEvents: number;
-    subscribers: Set<string>;
     chunkIntervalHandle: ReturnType<typeof setInterval> | null;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@readerseye2/cr_type",
-  "version": "1.0.171",
+  "version": "1.0.173",
   "description": "CheckReading shared TypeScript types",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",