@readerseye2/cr_type 1.0.183 → 1.0.185

package/dist/socket/connected-user.types.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Socket 디바이스 플랫폼 (얼굴보기 디바이스 선택용).
+ * 자녀 socket에만 채워짐. userAgent에서 파싱.
+ */
+export type DevicePlatform = 'windows' | 'macos' | 'android' | 'ios' | 'linux' | 'unknown';
 /**
  * 연결된 사용자 정보 (Socket 기반)
  */
@@ -12,10 +17,12 @@ export interface ConnectedUser {
     userName: string;
     /** 부모 idx (child인 경우) */
     parentIdx?: number;
-    /** 연결 시간 */
+    /** 연결 시간 (ISO) */
     connectedAt: string;
     /** 현재 읽기 세션 ID (읽기 중인 경우) */
     readingSessionId?: string;
+    /** 디바이스 플랫폼 — 자녀 socket에만 채워짐 (얼굴보기 디바이스 선택용) */
+    platform?: DevicePlatform;
 }
 /**
  * 가족 그룹 (family:{parentIdx} 기준)

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

@@ -26,24 +26,39 @@ export interface ClientToServerEvents {
     'reading:watch-children': (childIdxList: number[]) => void;
     /** 자녀 읽기 상태 구독 해제 */
     'reading:unwatch-children': () => void;
-    /** 부모→자녀 offer */
+    /**
+     * 부모→자녀 offer.
+     * targetChildSocketId: 같은 자녀 계정으로 여러 단말 접속 시 부모가 선택한 단말의 socketId.
+     * (디바이스 선택 모달 → ConnectedUser.socketId)
+     */
     'webrtc:offer': (payload: {
         targetChildIdx: number;
+        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

@@ -62,29 +62,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/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.183",
-  "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.185",
+  "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"
+  }
+}