@readerseye2/cr_type 1.0.186 → 1.0.189

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

@@ -2,6 +2,8 @@ import { ChatMessageReadRequest, ChatMessageRefreshRequest, MessageRequest } fro
 import { SessionDataPayload } from "./reading-section.types";
 import { ViewerOpenPayload, ViewerClosePayload, SessionHistoryListPayload, SessionHistoryGetPayload, SessionHistoryDeletePayload, UnifiedChunksGetPayload, UnifiedSegmentGetPayload, LiveBatchPayload } from "./unified-session.types";
 import { ReadingProgressReport } from "../book/child-reading-progress.type";
+import { IceServerConfig } from "./socket-serverToClientEvents.type";
+import { ConnectedUser } from "./connected-user.types";
 export interface ClientToServerEvents {
     'chat-message:send': (msg: MessageRequest) => void;
     'chat-message:refresh': (msg: ChatMessageRefreshRequest) => void;
@@ -66,6 +68,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
@@ -76,6 +88,22 @@ export interface ClientToServerEvents {
         iceCandidateType: 'host' | 'srflx' | 'relay' | null;
         endReason?: 'ice-failed' | 'connection-failed';
     }) => void;
+    /**
+     * 부모→서버: PC 생성 전에 TURN credential을 ack로 받아온다.
+     * 자녀는 offer payload에 iceServers가 동봉되지만, 부모는 PC를 직접 만들기 때문에
+     * 이 ack로 동일한 시점 보장(= PC 생성 전에 TURN URL 확보).
+     */
+    'webrtc:request-ice-servers': (ack: (response: {
+        iceServers: IceServerConfig[];
+    }) => void) => void;
+    /**
+     * 부모→서버: 현재 family room 의 자녀 ConnectedUser 목록을 ack 로 받아온다.
+     * connect 시점 catch-up + incremental events 만으론 좀비 socket / 이벤트 누락 케이스에서
+     * frontend cache 가 stale 될 수 있어서, 디바이스 picker 같은 critical UI 에서 fresh fetch 용도.
+     */
+    'presence:list-family': (ack: (response: {
+        children: ConnectedUser[];
+    }) => void) => void;
 }
 export interface NoticeToServerEvents {
     'notice-message:send': (msg: MessageRequest) => void;

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

@@ -113,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/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.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"
-  }
-}
+{
+  "name": "@readerseye2/cr_type",
+  "version": "1.0.189",
+  "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"
+  }
+}