velocious 1.0.449 → 1.0.451

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 (636) hide show
  1. package/README.md +1 -1
  2. package/build/application.js +4 -4
  3. package/build/authorization/ability.js +8 -8
  4. package/build/authorization/base-resource.js +4 -4
  5. package/build/background-jobs/cron-expression.js +1 -1
  6. package/build/background-jobs/forked-runner-child.js +1 -1
  7. package/build/background-jobs/job-registry.js +1 -1
  8. package/build/background-jobs/job-runner.js +1 -1
  9. package/build/background-jobs/job.js +1 -1
  10. package/build/background-jobs/json-socket.js +4 -4
  11. package/build/background-jobs/main.js +21 -21
  12. package/build/background-jobs/scheduler.js +7 -7
  13. package/build/background-jobs/store.js +7 -7
  14. package/build/background-jobs/web/controller.js +2 -2
  15. package/build/background-jobs/worker.js +12 -12
  16. package/build/beacon/client.js +11 -8
  17. package/build/beacon/in-process-broker.js +2 -2
  18. package/build/beacon/in-process-client.js +2 -2
  19. package/build/beacon/server.js +3 -3
  20. package/build/cli/browser-cli.js +1 -1
  21. package/build/cli/commands/db/base-command.js +2 -2
  22. package/build/cli/index.js +2 -2
  23. package/build/cli/tenant-database-command-helper.js +3 -3
  24. package/build/cli/use-browser-cli.js +1 -1
  25. package/build/configuration-types.js +3 -1
  26. package/build/configuration.js +38 -38
  27. package/build/controller.js +8 -8
  28. package/build/current-configuration.js +1 -1
  29. package/build/database/annotations-async-hooks.js +2 -2
  30. package/build/database/annotations.js +3 -3
  31. package/build/database/drivers/base-column.js +1 -1
  32. package/build/database/drivers/base-foreign-key.js +1 -1
  33. package/build/database/drivers/base-table.js +1 -1
  34. package/build/database/drivers/base.js +10 -10
  35. package/build/database/drivers/mssql/index.js +1 -1
  36. package/build/database/drivers/mssql/table.js +1 -1
  37. package/build/database/drivers/mysql/index.js +3 -3
  38. package/build/database/drivers/mysql/query.js +1 -1
  39. package/build/database/drivers/mysql/table.js +1 -1
  40. package/build/database/drivers/pgsql/index.js +2 -2
  41. package/build/database/drivers/sqlite/base.js +16 -16
  42. package/build/database/drivers/sqlite/index.js +11 -11
  43. package/build/database/drivers/sqlite/index.native.js +1 -1
  44. package/build/database/drivers/sqlite/index.web.js +3 -3
  45. package/build/database/drivers/sqlite/query.js +1 -1
  46. package/build/database/drivers/sqlite/query.web.js +1 -1
  47. package/build/database/drivers/sqlite/sql/alter-table.js +2 -2
  48. package/build/database/drivers/sqlite/table.js +1 -1
  49. package/build/database/migrator/files-finder.js +1 -1
  50. package/build/database/migrator.js +6 -6
  51. package/build/database/pool/async-tracked-multi-connection.js +27 -27
  52. package/build/database/pool/base-methods-forward.js +4 -4
  53. package/build/database/pool/base.js +8 -8
  54. package/build/database/query/from-base.js +1 -1
  55. package/build/database/query/index.js +10 -10
  56. package/build/database/query/join-object.js +3 -3
  57. package/build/database/query/model-class-query.js +39 -39
  58. package/build/database/query/preloader/belongs-to.js +22 -22
  59. package/build/database/query/preloader/has-many.js +20 -20
  60. package/build/database/query/preloader/has-one.js +8 -8
  61. package/build/database/query/preloader/selection.js +3 -3
  62. package/build/database/query/preloader.js +8 -8
  63. package/build/database/query/query-data.js +9 -9
  64. package/build/database/query/where-model-class-hash.js +7 -7
  65. package/build/database/query/with-count.js +9 -9
  66. package/build/database/record/acts-as-list.js +15 -15
  67. package/build/database/record/attachments/handle.js +2 -2
  68. package/build/database/record/attachments/normalize-input.js +12 -12
  69. package/build/database/record/attachments/storage-drivers/s3.js +6 -6
  70. package/build/database/record/attachments/store.js +13 -13
  71. package/build/database/record/index.js +115 -121
  72. package/build/database/record/instance-relationships/base.js +11 -11
  73. package/build/database/record/instance-relationships/belongs-to.js +3 -3
  74. package/build/database/record/instance-relationships/has-many.js +8 -8
  75. package/build/database/record/instance-relationships/has-one.js +7 -7
  76. package/build/database/record/relationships/base.js +2 -2
  77. package/build/database/record/state-machine.js +7 -7
  78. package/build/database/record/validators/presence.js +1 -1
  79. package/build/database/record/validators/uniqueness.js +5 -5
  80. package/build/database/table-data/index.js +4 -4
  81. package/build/environment-handlers/base.js +2 -2
  82. package/build/environment-handlers/browser.js +7 -7
  83. package/build/environment-handlers/node/cli/commands/cli-command-context.js +1 -1
  84. package/build/environment-handlers/node/cli/commands/console.js +4 -4
  85. package/build/environment-handlers/node/cli/commands/db/schema/dump.js +1 -1
  86. package/build/environment-handlers/node/cli/commands/db/schema/load.js +3 -3
  87. package/build/environment-handlers/node/cli/commands/generate/frontend-models.js +836 -60
  88. package/build/environment-handlers/node.js +6 -6
  89. package/build/frontend-model-controller.js +81 -82
  90. package/build/frontend-model-resource/base-resource.js +78 -115
  91. package/build/frontend-models/base.js +162 -149
  92. package/build/frontend-models/clear-pending-debounced-callback.js +1 -1
  93. package/build/frontend-models/event-hook-models.js +2 -2
  94. package/build/frontend-models/outgoing-event-buffer.js +2 -2
  95. package/build/frontend-models/preloader.js +5 -5
  96. package/build/frontend-models/query.js +43 -38
  97. package/build/frontend-models/resource-definition.js +6 -6
  98. package/build/frontend-models/transport-serialization.js +11 -11
  99. package/build/frontend-models/use-destroyed-event.js +10 -10
  100. package/build/frontend-models/use-model-class-event.js +11 -11
  101. package/build/frontend-models/use-updated-event.js +11 -11
  102. package/build/frontend-models/websocket-channel.js +26 -17
  103. package/build/frontend-models/websocket-publishers.js +9 -9
  104. package/build/http-client/response.js +2 -2
  105. package/build/http-server/client/index.js +8 -8
  106. package/build/http-server/client/params-to-object.js +10 -10
  107. package/build/http-server/client/request-buffer/form-data-part.js +2 -2
  108. package/build/http-server/client/request-buffer/index.js +8 -8
  109. package/build/http-server/client/request-parser.js +3 -3
  110. package/build/http-server/client/request-runner.js +6 -6
  111. package/build/http-server/client/request-timing.js +5 -5
  112. package/build/http-server/client/request.js +1 -1
  113. package/build/http-server/client/response.js +5 -5
  114. package/build/http-server/client/websocket-request.js +4 -4
  115. package/build/http-server/client/websocket-session.js +18 -18
  116. package/build/http-server/development-reloader.js +5 -5
  117. package/build/http-server/index.js +12 -12
  118. package/build/http-server/remote-address.js +4 -4
  119. package/build/http-server/server-client.js +3 -3
  120. package/build/http-server/server-lock.js +4 -4
  121. package/build/http-server/websocket-channel-subscribers.js +3 -3
  122. package/build/http-server/websocket-channel.js +1 -1
  123. package/build/http-server/websocket-connection.js +1 -1
  124. package/build/http-server/websocket-event-log-store.js +6 -6
  125. package/build/http-server/websocket-events-host.js +2 -2
  126. package/build/http-server/worker-handler/in-process.js +7 -7
  127. package/build/http-server/worker-handler/index.js +4 -4
  128. package/build/http-server/worker-handler/worker-thread.js +3 -3
  129. package/build/logger/outputs/array-output.js +3 -3
  130. package/build/logger/outputs/console-output.js +1 -1
  131. package/build/logger/outputs/file-output.js +4 -4
  132. package/build/logger/outputs/stdout-output.js +1 -1
  133. package/build/logger.js +10 -10
  134. package/build/mailer/backends/smtp.js +3 -3
  135. package/build/mailer/base.js +8 -8
  136. package/build/mailer/delivery.js +4 -4
  137. package/build/plugins/sqljs-wasm-route-controller.js +1 -1
  138. package/build/routes/base-route.js +6 -6
  139. package/build/routes/basic-route.js +1 -1
  140. package/build/routes/hooks/frontend-model-command-route-hook.js +1 -1
  141. package/build/routes/index.js +1 -1
  142. package/build/routes/plugin-routes.js +1 -1
  143. package/build/routes/resolver.js +11 -11
  144. package/build/routes/resource-route.js +1 -1
  145. package/build/src/application.d.ts +3 -3
  146. package/build/src/application.d.ts.map +1 -1
  147. package/build/src/application.js +5 -5
  148. package/build/src/authorization/ability.d.ts +7 -7
  149. package/build/src/authorization/ability.d.ts.map +1 -1
  150. package/build/src/authorization/ability.js +9 -9
  151. package/build/src/authorization/base-resource.d.ts +1 -1
  152. package/build/src/authorization/base-resource.d.ts.map +1 -1
  153. package/build/src/authorization/base-resource.js +5 -5
  154. package/build/src/background-jobs/cron-expression.js +2 -2
  155. package/build/src/background-jobs/forked-runner-child.js +2 -2
  156. package/build/src/background-jobs/job-registry.d.ts +1 -1
  157. package/build/src/background-jobs/job-registry.d.ts.map +1 -1
  158. package/build/src/background-jobs/job-registry.js +2 -2
  159. package/build/src/background-jobs/job-runner.js +2 -2
  160. package/build/src/background-jobs/job.js +2 -2
  161. package/build/src/background-jobs/json-socket.d.ts +4 -4
  162. package/build/src/background-jobs/json-socket.d.ts.map +1 -1
  163. package/build/src/background-jobs/json-socket.js +5 -5
  164. package/build/src/background-jobs/main.d.ts +18 -18
  165. package/build/src/background-jobs/main.d.ts.map +1 -1
  166. package/build/src/background-jobs/main.js +22 -22
  167. package/build/src/background-jobs/scheduler.d.ts +5 -5
  168. package/build/src/background-jobs/scheduler.d.ts.map +1 -1
  169. package/build/src/background-jobs/scheduler.js +8 -8
  170. package/build/src/background-jobs/store.js +8 -8
  171. package/build/src/background-jobs/web/controller.js +3 -3
  172. package/build/src/background-jobs/worker.d.ts +6 -6
  173. package/build/src/background-jobs/worker.d.ts.map +1 -1
  174. package/build/src/background-jobs/worker.js +13 -13
  175. package/build/src/beacon/client.d.ts +4 -4
  176. package/build/src/beacon/client.d.ts.map +1 -1
  177. package/build/src/beacon/client.js +12 -9
  178. package/build/src/beacon/in-process-broker.d.ts.map +1 -1
  179. package/build/src/beacon/in-process-broker.js +3 -3
  180. package/build/src/beacon/in-process-client.d.ts +1 -1
  181. package/build/src/beacon/in-process-client.d.ts.map +1 -1
  182. package/build/src/beacon/in-process-client.js +3 -3
  183. package/build/src/beacon/server.d.ts +2 -2
  184. package/build/src/beacon/server.d.ts.map +1 -1
  185. package/build/src/beacon/server.js +4 -4
  186. package/build/src/cli/browser-cli.js +2 -2
  187. package/build/src/cli/commands/db/base-command.d.ts +2 -2
  188. package/build/src/cli/commands/db/base-command.d.ts.map +1 -1
  189. package/build/src/cli/commands/db/base-command.js +3 -3
  190. package/build/src/cli/index.js +3 -3
  191. package/build/src/cli/tenant-database-command-helper.d.ts +1 -1
  192. package/build/src/cli/tenant-database-command-helper.d.ts.map +1 -1
  193. package/build/src/cli/tenant-database-command-helper.js +4 -4
  194. package/build/src/cli/use-browser-cli.js +2 -2
  195. package/build/src/configuration-types.d.ts +12 -2
  196. package/build/src/configuration-types.d.ts.map +1 -1
  197. package/build/src/configuration-types.js +4 -2
  198. package/build/src/configuration.d.ts +14 -14
  199. package/build/src/configuration.d.ts.map +1 -1
  200. package/build/src/configuration.js +39 -39
  201. package/build/src/controller.js +10 -10
  202. package/build/src/current-configuration.js +2 -2
  203. package/build/src/database/annotations-async-hooks.js +3 -3
  204. package/build/src/database/annotations.d.ts.map +1 -1
  205. package/build/src/database/annotations.js +4 -4
  206. package/build/src/database/drivers/base-column.d.ts +1 -1
  207. package/build/src/database/drivers/base-column.d.ts.map +1 -1
  208. package/build/src/database/drivers/base-column.js +2 -2
  209. package/build/src/database/drivers/base-foreign-key.d.ts +1 -1
  210. package/build/src/database/drivers/base-foreign-key.d.ts.map +1 -1
  211. package/build/src/database/drivers/base-foreign-key.js +2 -2
  212. package/build/src/database/drivers/base-table.d.ts +1 -1
  213. package/build/src/database/drivers/base-table.d.ts.map +1 -1
  214. package/build/src/database/drivers/base-table.js +2 -2
  215. package/build/src/database/drivers/base.d.ts +6 -6
  216. package/build/src/database/drivers/base.d.ts.map +1 -1
  217. package/build/src/database/drivers/base.js +11 -11
  218. package/build/src/database/drivers/mssql/index.js +2 -2
  219. package/build/src/database/drivers/mssql/table.js +2 -2
  220. package/build/src/database/drivers/mysql/index.js +4 -4
  221. package/build/src/database/drivers/mysql/query.js +2 -2
  222. package/build/src/database/drivers/mysql/table.js +2 -2
  223. package/build/src/database/drivers/pgsql/index.js +3 -3
  224. package/build/src/database/drivers/sqlite/base.d.ts +3 -3
  225. package/build/src/database/drivers/sqlite/base.d.ts.map +1 -1
  226. package/build/src/database/drivers/sqlite/base.js +17 -17
  227. package/build/src/database/drivers/sqlite/index.d.ts +4 -4
  228. package/build/src/database/drivers/sqlite/index.d.ts.map +1 -1
  229. package/build/src/database/drivers/sqlite/index.js +12 -12
  230. package/build/src/database/drivers/sqlite/index.native.js +2 -2
  231. package/build/src/database/drivers/sqlite/index.web.d.ts +2 -2
  232. package/build/src/database/drivers/sqlite/index.web.d.ts.map +1 -1
  233. package/build/src/database/drivers/sqlite/index.web.js +4 -4
  234. package/build/src/database/drivers/sqlite/query.js +2 -2
  235. package/build/src/database/drivers/sqlite/query.web.js +2 -2
  236. package/build/src/database/drivers/sqlite/sql/alter-table.js +3 -3
  237. package/build/src/database/drivers/sqlite/table.js +2 -2
  238. package/build/src/database/migrator/files-finder.js +2 -2
  239. package/build/src/database/migrator.d.ts +1 -1
  240. package/build/src/database/migrator.d.ts.map +1 -1
  241. package/build/src/database/migrator.js +7 -7
  242. package/build/src/database/pool/async-tracked-multi-connection.d.ts +9 -9
  243. package/build/src/database/pool/async-tracked-multi-connection.d.ts.map +1 -1
  244. package/build/src/database/pool/async-tracked-multi-connection.js +28 -28
  245. package/build/src/database/pool/base-methods-forward.js +7 -7
  246. package/build/src/database/pool/base.d.ts +1 -1
  247. package/build/src/database/pool/base.d.ts.map +1 -1
  248. package/build/src/database/pool/base.js +9 -9
  249. package/build/src/database/query/from-base.d.ts +1 -1
  250. package/build/src/database/query/from-base.d.ts.map +1 -1
  251. package/build/src/database/query/from-base.js +2 -2
  252. package/build/src/database/query/index.d.ts +4 -4
  253. package/build/src/database/query/index.d.ts.map +1 -1
  254. package/build/src/database/query/index.js +11 -11
  255. package/build/src/database/query/join-object.js +4 -4
  256. package/build/src/database/query/model-class-query.d.ts +4 -4
  257. package/build/src/database/query/model-class-query.d.ts.map +1 -1
  258. package/build/src/database/query/model-class-query.js +40 -40
  259. package/build/src/database/query/preloader/belongs-to.js +23 -23
  260. package/build/src/database/query/preloader/has-many.js +21 -21
  261. package/build/src/database/query/preloader/has-one.js +9 -9
  262. package/build/src/database/query/preloader/selection.js +4 -4
  263. package/build/src/database/query/preloader.js +9 -9
  264. package/build/src/database/query/query-data.js +10 -10
  265. package/build/src/database/query/where-model-class-hash.js +8 -8
  266. package/build/src/database/query/with-count.js +10 -10
  267. package/build/src/database/record/acts-as-list.js +20 -20
  268. package/build/src/database/record/attachments/handle.d.ts +1 -1
  269. package/build/src/database/record/attachments/handle.d.ts.map +1 -1
  270. package/build/src/database/record/attachments/handle.js +3 -3
  271. package/build/src/database/record/attachments/normalize-input.js +15 -15
  272. package/build/src/database/record/attachments/storage-drivers/s3.js +7 -7
  273. package/build/src/database/record/attachments/store.d.ts +2 -2
  274. package/build/src/database/record/attachments/store.d.ts.map +1 -1
  275. package/build/src/database/record/attachments/store.js +14 -14
  276. package/build/src/database/record/index.d.ts +18 -25
  277. package/build/src/database/record/index.d.ts.map +1 -1
  278. package/build/src/database/record/index.js +135 -141
  279. package/build/src/database/record/instance-relationships/base.d.ts +3 -3
  280. package/build/src/database/record/instance-relationships/base.d.ts.map +1 -1
  281. package/build/src/database/record/instance-relationships/base.js +13 -13
  282. package/build/src/database/record/instance-relationships/belongs-to.js +4 -4
  283. package/build/src/database/record/instance-relationships/has-many.js +9 -9
  284. package/build/src/database/record/instance-relationships/has-one.d.ts +1 -1
  285. package/build/src/database/record/instance-relationships/has-one.d.ts.map +1 -1
  286. package/build/src/database/record/instance-relationships/has-one.js +8 -8
  287. package/build/src/database/record/relationships/base.js +4 -4
  288. package/build/src/database/record/state-machine.js +8 -8
  289. package/build/src/database/record/validators/presence.js +2 -2
  290. package/build/src/database/record/validators/uniqueness.js +6 -6
  291. package/build/src/database/table-data/index.d.ts +4 -4
  292. package/build/src/database/table-data/index.d.ts.map +1 -1
  293. package/build/src/database/table-data/index.js +5 -5
  294. package/build/src/environment-handlers/base.js +3 -3
  295. package/build/src/environment-handlers/browser.d.ts +3 -3
  296. package/build/src/environment-handlers/browser.d.ts.map +1 -1
  297. package/build/src/environment-handlers/browser.js +8 -8
  298. package/build/src/environment-handlers/node/cli/commands/cli-command-context.js +2 -2
  299. package/build/src/environment-handlers/node/cli/commands/console.d.ts.map +1 -1
  300. package/build/src/environment-handlers/node/cli/commands/console.js +5 -5
  301. package/build/src/environment-handlers/node/cli/commands/db/schema/dump.d.ts +1 -1
  302. package/build/src/environment-handlers/node/cli/commands/db/schema/dump.d.ts.map +1 -1
  303. package/build/src/environment-handlers/node/cli/commands/db/schema/dump.js +2 -2
  304. package/build/src/environment-handlers/node/cli/commands/db/schema/load.d.ts +1 -1
  305. package/build/src/environment-handlers/node/cli/commands/db/schema/load.d.ts.map +1 -1
  306. package/build/src/environment-handlers/node/cli/commands/db/schema/load.js +4 -4
  307. package/build/src/environment-handlers/node/cli/commands/generate/frontend-models.d.ts +285 -12
  308. package/build/src/environment-handlers/node/cli/commands/generate/frontend-models.d.ts.map +1 -1
  309. package/build/src/environment-handlers/node/cli/commands/generate/frontend-models.js +712 -61
  310. package/build/src/environment-handlers/node.d.ts +2 -2
  311. package/build/src/environment-handlers/node.d.ts.map +1 -1
  312. package/build/src/environment-handlers/node.js +7 -7
  313. package/build/src/frontend-model-controller.d.ts +5 -6
  314. package/build/src/frontend-model-controller.d.ts.map +1 -1
  315. package/build/src/frontend-model-controller.js +88 -89
  316. package/build/src/frontend-model-resource/base-resource.d.ts +36 -27
  317. package/build/src/frontend-model-resource/base-resource.d.ts.map +1 -1
  318. package/build/src/frontend-model-resource/base-resource.js +67 -120
  319. package/build/src/frontend-models/base.d.ts +67 -59
  320. package/build/src/frontend-models/base.d.ts.map +1 -1
  321. package/build/src/frontend-models/base.js +171 -158
  322. package/build/src/frontend-models/clear-pending-debounced-callback.js +2 -2
  323. package/build/src/frontend-models/event-hook-models.d.ts.map +1 -1
  324. package/build/src/frontend-models/event-hook-models.js +3 -3
  325. package/build/src/frontend-models/outgoing-event-buffer.d.ts +1 -1
  326. package/build/src/frontend-models/outgoing-event-buffer.d.ts.map +1 -1
  327. package/build/src/frontend-models/outgoing-event-buffer.js +3 -3
  328. package/build/src/frontend-models/preloader.js +6 -6
  329. package/build/src/frontend-models/query.d.ts +16 -8
  330. package/build/src/frontend-models/query.d.ts.map +1 -1
  331. package/build/src/frontend-models/query.js +43 -39
  332. package/build/src/frontend-models/resource-definition.js +7 -7
  333. package/build/src/frontend-models/transport-serialization.js +12 -12
  334. package/build/src/frontend-models/use-destroyed-event.d.ts.map +1 -1
  335. package/build/src/frontend-models/use-destroyed-event.js +11 -11
  336. package/build/src/frontend-models/use-model-class-event.d.ts.map +1 -1
  337. package/build/src/frontend-models/use-model-class-event.js +12 -12
  338. package/build/src/frontend-models/use-updated-event.d.ts.map +1 -1
  339. package/build/src/frontend-models/use-updated-event.js +12 -12
  340. package/build/src/frontend-models/websocket-channel.d.ts +6 -1
  341. package/build/src/frontend-models/websocket-channel.d.ts.map +1 -1
  342. package/build/src/frontend-models/websocket-channel.js +26 -18
  343. package/build/src/frontend-models/websocket-publishers.js +11 -11
  344. package/build/src/http-client/response.d.ts +2 -2
  345. package/build/src/http-client/response.d.ts.map +1 -1
  346. package/build/src/http-client/response.js +3 -3
  347. package/build/src/http-server/client/index.d.ts +1 -1
  348. package/build/src/http-server/client/index.d.ts.map +1 -1
  349. package/build/src/http-server/client/index.js +9 -9
  350. package/build/src/http-server/client/params-to-object.js +11 -11
  351. package/build/src/http-server/client/request-buffer/form-data-part.d.ts +2 -2
  352. package/build/src/http-server/client/request-buffer/form-data-part.d.ts.map +1 -1
  353. package/build/src/http-server/client/request-buffer/form-data-part.js +3 -3
  354. package/build/src/http-server/client/request-buffer/index.d.ts +4 -4
  355. package/build/src/http-server/client/request-buffer/index.d.ts.map +1 -1
  356. package/build/src/http-server/client/request-buffer/index.js +9 -9
  357. package/build/src/http-server/client/request-parser.d.ts +1 -1
  358. package/build/src/http-server/client/request-parser.d.ts.map +1 -1
  359. package/build/src/http-server/client/request-parser.js +4 -4
  360. package/build/src/http-server/client/request-runner.js +7 -7
  361. package/build/src/http-server/client/request-timing.d.ts +5 -5
  362. package/build/src/http-server/client/request-timing.d.ts.map +1 -1
  363. package/build/src/http-server/client/request-timing.js +6 -6
  364. package/build/src/http-server/client/request.js +2 -2
  365. package/build/src/http-server/client/response.d.ts +3 -3
  366. package/build/src/http-server/client/response.d.ts.map +1 -1
  367. package/build/src/http-server/client/response.js +6 -6
  368. package/build/src/http-server/client/websocket-request.d.ts +3 -3
  369. package/build/src/http-server/client/websocket-request.d.ts.map +1 -1
  370. package/build/src/http-server/client/websocket-request.js +5 -5
  371. package/build/src/http-server/client/websocket-session.d.ts +6 -6
  372. package/build/src/http-server/client/websocket-session.d.ts.map +1 -1
  373. package/build/src/http-server/client/websocket-session.js +19 -19
  374. package/build/src/http-server/development-reloader.d.ts +3 -3
  375. package/build/src/http-server/development-reloader.d.ts.map +1 -1
  376. package/build/src/http-server/development-reloader.js +6 -6
  377. package/build/src/http-server/index.d.ts +7 -7
  378. package/build/src/http-server/index.d.ts.map +1 -1
  379. package/build/src/http-server/index.js +13 -13
  380. package/build/src/http-server/remote-address.js +6 -6
  381. package/build/src/http-server/server-client.js +4 -4
  382. package/build/src/http-server/server-lock.js +5 -5
  383. package/build/src/http-server/websocket-channel-subscribers.d.ts +1 -1
  384. package/build/src/http-server/websocket-channel-subscribers.d.ts.map +1 -1
  385. package/build/src/http-server/websocket-channel-subscribers.js +4 -4
  386. package/build/src/http-server/websocket-channel.d.ts +1 -1
  387. package/build/src/http-server/websocket-channel.d.ts.map +1 -1
  388. package/build/src/http-server/websocket-channel.js +2 -2
  389. package/build/src/http-server/websocket-connection.d.ts +1 -1
  390. package/build/src/http-server/websocket-connection.d.ts.map +1 -1
  391. package/build/src/http-server/websocket-connection.js +2 -2
  392. package/build/src/http-server/websocket-event-log-store.d.ts +1 -1
  393. package/build/src/http-server/websocket-event-log-store.d.ts.map +1 -1
  394. package/build/src/http-server/websocket-event-log-store.js +7 -7
  395. package/build/src/http-server/websocket-events-host.d.ts +1 -1
  396. package/build/src/http-server/websocket-events-host.d.ts.map +1 -1
  397. package/build/src/http-server/websocket-events-host.js +3 -3
  398. package/build/src/http-server/worker-handler/in-process.d.ts +3 -3
  399. package/build/src/http-server/worker-handler/in-process.d.ts.map +1 -1
  400. package/build/src/http-server/worker-handler/in-process.js +9 -9
  401. package/build/src/http-server/worker-handler/index.d.ts +4 -4
  402. package/build/src/http-server/worker-handler/index.d.ts.map +1 -1
  403. package/build/src/http-server/worker-handler/index.js +5 -5
  404. package/build/src/http-server/worker-handler/worker-thread.d.ts +2 -2
  405. package/build/src/http-server/worker-handler/worker-thread.d.ts.map +1 -1
  406. package/build/src/http-server/worker-handler/worker-thread.js +4 -4
  407. package/build/src/logger/outputs/array-output.d.ts +3 -3
  408. package/build/src/logger/outputs/array-output.d.ts.map +1 -1
  409. package/build/src/logger/outputs/array-output.js +4 -4
  410. package/build/src/logger/outputs/console-output.d.ts +1 -1
  411. package/build/src/logger/outputs/console-output.d.ts.map +1 -1
  412. package/build/src/logger/outputs/console-output.js +2 -2
  413. package/build/src/logger/outputs/file-output.d.ts +4 -4
  414. package/build/src/logger/outputs/file-output.d.ts.map +1 -1
  415. package/build/src/logger/outputs/file-output.js +5 -5
  416. package/build/src/logger/outputs/stdout-output.d.ts.map +1 -1
  417. package/build/src/logger/outputs/stdout-output.js +2 -2
  418. package/build/src/logger.d.ts.map +1 -1
  419. package/build/src/logger.js +11 -11
  420. package/build/src/mailer/backends/smtp.d.ts.map +1 -1
  421. package/build/src/mailer/backends/smtp.js +5 -5
  422. package/build/src/mailer/base.js +11 -11
  423. package/build/src/mailer/delivery.d.ts +3 -3
  424. package/build/src/mailer/delivery.d.ts.map +1 -1
  425. package/build/src/mailer/delivery.js +5 -5
  426. package/build/src/plugins/sqljs-wasm-route-controller.js +2 -2
  427. package/build/src/routes/base-route.d.ts +6 -6
  428. package/build/src/routes/base-route.d.ts.map +1 -1
  429. package/build/src/routes/base-route.js +7 -7
  430. package/build/src/routes/basic-route.js +2 -2
  431. package/build/src/routes/hooks/frontend-model-command-route-hook.js +2 -2
  432. package/build/src/routes/index.js +2 -2
  433. package/build/src/routes/plugin-routes.js +2 -2
  434. package/build/src/routes/resolver.d.ts +1 -1
  435. package/build/src/routes/resolver.d.ts.map +1 -1
  436. package/build/src/routes/resolver.js +13 -13
  437. package/build/src/routes/resource-route.d.ts +1 -1
  438. package/build/src/routes/resource-route.d.ts.map +1 -1
  439. package/build/src/routes/resource-route.js +2 -2
  440. package/build/src/testing/browser-frontend-model-event-hook-scenarios.d.ts.map +1 -1
  441. package/build/src/testing/browser-frontend-model-event-hook-scenarios.js +8 -8
  442. package/build/src/testing/expect-utils.js +13 -13
  443. package/build/src/testing/expect.d.ts +1 -1
  444. package/build/src/testing/expect.d.ts.map +1 -1
  445. package/build/src/testing/expect.js +9 -9
  446. package/build/src/testing/test-files-finder.d.ts +8 -8
  447. package/build/src/testing/test-files-finder.d.ts.map +1 -1
  448. package/build/src/testing/test-files-finder.js +9 -9
  449. package/build/src/testing/test-filter-parser.js +3 -3
  450. package/build/src/testing/test-runner.d.ts +2 -2
  451. package/build/src/testing/test-runner.d.ts.map +1 -1
  452. package/build/src/testing/test-runner.js +17 -17
  453. package/build/src/testing/test-suite-splitter.js +2 -2
  454. package/build/src/testing/test.d.ts +2 -2
  455. package/build/src/testing/test.d.ts.map +1 -1
  456. package/build/src/testing/test.js +16 -16
  457. package/build/src/utils/backtrace-cleaner.d.ts +1 -1
  458. package/build/src/utils/backtrace-cleaner.d.ts.map +1 -1
  459. package/build/src/utils/backtrace-cleaner.js +2 -2
  460. package/build/src/utils/format-value.js +2 -2
  461. package/build/src/utils/model-scope.js +2 -2
  462. package/build/src/utils/ransack.js +27 -27
  463. package/build/src/utils/with-tracked-stack-async-hooks.js +8 -8
  464. package/build/src/utils/with-tracked-stack.js +4 -4
  465. package/build/testing/browser-frontend-model-event-hook-scenarios.js +7 -7
  466. package/build/testing/expect-utils.js +11 -11
  467. package/build/testing/expect.js +7 -7
  468. package/build/testing/test-files-finder.js +8 -8
  469. package/build/testing/test-filter-parser.js +2 -2
  470. package/build/testing/test-runner.js +16 -16
  471. package/build/testing/test-suite-splitter.js +1 -1
  472. package/build/testing/test.js +15 -15
  473. package/build/utils/backtrace-cleaner.js +1 -1
  474. package/build/utils/format-value.js +1 -1
  475. package/build/utils/model-scope.js +1 -1
  476. package/build/utils/ransack.js +26 -26
  477. package/build/utils/with-tracked-stack-async-hooks.js +7 -7
  478. package/build/utils/with-tracked-stack.js +3 -3
  479. package/package.json +2 -1
  480. package/src/application.js +4 -4
  481. package/src/authorization/ability.js +8 -8
  482. package/src/authorization/base-resource.js +4 -4
  483. package/src/background-jobs/cron-expression.js +1 -1
  484. package/src/background-jobs/forked-runner-child.js +1 -1
  485. package/src/background-jobs/job-registry.js +1 -1
  486. package/src/background-jobs/job-runner.js +1 -1
  487. package/src/background-jobs/job.js +1 -1
  488. package/src/background-jobs/json-socket.js +4 -4
  489. package/src/background-jobs/main.js +21 -21
  490. package/src/background-jobs/scheduler.js +7 -7
  491. package/src/background-jobs/store.js +7 -7
  492. package/src/background-jobs/web/controller.js +2 -2
  493. package/src/background-jobs/worker.js +12 -12
  494. package/src/beacon/client.js +11 -8
  495. package/src/beacon/in-process-broker.js +2 -2
  496. package/src/beacon/in-process-client.js +2 -2
  497. package/src/beacon/server.js +3 -3
  498. package/src/cli/browser-cli.js +1 -1
  499. package/src/cli/commands/db/base-command.js +2 -2
  500. package/src/cli/index.js +2 -2
  501. package/src/cli/tenant-database-command-helper.js +3 -3
  502. package/src/cli/use-browser-cli.js +1 -1
  503. package/src/configuration-types.js +3 -1
  504. package/src/configuration.js +38 -38
  505. package/src/controller.js +8 -8
  506. package/src/current-configuration.js +1 -1
  507. package/src/database/annotations-async-hooks.js +2 -2
  508. package/src/database/annotations.js +3 -3
  509. package/src/database/drivers/base-column.js +1 -1
  510. package/src/database/drivers/base-foreign-key.js +1 -1
  511. package/src/database/drivers/base-table.js +1 -1
  512. package/src/database/drivers/base.js +10 -10
  513. package/src/database/drivers/mssql/index.js +1 -1
  514. package/src/database/drivers/mssql/table.js +1 -1
  515. package/src/database/drivers/mysql/index.js +3 -3
  516. package/src/database/drivers/mysql/query.js +1 -1
  517. package/src/database/drivers/mysql/table.js +1 -1
  518. package/src/database/drivers/pgsql/index.js +2 -2
  519. package/src/database/drivers/sqlite/base.js +16 -16
  520. package/src/database/drivers/sqlite/index.js +11 -11
  521. package/src/database/drivers/sqlite/index.native.js +1 -1
  522. package/src/database/drivers/sqlite/index.web.js +3 -3
  523. package/src/database/drivers/sqlite/query.js +1 -1
  524. package/src/database/drivers/sqlite/query.web.js +1 -1
  525. package/src/database/drivers/sqlite/sql/alter-table.js +2 -2
  526. package/src/database/drivers/sqlite/table.js +1 -1
  527. package/src/database/migrator/files-finder.js +1 -1
  528. package/src/database/migrator.js +6 -6
  529. package/src/database/pool/async-tracked-multi-connection.js +27 -27
  530. package/src/database/pool/base-methods-forward.js +4 -4
  531. package/src/database/pool/base.js +8 -8
  532. package/src/database/query/from-base.js +1 -1
  533. package/src/database/query/index.js +10 -10
  534. package/src/database/query/join-object.js +3 -3
  535. package/src/database/query/model-class-query.js +39 -39
  536. package/src/database/query/preloader/belongs-to.js +22 -22
  537. package/src/database/query/preloader/has-many.js +20 -20
  538. package/src/database/query/preloader/has-one.js +8 -8
  539. package/src/database/query/preloader/selection.js +3 -3
  540. package/src/database/query/preloader.js +8 -8
  541. package/src/database/query/query-data.js +9 -9
  542. package/src/database/query/where-model-class-hash.js +7 -7
  543. package/src/database/query/with-count.js +9 -9
  544. package/src/database/record/acts-as-list.js +15 -15
  545. package/src/database/record/attachments/handle.js +2 -2
  546. package/src/database/record/attachments/normalize-input.js +12 -12
  547. package/src/database/record/attachments/storage-drivers/s3.js +6 -6
  548. package/src/database/record/attachments/store.js +13 -13
  549. package/src/database/record/index.js +115 -121
  550. package/src/database/record/instance-relationships/base.js +11 -11
  551. package/src/database/record/instance-relationships/belongs-to.js +3 -3
  552. package/src/database/record/instance-relationships/has-many.js +8 -8
  553. package/src/database/record/instance-relationships/has-one.js +7 -7
  554. package/src/database/record/relationships/base.js +2 -2
  555. package/src/database/record/state-machine.js +7 -7
  556. package/src/database/record/validators/presence.js +1 -1
  557. package/src/database/record/validators/uniqueness.js +5 -5
  558. package/src/database/table-data/index.js +4 -4
  559. package/src/environment-handlers/base.js +2 -2
  560. package/src/environment-handlers/browser.js +7 -7
  561. package/src/environment-handlers/node/cli/commands/cli-command-context.js +1 -1
  562. package/src/environment-handlers/node/cli/commands/console.js +4 -4
  563. package/src/environment-handlers/node/cli/commands/db/schema/dump.js +1 -1
  564. package/src/environment-handlers/node/cli/commands/db/schema/load.js +3 -3
  565. package/src/environment-handlers/node/cli/commands/generate/frontend-models.js +836 -60
  566. package/src/environment-handlers/node.js +6 -6
  567. package/src/frontend-model-controller.js +81 -82
  568. package/src/frontend-model-resource/base-resource.js +78 -115
  569. package/src/frontend-models/base.js +162 -149
  570. package/src/frontend-models/clear-pending-debounced-callback.js +1 -1
  571. package/src/frontend-models/event-hook-models.js +2 -2
  572. package/src/frontend-models/outgoing-event-buffer.js +2 -2
  573. package/src/frontend-models/preloader.js +5 -5
  574. package/src/frontend-models/query.js +43 -38
  575. package/src/frontend-models/resource-definition.js +6 -6
  576. package/src/frontend-models/transport-serialization.js +11 -11
  577. package/src/frontend-models/use-destroyed-event.js +10 -10
  578. package/src/frontend-models/use-model-class-event.js +11 -11
  579. package/src/frontend-models/use-updated-event.js +11 -11
  580. package/src/frontend-models/websocket-channel.js +26 -17
  581. package/src/frontend-models/websocket-publishers.js +9 -9
  582. package/src/http-client/response.js +2 -2
  583. package/src/http-server/client/index.js +8 -8
  584. package/src/http-server/client/params-to-object.js +10 -10
  585. package/src/http-server/client/request-buffer/form-data-part.js +2 -2
  586. package/src/http-server/client/request-buffer/index.js +8 -8
  587. package/src/http-server/client/request-parser.js +3 -3
  588. package/src/http-server/client/request-runner.js +6 -6
  589. package/src/http-server/client/request-timing.js +5 -5
  590. package/src/http-server/client/request.js +1 -1
  591. package/src/http-server/client/response.js +5 -5
  592. package/src/http-server/client/websocket-request.js +4 -4
  593. package/src/http-server/client/websocket-session.js +18 -18
  594. package/src/http-server/development-reloader.js +5 -5
  595. package/src/http-server/index.js +12 -12
  596. package/src/http-server/remote-address.js +4 -4
  597. package/src/http-server/server-client.js +3 -3
  598. package/src/http-server/server-lock.js +4 -4
  599. package/src/http-server/websocket-channel-subscribers.js +3 -3
  600. package/src/http-server/websocket-channel.js +1 -1
  601. package/src/http-server/websocket-connection.js +1 -1
  602. package/src/http-server/websocket-event-log-store.js +6 -6
  603. package/src/http-server/websocket-events-host.js +2 -2
  604. package/src/http-server/worker-handler/in-process.js +7 -7
  605. package/src/http-server/worker-handler/index.js +4 -4
  606. package/src/http-server/worker-handler/worker-thread.js +3 -3
  607. package/src/logger/outputs/array-output.js +3 -3
  608. package/src/logger/outputs/console-output.js +1 -1
  609. package/src/logger/outputs/file-output.js +4 -4
  610. package/src/logger/outputs/stdout-output.js +1 -1
  611. package/src/logger.js +10 -10
  612. package/src/mailer/backends/smtp.js +3 -3
  613. package/src/mailer/base.js +8 -8
  614. package/src/mailer/delivery.js +4 -4
  615. package/src/plugins/sqljs-wasm-route-controller.js +1 -1
  616. package/src/routes/base-route.js +6 -6
  617. package/src/routes/basic-route.js +1 -1
  618. package/src/routes/hooks/frontend-model-command-route-hook.js +1 -1
  619. package/src/routes/index.js +1 -1
  620. package/src/routes/plugin-routes.js +1 -1
  621. package/src/routes/resolver.js +11 -11
  622. package/src/routes/resource-route.js +1 -1
  623. package/src/testing/browser-frontend-model-event-hook-scenarios.js +7 -7
  624. package/src/testing/expect-utils.js +11 -11
  625. package/src/testing/expect.js +7 -7
  626. package/src/testing/test-files-finder.js +8 -8
  627. package/src/testing/test-filter-parser.js +2 -2
  628. package/src/testing/test-runner.js +16 -16
  629. package/src/testing/test-suite-splitter.js +1 -1
  630. package/src/testing/test.js +15 -15
  631. package/src/utils/backtrace-cleaner.js +1 -1
  632. package/src/utils/format-value.js +1 -1
  633. package/src/utils/model-scope.js +1 -1
  634. package/src/utils/ransack.js +26 -26
  635. package/src/utils/with-tracked-stack-async-hooks.js +7 -7
  636. package/src/utils/with-tracked-stack.js +3 -3
