reltype 0.1.1

package/dist/features/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/query/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/features/query/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./select"), exports);
+__exportStar(require("./insert"), exports);
+__exportStar(require("./update"), exports);
+__exportStar(require("./delete"), exports);
+__exportStar(require("./upsert"), exports);
+__exportStar(require("./bulkInsert"), exports);
+__exportStar(require("./where"), exports);
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./builder"), exports);

package/dist/features/query/insert.d.ts

@@ -0,0 +1,7 @@
+import { BuiltQuery } from './interfaces/Query';
+/**
+ * INSERT 쿼리를 생성합니다. RETURNING * 으로 삽입된 row를 반환합니다.
+ * camelCase key → snake_case 컬럼명으로 자동 변환됩니다.
+ */
+export declare function buildInsert(table: string, data: Record<string, unknown>): BuiltQuery;
+//# sourceMappingURL=insert.d.ts.map

package/dist/features/query/insert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert.d.ts","sourceRoot":"","sources":["../../../src/features/query/insert.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,UAAU,CAWZ"}

package/dist/features/query/insert.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInsert = buildInsert;
+const case_1 = require("../transform/case");
+/**
+ * INSERT 쿼리를 생성합니다. RETURNING * 으로 삽입된 row를 반환합니다.
+ * camelCase key → snake_case 컬럼명으로 자동 변환됩니다.
+ */
+function buildInsert(table, data) {
+    const entries = Object.entries(data).filter(([, v]) => v !== undefined);
+    const cols = entries.map(([k]) => (0, case_1.toSnake)(k)).join(', ');
+    const placeholders = entries.map((_, i) => `$${i + 1}`).join(', ');
+    const params = entries.map(([, v]) => v);
+    return {
+        sql: `INSERT INTO ${table} (${cols}) VALUES (${placeholders}) RETURNING *`,
+        params,
+    };
+}

package/dist/features/query/interfaces/Advanced.d.ts

