@notion-headless-cms/core 0.1.2 → 0.1.3

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.ts → noop.d.mts}

@@ -1,9 +1,11 @@
-import { D as DocumentCacheAdapter, I as ImageCacheAdapter } from '../cache-DvbyemBK.js';
-import { B as BaseContentItem } from '../content-Biqf0l_o.js';
+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.ts → errors.d.mts}

@@ -1,3 +1,4 @@
+//#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 エラーコード。
@@ -6,25 +7,26 @@ type BuiltInCMSErrorCode = "core/config_invalid" | "core/schema_invalid" | "sour
  */
 type CMSErrorCode = BuiltInCMSErrorCode | (string & {});
 interface CMSErrorContext {
-    operation: string;
-    slug?: string;
-    dataSourceId?: string;
-    pageId?: string;
-    [key: string]: string | number | boolean | null | undefined;
+  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;
-    });
+  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;
-
-export { CMSError, type CMSErrorCode, type CMSErrorContext, isCMSError, isCMSErrorInNamespace };
+//#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

package/dist/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["type BuiltInCMSErrorCode =\n\t| \"core/config_invalid\"\n\t| \"core/schema_invalid\"\n\t| \"source/fetch_items_failed\"\n\t| \"source/fetch_item_failed\"\n\t| \"source/load_markdown_failed\"\n\t| \"cache/io_failed\"\n\t| \"cache/image_fetch_failed\"\n\t| \"renderer/failed\";\n\n/**\n * CMS エラーコード。\n * `BuiltInCMSErrorCode` のリテラル補完を維持しつつ、\n * サードパーティアダプタが独自コードを定義できるよう `string & {}` で拡張可能にする。\n */\nexport type CMSErrorCode = BuiltInCMSErrorCode | (string & {});\n\nexport interface CMSErrorContext {\n\toperation: string;\n\tslug?: string;\n\tdataSourceId?: string;\n\tpageId?: string;\n\t[key: string]: string | number | boolean | null | undefined;\n}\n\nexport class CMSError extends Error {\n\treadonly code: CMSErrorCode;\n\toverride readonly cause?: unknown;\n\treadonly context: CMSErrorContext;\n\n\tconstructor(params: {\n\t\tcode: CMSErrorCode;\n\t\tmessage: string;\n\t\tcause?: unknown;\n\t\tcontext: CMSErrorContext;\n\t}) {\n\t\tsuper(params.message, { cause: params.cause });\n\t\tthis.name = \"CMSError\";\n\t\tthis.code = params.code;\n\t\tthis.cause = params.cause;\n\t\tthis.context = params.context;\n\t}\n}\n\nexport function isCMSError(error: unknown): error is CMSError {\n\treturn error instanceof CMSError;\n}\n\n/** エラーコードが特定の名前空間に属するかを判定する（例: \"source/\"）。 */\nexport function isCMSErrorInNamespace(\n\terror: unknown,\n\tnamespace: string,\n): error is CMSError {\n\treturn isCMSError(error) && error.code.startsWith(namespace);\n}\n"],"mappings":";AAyBA,IAAa,WAAb,cAA8B,MAAM;CACnC;CACA;CACA;CAEA,YAAY,QAKT;AACF,QAAM,OAAO,SAAS,EAAE,OAAO,OAAO,OAAO,CAAC;AAC9C,OAAK,OAAO;AACZ,OAAK,OAAO,OAAO;AACnB,OAAK,QAAQ,OAAO;AACpB,OAAK,UAAU,OAAO;;;AAIxB,SAAgB,WAAW,OAAmC;AAC7D,QAAO,iBAAiB;;;AAIzB,SAAgB,sBACf,OACA,WACoB;AACpB,QAAO,WAAW,MAAM,IAAI,MAAM,KAAK,WAAW,UAAU"}

package/dist/hooks-DCSAQkST.d.mts

