HN 日本語サマリー

← 一覧へ戻る
Web開発

Primate 0.40: ルートページ、enumの保存、非同期スキーマとイベント

Primate 0.40: Route pages, store enums, async schemas and events (primate.run)

9 pointsby terrablue4 コメント

要約

WebフレームワークPrimateのバージョン0.40プレリリース版が発表されました。今回のアップデートでは、ルーティングとフロントエンドファイルの連携を強化する「コローケーションルートページ」機能が導入され、React、Vue、Svelteなどの主要フレームワークに対応しています。また、データベースストアでenum型を直接扱えるようになり、スキーマ定義の同期管理が容易になりました。

全文翻訳

Primate 0.40: ルートページ、ストア列挙型、非同期スキーマとイベント

2026年7月12日

本日、Primate 0.40プレビューリリースを発表します。

Primateが初めての方は、クイックスタートページを参照して開始することをお勧めします。

同居するルートページ (Collocated route pages)

Primate 0.40は、同居するルートページをサポートします。viewsからコンポーネントをインポートしてresponse.viewに渡す代わりに、ルートは隣接するフロントエンドファイルをresponse.pageでレンダリングできます。

// routes/post/[id].ts
import response from "primate/response";
import route from "primate/route";

export default route({
  get(request) {
    return response.page({ id: request.path.get("id") });
  },
});

フロントエンドファイルは、ルートと同じベース名を持ち、拡張子のみが異なります。

React Angular Vue Svelte Solid Marko
routes/post/[id].tsx``routes/post/[id].component.ts``routes/post/[id].vue``routes/post/[id].svelte``routes/post/[id].tsx``routes/post/[id].marko

// routes/post/[id].tsx
import type route from "./[id]";

export default function Post(props: typeof route.get.Page) {
  return <h1>Post {props.id}</h1>;
}

ルートはデータロード、バリデーション、リダイレクト、ステータスコードを処理し、ページはレンダリングを処理します。

宣言なしの型付きプロップス

上記のコンポーネント例では、プロップスにtypeof route.get.Pageを使用しています。その型はresponse.page(...)から取得されるため、ルートレスポンスが真実の源であり、同期させるための個別のインターフェースは不要です。

レイアウトページ

レイアウトも同居させることができます。

// routes/admin/+layout.ts
import response from "primate/response";
import route from "primate/route";

export default route({
  get() {
    return response.page({ section: "Admin" });
  },
});

通常のルートと同様に、レイアウトと同じベース名を持つコンポーネントを隣に追加します。

React Angular Vue Svelte Solid Marko
routes/admin/+layout.tsx``routes/admin/+layout.component.ts``routes/admin/+layout.vue``routes/admin/+layout.svelte``routes/admin/+layout.tsx``routes/admin/+layout.marko

// routes/admin/+layout.tsx
import type route from "./+layout";

export default function Layout(
  props: typeof route.get.Page & { children: React.ReactNode },
) {
  return <main data-section={props.section}>{props.children}</main>;
}

対応するレイアウトページは、これらのプロップスと子要素を受け取ります。これにより、ルート固有のUIをルートの近くに配置しつつ、共有コンポーネントや明示的に名前が付けられたビューのために既存のviewsディレクトリを保持できます。

ストア列挙型 (Store enums)

Primate 0.40では、p.enumがストアに参加します。p.u8カラムと、同期していることを願う手動で作成された定数オブジェクトをもう使い分ける必要はありません。1つの宣言で完全に検証され、完全に型付けされ、スキーマと共に列挙型の名前を持ちます。

// stores/Account.ts
import db from "@/config/db";
import p from "pema";
import store from "primate/store";

const Status = p.enum({
  UNCONFIRMED: 0,
  CONFIRMED: 1,
});

export default store({
  table: "account",
  db,
  schema: {
    id: store.key.primary(p.u32),
    email: p.string,
    status: Status,
    created_at: p.date.default(() => new Date()),
  },
}).extend(_Account => ({
  Status,
}));

そして、アプリの他の場所で:

import Account from "@/stores/Account";

const account = await Account.insert({
  email: "john@example.com",
  status: Account.Status.UNCONFIRMED,
});

if (account.status === Account.Status.CONFIRMED) {
  // ...
}

これにより、一般的なドリフトの発生源がいくつか排除されます。

プレーンなストレージ

p.enumは内部的にp.u8でバックアップされているため、0から255までのプレーンな整数として保存されます。方言固有の列挙型タイプや、SQLite、Postgres、MySQL間で管理する必要のあるCHECK制約はありません。u8の既存のカラムマッピングに乗ります。

メンバーシップ検証

p.u8だけでは、2つの値を持つ列挙型に対して7を喜んで受け入れてしまいます。p.enumはメンバーシップも検証します。宣言された値のみが通過します。

1つの宣言された値

列挙型はフィールドであり、更新を忘れるような兄弟定数ではありません。Account.Status.CONFIRMEDは、手動で複製されるのではなく、スキーマから直接生成されます。

逆引き

Account.Status.nameOf(account.status)は、数値だけでなく名前が必要な場合に"CONFIRMED"を返します。

派生および非同期スキーマ (Derived and async schemas)

Pemaスキーマは、解析された値を別の値に派生させることができるようになりました。解析された入力がハンドラに渡される前に正規化される必要がある場合は、.derive(...)を使用します。

import p from "pema";

const FullName = p({
  first: p.string,
  last: p.string,
}).derive(({ first, last }) => `${first} ${last}`);

const name = FullName.parse({ first: "John", last: "Adams" });
// name は "John Adams" です

