@readerseye2/cr_type 1.0.59 → 1.0.60

package/dist/socket/index.d.ts

@@ -1,3 +1,4 @@
 export * from './socket-clientToServerEvents.type';
 export * from './socket-serverToClientEvents.type';
 export * from './socket-message.types';
+export * from './reading-session.types';

package/dist/socket/index.js

@@ -18,3 +18,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./socket-clientToServerEvents.type"), exports);
 __exportStar(require("./socket-serverToClientEvents.type"), exports);
 __exportStar(require("./socket-message.types"), exports);
+__exportStar(require("./reading-session.types"), exports);

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

@@ -0,0 +1,77 @@
+/** 뷰어 스냅샷 (초기 상태) */
+export interface ViewerSnapshot {
+    viewMode: 'scroll' | 'page';
+    globalRunIndex: number;
+    pageIndex?: number;
+    scrollPosition?: number;
+    totalItems: number;
+}
+/** 뷰어 이벤트 */
+export interface ViewerEvent {
+    type: 'page_change' | 'scroll' | 'overlay_toggle' | 'range_select' | 'quiz_answer' | 'gi_change';
+    timestamp: number;
+    data: Record<string, unknown>;
+}
+/** 읽기 세션 정보 */
+export interface ReadingSessionInfo {
+    sessionId: string;
+    userId: number;
+    userType: 'parent' | 'child';
+    userName?: string;
+    bookIdx: number;
+    bookTitle?: string;
+    sectionId: string;
+    sectionTitle?: string;
+    startedAt: string;
+    snapshot: ViewerSnapshot;
+    lastEventAt?: string;
+}
+/** 세션 시작 페이로드 */
+export interface SessionStartPayload {
+    bookIdx: number;
+    sectionId: string;
+    snapshot: ViewerSnapshot;
+}
+/** 이벤트 배치 전송 페이로드 */
+export interface SessionEventPayload {
+    events: ViewerEvent[];
+}
+/** 세션 구독 페이로드 */
+export interface SessionSubscribePayload {
+    sessionId: string;
+}
+/** Client → Server: 읽기 세션 이벤트 (Client용 - 세션 생성/종료/이벤트 전송) */
+export interface ReadingClientToServerEvents {
+    'reading:session:start': (payload: SessionStartPayload) => void;
+    'reading:session:end': () => void;
+    'reading:session:event': (payload: SessionEventPayload) => void;
+}
+/** Admin → Server: 읽기 세션 이벤트 (Admin용 - 세션 목록 조회/구독) */
+export interface ReadingAdminToServerEvents {
+    'reading:session:list': () => void;
+    'reading:session:subscribe': (payload: SessionSubscribePayload) => void;
+    'reading:session:unsubscribe': (payload: SessionSubscribePayload) => void;
+}
+/** Server → Admin: 읽기 세션 이벤트 */
+export interface ReadingServerToAdminEvents {
+    'reading:session:list': (payload: {
+        sessions: ReadingSessionInfo[];
+    }) => void;
+    'reading:session:started': (payload: {
+        session: ReadingSessionInfo;
+    }) => void;
+    'reading:session:ended': (payload: {
+        sessionId: string;
+    }) => void;
+    'reading:session:subscribed': (payload: {
+        sessionId: string;
+        snapshot: ViewerSnapshot | null;
+    }) => void;
+    'reading:session:events': (payload: {
+        sessionId: string;
+        events: ViewerEvent[];
+    }) => void;
+    'reading:session:error': (payload: {
+        message: string;
+    }) => void;
+}

package/dist/socket/reading-session.types.js

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

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

@@ -1,4 +1,5 @@
 import { MessageReadResponse, MessageResponse, NoticeMessageResult } from "./socket-message.types";
+import { ReadingSessionInfo, ViewerEvent, ViewerSnapshot } from "./reading-session.types";
 export interface ServerToClientEvents {
     connect: () => void;
     disconnect: () => void;
@@ -15,5 +16,28 @@ export interface ServerToClientEvents {
 export interface NoticeToClientEvents {
     'notice-message:result': (payload: NoticeMessageResult) => void;
 }
-export interface AdminServerToClientEvents extends ServerToClientEvents, NoticeToClientEvents {
+/** 읽기 세션 모니터링 이벤트 (Admin에게 전송) */
+export interface ReadingServerToClientEvents {
+    'reading:session:list': (payload: {
+        sessions: ReadingSessionInfo[];
+    }) => void;
+    'reading:session:started': (payload: {
+        session: ReadingSessionInfo;
+    }) => void;
+    'reading:session:ended': (payload: {
+        sessionId: string;
+    }) => void;
+    'reading:session:subscribed': (payload: {
+        sessionId: string;
+        snapshot: ViewerSnapshot | null;
+    }) => void;
+    'reading:session:events': (payload: {
+        sessionId: string;
+        events: ViewerEvent[];
+    }) => void;
+    'reading:session:error': (payload: {
+        message: string;
+    }) => void;
+}
+export interface AdminServerToClientEvents extends ServerToClientEvents, NoticeToClientEvents, ReadingServerToClientEvents {
 }

package/package.json

@@ -1,27 +1,27 @@
-{
-  "name": "@readerseye2/cr_type",
-  "version": "1.0.59",
-  "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.60",
+  "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"
+  }
+}