@gencow/core 0.1.15 → 0.1.17

package/dist/crud.d.ts

@@ -48,6 +48,13 @@ type CrudOptions<T extends PgTable> = {
     realtime?: boolean;
     /** 키 접두사 오버라이드 (기본: 테이블명) */
     prefix?: string;
+    /**
+     * 생성할 메서드 목록 (기본: 전체 5개)
+     * 지정하면 해당 메서드만 레지스트리에 등록되고 반환됨.
+     * api.ts codegen에도 지정된 메서드만 포함됨.
+     * @example crud(table, { methods: ['list', 'get', 'create'] })
+     */
+    methods?: ('list' | 'get' | 'create' | 'update' | 'remove')[];
 };
 /** 지원 연산자 목록 */
 declare const FILTER_OPS: readonly ["eq", "ne", "gt", "gte", "lt", "lte", "in", "nin", "like", "ilike"];
@@ -103,14 +110,14 @@ export declare function crud<T extends PgTable>(table: T, options?: CrudOptions<
     }, {
         data: any;
         total: number;
-    }>;
+    }> | undefined;
     get: import("./reactive").QueryDef<{
         id: import("./v").Validator<string> | import("./v").Validator<number>;
-    }, any>;
-    create: import("./reactive").MutationDef<any, any>;
-    update: import("./reactive").MutationDef<any, any>;
+    }, any> | undefined;
+    create: import("./reactive").MutationDef<any, any> | undefined;
+    update: import("./reactive").MutationDef<any, any> | undefined;
     remove: import("./reactive").MutationDef<any, {
         success: boolean;
-    }>;
+    }> | undefined;
 };
 export {};

package/dist/crud.js

@@ -215,8 +215,11 @@ export function crud(table, options) {
         const countResult = await db.select({ count: drizzleCount() }).from(anyTable).where(whereClause);
         return { data, total: Number(countResult[0]?.count ?? 0) };
     }
+    // ── methods 필터링: 지정된 메서드만 레지스트리 등록 ──
+    // methods 옵션 미지정 시 전체 5개 등록 (하위호환)
+    const enabledMethods = new Set(options?.methods ?? ['list', 'get', 'create', 'update', 'remove']);
     // ── list ──────────────────────────────────────
