reltype 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -6,6 +6,32 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.1.8] — 2026-03-19
+
+### Added — JOIN / SELECT 용 `TableDef` 헬퍼
+
+- **`src/features/query/joinRefs.ts`** — 조인·SELECT 컬럼 나열을 짧게 쓰기 위한 유틸리티
+  - `sqlTableRef(def)` — `schema.table` 문자열 (`JOIN` 의 `table` 인자 등)
+  - `joinOnEq(leftDef, leftCol, rightDef, rightCol)` — `ON` 절 (`qualifiedName` + `quoteIdentifier` 기반)
+  - `sqlCols(def, '*')` / `sqlCols(def, ['firstName', ...])` — `테이블.*` 또는 camelCase 키 → `테이블.snake_col`
+  - `sqlColsAs(def, [['id', 'profile_id'], ...])` — `col AS alias_snake`
+  - `orderCol(def, colKey)` — `ORDER BY` 용 한정 컬럼 (`schema.table.column`)
+- `src/features/query/index.ts`, **`src/index.ts`** — 위 심볼 공개 export
+
+---
+
+## [0.1.7] — 2026-03-19
+
+### Added — Repository Query Debug
+
+- `BaseRepo`에 `RepoOpts` 및 쿼리 디버그 모드 추가
+  - `new UserRepo(usersTable, { debug: true })` 형태로 생성 시, 이 레포지토리에서 실행되는 **모든 SQL / Params / 실행 시간**이 콘솔에 출력됩니다.
+  - `userRepo.debugMode(true | false)` 로 런타임에서도 토글 가능, `userRepo.isDebugMode` 로 현재 상태 조회 가능
+  - `LOG_LEVEL` 환경 변수와 무관하게 항상 출력되며, 프로덕션에서는 `debug: false` 유지 권장
+- `select()` 계열은 QueryBuilder 훅(`ExecHooks`)과 자동 합성되어, debug 로그 → 사용자 정의 훅 순서로 실행되도록 개선
+
+---
+
 ## [0.1.6] — 2026-03-19
 
 ### Security — SQL Injection 전면 차단

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

@@ -7,4 +7,5 @@ export * from './bulkInsert';
 export * from './where';
 export * from './interfaces';
 export * from './builder';
+export * from './joinRefs';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAC1B,cAAc,YAAY,CAAC"}

package/dist/features/query/index.js

@@ -23,3 +23,4 @@ __exportStar(require("./bulkInsert"), exports);
 __exportStar(require("./where"), exports);
 __exportStar(require("./interfaces"), exports);
 __exportStar(require("./builder"), exports);
+__exportStar(require("./joinRefs"), exports);

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

