@readerseye2/cr_type 1.0.65 → 1.0.67

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

@@ -0,0 +1,49 @@
+/**
+ * 연결된 사용자 정보 (Socket 기반)
+ */
+export interface ConnectedUser {
+    /** 소켓 ID */
+    socketId: string;
+    /** 사용자 유형 */
+    userType: 'parent' | 'child';
+    /** 사용자 ID (parent: user_idx, child: child_idx) */
+    userId: number;
+    /** 사용자 이름 (parent: oauth_email, child: child_ID) */
+    userName: string;
+    /** 부모 idx (child인 경우) */
+    parentIdx?: number;
+    /** 연결 시간 */
+    connectedAt: string;
+    /** 현재 읽기 세션 ID (읽기 중인 경우) */
+    readingSessionId?: string;
+}
+/**
+ * 연결된 사용자 목록 (부모/자녀 그룹화)
+ */
+export interface ConnectedUsersGrouped {
+    /** 부모 목록 */
+    parents: ConnectedUser[];
+    /** 자녀 목록 (parentIdx로 그룹화 가능) */
+    children: ConnectedUser[];
+}
+/** 연결된 사용자 목록 응답 */
+export interface ConnectedUsersListResponse {
+    users: ConnectedUsersGrouped;
+}
+/** 사용자 연결 이벤트 */
+export interface UserConnectedPayload {
+    user: ConnectedUser;
+}
+/** 사용자 연결 해제 이벤트 */
+export interface UserDisconnectedPayload {
+    socketId: string;
+    userId: number;
+    userType: 'parent' | 'child';
+}
+/** 사용자 읽기 상태 변경 이벤트 */
+export interface UserReadingStatusPayload {
+    socketId: string;
+    userId: number;
+    userType: 'parent' | 'child';
+    readingSessionId: string | null;
+}

package/dist/socket/connected-user.types.js

@@ -0,0 +1,3 @@
+"use strict";
+// src/socket/connected-user.types.ts
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/socket/index.d.ts

@@ -2,3 +2,4 @@ export * from './socket-clientToServerEvents.type';
 export * from './socket-serverToClientEvents.type';
 export * from './socket-message.types';
 export * from './reading-section.types';
+export * from './connected-user.types';

package/dist/socket/index.js

@@ -19,3 +19,4 @@ __exportStar(require("./socket-clientToServerEvents.type"), exports);
 __exportStar(require("./socket-serverToClientEvents.type"), exports);
 __exportStar(require("./socket-message.types"), exports);
 __exportStar(require("./reading-section.types"), exports);
+__exportStar(require("./connected-user.types"), exports);

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

@@ -8,7 +8,7 @@ export interface ViewerSnapshot {
 }
 /** 뷰어 이벤트 */
 export interface ViewerEvent {
-    type: 'page_change' | 'scroll' | 'overlay_toggle' | 'range_select' | 'quiz_answer' | 'gi_change';
+    type: 'page_change' | 'scroll' | 'overlay_toggle' | 'range_select' | 'quiz_answer' | 'gi_change' | 'global_index_change' | 'section_change' | 'mode_change' | 'settings_change' | 'viewer_state_snapshot' | 'recording_start' | 'recording_stop' | 'audio_control';
     timestamp: number;
     data: Record<string, unknown>;
 }

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

@@ -1,5 +1,6 @@
 import { MessageReadResponse, MessageResponse, NoticeMessageResult } from "./socket-message.types";
 import { ReadingSessionInfo, ViewerEvent, ViewerSnapshot } from "./reading-section.types";
+import { ConnectedUser, ConnectedUsersGrouped } from "./connected-user.types";
 export interface ServerToClientEvents {
     connect: () => void;
     disconnect: () => void;
@@ -39,5 +40,25 @@ export interface ReadingServerToClientEvents {
         message: string;
     }) => void;
 }
-export interface AdminServerToClientEvents extends ServerToClientEvents, NoticeToClientEvents, ReadingServerToClientEvents {
+/** 연결된 사용자 모니터링 이벤트 (Admin에게 전송) */
+export interface UserServerToClientEvents {
+    'user:list': (payload: {
+        users: ConnectedUsersGrouped;
+    }) => void;
+    'user:connected': (payload: {
+        user: ConnectedUser;
+    }) => void;
+    'user:disconnected': (payload: {
+        socketId: string;
+        userId: number;
+        userType: 'parent' | 'child';
+    }) => void;
+    'user:reading-status': (payload: {
+        socketId: string;
+        userId: number;
+        userType: 'parent' | 'child';
+        readingSessionId: string | null;
+    }) => void;
+}
+export interface AdminServerToClientEvents extends ServerToClientEvents, NoticeToClientEvents, ReadingServerToClientEvents, UserServerToClientEvents {
 }

package/package.json

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