@readerseye2/cr_type 1.0.82 → 1.0.83

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -2,4 +2,3 @@ export * from './session/session.type';
2
2
  export * from './socket';
3
3
  export * from './book';
4
4
  export * from './ast';
5
- export * from './viewer/viewerEvent.types';
package/dist/index.js CHANGED
@@ -19,4 +19,4 @@ __exportStar(require("./session/session.type"), exports);
19
19
  __exportStar(require("./socket"), exports); // socket 전체 export
20
20
  __exportStar(require("./book"), exports);
21
21
  __exportStar(require("./ast"), exports); // AST 타입 (SectionData, Block 등)
22
- __exportStar(require("./viewer/viewerEvent.types"), exports); // 뷰어 이벤트/스냅샷 타입
22
+ // viewer 타입은 @readerseye2/cr_viewer에서 export
@@ -1,6 +1,5 @@
1
- import type { ViewerEventType, RecordingViewerState } from '../viewer/viewerEvent.types';
2
- /** 뷰어 설정 상태 (CRViewerState에서 재사용) */
3
- export type ViewerStateSnapshot = RecordingViewerState;
1
+ /** 뷰어 설정 상태 (소켓 통신용, 유연한 구조) */
2
+ export type ViewerStateSnapshot = Record<string, unknown>;
4
3
  /** 뷰어 스냅샷 (소켓 통신용 - 현재 읽기 상태) */
