@readerseye2/cr_type 1.0.60 → 1.0.65

package/dist/socket/index.d.ts

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

package/dist/socket/index.js

@@ -18,4 +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);
+__exportStar(require("./reading-section.types"), exports);

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

@@ -0,0 +1,114 @@
+/** 뷰어 스냅샷 (현재 상태) */
+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 ViewerConfig {
+    fontSize?: number;
+    lineHeight?: number;
+    theme?: 'light' | 'dark' | 'sepia';
+    viewMode?: 'scroll' | 'page';
+}
+/** 읽기 진행 상황 */
+export interface ReadingProgress {
+    currentPage?: number;
+    totalPages?: number;
+    percentage?: number;
+}
+/** 책/섹션 메타데이터 */
+export interface SessionMeta {
+    bookTitle?: string;
+    sectionTitle?: string;
+    sectionOrder?: number;
+    totalSections?: number;
+}
+/** 세션 통계 */
+export interface SessionStats {
+    pagesRead?: number;
+    scrollDistance?: number;
+    interactionCount?: number;
+}
+/** 섹션 읽기 시작 페이로드 */
+export interface SessionStartPayload {
+    bookIdx: number;
+    sectionId: string;
+    snapshot: ViewerSnapshot;
+    viewerConfig?: ViewerConfig;
+    meta?: SessionMeta;
+}
+/** 섹션 읽기 종료 페이로드 */
+export interface SessionEndPayload {
+    durationMs?: number;
+    finalSnapshot?: ViewerSnapshot;
+    stats?: SessionStats;
+}
+/** 진행 상황 업데이트 페이로드 */
+export interface SessionProgressPayload {
+    snapshot: ViewerSnapshot;
+    progress?: ReadingProgress;
+}
+/** 이벤트 배치 전송 페이로드 */
+export interface SessionEventPayload {
+    events: ViewerEvent[];
+}
+/** 세션 구독 페이로드 (Admin용) */
+export interface SessionSubscribePayload {
+    sessionId: string;
+}
+/** 읽기 세션 정보 (서버 응답) */
+export interface ReadingSessionInfo {
+    sessionId: string;
+    userId: number;
+    userType: 'parent' | 'child';
+    userName?: string;
+    bookIdx: number;
+    bookTitle?: string;
+    sectionId: string;
+    sectionTitle?: string;
+    sectionOrder?: number;
+    totalSections?: number;
+    startedAt: string;
+    snapshot: ViewerSnapshot;
+    viewerConfig?: ViewerConfig;
+    lastEventAt?: string;
+}
+/** 세션 시작 응답 */
+export interface SessionStartedResponse {
+    session: ReadingSessionInfo;
+}
+/** 세션 종료 응답 */
+export interface SessionEndedResponse {
+    sessionId: string;
+    durationMs?: number;
+    stats?: SessionStats;
+}
+/** 세션 진행 상황 응답 */
+export interface SessionProgressResponse {
+    sessionId: string;
+    snapshot: ViewerSnapshot;
+    progress?: ReadingProgress;
+}
+/** 세션 이벤트 응답 */
+export interface SessionEventsResponse {
+    sessionId: string;
+    events: ViewerEvent[];
+}
+/** 세션 목록 응답 */
+export interface SessionListResponse {
+    sessions: ReadingSessionInfo[];
+}
+/** 세션 구독 성공 응답 */
+export interface SessionSubscribedResponse {
+    sessionId: string;
+    snapshot: ViewerSnapshot;
+}

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

