@notion-headless-cms/core 0.1.1 → 0.1.3

package/README.md

@@ -1,6 +1,6 @@
 # @notion-headless-cms/core
 
-CMS エンジン本体。Notion からのコンテンツ取得・変換・キャッシュを統合管理する。
+CMS エンジン本体。データソース・キャッシュ・レンダラーを統合し、Stale-While-Revalidate / 更新検知 / クエリビルダー / フック / リトライを提供する。**外部ランタイム依存ゼロ**。
 
 ## インストール
 
@@ -8,98 +8,196 @@ CMS エンジン本体。Notion からのコンテンツ取得・変換・キャ
 npm install @notion-headless-cms/core
 ```
 
-Cloudflare Workers で使う場合は [`@notion-headless-cms/adapter-cloudflare`](../adapter-cloudflare) の利用を推奨する。
+`core` 自体は外部ランタイム依存ゼロ。`@notion-headless-cms/renderer` は `peerDependenciesMeta.optional: true` のため、renderer を `createCMS({ renderer })` で明示注入するか、動的フォールバック（`import("@notion-headless-cms/renderer")`）を使う場合のみインストールが必要。
 
-## 使い方
+Cloudflare Workers / Node.js / Next.js などで使う場合は、それぞれのアダプタを使うのが最短ルート:
 
-```typescript
-import { CMS } from "@notion-headless-cms/core";
+- [`@notion-headless-cms/adapter-cloudflare`](../adapter-cloudflare)
+- [`@notion-headless-cms/adapter-node`](../adapter-node)
+- [`@notion-headless-cms/adapter-next`](../adapter-next)
 