5
4
  export interface ViewerSnapshot {
6
5
  viewMode: 'scroll' | 'page';
@@ -14,7 +13,7 @@ export interface ViewerSnapshot {
14
13
  }
15
14
  /** 소켓 전송용 뷰어 이벤트 (간소화된 형태) */
16
15
  export interface SocketViewerEvent {
17
- type: ViewerEventType | 'overlay_toggle' | 'range_select' | 'quiz_answer' | 'gi_change';
16
+ type: string;
18
17
  timestamp: number;
19
18
  data: Record<string, unknown>;
20
19
  }
@@ -1,5 +1,5 @@
1
1
  "use strict";
2
2
  // src/socket/reading-section.types.ts
3
3
  // 읽기 섹션 모니터링용 데이터 타입 정의
4
- // 뷰어 이벤트 타입은 viewer/viewerEvent.types.ts에서 가져옴
4
+ // 뷰어 이벤트 상세 타입은 @readerseye2/cr_viewer에서 정의
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@readerseye2/cr_type",
3
- "version": "1.0.82",
3
+ "version": "1.0.83",
4
4
  "description": "CheckReading shared TypeScript types",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
package/dist/session.d.ts DELETED
@@ -1,36 +0,0 @@
1
- export declare enum OauthUserType {
2
- CHILD = "child",
3
- PARENT = "parent",
4
- ADMIN = "admin"
5
- }
6
- export declare enum OauthProvider {
7
- GOOGLE = "google",
8
- NAVER = "naver",
9
- KAKAO = "kakao"
10
- }
11
- export interface CommonSessionData {
12
- access_token: string;
13
- access_token_expire: number;
14
- refresh_token: string;
15
- refresh_token_expire: number;
16
- createdAt: number;
17
- device_ID: string;
18
- session_type: OauthUserType;
19
- }
20
- export interface ParentSessionData extends CommonSessionData {
21
- user_idx: number;
22
- user_logo_url?: string;
23
- client_id: string;
24
- email: string;
25
- name: string;
26
- provider: OauthProvider;
27
- }
28
- export interface ChildSessionData extends CommonSessionData {
29
- parent_idx: number;
30
- child_idx: number;
31
- child_image_url?: string;
32
- child_ID: string;
33
- parent_name: string;
34
- parent_logo_url?: string;
35
- }
36
- export type userSessionData = ParentSessionData | ChildSessionData;
package/dist/session.js DELETED
@@ -1,16 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.OauthProvider = exports.OauthUserType = void 0;
4
- // export type providerEnum = 'google' | 'naver' | 'kakao';
5
- var OauthUserType;
6
- (function (OauthUserType) {
7
- OauthUserType["CHILD"] = "child";
8
- OauthUserType["PARENT"] = "parent";
9
- OauthUserType["ADMIN"] = "admin";
10
- })(OauthUserType || (exports.OauthUserType = OauthUserType = {}));
11
- var OauthProvider;
12
- (function (OauthProvider) {
13
- OauthProvider["GOOGLE"] = "google";
14
- OauthProvider["NAVER"] = "naver";
15
- OauthProvider["KAKAO"] = "kakao";
16
- })(OauthProvider || (exports.OauthProvider = OauthProvider = {}));
@@ -1,82 +0,0 @@
1
- import { SocketViewerEvent, ViewerSnapshot, ReadingSessionInfo } from './reading-section.types';
2
- /** 모니터링 메타 정보 (S3 meta.json) */
3
- export interface MonitorMeta {
4
- targetSocketId: string;
5
- userType: 'parent' | 'child';
6
- userId: number;
7
- userName: string;
8
- parentIdx?: number;
9
- startedAt: number;
10
- endedAt: number | null;
11
- adminSocketId: string;
12
- chunkCount: number;
13
- }
14
- /** 모니터링 청크 (S3 chunks/N.json) */
15
- export interface MonitorChunk {
16
- chunkIndex: number;
17
- chunkTimestamp: number;
18
- readingSessionId: string | null;
19
- sectionId: string | null;
20
- bookIdx: number | null;
21
- events: SocketViewerEvent[];
22
- snapshot: ViewerSnapshot | null;
23
- /** 청크 생성 주기 (ms) */
24
- delayMs: number;
25
- }
26
- /** 모니터링 시작 요청 */
27
- export interface MonitorStartPayload {
28
- targetSocketId: string;
29
- }
30
- /** 모니터링 중지 요청 */
31
- export interface MonitorStopPayload {
32
- targetSocketId: string;
33
- }
34
- /** 모니터링 시작 응답 */
35
- export interface MonitorStartedPayload {
36
- targetSocketId: string;
37
- startedAt: number;
38
- userInfo: {
39
- userType: 'parent' | 'child';
40
- userId: number;
41
- userName: string;
42
- parentIdx?: number;
43
- };
44
- currentSession: ReadingSessionInfo | null;
45
- }
46
- /** 모니터링 청크 전송 */
47
- export interface MonitorChunkPayload {
48
- targetSocketId: string;
49
- chunk: MonitorChunk;
50
- }
51
- /** 모니터링 대상 세션 변경 알림 */
52
- export interface MonitorSessionChangedPayload {
53
- targetSocketId: string;
54
- session: ReadingSessionInfo | null;
55
- }
56
- /** 모니터링 중지 알림 (대상 연결 해제 등) */
57
- export interface MonitorStoppedPayload {
58
- targetSocketId: string;
59
- reason?: string;
60
- }
61
- /** 모니터링 에러 */
62
- export interface MonitorErrorPayload {
63
- message: string;
64
- }
65
- /** 활성 모니터링 (서버 메모리) */
66
- export interface ActiveMonitor {
67
- targetSocketId: string;
68
- adminSocketId: string;
69
- userType: 'parent' | 'child';
70
- userId: number;
71
- userName: string;
72
- parentIdx?: number;
73
- startedAt: number;
74
- s3Prefix: string;
75
- chunkIndex: number;
76
- eventBuffer: SocketViewerEvent[];
77
- lastSnapshot: ViewerSnapshot | null;
78
- currentReadingSessionId: string | null;
79
- currentSectionId: string | null;
80
- currentBookIdx: number | null;
81
- intervalHandle: ReturnType<typeof setInterval> | null;
82
- }
@@ -1,4 +0,0 @@
1
- "use strict";
2
- // src/socket/monitor.types.ts
3
- // Admin 실시간 모니터링용 타입 정의
4
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,114 +0,0 @@
1
- /** 뷰어 스냅샷 (현재 상태) */
2
- export interface ViewerSnapshot {
3
- viewMode: 'scroll' | 'page';
4
- globalRunIndex: number;
5
- pageIndex?: number;
6
- scrollPosition?: number;
7
- totalItems: number;
8
- }
9
- /** 뷰어 이벤트 */
10
- export interface ViewerEvent {
11
- type: 'page_change' | 'scroll' | 'overlay_toggle' | 'range_select' | 'quiz_answer' | 'gi_change';
12
- timestamp: number;
13
- data: Record<string, unknown>;
14
- }
15
- /** 뷰어 초기 설정 */
16
- export interface ViewerConfig {
17
- fontSize?: number;
18
- lineHeight?: number;
19
- theme?: 'light' | 'dark' | 'sepia';
20
- viewMode?: 'scroll' | 'page';
21
- }
22
- /** 읽기 진행 상황 */
23
- export interface ReadingProgress {
24
- currentPage?: number;
25
- totalPages?: number;
26
- percentage?: number;
27
- }
28
- /** 책/섹션 메타데이터 */
29
- export interface SessionMeta {
30
- bookTitle?: string;
31
- sectionTitle?: string;
32
- sectionOrder?: number;
33
- totalSections?: number;
34
- }
35
- /** 세션 통계 */
36
- export interface SessionStats {
37
- pagesRead?: number;
38
- scrollDistance?: number;
39
- interactionCount?: number;
40
- }
41
- /** 세션 시작 페이로드 */
42
- export interface SessionStartPayload {
43
- bookIdx: number;
44
- sectionId: string;
45
- snapshot: ViewerSnapshot;
46
- viewerConfig?: ViewerConfig;
47
- meta?: SessionMeta;
48
- }
49
- /** 세션 종료 페이로드 */
50
- export interface SessionEndPayload {
51
- durationMs?: number;
52
- finalSnapshot?: ViewerSnapshot;
53
- stats?: SessionStats;
54
- }
55
- /** 진행 상황 업데이트 페이로드 */
56
- export interface SessionProgressPayload {
57
- snapshot: ViewerSnapshot;
58
- progress?: ReadingProgress;
59
- }
60
- /** 이벤트 배치 전송 페이로드 */
61
- export interface SessionEventPayload {
62
- events: ViewerEvent[];
63
- }
64
- /** 세션 구독 페이로드 */
65
- export interface SessionSubscribePayload {
66
- sessionId: string;
67
- }
68
- /** 읽기 세션 정보 (서버 응답) */
69
- export interface ReadingSessionInfo {
70
- sessionId: string;
71
- userId: number;
72
- userType: 'parent' | 'child';
73
- userName?: string;
74
- bookIdx: number;
75
- bookTitle?: string;
76
- sectionId: string;
77
- sectionTitle?: string;
78
- sectionOrder?: number;
79
- totalSections?: number;
80
- startedAt: string;
81
- snapshot: ViewerSnapshot;
82
- viewerConfig?: ViewerConfig;
83
- lastEventAt?: string;
84
- }
85
- /** 세션 시작 응답 */
86
- export interface SessionStartedResponse {
87
- session: ReadingSessionInfo;
88
- }
89
- /** 세션 종료 응답 */
90
- export interface SessionEndedResponse {
91
- sessionId: string;
92
- durationMs?: number;
93
- stats?: SessionStats;
94
- }
95
- /** 세션 진행 상황 응답 */
96
- export interface SessionProgressResponse {
97
- sessionId: string;
98
- snapshot: ViewerSnapshot;
99
- progress?: ReadingProgress;
100
- }
101
- /** 세션 이벤트 응답 */
102
- export interface SessionEventsResponse {
103
- sessionId: string;
104
- events: ViewerEvent[];
105
- }
106
- /** 세션 목록 응답 */
107
- export interface SessionListResponse {
108
- sessions: ReadingSessionInfo[];
109
- }
110
- /** 세션 구독 성공 응답 */
111
- export interface SessionSubscribedResponse {
112
- sessionId: string;
113
- snapshot: ViewerSnapshot;
114
- }
@@ -1,5 +0,0 @@
1
- "use strict";
2
- // src/socket/reading-session.types.ts
3
- // 읽기 세션 모니터링용 데이터 타입 정의
4
- // 이벤트 인터페이스는 socket-clientToServerEvents.type.ts, socket-serverToClientEvents.type.ts 참조
5
- Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,132 +0,0 @@
1
- export type ViewerMode = 'scroll' | 'page';
2
- export type ViewerTheme = 'light' | 'dark' | 'sepia' | 'green';
3
- export type PointerStyle = 'highlight' | 'underline';
4
- /** 뷰어 전체 상태 (CR_viewer store 상태) */
5
- export type CRViewerState = {
6
- mode: ViewerMode;
7
- theme: ViewerTheme;
8
- fontFamily: string;
9
- fontSizePx: number;
10
- lineHeight: number;
11
- marginX: number;
12
- marginY: number;
13
- showOverlays: boolean;
14
- isSettingsOpen: boolean;
15
- pointerStyle: PointerStyle;
16
- pointerColor: string;
17
- breakMarks: {
18
- slash: boolean;
19
- };
20
- breakGapPx: number;
21
- muteAudio: boolean;
22
- audioTargetWpm: number;
23
- audioSpeed: number;
24
- showPointer: boolean;
25
- showSplit: boolean;
26
- viewportWidth: number;
27
- viewportHeight: number;
28
- playbackViewportWidth: number;
29
- playbackViewportHeight: number;
30
- };
31
- /** 뷰어 이벤트 타입 */
32
- 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';
33
- /** 오디오 상태 스냅샷 */
34
- export type AudioSnapshot = {
35
- status: 'idle' | 'loading' | 'playing' | 'paused' | 'ended' | 'error';
36
- currentClip: number;
37
- currentTimeMs: number;
38
- };
39
- /** 녹화용 뷰어 상태 (Partial - 모든 필드가 필수는 아님) */
40
- export type RecordingViewerState = Partial<CRViewerState>;
41
- /** 녹화 시작 시 저장할 초기 스냅샷 */
42
- export type RecordingSnapshot = {
43
- viewerState: RecordingViewerState;
44
- globalIndex: number;
45
- scrollY?: number;
46
- anchorGI?: number;
47
- anchorOffsetRatio?: number;
48
- currentPage?: number;
49
- sectionId: string;
50
- viewportWidth: number;
51
- viewportHeight: number;
52
- audio?: AudioSnapshot;
53
- };
54
- /** 기본 이벤트 (뷰어에서 emit) */
55
- export type ViewerEventBase<T extends ViewerEventType, P = Record<string, unknown>> = {
56
- type: T;
57
- timestamp: number;
58
- payload: P;
59
- };
60
- /** 저장용 이벤트 (외부에서 relTime 추가) */
61
- export type StoredViewerEvent<T extends ViewerEventType, P = Record<string, unknown>> = ViewerEventBase<T, P> & {
62
- relTime: number;
63
- };
64
- /** 오디오 제어 액션 타입 */
65
- export type AudioControlAction = 'play' | 'pause' | 'stop';
66
- export type RecordingStartEvent = ViewerEventBase<'recording_start', {
67
- snapshot: RecordingSnapshot;
68
- }>;
69
- export type RecordingStopEvent = ViewerEventBase<'recording_stop', {
70
- duration: number;
71
- }>;
72
- export type GlobalIndexChangeEvent = ViewerEventBase<'global_index_change', {
73
- globalIndex: number;
74
- }>;
75
- export type ScrollEvent = ViewerEventBase<'scroll', {
76
- scrollTop: number;
77
- scrollRatio: number;
78
- anchorGI: number;
79
- anchorOffsetRatio: number;
80
- }>;
81
- export type PageChangeEvent = ViewerEventBase<'page_change', {
82
- page: number;
83
- }>;
84
- export type SectionChangeEvent = ViewerEventBase<'section_change', {
85
- sectionId: string;
86
- }>;
87
- export type ModeChangeEvent = ViewerEventBase<'mode_change', {
88
- mode: ViewerMode;
89
- }>;
90
- export type SettingsChangeEvent = ViewerEventBase<'settings_change', {
91
- key: keyof CRViewerState;
92
- value: unknown;
93
- }>;
94
- export type ViewerStateSnapshotEvent = ViewerEventBase<'viewer_state_snapshot', {
95
- viewerState: CRViewerState;
96
- }>;
97
- export type RenderStartEvent = ViewerEventBase<'render_start', {
98
- sectionId: string;
99
- }>;
100
- export type LoadingStartEvent = ViewerEventBase<'loading_start', Record<string, never>>;
101
- export type LoadingEndEvent = ViewerEventBase<'loading_end', {
102
- duration: number;
103
- }>;
104
- export type ViewportResizeEvent = ViewerEventBase<'viewport_resize', {
105
- width: number;
106
- height: number;
107
- }>;
108
- export type AudioControlEvent = ViewerEventBase<'audio_control', {
109
- action: AudioControlAction;
110
- }>;
111
- /** 모든 뷰어 이벤트 타입 (Union) */
112
- export type ViewerEvent = RecordingStartEvent | RecordingStopEvent | GlobalIndexChangeEvent | ScrollEvent | PageChangeEvent | SectionChangeEvent | ModeChangeEvent | SettingsChangeEvent | ViewerStateSnapshotEvent | RenderStartEvent | LoadingStartEvent | LoadingEndEvent | ViewportResizeEvent | AudioControlEvent;
113
- export type ViewerEventCallback = (event: ViewerEvent) => void;
114
- /** 저장용 이벤트 (any type) */
115
- export type StoredEvent = StoredViewerEvent<ViewerEventType, unknown>;
116
- /** 녹화 청크 */
117
- export type RecordingChunk = {
118
- index: number;
119
- startTime: number;
120
- endTime: number;
121
- snapshot: RecordingSnapshot;
122
- events: StoredEvent[];
123
- };
124
- /** 녹화 메타데이터 */
125
- export type RecordingMeta = {
126
- id: string;
127
- startedAt: number;
128
- totalDuration: number;
129
- chunkDuration: number;
130
- chunkCount: number;
131
- sectionId: string;
132
- };
@@ -1,5 +0,0 @@
1
- "use strict";
2
- // src/viewer/viewerEvent.types.ts
3
- // CR_viewer 이벤트 및 스냅샷 타입 정의
4
- // 모든 프로젝트(CR_viewer, CR_app, CR_admin, CR_ws)에서 이 타입을 사용
5
- Object.defineProperty(exports, "__esModule", { value: true });