@@ -0,0 +1,5 @@
+"use strict";
+// src/socket/reading-section.types.ts
+// 읽기 섹션 모니터링용 데이터 타입 정의
+// 이벤트 인터페이스는 socket-clientToServerEvents.type.ts, socket-serverToClientEvents.type.ts 참조
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,4 +1,4 @@
-/** 뷰어 스냅샷 (초기 상태) */
+/** 뷰어 스냅샷 (현재 상태) */
 export interface ViewerSnapshot {
     viewMode: 'scroll' | 'page';
     globalRunIndex: number;
@@ -12,7 +12,60 @@ export interface ViewerEvent {
     timestamp: number;
     data: Record<string, unknown>;
 }
-/** 읽기 세션 정보 */
+/** 뷰어 초기 설정 */
+export interface ViewerConfig {
+    fontSize?: number;
+    lineHeight?: number;
+    theme?: 'light' | 'dark' | 'sepia';
+    viewMode?: 'scroll' | 'page';
+}
+/** 읽기 진행 상황 */
+export interface ReadingProgress {
+    currentPage?: number;
+    totalPages?: number;
+    percentage?: number;
+}
+/** 책/섹션 메타데이터 */
+export interface SessionMeta {
+    bookTitle?: string;
+    sectionTitle?: string;
+    sectionOrder?: number;
+    totalSections?: number;
+}
+/** 세션 통계 */
+export interface SessionStats {
+    pagesRead?: number;
+    scrollDistance?: number;
+    interactionCount?: number;
+}
+/** 세션 시작 페이로드 */
+export interface SessionStartPayload {
+    bookIdx: number;
+    sectionId: string;
+    snapshot: ViewerSnapshot;
+    viewerConfig?: ViewerConfig;
+    meta?: SessionMeta;
+}
+/** 세션 종료 페이로드 */
+export interface SessionEndPayload {
+    durationMs?: number;
+    finalSnapshot?: ViewerSnapshot;
+    stats?: SessionStats;
+}
+/** 진행 상황 업데이트 페이로드 */
+export interface SessionProgressPayload {
+    snapshot: ViewerSnapshot;
+    progress?: ReadingProgress;
+}
+/** 이벤트 배치 전송 페이로드 */
+export interface SessionEventPayload {
+    events: ViewerEvent[];
+}
+/** 세션 구독 페이로드 */
+export interface SessionSubscribePayload {
+    sessionId: string;
+}
+/** 읽기 세션 정보 (서버 응답) */
 export interface ReadingSessionInfo {
     sessionId: string;
     userId: number;
@@ -22,56 +75,40 @@ export interface ReadingSessionInfo {
     bookTitle?: string;
     sectionId: string;
     sectionTitle?: string;
+    sectionOrder?: number;
+    totalSections?: number;
     startedAt: string;
     snapshot: ViewerSnapshot;
+    viewerConfig?: ViewerConfig;
     lastEventAt?: string;
 }
-/** 세션 시작 페이로드 */
-export interface SessionStartPayload {
-    bookIdx: number;
-    sectionId: string;
+/** 세션 시작 응답 */
+export interface SessionStartedResponse {
+    session: ReadingSessionInfo;
+}
+/** 세션 종료 응답 */
+export interface SessionEndedResponse {
+    sessionId: string;
+    durationMs?: number;
+    stats?: SessionStats;
+}
+/** 세션 진행 상황 응답 */
+export interface SessionProgressResponse {
+    sessionId: string;
     snapshot: ViewerSnapshot;
+    progress?: ReadingProgress;
 }
-/** 이벤트 배치 전송 페이로드 */
-export interface SessionEventPayload {
+/** 세션 이벤트 응답 */
+export interface SessionEventsResponse {
+    sessionId: string;
     events: ViewerEvent[];
 }
-/** 세션 구독 페이로드 */
-export interface SessionSubscribePayload {
-    sessionId: string;
+/** 세션 목록 응답 */
+export interface SessionListResponse {
+    sessions: ReadingSessionInfo[];
 }
-/** 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;
+/** 세션 구독 성공 응답 */
+export interface SessionSubscribedResponse {
+    sessionId: string;
+    snapshot: ViewerSnapshot;
 }

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

@@ -1,3 +1,5 @@
 "use strict";
 // src/socket/reading-session.types.ts
+// 읽기 세션 모니터링용 데이터 타입 정의
+// 이벤트 인터페이스는 socket-clientToServerEvents.type.ts, socket-serverToClientEvents.type.ts 참조
 Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,11 +1,22 @@
 import { ChatMessageReadRequest, ChatMessageRefreshRequest, MessageRequest } from "./socket-message.types";
+import { SessionStartPayload, SessionEndPayload, SessionProgressPayload, SessionEventPayload, SessionSubscribePayload } from "./reading-section.types";
 export interface ClientToServerEvents {
     'chat-message:send': (msg: MessageRequest) => void;
     'chat-message:refresh': (msg: ChatMessageRefreshRequest) => void;
     'chat-message:read': (payload: ChatMessageReadRequest) => void;
+    'reading-section:start': (payload: SessionStartPayload) => void;
+    'reading-section:end': (payload: SessionEndPayload) => void;
+    'reading-section:progress': (payload: SessionProgressPayload) => void;
+    'reading-section:event': (payload: SessionEventPayload) => void;
 }
 export interface NoticeToServerEvents {
     'notice-message:send': (msg: MessageRequest) => void;
 }
-export interface AdminClientToServerEvents extends ClientToServerEvents, NoticeToServerEvents {
+/** 읽기 섹션 관리 이벤트 (Admin용 - 활성 세션 목록 조회/구독) */
+export interface ReadingAdminToServerEvents {
+    'reading-section:list': () => void;
+    'reading-section:subscribe': (payload: SessionSubscribePayload) => void;
+    'reading-section:unsubscribe': (payload: SessionSubscribePayload) => void;
+}
+export interface AdminClientToServerEvents extends ClientToServerEvents, NoticeToServerEvents, ReadingAdminToServerEvents {
 }

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

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

package/package.json

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