create-einja-app 0.1.1 → 0.2.1

package/templates/{turborepo-pandacss → default}/apps/web/src/app/(authenticated)/data/page.tsx

@@ -1,11 +1,20 @@
-import { userUseCases } from "@/application/use-cases/UserUseCases";
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
-import { UserTable } from "./_components/UserTable";
+import { prefetchUsers } from "@/hooks/api/prefetch-users";
+import type { PaginatedUserList } from "@/shared/schemas/user";
+import { UserTableContainer } from "./_components/UserTableContainer";
 
 export default async function DataPage() {
-  const result = await userUseCases.list({}, { page: 1, limit: 100 });
+  let initialData: PaginatedUserList | undefined;
+  let error: string | undefined;
 
-  if (!result.isSuccess) {
+  const result = await prefetchUsers({ page: 1, limit: 100 });
+  if (result === null) {
+    error = "データの取得に失敗しました";
+  } else {
+    initialData = result;
+  }
+
+  if (error) {
     return (
       <div className="container mx-auto p-6">
         <div className="space-y-6">
@@ -22,7 +31,7 @@ export default async function DataPage() {
               <CardDescription>データの取得中にエラーが発生しました。</CardDescription>
             </CardHeader>
             <CardContent>
-              <p className="text-destructive">{result.error.message}</p>
+              <p className="text-destructive">{error}</p>
             </CardContent>
           </Card>
         </div>
@@ -30,8 +39,6 @@ export default async function DataPage() {
     );
   }
 
-  const { items: users } = result.value;
-
   return (
     <div className="container mx-auto p-6">
       <div className="space-y-6">
@@ -48,7 +55,7 @@ export default async function DataPage() {
             </CardDescription>
           </CardHeader>
           <CardContent>
-            <UserTable users={users} />
+            <UserTableContainer initialData={initialData} />
           </CardContent>
         </Card>
       </div>

package/templates/default/apps/web/src/app/api/rpc/[[...route]]/route.ts

@@ -0,0 +1,31 @@
+/**
+ * route.ts
+ *
+ * Hono APIエントリーポイント
+ * basePath: /api/rpc
+ */
+
+import { userRoutes } from "@web/server/presentation/routes/userRoutes";
+import { Hono } from "hono";
+import { handle } from "hono/vercel";
+
+const app = new Hono().basePath("/api/rpc");
+
+/**
+ * ルート登録
+ */
+const routes = app.route("/users", userRoutes);
+
+/**
+ * 型エクスポート（Hono Client用）
+ */
+export type AppType = typeof routes;
+
+/**
+ * Next.js App Router統合
+ */
+export const GET = handle(app);
+export const POST = handle(app);
+export const PUT = handle(app);
+export const DELETE = handle(app);
+export const PATCH = handle(app);

package/templates/default/apps/web/src/hooks/api/prefetch-users.ts

@@ -0,0 +1,63 @@
+/**
+ * prefetch-users.ts
+ *
+ * Server Component用のユーザーデータプリフェッチ関数
+ */
+
+import { parseResponse } from "@/lib/api/parse-response";
+import { type PaginatedUserList, paginatedUserListSchema } from "@/shared/schemas/user";
+import { cookies, headers } from "next/headers";
+
+/**
+ * User filters type
+ */
+export interface UserFilters {
+  page?: number;
+  limit?: number;
+  search?: string;
+  status?: "active" | "inactive";
+  role?: "admin" | "user";
+}
+
+/**
+ * prefetchUsers
+ *
+ * Server Component用のデータ取得関数
+ */
+export async function prefetchUsers(filters: UserFilters = {}): Promise<PaginatedUserList | null> {
+  try {
+    // リクエストヘッダーからホスト情報を取得
+    const headersList = await headers();
+    const host = headersList.get("host") || "localhost:3000";
+    const protocol = headersList.get("x-forwarded-proto") || "http";
+    const baseUrl = `${protocol}://${host}`;
+
+    // クッキーを取得して転送
+    const cookieStore = await cookies();
+    const cookieHeader = cookieStore
+      .getAll()
+      .map((c) => `${c.name}=${c.value}`)
+      .join("; ");
+
+    const params = new URLSearchParams();
+    if (filters.page) params.set("page", String(filters.page));
+    if (filters.limit) params.set("limit", String(filters.limit));
+    if (filters.search) params.set("search", filters.search);
+    if (filters.status) params.set("status", filters.status);
+    if (filters.role) params.set("role", filters.role);
+
+    const url = `${baseUrl}/api/rpc/users?${params.toString()}`;
+
+    const response = await fetch(url, {
+      headers: {
+        Cookie: cookieHeader,
+      },
+      cache: "no-store",
+    });
+
+    return parseResponse(response, paginatedUserListSchema);
+  } catch (error) {
+    console.error("Failed to prefetch users:", error);
+    return null;
+  }
+}

package/templates/default/apps/web/src/hooks/api/use-users.ts

@@ -0,0 +1,83 @@
+/**
+ * use-users.ts
+ *
+ * Tanstack Query hooks for user data management
+ */
+
+"use client";
+
+import { apiClient } from "@/lib/api/client";
+import { parseResponse } from "@/lib/api/parse-response";
+import {
+  type PaginatedUserList,
+  type UserListItem,
+  paginatedUserListSchema,
+  userListItemSchema,
+} from "@/shared/schemas/user";
+import { useQuery } from "@tanstack/react-query";
+
+/**
+ * QueryKey factory for users
+ */
+export const userKeys = {
+  all: ["users"] as const,
+  lists: () => [...userKeys.all, "list"] as const,
+  list: (filters: UserFilters) => [...userKeys.lists(), filters] as const,
+  details: () => [...userKeys.all, "detail"] as const,
+  detail: (id: string) => [...userKeys.details(), id] as const,
+};
+
+/**
+ * User filters type
+ */
+export interface UserFilters {
+  page?: number;
+  limit?: number;
+  search?: string;
+  status?: "active" | "inactive";
+  role?: "admin" | "user";
+}
+
+/**
+ * useUsers hook
+ *
+ * ユーザー一覧を取得するhook
+ */
+export function useUsers(filters: UserFilters = {}, initialData?: PaginatedUserList) {
+  return useQuery({
+    queryKey: userKeys.list(filters),
+    queryFn: async () => {
+      const response = await apiClient.api.rpc.users.$get({
+        query: {
+          page: filters.page?.toString() ?? "1",
+          limit: filters.limit?.toString() ?? "10",
+          search: filters.search,
+          status: filters.status,
+          role: filters.role,
+        },
+      });
+
+      return parseResponse(response, paginatedUserListSchema);
+    },
+    initialData,
+  });
+}
+
+/**
+ * useUser hook
+ *
+ * 特定のユーザーを取得するhook
+ */
+export function useUser(id: string) {
+  return useQuery({
+    queryKey: userKeys.detail(id),
+    queryFn: async () => {
+      const response = await apiClient.api.rpc.users[":id"].$get({
+        param: { id },
+      });
+
+      return parseResponse(response, userListItemSchema);
+    },
+    enabled: !!id,
+  });
+}

package/templates/default/apps/web/src/lib/api/client.ts

@@ -0,0 +1,18 @@
+/**
+ * api-client.ts
+ *
+ * Hono Client設定
+ * 型安全なAPI呼び出しを提供
+ */
+
+import type { AppType } from "@/app/api/rpc/[[...route]]/route";
+import { hc } from "hono/client";
+
+/**
+ * Hono Client インスタンス
+ *
+ * 使用方法:
+ * - 一覧取得: apiClient.api.rpc.users.$get({ query: { page: "1", limit: "10" } })
+ * - 詳細取得: apiClient.api.rpc.users[":id"].$get({ param: { id: "..." } })
+ */
+export const apiClient = hc<AppType>("/");

package/templates/default/apps/web/src/lib/api/parse-response.ts

@@ -0,0 +1,114 @@
+/**
+ * parse-response.ts
+ *
+ * Zodスキーマによるレスポンス検証とエラーハンドリング
+ */
+
+import type { z } from "zod";
+
+/**
+ * APIエラークラス
+ *
+ * APIレスポンスのエラーを表現する
+ */
+export class ApiError extends Error {
+  constructor(
+    public readonly code: string,
+    message: string,
+    public readonly statusCode: number,
+    public readonly details?: Record<string, unknown>
+  ) {
+    super(message);
+    this.name = "ApiError";
+  }
+}
+
+/**
+ * JSONを安全にパースする
+ *
+ * @param response - Fetchレスポンス
+ * @returns パース結果（失敗時は空オブジェクト）
+ */
+async function safeJsonParse(response: Response): Promise<unknown> {
+  try {
+    return await response.json();
+  } catch {
+    // JSONパースに失敗した場合は空オブジェクトを返す
+    return {};
+  }
+}
+
+/**
+ * エラーレスポンスからエラー情報を抽出する
+ *
+ * バックエンドの形式: { error: string } または { error: { code, message, details } }
+ *
+ * @param json - パースされたJSON
+ * @param statusCode - HTTPステータスコード
+ * @returns エラー情報
+ */
+function extractErrorInfo(
+  json: unknown,
+  statusCode: number
+): { code: string; message: string; details?: Record<string, unknown> } {
+  if (typeof json === "object" && json !== null && "error" in json) {
+    const errorField = (json as { error: unknown }).error;
+
+    // { error: string } 形式
+    if (typeof errorField === "string") {
+      return {
+        code: "API_ERROR",
+        message: errorField,
+      };
+    }
+
+    // { error: { code, message, details } } 形式
+    if (typeof errorField === "object" && errorField !== null) {
+      const errObj = errorField as {
+        code?: string;
+        message?: string;
+        details?: Record<string, unknown>;
+      };
+      return {
+        code: errObj.code ?? "API_ERROR",
+        message: errObj.message ?? "An unknown error occurred",
+        details: errObj.details,
+      };
+    }
+  }
+
+  return {
+    code: "UNKNOWN_ERROR",
+    message: "An unknown error occurred",
+  };
+}
+
+/**
+ * レスポンスをパースしてZodスキーマで検証
+ *
+ * @param response - Fetchレスポンス
+ * @param schema - Zodスキーマ
+ * @returns バリデーション済みのデータ
+ * @throws ApiError - レスポンスエラーまたはバリデーションエラー
+ */
+export async function parseResponse<T>(response: Response, schema: z.ZodType<T>): Promise<T> {
+  // エラーレスポンスの場合
+  if (!response.ok) {
+    const json = await safeJsonParse(response);
+    const errorInfo = extractErrorInfo(json, response.status);
+    throw new ApiError(errorInfo.code, errorInfo.message, response.status, errorInfo.details);
+  }
+
+  // 成功レスポンスの場合
+  const json = await safeJsonParse(response);
+
+  // Zodスキーマでバリデーション
+  const result = schema.safeParse(json);
+  if (!result.success) {
+    throw new ApiError("VALIDATION_ERROR", "Response validation failed", response.status, {
+      zodErrors: result.error.flatten(),
+    });
+  }
+
+  return result.data;
+}

package/templates/default/apps/web/src/shared/schemas/user.ts

@@ -0,0 +1,36 @@
+/**
+ * user.ts
+ *
+ * ユーザー関連のZodスキーマと型定義
+ * APIレスポンスの型検証に使用
+ */
+
+import { z } from "zod";
+
+/**
+ * ユーザー一覧アイテムのレスポンススキーマ
+ * APIレスポンスの型検証に使用
+ */
+export const userListItemSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  email: z.string(),
+  status: z.enum(["active", "inactive", "pending"]),
+  role: z.enum(["admin", "user", "moderator"]),
+  createdAt: z.string(),
+  lastLogin: z.string().nullable(),
+});
+
+/**
+ * ページネーション付きユーザー一覧のレスポンススキーマ
+ */
+export const paginatedUserListSchema = z.object({
+  items: z.array(userListItemSchema),
+  total: z.number(),
+  page: z.number(),
+  limit: z.number(),
+  totalPages: z.number(),
+});
+
+export type UserListItem = z.infer<typeof userListItemSchema>;
+export type PaginatedUserList = z.infer<typeof paginatedUserListSchema>;

package/templates/{turborepo-pandacss → default}/apps/web/tsconfig.json

@@ -10,6 +10,10 @@
       "@/*": [
         "./src/*"
       ],
+      "@web/*": [
+        "./src/*",
+        "./*"
+      ],
       "@/styled-system/*": [
         "./styled-system/*"
       ],
@@ -24,6 +28,7 @@
     "test/matchers.d.ts",
     "**/*.ts",
     "**/*.tsx",
+    "server/**/*.ts",
     ".next/types/**/*.ts",
     "../../packages/front-core/src/auth/types/**/*.d.ts"
   ],

package/templates/{turborepo-pandacss → default}/package.json

@@ -45,12 +45,12 @@
     "dotenvx": "dotenvx",
     "env:encrypt": "dotenvx encrypt",
     "env:show": "tsx scripts/env-show.ts",
-    "task:loop": "einja task:loop"
+    "task:loop": "npx @einja/dev-cli task:loop",
+    "einja:sync": "npx @einja/dev-cli sync"
   },
   "devDependencies": {
     "@clack/prompts": "^0.11.0",
     "@dotenvx/dotenvx": "^1.51.4",
-    "@einja/dev-cli": "workspace:*",
     "@types/node": "^25.0.3",
     "husky": "^9.1.7",
     "lint-staged": "^16.1.0",
@@ -60,5 +60,10 @@
   "volta": {
     "node": "22.16.0",
     "pnpm": "10.14.0"
+  },
+  "dependencies": {
+    "@hono/zod-validator": "^0.7.6",
+    "hono": "^4.11.3",
+    "zod": "^4.3.5"
   }
 }

package/templates/default/packages/server-core/src/domain/validators/user.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+
+/**
+ * ユーザー一覧取得クエリパラメータスキーマ
+ */
+export const userListQuerySchema = z.object({
+  page: z.string().optional().default("1").transform(Number),
+  limit: z.string().optional().default("10").transform(Number),
+  search: z.string().optional(),
+  status: z.enum(["active", "inactive"]).optional(),
+  role: z.enum(["admin", "user"]).optional(),
+});
+
+export type UserListQuery = z.infer<typeof userListQuerySchema>;
+
+/**
+ * ユーザーIDパスパラメータスキーマ
+ */
+export const userIdParamSchema = z.object({
+  id: z.string().uuid("Invalid user ID format"),
+});
+
+export type UserIdParam = z.infer<typeof userIdParamSchema>;

package/templates/{turborepo-pandacss → default}/pnpm-lock.yaml

@@ -7,6 +7,16 @@ settings:
 importers:
 
   .:
+    dependencies:
+      '@hono/zod-validator':
+        specifier: ^0.7.6
+        version: 0.7.6(hono@4.11.3)(zod@4.3.5)
+      hono:
+        specifier: ^4.11.3
+        version: 4.11.3
+      zod:
+        specifier: ^4.3.5
+        version: 4.3.5
     devDependencies:
       '@clack/prompts':
         specifier: ^0.11.0
@@ -14,9 +24,6 @@ importers:
       '@dotenvx/dotenvx':
         specifier: ^1.51.4
         version: 1.51.4
-      '@einja/dev-cli':
-        specifier: workspace:*
-        version: link:packages/cli
       '@types/node':
         specifier: ^25.0.3
         version: 25.0.3
@@ -1094,6 +1101,12 @@ packages:
     peerDependencies:
       hono: ^4
 
+  '@hono/zod-validator@0.7.6':
+    resolution: {integrity: sha512-Io1B6d011Gj1KknV4rXYz4le5+5EubcWEU/speUjuw9XMMIaP3n78yXLhjd2A3PXaXaUwEAluOiAyLqhBEJgsw==}
+    peerDependencies:
+      hono: '>=3.9.0'
+      zod: ^3.25.0 || ^4.0.0
+
   '@hookform/resolvers@5.2.2':
     resolution: {integrity: sha512-A/IxlMLShx3KjV/HeTcTfaMxdwy690+L/ZADoeaTltLx+CVuzkeVIPuybK3jrRfw7YZnmdKsVVHAlEPIAEUNlA==}
     peerDependencies:
@@ -5205,6 +5218,11 @@ snapshots:
     dependencies:
       hono: 4.11.3
 
+  '@hono/zod-validator@0.7.6(hono@4.11.3)(zod@4.3.5)':
+    dependencies:
+      hono: 4.11.3
+      zod: 4.3.5
+
   '@hookform/resolvers@5.2.2(react-hook-form@7.65.0(react@19.2.0))':
     dependencies:
       '@standard-schema/utils': 0.3.0