@notion-headless-cms/core 0.1.1 → 0.1.2

package/dist/chunk-V6ML4QE5.js

@@ -0,0 +1,26 @@
+// 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;
+}
+function isCMSErrorInNamespace(error, namespace) {
+  return isCMSError(error) && error.code.startsWith(namespace);
+}
+
+export {
+  CMSError,
+  isCMSError,
+  isCMSErrorInNamespace
+};
+//# sourceMappingURL=chunk-V6ML4QE5.js.map

package/dist/chunk-V6ML4QE5.js.map

@@ -0,0 +1 @@
+{"version":3,"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":";AAyBO,IAAM,WAAN,cAAuB,MAAM;AAAA,EAC1B;AAAA,EACS;AAAA,EACT;AAAA,EAET,YAAY,QAKT;AACF,UAAM,OAAO,SAAS,EAAE,OAAO,OAAO,MAAM,CAAC;AAC7C,SAAK,OAAO;AACZ,SAAK,OAAO,OAAO;AACnB,SAAK,QAAQ,OAAO;AACpB,SAAK,UAAU,OAAO;AAAA,EACvB;AACD;AAEO,SAAS,WAAW,OAAmC;AAC7D,SAAO,iBAAiB;AACzB;AAGO,SAAS,sBACf,OACA,WACoB;AACpB,SAAO,WAAW,KAAK,KAAK,MAAM,KAAK,WAAW,SAAS;AAC5D;","names":[]}

package/dist/content-Biqf0l_o.d.ts

@@ -0,0 +1,51 @@
+/**
+ * ライブラリが動作するために必須なフィールド。
+ * 利用者はこのインターフェースを拡張して独自のコンテンツ型を定義する。
+ *
+ * @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;
+}
+
+export type { BaseContentItem as B, CMSSchemaProperties as C, StorageBinary as S, CachedItem as a, CachedItemList as b };

package/dist/errors.d.ts

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

package/dist/errors.js

@@ -0,0 +1,11 @@
+import {
+  CMSError,
+  isCMSError,
+  isCMSErrorInNamespace
+} from "./chunk-V6ML4QE5.js";
+export {
+  CMSError,
+  isCMSError,
+  isCMSErrorInNamespace
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/hooks-B83RUclt.d.ts

@@ -0,0 +1,41 @@
+import { B as BaseContentItem, a as CachedItem } from './content-Biqf0l_o.js';
+
+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;
+}
+
+interface Logger {
+    debug?: (message: string, context?: Record<string, unknown>) => void;
+    info?: (message: string, context?: Record<string, unknown>) => void;
+    warn?: (message: string, context?: Record<string, unknown>) => void;
+    error?: (message: string, context?: Record<string, unknown>) => void;
+}
+
+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>;
+
+/**
+ * プラグイン配列とダイレクトフックを合成して単一の 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;
+
+export { type CMSHooks as C, type Logger as L, type MaybePromise as M, type CMSPlugin as a, mergeLoggers as b, definePlugin as d, mergeHooks as m };

package/dist/hooks.d.ts

@@ -0,0 +1,2 @@
+import './content-Biqf0l_o.js';
+export { m as mergeHooks, b as mergeLoggers } from './hooks-B83RUclt.js';

package/dist/hooks.js

@@ -0,0 +1,9 @@
+import {
+  mergeHooks,
+  mergeLoggers
+} from "./chunk-4KGKWKKI.js";
+export {
+  mergeHooks,
+  mergeLoggers
+};
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -1,7 +1,13 @@
-import { RendererFn } from '@notion-headless-cms/renderer';
-import { BlockHandler } from '@notion-headless-cms/transformer';
-import { PageObjectResponse, RichTextItemResponse } from '@notionhq/client/build/src/api-endpoints';
-import { PluggableList } from 'unified';
+export { MemoryDocumentCacheOptions, MemoryImageCacheOptions, memoryCache, memoryDocumentCache, memoryImageCache } from './cache/memory.js';
+export { noopDocumentCache, noopImageCache } from './cache/noop.js';
+import { B as BaseContentItem, C as CMSSchemaProperties, a as CachedItem, S as StorageBinary } from './content-Biqf0l_o.js';
+export { b as CachedItemList } from './content-Biqf0l_o.js';
+import { PluggableList } from '@notion-headless-cms/renderer';
+import { C as CacheConfig } from './cache-DvbyemBK.js';
+export { D as DocumentCacheAdapter, I as ImageCacheAdapter } from './cache-DvbyemBK.js';
+import { C as CMSHooks, a as CMSPlugin, L as Logger } from './hooks-B83RUclt.js';
+export { M as MaybePromise, d as definePlugin, m as mergeHooks, b as mergeLoggers } from './hooks-B83RUclt.js';
+export { CMSError, CMSErrorCode, CMSErrorContext, isCMSError, isCMSErrorInNamespace } from './errors.js';
 
 /** 文字列をSHA-256でハッシュ化し、16進数文字列として返す。画像キーの生成に使用。 */
 declare function sha256Hex(input: string): Promise<string>;
