gencow 0.1.0

package/server/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@gencow/server-bundle",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "index.js"
+}

package/templates/ai-chat/README.md

@@ -0,0 +1,91 @@
+# Gencow Backend — AI Chat App
+
+> `gencow add` 명령으로 컴포넌트 추가 시 이 파일이 자동 업데이트됩니다.
+
+## 스키마
+
+### conversations
+| 컬럼 | 타입 | 설명 |
+|------|------|------|
+| id | serial | PK |
+| title | text | 대화 제목 |
+| userId | text | 사용자 ID |
+| createdAt | timestamp | 생성일 |
+| updatedAt | timestamp | 수정일 |
+
+### messages
+| 컬럼 | 타입 | 설명 |
+|------|------|------|
+| id | serial | PK |
+| conversationId | serial | 대화 FK |
+| role | text | user / assistant / system |
+| content | text | 메시지 내용 |
+| createdAt | timestamp | 생성일 |
+
+## API
+
+### chat.ts
+| 타입 | 이름 | 설명 |
+|------|------|------|
+| query | `chat.listConversations` | 대화 목록 (최신순) |
+| query | `chat.getMessages` | 대화의 메시지 목록 |
+| mutation | `chat.send` | 메시지 전송 + AI 응답 |
+
+### ai.ts
+| 메서드 | 설명 |
+|--------|------|
+| `ai.chat()` | 텍스트 생성 |
+| `ai.stream()` | 스트리밍 응답 |
+| `ai.embed()` | 텍스트 임베딩 |
+
+> `.env`에 `OPENAI_API_KEY` 설정 필요
+
+## 인증 (better-auth)
+
+Gencow는 **better-auth** (세션 + 쿠키 기반) 인증을 사용합니다.
+
+| 엔드포인트 | 메서드 | 설명 |
+|------------|--------|------|
+| `/api/auth/sign-up/email` | POST | 회원가입 (`{ email, password, name }`) |
+| `/api/auth/sign-in/email` | POST | 로그인 (`{ email, password }`) |
+| `/api/auth/sign-out` | POST | 로그아웃 |
+
+프론트엔드에서는 `@gencow/react`의 `gencowAuth()` 사용:
+
+```ts
+import { gencowAuth } from "@gencow/react";
+const { signIn, signUp, signOut, useAuth } = gencowAuth();
+```
+
+> ⚠️ JWT 토큰이나 `/auth/register` 같은 커스텀 경로를 만들지 마세요.
+
+## 📡 REST API 직접 호출
+
+> 아래 REST 경로로 API를 호출하세요.
+> 모든 요청에 `credentials: "include"` (쿠키)를 포함해야 합니다.
+
+```ts
+// Query (GET)
+const res = await fetch("http://localhost:5456/api/fn/tasks/list", {
+    credentials: "include",
+});
+
+// Mutation (POST)
+const res = await fetch("http://localhost:5456/api/fn/tasks/create", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    credentials: "include",
+    body: JSON.stringify({ title: "새 태스크" }),
+});
+
+// 파일 업로드 (FormData)
+const formData = new FormData();
+formData.append("file", file);
+fetch("http://localhost:5456/api/fn/files/upload", {
+    method: "POST",
+    credentials: "include",
+    body: formData,
+});
+```
+
+> `GET /api/fn` 으로 등록된 전체 API 목록을 JSON으로 조회할 수 있습니다.

package/templates/ai-chat/ai.ts