@@ -0,0 +1,60 @@
+import { r as CachedItem, t as BaseContentItem } from "./content-BrwEY2_p.mjs";
+
+//#region src/types/hooks.d.ts
+type MaybePromise<T> = T | Promise<T>;
+interface CMSHooks<T extends BaseContentItem = BaseContentItem> {
+  beforeCache?: (item: CachedItem<T>) => MaybePromise<CachedItem<T>>;
+  afterRender?: (html: string, item: T) => MaybePromise<string>;
+  onCacheHit?: (slug: string, item: CachedItem<T>) => void;
+  onCacheMiss?: (slug: string) => void;
+  onListCacheHit?: (items: T[], cachedAt: number) => void;
+  onListCacheMiss?: () => void;
+  onError?: (error: Error) => void;
+  onRenderStart?: (slug: string) => void;
+  onRenderEnd?: (slug: string, durationMs: number) => void;
+}
+//#endregion
+//#region src/types/logger.d.ts
+/**
+ * ログの付加情報。よく使うフィールドを型安全に渡せるようにしつつ、
+ * 任意の拡張フィールドは `[key: string]: unknown` で許容する。
+ */
+interface LogContext {
+  operation?: string;
+  slug?: string;
+  pageId?: string;
+  durationMs?: number;
+  attempt?: number;
+  status?: number;
+  error?: string;
+  [key: string]: unknown;
+}
+interface Logger {
+  debug?: (message: string, context?: LogContext) => void;
+  info?: (message: string, context?: LogContext) => void;
+  warn?: (message: string, context?: LogContext) => void;
+  error?: (message: string, context?: LogContext) => void;
+}
+//#endregion
+//#region src/types/plugin.d.ts
+interface CMSPlugin<T extends BaseContentItem = BaseContentItem> {
+  name: string;
+  hooks?: CMSHooks<T>;
+  logger?: Partial<Logger>;
+}
+declare function definePlugin<T extends BaseContentItem>(plugin: CMSPlugin<T>): CMSPlugin<T>;
+//#endregion
+//#region src/hooks.d.ts
+/**
+ * プラグイン配列とダイレクトフックを合成して単一の CMSHooks を返す。
+ * beforeCache / afterRender はパイプライン（前の出力が次の入力）。
+ * onCacheHit などオブザーバー系は全員に同じ値を渡し、例外は logger に流して握りつぶす。
+ */
+declare function mergeHooks<T extends BaseContentItem>(plugins: CMSPlugin<T>[], directHooks?: CMSHooks<T>, logger?: Logger): CMSHooks<T>;
+/** プラグイン配列とダイレクトロガーを合成して単一の Logger を返す。 */
+declare function mergeLoggers(plugins: Array<{
+  logger?: Partial<Logger>;
+}>, directLogger?: Logger): Logger | undefined;
+//#endregion
+export { Logger as a, definePlugin as i, mergeLoggers as n, CMSHooks as o, CMSPlugin as r, MaybePromise as s, mergeHooks as t };
+//# sourceMappingURL=hooks-DCSAQkST.d.mts.map

package/dist/hooks.d.mts

@@ -0,0 +1,2 @@
+import { n as mergeLoggers, t as mergeHooks } from "./hooks-DCSAQkST.mjs";
+export { mergeHooks, mergeLoggers };

package/dist/hooks.mjs

