reltype 0.1.1

package/dist/features/repository/base.js

@@ -0,0 +1,243 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseRepo = void 0;
+const select_1 = require("../query/select");
+const insert_1 = require("../query/insert");
+const update_1 = require("../query/update");
+const delete_1 = require("../query/delete");
+const upsert_1 = require("../query/upsert");
+const bulkInsert_1 = require("../query/bulkInsert");
+const builder_1 = require("../query/builder");
+const mapper_1 = require("../transform/mapper");
+const case_1 = require("../transform/case");
+const pool_1 = require("../connection/pool");
+const logger_1 = require("../../utils/logger");
+const dbError_1 = require("../../utils/dbError");
+const logger = logger_1.Logger.fromEnv(process.env, { prefix: '[Repo]' });
+/** 런타임에서 primary key의 camelCase 키를 찾습니다. */
+function findPkKey(cols) {
+    const entry = Object.entries(cols).find(([, c]) => c.isPrimary);
+    return entry ? entry[0] : 'id';
+}
+/**
+ * 기본 CRUD 레포지토리.
+ *
+ * - 모든 DB 에러는 `DbError`로 변환됩니다.
+ * - 사용자에게 노출할 메시지는 `DbError.toUserPayload()`를 사용하세요.
+ * - 트랜잭션 내에서 사용하려면 `exec(built, client)` 형태로 client를 전달하세요.
+ */
+class BaseRepo {
+    constructor(def) {
+        this.def = def;
+        this.tableName = def.name;
+        this.pkKey = findPkKey(def.cols);
+        this.pkCol = (0, case_1.toSnake)(this.pkKey);
+    }
+    /**
+     * 이 레포지토리의 모든 `select()` 빌더에 적용될 글로벌 훅을 등록합니다.
+     *
+     * @example
+     * ```ts
+     * userRepo.useHooks({
+     *   beforeExec: ({ sql }) => logger.debug('SQL:', sql),
+     *   afterExec:  ({ elapsed }) => metrics.record('db.query', elapsed),
+     * });
+     * ```
+     */
+    useHooks(h) {
+        this._globalHooks = h;
+        return this;
+    }
+    /**
+     * SQL을 실행하고 camelCase 변환된 rows를 반환합니다.
+     *
+     * - 에러 발생 시 `DbError`로 변환 후 로깅하고 re-throw합니다.
+     * - `client`를 넘기면 해당 client를 재사용합니다 (트랜잭션 지원).
+     */
+    async exec(built, client) {
+        const run = async (c) => {
+            const start = Date.now();
+            logger.debug(`SQL: ${built.sql}`, built.params);
+            try {
+                const result = await c.query(built.sql, built.params);
+                logger.debug(`완료 (${Date.now() - start}ms) rowCount=${result.rowCount ?? 0}`);
+                return (0, mapper_1.mapRows)(result.rows);
+            }
+            catch (err) {
+                const dbErr = dbError_1.DbError.from(err);
+                logger.error(`쿼리 실패 [${this.tableName}]`, {
+                    ...dbErr.toLogContext(),
+                    sql: built.sql,
+                    elapsed: `${Date.now() - start}ms`,
+                });
+                throw dbErr;
+            }
+        };
+        if (client)
+            return run(client);
+        return (0, pool_1.withClient)(run);
+    }
+    async findAll(opts = {}) {
+        try {
+            return await this.exec((0, select_1.buildSelect)(this.tableName, opts));
+        }
+        catch (err) {
+            throw dbError_1.DbError.from(err);
+        }
+    }
+    async findById(id) {
+        try {
+            const rows = await this.exec((0, select_1.buildSelect)(this.tableName, {
+                where: { [this.pkKey]: id },
+                limit: 1,
+            }));
+            return rows[0] ?? null;
+        }
+        catch (err) {
+            throw dbError_1.DbError.from(err);
+        }
+    }
+    async findOne(where) {
+        try {
+            const rows = await this.exec((0, select_1.buildSelect)(this.tableName, { where, limit: 1 }));
+            return rows[0] ?? null;
+        }
+        catch (err) {
+            throw dbError_1.DbError.from(err);
+        }
+    }
+    async create(data) {
+        try {
+            const rows = await this.exec((0, insert_1.buildInsert)(this.tableName, data));
+            return rows[0];
+        }
+        catch (err) {
+            throw dbError_1.DbError.from(err);
+        }
+    }
+    async update(id, data) {
+        try {
+            const where = { [this.pkKey]: id };
+            const rows = await this.exec((0, update_1.buildUpdate)(this.tableName, data, where));
+            return rows[0] ?? null;
+        }
+        catch (err) {
+            throw dbError_1.DbError.from(err);
+        }
+    }
+    async delete(id) {
+        try {
+            const where = { [this.pkKey]: id };
+            const built = (0, delete_1.buildDelete)(this.tableName, where);
+            return await (0, pool_1.withClient)(async (client) => {
+                const start = Date.now();
+                logger.debug(`SQL: ${built.sql}`, built.params);
+                try {
+                    const result = await client.query(built.sql, built.params);
+                    logger.debug(`완료 (${Date.now() - start}ms)`);
+                    return (result.rowCount ?? 0) > 0;
+                }
+                catch (err) {
+                    const dbErr = dbError_1.DbError.from(err);
+                    logger.error(`삭제 실패 [${this.tableName}]`, {
+                        ...dbErr.toLogContext(),
+                        elapsed: `${Date.now() - start}ms`,
+                    });
+                    throw dbErr;
+                }
+            });
+        }
+        catch (err) {
+            throw dbError_1.DbError.from(err);
+        }
+    }
+    /**
+     * 데이터를 삽입하거나, 충돌 시 UPDATE합니다.
+     * @param conflictCol - 충돌 기준 컬럼 (snake_case, 기본값: primary key)
+     */
+    async upsert(data, conflictCol) {
+        try {
+            const rows = await this.exec((0, upsert_1.buildUpsert)(this.tableName, data, conflictCol ?? this.pkCol));
+            return rows[0];
+        }
+        catch (err) {
+            throw dbError_1.DbError.from(err);
+        }
+    }
+    /**
+     * 여러 row를 단일 INSERT 쿼리로 삽입합니다.
+     */
+    async bulkCreate(rows) {
+        try {
+            return await this.exec((0, bulkInsert_1.buildBulkInsert)(this.tableName, rows));
+        }
+        catch (err) {
+            throw dbError_1.DbError.from(err);
+        }
+    }
+    // ── Fluent QueryBuilder ────────────────────────────────────────────────────
+    /**
+     * 유연한 플루언트 쿼리 빌더를 반환합니다.
+     *
+     * 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) {
+        const qb = new builder_1.QueryBuilder(this.tableName, where);
+        if (this._globalHooks)
+            qb.hooks(this._globalHooks);
+        return qb;
+    }
+    /**
+     * 단건 조회 (없으면 null). `select(where).one()` 의 단축형입니다.
+     *
+     * @example
+     * ```ts
+     * const user = await repo.selectOne({ id: 1 });
+     * ```
+     */
+    async selectOne(where) {
+        try {
+            return await new builder_1.QueryBuilder(this.tableName, where).one();
+        }
+        catch (err) {
+            throw dbError_1.DbError.from(err);
+        }
+    }
+    /**
+     * Raw SQL을 직접 실행합니다.
+     * DB 컬럼명(snake_case) → TypeScript(camelCase) 자동 변환이 적용됩니다.
+     *
+     * @example
+     * ```ts
+     * const rows = await repo.raw<UserRow>(
+     *   'SELECT * FROM users WHERE first_name ILIKE $1',
+     *   ['%john%'],
+     * );
+     * ```
+     */
+    async raw(sql, params) {
+        return builder_1.QueryBuilder.raw(sql, params);
+    }
+}
+exports.BaseRepo = BaseRepo;

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

