gencow 0.1.16 → 0.1.17

package/bin/gencow.mjs

@@ -440,6 +440,24 @@ function generateReadmeMd(config, apiObj) {
     md += `| \`/api/auth/sign-out\` | POST | 로그아웃 |\n\n`;
     md += `> ⚠️ 모든 API 요청에 \`credentials: "include"\`를 포함해야 합니다 (세션 쿠키 전송)\n`;
     md += `> ⚠️ JWT 토큰이나 \`/auth/register\` 같은 커스텀 경로를 만들지 마세요.\n\n`;
+    md += `### Next.js 프론트엔드 연동 (필수)\n\n`;
+    md += `프론트엔드(localhost:3000)와 백엔드(localhost:5456)가 다른 포트에서 실행되므로,\n`;
+    md += `\`next.config.ts\`에 rewrites 프록시를 설정해야 인증이 작동합니다:\n\n`;
+    md += `\`\`\`typescript\n`;
+    md += `// next.config.ts\n`;
+    md += `const nextConfig = {\n`;
+    md += `    async rewrites() {\n`;
+    md += `        return [\n`;
+    md += `            { source: "/api/:path*", destination: "http://localhost:5456/api/:path*" },\n`;
+    md += `            { source: "/ws", destination: "http://localhost:5456/ws" },\n`;
+    md += `        ];\n`;
+    md += `    },\n`;
+    md += `};\n`;
+    md += `\`\`\`\n\n`;
+    md += `또는 \`gencowAuth()\`에 명시적으로 baseUrl을 전달하세요:\n\n`;
+    md += `\`\`\`typescript\n`;
+    md += `const { signIn, useAuth } = gencowAuth(process.env.NEXT_PUBLIC_GENCOW_URL || "http://localhost:5456");\n`;
+    md += `\`\`\`\n\n`;
 
     // ── 1-3. RPC 직접 호출 (접힘 — 비-React 환경용) ──────────
     md += `---\n\n`;
@@ -1304,6 +1322,8 @@ ${BOLD}Dev commands:${RESET}
   ${GREEN}db:studio${RESET}        Open Drizzle Studio ${DIM}(visual DB browser)${RESET}
   ${GREEN}add <comp...>${RESET}   Add components ${DIM}(AI RAG Tools Memory Analytics)${RESET}
   ${GREEN}mcp${RESET}              Start MCP server for AI agent integration ${DIM}(stdio)${RESET}
+  ${GREEN}codegen${RESET}          Generate frontend-independent api.ts
+                     ${DIM}--outdir, -o  Output directory (default: src/gencow/)${RESET}
 
 ${BOLD}BaaS commands (login required):${RESET}
   ${GREEN}login${RESET}            Login to Gencow Platform ${DIM}(browser → token)${RESET}
@@ -1883,6 +1903,117 @@ ${BOLD}Examples:${RESET}
         success("Logged out");
     },
 
