@notion-headless-cms/core 0.1.3 → 0.2.0

package/dist/index.d.mts

@@ -1,84 +1,10 @@
 import { a as StorageBinary, i as CachedItemList, n as CMSSchemaProperties, r as CachedItem, t as BaseContentItem } from "./content-BrwEY2_p.mjs";
-import { i as InvalidateScope, n as DocumentCacheAdapter, r as ImageCacheAdapter, t as CacheConfig } from "./cache-B-MG4yyg.mjs";
+import { a as CollectionConfig, c as InferCollectionItem, d as ContentBlock, f as ContentResult, i as CMSSchema, l as InvalidateScope, m as InlineNode, n as DocumentCacheAdapter, o as DataSource, p as ImageRef, r as ImageCacheAdapter, s as DataSourceFactory, t as CacheConfig, u as WebhookConfig } from "./cache-Av7HRw_s.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-DCSAQkST.mjs";
 import { MemoryDocumentCacheOptions, MemoryImageCacheOptions, memoryCache, memoryDocumentCache, memoryImageCache } from "./cache/memory.mjs";
 import { noopDocumentCache, noopImageCache } from "./cache/noop.mjs";
 import { CMSError, CMSErrorCode, CMSErrorContext, isCMSError, isCMSErrorInNamespace } from "./errors.mjs";
 
-//#region src/content/blocks.d.ts
-/**
- * CMS 本文の中間表現 (AST)。
- *
- * DataSource が本文をこの配列にノーマライズして返す。
- * レンダラー (`blocksToHtml`) やカスタム React コンポーネントは
- * この型だけを扱えばよい。
- *
- * 対応が難しいブロック (Notion の column / synced block など) は
- * `{ type: "raw", html }` にフォールバックする。
- */
-type ContentBlock = {
-  type: "paragraph";
-  children: InlineNode[];
-} | {
-  type: "heading";
-  level: 1 | 2 | 3;
-  children: InlineNode[];
-} | {
-  type: "image";
-  src: string;
-  alt?: string;
-  cachedHash?: string;
-} | {
-  type: "code";
-  lang?: string;
-  value: string;
-} | {
-  type: "list";
-  ordered: boolean;
-  items: ContentBlock[][];
-} | {
-  type: "quote";
-  children: ContentBlock[];
-} | {
-  type: "divider";
-} | {
-  type: "raw";
-  html: string;
-};
-/** paragraph / heading 等の子に並ぶインラインノード。 */
-type InlineNode = {
-  type: "text";
-  value: string;
-  bold?: boolean;
-  italic?: boolean;
-  code?: boolean;
-} | {
-  type: "link";
-  url: string;
-  children: InlineNode[];
-} | {
-  type: "break";
-};
-/**
- * `getItem({ include: { content: true } })` で返される本文。
- * blocks は常に同梱。html / markdown は遅延生成。
- */
-interface ContentResult {
-  /** 本文の AST (第一級)。 */
-  blocks: ContentBlock[];
-  /** 遅延 HTML。renderer が必要な場合のみ呼ぶ。 */
-  html(): Promise<string>;
-  /** 遅延 Markdown。 */
-  markdown(): Promise<string>;
-}
-/** 画像参照 (DataSource.resolveImageUrl に渡す)。 */
-interface ImageRef {
-  /** 元の Notion 画像 URL (期限切れの可能性あり)。 */
-  originalUrl: string;
-  /** 関連するアイテム ID。 */
-  itemId?: string;
-}
-//#endregion
 //#region src/types/collection.d.ts
 /** 並び順指定。 */
 interface SortOption<T extends BaseContentItem = BaseContentItem> {
@@ -144,95 +70,6 @@ interface CollectionClient<T extends BaseContentItem = BaseContentItem> {
   }>;
 }
 //#endregion
