@notion-headless-cms/core 0.3.12 → 0.3.14

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { memoryCache } from "./cache/memory.mjs";
-import { CMSError, isCMSError, isCMSErrorInNamespace } from "./errors.mjs";
+import { CMSError, isCMSError, isCMSErrorInNamespace, matchCMSError } from "./errors.mjs";
 import { mergeHooks, mergeLoggers } from "./hooks.mjs";
 //#region src/cache.ts
 /** 文字列をSHA-256でハッシュ化し、16進数文字列として返す。画像キーの生成に使用。 */
@@ -59,44 +59,37 @@ const noopDocOps = noopDoc;
 const noopImgOps = noopImg;
 //#endregion
 //#region src/image.ts
-/** レスポンスヘッダまたはURLの拡張子からContent-Typeを推測する。 */
-function inferContentType(url, responseContentType) {
-	if (responseContentType?.startsWith("image/")) return responseContentType.split(";")[0].trim();
-	if (url.includes(".png")) return "image/png";
-	if (url.includes(".gif")) return "image/gif";
-	if (url.includes(".webp")) return "image/webp";
-	return "image/jpeg";
-}
 /**
-* URL → SHA-256 hash のメモ化マップ。
-* Notion の画像 URL は同じ画像でも署名が時刻ごとに変わるが、
-* 1 リクエスト内では同一 URL が複数回現れることが多い (重複ハッシュ計算を回避)。
-*
-* メモリリーク防止に最大エントリ数を設けており、超過時は最古から削除する LRU。
+* レスポンスの Content-Type ヘッダから画像の MIME タイプを取り出す。
+* ヘッダがない、または image/* でない場合は CMSError を投げる。
+* URL 拡張子からの推測や jpeg デフォルトは行わない。
 */
