HTTP エンドポイントを追加する
endpoints は、ルーターをプラグインに埋め込まずに HTTP の振る舞いを宣言します。ホスト側のインテグレーションがエンドポイントをルーターへ接続します。スキャフォールドの app/server.ts はすでに mountRiebeckiteEndpoints を呼んでいます。
import { defineEndpoint, definePlugin } from "@riebeckite/core";
export function catalogEndpoint() {
return definePlugin({
name: "catalog-endpoint",
endpoints: [
defineEndpoint(
"/catalog.json",
({ manifest, request }) => {
const tag = request.query.tag;
const entries = manifest.discoverableEntries
.filter((entry) => !tag || entry.tags.includes(tag))
.map((entry) => ({
title: entry.title,
permalink: entry.permalink,
tags: entry.tags,
}));
return { json: entries };
},
{ cacheControl: "public, max-age=300" },
),
],
});
}開発サーバーを起動し、/catalog.json または /catalog.json?tag=typescript にリクエストします。
エンドポイントが返すのは HTTP 応答であり、静的ファイルではありません。ホストが書き出さない限り、純粋な静的エクスポートに /catalog.json は含まれません。ビルド出力にファイルが必要なときは ファイルの生成 を使ってください。
cacheControl は、応答をキャッシュしても安全な場合だけ指定します。この応答はマニフェストに依存するため、通常は短めの max-age が適切です。