-const cms = new CMS({
-  env: {
-    NOTION_TOKEN: process.env.NOTION_TOKEN!,
-    NOTION_DATA_SOURCE_ID: process.env.NOTION_DATA_SOURCE_ID!,
-  },
+### サブパスエクスポート
+
+一部の機能はサブパス経由でインポートでき、バレル経由より小さくバンドルできる。
+
+```ts
+import { CMSError } from "@notion-headless-cms/core/errors";
+import { mergeHooks } from "@notion-headless-cms/core/hooks";
+import { memoryDocumentCache } from "@notion-headless-cms/core/cache/memory";
+```
+
+| サブパス | 内容 |
+|---|---|
+| `@notion-headless-cms/core` | 全エクスポート |
+| `@notion-headless-cms/core/errors` | `CMSError` / `isCMSError` / `isCMSErrorInNamespace` |
+| `@notion-headless-cms/core/hooks` | `mergeHooks` / `mergeLoggers` |
+| `@notion-headless-cms/core/cache/memory` | `memoryDocumentCache` / `memoryImageCache` / `*Options` |
+| `@notion-headless-cms/core/cache/noop` | `noopDocumentCache` / `noopImageCache` |
+
+## 使い方（core を直接使う場合）
+
+```typescript
+import { createCMS, memoryDocumentCache, memoryImageCache } from "@notion-headless-cms/core";
+import { notionAdapter } from "@notion-headless-cms/source-notion";
+import { renderMarkdown } from "@notion-headless-cms/renderer";
+
+const cms = createCMS({
+  source: notionAdapter({
+    token: process.env.NOTION_TOKEN!,
+    dataSourceId: process.env.NOTION_DATA_SOURCE_ID!,
+  }),
+  renderer: renderMarkdown,
   schema: {
     publishedStatuses: ["公開"],
     properties: { slug: "Slug" },
   },
-  cache: { ttlMs: 5 * 60 * 1000 },
+  cache: {
+    document: memoryDocumentCache({ maxItems: 500 }),
+    image: memoryImageCache({ maxItems: 200, maxSizeBytes: 64 * 1024 * 1024 }),
+    ttlMs: 5 * 60 * 1000,
+  },
 });
 
-// コンテンツ一覧を取得
-const { items } = await cms.getItems();
+// ソース直接
+const items = await cms.list();
+const item = await cms.find("my-post");
+const rendered = item ? await cms.render(item) : null;
 
-// スラッグで個別コンテンツを取得（HTML 付き）
-const cached = await cms.getItemBySlug("my-post");
+// SWR
+const { items: cachedItems } = await cms.cache.getList();
+const cached = await cms.cache.get("my-post");
 console.log(cached?.html);
 ```
 
+### `CacheConfig`
+
+```ts
+type CacheConfig<T> =
+  | "disabled"                                   // 完全無効化
+  | {
+      document?: DocumentCacheAdapter<T>;        // 未指定なら noop
+      image?: ImageCacheAdapter;                 // 未指定なら noop
+      ttlMs?: number;                            // 未指定は TTL なし
+    };
+```
+
 ### カスタムコンテンツ型
 
 `BaseContentItem` を拡張することで任意のプロパティを追加できる。
 
 ```typescript
-import type { BaseContentItem, CMSConfig } from "@notion-headless-cms/core";
-import type { PageObjectResponse } from "@notionhq/client/build/src/api-endpoints";
+import type { BaseContentItem } from "@notion-headless-cms/core";
+import { createCMS } from "@notion-headless-cms/core";
+import { notionAdapter } from "@notion-headless-cms/source-notion";
 
 interface MyPost extends BaseContentItem {
   title: string;
   category: string;
 }
 
-const config: CMSConfig<MyPost> = {
-  env: {
-    NOTION_TOKEN: process.env.NOTION_TOKEN!,
-    NOTION_DATA_SOURCE_ID: process.env.NOTION_DATA_SOURCE_ID!,
-  },
-  schema: {
-    mapItem: (page: PageObjectResponse): MyPost => ({
+const cms = createCMS<MyPost>({
+  source: notionAdapter<MyPost>({
+    token: process.env.NOTION_TOKEN!,
+    dataSourceId: process.env.NOTION_DATA_SOURCE_ID!,
+    mapItem: (page) => ({
       id: page.id,
       slug: /* ... */ "",
-      status: /* ... */ "",
-      publishedAt: page.created_time,
       updatedAt: page.last_edited_time,
+      publishedAt: page.created_time,
       title: /* ... */ "",
       category: /* ... */ "",
     }),
-  },
-};
+  }),
+});
 ```
 
+> 型安全なマッピングは [`defineSchema`](../source-notion) を推奨。
+
 ## 主要 API
 
-### `CMS` クラス
+### `CMS<T>` / `createCMS<T>(options)`
 
 | メソッド | 説明 |
 |---|---|
-| `getItems()` | コンテンツ一覧を返す |
-| `getItemBySlug(slug)` | スラッグで個別コンテンツを返す |
-| `renderItem(item)` | アイテムをレンダリングして `CachedItem` を返す |
-| `renderItemBySlug(slug)` | スラッグで取得してレンダリングする |
-| `getItemsCachedFirst(options?)` | キャッシュ優先でコンテンツ一覧を返す（SWR） |
-| `getItemCachedFirst(slug, options?)` | キャッシュ優先で個別コンテンツを返す（SWR） |
-| `checkItemsUpdate(clientVersion)` | 一覧の更新有無を確認する |
-| `checkItemUpdate(slug, lastEdited)` | 個別コンテンツの更新有無を確認する |
+| `list()` | ソースから一覧取得 |
+| `find(slug)` | ソースから単一アイテム取得 |
+| `findMany(slugs[])` | 複数スラッグを並列取得（`Map<string, T>` を返す） |
+| `render(item)` | Markdown → HTML にレンダリング |
+| `isPublished(item)` | `publishedStatuses` 判定 |
+| `cache.getList()` | SWR で一覧取得 |
+| `cache.get(slug)` | SWR で単一アイテム取得 |
+| `cache.prefetchAll(opts?)` | 全アイテムを事前レンダリング |
+| `cache.revalidate(scope?)` | キャッシュ無効化 |
+| `cache.sync(payload?)` | Webhook 由来のキャッシュ同期 |
+| `cache.checkList(version)` | 一覧差分検知 |
+| `cache.checkItem(slug, lastEdited)` | 個別差分検知 |
+| `query()` | QueryBuilder を返す |
+| `getStaticSlugs()` | 静的生成用スラッグ一覧 |
+| `getCachedImage(hash)` | キャッシュ画像を取得 |
+| `createCachedImageResponse(hash)` | キャッシュ画像の Response を生成 |
+
+詳細は [CMS メソッド一覧](../../docs/api/cms-methods.md) を参照。
 
 ### ユーティリティ
 
 | エクスポート | 説明 |
 |---|---|
-| `CacheStore` | JSON/バイナリストレージの抽象ラッパー |
+| `memoryDocumentCache<T>({ maxItems? })` | インメモリ DocumentCacheAdapter。`maxItems` 指定時は LRU 方式で古いものから削除 |
+| `memoryImageCache({ maxItems?, maxSizeBytes? })` | インメモリ ImageCacheAdapter。件数とバイト数の両方で上限を設定可 |
+| `noopDocumentCache<T>()` / `noopImageCache()` | 何もしないアダプタ |
 | `isStale(cachedAt, ttlMs)` | TTL 切れ判定 |
-| `sha256Hex(data)` | SHA256 ハッシュ生成（画像キー生成に使用） |
-| `CMSError` | カスタムエラークラス |
+| `sha256Hex(data)` | SHA256 ハッシュ生成 |
+| `CMSError` / `isCMSError` / `isCMSErrorInNamespace` | エラークラスと判定ヘルパー |
+| `QueryBuilder` | クエリ組み立て（`cms.query()` が返す） |
+| `withRetry` / `DEFAULT_RETRY_CONFIG` | リトライ付き実行 |
+| `mergeHooks` / `mergeLoggers` | プラグイン・直接指定のフック／ロガーを統合 |
+| `definePlugin` | プラグイン（hooks / logger）の型付き定義 |
+
+### ライフサイクルフック
+
+`createCMS({ hooks })` に指定する。観測フック（`onCache*` / `onRender*`）は例外を投げても他のフックに波及せず、`logger.error` に流される。
+
+| フック | 呼び出しタイミング |
+|---|---|
+| `beforeCache(item)` | キャッシュ書き込み直前（結果差し替え可） |
+| `afterRender(html, item)` | HTML 生成直後（差し替え可） |
+| `onCacheHit(slug, item)` / `onCacheMiss(slug)` | アイテム SWR のヒット・ミス |
+| `onListCacheHit(items, cachedAt)` / `onListCacheMiss()` | 一覧 SWR のヒット・ミス |
+| `onRenderStart(slug)` / `onRenderEnd(slug, durationMs)` | レンダリング所要時間の観測 |
+| `onError(error)` | 内部エラー通知 |
 
 ## 主要な型
 
-- `CMSConfig<T>` — CMS 設定オブジェクト（`env` フィールドで認証情報を渡す）
-- `BaseContentItem` — デフォルト・カスタム型の基底インターフェース
-- `CachedItem<T>` — キャッシュ済みコンテンツ（HTML + メタデータ）
-- `StorageAdapter` — ストレージ抽象インターフェース
-- `CMSEnv` — 必須環境変数の型
+- `CreateCMSOptions<T>` — `createCMS()` の引数
+- `BaseContentItem` — デフォルト・カスタム型の基底（`status` / `publishedAt` はオプション）
+- `CachedItem<T>` / `CachedItemList<T>` — キャッシュ済みコンテンツ
+- `CacheAccessor<T>` — `cms.cache` の型（外部で型引数として使いたい場合に）
+- `DataSourceAdapter<T>` — データソース抽象
+- `DocumentCacheAdapter<T>` / `ImageCacheAdapter` — キャッシュ抽象
+- `RendererFn` / `RenderOptions` — レンダラー関数の型
+- `CMSErrorCode` / `CMSErrorContext` — エラー型（名前空間付き）
+
+## エラー体系
+
+すべての内部エラーは `CMSError` に統一される。コードは `namespace/kind` 形式。
+
+```ts
+import { isCMSErrorInNamespace } from "@notion-headless-cms/core";
+
+try {
+  await cms.list();
+} catch (err) {
+  if (isCMSErrorInNamespace(err, "source/")) {
+    // Notion 取得系エラー
+  }
+}
+```
+
+組み込みコード: `core/config_invalid` / `core/schema_invalid` / `source/fetch_items_failed` / `source/fetch_item_failed` / `source/load_markdown_failed` / `cache/io_failed` / `cache/image_fetch_failed` / `renderer/failed`
 
 ## 関連パッケージ
 
-- [`@notion-headless-cms/adapter-cloudflare`](../adapter-cloudflare) — Cloudflare Workers 向けファクトリー
-- [`@notion-headless-cms/cache-r2`](../cache-r2) — R2 ストレージ実装
+- [`@notion-headless-cms/source-notion`](../source-notion) — Notion データソース
+- [`@notion-headless-cms/renderer`](../renderer) — Markdown → HTML レンダラー
+- [`@notion-headless-cms/cache-r2`](../cache-r2) — R2 キャッシュ
+- [`@notion-headless-cms/cache-next`](../cache-next) — Next.js ISR キャッシュ

package/dist/cache/memory.d.mts

@@ -0,0 +1,52 @@
+import { a as StorageBinary, i as CachedItemList, r as CachedItem, t as BaseContentItem } from "../content-BrwEY2_p.mjs";
+import { i as InvalidateScope, n as DocumentCacheAdapter, r as ImageCacheAdapter } from "../cache-B-MG4yyg.mjs";
+
+//#region src/cache/memory.d.ts
+interface MemoryDocumentCacheOptions {
+  /** アイテム保持上限。未指定時は上限なし。超過時は LRU で古いものから削除。 */
+  maxItems?: number;
+}
+interface MemoryImageCacheOptions {
+  /** エントリ保持上限。未指定時は上限なし。超過時は LRU で古いものから削除。 */
+  maxItems?: number;
+  /** 合計保持サイズ上限（バイト）。未指定時は上限なし。超過時は LRU で古いものから削除。 */
+  maxSizeBytes?: number;
+}
+/** インメモリのドキュメントキャッシュ実装。プロセス再起動でクリアされる。ローカル開発向け。 */
+declare class MemoryDocumentCache<T extends BaseContentItem = BaseContentItem> implements DocumentCacheAdapter<T> {
+  readonly name = "memory-document";
+  private list;
+  private items;
+  private readonly maxItems;
+  constructor(options?: MemoryDocumentCacheOptions);
+  getList(): Promise<CachedItemList<T> | null>;
+  setList(data: CachedItemList<T>): Promise<void>;
+  getItem(slug: string): Promise<CachedItem<T> | null>;
+  setItem(slug: string, data: CachedItem<T>): Promise<void>;
+  invalidate(scope: InvalidateScope): Promise<void>;
+  private enforceLimit;
+}
+/** インメモリの画像キャッシュ実装。プロセス再起動でクリアされる。ローカル開発向け。 */
+declare class MemoryImageCache implements ImageCacheAdapter {
+  readonly name = "memory-image";
+  private store;
+  private totalBytes;
+  private readonly maxItems;
+  private readonly maxSizeBytes;
+  constructor(options?: MemoryImageCacheOptions);
+  get(hash: string): Promise<StorageBinary | null>;
+  set(hash: string, data: ArrayBuffer, contentType: string): Promise<void>;
+  private enforceLimit;
+}
+/** インメモリキャッシュ（ドキュメント用）を生成する。 */
+declare function memoryDocumentCache<T extends BaseContentItem = BaseContentItem>(options?: MemoryDocumentCacheOptions): DocumentCacheAdapter<T>;
+/** インメモリキャッシュ（画像用）を生成する。 */
+declare function memoryImageCache(options?: MemoryImageCacheOptions): ImageCacheAdapter;
+/**
+ * ドキュメントと画像の両方にインメモリキャッシュを返す便利関数。
+ * memoryCache() はドキュメントキャッシュを返す（後方互換）。
+ */
+declare function memoryCache<T extends BaseContentItem = BaseContentItem>(options?: MemoryDocumentCacheOptions): DocumentCacheAdapter<T>;
+//#endregion
+export { MemoryDocumentCache, MemoryDocumentCacheOptions, MemoryImageCache, MemoryImageCacheOptions, memoryCache, memoryDocumentCache, memoryImageCache };
+//# sourceMappingURL=memory.d.mts.map

package/dist/cache/memory.mjs

@@ -0,0 +1,112 @@
+//#region src/cache/memory.ts
+/**
+* Map の挿入順を LRU として扱う軽量実装。
+* `touch` で既存キーを末尾に移動、`enforceLimit` で古いキー（先頭）から削除する。
+*/
+function touch(map, key) {
+	const v = map.get(key);
+	if (v === void 0) return;
+	map.delete(key);
+	map.set(key, v);
+}
+/** インメモリのドキュメントキャッシュ実装。プロセス再起動でクリアされる。ローカル開発向け。 */
+var MemoryDocumentCache = class {
+	name = "memory-document";
+	list = null;
+	items = /* @__PURE__ */ new Map();
+	maxItems;
+	constructor(options) {
+		this.maxItems = options?.maxItems;
+	}
+	getList() {
+		return Promise.resolve(this.list);
+	}
+	setList(data) {
+		this.list = data;
+		return Promise.resolve();
+	}
+	getItem(slug) {
+		const entry = this.items.get(slug);
+		if (entry) touch(this.items, slug);
+		return Promise.resolve(entry ?? null);
+	}
+	setItem(slug, data) {
+		if (this.items.has(slug)) this.items.delete(slug);
+		this.items.set(slug, data);
+		this.enforceLimit();
+		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);
+	}
+	enforceLimit() {
+		if (this.maxItems === void 0) return;
+		while (this.items.size > this.maxItems) {
+			const firstKey = this.items.keys().next().value;
+			if (firstKey === void 0) break;
+			this.items.delete(firstKey);
+		}
+	}
+};
+/** インメモリの画像キャッシュ実装。プロセス再起動でクリアされる。ローカル開発向け。 */
+var MemoryImageCache = class {
+	name = "memory-image";
+	store = /* @__PURE__ */ new Map();
+	totalBytes = 0;
+	maxItems;
+	maxSizeBytes;
+	constructor(options) {
+		this.maxItems = options?.maxItems;
+		this.maxSizeBytes = options?.maxSizeBytes;
+	}
+	get(hash) {
+		const entry = this.store.get(hash);
+		if (entry) touch(this.store, hash);
+		return Promise.resolve(entry ?? null);
+	}
+	set(hash, data, contentType) {
+		const existing = this.store.get(hash);
+		if (existing) {
+			this.totalBytes -= existing.data.byteLength;
+			this.store.delete(hash);
+		}
+		this.store.set(hash, {
+			data,
+			contentType
+		});
+		this.totalBytes += data.byteLength;
+		this.enforceLimit();
+		return Promise.resolve();
+	}
+	enforceLimit() {
+		while (this.maxItems !== void 0 && this.store.size > this.maxItems || this.maxSizeBytes !== void 0 && this.totalBytes > this.maxSizeBytes) {
+			const firstKey = this.store.keys().next().value;
+			if (firstKey === void 0) break;
+			const victim = this.store.get(firstKey);
+			if (victim) this.totalBytes -= victim.data.byteLength;
+			this.store.delete(firstKey);
+		}
+	}
+};
+/** インメモリキャッシュ（ドキュメント用）を生成する。 */
+function memoryDocumentCache(options) {
+	return new MemoryDocumentCache(options);
+}
+/** インメモリキャッシュ（画像用）を生成する。 */
+function memoryImageCache(options) {
+	return new MemoryImageCache(options);
+}
+/**
+* ドキュメントと画像の両方にインメモリキャッシュを返す便利関数。
+* memoryCache() はドキュメントキャッシュを返す（後方互換）。
+*/
+function memoryCache(options) {
+	return new MemoryDocumentCache(options);
+}
+//#endregion
+export { MemoryDocumentCache, MemoryImageCache, memoryCache, memoryDocumentCache, memoryImageCache };
+
+//# sourceMappingURL=memory.mjs.map

package/dist/cache/memory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.mjs","names":[],"sources":["../../src/cache/memory.ts"],"sourcesContent":["import type {\n\tBaseContentItem,\n\tCachedItem,\n\tCachedItemList,\n\tCacheInvalidateScope,\n\tDocumentCacheAdapter,\n\tImageCacheAdapter,\n\tStorageBinary,\n} from \"../types/index\";\n\nexport interface MemoryDocumentCacheOptions {\n\t/** アイテム保持上限。未指定時は上限なし。超過時は LRU で古いものから削除。 */\n\tmaxItems?: number;\n}\n\nexport interface MemoryImageCacheOptions {\n\t/** エントリ保持上限。未指定時は上限なし。超過時は LRU で古いものから削除。 */\n\tmaxItems?: number;\n\t/** 合計保持サイズ上限（バイト）。未指定時は上限なし。超過時は LRU で古いものから削除。 */\n\tmaxSizeBytes?: number;\n}\n\n/**\n * Map の挿入順を LRU として扱う軽量実装。\n * `touch` で既存キーを末尾に移動、`enforceLimit` で古いキー（先頭）から削除する。\n */\nfunction touch<K, V>(map: Map<K, V>, key: K): void {\n\tconst v = map.get(key);\n\tif (v === undefined) return;\n\tmap.delete(key);\n\tmap.set(key, v);\n}\n\n/** インメモリのドキュメントキャッシュ実装。プロセス再起動でクリアされる。ローカル開発向け。 */\nexport class MemoryDocumentCache<T extends BaseContentItem = BaseContentItem>\n\timplements DocumentCacheAdapter<T>\n{\n\treadonly name = \"memory-document\";\n\tprivate list: CachedItemList<T> | null = null;\n\tprivate items = new Map<string, CachedItem<T>>();\n\tprivate readonly maxItems: number | undefined;\n\n\tconstructor(options?: MemoryDocumentCacheOptions) {\n\t\tthis.maxItems = options?.maxItems;\n\t}\n\n\tgetList(): Promise<CachedItemList<T> | null> {\n\t\treturn Promise.resolve(this.list);\n\t}\n\n\tsetList(data: CachedItemList<T>): Promise<void> {\n\t\tthis.list = data;\n\t\treturn Promise.resolve();\n\t}\n\n\tgetItem(slug: string): Promise<CachedItem<T> | null> {\n\t\tconst entry = this.items.get(slug);\n\t\tif (entry) touch(this.items, slug);\n\t\treturn Promise.resolve(entry ?? null);\n\t}\n\n\tsetItem(slug: string, data: CachedItem<T>): Promise<void> {\n\t\tif (this.items.has(slug)) this.items.delete(slug);\n\t\tthis.items.set(slug, data);\n\t\tthis.enforceLimit();\n\t\treturn Promise.resolve();\n\t}\n\n\tasync invalidate(scope: CacheInvalidateScope): Promise<void> {\n\t\tif (scope === \"all\") {\n\t\t\tthis.list = null;\n\t\t\tthis.items.clear();\n\t\t} else if (\"slug\" in scope) {\n\t\t\tthis.items.delete(scope.slug);\n\t\t}\n\t}\n\n\tprivate enforceLimit(): void {\n\t\tif (this.maxItems === undefined) return;\n\t\twhile (this.items.size > this.maxItems) {\n\t\t\tconst firstKey = this.items.keys().next().value;\n\t\t\tif (firstKey === undefined) break;\n\t\t\tthis.items.delete(firstKey);\n\t\t}\n\t}\n}\n\n/** インメモリの画像キャッシュ実装。プロセス再起動でクリアされる。ローカル開発向け。 */\nexport class MemoryImageCache implements ImageCacheAdapter {\n\treadonly name = \"memory-image\";\n\tprivate store = new Map<string, StorageBinary>();\n\tprivate totalBytes = 0;\n\tprivate readonly maxItems: number | undefined;\n\tprivate readonly maxSizeBytes: number | undefined;\n\n\tconstructor(options?: MemoryImageCacheOptions) {\n\t\tthis.maxItems = options?.maxItems;\n\t\tthis.maxSizeBytes = options?.maxSizeBytes;\n\t}\n\n\tget(hash: string): Promise<StorageBinary | null> {\n\t\tconst entry = this.store.get(hash);\n\t\tif (entry) touch(this.store, hash);\n\t\treturn Promise.resolve(entry ?? null);\n\t}\n\n\tset(hash: string, data: ArrayBuffer, contentType: string): Promise<void> {\n\t\tconst existing = this.store.get(hash);\n\t\tif (existing) {\n\t\t\tthis.totalBytes -= existing.data.byteLength;\n\t\t\tthis.store.delete(hash);\n\t\t}\n\t\tthis.store.set(hash, { data, contentType });\n\t\tthis.totalBytes += data.byteLength;\n\t\tthis.enforceLimit();\n\t\treturn Promise.resolve();\n\t}\n\n\tprivate enforceLimit(): void {\n\t\twhile (\n\t\t\t(this.maxItems !== undefined && this.store.size > this.maxItems) ||\n\t\t\t(this.maxSizeBytes !== undefined && this.totalBytes > this.maxSizeBytes)\n\t\t) {\n\t\t\tconst firstKey = this.store.keys().next().value;\n\t\t\tif (firstKey === undefined) break;\n\t\t\tconst victim = this.store.get(firstKey);\n\t\t\tif (victim) this.totalBytes -= victim.data.byteLength;\n\t\t\tthis.store.delete(firstKey);\n\t\t}\n\t}\n}\n\n/** インメモリキャッシュ（ドキュメント用）を生成する。 */\nexport function memoryDocumentCache<\n\tT extends BaseContentItem = BaseContentItem,\n>(options?: MemoryDocumentCacheOptions): DocumentCacheAdapter<T> {\n\treturn new MemoryDocumentCache<T>(options);\n}\n\n/** インメモリキャッシュ（画像用）を生成する。 */\nexport function memoryImageCache(\n\toptions?: MemoryImageCacheOptions,\n): ImageCacheAdapter {\n\treturn new MemoryImageCache(options);\n}\n\n/**\n * ドキュメントと画像の両方にインメモリキャッシュを返す便利関数。\n * memoryCache() はドキュメントキャッシュを返す（後方互換）。\n */\nexport function memoryCache<T extends BaseContentItem = BaseContentItem>(\n\toptions?: MemoryDocumentCacheOptions,\n): DocumentCacheAdapter<T> {\n\treturn new MemoryDocumentCache<T>(options);\n}\n"],"mappings":";;;;;AA0BA,SAAS,MAAY,KAAgB,KAAc;CAClD,MAAM,IAAI,IAAI,IAAI,IAAI;AACtB,KAAI,MAAM,KAAA,EAAW;AACrB,KAAI,OAAO,IAAI;AACf,KAAI,IAAI,KAAK,EAAE;;;AAIhB,IAAa,sBAAb,MAEA;CACC,OAAgB;CAChB,OAAyC;CACzC,wBAAgB,IAAI,KAA4B;CAChD;CAEA,YAAY,SAAsC;AACjD,OAAK,WAAW,SAAS;;CAG1B,UAA6C;AAC5C,SAAO,QAAQ,QAAQ,KAAK,KAAK;;CAGlC,QAAQ,MAAwC;AAC/C,OAAK,OAAO;AACZ,SAAO,QAAQ,SAAS;;CAGzB,QAAQ,MAA6C;EACpD,MAAM,QAAQ,KAAK,MAAM,IAAI,KAAK;AAClC,MAAI,MAAO,OAAM,KAAK,OAAO,KAAK;AAClC,SAAO,QAAQ,QAAQ,SAAS,KAAK;;CAGtC,QAAQ,MAAc,MAAoC;AACzD,MAAI,KAAK,MAAM,IAAI,KAAK,CAAE,MAAK,MAAM,OAAO,KAAK;AACjD,OAAK,MAAM,IAAI,MAAM,KAAK;AAC1B,OAAK,cAAc;AACnB,SAAO,QAAQ,SAAS;;CAGzB,MAAM,WAAW,OAA4C;AAC5D,MAAI,UAAU,OAAO;AACpB,QAAK,OAAO;AACZ,QAAK,MAAM,OAAO;aACR,UAAU,MACpB,MAAK,MAAM,OAAO,MAAM,KAAK;;CAI/B,eAA6B;AAC5B,MAAI,KAAK,aAAa,KAAA,EAAW;AACjC,SAAO,KAAK,MAAM,OAAO,KAAK,UAAU;GACvC,MAAM,WAAW,KAAK,MAAM,MAAM,CAAC,MAAM,CAAC;AAC1C,OAAI,aAAa,KAAA,EAAW;AAC5B,QAAK,MAAM,OAAO,SAAS;;;;;AAM9B,IAAa,mBAAb,MAA2D;CAC1D,OAAgB;CAChB,wBAAgB,IAAI,KAA4B;CAChD,aAAqB;CACrB;CACA;CAEA,YAAY,SAAmC;AAC9C,OAAK,WAAW,SAAS;AACzB,OAAK,eAAe,SAAS;;CAG9B,IAAI,MAA6C;EAChD,MAAM,QAAQ,KAAK,MAAM,IAAI,KAAK;AAClC,MAAI,MAAO,OAAM,KAAK,OAAO,KAAK;AAClC,SAAO,QAAQ,QAAQ,SAAS,KAAK;;CAGtC,IAAI,MAAc,MAAmB,aAAoC;EACxE,MAAM,WAAW,KAAK,MAAM,IAAI,KAAK;AACrC,MAAI,UAAU;AACb,QAAK,cAAc,SAAS,KAAK;AACjC,QAAK,MAAM,OAAO,KAAK;;AAExB,OAAK,MAAM,IAAI,MAAM;GAAE;GAAM;GAAa,CAAC;AAC3C,OAAK,cAAc,KAAK;AACxB,OAAK,cAAc;AACnB,SAAO,QAAQ,SAAS;;CAGzB,eAA6B;AAC5B,SACE,KAAK,aAAa,KAAA,KAAa,KAAK,MAAM,OAAO,KAAK,YACtD,KAAK,iBAAiB,KAAA,KAAa,KAAK,aAAa,KAAK,cAC1D;GACD,MAAM,WAAW,KAAK,MAAM,MAAM,CAAC,MAAM,CAAC;AAC1C,OAAI,aAAa,KAAA,EAAW;GAC5B,MAAM,SAAS,KAAK,MAAM,IAAI,SAAS;AACvC,OAAI,OAAQ,MAAK,cAAc,OAAO,KAAK;AAC3C,QAAK,MAAM,OAAO,SAAS;;;;;AAM9B,SAAgB,oBAEd,SAA+D;AAChE,QAAO,IAAI,oBAAuB,QAAQ;;;AAI3C,SAAgB,iBACf,SACoB;AACpB,QAAO,IAAI,iBAAiB,QAAQ;;;;;;AAOrC,SAAgB,YACf,SAC0B;AAC1B,QAAO,IAAI,oBAAuB,QAAQ"}