@@ -0,0 +1,55 @@
+import { TableDef, Cols } from '../schema/interfaces/Table';
+/**
+ * `JOIN` 의 `table` 인자나 `schema.table.column` 접두로 쓰는 **따옴표 없는** 참조 문자열.
+ *
+ * @example
+ * ```ts
+ * defineTable('account.users', cols) → `account.users`
+ * defineTable('users', cols, { schema: 'public' }) → `public.users`
+ * ```
+ */
+export declare function sqlTableRef(def: TableDef<string, Cols>): string;
+/**
+ * SELECT 목록용 조각: `schema.table.*` 또는 `schema.table.col_snake` 배열.
+ * 컬럼 키는 **테이블 정의의 camelCase 프로퍼티명**을 넘기면 snake_case 로 변환됩니다.
+ *
+ * @example
+ * ```ts
+ * .columns([
+ *   ...sqlCols(usersTable, '*'),
+ *   ...sqlCols(profileTable, ['image', 'userName']),
+ * ])
+ * ```
+ */
+export declare function sqlCols<T extends TableDef<string, Cols>>(def: T, cols: '*' | ReadonlyArray<keyof T['cols'] & string>): string[];
+/**
+ * SELECT 목록용: `schema.table.col AS alias_snake` (별칭은 DB snake_case 권장 → mapRows 가 camelCase 로 변환).
+ *
+ * @example
+ * ```ts
+ * sqlColsAs(profileTable, [
+ *   ['id', 'profile_id'],
+ *   ['createdAt', 'profile_created_at'],
+ * ])
+ * ```
+ */
+export declare function sqlColsAs<T extends TableDef<string, Cols>>(def: T, pairs: ReadonlyArray<readonly [keyof T['cols'] & string, string]>): string[];
+/**
+ * `JOIN ... ON` 절 한 쌍 (등호). `TableDef.qualifiedName` 과 컬럼 `quoteIdentifier` 를 사용합니다.
+ *
+ * @example
+ * ```ts
+ * .join({
+ *   type: 'LEFT',
+ *   table: sqlTableRef(profileTable),
+ *   on: joinOnEq(usersTable, 'id', profileTable, 'userId'),
+ * })
+ * ```
+ */
+export declare function joinOnEq(left: TableDef<string, Cols>, leftCol: string, right: TableDef<string, Cols>, rightCol: string): string;
+/**
+ * `ORDER BY` 등에 넣을 **한정 컬럼** 문자열 (`schema.table.column`).
+ * `orderBy([{ column: orderCol(usersTable, 'id'), direction: 'DESC' }])`
+ */
+export declare function orderCol<T extends TableDef<string, Cols>>(def: T, col: keyof T['cols'] & string): string;
+//# sourceMappingURL=joinRefs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"joinRefs.d.ts","sourceRoot":"","sources":["../../../src/features/query/joinRefs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAI5D;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EACtD,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAClD,MAAM,EAAE,CAIV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EACxD,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,GAChE,MAAM,EAAE,CAGV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EACvD,GAAG,EAAE,CAAC,EACN,GAAG,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,GAC5B,MAAM,CAER"}

package/dist/features/query/joinRefs.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sqlTableRef = sqlTableRef;
+exports.sqlCols = sqlCols;
+exports.sqlColsAs = sqlColsAs;
+exports.joinOnEq = joinOnEq;
+exports.orderCol = orderCol;
+const case_1 = require("../transform/case");
+const sqlGuard_1 = require("../../utils/sqlGuard");
+/**
+ * `JOIN` 의 `table` 인자나 `schema.table.column` 접두로 쓰는 **따옴표 없는** 참조 문자열.
+ *
+ * @example
+ * ```ts
+ * defineTable('account.users', cols) → `account.users`
+ * defineTable('users', cols, { schema: 'public' }) → `public.users`
+ * ```
+ */
+function sqlTableRef(def) {
+    return def.schema ? `${def.schema}.${def.name}` : def.name;
+}
+/**
+ * SELECT 목록용 조각: `schema.table.*` 또는 `schema.table.col_snake` 배열.
+ * 컬럼 키는 **테이블 정의의 camelCase 프로퍼티명**을 넘기면 snake_case 로 변환됩니다.
+ *
+ * @example
+ * ```ts
+ * .columns([
+ *   ...sqlCols(usersTable, '*'),
+ *   ...sqlCols(profileTable, ['image', 'userName']),
+ * ])
+ * ```
+ */
+function sqlCols(def, cols) {
+    const t = sqlTableRef(def);
+    if (cols === '*')
+        return [`${t}.*`];
+    return cols.map((c) => `${t}.${(0, case_1.toSnake)(String(c))}`);
+}
+/**
+ * SELECT 목록용: `schema.table.col AS alias_snake` (별칭은 DB snake_case 권장 → mapRows 가 camelCase 로 변환).
+ *
+ * @example
+ * ```ts
+ * sqlColsAs(profileTable, [
+ *   ['id', 'profile_id'],
+ *   ['createdAt', 'profile_created_at'],
+ * ])
+ * ```
+ */
+function sqlColsAs(def, pairs) {
+    const t = sqlTableRef(def);
+    return pairs.map(([col, aliasSnake]) => `${t}.${(0, case_1.toSnake)(String(col))} as ${aliasSnake}`);
+}
+/**
+ * `JOIN ... ON` 절 한 쌍 (등호). `TableDef.qualifiedName` 과 컬럼 `quoteIdentifier` 를 사용합니다.
+ *
+ * @example
+ * ```ts
+ * .join({
+ *   type: 'LEFT',
+ *   table: sqlTableRef(profileTable),
+ *   on: joinOnEq(usersTable, 'id', profileTable, 'userId'),
+ * })
+ * ```
+ */
+function joinOnEq(left, leftCol, right, rightCol) {
+    const lc = (0, sqlGuard_1.quoteIdentifier)((0, case_1.toSnake)(leftCol));
+    const rc = (0, sqlGuard_1.quoteIdentifier)((0, case_1.toSnake)(rightCol));
+    return `${left.qualifiedName}.${lc} = ${right.qualifiedName}.${rc}`;
+}
+/**
+ * `ORDER BY` 등에 넣을 **한정 컬럼** 문자열 (`schema.table.column`).
+ * `orderBy([{ column: orderCol(usersTable, 'id'), direction: 'DESC' }])`
+ */
+function orderCol(def, col) {
+    return `${sqlTableRef(def)}.${(0, case_1.toSnake)(String(col))}`;
+}

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

