@simplysm/orm-common 13.0.100 → 14.0.4

package/dist/types/column.js

@@ -1,33 +1,63 @@
 import { DateOnly, DateTime, Time, Uuid } from "@simplysm/core-common";
-const dataTypeStrToColumnPrimitiveStr = {
-  int: "number",
-  bigint: "number",
-  float: "number",
-  double: "number",
-  decimal: "number",
-  varchar: "string",
-  char: "string",
-  text: "string",
-  binary: "Bytes",
-  boolean: "boolean",
-  datetime: "DateTime",
-  date: "DateOnly",
-  time: "Time",
-  uuid: "Uuid"
+// ============================================
+// DataType ↔ ColumnPrimitive Mapping
+// ============================================
+/**
+ * SQL DataType → TypeScript 타입 이름 매핑
+ *
+ * @example
+ * ```typescript
+ * const tsType = dataTypeStrToColumnPrimitiveStr["int"];  // "number"
+ * const tsType2 = dataTypeStrToColumnPrimitiveStr["datetime"];  // "DateTime"
+ * ```
+ */
+export const dataTypeStrToColumnPrimitiveStr = {
+    int: "number",
+    bigint: "number",
+    float: "number",
+    double: "number",
+    decimal: "number",
+    varchar: "string",
+    char: "string",
+    text: "string",
+    binary: "Bytes",
+    boolean: "boolean",
+    datetime: "DateTime",
+    date: "DateOnly",
+    time: "Time",
+    uuid: "Uuid",
 };
-function inferColumnPrimitiveStr(value) {
-  if (typeof value === "string") return "string";
-  if (typeof value === "number") return "number";
-  if (typeof value === "boolean") return "boolean";
-  if (value instanceof DateTime) return "DateTime";
-  if (value instanceof DateOnly) return "DateOnly";
-  if (value instanceof Time) return "Time";
-  if (value instanceof Uuid) return "Uuid";
-  if (value instanceof Uint8Array) return "Bytes";
-  throw new Error(`Unknown value type: ${typeof value}`);
+/**
+ * 런타임 값에서 ColumnPrimitiveStr 추론
+ *
+ * @param value - Column 값
+ * @returns ColumnPrimitiveStr 타입 이름
+ * @throws 값 타입이 알 수 없을 때 Error
+ *
+ * @example
+ * ```typescript
+ * inferColumnPrimitiveStr("hello");  // "string"
+ * inferColumnPrimitiveStr(123);  // "number"
+ * inferColumnPrimitiveStr(new DateTime());  // "DateTime"
+ * ```
+ */
+export function inferColumnPrimitiveStr(value) {
+    if (typeof value === "string")
+        return "string";
+    if (typeof value === "number")
+        return "number";
+    if (typeof value === "boolean")
+        return "boolean";
+    if (value instanceof DateTime)
+        return "DateTime";
+    if (value instanceof DateOnly)
+        return "DateOnly";
+    if (value instanceof Time)
+        return "Time";
+    if (value instanceof Uuid)
+        return "Uuid";
+    if (value instanceof Uint8Array)
+        return "Bytes";
+    throw new Error(`알 수 없는 값 타입: ${typeof value}`);
 }
-export {
-  dataTypeStrToColumnPrimitiveStr,
-  inferColumnPrimitiveStr
-};
-//# sourceMappingURL=column.js.map
+//# sourceMappingURL=column.js.map

package/dist/types/column.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/types/column.ts"],
-  "mappings": "AAAA,SAAS,UAAU,UAAU,MAAM,YAAwB;AAyGpD,MAAM,kCAAkC;AAAA,EAC7C,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU;AAAA,EACV,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AACR;AA8BO,SAAS,wBAAwB,OAA4C;AAClF,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,UAAW,QAAO;AACvC,MAAI,iBAAiB,SAAU,QAAO;AACtC,MAAI,iBAAiB,SAAU,QAAO;AACtC,MAAI,iBAAiB,KAAM,QAAO;AAClC,MAAI,iBAAiB,KAAM,QAAO;AAClC,MAAI,iBAAiB,WAAY,QAAO;AACxC,QAAM,IAAI,MAAM,uBAAuB,OAAO,KAAK,EAAE;AACvD;",
-  "names": []
-}
+{"version":3,"file":"column.js","sourceRoot":"","sources":["..\\..\\src\\types\\column.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAc,MAAM,uBAAuB,CAAC;AA4FnF,+CAA+C;AAC/C,qCAAqC;AACrC,+CAA+C;AAE/C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,GAAG,EAAE,QAAiB;IACtB,MAAM,EAAE,QAAiB;IACzB,KAAK,EAAE,QAAiB;IACxB,MAAM,EAAE,QAAiB;IACzB,OAAO,EAAE,QAAiB;IAC1B,OAAO,EAAE,QAAiB;IAC1B,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,QAAiB;IACvB,MAAM,EAAE,OAAgB;IACxB,OAAO,EAAE,SAAkB;IAC3B,QAAQ,EAAE,UAAmB;IAC7B,IAAI,EAAE,UAAmB;IACzB,IAAI,EAAE,MAAe;IACrB,IAAI,EAAE,MAAe;CACtB,CAAC;AAgBF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAsB;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,UAAU,CAAC;IACjD,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,UAAU,CAAC;IACjD,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,OAAO,CAAC;IAChD,MAAM,IAAI,KAAK,CAAC,gBAAgB,OAAO,KAAK,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/types/db-context-def.d.ts

@@ -7,11 +7,11 @@ import type { IndexBuilder } from "../schema/factory/index-builder";
 import type { DataRecord, IsolationLevel, Migration, ResultMeta } from "./db";
 import type { QueryDef, QueryDefObjectName } from "./query-def";
 /**
- * DbContext core interface
+ * DbContext 핵심 인터페이스
  *
- * Internal interface used by Queryable, Executable, and ViewBuilder.
- * Both the old DbContext class and new createDbContext return objects
- * that satisfy this interface.
+ * Queryable, Executable, ViewBuilder에서 사용하는 내부 인터페이스.
+ * 기존 DbContext 클래스와 새로운 createDbContext 반환 객체 모두
+ * 이 인터페이스를 만족함.
  */
 export interface DbContextBase {
     status: DbContextStatus;
@@ -25,9 +25,9 @@ export interface DbContextBase {
 }
 export type DbContextStatus = "ready" | "connect" | "transact";
 /**
- * DbContext definition (blueprint)
+ * DbContext 정의 (blueprint)
  *
- * Created by defineDbContext(). Contains schema metadata but no runtime state.
+ * defineDbContext()로 생성됨. Schema 메타데이터만 포함하며 런타임 상태는 없음.
  */
 export interface DbContextDef<TTables extends Record<string, TableBuilder<any, any>>, TViews extends Record<string, ViewBuilder<any, any, any>>, TProcedures extends Record<string, ProcedureBuilder<any, any>> = {}> {
     readonly meta: {
@@ -38,10 +38,10 @@ export interface DbContextDef<TTables extends Record<string, TableBuilder<any, a
     };
 }
 /**
- * Full DbContext instance type (created by createDbContext)
+ * 전체 DbContext 인스턴스 타입 (createDbContext로 생성)
  *
- * Extends DbContextBase with queryable accessors, DDL methods,
- * and connection/transaction management.
+ * DbContextBase를 queryable 접근자, DDL 메서드,
+ * 연결/트랜잭션 관리로 확장.
  */
 export type DbContextInstance<TDef extends DbContextDef<any, any, any>> = DbContextBase & DbContextConnectionMethods & DbContextDdlMethods & {
     [K in keyof TDef["meta"]["tables"]]: () => import("../exec/queryable").Queryable<TDef["meta"]["tables"][K]["$inferSelect"], TDef["meta"]["tables"][K]>;

package/dist/types/db-context-def.js

@@ -1 +1,2 @@
-//# sourceMappingURL=db-context-def.js.map
+export {};
+//# sourceMappingURL=db-context-def.js.map

package/dist/types/db-context-def.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": [],
-  "mappings": "",
-  "names": []
-}
+{"version":3,"file":"db-context-def.js","sourceRoot":"","sources":["..\\..\\src\\types\\db-context-def.ts"],"names":[],"mappings":""}

package/dist/types/db.d.ts

@@ -2,7 +2,7 @@ import type { ColumnPrimitive, ColumnPrimitiveStr } from "./column";
 import type { QueryDef } from "./query-def";
 import type { DbContextBase, DbContextDdlMethods } from "./db-context-def";
 /**
- * Supported Database dialects
+ * 지원하는 Database dialect
  *
  * - `mysql`: MySQL 8.0.14+
  * - `mssql`: Microsoft SQL Server 2012+
@@ -10,9 +10,9 @@ import type { DbContextBase, DbContextDdlMethods } from "./db-context-def";
  */
 export type Dialect = "mysql" | "mssql" | "postgresql";
 /**
- * List of all supported Database dialects
+ * 지원하는 모든 Database dialect 목록
  *
- * Used for per-dialect validation in testing
+ * 테스트에서 dialect별 검증에 사용
  *
  * @example
  * ```typescript
@@ -24,16 +24,16 @@ export type Dialect = "mysql" | "mssql" | "postgresql";
  */
 export declare const dialects: Dialect[];
 /**
- * QueryBuilder.build() return type
+ * QueryBuilder.build() 반환 타입
  *
- * Built SQL string and metadata for multiple result set processing
+ * 빌드된 SQL 문자열과 다중 결과 셋 처리를 위한 메타데이터
  *
- * @property sql - Built SQL string
- * @property resultSetIndex - Result set index to fetch results from (default: 0)
- *   - MySQL INSERT with OUTPUT: 1 (SELECT from INSERT + SELECT)
- * @property resultSetStride - Extract every Nth result set from multiple results
- *   - Example: index=1, stride=2 -> returns result sets 1, 3, 5, 7...
- *   - MySQL multiple INSERT: INSERT;SELECT; x N -> 1, 3, 5...
+ * @property sql - 빌드된 SQL 문자열
+ * @property resultSetIndex - 결과를 가져올 결과 셋 index (기본값: 0)
+ *   - MySQL INSERT with OUTPUT: 1 (INSERT + SELECT에서 SELECT)
+ * @property resultSetStride - 다중 결과에서 N번째마다 결과 셋 추출
+ *   - 예: index=1, stride=2 -> 결과 셋 1, 3, 5, 7... 반환
+ *   - MySQL 다중 INSERT: INSERT;SELECT; x N -> 1, 3, 5...
  */
 export interface QueryBuildResult {
     sql: string;
@@ -41,30 +41,30 @@ export interface QueryBuildResult {
     resultSetStride?: number;
 }
 /**
- * Transaction isolation level
+ * 트랜잭션 격리 수준
  *
- * - `READ_UNCOMMITTED`: Can read uncommitted data (Dirty Read)
- * - `READ_COMMITTED`: Read only committed data (default)
- * - `REPEATABLE_READ`: Guarantees same query returns same result within transaction
- * - `SERIALIZABLE`: Full serialization (most strict)
+ * - `READ_UNCOMMITTED`: 커밋되지 않은 데이터 읽기 가능 (Dirty Read)
+ * - `READ_COMMITTED`: 커밋된 데이터만 읽기 (기본값)
+ * - `REPEATABLE_READ`: 트랜잭션 내 동일 query가 동일 결과 반환 보장
+ * - `SERIALIZABLE`: 완전 직렬화 (가장 엄격)
  */
 export type IsolationLevel = "READ_UNCOMMITTED" | "READ_COMMITTED" | "REPEATABLE_READ" | "SERIALIZABLE";
 /**
- * Query result data record type
+ * Query 결과 데이터 레코드 타입
  *
- * Represents nested relation (include) results with recursive structure
+ * 재귀적 구조로 중첩 관계(include) 결과를 표현
  *
  * @example
  * ```typescript
- * // Simple record
+ * // 단순 레코드
  * type User = { id: number; name: string; }
  *
- * // Nested relation include
+ * // 중첩 관계 include
  * type UserWithPosts = {
  *   id: number;
  *   name: string;
- *   posts: { id: number; title: string; }[]  // 1:N relationship
- *   company: { id: number; name: string; }   // N:1 relationship
+ *   posts: { id: number; title: string; }[]  // 1:N 관계
+ *   company: { id: number; name: string; }   // N:1 관계
  * }
  * ```
  */
@@ -72,14 +72,14 @@ export type DataRecord = {
     [key: string]: ColumnPrimitive | DataRecord | DataRecord[];
 };
 /**
- * DbContext executor interface
+ * DbContext executor 인터페이스
  *
- * Responsible for actual DB connection and query execution
- * Implemented by NodeDbContextExecutor (server) or SdOrmServiceClientDbContextExecutor (client)
+ * 실제 DB 연결과 query 실행을 담당
+ * NodeDbContextExecutor(서버) 또는 SdOrmServiceClientDbContextExecutor(클라이언트)로 구현
  *
  * @example
  * ```typescript
- * // Server-side implementation example
+ * // 서버 측 구현 예시
  * class NodeDbContextExecutor implements IDbContextExecutor {
  *   async connect(): Promise<void> {
  *     await this.connection.connect();
@@ -88,48 +88,48 @@ export type DataRecord = {
  * }
  * ```
  *
- * @see {@link DbContext} Used in DbContext
+ * @see {@link DbContext} DbContext에서 사용
  */
 export interface DbContextExecutor {
     /**
-     * Establish DB connection
+     * DB 연결 수립
      */
     connect(): Promise<void>;
     /**
-     * Close DB connection
+     * DB 연결 종료
      */
     close(): Promise<void>;
     /**
-     * Begin transaction
+     * 트랜잭션 시작
      *
-     * @param isolationLevel - Isolation level (optional)
+     * @param isolationLevel - 격리 수준 (선택)
      */
     beginTransaction(isolationLevel?: IsolationLevel): Promise<void>;
     /**
-     * Commit transaction
+     * 트랜잭션 커밋
      */
     commitTransaction(): Promise<void>;
     /**
-     * Rollback transaction
+     * 트랜잭션 롤백
      */
     rollbackTransaction(): Promise<void>;
     /**
-     * Execute QueryDef array
+     * QueryDef 배열 실행
      *
-     * @template T - Result record type
-     * @param defs - QueryDef array to execute
-     * @param resultMetas - Metadata for result transformation (optional)
-     * @returns Array of result arrays per QueryDef
+     * @template T - 결과 레코드 타입
+     * @param defs - 실행할 QueryDef 배열
+     * @param resultMetas - 결과 변환용 메타데이터 (선택)
+     * @returns QueryDef별 결과 배열의 배열
      */
     executeDefs<T = DataRecord>(defs: QueryDef[], resultMetas?: (ResultMeta | undefined)[]): Promise<T[][]>;
 }
 /**
- * Metadata for query result transformation
+ * Query 결과 변환용 메타데이터
  *
- * Used when transforming SELECT results into TypeScript objects
+ * SELECT 결과를 TypeScript 객체로 변환할 때 사용
  *
- * @property columns - Column name -> ColumnPrimitiveStr mapping
- * @property joins - JOIN alias -> single/array indicator
+ * @property columns - Column 이름 -> ColumnPrimitiveStr 매핑
+ * @property joins - JOIN alias -> 단일/배열 구분자
  */
 export interface ResultMeta {
     columns: Record<string, ColumnPrimitiveStr>;
@@ -138,12 +138,12 @@ export interface ResultMeta {
     }>;
 }
 /**
- * Database migration definition
+ * Database migration 정의
  *
- * Version-control schema changes
+ * Schema 변경을 버전 관리
  *
- * @property name - Unique Migration name (timestamp recommended)
- * @property up - Migration execution function
+ * @property name - 고유 Migration 이름 (타임스탬프 권장)
+ * @property up - Migration 실행 함수
  *
  * @example
  * ```typescript
@@ -166,7 +166,7 @@ export interface ResultMeta {
  * ];
  * ```
  *
- * @see {@link DbContext.initialize} migration execution
+ * @see {@link DbContext.initialize} migration 실행
  */
 export interface Migration {
     name: string;

package/dist/types/db.js

@@ -1,5 +1,15 @@
-const dialects = ["mysql", "mssql", "postgresql"];
-export {
-  dialects
-};
-//# sourceMappingURL=db.js.map
+/**
+ * 지원하는 모든 Database dialect 목록
+ *
+ * 테스트에서 dialect별 검증에 사용
+ *
+ * @example
+ * ```typescript
+ * it.each(dialects)("[%s] SQL Validation", (dialect) => {
+ *   const builder = createQueryBuilder(dialect);
+ *   expect(builder.build(def)).toMatchSql(expected[dialect]);
+ * });
+ * ```
+ */
+export const dialects = ["mysql", "mssql", "postgresql"];
+//# sourceMappingURL=db.js.map

package/dist/types/db.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/types/db.ts"],
-  "mappings": "AA8BO,MAAM,WAAsB,CAAC,SAAS,SAAS,YAAY;",
-  "names": []
-}
+{"version":3,"file":"db.js","sourceRoot":"","sources":["..\\..\\src\\types\\db.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAc,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC"}