package/dist/cache/noop.d.mts

@@ -0,0 +1,11 @@
+import { t as BaseContentItem } from "../content-BrwEY2_p.mjs";
+import { n as DocumentCacheAdapter, r as ImageCacheAdapter } from "../cache-B-MG4yyg.mjs";
+
+//#region src/cache/noop.d.ts
+/** 何もしないドキュメントキャッシュを返す（シングルトン）。 */
+declare function noopDocumentCache<T extends BaseContentItem = BaseContentItem>(): DocumentCacheAdapter<T>;
+/** 何もしない画像キャッシュを返す（シングルトン）。 */
+declare function noopImageCache(): ImageCacheAdapter;
+//#endregion
+export { noopDocumentCache, noopImageCache };
+//# sourceMappingURL=noop.d.mts.map

package/dist/cache/noop.mjs

@@ -0,0 +1,44 @@
+//#region src/cache/noop.ts
+/** 何もキャッシュしないドキュメントキャッシュ実装。常に null を返す。 */
+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();
+	}
+};
+/** 何もキャッシュしない画像キャッシュ実装。常に null を返す。 */
+var NoopImageCache = class {
+	name = "noop-image";
+	get(_hash) {
+		return Promise.resolve(null);
+	}
+	set(_hash, _data, _contentType) {
+		return Promise.resolve();
+	}
+};
+const _noopDocument = new NoopDocumentCache();
+const _noopImage = new NoopImageCache();
+/** 何もしないドキュメントキャッシュを返す（シングルトン）。 */
+function noopDocumentCache() {
+	return _noopDocument;
+}
+/** 何もしない画像キャッシュを返す（シングルトン）。 */
+function noopImageCache() {
+	return _noopImage;
+}
+//#endregion
+export { noopDocumentCache, noopImageCache };
+
+//# sourceMappingURL=noop.mjs.map

