@notion-headless-cms/core 0.1.2 → 0.2.0

package/dist/cache-Av7HRw_s.d.mts

@@ -0,0 +1,205 @@
+import { a as StorageBinary, i as CachedItemList, r as CachedItem, t as BaseContentItem } from "./content-BrwEY2_p.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/data-source.d.ts
+/**
+ * キャッシュ無効化のスコープ (DataSource 層で参照する形)。
+ */
+type InvalidateScope = "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>;
+}
+/**
+ * `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 CMSSchema = 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` 等の
+ * ORM パッケージが provide する。ORM 固有のオプション (Notion なら
+ * `{ token }`、Google Docs なら `{ credentials }` 等) は `TOptions` の
+ * generic で受け取る。
+ *
+ * @example
+ * // notion-orm が DataSourceFactory<{ token: string }> として実装する
+ * const factory: DataSourceFactory<{ token: string }> = ({ collection, config, options }) =>
+ *   createNotionCollection({
+ *     token: options.token,
+ *     dataSourceId: config.databaseId,
+ *     schema: config.schema,
+ *   });
+ */
+type DataSourceFactory<TOptions = unknown> = <T extends BaseContentItem>(args: {
+  collection: string;
+  config: CollectionConfig<T>;
+  options: TOptions;
+}) => DataSource<T>;
+//#endregion
+//#region src/types/cache.d.ts
+/** ドキュメントキャッシュを抽象化するインターフェース。 */
+interface DocumentCacheAdapter<T extends BaseContentItem = BaseContentItem> {
+  readonly name: string;
+  getList(): Promise<CachedItemList<T> | null>;
+  setList(data: CachedItemList<T>): Promise<void>;
+  getItem(slug: string): Promise<CachedItem<T> | null>;
+  setItem(slug: string, data: CachedItem<T>): Promise<void>;
+  invalidate?(scope: InvalidateScope): Promise<void>;
+}
+/** 画像キャッシュを抽象化するインターフェース。 */
+interface ImageCacheAdapter {
+  readonly name: string;
+  get(hash: string): Promise<StorageBinary | null>;
+  set(hash: string, data: ArrayBuffer, contentType: string): Promise<void>;
+}
+/**
+ * キャッシュ設定。`"disabled"` を渡すと完全にキャッシュを無効化する。
+ * オブジェクトの場合、document / image それぞれ独立したアダプタを差し込める。
+ */
+type CacheConfig<T extends BaseContentItem = BaseContentItem> = "disabled" | {
+  document?: DocumentCacheAdapter<T>;
+  image?: ImageCacheAdapter; /** キャッシュの有効期間（ミリ秒）。未設定の場合はTTLなし。 */
+  ttlMs?: number;
+};
+//#endregion
+export { CollectionConfig as a, InferCollectionItem as c, ContentBlock as d, ContentResult as f, CMSSchema as i, InvalidateScope as l, InlineNode as m, DocumentCacheAdapter as n, DataSource as o, ImageRef as p, ImageCacheAdapter as r, DataSourceFactory as s, CacheConfig as t, WebhookConfig as u };
+//# sourceMappingURL=cache-Av7HRw_s.d.mts.map

package/dist/content-BrwEY2_p.d.mts

