@readerseye2/cr_type 1.0.106 → 1.0.108

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

@@ -96,3 +96,47 @@ export interface SessionSubscribedResponse {
     sessionId: string;
     snapshot: ViewerSnapshot;
 }
+/** S3에 저장된 읽기 세션 기록 */
+export interface ReadingSessionRecord {
+    sessionId: string;
+    userId: number;
+    userType: 'parent' | 'child';
+    userName: string;
+    familyId: number;
+    bookIdx: number;
+    bookTitle: string;
+    sectionId: string;
+    sectionTitle: string;
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    initialSnapshot?: ViewerSnapshot;
+    finalSnapshot?: ViewerSnapshot;
+    stats?: SessionStats;
+    /** 세션 동안의 모든 이벤트 (재생용, get 시에만 포함) */
+    events?: ViewerEvent[];
+}
+/** 읽기 세션 기록 목록 조회 요청 (Admin → Server) */
+export interface ReadingSessionsListPayload {
+    familyId?: number;
+    userId?: number;
+    date?: string;
+    limit?: number;
+    offset?: number;
+}
+/** 읽기 세션 기록 목록 조회 결과 (Server → Admin) */
+export interface ReadingSessionsListResultPayload {
+    sessions: ReadingSessionRecord[];
+    total: number;
+    hasMore: boolean;
+}
+/** 읽기 세션 기록 상세 조회 요청 (Admin → Server) */
+export interface ReadingSessionGetPayload {
+    sessionId: string;
+    /** S3 key (목록 조회 시 제공됨) */
+    s3Key?: string;
+}
+/** 읽기 세션 기록 상세 조회 결과 (Server → Admin) */
+export interface ReadingSessionGetResultPayload {
+    session: ReadingSessionRecord;
+}

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

@@ -1,5 +1,5 @@
 import { ChatMessageReadRequest, ChatMessageRefreshRequest, MessageRequest } from "./socket-message.types";
-import { SessionStartPayload, SessionEndPayload, SessionProgressPayload, SessionEventPayload, SessionSubscribePayload } from "./reading-section.types";
+import { SessionStartPayload, SessionEndPayload, SessionProgressPayload, SessionEventPayload, SessionSubscribePayload, ReadingSessionsListPayload, ReadingSessionGetPayload } from "./reading-section.types";
 import { RecordingStartPayload, RecordingStopPayload, RecordingListPayload, RecordingGetPayload, SegmentGetPayload, ChunksGetPayload } from "./recording.types";
 export interface ClientToServerEvents {
     'chat-message:send': (msg: MessageRequest) => void;
@@ -22,6 +22,10 @@ export interface ReadingAdminToServerEvents {
     'reading-section:list': () => void;
     'reading-section:subscribe': (payload: SessionSubscribePayload) => void;
     'reading-section:unsubscribe': (payload: SessionSubscribePayload) => void;
+    /** S3 읽기 세션 기록 목록 조회 */
+    'reading-sessions:list': (payload: ReadingSessionsListPayload) => void;
+    /** S3 읽기 세션 기록 상세 조회 (이벤트 포함) */
+    'reading-sessions:get': (payload: ReadingSessionGetPayload) => void;
 }
 /** 녹화 이벤트 (Admin/Parent → Server) - P2.2 Recording System */
 export interface RecordingAdminToServerEvents {

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

@@ -1,5 +1,5 @@
 import { MessageReadResponse, MessageResponse, NoticeMessageResult } from "./socket-message.types";
-import { ReadingSessionInfo, ViewerSnapshot } from "./reading-section.types";
+import { ReadingSessionInfo, ViewerSnapshot, ReadingSessionsListResultPayload, ReadingSessionGetResultPayload } from "./reading-section.types";
 import { ViewerEvent } from "./viewer-events.types";
 import { ConnectedUser, ConnectedUsersGrouped } from "./connected-user.types";
 import { RecordingStartedPayload, RecordingStoppedPayload, RecordingChunkPayload, RecordingLiveEventsPayload, SegmentStartedPayload, SegmentEndedPayload, RecordingListResultPayload, RecordingManifestPayload, SegmentMetaPayload, ChunksResultPayload } from "./recording.types";
@@ -34,6 +34,10 @@ export interface ReadingServerToClientEvents {
         sessionId: string;
         snapshot: ViewerSnapshot | null;
     }) => void;
+    'reading-section:progress': (payload: {
+        sessionId: string;
+        snapshot: ViewerSnapshot;
+    }) => void;
     'reading-section:events': (payload: {
         sessionId: string;
         events: ViewerEvent[];
@@ -41,6 +45,10 @@ export interface ReadingServerToClientEvents {
     'reading-section:error': (payload: {
         message: string;
     }) => void;
+    /** S3 읽기 세션 기록 목록 */
+    'reading-sessions:list-result': (payload: ReadingSessionsListResultPayload) => void;
+    /** S3 읽기 세션 기록 상세 (이벤트 포함) */
+    'reading-sessions:get-result': (payload: ReadingSessionGetResultPayload) => void;
 }
 /** 연결된 사용자 모니터링 이벤트 (Admin에게 전송) */
 export interface UserServerToClientEvents {

package/package.json

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