package/dist/cache/noop.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.mjs","names":[],"sources":["../../src/cache/noop.ts"],"sourcesContent":["import type {\n\tBaseContentItem,\n\tCachedItem,\n\tCachedItemList,\n\tCacheInvalidateScope,\n\tDocumentCacheAdapter,\n\tImageCacheAdapter,\n\tStorageBinary,\n} from \"../types/index\";\n\n/** 何もキャッシュしないドキュメントキャッシュ実装。常に null を返す。 */\nclass NoopDocumentCache<T extends BaseContentItem = BaseContentItem>\n\timplements DocumentCacheAdapter<T>\n{\n\treadonly name = \"noop-document\";\n\n\tgetList(): Promise<CachedItemList<T> | null> {\n\t\treturn Promise.resolve(null);\n\t}\n\n\tsetList(_data: CachedItemList<T>): Promise<void> {\n\t\treturn Promise.resolve();\n\t}\n\n\tgetItem(_slug: string): Promise<CachedItem<T> | null> {\n\t\treturn Promise.resolve(null);\n\t}\n\n\tsetItem(_slug: string, _data: CachedItem<T>): Promise<void> {\n\t\treturn Promise.resolve();\n\t}\n\n\tinvalidate(_scope: CacheInvalidateScope): Promise<void> {\n\t\treturn Promise.resolve();\n\t}\n}\n\n/** 何もキャッシュしない画像キャッシュ実装。常に null を返す。 */\nclass NoopImageCache implements ImageCacheAdapter {\n\treadonly name = \"noop-image\";\n\n\tget(_hash: string): Promise<StorageBinary | null> {\n\t\treturn Promise.resolve(null);\n\t}\n\n\tset(_hash: string, _data: ArrayBuffer, _contentType: string): Promise<void> {\n\t\treturn Promise.resolve();\n\t}\n}\n\nconst _noopDocument = new NoopDocumentCache();\nconst _noopImage = new NoopImageCache();\n\n/** 何もしないドキュメントキャッシュを返す（シングルトン）。 */\nexport function noopDocumentCache<\n\tT extends BaseContentItem = BaseContentItem,\n>(): DocumentCacheAdapter<T> {\n\treturn _noopDocument as DocumentCacheAdapter<T>;\n}\n\n/** 何もしない画像キャッシュを返す（シングルトン）。 */\nexport function noopImageCache(): ImageCacheAdapter {\n\treturn _noopImage;\n}\n"],"mappings":";;AAWA,IAAM,oBAAN,MAEA;CACC,OAAgB;CAEhB,UAA6C;AAC5C,SAAO,QAAQ,QAAQ,KAAK;;CAG7B,QAAQ,OAAyC;AAChD,SAAO,QAAQ,SAAS;;CAGzB,QAAQ,OAA8C;AACrD,SAAO,QAAQ,QAAQ,KAAK;;CAG7B,QAAQ,OAAe,OAAqC;AAC3D,SAAO,QAAQ,SAAS;;CAGzB,WAAW,QAA6C;AACvD,SAAO,QAAQ,SAAS;;;;AAK1B,IAAM,iBAAN,MAAkD;CACjD,OAAgB;CAEhB,IAAI,OAA8C;AACjD,SAAO,QAAQ,QAAQ,KAAK;;CAG7B,IAAI,OAAe,OAAoB,cAAqC;AAC3E,SAAO,QAAQ,SAAS;;;AAI1B,MAAM,gBAAgB,IAAI,mBAAmB;AAC7C,MAAM,aAAa,IAAI,gBAAgB;;AAGvC,SAAgB,oBAEa;AAC5B,QAAO;;;AAIR,SAAgB,iBAAoC;AACnD,QAAO"}

