@notion-headless-cms/core 0.1.2 → 0.2.0

package/README.md

@@ -1,28 +1,78 @@
 # @notion-headless-cms/core
 
-CMS エンジン本体。データソース・キャッシュ・レンダラーを統合し、Stale-While-Revalidate / 更新検知 / クエリビルダー / フック / リトライを提供する。**外部ランタイム依存ゼロ**。
+CMS エンジン本体。`createCMS` を提供し、SWR / 更新検知 / フック /
+リトライ / Web Standard Route Handler を内蔵する。**外部ランタイム依存ゼロ**。
 
 ## インストール
 
 ```bash
-npm install @notion-headless-cms/core
+pnpm add @notion-headless-cms/core @notion-headless-cms/notion-orm \
+  @notion-headless-cms/renderer @notionhq/client zod \
+  unified remark-parse remark-gfm remark-rehype rehype-stringify
 ```
 
-`core` 自体は外部ランタイム依存ゼロ。`@notion-headless-cms/renderer` は `peerDependenciesMeta.optional: true` のため、renderer を `createCMS({ renderer })` で明示注入するか、動的フォールバック（`import("@notion-headless-cms/renderer")`）を使う場合のみインストールが必要。
+`core` 自体は依存ゼロだが、実際に Notion を叩くには `notion-orm`、
+HTML 化には `renderer` が必要。CLI 生成物 (`nhc-schema.ts`) が
+notion-orm を自動参照する。
 
-Cloudflare Workers / Node.js / Next.js などで使う場合は、それぞれのアダプタを使うのが最短ルート:
+## 基本形
 
-- [`@notion-headless-cms/adapter-cloudflare`](../adapter-cloudflare)
-- [`@notion-headless-cms/adapter-node`](../adapter-node)
-- [`@notion-headless-cms/adapter-next`](../adapter-next)
+```ts
+import { createCMS, nodePreset } from "@notion-headless-cms/core";
+import { cmsDataSources } from "./generated/nhc-schema";
 
-### サブパスエクスポート
+const cms = createCMS({
+  ...nodePreset({ ttlMs: 5 * 60_000 }),
+  dataSources: cmsDataSources,
+});
+
+const posts = await cms.posts.getList();
+const post = await cms.posts.getItem("my-post");
+if (post) console.log(await post.content.html());
+```
 
-一部の機能はサブパス経由でインポートでき、バレル経由より小さくバンドルできる。
+## 公開 API
+
+### `createCMS(opts)`
+- `dataSources`: CLI が生成する `cmsDataSources` (必須)
+- `cache?`: `CacheConfig | "disabled"`
+- `renderer?`: `RendererFn` (未指定なら `@notion-headless-cms/renderer` を動的ロード)
+- `content?`: `imageProxyBase` 等
+- `waitUntil?`: Cloudflare Workers の `ctx.waitUntil`
+- `hooks?` / `plugins?` / `logger?` / `rateLimiter?`
+
+### `nodePreset(opts?)`
+Node.js 向けプリセット。`{ cache: { document: memoryDocumentCache, image: memoryImageCache }, renderer }` を返す。
+- `cache?`: `CacheConfig | "disabled"` — デフォルトは memory cache
+- `ttlMs?`: SWR TTL (ミリ秒)
+- `renderer?`: カスタム renderer
+
+### `cms.<collection>` の主なメソッド
+- `getItem(slug)` — 本文込みで単件取得 (SWR)。返り値は `T & { content: { blocks, html(), markdown() } }`
+- `getList(opts?)` — 公開済み一覧 (本文なし)
+- `getStaticParams()` / `getStaticPaths()` — SSG 用
+- `adjacent(slug, opts?)` — 前後記事ナビゲーション
+- `revalidate(scope?)` / `prefetch(opts?)` — コレクション別キャッシュ操作
+
+### グローバル操作
+- `cms.$collections` — コレクション名一覧
+- `cms.$revalidate(scope?)` — `"all" | { collection } | { collection, slug }`
+- `cms.$handler(opts?)` — Web Standard `(req) => Response` を返す (画像プロキシ + webhook)
+- `cms.$getCachedImage(hash)` — 画像キャッシュ直アクセス
+
+### cache アダプタ
+- `memoryDocumentCache({ maxItems? })` — LRU 対応インメモリキャッシュ
+- `memoryImageCache({ maxItems?, maxSizeBytes? })`
+- `noopDocumentCache()` / `noopImageCache()`
+
+### エラー
+- `CMSError` / `isCMSError` / `isCMSErrorInNamespace(err, "core/")`
+- 名前空間: `core/*` / `source/*` / `cache/*` / `renderer/*` / `cli/*`
+
+## サブパスエクスポート
 
 ```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";
 ```
 