@@ -0,0 +1,13 @@
+import { TableDef, Cols } from '../schema/interfaces/Table';
+import { BaseRepo } from './base';
+/**
+ * TableDef로부터 BaseRepo 인스턴스를 생성합니다.
+ *
+ * @example
+ * ```ts
+ * const userRepo = createRepo(usersTable);
+ * const users = await userRepo.findAll();
+ * ```
+ */
+export declare function createRepo<TDef extends TableDef<string, Cols>>(def: TDef): BaseRepo<TDef>;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/features/repository/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EAC5D,GAAG,EAAE,IAAI,GACR,QAAQ,CAAC,IAAI,CAAC,CAEhB"}

package/dist/features/repository/create.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRepo = createRepo;
+const base_1 = require("./base");
+/**
+ * TableDef로부터 BaseRepo 인스턴스를 생성합니다.
+ *
+ * @example
+ * ```ts
+ * const userRepo = createRepo(usersTable);
+ * const users = await userRepo.findAll();
+ * ```
+ */
+function createRepo(def) {
+    return new base_1.BaseRepo(def);
+}

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

@@ -0,0 +1,4 @@
+export * from './base';
+export * from './create';
+export * from './interfaces';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/features/repository/index.js

@@ -0,0 +1,19 @@
+"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("./base"), exports);
+__exportStar(require("./create"), exports);
+__exportStar(require("./interfaces"), exports);