-const HASH_MEMO_LIMIT = 1024;
-const hashMemo = /* @__PURE__ */ new Map();
-async function memoSha256(url) {
-	const cached = hashMemo.get(url);
-	if (cached !== void 0) {
-		hashMemo.delete(url);
-		hashMemo.set(url, cached);
-		return cached;
-	}
-	const hash = await sha256Hex(url);
-	hashMemo.set(url, hash);
-	if (hashMemo.size > HASH_MEMO_LIMIT) {
-		const firstKey = hashMemo.keys().next().value;
-		if (firstKey !== void 0) hashMemo.delete(firstKey);
-	}
-	return hash;
+function pickImageContentType(headerValue, notionUrl) {
+	if (!headerValue) throw new CMSError({
+		code: "cache/image_invalid_content_type",
+		message: "Image response missing Content-Type header.",
+		context: {
+			operation: "fetchAndCacheImage:contentType",
+			notionUrl
+		}
+	});
+	const value = (headerValue.split(";")[0] ?? headerValue).trim().toLowerCase();
+	if (!value.startsWith("image/")) throw new CMSError({
+		code: "cache/image_invalid_content_type",
+		message: `Image response has non-image Content-Type: ${value}`,
+		context: {
+			operation: "fetchAndCacheImage:contentType",
+			notionUrl,
+			contentType: value
+		}
+	});
+	return value;
 }
 /**
 * Notion画像URLをfetchして ImageCacheOps にキャッシュし、プロキシURL を返す。
 * 既存キャッシュがあれば再fetchしない。
 */
-async function fetchAndCacheImage(cache, cacheName, notionUrl, imageProxyBase, logger) {
-	const hash = await memoSha256(notionUrl);
+async function fetchAndCacheImage(cache, cacheName, notionUrl, hash, imageProxyBase, logger) {
 	const proxyUrl = `${imageProxyBase}/${hash}`;
 	if (await cache.get(hash)) {
 		logger?.debug?.("画像キャッシュヒット", {
@@ -123,7 +116,7 @@ async function fetchAndCacheImage(cache, cacheName, notionUrl, imageProxyBase, l
 			}
 		});
 		const data = await response.arrayBuffer();
-		const contentType = inferContentType(notionUrl, response.headers.get("content-type"));
+		const contentType = pickImageContentType(response.headers.get("content-type"), notionUrl);
 		await cache.set(hash, data, contentType);
 		logger?.debug?.("画像をキャッシュに保存", {
 			operation: "fetchAndCacheImage",
@@ -148,13 +141,39 @@ async function fetchAndCacheImage(cache, cacheName, notionUrl, imageProxyBase, l
 * `ImageCacheOps` と `imageProxyBase` から `cacheImage` 関数を構築する。
 * 返り値は Notion 画像 URL を受け取り、SHA-256 ハッシュをキャッシュキーとして
 * {@link ImageCacheOps} に保存後、プロキシ URL を返す。
+*
+* ハッシュのメモ化はファクトリ呼び出し単位でスコープ化されており、
+* インスタンス間でキャッシュを共有しない。
 */
 function buildCacheImageFn(cache, cacheName, imageProxyBase, logger) {
-	return (notionUrl) => fetchAndCacheImage(cache, cacheName, notionUrl, imageProxyBase, logger);
+	const hashMemo = /* @__PURE__ */ new Map();
+	return async (notionUrl) => {
+		let hash = hashMemo.get(notionUrl);
+		if (hash === void 0) {
+			hash = await sha256Hex(notionUrl);
+			hashMemo.set(notionUrl, hash);
+		}
+		return fetchAndCacheImage(cache, cacheName, notionUrl, hash, imageProxyBase, logger);
+	};
 }
 //#endregion
 //#region src/rendering.ts
 /**
+* `@notion-headless-cms/renderer` を動的 import してデフォルトレンダラーを返す。
+* core のゼロ依存ルールを守るため静的 import は禁止。
+*/
+async function loadDefaultRenderer() {
+	try {
+		return (await import("@notion-headless-cms/renderer")).renderMarkdown;
+	} catch {
+		throw new CMSError({
+			code: "core/config_invalid",
+			message: "renderer が未指定で、@notion-headless-cms/renderer のロードにも失敗しました。 createCMS の renderer オプションを指定するか、@notion-headless-cms/renderer をインストールしてください。",
+			context: { operation: "loadDefaultRenderer" }
+		});
+	}
+}
+/**
 * メタデータキャッシュエントリを生成する。Notion API も renderer も呼ばない軽量関数。
 */
 function buildCachedItemMeta(item, source) {
@@ -191,19 +210,25 @@ async function buildCachedItemContent(item, ctx) {
 			}
 		});
 	}
-	let blocks = [];
+	let blocks;
 	try {
 		blocks = await ctx.source.loadBlocks(item);
 	} catch (err) {
-		ctx.logger?.warn?.("loadBlocks に失敗したため raw フォールバック", {
-			slug: item.slug,
-			error: err instanceof Error ? err.message : String(err)
+		if (isCMSError(err)) throw err;
+		throw new CMSError({
+			code: "source/load_blocks_failed",
+			message: "Failed to load blocks from source.",
+			cause: err,
+			context: {
+				operation: "buildCachedItemContent:loadBlocks",
+				pageId: item.id,
+				slug: item.slug
+			}
 		});
-		blocks = [];
 	}
 	const cacheImage = ctx.hasImageCache ? buildCacheImageFn(ctx.imgCache, ctx.imgCacheName, ctx.imageProxyBase, ctx.logger) : void 0;
-	let html;
 	const rendererFn = ctx.rendererFn ?? await loadDefaultRenderer();
+	let html;
 	try {
 		html = await rendererFn(markdown, {
 			imageProxyBase: ctx.imageProxyBase,
@@ -241,23 +266,6 @@ async function buildCachedItemContent(item, ctx) {
 	ctx.hooks.onRenderEnd?.(item.slug, durationMs);
 	return result;
 }
-/**
-* renderer オプション未指定時のフォールバック。
-* @notion-headless-cms/renderer を動的 import する。
-* createCMS({ renderer }) で明示注入された場合はこのパスを通らない。
-*/
-async function loadDefaultRenderer() {
-	try {
-		return (await import("@notion-headless-cms/renderer")).renderMarkdown;
-	} catch (err) {
-		throw new CMSError({
-			code: "renderer/failed",
-			message: "renderer オプションが未指定で @notion-headless-cms/renderer が見つかりません。 createCMS({ renderer }) でレンダラーを注入するか、@notion-headless-cms/renderer をインストールしてください。",
-			cause: err,
-			context: { operation: "loadDefaultRenderer" }
-		});
-	}
-}
 //#endregion
 //#region src/retry.ts
 const DEFAULT_RETRY_CONFIG = {
@@ -313,40 +321,40 @@ var CollectionClientImpl = class {
 	constructor(ctx) {
 		this.ctx = ctx;
 		this.cache = {
-			invalidate: (slug) => this.invalidateImpl(slug),
-			warm: (opts) => this.warmImpl(opts),
-			adjacent: (slug, opts) => this.adjacentImpl(slug, opts)
+			invalidate: () => this.invalidateImpl(),
+			invalidateItem: (slug) => this.invalidateItemImpl(slug),
+			warm: (opts) => this.warmImpl(opts)
 		};
 	}
-	async get(slug, opts = {}) {
-		if (opts.fresh) {
+	async find(slug, opts = {}) {
+		if (opts.bypassCache) {
 			this.ctx.hooks.onCacheMiss?.(slug);
-			const item = await this.findRaw(slug);
+			const item = await this.fetchRaw(slug);
 			if (!item) return null;
 			const meta = await this.persistMeta(slug, item);
-			await this.invalidateContent(slug);
+			await this.invalidateContentEntry(slug);
 			return this.attachLazyContent(meta);
 		}
 		const cachedMeta = await this.ctx.docCache.getMeta(this.ctx.collection, slug);
 		if (cachedMeta) {
 			if (this.ctx.ttlMs !== void 0 && isStale(cachedMeta.cachedAt, this.ctx.ttlMs)) {
 				this.ctx.logger?.debug?.("キャッシュ期限切れ（TTL）、フェッチ", {
-					operation: "get",
+					operation: "find",
 					slug,
 					collection: this.ctx.collection,
 					cacheAdapter: this.ctx.docCacheName
 				});
 				this.ctx.hooks.onCacheMiss?.(slug);
-				const item = await this.findRaw(slug);
+				const item = await this.fetchRaw(slug);
 				if (!item) return null;
 				const meta = await this.persistMeta(slug, item);
-				await this.invalidateContent(slug);
+				await this.invalidateContentEntry(slug);
 				return this.attachLazyContent(meta);
 			}
 			const bg = this.checkAndUpdateItemBg(slug, cachedMeta);
 			if (this.ctx.waitUntil) this.ctx.waitUntil(bg);
 			this.ctx.logger?.debug?.("キャッシュヒット", {
-				operation: "get",
+				operation: "find",
 				slug,
 				collection: this.ctx.collection,
 				cacheAdapter: this.ctx.docCacheName,
@@ -356,13 +364,13 @@ var CollectionClientImpl = class {
 			return this.attachLazyContent(cachedMeta);
 		}
 		this.ctx.logger?.debug?.("キャッシュミス、フェッチ", {
-			operation: "get",
+			operation: "find",
 			slug,
 			collection: this.ctx.collection,
 			cacheAdapter: this.ctx.docCacheName
 		});
 		this.ctx.hooks.onCacheMiss?.(slug);
-		const item = await this.findRaw(slug);
+		const item = await this.fetchRaw(slug);
 		if (!item) return null;
 		const meta = await this.persistMeta(slug, item, { background: true });
 		return this.attachLazyContent(meta);
@@ -371,33 +379,32 @@ var CollectionClientImpl = class {
 		return applyListOptions(await this.fetchList(), opts);
 	}
 	async params() {
-		return (await this.fetchList()).map((item) => ({ slug: item.slug }));
+		return (await this.fetchList()).map((item) => item.slug);
 	}
 	async check(slug, currentVersion) {
-		const raw = await this.findRaw(slug);
+		const raw = await this.fetchRaw(slug);
 		if (!raw) return null;
-		if (raw.updatedAt === currentVersion) return { stale: false };
+		if (raw.lastEditedTime === currentVersion) return { stale: false };
 		const meta = await this.persistMeta(slug, raw);
-		await this.invalidateContent(slug);
+		await this.invalidateContentEntry(slug);
 		return {
 			stale: true,
 			item: this.attachLazyContent(meta)
 		};
 	}
-	async invalidateImpl(slug) {
-		if (slug !== void 0) {
-			this.ctx.logger?.debug?.("アイテムキャッシュを無効化", {
-				operation: "cache.invalidate",
-				collection: this.ctx.collection,
-				cacheAdapter: this.ctx.docCacheName,
-				slug
-			});
-			await this.ctx.docCache.invalidate({
-				collection: this.ctx.collection,
-				slug
-			});
-			return;
-		}
+	async adjacent(slug, opts) {
+		const items = applyListOptions(await this.fetchList(), { sort: opts?.sort });
+		const index = items.findIndex((it) => it.slug === slug);
+		if (index === -1) return {
+			prev: null,
+			next: null
+		};
+		return {
+			prev: index > 0 ? items[index - 1] ?? null : null,
+			next: index < items.length - 1 ? items[index + 1] ?? null : null
+		};
+	}
+	async invalidateImpl() {
 		this.ctx.logger?.debug?.("コレクション全体のキャッシュを無効化", {
 			operation: "cache.invalidate",
 			collection: this.ctx.collection,
@@ -405,11 +412,23 @@ var CollectionClientImpl = class {
 		});
 		await this.ctx.docCache.invalidate({ collection: this.ctx.collection });
 	}
+	async invalidateItemImpl(slug) {
+		this.ctx.logger?.debug?.("アイテムキャッシュを無効化", {
+			operation: "cache.invalidateItem",
+			collection: this.ctx.collection,
+			cacheAdapter: this.ctx.docCacheName,
+			slug
+		});
+		await this.ctx.docCache.invalidate({
+			collection: this.ctx.collection,
+			slug
+		});
+	}
 	async warmImpl(opts) {
 		const items = await this.fetchListRaw();
 		const concurrency = opts?.concurrency ?? this.ctx.maxConcurrent;
 		let ok = 0;
-		let failed = 0;
+		const failed = [];
 		for (let i = 0; i < items.length; i += concurrency) {
 			const chunk = items.slice(i, i + concurrency);
 			await Promise.all(chunk.map(async (item) => {
@@ -419,7 +438,10 @@ var CollectionClientImpl = class {
 					await this.ctx.docCache.setContent(this.ctx.collection, item.slug, content);
 					ok++;
 				} catch (err) {
-					failed++;
+					failed.push({
+						slug: item.slug,
+						error: err
+					});
 					this.ctx.logger?.warn?.("warm: アイテムの事前レンダリングに失敗", {
 						slug: item.slug,
 						pageId: item.id,
@@ -438,18 +460,6 @@ var CollectionClientImpl = class {
 			failed
 		};
 	}
-	async adjacentImpl(slug, opts) {
-		const items = applyListOptions(await this.fetchList(), { sort: opts?.sort });
-		const index = items.findIndex((it) => it.slug === slug);
-		if (index === -1) return {
-			prev: null,
-			next: null
-		};
-		return {
-			prev: index > 0 ? items[index - 1] ?? null : null,
-			next: index < items.length - 1 ? items[index + 1] ?? null : null
-		};
-	}
 	async persistMeta(slug, item, opts = {}) {
 		let meta = buildCachedItemMeta(item, this.ctx.source);
 		if (this.ctx.hooks.beforeCacheMeta) meta = await this.ctx.hooks.beforeCacheMeta(meta);
@@ -458,7 +468,7 @@ var CollectionClientImpl = class {
 		else await save;
 		return meta;
 	}
-	async invalidateContent(slug) {
+	async invalidateContentEntry(slug) {
 		await this.ctx.docCache.invalidate({
 			collection: this.ctx.collection,
 			slug,
@@ -478,16 +488,31 @@ var CollectionClientImpl = class {
 		this.ctx.hooks.onContentRevalidated?.(slug, fresh);
 		return fresh;
 	}
-	/** メタ既知の状態で本文だけバックグラウンド再生成する。エラーは握りつぶす。 */
+	/** メタ既知の状態で本文だけバックグラウンド再生成する。エラーは onSwrError フックに通知する。 */
 	async rebuildContentBg(slug, item) {
 		try {
 			const fresh = await buildCachedItemContent(item, this.ctx.render);
 			await this.ctx.docCache.setContent(this.ctx.collection, slug, fresh);
 			this.ctx.hooks.onContentRevalidated?.(slug, fresh);
 		} catch (err) {
+			const cmsErr = isCMSError(err) ? err : new CMSError({
+				code: "swr/content_rebuild_failed",
+				message: "SWR background content rebuild failed.",
+				cause: err,
+				context: {
+					operation: "swr.rebuildContentBg",
+					collection: this.ctx.collection,
+					slug
+				}
+			});
+			this.ctx.hooks.onSwrError?.(cmsErr, {
+				phase: "item-content",
+				slug
+			});
 			this.ctx.logger?.warn?.("本文のバックグラウンド再生成に失敗", {
 				slug,
 				collection: this.ctx.collection,
+				code: cmsErr.code,
 				error: err instanceof Error ? err.message : String(err)
 			});
 		}
@@ -500,11 +525,11 @@ var CollectionClientImpl = class {
 			if (!payloadPromise) payloadPromise = this.loadOrBuildContent(slug, item);
 			return payloadPromise;
 		};
-		const render = async (opts) => {
-			const payload = await loadPayload();
-			return opts?.format === "markdown" ? payload.markdown : payload.html;
-		};
-		return Object.assign(Object.create(null), item, { render });
+		return Object.assign(Object.create(null), item, {
+			html: async () => (await loadPayload()).html,
+			markdown: async () => (await loadPayload()).markdown,
+			blocks: async () => (await loadPayload()).blocks
+		});
 	}
 	async fetchList() {
 		const cached = await this.ctx.docCache.getList(this.ctx.collection);
@@ -551,13 +576,13 @@ var CollectionClientImpl = class {
 	}
 	async checkAndUpdateItemBg(slug, cached) {
 		try {
-			const item = await this.findRaw(slug);
+			const item = await this.fetchRaw(slug);
 			if (!item) return;
 			if (this.ctx.source.getLastModified(item) !== cached.notionUpdatedAt) {
 				const meta = await this.persistMeta(slug, item);
-				await this.invalidateContent(slug);
+				await this.invalidateContentEntry(slug);
 				this.ctx.logger?.debug?.("SWR: 差分を検出、メタを差し替え", {
-					operation: "get:bg",
+					operation: "find:bg",
 					slug,
 					collection: this.ctx.collection,
 					notionUpdatedAt: cached.notionUpdatedAt
@@ -570,15 +595,30 @@ var CollectionClientImpl = class {
 					cachedAt: Date.now()
 				});
 				this.ctx.logger?.debug?.("SWR: 差分なし、TTL をリセット", {
-					operation: "get:bg",
+					operation: "find:bg",
 					slug,
 					collection: this.ctx.collection
 				});
 			}
 		} catch (err) {
+			const cmsErr = isCMSError(err) ? err : new CMSError({
+				code: "swr/item_check_failed",
+				message: "SWR background item check failed.",
+				cause: err,
+				context: {
+					operation: "swr.checkAndUpdateItemBg",
+					collection: this.ctx.collection,
+					slug
+				}
+			});
+			this.ctx.hooks.onSwrError?.(cmsErr, {
+				phase: "item-meta",
+				slug
+			});
 			this.ctx.logger?.warn?.("SWR: アイテムのバックグラウンド差分チェックに失敗", {
 				slug,
 				collection: this.ctx.collection,
+				code: cmsErr.code,
 				error: err instanceof Error ? err.message : String(err)
 			});
 		}
@@ -608,14 +648,25 @@ var CollectionClientImpl = class {
 				});
 			}
 		} catch (err) {
+			const cmsErr = isCMSError(err) ? err : new CMSError({
+				code: "swr/list_check_failed",
+				message: "SWR background list check failed.",
+				cause: err,
+				context: {
+					operation: "swr.checkAndUpdateListBg",
+					collection: this.ctx.collection
+				}
+			});
+			this.ctx.hooks.onSwrError?.(cmsErr, { phase: "list" });
 			this.ctx.logger?.warn?.("SWR: リストのバックグラウンド差分チェックに失敗", {
 				collection: this.ctx.collection,
+				code: cmsErr.code,
 				error: err instanceof Error ? err.message : String(err)
 			});
 		}
 	}
-	fetchListRaw() {
-		return withRetry(() => this.ctx.source.list({ publishedStatuses: this.ctx.publishedStatuses.length > 0 ? this.ctx.publishedStatuses : void 0 }), {
+	async fetchListRaw() {
+		return (await withRetry(() => this.ctx.source.list({ publishedStatuses: this.ctx.publishedStatuses.length > 0 ? this.ctx.publishedStatuses : void 0 }), {
 			...this.ctx.retryConfig,
 			onRetry: (attempt, status) => {
 				this.ctx.logger?.warn?.("list() リトライ中", {
@@ -623,13 +674,17 @@ var CollectionClientImpl = class {
 					status
 				});
 			}
+		})).filter((item) => {
+			if (item.isArchived || item.isInTrash) return false;
+			if (this.ctx.accessibleStatuses.length > 0 && (!item.status || !this.ctx.accessibleStatuses.includes(item.status))) return false;
+			return true;
 		});
 	}
-	async findRaw(slug) {
+	async fetchRaw(slug) {
 		const retryOpts = {
 			...this.ctx.retryConfig,
 			onRetry: (attempt, status) => {
-				this.ctx.logger?.warn?.("get() リトライ中", {
+				this.ctx.logger?.warn?.("find() リトライ中", {
 					attempt,
 					status,
 					slug
@@ -642,15 +697,26 @@ var CollectionClientImpl = class {
 		if (notionPropName && findByProp) item = await withRetry(() => findByProp(notionPropName, slug), retryOpts);
 		else item = (await withRetry(() => this.ctx.source.list(), retryOpts)).find((i) => i.slug === slug) ?? null;
 		if (!item) return null;
+		if (item.isArchived || item.isInTrash) return null;
 		if (this.ctx.accessibleStatuses.length > 0 && (!item.status || !this.ctx.accessibleStatuses.includes(item.status))) return null;
 		return item;
 	}
 };
+function matchesWhere(item, where) {
+	for (const key of Object.keys(where)) {
+		const expected = where[key];
+		const actual = item[key];
+		if (Array.isArray(expected)) {
+			if (!expected.includes(actual)) return false;
+		} else if (actual !== expected) return false;
+	}
+	return true;
+}
 function applyListOptions(items, opts) {
-	if (!opts) return items;
+	if (!opts) return sortByPublishedAtDesc(items);
 	let result = items;
-	if (opts.status) {
-		const allow = new Set(Array.isArray(opts.status) ? opts.status : [opts.status]);
+	if (opts.statuses) {
+		const allow = new Set(Array.isArray(opts.statuses) ? opts.statuses : [opts.statuses]);
 		result = result.filter((it) => it.status != null && allow.has(it.status));
 	}
 	if (opts.tag) {
@@ -662,24 +728,46 @@ function applyListOptions(items, opts) {
 	}
 	if (opts.where) {
 		const where = opts.where;
-		result = result.filter((it) => Object.entries(where).every(([key, value]) => it[key] === value));
+		result = result.filter((it) => matchesWhere(it, where));
 	}
+	if (opts.filter) result = result.filter(opts.filter);
 	if (opts.sort) result = [...result].sort(makeComparator(opts.sort));
+	else result = sortByPublishedAtDesc(result);
 	const skip = opts.skip ?? 0;
 	const limit = opts.limit;
 	if (skip > 0 || limit !== void 0) result = result.slice(skip, limit !== void 0 ? skip + limit : void 0);
 	return result;
 }
+/** publishedAt 降順、未設定の場合は lastEditedTime 降順でソートする。 */
+function sortByPublishedAtDesc(items) {
+	return [...items].sort((a, b) => {
+		const av = a.publishedAt ?? a.lastEditedTime;
+		const bv = b.publishedAt ?? b.lastEditedTime;
+		if (av === bv) return 0;
+		return av > bv ? -1 : 1;
+	});
+}
 function makeComparator(sort) {
+	if (sort.compare) return sort.compare;
 	const by = sort.by;
 	const dir = sort.dir === "asc" ? 1 : -1;
 	return (a, b) => {
 		const av = a[by];
 		const bv = b[by];
 		if (av === bv) return 0;
-		if (av === void 0) return 1;
-		if (bv === void 0) return -1;
-		return av > bv ? dir : -dir;
+		if (av === void 0 || av === null) return 1;
+		if (bv === void 0 || bv === null) return -1;
+		if (typeof av === "string" && typeof bv === "string") return av > bv ? dir : -dir;
+		if (typeof av === "number" && typeof bv === "number") return av > bv ? dir : -dir;
+		throw new CMSError({
+			code: "core/sort_unsupported_type",
+			message: `"${String(by)}" フィールドの型 "${typeof av}" はソート非対応です。compare 関数を指定してください。`,
+			context: {
+				operation: "makeComparator",
+				field: String(by),
+				type: typeof av
+			}
+		});
 	};
 }
 //#endregion
@@ -690,12 +778,23 @@ const DEFAULT_OPTS = {
 	revalidatePath: "/revalidate"
 };
 /**
+* CMSError のコードから HTTP ステータスコードを返す。
+* 既知の webhook エラーコードのみ対応し、それ以外は null を返す。
+*/
+function webhookErrorStatus(code) {
+	if (code === "webhook/signature_invalid") return 401;
+	if (code === "webhook/not_implemented") return 501;
+	if (code === "webhook/unknown_collection") return 404;
+	if (code === "webhook/payload_invalid") return 400;
+	return null;
+}
+/**
 * Web Standard な Request → Response ルーター。
 * Next.js / React Router / Hono / Cloudflare Workers いずれでも使える。
 *
 * ルート:
-* - GET  `{basePath}/images/:hash` — 画像プロキシ
-* - POST `{basePath}/revalidate`   — Webhook 受信 + $revalidate()
+* - GET  `{basePath}/images/:hash`              — 画像プロキシ
+* - POST `{basePath}/revalidate/:collection`    — Webhook 受信 + $revalidate()
 */
 function createHandler(adapter, opts = {}) {
 	const basePath = trimTrailingSlash(opts.basePath ?? DEFAULT_OPTS.basePath);
@@ -715,23 +814,38 @@ function createHandler(adapter, opts = {}) {
 			headers.set("cache-control", "public, max-age=31536000, immutable");
 			return new Response(object.data, { headers });
 		}
-		if (req.method === "POST" && rel === revalidatePath) {
-			const scope = await adapter.parseWebhook(req, opts.webhookSecret);
-			if (!scope) return new Response(JSON.stringify({
+		if (req.method === "POST" && rel.startsWith(`${revalidatePath}/`)) {
+			const collection = rel.slice(revalidatePath.length + 1);
+			if (!collection || collection.includes("/")) return new Response(JSON.stringify({
 				ok: false,
-				reason: "invalid"
+				reason: "collection required"
 			}), {
 				status: 400,
 				headers: { "content-type": "application/json" }
 			});
-			await adapter.revalidate(scope);
-			return new Response(JSON.stringify({
-				ok: true,
-				scope
-			}), {
-				status: 200,
-				headers: { "content-type": "application/json" }
-			});
+			try {
+				const scope = await adapter.parseWebhookFor(collection, req, opts.webhookSecret);
+				await adapter.revalidate(scope);
+				return new Response(JSON.stringify({
+					ok: true,
+					scope
+				}), {
+					status: 200,
+					headers: { "content-type": "application/json" }
+				});
+			} catch (err) {
+				if (isCMSError(err)) {
+					const status = webhookErrorStatus(err.code);
+					if (status !== null) return new Response(JSON.stringify({
+						ok: false,
+						code: err.code
+					}), {
+						status,
+						headers: { "content-type": "application/json" }
+					});
+				}
+				throw err;
+			}
 		}
 		return new Response("Not Found", { status: 404 });
 	};
@@ -745,12 +859,11 @@ const DEFAULT_IMAGE_PROXY_BASE = "/api/images";
 /**
 * `cache` オプションから document / image オペレーションを解決する。
 *
-* - 配列で渡された場合は各 adapter の `handles` を見て先勝ち (最初に見つかったもの) で振り分ける
-* - 単体で渡された場合は `handles` の領域だけ反映、片側は noop
+* - 各 adapter の `handles` を見て先勝ち (最初に見つかったもの) で振り分ける
 * - 未指定なら両方 noop
 */
 function resolveCache(cache) {
-	const adapters = cache === void 0 ? [] : Array.isArray(cache) ? cache : [cache];
+	const adapters = cache ?? [];
 	let doc = noopDocOps;
 	let docName = "noop-document";
 	let img = noopImgOps;
@@ -812,7 +925,8 @@ function applyLogLevel(logger, minLevel) {
 *       publishedStatuses: ["公開済み"],
 *     }
 *   },
-*   cache: memoryCache({ ttlMs: 5 * 60_000 }),
+*   cache: [memoryCache()],
+*   swr: { ttlMs: 5 * 60_000 },
 * });
 */
 function createCMS(opts) {
@@ -840,7 +954,7 @@ function createCMS(opts) {
 		});
 	}
 	const cacheRes = resolveCache(opts.cache);
-	const ttlMs = opts.ttlMs;
+	const ttlMs = opts.swr?.ttlMs;
 	const imageProxyBase = opts.imageProxyBase ?? DEFAULT_IMAGE_PROXY_BASE;
 	const contentConfig = opts.content;
 	const rendererFn = opts.renderer;
@@ -853,10 +967,10 @@ function createCMS(opts) {
 		...DEFAULT_RETRY_CONFIG,
 		...opts.rateLimiter ?? {}
 	};
-	const collectionNames = Object.keys(opts.collections);
+	const collectionNames = [];
 	const collections = {};
-	for (const name of collectionNames) {
-		const def = opts.collections[name];
+	for (const [name, def] of Object.entries(opts.collections)) {
+		collectionNames.push(name);
 		const source = def.source;
 		const colHooks = def.hooks;
 		const collectionHooks = colHooks ? mergeHooks([{
@@ -892,43 +1006,42 @@ function createCMS(opts) {
 		});
 	}
 	const globalOps = {
-		$collections: collectionNames,
-		async $invalidate(scope) {
+		collections: collectionNames,
+		async invalidate(scope) {
 			logger?.debug?.("グローバルキャッシュを無効化", {
-				operation: "$invalidate",
+				operation: "invalidate",
 				cacheAdapter: cacheRes.docName
 			});
 			await cacheRes.doc.invalidate(scope ?? "all");
 		},
-		$handler(handlerOpts) {
+		handler(handlerOpts) {
 			return createHandler({
 				imageCache: cacheRes.img,
-				parseWebhook: async (req, webhookSecret) => {
-					for (const name of collectionNames) {
-						const ds = opts.collections[name].source;
-						if (ds.parseWebhook) try {
-							return await ds.parseWebhook(req.clone(), { secret: webhookSecret });
-						} catch (err) {
-							logger?.warn?.("parseWebhook 失敗", {
-								collection: name,
-								error: err instanceof Error ? err.message : String(err)
-							});
+				async parseWebhookFor(collection, req, webhookSecret) {
+					const def = opts.collections[collection];
+					if (!def) throw new CMSError({
+						code: "webhook/unknown_collection",
+						message: `Unknown collection: ${collection}`,
+						context: {
+							operation: "parseWebhookFor",
+							collection
 						}
-					}
-					try {
-						const body = await req.json();
-						if (body.slug && body.collection) return {
-							collection: body.collection,
-							slug: body.slug
-						};
-						if (body.collection) return { collection: body.collection };
-					} catch {}
-					return null;
+					});
+					const ds = def.source;
+					if (!ds.parseWebhook) throw new CMSError({
+						code: "webhook/not_implemented",
+						message: `Collection "${collection}" does not support webhooks.`,
+						context: {
+							operation: "parseWebhookFor",
+							collection
+						}
+					});
+					return ds.parseWebhook(req, { secret: webhookSecret });
 				},
-				revalidate: (scope) => globalOps.$invalidate(scope)
+				revalidate: (scope) => globalOps.invalidate(scope)
 			}, handlerOpts);
 		},
-		$getCachedImage(hash) {
+		getCachedImage(hash) {
 			return cacheRes.img.get(hash);
 		}
 	};
@@ -940,6 +1053,6 @@ function definePlugin(plugin) {
 	return plugin;
 }
 //#endregion
-export { CMSError, CollectionClientImpl, DEFAULT_RETRY_CONFIG, collectionKey, createCMS, createHandler, definePlugin, isCMSError, isCMSErrorInNamespace, isStale, memoryCache, mergeHooks, mergeLoggers, noopDocOps, noopImgOps, sha256Hex, withRetry };
+export { CMSError, CollectionClientImpl, DEFAULT_RETRY_CONFIG, collectionKey, createCMS, createHandler, definePlugin, isCMSError, isCMSErrorInNamespace, isStale, matchCMSError, memoryCache, mergeHooks, mergeLoggers, noopDocOps, noopImgOps, sha256Hex, withRetry };
 
 //# sourceMappingURL=index.mjs.map