+    // ── codegen — 프론트엔드 전용 api.ts 생성 ─────────
+    async codegen(...codegenArgs) {
+        const config = loadConfig();
+        const absoluteFunctions = resolve(process.cwd(), config.functionsDir);
+
+        // --outdir 옵션: 출력 디렉토리 지정
+        let outdir = null;
+        for (let i = 0; i < codegenArgs.length; i++) {
+            if (codegenArgs[i] === "--outdir" || codegenArgs[i] === "-o") {
+                outdir = codegenArgs[++i];
+            }
+        }
+        if (!outdir) {
+            outdir = resolve(process.cwd(), "src", "gencow");
+        } else {
+            outdir = resolve(process.cwd(), outdir);
+        }
+
+        log(`\n${BOLD}${CYAN}Gencow Codegen${RESET}\n`);
+        info(`Functions: ${config.functionsDir}/`);
+        info(`Output:    ${outdir}/api.ts`);
+        log("");
+
+        // 1. extract 로직 — queries/mutations 목록 추출
+        //    모노레포: findServerRoot() (packages/server에 @gencow/core 있음)
+        //    독립 프로젝트: cwd (node_modules/gencow에서 @gencow/core 해석)
+        let runtimeRoot;
+        try { runtimeRoot = findServerRoot(); } catch { runtimeRoot = process.cwd(); }
+        const extractTsPath = resolve(runtimeRoot, ".gencow-extract.ts");
+        const script = `
+import { getRegisteredQueries, getRegisteredMutations } from "@gencow/core";
+import "${absoluteFunctions}/index.ts";
+console.log("GENCOW_API_JSON=" + JSON.stringify({ 
+  queries: getRegisteredQueries(), 
+  mutations: getRegisteredMutations().map(m => m.name) 
+}));
+process.exit(0);
+`;
+        info("함수 목록 추출 중...");
+        try {
+            writeFileSync(extractTsPath, script);
+            let outStr;
+            try {
+                outStr = execSync(`bun ${extractTsPath}`, {
+                    cwd: runtimeRoot,
+                    stdio: ["pipe", "pipe", "pipe"]
+                }).toString();
+            } catch (execErr) {
+                const stderr = execErr.stderr?.toString() || "";
+                try { unlinkSync(extractTsPath); } catch { }
+                throw new Error(`bun extract 실패:\n${stderr || execErr.message}`);
+            }
+            try { unlinkSync(extractTsPath); } catch { }
+
+            const match = outStr.match(/GENCOW_API_JSON=({.*})/);
+            if (!match) throw new Error("Could not parse registry output");
+            const { queries, mutations } = JSON.parse(match[1]);
+
+            // 2. namespace별 그룹핑
+            const apiObj = {};
+            for (const q of queries) {
+                const [ns, name] = q.split(".");
+                if (!apiObj[ns]) apiObj[ns] = { queries: [], mutations: [] };
+                apiObj[ns].queries.push(name);
+            }
+            for (const m of mutations) {
+                const [ns, name] = m.split(".");
+                if (!apiObj[ns]) apiObj[ns] = { queries: [], mutations: [] };
+                apiObj[ns].mutations.push(name);
+            }
+
+            // 3. 프론트엔드 전용 api.ts 생성 — 백엔드 import 없음
+            let out = `/**\n`;
+            out += ` * Generated by \`gencow codegen\`\n`;
+            out += ` * Do not edit this file manually.\n`;
+            out += ` *\n`;
+            out += ` * 프론트엔드 전용 — 백엔드 의존성 없이 독립적으로 사용 가능합니다.\n`;
+            out += ` * 타입을 추가하려면 제네릭에 인라인 타입을 지정하세요:\n`;
+            out += ` *   defineQuery<{ _return: Task[] }>("tasks.list")\n`;
+            out += ` */\n`;
+            out += `import { defineQuery, defineMutation } from "@gencow/react";\n\n`;
+
+            out += `export const api = {\n`;
+            for (const [ns, fns] of Object.entries(apiObj)) {
+                out += `    ${ns}: {\n`;
+                for (const q of fns.queries) {
+                    out += `        ${q}: defineQuery("${ns}.${q}"),\n`;
+                }
+                for (const m of fns.mutations) {
+                    out += `        ${m}: defineMutation("${ns}.${m}"),\n`;
+                }
+                out += `    },\n`;
+            }
+            out += `} as const;\n`;
+
+            mkdirSync(outdir, { recursive: true });
+            writeFileSync(resolve(outdir, "api.ts"), out);
+            success(`Generated ${outdir}/api.ts`);
+            log("");
+            log(`  ${DIM}Queries:   ${queries.join(", ")}${RESET}`);
+            log(`  ${DIM}Mutations: ${mutations.join(", ")}${RESET}`);
+            log("");
+            info(`사용법: import { api } from "@/gencow/api";`);
+        } catch (e) {
+            try { unlinkSync(extractTsPath); } catch { }
+            error(`Codegen 실패: ${e.message}`);
+            process.exit(1);
+        }
+    },
+
+
     // ── app (subcommands: create, list, delete) ────────
     async app(subcmd, ...rest) {
         const creds = requireCreds();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "gencow",
-    "version": "0.1.16",
+    "version": "0.1.17",
     "description": "Gencow — Backend OS for AI Agents",
     "type": "module",
     "bin": {

package/server/index.js

@@ -71702,6 +71702,11 @@ async function main() {
               "OPENAI_API_KEY not found in .env. Add it to use ctx.ai.chat() in local development."
             );
           }
+          if (localKey.length < 20 || /^sk-\.{2,}$/.test(localKey) || localKey.includes("your-key") || localKey.includes("YOUR_KEY")) {
+            throw new Error(
+              "OPENAI_API_KEY\uAC00 \uD50C\uB808\uC774\uC2A4\uD640\uB354\uC785\uB2C8\uB2E4. .env \uD30C\uC77C\uC5D0 \uC2E4\uC81C OpenAI API \uD0A4\uB97C \uC124\uC815\uD558\uC138\uC694. (https://platform.openai.com/api-keys)"
+            );
+          }
           const { createOpenAI: createOpenAI2 } = await Promise.resolve().then(() => (init_dist4(), dist_exports));
           const { generateText: generateText2 } = await Promise.resolve().then(() => (init_dist8(), dist_exports2));
           const openai2 = createOpenAI2({ apiKey: localKey });
@@ -71845,6 +71850,11 @@ async function main() {
     console.log(`[gencow]   \u2192 Use { public: true } only for intentionally open endpoints.`);
   }
   console.log(`[gencow] \u{1F512} Secure by Default: ${protectedQueryCount} queries + ${protectedMutationCount} mutations require auth`);
+  const _aiKey = process.env.OPENAI_API_KEY;
+  if (_aiKey && (_aiKey.length < 20 || /^sk-\.{2,}$/.test(_aiKey) || _aiKey.includes("your-key") || _aiKey.includes("YOUR_KEY"))) {
+    console.warn(`[gencow] \u26A0\uFE0F  OPENAI_API_KEY\uAC00 \uD50C\uB808\uC774\uC2A4\uD640\uB354\uC785\uB2C8\uB2E4. .env\uC5D0 \uC2E4\uC81C \uD0A4\uB97C \uC124\uC815\uD558\uC138\uC694.`);
+    console.warn(`[gencow]    \u2192 https://platform.openai.com/api-keys`);
+  }
   app.route("/api", apiRouter);
   const httpActions = getRegisteredHttpActions();
   if (httpActions.length > 0) {