package/dist/features/repository/interfaces/Find.d.ts

@@ -0,0 +1,9 @@
+import { WhereInput } from '../../query/interfaces/Where';
+import { OrderByInput } from '../../query/interfaces/Order';
+export interface FindOpts<T extends Record<string, unknown>> {
+    where?: WhereInput<T>;
+    orderBy?: OrderByInput<T>[];
+    limit?: number;
+    offset?: number;
+}
+//# sourceMappingURL=Find.d.ts.map

package/dist/features/repository/interfaces/Find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Find.d.ts","sourceRoot":"","sources":["../../../../src/features/repository/interfaces/Find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,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"}

package/dist/features/repository/interfaces/Find.js

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

package/dist/features/repository/interfaces/Repo.d.ts

@@ -0,0 +1,29 @@
+import { FindOpts } from './Find';
+import { QueryBuilder } from '../../query/builder';
+import { AdvancedWhere, ExecHooks } from '../../query/interfaces/Advanced';
+/**
+ * 기본 CRUD + 확장 레포지토리 인터페이스.
+ *
+ * @typeParam TRow    - SELECT 결과 타입
+ * @typeParam TInsert - INSERT 입력 타입
+ * @typeParam TUpdate - UPDATE 입력 타입
+ */
+export interface IRepo<TRow extends Record<string, unknown>, TInsert = Partial<TRow>, TUpdate = Partial<TRow>> {
+    findAll(opts?: FindOpts<TRow>): Promise<TRow[]>;
+    findById(id: number | string): Promise<TRow | null>;
+    findOne(where: Partial<TRow>): Promise<TRow | null>;
+    create(data: TInsert): Promise<TRow>;
+    update(id: number | string, data: TUpdate): Promise<TRow | null>;
+    delete(id: number | string): Promise<boolean>;
+    upsert(data: TInsert, conflictCol?: string): Promise<TRow>;
+    bulkCreate(rows: TInsert[]): Promise<TRow[]>;
+    /** 유연한 쿼리 빌더 반환 (WHERE / OR / JOIN / GROUP BY / paginate / calculate 지원) */
+    select(where?: AdvancedWhere<TRow>): QueryBuilder<TRow>;
+    /** 단건 조회 (없으면 null) */
+    selectOne(where: AdvancedWhere<TRow>): Promise<TRow | null>;
+    /** Raw SQL 실행 (camelCase 변환 자동 적용) */
+    raw<R extends Record<string, unknown>>(sql: string, params?: unknown[]): Promise<R[]>;
+    /** 이 레포지토리의 모든 select() 빌더에 적용될 글로벌 훅 등록 */
+    useHooks(h: ExecHooks<TRow>): this;
+}
+//# sourceMappingURL=Repo.d.ts.map

package/dist/features/repository/interfaces/Repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Repo.d.ts","sourceRoot":"","sources":["../../../../src/features/repository/interfaces/Repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,KAAK,CACpB,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAGvB,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACpD,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAG7C,4EAA4E;IAC5E,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACxD,uBAAuB;IACvB,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC5D,sCAAsC;IACtC,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACtF,4CAA4C;IAC5C,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpC"}

