@readerseye2/cr_type 1.0.185 → 1.0.188

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

@@ -1,6 +1,6 @@
 import { ChatMessageReadRequest, ChatMessageRefreshRequest, MessageRequest } from "./socket-message.types";
 import { SessionDataPayload } from "./reading-section.types";
-import { ViewerOpenPayload, ViewerClosePayload, SessionHistoryListPayload, SessionHistoryGetPayload, SessionHistoryDeletePayload, UnifiedChunksGetPayload, UnifiedSegmentGetPayload } from "./unified-session.types";
+import { ViewerOpenPayload, ViewerClosePayload, SessionHistoryListPayload, SessionHistoryGetPayload, SessionHistoryDeletePayload, UnifiedChunksGetPayload, UnifiedSegmentGetPayload, LiveBatchPayload } from "./unified-session.types";
 import { ReadingProgressReport } from "../book/child-reading-progress.type";
 export interface ClientToServerEvents {
     'chat-message:send': (msg: MessageRequest) => void;
@@ -10,7 +10,7 @@ export interface ClientToServerEvents {
     'session:open': (payload: ViewerOpenPayload) => void;
     /** 뷰어 닫힘 (세션 종료) */
     'session:close': (payload: ViewerClosePayload) => void;
-    /** 5초 통합 데이터 (events + gaze + snapshot) */
+    /** 10초 통합 데이터 (events + gaze + snapshot) */
     'session:data': (payload: SessionDataPayload) => void;
     /** 자녀 세션 live 구독 (부모) */
     'live:subscribe': (payload: {
@@ -20,6 +20,12 @@ export interface ClientToServerEvents {
     'live:unsubscribe': (payload: {
         readingSessionId: string;
     }) => void;
+    /** 라이브 batch 전송 (CR_app → server, 100ms 주기) */
+    'live:batch': (payload: LiveBatchPayload) => void;
+    /** 라이브 mid-join 초기 상태 요청 (watcher → server) */
+    'live:request-initial': (payload: {
+        readingSessionId: string;
+    }) => void;
     /** 읽기 진행 보고 (5초 주기 자동저장) */
     'progress:reading-save': (payload: ReadingProgressReport) => void;
     /** 자녀 읽기 상태 구독 시작 */
@@ -60,6 +66,16 @@ export interface ClientToServerEvents {
     'webrtc:hangup': (payload: {
         targetSocketId: string;
     }) => void;
+    /**
+     * 자녀→부모 peer 오류 통지.
+     * 자녀 단말에 카메라가 없거나, answer 생성 실패 등으로 offer를 처리할 수 없을 때 발신.
+     * 부모는 watchdog timeout 대신 즉시 명확한 에러 메시지를 받는다.
+     */
+    'webrtc:peer-error': (payload: {
+        targetParentSocketId: string;
+        reason: 'camera-unavailable' | 'no-video-track' | 'offer-failed';
+        message?: string;
+    }) => void;
     /**
      * WebRTC 진단 정보 (부모→서버, 단방향)
      * - iceCandidateType: 부모 측 selected candidate pair의 local candidate type

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

@@ -1,6 +1,6 @@
 import { MessageReadResponse, MessageResponse, NoticeMessageResult } from "./socket-message.types";
 import { ConnectedUser, ConnectedUsersGrouped } from "./connected-user.types";
-import { UnifiedSessionInfo, SessionSegmentChangedPayload, SessionHistoryListResult, SessionHistoryGetResult, UnifiedChunksResult, UnifiedSegmentResult, SessionHistoryDeleteResult } from "./unified-session.types";
+import { UnifiedSessionInfo, SessionSegmentChangedPayload, SessionHistoryListResult, SessionHistoryGetResult, UnifiedChunksResult, UnifiedSegmentResult, SessionHistoryDeleteResult, LiveBatchPayload, LiveInitialPayload, LiveChunkRolledPayload, LiveEmitToggle } from "./unified-session.types";
 import { LiveReadingState } from "../book/child-reading-progress.type";
 /** WebRTC ICE 서버 설정 (STUN/TURN) */
 export interface IceServerConfig {
@@ -33,7 +33,7 @@ export interface ServerToClientEvents {
     'session:error': (payload: {
         message: string;
     }) => void;
-    /** 새 chunk 저장 알림 (5초마다) — 데이터는 기존 API로 fetch */
+    /** 새 chunk 저장 알림 (10초마다) — 데이터는 기존 API로 fetch */
     'live:chunk-notify': (payload: {
         readingSessionId: string;
         segmentIndex: number;
@@ -46,6 +46,16 @@ export interface ServerToClientEvents {
         readingSessionId: string;
         durationMs: number;
     }) => void;
+    /** 라이브 batch fanout (server → watchers in live:${id} room) */
+    'live:batch': (payload: LiveBatchPayload) => void;
+    /** 라이브 mid-join 초기 상태 응답 (server → 단일 watcher) */
+    'live:initial': (payload: LiveInitialPayload) => void;
+    /** chunk 경계 anchor 갱신 (server → watchers) */
+    'live:chunk-rolled': (payload: LiveChunkRolledPayload) => void;
+    /** 시청자 1명 이상 → publisher emit 시작 (Phase 7) */
+    'live:start-emit': (payload: LiveEmitToggle) => void;
+    /** 시청자 0명 → publisher emit 정지 (Phase 7) */
+    'live:stop-emit': (payload: LiveEmitToggle) => void;
     /** 자녀(같은 family room)가 소켓에 연결됨 */
     'user:connected': (payload: {
         user: ConnectedUser;
@@ -103,6 +113,16 @@ export interface ServerToClientEvents {
         fromIdx: number;
         fromSocketId: string;
     }) => void;
+    /**
+     * 자녀 측 peer 오류 수신 (부모 측).
+     * 자녀 단말에 카메라가 없거나 offer 처리 실패 시 즉시 통지된다.
+     */
+    'webrtc:peer-error': (payload: {
+        fromChildIdx: number;
+        fromSocketId: string;
+        reason: 'camera-unavailable' | 'no-video-track' | 'offer-failed';
+        message?: string;
+    }) => void;
 }
 export interface NoticeToClientEvents {
     'notice-message:result': (payload: NoticeMessageResult) => void;

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

@@ -308,3 +308,49 @@ export interface ActiveUnifiedSegment {
     totalEvents: number;
     totalGazeSamples: number;
 }
+/**
+ * 라이브 batch 페이로드 (CR_app → server → watchers).
+ * - events 있으면 reliable emit, gaze만이면 volatile emit
+ * - gazeSamples: flat [x, y, t, x, y, t, ...] (저장과 동일 포맷)
+ */
+export interface LiveBatchPayload {
+    readingSessionId: string;
+    /** flat [x, y, t, ...]. 100ms 동안 누적된 gaze samples */
+    gazeSamples?: number[];
+    /** 100ms 동안 발생한 viewer events */
+    events?: ViewerEvent[];
+    /** publisher 측 batch 종료 timestamp */
+    clientTs: number;
+}
+/**
+ * Watcher mid-join 응답 (server → 단일 watcher).
+ * chunkStartSnapshot은 anchor, bufferedEvents/bufferedGaze는 chunk 시작~now 누적.
+ */
+export interface LiveInitialPayload {
+    readingSessionId: string;
+    segmentIndex: number;
+    chunkStartTs: number;
+    chunkStartSnapshot: ViewerSnapshot;
+    /** chunk 시작 ~ 현재 누적 events */
+    bufferedEvents: ViewerEvent[];
+    /** chunk 시작 ~ 현재 누적 gaze */
+    bufferedGaze: GazeBatch[];
+    /** 서버 응답 시각 (clock sync용) */
+    serverTs: number;
+}
+/**
+ * Chunk 경계에서 새 anchor 통지 (server → watchers).
+ * watcher는 이 신호로 currentChunkStartTs 갱신 + snapshot 재적용.
+ */
+export interface LiveChunkRolledPayload {
+    readingSessionId: string;
+    segmentIndex: number;
+    newChunkStartTs: number;
+    newChunkStartSnapshot: ViewerSnapshot;
+}
+/**
+ * Publisher → emit on/off 신호 (시청자 0명 최적화, Phase 7).
+ */
+export interface LiveEmitToggle {
+    readingSessionId: string;
+}

package/package.json

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