gencow 0.1.109 → 0.1.111

package/core/index.js

@@ -2027,7 +2027,8 @@ function crud(table, options) {
     const countResult = await db.select({ count: drizzleCount() }).from(anyTable).where(whereClause);
     return { data, total: Number(countResult[0]?.count ?? 0) };
   }
-  const listDef = query(`${prefix}.list`, {
+  const enabledMethods = new Set(options?.methods ?? ["list", "get", "create", "update", "remove"]);
+  const listDef = !enabledMethods.has("list") ? void 0 : query(`${prefix}.list`, {
     public: isPublic,
     args: {
       page: v.optional(v.number()),
@@ -2058,7 +2059,7 @@ function crud(table, options) {
       };
     }
   });
-  const getDef = query(`${prefix}.get`, {
+  const getDef = !enabledMethods.has("get") ? void 0 : query(`${prefix}.get`, {
     public: isPublic,
     args: { id: idValidator },
     handler: async (ctx, args) => {
@@ -2072,7 +2073,7 @@ function crud(table, options) {
       return result ?? null;
     }
   });
-  const createDef = mutation(`${prefix}.create`, {
+  const createDef = !enabledMethods.has("create") ? void 0 : mutation(`${prefix}.create`, {
     public: isPublic,
     invalidates: [],
     handler: async (ctx, args) => {
@@ -2085,14 +2086,14 @@ function crud(table, options) {
         insertData = await options.hooks.beforeCreate(insertData);
       }
       const [result] = await ctx.db.insert(anyTable).values(insertData).returning();
-      if (useRealtime) {
+      if (useRealtime && enabledMethods.has("list")) {
         const listResult = await fetchListWithTotal(ctx.db);
         ctx.realtime.emit(`${prefix}.list`, listResult);
       }
       return result;
     }
   });
-  const updateDef = mutation(`${prefix}.update`, {
+  const updateDef = !enabledMethods.has("update") ? void 0 : mutation(`${prefix}.update`, {
     public: isPublic,
     invalidates: [],
     handler: async (ctx, args) => {
@@ -2107,14 +2108,18 @@ function crud(table, options) {
       }
       const [result] = await ctx.db.update(anyTable).set(updateData).where(eq(pk, id)).returning();
       if (useRealtime) {
-        const listResult = await fetchListWithTotal(ctx.db);
-        ctx.realtime.emit(`${prefix}.list`, listResult);
-        ctx.realtime.emit(`${prefix}.get`, result);
+        if (enabledMethods.has("list")) {
+          const listResult = await fetchListWithTotal(ctx.db);
+          ctx.realtime.emit(`${prefix}.list`, listResult);
+        }
+        if (enabledMethods.has("get")) {
+          ctx.realtime.emit(`${prefix}.get`, result);
+        }
       }
       return result;
     }
   });
-  const removeDef = mutation(`${prefix}.remove`, {
+  const removeDef = !enabledMethods.has("remove") ? void 0 : mutation(`${prefix}.remove`, {
     public: isPublic,
     invalidates: [],
     handler: async (ctx, args) => {
@@ -2125,7 +2130,7 @@ function crud(table, options) {
       } else {
         await ctx.db.delete(anyTable).where(eq(pk, args.id));
       }
-      if (useRealtime) {
+      if (useRealtime && enabledMethods.has("list")) {
         const listResult = await fetchListWithTotal(ctx.db);
         ctx.realtime.emit(`${prefix}.list`, listResult);
       }

package/lib/__tests__/readme-codegen.test.ts

@@ -223,8 +223,24 @@ describe("buildAiPrompt — AI Vibe-Coding 프롬프트", () => {
 
     it("mutation 제한 경고 포함", () => {
         const md = buildAiPrompt(SIMPLE_API, ["tasks"]);
-        expect(md).toContain("mutation은 10초 이내");
-        expect(md).toContain("scheduler.runAfter");
+        expect(md).toContain("mutation: 30초");
+        expect(md).toContain("FUNCTION_TIMEOUT");
+        expect(md).toContain("별도 mutation으로 분리");
+    });
+
+    it("mutation 간 공유 로직 패턴 포함", () => {
+        const md = buildAiPrompt(SIMPLE_API, ["tasks"]);
+        expect(md).toContain("mutation 간 로직 공유");
+        expect(md).toContain("일반 async 함수로 분리");
+        expect(md).toContain("mutation은 래핑만");
+    });
+
+    it("AI 우회 금지 목록 포함", () => {
+        const md = buildAiPrompt(SIMPLE_API, ["tasks"]);
+        expect(md).toContain("절대 금지");
+        expect(md).toContain("openai-direct.ts");
+        expect(md).toContain("ai.ts 수정 또는 우회 금지");
+        expect(md).toContain("SDK 직접 설치/사용 금지");
     });
 
     it("크론 잡 사용법 포함", () => {

package/lib/readme-codegen.mjs

@@ -296,16 +296,28 @@ export function buildAiPrompt(apiObj, namespaces) {
     md += `- 반드시 useQuery와 useMutation을 사용해서 데이터와 연결해줘.\n`;
     md += `- fetch()를 직접 호출하거나 apiPost() 같은 래퍼를 만들지 마.\n`;
     md += `- gencow/api.ts는 자동 생성된 파일이야. 수동으로 만들지 마.\n`;
+    md += `- ⚠️ gencow/ai.ts는 자동 생성 파일이야. 절대 수정하지 마. 에러 발생 시 환경변수(.env)를 확인하거나 \`npx gencow add AI\`로 재설치해.\n`;
     md += `- gencow/index.ts의 re-export는 export * as moduleName from "./moduleName" 패턴을 써.\n`;
     md += `  Module, Mod 같은 접미사를 붙이지 마.\n`;
     md += `\n`;
-    md += `⚠️ mutation 제한:\n`;
-    md += `- mutation은 10초 이내에 완료되어야 해. 외부 API나 LLM 호출이 길면 단계별로 분리해.\n`;
-    md += `- 긴 작업은 ctx.scheduler.runAfter(0, "module.nextStep", { sessionId }) 로 다음 단계를 예약.\n`;
-    md += `- 예: 크롤링(Step1) → 필터링(Step2) → 요약(Step3) 각각 별도 mutation으로 분리.\n`;
-    md += `- 같은 서버의 다른 모듈 함수를 호출할 때는 fetch()가 아닌 직접 import해서 호출해.\n`;
-    md += `  예: import { fetchNews } from "./naverApi"; → const result = await fetchNews.handler(ctx, { keyword });\n`;
-    md += `  HTTP self-fetch (fetch("/api/mutation")) 패턴은 불필요한 네트워크 우회이므로 사용하지 마.\n`;
+    md += `⚠️ mutation 제한 (타임아웃):\n`;
+    md += `- query: 30초, mutation: 30초, cron: 10분. 이 시간을 초과하면 FUNCTION_TIMEOUT 에러.\n`;
+    md += `- ✅ 1순위: 각 단계를 별도 mutation으로 분리하고, 프론트엔드에서 순차 호출해.\n`;
+    md += `  예: 크롤링(Step1) → 필터링(Step2) → 요약(Step3) 각각 별도 mutation으로 분리.\n`;
+    md += `  프론트엔드: await crawl(); await filter(); await summarize();\n`;
+    md += `- ⚠️ 보조: ctx.scheduler.runAfter(0, "module.nextStep", { sessionId }) — 로컬 dev에서만 안정적. 클라우드에서는 앱이 idle 상태로 전환 시 타이머가 소멸돼.\n`;
+    md += `\n`;
+    md += `⚠️ mutation 간 로직 공유:\n`;
+    md += `- mutation().handler()를 다른 mutation에서 직접 호출하면 안 돼.\n`;
+    md += `- ✅ 공유 로직은 일반 async 함수로 분리하고, 각 mutation에서 래핑해:\n`;
+    md += `  // 공유 함수 (일반 async 함수)\n`;
+    md += `  async function filterBatch(ctx, ids) { /* 실제 로직 */ }\n`;
+    md += `  // mutation은 래핑만\n`;
+    md += `  export const filter = mutation("pipeline.filter", {\n`;
+    md += `      handler: async (ctx, args) => filterBatch(ctx, args.ids),\n`;
+    md += `  });\n`;
+    md += `- ❌ fetch("/api/mutation") self-fetch 패턴은 사용하지 마.\n`;
+
     md += `\n`;
     md += `크론 잡 (예약 작업):\n`;
     md += `  gencow/crons.ts에서 cronJobs()로 선언\n`;
@@ -369,12 +381,18 @@ export function buildAiPrompt(apiObj, namespaces) {
     md += `  const hash = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(text));\n`;
     md += `  const hex = [...new Uint8Array(hash)].map(b => b.toString(16).padStart(2, "0")).join("");\n`;
     md += `- 직접 구현한 simpleHash 같은 32비트 해시는 충돌 위험이 있으니 SHA-256을 사용해.\n`;
-    md += `- AI 호출은 import { ai } from "./ai" 를 사용해:\n`;
+    md += `⚠️ AI 호출 규칙 (반드시 준수):\n`;
+    md += `- ✅ AI 호출은 반드시 import { ai } from "./ai"를 사용해:\n`;
     md += `  import { ai } from "./ai";\n`;
     md += `  const result = await ai.chat({ messages: [{ role: "user", content: "안녕" }] });\n`;
-    md += `  ❌ import OpenAI from "openai"; → 시크릿 관리, 비용 추적, 보안 문제 발생\n`;
-    md += `  ❌ OpenAI/Anthropic SDK 직접 설치 금지\n`;
     md += `  ✅ ai.chat()은 로컬(OPENAI_API_KEY)과 클라우드(Gencow 프록시) 자동 전환\n`;
+    md += `- ❌ 절대 금지:\n`;
+    md += `  - import OpenAI from "openai" — SDK 직접 설치/사용 금지\n`;
+    md += `  - fetch("https://api.openai.com/...") — API 직접 호출 금지\n`;
+    md += `  - openai-direct.ts, ai-wrapper.ts 같은 별도 래퍼 파일 생성 금지\n`;
+    md += `  - ai.ts 수정 또는 우회 금지 (프록시 우회 시 크레딧 차감 불가 + 장애 위험)\n`;
+    md += `- AI 에러 발생 시: .env의 OPENAI_API_KEY 확인 또는 npx gencow add AI로 재설치\n`;
+    md += `- JSON 응답 필요 시: ai.generateObject({ schema: z.object({...}), prompt: "..." })\n`;
     md += `- AI 컴포넌트가 없으면: gencow add AI 로 설치해.\n`;
     md += `- RAG가 필요하면: gencow add RAG (AI 자동 포함).\n`;
     md += `- 메모리가 필요하면: gencow add Memory.\n`;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "gencow",
-    "version": "0.1.109",
+    "version": "0.1.111",
     "description": "Gencow — AI Backend Engine",
     "type": "module",
     "bin": {

package/server/index.js

@@ -2076,7 +2076,8 @@ function crud(table, options) {
     const countResult = await db.select({ count: drizzleCount() }).from(anyTable).where(whereClause);
     return { data, total: Number(countResult[0]?.count ?? 0) };
   }
-  const listDef = query(`${prefix}.list`, {
+  const enabledMethods = new Set(options?.methods ?? ["list", "get", "create", "update", "remove"]);
+  const listDef = !enabledMethods.has("list") ? void 0 : query(`${prefix}.list`, {
     public: isPublic,
     args: {
       page: v.optional(v.number()),
@@ -2107,7 +2108,7 @@ function crud(table, options) {
       };
     }
   });
-  const getDef = query(`${prefix}.get`, {
+  const getDef = !enabledMethods.has("get") ? void 0 : query(`${prefix}.get`, {
     public: isPublic,
     args: { id: idValidator },
     handler: async (ctx, args) => {
@@ -2121,7 +2122,7 @@ function crud(table, options) {
       return result ?? null;
     }
   });
-  const createDef = mutation(`${prefix}.create`, {
+  const createDef = !enabledMethods.has("create") ? void 0 : mutation(`${prefix}.create`, {
     public: isPublic,
     invalidates: [],
     handler: async (ctx, args) => {
@@ -2134,14 +2135,14 @@ function crud(table, options) {
         insertData = await options.hooks.beforeCreate(insertData);
       }
       const [result] = await ctx.db.insert(anyTable).values(insertData).returning();
-      if (useRealtime) {
+      if (useRealtime && enabledMethods.has("list")) {
         const listResult = await fetchListWithTotal(ctx.db);
         ctx.realtime.emit(`${prefix}.list`, listResult);
       }
       return result;
     }
   });
-  const updateDef = mutation(`${prefix}.update`, {
+  const updateDef = !enabledMethods.has("update") ? void 0 : mutation(`${prefix}.update`, {
     public: isPublic,
     invalidates: [],
     handler: async (ctx, args) => {
@@ -2156,14 +2157,18 @@ function crud(table, options) {
       }
       const [result] = await ctx.db.update(anyTable).set(updateData).where(eq(pk, id)).returning();
       if (useRealtime) {
-        const listResult = await fetchListWithTotal(ctx.db);
-        ctx.realtime.emit(`${prefix}.list`, listResult);
-        ctx.realtime.emit(`${prefix}.get`, result);
+        if (enabledMethods.has("list")) {
+          const listResult = await fetchListWithTotal(ctx.db);
+          ctx.realtime.emit(`${prefix}.list`, listResult);
+        }
+        if (enabledMethods.has("get")) {
+          ctx.realtime.emit(`${prefix}.get`, result);
+        }
       }
       return result;
     }
   });
-  const removeDef = mutation(`${prefix}.remove`, {
+  const removeDef = !enabledMethods.has("remove") ? void 0 : mutation(`${prefix}.remove`, {
     public: isPublic,
     invalidates: [],
     handler: async (ctx, args) => {
@@ -2174,7 +2179,7 @@ function crud(table, options) {
       } else {
         await ctx.db.delete(anyTable).where(eq(pk, args.id));
       }
-      if (useRealtime) {
+      if (useRealtime && enabledMethods.has("list")) {
         const listResult = await fetchListWithTotal(ctx.db);
         ctx.realtime.emit(`${prefix}.list`, listResult);
       }
@@ -82244,7 +82249,7 @@ async function executeWithTimeout(fn, type, functionName) {
       new Promise((_, reject) => {
         controller.signal.addEventListener("abort", () => {
           const err = new Error(
-            `Function "${functionName}" exceeded ${timeoutMs / 1e3}s time limit. Use ctx.scheduler.runAfter() for long-running tasks.`
+            `Function "${functionName}" exceeded ${timeoutMs / 1e3}s time limit. Split into smaller mutations and call them sequentially from the frontend. Limits: query 30s, mutation 30s, httpAction 5min, cron 10min.`
           );
           err.code = "FUNCTION_TIMEOUT";
           reject(err);
@@ -83373,10 +83378,10 @@ async function main() {
       } : void 0),
       scheduler: scheduler ?? {
         runAfter: () => {
-          throw new Error("Scheduler not initialized");
+          throw new Error("Scheduler not initialized \u2014 add gencow/crons.ts to enable. Note: In BaaS mode, scheduler.runAfter() is sleep-unsafe (timers are lost when app goes idle). Recommended: split into separate mutations and call sequentially from frontend.");
         },
         runAt: () => {
-          throw new Error("Scheduler not initialized");
+          throw new Error("Scheduler not initialized \u2014 add gencow/crons.ts to enable. Note: In BaaS mode, scheduler.runAt() is sleep-unsafe.");
         },
         cancel: () => false,
         cron: () => {