@readerseye2/cr_type 1.0.184 → 1.0.186

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;
     /** 자녀 읽기 상태 구독 시작 */
@@ -36,19 +42,29 @@ export interface ClientToServerEvents {
         targetChildSocketId: string;
         sdp: string;
     }) => void;
-    /** 자녀→부모 answer */
+    /**
+     * 자녀→부모 answer.
+     * targetParentSocketId: 부모 계정 단말 단위로 1:1 라우팅하기 위해 사용.
+     * 같은 parent_idx의 다른 단말로는 전송되지 않는다.
+     */
     'webrtc:answer': (payload: {
-        targetParentIdx: number;
+        targetParentSocketId: string;
         sdp: string;
     }) => void;
-    /** ICE candidate 교환 (양방향) */
+    /**
+     * ICE candidate 교환 (양방향).
+     * targetSocketId: 발신자가 부모면 자녀 socket, 자녀면 부모 socket을 지정.
+     */
     'webrtc:ice-candidate': (payload: {
-        targetIdx: number;
+        targetSocketId: string;
         candidate: string;
     }) => void;
-    /** 연결 종료 (양방향) */
+    /**
+     * 연결 종료 (양방향).
+     * targetSocketId: 1:1 hangup 대상 socket.
+     */
     'webrtc:hangup': (payload: {
-        targetIdx: number;
+        targetSocketId: string;
     }) => void;
     /**
      * WebRTC 진단 정보 (부모→서버, 단방향)

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;
@@ -62,29 +72,46 @@ export interface ServerToClientEvents {
     'reading:child-offline': (payload: {
         testeeIdx: number;
     }) => void;
-    /** 부모의 offer 수신 (자녀 측) — iceServers 포함 */
+    /**
+     * 부모의 offer 수신 (자녀 측) — iceServers 포함.
+     * fromParentSocketId: 자녀가 어느 부모 단말이 보낸 offer인지 식별.
+     *   같은 parent_idx의 단말 2대가 동시에 같은 자녀에 offer를 보내면 두 PC가 공존해야 한다.
+     */
     'webrtc:offer': (payload: {
         fromParentIdx: number;
+        fromParentSocketId: string;
         sdp: string;
         iceServers?: IceServerConfig[];
     }) => void;
-    /** 자녀의 answer 수신 (부모 측) */
+    /**
+     * 자녀의 answer 수신 (부모 측).
+     * fromSocketId: 어느 자녀 단말이 보낸 answer인지 식별.
+     */
     'webrtc:answer': (payload: {
         fromChildIdx: number;
+        fromSocketId: string;
         sdp: string;
     }) => void;
     /** TURN credential 포함 ICE 서버 설정 (부모 측, offer 직후 수신) */
     'webrtc:ice-servers': (payload: {
         iceServers: IceServerConfig[];
     }) => void;
-    /** ICE candidate 수신 (양방향) */
+    /**
+     * ICE candidate 수신 (양방향).
+     * fromSocketId: 발신자 socketId — 수신측이 어느 PC에 매핑할지 결정하는 키.
+     */
     'webrtc:ice-candidate': (payload: {
         fromIdx: number;
+        fromSocketId: string;
         candidate: string;
     }) => void;
-    /** 연결 종료 수신 (양방향) */
+    /**
+     * 연결 종료 수신 (양방향).
+     * fromSocketId: 발신자 socketId.
+     */
     'webrtc:hangup': (payload: {
         fromIdx: number;
+        fromSocketId: string;
     }) => void;
 }
 export interface NoticeToClientEvents {

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/dist/socket/webrtc.types.d.ts

@@ -1,13 +1,13 @@
-/** WebRTC 얼굴보기 — 자녀 디바이스 식별용 플랫폼 라벨 */
-export type ChildDevicePlatform = 'windows' | 'macos' | 'android' | 'ios' | 'linux' | 'unknown';
-/**
- * WebRTC 얼굴보기 디바이스 선택 모달용 자녀 디바이스 정보.
- * 같은 자녀 계정으로 여러 단말에 로그인 중일 때, 부모가 어느 단말 영상을 볼지 선택.
- */
-export interface ChildDeviceInfo {
-    socketId: string;
-    platform: ChildDevicePlatform;
-    userAgent: string | null;
-    /** ISO 시각 — 해당 socket이 connect한 시점 */
-    connectedAt: string;
-}
+/** WebRTC 얼굴보기 — 자녀 디바이스 식별용 플랫폼 라벨 */
+export type ChildDevicePlatform = 'windows' | 'macos' | 'android' | 'ios' | 'linux' | 'unknown';
+/**
+ * WebRTC 얼굴보기 디바이스 선택 모달용 자녀 디바이스 정보.
+ * 같은 자녀 계정으로 여러 단말에 로그인 중일 때, 부모가 어느 단말 영상을 볼지 선택.
+ */
+export interface ChildDeviceInfo {
+    socketId: string;
+    platform: ChildDevicePlatform;
+    userAgent: string | null;
+    /** ISO 시각 — 해당 socket이 connect한 시점 */
+    connectedAt: string;
+}

package/dist/socket/webrtc.types.js

@@ -1,2 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,27 +1,27 @@
-{
-  "name": "@readerseye2/cr_type",
-  "version": "1.0.184",
-  "description": "CheckReading shared TypeScript types",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "deploy_npm": "npm version patch && npm publish --access public",
-    "build": "tsc --project tsconfig.json",
-    "prepare": "npm run build"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/bnri/CR_type.git"
-  },
-  "author": "guripong",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "typescript": "^5.8.3"
-  }
-}
+{
+  "name": "@readerseye2/cr_type",
+  "version": "1.0.186",
+  "description": "CheckReading shared TypeScript types",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "deploy_npm": "npm version patch && npm publish --access public",
+    "build": "tsc --project tsconfig.json",
+    "prepare": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bnri/CR_type.git"
+  },
+  "author": "guripong",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  }
+}