@simplysm/orm-common 13.0.100 → 14.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (246) hide show
  1. package/README.md +90 -147
  2. package/dist/create-db-context.d.ts +10 -10
  3. package/dist/create-db-context.js +312 -276
  4. package/dist/create-db-context.js.map +1 -6
  5. package/dist/ddl/column-ddl.d.ts +4 -4
  6. package/dist/ddl/column-ddl.js +41 -35
  7. package/dist/ddl/column-ddl.js.map +1 -6
  8. package/dist/ddl/initialize.d.ts +17 -17
  9. package/dist/ddl/initialize.js +200 -142
  10. package/dist/ddl/initialize.js.map +1 -6
  11. package/dist/ddl/relation-ddl.d.ts +6 -6
  12. package/dist/ddl/relation-ddl.js +55 -48
  13. package/dist/ddl/relation-ddl.js.map +1 -6
  14. package/dist/ddl/schema-ddl.d.ts +4 -4
  15. package/dist/ddl/schema-ddl.js +21 -15
  16. package/dist/ddl/schema-ddl.js.map +1 -6
  17. package/dist/ddl/table-ddl.d.ts +20 -20
  18. package/dist/ddl/table-ddl.js +139 -93
  19. package/dist/ddl/table-ddl.js.map +1 -6
  20. package/dist/define-db-context.js +10 -13
  21. package/dist/define-db-context.js.map +1 -6
  22. package/dist/errors/db-transaction-error.d.ts +15 -15
  23. package/dist/errors/db-transaction-error.d.ts.map +1 -1
  24. package/dist/errors/db-transaction-error.js +53 -19
  25. package/dist/errors/db-transaction-error.js.map +1 -6
  26. package/dist/exec/executable.d.ts +23 -23
  27. package/dist/exec/executable.js +94 -40
  28. package/dist/exec/executable.js.map +1 -6
  29. package/dist/exec/queryable.d.ts +97 -97
  30. package/dist/exec/queryable.js +1310 -1204
  31. package/dist/exec/queryable.js.map +1 -6
  32. package/dist/exec/search-parser.d.ts +31 -31
  33. package/dist/exec/search-parser.d.ts.map +1 -1
  34. package/dist/exec/search-parser.js +158 -59
  35. package/dist/exec/search-parser.js.map +1 -6
  36. package/dist/expr/expr-unit.d.ts +4 -4
  37. package/dist/expr/expr-unit.js +24 -18
  38. package/dist/expr/expr-unit.js.map +1 -6
  39. package/dist/expr/expr.d.ts +108 -108
  40. package/dist/expr/expr.js +1872 -1844
  41. package/dist/expr/expr.js.map +1 -6
  42. package/dist/index.js +23 -1
  43. package/dist/index.js.map +1 -6
  44. package/dist/models/system-migration.js +7 -7
  45. package/dist/models/system-migration.js.map +1 -6
  46. package/dist/query-builder/base/expr-renderer-base.d.ts +10 -10
  47. package/dist/query-builder/base/expr-renderer-base.js +27 -21
  48. package/dist/query-builder/base/expr-renderer-base.js.map +1 -6
  49. package/dist/query-builder/base/query-builder-base.d.ts +21 -21
  50. package/dist/query-builder/base/query-builder-base.d.ts.map +1 -1
  51. package/dist/query-builder/base/query-builder-base.js +90 -80
  52. package/dist/query-builder/base/query-builder-base.js.map +1 -6
  53. package/dist/query-builder/mssql/mssql-expr-renderer.d.ts +5 -5
  54. package/dist/query-builder/mssql/mssql-expr-renderer.d.ts.map +1 -1
  55. package/dist/query-builder/mssql/mssql-expr-renderer.js +447 -420
  56. package/dist/query-builder/mssql/mssql-expr-renderer.js.map +1 -6
  57. package/dist/query-builder/mssql/mssql-query-builder.d.ts +2 -2
  58. package/dist/query-builder/mssql/mssql-query-builder.d.ts.map +1 -1
  59. package/dist/query-builder/mssql/mssql-query-builder.js +483 -443
  60. package/dist/query-builder/mssql/mssql-query-builder.js.map +1 -6
  61. package/dist/query-builder/mysql/mysql-expr-renderer.d.ts +5 -5
  62. package/dist/query-builder/mysql/mysql-expr-renderer.d.ts.map +1 -1
  63. package/dist/query-builder/mysql/mysql-expr-renderer.js +451 -419
  64. package/dist/query-builder/mysql/mysql-expr-renderer.js.map +1 -6
  65. package/dist/query-builder/mysql/mysql-query-builder.d.ts +10 -10
  66. package/dist/query-builder/mysql/mysql-query-builder.d.ts.map +1 -1
  67. package/dist/query-builder/mysql/mysql-query-builder.js +570 -479
  68. package/dist/query-builder/mysql/mysql-query-builder.js.map +1 -6
  69. package/dist/query-builder/postgresql/postgresql-expr-renderer.d.ts +5 -5
  70. package/dist/query-builder/postgresql/postgresql-expr-renderer.d.ts.map +1 -1
  71. package/dist/query-builder/postgresql/postgresql-expr-renderer.js +449 -422
  72. package/dist/query-builder/postgresql/postgresql-expr-renderer.js.map +1 -6
  73. package/dist/query-builder/postgresql/postgresql-query-builder.d.ts +8 -8
  74. package/dist/query-builder/postgresql/postgresql-query-builder.d.ts.map +1 -1
  75. package/dist/query-builder/postgresql/postgresql-query-builder.js +511 -460
  76. package/dist/query-builder/postgresql/postgresql-query-builder.js.map +1 -6
  77. package/dist/query-builder/query-builder.d.ts +1 -1
  78. package/dist/query-builder/query-builder.js +13 -13
  79. package/dist/query-builder/query-builder.js.map +1 -6
  80. package/dist/schema/factory/column-builder.d.ts +84 -84
  81. package/dist/schema/factory/column-builder.js +248 -185
  82. package/dist/schema/factory/column-builder.js.map +1 -6
  83. package/dist/schema/factory/index-builder.d.ts +38 -38
  84. package/dist/schema/factory/index-builder.js +144 -85
  85. package/dist/schema/factory/index-builder.js.map +1 -6
  86. package/dist/schema/factory/relation-builder.d.ts +99 -99
  87. package/dist/schema/factory/relation-builder.d.ts.map +1 -1
  88. package/dist/schema/factory/relation-builder.js +274 -136
  89. package/dist/schema/factory/relation-builder.js.map +1 -6
  90. package/dist/schema/procedure-builder.d.ts +51 -51
  91. package/dist/schema/procedure-builder.d.ts.map +1 -1
  92. package/dist/schema/procedure-builder.js +205 -131
  93. package/dist/schema/procedure-builder.js.map +1 -6
  94. package/dist/schema/table-builder.d.ts +55 -55
  95. package/dist/schema/table-builder.d.ts.map +1 -1
  96. package/dist/schema/table-builder.js +274 -205
  97. package/dist/schema/table-builder.js.map +1 -6
  98. package/dist/schema/view-builder.d.ts +44 -44
  99. package/dist/schema/view-builder.d.ts.map +1 -1
  100. package/dist/schema/view-builder.js +189 -116
  101. package/dist/schema/view-builder.js.map +1 -6
  102. package/dist/types/column.d.ts +21 -21
  103. package/dist/types/column.js +60 -30
  104. package/dist/types/column.js.map +1 -6
  105. package/dist/types/db-context-def.d.ts +9 -9
  106. package/dist/types/db-context-def.js +2 -1
  107. package/dist/types/db-context-def.js.map +1 -6
  108. package/dist/types/db.d.ts +47 -47
  109. package/dist/types/db.js +15 -5
  110. package/dist/types/db.js.map +1 -6
  111. package/dist/types/expr.d.ts +81 -81
  112. package/dist/types/expr.d.ts.map +1 -1
  113. package/dist/types/expr.js +3 -1
  114. package/dist/types/expr.js.map +1 -6
  115. package/dist/types/query-def.d.ts +46 -46
  116. package/dist/types/query-def.d.ts.map +1 -1
  117. package/dist/types/query-def.js +31 -24
  118. package/dist/types/query-def.js.map +1 -6
  119. package/dist/utils/result-parser.d.ts +11 -11
  120. package/dist/utils/result-parser.js +362 -221
  121. package/dist/utils/result-parser.js.map +1 -6
  122. package/docs/core.md +117 -145
  123. package/docs/expression.md +186 -203
  124. package/docs/query-builder.md +75 -42
  125. package/docs/queryable.md +189 -151
  126. package/docs/schema-builders.md +172 -283
  127. package/docs/types.md +229 -173
  128. package/package.json +7 -5
  129. package/src/create-db-context.ts +31 -31
  130. package/src/ddl/column-ddl.ts +4 -4
  131. package/src/ddl/initialize.ts +38 -38
  132. package/src/ddl/relation-ddl.ts +6 -6
  133. package/src/ddl/schema-ddl.ts +4 -4
  134. package/src/ddl/table-ddl.ts +24 -24
  135. package/src/errors/db-transaction-error.ts +13 -13
  136. package/src/exec/executable.ts +25 -25
  137. package/src/exec/queryable.ts +152 -152
  138. package/src/exec/search-parser.ts +50 -50
  139. package/src/expr/expr-unit.ts +4 -4
  140. package/src/expr/expr.ts +118 -118
  141. package/src/index.ts +8 -8
  142. package/src/models/system-migration.ts +1 -1
  143. package/src/query-builder/base/expr-renderer-base.ts +21 -21
  144. package/src/query-builder/base/query-builder-base.ts +33 -33
  145. package/src/query-builder/mssql/mssql-expr-renderer.ts +28 -28
  146. package/src/query-builder/mssql/mssql-query-builder.ts +37 -37
  147. package/src/query-builder/mysql/mysql-expr-renderer.ts +29 -29
  148. package/src/query-builder/mysql/mysql-query-builder.ts +70 -70
  149. package/src/query-builder/postgresql/postgresql-expr-renderer.ts +22 -22
  150. package/src/query-builder/postgresql/postgresql-query-builder.ts +54 -54
  151. package/src/query-builder/query-builder.ts +1 -1
  152. package/src/schema/factory/column-builder.ts +86 -86
  153. package/src/schema/factory/index-builder.ts +38 -38
  154. package/src/schema/factory/relation-builder.ts +102 -102
  155. package/src/schema/procedure-builder.ts +52 -52
  156. package/src/schema/table-builder.ts +56 -56
  157. package/src/schema/view-builder.ts +47 -47
  158. package/src/types/column.ts +24 -24
  159. package/src/types/db-context-def.ts +15 -15
  160. package/src/types/db.ts +50 -50
  161. package/src/types/expr.ts +103 -103
  162. package/src/types/query-def.ts +50 -50
  163. package/src/utils/result-parser.ts +88 -88
  164. package/docs/utilities.md +0 -27
  165. package/tests/db-context/create-db-context.spec.ts +0 -193
  166. package/tests/db-context/define-db-context.spec.ts +0 -17
  167. package/tests/ddl/basic.expected.ts +0 -341
  168. package/tests/ddl/basic.spec.ts +0 -557
  169. package/tests/ddl/column-builder.expected.ts +0 -310
  170. package/tests/ddl/column-builder.spec.ts +0 -525
  171. package/tests/ddl/index-builder.expected.ts +0 -38
  172. package/tests/ddl/index-builder.spec.ts +0 -148
  173. package/tests/ddl/procedure-builder.expected.ts +0 -52
  174. package/tests/ddl/procedure-builder.spec.ts +0 -128
  175. package/tests/ddl/relation-builder.expected.ts +0 -36
  176. package/tests/ddl/relation-builder.spec.ts +0 -171
  177. package/tests/ddl/table-builder.expected.ts +0 -113
  178. package/tests/ddl/table-builder.spec.ts +0 -399
  179. package/tests/ddl/view-builder.expected.ts +0 -38
  180. package/tests/ddl/view-builder.spec.ts +0 -116
  181. package/tests/dml/delete.expected.ts +0 -96
  182. package/tests/dml/delete.spec.ts +0 -127
  183. package/tests/dml/insert.expected.ts +0 -192
  184. package/tests/dml/insert.spec.ts +0 -210
  185. package/tests/dml/update.expected.ts +0 -176
  186. package/tests/dml/update.spec.ts +0 -222
  187. package/tests/dml/upsert.expected.ts +0 -215
  188. package/tests/dml/upsert.spec.ts +0 -190
  189. package/tests/errors/queryable-errors.spec.ts +0 -126
  190. package/tests/escape.spec.ts +0 -59
  191. package/tests/examples/pivot.expected.ts +0 -211
  192. package/tests/examples/pivot.spec.ts +0 -200
  193. package/tests/examples/sampling.expected.ts +0 -69
  194. package/tests/examples/sampling.spec.ts +0 -42
  195. package/tests/examples/unpivot.expected.ts +0 -120
  196. package/tests/examples/unpivot.spec.ts +0 -161
  197. package/tests/exec/search-parser.spec.ts +0 -267
  198. package/tests/executable/basic.expected.ts +0 -18
  199. package/tests/executable/basic.spec.ts +0 -54
  200. package/tests/expr/comparison.expected.ts +0 -282
  201. package/tests/expr/comparison.spec.ts +0 -334
  202. package/tests/expr/conditional.expected.ts +0 -134
  203. package/tests/expr/conditional.spec.ts +0 -249
  204. package/tests/expr/date.expected.ts +0 -332
  205. package/tests/expr/date.spec.ts +0 -459
  206. package/tests/expr/math.expected.ts +0 -62
  207. package/tests/expr/math.spec.ts +0 -59
  208. package/tests/expr/string.expected.ts +0 -218
  209. package/tests/expr/string.spec.ts +0 -300
  210. package/tests/expr/utility.expected.ts +0 -147
  211. package/tests/expr/utility.spec.ts +0 -155
  212. package/tests/select/basic.expected.ts +0 -322
  213. package/tests/select/basic.spec.ts +0 -433
  214. package/tests/select/filter.expected.ts +0 -357
  215. package/tests/select/filter.spec.ts +0 -954
  216. package/tests/select/group.expected.ts +0 -169
  217. package/tests/select/group.spec.ts +0 -159
  218. package/tests/select/join.expected.ts +0 -582
  219. package/tests/select/join.spec.ts +0 -692
  220. package/tests/select/order.expected.ts +0 -150
  221. package/tests/select/order.spec.ts +0 -140
  222. package/tests/select/recursive-cte.expected.ts +0 -244
  223. package/tests/select/recursive-cte.spec.ts +0 -514
  224. package/tests/select/result-meta.spec.ts +0 -270
  225. package/tests/select/subquery.expected.ts +0 -363
  226. package/tests/select/subquery.spec.ts +0 -441
  227. package/tests/select/view.expected.ts +0 -155
  228. package/tests/select/view.spec.ts +0 -235
  229. package/tests/select/window.expected.ts +0 -345
  230. package/tests/select/window.spec.ts +0 -433
  231. package/tests/setup/MockExecutor.ts +0 -18
  232. package/tests/setup/TestDbContext.ts +0 -59
  233. package/tests/setup/models/Company.ts +0 -13
  234. package/tests/setup/models/Employee.ts +0 -10
  235. package/tests/setup/models/MonthlySales.ts +0 -11
  236. package/tests/setup/models/Post.ts +0 -16
  237. package/tests/setup/models/Sales.ts +0 -10
  238. package/tests/setup/models/User.ts +0 -19
  239. package/tests/setup/procedure/GetAllUsers.ts +0 -9
  240. package/tests/setup/procedure/GetUserById.ts +0 -12
  241. package/tests/setup/test-utils.ts +0 -72
  242. package/tests/setup/views/ActiveUsers.ts +0 -8
  243. package/tests/setup/views/UserSummary.ts +0 -11
  244. package/tests/types/nullable-queryable-record.spec.ts +0 -97
  245. package/tests/utils/result-parser-perf.spec.ts +0 -143
  246. package/tests/utils/result-parser.spec.ts +0 -667
