@mandujs/core 0.53.3 → 0.54.0

package/src/content/loaders/types.ts

@@ -1,137 +1,137 @@
-/**
- * Loader Types - 로더 공통 인터페이스
- *
- * 모든 로더가 구현해야 하는 인터페이스와 유틸리티 타입
- */
-
-import type { ZodSchema } from "zod";
-import type { LoaderContext, RenderedContent } from "../types";
-
-/**
- * 로더 인터페이스
- */
-export interface Loader {
-  /** 로더 이름 (디버깅용) */
-  name: string;
-  /** 콘텐츠 로드 함수 */
-  load: (context: LoaderContext) => Promise<void>;
-  /** 기본 스키마 (컬렉션 설정보다 우선순위 낮음) */
-  schema?: ZodSchema | (() => ZodSchema | Promise<ZodSchema>);
-}
-
-/**
- * File Loader 옵션
- */
-export interface FileLoaderOptions {
-  /** 파일 경로 (프로젝트 루트 기준) */
-  path: string;
-  /** 파서 타입 (자동 감지됨) */
-  parser?: "json" | "yaml" | "toml";
-}
-
-/**
- * Glob Loader 옵션
- */
-export interface GlobLoaderOptions {
-  /** Glob 패턴 */
-  pattern: string | string[];
-  /** 기본 디렉토리 */
-  base?: string;
-  /** ID 생성 함수 */
-  generateId?: (params: { filePath: string; base: string }) => string;
-}
-
-/**
- * API Loader 옵션
- */
-export interface ApiLoaderOptions {
-  /** API URL */
-  url: string | (() => string | Promise<string>);
-  /** HTTP 메서드 */
-  method?: "GET" | "POST";
-  /** 요청 헤더 */
-  headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
-  /** 요청 바디 (POST) */
-  body?: unknown | (() => unknown | Promise<unknown>);
-  /** 응답 변환 */
-  transform?: (response: unknown) => unknown[] | Promise<unknown[]>;
-  /** 캐시 TTL (초) */
-  cacheTTL?: number;
-  /** 페이지네이션 설정 */
-  pagination?: PaginationConfig;
-}
-
-/**
- * 페이지네이션 설정
- */
-export interface PaginationConfig {
-  /** 다음 페이지 URL 추출 */
-  getNextUrl?: (response: unknown, currentUrl: string) => string | null;
-  /** 총 페이지 수 추출 */
-  getTotalPages?: (response: unknown) => number;
-  /** 페이지 크기 */
-  pageSize?: number;
-}
-
-/**
- * Markdown 프론트매터 파싱 결과
- */
-export interface ParsedMarkdown {
-  /** 프론트매터 데이터 */
-  data: Record<string, unknown>;
-  /** Markdown 본문 */
-  body: string;
-  /** 원본 프론트매터 문자열 */
-  rawFrontmatter?: string;
-}
-
-/**
- * 로더 결과 엔트리 (store.set 전)
- */
-export interface LoaderEntry<T = Record<string, unknown>> {
-  /** 고유 ID */
-  id: string;
-  /** 데이터 */
-  data: T;
-  /** 파일 경로 (파일 기반) */
-  filePath?: string;
-  /** 본문 (Markdown 등) */
-  body?: string;
-  /** 다이제스트 */
-  digest?: string;
-  /** 렌더링된 콘텐츠 */
-  rendered?: RenderedContent;
-}
-
-/**
- * 로더 팩토리 함수 타입
- */
-export type LoaderFactory<TOptions> = (options: TOptions) => Loader;
-
-/**
- * 지원 파일 확장자별 파서
- */
-export const FILE_PARSERS = {
-  ".json": "json",
-  ".yaml": "yaml",
-  ".yml": "yaml",
-  ".toml": "toml",
-} as const;
-
-/**
- * Markdown 파일 확장자
- */
-export const MARKDOWN_EXTENSIONS = new Set([".md", ".mdx", ".markdown"]);
-
-/**
- * 파일 확장자로 파서 타입 추론
- */
-export function inferParser(filePath: string): "json" | "yaml" | "toml" | "markdown" | null {
-  const ext = filePath.toLowerCase().slice(filePath.lastIndexOf("."));
-
-  if (MARKDOWN_EXTENSIONS.has(ext)) {
-    return "markdown";
-  }
-
-  return FILE_PARSERS[ext as keyof typeof FILE_PARSERS] ?? null;
-}
+/**
+ * Loader Types - 로더 공통 인터페이스
+ *
+ * 모든 로더가 구현해야 하는 인터페이스와 유틸리티 타입
+ */
+
+import type { ZodSchema } from "zod";
+import type { LoaderContext, RenderedContent } from "../types";
+
+/**
+ * 로더 인터페이스
+ */
+export interface Loader {
+  /** 로더 이름 (디버깅용) */
+  name: string;
+  /** 콘텐츠 로드 함수 */
+  load: (context: LoaderContext) => Promise<void>;
+  /** 기본 스키마 (컬렉션 설정보다 우선순위 낮음) */
+  schema?: ZodSchema | (() => ZodSchema | Promise<ZodSchema>);
+}
+
+/**
+ * File Loader 옵션
+ */
+export interface FileLoaderOptions {
+  /** 파일 경로 (프로젝트 루트 기준) */
+  path: string;
+  /** 파서 타입 (자동 감지됨) */
+  parser?: "json" | "yaml" | "toml";
+}
+
+/**
+ * Glob Loader 옵션
+ */
+export interface GlobLoaderOptions {
+  /** Glob 패턴 */
+  pattern: string | string[];
+  /** 기본 디렉토리 */
+  base?: string;
+  /** ID 생성 함수 */
+  generateId?: (params: { filePath: string; base: string }) => string;
+}
+
+/**
+ * API Loader 옵션
+ */
+export interface ApiLoaderOptions {
+  /** API URL */
+  url: string | (() => string | Promise<string>);
+  /** HTTP 메서드 */
+  method?: "GET" | "POST";
+  /** 요청 헤더 */
+  headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+  /** 요청 바디 (POST) */
+  body?: unknown | (() => unknown | Promise<unknown>);
+  /** 응답 변환 */
+  transform?: (response: unknown) => unknown[] | Promise<unknown[]>;
+  /** 캐시 TTL (초) */
+  cacheTTL?: number;
+  /** 페이지네이션 설정 */
+  pagination?: PaginationConfig;
+}
+
+/**
+ * 페이지네이션 설정
+ */
+export interface PaginationConfig {
+  /** 다음 페이지 URL 추출 */
+  getNextUrl?: (response: unknown, currentUrl: string) => string | null;
+  /** 총 페이지 수 추출 */
+  getTotalPages?: (response: unknown) => number;
+  /** 페이지 크기 */
+  pageSize?: number;
+}
+
+/**
+ * Markdown 프론트매터 파싱 결과
+ */
+export interface ParsedMarkdown {
+  /** 프론트매터 데이터 */
+  data: Record<string, unknown>;
+  /** Markdown 본문 */
+  body: string;
+  /** 원본 프론트매터 문자열 */
+  rawFrontmatter?: string;
+}
+
+/**
+ * 로더 결과 엔트리 (store.set 전)
+ */
+export interface LoaderEntry<T = Record<string, unknown>> {
+  /** 고유 ID */
+  id: string;
+  /** 데이터 */
+  data: T;
+  /** 파일 경로 (파일 기반) */
+  filePath?: string;
+  /** 본문 (Markdown 등) */
+  body?: string;
+  /** 다이제스트 */
+  digest?: string;
+  /** 렌더링된 콘텐츠 */
+  rendered?: RenderedContent;
+}
+
+/**
+ * 로더 팩토리 함수 타입
+ */
+export type LoaderFactory<TOptions> = (options: TOptions) => Loader;
+
+/**
+ * 지원 파일 확장자별 파서
+ */
+export const FILE_PARSERS = {
+  ".json": "json",
+  ".yaml": "yaml",
+  ".yml": "yaml",
+  ".toml": "toml",
+} as const;
+
+/**
+ * Markdown 파일 확장자
+ */
+export const MARKDOWN_EXTENSIONS = new Set([".md", ".mdx", ".markdown"]);
+
+/**
+ * 파일 확장자로 파서 타입 추론
+ */
+export function inferParser(filePath: string): "json" | "yaml" | "toml" | "markdown" | null {
+  const ext = filePath.toLowerCase().slice(filePath.lastIndexOf("."));
+
+  if (MARKDOWN_EXTENSIONS.has(ext)) {
+    return "markdown";
+  }
+
+  return FILE_PARSERS[ext as keyof typeof FILE_PARSERS] ?? null;
+}