これは、Pemaスキーマが受け入れられる場所ならどこでも機能します。リクエストボディの場合、派生型はルートハンドラに流れます。

import p from "pema";
import route from "primate/route";

const Body = p({
  name: p.string,
}).derive(({ name }) => name.toUpperCase());

export default route({
  post: route.with(
    { body: Body, contentType: "application/json" },
    async request => {
      const name = await request.body.json();
      // name は string です
      return name;
    },
  ),
});

Primate 0.40は、非同期後処理を必要とするオブジェクトスキーマのためにp.async(...)もサポートしています。そのparse(...)メソッドは常にPromiseを返し、非同期派生は同期派生と同様に構成されます。

import p from "pema";

const User = p.async({
  id: p.string,
}).derive(async ({ id }) => {
  return await loadUser(id);
});

非同期スキーマは、ボディとパスパラメータのためにroute.with(...)でサポートされています。パススキーマの場合、p.async(...)はオブジェクトの形状を可視のままにするため、Primateはビルド時にルートパラメータとスキーマプロパティが一致するかどうかを確認できます。

// routes/user/[id].ts
import p from "pema";
import route from "primate/route";

const Path = p.async({
  id: p.string,
}).derive(async ({ id }) => ({
  id: await resolveUserId(id),
}));

export default route({
  get: route.with({ path: Path }, request => {
    return request.path.get("id");
  }),
});

同期変換には通常の.derive(...)を使用します。スキーマがI/Oを待機したり、データをルックアップしたり、ハンドラが値を見る前に別の非同期正規化ステップを実行する必要がある場合は、p.async(...)を使用してください。

イベントとよりシンプルなSSEクリーンアップ

response.sseは、個別のopenとcloseコールバックの代わりに、単一のセットアップ関数を使用するようになりました。ブラウザが切断したときにタイマーを停止したり、購読を解除したりするために、クリーンアップ関数を返します。

import response from "primate/response";
import route from "primate/route";

export default route({
  get() {
    return response.sse(source => {
      const timer = setInterval(() => {
        source.send("tick", Date.now());
      }, 1000);

      return () => clearInterval(timer);
    });
  },
});

Primate 0.40には、キー付き購読のためのインメモリチャネルヘルパーであるprimate/eventsも含まれています。

// services/DeploymentEvents.ts
import events from "primate/events";

type DeploymentEvent = {
  type: "step";
  key: number;
  status: "running" | "done" | "error";
};

export default events.channel<number, DeploymentEvent>();

キーで発行し、同じキーで購読し、response.sseからアンサブスクライブ関数を返します。

return response.sse(source => {
  return DeploymentEvents.subscribe(deployment.id, event => {
    source.send(event.type, event);
  });
});

チャネルは意図的に1つのサーバープロセスにローカルです。イベントを永続化したり、複数の実行インスタンス間でブロードキャストしたりしません。

マイナーな改善

アプリのインポートが@/に移動

新しいPrimateアプリは、以前の#エイリアスのファミリーの代わりに、アプリのインポートに単一の@/* TypeScriptパスエイリアスを使用するようになりました。これにより、パッケージ内部のインポートマップとの衝突が回避され、アプリのインポートが通常のプロジェクトルートからのインポートのように読めるようになります。

{
  "compilerOptions": {
    "baseUrl": "${configDir}",
    "paths": {
      "@/*": ["*"]
    }
  }
}

既存のインポートはプロジェクトフォルダに直接マッピングされます。

import app from "@/config/app";
import db from "@/config/db";
import View from "@/views/Post";
import route from "@/routes/post";
import User from "@/stores/User";

これは、#app、#db、#lib/*、#view/*、#route/*、#store/*のようなアプリレベルのインポートを置き換えます。

HTMLテンプレートがtemplatesに移動

PrimateのHTMLシェルファイルは、pagesではなくtemplatesに配置されるようになりました。これにより、「page」という用語を同居するルートページのために解放し、既存の概念をより明確にします。これらのファイルはドキュメントテンプレートであり、ルートページではありません。

templates/app.html
templates/error.html

レンダリングオプションは、同じ精神で名前が変更されました。

return response.view(View, props, { template: "admin.html" });
return response.error({ template: "error.html" });

npx primate initで生成された新しいアプリはtemplates/app.htmlを使用し、古いpagesディレクトリはアプリ構造の一部ではなくなりました。

マイグレーションの自動適用

0.41で非推奨: db.migrations.autoapplyは0.41まで互換性がありますが、0.42で削除されます。開発中はprimate migrate:applyを、本番起動前にはbuild/migrate.js applyを使用してください。

Primateは本番環境でマイグレーションを自動適用できるようになりました。これを有効にするには、設定にautoapply: trueを追加します。

import config from "primate/config";
import db from "@/config/db";

export default config({
  db: {
    migrations: {
      table: "migration",
      db,
      autoapply: true, // デフォルトは false
    },
  },
});

マイグレーションは、本番環境でnode build/server.jsを実行すると自動的に適用されます。サーバーを実行する前にnpx primate migrate:applyを実行する必要はありません。

これにより、本番環境でnode_modulesやパッケージマネージャーに依存する必要がなくなります。buildの内容をデプロイサーバーにコピーして、Node、Deno、またはBunでアプリを実行できます。クロスビルドしている場合は、--target=node、--target=deno、または--target=bunも設定することを検討してください。Primate 0.39リリースノートのクロスビルドを参照してください。

終わりに

Primateを気に入っていただけた場合は、Discordサーバーへの参加や、GitHubでのスターを検討してください。