reltype 0.1.1

package/dist/features/schema/interfaces/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("./Infer"), exports);

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

@@ -0,0 +1,14 @@
+import { TableDef, Cols } from './interfaces/Table';
+/**
+ * 테이블 정의를 생성합니다.
+ *
+ * @example
+ * ```ts
+ * const usersTable = defineTable('users', {
+ *   id:    col.serial().primaryKey(),
+ *   name:  col.varchar(255).notNull(),
+ * });
+ * ```
+ */
+export declare function defineTable<TName extends string, TCols extends Cols>(name: TName, cols: TCols): TableDef<TName, TCols>;
+//# sourceMappingURL=table.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/features/schema/table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,IAAI,EAClE,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,KAAK,GACV,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAExB"}

package/dist/features/schema/table.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineTable = defineTable;
+/**
+ * 테이블 정의를 생성합니다.
+ *
+ * @example
+ * ```ts
+ * const usersTable = defineTable('users', {
+ *   id:    col.serial().primaryKey(),
+ *   name:  col.varchar(255).notNull(),
+ * });
+ * ```
+ */
+function defineTable(name, cols) {
+    return { name, cols };
+}

package/dist/features/transform/case.d.ts

@@ -0,0 +1,19 @@
+/**
+ * snake_case 문자열을 camelCase로 변환합니다.
+ * 예: "first_name" → "firstName"
+ */
+export declare function toCamel(str: string): string;
+/**
+ * camelCase 문자열을 snake_case로 변환합니다.
+ * 예: "firstName" → "first_name"
+ */
+export declare function toSnake(str: string): string;
+/**
+ * 객체의 모든 key를 camelCase로 변환합니다.
+ */
+export declare function keysToCamel(obj: Record<string, unknown>): Record<string, unknown>;
+/**
+ * 객체의 모든 key를 snake_case로 변환합니다.
+ */
+export declare function keysToSnake(obj: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=case.d.ts.map

package/dist/features/transform/case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.d.ts","sourceRoot":"","sources":["../../../src/features/transform/case.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIjF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIjF"}

package/dist/features/transform/case.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCamel = toCamel;
+exports.toSnake = toSnake;
+exports.keysToCamel = keysToCamel;
+exports.keysToSnake = keysToSnake;
+/**
+ * snake_case 문자열을 camelCase로 변환합니다.
+ * 예: "first_name" → "firstName"
+ */
+function toCamel(str) {
+    return str.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+/**
+ * camelCase 문자열을 snake_case로 변환합니다.
+ * 예: "firstName" → "first_name"
+ */
+function toSnake(str) {
+    return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+/**
+ * 객체의 모든 key를 camelCase로 변환합니다.
+ */
+function keysToCamel(obj) {
+    return Object.fromEntries(Object.entries(obj).map(([k, v]) => [toCamel(k), v]));
+}
+/**
+ * 객체의 모든 key를 snake_case로 변환합니다.
+ */
+function keysToSnake(obj) {
+    return Object.fromEntries(Object.entries(obj).map(([k, v]) => [toSnake(k), v]));
+}

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

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

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

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

package/dist/features/transform/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("./case"), exports);
+__exportStar(require("./mapper"), exports);

package/dist/features/transform/mapper.d.ts

@@ -0,0 +1,9 @@
+/**
+ * DB raw row를 camelCase TypeScript 객체로 변환합니다.
+ */
+export declare function mapRow<T>(raw: Record<string, unknown>): T;
+/**
+ * DB raw rows 배열을 camelCase TypeScript 객체 배열로 변환합니다.
+ */
+export declare function mapRows<T>(raws: Record<string, unknown>[]): T[];
+//# sourceMappingURL=mapper.d.ts.map

package/dist/features/transform/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/features/transform/mapper.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAEzD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,CAE/D"}

package/dist/features/transform/mapper.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapRow = mapRow;
+exports.mapRows = mapRows;
+const case_1 = require("./case");
+/**
+ * DB raw row를 camelCase TypeScript 객체로 변환합니다.
+ */
+function mapRow(raw) {
+    return (0, case_1.keysToCamel)(raw);
+}
+/**
+ * DB raw rows 배열을 camelCase TypeScript 객체 배열로 변환합니다.
+ */
+function mapRows(raws) {
+    return raws.map((r) => mapRow(r));
+}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+export { col, Col } from './features/schema/column';
+export { defineTable } from './features/schema/table';
+export type { ColShape } from './features/schema/interfaces/Column';
+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 { 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 { buildInsert } from './features/query/insert';
+export { buildUpdate } from './features/query/update';
+export { buildDelete } from './features/query/delete';
+export { buildUpsert } from './features/query/upsert';
+export { buildBulkInsert } from './features/query/bulkInsert';
+export { buildWhere } from './features/query/where';
+export type { BuiltQuery } from './features/query/interfaces/Query';
+export type { WhereInput } from './features/query/interfaces/Where';
+export type { OrderByInput, OrderDir } from './features/query/interfaces/Order';
+export type { SelectOpts } from './features/query/select';
+export { QueryBuilder } from './features/query/builder';
+export type { AdvancedWhere, WhereOp, WhereVal, JoinClause, JoinType, AggregateFn, AggregateCalc, PaginateOpts, PageResult, OrderByClause, KeysetPaginateOpts, KeysetPageResult, StreamOpts, ExecHooks, } from './features/query/interfaces/Advanced';
+export { toCamel, toSnake, keysToCamel, keysToSnake } from './features/transform/case';
+export { mapRow, mapRows } from './features/transform/mapper';
+export { DbError } from './utils/dbError';
+export type { DbErrorKind, DbErrorPayload } from './utils/dbError';
+export { getDatabaseConfig } from './configs/env';
+export type { DatabaseConfig } from './interfaces/DatabaseConfig';
+export { PostgresConfig, NodeEnvSource, readEnv } from './utils/reader';
+export { Logger } from './utils/logger';
+export type { LogLevel, LogFormat, LoggerConfig } from './utils/logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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"}

package/dist/index.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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;
+// ── Schema ──────────────────────────────────────────────────────────────────
+var column_1 = require("./features/schema/column");
+Object.defineProperty(exports, "col", { enumerable: true, get: function () { return column_1.col; } });
+Object.defineProperty(exports, "Col", { enumerable: true, get: function () { return column_1.Col; } });
+var table_1 = require("./features/schema/table");
+Object.defineProperty(exports, "defineTable", { enumerable: true, get: function () { return table_1.defineTable; } });
+// ── Repository ───────────────────────────────────────────────────────────────
+var create_1 = require("./features/repository/create");
+Object.defineProperty(exports, "createRepo", { enumerable: true, get: function () { return create_1.createRepo; } });
+var base_1 = require("./features/repository/base");
+Object.defineProperty(exports, "BaseRepo", { enumerable: true, get: function () { return base_1.BaseRepo; } });
+// ── Connection ───────────────────────────────────────────────────────────────
+var pool_1 = require("./features/connection/pool");
+Object.defineProperty(exports, "getPool", { enumerable: true, get: function () { return pool_1.getPool; } });
+Object.defineProperty(exports, "withClient", { enumerable: true, get: function () { return pool_1.withClient; } });
+Object.defineProperty(exports, "closePool", { enumerable: true, get: function () { return pool_1.closePool; } });
+Object.defineProperty(exports, "getPoolStatus", { enumerable: true, get: function () { return pool_1.getPoolStatus; } });
+Object.defineProperty(exports, "checkPoolHealth", { enumerable: true, get: function () { return pool_1.checkPoolHealth; } });
+var tx_1 = require("./features/connection/tx");
+Object.defineProperty(exports, "runInTx", { enumerable: true, get: function () { return tx_1.runInTx; } });
+// ── Query builders ───────────────────────────────────────────────────────────
+var select_1 = require("./features/query/select");
+Object.defineProperty(exports, "buildSelect", { enumerable: true, get: function () { return select_1.buildSelect; } });
+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");
+Object.defineProperty(exports, "buildUpdate", { enumerable: true, get: function () { return update_1.buildUpdate; } });
+var delete_1 = require("./features/query/delete");
+Object.defineProperty(exports, "buildDelete", { enumerable: true, get: function () { return delete_1.buildDelete; } });
+var upsert_1 = require("./features/query/upsert");
+Object.defineProperty(exports, "buildUpsert", { enumerable: true, get: function () { return upsert_1.buildUpsert; } });
+var bulkInsert_1 = require("./features/query/bulkInsert");
+Object.defineProperty(exports, "buildBulkInsert", { enumerable: true, get: function () { return bulkInsert_1.buildBulkInsert; } });
+var where_1 = require("./features/query/where");
+Object.defineProperty(exports, "buildWhere", { enumerable: true, get: function () { return where_1.buildWhere; } });
+// ── Fluent QueryBuilder ───────────────────────────────────────────────────────
+var builder_1 = require("./features/query/builder");
+Object.defineProperty(exports, "QueryBuilder", { enumerable: true, get: function () { return builder_1.QueryBuilder; } });
+// ── Transform ────────────────────────────────────────────────────────────────
+var case_1 = require("./features/transform/case");
+Object.defineProperty(exports, "toCamel", { enumerable: true, get: function () { return case_1.toCamel; } });
+Object.defineProperty(exports, "toSnake", { enumerable: true, get: function () { return case_1.toSnake; } });
+Object.defineProperty(exports, "keysToCamel", { enumerable: true, get: function () { return case_1.keysToCamel; } });
+Object.defineProperty(exports, "keysToSnake", { enumerable: true, get: function () { return case_1.keysToSnake; } });
+var mapper_1 = require("./features/transform/mapper");
+Object.defineProperty(exports, "mapRow", { enumerable: true, get: function () { return mapper_1.mapRow; } });
+Object.defineProperty(exports, "mapRows", { enumerable: true, get: function () { return mapper_1.mapRows; } });
+// ── Error handling ───────────────────────────────────────────────────────────
+var dbError_1 = require("./utils/dbError");
+Object.defineProperty(exports, "DbError", { enumerable: true, get: function () { return dbError_1.DbError; } });
+// ── Config ───────────────────────────────────────────────────────────────────
+var env_1 = require("./configs/env");
+Object.defineProperty(exports, "getDatabaseConfig", { enumerable: true, get: function () { return env_1.getDatabaseConfig; } });
+var reader_1 = require("./utils/reader");
+Object.defineProperty(exports, "PostgresConfig", { enumerable: true, get: function () { return reader_1.PostgresConfig; } });
+Object.defineProperty(exports, "NodeEnvSource", { enumerable: true, get: function () { return reader_1.NodeEnvSource; } });
+Object.defineProperty(exports, "readEnv", { enumerable: true, get: function () { return reader_1.readEnv; } });
+// ── Logger ───────────────────────────────────────────────────────────────────
+var logger_1 = require("./utils/logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });

package/dist/interfaces/DatabaseConfig.d.ts

@@ -0,0 +1,25 @@
+/**
+ * PostgreSQL 연결 설정 인터페이스
+ * pg 라이브러리의 PoolConfig와 ClientConfig의 모든 옵션을 포함합니다
+ */
+export interface DatabaseConfig {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string | undefined;
+    connectionString?: string;
+    ssl?: boolean | object;
+    max?: number;
+    idleTimeoutMillis?: number;
+    connectionTimeoutMillis?: number;
+    allowExitOnIdle?: boolean;
+    statement_timeout?: number;
+    query_timeout?: number;
+    application_name?: string;
+    parseInputDatesAsUTC?: boolean;
+    keepAlive?: boolean;
+    keepAliveInitialDelayMillis?: number;
+    types?: Record<string, unknown>;
+}
+//# sourceMappingURL=DatabaseConfig.d.ts.map

package/dist/interfaces/DatabaseConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseConfig.d.ts","sourceRoot":"","sources":["../../src/interfaces/DatabaseConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAE3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAGvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAG/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAGvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC"}

package/dist/interfaces/DatabaseConfig.js

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

package/dist/interfaces/EnvSource.d.ts

@@ -0,0 +1,4 @@
+export interface EnvSource {
+    get(key: string): string | undefined;
+}
+//# sourceMappingURL=EnvSource.d.ts.map

package/dist/interfaces/EnvSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvSource.d.ts","sourceRoot":"","sources":["../../src/interfaces/EnvSource.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACxC"}

package/dist/interfaces/EnvSource.js

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

package/dist/interfaces/PostgresDriverOptions.d.ts

@@ -0,0 +1,20 @@
+export interface PostgresDriverOptions {
+    host?: string;
+    port?: number;
+    database?: string;
+    user?: string;
+    password?: string;
+    connectionString?: string;
+    ssl?: boolean;
+    max?: number;
+    idleTimeoutMillis?: number;
+    connectionTimeoutMillis?: number;
+    allowExitOnIdle?: boolean;
+    statement_timeout?: number;
+    query_timeout?: number;
+    application_name?: string;
+    parseInputDatesAsUTC?: boolean;
+    keepAlive?: boolean;
+    keepAliveInitialDelayMillis?: number;
+}
+//# sourceMappingURL=PostgresDriverOptions.d.ts.map

package/dist/interfaces/PostgresDriverOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresDriverOptions.d.ts","sourceRoot":"","sources":["../../src/interfaces/PostgresDriverOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACxC"}

package/dist/interfaces/PostgresDriverOptions.js

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

package/dist/interfaces/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./PostgresDriverOptions";
+export * from "./EnvSource";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/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("./PostgresDriverOptions"), exports);
+__exportStar(require("./EnvSource"), exports);

package/dist/utils/dbError.d.ts

@@ -0,0 +1,61 @@
+/**
+ * PostgreSQL 에러 분류 타입.
+ * pg 라이브러리의 error.code (SQLSTATE) 기준으로 분류됩니다.
+ */
+export type DbErrorKind = 'uniqueViolation' | 'foreignKeyViolation' | 'notNullViolation' | 'checkViolation' | 'deadlock' | 'serializationFailure' | 'connectionFailed' | 'tooManyConnections' | 'queryTimeout' | 'undefinedTable' | 'undefinedColumn' | 'syntaxError' | 'invalidInput' | 'unknown';
+/** 사용자 노출용 에러 페이로드 */
+export interface DbErrorPayload {
+    error: string;
+    kind: DbErrorKind;
+    isRetryable: boolean;
+}
+/**
+ * PostgreSQL 에러를 분류하고, 내부 에러와 사용자 노출 메시지를 분리합니다.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await userRepo.create(data);
+ * } catch (err) {
+ *   if (err instanceof DbError) {
+ *     res.status(400).json(err.toUserPayload());
+ *   }
+ * }
+ * ```
+ */
+export declare class DbError extends Error {
+    readonly kind: DbErrorKind;
+    /** PostgreSQL SQLSTATE 코드 */
+    readonly pgCode: string;
+    /** 사용자에게 안전하게 노출 가능한 메시지 */
+    readonly userMessage: string;
+    /** 재시도 가능 여부 */
+    readonly isRetryable: boolean;
+    /** 관련 테이블명 */
+    readonly table?: string;
+    /** 관련 컬럼명 */
+    readonly column?: string;
+    /** 위반된 제약조건명 */
+    readonly constraint?: string;
+    /** pg가 제공하는 상세 설명 (내부 로그용) */
+    readonly detail?: string;
+    /** pg가 제공하는 힌트 (내부 로그용) */
+    readonly hint?: string;
+    private constructor();
+    /**
+     * 알 수 없는 에러를 DbError로 변환합니다.
+     * 이미 DbError이면 그대로 반환합니다.
+     */
+    static from(err: unknown): DbError;
+    /**
+     * 사용자에게 안전하게 노출할 수 있는 정보만 담은 객체를 반환합니다.
+     * Express response 등에서 직접 사용하세요.
+     */
+    toUserPayload(): DbErrorPayload;
+    /**
+     * 내부 로깅용 컨텍스트를 반환합니다.
+     * 절대 사용자에게 직접 노출하지 마세요.
+     */
+    toLogContext(): Record<string, unknown>;
+}
+//# sourceMappingURL=dbError.d.ts.map

package/dist/utils/dbError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbError.d.ts","sourceRoot":"","sources":["../../src/utils/dbError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB,iBAAiB,GACjB,qBAAqB,GACrB,kBAAkB,GAClB,gBAAgB,GAChB,UAAU,GACV,sBAAsB,GACtB,kBAAkB,GAClB,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,SAAS,CAAC;AA0Dd,sBAAsB;AACtB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IAChC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gBAAgB;IAChB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,cAAc;IACd,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa;IACb,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB;IAChB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,OAAO;IAmBP;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAmBlC;;;OAGG;IACH,aAAa,IAAI,cAAc;IAQ/B;;;OAGG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYxC"}

package/dist/utils/dbError.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DbError = void 0;
+/** pg SQLSTATE 코드 → DbErrorKind 매핑 */
+const PG_CODE_TO_KIND = {
+    '23505': 'uniqueViolation',
+    '23503': 'foreignKeyViolation',
+    '23502': 'notNullViolation',
+    '23514': 'checkViolation',
+    '40P01': 'deadlock',
+    '40001': 'serializationFailure',
+    '08000': 'connectionFailed',
+    '08003': 'connectionFailed',
+    '08006': 'connectionFailed',
+    '08001': 'connectionFailed',
+    '08004': 'connectionFailed',
+    '53300': 'tooManyConnections',
+    '57014': 'queryTimeout',
+    '42P01': 'undefinedTable',
+    '42703': 'undefinedColumn',
+    '42601': 'syntaxError',
+};
+/** 사용자에게 노출할 메시지 (내부 상세 정보 미포함) */
+const USER_MESSAGES = {
+    uniqueViolation: '이미 존재하는 값입니다.',
+    foreignKeyViolation: '참조 데이터가 존재하지 않거나, 참조 중인 데이터를 삭제할 수 없습니다.',
+    notNullViolation: '필수 값이 누락되었습니다.',
+    checkViolation: '유효하지 않은 값입니다.',
+    deadlock: '처리 중 충돌이 발생했습니다. 잠시 후 다시 시도해 주세요.',
+    serializationFailure: '처리 중 충돌이 발생했습니다. 잠시 후 다시 시도해 주세요.',
+    connectionFailed: '데이터베이스에 연결할 수 없습니다.',
+    tooManyConnections: '서버가 일시적으로 혼잡합니다. 잠시 후 다시 시도해 주세요.',
+    queryTimeout: '요청 처리 시간이 초과되었습니다.',
+    undefinedTable: '서버 내부 오류가 발생했습니다.',
+    undefinedColumn: '서버 내부 오류가 발생했습니다.',
+    syntaxError: '서버 내부 오류가 발생했습니다.',
+    invalidInput: '입력 형식이 올바르지 않습니다.',
+    unknown: '알 수 없는 오류가 발생했습니다.',
+};
+/** 재시도가 의미 있는 에러 종류 */
+const RETRYABLE_KINDS = new Set([
+    'deadlock',
+    'serializationFailure',
+    'tooManyConnections',
+    'connectionFailed',
+]);
+/**
+ * PostgreSQL 에러를 분류하고, 내부 에러와 사용자 노출 메시지를 분리합니다.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await userRepo.create(data);
+ * } catch (err) {
+ *   if (err instanceof DbError) {
+ *     res.status(400).json(err.toUserPayload());
+ *   }
+ * }
+ * ```
+ */
+class DbError extends Error {
+    constructor(kind, pgCode, internalMessage, opts = {}) {
+        super(internalMessage);
+        this.name = 'DbError';
+        this.kind = kind;
+        this.pgCode = pgCode;
+        this.userMessage = USER_MESSAGES[kind];
+        this.isRetryable = RETRYABLE_KINDS.has(kind);
+        this.table = opts.table;
+        this.column = opts.column;
+        this.constraint = opts.constraint;
+        this.detail = opts.detail;
+        this.hint = opts.hint;
+    }
+    /**
+     * 알 수 없는 에러를 DbError로 변환합니다.
+     * 이미 DbError이면 그대로 반환합니다.
+     */
+    static from(err) {
+        if (err instanceof DbError)
+            return err;
+        const pg = err;
+        const code = pg.code ?? 'UNKNOWN';
+        const kind = PG_CODE_TO_KIND[code] ??
+            (code.startsWith('22') ? 'invalidInput' : 'unknown');
+        return new DbError(kind, code, pg.message ?? 'Unknown database error', {
+            table: pg.table,
+            column: pg.column,
+            constraint: pg.constraint,
+            detail: pg.detail,
+            hint: pg.hint,
+        });
+    }
+    /**
+     * 사용자에게 안전하게 노출할 수 있는 정보만 담은 객체를 반환합니다.
+     * Express response 등에서 직접 사용하세요.
+     */
+    toUserPayload() {
+        return {
+            error: this.userMessage,
+            kind: this.kind,
+            isRetryable: this.isRetryable,
+        };
+    }
+    /**
+     * 내부 로깅용 컨텍스트를 반환합니다.
+     * 절대 사용자에게 직접 노출하지 마세요.
+     */
+    toLogContext() {
+        return {
+            pgCode: this.pgCode,
+            kind: this.kind,
+            table: this.table,
+            column: this.column,
+            constraint: this.constraint,
+            detail: this.detail,
+            hint: this.hint,
+            message: this.message,
+        };
+    }
+}
+exports.DbError = DbError;

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './logger';
+export * from './reader';
+export * from './dbError';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

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

package/dist/utils/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("./logger"), exports);
+__exportStar(require("./reader"), exports);
+__exportStar(require("./dbError"), exports);