@@ -0,0 +1,177 @@
+/** WHERE 조건 연산자 */
+export type WhereOp = '=' | '!=' | '>' | '<' | '>=' | '<=' | 'LIKE' | 'ILIKE' | 'IN' | 'NOT IN' | 'IS NULL' | 'IS NOT NULL';
+/**
+ * 고급 WHERE 조건값.
+ * `{ operator: 'LIKE', value: '%search%' }` 형태로 사용합니다.
+ */
+export interface WhereVal<T> {
+    operator: WhereOp;
+    /** IS NULL / IS NOT NULL 일 때는 생략 가능 */
+    value?: T | T[];
+}
+/**
+ * 고급 WHERE 조건 입력 타입.
+ * 단순 값(등호 조건) 또는 `WhereVal`(연산자 지정) 모두 허용합니다.
+ *
+ * @example
+ * ```ts
+ * // 등호
+ * { isActive: true }
+ * // LIKE
+ * { email: { operator: 'LIKE', value: '%@gmail.com' } }
+ * // IN
+ * { id: { operator: 'IN', value: [1, 2, 3] } }
+ * // NULL 체크
+ * { deletedAt: { operator: 'IS NULL' } }
+ * ```
+ */
+export type AdvancedWhere<T> = {
+    [K in keyof T]?: T[K] | WhereVal<T[K]>;
+};
+/** JOIN 종류 */
+export type JoinType = 'INNER' | 'LEFT' | 'RIGHT' | 'FULL';
+/**
+ * JOIN 절 정의.
+ *
+ * @example
+ * ```ts
+ * repo.select()
+ *   .join({ table: 'orders', on: 'users.id = orders.user_id', type: 'LEFT' })
+ * ```
+ */
+export interface JoinClause {
+    table: string;
+    /** ON 절 (snake_case 컬럼명으로 직접 작성) */
+    on: string;
+    type?: JoinType;
+}
+/** 집계 함수 종류 */
+export type AggregateFn = 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX';
+/**
+ * 집계 함수 정의.
+ *
+ * @example
+ * ```ts
+ * .calculate([
+ *   { fn: 'COUNT', alias: 'count' },
+ *   { fn: 'AVG',   column: 'price', alias: 'avgPrice' },
+ * ])
+ * ```
+ */
+export interface AggregateCalc {
+    fn: AggregateFn;
+    /** 대상 컬럼 (생략 시 *) */
+    column?: string;
+    alias: string;
+}
+/** 페이지네이션 입력 옵션 */
+export interface PaginateOpts {
+    page: number;
+    pageSize: number;
+}
+/**
+ * 페이지네이션 결과.
+ *
+ * @example
+ * ```ts
+ * {
+ *   data: [...],
+ *   count: 150,
+ *   page: 2,
+ *   pageSize: 20,
+ *   nextAction: true,
+ *   previousAction: true
+ * }
+ * ```
+ */
+export interface PageResult<T> {
+    data: T[];
+    /** 필터 조건에 해당하는 전체 row 수 */
+    count: number;
+    page: number;
+    pageSize: number;
+    /** 다음 페이지가 존재하는지 여부 */
+    nextAction: boolean;
+    /** 이전 페이지가 존재하는지 여부 */
+    previousAction: boolean;
+}
+/** ORDER BY 절 */
+export interface OrderByClause<T = Record<string, unknown>> {
+    column: keyof T | string;
+    direction?: 'ASC' | 'DESC';
+}
+/** 내부 조건 저장 포맷 (실행 시 SQL 생성) */
+export interface RawCond {
+    col: string;
+    op: WhereOp;
+    val?: unknown;
+}
+/**
+ * 커서 기반(Keyset) 페이지네이션 옵션.
+ *
+ * OFFSET 방식 대비 대용량 테이블에서 일정한 성능을 보장합니다.
+ * 인덱스가 걸린 컬럼(id, createdAt 등)을 cursorColumn으로 지정하세요.
+ *
+ * @example
+ * ```ts
+ * // 첫 번째 페이지
+ * const p1 = await repo.select().cursorPaginate({ pageSize: 20, cursorColumn: 'id' });
+ * // 다음 페이지
+ * const p2 = await repo.select().cursorPaginate({ pageSize: 20, cursorColumn: 'id', cursor: p1.nextCursor });
+ * ```
+ */
+export interface KeysetPaginateOpts {
+    pageSize: number;
+    /** 이전 페이지 결과의 nextCursor 값 (최초 요청 시 생략) */
+    cursor?: string;
+    /** 커서로 사용할 컬럼 (camelCase, 인덱스가 존재해야 합니다) */
+    cursorColumn: string;
+    direction?: 'asc' | 'desc';
+}
+/** 커서 기반 페이지네이션 결과 */
+export interface KeysetPageResult<T> {
+    data: T[];
+    /** 다음 페이지 요청 시 cursor 파라미터로 전달하세요. null이면 마지막 페이지입니다. */
+    nextCursor: string | null;
+    pageSize: number;
+    hasNext: boolean;
+}
+/**
+ * 배치 스트리밍 옵션.
+ * 대용량 데이터를 메모리에 전부 로드하지 않고 청크 단위로 처리합니다.
+ */
+export interface StreamOpts {
+    /** 한 번에 DB에서 읽어올 row 수 (기본값: 500) */
+    batchSize?: number;
+}
+/**
+ * 쿼리 실행 라이프사이클 훅.
+ *
+ * @example
+ * ```ts
+ * repo.select()
+ *   .hooks({
+ *     beforeExec: ({ sql }) => logger.debug('실행 예정 SQL:', sql),
+ *     afterExec:  ({ rows, elapsed }) => metrics.record('query', elapsed),
+ *     onError:    ({ err }) => alerting.send(err),
+ *   })
+ *   .paginate({ page: 1, pageSize: 20 });
+ * ```
+ */
+export interface ExecHooks<T extends Record<string, unknown> = Record<string, unknown>> {
+    beforeExec?: (ctx: {
+        sql: string;
+        params: unknown[];
+    }) => void | Promise<void>;
+    afterExec?: (ctx: {
+        rows: T[];
+        elapsed: number;
+        sql: string;
+    }) => void | Promise<void>;
+    onError?: (ctx: {
+        err: Error;
+        sql: string;
+        params: unknown[];
+    }) => void | Promise<void>;
+}
+//# sourceMappingURL=Advanced.d.ts.map