package/dist/features/repository/interfaces/Repo.js

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

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

@@ -0,0 +1,3 @@
+export * from './Find';
+export * from './Repo';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,18 @@
+"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("./Find"), exports);
+__exportStar(require("./Repo"), exports);

package/dist/features/schema/column.d.ts

@@ -0,0 +1,62 @@
+import { ColShape } from './interfaces/Column';
+/**
+ * 컬럼 정의 빌더 클래스.
+ *
+ * 타입 파라미터:
+ * - T        : TypeScript 타입 (phantom)
+ * - IsOpt    : INSERT 시 optional 여부
+ * - IsPrimary: primary key 여부
+ */
+export declare class Col<T = unknown, IsOpt extends boolean = false, IsPrimary extends boolean = false> implements ColShape<T, IsOpt, IsPrimary> {
+    readonly pgType: string;
+    readonly isNullable: boolean;
+    readonly hasDefault: boolean;
+    readonly isPrimary: boolean;
+    readonly length?: number | undefined;
+    readonly _type: T;
+    readonly _isOpt: IsOpt;
+    readonly _isPrimary: IsPrimary;
+    constructor(pgType: string, isNullable?: boolean, hasDefault?: boolean, isPrimary?: boolean, length?: number | undefined);
+    /** 컬럼을 nullable로 설정합니다. (INSERT도 optional) */
+    nullable(): Col<T | null, true, IsPrimary>;
+    /**
+     * 런타임에서 INSERT optional 여부를 반환합니다.
+     * isNullable, hasDefault, isPrimary 중 하나라도 true 이면 optional입니다.
+     */
+    get isOptional(): boolean;
+    /** 컬럼을 NOT NULL로 설정합니다. */
+    notNull(): Col<Exclude<T, null>, false, IsPrimary>;
+    /** primary key로 설정합니다. (INSERT optional) */
+    primaryKey(): Col<T, true, true>;
+    /** DB 기본값이 있는 컬럼으로 설정합니다. (INSERT optional) */
+    default(): Col<T, true, IsPrimary>;
+    /** DEFAULT NOW() 컬럼으로 설정합니다. (INSERT optional) */
+    defaultNow(): Col<T, true, IsPrimary>;
+}
+/**
+ * 컬럼 빌더 팩토리.
+ *
+ * @example
+ * ```ts
+ * const usersTable = defineTable('users', {
+ *   id:    col.serial().primaryKey(),
+ *   name:  col.varchar(255).notNull(),
+ *   email: col.text().notNull(),
+ * });
+ * ```
+ */
+export declare const col: {
+    serial: () => Col<number, true, false>;
+    integer: () => Col<number, false, false>;
+    bigint: () => Col<bigint, false, false>;
+    numeric: () => Col<number, false, false>;
+    varchar: (len?: number) => Col<string, false, false>;
+    text: () => Col<string, false, false>;
+    boolean: () => Col<boolean, false, false>;
+    timestamp: () => Col<Date, false, false>;
+    timestamptz: () => Col<Date, false, false>;
+    date: () => Col<Date, false, false>;
+    uuid: () => Col<string, false, false>;
+    jsonb: <T = unknown>() => Col<T, false, false>;
+};
+//# sourceMappingURL=column.d.ts.map

package/dist/features/schema/column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.d.ts","sourceRoot":"","sources":["../../../src/features/schema/column.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;;;;GAOG;AACH,qBAAa,GAAG,CACd,CAAC,GAAG,OAAO,EACX,KAAK,SAAS,OAAO,GAAG,KAAK,EAC7B,SAAS,SAAS,OAAO,GAAG,KAAK,CACjC,YAAW,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC;IAMtC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,UAAU,EAAE,OAAO;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAT1B,SAAiB,KAAK,EAAE,CAAC,CAAC;IAC1B,SAAiB,MAAM,EAAE,KAAK,CAAC;IAC/B,SAAiB,UAAU,EAAE,SAAS,CAAC;gBAG5B,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,OAAe,EAC3B,UAAU,GAAE,OAAe,EAC3B,SAAS,GAAE,OAAe,EAC1B,MAAM,CAAC,EAAE,MAAM,YAAA;IAG1B,8CAA8C;IAC9C,QAAQ,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC;IAI1C;;;OAGG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,2BAA2B;IAC3B,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC;IAIlD,4CAA4C;IAC5C,UAAU,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;IAIhC,+CAA+C;IAC/C,OAAO,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;IAIlC,kDAAkD;IAClD,UAAU,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;CAGtC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,GAAG;;;;;oBAKM,MAAM;;;;;;;YAOZ,CAAC;CAChB,CAAC"}