-    const listDef = query(`${prefix}.list`, {
+    const listDef = !enabledMethods.has('list') ? undefined : query(`${prefix}.list`, {
         public: isPublic,
         args: {
             page: v.optional(v.number()),
@@ -243,8 +246,6 @@ export function crud(table, options) {
                 orderByClause = desc(defaultOrderCol);
             }
             // SELECT + COUNT 순차 실행 — 소규모 커넥션 풀 환경에서 동시 점유 방지
-            // Note: data←→count 사이 INSERT/DELETE 시 total 불일치 가능 (BaaS 단일사용자/저부하에서 무시 가능)
-            // TODO(P2): 대규모 시 db.transaction() 래핑 검토
             const results = await ctx.db.select()
                 .from(anyTable)
                 .where(whereClause)
@@ -261,7 +262,7 @@ export function crud(table, options) {
         }
     });
     // ── get ───────────────────────────────────────
-    const getDef = query(`${prefix}.get`, {
+    const getDef = !enabledMethods.has('get') ? undefined : query(`${prefix}.get`, {
         public: isPublic,
         args: { id: idValidator },
         handler: async (ctx, args) => {
@@ -277,7 +278,7 @@ export function crud(table, options) {
         }
     });
     // ── create ────────────────────────────────────
-    const createDef = mutation(`${prefix}.create`, {
+    const createDef = !enabledMethods.has('create') ? undefined : mutation(`${prefix}.create`, {
         public: isPublic,
         invalidates: [],
         handler: async (ctx, args) => {
@@ -293,7 +294,7 @@ export function crud(table, options) {
             }
             const [result] = await ctx.db.insert(anyTable).values(insertData).returning();
             // Realtime push — { data, total } 형태로 emit
-            if (useRealtime) {
+            if (useRealtime && enabledMethods.has('list')) {
                 const listResult = await fetchListWithTotal(ctx.db);
                 ctx.realtime.emit(`${prefix}.list`, listResult);
             }
@@ -301,7 +302,7 @@ export function crud(table, options) {
         }
     });
     // ── update ────────────────────────────────────
-    const updateDef = mutation(`${prefix}.update`, {
+    const updateDef = !enabledMethods.has('update') ? undefined : mutation(`${prefix}.update`, {
         public: isPublic,
         invalidates: [],
         handler: async (ctx, args) => {
@@ -323,15 +324,19 @@ export function crud(table, options) {
                 .returning();
             // Realtime push (list + get 양쪽) — { data, total } 형태
             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;
         }
     });
     // ── remove ────────────────────────────────────
-    const removeDef = mutation(`${prefix}.remove`, {
+    const removeDef = !enabledMethods.has('remove') ? undefined : mutation(`${prefix}.remove`, {
         public: isPublic,
         invalidates: [],
         handler: async (ctx, args) => {
@@ -347,13 +352,16 @@ export function crud(table, options) {
                 await ctx.db.delete(anyTable).where(eq(pk, args.id));
             }
             // Realtime push — { data, total } 형태
-            if (useRealtime) {
+            if (useRealtime && enabledMethods.has('list')) {
                 const listResult = await fetchListWithTotal(ctx.db);
                 ctx.realtime.emit(`${prefix}.list`, listResult);
             }
             return { success: true };
         }
     });
+    // 반환 객체는 항상 5개 키를 가지지만, 비활성 메서드는 undefined.
+    // 사용자가 destructure 시 undefined를 받으면 export하지 않으므로
+    // codegen의 레지스트리에 등록되지 않아 api.ts 불일치가 해소됨.
     return {
         list: listDef,
         get: getDef,

package/dist/reactive.d.ts

@@ -48,7 +48,7 @@ export interface AIResult {
     model: string;
 }
 export interface AIContext {
-    /** AI 텍스트 생성 — ctx.ai.chat({ model, messages }) */
+    /** AI 텍스트 생성 */
     chat: (opts: {
         model?: string;
         messages: AIMessage[];
@@ -61,9 +61,9 @@ export interface AIContext {
             type: string;
         };
     }) => Promise<AIResult>;
-    /** 텍스트 임베딩 (단일) — ctx.ai.embed("검색 텍스트") */
+    /** 텍스트 임베딩 (단일) */
     embed: (text: string) => Promise<number[]>;
-    /** 배치 임베딩 — ctx.ai.embedMany(["텍스트1", "텍스트2"]) */
+    /** 배치 임베딩 */
     embedMany: (texts: string[]) => Promise<number[][]>;
 }
 export interface GencowCtx {
@@ -81,7 +81,7 @@ export interface GencowCtx {
     realtime: RealtimeCtx;
     /** 재시도 — ctx.retry(fn, opts) — exponential backoff + jitter */
     retry: <T>(fn: () => Promise<T>, options?: import("./retry").RetryOptions) => Promise<T>;
-    /** AI 헬퍼 — ctx.ai.chat({ model, messages }) — 로컬: 직접 호출, BaaS: Control Plane 프록시 */
+    /** AI 헬퍼 */
     ai?: AIContext;
 }
 type QueryHandler<TArgs = any, TReturn = any> = (ctx: GencowCtx, args: TArgs) => Promise<TReturn>;
@@ -248,8 +248,18 @@ export declare function deregisterClient(ws: WSContext): void;
  * 마지막 데이터만 push하여 불필요한 전송을 방지합니다.
  *
  * ⚠️ 매 mutation 호출마다 새로 생성해야 합니다 (debounce timer가 mutation scope에 격리).
+ *
+ * @param options.httpCallback  BaaS 모드: Platform WS Gateway에 HTTP로 emit 전달.
+ *                              설정되면 WS 직접 push 대신 이 콜백을 호출.
+ *                              로컬 dev에서는 미설정 → 기존 WS 직접 push 유지.
  */
-export declare function buildRealtimeCtx(): RealtimeCtx;
+export declare function buildRealtimeCtx(options?: {
+    httpCallback?: (event: {
+        type: "emit";
+        queryKey: string;
+        data: unknown;
+    }) => void;
+}): RealtimeCtx;
 /**
  * mutation이 끝난 후 호출되는 legacy fallback.
  * `ctx.realtime.emit()`을 사용하는 새 mutation에서는 빈 배열([])을 전달하면 됩니다.
@@ -258,8 +268,9 @@ export declare function buildRealtimeCtx(): RealtimeCtx;
  * (서버에서 쿼리를 재실행하지 않으므로 DB 부하 없음)
  *
  * @deprecated ctx.realtime.emit() 사용 권장
+ * @param httpInvalidateCallback  BaaS 모드: Platform WS Gateway에 HTTP로 invalidation 전달.
  */
-export declare function invalidateQueries(queryKeys: string[], ctx: GencowCtx): Promise<void>;
+export declare function invalidateQueries(queryKeys: string[], ctx: GencowCtx, httpInvalidateCallback?: (queryKeys: string[]) => void): Promise<void>;
 export declare function handleWsMessage(ws: WSContext, raw: string | ArrayBuffer): void;
 export declare function getQueryHandler(key: string): QueryHandler | undefined;
 export declare function getQueryDef(key: string): QueryDef | undefined;

package/dist/reactive.js

@@ -181,8 +181,12 @@ export function deregisterClient(ws) {
  * 마지막 데이터만 push하여 불필요한 전송을 방지합니다.
  *
  * ⚠️ 매 mutation 호출마다 새로 생성해야 합니다 (debounce timer가 mutation scope에 격리).
+ *
+ * @param options.httpCallback  BaaS 모드: Platform WS Gateway에 HTTP로 emit 전달.
+ *                              설정되면 WS 직접 push 대신 이 콜백을 호출.
+ *                              로컬 dev에서는 미설정 → 기존 WS 직접 push 유지.
  */
-export function buildRealtimeCtx() {
+export function buildRealtimeCtx(options) {
     const pendingEmits = new Map();
     return {
         emit(queryKey, data) {
@@ -192,6 +196,12 @@ export function buildRealtimeCtx() {
                 clearTimeout(existing.timer);
             const timer = setTimeout(() => {
                 pendingEmits.delete(queryKey);
+                // BaaS 모드: Platform WS Gateway에 HTTP callback
+                if (options?.httpCallback) {
+                    options.httpCallback({ type: "emit", queryKey, data });
+                    return;
+                }
+                // 로컬 dev: WS 직접 push (기존 동작)
                 const clients = subscribers.get(queryKey);
                 if (!clients || clients.size === 0)
                     return;
@@ -221,11 +231,17 @@ export function buildRealtimeCtx() {
  * (서버에서 쿼리를 재실행하지 않으므로 DB 부하 없음)
  *
  * @deprecated ctx.realtime.emit() 사용 권장
+ * @param httpInvalidateCallback  BaaS 모드: Platform WS Gateway에 HTTP로 invalidation 전달.
  */
-export async function invalidateQueries(queryKeys, ctx) {
+export async function invalidateQueries(queryKeys, ctx, httpInvalidateCallback) {
     if (queryKeys.length === 0)
         return; // emit() 방식에서는 no-op
-    // invalidate 신호만 broadcast (re-fetch는 클라이언트 결정에 맡김)
+    // BaaS 모드: Platform WS Gateway에 HTTP callback
+    if (httpInvalidateCallback) {
+        httpInvalidateCallback(queryKeys);
+        return;
+    }
+    // 로컬 dev: WS 직접 broadcast (기존 동작)
     const invalidateMsg = JSON.stringify({ type: "invalidate", queries: queryKeys });
     for (const ws of connectedClients) {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gencow/core",
-    "version": "0.1.15",
+    "version": "0.1.17",
     "description": "Gencow core library — defineQuery, defineMutation, reactive subscriptions",
     "type": "module",
     "main": "dist/index.js",

package/src/crud.ts

@@ -52,6 +52,13 @@ type CrudOptions<T extends PgTable> = {
     realtime?: boolean;
     /** 키 접두사 오버라이드 (기본: 테이블명) */
     prefix?: string;
+    /**
+     * 생성할 메서드 목록 (기본: 전체 5개)
+     * 지정하면 해당 메서드만 레지스트리에 등록되고 반환됨.
+     * api.ts codegen에도 지정된 메서드만 포함됨.
+     * @example crud(table, { methods: ['list', 'get', 'create'] })
+     */
+    methods?: ('list' | 'get' | 'create' | 'update' | 'remove')[];
 };
 
 // ─── Helpers ────────────────────────────────────────────
@@ -271,9 +278,13 @@ export function crud<T extends PgTable>(table: T, options?: CrudOptions<T>) {
         return { data, total: Number(countResult[0]?.count ?? 0) };
     }
 
+    // ── methods 필터링: 지정된 메서드만 레지스트리 등록 ──
+    // methods 옵션 미지정 시 전체 5개 등록 (하위호환)
+    const enabledMethods = new Set(options?.methods ?? ['list', 'get', 'create', 'update', 'remove']);
+
     // ── list ──────────────────────────────────────
 
-    const listDef = query(`${prefix}.list`, {
+    const listDef = !enabledMethods.has('list') ? undefined : query(`${prefix}.list`, {
         public: isPublic,
         args: {
             page: v.optional(v.number()),
@@ -302,8 +313,6 @@ export function crud<T extends PgTable>(table: T, options?: CrudOptions<T>) {
             }
 
             // SELECT + COUNT 순차 실행 — 소규모 커넥션 풀 환경에서 동시 점유 방지
-            // Note: data←→count 사이 INSERT/DELETE 시 total 불일치 가능 (BaaS 단일사용자/저부하에서 무시 가능)
-            // TODO(P2): 대규모 시 db.transaction() 래핑 검토
             const results = await ctx.db.select()
                 .from(anyTable)
                 .where(whereClause)
@@ -323,7 +332,7 @@ export function crud<T extends PgTable>(table: T, options?: CrudOptions<T>) {
 
     // ── get ───────────────────────────────────────
 
-    const getDef = query(`${prefix}.get`, {
+    const getDef = !enabledMethods.has('get') ? undefined : query(`${prefix}.get`, {
         public: isPublic,
         args: { id: idValidator },
         handler: async (ctx: any, args: any) => {
@@ -343,7 +352,7 @@ export function crud<T extends PgTable>(table: T, options?: CrudOptions<T>) {
 
     // ── create ────────────────────────────────────
 
-    const createDef = mutation(`${prefix}.create`, {
+    const createDef = !enabledMethods.has('create') ? undefined : mutation(`${prefix}.create`, {
         public: isPublic,
         invalidates: [],
         handler: async (ctx: any, args: any) => {
@@ -364,7 +373,7 @@ export function crud<T extends PgTable>(table: T, options?: CrudOptions<T>) {
             const [result] = await ctx.db.insert(anyTable).values(insertData).returning();
 
             // Realtime push — { data, total } 형태로 emit
-            if (useRealtime) {
+            if (useRealtime && enabledMethods.has('list')) {
                 const listResult = await fetchListWithTotal(ctx.db);
                 ctx.realtime.emit(`${prefix}.list`, listResult);
             }
@@ -375,7 +384,7 @@ export function crud<T extends PgTable>(table: T, options?: CrudOptions<T>) {
 
     // ── update ────────────────────────────────────
 
-    const updateDef = mutation(`${prefix}.update`, {
+    const updateDef = !enabledMethods.has('update') ? undefined : mutation(`${prefix}.update`, {
         public: isPublic,
         invalidates: [],
         handler: async (ctx: any, args: any) => {
@@ -402,9 +411,13 @@ export function crud<T extends PgTable>(table: T, options?: CrudOptions<T>) {
 
             // Realtime push (list + get 양쪽) — { data, total } 형태
             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;
@@ -413,7 +426,7 @@ export function crud<T extends PgTable>(table: T, options?: CrudOptions<T>) {
 
     // ── remove ────────────────────────────────────
 
-    const removeDef = mutation(`${prefix}.remove`, {
+    const removeDef = !enabledMethods.has('remove') ? undefined : mutation(`${prefix}.remove`, {
         public: isPublic,
         invalidates: [],
         handler: async (ctx: any, args: any) => {
@@ -429,7 +442,7 @@ export function crud<T extends PgTable>(table: T, options?: CrudOptions<T>) {
             }
 
             // Realtime push — { data, total } 형태
-            if (useRealtime) {
+            if (useRealtime && enabledMethods.has('list')) {
                 const listResult = await fetchListWithTotal(ctx.db);
                 ctx.realtime.emit(`${prefix}.list`, listResult);
             }
@@ -438,6 +451,9 @@ export function crud<T extends PgTable>(table: T, options?: CrudOptions<T>) {
         }
     });
 
+    // 반환 객체는 항상 5개 키를 가지지만, 비활성 메서드는 undefined.
+    // 사용자가 destructure 시 undefined를 받으면 export하지 않으므로
+    // codegen의 레지스트리에 등록되지 않아 api.ts 불일치가 해소됨.
     return {
         list: listDef,
         get: getDef,

package/src/reactive.ts

@@ -54,7 +54,7 @@ export interface AIResult {
 }
 
 export interface AIContext {
-    /** AI 텍스트 생성 — ctx.ai.chat({ model, messages }) */
+    /** AI 텍스트 생성 */
     chat: (opts: {
         model?: string;
         messages: AIMessage[];
@@ -65,9 +65,9 @@ export interface AIContext {
         /** Response format — e.g. { type: "json_object" } for JSON mode */
         responseFormat?: { type: string };
     }) => Promise<AIResult>;
-    /** 텍스트 임베딩 (단일) — ctx.ai.embed("검색 텍스트") */
+    /** 텍스트 임베딩 (단일) */
     embed: (text: string) => Promise<number[]>;
-    /** 배치 임베딩 — ctx.ai.embedMany(["텍스트1", "텍스트2"]) */
+    /** 배치 임베딩 */
     embedMany: (texts: string[]) => Promise<number[][]>;
 }
 
@@ -86,7 +86,7 @@ export interface GencowCtx {
     realtime: RealtimeCtx;
     /** 재시도 — ctx.retry(fn, opts) — exponential backoff + jitter */
     retry: <T>(fn: () => Promise<T>, options?: import("./retry").RetryOptions) => Promise<T>;
-    /** AI 헬퍼 — ctx.ai.chat({ model, messages }) — 로컬: 직접 호출, BaaS: Control Plane 프록시 */
+    /** AI 헬퍼 */
     ai?: AIContext;
 }
 
@@ -392,8 +392,14 @@ export function deregisterClient(ws: WSContext) {
  * 마지막 데이터만 push하여 불필요한 전송을 방지합니다.
  *
  * ⚠️ 매 mutation 호출마다 새로 생성해야 합니다 (debounce timer가 mutation scope에 격리).
+ *
+ * @param options.httpCallback  BaaS 모드: Platform WS Gateway에 HTTP로 emit 전달.
+ *                              설정되면 WS 직접 push 대신 이 콜백을 호출.
+ *                              로컬 dev에서는 미설정 → 기존 WS 직접 push 유지.
  */
-export function buildRealtimeCtx(): RealtimeCtx {
+export function buildRealtimeCtx(options?: {
+    httpCallback?: (event: { type: "emit"; queryKey: string; data: unknown }) => void;
+}): RealtimeCtx {
     const pendingEmits = new Map<string, { data: unknown; timer: ReturnType<typeof setTimeout> }>();
 
     return {
@@ -404,6 +410,14 @@ export function buildRealtimeCtx(): RealtimeCtx {
 
             const timer = setTimeout(() => {
                 pendingEmits.delete(queryKey);
+
+                // BaaS 모드: Platform WS Gateway에 HTTP callback
+                if (options?.httpCallback) {
+                    options.httpCallback({ type: "emit", queryKey, data });
+                    return;
+                }
+
+                // 로컬 dev: WS 직접 push (기존 동작)
                 const clients = subscribers.get(queryKey);
                 if (!clients || clients.size === 0) return;
 
@@ -430,14 +444,22 @@ export function buildRealtimeCtx(): RealtimeCtx {
  * (서버에서 쿼리를 재실행하지 않으므로 DB 부하 없음)
  *
  * @deprecated ctx.realtime.emit() 사용 권장
+ * @param httpInvalidateCallback  BaaS 모드: Platform WS Gateway에 HTTP로 invalidation 전달.
  */
 export async function invalidateQueries(
     queryKeys: string[],
-    ctx: GencowCtx
+    ctx: GencowCtx,
+    httpInvalidateCallback?: (queryKeys: string[]) => void,
 ): Promise<void> {
     if (queryKeys.length === 0) return; // emit() 방식에서는 no-op
 
-    // invalidate 신호만 broadcast (re-fetch는 클라이언트 결정에 맡김)
+    // BaaS 모드: Platform WS Gateway에 HTTP callback
+    if (httpInvalidateCallback) {
+        httpInvalidateCallback(queryKeys);
+        return;
+    }
+
+    // 로컬 dev: WS 직접 broadcast (기존 동작)
     const invalidateMsg = JSON.stringify({ type: "invalidate", queries: queryKeys });
     for (const ws of connectedClients) {
         try { ws.send(invalidateMsg); } catch { connectedClients.delete(ws); }