@relq/orm 0.1.3 → 0.1.5

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 (412) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +33 -224
  3. package/dist/cjs/addon/cursor.cjs +2 -1407
  4. package/dist/cjs/addon/mysql2.cjs +21143 -0
  5. package/dist/cjs/addon/pg.cjs +5 -5
  6. package/dist/cjs/cache/query-cache.cjs +1 -4
  7. package/dist/cjs/core/cte/cte-accessor.cjs +80 -0
  8. package/dist/cjs/core/cte/cte-types.cjs +24 -0
  9. package/dist/cjs/core/cte/native-cte-builder.cjs +254 -0
  10. package/dist/cjs/core/helpers/index.cjs +14 -14
  11. package/dist/cjs/core/relq-base.cjs +4 -88
  12. package/dist/cjs/core/relq-client.cjs +59 -41
  13. package/dist/cjs/core/shared/column-mapping.cjs +1 -1
  14. package/dist/cjs/core/shared/table-accessor.cjs +1 -1
  15. package/dist/cjs/core/shared/where.cjs +15 -0
  16. package/dist/cjs/index.cjs +40 -5
  17. package/dist/cjs/mysql/clients/index.cjs +17 -0
  18. package/dist/cjs/mysql/clients/mariadb-client/capabilities.cjs +31 -0
  19. package/dist/cjs/mysql/clients/mariadb-client/index.cjs +7 -0
  20. package/dist/cjs/mysql/clients/mariadb-client/relq-mariadb.cjs +14 -0
  21. package/dist/cjs/mysql/clients/mysql-client/capabilities.cjs +31 -0
  22. package/dist/cjs/mysql/clients/mysql-client/index.cjs +7 -0
  23. package/dist/cjs/mysql/clients/mysql-client/relq-mysql.cjs +14 -0
  24. package/dist/cjs/mysql/clients/planetscale-client/capabilities.cjs +31 -0
  25. package/dist/cjs/mysql/clients/planetscale-client/index.cjs +7 -0
  26. package/dist/cjs/mysql/clients/planetscale-client/relq-planetscale.cjs +32 -0
  27. package/dist/cjs/mysql/clients/shared/index.cjs +32 -0
  28. package/dist/cjs/mysql/clients/shared/mysql-base.cjs +362 -0
  29. package/dist/cjs/mysql/clients/shared/mysql-dialect.cjs +141 -0
  30. package/dist/cjs/mysql/clients/shared/mysql-error-parser.cjs +195 -0
  31. package/dist/cjs/mysql/clients/shared/mysql-format.cjs +95 -0
  32. package/dist/cjs/mysql/clients/shared/mysql-type-coercion.cjs +14 -0
  33. package/dist/cjs/mysql/condition/condition-collector.cjs +377 -0
  34. package/dist/cjs/mysql/condition/fulltext-condition-builder.cjs +63 -0
  35. package/dist/cjs/mysql/condition/index.cjs +16 -0
  36. package/dist/cjs/mysql/condition/json-condition-builder.cjs +144 -0
  37. package/dist/cjs/mysql/condition/json-path-proxy.cjs +520 -0
  38. package/dist/cjs/mysql/count/count-builder.cjs +109 -0
  39. package/dist/cjs/mysql/count/index.cjs +5 -0
  40. package/dist/cjs/mysql/delete/delete-builder.cjs +105 -0
  41. package/dist/cjs/mysql/delete/index.cjs +5 -0
  42. package/dist/cjs/mysql/explain/explain-builder.cjs +43 -0
  43. package/dist/cjs/mysql/explain/index.cjs +5 -0
  44. package/dist/cjs/mysql/helpers/MysqlConnectedAggregateBuilder.cjs +132 -0
  45. package/dist/cjs/mysql/helpers/MysqlConnectedCountBuilder.cjs +83 -0
  46. package/dist/cjs/mysql/helpers/MysqlConnectedDeleteBuilder.cjs +91 -0
  47. package/dist/cjs/mysql/helpers/MysqlConnectedInsertBuilder.cjs +75 -0
  48. package/dist/cjs/mysql/helpers/MysqlConnectedInsertFromSelectBuilder.cjs +57 -0
  49. package/dist/cjs/mysql/helpers/MysqlConnectedQueryBuilder.cjs +141 -0
  50. package/dist/cjs/mysql/helpers/MysqlConnectedRawQueryBuilder.cjs +60 -0
  51. package/dist/cjs/mysql/helpers/MysqlConnectedSelectBuilder.cjs +398 -0
  52. package/dist/cjs/mysql/helpers/MysqlConnectedTransactionBuilder.cjs +128 -0
  53. package/dist/cjs/mysql/helpers/MysqlConnectedUpdateBuilder.cjs +92 -0
  54. package/dist/cjs/mysql/helpers/MysqlPaginateBuilder.cjs +186 -0
  55. package/dist/cjs/mysql/helpers/MysqlReturningExecutor.cjs +69 -0
  56. package/dist/cjs/mysql/helpers/index.cjs +45 -0
  57. package/dist/cjs/mysql/helpers/query-convenience.cjs +210 -0
  58. package/dist/cjs/mysql/helpers/select-joins.cjs +465 -0
  59. package/dist/cjs/mysql/helpers/select-pagination.cjs +190 -0
  60. package/dist/cjs/mysql/index.cjs +154 -0
  61. package/dist/cjs/mysql/insert/duplicate-key-builder.cjs +185 -0
  62. package/dist/cjs/mysql/insert/index.cjs +13 -0
  63. package/dist/cjs/mysql/insert/insert-builder.cjs +169 -0
  64. package/dist/cjs/mysql/insert/insert-from-select-builder.cjs +74 -0
  65. package/dist/cjs/mysql/raw/index.cjs +8 -0
  66. package/dist/cjs/mysql/raw/raw-query-builder.cjs +27 -0
  67. package/dist/cjs/mysql/raw/sql-template.cjs +65 -0
  68. package/dist/cjs/mysql/select/aggregate-builder.cjs +211 -0
  69. package/dist/cjs/mysql/select/index.cjs +32 -0
  70. package/dist/cjs/mysql/select/join-builder.cjs +206 -0
  71. package/dist/cjs/mysql/select/join-condition-builder.cjs +205 -0
  72. package/dist/cjs/mysql/select/join-internals.cjs +5 -0
  73. package/dist/cjs/mysql/select/scalar-query-builder.cjs +164 -0
  74. package/dist/cjs/mysql/select/scalar-select-builder.cjs +78 -0
  75. package/dist/cjs/mysql/select/select-builder.cjs +414 -0
  76. package/dist/cjs/mysql/select/sql-expression.cjs +56 -0
  77. package/dist/cjs/mysql/select/table-proxy.cjs +99 -0
  78. package/dist/cjs/mysql/shared/mysql-table-accessor.cjs +22 -0
  79. package/dist/cjs/mysql/transaction/index.cjs +6 -0
  80. package/dist/cjs/mysql/transaction/transaction-builder.cjs +64 -0
  81. package/dist/cjs/mysql/update/column-expression-builder.cjs +49 -0
  82. package/dist/cjs/mysql/update/index.cjs +7 -0
  83. package/dist/cjs/mysql/update/mysql-json-update-builder.cjs +200 -0
  84. package/dist/cjs/mysql/update/update-builder.cjs +167 -0
  85. package/dist/cjs/mysql/utils/addon/mysql/mysql2.cjs +23 -0
  86. package/dist/cjs/mysql/utils/fk-resolver.cjs +187 -0
  87. package/dist/cjs/mysql/utils/index.cjs +16 -0
  88. package/dist/cjs/mysql/utils/type-coercion.cjs +158 -0
  89. package/dist/cjs/mysql/window/index.cjs +5 -0
  90. package/dist/cjs/mysql/window/window-builder.cjs +80 -0
  91. package/dist/cjs/pg/clients/alloydb-client/capabilities.cjs +31 -0
  92. package/dist/cjs/pg/clients/alloydb-client/index.cjs +7 -0
  93. package/dist/cjs/pg/clients/alloydb-client/relq-alloydb.cjs +43 -0
  94. package/dist/cjs/pg/clients/aurora-client/capabilities.cjs +31 -0
  95. package/dist/cjs/pg/clients/aurora-client/index.cjs +7 -0
  96. package/dist/cjs/pg/clients/aurora-client/relq-aurora.cjs +43 -0
  97. package/dist/cjs/pg/clients/citus-client/capabilities.cjs +31 -0
  98. package/dist/cjs/pg/clients/citus-client/index.cjs +7 -0
  99. package/dist/cjs/pg/clients/citus-client/relq-citus.cjs +43 -0
  100. package/dist/cjs/pg/clients/neon-client/capabilities.cjs +31 -0
  101. package/dist/cjs/pg/clients/neon-client/index.cjs +7 -0
  102. package/dist/cjs/pg/clients/neon-client/relq-neon.cjs +43 -0
  103. package/dist/cjs/pg/clients/pg-client/relq-postgres.cjs +56 -0
  104. package/dist/cjs/{core/pg-family → pg/clients}/shared/pg-base.cjs +64 -7
  105. package/dist/cjs/{core/pg-family → pg/clients}/shared/pg-type-coercion.cjs +1 -1
  106. package/dist/cjs/pg/clients/supabase-client/capabilities.cjs +31 -0
  107. package/dist/cjs/pg/clients/supabase-client/index.cjs +7 -0
  108. package/dist/cjs/{core/pg-family/pg-client/relq-postgres.cjs → pg/clients/supabase-client/relq-supabase.cjs} +9 -9
  109. package/dist/cjs/pg/clients/timescale-client/capabilities.cjs +31 -0
  110. package/dist/cjs/pg/clients/timescale-client/index.cjs +7 -0
  111. package/dist/cjs/pg/clients/timescale-client/relq-timescale.cjs +43 -0
  112. package/dist/cjs/pg/clients/yugabytedb-client/capabilities.cjs +31 -0
  113. package/dist/cjs/pg/clients/yugabytedb-client/index.cjs +7 -0
  114. package/dist/cjs/pg/clients/yugabytedb-client/relq-yugabytedb.cjs +16 -0
  115. package/dist/cjs/{condition → pg/condition}/array-condition-builder.cjs +1 -1
  116. package/dist/cjs/pg/condition/array-path-proxy.cjs +379 -0
  117. package/dist/cjs/{condition → pg/condition}/condition-collector.cjs +18 -9
  118. package/dist/cjs/{condition → pg/condition}/fulltext-condition-builder.cjs +1 -1
  119. package/dist/cjs/{condition → pg/condition}/geometric-condition-builder.cjs +1 -1
  120. package/dist/cjs/pg/condition/json-path-proxy.cjs +480 -0
  121. package/dist/cjs/{condition → pg/condition}/jsonb-condition-builder.cjs +1 -1
  122. package/dist/cjs/{condition → pg/condition}/network-condition-builder.cjs +1 -1
  123. package/dist/cjs/{condition → pg/condition}/postgis-condition-builder.cjs +1 -1
  124. package/dist/cjs/{condition → pg/condition}/range-condition-builder.cjs +1 -1
  125. package/dist/cjs/{count → pg/count}/count-builder.cjs +10 -5
  126. package/dist/cjs/{delete → pg/delete}/delete-builder.cjs +10 -5
  127. package/dist/cjs/{core → pg}/helpers/ConnectedAggregateBuilder.cjs +16 -3
  128. package/dist/cjs/{core → pg}/helpers/ConnectedCountBuilder.cjs +16 -3
  129. package/dist/cjs/{core → pg}/helpers/ConnectedDeleteBuilder.cjs +27 -7
  130. package/dist/cjs/{core → pg}/helpers/ConnectedInsertBuilder.cjs +16 -8
  131. package/dist/cjs/{core → pg}/helpers/ConnectedInsertFromSelectBuilder.cjs +9 -5
  132. package/dist/cjs/{core → pg}/helpers/ConnectedQueryBuilder.cjs +14 -19
  133. package/dist/cjs/pg/helpers/ConnectedRawQueryBuilder.cjs +67 -0
  134. package/dist/cjs/{core → pg}/helpers/ConnectedSelectBuilder.cjs +121 -25
  135. package/dist/cjs/{core → pg}/helpers/ConnectedTransactionBuilder.cjs +34 -4
  136. package/dist/cjs/{core → pg}/helpers/ConnectedUpdateBuilder.cjs +27 -7
  137. package/dist/cjs/{core → pg}/helpers/PaginateBuilder.cjs +3 -3
  138. package/dist/cjs/{core → pg}/helpers/ReturningExecutor.cjs +3 -3
  139. package/dist/cjs/{core → pg}/helpers/query-convenience.cjs +11 -12
  140. package/dist/cjs/{core → pg}/helpers/select-joins.cjs +17 -14
  141. package/dist/cjs/{core → pg}/helpers/select-pagination.cjs +1 -1
  142. package/dist/cjs/{insert → pg/insert}/conflict-builder.cjs +2 -2
  143. package/dist/cjs/{insert → pg/insert}/insert-builder.cjs +8 -5
  144. package/dist/cjs/{insert → pg/insert}/insert-from-select-builder.cjs +1 -1
  145. package/dist/cjs/{pubsub → pg/pubsub}/listen-notify-builder.cjs +1 -1
  146. package/dist/cjs/{pubsub → pg/pubsub}/listener-connection.cjs +2 -2
  147. package/dist/cjs/{raw → pg/raw}/raw-query-builder.cjs +2 -2
  148. package/dist/cjs/{raw → pg/raw}/sql-template.cjs +1 -6
  149. package/dist/cjs/{select → pg/select}/aggregate-builder.cjs +10 -5
  150. package/dist/cjs/{select → pg/select}/join-builder.cjs +2 -2
  151. package/dist/cjs/{select → pg/select}/join-condition-builder.cjs +11 -1
  152. package/dist/cjs/{select → pg/select}/join-many-condition-builder.cjs +3 -4
  153. package/dist/cjs/{select → pg/select}/scalar-query-builder.cjs +31 -1
  154. package/dist/cjs/{select → pg/select}/scalar-select-builder.cjs +1 -1
  155. package/dist/cjs/{select → pg/select}/select-builder.cjs +40 -7
  156. package/dist/cjs/pg/select/sql-expression.cjs +56 -0
  157. package/dist/cjs/{transaction → pg/transaction}/transaction-builder.cjs +1 -1
  158. package/dist/cjs/{update → pg/update}/array-update-builder.cjs +2 -5
  159. package/dist/cjs/pg/update/column-expression-builder.cjs +49 -0
  160. package/dist/cjs/{update → pg/update}/jsonb-update-builder.cjs +1 -1
  161. package/dist/cjs/{update → pg/update}/update-builder.cjs +14 -7
  162. package/dist/cjs/{utils → pg/utils}/addon/pg/cursor.cjs +1 -1
  163. package/dist/cjs/{utils → pg/utils}/addon/pg/pg.cjs +2 -2
  164. package/dist/cjs/{utils → pg/utils}/fk-resolver.cjs +47 -30
  165. package/dist/cjs/{window → pg/window}/window-builder.cjs +1 -1
  166. package/dist/cjs/shared/errors/relq-errors.cjs +496 -35
  167. package/dist/cjs/shared/types/config-types.cjs +2 -2
  168. package/dist/cjs/utils/env-resolver.cjs +76 -13
  169. package/dist/cjs/utils/index.cjs +1 -1
  170. package/dist/esm/addon/cursor.js +1 -1438
  171. package/dist/esm/addon/mysql2.js +21129 -0
  172. package/dist/esm/addon/pg.js +5 -5
  173. package/dist/esm/cache/query-cache.js +1 -4
  174. package/dist/esm/core/cte/cte-accessor.js +75 -0
  175. package/dist/esm/core/cte/cte-types.js +20 -0
  176. package/dist/esm/core/cte/native-cte-builder.js +250 -0
  177. package/dist/esm/core/helpers/index.js +12 -12
  178. package/dist/esm/core/relq-base.js +5 -56
  179. package/dist/esm/core/relq-client.js +54 -32
  180. package/dist/esm/core/shared/column-mapping.js +1 -1
  181. package/dist/esm/core/shared/table-accessor.js +1 -1
  182. package/dist/esm/core/shared/where.js +12 -0
  183. package/dist/esm/index.js +17 -5
  184. package/dist/esm/mysql/clients/index.js +5 -0
  185. package/dist/esm/mysql/clients/mariadb-client/capabilities.js +28 -0
  186. package/dist/esm/mysql/clients/mariadb-client/index.js +2 -0
  187. package/dist/esm/mysql/clients/mariadb-client/relq-mariadb.js +10 -0
  188. package/dist/esm/mysql/clients/mysql-client/capabilities.js +28 -0
  189. package/dist/esm/mysql/clients/mysql-client/index.js +2 -0
  190. package/dist/esm/mysql/clients/mysql-client/relq-mysql.js +10 -0
  191. package/dist/esm/mysql/clients/planetscale-client/capabilities.js +28 -0
  192. package/dist/esm/mysql/clients/planetscale-client/index.js +2 -0
  193. package/dist/esm/mysql/clients/planetscale-client/relq-planetscale.js +28 -0
  194. package/dist/esm/mysql/clients/shared/index.js +7 -0
  195. package/dist/esm/mysql/clients/shared/mysql-base.js +321 -0
  196. package/dist/esm/mysql/clients/shared/mysql-dialect.js +136 -0
  197. package/dist/esm/mysql/clients/shared/mysql-error-parser.js +188 -0
  198. package/dist/esm/mysql/clients/shared/mysql-format.js +92 -0
  199. package/dist/esm/mysql/clients/shared/mysql-type-coercion.js +6 -0
  200. package/dist/esm/mysql/condition/condition-collector.js +368 -0
  201. package/dist/esm/mysql/condition/fulltext-condition-builder.js +55 -0
  202. package/dist/esm/mysql/condition/index.js +4 -0
  203. package/dist/esm/mysql/condition/json-condition-builder.js +136 -0
  204. package/dist/esm/mysql/condition/json-path-proxy.js +513 -0
  205. package/dist/esm/mysql/count/count-builder.js +102 -0
  206. package/dist/esm/mysql/count/index.js +1 -0
  207. package/dist/esm/mysql/delete/delete-builder.js +98 -0
  208. package/dist/esm/mysql/delete/index.js +1 -0
  209. package/dist/esm/mysql/explain/explain-builder.js +39 -0
  210. package/dist/esm/mysql/explain/index.js +1 -0
  211. package/dist/esm/mysql/helpers/MysqlConnectedAggregateBuilder.js +128 -0
  212. package/dist/esm/{core/helpers/ConnectedCountBuilder.js → mysql/helpers/MysqlConnectedCountBuilder.js} +15 -5
  213. package/dist/esm/mysql/helpers/MysqlConnectedDeleteBuilder.js +87 -0
  214. package/dist/esm/mysql/helpers/MysqlConnectedInsertBuilder.js +71 -0
  215. package/dist/esm/mysql/helpers/MysqlConnectedInsertFromSelectBuilder.js +53 -0
  216. package/dist/esm/mysql/helpers/MysqlConnectedQueryBuilder.js +137 -0
  217. package/dist/esm/mysql/helpers/MysqlConnectedRawQueryBuilder.js +56 -0
  218. package/dist/esm/mysql/helpers/MysqlConnectedSelectBuilder.js +391 -0
  219. package/dist/esm/mysql/helpers/MysqlConnectedTransactionBuilder.js +123 -0
  220. package/dist/esm/mysql/helpers/MysqlConnectedUpdateBuilder.js +88 -0
  221. package/dist/esm/mysql/helpers/MysqlPaginateBuilder.js +182 -0
  222. package/dist/esm/mysql/helpers/MysqlReturningExecutor.js +65 -0
  223. package/dist/esm/mysql/helpers/index.js +15 -0
  224. package/dist/esm/mysql/helpers/query-convenience.js +199 -0
  225. package/dist/esm/mysql/helpers/select-joins.js +455 -0
  226. package/dist/esm/mysql/helpers/select-pagination.js +186 -0
  227. package/dist/esm/mysql/index.js +47 -0
  228. package/dist/esm/mysql/insert/duplicate-key-builder.js +174 -0
  229. package/dist/esm/mysql/insert/index.js +3 -0
  230. package/dist/esm/mysql/insert/insert-builder.js +162 -0
  231. package/dist/esm/mysql/insert/insert-from-select-builder.js +67 -0
  232. package/dist/esm/mysql/raw/index.js +2 -0
  233. package/dist/esm/mysql/raw/raw-query-builder.js +20 -0
  234. package/dist/esm/mysql/raw/sql-template.js +58 -0
  235. package/dist/esm/mysql/select/aggregate-builder.js +204 -0
  236. package/dist/esm/mysql/select/index.js +9 -0
  237. package/dist/esm/mysql/select/join-builder.js +198 -0
  238. package/dist/esm/mysql/select/join-condition-builder.js +197 -0
  239. package/dist/esm/mysql/select/join-internals.js +2 -0
  240. package/dist/esm/mysql/select/scalar-query-builder.js +156 -0
  241. package/dist/esm/mysql/select/scalar-select-builder.js +70 -0
  242. package/dist/esm/mysql/select/select-builder.js +407 -0
  243. package/dist/esm/mysql/select/sql-expression.js +51 -0
  244. package/dist/esm/mysql/select/table-proxy.js +91 -0
  245. package/dist/esm/mysql/shared/mysql-table-accessor.js +19 -0
  246. package/dist/esm/mysql/transaction/index.js +1 -0
  247. package/dist/esm/mysql/transaction/transaction-builder.js +56 -0
  248. package/dist/esm/mysql/update/column-expression-builder.js +42 -0
  249. package/dist/esm/mysql/update/index.js +2 -0
  250. package/dist/esm/mysql/update/mysql-json-update-builder.js +193 -0
  251. package/dist/esm/mysql/update/update-builder.js +160 -0
  252. package/dist/esm/mysql/utils/addon/mysql/mysql2.js +2 -0
  253. package/dist/esm/mysql/utils/fk-resolver.js +179 -0
  254. package/dist/esm/mysql/utils/index.js +2 -0
  255. package/dist/esm/mysql/utils/type-coercion.js +150 -0
  256. package/dist/esm/mysql/window/index.js +1 -0
  257. package/dist/esm/mysql/window/window-builder.js +73 -0
  258. package/dist/esm/pg/clients/alloydb-client/capabilities.js +28 -0
  259. package/dist/esm/pg/clients/alloydb-client/index.js +2 -0
  260. package/dist/esm/{core/pg-family/pg-client/relq-postgres.js → pg/clients/alloydb-client/relq-alloydb.js} +8 -8
  261. package/dist/esm/pg/clients/aurora-client/capabilities.js +28 -0
  262. package/dist/esm/pg/clients/aurora-client/index.js +2 -0
  263. package/dist/esm/pg/clients/aurora-client/relq-aurora.js +39 -0
  264. package/dist/esm/pg/clients/citus-client/capabilities.js +28 -0
  265. package/dist/esm/pg/clients/citus-client/index.js +2 -0
  266. package/dist/esm/pg/clients/citus-client/relq-citus.js +39 -0
  267. package/dist/esm/pg/clients/neon-client/capabilities.js +28 -0
  268. package/dist/esm/pg/clients/neon-client/index.js +2 -0
  269. package/dist/esm/pg/clients/neon-client/relq-neon.js +39 -0
  270. package/dist/esm/pg/clients/pg-client/relq-postgres.js +52 -0
  271. package/dist/esm/{core/pg-family → pg/clients}/shared/pg-base.js +64 -7
  272. package/dist/esm/{core/pg-family → pg/clients}/shared/pg-type-coercion.js +1 -1
  273. package/dist/esm/pg/clients/supabase-client/capabilities.js +28 -0
  274. package/dist/esm/pg/clients/supabase-client/index.js +2 -0
  275. package/dist/esm/pg/clients/supabase-client/relq-supabase.js +39 -0
  276. package/dist/esm/pg/clients/timescale-client/capabilities.js +28 -0
  277. package/dist/esm/pg/clients/timescale-client/index.js +2 -0
  278. package/dist/esm/pg/clients/timescale-client/relq-timescale.js +39 -0
  279. package/dist/esm/pg/clients/yugabytedb-client/capabilities.js +28 -0
  280. package/dist/esm/pg/clients/yugabytedb-client/index.js +2 -0
  281. package/dist/esm/pg/clients/yugabytedb-client/relq-yugabytedb.js +12 -0
  282. package/dist/esm/{condition → pg/condition}/array-condition-builder.js +1 -1
  283. package/dist/esm/pg/condition/array-path-proxy.js +372 -0
  284. package/dist/esm/{condition → pg/condition}/condition-collector.js +20 -11
  285. package/dist/esm/{condition → pg/condition}/fulltext-condition-builder.js +1 -1
  286. package/dist/esm/{condition → pg/condition}/geometric-condition-builder.js +1 -1
  287. package/dist/esm/pg/condition/json-path-proxy.js +473 -0
  288. package/dist/esm/{condition → pg/condition}/jsonb-condition-builder.js +1 -1
  289. package/dist/esm/{condition → pg/condition}/network-condition-builder.js +1 -1
  290. package/dist/esm/{condition → pg/condition}/postgis-condition-builder.js +1 -1
  291. package/dist/esm/{condition → pg/condition}/range-condition-builder.js +1 -1
  292. package/dist/esm/{count → pg/count}/count-builder.js +10 -5
  293. package/dist/esm/{delete → pg/delete}/delete-builder.js +10 -5
  294. package/dist/esm/{core → pg}/helpers/ConnectedAggregateBuilder.js +16 -3
  295. package/dist/esm/pg/helpers/ConnectedCountBuilder.js +82 -0
  296. package/dist/esm/{core → pg}/helpers/ConnectedDeleteBuilder.js +27 -7
  297. package/dist/esm/{core → pg}/helpers/ConnectedInsertBuilder.js +16 -8
  298. package/dist/esm/{core → pg}/helpers/ConnectedInsertFromSelectBuilder.js +9 -5
  299. package/dist/esm/{core → pg}/helpers/ConnectedQueryBuilder.js +15 -20
  300. package/dist/esm/pg/helpers/ConnectedRawQueryBuilder.js +63 -0
  301. package/dist/esm/{core → pg}/helpers/ConnectedSelectBuilder.js +118 -25
  302. package/dist/esm/{core → pg}/helpers/ConnectedTransactionBuilder.js +34 -4
  303. package/dist/esm/{core → pg}/helpers/ConnectedUpdateBuilder.js +27 -7
  304. package/dist/esm/{core → pg}/helpers/PaginateBuilder.js +3 -3
  305. package/dist/esm/{core → pg}/helpers/ReturningExecutor.js +3 -3
  306. package/dist/esm/{core → pg}/helpers/query-convenience.js +11 -12
  307. package/dist/esm/{core → pg}/helpers/select-joins.js +18 -15
  308. package/dist/esm/{core → pg}/helpers/select-pagination.js +1 -1
  309. package/dist/esm/{insert → pg/insert}/conflict-builder.js +2 -2
  310. package/dist/esm/{insert → pg/insert}/insert-builder.js +8 -5
  311. package/dist/esm/{insert → pg/insert}/insert-from-select-builder.js +1 -1
  312. package/dist/esm/{pubsub → pg/pubsub}/listen-notify-builder.js +1 -1
  313. package/dist/esm/{pubsub → pg/pubsub}/listener-connection.js +2 -2
  314. package/dist/esm/{raw → pg/raw}/raw-query-builder.js +2 -2
  315. package/dist/esm/{raw → pg/raw}/sql-template.js +1 -6
  316. package/dist/esm/{select → pg/select}/aggregate-builder.js +10 -5
  317. package/dist/esm/{select → pg/select}/join-builder.js +2 -2
  318. package/dist/esm/{select → pg/select}/join-condition-builder.js +11 -1
  319. package/dist/esm/{select → pg/select}/join-many-condition-builder.js +3 -4
  320. package/dist/esm/{select → pg/select}/scalar-query-builder.js +31 -1
  321. package/dist/esm/{select → pg/select}/scalar-select-builder.js +1 -1
  322. package/dist/esm/{select → pg/select}/select-builder.js +40 -7
  323. package/dist/esm/pg/select/sql-expression.js +51 -0
  324. package/dist/esm/{transaction → pg/transaction}/transaction-builder.js +1 -1
  325. package/dist/esm/{update → pg/update}/array-update-builder.js +2 -5
  326. package/dist/esm/pg/update/column-expression-builder.js +42 -0
  327. package/dist/esm/{update → pg/update}/jsonb-update-builder.js +1 -1
  328. package/dist/esm/{update → pg/update}/update-builder.js +14 -7
  329. package/dist/esm/pg/utils/addon/pg/cursor.js +1 -0
  330. package/dist/esm/pg/utils/addon/pg/pg.js +2 -0
  331. package/dist/esm/{utils → pg/utils}/fk-resolver.js +47 -30
  332. package/dist/esm/{window → pg/window}/window-builder.js +1 -1
  333. package/dist/esm/shared/errors/relq-errors.js +486 -34
  334. package/dist/esm/shared/types/config-types.js +2 -2
  335. package/dist/esm/utils/env-resolver.js +74 -13
  336. package/dist/esm/utils/index.js +1 -1
  337. package/dist/index.d.ts +9629 -3974
  338. package/package.json +6 -3
  339. package/dist/cjs/core/helpers/ConnectedCTEBuilder.cjs +0 -53
  340. package/dist/cjs/core/helpers/ConnectedRawQueryBuilder.cjs +0 -46
  341. package/dist/cjs/select/sql-expression.cjs +0 -38
  342. package/dist/esm/core/helpers/ConnectedCTEBuilder.js +0 -49
  343. package/dist/esm/core/helpers/ConnectedRawQueryBuilder.js +0 -42
  344. package/dist/esm/select/sql-expression.js +0 -33
  345. package/dist/esm/utils/addon/pg/cursor.js +0 -1
  346. package/dist/esm/utils/addon/pg/pg.js +0 -2
  347. /package/dist/cjs/{core/pg-family → pg/clients}/cockroachdb-client/capabilities.cjs +0 -0
  348. /package/dist/cjs/{core/pg-family → pg/clients}/cockroachdb-client/index.cjs +0 -0
  349. /package/dist/cjs/{core/pg-family → pg/clients}/cockroachdb-client/relq-cockroach.cjs +0 -0
  350. /package/dist/cjs/{core/pg-family → pg/clients}/dsql-client/capabilities.cjs +0 -0
  351. /package/dist/cjs/{core/pg-family → pg/clients}/dsql-client/index.cjs +0 -0
  352. /package/dist/cjs/{core/pg-family → pg/clients}/dsql-client/relq-dsql.cjs +0 -0
  353. /package/dist/cjs/{core/pg-family → pg/clients}/index.cjs +0 -0
  354. /package/dist/cjs/{core/pg-family → pg/clients}/nile-client/capabilities.cjs +0 -0
  355. /package/dist/cjs/{core/pg-family → pg/clients}/nile-client/index.cjs +0 -0
  356. /package/dist/cjs/{core/pg-family → pg/clients}/nile-client/relq-nile.cjs +0 -0
  357. /package/dist/cjs/{core/pg-family → pg/clients}/nile-client/tenant-context.cjs +0 -0
  358. /package/dist/cjs/{core/pg-family → pg/clients}/pg-client/capabilities.cjs +0 -0
  359. /package/dist/cjs/{core/pg-family → pg/clients}/pg-client/index.cjs +0 -0
  360. /package/dist/cjs/{core/pg-family → pg/clients}/shared/pg-dialect.cjs +0 -0
  361. /package/dist/cjs/{core/pg-family → pg/clients}/shared/pg-error-parser.cjs +0 -0
  362. /package/dist/cjs/{condition → pg/condition}/array-numeric-condition-builder.cjs +0 -0
  363. /package/dist/cjs/{condition → pg/condition}/array-specialized-condition-builder.cjs +0 -0
  364. /package/dist/cjs/{condition → pg/condition}/array-string-condition-builder.cjs +0 -0
  365. /package/dist/cjs/{condition → pg/condition}/index.cjs +0 -0
  366. /package/dist/cjs/{count → pg/count}/index.cjs +0 -0
  367. /package/dist/cjs/{delete → pg/delete}/index.cjs +0 -0
  368. /package/dist/cjs/{explain → pg/explain}/explain-builder.cjs +0 -0
  369. /package/dist/cjs/{explain → pg/explain}/index.cjs +0 -0
  370. /package/dist/cjs/{insert → pg/insert}/index.cjs +0 -0
  371. /package/dist/cjs/{pubsub → pg/pubsub}/index.cjs +0 -0
  372. /package/dist/cjs/{raw → pg/raw}/index.cjs +0 -0
  373. /package/dist/cjs/{select → pg/select}/index.cjs +0 -0
  374. /package/dist/cjs/{select → pg/select}/join-internals.cjs +0 -0
  375. /package/dist/cjs/{select → pg/select}/table-proxy.cjs +0 -0
  376. /package/dist/cjs/{transaction → pg/transaction}/index.cjs +0 -0
  377. /package/dist/cjs/{update → pg/update}/index.cjs +0 -0
  378. /package/dist/cjs/{utils → pg/utils}/type-coercion.cjs +0 -0
  379. /package/dist/cjs/{window → pg/window}/index.cjs +0 -0
  380. /package/dist/esm/{core/pg-family → pg/clients}/cockroachdb-client/capabilities.js +0 -0
  381. /package/dist/esm/{core/pg-family → pg/clients}/cockroachdb-client/index.js +0 -0
  382. /package/dist/esm/{core/pg-family → pg/clients}/cockroachdb-client/relq-cockroach.js +0 -0
  383. /package/dist/esm/{core/pg-family → pg/clients}/dsql-client/capabilities.js +0 -0
  384. /package/dist/esm/{core/pg-family → pg/clients}/dsql-client/index.js +0 -0
  385. /package/dist/esm/{core/pg-family → pg/clients}/dsql-client/relq-dsql.js +0 -0
  386. /package/dist/esm/{core/pg-family → pg/clients}/index.js +0 -0
  387. /package/dist/esm/{core/pg-family → pg/clients}/nile-client/capabilities.js +0 -0
  388. /package/dist/esm/{core/pg-family → pg/clients}/nile-client/index.js +0 -0
  389. /package/dist/esm/{core/pg-family → pg/clients}/nile-client/relq-nile.js +0 -0
  390. /package/dist/esm/{core/pg-family → pg/clients}/nile-client/tenant-context.js +0 -0
  391. /package/dist/esm/{core/pg-family → pg/clients}/pg-client/capabilities.js +0 -0
  392. /package/dist/esm/{core/pg-family → pg/clients}/pg-client/index.js +0 -0
  393. /package/dist/esm/{core/pg-family → pg/clients}/shared/pg-dialect.js +0 -0
  394. /package/dist/esm/{core/pg-family → pg/clients}/shared/pg-error-parser.js +0 -0
  395. /package/dist/esm/{condition → pg/condition}/array-numeric-condition-builder.js +0 -0
  396. /package/dist/esm/{condition → pg/condition}/array-specialized-condition-builder.js +0 -0
  397. /package/dist/esm/{condition → pg/condition}/array-string-condition-builder.js +0 -0
  398. /package/dist/esm/{condition → pg/condition}/index.js +0 -0
  399. /package/dist/esm/{count → pg/count}/index.js +0 -0
  400. /package/dist/esm/{delete → pg/delete}/index.js +0 -0
  401. /package/dist/esm/{explain → pg/explain}/explain-builder.js +0 -0
  402. /package/dist/esm/{explain → pg/explain}/index.js +0 -0
  403. /package/dist/esm/{insert → pg/insert}/index.js +0 -0
  404. /package/dist/esm/{pubsub → pg/pubsub}/index.js +0 -0
  405. /package/dist/esm/{raw → pg/raw}/index.js +0 -0
  406. /package/dist/esm/{select → pg/select}/index.js +0 -0
  407. /package/dist/esm/{select → pg/select}/join-internals.js +0 -0
  408. /package/dist/esm/{select → pg/select}/table-proxy.js +0 -0
  409. /package/dist/esm/{transaction → pg/transaction}/index.js +0 -0
  410. /package/dist/esm/{update → pg/update}/index.js +0 -0
  411. /package/dist/esm/{utils → pg/utils}/type-coercion.js +0 -0
  412. /package/dist/esm/{window → pg/window}/index.js +0 -0