@@ -0,0 +1,108 @@
+import { generateText, streamText, embed, generateObject } from "ai";
+import { openai } from "@ai-sdk/openai";
+
+// ─── 기본 모델 (자유롭게 변경 가능) ─────────────────────
+const defaultModel = openai("gpt-4o-mini");
+
+/**
+ * Gencow AI Engine — Vercel AI SDK 래퍼
+ *
+ * 이 파일을 수정하여 모델, 시스템 프롬프트 등을 커스터마이징할 수 있습니다.
+ */
+export const ai = {
+    /**
+     * 텍스트 생성 (비스트리밍)
+     *
+     * @example
+     * const reply = await ai.chat({
+     *     system: "You are a helpful assistant.",
+     *     messages: [{ role: "user", content: "안녕?" }],
+     * });
+     */
+    async chat(options: {
+        model?: Parameters<typeof generateText>[0]["model"];
+        system?: string;
+        messages: { role: string; content: string }[];
+        tools?: Record<string, unknown>;
+    }) {
+        const result = await generateText({
+            model: options.model ?? defaultModel,
+            system: options.system,
+            messages: options.messages as Parameters<typeof generateText>[0]["messages"],
+            tools: options.tools as any,
+        } as any);
+
+        if (result.text) return result.text;
+
+        const toolCalls = (result as any).toolCalls || [];
+        const toolResults = (result as any).toolResults || [];
+
+        if (toolCalls.length > 0 && toolResults.length > 0) {
+            const toolSummary = toolResults
+                .map((tr: any) => {
+                    const resultData = tr.result ?? tr.output ?? tr;
+                    return `[도구: ${tr.toolName}] 결과:\n${JSON.stringify(resultData, null, 2)}`;
+                })
+                .join("\n\n");
+
+            const followUpMessages = [
+                ...options.messages,
+                { role: "assistant", content: `도구를 실행하여 다음 결과를 얻었습니다:\n${toolSummary}` },
+                { role: "user", content: "위 결과를 바탕으로 자연스럽게 답변해 주세요." },
+            ];
+
+            const { text: followUpText } = await generateText({
+                model: options.model ?? defaultModel,
+                system: options.system,
+                messages: followUpMessages as Parameters<typeof generateText>[0]["messages"],
+            } as any);
+
+            return followUpText || toolSummary;
+        }
+
+        return result.text || "응답을 생성할 수 없습니다.";
+    },
+
+    /**
+     * 스트리밍 응답
+     */
+    async stream(options: {
+        model?: Parameters<typeof streamText>[0]["model"];
+        system?: string;
+        messages: { role: string; content: string }[];
+    }) {
+        return streamText({
+            model: options.model ?? defaultModel,
+            system: options.system,
+            messages: options.messages as Parameters<typeof streamText>[0]["messages"],
+        });
+    },
+
+    /**
+     * 텍스트 임베딩 (RAG / Memory 용)
+     */
+    async embed(text: string, model?: Parameters<typeof embed>[0]["model"]) {
+        const { embedding } = await embed({
+            model: model ?? openai.embedding("text-embedding-3-small"),
+            value: text,
+        });
+        return embedding;
+    },
+
+    /**
+     * 구조화 출력 — Zod 스키마에 맞는 JSON 객체 생성
+     */
+    async generateObject<T>(options: {
+        model?: Parameters<typeof generateObject>[0]["model"];
+        schema: Parameters<typeof generateObject>[0]["schema"];
+        prompt: string;
+        system?: string;
+    }) {
+        return generateObject({
+            model: options.model ?? defaultModel,
+            schema: options.schema,
+            prompt: options.prompt,
+            system: options.system,
+        } as Parameters<typeof generateObject>[0]);
+    },
+};

package/templates/ai-chat/chat.ts

