ブログとリリースノート

npm install notcms
npx notcms init

import { Client } from "notcms";
import type { Schema } from "notcms";

export const schema = {
  releases: {
    id: "your_notion_database_id",
    properties: {
      title: "title",
      language: "select",
      released_at: "date",
      slug: "rich_text",
      version_number: "number",
      products: "multi_select",
    },
  },
} satisfies Schema;

export const nc = new Client({ schema });

type ReleaseSummary = (typeof nc.query.releases.$inferPages)[number];

function releasedAt(release: ReleaseSummary): number | null {
  const value = release.properties.released_at;
  if (!value) return null;

  const timestamp = Date.parse(value);
  return Number.isFinite(timestamp) ? timestamp : null;
}

function isPublished(release: ReleaseSummary): boolean {
  const timestamp = releasedAt(release);
  return timestamp !== null && timestamp <= Date.now();
}

function languageOf(release: ReleaseSummary): string {
  const language = release.properties.language?.trim();
  return language ? language : "ja";
}

export async function getPublishedReleases(language: string) {
  const [pages, error] = await nc.query.releases.list();
  if (error) throw error;

  return (pages ?? [])
    .filter(isPublished)
    .filter((release) => languageOf(release) === language)
    .sort((a, b) => (releasedAt(b) ?? 0) - (releasedAt(a) ?? 0));
}

export function releaseHref(
  release: ReleaseSummary,
  language = languageOf(release)
): string {
  const slug = release.properties.slug?.trim();
  const segment = slug ? slug : release.id;
  return `/releases/${encodeURIComponent(language)}/${encodeURIComponent(segment)}`;
}

export async function getReleaseBySegment(
  language: string,
  segment: string
) {
  const [pages, listError] = await nc.query.releases.list();
  if (listError) throw listError;

  const matches = (pages ?? []).filter(
    (release) =>
      isPublished(release) &&
      languageOf(release) === language &&
      (release.id === segment || release.properties.slug?.trim() === segment)
  );
  if (matches.length !== 1) return null;
  const summary = matches[0];

  const [release, detailError] = await nc.query.releases.get(summary.id);
  if (detailError) throw detailError;
  if (!release || !isPublished(release) || languageOf(release) !== language) {
    return null;
  }
  return release;
}

const language = "ja";
const releases = await getPublishedReleases(language);

if (releases.length === 0) {
  return <p>日本語で公開されたリリースはありません。</p>;
}

return (
  <ul>
    {releases.map((release) => (
      <li key={release.id}>
        <a href={releaseHref(release, language)}>{release.title}</a>
      </li>
    ))}
  </ul>
);

const release = await getReleaseBySegment("ja", "v1-2-0");
if (!release) {
  // 利用するフレームワークで404を返します。
  return null;
}

return (
  <article>
    <h1>{release.title}</h1>
    <div>{release.content}</div>
  </article>
);