@@ -0,0 +1,56 @@
1
+ import { MysqlRawQueryBuilder } from "../raw/index.js";
2
+ import { INTERNAL } from "../../core/helpers/methods.js";
3
+ export class MysqlConnectedRawQueryBuilder {
4
+ relq;
5
+ builder;
6
+ constructor(query, params, relq) {
7
+ this.relq = relq;
8
+ this.builder = new MysqlRawQueryBuilder(query, params);
9
+ }
10
+ async all() {
11
+ const sql = this.builder.toString();
12
+ const { result, duration } = await this.relq[INTERNAL].executeRawQuery(sql);
13
+ return {
14
+ data: result.rows,
15
+ metadata: { rowCount: result.rowCount, command: result.command, duration, fields: result.fields },
16
+ };
17
+ }
18
+ async get() {
19
+ const sql = this.builder.toString();
20
+ const { result, duration } = await this.relq[INTERNAL].executeRawQuery(sql);
21
+ return {
22
+ data: (result.rows[0] || null),
23
+ metadata: { rowCount: result.rowCount, command: result.command, duration, fields: result.fields },
24
+ };
25
+ }
26
+ async getMany(count) {
27
+ const sql = this.builder.toString();
28
+ const limitedSql = sql.toUpperCase().includes('LIMIT') ? sql : `${sql} LIMIT ${count}`;
29
+ const { result, duration } = await this.relq[INTERNAL].executeRawQuery(limitedSql);
30
+ return {
31
+ data: result.rows,
32
+ metadata: { rowCount: result.rowCount, command: result.command, duration, fields: result.fields },
33
+ };
34
+ }
35
+ async run() {
36
+ const sql = this.builder.toString();
37
+ const { result, duration } = await this.relq[INTERNAL].executeRawQuery(sql);
38
+ return {
39
+ success: true,
40
+ metadata: { rowCount: result.rowCount, command: result.command, duration, fields: result.fields },
41
+ };
42
+ }
43
+ async count() {
44
+ const sql = this.builder.toString();
45
+ const { result, duration } = await this.relq[INTERNAL].executeRawQuery(sql);
46
+ const row = result.rows[0];
47
+ const count = row ? Number(Object.values(row)[0]) || 0 : 0;
48
+ return {
49
+ count,
50
+ metadata: { rowCount: result.rowCount, command: result.command, duration, fields: result.fields },
51
+ };
52
+ }
53
+ toString() {
54
+ return this.builder.toString();
55
+ }
56
+ }
@@ -0,0 +1,391 @@
1
+ import { MysqlConditionCollector } from "../condition/condition-collector.js";
2
+ import { INTERNAL } from "../../core/helpers/methods.js";
3
+ import { executeMysqlTypeSafeJoin, executeMysqlCorrelatedSubqueryJoin, executeMysqlJoinManyThrough, executeMysqlLateralJoin, executeMysqlLateralJoinThrough, } from "./select-joins.js";
4
+ import { executeMysqlCursorEach, executeMysqlPagination } from "./select-pagination.js";
5
+ import { requireCapability } from "../../core/helpers/capability-guard.js";
6
+ import { createTableAccessor } from "../../core/shared/table-accessor.js";
7
+ import { MysqlAggregateFunctions } from "../select/sql-expression.js";
8
+ import { createMysqlTableProxy } from "../select/table-proxy.js";
9
+ import { resolveMysqlForeignKey } from "../utils/fk-resolver.js";
10
+ import { RelqBuilderError } from "../../shared/errors/relq-errors.js";
11
+ import mysqlFormat from "../clients/shared/mysql-format.js";
12
+ export class MysqlConnectedSelectBuilder {
13
+ builder;
14
+ relq;
15
+ tableName;
16
+ schemaKey;
17
+ constructor(builder, relq, tableName, _columns, schemaKey) {
18
+ this.builder = builder;
19
+ this.relq = relq;
20
+ this.tableName = tableName;
21
+ this.schemaKey = schemaKey;
22
+ this.setupColumnResolver();
23
+ }
24
+ get joinCtx() {
25
+ return { relq: this.relq, builder: this.builder, tableName: this.tableName, schemaKey: this.schemaKey };
26
+ }
27
+ get paginationCtx() {
28
+ return { relq: this.relq, builder: this.builder, tableName: this.tableName };
29
+ }
30
+ setupColumnResolver() {
31
+ const internal = this.relq[INTERNAL];
32
+ const tableKey = this.schemaKey || this.tableName;
33
+ const tableDef = internal.getTableDef(tableKey);
34
+ if (!tableDef) {
35
+ return;
36
+ }
37
+ const tableColumns = tableDef.$columns || tableDef;
38
+ this.builder.setColumnResolver((column) => {
39
+ const columnDef = tableColumns[column];
40
+ if (columnDef) {
41
+ return columnDef.$columnName || column;
42
+ }
43
+ return column;
44
+ });
45
+ }
46
+ transformJoinResults(rows) {
47
+ const joins = this.builder.getStructuredJoins();
48
+ if (joins.length === 0) {
49
+ return rows;
50
+ }
51
+ const internal = this.relq[INTERNAL];
52
+ return rows.map(row => {
53
+ if (!row || typeof row !== 'object')
54
+ return row;
55
+ const transformed = { ...row };
56
+ for (const join of joins) {
57
+ const alias = join.alias;
58
+ const nestedData = transformed[alias];
59
+ if (nestedData === null || nestedData === undefined) {
60
+ continue;
61
+ }
62
+ const joinedTableDef = internal.getTableDef(join.schemaKey || alias) || internal.getTableDef(join.table);
63
+ if (!joinedTableDef) {
64
+ continue;
65
+ }
66
+ const tableColumns = joinedTableDef.$columns || joinedTableDef;
67
+ const dbToProp = new Map();
68
+ const propTypes = new Map();
69
+ for (const [propName, colDef] of Object.entries(tableColumns)) {
70
+ const dbColName = colDef?.$columnName ?? propName;
71
+ dbToProp.set(dbColName, propName);
72
+ const snakeCase = propName.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
73
+ if (snakeCase !== propName && !dbToProp.has(snakeCase)) {
74
+ dbToProp.set(snakeCase, propName);
75
+ }
76
+ const sqlType = colDef?.$sqlType || (typeof colDef?.$type === 'string' ? colDef.$type : undefined);
77
+ if (sqlType) {
78
+ propTypes.set(propName, sqlType.toLowerCase());
79
+ }
80
+ }
81
+ if (Array.isArray(nestedData)) {
82
+ transformed[alias] = nestedData.map((item) => this.transformNestedObject(item, dbToProp, propTypes));
83
+ }
84
+ else {
85
+ transformed[alias] = this.transformNestedObject(nestedData, dbToProp, propTypes);
86
+ }
87
+ }
88
+ return transformed;
89
+ });
90
+ }
91
+ transformNestedObject(obj, dbToProp, propTypes) {
92
+ if (!obj || typeof obj !== 'object')
93
+ return obj;
94
+ const result = {};
95
+ for (const [key, value] of Object.entries(obj)) {
96
+ const propName = dbToProp.get(key) ?? key;
97
+ result[propName] = propTypes ? this.coerceValue(value, propTypes.get(propName)) : value;
98
+ }
99
+ return result;
100
+ }
101
+ coerceValue(value, sqlType) {
102
+ if (value === null || value === undefined || !sqlType)
103
+ return value;
104
+ switch (sqlType) {
105
+ case 'timestamp':
106
+ case 'datetime':
107
+ case 'date':
108
+ return typeof value === 'string' ? new Date(value) : value;
109
+ case 'bigint':
110
+ return typeof value === 'number' ? BigInt(value) : typeof value === 'string' ? BigInt(value) : value;
111
+ default:
112
+ return value;
113
+ }
114
+ }
115
+ where(callbackOrCondition) {
116
+ if (callbackOrCondition instanceof MysqlConditionCollector) {
117
+ const conditionTable = callbackOrCondition._tableName;
118
+ if (conditionTable) {
119
+ const matches = conditionTable === this.schemaKey || conditionTable === this.tableName;
120
+ if (!matches) {
121
+ const queryTable = this.schemaKey || this.tableName;
122
+ throw new RelqBuilderError(`Condition was created for table '${conditionTable}' but is being used on '${queryTable}'. ` +
123
+ `Create the condition with db.where('${queryTable}') instead.`);
124
+ }
125
+ }
126
+ this.builder.where(callbackOrCondition);
127
+ return this;
128
+ }
129
+ const callback = callbackOrCondition;
130
+ this.builder.where((q) => {
131
+ q._tables = createTableAccessor(this.relq, this.relq.schema);
132
+ return callback(q);
133
+ });
134
+ return this;
135
+ }
136
+ orderBy(column, direction) {
137
+ const dbColumn = this.relq[INTERNAL].hasColumnMapping()
138
+ ? Object.keys(this.relq[INTERNAL].transformToDbColumns(this.tableName, { [column]: true }))[0]
139
+ : column;
140
+ this.builder.orderBy(dbColumn, direction);
141
+ return this;
142
+ }
143
+ limit(count) {
144
+ this.builder.limit(count);
145
+ return this;
146
+ }
147
+ offset(count) {
148
+ this.builder.offset(count);
149
+ return this;
150
+ }
151
+ groupBy(...columns) {
152
+ const dbColumns = this.relq[INTERNAL].hasColumnMapping()
153
+ ? columns.map(col => Object.keys(this.relq[INTERNAL].transformToDbColumns(this.tableName, { [col]: true }))[0])
154
+ : columns;
155
+ this.builder.groupBy(...dbColumns);
156
+ return this;
157
+ }
158
+ having(callback) {
159
+ this.builder.having(callback);
160
+ return this;
161
+ }
162
+ include(callback) {
163
+ const agg = new MysqlAggregateFunctions();
164
+ const internal = this.relq[INTERNAL];
165
+ const schema = internal.getSchema() || {};
166
+ const sourceSchemaKey = this.schemaKey || this.tableName;
167
+ const sourceAlias = this.builder.getTableIdentifier();
168
+ const accessedTables = new Set();
169
+ const tableProxies = new Proxy({}, {
170
+ get(_, tableKey) {
171
+ if (typeof tableKey === 'symbol')
172
+ return undefined;
173
+ const key = tableKey;
174
+ const tableDef = schema[key];
175
+ const tableSqlName = tableDef?.$name || key;
176
+ if (key === sourceSchemaKey) {
177
+ return createMysqlTableProxy(tableSqlName, sourceAlias, tableDef);
178
+ }
179
+ accessedTables.add(key);
180
+ return createMysqlTableProxy(tableSqlName, key, tableDef);
181
+ }
182
+ });
183
+ const expressions = callback(agg, tableProxies);
184
+ const sourceExprs = [];
185
+ const externalExprs = new Map();
186
+ for (const [alias, expr] of Object.entries(expressions)) {
187
+ let targetTable = null;
188
+ for (const tableKey of accessedTables) {
189
+ if (expr.sql.includes(`\`${tableKey}\`.`)) {
190
+ targetTable = tableKey;
191
+ break;
192
+ }
193
+ }
194
+ if (targetTable) {
195
+ if (!externalExprs.has(targetTable))
196
+ externalExprs.set(targetTable, []);
197
+ externalExprs.get(targetTable).push({ alias, sql: expr.sql });
198
+ }
199
+ else {
200
+ sourceExprs.push({ alias, sql: expr.sql });
201
+ }
202
+ }
203
+ for (const e of sourceExprs) {
204
+ this.builder.addIncludeExpression(e.alias, e.sql);
205
+ }
206
+ for (const [tableKey, exprs] of externalExprs) {
207
+ const tableDef = schema[tableKey];
208
+ const sqlTableName = tableDef?.$name || tableKey;
209
+ const existingJoins = this.builder.getStructuredJoins();
210
+ const alreadyJoined = existingJoins.some(j => j.table === sqlTableName || j.schemaKey === tableKey || j.alias === tableKey);
211
+ if (alreadyJoined) {
212
+ for (const e of exprs) {
213
+ this.builder.addIncludeExpression(e.alias, e.sql);
214
+ }
215
+ continue;
216
+ }
217
+ const fk = resolveMysqlForeignKey(schema, sourceSchemaKey, tableKey);
218
+ if (!fk) {
219
+ throw new RelqBuilderError(`include() references table "${tableKey}" but no foreign key relationship exists between "${sourceSchemaKey}" and "${tableKey}". Define the relationship in your schema.`, { builder: 'include', hint: `Add a foreign key from "${tableKey}" to "${sourceSchemaKey}" in your table definition.` });
220
+ }
221
+ for (const e of exprs) {
222
+ const unqualifiedSql = e.sql.replace(new RegExp(`\`${tableKey}\`\\.`, 'g'), '');
223
+ const subquery = `(SELECT ${unqualifiedSql} FROM ${mysqlFormat.ident(sqlTableName)} WHERE ${mysqlFormat.ident(fk.toColumn)} = ${mysqlFormat.ident(sourceAlias)}.${mysqlFormat.ident(fk.fromColumn)})`;
224
+ this.builder.addIncludeExpression(e.alias, subquery);
225
+ }
226
+ }
227
+ return this;
228
+ }
229
+ join(tableOrAlias, callback) {
230
+ executeMysqlTypeSafeJoin(this.joinCtx, 'JOIN', tableOrAlias, callback);
231
+ return this;
232
+ }
233
+ leftJoin(tableOrAlias, callback) {
234
+ executeMysqlTypeSafeJoin(this.joinCtx, 'LEFT JOIN', tableOrAlias, callback);
235
+ return this;
236
+ }
237
+ rightJoin(tableOrAlias, callback) {
238
+ executeMysqlTypeSafeJoin(this.joinCtx, 'RIGHT JOIN', tableOrAlias, callback);
239
+ return this;
240
+ }
241
+ innerJoin(tableOrAlias, callback) {
242
+ executeMysqlTypeSafeJoin(this.joinCtx, 'INNER JOIN', tableOrAlias, callback);
243
+ return this;
244
+ }
245
+ crossJoin(tableOrAlias) {
246
+ const [tableKey, alias] = Array.isArray(tableOrAlias) ? tableOrAlias : [tableOrAlias, tableOrAlias];
247
+ const internal = this.relq[INTERNAL];
248
+ const tableDef = internal.getTableDef(tableKey);
249
+ const tableSqlName = tableDef?.$name || tableKey;
250
+ this.builder.crossJoin(tableSqlName);
251
+ this.builder.addStructuredJoin({ table: tableSqlName, alias, type: 'CROSS JOIN', schemaKey: tableKey });
252
+ return this;
253
+ }
254
+ joinSubquery(alias, subquery, onClause) {
255
+ const subquerySQL = typeof subquery === 'string' ? subquery : subquery.toString();
256
+ this.builder.addRawJoin(`JOIN (${subquerySQL}) AS ${mysqlFormat.ident(alias)} ON ${onClause}`);
257
+ return this;
258
+ }
259
+ leftJoinSubquery(alias, subquery, onClause) {
260
+ const subquerySQL = typeof subquery === 'string' ? subquery : subquery.toString();
261
+ this.builder.addRawJoin(`LEFT JOIN (${subquerySQL}) AS ${mysqlFormat.ident(alias)} ON ${onClause}`);
262
+ return this;
263
+ }
264
+ joinMany(tableOrAlias, callbackOrOptions, throughCallback) {
265
+ if (callbackOrOptions && typeof callbackOrOptions === 'object' && 'through' in callbackOrOptions) {
266
+ executeMysqlJoinManyThrough(this.joinCtx, tableOrAlias, callbackOrOptions.through, throughCallback);
267
+ }
268
+ else {
269
+ executeMysqlCorrelatedSubqueryJoin(this.joinCtx, tableOrAlias, callbackOrOptions);
270
+ }
271
+ return this;
272
+ }
273
+ leftJoinMany(tableOrAlias, callbackOrOptions, throughCallback) {
274
+ if (callbackOrOptions && typeof callbackOrOptions === 'object' && 'through' in callbackOrOptions) {
275
+ executeMysqlJoinManyThrough(this.joinCtx, tableOrAlias, callbackOrOptions.through, throughCallback);
276
+ }
277
+ else {
278
+ executeMysqlCorrelatedSubqueryJoin(this.joinCtx, tableOrAlias, callbackOrOptions);
279
+ }
280
+ return this;
281
+ }
282
+ joinManyLateral(tableOrAlias, callbackOrOptions, throughCallback) {
283
+ if (callbackOrOptions && typeof callbackOrOptions === 'object' && 'through' in callbackOrOptions) {
284
+ executeMysqlLateralJoinThrough(this.joinCtx, 'JOIN', tableOrAlias, callbackOrOptions.through, throughCallback);
285
+ }
286
+ else {
287
+ executeMysqlLateralJoin(this.joinCtx, 'JOIN', tableOrAlias, callbackOrOptions);
288
+ }
289
+ return this;
290
+ }
291
+ leftJoinManyLateral(tableOrAlias, callbackOrOptions, throughCallback) {
292
+ if (callbackOrOptions && typeof callbackOrOptions === 'object' && 'through' in callbackOrOptions) {
293
+ executeMysqlLateralJoinThrough(this.joinCtx, 'LEFT JOIN', tableOrAlias, callbackOrOptions.through, throughCallback);
294
+ }
295
+ else {
296
+ executeMysqlLateralJoin(this.joinCtx, 'LEFT JOIN', tableOrAlias, callbackOrOptions);
297
+ }
298
+ return this;
299
+ }
300
+ with(table) {
301
+ executeMysqlTypeSafeJoin(this.joinCtx, 'LEFT JOIN', table);
302
+ return this;
303
+ }
304
+ withMany(table, options) {
305
+ if (options && 'through' in options) {
306
+ executeMysqlJoinManyThrough(this.joinCtx, table, options.through);
307
+ return this;
308
+ }
309
+ const internal = this.relq[INTERNAL];
310
+ const schema = internal.getSchema();
311
+ if (!schema) {
312
+ throw new RelqBuilderError(`Cannot use .withMany('${table}') without schema. Pass your schema when creating Relq.`, { builder: 'withMany', hint: `Use .leftJoinMany() with an explicit callback instead.` });
313
+ }
314
+ const sourceKey = this.schemaKey || this.tableName;
315
+ const fk = resolveMysqlForeignKey(schema, sourceKey, table);
316
+ if (!fk) {
317
+ throw new RelqBuilderError(`No foreign key relationship found between "${sourceKey}" and "${table}". Define $foreignKeys on your table definitions.`, { builder: 'withMany', hint: `Use .leftJoinMany() with explicit join conditions instead.` });
318
+ }
319
+ executeMysqlCorrelatedSubqueryJoin(this.joinCtx, table, (on, right, left) => {
320
+ const rightCol = right[fk.toColumn];
321
+ const leftCol = left[fk.fromColumn];
322
+ return on.equal(rightCol, leftCol);
323
+ });
324
+ return this;
325
+ }
326
+ distinct() {
327
+ this.builder.distinct();
328
+ return this;
329
+ }
330
+ union(query) {
331
+ this.builder.union(typeof query === 'string' ? query : query.toString());
332
+ return this;
333
+ }
334
+ unionAll(query) {
335
+ this.builder.unionAll(typeof query === 'string' ? query : query.toString());
336
+ return this;
337
+ }
338
+ intersect(query) {
339
+ this.builder.intersect(typeof query === 'string' ? query : query.toString());
340
+ return this;
341
+ }
342
+ except(query) {
343
+ this.builder.except(typeof query === 'string' ? query : query.toString());
344
+ return this;
345
+ }
346
+ forUpdate() {
347
+ this.builder.forUpdate();
348
+ return this;
349
+ }
350
+ forUpdateSkipLocked() {
351
+ requireCapability(this.relq, 'forUpdateSkipLocked', 'FOR UPDATE SKIP LOCKED', 'Use FOR UPDATE without SKIP LOCKED');
352
+ this.builder.forUpdateSkipLocked();
353
+ return this;
354
+ }
355
+ forUpdateNoWait() {
356
+ this.builder.forUpdateNoWait();
357
+ return this;
358
+ }
359
+ forShare() {
360
+ this.builder.forShare();
361
+ return this;
362
+ }
363
+ toString() {
364
+ return this.builder.toString();
365
+ }
366
+ async all(withMetadata, _asRequired) {
367
+ const sql = this.builder.toString();
368
+ const result = await this.relq[INTERNAL].executeSelect(sql, this.tableName);
369
+ const transformedData = this.transformJoinResults(result.data);
370
+ if (withMetadata) {
371
+ return { data: transformedData, metadata: result.metadata };
372
+ }
373
+ return transformedData;
374
+ }
375
+ async get(withMetadata, _asRequired) {
376
+ this.builder.limit(1);
377
+ const sql = this.builder.toString();
378
+ const result = await this.relq[INTERNAL].executeSelectOne(sql, this.tableName);
379
+ const transformedData = result.data ? this.transformJoinResults([result.data])[0] : null;
380
+ if (withMetadata) {
381
+ return { data: transformedData, metadata: result.metadata };
382
+ }
383
+ return transformedData;
384
+ }
385
+ async each(callback, options = {}) {
386
+ return executeMysqlCursorEach(this.paginationCtx, callback, options);
387
+ }
388
+ async pagination(options) {
389
+ return executeMysqlPagination(this.paginationCtx, options, (opts) => this.pagination(opts));
390
+ }
391
+ }
@@ -0,0 +1,123 @@
1
+ import { MysqlConnectedRawQueryBuilder } from "./MysqlConnectedRawQueryBuilder.js";
2
+ import { INTERNAL } from "../../core/helpers/methods.js";
3
+ export class MysqlTransactionClient {
4
+ client;
5
+ relq;
6
+ schema;
7
+ constructor(client, relq) {
8
+ this.client = client;
9
+ this.relq = relq;
10
+ const internal = this.relq[INTERNAL];
11
+ this.schema = internal.getSchema?.() ?? this.relq.schema;
12
+ }
13
+ get dialect() { return this.relq.dialect; }
14
+ get capabilities() { return this.relq.capabilities; }
15
+ get table() {
16
+ const { createMysqlTableAccessor } = require('../shared/mysql-table-accessor');
17
+ return createMysqlTableAccessor(this, this.schema);
18
+ }
19
+ raw(query, ...params) {
20
+ return new MysqlConnectedRawQueryBuilder(query, params, this);
21
+ }
22
+ async savepoint(name) {
23
+ await this.executeOnClient(`SAVEPOINT \`${name}\``);
24
+ }
25
+ async rollbackTo(name) {
26
+ await this.executeOnClient(`ROLLBACK TO SAVEPOINT \`${name}\``);
27
+ }
28
+ async releaseSavepoint(name) {
29
+ await this.executeOnClient(`RELEASE SAVEPOINT \`${name}\``);
30
+ }
31
+ async executeOnClient(sql) {
32
+ const [rows, fields] = await this.client.query(sql);
33
+ return {
34
+ rows: Array.isArray(rows) ? rows : [],
35
+ rowCount: rows?.affectedRows ?? 0,
36
+ command: sql.split(' ')[0] || 'QUERY',
37
+ fields: (fields ?? []).map((f) => ({ name: f.name, dataTypeID: f.columnType ?? 0 })),
38
+ };
39
+ }
40
+ get [INTERNAL]() {
41
+ const parentInternal = this.relq[INTERNAL];
42
+ const queryViaClient = async (sql) => {
43
+ const start = performance.now();
44
+ const result = await this.executeOnClient(sql);
45
+ return { result, duration: performance.now() - start };
46
+ };
47
+ const buildMetadata = (result, duration) => ({
48
+ rowCount: result.rowCount,
49
+ command: result.command,
50
+ duration,
51
+ fields: result.fields,
52
+ });
53
+ return {
54
+ executeQuery: queryViaClient,
55
+ async executeSelect(sql, tableName) {
56
+ const { result, duration } = await queryViaClient(sql);
57
+ const rows = tableName
58
+ ? parentInternal.transformResultsFromDb(tableName, result.rows)
59
+ : result.rows;
60
+ return { data: rows, metadata: buildMetadata(result, duration) };
61
+ },
62
+ async executeSelectOne(sql, tableName) {
63
+ const { result, duration } = await queryViaClient(sql);
64
+ const row = result.rows[0]
65
+ ? (tableName ? parentInternal.transformFromDbColumns(tableName, result.rows[0]) : result.rows[0])
66
+ : null;
67
+ return { data: row, metadata: buildMetadata(result, duration) };
68
+ },
69
+ async executeCount(sql) {
70
+ const { result, duration } = await queryViaClient(sql);
71
+ const count = result.rows[0]?.count
72
+ ? parseInt(result.rows[0].count, 10)
73
+ : 0;
74
+ return { count, metadata: buildMetadata(result, duration) };
75
+ },
76
+ async executeRun(sql) {
77
+ const { result, duration } = await queryViaClient(sql);
78
+ return { success: true, metadata: buildMetadata(result, duration) };
79
+ },
80
+ executeRawQuery: queryViaClient,
81
+ transformToDbColumns: parentInternal.transformToDbColumns,
82
+ transformFromDbColumns: parentInternal.transformFromDbColumns,
83
+ transformResultsFromDb: parentInternal.transformResultsFromDb,
84
+ hasColumnMapping: parentInternal.hasColumnMapping,
85
+ validateData: parentInternal.validateData,
86
+ getSchema: parentInternal.getSchema,
87
+ getRelations: parentInternal.getRelations,
88
+ getTableDef: parentInternal.getTableDef,
89
+ getClientForCursor: async () => ({ client: this.client, release: () => { } }),
90
+ };
91
+ }
92
+ }
93
+ export async function executeMysqlTransaction(relq, callback, options) {
94
+ await relq.ensureInitialized();
95
+ const { client, release } = await relq[INTERNAL].getClientForCursor();
96
+ try {
97
+ if (options?.isolation) {
98
+ await client.query(`SET TRANSACTION ISOLATION LEVEL ${options.isolation}`);
99
+ }
100
+ let startSql = 'START TRANSACTION';
101
+ if (options?.readOnly === true) {
102
+ startSql += ' READ ONLY';
103
+ }
104
+ else if (options?.readOnly === false) {
105
+ startSql += ' READ WRITE';
106
+ }
107
+ await client.query(startSql);
108
+ const tx = new MysqlTransactionClient(client, relq);
109
+ const result = await callback(tx);
110
+ await client.query('COMMIT');
111
+ return result;
112
+ }
113
+ catch (error) {
114
+ try {
115
+ await client.query('ROLLBACK');
116
+ }
117
+ catch { }
118
+ throw error;
119
+ }
120
+ finally {
121
+ release();
122
+ }
123
+ }
@@ -0,0 +1,88 @@
1
+ import { MysqlConditionCollector } from "../condition/condition-collector.js";
2
+ import { INTERNAL } from "../../core/helpers/methods.js";
3
+ import { RelqBuilderError } from "../../shared/errors/relq-errors.js";
4
+ export class MysqlConnectedUpdateBuilder {
5
+ builder;
6
+ relq;
7
+ tableName;
8
+ schemaKey;
9
+ constructor(builder, relq, tableName, schemaKey) {
10
+ this.builder = builder;
11
+ this.relq = relq;
12
+ this.tableName = tableName;
13
+ this.schemaKey = schemaKey;
14
+ this.setupColumnResolver();
15
+ }
16
+ setupColumnResolver() {
17
+ if (!this.tableName && !this.schemaKey)
18
+ return;
19
+ const internal = this.relq[INTERNAL];
20
+ const tableDef = internal.getTableDef(this.schemaKey || this.tableName);
21
+ if (!tableDef)
22
+ return;
23
+ const tableColumns = tableDef.$columns || tableDef;
24
+ this.builder.setColumnResolver((column) => {
25
+ const columnDef = tableColumns[column];
26
+ if (columnDef) {
27
+ return columnDef.$columnName || column;
28
+ }
29
+ return column;
30
+ });
31
+ }
32
+ set(data) {
33
+ this.builder.set(data);
34
+ return this;
35
+ }
36
+ where(callbackOrCondition) {
37
+ if (callbackOrCondition instanceof MysqlConditionCollector) {
38
+ const conditionTable = callbackOrCondition._tableName;
39
+ if (conditionTable) {
40
+ const matches = conditionTable === this.schemaKey || conditionTable === this.tableName;
41
+ if (!matches) {
42
+ const queryTable = this.schemaKey || this.tableName;
43
+ throw new RelqBuilderError(`Condition was created for table '${conditionTable}' but is being used on '${queryTable}'. ` +
44
+ `Create the condition with db.where('${queryTable}') instead.`);
45
+ }
46
+ }
47
+ this.builder.where(callbackOrCondition);
48
+ return this;
49
+ }
50
+ const callback = callbackOrCondition;
51
+ this.builder.where((q) => {
52
+ return callback(q);
53
+ });
54
+ return this;
55
+ }
56
+ join(table, condition) {
57
+ this.builder.join(table, condition);
58
+ return this;
59
+ }
60
+ leftJoin(table, condition) {
61
+ this.builder.leftJoin(table, condition);
62
+ return this;
63
+ }
64
+ innerJoin(table, condition) {
65
+ this.builder.innerJoin(table, condition);
66
+ return this;
67
+ }
68
+ orderBy(column, direction = 'ASC') {
69
+ this.builder.orderBy(column, direction);
70
+ return this;
71
+ }
72
+ limit(count) {
73
+ this.builder.limit(count);
74
+ return this;
75
+ }
76
+ toString() {
77
+ return this.builder.toString();
78
+ }
79
+ async run(withMetadata) {
80
+ this.relq[INTERNAL].validateData(this.builder.tableName, this.builder.updateData, 'update');
81
+ const sql = this.builder.toString();
82
+ const result = await this.relq[INTERNAL].executeRun(sql);
83
+ if (withMetadata) {
84
+ return result;
85
+ }
86
+ return result.metadata.rowCount ?? 0;
87
+ }
88
+ }