@notion-headless-cms/core 0.3.7 → 0.3.9

package/dist/index.d.mts

@@ -1,8 +1,6 @@
-import { a as StorageBinary, c as ImageRef, i as CachedItemList, l as InlineNode, n as CMSSchemaProperties, o as ContentBlock, r as CachedItem, s as ContentResult, t as BaseContentItem } from "./content-WydAfQtk.mjs";
-import { a as CollectionConfig, c as InferCollectionItem, d as PropertyMap, f as WebhookConfig, i as CMSSchema, l as InvalidateScope, n as DocumentCacheAdapter, o as DataSource, r as ImageCacheAdapter, s as DataSourceFactory, t as CacheConfig, u as PropertyDef } from "./cache-D051BP4G.mjs";
-import { a as Logger, i as definePlugin, n as mergeLoggers, o as CMSHooks, r as CMSPlugin, s as MaybePromise, t as mergeHooks } from "./hooks-D8Lgf-Co.mjs";
-import { MemoryDocumentCacheOptions, MemoryImageCacheOptions, memoryDocumentCache, memoryImageCache } from "./cache/memory.mjs";
-import { noopDocumentCache, noopImageCache } from "./cache/noop.mjs";
+import { a as CachedItemMeta, c as ContentResult, i as CachedItemList, l as ImageRef, n as CMSSchemaProperties, o as StorageBinary, r as CachedItemContent, s as ContentBlock, t as BaseContentItem, u as InlineNode } from "./content-BIcYVt2y.mjs";
+import { a as CacheAdapter, c as DataSource, d as PropertyDef, f as PropertyMap, i as memoryCache, l as InvalidateKind, o as DocumentCacheOps, p as WebhookConfig, s as ImageCacheOps, t as MemoryCacheOptions, u as InvalidateScope } from "./memory-V04Q09jC.mjs";
+import { a as Logger, i as definePlugin, n as mergeLoggers, o as CMSHooks, r as CMSPlugin, s as MaybePromise, t as mergeHooks } from "./hooks-C0Pv0WYd.mjs";
 import { BuiltInCMSErrorCode, CMSError, CMSErrorCode, CMSErrorContext, isCMSError, isCMSErrorInNamespace } from "./errors.mjs";
 
 //#region src/types/collection.d.ts
@@ -11,12 +9,12 @@ interface SortOption<T extends BaseContentItem = BaseContentItem> {
   /** ソートするプロパティ名。 */
   by: keyof T & string;
   /** 昇順 / 降順。デフォルト "desc"。 */
-  direction?: "asc" | "desc";
+  dir?: "asc" | "desc";
 }