package/dist/features/query/interfaces/Advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Advanced.d.ts","sourceRoot":"","sources":["../../../../src/features/query/interfaces/Advanced.ts"],"names":[],"mappings":"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"}

package/dist/features/query/interfaces/Advanced.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/features/query/interfaces/Order.d.ts

@@ -0,0 +1,6 @@
+export type OrderDir = 'ASC' | 'DESC';
+export interface OrderByInput<T> {
+    col: keyof T;
+    dir?: OrderDir;
+}
+//# sourceMappingURL=Order.d.ts.map

package/dist/features/query/interfaces/Order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Order.d.ts","sourceRoot":"","sources":["../../../../src/features/query/interfaces/Order.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAEtC,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC,CAAC;IACb,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB"}

package/dist/features/query/interfaces/Order.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/features/query/interfaces/Query.d.ts

@@ -0,0 +1,6 @@
+/** SQL 문자열과 parameterized 값 묶음 */
+export interface BuiltQuery {
+    readonly sql: string;
+    readonly params: unknown[];
+}
+//# sourceMappingURL=Query.d.ts.map

package/dist/features/query/interfaces/Query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Query.d.ts","sourceRoot":"","sources":["../../../../src/features/query/interfaces/Query.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;CAC5B"}

package/dist/features/query/interfaces/Query.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/features/query/interfaces/Where.d.ts

@@ -0,0 +1,3 @@
+/** WHERE 조건 입력 타입 (camelCase key) */
+export type WhereInput<T> = Partial<T>;
+//# sourceMappingURL=Where.d.ts.map

package/dist/features/query/interfaces/Where.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Where.d.ts","sourceRoot":"","sources":["../../../../src/features/query/interfaces/Where.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/features/query/interfaces/Where.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/features/query/interfaces/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Query';
+export * from './Where';
+export * from './Order';
+export * from './Advanced';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/query/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/query/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC"}

package/dist/features/query/interfaces/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Query"), exports);
+__exportStar(require("./Where"), exports);
+__exportStar(require("./Order"), exports);
+__exportStar(require("./Advanced"), exports);

package/dist/features/query/select.d.ts

@@ -0,0 +1,15 @@
+import { BuiltQuery } from './interfaces/Query';
+import { WhereInput } from './interfaces/Where';
+import { OrderByInput } from './interfaces/Order';
+export interface SelectOpts<T extends Record<string, unknown>> {
+    where?: WhereInput<T>;
+    orderBy?: OrderByInput<T>[];
+    limit?: number;
+    offset?: number;
+}
+/**
+ * SELECT 쿼리를 생성합니다.
+ * 모든 WHERE 조건은 camelCase → snake_case 자동 변환됩니다.
+ */
+export declare function buildSelect<T extends Record<string, unknown>>(table: string, opts?: SelectOpts<T>): BuiltQuery;
+//# sourceMappingURL=select.d.ts.map

package/dist/features/query/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/features/query/select.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,UAAU,CAAC,CAAC,CAAM,GACvB,UAAU,CA8BZ"}

package/dist/features/query/select.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSelect = buildSelect;
+const case_1 = require("../transform/case");
+const where_1 = require("./where");
+/**
+ * SELECT 쿼리를 생성합니다.
+ * 모든 WHERE 조건은 camelCase → snake_case 자동 변환됩니다.
+ */
+function buildSelect(table, opts = {}) {
+    const parts = [`SELECT * FROM ${table}`];
+    const params = [];
+    if (opts.where && Object.keys(opts.where).length > 0) {
+        const { sql: w, params: wp } = (0, where_1.buildWhere)(opts.where, params.length + 1);
+        if (w) {
+            parts.push(w);
+            params.push(...wp);
+        }
+    }
+    if (opts.orderBy && opts.orderBy.length > 0) {
+        const clauses = opts.orderBy.map(({ col, dir }) => `${(0, case_1.toSnake)(String(col))} ${dir ?? 'ASC'}`);
+        parts.push(`ORDER BY ${clauses.join(', ')}`);
+    }
+    if (opts.limit !== undefined) {
+        params.push(opts.limit);
+        parts.push(`LIMIT $${params.length}`);
+    }
+    if (opts.offset !== undefined) {
+        params.push(opts.offset);
+        parts.push(`OFFSET $${params.length}`);
+    }
+    return { sql: parts.join(' '), params };
+}