package/src/content/meta-store.ts

@@ -1,209 +1,209 @@
-/**
- * MetaStore - 동기화 메타데이터 저장소
- *
- * API 동기화 토큰, 마지막 수정 시간, 커서 등
- * 로더가 증분 업데이트를 수행하는 데 필요한 메타데이터 저장
- */
-
-import type { MetaStore } from "./types";
-import * as fs from "fs";
-import * as path from "path";
-
-/**
- * MetaStore 옵션
- */
-export interface MetaStoreOptions {
-  /** 영속화 파일 경로 */
-  filePath?: string;
-  /** 자동 저장 활성화 */
-  autoSave?: boolean;
-}
-
-/**
- * 직렬화된 메타 스토어 형식
- */
-interface SerializedMetaStore {
-  version: number;
-  collections: Record<string, Record<string, string>>;
-  timestamp: string;
-}
-
-const META_VERSION = 1;
-
-/**
- * 콘텐츠 메타 저장소 구현
- */
-export class ContentMetaStore {
-  private collections: Map<string, Map<string, string>> = new Map();
-  private options: MetaStoreOptions;
-  private dirty: boolean = false;
-
-  constructor(options: MetaStoreOptions = {}) {
-    this.options = {
-      autoSave: true,
-      ...options,
-    };
-  }
-
-  /**
-   * 컬렉션용 MetaStore 인터페이스 생성
-   */
-  getStore(collection: string): MetaStore {
-    if (!this.collections.has(collection)) {
-      this.collections.set(collection, new Map());
-    }
-
-    const store = this.collections.get(collection)!;
-
-    return {
-      get: (key: string) => store.get(key),
-
-      set: (key: string, value: string) => {
-        store.set(key, value);
-        this.dirty = true;
-        this.autoSave();
-      },
-
-      has: (key: string) => store.has(key),
-
-      delete: (key: string) => {
-        if (store.has(key)) {
-          store.delete(key);
-          this.dirty = true;
-          this.autoSave();
-        }
-      },
-
-      clear: () => {
-        if (store.size > 0) {
-          store.clear();
-          this.dirty = true;
-          this.autoSave();
-        }
-      },
-
-      entries: () => Array.from(store.entries()),
-    };
-  }
-
-  /**
-   * 컬렉션 삭제
-   */
-  deleteCollection(collection: string): void {
-    if (this.collections.has(collection)) {
-      this.collections.delete(collection);
-      this.dirty = true;
-      this.autoSave();
-    }
-  }
-
-  /**
-   * 자동 저장
-   */
-  private autoSave(): void {
-    if (this.options.autoSave && this.options.filePath) {
-      void this.save();
-    }
-  }
-
-  /**
-   * 파일에서 로드
-   */
-  async load(): Promise<void> {
-    if (!this.options.filePath) return;
-
-    try {
-      if (!fs.existsSync(this.options.filePath)) {
-        return;
-      }
-
-      const content = fs.readFileSync(this.options.filePath, "utf-8");
-      const data: SerializedMetaStore = JSON.parse(content);
-
-      if (data.version !== META_VERSION) {
-        console.warn(
-          `[MetaStore] Version mismatch (${data.version} vs ${META_VERSION}), starting fresh`
-        );
-        return;
-      }
-
-      for (const [collection, entries] of Object.entries(data.collections)) {
-        const store = new Map<string, string>();
-        for (const [key, value] of Object.entries(entries)) {
-          store.set(key, value);
-        }
-        this.collections.set(collection, store);
-      }
-
-      this.dirty = false;
-    } catch (error) {
-      console.warn(
-        `[MetaStore] Failed to load:`,
-        error instanceof Error ? error.message : error
-      );
-    }
-  }
-
-  /**
-   * 파일에 저장
-   */
-  async save(): Promise<void> {
-    if (!this.options.filePath || !this.dirty) return;
-
-    try {
-      const dir = path.dirname(this.options.filePath);
-      if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-      }
-
-      const data: SerializedMetaStore = {
-        version: META_VERSION,
-        collections: {},
-        timestamp: new Date().toISOString(),
-      };
-
-      for (const [collection, store] of this.collections) {
-        data.collections[collection] = Object.fromEntries(store);
-      }
-
-      fs.writeFileSync(this.options.filePath, JSON.stringify(data, null, 2));
-      this.dirty = false;
-    } catch (error) {
-      console.error(
-        `[MetaStore] Failed to save:`,
-        error instanceof Error ? error.message : error
-      );
-    }
-  }
-
-  /**
-   * 전체 스토어 초기화
-   */
-  clear(): void {
-    this.collections.clear();
-    this.dirty = true;
-    this.autoSave();
-  }
-
-  /**
-   * 스토어 통계
-   */
-  getStats(): { collections: number; totalKeys: number } {
-    let totalKeys = 0;
-    for (const store of this.collections.values()) {
-      totalKeys += store.size;
-    }
-
-    return {
-      collections: this.collections.size,
-      totalKeys,
-    };
-  }
-}
-
-/**
- * MetaStore 팩토리
- */
-export function createMetaStore(options?: MetaStoreOptions): ContentMetaStore {
-  return new ContentMetaStore(options);
-}
+/**
+ * MetaStore - 동기화 메타데이터 저장소
+ *
+ * API 동기화 토큰, 마지막 수정 시간, 커서 등
+ * 로더가 증분 업데이트를 수행하는 데 필요한 메타데이터 저장
+ */
+
+import type { MetaStore } from "./types";
+import * as fs from "fs";
+import * as path from "path";
+
+/**
+ * MetaStore 옵션
+ */
+export interface MetaStoreOptions {
+  /** 영속화 파일 경로 */
+  filePath?: string;
+  /** 자동 저장 활성화 */
+  autoSave?: boolean;
+}
+
+/**
+ * 직렬화된 메타 스토어 형식
+ */
+interface SerializedMetaStore {
+  version: number;
+  collections: Record<string, Record<string, string>>;
+  timestamp: string;
+}
+
+const META_VERSION = 1;
+
+/**
+ * 콘텐츠 메타 저장소 구현
+ */
+export class ContentMetaStore {
+  private collections: Map<string, Map<string, string>> = new Map();
+  private options: MetaStoreOptions;
+  private dirty: boolean = false;
+
+  constructor(options: MetaStoreOptions = {}) {
+    this.options = {
+      autoSave: true,
+      ...options,
+    };
+  }
+
+  /**
+   * 컬렉션용 MetaStore 인터페이스 생성
+   */
+  getStore(collection: string): MetaStore {
+    if (!this.collections.has(collection)) {
+      this.collections.set(collection, new Map());
+    }
+
+    const store = this.collections.get(collection)!;
+
+    return {
+      get: (key: string) => store.get(key),
+
+      set: (key: string, value: string) => {
+        store.set(key, value);
+        this.dirty = true;
+        this.autoSave();
+      },
+
+      has: (key: string) => store.has(key),
+
+      delete: (key: string) => {
+        if (store.has(key)) {
+          store.delete(key);
+          this.dirty = true;
+          this.autoSave();
+        }
+      },
+
+      clear: () => {
+        if (store.size > 0) {
+          store.clear();
+          this.dirty = true;
+          this.autoSave();
+        }
+      },
+
+      entries: () => Array.from(store.entries()),
+    };
+  }
+
+  /**
+   * 컬렉션 삭제
+   */
+  deleteCollection(collection: string): void {
+    if (this.collections.has(collection)) {
+      this.collections.delete(collection);
+      this.dirty = true;
+      this.autoSave();
+    }
+  }
+
+  /**
+   * 자동 저장
+   */
+  private autoSave(): void {
+    if (this.options.autoSave && this.options.filePath) {
+      void this.save();
+    }
+  }
+
+  /**
+   * 파일에서 로드
+   */
+  async load(): Promise<void> {
+    if (!this.options.filePath) return;
+
+    try {
+      if (!fs.existsSync(this.options.filePath)) {
+        return;
+      }
+
+      const content = fs.readFileSync(this.options.filePath, "utf-8");
+      const data: SerializedMetaStore = JSON.parse(content);
+
+      if (data.version !== META_VERSION) {
+        console.warn(
+          `[MetaStore] Version mismatch (${data.version} vs ${META_VERSION}), starting fresh`
+        );
+        return;
+      }
+
+      for (const [collection, entries] of Object.entries(data.collections)) {
+        const store = new Map<string, string>();
+        for (const [key, value] of Object.entries(entries)) {
+          store.set(key, value);
+        }
+        this.collections.set(collection, store);
+      }
+
+      this.dirty = false;
+    } catch (error) {
+      console.warn(
+        `[MetaStore] Failed to load:`,
+        error instanceof Error ? error.message : error
+      );
+    }
+  }
+
+  /**
+   * 파일에 저장
+   */
+  async save(): Promise<void> {
+    if (!this.options.filePath || !this.dirty) return;
+
+    try {
+      const dir = path.dirname(this.options.filePath);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+
+      const data: SerializedMetaStore = {
+        version: META_VERSION,
+        collections: {},
+        timestamp: new Date().toISOString(),
+      };
+
+      for (const [collection, store] of this.collections) {
+        data.collections[collection] = Object.fromEntries(store);
+      }
+
+      fs.writeFileSync(this.options.filePath, JSON.stringify(data, null, 2));
+      this.dirty = false;
+    } catch (error) {
+      console.error(
+        `[MetaStore] Failed to save:`,
+        error instanceof Error ? error.message : error
+      );
+    }
+  }
+
+  /**
+   * 전체 스토어 초기화
+   */
+  clear(): void {
+    this.collections.clear();
+    this.dirty = true;
+    this.autoSave();
+  }
+
+  /**
+   * 스토어 통계
+   */
+  getStats(): { collections: number; totalKeys: number } {
+    let totalKeys = 0;
+    for (const store of this.collections.values()) {
+      totalKeys += store.size;
+    }
+
+    return {
+      collections: this.collections.size,
+      totalKeys,
+    };
+  }
+}
+
+/**
+ * MetaStore 팩토리
+ */
+export function createMetaStore(options?: MetaStoreOptions): ContentMetaStore {
+  return new ContentMetaStore(options);
+}