@@ -6,6 +6,29 @@ import { QueryBuilder } from '../query/builder';
 import { AdvancedWhere, ExecHooks } from '../query/interfaces/Advanced';
 import { IRepo } from './interfaces/Repo';
 import { FindOpts } from './interfaces/Find';
+/**
+ * `BaseRepo` 생성자 옵션.
+ *
+ * @example
+ * ```ts
+ * // 생성 시 debug 활성화
+ * const userRepo = new UserRepo(usersTable, { debug: true });
+ *
+ * // 런타임 토글
+ * userRepo.debugMode(true);   // 활성화
+ * userRepo.debugMode(false);  // 비활성화
+ * ```
+ */
+export interface RepoOpts {
+    /**
+     * `true` 로 설정하면 이 레포지토리의 모든 SQL 실행 내용을 콘솔에 강제 출력합니다.
+     *
+     * - `LOG_LEVEL` 환경변수 설정과 무관하게 항상 출력됩니다.
+     * - 출력 내용: SQL 쿼리, 파라미터, 실행 시간, 반환 row 수
+     * - 개발·디버깅 목적으로만 사용하세요. 프로덕션에서는 `false` 유지를 권장합니다.
+     */
+    debug?: boolean;
+}
 /**
  * 기본 CRUD 레포지토리.
  *
@@ -19,7 +42,10 @@ export declare class BaseRepo<TDef extends TableDef<string, Cols>> implements IR
     protected readonly pkKey: string;
     protected readonly pkCol: string;
     private _globalHooks?;
-    constructor(def: TDef);
+    private _debugMode;
+    /** debug 전용 Logger — LOG_LEVEL 환경변수와 무관하게 항상 출력 */
+    private readonly _debugLogger;
+    constructor(def: TDef, opts?: RepoOpts);
     /**
      * 이 레포지토리의 모든 `select()` 빌더에 적용될 글로벌 훅을 등록합니다.
      *
@@ -32,6 +58,22 @@ export declare class BaseRepo<TDef extends TableDef<string, Cols>> implements IR
      * ```
      */
     useHooks(h: ExecHooks<InferRow<TDef>>): this;
+    /**
+     * 쿼리 디버그 모드를 런타임에 토글합니다.
+     * `true` 이면 이 레포지토리의 모든 SQL 실행 내용을 콘솔에 강제 출력합니다.
+     *
+     * @example
+     * ```ts
+     * userRepo.debugMode(true);  // 활성화
+     * userRepo.debugMode(false); // 비활성화
+     * userRepo.debugMode();      // 인수 생략 시 true (toggle-on)
+     * ```
+     */
+    debugMode(enabled?: boolean): this;
+    /**
+     * 현재 debug 모드 활성화 여부를 반환합니다.
+     */
+    get isDebugMode(): boolean;
     /**
      * SQL을 실행하고 camelCase 변환된 rows를 반환합니다.
      *
@@ -75,6 +117,12 @@ export declare class BaseRepo<TDef extends TableDef<string, Cols>> implements IR
      * ```
      */
     select(where?: AdvancedWhere<InferRow<TDef>>): QueryBuilder<InferRow<TDef>>;
