Node.js と Bun のサーバー API

@effront/server は Node.js と Bun 向けに、ネイティブ Effect HTTP ホストと静的ファイル配信を提供します。 インストールと起動ファイルは Node.js と Bun を参照してください。

effrontServer

@effront/server/vite の effrontServer(options?: EffrontServerOptions): Plugin は、Vite の開発・プレビューにネイティブハンドラーを接続し、別の本番起動用エントリーをビルドします。 effront() より後に登録する必要があります。

import { effront } from "@effront/vite";
import { effrontServer } from "@effront/server/vite";
import { defineConfig } from "vite-plus";

export default defineConfig({
  plugins: [effront(), effrontServer()],
});

エントリーに空文字列を指定すると TypeError になります。 RSC エントリーは if (import.meta.hot) import.meta.hot.accept(); で HMR を受け入れます。

開発とプレビューは、Node 互換ミドルウェアを通じて Vite のリスナーを使い、本番起動用エントリーは使いません。 そのため serve のオプションでは Vite のポートやホスト名は変わりません。 本番で Bun を使う場合も @effect/platform-node が必要です。 Bun 固有の実行時動作を確認するには、Vite プレビューではなく、通常は bun dist/rsc/server.js でビルド済み本番エントリーを実行します。

serve

serve(handler, options) は、スコープで管理するサーバー Layer を返します。 handler は HttpServerResponse を返す Effect であり、Fetch 関数ではありません。 Layer.launch と対応するプラットフォーム Runtime で Layer を起動します。

起動前に、残りのアプリケーションサービス Layer を提供します。 Node.js の起動例 を参照してください。 既定のアドレスはローカル接続だけを受け付けます。 0.0.0.0 などのアドレスは、他のマシンにもリスナーを公開します。 Bun のサーバーは、リクエスト本文に 10 MiB の上限も適用します。

withAssets

@effront/server/assets の withAssets(handler, options) は、静的ファイルを配信するハンドラーを構築します。 serve は assets オプションを使って、これを適用済みです。

どちらのキャッシュポリシーも、既定値は public, max-age=0, must-revalidate です。 public, max-age=31536000, immutable は、ハッシュ付きファイル名だけに使用してください。 接頭辞が /assets/ の場合、/assets/app.js は client.root 内の app.js を検索します。 Vite の出力や base を変更した場合、実際の出力ディレクトリと URL にマウント設定を合わせる必要があります。

ディレクトリの index や SPA フォールバックはありません。 それ以外のファイルシステム障害は型付き HTTP エラーとして残ります。 ルートディレクトリの確認は起動時ではなく、リクエスト時に行います。

既存の Effect HTTP サーバーでは、構築時に yield* withAssets(handler, options) でハンドラーを取得します。 外側の構築用 Effect をリクエストハンドラーとして渡さないでください。

ホストはリクエスト Scope を所有し、レスポンス本文を消費またはキャンセルする必要があります。 MIME 型、weak ETag、条件付きリクエスト、Range は Effect 4.0.0-rc.116 に従います。

呼び出し側が提供する HttpPlatform や ETag サービスは、アセットレスポンスに影響しません。