@@ -10,17 +10,17 @@ interface WinSpecInput {
10
10
  orderBy?: [ExprInput<ColumnPrimitive>, ("ASC" | "DESC")?][];
11
11
  }
12
12
  /**
13
- * Switch expression builder interface
13
+ * Switch expression builder 인터페이스
14
14
  */
15
15
  export interface SwitchExprBuilder<TPrimitive extends ColumnPrimitive> {
16
16
  case(condition: WhereExprUnit, then: ExprInput<TPrimitive>): SwitchExprBuilder<TPrimitive>;
17
17
  default(value: ExprInput<TPrimitive>): ExprUnit<TPrimitive>;
18
18
  }
19
19
  /**
20
- * Dialect-independent SQL expression builder
20
+ * Dialect 독립적 SQL expression builder
21
21
  *
22
- * Generates JSON AST (Expr) instead of SQL strings, which QueryBuilder
23
- * converts to each DBMS (MySQL, MSSQL, PostgreSQL)
22
+ * SQL 문자열 대신 JSON AST(Expr) 생성하며, QueryBuilder
23
+ * DBMS(MySQL, MSSQL, PostgreSQL)로 변환
24
24
  *
25
25
  * @example
26
26
  * ```typescript
@@ -43,18 +43,18 @@ export interface SwitchExprBuilder<TPrimitive extends ColumnPrimitive> {
43
43
  * }))
44
44
  * ```
45
45
  *
46
- * @see {@link Queryable} Query builder class
47
- * @see {@link ExprUnit} Expression wrapper class
46
+ * @see {@link Queryable} Query builder 클래스
47
+ * @see {@link ExprUnit} Expression 래퍼 클래스
48
48
  */
