@readerseye2/cr_type 1.0.67 → 1.0.69

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

@@ -18,13 +18,22 @@ export interface ConnectedUser {
     readingSessionId?: string;
 }
 /**
- * 연결된 사용자 목록 (부모/자녀 그룹화)
+ * 가족 그룹 (family:{parentIdx} 기준)
+ */
+export interface FamilyGroup {
+    /** 가족 ID (parent_idx) */
+    familyId: number;
+    /** 가족 내 연결된 사용자 목록 */
+    members: ConnectedUser[];
+}
+/**
+ * 연결된 사용자 목록 (가족별 그룹화)
  */
 export interface ConnectedUsersGrouped {
-    /** 부모 목록 */
-    parents: ConnectedUser[];
-    /** 자녀 목록 (parentIdx로 그룹화 가능) */
-    children: ConnectedUser[];
+    /** 가족별 그룹 목록 */
+    families: FamilyGroup[];
+    /** 총 연결 수 */
+    totalCount: number;
 }
 /** 연결된 사용자 목록 응답 */
 export interface ConnectedUsersListResponse {

package/dist/socket/index.d.ts

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

package/dist/socket/index.js

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

package/dist/socket/monitor.types.d.ts

@@ -0,0 +1,64 @@
+import { ViewerEvent, ViewerSnapshot, ReadingSessionInfo } from './reading-section.types';
+/** 모니터링 메타 정보 (S3 meta.json) */
+export interface MonitorMeta {
+    targetSocketId: string;
+    userType: 'parent' | 'child';
+    userId: number;
+    userName: string;
+    parentIdx?: number;
+    startedAt: number;
+    endedAt: number | null;
+    adminSocketId: string;
+    chunkCount: number;
+}
+/** 모니터링 청크 (S3 chunks/N.json) */
+export interface MonitorChunk {
+    chunkIndex: number;
+    chunkTimestamp: number;
+    readingSessionId: string | null;
+    sectionId: string | null;
+    bookIdx: number | null;
+    events: ViewerEvent[];
+    snapshot: ViewerSnapshot | null;
+    /** 청크 생성 주기 (ms) */
+    delayMs: number;
+}
+/** 모니터링 시작 요청 */
+export interface MonitorStartPayload {
+    targetSocketId: string;
+}
+/** 모니터링 중지 요청 */
+export interface MonitorStopPayload {
+    targetSocketId: string;
+}
+/** 모니터링 시작 응답 */
+export interface MonitorStartedPayload {
+    targetSocketId: string;
+    startedAt: number;
+    userInfo: {
+        userType: 'parent' | 'child';
+        userId: number;
+        userName: string;
+        parentIdx?: number;
+    };
+    currentSession: ReadingSessionInfo | null;
+}
+/** 모니터링 청크 전송 */
+export interface MonitorChunkPayload {
+    targetSocketId: string;
+    chunk: MonitorChunk;
+}
+/** 모니터링 대상 세션 변경 알림 */
+export interface MonitorSessionChangedPayload {
+    targetSocketId: string;
+    session: ReadingSessionInfo | null;
+}
+/** 모니터링 중지 알림 (대상 연결 해제 등) */
+export interface MonitorStoppedPayload {
+    targetSocketId: string;
+    reason?: string;
+}
+/** 모니터링 에러 */
+export interface MonitorErrorPayload {
+    message: string;
+}

package/dist/socket/monitor.types.js

@@ -0,0 +1,4 @@
+"use strict";
+// src/socket/monitor.types.ts
+// Admin 실시간 모니터링용 타입 정의
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -5,6 +5,10 @@ export interface ViewerSnapshot {
     pageIndex?: number;
     scrollPosition?: number;
     totalItems: number;
+    /** 뷰어 너비 (재생 시 동일 크기로 렌더링) */
+    viewportWidth?: number;
+    /** 뷰어 높이 (재생 시 동일 크기로 렌더링) */
+    viewportHeight?: number;
 }
 /** 뷰어 이벤트 */
 export interface ViewerEvent {

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

@@ -1,5 +1,6 @@
 import { ChatMessageReadRequest, ChatMessageRefreshRequest, MessageRequest } from "./socket-message.types";
 import { SessionStartPayload, SessionEndPayload, SessionProgressPayload, SessionEventPayload, SessionSubscribePayload } from "./reading-section.types";
+import { MonitorStartPayload, MonitorStopPayload } from "./monitor.types";
 export interface ClientToServerEvents {
     'chat-message:send': (msg: MessageRequest) => void;
     'chat-message:refresh': (msg: ChatMessageRefreshRequest) => void;
@@ -18,5 +19,10 @@ export interface ReadingAdminToServerEvents {
     'reading-section:subscribe': (payload: SessionSubscribePayload) => void;
     'reading-section:unsubscribe': (payload: SessionSubscribePayload) => void;
 }
-export interface AdminClientToServerEvents extends ClientToServerEvents, NoticeToServerEvents, ReadingAdminToServerEvents {
+/** 실시간 모니터링 이벤트 (Admin용 - 모니터링 시작/중지) */
+export interface MonitorAdminToServerEvents {
+    'monitor:start': (payload: MonitorStartPayload) => void;
+    'monitor:stop': (payload: MonitorStopPayload) => void;
+}
+export interface AdminClientToServerEvents extends ClientToServerEvents, NoticeToServerEvents, ReadingAdminToServerEvents, MonitorAdminToServerEvents {
 }

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

@@ -1,6 +1,7 @@
 import { MessageReadResponse, MessageResponse, NoticeMessageResult } from "./socket-message.types";
 import { ReadingSessionInfo, ViewerEvent, ViewerSnapshot } from "./reading-section.types";
 import { ConnectedUser, ConnectedUsersGrouped } from "./connected-user.types";
+import { MonitorStartedPayload, MonitorChunkPayload, MonitorSessionChangedPayload, MonitorStoppedPayload, MonitorErrorPayload } from "./monitor.types";
 export interface ServerToClientEvents {
     connect: () => void;
     disconnect: () => void;
@@ -60,5 +61,13 @@ export interface UserServerToClientEvents {
         readingSessionId: string | null;
     }) => void;
 }
-export interface AdminServerToClientEvents extends ServerToClientEvents, NoticeToClientEvents, ReadingServerToClientEvents, UserServerToClientEvents {
+/** 실시간 모니터링 이벤트 (Admin에게 전송) */
+export interface MonitorServerToClientEvents {
+    'monitor:started': (payload: MonitorStartedPayload) => void;
+    'monitor:chunk': (payload: MonitorChunkPayload) => void;
+    'monitor:session-changed': (payload: MonitorSessionChangedPayload) => void;
+    'monitor:stopped': (payload: MonitorStoppedPayload) => void;
+    'monitor:error': (payload: MonitorErrorPayload) => void;
+}
+export interface AdminServerToClientEvents extends ServerToClientEvents, NoticeToClientEvents, ReadingServerToClientEvents, UserServerToClientEvents, MonitorServerToClientEvents {
 }

package/package.json

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