package/dist/cache-B-MG4yyg.d.mts

@@ -0,0 +1,45 @@
+import { a as StorageBinary, i as CachedItemList, r as CachedItem, t as BaseContentItem } from "./content-BrwEY2_p.mjs";
+
+//#region src/types/cache.d.ts
+/**
+ * キャッシュ無効化のスコープ。
+ * v1 API では `{ collection, slug? }` が主形式。
+ * 旧 `{ tag }` 形式は後方互換のため残す。
+ */
+type InvalidateScope = "all" | {
+  slug: string;
+} | {
+  tag: string;
+} | {
+  collection: string;
+} | {
+  collection: string;
+  slug: string;
+};
+/** ドキュメントキャッシュを抽象化するインターフェース。 */
+interface DocumentCacheAdapter<T extends BaseContentItem = BaseContentItem> {
+  readonly name: string;
+  getList(): Promise<CachedItemList<T> | null>;
+  setList(data: CachedItemList<T>): Promise<void>;
+  getItem(slug: string): Promise<CachedItem<T> | null>;
+  setItem(slug: string, data: CachedItem<T>): Promise<void>;
+  invalidate?(scope: InvalidateScope): Promise<void>;
+}
+/** 画像キャッシュを抽象化するインターフェース。 */
+interface ImageCacheAdapter {
+  readonly name: string;
+  get(hash: string): Promise<StorageBinary | null>;
+  set(hash: string, data: ArrayBuffer, contentType: string): Promise<void>;
+}
+/**
+ * キャッシュ設定。`"disabled"` を渡すと完全にキャッシュを無効化する。
+ * オブジェクトの場合、document / image それぞれ独立したアダプタを差し込める。
+ */
+type CacheConfig<T extends BaseContentItem = BaseContentItem> = "disabled" | {
+  document?: DocumentCacheAdapter<T>;
+  image?: ImageCacheAdapter; /** キャッシュの有効期間（ミリ秒）。未設定の場合はTTLなし。 */
+  ttlMs?: number;
+};
+//#endregion
+export { InvalidateScope as i, DocumentCacheAdapter as n, ImageCacheAdapter as r, CacheConfig as t };
+//# sourceMappingURL=cache-B-MG4yyg.d.mts.map