@@ -11,103 +17,6 @@ declare function sha256Hex(input: string): Promise<string>;
  */
 declare function isStale(cachedAt: number, ttlMs?: number): boolean;
 
-/**
- * ライブラリが動作するために必須なフィールド。
- * 利用者はこのインターフェースを拡張して独自のコンテンツ型を定義する。
- *
- * @example
- * interface Post extends BaseContentItem {
- *   title: string;
- *   author: string;
- * }
- * createCMS<Post>({ source: notionAdapter({ ... }) })
- */
-interface BaseContentItem {
-    id: string;
-    slug: string;
-    status: string;
-    publishedAt: string;
-    updatedAt: 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;
-}
-
-/** ドキュメントキャッシュを抽象化するインターフェース。 */
-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: "all" | {
-        slug: string;
-    } | {
-        tag: string;
-    }): Promise<void>;
-}
-/** 画像キャッシュを抽象化するインターフェース。 */
-interface ImageCacheAdapter {
-    readonly name: string;
-    get(hash: string): Promise<StorageBinary | null>;
-    set(hash: string, data: ArrayBuffer, contentType: string): Promise<void>;
-}
-/** キャッシュ設定オブジェクト。document / image それぞれ独立したアダプタを差し込める。 */
-interface CacheConfig<T extends BaseContentItem = BaseContentItem> {
-    document?: DocumentCacheAdapter<T> | false;
-    image?: ImageCacheAdapter | false;
-    /** キャッシュの有効期間（ミリ秒）。未設定の場合はTTLなし。 */
-    ttlMs?: number;
-}
-
-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;
-}
-
-interface Logger {
-    debug?: (message: string, context?: Record<string, unknown>) => void;
-    info?: (message: string, context?: Record<string, unknown>) => void;
-    warn?: (message: string, context?: Record<string, unknown>) => void;
-    error?: (message: string, context?: Record<string, unknown>) => void;
-}
-
-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>;
-
 /** ソース側クエリのフィルタ・ソート条件。 */
 interface SourceQueryOptions {
     filter?: {
@@ -145,19 +54,26 @@ interface DataSourceAdapter<T extends BaseContentItem = BaseContentItem> {
     query?(opts: SourceQueryOptions): Promise<SourceQueryResult<T>>;
 }
 
+/**
+ * render() オプション。core は renderer の実装を知らず、この型だけを扱う。
+ * @notion-headless-cms/renderer の renderMarkdown() はこのシグネチャと構造的に互換。
+ */
+interface RenderOptions {
+    imageProxyBase?: string;
+    cacheImage?: (url: string) => Promise<string>;
+    remarkPlugins?: PluggableList;
+    rehypePlugins?: PluggableList;
+}
+/** カスタムレンダラー関数の型。デフォルトは @notion-headless-cms/renderer の renderMarkdown。 */
+type RendererFn = (markdown: string, opts?: RenderOptions) => Promise<string>;
 /** スキーマ設定。公開ステータスのフィルタやプロパティ名マッピングを制御する。 */
 interface SchemaConfig<T extends BaseContentItem = BaseContentItem> {
-    /**
-     * Notionページをコンテンツ型 T にマッピングするカスタム関数。
-     * 指定した場合 properties の設定は無視される（slug プロパティ名のみ例外）。
-     */
-    mapItem?: (page: PageObjectResponse) => T;
-    /** mapItem 未使用時のプロパティ名マッピング。 */
-    properties?: CMSSchemaProperties;
     /** list() で返す「公開済み」ステータス値の配列。デフォルト: [] （全件返す） */
     publishedStatuses?: string[];
     /** findBySlug() でアクセス可能なステータス値の配列。デフォルト: [] （全件許可） */
     accessibleStatuses?: string[];
+    /** mapItem 未使用時のプロパティ名マッピング。source-notion 経由で渡す場合は不要。 */
+    properties?: CMSSchemaProperties;
 }
 /** レンダリング・コンテンツ処理設定。 */
 interface ContentConfig {
@@ -167,10 +83,6 @@ interface ContentConfig {
     remarkPlugins?: PluggableList;
     /** 追加する rehype プラグイン。 */
     rehypePlugins?: PluggableList;
-    /** デフォルトのパイプラインを置き換えるカスタムレンダラー。 */
-    render?: RendererFn;
-    /** カスタムブロックハンドラーのマップ。Notionブロックタイプをキーとする。 */
-    blocks?: Record<string, BlockHandler>;
 }
 /** レートリミット・リトライ設定。 */
 interface RateLimiterConfig {
@@ -190,6 +102,8 @@ interface RateLimiterConfig {
 interface CreateCMSOptions<T extends BaseContentItem = BaseContentItem> {
     /** データソースアダプタ（Notion など）。 */
     source: DataSourceAdapter<T>;
+    /** レンダラー関数。未指定時は @notion-headless-cms/renderer の renderMarkdown を使用。 */
+    renderer?: RendererFn;
     /** キャッシュ設定。未設定時はキャッシュなし。 */
     cache?: CacheConfig<T>;
     /** スキーマ・ステータス設定。 */
@@ -208,21 +122,6 @@ interface CreateCMSOptions<T extends BaseContentItem = BaseContentItem> {
     rateLimiter?: RateLimiterConfig;
 }
 
-/** インメモリキャッシュ（ドキュメント用）を生成する。 */
-declare function memoryDocumentCache<T extends BaseContentItem = BaseContentItem>(): DocumentCacheAdapter<T>;
-/** インメモリキャッシュ（画像用）を生成する。 */
-declare function memoryImageCache(): ImageCacheAdapter;
-/**
- * ドキュメントと画像の両方にインメモリキャッシュを返す便利関数。
- * memoryCache() はドキュメントキャッシュを返す（後方互換）。
- */
-declare function memoryCache<T extends BaseContentItem = BaseContentItem>(): DocumentCacheAdapter<T>;
-
-/** 何もしないドキュメントキャッシュを返す（シングルトン）。 */
-declare function noopDocumentCache<T extends BaseContentItem = BaseContentItem>(): DocumentCacheAdapter<T>;
-/** 何もしない画像キャッシュを返す（シングルトン）。 */
-declare function noopImageCache(): ImageCacheAdapter;
-
 interface QueryResult<T> {
     items: T[];
     total: number;
@@ -252,23 +151,26 @@ declare class QueryBuilder<T extends BaseContentItem> {
     }): this;
     execute(): Promise<QueryResult<T>>;
     executeOne(): Promise<T | null>;
+    /** 前後アイテムを返す。sortBy() で指定したソート順を適用する。 */
     adjacent(slug: string): Promise<{
         prev: T | null;
         next: T | null;
     }>;
+    /** 最初の 1 件を返す。`.paginate({ page: 1, perPage: 1 }).executeOne()` の短縮形。 */
+    first(): Promise<T | null>;
 }
 
-/** キャッシュ優先アクセサ。 */
-interface CachedAccessor<T extends BaseContentItem> {
-    list(): Promise<{
+/** キャッシュ系の公開名前空間。SWR 読み取りとキャッシュ管理を統合する。 */
+interface CacheAccessor<T extends BaseContentItem> {
+    /** キャッシュ優先でコンテンツ一覧を返す（SWR）。 */
+    getList(): Promise<{
         items: T[];
         isStale: boolean;
         cachedAt: number;
     }>;
+    /** キャッシュ優先で単一コンテンツを返す（SWR）。HTML 付きの CachedItem を返す。 */
     get(slug: string): Promise<CachedItem<T> | null>;
-}
-/** キャッシュ管理オペレーション。 */
-interface CacheManager<T extends BaseContentItem> {
+    /** 全コンテンツを事前レンダリングしてキャッシュに保存する。 */
     prefetchAll(opts?: {
         concurrency?: number;
         onProgress?: (done: number, total: number) => void;
@@ -276,20 +178,24 @@ interface CacheManager<T extends BaseContentItem> {
         ok: number;
         failed: number;
     }>;
+    /** 指定スコープのキャッシュを無効化する。 */
     revalidate(scope?: "all" | {
         slug: string;
     }): Promise<void>;
+    /** Webhook ペイロードを元にキャッシュを同期する。 */
     sync(payload?: {
         slug?: string;
     }): Promise<{
         updated: string[];
     }>;
+    /** リスト全体の変更を検知する。version はリスト取得時の buildListVersion の値。 */
     checkList(version: string): Promise<{
         changed: false;
     } | {
         changed: true;
         items: T[];
     }>;
+    /** 単一アイテムの変更を検知し、変更があれば再レンダリングしてキャッシュを更新する。 */
     checkItem(slug: string, lastEdited: string): Promise<{
         changed: false;
     } | {
@@ -307,6 +213,7 @@ interface CacheManager<T extends BaseContentItem> {
  *   source: notionAdapter({ token: '...', dataSourceId: '...' }),
  * });
  * const items = await cms.list();
+ * const entry = await cms.cache.get('my-post');
  */
 declare class CMS<T extends BaseContentItem = BaseContentItem> {
     private readonly source;
@@ -318,157 +225,54 @@ declare class CMS<T extends BaseContentItem = BaseContentItem> {
     private readonly accessibleStatuses;
     private readonly imageProxyBase;
     private readonly contentConfig;
+    private readonly rendererFn;
     private readonly waitUntil;
     private readonly hooks;
     private readonly logger;
     private readonly retryConfig;
-    readonly cached: CachedAccessor<T>;
-    readonly cache: CacheManager<T>;
+    private readonly maxConcurrent;
+    readonly cache: CacheAccessor<T>;
     constructor(opts: CreateCMSOptions<T>);
     /** 公開済みコンテンツ一覧をソースから直接取得する。 */
     list(): Promise<T[]>;
     /** スラッグでコンテンツをソースから直接取得する。 */
     find(slug: string): Promise<T | null>;
-    /** @deprecated find() を使用してください。 */
-    findBySlug(slug: string): Promise<T | null>;
+    /** 複数スラッグをまとめてソースから直接取得する。accessibleStatuses フィルタを適用する。 */
+    findMany(slugs: string[]): Promise<Map<string, T>>;
     /** アイテムが publishedStatuses に含まれるステータスかどうかを返す。 */
     isPublished(item: T): boolean;
-    /** コンテンツを Markdown → HTML にレンダリングし、CachedItem として返す。 */
+    /** コンテンツを Markdown → HTML にレンダリングし、CachedItem として返す。キャッシュには保存しない。 */
     render(item: T): Promise<CachedItem<T>>;
     /** QueryBuilder を返す。ステータス・タグ・ページネーションなどを連鎖で指定できる。 */
     query(): QueryBuilder<T>;
-    /** 全コンテンツを事前レンダリングしてキャッシュに保存する。 */
-    prefetchAll(opts?: {
-        concurrency?: number;
-        onProgress?: (done: number, total: number) => void;
-    }): Promise<{
-        ok: number;
-        failed: number;
-    }>;
     /** 静的生成用のスラッグ一覧を返す。 */
     getStaticSlugs(): Promise<string[]>;
-    /** 指定スコープのキャッシュを無効化する。 */
-    revalidate(scope?: "all" | {
-        slug: string;
-    }): Promise<void>;
-    /** Webhook ペイロードを元にキャッシュを同期する。 */
-    syncFromWebhook(payload?: {
-        slug?: string;
-    }): Promise<{
-        updated: string[];
-    }>;
-    /** キャッシュ優先でコンテンツ一覧を返す（SWR）。 */
-    private cachedList;
-    /** キャッシュ優先で単一コンテンツを返す（SWR）。 */
-    private cachedGet;
-    checkListUpdate(version: string): Promise<{
-        changed: false;
-    } | {
-        changed: true;
-        items: T[];
-    }>;
-    checkItemUpdate(slug: string, lastEdited: string): Promise<{
-        changed: false;
-    } | {
-        changed: true;
-        html: string;
-        item: T;
-        notionUpdatedAt: string;
-    }>;
-    /** @deprecated cached.list() を使用してください。 */
-    getList(): Promise<{
-        items: T[];
-        listVersion: string;
-    }>;
-    /** @deprecated cached.get() を使用してください。 */
-    getItem(slug: string): Promise<CachedItem<T> | null>;
-    /** @deprecated cache.prefetchAll() を使用してください。 */
-    prefetchAllLegacy(opts?: {
-        concurrency?: number;
-        onProgress?: (done: number, total: number) => void;
-    }): Promise<{
-        ok: number;
-        failed: number;
-    }>;
-    /** @deprecated query().status(s).execute() を使用してください。 */
-    listByStatus(status: string | readonly string[]): Promise<T[]>;
-    /** @deprecated query().where(pred).execute() を使用してください。 */
-    where(predicate: (item: T) => boolean): Promise<T[]>;
-    /** @deprecated query().paginate(opts).execute() を使用してください。 */
-    paginate(opts: {
-        page: number;
-        perPage: number;
-    }): Promise<{
-        items: T[];
-        total: number;
-        page: number;
-        perPage: number;
-        hasNext: boolean;
-    }>;
-    /** @deprecated query().adjacent(slug) を使用してください。 */
-    getAdjacent(slug: string): Promise<{
-        prev: T | null;
-        next: T | null;
-    }>;
     /** ハッシュキーでキャッシュ画像を取得する。 */
     getCachedImage(hash: string): Promise<StorageBinary | null>;
     /** ハッシュキーでキャッシュ画像を Response として返す。 */
     createCachedImageResponse(hash: string): Promise<Response | null>;
+    private cachedList;
+    private cachedGet;
+    private prefetchAll;
+    private revalidate;
+    private syncFromWebhook;
+    private checkListUpdate;
+    private checkItemUpdate;
     private buildCachedItem;
 }
 /** 設定済みの CMS インスタンスを生成するファクトリ関数。 */
 declare function createCMS<T extends BaseContentItem = BaseContentItem>(opts: CreateCMSOptions<T>): CMS<T>;
 
-type CMSErrorCode = "CONFIG_INVALID" | "NOTION_ITEM_SCHEMA_INVALID" | "NOTION_FETCH_ITEMS_FAILED" | "NOTION_FETCH_ITEM_BY_SLUG_FAILED" | "NOTION_GET_BLOCKS_FAILED" | "NOTION_MARKDOWN_FETCH_FAILED" | "IMAGE_CACHE_FAILED" | "RENDERER_FAILED";
-interface CMSErrorContext {
-    operation: string;
-    slug?: string;
-    dataSourceId?: string;
-    pageId?: string;
-    [key: string]: string | number | boolean | null | undefined;
-}
-declare class CMSError extends Error {
-    readonly code: CMSErrorCode;
-    readonly cause?: unknown;
-    readonly context: CMSErrorContext;
-    constructor(params: {
-        code: CMSErrorCode;
-        message: string;
-        cause?: unknown;
-        context: CMSErrorContext;
-    });
-}
-declare function isCMSError(error: unknown): error is CMSError;
-
-/**
- * プラグイン配列とダイレクトフックを合成して単一の CMSHooks を返す。
- * beforeCache / afterRender はパイプライン（前の出力が次の入力）。
- * onCacheHit などオブザーバー系は全員に同じ値を渡す。
- */
-declare function mergeHooks<T extends BaseContentItem>(plugins: CMSPlugin<T>[], directHooks?: CMSHooks<T>): CMSHooks<T>;
-/** プラグイン配列とダイレクトロガーを合成して単一の Logger を返す。 */
-declare function mergeLoggers(plugins: Array<{
-    logger?: Partial<Logger>;
-}>, directLogger?: Logger): Logger | undefined;
-
-/** Notionリッチテキスト配列をプレーンテキストに結合する。 */
-declare function getPlainText(items: RichTextItemResponse[] | undefined): string;
-/**
- * NotionのPageObjectResponseをデフォルトの BaseContentItem に変換する。
- * 独自の拡張型（title などを含む）が必要な場合は、本関数の戻り値に
- * 追加フィールドを足してカスタム mapItem を実装する。
- */
-declare function mapItem(page: PageObjectResponse, props: Required<CMSSchemaProperties>): BaseContentItem;
-
 interface RetryConfig {
-    maxConcurrent: number;
     retryOn: number[];
     maxRetries: number;
     baseDelayMs: number;
+    /** true のとき指数バックオフにランダムジッターを加える（Thundering Herd 対策）。デフォルト: true */
+    jitter?: boolean;
     onRetry?: (attempt: number, status: number) => void;
 }
 declare const DEFAULT_RETRY_CONFIG: RetryConfig;
-/** 指数バックオフでリトライする。retryOn に含まれる HTTP エラーのみ対象。 */
+/** 指数バックオフ（オプションでジッター付き）でリトライする。retryOn に含まれる HTTP エラーのみ対象。 */
 declare function withRetry<T>(fn: () => Promise<T>, config: RetryConfig): Promise<T>;
 
-export { type BaseContentItem, CMS, CMSError, type CMSErrorCode, type CMSErrorContext, type CMSHooks, type CMSPlugin, type CMSSchemaProperties, type CacheConfig, type CachedItem, type CachedItemList, type ContentConfig, type CreateCMSOptions, DEFAULT_RETRY_CONFIG, type DataSourceAdapter, type DocumentCacheAdapter, type ImageCacheAdapter, type Logger, type MaybePromise, QueryBuilder, type QueryResult, type RateLimiterConfig, type RetryConfig, type SchemaConfig, type SourceQueryOptions, type SourceQueryResult, type StorageBinary, createCMS, definePlugin, getPlainText, isCMSError, isStale, mapItem, memoryCache, memoryDocumentCache, memoryImageCache, mergeHooks, mergeLoggers, noopDocumentCache, noopImageCache, sha256Hex, withRetry };
+export { BaseContentItem, CMS, CMSHooks, CMSPlugin, CMSSchemaProperties, type CacheAccessor, CacheConfig, CachedItem, type ContentConfig, type CreateCMSOptions, DEFAULT_RETRY_CONFIG, type DataSourceAdapter, Logger, QueryBuilder, type QueryResult, type RateLimiterConfig, type RenderOptions, type RendererFn, type RetryConfig, type SchemaConfig, type SourceQueryOptions, type SourceQueryResult, StorageBinary, createCMS, isStale, sha256Hex, withRetry };