@readerseye2/cr_type 1.0.66 → 1.0.69

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

@@ -0,0 +1,58 @@
+/**
+ * 연결된 사용자 정보 (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;
+}
+/**
+ * 가족 그룹 (family:{parentIdx} 기준)
+ */
+export interface FamilyGroup {
+    /** 가족 ID (parent_idx) */
+    familyId: number;
+    /** 가족 내 연결된 사용자 목록 */
+    members: ConnectedUser[];
+}
+/**
+ * 연결된 사용자 목록 (가족별 그룹화)
+ */
+export interface ConnectedUsersGrouped {
+    /** 가족별 그룹 목록 */
+    families: FamilyGroup[];
+    /** 총 연결 수 */
+    totalCount: number;
+}
+/** 연결된 사용자 목록 응답 */
+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,5 @@ 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';
+export * from './monitor.types';

package/dist/socket/index.js

@@ -19,3 +19,5 @@ __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);
+__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,5 +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;
@@ -39,5 +41,33 @@ 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;
+}
+/** 실시간 모니터링 이벤트 (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.66",
+  "version": "1.0.69",
   "description": "CheckReading shared TypeScript types",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",