@readerseye2/cr_type 1.0.82 → 1.0.84

package/dist/index.d.ts

@@ -2,4 +2,3 @@ export * from './session/session.type';
 export * from './socket';
 export * from './book';
 export * from './ast';
-export * from './viewer/viewerEvent.types';

package/dist/index.js

@@ -19,4 +19,4 @@ __exportStar(require("./session/session.type"), exports);
 __exportStar(require("./socket"), exports); // socket 전체 export
 __exportStar(require("./book"), exports);
 __exportStar(require("./ast"), exports); // AST 타입 (SectionData, Block 등)
-__exportStar(require("./viewer/viewerEvent.types"), exports); // 뷰어 이벤트/스냅샷 타입
+// viewer 타입은 @readerseye2/cr_viewer에서 export

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,6 +1,4 @@
-import type { ViewerEventType, RecordingViewerState } from '../viewer/viewerEvent.types';
-/** 뷰어 설정 상태 (CRViewerState에서 재사용) */
-export type ViewerStateSnapshot = RecordingViewerState;
+import type { CRViewerState, ViewerEvent } from './viewer-events.types';
 /** 뷰어 스냅샷 (소켓 통신용 - 현재 읽기 상태) */
 export interface ViewerSnapshot {
     viewMode: 'scroll' | 'page';
@@ -10,26 +8,7 @@ export interface ViewerSnapshot {
     totalItems: number;
     viewportWidth?: number;
     viewportHeight?: number;
-    viewerState?: ViewerStateSnapshot;
-}
-/** 소켓 전송용 뷰어 이벤트 (간소화된 형태) */
-export interface SocketViewerEvent {
-    type: ViewerEventType | '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;
+    viewerState?: Partial<CRViewerState>;
 }
 /** 책/섹션 메타데이터 */
 export interface SessionMeta {
@@ -49,7 +28,6 @@ export interface SessionStartPayload {
     bookIdx: number;
     sectionId: string;
     snapshot: ViewerSnapshot;
-    viewerConfig?: ViewerConfig;
     meta?: SessionMeta;
 }
 /** 섹션 읽기 종료 페이로드 */
@@ -61,11 +39,10 @@ export interface SessionEndPayload {
 /** 진행 상황 업데이트 페이로드 */
 export interface SessionProgressPayload {
     snapshot: ViewerSnapshot;
-    progress?: ReadingProgress;
 }
 /** 이벤트 배치 전송 페이로드 */
 export interface SessionEventPayload {
-    events: SocketViewerEvent[];
+    events: ViewerEvent[];
 }
 /** 세션 구독 페이로드 (Admin용) */
 export interface SessionSubscribePayload {
@@ -85,7 +62,6 @@ export interface ReadingSessionInfo {
     totalSections?: number;
     startedAt: string;
     snapshot: ViewerSnapshot;
-    viewerConfig?: ViewerConfig;
     lastEventAt?: string;
 }
 /** 세션 시작 응답 */
@@ -102,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
 // 읽기 섹션 모니터링용 데이터 타입 정의
-// 뷰어 이벤트 타입은 viewer/viewerEvent.types.ts에서 가져옴
+// 뷰어 이벤트 상세 타입은 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/{viewer/viewerEvent.types.d.ts → socket/viewer-events.types.d.ts}

@@ -11,6 +11,8 @@ export type CRViewerState = {
     marginX: number;
     marginY: number;
     showOverlays: boolean;
+    /** 컴팩트 오버레이 모드 (topbar 숨김 + bottombar 축소) */
+    overlayCompactMode: boolean;
     isSettingsOpen: boolean;
     pointerStyle: PointerStyle;
     pointerColor: string;
@@ -19,38 +21,23 @@ export type CRViewerState = {
     };
     breakGapPx: number;
     muteAudio: boolean;
-    audioTargetWpm: number;
+    /** 오디오 재생 속도 (1.0 = 기본, 0.05 단위 증감, 범위: 0.3~2.0) */
     audioSpeed: number;
     showPointer: boolean;
     showSplit: boolean;
     viewportWidth: number;
     viewportHeight: number;
-    playbackViewportWidth: number;
-    playbackViewportHeight: number;
 };
 /** 뷰어 이벤트 타입 */
-export type ViewerEventType = 'recording_start' | 'recording_stop' | 'global_index_change' | 'scroll' | 'page_change' | 'section_change' | 'mode_change' | 'settings_change' | 'viewer_state_snapshot' | 'render_start' | 'loading_start' | 'loading_end' | 'viewport_resize' | 'audio_control';
+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;
 };
-/** 녹화용 뷰어 상태 (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 AudioControlAction = 'play' | 'pause' | 'stop';
 /** 기본 이벤트 (뷰어에서 emit) */
 export type ViewerEventBase<T extends ViewerEventType, P = Record<string, unknown>> = {
     type: T;
@@ -61,14 +48,6 @@ export type ViewerEventBase<T extends ViewerEventType, P = Record<string, unknow
 export type StoredViewerEvent<T extends ViewerEventType, P = Record<string, unknown>> = ViewerEventBase<T, P> & {
     relTime: number;
 };
-/** 오디오 제어 액션 타입 */
-export type AudioControlAction = 'play' | 'pause' | 'stop';
-export type RecordingStartEvent = ViewerEventBase<'recording_start', {
-    snapshot: RecordingSnapshot;
-}>;
-export type RecordingStopEvent = ViewerEventBase<'recording_stop', {
-    duration: number;
-}>;
 export type GlobalIndexChangeEvent = ViewerEventBase<'global_index_change', {
     globalIndex: number;
 }>;
@@ -80,6 +59,7 @@ export type ScrollEvent = ViewerEventBase<'scroll', {
 }>;
 export type PageChangeEvent = ViewerEventBase<'page_change', {
     page: number;
+    pageIndex?: number;
 }>;
 export type SectionChangeEvent = ViewerEventBase<'section_change', {
     sectionId: string;
@@ -91,9 +71,6 @@ export type SettingsChangeEvent = ViewerEventBase<'settings_change', {
     key: keyof CRViewerState;
     value: unknown;
 }>;
-export type ViewerStateSnapshotEvent = ViewerEventBase<'viewer_state_snapshot', {
-    viewerState: CRViewerState;
-}>;
 export type RenderStartEvent = ViewerEventBase<'render_start', {
     sectionId: string;
 }>;
@@ -109,10 +86,25 @@ export type AudioControlEvent = ViewerEventBase<'audio_control', {
     action: AudioControlAction;
 }>;
 /** 모든 뷰어 이벤트 타입 (Union) */
-export type ViewerEvent = RecordingStartEvent | RecordingStopEvent | GlobalIndexChangeEvent | ScrollEvent | PageChangeEvent | SectionChangeEvent | ModeChangeEvent | SettingsChangeEvent | ViewerStateSnapshotEvent | RenderStartEvent | LoadingStartEvent | LoadingEndEvent | ViewportResizeEvent | AudioControlEvent;
+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;

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.82",
+  "version": "1.0.84",
   "description": "CheckReading shared TypeScript types",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/session.d.ts

@@ -1,36 +0,0 @@
-export declare enum OauthUserType {
-    CHILD = "child",
-    PARENT = "parent",
-    ADMIN = "admin"
-}
-export declare enum OauthProvider {
-    GOOGLE = "google",
-    NAVER = "naver",
-    KAKAO = "kakao"
-}
-export interface CommonSessionData {
-    access_token: string;
-    access_token_expire: number;
-    refresh_token: string;
-    refresh_token_expire: number;
-    createdAt: number;
-    device_ID: string;
-    session_type: OauthUserType;
-}
-export interface ParentSessionData extends CommonSessionData {
-    user_idx: number;
-    user_logo_url?: string;
-    client_id: string;
-    email: string;
-    name: string;
-    provider: OauthProvider;
-}
-export interface ChildSessionData extends CommonSessionData {
-    parent_idx: number;
-    child_idx: number;
-    child_image_url?: string;
-    child_ID: string;
-    parent_name: string;
-    parent_logo_url?: string;
-}
-export type userSessionData = ParentSessionData | ChildSessionData;

package/dist/session.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OauthProvider = exports.OauthUserType = void 0;
-// export type providerEnum = 'google' | 'naver' | 'kakao';
-var OauthUserType;
-(function (OauthUserType) {
-    OauthUserType["CHILD"] = "child";
-    OauthUserType["PARENT"] = "parent";
-    OauthUserType["ADMIN"] = "admin";
-})(OauthUserType || (exports.OauthUserType = OauthUserType = {}));
-var OauthProvider;
-(function (OauthProvider) {
-    OauthProvider["GOOGLE"] = "google";
-    OauthProvider["NAVER"] = "naver";
-    OauthProvider["KAKAO"] = "kakao";
-})(OauthProvider || (exports.OauthProvider = OauthProvider = {}));

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

@@ -1,82 +0,0 @@
-import { SocketViewerEvent, 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: SocketViewerEvent[];
-    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;
-}
-/** 활성 모니터링 (서버 메모리) */
-export interface ActiveMonitor {
-    targetSocketId: string;
-    adminSocketId: string;
-    userType: 'parent' | 'child';
-    userId: number;
-    userName: string;
-    parentIdx?: number;
-    startedAt: number;
-    s3Prefix: string;
-    chunkIndex: number;
-    eventBuffer: SocketViewerEvent[];
-    lastSnapshot: ViewerSnapshot | null;
-    currentReadingSessionId: string | null;
-    currentSectionId: string | null;
-    currentBookIdx: number | null;
-    intervalHandle: ReturnType<typeof setInterval> | null;
-}

package/dist/socket/monitor.types.js

@@ -1,4 +0,0 @@
-"use strict";
-// src/socket/monitor.types.ts
-// Admin 실시간 모니터링용 타입 정의
-Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,114 +0,0 @@
-/** 뷰어 스냅샷 (현재 상태) */
-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[];
-}
-/** 세션 구독 페이로드 */
-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-session.types.js

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

package/dist/viewer/viewerEvent.types.js

@@ -1,5 +0,0 @@
-"use strict";
-// src/viewer/viewerEvent.types.ts
-// CR_viewer 이벤트 및 스냅샷 타입 정의
-// 모든 프로젝트(CR_viewer, CR_app, CR_admin, CR_ws)에서 이 타입을 사용
-Object.defineProperty(exports, "__esModule", { value: true });