@@ -31,173 +81,17 @@ 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/memory` | `memoryDocumentCache` / `memoryImageCache` |
 | `@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: {
-    document: memoryDocumentCache({ maxItems: 500 }),
-    image: memoryImageCache({ maxItems: 200, maxSizeBytes: 64 * 1024 * 1024 }),
-    ttlMs: 5 * 60 * 1000,
-  },
-});
-
-// ソース直接
-const items = await cms.list();
-const item = await cms.find("my-post");
-const rendered = item ? await cms.render(item) : null;
-
-// 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 } 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 cms = createCMS<MyPost>({
-  source: notionAdapter<MyPost>({
-    token: process.env.NOTION_TOKEN!,
-    dataSourceId: process.env.NOTION_DATA_SOURCE_ID!,
-    mapItem: (page) => ({
-      id: page.id,
-      slug: /* ... */ "",
-      updatedAt: page.last_edited_time,
-      publishedAt: page.created_time,
-      title: /* ... */ "",
-      category: /* ... */ "",
-    }),
-  }),
-});
-```
-
-> 型安全なマッピングは [`defineSchema`](../source-notion) を推奨。
-
-## 主要 API
-
-### `CMS<T>` / `createCMS<T>(options)`
-
-| メソッド | 説明 |
-|---|---|
-| `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) を参照。
-
-### ユーティリティ
-
-| エクスポート | 説明 |
-|---|---|
-| `memoryDocumentCache<T>({ maxItems? })` | インメモリ DocumentCacheAdapter。`maxItems` 指定時は LRU 方式で古いものから削除 |
-| `memoryImageCache({ maxItems?, maxSizeBytes? })` | インメモリ ImageCacheAdapter。件数とバイト数の両方で上限を設定可 |
-| `noopDocumentCache<T>()` / `noopImageCache()` | 何もしないアダプタ |
-| `isStale(cachedAt, ttlMs)` | TTL 切れ判定 |
-| `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)` | 内部エラー通知 |
-
-## 主要な型
-
-- `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`
+- [Node.js スクリプト](../../docs/recipes/nodejs-script.md)
+- [Cloudflare Workers + R2 + KV](../../docs/recipes/cloudflare-workers.md) (`cloudflarePreset` は `cache-r2` パッケージ)
+- [Next.js App Router](../../docs/recipes/nextjs-app-router.md)
 
-## 関連パッケージ
+## 詳細ドキュメント
 
-- [`@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 キャッシュ
+- [クイックスタート](../../docs/quickstart.md)
+- [CMS メソッド一覧](../../docs/api/cms-methods.md)
+- [v0.2 → v0.3 移行ガイド](../../docs/migration/v0.3.md)

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 { l as InvalidateScope, n as DocumentCacheAdapter, r as ImageCacheAdapter } from "../cache-Av7HRw_s.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,115 @@
+//#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();
+			return;
+		}
+		this.list = null;
+		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\tDocumentCacheAdapter,\n\tImageCacheAdapter,\n\tInvalidateScope,\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: InvalidateScope): Promise<void> {\n\t\tif (scope === \"all\") {\n\t\t\tthis.list = null;\n\t\t\tthis.items.clear();\n\t\t\treturn;\n\t\t}\n\t\t// { collection } または { collection, slug }。単一コレクション想定のため\n\t\t// list を必ず破棄し、slug 指定があれば該当 item も削除する\n\t\tthis.list = null;\n\t\tif (\"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,OAAuC;AACvD,MAAI,UAAU,OAAO;AACpB,QAAK,OAAO;AACZ,QAAK,MAAM,OAAO;AAClB;;AAID,OAAK,OAAO;AACZ,MAAI,UAAU,MACb,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-Av7HRw_s.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\tDocumentCacheAdapter,\n\tImageCacheAdapter,\n\tInvalidateScope,\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: InvalidateScope): 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,QAAwC;AAClD,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"}