@gencow/core 0.1.16 → 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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gencow/core",
-    "version": "0.1.16",
+    "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,