package/dist/features/query/update.d.ts

@@ -0,0 +1,8 @@
+import { BuiltQuery } from './interfaces/Query';
+import { WhereInput } from './interfaces/Where';
+/**
+ * UPDATE 쿼리를 생성합니다. RETURNING * 으로 수정된 row를 반환합니다.
+ * camelCase key → snake_case 컬럼명으로 자동 변환됩니다.
+ */
+export declare function buildUpdate<T extends Record<string, unknown>>(table: string, data: Partial<T>, where: WhereInput<T>): BuiltQuery;
+//# sourceMappingURL=update.d.ts.map

package/dist/features/query/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/features/query/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GACnB,UAAU,CAsBZ"}

package/dist/features/query/update.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildUpdate = buildUpdate;
+const case_1 = require("../transform/case");
+const where_1 = require("./where");
+/**
+ * UPDATE 쿼리를 생성합니다. RETURNING * 으로 수정된 row를 반환합니다.
+ * camelCase key → snake_case 컬럼명으로 자동 변환됩니다.
+ */
+function buildUpdate(table, data, where) {
+    const entries = Object.entries(data).filter(([, v]) => v !== undefined);
+    const params = [];
+    const setClauses = entries.map(([k, v]) => {
+        params.push(v);
+        return `${(0, case_1.toSnake)(k)} = $${params.length}`;
+    });
+    const { sql: whereSql, params: whereParams } = (0, where_1.buildWhere)(where, params.length + 1);
+    params.push(...whereParams);
+    const sql = [
+        `UPDATE ${table}`,
+        `SET ${setClauses.join(', ')}`,
+        whereSql,
+        'RETURNING *',
+    ]
+        .filter(Boolean)
+        .join(' ');
+    return { sql, params };
+}

package/dist/features/query/upsert.d.ts

@@ -0,0 +1,11 @@
+import { BuiltQuery } from './interfaces/Query';
+/**
+ * INSERT ... ON CONFLICT DO UPDATE 쿼리를 생성합니다.
+ * 충돌 컬럼을 제외한 나머지 컬럼을 EXCLUDED 값으로 업데이트합니다.
+ *
+ * @param table       - 테이블명 (snake_case)
+ * @param data        - 삽입할 데이터 (camelCase key)
+ * @param conflictCol - 충돌 기준 컬럼명 (snake_case)
+ */
+export declare function buildUpsert(table: string, data: Record<string, unknown>, conflictCol: string): BuiltQuery;
+//# sourceMappingURL=upsert.d.ts.map

package/dist/features/query/upsert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../../src/features/query/upsert.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,MAAM,GAClB,UAAU,CAqBZ"}

package/dist/features/query/upsert.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildUpsert = buildUpsert;
+const case_1 = require("../transform/case");
+/**
+ * INSERT ... ON CONFLICT DO UPDATE 쿼리를 생성합니다.
+ * 충돌 컬럼을 제외한 나머지 컬럼을 EXCLUDED 값으로 업데이트합니다.
+ *
+ * @param table       - 테이블명 (snake_case)
+ * @param data        - 삽입할 데이터 (camelCase key)
+ * @param conflictCol - 충돌 기준 컬럼명 (snake_case)
+ */
+function buildUpsert(table, data, conflictCol) {
+    const entries = Object.entries(data).filter(([, v]) => v !== undefined);
+    const cols = entries.map(([k]) => (0, case_1.toSnake)(k)).join(', ');
+    const placeholders = entries.map((_, i) => `$${i + 1}`).join(', ');
+    const params = entries.map(([, v]) => v);
+    const updateSet = entries
+        .map(([k]) => (0, case_1.toSnake)(k))
+        .filter((col) => col !== conflictCol)
+        .map((col) => `${col} = EXCLUDED.${col}`)
+        .join(', ');
+    return {
+        sql: [
+            `INSERT INTO ${table} (${cols}) VALUES (${placeholders})`,
+            `ON CONFLICT (${conflictCol}) DO UPDATE SET ${updateSet}`,
+            'RETURNING *',
+        ].join(' '),
+        params,
+    };
+}