@@ -0,0 +1,99 @@
+/**
+ * gencow/chat.ts — AI Chat mutations
+ */
+import { eq, desc } from "drizzle-orm";
+import { query, mutation, v } from "@gencow/core";
+import { conversations, messages } from "./schema";
+import { ai } from "./ai";
+
+// ─── Queries ─────────────────────────────────────────────
+
+export const listConversations = query("chat.listConversations", {
+    handler: async (ctx) => {
+        return await ctx.db.select().from(conversations).orderBy(desc(conversations.updatedAt));
+    }
+});
+
+export const getMessages = query("chat.getMessages", {
+    args: { conversationId: v.number() },
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .select()
+            .from(messages)
+            .where(eq(messages.conversationId, args.conversationId))
+            .orderBy(messages.createdAt);
+    }
+});
+
+// ─── Mutations ───────────────────────────────────────────
+
+export const send = mutation({
+    name: "chat.send",
+    invalidates: [],
+    args: {
+        conversationId: v.optional(v.number()),
+        message: v.string(),
+    },
+    handler: async (ctx, args) => {
+        let convId = args.conversationId;
+
+        // 새 대화 자동 생성
+        if (!convId) {
+            const user = ctx.auth.getUserIdentity();
+            const [conv] = await ctx.db
+                .insert(conversations)
+                .values({
+                    title: args.message.slice(0, 50),
+                    userId: user?.id,
+                })
+                .returning();
+            convId = conv.id;
+        }
+
+        // 사용자 메시지 저장
+        await ctx.db.insert(messages).values({
+            conversationId: convId,
+            role: "user",
+            content: args.message,
+        });
+
+        // 대화 히스토리 로드
+        const history = await ctx.db
+            .select()
+            .from(messages)
+            .where(eq(messages.conversationId, convId))
+            .orderBy(messages.createdAt);
+
+        // AI 응답 생성
+        const reply = await ai.chat({
+            system: "You are a helpful assistant. 한국어로 답변해주세요.",
+            messages: history.map(m => ({ role: m.role, content: m.content })),
+        });
+
+        // AI 메시지 저장
+        await ctx.db.insert(messages).values({
+            conversationId: convId,
+            role: "assistant",
+            content: reply,
+        });
+
+        // 대화 시간 업데이트
+        await ctx.db
+            .update(conversations)
+            .set({ updatedAt: new Date() })
+            .where(eq(conversations.id, convId));
+
+        // 실시간 push
+        const freshMessages = await ctx.db
+            .select()
+            .from(messages)
+            .where(eq(messages.conversationId, convId))
+            .orderBy(messages.createdAt);
+        ctx.realtime.emit("chat.getMessages", freshMessages);
+
+        const freshConvs = await ctx.db.select().from(conversations).orderBy(desc(conversations.updatedAt));
+        ctx.realtime.emit("chat.listConversations", freshConvs);
+
+        return { conversationId: convId, reply };
+    }
+});

package/templates/ai-chat/index.ts

@@ -0,0 +1,4 @@
+/**
+ * gencow/index.ts — Entry point
+ */
+import "./chat";

package/templates/ai-chat/prompt.md