-//#region src/types/data-source.d.ts
-/**
- * キャッシュ無効化のスコープ (DataSource 層で参照する形)。
- */
-type InvalidateScope$1 = "all" | {
-  collection: string;
-} | {
-  collection: string;
-  slug: string;
-};
-/**
- * Webhook 受信時の検証設定。
- */
-interface WebhookConfig {
-  /** 署名検証用シークレット。 */
-  secret?: string;
-}
-/**
- * コンテンツソースを抽象化する v1 インターフェース。
- *
- * ユーザーは直接実装しない。`notion-orm` 等の ORM パッケージが実装する。
- * core は Notion 固有の知識を持たず、このインターフェース経由でのみデータを扱う。
- * 将来 `googledocs-orm` 等の別ソースもこの I/F を満たせば差し替え可能。
- */
-interface DataSource<T extends BaseContentItem = BaseContentItem> {
-  /** ソース識別子 (ロギング・デバッグ用)。 */
-  readonly name: string;
-  /** 公開扱いするステータス値 (ORM 側デフォルト)。 */
-  readonly publishedStatuses?: readonly string[];
-  /** アクセス許可するステータス値 (ORM 側デフォルト)。 */
-  readonly accessibleStatuses?: readonly string[];
-  /** 公開済みアイテム一覧を取得する。 */
-  list(opts?: {
-    publishedStatuses?: readonly string[];
-  }): Promise<T[]>;
-  /** スラッグで単件取得。見つからなければ null。 */
-  findBySlug(slug: string): Promise<T | null>;
-  /** アイテム本文を ContentBlock 配列で返す。 */
-  loadBlocks(item: T): Promise<ContentBlock[]>;
-  /** アイテム本文を Markdown 文字列で返す (html() 生成の元ソース)。 */
-  loadMarkdown(item: T): Promise<string>;
-  /** SWR 鮮度判定用。item の最終更新タイムスタンプ。 */
-  getLastModified(item: T): string;
-  /** リスト全体のバージョン文字列 (例: 最新 last_edited_time)。 */
-  getListVersion(items: T[]): string;
-  /** 期限切れ画像 URL の再取得 (Notion の署名 URL 対応)。 */
-  resolveImageUrl?(ref: ImageRef): Promise<string>;
-  /**
-   * Webhook リクエストをパースして無効化スコープを返す。
-   * 実装していない場合は `$handler` が body の `{ slug }` にフォールバック。
-   */
-  parseWebhook?(req: Request, config: WebhookConfig): Promise<InvalidateScope$1>;
-}
-/**
- * `nhcSchema` の各コレクション設定エントリ。
- * ユーザーは CLI 生成の `nhcSchema` を渡すだけで、
- * この型は `createCMS` 内部で DataSource のファクトリに渡される。
- */
-interface CollectionConfig<T extends BaseContentItem = BaseContentItem> {
-  /** Notion データソース (database) ID。 */
-  databaseId: string;
-  /** スキーマ情報 (ORM が解釈する不透明データ)。 */
-  schema?: any;
-  /** 公開扱いするステータス値。 */
-  publishedStatuses?: string[];
-  /** アクセス許可するステータス値。 */
-  accessibleStatuses?: string[];
-  /** `T` を型レベルで持ち回るためのマーカー (ランタイム値なし)。 */
-  __itemType?: T;
-}
-/**
- * `nhc generate` が生成する `nhcSchema` の型。
- * コレクション名をキーとして、各コレクションの設定を保持する。
- */
-type NHCSchema = Record<string, CollectionConfig<any>>;
-/** `CollectionConfig<T>` から `T` を抽出するユーティリティ型。 */
-type InferCollectionItem<C> = C extends CollectionConfig<infer T> ? T : BaseContentItem;
-/**
- * DataSource を生成するファクトリ関数の型。
- * `createCMS` はコレクション名 → この関数 → DataSource の経路で組み立てる。
- *
- * ユーザーコードは直接呼ばない。`@notion-headless-cms/notion-orm` 等が provide する。
- */
-type DataSourceFactory = <T extends BaseContentItem>(args: {
-  collection: string;
-  config: CollectionConfig<T>;
-  notionToken: string;
-}) => DataSource<T>;
-//#endregion
 //#region src/types/config.d.ts
 /**
  * renderer プラグインの不透明型。
@@ -277,11 +114,38 @@ type DataSourceMap = Record<string, DataSource<any>>;
 type InferDataSourceItem<D> = D extends DataSource<infer T> ? T : BaseContentItem;
 /**
  * `createCMS()` に渡すオプション。v1 の正式な入力シグネチャ。
- * ユーザーは `nhc generate` が生成した `nhcDataSources` を渡すだけ。
+ * ユーザーは `nhc generate` が生成した `cmsDataSources` を渡すだけ。
  */
 interface CreateCMSOptions<D extends DataSourceMap = DataSourceMap> {
-  /** コレクション名 → DataSource のマップ (CLI 生成の `nhcDataSources`)。 */
+  /** コレクション名 → 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";
+  /**
+   * SWR キャッシュの有効期間（ミリ秒）。`preset` と組み合わせて使用する。
+   * `cache` オブジェクトを直接渡す場合は `cache.ttlMs` を使用すること。
+   *
+   * @example
+   * const cms = createCMS({ dataSources, preset: "node", ttlMs: 5 * 60_000 });
+   */
+  ttlMs?: number;
   /** レンダラー関数。未指定時は @notion-headless-cms/renderer の renderMarkdown を使用。 */
   renderer?: RendererFn;
   /** キャッシュ設定。未設定時はキャッシュなし。 */
@@ -327,8 +191,8 @@ interface HandlerOptions {
 interface HandlerAdapter {
   imageCache: ImageCacheAdapter;
   /** コレクション名で DataSource を取り出し parseWebhook にフォワードする。 */
-  parseWebhook(req: Request, webhookSecret: string | undefined): Promise<InvalidateScope$1 | null>;
-  revalidate(scope: InvalidateScope$1): Promise<void>;
+  parseWebhook(req: Request, webhookSecret: string | undefined): Promise<InvalidateScope | null>;
+  revalidate(scope: InvalidateScope): Promise<void>;
 }
 /**
  * Web Standard な Request → Response ルーター。
@@ -348,7 +212,7 @@ interface CMSGlobalOps<D extends DataSourceMap> {
   /** 登録されているコレクション名の一覧。 */
   readonly $collections: readonly (keyof D & string)[];
   /** 全コレクションまたは特定コレクションのキャッシュを無効化する。 */
-  $revalidate(scope?: InvalidateScope$1): Promise<void>;
+  $revalidate(scope?: InvalidateScope): Promise<void>;
   /** Web Standard なルーティングハンドラ (画像プロキシ / webhook) を生成する。 */
   $handler(opts?: HandlerOptions): (req: Request) => Promise<Response>;
   /** ハッシュキーでキャッシュ画像を取得する。 */
@@ -358,13 +222,19 @@ interface CMSGlobalOps<D extends DataSourceMap> {
  * 複数の DataSource を束ねた CMS クライアントを生成する。
  *
  * @example
+ * // Node.js（preset を使った簡潔な記法）
+ * const cms = createCMS({ dataSources: cmsDataSources, preset: "node", ttlMs: 5 * 60_000 });
+ *
+ * @example
+ * // 従来の spread パターン（引き続き動作する）
+ * const cms = createCMS({ ...nodePreset({ ttlMs: 5 * 60_000 }), dataSources: cmsDataSources });
+ *
+ * @example
+ * // キャッシュを細かく指定する場合
  * const cms = createCMS({
- *   dataSources: {
- *     posts: createNotionCollection({ token, databaseId, schema }),
- *   },
+ *   dataSources,
  *   cache: { document, image, ttlMs: 60_000 },
  * });
- * const post = await cms.posts.getItem("my-slug");
  */
 declare function createCMS<D extends DataSourceMap>(opts: CreateCMSOptions<D>): CMSClient<D>;
 //#endregion
@@ -445,5 +315,35 @@ declare class CollectionClientImpl<T extends BaseContentItem> implements Collect
   private findRaw;
 }
 //#endregion
-export { type AdjacencyOptions, type BaseContentItem, type CMSClient, CMSError, type CMSErrorCode, type CMSErrorContext, type CMSGlobalOps, type CMSHooks, type CMSPlugin, type CMSSchemaProperties, type CacheConfig, type InvalidateScope as CacheInvalidateScope, type CachedItem, type CachedItemList, type CollectionClient, CollectionClientImpl, type CollectionConfig, type CollectionContext, type ContentBlock, type ContentConfig, type ContentResult, type CreateCMSOptions, DEFAULT_RETRY_CONFIG, type DataSource, type DataSourceFactory, type DataSourceMap, type DocumentCacheAdapter, type GetListOptions, type HandlerAdapter, type HandlerOptions, type ImageCacheAdapter, type ImageRef, type InferCollectionItem, type InferDataSourceItem, type InlineNode, type InvalidateScope$1 as InvalidateScope, type ItemWithContent, type Logger, type MaybePromise, type MemoryDocumentCacheOptions, type MemoryImageCacheOptions, type NHCSchema, type RateLimiterConfig, type RenderOptions, type RendererFn, type RendererPluginList, type RetryConfig, type SortOption, type StorageBinary, type WebhookConfig, collectionKey, createCMS, createHandler, definePlugin, isCMSError, isCMSErrorInNamespace, isStale, memoryCache, memoryDocumentCache, memoryImageCache, mergeHooks, mergeLoggers, noopDocumentCache, noopImageCache, sha256Hex, withRetry };
+//#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 CMSClient, CMSError, type CMSErrorCode, type CMSErrorContext, type CMSGlobalOps, type CMSHooks, type CMSPlugin, type CMSSchema, type CMSSchemaProperties, type CacheConfig, type CachedItem, type CachedItemList, type CollectionClient, CollectionClientImpl, type CollectionConfig, type CollectionContext, type ContentBlock, type ContentConfig, type ContentResult, type CreateCMSOptions, DEFAULT_RETRY_CONFIG, type DataSource, type DataSourceFactory, type DataSourceMap, type DocumentCacheAdapter, type GetListOptions, 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 RateLimiterConfig, type RenderOptions, type RendererFn, type RendererPluginList, type RetryConfig, type SortOption, type StorageBinary, type WebhookConfig, collectionKey, createCMS, createHandler, definePlugin, isCMSError, isCMSErrorInNamespace, isStale, memoryCache, memoryDocumentCache, memoryImageCache, mergeHooks, mergeLoggers, nodePreset, noopDocumentCache, noopImageCache, sha256Hex, withRetry };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -450,6 +450,35 @@ function trimTrailingSlash(s) {
 	return s.endsWith("/") ? s.slice(0, -1) : s;
 }
 //#endregion
+//#region src/preset-node.ts
+/**
+* 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,
+* });
+*/
+function nodePreset(opts = {}) {
+	if (opts.cache === "disabled") return {
+		cache: void 0,
+		renderer: opts.renderer
+	};
+	return {
+		cache: opts.cache ?? {
+			document: memoryDocumentCache(),
+			image: memoryImageCache(),
+			ttlMs: opts.ttlMs
+		},
+		renderer: opts.renderer
+	};
+}
+//#endregion
 //#region src/cms.ts
 const DEFAULT_IMAGE_PROXY_BASE = "/api/images";
 function resolveDocumentCache(cache) {
@@ -500,35 +529,62 @@ function scopeDocumentCache(base, collection) {
 		async invalidate(scope) {
 			if (!base.invalidate) return;
 			if (scope === "all") return base.invalidate({ collection });
-			if ("slug" in scope && !("collection" in scope)) return base.invalidate({
-				collection,
-				slug: scope.slug
-			});
 			return base.invalidate(scope);
 		}
 	};
 }
 /**
+* `preset` オプションを解決して `cache` / `renderer` のデフォルトを補完する内部関数。
+* 明示的な `cache` / `renderer` がある場合はそちらが優先される。
+* `preset` 未指定時は opts をそのまま返す（後方互換）。
+*/
+function resolvePreset(opts) {
+	if (opts.preset === "disabled") return {
+		...opts,
+		cache: void 0
+	};
+	if (opts.preset === "node") {
+		const presetResult = nodePreset({ ttlMs: opts.ttlMs });
+		return {
+			...opts,
+			cache: opts.cache ?? presetResult.cache,
+			renderer: opts.renderer ?? presetResult.renderer
+		};
+	}
+	return opts;
+}
+/**
 * 複数の DataSource を束ねた CMS クライアントを生成する。
 *
 * @example
+* // Node.js（preset を使った簡潔な記法）
+* const cms = createCMS({ dataSources: cmsDataSources, preset: "node", ttlMs: 5 * 60_000 });
+*
+* @example
+* // 従来の spread パターン（引き続き動作する）
+* const cms = createCMS({ ...nodePreset({ ttlMs: 5 * 60_000 }), dataSources: cmsDataSources });
+*
+* @example
+* // キャッシュを細かく指定する場合
 * const cms = createCMS({
-*   dataSources: {
-*     posts: createNotionCollection({ token, databaseId, schema }),
-*   },
+*   dataSources,
 *   cache: { document, image, ttlMs: 60_000 },
 * });
-* const post = await cms.posts.getItem("my-slug");
 */
 function createCMS(opts) {
-	if (!opts.dataSources || Object.keys(opts.dataSources).length === 0) throw new Error("createCMS: dataSources に少なくとも1つのコレクションを指定してください。");
-	const baseDocCache = resolveDocumentCache(opts.cache);
-	const imgCache = resolveImageCache(opts.cache);
-	const hasImageCache = hasImageCacheConfigured(opts.cache);
-	const ttlMs = resolveTtl(opts.cache);
+	if (!opts.dataSources || Object.keys(opts.dataSources).length === 0) throw new CMSError({
+		code: "core/config_invalid",
+		message: "createCMS: dataSources に少なくとも1つのコレクションを指定してください。",
+		context: { operation: "createCMS" }
+	});
+	const resolved = resolvePreset(opts);
+	const baseDocCache = resolveDocumentCache(resolved.cache);
+	const imgCache = resolveImageCache(resolved.cache);
+	const hasImageCache = hasImageCacheConfigured(resolved.cache);
+	const ttlMs = resolveTtl(resolved.cache);
 	const imageProxyBase = opts.content?.imageProxyBase ?? DEFAULT_IMAGE_PROXY_BASE;
 	const contentConfig = opts.content;
-	const rendererFn = opts.renderer;
+	const rendererFn = resolved.renderer;
 	const waitUntil = opts.waitUntil;
 	const logger = mergeLoggers(opts.plugins ?? [], opts.logger);
 	const hooks = mergeHooks(opts.plugins ?? [], opts.hooks, logger);
@@ -611,6 +667,6 @@ function definePlugin(plugin) {
 	return plugin;
 }
 //#endregion
-export { CMSError, CollectionClientImpl, DEFAULT_RETRY_CONFIG, collectionKey, createCMS, createHandler, definePlugin, isCMSError, isCMSErrorInNamespace, isStale, memoryCache, memoryDocumentCache, memoryImageCache, mergeHooks, mergeLoggers, noopDocumentCache, noopImageCache, sha256Hex, withRetry };
+export { CMSError, CollectionClientImpl, DEFAULT_RETRY_CONFIG, collectionKey, createCMS, createHandler, definePlugin, isCMSError, isCMSErrorInNamespace, isStale, memoryCache, memoryDocumentCache, memoryImageCache, mergeHooks, mergeLoggers, nodePreset, noopDocumentCache, noopImageCache, sha256Hex, withRetry };
 
 //# sourceMappingURL=index.mjs.map