@@ -0,0 +1,53 @@
+//#region src/types/content.d.ts
+/**
+ * ライブラリが動作するために必須なフィールド。
+ * 利用者はこのインターフェースを拡張して独自のコンテンツ型を定義する。
+ *
+ * @example
+ * interface Post extends BaseContentItem {
+ *   title: string;
+ *   author: string;
+ * }
+ * createCMS<Post>({ source: notionAdapter({ ... }) })
+ */
+interface BaseContentItem {
+  /** Notion ページ ID（変更検知に必須）。 */
+  id: string;
+  /** URL キー（必須）。 */
+  slug: string;
+  /** 最終更新タイムスタンプ（変更検知に必須）。 */
+  updatedAt: string;
+  /** コンテンツのステータス。ステータスのない DB では省略可能。 */
+  status?: string;
+  /** 公開日時。日付プロパティのない DB では省略可能。 */
+  publishedAt?: string;
+}
+/** ストレージにキャッシュされたレンダリング済みコンテンツ。 */
+interface CachedItem<T extends BaseContentItem = BaseContentItem> {
+  html: string;
+  item: T;
+  notionUpdatedAt: string;
+  cachedAt: number;
+}
+/** ストレージにキャッシュされたコンテンツ一覧。 */
+interface CachedItemList<T extends BaseContentItem = BaseContentItem> {
+  items: T[];
+  cachedAt: number;
+}
+/** ストレージから取得したバイナリオブジェクト。 */
+interface StorageBinary {
+  data: ArrayBuffer;
+  contentType?: string;
+}
+/** Notionのプロパティ名マッピング（すべてオプション）。 */
+interface CMSSchemaProperties {
+  /** Notionのスラッグプロパティ名。デフォルト: 'Slug' */
+  slug?: string;
+  /** Notionのステータスプロパティ名。デフォルト: 'Status' */
+  status?: string;
+  /** Notionの公開日プロパティ名。デフォルト: 'CreatedAt' */
+  date?: string;
+}
+//#endregion
+export { StorageBinary as a, CachedItemList as i, CMSSchemaProperties as n, CachedItem as r, BaseContentItem as t };
+//# sourceMappingURL=content-BrwEY2_p.d.mts.map

package/dist/errors.d.mts

@@ -0,0 +1,32 @@
+//#region src/errors.d.ts
+type BuiltInCMSErrorCode = "core/config_invalid" | "core/schema_invalid" | "core/notion_orm_missing" | "source/fetch_items_failed" | "source/fetch_item_failed" | "source/load_markdown_failed" | "cache/io_failed" | "cache/image_fetch_failed" | "renderer/failed" | "cli/config_invalid" | "cli/config_load_failed" | "cli/schema_invalid" | "cli/generate_failed" | "cli/init_failed" | "cli/notion_api_failed" | "cli/env_file_not_found";
+/**
+ * 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;
+//#endregion
+export { CMSError, CMSErrorCode, CMSErrorContext, isCMSError, isCMSErrorInNamespace };
+//# sourceMappingURL=errors.d.mts.map

package/dist/errors.mjs

@@ -0,0 +1,24 @@
+//#region src/errors.ts
+var CMSError = class extends Error {
+	code;
+	cause;
+	context;
+	constructor(params) {
+		super(params.message, { cause: params.cause });
+		this.name = "CMSError";
+		this.code = params.code;
+		this.cause = params.cause;
+		this.context = params.context;
+	}
+};
+function isCMSError(error) {
+	return error instanceof CMSError;
+}
+/** エラーコードが特定の名前空間に属するかを判定する（例: "source/"）。 */
+function isCMSErrorInNamespace(error, namespace) {
+	return isCMSError(error) && error.code.startsWith(namespace);
+}
+//#endregion
+export { CMSError, isCMSError, isCMSErrorInNamespace };
+
+//# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["type BuiltInCMSErrorCode =\n\t| \"core/config_invalid\"\n\t| \"core/schema_invalid\"\n\t| \"core/notion_orm_missing\"\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\t| \"cli/config_invalid\"\n\t| \"cli/config_load_failed\"\n\t| \"cli/schema_invalid\"\n\t| \"cli/generate_failed\"\n\t| \"cli/init_failed\"\n\t| \"cli/notion_api_failed\"\n\t| \"cli/env_file_not_found\";\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":";AAiCA,IAAa,WAAb,cAA8B,MAAM;CACnC;CACA;CACA;CAEA,YAAY,QAKT;AACF,QAAM,OAAO,SAAS,EAAE,OAAO,OAAO,OAAO,CAAC;AAC9C,OAAK,OAAO;AACZ,OAAK,OAAO,OAAO;AACnB,OAAK,QAAQ,OAAO;AACpB,OAAK,UAAU,OAAO;;;AAIxB,SAAgB,WAAW,OAAmC;AAC7D,QAAO,iBAAiB;;;AAIzB,SAAgB,sBACf,OACA,WACoB;AACpB,QAAO,WAAW,MAAM,IAAI,MAAM,KAAK,WAAW,UAAU"}

package/dist/hooks-DCSAQkST.d.mts

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

package/dist/hooks.d.mts

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

package/dist/hooks.mjs

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

package/dist/hooks.mjs.map

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