package/dist/features/query/where.d.ts

@@ -0,0 +1,11 @@
+import { BuiltQuery } from './interfaces/Query';
+import { WhereInput } from './interfaces/Where';
+/**
+ * WhereInput 객체로부터 WHERE 절 SQL과 params를 생성합니다.
+ * camelCase key → snake_case 컬럼명으로 자동 변환됩니다.
+ *
+ * @param where     - camelCase key 기반 조건 객체
+ * @param startIdx  - param placeholder 시작 번호 ($1, $2 ...)
+ */
+export declare function buildWhere<T extends Record<string, unknown>>(where: WhereInput<T>, startIdx?: number): BuiltQuery;
+//# sourceMappingURL=where.d.ts.map

package/dist/features/query/where.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"where.d.ts","sourceRoot":"","sources":["../../../src/features/query/where.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EACpB,QAAQ,GAAE,MAAU,GACnB,UAAU,CAqBZ"}

package/dist/features/query/where.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildWhere = buildWhere;
+const case_1 = require("../transform/case");
+/**
+ * WhereInput 객체로부터 WHERE 절 SQL과 params를 생성합니다.
+ * camelCase key → snake_case 컬럼명으로 자동 변환됩니다.
+ *
+ * @param where     - camelCase key 기반 조건 객체
+ * @param startIdx  - param placeholder 시작 번호 ($1, $2 ...)
+ */
+function buildWhere(where, startIdx = 1) {
+    const entries = Object.entries(where).filter(([, v]) => v !== undefined);
+    if (entries.length === 0) {
+        return { sql: '', params: [] };
+    }
+    const params = [];
+    const conditions = [];
+    for (const [key, val] of entries) {
+        const col = (0, case_1.toSnake)(key);
+        if (val === null) {
+            conditions.push(`${col} IS NULL`);
+        }
+        else {
+            conditions.push(`${col} = $${startIdx + params.length}`);
+            params.push(val);
+        }
+    }
+    return { sql: `WHERE ${conditions.join(' AND ')}`, params };
+}

package/dist/features/repository/base.d.ts

