@notion-headless-cms/adapter-next

Next.js App Router 向けルートハンドラ。@notion-headless-cms/core の CMS インスタンスから、画像プロキシ配信と Revalidate Webhook の GET / POST ハンドラを生成する。

インストール

pnpm add @notion-headless-cms/adapter-next @notion-headless-cms/core

使い方

CMS インスタンスの準備

// app/lib/cms.ts
import { createCMS, nodePreset } from "@notion-headless-cms/core";
import { nextCache } from "@notion-headless-cms/cache-next";
import { cmsDataSources } from "../generated/nhc-schema";

export const cms = createCMS({
  ...nodePreset({
    cache: {
      document: nextCache({ revalidate: 300, tags: ["posts"] }),
    },
    ttlMs: 5 * 60_000,
  }),
  dataSources: cmsDataSources,
});

画像プロキシルート

// app/api/images/[hash]/route.ts
import { cms } from "@/lib/cms";
import { createImageRouteHandler } from "@notion-headless-cms/adapter-next";

export const GET = createImageRouteHandler(cms);

/api/images/[hash] に配置する前提。ハッシュに対応する画像が 存在しない場合は 404 Not Found を返す。

Revalidate Webhook ルート

// app/api/revalidate/route.ts
import { cms } from "@/lib/cms";
import { createRevalidateRouteHandler } from "@notion-headless-cms/adapter-next";

export const POST = createRevalidateRouteHandler(cms, {
  secret: process.env.REVALIDATE_SECRET!,
});

POST /api/revalidate を Authorization: Bearer <REVALIDATE_SECRET> で叩く。 リクエストボディの例:

{ "collection": "posts", "slug": "my-post" }

collection / slug を省略すると全件 ("all") 扱い。レスポンスで { "updated": string[] } が返る。認可失敗時は 401 Unauthorized。

cache-next と組み合わせた場合、invalidate 時に規約タグ nhc:col:<name> / nhc:col:<name>:slug:<slug> が revalidateTag される。

API

createImageRouteHandler(cms)

| 引数 | 型 | 説明 | |---|---|---| | cms | CMSClient | createCMS() の戻り値 |

戻り値: App Router 仕様の GET ハンドラ。

createRevalidateRouteHandler(cms, opts)

| 引数 | 型 | 説明 | |---|---|---| | cms | CMSClient | CMS インスタンス | | opts.secret | string | Authorization: Bearer <secret> と照合するシークレット |

戻り値: POST ハンドラ (request) => Promise<Response>。

関連パッケージ

• @notion-headless-cms/core — CMS エンジン本体
• @notion-headless-cms/cache-next — Next.js ISR 向けキャッシュ
• @notion-headless-cms/renderer — Markdown レンダラー