@@ -0,0 +1,159 @@
+# AI Chat App — 프론트엔드 바이브코딩 프롬프트
+
+이 프로젝트는 Gencow AI 채팅 백엔드가 이미 구현되어 있습니다.
+아래 정보를 참고하여 채팅 프론트엔드를 만들어주세요.
+
+## 이미 구현된 백엔드
+
+- `gencow/schema.ts` — DB 테이블 (conversations, messages)
+- `gencow/chat.ts` — 대화 CRUD + AI 응답 생성 (OpenAI)
+- `gencow/ai.ts` — AI Engine (모델 설정)
+
+## 프론트엔드 세팅 가이드
+
+### 의존성 설치
+```bash
+npm install @gencow/react lucide-react next-themes
+```
+
+### 프로바이더 설정
+
+```tsx
+// src/components/gencow-provider.tsx
+"use client";
+import { useAuth } from "@/lib/auth";
+import { GencowProvider } from "@gencow/react";
+
+const BASE_URL = process.env.NEXT_PUBLIC_API_URL ?? "http://localhost:5456";
+
+export function GencowClientProvider({ children }) {
+    const { token } = useAuth();
+    return (
+        <GencowProvider baseUrl={BASE_URL} token={token}>
+            {children}
+        </GencowProvider>
+    );
+}
+```
+
+### 인증 설정 (⚠️ 중요 — 반드시 이 방식을 따르세요)
+
+Gencow는 **better-auth (세션 + 쿠키 기반)** 인증 시스템을 사용합니다.
+**JWT 토큰이나 커스텀 /auth/register 경로를 직접 만들지 마세요.**
+
+```tsx
+// src/lib/auth.ts — 이 파일 하나로 인증 완료
+import { gencowAuth } from "@gencow/react";
+export const { signIn, signUp, signOut, useAuth, store } = gencowAuth();
+```
+
+#### 올바른 사용법 (프론트엔드)
+
+```tsx
+// 회원가입
+await signUp("user@example.com", "password123", "홍길동");
+
+// 로그인
+await signIn("user@example.com", "password123");
+
+// 로그아웃
+await signOut();
+
+// 인증 상태 확인 (React hook)
+const { token, user, isAuthenticated } = useAuth();
+```
+
+#### ❌ 절대 하지 마세요
+
+```tsx
+fetch("/auth/register", { ... })        // ❌ 잘못된 경로
+fetch("/api/auth/register", { ... })    // ❌ 잘못된 경로
+localStorage.setItem("token", jwt)      // ❌ gencowAuth()가 자동 관리
+// ✅ 올바른 방법: gencowAuth()의 signIn/signUp/signOut만 사용
+```
+
+#### 실제 백엔드 인증 엔드포인트 (참고용)
+
+| 엔드포인트 | 메서드 | 설명 |
+|------------|--------|------|
+| `/api/auth/sign-up/email` | POST | 회원가입 |
+| `/api/auth/sign-in/email` | POST | 로그인 |
+| `/api/auth/sign-out` | POST | 로그아웃 |
+
+> 직접 호출 불필요 — `gencowAuth()`가 자동 처리합니다.
+
+## 📡 REST API 직접 호출
+
+> 아래 REST 경로로 API를 호출하세요.
+> 모든 요청에 `credentials: "include"` (쿠키)를 포함해야 합니다.
+
+### Query 호출 예시
+
+```ts
+const res = await fetch("http://localhost:5456/api/fn/chat/listConversations", {
+    credentials: "include",
+});
+```
+
+### Mutation 호출 예시
+
+```ts
+const res = await fetch("http://localhost:5456/api/fn/chat/send", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    credentials: "include",
+    body: JSON.stringify({ message: "안녕하세요!" }),
+});
+```
+
+> `GET /api/fn` 으로 등록된 전체 API 목록을 JSON으로 조회할 수 있습니다.
+
+### React Hook 사용 시 (권장)
+
+```tsx
+const conversations = useQuery(api.chat.listConversations);
+const [send] = useMutation(api.chat.send);
+await send({ message: "안녕하세요!" });
+```
+
+## 사용 가능한 API
+
+### 대화
+| 메서드 | 이름 | 인자 | 설명 |
+|--------|------|------|------|
+| query | `chat.listConversations` | 없음 | 대화 목록 (최신순) |
+| query | `chat.getMessages` | `{ conversationId: number }` | 대화의 메시지 목록 |
+| mutation | `chat.send` | `{ message: string, conversationId?: number }` | 메시지 전송 + AI 응답 |
+
+### 인증
+| 함수 | 설명 |
+|------|------|
+| `signUp(email, password, name)` | 회원가입 |
+| `signIn(email, password)` | 로그인 |
+| `signOut()` | 로그아웃 |
+| `useAuth()` | `{ token, user, isAuthenticated }` |
+
+## 데이터 사용 패턴
+
+```tsx
+import { useQuery, useMutation } from "@gencow/react";
+import { api } from "../gencow/api";
+
+// 대화 목록
+const conversations = useQuery(api.chat.listConversations);
+
+// 특정 대화의 메시지
+const messages = useQuery(api.chat.getMessages, { conversationId: selectedId });
+
+// 메시지 전송 (새 대화 자동 생성 또는 기존 대화에 추가)
+const [send, isSending] = useMutation(api.chat.send);
+await send({ message: "안녕하세요!" });
+await send({ conversationId: 1, message: "추가 질문입니다" });
+```
+
+## 권장 UI 구조
+
+- 좌측 사이드바: 대화 목록 + 새 대화 버튼
+- 중앙: 채팅 메시지 영역 (말풍선 UI)
+- 하단: 입력 필드 + 전송 버튼
+- 상단: 로그인/로그아웃 + 다크 모드 토글

package/templates/ai-chat/schema.ts