package/dist/content-BrwEY2_p.d.mts

@@ -0,0 +1,53 @@
+//#region src/types/content.d.ts
+/**
+ * ライブラリが動作するために必須なフィールド。
+ * 利用者はこのインターフェースを拡張して独自のコンテンツ型を定義する。
+ *
+ * @example
+ * interface Post extends BaseContentItem {
+ *   title: string;
+ *   author: string;
+ * }
+ * createCMS<Post>({ source: notionAdapter({ ... }) })
+ */
+interface BaseContentItem {
+  /** Notion ページ ID（変更検知に必須）。 */
+  id: string;
+  /** URL キー（必須）。 */
+  slug: string;
+  /** 最終更新タイムスタンプ（変更検知に必須）。 */
+  updatedAt: string;
+  /** コンテンツのステータス。ステータスのない DB では省略可能。 */
+  status?: string;
+  /** 公開日時。日付プロパティのない DB では省略可能。 */
+  publishedAt?: string;
+}
+/** ストレージにキャッシュされたレンダリング済みコンテンツ。 */
+interface CachedItem<T extends BaseContentItem = BaseContentItem> {
+  html: string;
+  item: T;
+  notionUpdatedAt: string;
+  cachedAt: number;
+}
+/** ストレージにキャッシュされたコンテンツ一覧。 */
+interface CachedItemList<T extends BaseContentItem = BaseContentItem> {
+  items: T[];
+  cachedAt: number;
+}
+/** ストレージから取得したバイナリオブジェクト。 */
+interface StorageBinary {
+  data: ArrayBuffer;
+  contentType?: string;
+}
+/** Notionのプロパティ名マッピング（すべてオプション）。 */
+interface CMSSchemaProperties {
+  /** Notionのスラッグプロパティ名。デフォルト: 'Slug' */
+  slug?: string;
+  /** Notionのステータスプロパティ名。デフォルト: 'Status' */
+  status?: string;
+  /** Notionの公開日プロパティ名。デフォルト: 'CreatedAt' */
+  date?: string;
+}
+//#endregion
+export { StorageBinary as a, CachedItemList as i, CMSSchemaProperties as n, CachedItem as r, BaseContentItem as t };
+//# sourceMappingURL=content-BrwEY2_p.d.mts.map