@@ -0,0 +1,75 @@
+//#region src/hooks.ts
+/**
+* プラグイン配列とダイレクトフックを合成して単一の CMSHooks を返す。
+* beforeCache / afterRender はパイプライン（前の出力が次の入力）。
+* onCacheHit などオブザーバー系は全員に同じ値を渡し、例外は logger に流して握りつぶす。
+*/
+function mergeHooks(plugins, directHooks, logger) {
+	const allHooks = [...plugins.map((p) => p.hooks ?? {}), ...directHooks ? [directHooks] : []];
+	if (allHooks.length === 0) return {};
+	return {
+		beforeCache: buildPipeline(allHooks, "beforeCache"),
+		afterRender: buildRenderPipeline(allHooks),
+		onCacheHit: buildObserver(allHooks, "onCacheHit", logger),
+		onCacheMiss: buildObserver(allHooks, "onCacheMiss", logger),
+		onListCacheHit: buildObserver(allHooks, "onListCacheHit", logger),
+		onListCacheMiss: buildObserver(allHooks, "onListCacheMiss", logger),
+		onError: buildObserver(allHooks, "onError", logger),
+		onRenderStart: buildObserver(allHooks, "onRenderStart", logger),
+		onRenderEnd: buildObserver(allHooks, "onRenderEnd", logger)
+	};
+}
+function buildPipeline(hooks, key) {
+	const fns = hooks.map((h) => h[key]).filter(Boolean);
+	if (fns.length === 0) return void 0;
+	return async (item) => {
+		let current = item;
+		for (const fn of fns) current = await fn(current);
+		return current;
+	};
+}
+function buildRenderPipeline(hooks) {
+	const fns = hooks.map((h) => h.afterRender).filter(Boolean);
+	if (fns.length === 0) return void 0;
+	return async (html, item) => {
+		let current = html;
+		for (const fn of fns) current = await fn(current, item);
+		return current;
+	};
+}
+function buildObserver(hooks, key, logger) {
+	const fns = hooks.map((h) => h[key]).filter(Boolean);
+	if (fns.length === 0) return void 0;
+	return ((...args) => {
+		for (const fn of fns) try {
+			fn(...args);
+		} catch (err) {
+			logger?.error?.("観測フックで例外が発生", {
+				hook: String(key),
+				error: err instanceof Error ? err.message : String(err)
+			});
+		}
+	});
+}
+/** プラグイン配列とダイレクトロガーを合成して単一の Logger を返す。 */
+function mergeLoggers(plugins, directLogger) {
+	const loggers = [...plugins.map((p) => p.logger ?? {}), ...directLogger ? [directLogger] : []];
+	if (loggers.length === 0) return void 0;
+	const merged = {};
+	for (const level of [
+		"debug",
+		"info",
+		"warn",
+		"error"
+	]) {
+		const fns = loggers.map((l) => l[level]).filter(Boolean);
+		if (fns.length > 0) merged[level] = (message, context) => {
+			for (const fn of fns) fn(message, context);
+		};
+	}
+	return merged;
+}
+//#endregion
+export { mergeHooks, mergeLoggers };
+
+//# sourceMappingURL=hooks.mjs.map

