@readerseye2/cr_type 1.0.92 → 1.0.93

package/dist/ast/ast.types.d.ts

@@ -1,3 +1,4 @@
+import type { AudioMeta } from '../book/book-sections.type';
 export type SectionId = string;
 export type InlineRun = {
     text: string;
@@ -43,15 +44,11 @@ export interface AudioMark {
     end: number;
     value: string;
 }
-export interface AudioClipMeta {
-    provider: string;
-    TTS_engine: string;
-    language: string;
-    speaker: string;
+/** 개별 오디오 클립 메타 (AudioMeta 확장 + 결과 데이터) */
+export type AudioClipMeta = AudioMeta & {
     durationMs: number;
     wordCount: number;
-    wpm: number;
-}
+};
 type SectionAudioBase = {
     chunkIndex: number;
     marks?: AudioMark[];
@@ -89,7 +86,7 @@ export type SectionQuiz = {
     qid: string;
     kind: 'saved';
     index: number;
-    cdnUrl: string;
+    image_cdn_url: string;
     question: string;
     options: string[];
     answers: string[];
@@ -99,7 +96,7 @@ export type SectionQuiz = {
     qid: string;
     kind: 'temp';
     index: number;
-    blobUrl: string;
+    image_blob_url: string;
     question: string;
     options: string[];
     answers: string[];
@@ -109,114 +106,12 @@ export type SectionQuiz = {
 export type SectionAST = {
     title: string;
     blocks: Block[];
-    isAddedSplit?: boolean;
-    isAddedAudio?: boolean;
 };
 export type SectionData = {
     section_id: SectionId;
     ast: SectionAST;
     images?: SectionImage[];
     audios?: SectionAudio[];
-    quiz?: SectionQuiz[];
-};
-/** 드래프트 책 메타 정보 (cr.erd.json CR.draft_book 테이블 기준)
- * - user_idx는 백엔드 세션에서 확인하므로 프론트에서 전송하지 않음
- * - isdeleted는 백엔드 내부용이므로 프론트에 노출하지 않음
- */
-export interface DraftMeta {
-    /** PK */
-    draft_book_idx: number;
-    /** 책 제목 (default: 'untitled') */
-    draft_book_title: string;
-    /** 언어 코드 */
-    draft_book_language: 'ko' | 'en';
-    /** 난이도 레벨 (권장 연령, default: 5) */
-    draft_book_level: number;
-    /** 표지 이미지 URL (nullable) */
-    draft_book_cover_url: string | null;
-    /** 책 길이 (short/medium/long) */
-    draft_book_length: string | null;
-    /** 책 종류/장르 (fiction/non-fiction/other) */
-    draft_book_genre: string | null;
-    /** 영어레벨 (영어책 전용) */
-    draft_book_en_level: string | null;
-    /** 시리즈명 */
-    draft_book_series: string | null;
-    /** 원작자 */
-    draft_book_author: string | null;
-    /** 태그 배열 */
-    draft_book_tags: string[] | null;
-    /** 설명 */
-    draft_book_description: string | null;
-    /** 원출판일 (YYYY-MM-DD) */
-    draft_book_original_publish_date: string | null;
-    /** 원출판사 */
-    draft_book_original_publisher: string | null;
-    /** ISBN */
-    draft_book_isbn: string | null;
-    /** 총 어절 수 (자동 계산) */
-    draft_book_word_count: number | null;
-    /** AR 지수 (0.0 ~ 12.0, 소수점 1자리) */
-    draft_book_ar_index: number | null;
-    /** Lexile 지수 (0 ~ 2000, 정수) */
-    draft_book_lexile_index: number | null;
-    /** QUIZ 다시풀기 허용 여부 */
-    draft_book_quiz_retry_allowed: boolean;
-    /** 생성일 (ISO) */
-    draft_book_create_date: string;
-    /** 수정일 (ISO) */
-    draft_book_update_date: string;
-    /** 출판 상태 */
-    draft_book_publish_status?: 'draft' | 'pending' | 'rejected';
-}
-import { SectionSummary } from '../book/book.type';
-export type DraftSummary = {
-    sectionOrder: SectionId[];
-    sections?: SectionSummary[];
+    quizzes?: SectionQuiz[];
 };
-export type BookDraftDTO = {
-    meta: DraftMeta;
-    summary: DraftSummary;
-    content: SectionData[];
-};
-export type SectionMap = Record<SectionId, SectionData>;
-export type RuntimeTemp = {
-    /** 오디오 blobUrl (런타임 전용): sectionId -> clipIndex -> blobUrl */
-    audioBlobUrlBySection: Record<SectionId, Record<number, string>>;
-    /** 이미지 blobUrl (런타임 전용): sectionId -> imageIndex -> blobUrl */
-    imageBlobUrlBySection: Record<SectionId, Record<number, string>>;
-};
-export type SaveStatus = 'unsaved' | 'saving' | 'saved' | 'error';
-export type SectionSaveState = {
-    status: SaveStatus;
-    savedAt?: string;
-    errorMessage?: string;
-};
-export type DraftSaveState = {
-    /** 메타 저장 상태 */
-    meta: SaveStatus;
-    /** 섹션 순서 저장 상태 */
-    order: SaveStatus;
-    /** 섹션별 저장 상태 */
-    sections: Record<SectionId, SectionSaveState>;
-    /** 저장 진행률 */
-    progress?: {
-        current: number;
-        total: number;
-        jobId?: string;
-    };
-};
-export interface MakeBookState {
-    meta: DraftMeta | null;
-    /** 정규화된 섹션 맵 */
-    sectionsById: SectionMap;
-    /** 섹션 순서(목차) */
-    sectionOrder: SectionId[];
-    /** 리스트 캐시(선택) */
-    sectionSummaries?: SectionSummary[];
-    /** 런타임 전용(blobUrl 등) */
-    temp: RuntimeTemp;
-    /** 저장 상태 (클라이언트 전용) */
-    saveState: DraftSaveState;
-}
 export {};

package/dist/book/book-api.type.d.ts

@@ -0,0 +1,15 @@
+import type { Book, SectionSummary } from './book.type';
+import type { SectionData } from '../ast/ast.types';
+/** 책 목록 조회용 (간략) */
+export type BookListItem = Pick<Book, 'book_idx' | 'creator_idx' | 'status' | 'book_title' | 'book_language' | 'book_level' | 'book_cover_url' | 'genre' | 'word_count' | 'section_count' | 'created_at' | 'updated_at'> & {
+    creator_name?: string;
+};
+/** 책 상세 응답 (메타 + 요약 + 콘텐츠) */
+export type BookDTO = {
+    meta: Book;
+    summary: {
+        sectionOrder: string[];
+        sections: SectionSummary[];
+    };
+    content: SectionData[];
+};

package/dist/book/book-api.type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/book/book-log.type.d.ts

@@ -0,0 +1,14 @@
+/** book_log.action ENUM */
+export type BookLogAction = 'request' | 'approve' | 'reject' | 'cancel' | 'suspend' | 'unsuspend';
+/** book_log.acted_by_type ENUM */
+export type BookLogActorType = 'admin' | 'creator';
+/** MySQL book_log 테이블 1:1 */
+export interface BookLog {
+    book_log_idx: number;
+    book_idx: number;
+    action: BookLogAction;
+    acted_by_type: BookLogActorType;
+    acted_by_idx: number;
+    reason: string | null;
+    created_at: string;
+}

package/dist/book/book-log.type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/book/book-sections.type.d.ts

@@ -0,0 +1,34 @@
+/** TTS 설정 (섹션 레벨) */
+export type AudioMeta = {
+    provider: 'AWS' | 'GCP';
+    language: string;
+    engine: string;
+    voiceName: string;
+    voiceGender?: 'Male' | 'Female';
+};
+/** 섹션 요약 (snake_case — MongoDB/API 공용) */
+export interface SectionSummary {
+    section_id: string;
+    title: string;
+    order: number;
+    audio_count: number;
+    image_count: number;
+    quiz_count: number;
+    word_count: number;
+    sound_minutes?: number;
+    is_added_split?: boolean;
+    is_added_audio?: boolean;
+    is_added_quiz?: boolean;
+    updated_at?: string;
+    ast_cdn_url?: string;
+    audio_meta?: AudioMeta;
+}
+/** MongoDB book_sections 문서 1:1 */
+export interface BookSectionsDoc {
+    book_idx: number;
+    section_order: string[];
+    sections: SectionSummary[];
+    free_section_ids: string[] | null;
+    created_at: string;
+    updated_at: string;
+}

package/dist/book/book-sections.type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/book/book.const.d.ts

@@ -0,0 +1,274 @@
+/** 언어 */
+export type BookLanguage = 'ko' | 'en';
+/** 길이 */
+export type BookLength = 'short' | 'medium' | 'long';
+/** 종류 */
+export type BookGenre = 'fiction' | 'non-fiction' | 'other';
+/** 영어레벨 (영어책 전용) */
+export type BookEnLevel = 'story' | 'readers' | 'early-chapter' | 'middle-chapter' | 'chapter' | 'novel';
+/** 출판 연령등급 */
+export type PublishAgeRating = 'all' | '12' | '15' | '19';
+/** 책 상태 (라이프사이클) */
+export type BookStatus = 'draft' | 'pending' | 'published' | 'suspended';
+export declare const BookLanguageLabel: {
+    readonly ko: "한국어";
+    readonly en: "English";
+};
+export declare const BookLengthLabel: {
+    readonly short: "단편";
+    readonly medium: "중편";
+    readonly long: "장편";
+};
+export declare const BookGenreLabel: {
+    readonly fiction: "문학";
+    readonly 'non-fiction': "비문학";
+    readonly other: "기타";
+};
+export declare const BookEnLevelLabel: {
+    readonly story: "스토리";
+    readonly readers: "리더스";
+    readonly 'early-chapter': "얼리챕터";
+    readonly 'middle-chapter': "미들챕터";
+    readonly chapter: "챕터";
+    readonly novel: "노블";
+};
+export declare const PublishAgeRatingLabel: {
+    readonly all: "전체이용가";
+    readonly '12': "12세 이용가";
+    readonly '15': "15세 이용가";
+    readonly '19': "19세 이용가";
+};
+/** 권장 연령 범위 (5~19세) */
+export declare const BOOK_AGE_MIN = 5;
+export declare const BOOK_AGE_MAX = 19;
+/** 새 책 생성 시 기본값 */
+export declare const DEFAULT_BOOK_META: {
+    readonly title: "나의 책";
+    readonly language: BookLanguage;
+    readonly age: 5;
+    readonly length: BookLength;
+    readonly genre: BookGenre;
+    readonly quiz_retry_allowed: true;
+    readonly ar_index: 3;
+    readonly lexile_index: 600;
+};
+/** AR 지수 범위별 설명 (소수점 1자리 기준) */
+export declare const AR_INDEX_RANGES: readonly [{
+    readonly min: 0;
+    readonly max: 1.9;
+    readonly level: "유아 ~ 초1";
+    readonly description: "그림책, 아주 짧은 문장";
+}, {
+    readonly min: 2;
+    readonly max: 2.9;
+    readonly level: "초2";
+    readonly description: "기초 리더북";
+}, {
+    readonly min: 3;
+    readonly max: 3.9;
+    readonly level: "초3";
+    readonly description: "챕터북 시작";
+}, {
+    readonly min: 4;
+    readonly max: 4.9;
+    readonly level: "초4";
+    readonly description: "본격적인 이야기 구조";
+}, {
+    readonly min: 5;
+    readonly max: 5.9;
+    readonly level: "초5";
+    readonly description: "어휘·문장 길이 증가";
+}, {
+    readonly min: 6;
+    readonly max: 6.9;
+    readonly level: "초6";
+    readonly description: "논픽션 비중 증가";
+}, {
+    readonly min: 7;
+    readonly max: 8.9;
+    readonly level: "중학생";
+    readonly description: "복합 문장, 추론 필요";
+}, {
+    readonly min: 9;
+    readonly max: 10.9;
+    readonly level: "고등학생";
+    readonly description: "문학 작품, 추상 개념";
+}, {
+    readonly min: 11;
+    readonly max: 12;
+    readonly level: "고급";
+    readonly description: "성인 소설·고전";
+}];
+/** Lexile 지수 범위별 설명 */
+export declare const LEXILE_INDEX_RANGES: readonly [{
+    readonly min: 0;
+    readonly max: 200;
+    readonly level: "유아";
+    readonly description: "알파벳·기초 단어";
+}, {
+    readonly min: 200;
+    readonly max: 400;
+    readonly level: "초1";
+    readonly description: "아주 쉬운 문장";
+}, {
+    readonly min: 400;
+    readonly max: 600;
+    readonly level: "초2";
+    readonly description: "간단한 스토리";
+}, {
+    readonly min: 600;
+    readonly max: 800;
+    readonly level: "초3";
+    readonly description: "챕터북";
+}, {
+    readonly min: 800;
+    readonly max: 1000;
+    readonly level: "초4";
+    readonly description: "정보량 증가";
+}, {
+    readonly min: 1000;
+    readonly max: 1200;
+    readonly level: "초5~6";
+    readonly description: "교과서 수준";
+}, {
+    readonly min: 1200;
+    readonly max: 1400;
+    readonly level: "중학생";
+    readonly description: "추론·비판적 읽기";
+}, {
+    readonly min: 1400;
+    readonly max: 1600;
+    readonly level: "고등학생";
+    readonly description: "문학·비문학 혼합";
+}, {
+    readonly min: 1600;
+    readonly max: 2000;
+    readonly level: "성인";
+    readonly description: "학술·고전 문학";
+}];
+/** AR 지수로 해당 범위 설명 조회 */
+export declare const getARDescription: (ar: number) => {
+    readonly min: 0;
+    readonly max: 1.9;
+    readonly level: "유아 ~ 초1";
+    readonly description: "그림책, 아주 짧은 문장";
+} | {
+    readonly min: 2;
+    readonly max: 2.9;
+    readonly level: "초2";
+    readonly description: "기초 리더북";
+} | {
+    readonly min: 3;
+    readonly max: 3.9;
+    readonly level: "초3";
+    readonly description: "챕터북 시작";
+} | {
+    readonly min: 4;
+    readonly max: 4.9;
+    readonly level: "초4";
+    readonly description: "본격적인 이야기 구조";
+} | {
+    readonly min: 5;
+    readonly max: 5.9;
+    readonly level: "초5";
+    readonly description: "어휘·문장 길이 증가";
+} | {
+    readonly min: 6;
+    readonly max: 6.9;
+    readonly level: "초6";
+    readonly description: "논픽션 비중 증가";
+} | {
+    readonly min: 7;
+    readonly max: 8.9;
+    readonly level: "중학생";
+    readonly description: "복합 문장, 추론 필요";
+} | {
+    readonly min: 9;
+    readonly max: 10.9;
+    readonly level: "고등학생";
+    readonly description: "문학 작품, 추상 개념";
+} | {
+    readonly min: 11;
+    readonly max: 12;
+    readonly level: "고급";
+    readonly description: "성인 소설·고전";
+} | undefined;
+/** Lexile 지수로 해당 범위 설명 조회 */
+export declare const getLexileDescription: (lexile: number) => {
+    readonly min: 0;
+    readonly max: 200;
+    readonly level: "유아";
+    readonly description: "알파벳·기초 단어";
+} | {
+    readonly min: 200;
+    readonly max: 400;
+    readonly level: "초1";
+    readonly description: "아주 쉬운 문장";
+} | {
+    readonly min: 400;
+    readonly max: 600;
+    readonly level: "초2";
+    readonly description: "간단한 스토리";
+} | {
+    readonly min: 600;
+    readonly max: 800;
+    readonly level: "초3";
+    readonly description: "챕터북";
+} | {
+    readonly min: 800;
+    readonly max: 1000;
+    readonly level: "초4";
+    readonly description: "정보량 증가";
+} | {
+    readonly min: 1000;
+    readonly max: 1200;
+    readonly level: "초5~6";
+    readonly description: "교과서 수준";
+} | {
+    readonly min: 1200;
+    readonly max: 1400;
+    readonly level: "중학생";
+    readonly description: "추론·비판적 읽기";
+} | {
+    readonly min: 1400;
+    readonly max: 1600;
+    readonly level: "고등학생";
+    readonly description: "문학·비문학 혼합";
+} | {
+    readonly min: 1600;
+    readonly max: 2000;
+    readonly level: "성인";
+    readonly description: "학술·고전 문학";
+} | undefined;
+/** 어절 수 → 재생 분수 계산 (200 WPM 기준) */
+export declare const calcSoundMinutes: (wordCount: number) => number;
+/** 언어 옵션 (UI Select용) */
+export declare const getLanguageOptions: () => {
+    value: BookLanguage;
+    label: "한국어" | "English";
+}[];
+/** 길이 옵션 (UI Select용) */
+export declare const getLengthOptions: () => {
+    value: BookLength;
+    label: "단편" | "중편" | "장편";
+}[];
+/** 장르 옵션 (UI Select용) */
+export declare const getGenreOptions: () => {
+    value: BookGenre;
+    label: "문학" | "비문학" | "기타";
+}[];
+/** 영어레벨 옵션 (UI Select용) */
+export declare const getEnLevelOptions: () => {
+    value: BookEnLevel;
+    label: "스토리" | "리더스" | "얼리챕터" | "미들챕터" | "챕터" | "노블";
+}[];
+/** 출판 연령등급 옵션 (UI Select용) */
+export declare const getAgeRatingOptions: () => {
+    value: PublishAgeRating;
+    label: "전체이용가" | "12세 이용가" | "15세 이용가" | "19세 이용가";
+}[];
+/** 권장 연령 옵션 (5~19세) */
+export declare const getAgeOptions: () => {
+    value: number;
+    label: string;
+}[];

package/dist/book/book.const.js

@@ -0,0 +1,119 @@
+"use strict";
+// ========== 리터럴 유니온 타입 ==========
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAgeOptions = exports.getAgeRatingOptions = exports.getEnLevelOptions = exports.getGenreOptions = exports.getLengthOptions = exports.getLanguageOptions = exports.calcSoundMinutes = exports.getLexileDescription = exports.getARDescription = exports.LEXILE_INDEX_RANGES = exports.AR_INDEX_RANGES = exports.DEFAULT_BOOK_META = exports.BOOK_AGE_MAX = exports.BOOK_AGE_MIN = exports.PublishAgeRatingLabel = exports.BookEnLevelLabel = exports.BookGenreLabel = exports.BookLengthLabel = exports.BookLanguageLabel = void 0;
+// ========== 라벨 (UI 표시용) ==========
+exports.BookLanguageLabel = {
+    ko: '한국어',
+    en: 'English',
+};
+exports.BookLengthLabel = {
+    short: '단편',
+    medium: '중편',
+    long: '장편',
+};
+exports.BookGenreLabel = {
+    fiction: '문학',
+    'non-fiction': '비문학',
+    other: '기타',
+};
+exports.BookEnLevelLabel = {
+    story: '스토리',
+    readers: '리더스',
+    'early-chapter': '얼리챕터',
+    'middle-chapter': '미들챕터',
+    chapter: '챕터',
+    novel: '노블',
+};
+exports.PublishAgeRatingLabel = {
+    all: '전체이용가',
+    '12': '12세 이용가',
+    '15': '15세 이용가',
+    '19': '19세 이용가',
+};
+// ========== 상수 ==========
+/** 권장 연령 범위 (5~19세) */
+exports.BOOK_AGE_MIN = 5;
+exports.BOOK_AGE_MAX = 19;
+/** 새 책 생성 시 기본값 */
+exports.DEFAULT_BOOK_META = {
+    title: '나의 책',
+    language: 'en',
+    age: 5,
+    length: 'short',
+    genre: 'fiction',
+    quiz_retry_allowed: true,
+    ar_index: 3.0,
+    lexile_index: 600,
+};
+// ========== AR / Lexile 지수 ==========
+/** AR 지수 범위별 설명 (소수점 1자리 기준) */
+exports.AR_INDEX_RANGES = [
+    { min: 0.0, max: 1.9, level: '유아 ~ 초1', description: '그림책, 아주 짧은 문장' },
+    { min: 2.0, max: 2.9, level: '초2', description: '기초 리더북' },
+    { min: 3.0, max: 3.9, level: '초3', description: '챕터북 시작' },
+    { min: 4.0, max: 4.9, level: '초4', description: '본격적인 이야기 구조' },
+    { min: 5.0, max: 5.9, level: '초5', description: '어휘·문장 길이 증가' },
+    { min: 6.0, max: 6.9, level: '초6', description: '논픽션 비중 증가' },
+    { min: 7.0, max: 8.9, level: '중학생', description: '복합 문장, 추론 필요' },
+    { min: 9.0, max: 10.9, level: '고등학생', description: '문학 작품, 추상 개념' },
+    { min: 11.0, max: 12.0, level: '고급', description: '성인 소설·고전' },
+];
+/** Lexile 지수 범위별 설명 */
+exports.LEXILE_INDEX_RANGES = [
+    { min: 0, max: 200, level: '유아', description: '알파벳·기초 단어' },
+    { min: 200, max: 400, level: '초1', description: '아주 쉬운 문장' },
+    { min: 400, max: 600, level: '초2', description: '간단한 스토리' },
+    { min: 600, max: 800, level: '초3', description: '챕터북' },
+    { min: 800, max: 1000, level: '초4', description: '정보량 증가' },
+    { min: 1000, max: 1200, level: '초5~6', description: '교과서 수준' },
+    { min: 1200, max: 1400, level: '중학생', description: '추론·비판적 읽기' },
+    { min: 1400, max: 1600, level: '고등학생', description: '문학·비문학 혼합' },
+    { min: 1600, max: 2000, level: '성인', description: '학술·고전 문학' },
+];
+/** AR 지수로 해당 범위 설명 조회 */
+const getARDescription = (ar) => exports.AR_INDEX_RANGES.find(r => ar >= r.min && ar <= r.max);
+exports.getARDescription = getARDescription;
+/** Lexile 지수로 해당 범위 설명 조회 */
+const getLexileDescription = (lexile) => exports.LEXILE_INDEX_RANGES.find(r => lexile >= r.min && lexile <= r.max);
+exports.getLexileDescription = getLexileDescription;
+// ========== 헬퍼 함수 ==========
+/** 어절 수 → 재생 분수 계산 (200 WPM 기준) */
+const calcSoundMinutes = (wordCount) => Math.ceil(wordCount / 200);
+exports.calcSoundMinutes = calcSoundMinutes;
+/** 언어 옵션 (UI Select용) */
+const getLanguageOptions = () => Object.entries(exports.BookLanguageLabel).map(([value, label]) => ({
+    value: value,
+    label,
+}));
+exports.getLanguageOptions = getLanguageOptions;
+/** 길이 옵션 (UI Select용) */
+const getLengthOptions = () => Object.entries(exports.BookLengthLabel).map(([value, label]) => ({
+    value: value,
+    label,
+}));
+exports.getLengthOptions = getLengthOptions;
+/** 장르 옵션 (UI Select용) */
+const getGenreOptions = () => Object.entries(exports.BookGenreLabel).map(([value, label]) => ({
+    value: value,
+    label,
+}));
+exports.getGenreOptions = getGenreOptions;
+/** 영어레벨 옵션 (UI Select용) */
+const getEnLevelOptions = () => Object.entries(exports.BookEnLevelLabel).map(([value, label]) => ({
+    value: value,
+    label,
+}));
+exports.getEnLevelOptions = getEnLevelOptions;
+/** 출판 연령등급 옵션 (UI Select용) */
+const getAgeRatingOptions = () => Object.entries(exports.PublishAgeRatingLabel).map(([value, label]) => ({
+    value: value,
+    label,
+}));
+exports.getAgeRatingOptions = getAgeRatingOptions;
+/** 권장 연령 옵션 (5~19세) */
+const getAgeOptions = () => Array.from({ length: exports.BOOK_AGE_MAX - exports.BOOK_AGE_MIN + 1 }, (_, i) => ({
+    value: exports.BOOK_AGE_MIN + i,
+    label: `만 ${exports.BOOK_AGE_MIN + i}세`,
+}));
+exports.getAgeOptions = getAgeOptions;