package/dist/features/schema/column.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.col = exports.Col = void 0;
+/**
+ * 컬럼 정의 빌더 클래스.
+ *
+ * 타입 파라미터:
+ * - T        : TypeScript 타입 (phantom)
+ * - IsOpt    : INSERT 시 optional 여부
+ * - IsPrimary: primary key 여부
+ */
+class Col {
+    constructor(pgType, isNullable = false, hasDefault = false, isPrimary = false, length) {
+        this.pgType = pgType;
+        this.isNullable = isNullable;
+        this.hasDefault = hasDefault;
+        this.isPrimary = isPrimary;
+        this.length = length;
+    }
+    /** 컬럼을 nullable로 설정합니다. (INSERT도 optional) */
+    nullable() {
+        return new Col(this.pgType, true, this.hasDefault, this.isPrimary, this.length);
+    }
+    /**
+     * 런타임에서 INSERT optional 여부를 반환합니다.
+     * isNullable, hasDefault, isPrimary 중 하나라도 true 이면 optional입니다.
+     */
+    get isOptional() {
+        return this.isNullable || this.hasDefault || this.isPrimary;
+    }
+    /** 컬럼을 NOT NULL로 설정합니다. */
+    notNull() {
+        return new Col(this.pgType, false, this.hasDefault, this.isPrimary, this.length);
+    }
+    /** primary key로 설정합니다. (INSERT optional) */
+    primaryKey() {
+        return new Col(this.pgType, this.isNullable, true, true, this.length);
+    }
+    /** DB 기본값이 있는 컬럼으로 설정합니다. (INSERT optional) */
+    default() {
+        return new Col(this.pgType, this.isNullable, true, this.isPrimary, this.length);
+    }
+    /** DEFAULT NOW() 컬럼으로 설정합니다. (INSERT optional) */
+    defaultNow() {
+        return new Col(this.pgType, this.isNullable, true, this.isPrimary, this.length);
+    }
+}
+exports.Col = Col;
+/**
+ * 컬럼 빌더 팩토리.
+ *
+ * @example
+ * ```ts
+ * const usersTable = defineTable('users', {
+ *   id:    col.serial().primaryKey(),
+ *   name:  col.varchar(255).notNull(),
+ *   email: col.text().notNull(),
+ * });
+ * ```
+ */
+exports.col = {
+    serial: () => new Col('serial', false, true, false),
+    integer: () => new Col('integer', false, false, false),
+    bigint: () => new Col('bigint', false, false, false),
+    numeric: () => new Col('numeric', false, false, false),
+    varchar: (len) => new Col('varchar', false, false, false, len),
+    text: () => new Col('text', false, false, false),
+    boolean: () => new Col('boolean', false, false, false),
+    timestamp: () => new Col('timestamp', false, false, false),
+    timestamptz: () => new Col('timestamptz', false, false, false),
+    date: () => new Col('date', false, false, false),
+    uuid: () => new Col('uuid', false, false, false),
+    jsonb: () => new Col('jsonb', false, false, false),
+};

package/dist/features/schema/index.d.ts

@@ -0,0 +1,4 @@
+export * from './column';
+export * from './table';
+export * from './interfaces';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/features/schema/index.js

@@ -0,0 +1,19 @@
+"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("./column"), exports);
+__exportStar(require("./table"), exports);
+__exportStar(require("./interfaces"), exports);