+    /**
+     * debug 훅과 전역 훅을 합성합니다.
+     * - debugMode ON:  debug 출력 → _globalHooks 순서로 실행
+     * - debugMode OFF: _globalHooks 만 실행
+     */
+    private buildSelectHooks;
     /**
      * 단건 조회 (없으면 null). `select(where).one()` 의 단축형입니다.
      * 전역 훅이 적용됩니다.

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

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

package/dist/features/repository/base.js

@@ -36,11 +36,19 @@ function findPkKey(cols, tableName) {
  * - 트랜잭션 내에서 사용하려면 `exec(built, client)` 형태로 client를 전달하세요.
  */
 class BaseRepo {
-    constructor(def) {
+    constructor(def, opts) {
         this.def = def;
         this.tableName = def.qualifiedName ?? def.name;
         this.pkKey = findPkKey(def.cols, this.tableName);
         this.pkCol = (0, case_1.toSnake)(this.pkKey);
+        this._debugMode = opts?.debug ?? false;
+        this._debugLogger = new logger_1.Logger({
+            enabled: true,
+            level: 'debug',
+            format: 'text',
+            enableTimestamp: false,
+            prefix: `[SQL ${this.tableName}]`,
+        });
     }
     /**
      * 이 레포지토리의 모든 `select()` 빌더에 적용될 글로벌 훅을 등록합니다.
@@ -57,6 +65,27 @@ class BaseRepo {
         this._globalHooks = h;
         return this;
     }
+    /**
+     * 쿼리 디버그 모드를 런타임에 토글합니다.
+     * `true` 이면 이 레포지토리의 모든 SQL 실행 내용을 콘솔에 강제 출력합니다.
+     *
+     * @example
+     * ```ts
+     * userRepo.debugMode(true);  // 활성화
+     * userRepo.debugMode(false); // 비활성화
+     * userRepo.debugMode();      // 인수 생략 시 true (toggle-on)
+     * ```
+     */
+    debugMode(enabled = true) {
+        this._debugMode = enabled;
+        return this;
+    }
+    /**
+     * 현재 debug 모드 활성화 여부를 반환합니다.
+     */
+    get isDebugMode() {
+        return this._debugMode;
+    }
     /**
      * SQL을 실행하고 camelCase 변환된 rows를 반환합니다.
      *
@@ -70,10 +99,25 @@ class BaseRepo {
         }
         const run = async (c) => {
             const start = Date.now();
-            logger.debug(`SQL: ${built.sql}`, built.params);
+            if (this._debugMode) {
+                this._debugLogger.debug(`SQL:    ${built.sql}`);
+                if (built.params.length > 0) {
+                    this._debugLogger.debug('Params:', built.params);
+                }
+            }
+            else {
+                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}`);
+                const elapsed = Date.now() - start;
+                const count = result.rowCount ?? 0;
+                if (this._debugMode) {
+                    this._debugLogger.debug(`→ ${count} rows in ${elapsed}ms`);
+                }
+                else {
+                    logger.debug(`완료 (${elapsed}ms) rowCount=${count}`);
+                }
                 return (0, mapper_1.mapRows)(result.rows);
             }
             catch (err) {
@@ -195,10 +239,37 @@ class BaseRepo {
      */
     select(where) {
         const qb = new builder_1.QueryBuilder(this.tableName, where);
-        if (this._globalHooks)
-            qb.hooks(this._globalHooks);
+        const composedHooks = this.buildSelectHooks();
+        if (composedHooks)
+            qb.hooks(composedHooks);
         return qb;
     }
+    /**
+     * debug 훅과 전역 훅을 합성합니다.
+     * - debugMode ON:  debug 출력 → _globalHooks 순서로 실행
+     * - debugMode OFF: _globalHooks 만 실행
+     */
+    buildSelectHooks() {
+        if (!this._debugMode && !this._globalHooks)
+            return undefined;
+        if (!this._debugMode)
+            return this._globalHooks;
+        const dl = this._debugLogger;
+        const g = this._globalHooks;
+        return {
+            beforeExec: async (ctx) => {
+                dl.debug(`SQL:    ${ctx.sql}`);
+                if (ctx.params.length > 0)
+                    dl.debug('Params:', ctx.params);
+                await g?.beforeExec?.(ctx);
+            },
+            afterExec: async (ctx) => {
+                dl.debug(`→ ${ctx.rows.length} rows in ${ctx.elapsed}ms`);
+                await g?.afterExec?.(ctx);
+            },
+            onError: g?.onError,
+        };
+    }
     /**
      * 단건 조회 (없으면 null). `select(where).one()` 의 단축형입니다.
      * 전역 훅이 적용됩니다.

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

@@ -25,5 +25,9 @@ export interface IRepo<TRow extends Record<string, unknown>, TInsert = Partial<T
     raw<R extends Record<string, unknown>>(sql: string, params?: unknown[]): Promise<R[]>;
     /** 이 레포지토리의 모든 select() 빌더에 적용될 글로벌 훅 등록 */
     useHooks(h: ExecHooks<TRow>): this;
+    /** 런타임 쿼리 디버그 모드 토글 */
+    debugMode(enabled?: boolean): this;
+    /** 현재 debug 모드 활성화 여부 */
+    readonly isDebugMode: boolean;
 }
 //# sourceMappingURL=Repo.d.ts.map

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

@@ -1 +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"}
+{"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;IACnC,uBAAuB;IACvB,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,yBAAyB;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B"}

package/dist/index.d.ts

@@ -6,12 +6,14 @@ export type { TableDef, Cols } from './features/schema/interfaces/Table';
 export type { InferRow, InferInsert, InferUpdate } from './features/schema/interfaces/Infer';
 export { createRepo } from './features/repository/create';
 export { BaseRepo } from './features/repository/base';
+export type { RepoOpts } from './features/repository/base';
 export type { IRepo } from './features/repository/interfaces/Repo';
 export type { FindOpts } from './features/repository/interfaces/Find';
 export { getPool, withClient, closePool, getPoolStatus, checkPoolHealth } from './features/connection/pool';
 export type { PoolStatus } from './features/connection/pool';
 export { runInTx } from './features/connection/tx';
 export { buildSelect } from './features/query/select';
+export { sqlTableRef, sqlCols, sqlColsAs, joinOnEq, orderCol, } from './features/query/joinRefs';
 export { buildInsert } from './features/query/insert';
 export { buildUpdate } from './features/query/update';
 export { buildDelete } from './features/query/delete';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAe,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAY,yBAAyB,CAAC;AAC5D,YAAY,EAAE,SAAS,EAAE,MAAS,yBAAyB,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,MAAU,qCAAqC,CAAC;AACxE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AACzE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAG7F,OAAO,EAAE,UAAU,EAAE,MAAa,8BAA8B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAe,4BAA4B,CAAC;AAC/D,YAAY,EAAE,KAAK,EAAE,MAAa,uCAAuC,CAAC;AAC1E,YAAY,EAAE,QAAQ,EAAE,MAAU,uCAAuC,CAAC;AAG1E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC5G,YAAY,EAAE,UAAU,EAAE,MAAQ,4BAA4B,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAgB,0BAA0B,CAAC;AAG7D,OAAO,EAAE,WAAW,EAAE,MAAY,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAY,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAY,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAY,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAY,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAQ,6BAA6B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAa,wBAAwB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAQ,mCAAmC,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,MAAQ,mCAAmC,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAChF,YAAY,EAAE,UAAU,EAAE,MAAQ,yBAAyB,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAW,0BAA0B,CAAC;AAC7D,YAAY,EACV,aAAa,EACb,OAAO,EACP,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,SAAS,GACV,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAQ,6BAA6B,CAAC;AAGhE,OAAO,EAAE,OAAO,EAAE,MAAgB,iBAAiB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EAAE,MAAM,EAAE,MAAiB,gBAAgB,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateJoinType = exports.validateAggregateFn = exports.validateOrderDir = exports.escapeSchemaIdentifier = exports.quoteIdentifier = exports.Logger = exports.readEnv = exports.NodeEnvSource = exports.PostgresConfig = exports.getDatabaseConfig = exports.DbError = exports.mapRows = exports.mapRow = exports.keysToSnake = exports.keysToCamel = exports.toSnake = exports.toCamel = exports.QueryBuilder = exports.buildWhere = exports.buildBulkInsert = exports.buildUpsert = exports.buildDelete = exports.buildUpdate = exports.buildInsert = exports.buildSelect = exports.runInTx = exports.checkPoolHealth = exports.getPoolStatus = exports.closePool = exports.withClient = exports.getPool = exports.BaseRepo = exports.createRepo = exports.defineTable = exports.Col = exports.col = void 0;
+exports.validateJoinType = exports.validateAggregateFn = exports.validateOrderDir = exports.escapeSchemaIdentifier = exports.quoteIdentifier = exports.Logger = exports.readEnv = exports.NodeEnvSource = exports.PostgresConfig = exports.getDatabaseConfig = exports.DbError = exports.mapRows = exports.mapRow = exports.keysToSnake = exports.keysToCamel = exports.toSnake = exports.toCamel = exports.QueryBuilder = exports.buildWhere = exports.buildBulkInsert = exports.buildUpsert = exports.buildDelete = exports.buildUpdate = exports.buildInsert = exports.orderCol = exports.joinOnEq = exports.sqlColsAs = exports.sqlCols = exports.sqlTableRef = exports.buildSelect = exports.runInTx = exports.checkPoolHealth = exports.getPoolStatus = exports.closePool = exports.withClient = exports.getPool = exports.BaseRepo = exports.createRepo = exports.defineTable = exports.Col = exports.col = void 0;
 // ── Schema ──────────────────────────────────────────────────────────────────
 var column_1 = require("./features/schema/column");
 Object.defineProperty(exports, "col", { enumerable: true, get: function () { return column_1.col; } });
@@ -24,6 +24,12 @@ Object.defineProperty(exports, "runInTx", { enumerable: true, get: function () {
 // ── Query builders ───────────────────────────────────────────────────────────
 var select_1 = require("./features/query/select");
 Object.defineProperty(exports, "buildSelect", { enumerable: true, get: function () { return select_1.buildSelect; } });
+var joinRefs_1 = require("./features/query/joinRefs");
+Object.defineProperty(exports, "sqlTableRef", { enumerable: true, get: function () { return joinRefs_1.sqlTableRef; } });
+Object.defineProperty(exports, "sqlCols", { enumerable: true, get: function () { return joinRefs_1.sqlCols; } });
+Object.defineProperty(exports, "sqlColsAs", { enumerable: true, get: function () { return joinRefs_1.sqlColsAs; } });
+Object.defineProperty(exports, "joinOnEq", { enumerable: true, get: function () { return joinRefs_1.joinOnEq; } });
+Object.defineProperty(exports, "orderCol", { enumerable: true, get: function () { return joinRefs_1.orderCol; } });
 var insert_1 = require("./features/query/insert");
 Object.defineProperty(exports, "buildInsert", { enumerable: true, get: function () { return insert_1.buildInsert; } });
 var update_1 = require("./features/query/update");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reltype",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Type-first relational modeling for PostgreSQL in TypeScript. Fluent query builder with automatic camelCase ↔ snake_case conversion, CRUD, streaming, cursor pagination, and hooks.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",