@@ -23,12 +23,12 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
23
23
  async run() {
24
24
  /**
25
25
  * Models primary key values.
26
- @type {Array<number | string>} */
26
+ * @type {Array<number | string>} */
27
27
  const modelsPrimaryKeyValues = []
28
28
 
29
29
  /**
30
30
  * Models by primary key value.
31
- @type {Record<number | string, Array<import("../../record/index.js").default>>} */
31
+ * @type {Record<number | string, Array<import("../../record/index.js").default>>} */
32
32
  const modelsByPrimaryKeyValue = {}
33
33
 
34
34
  const foreignKey = this.relationship.getForeignKey()
@@ -41,12 +41,12 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
41
41
 
42
42
  /**
43
43
  * Preload collections.
44
- @type {Record<number | string, import("../../record/index.js").default | undefined>} */
44
+ * @type {Record<number | string, import("../../record/index.js").default | undefined>} */
45
45
  const preloadCollections = {}
46
46
 
47
47
  /**
48
48
  * Satisfied targets.
49
- @type {import("../../record/index.js").default[]} */
49
+ * @type {import("../../record/index.js").default[]} */
50
50
  const satisfiedTargets = []
51
51
 
52
52
  for (const model of this.models) {
@@ -55,7 +55,7 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
55
55
  if (this.selection.isSatisfied({instanceRelationship, targetModelClass, mappingColumns: [foreignKey]})) {
56
56
  const loaded = /**
57
57
  * Narrows the runtime value to the documented type.
58
- @type {import("../../record/index.js").default | undefined} */ (instanceRelationship.getLoadedOrUndefined())
58
+ * @type {import("../../record/index.js").default | undefined} */ (instanceRelationship.getLoadedOrUndefined())
59
59
 
60
60
  if (loaded) satisfiedTargets.push(loaded)
61
61
  continue
@@ -63,7 +63,7 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
63
63
 
64
64
  const primaryKeyValue = /**
65
65
  * Narrows the runtime value to the documented type.
66
- @type {string | number} */ (model.readColumn(primaryKey))
66
+ * @type {string | number} */ (model.readColumn(primaryKey))
67
67
 
68
68
  preloadCollections[primaryKeyValue] = undefined
69
69
 
@@ -77,7 +77,7 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
77
77
 
78
78
  /**
79
79
  * Where args.
80
- @type {Record<string, string | number | Array<string | number>>} */
80
+ * @type {Record<string, string | number | Array<string | number>>} */
81
81
  const whereArgs = {}
82
82
 
83
83
  whereArgs[foreignKey] = modelsPrimaryKeyValues
@@ -101,7 +101,7 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
101
101
  for (const targetModel of targetModels) {
102
102
  const foreignKeyValue = /**
103
103
  * Narrows the runtime value to the documented type.
104
- @type {string | number} */ (targetModel.readColumn(foreignKey))
104
+ * @type {string | number} */ (targetModel.readColumn(foreignKey))
105
105
 
106
106
  preloadCollections[foreignKeyValue] = targetModel
107
107
  }
@@ -70,13 +70,13 @@ export default class VelociousDatabaseQueryPreloaderSelection {
70
70
  if (narrowing) {
71
71
  const selects = [...new Set([...narrowing, ...mappingColumns, ...(extra || [])])]
72
72
 
73
- return /** Narrows the runtime value to the documented type. @type {T} */ (query.select(selects))
73
+ return /** @type {T} */ (query.select(selects))
74
74
  }
75
75
 
76
76
  if (extra) {
77
77
  const allColumns = `${query.driver.quoteTable(targetModelClass.tableName())}.*`
78
78
 
79
- return /** Narrows the runtime value to the documented type. @type {T} */ (query.select([allColumns, ...extra]))
79
+ return /** @type {T} */ (query.select([allColumns, ...extra]))
80
80
  }
81
81
 
82
82
  return query
@@ -129,7 +129,7 @@ export default class VelociousDatabaseQueryPreloaderSelection {
129
129
  const extra = this._extraFor(targetModelClass)
130
130
  /**
131
131
  * Columns.
132
- @type {string[]} */
132
+ * @type {string[]} */
133
133
  const columns = []
134
134
 
135
135
  if (narrowing) {
@@ -21,7 +21,7 @@ function normalizeNestedPreload(preload) {
21
21
  if (Array.isArray(preload)) {
22
22
  /**
23
23
  * Result.
24
- @type {import("../query/index.js").NestedPreloadRecord} */
24
+ * @type {import("../query/index.js").NestedPreloadRecord} */
25
25
  const result = {}
26
26
 
27
27
  for (const entry of preload) {
@@ -50,7 +50,7 @@ function normalizeNestedPreload(preload) {
50
50
  if (preload && typeof preload == "object") {
51
51
  /**
52
52
  * Result.
53
- @type {import("../query/index.js").NestedPreloadRecord} */
53
+ * @type {import("../query/index.js").NestedPreloadRecord} */
54
54
  const result = {}
55
55
 
56
56
  for (const [key, value] of Object.entries(preload)) {
@@ -90,17 +90,17 @@ export default class VelociousDatabaseQueryPreloader {
90
90
 
91
91
  const modelClass = /**
92
92
  * Narrows the runtime value to the documented type.
93
- @type {typeof import("../record/index.js").default} */ (models[0].constructor)
93
+ * @type {typeof import("../record/index.js").default} */ (models[0].constructor)
94
94
  const isQuery = Boolean(queryOrSpec) && typeof queryOrSpec == "object" && "_preload" in queryOrSpec
95
95
  // Reuse the query builder's preload/select normalization for raw specs
96
96
  // instead of duplicating it here.
97
97
  const query = isQuery
98
98
  ? /**
99
99
  * Narrows the runtime value to the documented type.
100
- @type {import("./model-class-query.js").default} */ (queryOrSpec)
100
+ * @type {import("./model-class-query.js").default} */ (queryOrSpec)
101
101
  : modelClass.preload(/**
102
102
  * Narrows the runtime value to the documented type.
103
- @type {?} */ (queryOrSpec))
103
+ * @type {?} */ (queryOrSpec))
104
104
 
105
105
  const preloader = new VelociousDatabaseQueryPreloader({
106
106
  modelClass,
@@ -143,21 +143,21 @@ export default class VelociousDatabaseQueryPreloader {
143
143
  if (relationship.getType() == "belongsTo") {
144
144
  const belongsToRelationship = /**
145
145
  * Narrows the runtime value to the documented type.
146
- @type {import("../record/relationships/belongs-to.js").default} */ (relationship)
146
+ * @type {import("../record/relationships/belongs-to.js").default} */ (relationship)
147
147
  const hasManyPreloader = new BelongsToPreloader({models: this.models, relationship: belongsToRelationship, selection: this.selection})
148
148
 
149
149
  preloadResult = await hasManyPreloader.run()
150
150
  } else if (relationship.getType() == "hasMany") {
151
151
  const hasManyRelationship = /**
152
152
  * Narrows the runtime value to the documented type.
153
- @type {import("../record/relationships/has-many.js").default} */ (relationship)
153
+ * @type {import("../record/relationships/has-many.js").default} */ (relationship)
154
154
  const hasManyPreloader = new HasManyPreloader({models: this.models, relationship: hasManyRelationship, selection: this.selection})
155
155
 
156
156
  preloadResult = await hasManyPreloader.run()
157
157
  } else if (relationship.getType() == "hasOne") {
158
158
  const hasOneRelationship = /**
159
159
  * Narrows the runtime value to the documented type.
160
- @type {import("../record/relationships/has-one.js").default} */ (relationship)
160
+ * @type {import("../record/relationships/has-one.js").default} */ (relationship)
161
161
  const hasOnePreloader = new HasOnePreloader({models: this.models, relationship: hasOneRelationship, selection: this.selection})
162
162
 
163
163
  preloadResult = await hasOnePreloader.run()
@@ -59,7 +59,7 @@ export function normalizeQueryDataSpec(spec, chain = []) {
59
59
  if (Array.isArray(spec)) {
60
60
  /**
61
61
  * Entries.
62
- @type {QueryDataEntry[]} */
62
+ * @type {QueryDataEntry[]} */
63
63
  const entries = []
64
64
 
65
65
  for (const item of spec) {
@@ -71,7 +71,7 @@ export function normalizeQueryDataSpec(spec, chain = []) {
71
71
  if (isPlainObject(item)) {
72
72
  for (const nested of normalizeQueryDataSpec(/**
73
73
  * Narrows the runtime value to the documented type.
74
- @type {?} */ (item), chain)) {
74
+ * @type {?} */ (item), chain)) {
75
75
  entries.push(nested)
76
76
  }
77
77
  continue
@@ -86,7 +86,7 @@ export function normalizeQueryDataSpec(spec, chain = []) {
86
86
  if (isPlainObject(spec)) {
87
87
  /**
88
88
  * Entries.
89
- @type {QueryDataEntry[]} */
89
+ * @type {QueryDataEntry[]} */
90
90
  const entries = []
91
91
 
92
92
  for (const [key, value] of Object.entries(spec)) {
@@ -100,7 +100,7 @@ export function normalizeQueryDataSpec(spec, chain = []) {
100
100
  if (typeof value === "string" || Array.isArray(value) || isPlainObject(value)) {
101
101
  for (const nested of normalizeQueryDataSpec(/**
102
102
  * Narrows the runtime value to the documented type.
103
- @type {?} */ (value), [...chain, key])) {
103
+ * @type {?} */ (value), [...chain, key])) {
104
104
  entries.push(nested)
105
105
  }
106
106
  continue
@@ -128,7 +128,7 @@ function buildNestedJoinDescriptor(chain) {
128
128
 
129
129
  /**
130
130
  * Obj.
131
- @type {Record<string, ?>} */
131
+ * @type {Record<string, ?>} */
132
132
  const obj = {}
133
133
  let cursor = obj
134
134
 
@@ -195,7 +195,7 @@ export async function runQueryData({rootModelClass, rootModels, entries}) {
195
195
  const primaryKey = rootModelClass.primaryKey()
196
196
  const rootIds = rootModels.map((model) => /**
197
197
  * Narrows the runtime value to the documented type.
198
- @type {string | number} */ (model.readColumn(primaryKey)))
198
+ * @type {string | number} */ (model.readColumn(primaryKey)))
199
199
 
200
200
  for (const entry of entries) {
201
201
  await runEntry({entry, primaryKey, rootIds, rootModelClass, rootModels})
@@ -239,7 +239,7 @@ async function runEntry({entry, primaryKey, rootIds, rootModelClass, rootModels}
239
239
 
240
240
  /**
241
241
  * Root where.
242
- @type {Record<string, ?>} */
242
+ * @type {Record<string, ?>} */
243
243
  const rootWhere = {}
244
244
  rootWhere[primaryKey] = rootIds
245
245
  query.where(rootWhere)
@@ -272,7 +272,7 @@ async function runEntry({entry, primaryKey, rootIds, rootModelClass, rootModels}
272
272
 
273
273
  const rows = /**
274
274
  * Narrows the runtime value to the documented type.
275
- @type {Array<Record<string, ?>>} */ (await query._executeQuery())
275
+ * @type {Array<Record<string, ?>>} */ (await query._executeQuery())
276
276
  const byParent = new Map()
277
277
 
278
278
  for (const row of rows) {
@@ -286,7 +286,7 @@ async function runEntry({entry, primaryKey, rootIds, rootModelClass, rootModels}
286
286
  for (const model of rootModels) {
287
287
  const modelId = /**
288
288
  * Narrows the runtime value to the documented type.
289
- @type {string | number} */ (model.readColumn(primaryKey))
289
+ * @type {string | number} */ (model.readColumn(primaryKey))
290
290
  // Driver-type tolerance: MySQL can return PKs as strings even when
291
291
  // the column is numeric. Fall back to a string lookup so results
292
292
  // still land on the right model.
@@ -25,10 +25,10 @@ function normalizeRelationshipWhereOperator(operator) {
25
25
  ">=": "gteq"
26
26
  }
27
27
 
28
- return /** Narrows the runtime value to the documented type. @type {"eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like"} */ (
28
+ return /** @type {"eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like"} */ (
29
29
  operatorAliases[/**
30
30
  * Narrows the runtime value to the documented type.
31
- @type {"<" | "<=" | ">" | ">="} */ (operator)] || operator
31
+ * @type {"<" | "<=" | ">" | ">="} */ (operator)] || operator
32
32
  )
33
33
  }
34
34
 
@@ -68,7 +68,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
68
68
 
69
69
  const modelQuery = /**
70
70
  * Narrows the runtime value to the documented type.
71
- @type {import("./model-class-query.js").default} */ (this.query)
71
+ * @type {import("./model-class-query.js").default} */ (this.query)
72
72
  const baseTableName = this.qualifyBaseTable
73
73
  ? modelQuery.getTableReferenceForJoin()
74
74
  : undefined
@@ -136,7 +136,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
136
136
 
137
137
  /**
138
138
  * Normalized.
139
- @type {Array<[string, "eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like", unknown]>} */
139
+ * @type {Array<[string, "eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like", unknown]>} */
140
140
  const normalized = []
141
141
  /**
142
142
  * Add condition.
@@ -146,7 +146,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
146
146
  if (this._isRelationshipWhereOperatorTuple(conditionValue)) {
147
147
  const tuple = /**
148
148
  * Narrows the runtime value to the documented type.
149
- @type {[string, "eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like" | ">" | ">=" | "<" | "<=", unknown, ...Array<unknown>]} */ (conditionValue)
149
+ * @type {[string, "eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like" | ">" | ">=" | "<" | "<=", unknown, ...Array<unknown>]} */ (conditionValue)
150
150
  const normalizedOperator = normalizeRelationshipWhereOperator(tuple[1])
151
151
 
152
152
  normalized.push([
@@ -395,7 +395,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
395
395
  const options = this.getOptions()
396
396
  const modelQuery = /**
397
397
  * Narrows the runtime value to the documented type.
398
- @type {import("./model-class-query.js").default} */ (this.query)
398
+ * @type {import("./model-class-query.js").default} */ (this.query)
399
399
  let sql = ""
400
400
 
401
401
  for (const whereKey in hash) {
@@ -443,7 +443,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
443
443
 
444
444
  const nestedHash = /**
445
445
  * Narrows the runtime value to the documented type.
446
- @type {WhereHash} */ (whereValue)
446
+ * @type {WhereHash} */ (whereValue)
447
447
  const nestedPath = path.concat([whereKey])
448
448
  const nestedTableName = modelQuery.getTableReferenceForJoin(...nestedPath)
449
449
 
@@ -47,7 +47,7 @@ export function normalizeWithCount(spec) {
47
47
  if (typeof spec === "object") {
48
48
  /**
49
49
  * Entries.
50
- @type {WithCountEntry[]} */
50
+ * @type {WithCountEntry[]} */
51
51
  const entries = []
52
52
 
53
53
  for (const [key, value] of Object.entries(spec)) {
@@ -63,7 +63,7 @@ export function normalizeWithCount(spec) {
63
63
  if (typeof value === "object" && value !== null) {
64
64
  /**
65
65
  * Options.
66
- @type {{relationship?: string, where?: Record<string, ?>}} */
66
+ * @type {{relationship?: string, where?: Record<string, ?>}} */
67
67
  const options = value
68
68
  entries.push({
69
69
  attributeName: key,
@@ -112,7 +112,7 @@ export async function runWithCount({models, modelClass, entries}) {
112
112
  const primaryKey = modelClass.primaryKey()
113
113
  const parentIds = models.map((model) => /**
114
114
  * Narrows the runtime value to the documented type.
115
- @type {string | number} */ (model.readColumn(primaryKey)))
115
+ * @type {string | number} */ (model.readColumn(primaryKey)))
116
116
 
117
117
  for (const entry of entries) {
118
118
  const counts = await countForEntry({entries, entry, modelClass, parentIds})
@@ -120,14 +120,14 @@ export async function runWithCount({models, modelClass, entries}) {
120
120
  for (const model of models) {
121
121
  const modelPrimaryKeyValue = /**
122
122
  * Narrows the runtime value to the documented type.
123
- @type {string | number} */ (model.readColumn(primaryKey))
123
+ * @type {string | number} */ (model.readColumn(primaryKey))
124
124
  // Tolerate driver differences in numeric return types: SQLite
125
125
  // returns integers as JS numbers, but MySQL's raw driver can
126
126
  // return count primary keys as strings. Try both.
127
127
  const resolvedCount = counts.has(modelPrimaryKeyValue)
128
128
  ? /**
129
129
  * Narrows the runtime value to the documented type.
130
- @type {number} */ (counts.get(modelPrimaryKeyValue))
130
+ * @type {number} */ (counts.get(modelPrimaryKeyValue))
131
131
  : Number(counts.get(String(modelPrimaryKeyValue)) ?? 0)
132
132
 
133
133
  // Counts go on the record's dedicated association-count map,
@@ -170,7 +170,7 @@ async function countForEntry({entries, entry, modelClass, parentIds}) {
170
170
  const foreignKey = relationship.getForeignKey()
171
171
  /**
172
172
  * Where conditions.
173
- @type {Record<string, ?>} */
173
+ * @type {Record<string, ?>} */
174
174
  const whereConditions = {[foreignKey]: parentIds}
175
175
 
176
176
  if (relationship.getPolymorphic && relationship.getPolymorphic()) {
@@ -198,19 +198,19 @@ async function countForEntry({entries, entry, modelClass, parentIds}) {
198
198
 
199
199
  const rows = /**
200
200
  * Narrows the runtime value to the documented type.
201
- @type {Array<{parent_id: string | number, count_value: string | number}>} */ (
201
+ * @type {Array<{parent_id: string | number, count_value: string | number}>} */ (
202
202
  await countQuery._executeQuery()
203
203
  )
204
204
 
205
205
  /**
206
206
  * Counts.
207
- @type {Map<string | number, number>} */
207
+ * @type {Map<string | number, number>} */
208
208
  const counts = new Map()
209
209
 
210
210
  for (const row of rows) {
211
211
  const parentId = /**
212
212
  * Narrows the runtime value to the documented type.
213
- @type {string | number} */ (row.parent_id)
213
+ * @type {string | number} */ (row.parent_id)
214
214
  const countValue = Number(row.count_value) || 0
215
215
  counts.set(parentId, countValue)
216
216
  }
@@ -64,7 +64,7 @@ export default function registerActsAsListCallbacks(modelClass, positionColumn,
64
64
 
65
65
  const modelClass = /**
66
66
  * Narrows the runtime value to the documented type.
67
- @type {typeof import("./index.js").default} */ (record.constructor)
67
+ * @type {typeof import("./index.js").default} */ (record.constructor)
68
68
  const posColumn = modelClass.getColumnNameForAttributeName(positionColumn)
69
69
  const scopeCol = modelClass.getColumnNameForAttributeName(scope)
70
70
  /** @type {Record<string, ?>} */
@@ -81,24 +81,24 @@ export default function registerActsAsListCallbacks(modelClass, positionColumn,
81
81
 
82
82
  const oldPosition = posChanged ? /**
83
83
  * Narrows the runtime value to the documented type.
84
- @type {number} */ (rawAttributes[posColumn]) : /**
84
+ * @type {number} */ (rawAttributes[posColumn]) : /**
85
85
  * Narrows the runtime value to the documented type.
86
- @type {number} */ (record.readAttribute(positionColumn))
86
+ * @type {number} */ (record.readAttribute(positionColumn))
87
87
  const newPosition = posChanged ? /**
88
88
  * Narrows the runtime value to the documented type.
89
- @type {number} */ (changes[posColumn]) : /**
89
+ * @type {number} */ (changes[posColumn]) : /**
90
90
  * Narrows the runtime value to the documented type.
91
- @type {number} */ (record.readAttribute(positionColumn))
91
+ * @type {number} */ (record.readAttribute(positionColumn))
92
92
  const oldScopeValue = scopeChanged ? /**
93
93
  * Narrows the runtime value to the documented type.
94
- @type {number} */ (rawAttributes[scopeCol]) : /**
94
+ * @type {number} */ (rawAttributes[scopeCol]) : /**
95
95
  * Narrows the runtime value to the documented type.
96
- @type {number} */ (record.readAttribute(scope))
96
+ * @type {number} */ (record.readAttribute(scope))
97
97
  const newScopeValue = scopeChanged ? /**
98
98
  * Narrows the runtime value to the documented type.
99
- @type {number} */ (changes[scopeCol]) : /**
99
+ * @type {number} */ (changes[scopeCol]) : /**
100
100
  * Narrows the runtime value to the documented type.
101
- @type {number} */ (record.readAttribute(scope))
101
+ * @type {number} */ (record.readAttribute(scope))
102
102
 
103
103
  if (oldPosition == null || newPosition == null) return
104
104
  if (newPosition === oldPosition && newScopeValue === oldScopeValue) return
@@ -212,7 +212,7 @@ function clearBelongsToChangeForScope(record) {
212
212
  async function shiftPositionsUp({record, positionColumn, scope, fromPosition, toPosition, scopeValue, excludeRecordId}) {
213
213
  const modelClass = /**
214
214
  * Narrows the runtime value to the documented type.
215
- @type {typeof import("./index.js").default} */ (record.constructor)
215
+ * @type {typeof import("./index.js").default} */ (record.constructor)
216
216
  const connection = modelClass.connection()
217
217
  const tableName = modelClass._getTable().getName()
218
218
  const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)
@@ -279,7 +279,7 @@ async function shiftPositionsUp({record, positionColumn, scope, fromPosition, to
279
279
  async function shiftPositionsDown({record, positionColumn, scope, fromPosition, toPosition, scopeValue}) {
280
280
  const modelClass = /**
281
281
  * Narrows the runtime value to the documented type.
282
- @type {typeof import("./index.js").default} */ (record.constructor)
282
+ * @type {typeof import("./index.js").default} */ (record.constructor)
283
283
  const connection = modelClass.connection()
284
284
  const tableName = modelClass._getTable().getName()
285
285
  const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)
@@ -337,7 +337,7 @@ async function shiftPositionsDown({record, positionColumn, scope, fromPosition,
337
337
  async function highestPositionInScope({record, positionColumn, scope, scopeValue}) {
338
338
  const modelClass = /**
339
339
  * Narrows the runtime value to the documented type.
340
- @type {typeof import("./index.js").default} */ (record.constructor)
340
+ * @type {typeof import("./index.js").default} */ (record.constructor)
341
341
  const connection = modelClass.connection()
342
342
  const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
343
343
  const positionColumnName = modelClass.getColumnNameForAttributeName(positionColumn)
@@ -370,11 +370,11 @@ async function highestPositionInScope({record, positionColumn, scope, scopeValue
370
370
  function resolveScopeValue(record, scope) {
371
371
  const attrValue = record.readAttribute(scope)
372
372
 
373
- if (attrValue != null) return /** Narrows the runtime value to the documented type. @type {string | number} */ (attrValue)
373
+ if (attrValue != null) return /** @type {string | number} */ (attrValue)
374
374
 
375
375
  const modelClass = /**
376
376
  * Narrows the runtime value to the documented type.
377
- @type {typeof import("./index.js").default} */ (record.constructor)
377
+ * @type {typeof import("./index.js").default} */ (record.constructor)
378
378
  const relationships = modelClass.getRelationshipsMap()
379
379
  const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
380
380
 
@@ -412,7 +412,7 @@ function resolveScopeValue(record, scope) {
412
412
  async function moveOutOfWay({record, positionColumn, scope, scopeValue, targetScopeValue}) {
413
413
  const modelClass = /**
414
414
  * Narrows the runtime value to the documented type.
415
- @type {typeof import("./index.js").default} */ (record.constructor)
415
+ * @type {typeof import("./index.js").default} */ (record.constructor)
416
416
  const connection = modelClass.connection()
417
417
  const tableName = modelClass._getTable().getName()
418
418
  const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)
@@ -39,7 +39,7 @@ function isArray(value) {
39
39
  export default class RecordAttachmentHandle {
40
40
  /**
41
41
  * Pending inputs.
42
- @type {Array<?>} */
42
+ * @type {Array<?>} */
43
43
  pendingInputs = []
44
44
 
45
45
  /**
@@ -155,7 +155,7 @@ export default class RecordAttachmentHandle {
155
155
  const rows = await store.findMany({model: this.model, name: this.name})
156
156
  /**
157
157
  * Downloads.
158
- @type {RecordAttachmentDownload[]} */
158
+ * @type {RecordAttachmentDownload[]} */
159
159
  const downloads = []
160
160
 
161
161
  for (const row of rows) {
@@ -57,7 +57,7 @@ function isArrayBuffer(value) {
57
57
  function isArrayBufferLike(value) {
58
58
  return Boolean(value && typeof value === "object" && typeof /**
59
59
  * Narrows the runtime value to the documented type.
60
- @type {?} */ (value).arrayBuffer === "function")
60
+ * @type {?} */ (value).arrayBuffer === "function")
61
61
  }
62
62
 
63
63
  /**
@@ -83,13 +83,13 @@ function toBuffer(value) {
83
83
  async function uploadedFileBuffer(uploadedFile, environmentHandler) {
84
84
  const memoryBuffer = /**
85
85
  * Narrows the runtime value to the documented type.
86
- @type {{getBuffer?: () => Buffer}} */ (uploadedFile).getBuffer?.()
86
+ * @type {{getBuffer?: () => Buffer}} */ (uploadedFile).getBuffer?.()
87
87
 
88
88
  if (Buffer.isBuffer(memoryBuffer)) return memoryBuffer
89
89
 
90
90
  const tempPath = /**
91
91
  * Narrows the runtime value to the documented type.
92
- @type {{getPath?: () => string}} */ (uploadedFile).getPath?.()
92
+ * @type {{getPath?: () => string}} */ (uploadedFile).getPath?.()
93
93
 
94
94
  if (typeof tempPath === "string" && tempPath.length > 0) {
95
95
  if (!environmentHandler || typeof environmentHandler.readAttachmentInputFile !== "function") {
@@ -127,15 +127,15 @@ export default async function normalizeRecordAttachmentInput(input, args = {}) {
127
127
  const environmentHandler = args.environmentHandler
128
128
  /**
129
129
  * Defines buffer.
130
- @type {Buffer} */
130
+ * @type {Buffer} */
131
131
  let buffer
132
132
  /**
133
133
  * Content type.
134
- @type {string | null} */
134
+ * @type {string | null} */
135
135
  let contentType = null
136
136
  /**
137
137
  * Defines filename.
138
- @type {string | undefined} */
138
+ * @type {string | undefined} */
139
139
  let filename
140
140
 
141
141
  if (input instanceof UploadedFile) {
@@ -176,21 +176,21 @@ export default async function normalizeRecordAttachmentInput(input, args = {}) {
176
176
  buffer = Buffer.from(arrayBuffer)
177
177
  filename = typeof /**
178
178
  * Narrows the runtime value to the documented type.
179
- @type {?} */ (input).name === "string" && /**
179
+ * @type {?} */ (input).name === "string" && /**
180
180
  * Narrows the runtime value to the documented type.
181
- @type {?} */ (input).name.length > 0
181
+ * @type {?} */ (input).name.length > 0
182
182
  ? /**
183
183
  * Narrows the runtime value to the documented type.
184
- @type {?} */ (input).name
184
+ * @type {?} */ (input).name
185
185
  : defaultFilename
186
186
  contentType = typeof /**
187
187
  * Narrows the runtime value to the documented type.
188
- @type {?} */ (input).type === "string" && /**
188
+ * @type {?} */ (input).type === "string" && /**
189
189
  * Narrows the runtime value to the documented type.
190
- @type {?} */ (input).type.length > 0
190
+ * @type {?} */ (input).type.length > 0
191
191
  ? /**
192
192
  * Narrows the runtime value to the documented type.
193
- @type {?} */ (input).type
193
+ * @type {?} */ (input).type
194
194
  : null
195
195
  } else if (typeof input === "string" || Buffer.isBuffer(input) || isArrayBuffer(input) || isUint8Array(input)) {
196
196
  buffer = toBuffer(input)
@@ -17,7 +17,7 @@ function throwS3ConfigurationError(message) {
17
17
  function isReadableStream(value) {
18
18
  return Boolean(value && typeof value === "object" && typeof /**
19
19
  * Narrows the runtime value to the documented type.
20
- @type {?} */ (value).pipe === "function")
20
+ * @type {?} */ (value).pipe === "function")
21
21
  }
22
22
 
23
23
  /**
@@ -28,7 +28,7 @@ function isReadableStream(value) {
28
28
  async function dynamicImport(specifier) {
29
29
  const importer = /**
30
30
  * Narrows the runtime value to the documented type.
31
- @type {(moduleSpecifier: string) => Promise<?>} */ (
31
+ * @type {(moduleSpecifier: string) => Promise<?>} */ (
32
32
  new Function("moduleSpecifier", "return import(moduleSpecifier)")
33
33
  )
34
34
 
@@ -51,17 +51,17 @@ async function streamToBuffer(value) {
51
51
 
52
52
  /**
53
53
  * Chunks.
54
- @type {Buffer[]} */
54
+ * @type {Buffer[]} */
55
55
  const chunks = []
56
56
 
57
57
  const readableStream = /**
58
58
  * Narrows the runtime value to the documented type.
59
- @type {?} */ (value)
59
+ * @type {?} */ (value)
60
60
 
61
61
  await new Promise((resolve, reject) => {
62
62
  readableStream.on("data", (/**
63
63
  * Narrows the runtime value to the documented type.
64
- @type {Buffer | Uint8Array | ArrayBuffer | string} */ chunk) => {
64
+ * @type {Buffer | Uint8Array | ArrayBuffer | string} */ chunk) => {
65
65
  if (Buffer.isBuffer(chunk)) {
66
66
  chunks.push(chunk)
67
67
  } else if (chunk instanceof ArrayBuffer) {
@@ -145,7 +145,7 @@ export default class S3AttachmentStorageDriver {
145
145
  const {S3Client} = await this.s3Runtime()
146
146
  /**
147
147
  * Client config.
148
- @type {Record<string, ?>} */
148
+ * @type {Record<string, ?>} */
149
149
  const clientConfig = {
150
150
  region: this.options.region || process.env.VELOCIOUS_ATTACHMENTS_S3_REGION || "us-east-1"
151
151
  }