package/dist/features/schema/interfaces/Column.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Col 클래스의 타입 파라미터를 외부에서 읽기 위한 인터페이스.
+ *
+ * - _type     : 컬럼의 TypeScript 타입 (phantom)
+ * - _isOpt    : INSERT 시 optional 여부 (primaryKey · hasDefault · nullable)
+ * - _isPrimary: primary key 여부
+ */
+export interface ColShape<T = unknown, IsOpt extends boolean = boolean, IsPrimary extends boolean = boolean> {
+    readonly _type: T;
+    readonly _isOpt: IsOpt;
+    readonly _isPrimary: IsPrimary;
+    readonly pgType: string;
+    readonly isNullable: boolean;
+    readonly hasDefault: boolean;
+    readonly isPrimary: boolean;
+    readonly isOptional: boolean;
+    readonly length?: number;
+}
+//# sourceMappingURL=Column.d.ts.map

package/dist/features/schema/interfaces/Column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Column.d.ts","sourceRoot":"","sources":["../../../../src/features/schema/interfaces/Column.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ,CACvB,CAAC,GAAG,OAAO,EACX,KAAK,SAAS,OAAO,GAAG,OAAO,EAC/B,SAAS,SAAS,OAAO,GAAG,OAAO;IAEnC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/features/schema/interfaces/Column.js

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

package/dist/features/schema/interfaces/Infer.d.ts

@@ -0,0 +1,20 @@
+import { TableDef, Cols } from './Table';
+/** SELECT 결과 타입: 모든 컬럼 포함 */
+export type InferRow<TDef extends TableDef<string, Cols>> = {
+    [K in keyof TDef['cols']]: TDef['cols'][K]['_type'];
+};
+/**
+ * INSERT 입력 타입:
+ * - _isOpt = false → required
+ * - _isOpt = true  → optional
+ */
+export type InferInsert<TDef extends TableDef<string, Cols>> = {
+    [K in keyof TDef['cols'] as TDef['cols'][K]['_isOpt'] extends true ? never : K]: TDef['cols'][K]['_type'];
+} & {
+    [K in keyof TDef['cols'] as TDef['cols'][K]['_isOpt'] extends true ? K : never]?: TDef['cols'][K]['_type'];
+};
+/** UPDATE 입력 타입: primary key 제외, 모두 optional */
+export type InferUpdate<TDef extends TableDef<string, Cols>> = {
+    [K in keyof TDef['cols'] as TDef['cols'][K]['_isPrimary'] extends true ? never : K]?: TDef['cols'][K]['_type'];
+};
+//# sourceMappingURL=Infer.d.ts.map

package/dist/features/schema/interfaces/Infer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Infer.d.ts","sourceRoot":"","sources":["../../../../src/features/schema/interfaces/Infer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEzC,6BAA6B;AAC7B,MAAM,MAAM,QAAQ,CAAC,IAAI,SAAS,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI;KACzD,CAAC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;CACpD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,IAAI,SAAS,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IACzD;KAAG,CAAC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;CAAE,GAC7G;KAAG,CAAC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;CAAE,CAAC;AAEjH,gDAAgD;AAChD,MAAM,MAAM,WAAW,CAAC,IAAI,SAAS,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI;KAC5D,CAAC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;CAC/G,CAAC"}

package/dist/features/schema/interfaces/Infer.js

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

package/dist/features/schema/interfaces/Table.d.ts

@@ -0,0 +1,7 @@
+import { ColShape } from './Column';
+export type Cols = Record<string, ColShape<unknown, boolean, boolean>>;
+export interface TableDef<TName extends string = string, TCols extends Cols = Cols> {
+    readonly name: TName;
+    readonly cols: TCols;
+}
+//# sourceMappingURL=Table.d.ts.map

package/dist/features/schema/interfaces/Table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../../../../src/features/schema/interfaces/Table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvE,MAAM,WAAW,QAAQ,CACvB,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,KAAK,SAAS,IAAI,GAAG,IAAI;IAEzB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB"}

package/dist/features/schema/interfaces/Table.js

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

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

@@ -0,0 +1,4 @@
+export * from './Column';
+export * from './Table';
+export * from './Infer';
+//# sourceMappingURL=index.d.ts.map

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

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