package/dist/errors.d.mts

@@ -0,0 +1,32 @@
+//#region src/errors.d.ts
+type BuiltInCMSErrorCode = "core/config_invalid" | "core/schema_invalid" | "source/fetch_items_failed" | "source/fetch_item_failed" | "source/load_markdown_failed" | "cache/io_failed" | "cache/image_fetch_failed" | "renderer/failed";
+/**
+ * CMS エラーコード。
+ * `BuiltInCMSErrorCode` のリテラル補完を維持しつつ、
+ * サードパーティアダプタが独自コードを定義できるよう `string & {}` で拡張可能にする。
+ */
+type CMSErrorCode = BuiltInCMSErrorCode | (string & {});
+interface CMSErrorContext {
+  operation: string;
+  slug?: string;
+  dataSourceId?: string;
+  pageId?: string;
+  [key: string]: string | number | boolean | null | undefined;
+}
+declare class CMSError extends Error {
+  readonly code: CMSErrorCode;
+  readonly cause?: unknown;
+  readonly context: CMSErrorContext;
+  constructor(params: {
+    code: CMSErrorCode;
+    message: string;
+    cause?: unknown;
+    context: CMSErrorContext;
+  });
+}
+declare function isCMSError(error: unknown): error is CMSError;
+/** エラーコードが特定の名前空間に属するかを判定する（例: "source/"）。 */
+declare function isCMSErrorInNamespace(error: unknown, namespace: string): error is CMSError;
+//#endregion
+export { CMSError, CMSErrorCode, CMSErrorContext, isCMSError, isCMSErrorInNamespace };
+//# sourceMappingURL=errors.d.mts.map

package/dist/errors.mjs

@@ -0,0 +1,24 @@
+//#region 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;
+}
+/** エラーコードが特定の名前空間に属するかを判定する（例: "source/"）。 */
+function isCMSErrorInNamespace(error, namespace) {
+	return isCMSError(error) && error.code.startsWith(namespace);
+}
+//#endregion
+export { CMSError, isCMSError, isCMSErrorInNamespace };
+
+//# sourceMappingURL=errors.mjs.map