49
49
  export declare const expr: {
50
50
  /**
51
- * Wrap literal value as ExprUnit
51
+ * 리터럴 값을 ExprUnit으로 래핑
52
52
  *
53
- * Widen to base type matching dataType, remove literal type
53
+ * dataType에 맞는 기본 타입으로 확장, 리터럴 타입 제거
54
54
  *
55
- * @param dataType - The data type of the value ("string", "number", "boolean", "DateTime", "DateOnly", "Time", "Uuid", "Buffer")
56
- * @param value - Value to wrap (undefined allowed)
57
- * @returns Wrapped ExprUnit instance
55
+ * @param dataType - 값의 데이터 타입 ("string", "number", "boolean", "DateTime", "DateOnly", "Time", "Uuid", "Buffer")
56
+ * @param value - 래핑할 (undefined 허용)
57
+ * @returns 래핑된 ExprUnit 인스턴스
58
58
  *
59
59
  * @example
60
60
  * ```typescript
@@ -73,13 +73,13 @@ export declare const expr: {
73
73
  */
74
74
  val<TStr extends ColumnPrimitiveStr, T extends ColumnPrimitiveMap[TStr] | undefined>(dataType: TStr, value: T): ExprUnit<T extends undefined ? ColumnPrimitiveMap[TStr] | undefined : ColumnPrimitiveMap[TStr]>;
75
75
  /**
76
- * Generate column reference
76
+ * Column 참조 생성
77
77
  *
78
- * Typically proxy objects are used inside Queryable callbacks
78
+ * 일반적으로 Queryable 콜백 내부에서 프록시 객체를 사용
79
79
  *
80
- * @param dataType - Column data type
81
- * @param path - Column path (table alias, column name, etc.)
82
- * @returns Column reference ExprUnit instance
80
+ * @param dataType - Column 데이터 타입
81
+ * @param path - Column 경로 (테이블 별칭, column 이름 )
82
+ * @returns Column 참조 ExprUnit 인스턴스
83
83
  *
84
84
  * @example
85
85
  * ```typescript
@@ -89,13 +89,13 @@ export declare const expr: {
89
89
  */
90
90
  col<TStr extends ColumnPrimitiveStr>(dataType: ColumnPrimitiveStr, ...path: string[]): ExprUnit<ColumnPrimitiveMap[TStr] | undefined>;
91
91
  /**
92
- * Raw SQL expression Generate (escape hatch)
92
+ * Raw SQL expression 생성 (이스케이프 해치)
93
93
  *
94
- * Use when you need to directly use DB-specific functions or syntax not supported by the ORM.
95
- * Used as tagged template literal, interpolated values are automatically parameterized
94
+ * ORM에서 지원하지 않는 DB 전용 함수나 구문을 직접 사용해야 사용.
95
+ * 태그드 템플릿 리터럴로 사용하며, 보간된 값은 자동으로 파라미터화됨
96
96
  *
97
- * @param dataType - Data type of the returned value
98
- * @returns Tagged template function
97
+ * @param dataType - 반환 값의 데이터 타입
98
+ * @returns 태그드 템플릿 함수
99
99
  *
100
100
  * @example
101
101
  * ```typescript
@@ -111,13 +111,13 @@ export declare const expr: {
111
111
  */
112
112
  raw<T extends ColumnPrimitiveStr>(dataType: T): (strings: TemplateStringsArray, ...values: ExprInput<ColumnPrimitive>[]) => ExprUnit<ColumnPrimitiveMap[T] | undefined>;
113
113
  /**
114
- * Equality comparison (NULL-safe)
114
+ * 동등 비교 (NULL 안전)
115
115
  *
116
- * Safely compare even NULL values (MySQL: `<=>`, MSSQL/PostgreSQL: `IS NULL OR =`)
116
+ * NULL 값도 안전하게 비교 (MySQL: `<=>`, MSSQL/PostgreSQL: `IS NULL OR =`)
117
117
  *
118
- * @param source - Column or expression to compare
119
- * @param target - Target value or expression for comparison
120
- * @returns WHERE condition expression
118
+ * @param source - 비교할 column 또는 expression
119
+ * @param target - 비교 대상 또는 expression
120
+ * @returns WHERE 조건 expression
121
121
  *
122
122
  * @example
123
123
  * ```typescript
@@ -127,11 +127,11 @@ export declare const expr: {
127
127
  */
128
128
  eq<T extends ColumnPrimitive>(source: ExprUnit<T>, target: ExprInput<T>): WhereExprUnit;
129
129
  /**
130
- * Greater than comparison (>)
130
+ * 초과 비교 (>)
131
131
  *
132
- * @param source - Column or expression to compare
133
- * @param target - Target value or expression for comparison
134
- * @returns WHERE condition expression
132
+ * @param source - 비교할 column 또는 expression
133
+ * @param target - 비교 대상 또는 expression
134
+ * @returns WHERE 조건 expression
135
135
  *
136
136
  * @example
137
137
  * ```typescript
@@ -141,11 +141,11 @@ export declare const expr: {
141
141
  */
142
142
  gt<T extends ColumnPrimitive>(source: ExprUnit<T>, target: ExprInput<T>): WhereExprUnit;
143
143
  /**
144
- * Less than comparison (<)
144
+ * 미만 비교 (<)
145
145
  *
146
- * @param source - Column or expression to compare
147
- * @param target - Target value or expression for comparison
148
- * @returns WHERE condition expression
146
+ * @param source - 비교할 column 또는 expression
147
+ * @param target - 비교 대상 또는 expression
148
+ * @returns WHERE 조건 expression
149
149
  *
150
150
  * @example
151
151
  * ```typescript
@@ -155,11 +155,11 @@ export declare const expr: {
155
155
  */
156
156
  lt<T extends ColumnPrimitive>(source: ExprUnit<T>, target: ExprInput<T>): WhereExprUnit;
157
157
  /**
158
- * Greater than or equal comparison (>=)
158
+ * 이상 비교 (>=)
159
159
  *
160
- * @param source - Column or expression to compare
161
- * @param target - Target value or expression for comparison
162
- * @returns WHERE condition expression
160
+ * @param source - 비교할 column 또는 expression
161
+ * @param target - 비교 대상 또는 expression
162
+ * @returns WHERE 조건 expression
163
163
  *
164
164
  * @example
165
165
  * ```typescript
@@ -169,11 +169,11 @@ export declare const expr: {
169
169
  */
170
170
  gte<T extends ColumnPrimitive>(source: ExprUnit<T>, target: ExprInput<T>): WhereExprUnit;
171
171
  /**
172
- * Less than or equal comparison (<=)
172
+ * 이하 비교 (<=)
173
173
  *
174
- * @param source - Column or expression to compare
175
- * @param target - Target value or expression for comparison
176
- * @returns WHERE condition expression
174
+ * @param source - 비교할 column 또는 expression
175
+ * @param target - 비교 대상 또는 expression
176
+ * @returns WHERE 조건 expression
177
177
  *
178
178
  * @example
179
179
  * ```typescript
@@ -185,12 +185,12 @@ export declare const expr: {
185
185
  /**
186
186
  * range comparison (BETWEEN)
187
187
  *
188
- * If from/to is undefined, that direction is unbounded
188
+ * from/to undefined이면 해당 방향은 제한 없음
189
189
  *
190
- * @param source - Column or expression to compare
191
- * @param from - Start value (no lower bound if undefined)
192
- * @param to - End value (no upper bound if undefined)
193
- * @returns WHERE condition expression
190
+ * @param source - 비교할 column 또는 expression
191
+ * @param from - 시작 (undefined이면 하한 없음)
192
+ * @param to - (undefined이면 상한 없음)
193
+ * @returns WHERE 조건 expression
194
194
  *
195
195
  * @example
196
196
  * ```typescript
@@ -221,7 +221,7 @@ export declare const expr: {
221
221
  * LIKE pattern matching
222
222
  *
223
223
  * `%` matches zero or more characters, `_` matches a single character.
224
- * Special characters are escaped with `\`
224
+ * 특수 문자는 `\`로 이스케이프됨
225
225
  *
226
226
  * @param source - Column or expression to search
227
227
  * @param pattern - Search pattern (%, _ wildcards available)
@@ -239,9 +239,9 @@ export declare const expr: {
239
239
  */
240
240
  like(source: ExprUnit<string | undefined>, pattern: ExprInput<string | undefined>): WhereExprUnit;
241
241
  /**
242
- * Regular expression pattern matching
242
+ * 정규식 패턴 매칭
243
243
  *
244
- * Note: regex syntax may differ between DBMS implementations
244
+ * 참고: 정규식 구문은 DBMS 구현에 따라 다를 수 있음
245
245
  *
246
246
  * @param source - Column or expression to search
247
247
  * @param pattern - Regular expression pattern
@@ -271,7 +271,7 @@ export declare const expr: {
271
271
  /**
272
272
  * IN (SELECT ...) - Compare against subquery results
273
273
  *
274
- * The subquery must SELECT only a single column
274
+ * 서브쿼리는 단일 column만 SELECT해야
275
275
  *
276
276
  * @param source - Column or expression to compare
277
277
  * @param query - Queryable that returns a single column
@@ -295,7 +295,7 @@ export declare const expr: {
295
295
  /**
296
296
  * EXISTS (SELECT ...) - Check if subquery returns any rows
297
297
  *
298
- * Returns true if the subquery returns one or more rows
298
+ * 서브쿼리가 하나 이상의 행을 반환하면 true 반환
299
299
  *
300
300
  * @param query - Queryable to check for existence
301
301
  * @returns WHERE condition expression
@@ -328,7 +328,7 @@ export declare const expr: {
328
328
  /**
329
329
  * AND operator - All conditions must be satisfied
330
330
  *
331
- * Combines multiple conditions with AND. Passing an array to where() automatically applies AND
331
+ * 여러 조건을 AND 결합. where() 배열을 전달하면 자동으로 AND 적용
332
332
  *
333
333
  * @param conditions - List of conditions to combine with AND
334
334
  * @returns Combined WHERE condition expression
@@ -364,9 +364,9 @@ export declare const expr: {
364
364
  */
365
365
  or(conditions: WhereExprUnit[]): WhereExprUnit;
366
366
  /**
367
- * String concatenation (CONCAT)
367
+ * 문자열 연결 (CONCAT)
368
368
  *
369
- * NULL values are treated as empty strings (auto-transformed per DBMS)
369
+ * NULL 값은 문자열로 처리 (DBMS별 자동 변환)
370
370
  *
371
371
  * @param args - Strings to concatenate
372
372
  * @returns Concatenated string expression
@@ -381,7 +381,7 @@ export declare const expr: {
381
381
  */
382
382
  concat(...args: ExprInput<string | undefined>[]): ExprUnit<string>;
383
383
  /**
384
- * Extract specified length from the left of a string (LEFT)
384
+ * 문자열 왼쪽에서 지정 길이만큼 추출 (LEFT)
385
385
  *
386
386
  * @param source - Original string
387
387
  * @param length - Number of characters to extract
@@ -397,7 +397,7 @@ export declare const expr: {
397
397
  */
398
398
  left<T extends string | undefined>(source: ExprUnit<T>, length: ExprInput<number>): ExprUnit<T>;
399
399
  /**
400
- * Extract specified length from the right of a string (RIGHT)
400
+ * 문자열 오른쪽에서 지정 길이만큼 추출 (RIGHT)
401
401
  *
402
402
  * @param source - Original string
403
403
  * @param length - Number of characters to extract
@@ -413,7 +413,7 @@ export declare const expr: {
413
413
  */
414
414
  right<T extends string | undefined>(source: ExprUnit<T>, length: ExprInput<number>): ExprUnit<T>;
415
415
  /**
416
- * Remove whitespace from both sides of a string (TRIM)
416
+ * 문자열 양쪽 공백 제거 (TRIM)
417
417
  *
418
418
  * @param source - Original string
419
419
  * @returns String expression with whitespace removed
@@ -428,9 +428,9 @@ export declare const expr: {
428
428
  */
429
429
  trim<T extends string | undefined>(source: ExprUnit<T>): ExprUnit<T>;
430
430
  /**
431
- * Left padding (LPAD)
431
+ * 왼쪽 패딩 (LPAD)
432
432
  *
433
- * Repeatedly adds fillString on the left until the target length is reached
433
+ * 대상 길이에 도달할 때까지 왼쪽에 fillString을 반복 추가
434
434
  *
435
435
  * @param source - Original string
436
436
  * @param length - Target length
@@ -448,7 +448,7 @@ export declare const expr: {
448
448
  */
449
449
  padStart<T extends string | undefined>(source: ExprUnit<T>, length: ExprInput<number>, fillString: ExprInput<string>): ExprUnit<T>;
450
450
  /**
451
- * String replacement (REPLACE)
451
+ * 문자열 치환 (REPLACE)
452
452
  *
453
453
  * @param source - Original string
454
454
  * @param from - String to find
@@ -465,7 +465,7 @@ export declare const expr: {
465
465
  */
466
466
  replace<T extends string | undefined>(source: ExprUnit<T>, from: ExprInput<string>, to: ExprInput<string>): ExprUnit<T>;
467
467
  /**
468
- * Convert string to uppercase (UPPER)
468
+ * 문자열 대문자 변환 (UPPER)
469
469
  *
470
470
  * @param source - Original string
471
471
  * @returns Uppercase string expression
@@ -480,7 +480,7 @@ export declare const expr: {
480
480
  */
481
481
  upper<T extends string | undefined>(source: ExprUnit<T>): ExprUnit<T>;
482
482
  /**
483
- * Convert string to lowercase (LOWER)
483
+ * 문자열 소문자 변환 (LOWER)
484
484
  *
485
485
  * @param source - Original string
486
486
  * @returns Lowercase string expression
@@ -495,7 +495,7 @@ export declare const expr: {
495
495
  */
496
496
  lower<T extends string | undefined>(source: ExprUnit<T>): ExprUnit<T>;
497
497
  /**
498
- * String length (character count)
498
+ * 문자열 길이 (문자 )
499
499
  *
500
500
  * @param source - Original string
501
501
  * @returns Character count
@@ -510,9 +510,9 @@ export declare const expr: {
510
510
  */
511
511
  length(source: ExprUnit<string | undefined>): ExprUnit<number>;
512
512
  /**
513
- * String byte length
513
+ * 문자열 바이트 길이
514
514
  *
515
- * In UTF-8, CJK characters are 3 bytes each
515
+ * UTF-8에서 CJK 문자는 3바이트
516
516
  *
517
517
  * @param source - Original string
518
518
  * @returns Byte count
@@ -527,9 +527,9 @@ export declare const expr: {
527
527
  */
528
528
  byteLength(source: ExprUnit<string | undefined>): ExprUnit<number>;
529
529
  /**
530
- * Extract part of a string (SUBSTRING)
530
+ * 문자열 부분 추출 (SUBSTRING)
531
531
  *
532
- * Uses 1-based index per SQL standard
532
+ * SQL 표준에 따라 1부터 시작하는 인덱스 사용
533
533
  *
534
534
  * @param source - Original string
535
535
  * @param start - Start position (starting from 1)
@@ -547,9 +547,9 @@ export declare const expr: {
547
547
  */
548
548
  substring<T extends string | undefined>(source: ExprUnit<T>, start: ExprInput<number>, length?: ExprInput<number>): ExprUnit<T>;
549
549
  /**
550
- * Find position within a string (LOCATE/CHARINDEX)
550
+ * 문자열 위치 찾기 (LOCATE/CHARINDEX)
551
551
  *
552
- * Returns 1-based index, or 0 if not found
552
+ * 1부터 시작하는 인덱스 반환, 찾지 못하면 0 반환
553
553
  *
554
554
  * @param source - String to search in
555
555
  * @param search - String to find
@@ -566,7 +566,7 @@ export declare const expr: {
566
566
  */
567
567
  indexOf(source: ExprUnit<string | undefined>, search: ExprInput<string>): ExprUnit<number>;
568
568
  /**
569
- * Absolute value (ABS)
569
+ * 절대값 (ABS)
570
570
  *
571
571
  * @param source - Original number
572
572
  * @returns Absolute value expression
@@ -581,7 +581,7 @@ export declare const expr: {
581
581
  */
582
582
  abs<T extends number | undefined>(source: ExprUnit<T>): ExprUnit<T>;
583
583
  /**
584
- * Round (ROUND)
584
+ * 반올림 (ROUND)
585
585
  *
586
586
  * @param source - Original number
587
587
  * @param digits - Number of decimal places
@@ -598,7 +598,7 @@ export declare const expr: {
598
598
  */
599
599
  round<T extends number | undefined>(source: ExprUnit<T>, digits: number): ExprUnit<T>;
600
600
  /**
601
- * Ceiling (CEILING)
601
+ * 올림 (CEILING)
602
602
  *
603
603
  * @param source - Original number
604
604
  * @returns Ceiling number expression
@@ -614,7 +614,7 @@ export declare const expr: {
614
614
  */
615
615
  ceil<T extends number | undefined>(source: ExprUnit<T>): ExprUnit<T>;
616
616
  /**
617
- * Floor (FLOOR)
617
+ * 내림 (FLOOR)
618
618
  *
619
619
  * @param source - Original number
620
620
  * @returns Floor number expression
@@ -630,7 +630,7 @@ export declare const expr: {
630
630
  */
631
631
  floor<T extends number | undefined>(source: ExprUnit<T>): ExprUnit<T>;
632
632
  /**
633
- * Extract year (YEAR)
633
+ * 연도 추출 (YEAR)
634
634
  *
635
635
  * @param source - DateTime or DateOnly expression
636
636
  * @returns Year (4-digit number)
@@ -645,7 +645,7 @@ export declare const expr: {
645
645
  */
646
646
  year<T extends DateTime | DateOnly | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
647
647
  /**
648
- * Extract month (MONTH)
648
+ * 추출 (MONTH)
649
649
  *
650
650
  * @param source - DateTime or DateOnly expression
651
651
  * @returns Month (1~12)
@@ -660,7 +660,7 @@ export declare const expr: {
660
660
  */
661
661
  month<T extends DateTime | DateOnly | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
662
662
  /**
663
- * Extract day (DAY)
663
+ * 추출 (DAY)
664
664
  *
665
665
  * @param source - DateTime or DateOnly expression
666
666
  * @returns Day (1~31)
@@ -675,7 +675,7 @@ export declare const expr: {
675
675
  */
676
676
  day<T extends DateTime | DateOnly | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
677
677
  /**
678
- * Extract hour (HOUR)
678
+ * 추출 (HOUR)
679
679
  *
680
680
  * @param source - DateTime or Time expression
681
681
  * @returns Hour (0~23)
@@ -690,7 +690,7 @@ export declare const expr: {
690
690
  */
691
691
  hour<T extends DateTime | Time | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
692
692
  /**
693
- * Extract minute (MINUTE)
693
+ * 추출 (MINUTE)
694
694
  *
695
695
  * @param source - DateTime or Time expression
696
696
  * @returns Minute (0~59)
@@ -705,7 +705,7 @@ export declare const expr: {
705
705
  */
706
706
  minute<T extends DateTime | Time | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
707
707
  /**
708
- * Extract second (SECOND)
708
+ * 추출 (SECOND)
709
709
  *
710
710
  * @param source - DateTime or Time expression
711
711
  * @returns Second (0~59)
@@ -720,7 +720,7 @@ export declare const expr: {
720
720
  */
721
721
  second<T extends DateTime | Time | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
722
722
  /**
723
- * Extract ISO week number
723
+ * ISO 번호 추출
724
724
  *
725
725
  * ISO 8601 week number (starts Monday, 1~53)
726
726
  *
@@ -739,7 +739,7 @@ export declare const expr: {
739
739
  /**
740
740
  * ISO week start date (Monday)
741
741
  *
742
- * Returns the Monday of the week the given date belongs to
742
+ * 주어진 날짜가 속한 주의 월요일 반환
743
743
  *
744
744
  * @param source - DateOnly expression
745
745
  * @returns Week start date (Monday)
@@ -756,7 +756,7 @@ export declare const expr: {
756
756
  /**
757
757
  * ISO year-month (first day of the month)
758
758
  *
759
- * Returns the first day of the month for the given date
759
+ * 주어진 날짜의 해당 첫째 반환
760
760
  *
761
761
  * @param source - DateOnly expression
762
762
  * @returns First day of the month
@@ -771,7 +771,7 @@ export declare const expr: {
771
771
  */
772
772
  isoYearMonth<T extends DateOnly | undefined>(source: ExprUnit<T>): ExprUnit<T>;
773
773
  /**
774
- * Calculate date difference (DATEDIFF)
774
+ * 날짜 차이 계산 (DATEDIFF)
775
775
  *
776
776
  * @param unit - Unit ("year", "month", "day", "hour", "minute", "second")
777
777
  * @param from - Start date
@@ -788,7 +788,7 @@ export declare const expr: {
788
788
  */
789
789
  dateDiff<T extends DateTime | DateOnly | Time | undefined>(unit: DateUnit, from: ExprInput<T>, to: ExprInput<T>): ExprUnit<T extends undefined ? undefined : number>;
790
790
  /**
791
- * Add to date (DATEADD)
791
+ * 날짜 더하기 (DATEADD)
792
792
  *
793
793
  * @param unit - Unit ("year", "month", "day", "hour", "minute", "second")
794
794
  * @param source - Original date
@@ -805,9 +805,9 @@ export declare const expr: {
805
805
  */
806
806
  dateAdd<T extends DateTime | DateOnly | Time | undefined>(unit: DateUnit, source: ExprUnit<T>, value: ExprInput<number>): ExprUnit<T>;
807
807
  /**
808
- * Date format (DATE_FORMAT)
808
+ * 날짜 포맷 (DATE_FORMAT)
809
809
  *
810
- * Format string rules may differ between DBMS implementations
810
+ * 포맷 문자열 규칙은 DBMS 구현에 따라 다를 수 있음
811
811
  *
812
812
  * @param source - Date expression
813
813
  * @param format - Format string (e.g., "%Y-%m-%d")
@@ -826,7 +826,7 @@ export declare const expr: {
826
826
  /**
827
827
  * NULL replacement (COALESCE/IFNULL)
828
828
  *
829
- * Returns the first non-null value. If the last argument is non-nullable, the result is also non-nullable
829
+ * 번째 non-null 반환. 마지막 인수가 non-nullable이면 결과도 non-nullable
830
830
  *
831
831
  * @param args - Values to inspect (last is default value)
832
832
  * @returns First non-null value
@@ -841,9 +841,9 @@ export declare const expr: {
841
841
  */
842
842
  coalesce: typeof coalesce;
843
843
  /**
844
- * Return NULL if value matches (NULLIF)
844
+ * 값이 일치하면 NULL 반환 (NULLIF)
845
845
  *
846
- * Returns NULL if source === value, otherwise returns source
846
+ * source === value이면 NULL 반환, 아니면 source 반환
847
847
  *
848
848
  * @param source - Original value
849
849
  * @param value - Value to compare
@@ -860,9 +860,9 @@ export declare const expr: {
860
860
  */
861
861
  nullIf<T extends ColumnPrimitive>(source: ExprUnit<T>, value: ExprInput<T>): ExprUnit<T | undefined>;
862
862
  /**
863
- * Transform WHERE expression to boolean
863
+ * WHERE expression boolean으로 변환
864
864
  *
865
- * Used when condition results should be used as a boolean column in SELECT clause
865
+ * 조건 결과를 SELECT 절에서 boolean column으로 사용할 사용
866
866
  *
867
867
  * @param condition - Condition to transform
868
868
  * @returns boolean expression
@@ -879,7 +879,7 @@ export declare const expr: {
879
879
  /**
880
880
  * CASE WHEN expression builder
881
881
  *
882
- * Build conditional branches using method chaining
882
+ * 메서드 체이닝으로 조건 분기 구성
883
883
  *
884
884
  * @returns SwitchExprBuilder instance
885
885
  *
@@ -897,7 +897,7 @@ export declare const expr: {
897
897
  */
898
898
  switch<T extends ColumnPrimitive>(): SwitchExprBuilder<T>;
899
899
  /**
900
- * Simple IF condition (ternary operator)
900
+ * 단순 IF 조건 (삼항 연산자)
901
901
  *
902
902
  * @param condition - Condition
903
903
  * @param then - Value when condition is true
@@ -914,7 +914,7 @@ export declare const expr: {
914
914
  */
915
915
  if<T extends ColumnPrimitive>(condition: WhereExprUnit, then: ExprInput<T>, else_: ExprInput<T>): ExprUnit<T>;
916
916
  /**
917
- * Count rows (COUNT)
917
+ * 세기 (COUNT)
918
918
  *
919
919
  * @param arg - Column to count (all rows if omitted)
920
920
  * @param distinct - If true, remove duplicates
@@ -933,7 +933,7 @@ export declare const expr: {
933
933
  */
934
934
  count(arg?: ExprUnit<ColumnPrimitive>, distinct?: boolean): ExprUnit<number>;
935
935
  /**
936
- * Sum (SUM)
936
+ * 합계 (SUM)
937
937
  *
938
938
  * NULL values are ignored. Returns NULL if all values are NULL
939
939
  *
@@ -950,7 +950,7 @@ export declare const expr: {
950
950
  */
951
951
  sum(arg: ExprUnit<number | undefined>): ExprUnit<number | undefined>;
952
952
  /**
953
- * Average (AVG)
953
+ * 평균 (AVG)
954
954
  *
955
955
  * NULL values are ignored. Returns NULL if all values are NULL
956
956
  *
@@ -967,7 +967,7 @@ export declare const expr: {
967
967
  */
968
968
  avg(arg: ExprUnit<number | undefined>): ExprUnit<number | undefined>;
969
969
  /**
970
- * Maximum value (MAX)
970
+ * 최대값 (MAX)
971
971
  *
972
972
  * NULL values are ignored. Returns NULL if all values are NULL
973
973
  *
@@ -984,7 +984,7 @@ export declare const expr: {
984
984
  */
985
985
  max<T extends ColumnPrimitive>(arg: ExprUnit<T>): ExprUnit<T | undefined>;
986
986
  /**
987
- * Minimum value (MIN)
987
+ * 최소값 (MIN)
988
988
  *
989
989
  * NULL values are ignored. Returns NULL if all values are NULL
990
990
  *
@@ -1001,7 +1001,7 @@ export declare const expr: {
1001
1001
  */
1002
1002
  min<T extends ColumnPrimitive>(arg: ExprUnit<T>): ExprUnit<T | undefined>;
1003
1003
  /**
1004
- * Greatest value among multiple values (GREATEST)
1004
+ * 여러 최대값 선택 (GREATEST)
1005
1005
  *
1006
1006
  * @param args - Values to compare
1007
1007
  * @returns Greatest value
@@ -1016,7 +1016,7 @@ export declare const expr: {
1016
1016
  */
1017
1017
  greatest<T extends ColumnPrimitive>(...args: ExprInput<T>[]): ExprUnit<T>;
1018
1018
  /**
1019
- * Least value among multiple values (LEAST)
1019
+ * 여러 최소값 선택 (LEAST)
1020
1020
  *
1021
1021
  * @param args - Values to compare
1022
1022
  * @returns Least value
@@ -1031,7 +1031,7 @@ export declare const expr: {
1031
1031
  */
1032
1032
  least<T extends ColumnPrimitive>(...args: ExprInput<T>[]): ExprUnit<T>;
1033
1033
  /**
1034
- * Row number (sequential number for all rows without ROW_NUMBER)
1034
+ * 번호 (ROW_NUMBER 없이 모든 행에 순번 부여)
1035
1035
  *
1036
1036
  * @returns Row number (starting from 1)
1037
1037
  *
@@ -1045,9 +1045,9 @@ export declare const expr: {
1045
1045
  */
1046
1046
  rowNum(): ExprUnit<number>;
1047
1047
  /**
1048
- * Generate random number (RAND/RANDOM)
1048
+ * 난수 생성 (RAND/RANDOM)
1049
1049
  *
1050
- * Returns a random number between 0 and 1. Mainly used for random ordering in ORDER BY
1050
+ * 0 1 사이의 난수 반환. 주로 ORDER BY에서 무작위 정렬에 사용
1051
1051
  *
1052
1052
  * @returns Random number between 0 and 1
1053
1053
  *
@@ -1075,9 +1075,9 @@ export declare const expr: {
1075
1075
  */
1076
1076
  cast<T extends ColumnPrimitive, TDataType extends DataType>(source: ExprUnit<T>, targetType: TDataType): ExprUnit<T extends undefined ? undefined : InferColumnPrimitiveFromDataType<TDataType>>;
1077
1077
  /**
1078
- * Scalar Subquery - Subquery that returns a single value in SELECT clause
1078
+ * 스칼라 Subquery - SELECT 절에서 단일 값을 반환하는 서브쿼리
1079
1079
  *
1080
- * The subquery must return exactly one row and one column
1080
+ * 서브쿼리는 정확히 하나의 행과 하나의 column을 반환해야
1081
1081
  *
1082
1082
  * @param dataType - Data type of the returned value
1083
1083
  * @param queryable - Queryable that returns a scalar value
@@ -1103,7 +1103,7 @@ export declare const expr: {
1103
1103
  /**
1104
1104
  * ROW_NUMBER() - Row number within a partition
1105
1105
  *
1106
- * Assigns sequential numbers starting from 1 within each partition
1106
+ * 파티션 내에서 1부터 시작하는 순번 부여
1107
1107
  *
1108
1108
  * @param spec - Window spec (partitionBy, orderBy)
1109
1109
  * @returns Row number (starting from 1)
@@ -1355,7 +1355,7 @@ export declare const expr: {
1355
1355
  */
1356
1356
  maxOver<T extends ColumnPrimitive>(column: ExprUnit<T>, spec: WinSpecInput): ExprUnit<T | undefined>;
1357
1357
  /**
1358
- * Transform ExprInput to Expr (internal use)
1358
+ * ExprInput Expr 변환 (내부 사용)
1359
1359
  *
1360
1360
  * @param value - Value to transform
1361
1361
  * @returns Expr JSON AST