@@ -0,0 +1,25 @@
+/**
+ * gencow/schema.ts — AI Chat 스키마
+ */
+import {
+    pgTable,
+    serial,
+    text,
+    timestamp,
+} from "drizzle-orm/pg-core";
+
+export const conversations = pgTable("conversations", {
+    id: serial("id").primaryKey(),
+    title: text("title").notNull(),
+    userId: text("user_id"),
+    createdAt: timestamp("created_at").defaultNow().notNull(),
+    updatedAt: timestamp("updated_at").defaultNow().notNull(),
+});
+
+export const messages = pgTable("messages", {
+    id: serial("id").primaryKey(),
+    conversationId: serial("conversation_id").notNull(),
+    role: text("role").notNull(),        // "user" | "assistant" | "system"
+    content: text("content").notNull(),
+    createdAt: timestamp("created_at").defaultNow().notNull(),
+});

package/templates/ai.ts

@@ -0,0 +1,101 @@
+import { generateText, streamText, embed, generateObject } from "ai";
+import { openai } from "@ai-sdk/openai";
+
+// ─── 기본 모델 (자유롭게 변경 가능) ─────────────────────
+// 예: anthropic("claude-3-haiku"), openai("gpt-4o") 등
+const defaultModel = openai("gpt-4o-mini");
+
+/**
+ * Gencow AI Engine — Vercel AI SDK 래퍼
+ *
+ * 바이브코더가 이 파일을 직접 수정하여 커스터마이징 가능.
+ * "ai.ts 수정해서 시스템 프롬프트 바꿔줘" → AI가 바로 수정 가능.
+ */
+export const ai = {
+    /**
+     * 텍스트 생성 (비스트리밍)
+     *
+     * @example
+     * const reply = await ai.chat({
+     *     system: "You are a helpful assistant.",
+     *     messages: [{ role: "user", content: "안녕?" }],
+     * });
+     */
+    async chat(options: {
+        model?: Parameters<typeof generateText>[0]["model"];
+        system?: string;
+        messages: { role: string; content: string }[];
+        tools?: Record<string, unknown>;
+    }) {
+        const { text } = await generateText({
+            model: options.model ?? defaultModel,
+            system: options.system,
+            messages: options.messages as Parameters<typeof generateText>[0]["messages"],
+            tools: options.tools as Parameters<typeof generateText>[0]["tools"],
+        });
+        return text;
+    },
+
+    /**
+     * 스트리밍 응답
+     *
+     * @example
+     * const stream = await ai.stream({
+     *     system: "You are a helpful assistant.",
+     *     messages: [{ role: "user", content: "안녕?" }],
+     * });
+     * for await (const chunk of stream.textStream) {
+     *     process.stdout.write(chunk);
+     * }
+     */
+    async stream(options: {
+        model?: Parameters<typeof streamText>[0]["model"];
+        system?: string;
+        messages: { role: string; content: string }[];
+    }) {
+        return streamText({
+            model: options.model ?? defaultModel,
+            system: options.system,
+            messages: options.messages as Parameters<typeof streamText>[0]["messages"],
+        });
+    },
+
+    /**
+     * 텍스트 임베딩 (RAG / Memory 용)
+     *
+     * @example
+     * const vector = await ai.embed("검색할 텍스트");
+     */
+    async embed(text: string, model?: Parameters<typeof embed>[0]["model"]) {
+        const { embedding } = await embed({
+            model: model ?? openai.embedding("text-embedding-3-small"),
+            value: text,
+        });
+        return embedding;
+    },
+
+    /**
+     * 구조화 출력 — Zod 스키마에 맞는 JSON 객체 생성
+     *
+     * @example
+     * import { z } from "zod";
+     * const { object } = await ai.generateObject({
+     *     schema: z.object({ name: z.string(), age: z.number() }),
+     *     prompt: "홍길동은 25살입니다.",
+     * });
+     * // object = { name: "홍길동", age: 25 }
+     */
+    async generateObject<T>(options: {
+        model?: Parameters<typeof generateObject>[0]["model"];
+        schema: Parameters<typeof generateObject>[0]["schema"];
+        prompt: string;
+        system?: string;
+    }) {
+        return generateObject({
+            model: options.model ?? defaultModel,
+            schema: options.schema,
+            prompt: options.prompt,
+            system: options.system,
+        } as Parameters<typeof generateObject>[0]);
+    },
+};