package/dist/hooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.mjs","names":[],"sources":["../src/hooks.ts"],"sourcesContent":["import type { BaseContentItem } from \"./types/content\";\nimport type { CMSHooks, MaybePromise } from \"./types/hooks\";\nimport type { Logger } from \"./types/logger\";\nimport type { CMSPlugin } from \"./types/plugin\";\n\n/**\n * プラグイン配列とダイレクトフックを合成して単一の CMSHooks を返す。\n * beforeCache / afterRender はパイプライン（前の出力が次の入力）。\n * onCacheHit などオブザーバー系は全員に同じ値を渡し、例外は logger に流して握りつぶす。\n */\nexport function mergeHooks<T extends BaseContentItem>(\n\tplugins: CMSPlugin<T>[],\n\tdirectHooks?: CMSHooks<T>,\n\tlogger?: Logger,\n): CMSHooks<T> {\n\tconst allHooks: CMSHooks<T>[] = [\n\t\t...plugins.map((p) => p.hooks ?? {}),\n\t\t...(directHooks ? [directHooks] : []),\n\t];\n\n\tif (allHooks.length === 0) return {};\n\n\treturn {\n\t\tbeforeCache: buildPipeline(allHooks, \"beforeCache\"),\n\t\tafterRender: buildRenderPipeline(allHooks),\n\t\tonCacheHit: buildObserver(allHooks, \"onCacheHit\", logger),\n\t\tonCacheMiss: buildObserver(allHooks, \"onCacheMiss\", logger),\n\t\tonListCacheHit: buildObserver(allHooks, \"onListCacheHit\", logger),\n\t\tonListCacheMiss: buildObserver(allHooks, \"onListCacheMiss\", logger),\n\t\tonError: buildObserver(allHooks, \"onError\", logger),\n\t\tonRenderStart: buildObserver(allHooks, \"onRenderStart\", logger),\n\t\tonRenderEnd: buildObserver(allHooks, \"onRenderEnd\", logger),\n\t};\n}\n\nfunction buildPipeline<T extends BaseContentItem>(\n\thooks: CMSHooks<T>[],\n\tkey: \"beforeCache\",\n): CMSHooks<T>[\"beforeCache\"] {\n\tconst fns = hooks.map((h) => h[key]).filter(Boolean) as NonNullable<\n\t\tCMSHooks<T>[\"beforeCache\"]\n\t>[];\n\tif (fns.length === 0) return undefined;\n\treturn async (item) => {\n\t\tlet current = item;\n\t\tfor (const fn of fns) {\n\t\t\tcurrent = await (fn(current) as MaybePromise<typeof item>);\n\t\t}\n\t\treturn current;\n\t};\n}\n\nfunction buildRenderPipeline<T extends BaseContentItem>(\n\thooks: CMSHooks<T>[],\n): CMSHooks<T>[\"afterRender\"] {\n\tconst fns = hooks.map((h) => h.afterRender).filter(Boolean) as NonNullable<\n\t\tCMSHooks<T>[\"afterRender\"]\n\t>[];\n\tif (fns.length === 0) return undefined;\n\treturn async (html, item) => {\n\t\tlet current = html;\n\t\tfor (const fn of fns) {\n\t\t\tcurrent = await (fn(current, item) as MaybePromise<string>);\n\t\t}\n\t\treturn current;\n\t};\n}\n\nfunction buildObserver<T extends BaseContentItem, K extends keyof CMSHooks<T>>(\n\thooks: CMSHooks<T>[],\n\tkey: K,\n\tlogger?: Logger,\n): CMSHooks<T>[K] {\n\tconst fns = hooks.map((h) => h[key]).filter(Boolean);\n\tif (fns.length === 0) return undefined;\n\treturn ((...args: unknown[]) => {\n\t\tfor (const fn of fns) {\n\t\t\ttry {\n\t\t\t\t(fn as (...a: unknown[]) => void)(...args);\n\t\t\t} catch (err) {\n\t\t\t\tlogger?.error?.(\"観測フックで例外が発生\", {\n\t\t\t\t\thook: String(key),\n\t\t\t\t\terror: err instanceof Error ? err.message : String(err),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}) as CMSHooks<T>[K];\n}\n\n/** プラグイン配列とダイレクトロガーを合成して単一の Logger を返す。 */\nexport function mergeLoggers(\n\tplugins: Array<{ logger?: Partial<Logger> }>,\n\tdirectLogger?: Logger,\n): Logger | undefined {\n\tconst loggers: Partial<Logger>[] = [\n\t\t...plugins.map((p) => p.logger ?? {}),\n\t\t...(directLogger ? [directLogger] : []),\n\t];\n\tif (loggers.length === 0) return undefined;\n\n\tconst merged: Logger = {};\n\tfor (const level of [\"debug\", \"info\", \"warn\", \"error\"] as const) {\n\t\tconst fns = loggers.map((l) => l[level]).filter(Boolean) as NonNullable<\n\t\t\tLogger[typeof level]\n\t\t>[];\n\t\tif (fns.length > 0) {\n\t\t\tmerged[level] = (message, context) => {\n\t\t\t\tfor (const fn of fns) fn(message, context);\n\t\t\t};\n\t\t}\n\t}\n\treturn merged;\n}\n"],"mappings":";;;;;;AAUA,SAAgB,WACf,SACA,aACA,QACc;CACd,MAAM,WAA0B,CAC/B,GAAG,QAAQ,KAAK,MAAM,EAAE,SAAS,EAAE,CAAC,EACpC,GAAI,cAAc,CAAC,YAAY,GAAG,EAAE,CACpC;AAED,KAAI,SAAS,WAAW,EAAG,QAAO,EAAE;AAEpC,QAAO;EACN,aAAa,cAAc,UAAU,cAAc;EACnD,aAAa,oBAAoB,SAAS;EAC1C,YAAY,cAAc,UAAU,cAAc,OAAO;EACzD,aAAa,cAAc,UAAU,eAAe,OAAO;EAC3D,gBAAgB,cAAc,UAAU,kBAAkB,OAAO;EACjE,iBAAiB,cAAc,UAAU,mBAAmB,OAAO;EACnE,SAAS,cAAc,UAAU,WAAW,OAAO;EACnD,eAAe,cAAc,UAAU,iBAAiB,OAAO;EAC/D,aAAa,cAAc,UAAU,eAAe,OAAO;EAC3D;;AAGF,SAAS,cACR,OACA,KAC6B;CAC7B,MAAM,MAAM,MAAM,KAAK,MAAM,EAAE,KAAK,CAAC,OAAO,QAAQ;AAGpD,KAAI,IAAI,WAAW,EAAG,QAAO,KAAA;AAC7B,QAAO,OAAO,SAAS;EACtB,IAAI,UAAU;AACd,OAAK,MAAM,MAAM,IAChB,WAAU,MAAO,GAAG,QAAQ;AAE7B,SAAO;;;AAIT,SAAS,oBACR,OAC6B;CAC7B,MAAM,MAAM,MAAM,KAAK,MAAM,EAAE,YAAY,CAAC,OAAO,QAAQ;AAG3D,KAAI,IAAI,WAAW,EAAG,QAAO,KAAA;AAC7B,QAAO,OAAO,MAAM,SAAS;EAC5B,IAAI,UAAU;AACd,OAAK,MAAM,MAAM,IAChB,WAAU,MAAO,GAAG,SAAS,KAAK;AAEnC,SAAO;;;AAIT,SAAS,cACR,OACA,KACA,QACiB;CACjB,MAAM,MAAM,MAAM,KAAK,MAAM,EAAE,KAAK,CAAC,OAAO,QAAQ;AACpD,KAAI,IAAI,WAAW,EAAG,QAAO,KAAA;AAC7B,UAAS,GAAG,SAAoB;AAC/B,OAAK,MAAM,MAAM,IAChB,KAAI;AACF,MAAiC,GAAG,KAAK;WAClC,KAAK;AACb,WAAQ,QAAQ,eAAe;IAC9B,MAAM,OAAO,IAAI;IACjB,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;IACvD,CAAC;;;;;AAON,SAAgB,aACf,SACA,cACqB;CACrB,MAAM,UAA6B,CAClC,GAAG,QAAQ,KAAK,MAAM,EAAE,UAAU,EAAE,CAAC,EACrC,GAAI,eAAe,CAAC,aAAa,GAAG,EAAE,CACtC;AACD,KAAI,QAAQ,WAAW,EAAG,QAAO,KAAA;CAEjC,MAAM,SAAiB,EAAE;AACzB,MAAK,MAAM,SAAS;EAAC;EAAS;EAAQ;EAAQ;EAAQ,EAAW;EAChE,MAAM,MAAM,QAAQ,KAAK,MAAM,EAAE,OAAO,CAAC,OAAO,QAAQ;AAGxD,MAAI,IAAI,SAAS,EAChB,QAAO,UAAU,SAAS,YAAY;AACrC,QAAK,MAAM,MAAM,IAAK,IAAG,SAAS,QAAQ;;;AAI7C,QAAO"}