@@ -0,0 +1,107 @@
+import { PoolClient } from 'pg';
+import { TableDef, Cols } from '../schema/interfaces/Table';
+import { InferRow, InferInsert, InferUpdate } from '../schema/interfaces/Infer';
+import { BuiltQuery } from '../query/interfaces/Query';
+import { QueryBuilder } from '../query/builder';
+import { AdvancedWhere, ExecHooks } from '../query/interfaces/Advanced';
+import { IRepo } from './interfaces/Repo';
+import { FindOpts } from './interfaces/Find';
+/**
+ * 기본 CRUD 레포지토리.
+ *
+ * - 모든 DB 에러는 `DbError`로 변환됩니다.
+ * - 사용자에게 노출할 메시지는 `DbError.toUserPayload()`를 사용하세요.
+ * - 트랜잭션 내에서 사용하려면 `exec(built, client)` 형태로 client를 전달하세요.
+ */
+export declare class BaseRepo<TDef extends TableDef<string, Cols>> implements IRepo<InferRow<TDef>, InferInsert<TDef>, InferUpdate<TDef>> {
+    protected readonly def: TDef;
+    protected readonly tableName: string;
+    protected readonly pkKey: string;
+    protected readonly pkCol: string;
+    private _globalHooks?;
+    constructor(def: TDef);
+    /**
+     * 이 레포지토리의 모든 `select()` 빌더에 적용될 글로벌 훅을 등록합니다.
+     *
+     * @example
+     * ```ts
+     * userRepo.useHooks({
+     *   beforeExec: ({ sql }) => logger.debug('SQL:', sql),
+     *   afterExec:  ({ elapsed }) => metrics.record('db.query', elapsed),
+     * });
+     * ```
+     */
+    useHooks(h: ExecHooks<InferRow<TDef>>): this;
+    /**
+     * SQL을 실행하고 camelCase 변환된 rows를 반환합니다.
+     *
+     * - 에러 발생 시 `DbError`로 변환 후 로깅하고 re-throw합니다.
+     * - `client`를 넘기면 해당 client를 재사용합니다 (트랜잭션 지원).
+     */
+    protected exec<T extends Record<string, unknown>>(built: BuiltQuery, client?: PoolClient): Promise<T[]>;
+    findAll(opts?: FindOpts<InferRow<TDef>>): Promise<InferRow<TDef>[]>;
+    findById(id: number | string): Promise<InferRow<TDef> | null>;
+    findOne(where: Partial<InferRow<TDef>>): Promise<InferRow<TDef> | null>;
+    create(data: InferInsert<TDef>): Promise<InferRow<TDef>>;
+    update(id: number | string, data: InferUpdate<TDef>): Promise<InferRow<TDef> | null>;
+    delete(id: number | string): Promise<boolean>;
+    /**
+     * 데이터를 삽입하거나, 충돌 시 UPDATE합니다.
+     * @param conflictCol - 충돌 기준 컬럼 (snake_case, 기본값: primary key)
+     */
+    upsert(data: InferInsert<TDef>, conflictCol?: string): Promise<InferRow<TDef>>;
+    /**
+     * 여러 row를 단일 INSERT 쿼리로 삽입합니다.
+     */
+    bulkCreate(rows: InferInsert<TDef>[]): Promise<InferRow<TDef>[]>;
+    /**
+     * 유연한 플루언트 쿼리 빌더를 반환합니다.
+     *
+     * WHERE, OR, ORDER BY, GROUP BY, JOIN, LIMIT, OFFSET, paginate, calculate 등을
+     * 메서드 체인으로 조합할 수 있습니다.
+     *
+     * @example
+     * ```ts
+     * // 기본 조회 (await 직접 사용 가능)
+     * const users = await repo.select({ isActive: true })
+     *   .orderBy([{ column: 'createdAt', direction: 'DESC' }])
+     *   .limit(20);
+     *
+     * // OR 조건
+     * const results = await repo.select()
+     *   .or({ email: { operator: 'LIKE', value: '%@gmail.com' } });
+     *
+     * // 페이지네이션
+     * const page = await repo.select()
+     *   .paginate({ page: 1, pageSize: 20 });
+     *
+     * // 집계
+     * const agg = await repo.select({ isActive: true })
+     *   .calculate([{ fn: 'COUNT', alias: 'count' }]);
+     * ```
+     */
+    select(where?: AdvancedWhere<InferRow<TDef>>): QueryBuilder<InferRow<TDef>>;
+    /**
+     * 단건 조회 (없으면 null). `select(where).one()` 의 단축형입니다.
+     *
+     * @example
+     * ```ts
+     * const user = await repo.selectOne({ id: 1 });
+     * ```
+     */
+    selectOne(where: AdvancedWhere<InferRow<TDef>>): Promise<InferRow<TDef> | null>;
+    /**
+     * Raw SQL을 직접 실행합니다.
+     * DB 컬럼명(snake_case) → TypeScript(camelCase) 자동 변환이 적용됩니다.
+     *
+     * @example
+     * ```ts
+     * const rows = await repo.raw<UserRow>(
+     *   'SELECT * FROM users WHERE first_name ILIKE $1',
+     *   ['%john%'],
+     * );
+     * ```
+     */
+    raw<R extends Record<string, unknown> = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<R[]>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/features/repository/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/features/repository/base.ts"],"names":[],"mappings":"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"}