-/** `getList` のフィルタ / ソート / ページング。 */
-interface GetListOptions<T extends BaseContentItem = BaseContentItem> {
+/** `list()` のオプション。ページ取得に必要な絞り込み・ソート・ページングを表現する。 */
+interface ListOptions<T extends BaseContentItem = BaseContentItem> {
   /** ステータス絞り込み (`publishedStatuses` を上書き)。 */
-  statuses?: string[];
+  status?: string | readonly string[];
   /** プロパティ一致フィルタ (in-memory フィルタ)。 */
   where?: Partial<Record<keyof T, unknown>>;
   /** タグ絞り込み (schema に tags: string[] フィールドがある場合)。 */
@@ -28,106 +26,78 @@ interface GetListOptions<T extends BaseContentItem = BaseContentItem> {
   /** スキップ件数。 */
   skip?: number;
 }
-/** `adjacent` の並び順指定。 */
+/** `cache.adjacent` のオプション。 */
 interface AdjacencyOptions<T extends BaseContentItem = BaseContentItem> {
   sort?: SortOption<T>;
 }
-/** `getItem` の返り値 (本文常時同梱)。 */
-type ItemWithContent<T extends BaseContentItem> = T & {
-  content: ContentResult;
-};
-/**
- * `getList` の戻り値。アイテム配列とバージョン文字列を含む。
- * version は DataSource.getListVersion() が生成するフィルタ済みアイテムの識別子。
- */
-interface GetListResult<T extends BaseContentItem = BaseContentItem> {
-  items: T[];
-  /** フィルタ適用後のアイテム群を識別するバージョン文字列。 */
-  version: string;
+/** `get()` のオプション。 */
+interface GetOptions {
+  /** true なら TTL に関わらずブロッキングで再取得し、本文 cache を破棄する。 */
+  fresh?: boolean;
 }
 /**
- * `checkForUpdate` の戻り値。
- * changed: true の場合は最新の ItemWithContent を含む。
+ * `get()` の戻り値。アイテム本体に `render()` が生える。
+ * `render()` を呼んだ時点で初めて本文をロードする lazy 設計。
  */
-type CheckForUpdateResult<T extends BaseContentItem = BaseContentItem> = {
-  changed: false;
-} | {
-  changed: true;
-  item: ItemWithContent<T>;
-};
-/**
- * `checkListForUpdate` の戻り値。
- * changed: true の場合は最新のアイテム配列とバージョンを含む。
- */
-type CheckListForUpdateResult<T extends BaseContentItem = BaseContentItem> = {
-  changed: false;
-} | {
-  changed: true;
-  items: T[];
-  version: string;
+type ItemWithRender<T extends BaseContentItem> = T & {
+  /**
+   * 本文を文字列で返す。デフォルトは HTML。
+   * `format: "markdown"` で Markdown を返す。
+   */
+  render(opts?: {
+    format?: "html" | "markdown";
+  }): Promise<string>;
 };
+/** `cache.warm()` のオプション。 */
+interface WarmOptions {
+  /** 並列度。デフォルトは createCMS の rateLimiter.maxConcurrent。 */
+  concurrency?: number;
+  /** 進捗コールバック。 */
+  onProgress?: (done: number, total: number) => void;
+}
+/** コレクションごとのキャッシュ操作 namespace。 */
+interface CollectionCacheOps<T extends BaseContentItem> {
+  /**
+   * 指定 slug、または slug 省略時はコレクション全体のキャッシュを失効させる。
+   * 次回 `get` / `list` で source から再取得される。
+   */
+  invalidate(slug?: string): Promise<void>;
+  /**
+   * 全アイテムを並列に事前取得・レンダリングしてキャッシュに格納する。
+   * SSG ビルド前のウォームアップに利用する。
+   */
+  warm(opts?: WarmOptions): Promise<{
+    ok: number;
+    failed: number;
+  }>;
+  /** 前後アイテムのナビゲーション (リスト順序ベース)。 */
+  adjacent(slug: string, opts?: AdjacencyOptions<T>): Promise<{
+    prev: T | null;
+    next: T | null;
+  }>;
+}
 /**
  * コレクション別の CMS クライアント。
- * `cms.posts.getItem(slug)` のようにアクセスする。
+ * `cms.posts.get(slug)` / `cms.posts.list()` のようにアクセスする。
  */
 interface CollectionClient<T extends BaseContentItem = BaseContentItem> {
   /**
-   * スラッグで単件取得 (本文込み)。
+   * スラッグで単件取得。アイテム本体に `render()` が生える。
    *
-   * キャッシュヒット時はキャッシュを即時返却する (SWR)。
-   * TTL が切れている場合はブロッキングで Notion から再取得する。
-   * TTL 未設定の場合はキャッシュを即時返却しバックグラウンドで差分チェックする。
-   * 明示的に同期リフレッシュしたい場合は {@link revalidate} を先に呼ぶ。
+   * SWR: TTL 未設定 or 期限内ならキャッシュ即時返却 + バックグラウンド差分チェック。
+   *      TTL 期限切れ、または `opts.fresh === true` でブロッキング取得。
    *
-   * @returns キャッシュまたは Notion から取得したアイテム。存在しない場合は null。
+   * @returns キャッシュまたは source から取得したアイテム。存在しない場合は null。
    */
-  getItem(slug: string): Promise<ItemWithContent<T> | null>;
-  /** 公開済みアイテム一覧 (本文なし、一覧ページ向け)。items とバージョン文字列を返す。 */
-  getList(opts?: GetListOptions<T>): Promise<GetListResult<T>>;
-  /** Next App Router の `generateStaticParams` 向け。 */
-  getStaticParams(): Promise<{
+  get(slug: string, opts?: GetOptions): Promise<ItemWithRender<T> | null>;
+  /** 公開済みアイテム一覧を取得する。 */
+  list(opts?: ListOptions<T>): Promise<T[]>;
+  /** SSG パラメータ生成 (Next App Router の `generateStaticParams` 互換)。 */
+  params(): Promise<{
     slug: string;
   }[]>;
-  /** SSG のパス一覧 (スラッグ配列)。 */
-  getStaticPaths(): Promise<string[]>;
-  /** 前後記事のナビゲーション。 */
-  adjacent(slug: string, opts?: AdjacencyOptions<T>): Promise<{
-    prev: T | null;
-    next: T | null;
-  }>;
-  /**
-   * 指定スラッグのアイテムキャッシュを無効化する。
-   * 次回の getItem 呼び出しで Notion から再取得される。
-   */
-  revalidate(slug: string): Promise<void>;
-  /** コレクション全体のキャッシュを無効化する。 */
-  revalidateAll(): Promise<void>;
-  /**
-   * 指定アイテムが since 以降に更新されたか確認する。
-   * 内部で revalidate → getItem を実行し updatedAt を比較する。
-   * 更新があった場合は最新の ItemWithContent を返す。
-   */
-  checkForUpdate(args: {
-    slug: string;
-    since: string;
-  }): Promise<CheckForUpdateResult<T>>;
-  /**
-   * リスト全体が since 以降に更新されたか確認する。
-   * 内部で revalidateAll → getList を実行しバージョンを比較する。
-   * 更新があった場合は最新の items と version を返す。
-   */
-  checkListForUpdate(args: {
-    since: string;
-    filter?: GetListOptions<T>;
-  }): Promise<CheckListForUpdateResult<T>>;
-  /** 全コンテンツをプリフェッチしてキャッシュに保存。 */
-  prefetch(opts?: {
-    concurrency?: number;
-    onProgress?: (done: number, total: number) => void;
-  }): Promise<{
-    ok: number;
-    failed: number;
-  }>;
+  /** キャッシュ操作 namespace。 */
+  cache: CollectionCacheOps<T>;
 }
 //#endregion
 //#region src/types/config.d.ts
@@ -170,83 +140,67 @@ interface RateLimiterConfig {
   /** リトライ時の基準待機時間（ミリ秒）。デフォルト: 1000 */
   baseDelayMs?: number;
 }
-/** `createCMS({ dataSources })` の map 型。 */
-type DataSourceMap = Record<string, DataSource<any>>;
 /**
- * コレクション別のページ構成セマンティクス。
- * `createCMS({ collections: { posts: { ... } } })` に渡す。
+ * コレクション 1 件の定義。CLI が生成する `nhc.ts` から `createCMS` に渡される。
  *
- * `T` を指定するとコレクション固有の型付きフックを定義できる。
- * `createCMS` の `dataSources` から `T` が自動推論されるため、アプリ側が
- * `CMSHooks<Post>` などを直接記述する必要がなくなる。
+ * `source` は notion-orm 等の DataSource 実装。
+ * `slugField` / `statusField` は TS フィールド名 (DataSource の `properties` キーと一致)。
  */
-interface CollectionSemantics<T extends BaseContentItem = BaseContentItem> {
-  /**
-   * slug として使うフィールド名（必須）。
-   * DataSource の `properties` マップのキーと一致させる。
-   */
-  slug: string;
-  /** status として使うフィールド名。 */
-  status?: string;
-  /**
-   * 公開扱いするステータス値。DataSource 側の `publishedStatuses` より優先される。
-   * 例: ["公開済み", "Published"]
-   */
+interface CollectionDef<T extends BaseContentItem = BaseContentItem> {
+  /** Notion etc. のデータソース実装。 */
+  source: DataSource<T>;
+  /** slug として使う TS フィールド名 (必須)。`source.properties[slugField]` で Notion プロパティ名を解決する。 */
+  slugField: string;
+  /** ステータスとして使う TS フィールド名。 */
+  statusField?: string;
+  /** 公開扱いするステータス値。`list()` のデフォルト絞り込みに使う。 */
   publishedStatuses?: readonly string[];
-  /**
-   * アクセス許可するステータス値。DataSource 側の `accessibleStatuses` より優先される。
-   */
+  /** アクセス許可するステータス値。`get()` の閲覧可否判定に使う。 */
   accessibleStatuses?: readonly string[];
-  /**
-   * コレクション固有のライフサイクルフック。
-   * トップレベルの `hooks` と合成して実行される（グローバルフック → コレクションフックの順）。
-   * `T` が確定しているため `item.item.myField` など独自フィールドに型安全にアクセスできる。
-   */
+  /** コレクション固有のライフサイクルフック。グローバル hooks の後に実行される。 */
   hooks?: CMSHooks<T>;
 }
-/** `DataSourceMap` から各 T を抽出するユーティリティ型。 */
-type InferDataSourceItem<D> = D extends DataSource<infer T> ? T : BaseContentItem;
 /**
- * `createCMS()` に渡すオプション。v1 の正式な入力シグネチャ。
- * ユーザーは `nhc generate` が生成した `cmsDataSources` を渡すだけ。
+ * `createCMS({ collections })` の map 型。
+ * キーがコレクション名、値が `CollectionDef<T>`。
  */
-interface CreateCMSOptions<D extends DataSourceMap = DataSourceMap> {
-  /** コレクション名 → DataSource のマップ (CLI 生成の `cmsDataSources`)。 */
-  dataSources: D;
-  /**
-   * ランタイムプリセット。`cache` / `renderer` のデフォルトを自動設定する。
-   *
-   * - `"node"`: Node.js 向け。`memoryDocumentCache` + `memoryImageCache` を有効化。
-   *   `ttlMs` と組み合わせて SWR の TTL を設定できる。
-   * - `"disabled"`: キャッシュを完全無効化する。
-   * - 省略: 従来の動作（`cache` / `renderer` をそのまま使用）。
-   *   `...nodePreset({ ttlMs })` のスプレッドパターンも引き続き動作する。
-   *
-   * `cache` を明示的に指定した場合は `preset` より `cache` が優先される。
-   *
-   * @example
-   * // Before（スプレッドが必要だった）
-   * const cms = createCMS({ ...nodePreset({ ttlMs: 5 * 60_000 }), dataSources });
-   *
-   * // After
-   * const cms = createCMS({ dataSources, preset: "node", ttlMs: 5 * 60_000 });
-   */
-  preset?: "node" | "disabled";
+type CollectionsConfig = Record<string, CollectionDef<any>>;
+/** `CollectionsConfig` から各 T を抽出するユーティリティ型。 */
+type InferCollectionItem<C> = C extends CollectionDef<infer T> ? T : BaseContentItem;
+/**
+ * `createCMS()` の入力。
+ * 通常は CLI が生成した `nhc.ts` の `createCMS` がこの型をラップする。
+ *
+ * @example
+ * createCMS({
+ *   collections: {
+ *     posts: {
+ *       source: createNotionCollection({ token, dataSourceId, properties }),
+ *       slugField: "slug",
+ *       statusField: "status",
+ *       publishedStatuses: ["公開済み"],
+ *     }
+ *   },
+ *   cache: memoryCache({ ttlMs: 5 * 60_000 }),
+ * });
+ */
+interface CreateCMSOptions<C extends CollectionsConfig = CollectionsConfig> {
+  /** コレクション定義のマップ。 */
+  collections: C;
   /**
-   * SWR キャッシュの有効期間（ミリ秒）。`preset` と組み合わせて使用する。
-   * `cache` オブジェクトを直接渡す場合は `cache.ttlMs` を使用すること。
-   *
-   * @example
-   * const cms = createCMS({ dataSources, preset: "node", ttlMs: 5 * 60_000 });
+   * キャッシュアダプタ (単体または配列)。未指定時はキャッシュなし。
+   * - `memoryCache()` のように doc + image 両方を担当するもの
+   * - `r2Cache()` (image のみ)、`kvCache()` (doc のみ) のように片側のみ担当するもの
+   * - 配列で組み合わせると、各 adapter の `handles` で振り分けられる
    */
+  cache?: CacheAdapter | readonly CacheAdapter[];
+  /** SWR の有効期間 (ミリ秒)。未設定時は TTL なし (失効まで stale を返す)。 */
   ttlMs?: number;
-  /** レンダラー関数。未指定時は @notion-headless-cms/renderer の renderMarkdown を使用。 */
+  /** カスタムレンダラー。未指定時は `@notion-headless-cms/renderer` の `renderMarkdown` を動的 import。 */
   renderer?: RendererFn;
-  /** キャッシュ設定。未設定時はキャッシュなし。 */
-  cache?: CacheConfig;
-  /** レンダリング・コンテンツ処理設定。 */
-  content?: ContentConfig;
-  /** Cloudflare Workers の waitUntil に相当する非同期処理の登録関数。 */
+  /** 画像プロキシのベース URL。デフォルト `/api/images`。 */
+  imageProxyBase?: string;
+  /** Cloudflare Workers の `waitUntil` に相当する非同期処理の登録関数。 */
   waitUntil?: (p: Promise<unknown>) => void;
   /** ライフサイクルフック (全コレクション共通)。 */
   hooks?: CMSHooks<any>;
@@ -254,43 +208,12 @@ interface CreateCMSOptions<D extends DataSourceMap = DataSourceMap> {
   plugins?: CMSPlugin<any>[];
   /** ロガー。 */
   logger?: Logger;
-  /**
-   * ログレベルの下限。指定したレベル未満のログを内部で抑制する。
-   * Cloudflare Workers の Observability のように debug ログが課金対象になる環境では
-   * `"info"` を指定すると debug ログを出力しなくなる。
-   *
-   * @example
-   * createCMS({ ..., logLevel: "info" }) // debug ログを抑制
-   */
+  /** ログレベルの下限。指定したレベル未満のログを内部で抑制する。 */
   logLevel?: LogLevel;
   /** レートリミット・リトライ設定。 */
   rateLimiter?: RateLimiterConfig;
-  /**
-   * コレクション別のページ構成セマンティクス。
-   * slug・status・公開条件・コレクション固有フックを指定する。
-   * 指定したコレクションでは `slug` が必須（未指定時はエラー）。
-   * 指定したコレクションの `publishedStatuses`/`accessibleStatuses` は
-   * DataSource 側の設定より優先される。
-   *
-   * `hooks` にコレクション固有フックを定義すると、`dataSources` の型から `T` が
-   * 自動推論されるため `CMSHooks<Post>` などを直接書かずに済む。
-   *
-   * @example
-   * createCMS({
-   *   dataSources: { posts: createNotionCollection<Post>({ ... }) },
-   *   collections: {
-   *     posts: {
-   *       slug: "slug",
-   *       status: "status",
-   *       publishedStatuses: ["公開済み"],
-   *       hooks: {
-   *         onCacheHit: (slug, item) => console.log(item.item.title),
-   *       },
-   *     }
-   *   }
-   * })
-   */
-  collections?: { [K in keyof D]?: CollectionSemantics<InferDataSourceItem<D[K]>> };
+  /** レンダリング・コンテンツ処理設定。 */
+  content?: ContentConfig;
 }
 //#endregion
 //#region src/cache.d.ts
@@ -302,6 +225,14 @@ declare function sha256Hex(input: string): Promise<string>;
  */
 declare function isStale(cachedAt: number, ttlMs?: number): boolean;
 //#endregion
+//#region src/cache/noop.d.ts
+/**
+ * 何もキャッシュしないアダプタ。`createCMS({ cache })` 未指定時の内部デフォルト。
+ * テストでも使える。
+ */
+declare const noopDocOps: DocumentCacheOps;
+declare const noopImgOps: ImageCacheOps;
+//#endregion
 //#region src/handler.d.ts
 /** `$handler()` の挙動設定。 */
 interface HandlerOptions {
@@ -318,7 +249,7 @@ interface HandlerOptions {
 }
 /** `$handler()` が内部で依存する CMS 機能の最小セット。 */
 interface HandlerAdapter {
-  imageCache: ImageCacheAdapter;
+  imageCache: ImageCacheOps;
   /** コレクション名で DataSource を取り出し parseWebhook にフォワードする。 */
   parseWebhook(req: Request, webhookSecret: string | undefined): Promise<InvalidateScope | null>;
   revalidate(scope: InvalidateScope): Promise<void>;
@@ -334,45 +265,47 @@ interface HandlerAdapter {
 declare function createHandler(adapter: HandlerAdapter, opts?: HandlerOptions): (req: Request) => Promise<Response>;
 //#endregion
 //#region src/cms.d.ts
-/** `CMSClient<D>` — コレクション別アクセス + グローバル操作の合成型。 */
-type CMSClient<D extends DataSourceMap> = { [K in keyof D]: CollectionClient<InferDataSourceItem<D[K]>> } & CMSGlobalOps<D>;
+/** `CMSClient<C>` — コレクション別アクセス + グローバル操作の合成型。 */
+type CMSClient<C extends CollectionsConfig> = { [K in keyof C]: CollectionClient<InferCollectionItem<C[K]>> } & CMSGlobalOps;
 /** `CMSClient` のグローバル名前空間。`$` プレフィックス。 */
-interface CMSGlobalOps<D extends DataSourceMap> {
+interface CMSGlobalOps {
   /** 登録されているコレクション名の一覧。 */
-  readonly $collections: readonly (keyof D & string)[];
-  /** 全コレクションまたは特定コレクションのキャッシュを無効化する。 */
-  $revalidate(scope?: InvalidateScope): Promise<void>;
+  readonly $collections: readonly string[];
+  /** 全コレクションまたは特定スコープのキャッシュを無効化する。 */
+  $invalidate(scope?: InvalidateScope): Promise<void>;
   /** Web Standard なルーティングハンドラ (画像プロキシ / webhook) を生成する。 */
   $handler(opts?: HandlerOptions): (req: Request) => Promise<Response>;
   /** ハッシュキーでキャッシュ画像を取得する。 */
-  $getCachedImage(hash: string): ReturnType<ImageCacheAdapter["get"]>;
+  $getCachedImage(hash: string): Promise<StorageBinary | null>;
 }
 /**
- * 複数の DataSource を束ねた CMS クライアントを生成する。
- *
- * @example
- * // Node.js（preset を使った簡潔な記法）
- * const cms = createCMS({ dataSources: cmsDataSources, preset: "node", ttlMs: 5 * 60_000 });
+ * 複数の `CollectionDef` を束ねた CMS クライアントを生成する。
  *
- * @example
- * // 従来の spread パターン（引き続き動作する）
- * const cms = createCMS({ ...nodePreset({ ttlMs: 5 * 60_000 }), dataSources: cmsDataSources });
+ * 通常はユーザーが直接呼ぶことはなく、CLI 生成の `nhc.ts` の `createCMS`
+ * (低レベルのこの関数をラップしたもの) を経由する。
  *
  * @example
- * // キャッシュを細かく指定する場合
- * const cms = createCMS({
- *   dataSources,
- *   cache: { document, image, ttlMs: 60_000 },
+ * createCMS({
+ *   collections: {
+ *     posts: {
+ *       source: createNotionCollection({ token, dataSourceId, properties }),
+ *       slugField: "slug",
+ *       statusField: "status",
+ *       publishedStatuses: ["公開済み"],
+ *     }
+ *   },
+ *   cache: memoryCache({ ttlMs: 5 * 60_000 }),
  * });
  */
-declare function createCMS<D extends DataSourceMap>(opts: CreateCMSOptions<D>): CMSClient<D>;
+declare function createCMS<C extends CollectionsConfig>(opts: CreateCMSOptions<C>): CMSClient<C>;
 //#endregion
 //#region src/rendering.d.ts
-/** `buildCachedItem` に必要な CMS の依存を束ねたコンテキスト。 */
+/** 本文レンダリングに必要な依存を束ねたコンテキスト。 */
 interface RenderContext<T extends BaseContentItem> {
   source: DataSource<T>;
   rendererFn: RendererFn | undefined;
-  imgCache: ImageCacheAdapter;
+  imgCache: ImageCacheOps;
+  imgCacheName: string;
   hasImageCache: boolean;
   imageProxyBase: string;
   contentConfig: ContentConfig | undefined;
@@ -404,13 +337,17 @@ declare function withRetry<T>(fn: () => Promise<T>, config: RetryConfig): Promis
 /**
  * コレクション別キャッシュキーを生成する。
  * item: `{collection}:{slug}` / list: `{collection}`
+ *
+ * (Cache adapter 内部のキー戦略はアダプタごとに異なるが、
+ * 表示や再計算用に core 側でも公開ヘルパーを提供する)
  */
 declare function collectionKey(collection: string, slug?: string): string;
 /** 単一コレクションの DataSource + SWR キャッシュ依存を束ねたコンテキスト。 */
 interface CollectionContext<T extends BaseContentItem> {
   collection: string;
   source: DataSource<T>;
-  docCache: DocumentCacheAdapter<T>;
+  docCache: DocumentCacheOps;
+  docCacheName: string;
   render: RenderContext<T>;
   hooks: CMSHooks<T>;
   logger: Logger | undefined;
@@ -421,51 +358,35 @@ interface CollectionContext<T extends BaseContentItem> {
   maxConcurrent: number;
   waitUntil: ((p: Promise<unknown>) => void) | undefined;
   /**
-   * slug として使うフィールド名。
-   * `createCMS({ collections })` で指定した値。
-   * 設定時は `source.properties[slugField].notion` を Notion プロパティ名として
+   * slug として使うフィールド名 (CLI 生成の `CollectionDef.slugField`)。
+   * `source.properties[slugField].notion` を Notion プロパティ名として
    * `findByProp` を呼び出す。
    */
-  slugField?: string;
+  slugField: string;
 }
 /** CollectionClient の実装。ユーザーは `createCMS` 経由でインスタンスを受け取る。 */
 declare class CollectionClientImpl<T extends BaseContentItem> implements CollectionClient<T> {
   private readonly ctx;
+  readonly cache: CollectionCacheOps<T>;
   constructor(ctx: CollectionContext<T>);
-  getItem(slug: string): Promise<ItemWithContent<T> | null>;
-  getList(opts?: GetListOptions<T>): Promise<GetListResult<T>>;
-  getStaticParams(): Promise<{
+  get(slug: string, opts?: GetOptions): Promise<ItemWithRender<T> | null>;
+  list(opts?: ListOptions<T>): Promise<T[]>;
+  params(): Promise<{
     slug: string;
   }[]>;
-  getStaticPaths(): Promise<string[]>;
-  adjacent(slug: string, opts?: AdjacencyOptions<T>): Promise<{
-    prev: T | null;
-    next: T | null;
-  }>;
-  revalidate(slug: string): Promise<void>;
-  revalidateAll(): Promise<void>;
-  checkForUpdate({
-    slug,
-    since
-  }: {
-    slug: string;
-    since: string;
-  }): Promise<CheckForUpdateResult<T>>;
-  checkListForUpdate({
-    since,
-    filter
-  }: {
-    since: string;
-    filter?: GetListOptions<T>;
-  }): Promise<CheckListForUpdateResult<T>>;
-  prefetch(opts?: {
-    concurrency?: number;
-    onProgress?: (done: number, total: number) => void;
-  }): Promise<{
-    ok: number;
-    failed: number;
-  }>;
-  private attachContent;
+  private invalidateImpl;
+  private warmImpl;
+  private adjacentImpl;
+  private persistMeta;
+  private invalidateContent;
+  /**
+   * 本文キャッシュをロードする。キャッシュが無いか、メタとの整合性が取れない場合は
+   * 再生成して書き戻す。
+   */
+  private loadOrBuildContent;
+  /** メタ既知の状態で本文だけバックグラウンド再生成する。エラーは握りつぶす。 */
+  private rebuildContentBg;
+  private attachLazyContent;
   private fetchList;
   private checkAndUpdateItemBg;
   private checkAndUpdateListBg;
@@ -473,35 +394,5 @@ declare class CollectionClientImpl<T extends BaseContentItem> implements Collect
   private findRaw;
 }
 //#endregion
-//#region src/preset-node.d.ts
-/** `nodePreset()` のオプション。 */
-interface NodePresetOptions {
-  /**
-   * キャッシュ設定。
-   * - 省略時: memoryDocumentCache + memoryImageCache をデフォルト有効化
-   * - `"disabled"`: キャッシュを完全無効化
-   * - オブジェクト: 任意の cache adapter を差し込む
-   */
-  cache?: CacheConfig | "disabled";
-  /** SWR の TTL (ミリ秒)。`cache` をオブジェクトで渡した場合はそちらが優先される。 */
-  ttlMs?: number;
-  /** カスタムレンダラー。未指定時は core が @notion-headless-cms/renderer を動的ロード。 */
-  renderer?: RendererFn;
-}
-/**
- * Node.js ランタイム向けの `createCMS` オプションプリセット。
- * メモリキャッシュをデフォルト有効にした `{ cache, renderer }` を返す。
- *
- * @example
- * import { createCMS, nodePreset } from "@notion-headless-cms/core";
- * import { cmsDataSources } from "./generated/cms-schema";
- *
- * const cms = createCMS({
- *   ...nodePreset({ ttlMs: 5 * 60_000 }),
- *   dataSources: cmsDataSources,
- * });
- */
-declare function nodePreset(opts?: NodePresetOptions): Pick<CreateCMSOptions, "cache" | "renderer">;
-//#endregion
-export { type AdjacencyOptions, type BaseContentItem, type BuiltInCMSErrorCode, type CMSClient, CMSError, type CMSErrorCode, type CMSErrorContext, type CMSGlobalOps, type CMSHooks, type CMSPlugin, type CMSSchema, type CMSSchemaProperties, type CacheConfig, type CachedItem, type CachedItemList, type CheckForUpdateResult, type CheckListForUpdateResult, type CollectionClient, CollectionClientImpl, type CollectionConfig, type CollectionContext, type CollectionSemantics, type ContentBlock, type ContentConfig, type ContentResult, type CreateCMSOptions, DEFAULT_RETRY_CONFIG, type DataSource, type DataSourceFactory, type DataSourceMap, type DocumentCacheAdapter, type GetListOptions, type GetListResult, type HandlerAdapter, type HandlerOptions, type ImageCacheAdapter, type ImageRef, type InferCollectionItem, type InferDataSourceItem, type InlineNode, type InvalidateScope, type ItemWithContent, type Logger, type MaybePromise, type MemoryDocumentCacheOptions, type MemoryImageCacheOptions, type NodePresetOptions, type PropertyDef, type PropertyMap, type RateLimiterConfig, type RenderOptions, type RendererFn, type RendererPluginList, type RetryConfig, type SortOption, type StorageBinary, type WebhookConfig, collectionKey, createCMS, createHandler, definePlugin, isCMSError, isCMSErrorInNamespace, isStale, memoryDocumentCache, memoryImageCache, mergeHooks, mergeLoggers, nodePreset, noopDocumentCache, noopImageCache, sha256Hex, withRetry };
+export { type AdjacencyOptions, type BaseContentItem, type BuiltInCMSErrorCode, type CMSClient, CMSError, type CMSErrorCode, type CMSErrorContext, type CMSGlobalOps, type CMSHooks, type CMSPlugin, type CMSSchemaProperties, type CacheAdapter, type CachedItemContent, type CachedItemList, type CachedItemMeta, type CollectionCacheOps, type CollectionClient, CollectionClientImpl, type CollectionContext, type CollectionDef, type CollectionsConfig, type ContentBlock, type ContentConfig, type ContentResult, type CreateCMSOptions, DEFAULT_RETRY_CONFIG, type DataSource, type DocumentCacheOps, type GetOptions, type HandlerAdapter, type HandlerOptions, type ImageCacheOps, type ImageRef, type InferCollectionItem, type InlineNode, type InvalidateKind, type InvalidateScope, type ItemWithRender, type ListOptions, type LogLevel, type Logger, type MaybePromise, type MemoryCacheOptions, type PropertyDef, type PropertyMap, type RateLimiterConfig, type RenderOptions, type RendererFn, type RendererPluginList, type RetryConfig, type SortOption, type StorageBinary, type WarmOptions, type WebhookConfig, collectionKey, createCMS, createHandler, definePlugin, isCMSError, isCMSErrorInNamespace, isStale, memoryCache, mergeHooks, mergeLoggers, noopDocOps, noopImgOps, sha256Hex, withRetry };
 //# sourceMappingURL=index.d.mts.map