@readerseye2/cr_type 1.0.83 → 1.0.84

package/dist/socket/index.d.ts

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

package/dist/socket/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 // src/socket/index.ts
+__exportStar(require("./viewer-events.types"), exports);
 __exportStar(require("./socket-clientToServerEvents.type"), exports);
 __exportStar(require("./socket-serverToClientEvents.type"), exports);
 __exportStar(require("./socket-message.types"), exports);

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

@@ -1,5 +1,4 @@
-/** 뷰어 설정 상태 (소켓 통신용, 유연한 구조) */
-export type ViewerStateSnapshot = Record<string, unknown>;
+import type { CRViewerState, ViewerEvent } from './viewer-events.types';
 /** 뷰어 스냅샷 (소켓 통신용 - 현재 읽기 상태) */
 export interface ViewerSnapshot {
     viewMode: 'scroll' | 'page';
@@ -9,26 +8,7 @@ export interface ViewerSnapshot {
     totalItems: number;
     viewportWidth?: number;
     viewportHeight?: number;
-    viewerState?: ViewerStateSnapshot;
-}
-/** 소켓 전송용 뷰어 이벤트 (간소화된 형태) */
-export interface SocketViewerEvent {
-    type: string;
-    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;
+    viewerState?: Partial<CRViewerState>;
 }
 /** 책/섹션 메타데이터 */
 export interface SessionMeta {
@@ -48,7 +28,6 @@ export interface SessionStartPayload {
     bookIdx: number;
     sectionId: string;
     snapshot: ViewerSnapshot;
-    viewerConfig?: ViewerConfig;
     meta?: SessionMeta;
 }
 /** 섹션 읽기 종료 페이로드 */
@@ -60,11 +39,10 @@ export interface SessionEndPayload {
 /** 진행 상황 업데이트 페이로드 */
 export interface SessionProgressPayload {
     snapshot: ViewerSnapshot;
-    progress?: ReadingProgress;
 }
 /** 이벤트 배치 전송 페이로드 */
 export interface SessionEventPayload {
-    events: SocketViewerEvent[];
+    events: ViewerEvent[];
 }
 /** 세션 구독 페이로드 (Admin용) */
 export interface SessionSubscribePayload {
@@ -84,7 +62,6 @@ export interface ReadingSessionInfo {
     totalSections?: number;
     startedAt: string;
     snapshot: ViewerSnapshot;
-    viewerConfig?: ViewerConfig;
     lastEventAt?: string;
 }
 /** 세션 시작 응답 */
@@ -101,12 +78,11 @@ export interface SessionEndedResponse {
 export interface SessionProgressResponse {
     sessionId: string;
     snapshot: ViewerSnapshot;
-    progress?: ReadingProgress;
 }
 /** 세션 이벤트 응답 */
 export interface SessionEventsResponse {
     sessionId: string;
-    events: SocketViewerEvent[];
+    events: ViewerEvent[];
 }
 /** 세션 목록 응답 */
 export interface SessionListResponse {

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

@@ -1,5 +1,5 @@
 "use strict";
 // src/socket/reading-section.types.ts
 // 읽기 섹션 모니터링용 데이터 타입 정의
-// 뷰어 이벤트 상세 타입은 @readerseye2/cr_viewer에서 정의
+// 뷰어 이벤트 상세 타입은 viewer-events.types.ts에서 정의
 Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,4 +1,5 @@
-import type { ViewerSnapshot, SocketViewerEvent } from './reading-section.types';
+import type { ViewerSnapshot } from './reading-section.types';
+import type { ViewerEvent } from './viewer-events.types';
 /** 녹화 요청자 타입 */
 export type RecordingRequesterType = 'admin' | 'parent';
 /** 뷰어 사용자 타입 (실제로 책 읽는 사람) */
@@ -15,7 +16,7 @@ export type SegmentStatus = 'active' | 'ended';
 export interface ChunkFile {
     startTimestamp: number;
     endTimestamp: number;
-    events: SocketViewerEvent[];
+    events: ViewerEvent[];
     /** 청크 시작 시점의 뷰어 상태 (Seek 시 이 상태로 초기화 후 이벤트 재생) */
     snapshot?: ViewerSnapshot;
 }
@@ -283,7 +284,7 @@ export interface ActiveSegment {
     sectionId: string;
     sectionTitle?: string;
     startedAt: number;
-    eventBuffer: SocketViewerEvent[];
+    eventBuffer: ViewerEvent[];
     chunkStartTimestamp: number;
     /** 현재 청크 시작 시점의 스냅샷 (청크에 포함됨) */
     chunkStartSnapshot: ViewerSnapshot | null;

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

@@ -1,5 +1,6 @@
 import { MessageReadResponse, MessageResponse, NoticeMessageResult } from "./socket-message.types";
-import { ReadingSessionInfo, SocketViewerEvent, ViewerSnapshot } from "./reading-section.types";
+import { ReadingSessionInfo, ViewerSnapshot } from "./reading-section.types";
+import { ViewerEvent } from "./viewer-events.types";
 import { ConnectedUser, ConnectedUsersGrouped } from "./connected-user.types";
 import { RecordingStartedPayload, RecordingStoppedPayload, RecordingChunkPayload, SegmentStartedPayload, SegmentEndedPayload, RecordingListResultPayload, RecordingManifestPayload, SegmentMetaPayload, ChunksResultPayload } from "./recording.types";
 export interface ServerToClientEvents {
@@ -35,7 +36,7 @@ export interface ReadingServerToClientEvents {
     }) => void;
     'reading-section:events': (payload: {
         sessionId: string;
-        events: SocketViewerEvent[];
+        events: ViewerEvent[];
     }) => void;
     'reading-section:error': (payload: {
         message: string;

package/dist/socket/viewer-events.types.d.ts

@@ -0,0 +1,124 @@
+export type ViewerMode = 'scroll' | 'page';
+export type ViewerTheme = 'light' | 'dark' | 'sepia' | 'green';
+export type PointerStyle = 'highlight' | 'underline';
+/** 뷰어 전체 상태 (CR_viewer store 상태) */
+export type CRViewerState = {
+    mode: ViewerMode;
+    theme: ViewerTheme;
+    fontFamily: string;
+    fontSizePx: number;
+    lineHeight: number;
+    marginX: number;
+    marginY: number;
+    showOverlays: boolean;
+    /** 컴팩트 오버레이 모드 (topbar 숨김 + bottombar 축소) */
+    overlayCompactMode: boolean;
+    isSettingsOpen: boolean;
+    pointerStyle: PointerStyle;
+    pointerColor: string;
+    breakMarks: {
+        slash: boolean;
+    };
+    breakGapPx: number;
+    muteAudio: boolean;
+    /** 오디오 재생 속도 (1.0 = 기본, 0.05 단위 증감, 범위: 0.3~2.0) */
+    audioSpeed: number;
+    showPointer: boolean;
+    showSplit: boolean;
+    viewportWidth: number;
+    viewportHeight: number;
+};
+/** 뷰어 이벤트 타입 */
+export type ViewerEventType = 'global_index_change' | 'scroll' | 'page_change' | 'section_change' | 'mode_change' | 'settings_change' | 'render_start' | 'loading_start' | 'loading_end' | 'viewport_resize' | 'audio_control';
+/** 오디오 상태 스냅샷 */
+export type AudioSnapshot = {
+    status: 'idle' | 'loading' | 'playing' | 'paused' | 'ended' | 'error';
+    currentClip: number;
+    currentTimeMs: number;
+};
+/** 오디오 제어 액션 타입 */
+export type AudioControlAction = 'play' | 'pause' | 'stop';
+/** 기본 이벤트 (뷰어에서 emit) */
+export type ViewerEventBase<T extends ViewerEventType, P = Record<string, unknown>> = {
+    type: T;
+    timestamp: number;
+    payload: P;
+};
+/** 저장용 이벤트 (외부에서 relTime 추가) */
+export type StoredViewerEvent<T extends ViewerEventType, P = Record<string, unknown>> = ViewerEventBase<T, P> & {
+    relTime: number;
+};
+export type GlobalIndexChangeEvent = ViewerEventBase<'global_index_change', {
+    globalIndex: number;
+}>;
+export type ScrollEvent = ViewerEventBase<'scroll', {
+    scrollTop: number;
+    scrollRatio: number;
+    anchorGI: number;
+    anchorOffsetRatio: number;
+}>;
+export type PageChangeEvent = ViewerEventBase<'page_change', {
+    page: number;
+    pageIndex?: number;
+}>;
+export type SectionChangeEvent = ViewerEventBase<'section_change', {
+    sectionId: string;
+}>;
+export type ModeChangeEvent = ViewerEventBase<'mode_change', {
+    mode: ViewerMode;
+}>;
+export type SettingsChangeEvent = ViewerEventBase<'settings_change', {
+    key: keyof CRViewerState;
+    value: unknown;
+}>;
+export type RenderStartEvent = ViewerEventBase<'render_start', {
+    sectionId: string;
+}>;
+export type LoadingStartEvent = ViewerEventBase<'loading_start', Record<string, never>>;
+export type LoadingEndEvent = ViewerEventBase<'loading_end', {
+    duration: number;
+}>;
+export type ViewportResizeEvent = ViewerEventBase<'viewport_resize', {
+    width: number;
+    height: number;
+}>;
+export type AudioControlEvent = ViewerEventBase<'audio_control', {
+    action: AudioControlAction;
+}>;
+/** 모든 뷰어 이벤트 타입 (Union) */
+export type ViewerEvent = GlobalIndexChangeEvent | ScrollEvent | PageChangeEvent | SectionChangeEvent | ModeChangeEvent | SettingsChangeEvent | RenderStartEvent | LoadingStartEvent | LoadingEndEvent | ViewportResizeEvent | AudioControlEvent;
+export type ViewerEventCallback = (event: ViewerEvent) => void;
+/** 저장용 이벤트 (any type) */
+export type StoredEvent = StoredViewerEvent<ViewerEventType, unknown>;
+/** 녹화용 뷰어 상태 (Partial - 모든 필드가 필수는 아님) */
+export type RecordingViewerState = Partial<CRViewerState>;
+/** 녹화/재생용 뷰어 스냅샷 (정확한 구조) */
+export type RecordingSnapshot = {
+    viewerState: RecordingViewerState;
+    globalIndex: number;
+    scrollY?: number;
+    anchorGI?: number;
+    anchorOffsetRatio?: number;
+    currentPage?: number;
+    sectionId: string;
+    viewportWidth: number;
+    viewportHeight: number;
+    audio?: AudioSnapshot;
+};
+/** 녹화 청크 */
+export type RecordingChunk = {
+    index: number;
+    startTime: number;
+    endTime: number;
+    snapshot: RecordingSnapshot;
+    events: StoredEvent[];
+};
+/** 녹화 메타데이터 */
+export type RecordingMeta = {
+    id: string;
+    startedAt: number;
+    totalDuration: number;
+    chunkDuration: number;
+    chunkCount: number;
+    sectionId: string;
+};

package/dist/socket/viewer-events.types.js

@@ -0,0 +1,5 @@
+"use strict";
+// src/socket/viewer-events.types.ts
+// 뷰어 이벤트 타입 정의 (source of truth)
+// CR_viewer의 viewerEvent.types.ts에서 이관
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

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