@notion-headless-cms/core 0.1.0 → 0.1.2

package/dist/index.js

@@ -1,3 +1,22 @@
+import {
+  CMSError,
+  isCMSError,
+  isCMSErrorInNamespace
+} from "./chunk-V6ML4QE5.js";
+import {
+  mergeHooks,
+  mergeLoggers
+} from "./chunk-4KGKWKKI.js";
+import {
+  memoryCache,
+  memoryDocumentCache,
+  memoryImageCache
+} from "./chunk-6LHROEPI.js";
+import {
+  noopDocumentCache,
+  noopImageCache
+} from "./chunk-6DG63XUF.js";
+
 // src/cache.ts
 async function sha256Hex(input) {
   const data = new TextEncoder().encode(input);
@@ -9,112 +28,6 @@ function isStale(cachedAt, ttlMs) {
   return Date.now() - cachedAt > ttlMs;
 }
 
-// src/cache/memory.ts
-var MemoryDocumentCache = class {
-  name = "memory-document";
-  list = null;
-  items = /* @__PURE__ */ new Map();
-  getList() {
-    return Promise.resolve(this.list);
-  }
-  setList(data) {
-    this.list = data;
-    return Promise.resolve();
-  }
-  getItem(slug) {
-    return Promise.resolve(this.items.get(slug) ?? null);
-  }
-  setItem(slug, data) {
-    this.items.set(slug, data);
-    return Promise.resolve();
-  }
-  async invalidate(scope) {
-    if (scope === "all") {
-      this.list = null;
-      this.items.clear();
-    } else if ("slug" in scope) {
-      this.items.delete(scope.slug);
-    }
-  }
-};
-var MemoryImageCache = class {
-  name = "memory-image";
-  store = /* @__PURE__ */ new Map();
-  get(hash) {
-    return Promise.resolve(this.store.get(hash) ?? null);
-  }
-  set(hash, data, contentType) {
-    this.store.set(hash, { data, contentType });
-    return Promise.resolve();
-  }
-};
-function memoryDocumentCache() {
-  return new MemoryDocumentCache();
-}
-function memoryImageCache() {
-  return new MemoryImageCache();
-}
-function memoryCache() {
-  return new MemoryDocumentCache();
-}
-
-// src/cache/noop.ts
-var NoopDocumentCache = class {
-  name = "noop-document";
-  getList() {
-    return Promise.resolve(null);
-  }
-  setList(_data) {
-    return Promise.resolve();
-  }
-  getItem(_slug) {
-    return Promise.resolve(null);
-  }
-  setItem(_slug, _data) {
-    return Promise.resolve();
-  }
-  invalidate(_scope) {
-    return Promise.resolve();
-  }
-};
-var NoopImageCache = class {
-  name = "noop-image";
-  get(_hash) {
-    return Promise.resolve(null);
-  }
-  set(_hash, _data, _contentType) {
-    return Promise.resolve();
-  }
-};
-var _noopDocument = new NoopDocumentCache();
-var _noopImage = new NoopImageCache();
-function noopDocumentCache() {
-  return _noopDocument;
-}
-function noopImageCache() {
-  return _noopImage;
-}
-
-// src/cms.ts
-import { renderMarkdown } from "@notion-headless-cms/renderer";
-
-// src/errors.ts
-var CMSError = class extends Error {
-  code;
-  cause;
-  context;
-  constructor(params) {
-    super(params.message, { cause: params.cause });
-    this.name = "CMSError";
-    this.code = params.code;
-    this.cause = params.cause;
-    this.context = params.context;
-  }
-};
-function isCMSError(error) {
-  return error instanceof CMSError;
-}
-
 // src/image.ts
 function inferContentType(url, responseContentType) {
   if (responseContentType?.startsWith("image/")) {
@@ -134,7 +47,17 @@ async function fetchAndCacheImage(cache, notionUrl, imageProxyBase) {
     const response = await fetch(notionUrl, {
       signal: AbortSignal.timeout(1e4)
     });
-    if (!response.ok) return proxyUrl;
+    if (!response.ok) {
+      throw new CMSError({
+        code: "cache/image_fetch_failed",
+        message: `Failed to fetch Notion image: HTTP ${response.status}`,
+        context: {
+          operation: "fetchAndCacheImage",
+          notionUrl,
+          httpStatus: response.status
+        }
+      });
+    }
     const data = await response.arrayBuffer();
     const contentType = inferContentType(
       notionUrl,
@@ -142,8 +65,9 @@ async function fetchAndCacheImage(cache, notionUrl, imageProxyBase) {
     );
     await cache.set(hash, data, contentType);
   } catch (err) {
+    if (isCMSError(err)) throw err;
     throw new CMSError({
-      code: "IMAGE_CACHE_FAILED",
+      code: "cache/io_failed",
       message: "Failed to fetch or cache Notion image.",
       cause: err,
       context: { operation: "fetchAndCacheImage", notionUrl }
@@ -155,23 +79,181 @@ function buildCacheImageFn(cache, imageProxyBase) {
   return (notionUrl) => fetchAndCacheImage(cache, notionUrl, imageProxyBase);
 }
 
+// src/query.ts
+var QueryBuilder = class {
+  source;
+  defaultStatuses;
+  _statuses = [];
+  _tags = [];
+  _predicate;
+  _sortField;
+  _sortDir = "asc";
+  _page = 1;
+  _perPage = 20;
+  constructor(source, defaultStatuses = []) {
+    this.source = source;
+    this.defaultStatuses = defaultStatuses;
+  }
+  status(s) {
+    this._statuses = Array.isArray(s) ? s : [s];
+    return this;
+  }
+  tag(t) {
+    this._tags = Array.isArray(t) ? t : [t];
+    return this;
+  }
+  where(predicate) {
+    this._predicate = predicate;
+    return this;
+  }
+  sortBy(field, dir = "asc") {
+    this._sortField = field;
+    this._sortDir = dir;
+    return this;
+  }
+  paginate(opts) {
+    this._page = opts.page;
+    this._perPage = opts.perPage;
+    return this;
+  }
+  async execute() {
+    const statuses = this._statuses.length > 0 ? this._statuses : this.defaultStatuses.length > 0 ? this.defaultStatuses : void 0;
+    if (this.source.query && !this._predicate) {
+      const result = await this.source.query({
+        filter: {
+          statuses,
+          tags: this._tags.length > 0 ? this._tags : void 0
+        },
+        sort: this._sortField ? [{ property: this._sortField, direction: this._sortDir }] : void 0,
+        pageSize: this._perPage
+      });
+      const items2 = result.items;
+      return {
+        items: items2,
+        total: items2.length,
+        page: this._page,
+        perPage: this._perPage,
+        hasNext: result.hasMore,
+        hasPrev: this._page > 1
+      };
+    }
+    let items = await this.source.list({
+      publishedStatuses: statuses
+    });
+    if (this._tags.length > 0) {
+      items = items.filter((item) => {
+        const itemTags = item.tags;
+        if (!Array.isArray(itemTags)) return false;
+        return this._tags.some((tag) => itemTags.includes(tag));
+      });
+    }
+    if (this._predicate) {
+      items = items.filter(this._predicate);
+    }
+    if (this._sortField) {
+      const field = this._sortField;
+      const dir = this._sortDir;
+      items = [...items].sort((a, b) => {
+        const av = a[field];
+        const bv = b[field];
+        const cmp = av < bv ? -1 : av > bv ? 1 : 0;
+        return dir === "asc" ? cmp : -cmp;
+      });
+    }
+    const total = items.length;
+    const start = (this._page - 1) * this._perPage;
+    const paged = items.slice(start, start + this._perPage);
+    return {
+      items: paged,
+      total,
+      page: this._page,
+      perPage: this._perPage,
+      hasNext: start + this._perPage < total,
+      hasPrev: this._page > 1
+    };
+  }
+  async executeOne() {
+    const result = await this.execute();
+    return result.items[0] ?? null;
+  }
+  /** 前後アイテムを返す。sortBy() で指定したソート順を適用する。 */
+  async adjacent(slug) {
+    const statuses = this._statuses.length > 0 ? this._statuses : this.defaultStatuses.length > 0 ? this.defaultStatuses : void 0;
+    let items = await this.source.list({ publishedStatuses: statuses });
+    if (this._sortField) {
+      const field = this._sortField;
+      const dir = this._sortDir;
+      items = [...items].sort((a, b) => {
+        const av = a[field];
+        const bv = b[field];
+        const cmp = av < bv ? -1 : av > bv ? 1 : 0;
+        return dir === "asc" ? cmp : -cmp;
+      });
+    }
+    const idx = items.findIndex((item) => item.slug === slug);
+    if (idx === -1) return { prev: null, next: null };
+    return {
+      prev: idx > 0 ? items[idx - 1] : null,
+      next: idx < items.length - 1 ? items[idx + 1] : null
+    };
+  }
+  /** 最初の 1 件を返す。`.paginate({ page: 1, perPage: 1 }).executeOne()` の短縮形。 */
+  first() {
+    return this.paginate({ page: 1, perPage: 1 }).executeOne();
+  }
+};
+
+// src/retry.ts
+var DEFAULT_RETRY_CONFIG = {
+  retryOn: [429, 502, 503],
+  maxRetries: 4,
+  baseDelayMs: 1e3,
+  jitter: true
+};
+async function withRetry(fn, config) {
+  let lastError;
+  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      const status = err.status;
+      if (status === void 0 || !config.retryOn.includes(status)) {
+        throw err;
+      }
+      lastError = err;
+      if (attempt < config.maxRetries) {
+        config.onRetry?.(attempt + 1, status);
+        const jitterFactor = config.jitter !== false ? 0.5 + Math.random() * 0.5 : 1;
+        const delay = config.baseDelayMs * 2 ** attempt * jitterFactor;
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+    }
+  }
+  throw lastError;
+}
+
 // src/cms.ts
 var DEFAULT_IMAGE_PROXY_BASE = "/api/images";
-function buildListVersion(items) {
-  return items.map((item) => `${item.id}:${item.updatedAt}`).join("|");
-}
 function resolveDocumentCache(cache) {
-  if (!cache || cache.document === false || cache.document === void 0) {
+  if (!cache || cache === "disabled" || !cache.document) {
     return noopDocumentCache();
   }
   return cache.document;
 }
 function resolveImageCache(cache) {
-  if (!cache || cache.image === false || cache.image === void 0) {
+  if (!cache || cache === "disabled" || !cache.image) {
     return noopImageCache();
   }
   return cache.image;
 }
+function resolveTtl(cache) {
+  if (!cache || cache === "disabled") return void 0;
+  return cache.ttlMs;
+}
+function hasImageCacheConfigured(cache) {
+  if (!cache || cache === "disabled") return false;
+  return !!cache.image;
+}
 var CMS = class {
   source;
   docCache;
@@ -182,100 +264,154 @@ var CMS = class {
   accessibleStatuses;
   imageProxyBase;
   contentConfig;
+  rendererFn;
   waitUntil;
+  hooks;
+  logger;
+  retryConfig;
+  maxConcurrent;
+  cache;
   constructor(opts) {
     this.source = opts.source;
     this.docCache = resolveDocumentCache(opts.cache);
     this.imgCache = resolveImageCache(opts.cache);
-    this.hasImageCache = !!opts.cache?.image;
-    this.ttlMs = opts.cache?.ttlMs;
+    this.hasImageCache = hasImageCacheConfigured(opts.cache);
+    this.ttlMs = resolveTtl(opts.cache);
     this.publishedStatuses = opts.schema?.publishedStatuses ?? (opts.source.publishedStatuses ? [...opts.source.publishedStatuses] : []);
     this.accessibleStatuses = opts.schema?.accessibleStatuses ?? (opts.source.accessibleStatuses ? [...opts.source.accessibleStatuses] : []);
     this.imageProxyBase = opts.content?.imageProxyBase ?? DEFAULT_IMAGE_PROXY_BASE;
     this.contentConfig = opts.content;
+    this.rendererFn = opts.renderer;
     this.waitUntil = opts.waitUntil;
+    this.logger = mergeLoggers(opts.plugins ?? [], opts.logger);
+    this.hooks = mergeHooks(opts.plugins ?? [], opts.hooks, this.logger);
+    this.maxConcurrent = opts.rateLimiter?.maxConcurrent ?? 3;
+    this.retryConfig = {
+      ...DEFAULT_RETRY_CONFIG,
+      ...opts.rateLimiter ?? {}
+    };
+    this.cache = {
+      getList: this.cachedList.bind(this),
+      get: this.cachedGet.bind(this),
+      prefetchAll: this.prefetchAll.bind(this),
+      revalidate: this.revalidate.bind(this),
+      sync: this.syncFromWebhook.bind(this),
+      checkList: this.checkListUpdate.bind(this),
+      checkItem: this.checkItemUpdate.bind(this)
+    };
   }
   // ── コンテンツ取得 ──────────────────────────────────────────────────────
   /** 公開済みコンテンツ一覧をソースから直接取得する。 */
   list() {
-    return this.source.list({
-      publishedStatuses: this.publishedStatuses.length > 0 ? this.publishedStatuses : void 0
-    });
+    return withRetry(
+      () => this.source.list({
+        publishedStatuses: this.publishedStatuses.length > 0 ? this.publishedStatuses : void 0
+      }),
+      {
+        ...this.retryConfig,
+        onRetry: (attempt, status) => {
+          this.logger?.warn?.("list() \u30EA\u30C8\u30E9\u30A4\u4E2D", { attempt, status });
+        }
+      }
+    );
   }
   /** スラッグでコンテンツをソースから直接取得する。 */
-  async findBySlug(slug) {
-    const item = await this.source.findBySlug(slug);
+  async find(slug) {
+    const item = await withRetry(() => this.source.findBySlug(slug), {
+      ...this.retryConfig,
+      onRetry: (attempt, status) => {
+        this.logger?.warn?.("find() \u30EA\u30C8\u30E9\u30A4\u4E2D", { attempt, status, slug });
+      }
+    });
     if (!item) return null;
-    if (this.accessibleStatuses.length > 0 && !this.accessibleStatuses.includes(item.status)) {
+    if (this.accessibleStatuses.length > 0 && (!item.status || !this.accessibleStatuses.includes(item.status))) {
       return null;
     }
     return item;
   }
+  /** 複数スラッグをまとめてソースから直接取得する。accessibleStatuses フィルタを適用する。 */
+  async findMany(slugs) {
+    const results = /* @__PURE__ */ new Map();
+    await Promise.all(
+      slugs.map(async (slug) => {
+        const item = await this.find(slug);
+        if (item) results.set(slug, item);
+      })
+    );
+    return results;
+  }
   /** アイテムが publishedStatuses に含まれるステータスかどうかを返す。 */
   isPublished(item) {
     if (this.publishedStatuses.length === 0) return true;
-    return this.publishedStatuses.includes(item.status);
+    return !!item.status && this.publishedStatuses.includes(item.status);
   }
-  /** コンテンツを Markdown → HTML にレンダリングし、CachedItem として返す。 */
+  /** コンテンツを Markdown → HTML にレンダリングし、CachedItem として返す。キャッシュには保存しない。 */
   async render(item) {
     return this.buildCachedItem(item);
   }
-  /** スラッグでコンテンツを取得して Markdown → HTML にレンダリングする。 */
-  async renderBySlug(slug) {
-    try {
-      const item = await this.findBySlug(slug);
-      if (!item) return null;
-      return this.buildCachedItem(item);
-    } catch (err) {
-      if (isCMSError(err)) throw err;
-      throw new CMSError({
-        code: "NOTION_FETCH_ITEM_BY_SLUG_FAILED",
-        message: "Failed to fetch item by slug from Notion data source.",
-        cause: err,
-        context: { operation: "renderBySlug", slug }
-      });
-    }
-  }
-  // ── 便利 API ───────────────────────────────────────────────────────────
-  /** ステータスでフィルタリングした一覧を返す。 */
-  async listByStatus(status) {
-    const statuses = Array.isArray(status) ? status : [status];
-    const all = await this.source.list();
-    return all.filter((item) => statuses.includes(item.status));
+  /** QueryBuilder を返す。ステータス・タグ・ページネーションなどを連鎖で指定できる。 */
+  query() {
+    return new QueryBuilder(this.source, this.publishedStatuses);
   }
-  /** 任意の条件でフィルタリングした一覧を返す。 */
-  async where(predicate) {
+  /** 静的生成用のスラッグ一覧を返す。 */
+  async getStaticSlugs() {
     const items = await this.list();
-    return items.filter(predicate);
-  }
-  /** ページネーション付き一覧を返す。 */
-  async paginate(opts) {
-    const all = await this.list();
-    const total = all.length;
-    const start = (opts.page - 1) * opts.perPage;
-    const items = all.slice(start, start + opts.perPage);
-    return {
-      items,
-      total,
-      page: opts.page,
-      perPage: opts.perPage,
-      hasNext: start + opts.perPage < total
-    };
+    return items.map((item) => item.slug);
+  }
+  // ── 画像配信 ──────────────────────────────────────────────────────────
+  /** ハッシュキーでキャッシュ画像を取得する。 */
+  getCachedImage(hash) {
+    return this.imgCache.get(hash);
+  }
+  /** ハッシュキーでキャッシュ画像を Response として返す。 */
+  async createCachedImageResponse(hash) {
+    const object = await this.imgCache.get(hash);
+    if (!object) return null;
+    const headers = new Headers();
+    if (object.contentType) headers.set("content-type", object.contentType);
+    headers.set("cache-control", "public, max-age=31536000, immutable");
+    return new Response(object.data, { headers });
   }
-  /** 指定スラッグの前後コンテンツを返す。 */
-  async getAdjacent(slug) {
+  // ── キャッシュ優先取得（Stale-While-Revalidate） ─────────────────────
+  async cachedList() {
+    const cached = await this.docCache.getList();
+    if (cached && !isStale(cached.cachedAt, this.ttlMs)) {
+      this.hooks.onListCacheHit?.(cached.items, cached.cachedAt);
+      return { items: cached.items, isStale: false, cachedAt: cached.cachedAt };
+    }
+    this.hooks.onListCacheMiss?.();
     const items = await this.list();
-    const idx = items.findIndex((item) => item.slug === slug);
-    if (idx === -1) return { prev: null, next: null };
-    return {
-      prev: idx > 0 ? items[idx - 1] : null,
-      next: idx < items.length - 1 ? items[idx + 1] : null
-    };
+    const cachedAt = Date.now();
+    const save = this.docCache.setList({ items, cachedAt });
+    if (this.waitUntil) {
+      this.waitUntil(save);
+    } else {
+      await save;
+    }
+    return { items, isStale: !!cached, cachedAt };
   }
-  /** 全コンテンツを事前レンダリングしてキャッシュに保存する。 */
+  async cachedGet(slug) {
+    const cached = await this.docCache.getItem(slug);
+    if (cached && !isStale(cached.cachedAt, this.ttlMs)) {
+      this.hooks.onCacheHit?.(slug, cached);
+      return cached;
+    }
+    this.hooks.onCacheMiss?.(slug);
+    const item = await this.find(slug);
+    if (!item) return null;
+    const entry = await this.buildCachedItem(item);
+    const save = this.docCache.setItem(slug, entry);
+    if (this.waitUntil) {
+      this.waitUntil(save);
+    } else {
+      await save;
+    }
+    return entry;
+  }
+  // ── キャッシュ管理 ────────────────────────────────────────────────────
   async prefetchAll(opts) {
     const items = await this.list();
-    const concurrency = opts?.concurrency ?? 3;
+    const concurrency = opts?.concurrency ?? this.maxConcurrent;
     let ok = 0;
     let failed = 0;
     for (let i = 0; i < items.length; i += concurrency) {
@@ -286,8 +422,16 @@ var CMS = class {
             const rendered = await this.buildCachedItem(item);
             await this.docCache.setItem(item.slug, rendered);
             ok++;
-          } catch {
+          } catch (err) {
             failed++;
+            this.logger?.warn?.(
+              "prefetchAll: \u30A2\u30A4\u30C6\u30E0\u306E\u4E8B\u524D\u30EC\u30F3\u30C0\u30EA\u30F3\u30B0\u306B\u5931\u6557",
+              {
+                slug: item.slug,
+                pageId: item.id,
+                error: err instanceof Error ? err.message : String(err)
+              }
+            );
           }
         })
       );
@@ -296,21 +440,14 @@ var CMS = class {
     await this.docCache.setList({ items, cachedAt: Date.now() });
     return { ok, failed };
   }
-  /** 静的生成用のスラッグ一覧を返す。 */
-  async getStaticSlugs() {
-    const items = await this.list();
-    return items.map((item) => item.slug);
-  }
-  /** 指定スコープのキャッシュを無効化する。 */
   async revalidate(scope) {
     if (!this.docCache.invalidate) return;
     await this.docCache.invalidate(scope ?? "all");
   }
-  /** Webhook ペイロードを元にキャッシュを同期する。 */
   async syncFromWebhook(payload) {
     const updated = [];
     if (payload?.slug) {
-      const item = await this.findBySlug(payload.slug);
+      const item = await this.find(payload.slug);
       if (item) {
         const rendered = await this.buildCachedItem(item);
         await this.docCache.setItem(item.slug, rendered);
@@ -325,39 +462,6 @@ var CMS = class {
     }
     return { updated };
   }
-  // ── キャッシュ優先取得（Stale-While-Revalidate） ─────────────────────
-  /** キャッシュ優先でコンテンツ一覧を返す（SWR）。 */
-  async getList() {
-    const cached = await this.docCache.getList();
-    if (cached && !isStale(cached.cachedAt, this.ttlMs)) {
-      return {
-        items: cached.items,
-        listVersion: buildListVersion(cached.items)
-      };
-    }
-    const items = await this.list();
-    const save = this.docCache.setList({ items, cachedAt: Date.now() });
-    if (this.waitUntil) {
-      this.waitUntil(save);
-    } else {
-      await save;
-    }
-    return { items, listVersion: buildListVersion(items) };
-  }
-  /** キャッシュ優先で単一コンテンツを返す（SWR）。 */
-  async getItem(slug) {
-    const cached = await this.docCache.getItem(slug);
-    if (cached && !isStale(cached.cachedAt, this.ttlMs)) return cached;
-    const entry = await this.renderBySlug(slug);
-    if (!entry) return null;
-    const save = this.docCache.setItem(slug, entry);
-    if (this.waitUntil) {
-      this.waitUntil(save);
-    } else {
-      await save;
-    }
-    return entry;
-  }
   async checkListUpdate(version) {
     const items = await this.list();
     const serverVersion = buildListVersion(items);
@@ -366,12 +470,11 @@ var CMS = class {
     return { changed: true, items };
   }
   async checkItemUpdate(slug, lastEdited) {
-    const item = await this.findBySlug(slug);
+    const item = await this.find(slug);
     if (!item) return { changed: false };
     if (!this.isPublished(item)) return { changed: false };
     if (item.updatedAt === lastEdited) return { changed: false };
-    const entry = await this.renderBySlug(slug);
-    if (!entry) return { changed: false };
+    const entry = await this.buildCachedItem(item);
     await this.docCache.setItem(slug, entry);
     return {
       changed: true,
@@ -380,29 +483,21 @@ var CMS = class {
       notionUpdatedAt: entry.notionUpdatedAt
     };
   }
-  // ── 画像配信 ───────────────────────────────────────────────────────────
-  /** ハッシュキーでキャッシュ画像を取得する。 */
-  getCachedImage(hash) {
-    return this.imgCache.get(hash);
-  }
-  /** ハッシュキーでキャッシュ画像を Response として返す。 */
-  async createCachedImageResponse(hash) {
-    const object = await this.imgCache.get(hash);
-    if (!object) return null;
-    const headers = new Headers();
-    if (object.contentType) headers.set("content-type", object.contentType);
-    headers.set("cache-control", "public, max-age=31536000, immutable");
-    return new Response(object.data, { headers });
-  }
   // ── プライベートヘルパー ────────────────────────────────────────────────
   async buildCachedItem(item) {
+    const start = Date.now();
+    this.logger?.info?.("\u30B3\u30F3\u30C6\u30F3\u30C4\u306E\u30EC\u30F3\u30C0\u30EA\u30F3\u30B0\u958B\u59CB", {
+      slug: item.slug,
+      pageId: item.id
+    });
+    this.hooks.onRenderStart?.(item.slug);
     let markdown;
     try {
       markdown = await this.source.loadMarkdown(item);
     } catch (err) {
       if (isCMSError(err)) throw err;
       throw new CMSError({
-        code: "NOTION_MARKDOWN_FETCH_FAILED",
+        code: "source/load_markdown_failed",
         message: "Failed to load markdown from source.",
         cause: err,
         context: {
@@ -414,18 +509,18 @@ var CMS = class {
     }
     const cacheImage = this.hasImageCache ? buildCacheImageFn(this.imgCache, this.imageProxyBase) : void 0;
     let html;
+    const rendererFn = this.rendererFn ?? await loadDefaultRenderer();
     try {
-      html = await renderMarkdown(markdown, {
+      html = await rendererFn(markdown, {
         imageProxyBase: this.imageProxyBase,
         cacheImage,
         remarkPlugins: this.contentConfig?.remarkPlugins,
-        rehypePlugins: this.contentConfig?.rehypePlugins,
-        render: this.contentConfig?.render
+        rehypePlugins: this.contentConfig?.rehypePlugins
       });
     } catch (err) {
       if (isCMSError(err)) throw err;
       throw new CMSError({
-        code: "RENDERER_FAILED",
+        code: "renderer/failed",
         message: "Failed to render markdown.",
         cause: err,
         context: {
@@ -435,67 +530,69 @@ var CMS = class {
         }
       });
     }
-    return {
+    if (this.hooks.afterRender) {
+      html = await this.hooks.afterRender(html, item);
+    }
+    let result = {
       html,
       item,
       notionUpdatedAt: item.updatedAt,
       cachedAt: Date.now()
     };
+    if (this.hooks.beforeCache) {
+      result = await this.hooks.beforeCache(result);
+    }
+    const durationMs = Date.now() - start;
+    this.logger?.info?.("\u30B3\u30F3\u30C6\u30F3\u30C4\u306E\u30EC\u30F3\u30C0\u30EA\u30F3\u30B0\u5B8C\u4E86", {
+      slug: item.slug,
+      durationMs
+    });
+    this.hooks.onRenderEnd?.(item.slug, durationMs);
+    return result;
   }
 };
+async function loadDefaultRenderer() {
+  try {
+    const mod = await import("@notion-headless-cms/renderer");
+    return mod.renderMarkdown;
+  } catch (err) {
+    throw new CMSError({
+      code: "renderer/failed",
+      message: "renderer \u30AA\u30D7\u30B7\u30E7\u30F3\u304C\u672A\u6307\u5B9A\u3067 @notion-headless-cms/renderer \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002 createCMS({ renderer }) \u3067\u30EC\u30F3\u30C0\u30E9\u30FC\u3092\u6CE8\u5165\u3059\u308B\u304B\u3001@notion-headless-cms/renderer \u3092\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+      cause: err,
+      context: { operation: "loadDefaultRenderer" }
+    });
+  }
+}
+function buildListVersion(items) {
+  return items.map((item) => `${item.id}:${item.updatedAt}`).join("|");
+}
 function createCMS(opts) {
   return new CMS(opts);
 }
 
-// src/mapper.ts
-import { z } from "zod";
-var baseContentItemSchema = z.object({
-  id: z.string().min(1),
-  slug: z.string(),
-  status: z.string(),
-  publishedAt: z.string().min(1),
-  updatedAt: z.string().min(1)
-});
-function getPlainText(items) {
-  return items?.map((item) => item.plain_text).join("") ?? "";
-}
-function mapItem(page, props) {
-  const statusProperty = page.properties[props.status];
-  const dateProperty = page.properties[props.date];
-  const parsed = baseContentItemSchema.safeParse({
-    id: page.id,
-    slug: getPlainText(
-      page.properties[props.slug]?.rich_text
-    ),
-    status: statusProperty?.status?.name ?? statusProperty?.select?.name ?? "",
-    publishedAt: dateProperty?.date?.start ?? page.created_time,
-    updatedAt: page.last_edited_time
-  });
-  if (!parsed.success) {
-    throw new CMSError({
-      code: "NOTION_ITEM_SCHEMA_INVALID",
-      message: "Failed to parse Notion page into BaseContentItem.",
-      context: {
-        operation: "mapItem",
-        pageId: page.id,
-        issues: JSON.stringify(parsed.error.issues)
-      }
-    });
-  }
-  return parsed.data;
+// src/types/plugin.ts
+function definePlugin(plugin) {
+  return plugin;
 }
 export {
   CMS,
   CMSError,
+  DEFAULT_RETRY_CONFIG,
+  QueryBuilder,
   createCMS,
-  getPlainText,
+  definePlugin,
   isCMSError,
+  isCMSErrorInNamespace,
   isStale,
-  mapItem,
   memoryCache,
   memoryDocumentCache,
   memoryImageCache,
+  mergeHooks,
+  mergeLoggers,
   noopDocumentCache,
   noopImageCache,
-  sha256Hex
+  sha256Hex,
+  withRetry
 };
+//# sourceMappingURL=index.js.map